@tensorix/metahub 0.1.3 → 0.1.6

package/dist/cli.js

@@ -891,7 +891,7 @@ function observeHlc(db, node, remote, now = Date.now()) {
 }
 
 // src/core/blocks.ts
-function parseBlocks(md) {
+function parseDocBlocks(md) {
   if (!md)
     return [];
   const lines = md.replace(/\r\n?/g, `
@@ -901,24 +901,24 @@ function parseBlocks(md) {
   let cur = [];
   let fenceChar = null;
   let fenceLen = 0;
-  const flushPara = () => {
-    while (cur.length && cur[cur.length - 1].trim() === "")
-      cur.pop();
-    while (cur.length && cur[0].trim() === "")
-      cur.shift();
-    if (cur.length)
-      blocks.push(cur.join(`
-`));
-    cur = [];
+  const closeBlock = () => {
+    if (cur.length) {
+      blocks.push({ text: cur.join(`
+`), blankAfter: 0 });
+      cur = [];
+    }
+  };
+  const onBlank = () => {
+    closeBlock();
+    if (blocks.length)
+      blocks[blocks.length - 1].blankAfter++;
   };
   for (const raw of lines) {
     if (fenceChar) {
       cur.push(raw);
       const m2 = raw.match(/^\s*(`{3,}|~{3,})\s*$/);
       if (m2 && m2[1][0] === fenceChar && m2[1].length >= fenceLen) {
-        blocks.push(cur.join(`
-`));
-        cur = [];
+        closeBlock();
         fenceChar = null;
         fenceLen = 0;
       }
@@ -926,28 +926,34 @@ function parseBlocks(md) {
     }
     const open = raw.match(/^\s*(`{3,}|~{3,})/);
     if (open) {
-      flushPara();
+      closeBlock();
       fenceChar = open[1][0];
       fenceLen = open[1].length;
       cur.push(raw);
     } else if (raw.trim() === "") {
-      flushPara();
+      onBlank();
     } else {
       cur.push(raw);
     }
   }
-  if (fenceChar) {
-    if (cur.length)
-      blocks.push(cur.join(`
-`));
-  } else {
-    flushPara();
-  }
+  closeBlock();
+  for (let i2 = 0;i2 < blocks.length - 1; i2++)
+    blocks[i2].blankAfter = Math.max(0, blocks[i2].blankAfter - 1);
   return blocks;
 }
-function serializeBlocks(texts) {
-  return texts.filter((t2) => !!t2 && t2.length > 0).join(`
-
+function serializeDocBlocks(blocks) {
+  const live = blocks.filter((b2) => !!b2.text && b2.text.length > 0);
+  const out = [];
+  live.forEach((b2, i2) => {
+    out.push(...b2.text.split(`
+`));
+    const extra = Math.max(0, b2.blankAfter ?? 0);
+    if (i2 < live.length - 1)
+      out.push("");
+    for (let k2 = 0;k2 < extra; k2++)
+      out.push("");
+  });
+  return out.join(`
 `);
 }
 function reconcile(oldTexts, newTexts) {
@@ -1004,9 +1010,9 @@ function isBlockManaged(db, docId) {
   return db.query("SELECT 1 AS x FROM doc_blocks WHERE doc_id = ? LIMIT 1").get(docId) != null;
 }
 function recomputeDocBody(db, docId) {
-  const rows = db.query("SELECT text FROM doc_blocks WHERE doc_id = ? AND __deleted = 0 ORDER BY order_key, id").all(docId);
+  const rows = db.query("SELECT text, blank_after FROM doc_blocks WHERE doc_id = ? AND __deleted = 0 ORDER BY order_key, id").all(docId);
   ensureRow(db, "documents", docId);
-  db.query("UPDATE documents SET body = ? WHERE id = ?").run(serializeBlocks(rows.map((r3) => r3.text)), docId);
+  db.query("UPDATE documents SET body = ? WHERE id = ?").run(serializeDocBlocks(rows.map((r3) => ({ text: r3.text, blankAfter: r3.blank_after ?? 0 }))), docId);
 }
 function materialize(db, dataset, rowId, col, valueJson) {
   if (dataset === "records") {
@@ -1096,7 +1102,7 @@ var init_crdt = __esm(() => {
     },
     doc_blocks: {
       table: "doc_blocks",
-      cols: new Set(["doc_id", "text", "order_key", "__deleted"])
+      cols: new Set(["doc_id", "text", "order_key", "blank_after", "__deleted"])
     },
     sites: {
       table: "sites",
@@ -1349,9 +1355,14 @@ var require_src = __commonJS((exports, module) => {
 // src/core/sync/webui.ts
 var exports_webui = {};
 __export(exports_webui, {
+  warmWebui: () => warmWebui,
+  setWebuiBundle: () => setWebuiBundle,
   serveWebui: () => serveWebui
 });
 import { fileURLToPath } from "url";
+function setWebuiBundle(js) {
+  cachedJs = js;
+}
 async function getJs() {
   if (cachedJs != null)
     return cachedJs;
@@ -1367,6 +1378,11 @@ async function getJs() {
   cachedJs = await res.outputs[0].text();
   return cachedJs;
 }
+async function warmWebui() {
+  try {
+    await getJs();
+  } catch {}
+}
 async function serveWebui(req) {
   if (req.method !== "GET")
     return null;
@@ -1393,7 +1409,13 @@ var HTML = `<!doctype html>
 <title>Metahub</title>
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
-<link href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
+<!-- Load web fonts without blocking first paint: media="print" keeps the
+     stylesheet non-render-blocking, then onload flips it to "all". The page
+     paints instantly with the system-font fallbacks baked into --ui/--mono and
+     swaps to the web fonts when they arrive (or stays on system fonts offline).
+     This is what kept the desktop cold-start white for seconds on slow networks. -->
+<link rel="stylesheet" media="print" onload="this.media='all'" href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap">
+<noscript><link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Hanken+Grotesk:wght@400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap"></noscript>
 <script>try{document.documentElement.dataset.theme=localStorage.getItem('mh-theme')||'system'}catch(e){}</script>
 <style>
   :root {
@@ -1407,6 +1429,7 @@ var HTML = `<!doctype html>
     --radius:8px; --radius-sm:6px;
     --ui:"Hanken Grotesk",-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",sans-serif;
     --mono:"JetBrains Mono",ui-monospace,SFMono-Regular,monospace;
+    --note-lh:1.6;
     --code-bg:#f8f8f6;
     --hl-cmt:#9a9aa2; --hl-key:#a626a4; --hl-str:#28823f; --hl-num:#b76a00;
     --hl-fn:#3f51d6; --hl-type:#0a7ea4; --hl-var:#c2410c;
@@ -1439,7 +1462,7 @@ var HTML = `<!doctype html>
   * { box-sizing: border-box; }
   html, body { margin: 0; height: 100%; }
   body { font-family: var(--ui); font-size: 14px; line-height: 1.55; color: var(--fg); background: var(--bg);
-    overflow: hidden; -webkit-font-smoothing: antialiased; text-rendering: optimizeLegibility; }
+    overflow: hidden; text-rendering: auto; }
   button { font: inherit; color: inherit; cursor: pointer; background: none; border: 0; padding: 0; }
   input, textarea { font: inherit; color: inherit; }
   .muted { color: var(--muted); }
@@ -1495,6 +1518,8 @@ var HTML = `<!doctype html>
   .dragging { opacity:.35; }
   .sb-footer { flex:none; padding:6px 8px; border-top:1px solid var(--line); }
   .sb-footer .navitem { font-size:13.5px; }
+  .nav-dot { flex:none; width:7px; height:7px; border-radius:50%; background:var(--danger);
+    box-shadow:0 0 0 2px var(--surface); margin-right:2px; }
 
   /* settings page */
   .set-page { max-width:680px; margin:0 auto; padding:40px 28px 64px; }
@@ -1503,6 +1528,20 @@ var HTML = `<!doctype html>
   .set-section { margin-top:34px; }
   .set-section-head { font-size:12px; font-weight:600; text-transform:uppercase; letter-spacing:.07em; color:var(--muted); margin-bottom:4px; }
   .set-section-desc { color:var(--fg-soft); margin-bottom:16px; }
+  .set-footer { margin-top:40px; padding-top:20px; border-top:1px solid var(--line); display:flex;
+    flex-wrap:wrap; justify-content:center; align-items:center; gap:7px; color:var(--muted); font-size:12px; }
+  .set-footer-sep { opacity:.45; }
+  .ver-num { font-family:var(--mono); font-size:11px; color:var(--fg-soft); letter-spacing:-.01em; }
+  .ver-up { display:inline-flex; align-items:center; gap:6px; }
+  .ver-up.err .ver-msg { color:var(--danger); }
+  .ver-act { background:none; border:0; padding:0; margin:0; font:inherit; font-size:12px; line-height:1;
+    color:var(--muted); cursor:pointer; transition:color .12s; }
+  .ver-act:hover { color:var(--accent); }
+  .ver-act.accent { color:var(--accent); font-weight:600; }
+  .ver-act[aria-disabled="true"] { opacity:.6; cursor:default; pointer-events:none; }
+  .ver-dot { width:6px; height:6px; border-radius:50%; background:var(--accent); flex:none; }
+  .ver-dot.pulse { animation:verpulse 1.8s ease-in-out infinite; }
+  @keyframes verpulse { 0%,100% { opacity:1; } 50% { opacity:.4; } }
   .theme-grid { display:grid; grid-template-columns:repeat(3,1fr); gap:12px; }
   .theme-card { position:relative; display:flex; flex-direction:column; align-items:flex-start; gap:10px;
     text-align:left; padding:16px; border:1px solid var(--line-strong); border-radius:var(--radius);
@@ -1540,6 +1579,7 @@ var HTML = `<!doctype html>
   /* main */
   .main { flex:1; display:flex; flex-direction:column; overflow:hidden; min-width:0; }
   .topbar { display:flex; align-items:center; gap:6px; padding:10px 18px; border-bottom:1px solid var(--line); min-height:49px; }
+  .topbar.bare { border-bottom:0; }
   .topbar .hamburger { display:none; }
   .topbar .hamburger.show-collapsed { display:grid; }
   .sidebar.collapsed { overflow:hidden; }
@@ -1594,8 +1634,10 @@ var HTML = `<!doctype html>
   /* The list item's host gutter controls the whole unit, so suppress the nested
      code block's own gutter (it would overlap the list marker on the same row). */
   .block.list-code-host + .block-wrap.nested .gutter { display:none; }
-  .editable { outline:none; flex:1; min-width:0; padding:3px 2px; line-height:1.6; }
+  .editable { outline:none; flex:1; min-width:0; padding:3px 2px; line-height:var(--note-lh); }
   .editable:empty::before { content:attr(data-ph); color:var(--muted); pointer-events:none; }
+  /* The generic "/" prompt only shows on the focused line; idle blank lines (paragraphs and list items, any depth) stay blank. */
+  .editable[data-ph-hint="slash"]:empty:not(:focus)::before { content:""; }
   .b-h1 .editable { font-size:28px; font-weight:700; letter-spacing:-.02em; padding-top:12px; }
   .b-h2 .editable { font-size:22px; font-weight:650; letter-spacing:-.01em; padding-top:8px; }
   .b-h3 .editable { font-size:18px; font-weight:600; padding-top:4px; }
@@ -1647,7 +1689,8 @@ var HTML = `<!doctype html>
   .hljs-emphasis { font-style:italic; }
   .hljs-strong { font-weight:700; }
   .marker { width:24px; flex:none; text-align:center; color:var(--fg-soft); user-select:none; padding-top:4px; }
-  .b-todo .marker { padding-top:5px; }
+  .b-todo .marker { box-sizing:content-box; padding-top:3px; height:calc(1em * var(--note-lh));
+    display:flex; align-items:center; justify-content:center; }
   .b-todo .marker input { width:15px; height:15px; accent-color:var(--accent); cursor:pointer; }
   .b-divider { padding:10px 0; }
   .b-divider hr { border:0; border-top:1px solid var(--line-strong); margin:0; width:100%; }
@@ -1834,14 +1877,14 @@ var HTML = `<!doctype html>
   .optrow .x:hover { background:var(--hover-2); color:var(--danger); }
 
   /* modal */
-  .modal-scrim { position:fixed; inset:0; background:rgba(15,15,25,.4); z-index:100; display:grid; place-items:center;
+  .modal-scrim { position:fixed; inset:0; background:rgba(15,15,25,.4); z-index:100; display:flex; align-items:center; justify-content:center;
     opacity:0; pointer-events:none; transition:opacity .15s; padding:20px; }
   .modal-scrim.open { opacity:1; pointer-events:auto; }
-  .modal { background:var(--bg); border-radius:16px; box-shadow:var(--shadow-lg); width:440px; max-width:100%; overflow:hidden; }
+  .modal { background:var(--bg); border-radius:16px; box-shadow:var(--shadow-lg); width:440px; max-width:100%; max-height:100%; display:flex; flex-direction:column; overflow:hidden; }
   .modal-head { padding:20px 22px 0; }
   .modal-head h3 { margin:0; font-size:18px; font-weight:700; letter-spacing:-.01em; }
   .modal-head p { margin:6px 0 0; color:var(--muted); font-size:13.5px; }
-  .modal-body { padding:18px 22px; }
+  .modal-body { padding:18px 22px; overflow-y:auto; }
   .modal-foot { display:flex; justify-content:flex-end; gap:8px; padding:14px 22px; background:var(--surface); border-top:1px solid var(--line); }
   .field-label { font-size:12px; font-weight:600; color:var(--fg-soft); margin:12px 0 5px; }
   .field-label:first-child { margin-top:0; }
@@ -1864,7 +1907,71 @@ var HTML = `<!doctype html>
   @keyframes slidein { from { opacity:0; transform:translateX(-12px); } }
 
   /* misc */
-  .empty { display:grid; place-items:center; height:100%; color:var(--muted); text-align:center; padding:40px; }
+  .empty { display:flex; flex-direction:column; align-items:center; justify-content:center; height:100%;
+    color:var(--muted); text-align:center; padding:40px; }
+
+  /* ---- empty state: \u77E5\u8BC6\u751F\u957F\u63D2\u753B ---- */
+  .estate-art { width:240px; height:208px; overflow:visible; animation:idleFloat 5s ease-in-out 1.6s infinite; }
+  .estate-art .stroke-a { fill:none; stroke:var(--accent); stroke-width:2.4; stroke-linecap:round; stroke-linejoin:round; }
+  .estate-art .stroke   { fill:none; stroke:var(--line-strong); stroke-width:2.4; stroke-linecap:round; stroke-linejoin:round; }
+  .estate-art .fill-a       { fill:var(--accent); }
+  .estate-art .fill-soft    { fill:var(--accent-soft); }
+  .estate-art .fill-surface { fill:var(--bg); }
+  .estate-art .ground       { fill:var(--accent); }
+  .estate-title { margin:28px 0 0; font-size:18px; font-weight:600; letter-spacing:.2px; color:var(--fg);
+    opacity:0; animation:fadeUp .5s ease forwards 1.0s; }
+  .estate-hint { margin:9px 0 0; font-size:13.5px; line-height:1.6; color:var(--muted); max-width:300px;
+    opacity:0; animation:fadeUp .5s ease forwards 1.15s; }
+  .estate-link { margin:18px 0 0; font-size:14px; font-weight:600; color:var(--accent);
+    display:inline-flex; align-items:center; gap:6px; padding:9px 8px; border-radius:var(--radius-sm);
+    opacity:0; animation:fadeUp .5s ease forwards 1.3s; transition:opacity .15s; }
+  .estate-link:hover { opacity:.7; }
+  /* intro */
+  .draw { stroke-dasharray:100; stroke-dashoffset:100; }
+  @keyframes draw     { to { stroke-dashoffset:0; } }
+  @keyframes leafGrow { from { opacity:0; transform:scale(.2) rotate(-10deg); } to { opacity:1; transform:scale(1) rotate(0); } }
+  @keyframes cardUp   { from { opacity:0; transform:translateY(16px) scale(.96); } to { opacity:1; transform:translateY(0) scale(1); } }
+  @keyframes groundIn { to { opacity:.1; } }
+  @keyframes glowIn   { to { opacity:.6; } }
+  @keyframes fadeUp   { from { opacity:0; transform:translateY(6px); } to { opacity:1; transform:translateY(0); } }
+  /* idle loops \u2014 each 0% equals the settled rest state to avoid a jump */
+  @keyframes idleFloat     { 0%,100% { transform:translateY(0); } 50% { transform:translateY(-5px); } }
+  @keyframes plantSway     { 0%,100% { transform:rotate(0deg); } 25% { transform:rotate(-1.3deg); } 75% { transform:rotate(1.3deg); } }
+  @keyframes leafSwayA     { 0%,100% { transform:rotate(0deg); } 25% { transform:rotate(-2.6deg); } 75% { transform:rotate(2.6deg); } }
+  @keyframes leafSwayB     { 0%,100% { transform:rotate(0deg); } 25% { transform:rotate(2.6deg); } 75% { transform:rotate(-2.6deg); } }
+  @keyframes groundBreathe { 0%,100% { transform:scale(1); opacity:.10; } 50% { transform:scale(1.07); opacity:.15; } }
+  @keyframes glowPulse     { 0%,100% { transform:scale(1); opacity:.6; } 50% { transform:scale(1.1); opacity:.85; } }
+  @keyframes particle      { 0% { opacity:0; transform:translate(0,0) scale(.4); } 35% { opacity:.85; transform:translate(2px,-4px) scale(1); } 70% { opacity:0; transform:translate(4px,-9px) scale(.5); } 100% { opacity:0; transform:translate(0,0) scale(.4); } }
+  /* wiring */
+  .kg-ground { transform-box:fill-box; transform-origin:center; opacity:0;
+    animation:groundIn .5s ease forwards .1s, groundBreathe 6s ease-in-out 1.6s infinite; }
+  .kg-glow { filter:blur(9px); transform-box:fill-box; transform-origin:center; opacity:0;
+    animation:glowIn .6s ease forwards .1s, glowPulse 4.6s ease-in-out 1.6s infinite; }
+  .kg-cardB { transform-box:fill-box; transform-origin:center; opacity:0; animation:cardUp .55s cubic-bezier(.2,.8,.2,1) forwards .2s; }
+  .kg-cardA { transform-box:fill-box; transform-origin:center; opacity:0; animation:cardUp .55s cubic-bezier(.2,.8,.2,1) forwards .32s; }
+  .kg-plant { transform-box:fill-box; transform-origin:50% 100%; animation:plantSway 6s ease-in-out 1.7s infinite; }
+  .kg-stem  { animation:draw .9s ease-out forwards .4s; }
+  .kg-leaf  { transform-box:fill-box; }
+  .kg-grow  { transform-box:fill-box; opacity:0; }
+  .kg-leaf.l1 { transform-origin:90% 100%; animation:leafSwayA 4.6s ease-in-out 1.7s infinite; }
+  .kg-leaf.l2 { transform-origin:0% 80%;   animation:leafSwayB 5.2s ease-in-out 1.8s infinite; }
+  .kg-leaf.l3 { transform-origin:0% 100%;  animation:leafSwayA 5.0s ease-in-out 1.9s infinite; }
+  .kg-leaf.l1 .kg-grow { transform-origin:90% 100%; animation:leafGrow .52s cubic-bezier(.18,.9,.24,1.22) forwards .85s; }
+  .kg-leaf.l2 .kg-grow { transform-origin:0% 80%;   animation:leafGrow .52s cubic-bezier(.18,.9,.24,1.22) forwards 1.0s; }
+  .kg-leaf.l3 .kg-grow { transform-origin:0% 100%;  animation:leafGrow .52s cubic-bezier(.18,.9,.24,1.22) forwards 1.15s; }
+  .kg-particle { transform-box:fill-box; transform-origin:center; opacity:0; }
+  .kg-particle.p1 { animation:particle 4.5s ease-in-out 1.6s infinite; }
+  .kg-particle.p2 { animation:particle 5.2s ease-in-out 2.0s infinite; }
+  .kg-particle.p3 { animation:particle 4.8s ease-in-out 2.6s infinite; }
+  .kg-particle.p4 { animation:particle 5.6s ease-in-out 3.1s infinite; }
+  .kg-particle.p5 { animation:particle 4.2s ease-in-out 2.3s infinite; }
+  @media (prefers-reduced-motion: reduce) {
+    .estate-art, .estate-art *, .estate-title, .estate-hint, .estate-link { animation:none !important; opacity:1 !important; transform:none !important; }
+    .draw { stroke-dashoffset:0 !important; }
+    .kg-ground { opacity:.1 !important; }
+    .kg-glow { opacity:.6 !important; }
+    .kg-particle { opacity:0 !important; }
+  }
   .error-bar { margin:12px 24px; padding:10px 14px; background:var(--danger-soft); color:var(--danger); border-radius:var(--radius-sm); font-size:13px; cursor:pointer; }
   .view-placeholder { padding:40px; text-align:center; border:1px dashed var(--line-strong); border-radius:var(--radius); color:var(--muted); margin-top:8px; }
   .ico.flip { transform:scaleX(-1); }
@@ -1996,6 +2103,17 @@ var HTML = `<!doctype html>
   .qn-body .doc { max-width:none; margin:0; padding:14px 22px 30vh; }
   .qn-body .doc-title { font-size:24px; margin-bottom:2px; }
   .qn-body .doc-meta { display:none; }
+  /* A native checkbox paints an opaque white box when unchecked, which breaks
+     the window's vibrancy blur. Draw a custom box so the unchecked background
+     stays transparent; checked falls back to the accent fill + checkmark. */
+  body.quicknote .b-todo .marker input {
+    appearance:none; -webkit-appearance:none; box-sizing:border-box;
+    border:1.5px solid color-mix(in srgb, var(--fg-soft) 55%, transparent);
+    border-radius:4px; background:transparent; }
+  body.quicknote .b-todo .marker input:checked {
+    border-color:var(--accent);
+    background:var(--accent) center/10px no-repeat
+      url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='white' stroke-width='3.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M5 12l5 5L20 7'/%3E%3C/svg%3E"); }
   /* Compact menus inside the quick-note window only (dropdown + slash command
      share .pop/.item/.lico with the main app; scope under body.quicknote so the
      main app keeps its roomier density). */
@@ -3456,8 +3574,9 @@ async function runMain(cmd, opts = {}) {
 // package.json
 var package_default = {
   name: "@tensorix/metahub",
-  version: "0.1.3",
+  version: "0.1.6",
   description: "Metahub core library and CLI",
+  license: "AGPL-3.0-only",
   type: "module",
   main: "./dist/index.js",
   module: "./dist/index.js",
@@ -3475,14 +3594,17 @@ var package_default = {
   },
   files: [
     "dist",
-    "README.md"
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
   ],
   scripts: {
     dev: "bun --hot src/cli/index.ts",
     build: "bun run scripts/build.ts",
     "build:binaries": "bun run scripts/compile-binaries.ts",
     prepublishOnly: "bun run build",
-    test: "bun test"
+    test: "bun test",
+    release: "bun run scripts/tag-release.ts"
   },
   dependencies: {
     "@clack/prompts": "^1.5.0",
@@ -3607,11 +3729,12 @@ CREATE TABLE IF NOT EXISTS documents (
 -- independent CRDT register so concurrent edits to different blocks merge.
 -- order_key is a fractional index (ties broken by id) giving display order.
 CREATE TABLE IF NOT EXISTS doc_blocks (
-  id        TEXT PRIMARY KEY,
-  doc_id    TEXT,
-  text      TEXT,
-  order_key TEXT,
-  __deleted INTEGER NOT NULL DEFAULT 0
+  id          TEXT PRIMARY KEY,
+  doc_id      TEXT,
+  text        TEXT,
+  order_key   TEXT,
+  blank_after INTEGER NOT NULL DEFAULT 0,  -- extra blank lines kept after this block (user spacing)
+  __deleted   INTEGER NOT NULL DEFAULT 0
 );
 CREATE INDEX IF NOT EXISTS idx_doc_blocks_doc ON doc_blocks(doc_id);
 
@@ -3683,9 +3806,20 @@ function deleteDatabase(db, id) {
   if (!getDatabase(db, id))
     return false;
   emit(db, "databases", id, "__deleted", 1);
+  const tombstone = (table) => {
+    for (const r3 of liveChildren(db, table, "database_id", id))
+      emit(db, table, r3, "__deleted", 1);
+  };
+  tombstone("properties");
+  tombstone("records");
+  for (const d2 of liveChildren(db, "documents", "database_id", id))
+    emit(db, "documents", d2, "database_id", null);
   db.query("DELETE FROM meta WHERE key = 'current_db' AND value = ?").run(id);
   return true;
 }
+function liveChildren(db, table, col, parentId) {
+  return db.query(`SELECT id FROM ${table} WHERE ${col} = ? AND __deleted = 0`).all(parentId).map((r3) => r3.id);
+}
 
 // src/core/properties.ts
 init_ids();
@@ -3814,9 +3948,13 @@ function setPropertyWidth(db, id, width) {
   return updateProperty(db, id, { config: { ...cur.config ?? {}, width: w2 } });
 }
 function removeProperty(db, id) {
-  if (!getProperty(db, id))
+  const prop = getProperty(db, id);
+  if (!prop)
     return false;
   emit(db, "properties", id, "__deleted", 1);
+  const rows = db.query("SELECT id FROM records WHERE database_id = ? AND __deleted = 0 AND data ->> ? IS NOT NULL").all(prop.database_id, id);
+  for (const r3 of rows)
+    emit(db, "records", r3.id, id, undefined);
   return true;
 }
 
@@ -4284,6 +4422,10 @@ function migratePeers(db) {
       db.exec(`ALTER TABLE peers ADD COLUMN ${col} ${decl}`);
   }
 }
+function migrateDocBlocks(db) {
+  if (!hasColumn(db, "doc_blocks", "blank_after"))
+    db.exec("ALTER TABLE doc_blocks ADD COLUMN blank_after INTEGER NOT NULL DEFAULT 0");
+}
 function openMetahub() {
   ensureDirs();
   const db = new Database(dbPath(), { create: true });
@@ -4291,6 +4433,7 @@ function openMetahub() {
   runSchema(db);
   migrateRecords(db);
   migratePeers(db);
+  migrateDocBlocks(db);
   return db;
 }
 
@@ -4462,7 +4605,7 @@ var use_default = defineCommand({
 init_ids();
 init_crdt();
 function liveBlocks(db, docId) {
-  return db.query("SELECT id, text, order_key FROM doc_blocks WHERE doc_id = ? AND __deleted = 0 ORDER BY order_key, id").all(docId);
+  return db.query("SELECT id, text, order_key, blank_after FROM doc_blocks WHERE doc_id = ? AND __deleted = 0 ORDER BY order_key, id").all(docId);
 }
 function makeBlockId(text) {
   return newId("blk", text.split(`
@@ -4472,29 +4615,37 @@ function emitBlock(db, docId, fields) {
   const id = makeBlockId(fields.text);
   emit(db, "doc_blocks", id, "doc_id", docId);
   emit(db, "doc_blocks", id, "order_key", fields.order_key);
+  if (fields.blankAfter)
+    emit(db, "doc_blocks", id, "blank_after", fields.blankAfter);
   emit(db, "doc_blocks", id, "text", fields.text);
 }
-function insertBlocks(db, docId, texts, after, before) {
-  const keys = keysBetween(after, before, texts.length);
-  texts.forEach((text, i2) => emitBlock(db, docId, { text, order_key: keys[i2] }));
+function insertBlocks(db, docId, blocks, after, before) {
+  const keys = keysBetween(after, before, blocks.length);
+  blocks.forEach((b2, i2) => emitBlock(db, docId, { text: b2.text, order_key: keys[i2], blankAfter: b2.blankAfter }));
 }
 function ensureBlocks(db, docId) {
   if (db.query("SELECT 1 AS x FROM doc_blocks WHERE doc_id = ? LIMIT 1").get(docId))
     return;
   const row = db.query("SELECT body FROM documents WHERE id = ?").get(docId);
-  const texts = parseBlocks(row?.body ?? "");
-  if (texts.length)
-    insertBlocks(db, docId, texts, null, null);
+  const blocks = parseDocBlocks(row?.body ?? "");
+  if (blocks.length)
+    insertBlocks(db, docId, blocks, null, null);
 }
 function reconcileBody(db, docId, body) {
   const old = liveBlocks(db, docId);
-  const plan = reconcile(old.map((b2) => b2.text), parseBlocks(body));
+  const next = parseDocBlocks(body);
+  const plan = reconcile(old.map((b2) => b2.text), next.map((b2) => b2.text));
   for (const oi of plan.deleted)
     emit(db, "doc_blocks", old[oi].id, "__deleted", 1);
   const { items } = plan;
   let i2 = 0;
   while (i2 < items.length) {
-    if ("keep" in items[i2]) {
+    const it = items[i2];
+    if ("keep" in it) {
+      const oldB = old[it.keep];
+      const want = next[i2].blankAfter;
+      if ((oldB.blank_after ?? 0) !== want)
+        emit(db, "doc_blocks", oldB.id, "blank_after", want);
       i2++;
       continue;
     }
@@ -4503,8 +4654,7 @@ function reconcileBody(db, docId, body) {
       j++;
     const left = i2 > 0 ? old[items[i2 - 1].keep].order_key : null;
     const right = j < items.length ? old[items[j].keep].order_key : null;
-    const texts = items.slice(i2, j).map((it) => it.insert);
-    insertBlocks(db, docId, texts, left, right);
+    insertBlocks(db, docId, next.slice(i2, j), left, right);
     i2 = j;
   }
 }
@@ -4523,9 +4673,9 @@ function createDocument(db, opts) {
   if (opts.parent_id !== undefined)
     emit(db, "documents", id, "parent_id", opts.parent_id);
   if (opts.body !== undefined) {
-    const texts = parseBlocks(opts.body);
-    if (texts.length)
-      insertBlocks(db, id, texts, null, null);
+    const blocks = parseDocBlocks(opts.body);
+    if (blocks.length)
+      insertBlocks(db, id, blocks, null, null);
   }
   return getDocument(db, id);
 }
@@ -4571,7 +4721,7 @@ function editDocument(db, id, opts) {
     throw new Error("--old must not be empty");
   ensureBlocks(db, id);
   const blocks = liveBlocks(db, id);
-  const body = serializeBlocks(blocks.map((b2) => b2.text));
+  const body = serializeDocBlocks(blocks.map((b2) => ({ text: b2.text, blankAfter: b2.blank_after })));
   const count = countOccurrences(body, opts.old);
   if (count === 0)
     throw new Error(`anchor not found: no match for --old`);
@@ -4598,32 +4748,39 @@ function appendDocument(db, id, body) {
   if (!getDocument(db, id))
     throw new Error(`no such document: ${id}`);
   ensureBlocks(db, id);
-  const texts = parseBlocks(body);
-  if (texts.length) {
+  const next = parseDocBlocks(body);
+  if (next.length) {
     const blocks = liveBlocks(db, id);
     const last = blocks.length ? blocks[blocks.length - 1].order_key : null;
-    insertBlocks(db, id, texts, last, null);
+    insertBlocks(db, id, next, last, null);
   }
-  return { id, changed: texts.length > 0, replaced: texts.length, version: documentVersion(db, id) };
+  return { id, changed: next.length > 0, replaced: next.length, version: documentVersion(db, id) };
 }
 function prependDocument(db, id, body) {
   if (!getDocument(db, id))
     throw new Error(`no such document: ${id}`);
   ensureBlocks(db, id);
-  const texts = parseBlocks(body);
-  if (texts.length) {
+  const next = parseDocBlocks(body);
+  if (next.length) {
     const blocks = liveBlocks(db, id);
     const first = blocks.length ? blocks[0].order_key : null;
-    insertBlocks(db, id, texts, null, first);
+    insertBlocks(db, id, next, null, first);
   }
-  return { id, changed: texts.length > 0, replaced: texts.length, version: documentVersion(db, id) };
+  return { id, changed: next.length > 0, replaced: next.length, version: documentVersion(db, id) };
 }
 function deleteDocument(db, id) {
   if (!getDocument(db, id))
     return false;
   emit(db, "documents", id, "__deleted", 1);
+  for (const b2 of liveChildIds(db, "doc_blocks", "doc_id", id))
+    emit(db, "doc_blocks", b2, "__deleted", 1);
+  for (const c3 of liveChildIds(db, "documents", "parent_id", id))
+    emit(db, "documents", c3, "parent_id", null);
   return true;
 }
+function liveChildIds(db, table2, col, parentId) {
+  return db.query(`SELECT id FROM ${table2} WHERE ${col} = ? AND __deleted = 0`).all(parentId).map((r3) => r3.id);
+}
 function countOccurrences(haystack, needle) {
   if (needle === "")
     return 0;
@@ -5148,26 +5305,106 @@ var edit_default = defineCommand({
 });
 
 // src/core/search.ts
+init_crdt();
 var TEXT_TYPES = "('text','url','select','multi_select','date')";
-function ensureIndex(db) {
-  if (!ftsAvailable(db))
-    return false;
-  const max = db.query("SELECT MAX(hlc) AS h FROM crdt_changes").get().h ?? "";
-  const indexed = db.query("SELECT value FROM meta WHERE key = 'search_hlc'").get()?.value ?? "";
-  if (max === indexed)
-    return true;
-  db.query("DELETE FROM search_fts").run();
-  for (const d2 of db.query("SELECT id, title, body, database_id FROM documents WHERE __deleted = 0").all()) {
+var SEARCH_INDEX_VERSION = "1";
+function readMeta(db, key) {
+  return db.query("SELECT value FROM meta WHERE key = ?").get(key)?.value ?? null;
+}
+function writeMeta(db, key, value) {
+  db.query("INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(key, value);
+}
+function reindexDocument(db, id) {
+  db.query("DELETE FROM search_fts WHERE kind = 'document' AND id = ?").run(id);
+  const d2 = db.query("SELECT id, title, body, database_id FROM documents WHERE id = ? AND __deleted = 0").get(id);
+  if (d2)
     db.query("INSERT INTO search_fts (kind, id, database_id, title, body) VALUES ('document', ?, ?, ?, ?)").run(d2.id, d2.database_id, d2.title ?? "", d2.body ?? "");
-  }
-  for (const r3 of db.query(`SELECT r.id AS id, r.database_id AS database_id, group_concat(je.value, ' ') AS body
+}
+function recordBodyRows(db, where, ...args) {
+  return db.query(`SELECT r.id AS id, r.database_id AS database_id, group_concat(je.value, ' ') AS body
        FROM records r, json_each(r.data) je
        JOIN properties p ON p.id = je.key AND p.__deleted = 0
-       WHERE r.__deleted = 0 AND p.type IN ${TEXT_TYPES}
-       GROUP BY r.id`).all()) {
-    db.query("INSERT INTO search_fts (kind, id, database_id, title, body) VALUES ('record', ?, ?, ?, ?)").run(r3.id, r3.database_id, r3.id, r3.body ?? "");
+       WHERE ${where} AND r.__deleted = 0 AND p.type IN ${TEXT_TYPES}
+       GROUP BY r.id`).all(...args);
+}
+function insertRecordRow(db, r3) {
+  db.query("INSERT INTO search_fts (kind, id, database_id, title, body) VALUES ('record', ?, ?, ?, ?)").run(r3.id, r3.database_id, r3.id, r3.body ?? "");
+}
+function reindexRecord(db, id) {
+  db.query("DELETE FROM search_fts WHERE kind = 'record' AND id = ?").run(id);
+  const r3 = recordBodyRows(db, "r.id = ?", id)[0];
+  if (r3)
+    insertRecordRow(db, r3);
+}
+function reindexDatabaseRecords(db, databaseId) {
+  db.query("DELETE FROM search_fts WHERE kind = 'record' AND database_id = ?").run(databaseId);
+  for (const r3 of recordBodyRows(db, "r.database_id = ?", databaseId))
+    insertRecordRow(db, r3);
+}
+function fullRebuild(db) {
+  db.query("DELETE FROM search_fts").run();
+  for (const d2 of db.query("SELECT id, title, body, database_id FROM documents WHERE __deleted = 0").all())
+    db.query("INSERT INTO search_fts (kind, id, database_id, title, body) VALUES ('document', ?, ?, ?, ?)").run(d2.id, d2.database_id, d2.title ?? "", d2.body ?? "");
+  for (const r3 of recordBodyRows(db, "1 = 1"))
+    insertRecordRow(db, r3);
+  const max = db.query("SELECT MAX(rowid) AS m FROM crdt_changes").get().m ?? 0;
+  writeMeta(db, "search_seq", String(max));
+  writeMeta(db, "search_index_version", SEARCH_INDEX_VERSION);
+}
+function incrementalUpdate(db) {
+  const cursor = Number(readMeta(db, "search_seq") ?? "0");
+  const { changes, cursor: next } = changesAfterSeq(db, cursor);
+  if (changes.length === 0)
+    return;
+  const docIds = new Set;
+  const recordIds = new Set;
+  const dbIds = new Set;
+  for (const c3 of changes) {
+    switch (c3.dataset) {
+      case "documents":
+        docIds.add(c3.row_id);
+        break;
+      case "doc_blocks": {
+        const blk = db.query("SELECT doc_id FROM doc_blocks WHERE id = ?").get(c3.row_id);
+        if (blk?.doc_id)
+          docIds.add(blk.doc_id);
+        break;
+      }
+      case "records":
+        recordIds.add(c3.row_id);
+        break;
+      case "properties":
+        if (c3.col === "type" || c3.col === "__deleted" || c3.col === "database_id") {
+          const p = db.query("SELECT database_id FROM properties WHERE id = ?").get(c3.row_id);
+          if (p?.database_id)
+            dbIds.add(p.database_id);
+        }
+        break;
+    }
+  }
+  for (const id of docIds)
+    reindexDocument(db, id);
+  for (const dbId of dbIds)
+    reindexDatabaseRecords(db, dbId);
+  for (const id of recordIds) {
+    const r3 = db.query("SELECT database_id FROM records WHERE id = ?").get(id);
+    if (r3?.database_id && dbIds.has(r3.database_id))
+      continue;
+    reindexRecord(db, id);
   }
-  db.query("INSERT INTO meta (key, value) VALUES ('search_hlc', ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(max);
+  writeMeta(db, "search_seq", String(next));
+}
+function ensureIndex(db) {
+  if (!ftsAvailable(db))
+    return false;
+  const version = readMeta(db, "search_index_version");
+  const seq = readMeta(db, "search_seq");
+  db.transaction(() => {
+    if (version !== SEARCH_INDEX_VERSION || seq === null)
+      fullRebuild(db);
+    else
+      incrementalUpdate(db);
+  })();
   return true;
 }
 function ftsSearch(db, query, limit) {
@@ -20166,11 +20403,262 @@ var sync_default = defineCommand({
 init_crdt();
 import { readdirSync, existsSync } from "fs";
 import { join as join5 } from "path";
+
+// src/core/integrity.ts
+init_crdt();
+var REF_RULES = [
+  { srcTable: "properties", fk: "database_id", tgtTable: "databases", fix: "tombstone-src" },
+  { srcTable: "records", fk: "database_id", tgtTable: "databases", fix: "tombstone-src" },
+  { srcTable: "documents", fk: "database_id", tgtTable: "databases", fix: "null-fk" },
+  { srcTable: "documents", fk: "parent_id", tgtTable: "documents", fix: "null-fk" },
+  { srcTable: "doc_blocks", fk: "doc_id", tgtTable: "documents", fix: "tombstone-src" },
+  { srcTable: "site_files", fk: "site_id", tgtTable: "sites", fix: "tombstone-src" }
+];
+function brokenRefRows(db, r3) {
+  return db.query(`SELECT s.id AS id, s.${r3.fk} AS ref FROM ${r3.srcTable} s
+       JOIN ${r3.tgtTable} t ON t.id = s.${r3.fk} AND t.__deleted = 1
+       WHERE s.__deleted = 0 AND s.${r3.fk} IS NOT NULL
+       ORDER BY s.id`).all();
+}
+function detectBrokenRefs(db) {
+  const out = [];
+  for (const r3 of REF_RULES) {
+    for (const row of brokenRefRows(db, r3)) {
+      out.push({
+        category: "broken_ref",
+        entity: r3.srcTable,
+        id: row.id,
+        detail: `${r3.fk} \u2192 deleted ${r3.tgtTable} ${row.ref} (${r3.fix === "tombstone-src" ? "tombstone" : `clear ${r3.fk}`})`,
+        fixable: true
+      });
+    }
+  }
+  return out;
+}
+function repairBrokenRefs(db) {
+  let n2 = 0;
+  for (const r3 of REF_RULES) {
+    for (const row of brokenRefRows(db, r3)) {
+      if (r3.fix === "tombstone-src")
+        emit(db, r3.srcTable, row.id, "__deleted", 1);
+      else
+        emit(db, r3.srcTable, row.id, r3.fk, null);
+      n2++;
+    }
+  }
+  return n2;
+}
+function orphanCellRows(db) {
+  return db.query(`SELECT r.id AS rec, j.key AS prop
+       FROM records r, json_each(coalesce(r.data, '{}')) j
+       JOIN properties p ON p.id = j.key AND p.__deleted = 1
+       WHERE r.__deleted = 0
+       ORDER BY r.id, j.key`).all();
+}
+function detectOrphanCells(db) {
+  return orphanCellRows(db).map((row) => ({
+    category: "orphan_cell",
+    entity: "records",
+    id: row.rec,
+    detail: `cell for deleted property ${row.prop}`,
+    fixable: true
+  }));
+}
+function repairOrphanCells(db) {
+  const rows = orphanCellRows(db);
+  for (const row of rows)
+    emit(db, "records", row.rec, row.prop, undefined);
+  return rows.length;
+}
+function dupPathLosers(db) {
+  const rows = db.query(`SELECT id, site_id, path FROM site_files
+       WHERE __deleted = 0 AND site_id IS NOT NULL AND path IS NOT NULL
+       ORDER BY site_id, path, created_hlc, id`).all();
+  const losers = [];
+  let group = null;
+  for (const r3 of rows) {
+    const key = `${r3.site_id}\x00${r3.path}`;
+    if (key === group)
+      losers.push({ id: r3.id });
+    else
+      group = key;
+  }
+  return losers;
+}
+function detectDupPaths(db) {
+  return dupPathLosers(db).map((row) => ({
+    category: "dup_path",
+    entity: "site_files",
+    id: row.id,
+    detail: "redundant duplicate (site_id, path); loser tombstoned",
+    fixable: true
+  }));
+}
+function repairDupPaths(db) {
+  const losers = dupPathLosers(db);
+  for (const row of losers)
+    emit(db, "site_files", row.id, "__deleted", 1);
+  return losers.length;
+}
+function detectParentCycles(db) {
+  const rows = db.query(`SELECT d.id AS id, d.parent_id AS parent, d.created_hlc AS hlc
+       FROM documents d
+       WHERE d.__deleted = 0 AND d.parent_id IS NOT NULL
+         AND EXISTS (SELECT 1 FROM documents p WHERE p.id = d.parent_id AND p.__deleted = 0)
+       ORDER BY d.id`).all();
+  const parent = new Map(rows.map((r3) => [r3.id, r3.parent]));
+  const hlc = new Map(rows.map((r3) => [r3.id, r3.hlc]));
+  const seen = new Set;
+  const cycles = [];
+  for (const start of parent.keys()) {
+    if (seen.has(start))
+      continue;
+    const path = [];
+    const pos = new Map;
+    let cur = start;
+    while (cur != null && parent.has(cur) && !seen.has(cur)) {
+      if (pos.has(cur)) {
+        cycles.push(path.slice(pos.get(cur)));
+        break;
+      }
+      pos.set(cur, path.length);
+      path.push(cur);
+      cur = parent.get(cur);
+    }
+    for (const n2 of path)
+      seen.add(n2);
+  }
+  return { cycles, hlc };
+}
+function geHlcId(hlc, a2, b2) {
+  const ha = hlc.get(a2) ?? "";
+  const hb = hlc.get(b2) ?? "";
+  if (ha !== hb)
+    return ha > hb;
+  return a2 >= b2;
+}
+function detectCycleIssues(db) {
+  const { cycles } = detectParentCycles(db);
+  return cycles.map((cyc) => ({
+    category: "parent_cycle",
+    entity: "documents",
+    id: [...cyc].sort()[0],
+    detail: `parent cycle: ${[...cyc].sort().join(" \u2192 ")}`,
+    fixable: true
+  }));
+}
+function repairParentCycles(db) {
+  const { cycles, hlc } = detectParentCycles(db);
+  for (const cyc of cycles) {
+    const brk = cyc.reduce((a2, b2) => geHlcId(hlc, a2, b2) ? a2 : b2);
+    emit(db, "documents", brk, "parent_id", null);
+  }
+  return cycles.length;
+}
+function detectDupNames(db) {
+  const out = [];
+  const props = db.query(`SELECT database_id AS db, lower(name) AS n, count(*) AS c, group_concat(id) AS ids
+       FROM properties
+       WHERE __deleted = 0 AND name IS NOT NULL AND database_id IS NOT NULL
+       GROUP BY database_id, lower(name) HAVING c > 1
+       ORDER BY database_id, n`).all();
+  for (const r3 of props)
+    out.push({
+      category: "dup_name",
+      entity: "properties",
+      id: r3.ids.split(",").sort()[0],
+      detail: `${r3.c} properties named "${r3.n}" in database ${r3.db}: ${r3.ids}`,
+      fixable: false
+    });
+  const dbs = db.query(`SELECT lower(name) AS n, count(*) AS c, group_concat(id) AS ids
+       FROM databases WHERE __deleted = 0 AND name IS NOT NULL
+       GROUP BY lower(name) HAVING c > 1 ORDER BY n`).all();
+  for (const r3 of dbs)
+    out.push({
+      category: "dup_name",
+      entity: "databases",
+      id: r3.ids.split(",").sort()[0],
+      detail: `${r3.c} databases named "${r3.n}": ${r3.ids}`,
+      fixable: false
+    });
+  return out;
+}
+function configIssue(type, config2) {
+  if (!PROP_TYPES.has(type))
+    return `unknown property type: ${type}`;
+  if (type === "select" || type === "multi_select") {
+    const opts = config2?.options;
+    if (!Array.isArray(opts) || opts.length === 0 || !opts.every((o3) => typeof o3 === "string"))
+      return `${type} missing config.options: string[]`;
+  }
+  if (type === "relation" && typeof config2?.database !== "string")
+    return "relation missing config.database";
+  return null;
+}
+function detectBadConfig(db) {
+  const rows = db.query("SELECT id, type, config FROM properties WHERE __deleted = 0 ORDER BY id").all();
+  const out = [];
+  for (const r3 of rows) {
+    let config2 = null;
+    try {
+      config2 = r3.config ? JSON.parse(r3.config) : null;
+    } catch {
+      out.push({ category: "bad_config", entity: "properties", id: r3.id, detail: "config is not valid JSON", fixable: false });
+      continue;
+    }
+    const problem = configIssue(r3.type, config2);
+    if (problem)
+      out.push({ category: "bad_config", entity: "properties", id: r3.id, detail: problem, fixable: false });
+  }
+  return out;
+}
+function validateHub(db) {
+  const issues = [
+    ...detectBrokenRefs(db),
+    ...detectOrphanCells(db),
+    ...detectDupPaths(db),
+    ...detectCycleIssues(db),
+    ...detectDupNames(db),
+    ...detectBadConfig(db)
+  ];
+  const counts = {};
+  for (const i2 of issues)
+    counts[i2.category] = (counts[i2.category] ?? 0) + 1;
+  return { ok: issues.length === 0, total: issues.length, counts, issues };
+}
+function repairPass(db) {
+  const fixed = {};
+  const bump = (cat, n2) => {
+    if (n2)
+      fixed[cat] = (fixed[cat] ?? 0) + n2;
+  };
+  bump("broken_ref", repairBrokenRefs(db));
+  bump("orphan_cell", repairOrphanCells(db));
+  bump("dup_path", repairDupPaths(db));
+  bump("parent_cycle", repairParentCycles(db));
+  const applied = Object.values(fixed).reduce((a2, b2) => a2 + b2, 0);
+  return { applied, fixed };
+}
+function repairHub(db) {
+  const fixed = {};
+  let applied = 0;
+  for (let i2 = 0;i2 < 20; i2++) {
+    const pass = repairPass(db);
+    if (pass.applied === 0)
+      break;
+    applied += pass.applied;
+    for (const [cat, n2] of Object.entries(pass.fixed))
+      fixed[cat] = (fixed[cat] ?? 0) + n2;
+  }
+  return { applied, fixed, remaining: validateHub(db) };
+}
+
+// src/core/snapshot.ts
 init_paths();
 init_cache();
 var SNAPSHOT_FORMAT = "metahub-snapshot";
 var SNAPSHOT_VERSION = 1;
-function readMeta(db, key) {
+function readMeta2(db, key) {
   const row = db.query("SELECT value FROM meta WHERE key = ?").get(key);
   return row?.value ?? null;
 }
@@ -20187,8 +20675,8 @@ async function readBlobs() {
 }
 async function createSnapshot(db) {
   const changes = changesAfterSeq(db, 0).changes;
-  const node_id = readMeta(db, "node_id");
-  const hlc = readMeta(db, "hlc");
+  const node_id = readMeta2(db, "node_id");
+  const hlc = readMeta2(db, "hlc");
   const peers = db.query("SELECT url, pull_cursor, push_cursor FROM peers").all();
   const blobs = await readBlobs();
   return {
@@ -20249,8 +20737,9 @@ async function restoreSnapshot(db, pkg, opts = {}) {
   if (!opts.reset) {
     const applied2 = ingest(db, pkg.changes);
     rebuildDeclaredIndexes(db);
+    const repaired2 = repairHub(db).applied;
     const blobs2 = await writeBlobs(pkg.blobs);
-    return { mode: "merge", applied: applied2, blobs: blobs2 };
+    return { mode: "merge", applied: applied2, blobs: blobs2, repaired: repaired2 };
   }
   if (!opts.force)
     throw new Error("refusing to replace local data without --force (a safety snapshot is saved first)");
@@ -20268,7 +20757,7 @@ async function restoreSnapshot(db, pkg, opts = {}) {
       "peers"
     ])
       db.query(`DELETE FROM ${t2}`).run();
-    db.query("DELETE FROM meta WHERE key = 'search_hlc'").run();
+    db.query("DELETE FROM meta WHERE key IN ('search_seq', 'search_index_version')").run();
     if (ftsAvailable(db))
       db.query("DELETE FROM search_fts").run();
     const setMeta2 = db.query("INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value");
@@ -20282,8 +20771,9 @@ async function restoreSnapshot(db, pkg, opts = {}) {
   });
   tx();
   rebuildDeclaredIndexes(db);
+  const repaired = repairHub(db).applied;
   const blobs = await writeBlobs(pkg.blobs);
-  return { mode: "reset", applied, blobs, safetyPath };
+  return { mode: "reset", applied, blobs, repaired, safetyPath };
 }
 
 // src/cli/commands/snapshot.ts
@@ -20332,10 +20822,78 @@ var restore_default = defineCommand({
       reset: !!args.reset,
       force: !!args.force
     });
-    print(result, () => result.mode === "reset" ? `Restored (reset) from ${args.file}: ${result.applied} changes, ${result.blobs} blobs. Safety snapshot: ${result.safetyPath}` : `Merged ${args.file}: ${result.applied} new changes, ${result.blobs} blobs`);
+    print(result, () => result.mode === "reset" ? `Restored (reset) from ${args.file}: ${result.applied} changes, ${result.blobs} blobs, ${result.repaired} repairs. Safety snapshot: ${result.safetyPath}` : `Merged ${args.file}: ${result.applied} new changes, ${result.blobs} blobs, ${result.repaired} repairs`);
   })
 });
 
+// src/cli/commands/doctor.ts
+var doctor_default = defineCommand({
+  meta: {
+    name: "doctor",
+    description: "Scan the hub for logical-integrity issues (read-only; run `mh repair` to fix)"
+  },
+  run: () => {
+    const report = validateHub(openMetahub());
+    print(report, () => {
+      if (report.ok)
+        return "No integrity issues found.";
+      const head = `${report.total} issue(s): ${Object.entries(report.counts).map(([k2, v2]) => `${k2}=${v2}`).join(", ")}`;
+      const rows = report.issues.map((i2) => ({
+        category: i2.category,
+        entity: i2.entity,
+        id: i2.id,
+        fix: i2.fixable ? "auto" : "report",
+        detail: i2.detail
+      }));
+      return `${head}
+
+${table(rows)}`;
+    });
+  }
+});
+
+// src/cli/commands/repair.ts
+var repair_default = defineCommand({
+  meta: {
+    name: "repair",
+    description: "Deterministically fix logical-integrity issues (idempotent; replicates over sync)"
+  },
+  args: {
+    "dry-run": {
+      type: "boolean",
+      description: "Report what would be fixed without changing anything (same as `mh doctor`)"
+    }
+  },
+  run: ({ args }) => {
+    const db = openMetahub();
+    if (args["dry-run"]) {
+      const report = validateHub(db);
+      const fixable = report.issues.filter((i2) => i2.fixable);
+      print({ dryRun: true, ...report }, () => report.ok ? "No integrity issues found." : `Would fix ${fixable.length} of ${report.total} issue(s); ${report.total - fixable.length} report-only.
+
+` + table(report.issues.map((i2) => ({
+        category: i2.category,
+        id: i2.id,
+        fix: i2.fixable ? "auto" : "report",
+        detail: i2.detail
+      }))));
+      return;
+    }
+    const result = repairHub(db);
+    print(result, () => {
+      const fixed = Object.entries(result.fixed).map(([k2, v2]) => `${k2}=${v2}`).join(", ");
+      const head = result.applied === 0 ? "No fixable issues." : `Applied ${result.applied} repair(s): ${fixed}`;
+      const left = result.remaining.issues;
+      if (left.length === 0)
+        return head;
+      return `${head}
+${left.length} report-only issue(s) need manual attention:
+
+` + table(left.map((i2) => ({ category: i2.category, id: i2.id, detail: i2.detail })));
+    });
+  }
+});
+
 // src/cli/commands/config.ts
 init_node();
 
@@ -22251,7 +22809,15 @@ function handle(fn) {
     }
   };
 }
+var VersionSchema = exports_external.object({ version: exports_external.string() });
 var webuiRoutes = [
+  {
+    method: "GET",
+    path: "/api/version",
+    summary: "Version of the running core (sidecar). Used by the desktop app's settings footer.",
+    response: VersionSchema,
+    handler: () => Response.json({ version: package_default.version })
+  },
   {
     method: "GET",
     path: "/api/databases",
@@ -22875,6 +23441,16 @@ function unauthorized() {
 }
 
 // src/core/sync/server.ts
+class PortInUseError extends Error {
+  port;
+  host;
+  constructor(port, host) {
+    super(`port ${port} is already in use \u2014 another mh server may be running. ` + `Stop it, or start on a free port with --port <n>.`);
+    this.port = port;
+    this.host = host;
+    this.name = "PortInUseError";
+  }
+}
 function scalarHtml(specUrl) {
   return `<!doctype html><html><head>
 <meta charset="utf-8"><title>Metahub API</title>
@@ -22899,48 +23475,60 @@ function startServer(opts = {}) {
     ttlMs: DEFAULT_TTL_MS,
     graceMs: DEFAULT_GRACE_MS
   };
-  const server = Bun.serve({
-    port,
-    hostname: host,
-    async fetch(req) {
-      const url2 = new URL(req.url);
-      if (url2.pathname === SYNC_PATH) {
-        if (!acceptsSyncToken(req, url2, auth, db))
-          return unauthorized();
-      } else {
-        const exempt = url2.pathname === HEALTH_PATH || url2.pathname === RENEW_PATH || url2.pathname === PAIR_PATH;
-        if (!exempt && !hasValidToken(req, url2, auth)) {
-          return wantsHtml(req) ? new Response(unlockPage(), { headers: HTML_HEADERS }) : unauthorized();
+  let server;
+  try {
+    server = Bun.serve({
+      port,
+      hostname: host,
+      async fetch(req) {
+        const url2 = new URL(req.url);
+        if (url2.pathname === SYNC_PATH) {
+          if (!acceptsSyncToken(req, url2, auth, db))
+            return unauthorized();
+        } else {
+          const exempt = url2.pathname === HEALTH_PATH || url2.pathname === RENEW_PATH || url2.pathname === PAIR_PATH;
+          if (!exempt && !hasValidToken(req, url2, auth)) {
+            return wantsHtml(req) ? new Response(unlockPage(), { headers: HTML_HEADERS }) : unauthorized();
+          }
         }
+        if (url2.pathname === RENEW_PATH) {
+          const r3 = renewToken(req, url2, auth);
+          return r3 ? Response.json(r3) : unauthorized();
+        }
+        if (req.method === "GET" && url2.pathname === "/docs.json") {
+          return Response.json(buildOpenApi(package_default.version));
+        }
+        if (req.method === "GET" && url2.pathname === "/docs") {
+          return withShim(new Response(scalarHtml("/docs.json"), { headers: HTML_HEADERS }), auth);
+        }
+        if (req.method === "GET" && (url2.pathname === "/" || url2.pathname === "/webui.js")) {
+          const { serveWebui: serveWebui2 } = await Promise.resolve().then(() => (init_webui(), exports_webui));
+          const res = await serveWebui2(req);
+          if (res)
+            return withShim(res, auth);
+        }
+        if (req.method === "GET" && url2.pathname.startsWith("/sites/")) {
+          const { serveSite: serveSite2 } = await Promise.resolve().then(() => (init_sites_serve(), exports_sites_serve));
+          const res = await serveSite2(req, ctx);
+          if (res)
+            return withShim(res, auth);
+        }
+        const route = routes.find((r3) => r3.method === req.method && r3.path === url2.pathname);
+        if (route)
+          return route.handler(req, ctx);
+        return new Response("not found", { status: 404 });
       }
-      if (url2.pathname === RENEW_PATH) {
-        const r3 = renewToken(req, url2, auth);
-        return r3 ? Response.json(r3) : unauthorized();
-      }
-      if (req.method === "GET" && url2.pathname === "/docs.json") {
-        return Response.json(buildOpenApi(package_default.version));
-      }
-      if (req.method === "GET" && url2.pathname === "/docs") {
-        return withShim(new Response(scalarHtml("/docs.json"), { headers: HTML_HEADERS }), auth);
-      }
-      if (req.method === "GET" && (url2.pathname === "/" || url2.pathname === "/webui.js")) {
-        const { serveWebui: serveWebui2 } = await Promise.resolve().then(() => (init_webui(), exports_webui));
-        const res = await serveWebui2(req);
-        if (res)
-          return withShim(res, auth);
-      }
-      if (req.method === "GET" && url2.pathname.startsWith("/sites/")) {
-        const { serveSite: serveSite2 } = await Promise.resolve().then(() => (init_sites_serve(), exports_sites_serve));
-        const res = await serveSite2(req, ctx);
-        if (res)
-          return withShim(res, auth);
-      }
-      const route = routes.find((r3) => r3.method === req.method && r3.path === url2.pathname);
-      if (route)
-        return route.handler(req, ctx);
-      return new Response("not found", { status: 404 });
+    });
+  } catch (e3) {
+    const code = e3?.code;
+    if (code === "EADDRINUSE") {
+      throw new PortInUseError(port, host);
     }
-  });
+    if (code === "EACCES") {
+      throw new Error(`permission denied binding ${host}:${port} \u2014 ports below 1024 need elevated privileges; pick a higher port with --port`);
+    }
+    throw e3;
+  }
   let timer = null;
   if (autoSync && syncIntervalMs > 0) {
     timer = setInterval(() => {
@@ -22949,12 +23537,17 @@ function startServer(opts = {}) {
     timer.unref?.();
   }
   const active = activeToken(auth);
+  const authMode = opts.debug ? "disabled" : opts.token ? "static" : "managed";
   return {
     server,
     node,
     port: server.port ?? port,
+    host,
     token: active?.token ?? null,
     exp: active?.exp ?? null,
+    authMode,
+    autoSync: Boolean(autoSync && syncIntervalMs > 0),
+    syncIntervalMs,
     stop() {
       if (timer)
         clearInterval(timer);
@@ -22963,6 +23556,129 @@ function startServer(opts = {}) {
   };
 }
 
+// src/cli/banner.ts
+var ANSI = /\x1b\[[0-9;]*m/g;
+function supportsColor() {
+  return Boolean(process.stdout.isTTY) && !process.env.NO_COLOR;
+}
+function visibleWidth(s2) {
+  return s2.replace(ANSI, "").length;
+}
+var CODES = {
+  reset: "\x1B[0m",
+  dim: "\x1B[2m",
+  bold: "\x1B[1m",
+  green: "\x1B[32m",
+  cyan: "\x1B[36m",
+  yellow: "\x1B[33m",
+  magenta: "\x1B[35m",
+  red: "\x1B[31m"
+};
+function makePalette(on) {
+  const wrap = (code) => (s2) => on ? `${code}${s2}${CODES.reset}` : s2;
+  return {
+    reset: (s2) => s2,
+    dim: wrap(CODES.dim),
+    bold: wrap(CODES.bold),
+    green: wrap(CODES.green),
+    cyan: wrap(CODES.cyan),
+    yellow: wrap(CODES.yellow),
+    magenta: wrap(CODES.magenta),
+    red: wrap(CODES.red)
+  };
+}
+var MONTHS = [
+  "Jan",
+  "Feb",
+  "Mar",
+  "Apr",
+  "May",
+  "Jun",
+  "Jul",
+  "Aug",
+  "Sep",
+  "Oct",
+  "Nov",
+  "Dec"
+];
+function humanizeExpiry(exp, now = Date.now()) {
+  if (exp == null)
+    return "";
+  if (!Number.isFinite(exp))
+    return "never expires";
+  const ms = exp - now;
+  if (ms <= 0)
+    return "expired";
+  const d2 = new Date(exp);
+  const date5 = `${MONTHS[d2.getMonth()]} ${d2.getDate()}`;
+  const mins = Math.round(ms / 60000);
+  let rel;
+  if (mins < 60)
+    rel = `${mins}m`;
+  else if (mins < 60 * 24)
+    rel = `${Math.round(mins / 60)}h`;
+  else
+    rel = `${Math.round(mins / (60 * 24))} days`;
+  return `expires in ${rel} \xB7 ${date5}`;
+}
+function formatSync(autoSync, ms) {
+  if (!autoSync || ms <= 0)
+    return "auto-sync off";
+  const secs2 = Math.round(ms / 1000);
+  const human = secs2 % 3600 === 0 ? `${secs2 / 3600}h` : secs2 % 60 === 0 ? `${secs2 / 60}m` : `${secs2}s`;
+  return `every ${human}`;
+}
+function isLoopback(host) {
+  return host === "127.0.0.1" || host === "::1" || host === "localhost" || host === "::";
+}
+function renderStartupBanner(info) {
+  const on = info.color ?? supportsColor();
+  const c3 = makePalette(on);
+  const LABEL_W = 7;
+  const label = (t2) => c3.dim(t2.padEnd(LABEL_W));
+  const rows = [];
+  const push = (plain, painted) => rows.push([plain, painted]);
+  push(`\u25CF listening   ${info.host}:${info.port}`, `${c3.green("\u25CF")} ${c3.dim("listening")}   ${c3.bold(`${info.host}:${info.port}`)}`);
+  if (!isLoopback(info.host)) {
+    push("\u26A0 reachable on your network", c3.yellow("\u26A0 reachable on your network"));
+  }
+  push("", "");
+  push(`${"WebUI".padEnd(LABEL_W)}${info.webuiUrl}`, `${label("WebUI")}${c3.cyan(info.webuiUrl)}`);
+  push(`${"Docs".padEnd(LABEL_W)}${info.docsUrl}`, `${label("Docs")}${c3.cyan(info.docsUrl)}`);
+  if (info.authMode === "disabled" || !info.token) {
+    push(`${"Auth".padEnd(LABEL_W)}disabled (--debug)`, `${label("Auth")}${c3.red("disabled")} ${c3.dim("(--debug)")}`);
+  } else {
+    push(`${"Token".padEnd(LABEL_W)}${info.token}`, `${label("Token")}${c3.yellow(info.token)}`);
+    const exp = humanizeExpiry(info.exp);
+    if (exp)
+      push(`${" ".repeat(LABEL_W)}${exp}`, `${" ".repeat(LABEL_W)}${c3.dim(exp)}`);
+  }
+  const sync = formatSync(info.autoSync, info.syncIntervalMs);
+  const syncLabel = info.autoSync && info.syncIntervalMs > 0 ? `sync ${sync}` : sync;
+  push(`${"Node".padEnd(LABEL_W)}${info.node}   \xB7   ${syncLabel}`, `${label("Node")}${info.node}   ${c3.dim("\xB7")}   ${c3.dim(syncLabel)}`);
+  const PAD = 2;
+  const title = "metahub";
+  const ver = `v${info.version}`;
+  const footer = "Ctrl-C to stop";
+  const contentW = Math.max(...rows.map(([plain]) => plain.length), title.length + ver.length + 6, footer.length + 4);
+  const innerW = contentW + PAD * 2;
+  const totalW = innerW + 2;
+  const border = (lc, left, right, rc) => {
+    const leftSeg = left ? `\u2500 ${left} ` : "\u2500";
+    const rightSeg = right ? ` ${right} \u2500` : "\u2500";
+    const dashes = totalW - 2 - visibleWidth(leftSeg) - visibleWidth(rightSeg);
+    return `${lc}${leftSeg}${"\u2500".repeat(Math.max(0, dashes))}${rightSeg}${rc}`;
+  };
+  const top = border("\u256D", c3.bold(c3.magenta(title)), c3.dim(ver), "\u256E");
+  const bottom = border("\u2570", c3.dim(footer), "", "\u256F");
+  const body = rows.map(([plain, painted]) => {
+    const fill = innerW - PAD * 2 - plain.length;
+    return `\u2502${" ".repeat(PAD)}${painted}${" ".repeat(Math.max(0, fill) + PAD)}\u2502`;
+  });
+  return [top, ...body, bottom].join(`
+`);
+}
+
 // src/cli/help.ts
 var ROOT_GUIDE = `metahub \u2014 local knowledge base for AI agents
 Notion-like typed databases (tables + rows) and markdown documents, stored in
@@ -23196,6 +23912,8 @@ var main = defineCommand({
     sync: sync_default,
     snapshot: snapshot_default,
     restore: restore_default,
+    doctor: doctor_default,
+    repair: repair_default,
     config: config_default
   }
 });
@@ -23210,26 +23928,48 @@ var argv2 = process.argv.slice(2);
 if (argv2.includes("--server")) {
   const portFlag = flagValue(argv2, "port");
   const intervalFlag = flagValue(argv2, "sync-interval");
-  const s2 = startServer({
-    port: portFlag != null ? Number(portFlag) : undefined,
-    host: flagValue(argv2, "host"),
-    debug: argv2.includes("--debug"),
-    token: flagValue(argv2, "token") ?? process.env.METAHUB_TOKEN,
-    syncIntervalMs: intervalFlag != null ? parseDuration(intervalFlag, 30000) : undefined,
-    autoSync: argv2.includes("--no-auto-sync") ? false : undefined
-  });
-  const expNote = s2.token && s2.exp != null && Number.isFinite(s2.exp) ? ` (expires ${new Date(s2.exp).toISOString()})` : "";
+  let s2;
+  try {
+    s2 = startServer({
+      port: portFlag != null ? Number(portFlag) : undefined,
+      host: flagValue(argv2, "host"),
+      debug: argv2.includes("--debug"),
+      token: flagValue(argv2, "token") ?? process.env.METAHUB_TOKEN,
+      syncIntervalMs: intervalFlag != null ? parseDuration(intervalFlag, 30000) : undefined,
+      autoSync: argv2.includes("--no-auto-sync") ? false : undefined
+    });
+  } catch (e3) {
+    fail(e3 instanceof Error ? e3.message : String(e3), e3 instanceof PortInUseError ? 98 : 1);
+  }
+  const webui = `http://localhost:${s2.port}`;
+  const docs = `${webui}/docs`;
   print({
     server: "listening",
     port: s2.port,
+    host: s2.host,
     nodeId: s2.node,
     docs: `/docs`,
+    webui,
+    authMode: s2.authMode,
     token: s2.token,
-    exp: s2.exp != null && Number.isFinite(s2.exp) ? s2.exp : null
-  }, () => `metahub sync server on :${s2.port} (node ${s2.node}) \u2014 docs at http://localhost:${s2.port}/docs
-` + (s2.token ? `auth token: ${s2.token}${expNote}` : `auth: disabled (--debug)`));
+    exp: s2.exp != null && Number.isFinite(s2.exp) ? s2.exp : null,
+    autoSync: s2.autoSync,
+    syncIntervalMs: s2.syncIntervalMs
+  }, () => renderStartupBanner({
+    version: package_default.version,
+    host: s2.host,
+    port: s2.port,
+    webuiUrl: webui,
+    docsUrl: docs,
+    authMode: s2.authMode,
+    token: s2.token,
+    exp: s2.exp,
+    node: s2.node,
+    autoSync: s2.autoSync,
+    syncIntervalMs: s2.syncIntervalMs
+  }));
 } else {
   runMain(main, { showUsage: showUsage2 });
 }
 
-//# debugId=10C9A2ACC0C4883B64756E2164756E21
+//# debugId=25AC050A4B6CCBA264756E2164756E21