@tensorix/metahub 0.1.7 → 0.1.9

package/dist/index.js

@@ -342,7 +342,7 @@ var init_crdt = __esm(() => {
     },
     documents: {
       table: "documents",
-      cols: new Set(["title", "body", "database_id", "parent_id", "created_hlc", "__deleted"])
+      cols: new Set(["title", "body", "database_id", "parent_id", "created_hlc", "order_key", "__deleted"])
     },
     doc_blocks: {
       table: "doc_blocks",
@@ -398,6 +398,24 @@ function inferContentType(path) {
   const ext = path.slice(path.lastIndexOf(".") + 1).toLowerCase();
   return MIME[ext] ?? "application/octet-stream";
 }
+function normalizeSiteName(raw) {
+  const slug = raw.trim().toLowerCase().replace(/[^a-z0-9-]+/g, "-").replace(/^-+|-+$/g, "");
+  if (!slug)
+    throw new Error(`invalid site name: ${JSON.stringify(raw)}`);
+  return slug;
+}
+function normalizeSitePath(raw) {
+  const segs = [];
+  for (const seg of raw.split("/")) {
+    if (seg === "" || seg === ".")
+      continue;
+    if (seg === "..")
+      segs.pop();
+    else
+      segs.push(seg);
+  }
+  return segs.join("/");
+}
 function isTextType(contentType) {
   const ct = contentType.toLowerCase();
   return ct.startsWith("text/") || ct.startsWith("application/json") || ct.startsWith("application/manifest+json") || ct.startsWith("application/xml") || ct.startsWith("text/javascript") || ct.startsWith("application/javascript") || ct.startsWith("image/svg+xml");
@@ -408,10 +426,11 @@ function toBytes(data) {
   return data instanceof Uint8Array ? data : new Uint8Array(data);
 }
 function createSite(db, opts) {
-  if (getSiteByName(db, opts.name))
-    throw new Error(`site name already exists: ${opts.name}`);
-  const id = newId("site", opts.name);
-  const first = emit(db, "sites", id, "name", opts.name);
+  const name = normalizeSiteName(opts.name);
+  if (getSiteByName(db, name))
+    throw new Error(`site name already exists: ${name}`);
+  const id = newId("site", name);
+  const first = emit(db, "sites", id, "name", name);
   emit(db, "sites", id, "created_hlc", first.hlc);
   if (opts.title !== undefined)
     emit(db, "sites", id, "title", opts.title);
@@ -421,7 +440,13 @@ function getSite(db, id) {
   return db.query("SELECT id, name, title, created_hlc FROM sites WHERE id = ? AND __deleted = 0").get(id);
 }
 function getSiteByName(db, name) {
-  return db.query("SELECT id, name, title, created_hlc FROM sites WHERE name = ? AND __deleted = 0 ORDER BY created_hlc DESC LIMIT 1").get(name);
+  let slug;
+  try {
+    slug = normalizeSiteName(name);
+  } catch {
+    return null;
+  }
+  return db.query("SELECT id, name, title, created_hlc FROM sites WHERE name = ? AND __deleted = 0 ORDER BY created_hlc DESC LIMIT 1").get(slug);
 }
 function listSites(db) {
   return db.query("SELECT id, name, title, created_hlc FROM sites WHERE __deleted = 0 ORDER BY created_hlc").all();
@@ -433,6 +458,20 @@ function resolveSite(db, ref) {
     throw new Error(`no such site: ${ref}`);
   return site;
 }
+function updateSite(db, id, opts) {
+  if (!getSite(db, id))
+    throw new Error(`no such site: ${id}`);
+  if (opts.name !== undefined) {
+    const name = normalizeSiteName(opts.name);
+    const dup = getSiteByName(db, name);
+    if (dup && dup.id !== id)
+      throw new Error(`site name already exists: ${name}`);
+    emit(db, "sites", id, "name", name);
+  }
+  if (opts.title !== undefined)
+    emit(db, "sites", id, "title", opts.title);
+  return getSite(db, id);
+}
 function deleteSite(db, id) {
   if (!getSite(db, id))
     return false;
@@ -447,7 +486,10 @@ function fileIdFor(db, siteId, path) {
   return row?.id ?? null;
 }
 async function putFile(db, siteId, path, opts) {
-  const contentType = opts.contentType ?? inferContentType(path);
+  const cleanPath = normalizeSitePath(path);
+  if (!cleanPath)
+    throw new Error(`invalid file path: ${JSON.stringify(path)}`);
+  const contentType = opts.contentType ?? inferContentType(cleanPath);
   const bytes = toBytes(opts.data);
   let encoding;
   let content;
@@ -461,11 +503,11 @@ async function putFile(db, siteId, path, opts) {
     encoding = "blob";
     content = (await putBlob(bytes)).hash;
   }
-  const existing = fileIdFor(db, siteId, path);
-  const id = existing ?? newId("sf", path);
+  const existing = fileIdFor(db, siteId, cleanPath);
+  const id = existing ?? newId("sf", cleanPath);
   if (!existing) {
     const first = emit(db, "site_files", id, "site_id", siteId);
-    emit(db, "site_files", id, "path", path);
+    emit(db, "site_files", id, "path", cleanPath);
     emit(db, "site_files", id, "created_hlc", first.hlc);
   }
   emit(db, "site_files", id, "content_type", contentType);
@@ -478,7 +520,7 @@ function listFiles(db, siteId) {
   return db.query("SELECT id, site_id, path, content_type, encoding FROM site_files WHERE site_id = ? AND __deleted = 0 ORDER BY path").all(siteId);
 }
 function deleteFile(db, siteId, path) {
-  const id = fileIdFor(db, siteId, path);
+  const id = fileIdFor(db, siteId, normalizeSitePath(path));
   if (!id)
     return false;
   const live = db.query("SELECT __deleted AS d FROM site_files WHERE id = ?").get(id);
@@ -488,7 +530,10 @@ function deleteFile(db, siteId, path) {
   return true;
 }
 async function getFileForServe(db, siteId, path) {
-  const p = path === "" || path.endsWith("/") ? `${path}index.html` : path;
+  const withIndex = path === "" || path.endsWith("/") ? `${path}index.html` : path;
+  const p = normalizeSitePath(withIndex);
+  if (!p)
+    return null;
   const row = db.query("SELECT content_type, encoding, content FROM site_files WHERE site_id = ? AND path = ? AND __deleted = 0 ORDER BY created_hlc LIMIT 1").get(siteId, p);
   if (!row)
     return null;
@@ -684,7 +729,7 @@ var HTML = `<!doctype html>
   .sb-section-head .add { opacity:0; padding:3px; border-radius:5px; color:var(--muted); transition:opacity .12s; }
   .sb-section:hover .add { opacity:1; }
   .sb-section-head .add:hover { background:var(--hover-2); color:var(--fg); }
-  .navitem { display:flex; align-items:center; gap:3px; width:100%; text-align:left; padding:5px 6px; border-radius:var(--radius-sm);
+  .navitem { display:flex; align-items:center; gap:3px; width:100%; text-align:left; padding:5px 6px; margin-bottom:2px; border-radius:var(--radius-sm);
     color:var(--fg-soft); font-size:13.5px; position:relative; white-space:nowrap; transition:background .1s; }
   .navitem:hover { background:var(--hover-2); }
   .navitem.active { background:var(--bg); color:var(--fg); font-weight:600; box-shadow:var(--shadow-sm); }
@@ -784,6 +829,21 @@ var HTML = `<!doctype html>
   .btn-primary:hover { filter:brightness(1.07); }
   .btn-danger { background:var(--danger); color:#fff; } .btn-danger:hover { filter:brightness(1.05); }
 
+  /* desktop app (frameless): drop the sidebar logo; on macOS reserve a draggable
+     strip for the inset traffic lights so they never overlap our controls */
+  body.desktop .brand { display:none; }
+  /* logo gone \u2192 keep the collapse button on the right (where .brand's flex used to push it) */
+  body.desktop .sb-head .iconbtn { margin-left:auto; }
+  body.desktop-mac .sb-head { -webkit-app-region:drag; }
+  body.desktop-mac .sb-head .iconbtn { -webkit-app-region:no-drag; }
+  body.desktop-mac .topbar { -webkit-app-region:drag; }
+  body.desktop-mac .topbar .iconbtn, body.desktop-mac .topbar .btn { -webkit-app-region:no-drag; }
+  /* peek drawer header overlaps the topbar drag region \u2192 clear its buttons so they stay clickable */
+  body.desktop-mac .peek-head { -webkit-app-region:drag; }
+  body.desktop-mac .peek-head .iconbtn, body.desktop-mac .peek-head .btn { -webkit-app-region:no-drag; }
+  /* sidebar collapsed \u2192 traffic lights sit over the main header; clear the hamburger */
+  body.desktop-mac .sidebar.collapsed ~ .main .topbar { padding-left:80px; }
+
   /* document editor */
   .doc { max-width:740px; margin:0 auto; padding:60px 60px 36vh; }
   .doc-title { font-size:38px; font-weight:700; letter-spacing:-.02em; outline:none; line-height:1.15; margin-bottom:4px; }
@@ -1015,6 +1075,83 @@ var HTML = `<!doctype html>
   .gridfoot { display:flex; gap:18px; color:var(--muted); font-size:12px; padding:8px 2px; }
   input.inlineedit { width:100%; border:0; outline:2px solid var(--accent); border-radius:4px; padding:7px 9px; background:var(--bg); color:var(--fg); font:inherit; }
 
+  /* ---- sites (\u7AD9\u70B9\u7BA1\u7406) ---- */
+  .sites-grid { display:grid; grid-template-columns:repeat(auto-fill, minmax(264px, 1fr)); gap:14px; margin-top:6px; }
+  .site-card { display:flex; flex-direction:column; gap:13px; padding:16px 16px 14px; background:var(--bg); border:1px solid var(--line);
+    border-radius:var(--radius); box-shadow:var(--shadow-sm); cursor:pointer; transition:box-shadow .16s, border-color .16s, transform .16s; }
+  .site-card:hover { box-shadow:var(--shadow-md); border-color:var(--line-strong); transform:translateY(-1px); }
+  .site-card-head { display:flex; align-items:center; gap:11px; min-width:0; }
+  .site-card .si { width:40px; height:40px; border-radius:11px; background:var(--accent-soft); color:var(--accent); display:grid; place-items:center; flex:none; }
+  .site-card .si svg { width:20px; height:20px; }
+  .site-card-id { min-width:0; }
+  .site-card .slug { font-family:var(--mono); font-weight:600; font-size:14.5px; color:var(--fg); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+  .site-card .ttl { font-size:12px; color:var(--fg-soft); margin-top:1px; overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+  .site-card .ttl.muted { color:var(--muted); font-style:italic; }
+  .site-addr { display:flex; align-items:center; gap:6px; width:100%; text-align:left; background:var(--surface); border:1px solid var(--line);
+    border-radius:var(--radius-sm); padding:6px 9px; color:var(--muted); font-family:var(--mono); font-size:11.5px; transition:border-color .12s, color .12s; }
+  .site-addr svg { flex:none; }
+  .site-addr span { overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+  .site-addr:hover { border-color:var(--accent); color:var(--accent); }
+  .site-card-meta { display:flex; align-items:center; gap:7px; font-size:12px; color:var(--muted); }
+  .site-card-meta b { color:var(--fg-soft); font-weight:600; font-variant-numeric:tabular-nums; }
+  .site-card-meta .dot { color:var(--line-strong); }
+  .site-card-foot { display:flex; align-items:center; gap:6px; padding-top:12px; margin-top:1px; border-top:1px solid var(--line); }
+  .site-card-foot .btn-secondary { padding:6px 12px; justify-content:center; }
+
+  .site-empty { text-align:center; color:var(--muted); border:1px dashed var(--line-strong); border-radius:var(--radius); padding:48px 24px; margin-top:8px; }
+  .site-empty .ei { font-size:30px; margin-bottom:10px; }
+  .site-empty .et { font-size:14px; color:var(--fg-soft); margin-bottom:4px; font-weight:600; }
+  .site-empty .ed { font-size:12.5px; margin-bottom:16px; }
+
+  /* site peek: access bar + file manager */
+  .acc-link { display:flex; align-items:center; gap:6px; background:var(--surface); border:1px solid var(--line); border-radius:var(--radius-sm); padding:7px 8px 7px 11px; margin-bottom:16px; }
+  .acc-link .url { flex:1; font-family:var(--mono); font-size:12.5px; color:var(--fg-soft); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+  .acc-link button { width:28px; height:28px; display:grid; place-items:center; border-radius:6px; color:var(--muted); flex:none; }
+  .acc-link button:hover { background:var(--hover-2); color:var(--fg); }
+  .acc-link button.accent { color:var(--accent); }
+  .site-meta { display:flex; gap:18px; color:var(--muted); font-size:12px; margin-bottom:20px; }
+  .site-meta b { color:var(--fg); font-weight:600; }
+  .files-head { display:flex; align-items:center; justify-content:space-between; font-size:11px; font-weight:600; text-transform:uppercase; letter-spacing:.05em; color:var(--muted); margin:0 0 4px; }
+  .filerow { display:flex; align-items:center; gap:10px; padding:9px 8px; border-radius:var(--radius-sm); cursor:pointer; border-bottom:1px solid var(--line); }
+  .filerow:last-child { border-bottom:0; }
+  .filerow:hover { background:var(--hover); }
+  .filerow .fi { color:var(--muted); display:grid; place-items:center; flex:none; }
+  .filerow .fpath { flex:1; font-family:var(--mono); font-size:12.5px; color:var(--fg); overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+  .filerow .facts { display:flex; gap:1px; opacity:0; flex:none; }
+  .filerow:hover .facts { opacity:1; }
+  .filerow .facts button { width:27px; height:27px; display:grid; place-items:center; border-radius:6px; color:var(--muted); }
+  .filerow .facts button:hover { background:var(--hover-2); color:var(--fg); }
+  .filerow .facts button.del:hover { color:var(--danger); }
+  .enc-badge { display:inline-flex; align-items:center; font-family:var(--mono); font-size:10.5px; font-weight:500; letter-spacing:.02em;
+    padding:2px 6px; border-radius:5px; background:var(--surface-2); color:var(--fg-soft); border:1px solid var(--line); }
+  .enc-badge.blob { color:var(--accent); background:var(--accent-soft); border-color:transparent; }
+
+  /* file preview (inside modal) */
+  .preview-box { font-family:var(--mono); font-size:12.5px; background:var(--surface-2); border:1px solid var(--line); border-radius:var(--radius);
+    padding:14px 16px; max-height:52vh; overflow:auto; white-space:pre-wrap; line-height:1.6; color:var(--fg); }
+  .preview-bin { text-align:center; color:var(--muted); border:1px dashed var(--line-strong); border-radius:var(--radius); padding:40px 20px; }
+  .preview-bin .pi { font-size:28px; margin-bottom:8px; }
+  .preview-bin .pt { color:var(--fg-soft); font-size:13px; }
+
+  /* in-app site preview (browser-framed iframe) */
+  .spv-scrim { position:fixed; inset:0; background:rgba(15,15,25,.5); z-index:85; display:grid; place-items:center; padding:28px;
+    opacity:0; pointer-events:none; transition:opacity .16s; animation:spv-in .16s forwards; }
+  @keyframes spv-in { to { opacity:1; pointer-events:auto; } }
+  .spv-scrim.open { opacity:1; pointer-events:auto; }
+  .spv { width:min(1100px, 92vw); height:88vh; background:var(--bg); border-radius:14px; box-shadow:var(--shadow-lg);
+    display:flex; flex-direction:column; overflow:hidden; }
+  .spv-chrome { display:flex; align-items:center; gap:10px; padding:9px 12px; border-bottom:1px solid var(--line); background:var(--surface); }
+  .spv-dots { display:flex; gap:6px; flex:none; }
+  .spv-dots i { width:11px; height:11px; border-radius:50%; background:var(--line-strong); }
+  .spv-url { flex:1; display:flex; align-items:center; gap:6px; min-width:0; background:var(--bg); border:1px solid var(--line);
+    border-radius:7px; padding:5px 10px; color:var(--fg-soft); font-family:var(--mono); font-size:12px; }
+  .spv-url svg { color:var(--muted); flex:none; }
+  .spv-url span { overflow:hidden; text-overflow:ellipsis; white-space:nowrap; }
+  .spv-btn { display:inline-flex; align-items:center; gap:5px; flex:none; padding:6px 10px; border-radius:7px; color:var(--fg-soft); font-size:12.5px; font-weight:500; }
+  .spv-btn:hover { background:var(--hover-2); color:var(--fg); }
+  .spv-btn.icon { padding:6px; }
+  .spv-frame { flex:1; width:100%; border:0; background:#fff; }
+
   .selbar { position:fixed; bottom:24px; left:50%; transform:translateX(-50%); z-index:65; display:flex; align-items:center; gap:4px;
     background:var(--fg); color:var(--bg); padding:7px 8px 7px 14px; border-radius:11px; box-shadow:var(--shadow-lg); }
   .selbar .cnt { font-size:13px; font-weight:600; margin-right:6px; }
@@ -1466,6 +1603,7 @@ CREATE TABLE IF NOT EXISTS documents (
   database_id TEXT,
   parent_id   TEXT,
   created_hlc TEXT,
+  order_key   TEXT,        -- fractional index among siblings (same parent_id); ties broken by created_hlc,id
   __deleted   INTEGER NOT NULL DEFAULT 0
 );
 
@@ -2108,103 +2246,6 @@ function deleteRecord(db, id) {
   return true;
 }
 
-// src/core/db.ts
-function ensureDirs() {
-  mkdirSync(metahubHome(), { recursive: true });
-  mkdirSync(cacheDir(), { recursive: true });
-}
-function runSchema(db) {
-  db.exec(CORE_SCHEMA);
-  try {
-    db.exec(FTS_SCHEMA);
-  } catch {}
-}
-function ftsAvailable(db) {
-  const row = db.query("SELECT 1 AS ok FROM sqlite_master WHERE name = 'search_fts'").get();
-  return row != null;
-}
-function hasColumn(db, table, column) {
-  const cols = db.query(`PRAGMA table_info(${table})`).all();
-  return cols.some((c) => c.name === column);
-}
-function tableExists2(db, table) {
-  return db.query("SELECT 1 AS ok FROM sqlite_master WHERE type = 'table' AND name = ?").get(table) != null;
-}
-function migrateRecords(db) {
-  if (!hasColumn(db, "records", "data"))
-    db.exec("ALTER TABLE records ADD COLUMN data TEXT NOT NULL DEFAULT '{}'");
-  if (!hasColumn(db, "records", "order_key"))
-    db.exec("ALTER TABLE records ADD COLUMN order_key TEXT");
-  if (!tableExists2(db, "record_values"))
-    return;
-  const tx = db.transaction(() => {
-    db.exec(`
-      UPDATE records SET data = coalesce((
-        SELECT json_group_object(rv.property_id, json(rv.value))
-        FROM record_values rv WHERE rv.record_id = records.id
-      ), '{}')
-      WHERE id IN (SELECT DISTINCT record_id FROM record_values);
-    `);
-    db.exec("DROP TABLE record_values");
-    backfillRecordOrderKeys(db);
-  });
-  tx();
-  backfillRecordOrderKeys(db);
-}
-function migratePeers(db) {
-  const add = [
-    ["token", "TEXT"],
-    ["label", "TEXT"],
-    ["node_id", "TEXT"],
-    ["enabled", "INTEGER NOT NULL DEFAULT 1"],
-    ["last_sync_at", "INTEGER"],
-    ["last_status", "TEXT"],
-    ["last_error", "TEXT"]
-  ];
-  for (const [col, decl] of add) {
-    if (!hasColumn(db, "peers", col))
-      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 });
-  db.exec("PRAGMA journal_mode = WAL;");
-  runSchema(db);
-  migrateRecords(db);
-  migratePeers(db);
-  migrateDocBlocks(db);
-  return db;
-}
-
-// src/core/index.ts
-init_ids();
-init_crdt();
-init_node();
-
-// src/core/context.ts
-var KEY = "current_db";
-function getCurrentDatabase(db) {
-  const row = db.query("SELECT value FROM meta WHERE key = ?").get(KEY);
-  if (!row)
-    return null;
-  const found = getDatabase(db, row.value);
-  if (!found) {
-    clearCurrentDatabase(db);
-    return null;
-  }
-  return found;
-}
-function setCurrentDatabase(db, id) {
-  db.query("INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(KEY, id);
-}
-function clearCurrentDatabase(db) {
-  db.query("DELETE FROM meta WHERE key = ?").run(KEY);
-}
 // src/core/documents.ts
 init_ids();
 init_crdt();
@@ -2276,6 +2317,7 @@ function createDocument(db, opts) {
     emit(db, "documents", id, "database_id", opts.database_id);
   if (opts.parent_id !== undefined)
     emit(db, "documents", id, "parent_id", opts.parent_id);
+  placeInSiblings(db, id, opts.parent_id ?? null);
   if (opts.body !== undefined) {
     const blocks = parseDocBlocks(opts.body);
     if (blocks.length)
@@ -2284,15 +2326,111 @@ function createDocument(db, opts) {
   return getDocument(db, id);
 }
 function getDocument(db, id) {
-  return db.query("SELECT id, title, body, database_id, parent_id, created_hlc FROM documents WHERE id = ? AND __deleted = 0").get(id);
+  return db.query("SELECT id, title, body, database_id, parent_id, created_hlc, order_key FROM documents WHERE id = ? AND __deleted = 0").get(id);
 }
+var ORDER_BY = "ORDER BY order_key IS NULL, order_key, created_hlc, id";
 function listDocuments(db, opts = {}) {
-  const cols = "SELECT id, title, database_id, parent_id, created_hlc FROM documents WHERE __deleted = 0";
+  const cols = "SELECT id, title, database_id, parent_id, created_hlc, order_key FROM documents WHERE __deleted = 0";
   if (opts.parent_id !== undefined)
-    return db.query(`${cols} AND parent_id = ? ORDER BY created_hlc`).all(opts.parent_id);
+    return db.query(`${cols} AND parent_id = ? ${ORDER_BY}`).all(opts.parent_id);
   if (opts.database_id)
-    return db.query(`${cols} AND database_id = ? ORDER BY created_hlc`).all(opts.database_id);
-  return db.query(`${cols} ORDER BY created_hlc`).all();
+    return db.query(`${cols} AND database_id = ? ${ORDER_BY}`).all(opts.database_id);
+  return db.query(`${cols} ${ORDER_BY}`).all();
+}
+function siblingWhere(parentId) {
+  return parentId === null ? { clause: "parent_id IS NULL", args: [] } : { clause: "parent_id = ?", args: [parentId] };
+}
+function canEmitOrderKeys2(db) {
+  return tableExists2(db, "meta") && tableExists2(db, "crdt_changes");
+}
+function tableExists2(db, table) {
+  return db.query("SELECT 1 AS ok FROM sqlite_master WHERE type = 'table' AND name = ?").get(table) != null;
+}
+function lastSiblingOrderKey(db, parentId, excludeId) {
+  const w = siblingWhere(parentId);
+  const exclude = excludeId ? " AND id <> ?" : "";
+  const row = db.query(`SELECT order_key FROM documents WHERE ${w.clause}${exclude}
+       AND __deleted = 0 AND order_key IS NOT NULL
+       ORDER BY order_key DESC, id DESC LIMIT 1`).get(...w.args, ...excludeId ? [excludeId] : []);
+  return row?.order_key ?? null;
+}
+function orderedSiblings(db, parentId) {
+  const w = siblingWhere(parentId);
+  return db.query(`SELECT id, order_key FROM documents WHERE ${w.clause} AND __deleted = 0 ${ORDER_BY}`).all(...w.args);
+}
+function rebalanceSiblings(db, parentId) {
+  const rows = orderedSiblings(db, parentId);
+  const keys = keysBetween(null, null, rows.length);
+  rows.forEach((row, i) => {
+    if (row.order_key !== keys[i])
+      emit(db, "documents", row.id, "order_key", keys[i]);
+  });
+}
+function backfillSiblings(db, parentId) {
+  const emitChange = canEmitOrderKeys2(db);
+  const w = siblingWhere(parentId);
+  const missing = db.query(`SELECT id FROM documents WHERE ${w.clause} AND __deleted = 0 AND order_key IS NULL
+       ORDER BY created_hlc, id`).all(...w.args);
+  if (!missing.length)
+    return;
+  const keys = keysBetween(lastSiblingOrderKey(db, parentId), null, missing.length);
+  missing.forEach((row, i) => {
+    if (emitChange)
+      emit(db, "documents", row.id, "order_key", keys[i]);
+    else
+      db.query("UPDATE documents SET order_key = ? WHERE id = ?").run(keys[i], row.id);
+  });
+}
+function backfillDocumentOrderKeys(db) {
+  const parents = db.query("SELECT DISTINCT parent_id FROM documents WHERE __deleted = 0 AND order_key IS NULL").all();
+  for (const p of parents)
+    backfillSiblings(db, p.parent_id);
+}
+function placeInSiblings(db, id, parentId, anchor) {
+  let cur = parentId;
+  while (cur) {
+    if (cur === id)
+      throw new Error(`cannot set parent_id: would create a cycle (${id})`);
+    cur = getDocument(db, cur)?.parent_id ?? null;
+  }
+  const current = getDocument(db, id);
+  if (current && (current.parent_id ?? null) !== parentId)
+    emit(db, "documents", id, "parent_id", parentId);
+  let key;
+  if (!anchor) {
+    key = keyBetween(lastSiblingOrderKey(db, parentId, id), null);
+  } else {
+    backfillSiblings(db, parentId);
+    const neighbors = () => {
+      const rows = orderedSiblings(db, parentId).filter((r) => r.id !== id);
+      const to = rows.findIndex((r) => r.id === anchor.targetId);
+      if (to < 0)
+        throw new Error(`no such target document: ${anchor.targetId}`);
+      return anchor.where === "before" ? [rows[to - 1]?.order_key ?? null, rows[to].order_key] : [rows[to].order_key, rows[to + 1]?.order_key ?? null];
+    };
+    let [left, right] = neighbors();
+    if (left !== null && right !== null && left >= right) {
+      rebalanceSiblings(db, parentId);
+      [left, right] = neighbors();
+    }
+    key = keyBetween(left, right);
+  }
+  emit(db, "documents", id, "order_key", key);
+}
+function moveDocument(db, id, targetId, where) {
+  const src = getDocument(db, id);
+  if (!src)
+    throw new Error(`no such document: ${id}`);
+  if (id === targetId)
+    return src;
+  const target = getDocument(db, targetId);
+  if (!target)
+    throw new Error(`no such target document: ${targetId}`);
+  if (where === "into")
+    placeInSiblings(db, id, targetId);
+  else
+    placeInSiblings(db, id, target.parent_id, { targetId, where });
+  return getDocument(db, id);
 }
 function updateDocument(db, id, fields) {
   if (!getDocument(db, id))
@@ -2302,13 +2440,9 @@ function updateDocument(db, id, fields) {
   if (fields.database_id !== undefined)
     emit(db, "documents", id, "database_id", fields.database_id);
   if (fields.parent_id !== undefined) {
-    let cur = fields.parent_id;
-    while (cur) {
-      if (cur === id)
-        throw new Error(`cannot set parent_id: would create a cycle (${id})`);
-      cur = getDocument(db, cur)?.parent_id ?? null;
-    }
-    emit(db, "documents", id, "parent_id", fields.parent_id);
+    const next = fields.parent_id ?? null;
+    if ((getDocument(db, id).parent_id ?? null) !== next)
+      placeInSiblings(db, id, next);
   }
   if (fields.body !== undefined) {
     ensureBlocks(db, id);
@@ -2396,6 +2530,110 @@ function countOccurrences(haystack, needle) {
   }
   return n;
 }
+
+// src/core/db.ts
+function ensureDirs() {
+  mkdirSync(metahubHome(), { recursive: true });
+  mkdirSync(cacheDir(), { recursive: true });
+}
+function runSchema(db) {
+  db.exec(CORE_SCHEMA);
+  try {
+    db.exec(FTS_SCHEMA);
+  } catch {}
+}
+function ftsAvailable(db) {
+  const row = db.query("SELECT 1 AS ok FROM sqlite_master WHERE name = 'search_fts'").get();
+  return row != null;
+}
+function hasColumn(db, table, column) {
+  const cols = db.query(`PRAGMA table_info(${table})`).all();
+  return cols.some((c) => c.name === column);
+}
+function tableExists3(db, table) {
+  return db.query("SELECT 1 AS ok FROM sqlite_master WHERE type = 'table' AND name = ?").get(table) != null;
+}
+function migrateRecords(db) {
+  if (!hasColumn(db, "records", "data"))
+    db.exec("ALTER TABLE records ADD COLUMN data TEXT NOT NULL DEFAULT '{}'");
+  if (!hasColumn(db, "records", "order_key"))
+    db.exec("ALTER TABLE records ADD COLUMN order_key TEXT");
+  if (!tableExists3(db, "record_values"))
+    return;
+  const tx = db.transaction(() => {
+    db.exec(`
+      UPDATE records SET data = coalesce((
+        SELECT json_group_object(rv.property_id, json(rv.value))
+        FROM record_values rv WHERE rv.record_id = records.id
+      ), '{}')
+      WHERE id IN (SELECT DISTINCT record_id FROM record_values);
+    `);
+    db.exec("DROP TABLE record_values");
+    backfillRecordOrderKeys(db);
+  });
+  tx();
+  backfillRecordOrderKeys(db);
+}
+function migratePeers(db) {
+  const add = [
+    ["token", "TEXT"],
+    ["label", "TEXT"],
+    ["node_id", "TEXT"],
+    ["enabled", "INTEGER NOT NULL DEFAULT 1"],
+    ["last_sync_at", "INTEGER"],
+    ["last_status", "TEXT"],
+    ["last_error", "TEXT"]
+  ];
+  for (const [col, decl] of add) {
+    if (!hasColumn(db, "peers", col))
+      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 migrateDocuments(db) {
+  if (!hasColumn(db, "documents", "order_key"))
+    db.exec("ALTER TABLE documents ADD COLUMN order_key TEXT");
+  backfillDocumentOrderKeys(db);
+}
+function openMetahub() {
+  ensureDirs();
+  const db = new Database(dbPath(), { create: true });
+  db.exec("PRAGMA journal_mode = WAL;");
+  runSchema(db);
+  migrateRecords(db);
+  migratePeers(db);
+  migrateDocBlocks(db);
+  migrateDocuments(db);
+  return db;
+}
+
+// src/core/index.ts
+init_ids();
+init_crdt();
+init_node();
+
+// src/core/context.ts
+var KEY = "current_db";
+function getCurrentDatabase(db) {
+  const row = db.query("SELECT value FROM meta WHERE key = ?").get(KEY);
+  if (!row)
+    return null;
+  const found = getDatabase(db, row.value);
+  if (!found) {
+    clearCurrentDatabase(db);
+    return null;
+  }
+  return found;
+}
+function setCurrentDatabase(db, id) {
+  db.query("INSERT INTO meta (key, value) VALUES (?, ?) ON CONFLICT(key) DO UPDATE SET value = excluded.value").run(KEY, id);
+}
+function clearCurrentDatabase(db) {
+  db.query("DELETE FROM meta WHERE key = ?").run(KEY);
+}
 // src/core/search.ts
 init_crdt();
 var TEXT_TYPES = "('text','url','select','multi_select','date')";
@@ -17016,7 +17254,7 @@ function getServerConfig(db) {
 // package.json
 var package_default = {
   name: "@tensorix/metahub",
-  version: "0.1.7",
+  version: "0.1.9",
   description: "Metahub core library and CLI",
   license: "AGPL-3.0-only",
   type: "module",
@@ -17053,10 +17291,13 @@ var package_default = {
     citty: "^0.1.6",
     "highlight.js": "^11.11.1",
     preact: "^10.29.2",
+    turndown: "^7.2.4",
+    "turndown-plugin-gfm": "^1.0.2",
     zod: "^4.4.3"
   },
   devDependencies: {
     "@types/bun": "latest",
+    "@types/turndown": "^5.0.6",
     typescript: "^5"
   }
 };
@@ -17082,7 +17323,7 @@ var PropertySchema = exports_external.object({
 var RecordSchema = exports_external.object({
   id: exports_external.string(),
   database_id: exports_external.string(),
-  values: exports_external.record(exports_external.string(), exports_external.any())
+  values: exports_external.record(exports_external.string(), exports_external.any()).describe('Field values keyed by property name (e.g. {"Amount":35}). Reads nest cells here; writes take a flat {column: value} map.')
 });
 var MoveRecordReq = exports_external.object({
   target: exports_external.string(),
@@ -17093,7 +17334,12 @@ var DocumentSummarySchema = exports_external.object({
   title: exports_external.string(),
   database_id: exports_external.string().nullable(),
   parent_id: exports_external.string().nullable(),
-  created_hlc: exports_external.string()
+  created_hlc: exports_external.string(),
+  order_key: exports_external.string().nullable()
+});
+var MoveDocumentReq = exports_external.object({
+  target: exports_external.string(),
+  where: exports_external.enum(["before", "after", "into"])
 });
 var DocumentSchema = DocumentSummarySchema.extend({ body: exports_external.string().nullable() });
 var SearchHitSchema = exports_external.object({
@@ -17122,7 +17368,7 @@ var UpdatePropertyReq = exports_external.object({
   position: exports_external.number().optional()
 });
 var SetWidthReq = exports_external.object({ width: exports_external.number() });
-var RecordValuesReq = exports_external.record(exports_external.string(), exports_external.any());
+var RecordValuesReq = exports_external.record(exports_external.string(), exports_external.any()).describe("Flat { column: value } cell patch (keyed by property name).");
 var CreateDocumentReq = exports_external.object({
   title: exports_external.string(),
   body: exports_external.string().optional(),
@@ -17349,6 +17595,17 @@ var webuiRoutes = [
       return updateDocument(db, need(req, "id"), body);
     })
   },
+  {
+    method: "PATCH",
+    path: "/api/document/move",
+    summary: "Move a document before/after another, or into it as a child. Query: ?id=<id>",
+    request: MoveDocumentReq,
+    response: DocumentSchema,
+    handler: handle(async (req, { db }) => {
+      const body = await req.json();
+      return moveDocument(db, need(req, "id"), body.target, body.where);
+    })
+  },
   {
     method: "DELETE",
     path: "/api/document",
@@ -17376,6 +17633,7 @@ var SiteSchema = exports_external.object({
   title: exports_external.string().nullable(),
   created_hlc: exports_external.string()
 });
+var SiteWithCountSchema = SiteSchema.extend({ file_count: exports_external.number() });
 var SiteFileSchema = exports_external.object({
   id: exports_external.string(),
   site_id: exports_external.string(),
@@ -17383,6 +17641,8 @@ var SiteFileSchema = exports_external.object({
   content_type: exports_external.string(),
   encoding: exports_external.string()
 });
+var CreateSiteBody = exports_external.object({ name: exports_external.string(), title: exports_external.string().optional() });
+var UpdateSiteBody = exports_external.object({ name: exports_external.string().optional(), title: exports_external.string().optional() });
 function need2(req, key) {
   const v = new URL(req.url).searchParams.get(key);
   if (!v)
@@ -17402,9 +17662,9 @@ var sitesRoutes = [
   {
     method: "GET",
     path: "/api/sites",
-    summary: "List published sites",
-    response: exports_external.array(SiteSchema),
-    handler: handle2((_req, { db }) => listSites(db))
+    summary: "List published sites (with file counts)",
+    response: exports_external.array(SiteWithCountSchema),
+    handler: handle2((_req, { db }) => listSites(db).map((s) => ({ ...s, file_count: listFiles(db, s.id).length })))
   },
   {
     method: "GET",
@@ -17412,6 +17672,60 @@ var sitesRoutes = [
     summary: "List a site's files (manifest). Query: ?site=<id|name>",
     response: exports_external.array(SiteFileSchema),
     handler: handle2((req, { db }) => listFiles(db, resolveSite(db, need2(req, "site")).id))
+  },
+  {
+    method: "POST",
+    path: "/api/sites",
+    summary: "Create a site",
+    request: CreateSiteBody,
+    response: SiteSchema,
+    handler: handle2(async (req, { db }) => {
+      const body = CreateSiteBody.parse(await req.json());
+      return createSite(db, body);
+    })
+  },
+  {
+    method: "PATCH",
+    path: "/api/site",
+    summary: "Rename a site or change its title. Query: ?id=<id>",
+    request: UpdateSiteBody,
+    response: SiteSchema,
+    handler: handle2(async (req, { db }) => {
+      const body = UpdateSiteBody.parse(await req.json());
+      return updateSite(db, need2(req, "id"), body);
+    })
+  },
+  {
+    method: "DELETE",
+    path: "/api/site",
+    summary: "Delete a site and its files. Query: ?id=<id>",
+    response: exports_external.object({ ok: exports_external.boolean() }),
+    handler: handle2((req, { db }) => ({ ok: deleteSite(db, need2(req, "id")) }))
+  },
+  {
+    method: "POST",
+    path: "/api/site/file",
+    summary: "Upload/replace a file. Query: ?site=<id|name>&path=<path>; body is raw bytes",
+    response: SiteFileSchema,
+    handler: handle2(async (req, { db }) => {
+      const site = resolveSite(db, need2(req, "site"));
+      const ct = req.headers.get("content-type");
+      const file2 = await putFile(db, site.id, need2(req, "path"), {
+        data: await req.arrayBuffer(),
+        contentType: ct && ct !== "application/octet-stream" ? ct : undefined
+      });
+      const { content: _content, ...summary } = file2;
+      return summary;
+    })
+  },
+  {
+    method: "DELETE",
+    path: "/api/site/file",
+    summary: "Delete a file. Query: ?site=<id|name>&path=<path>",
+    response: exports_external.object({ ok: exports_external.boolean() }),
+    handler: handle2((req, { db }) => ({
+      ok: deleteFile(db, resolveSite(db, need2(req, "site")).id, need2(req, "path"))
+    }))
   }
 ];
 
@@ -18006,6 +18320,7 @@ function startServer(opts = {}) {
   };
 }
 export {
+  updateSite,
   updateRecord,
   updateProperty,
   updateDocument,
@@ -18033,11 +18348,15 @@ export {
   parseDocBlocks,
   openMetahub,
   observeHlc,
+  normalizeSitePath,
+  normalizeSiteName,
   nextHlc,
   newId,
   moveRecord,
+  moveDocument,
   migrateRecords,
   migratePeers,
+  migrateDocuments,
   migrateDocBlocks,
   metahubHome,
   maybeAutoIndex,
@@ -18088,6 +18407,7 @@ export {
   cacheDir,
   blobPath,
   backfillRecordOrderKeys,
+  backfillDocumentOrderKeys,
   applyChange,
   appendDocument,
   addProperty,
@@ -18105,4 +18425,4 @@ export {
   ChangeSchema
 };
 
-//# debugId=548591A808956A3F64756E2164756E21
+//# debugId=F1DD5DA39D0D2ABD64756E2164756E21