@tensorix/metahub 0.1.4 → 0.1.7

package/dist/core/blocks.d.ts

@@ -1,7 +1,26 @@
-/** Split markdown into block texts (no leading/trailing blank lines, no empties). */
-export declare function parseBlocks(md: string): string[];
-/** Join block texts back into a markdown body. */
-export declare function serializeBlocks(texts: readonly (string | null)[]): string;
+/**
+ * A document block plus the blank lines the user left after it. `blankAfter` is
+ * the count *beyond* the standard single-blank-line separator (so a normal
+ * paragraph break is 0); for the last block it's the trailing blank-line run.
+ * This is what lets deliberate vertical spacing survive a save/reload without
+ * representing blank lines as zero-content blocks (which would churn the
+ * text-keyed reconcile). See [[blocks]] doc-block model.
+ */
+export interface DocBlock {
+    text: string;
+    blankAfter: number;
+}
+/**
+ * Split markdown into doc blocks, preserving blank-line runs as `blankAfter`.
+ * Leading blank lines (before the first block) are dropped; one blank line
+ * between two blocks is the standard separator, every extra blank line is kept.
+ */
+export declare function parseDocBlocks(md: string): DocBlock[];
+/** Serialize doc blocks back to a body, re-emitting kept blank-line runs. */
+export declare function serializeDocBlocks(blocks: readonly {
+    text: string | null;
+    blankAfter?: number;
+}[]): string;
 export type ReconcileItem = {
     keep: number;
 } | {

package/dist/core/blocks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/core/blocks.ts"],"names":[],"mappings":"AAIA,qFAAqF;AACrF,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CA8ChD;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,MAAM,CAEzE;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAClE,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAa/E"}
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/core/blocks.ts"],"names":[],"mappings":"AAIA;;;;;;;GAOG;AACH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,EAAE,CAmDrD;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAC9D,MAAM,CAUR;AAED,MAAM,MAAM,aAAa,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAClE,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,oDAAoD;IACpD,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,aAAa,CAa/E"}

package/dist/core/db.d.ts

@@ -14,6 +14,12 @@ export declare function migrateRecords(db: Database): void;
  * never drops the table so existing replication cursors survive.
  */
 export declare function migratePeers(db: Database): void;
+/**
+ * Add the `blank_after` column to a legacy `doc_blocks` table. Idempotent —
+ * guarded by hasColumn; existing blocks default to 0 (canonical single-blank-line
+ * separators), so the migration never changes an existing document's body.
+ */
+export declare function migrateDocBlocks(db: Database): void;
 /** Open (and migrate) the on-disk metahub database for the resolved home. */
 export declare function openMetahub(): Database;
 //# sourceMappingURL=db.d.ts.map

package/dist/core/db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/core/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMtC,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAO5C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAKlD;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAuBjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAa/C;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,QAAQ,CAQtC"}
+{"version":3,"file":"db.d.ts","sourceRoot":"","sources":["../../src/core/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAMtC,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,wBAAgB,SAAS,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAO5C;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAKlD;AAeD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAuBjD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAa/C;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,GAAG,IAAI,CAGnD;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,IAAI,QAAQ,CAStC"}

package/dist/core/documents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/core/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AAmFxD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAShE;AAID,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E,WAAW,CAWb;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMxE;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,EACZ,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,eAAe,EAAE,CAYnB;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzF,WAAW,CAoBb;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,aAAa,CAmCf;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAUpF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAUrF;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAUhE"}
+{"version":3,"file":"documents.d.ts","sourceRoot":"","sources":["../../src/core/documents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAM3C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AA6FxD,qFAAqF;AACrF,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAShE;AAID,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GAC/E,WAAW,CAWb;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAMxE;AAED,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,EACZ,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,eAAe,EAAE,CAYnB;AAED,wBAAgB,cAAc,CAC5B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACzF,WAAW,CAoBb;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,EAAE,EAAE,QAAQ,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,aAAa,CAmCf;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAUpF;AAED,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CAUrF;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAUhE"}

package/dist/core/schema.d.ts

@@ -1,3 +1,3 @@
-export declare const CORE_SCHEMA = "\nCREATE TABLE IF NOT EXISTS meta (\n  key   TEXT PRIMARY KEY,\n  value TEXT\n);\n\n-- CRDT oplog: one row per field assignment. Source of truth for sync.\nCREATE TABLE IF NOT EXISTS crdt_changes (\n  hlc     TEXT NOT NULL,\n  node_id TEXT NOT NULL,\n  dataset TEXT NOT NULL,\n  row_id  TEXT NOT NULL,\n  col     TEXT NOT NULL,\n  value   TEXT,\n  PRIMARY KEY (dataset, row_id, col, hlc)\n);\nCREATE INDEX IF NOT EXISTS idx_changes_hlc ON crdt_changes(hlc);\n\n-- Per-peer replication cursors (SQLite rowids: monotonic in insertion order,\n-- so no change is ever skipped regardless of HLC/clock skew). Outbound side of\n-- a pairing: \"token\" is the credential the *remote* issued to us (sent as a\n-- Bearer header when we sync to them). See migratePeers in db.ts for the columns\n-- added to legacy databases.\nCREATE TABLE IF NOT EXISTS peers (\n  url          TEXT PRIMARY KEY,\n  pull_cursor  INTEGER NOT NULL DEFAULT 0,\n  push_cursor  INTEGER NOT NULL DEFAULT 0,\n  token        TEXT,\n  label        TEXT,\n  node_id      TEXT,\n  enabled      INTEGER NOT NULL DEFAULT 1,\n  last_sync_at INTEGER,\n  last_status  TEXT,\n  last_error   TEXT\n);\n\n-- Inbound side of a pairing: credentials *we* issued to remote devices. A peer\n-- presents one of these on /sync; acceptsSyncToken() checks it alongside the\n-- managed master token. Revoke by deleting the row.\nCREATE TABLE IF NOT EXISTS peer_grants (\n  token      TEXT PRIMARY KEY,\n  peer_url   TEXT,\n  node_id    TEXT,\n  created_at INTEGER\n);\n\n-- One-time pairing codes minted by \"mh config peer code\" / POST /api/pair/new.\n-- Short-lived and single-use: redeemed during the pairing handshake, then the\n-- two devices exchange durable peer_grants. used/exp gate redemption.\nCREATE TABLE IF NOT EXISTS pairing_codes (\n  code       TEXT PRIMARY KEY,\n  exp        INTEGER NOT NULL,\n  used       INTEGER NOT NULL DEFAULT 0,\n  created_at INTEGER\n);\n\nCREATE TABLE IF NOT EXISTS databases (\n  id          TEXT PRIMARY KEY,\n  name        TEXT,\n  icon        TEXT,\n  created_hlc TEXT,\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE TABLE IF NOT EXISTS properties (\n  id          TEXT PRIMARY KEY,\n  database_id TEXT,\n  name        TEXT,\n  type        TEXT,\n  config      TEXT,\n  position    REAL,\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_properties_db ON properties(database_id);\n\n-- One row per record. Field cells live in the data JSON object, keyed by\n-- property id (rename-safe). Each (record,property) is still an independent\n-- CRDT register in the oplog; materialize() folds the winner into data via\n-- json_set/json_remove. Hot fields get expression indexes on data->>'propid'\n-- (see indexing.ts) so filter/sort/limit push down to SQL.\nCREATE TABLE IF NOT EXISTS records (\n  id          TEXT PRIMARY KEY,\n  database_id TEXT,\n  created_hlc TEXT,\n  order_key   TEXT,\n  data        TEXT NOT NULL DEFAULT '{}',\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_records_db_hlc ON records(database_id, created_hlc);\n\nCREATE TABLE IF NOT EXISTS documents (\n  id          TEXT PRIMARY KEY,\n  title       TEXT,\n  body        TEXT,        -- materialized cache: serialized from doc_blocks\n  database_id TEXT,\n  parent_id   TEXT,\n  created_hlc TEXT,\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\n\n-- Document body as an ordered list of blocks; each (block,field) is an\n-- independent CRDT register so concurrent edits to different blocks merge.\n-- order_key is a fractional index (ties broken by id) giving display order.\nCREATE TABLE IF NOT EXISTS doc_blocks (\n  id        TEXT PRIMARY KEY,\n  doc_id    TEXT,\n  text      TEXT,\n  order_key TEXT,\n  __deleted INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_doc_blocks_doc ON doc_blocks(doc_id);\n\n-- A named static site (Supabase-Storage-style bucket). Served at /sites/<name>/.\nCREATE TABLE IF NOT EXISTS sites (\n  id          TEXT PRIMARY KEY,\n  name        TEXT,        -- URL slug; resolved by getSiteByName\n  title       TEXT,\n  created_hlc TEXT,\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\n\n-- One row per file in a site. content holds inline utf8/base64 text, or a blob\n-- hash (see cache.ts) when encoding = 'blob'. (site_id, path) maps to a stable\n-- id so re-uploads merge as a CRDT register instead of duplicating.\nCREATE TABLE IF NOT EXISTS site_files (\n  id           TEXT PRIMARY KEY,\n  site_id      TEXT,\n  path         TEXT,\n  content_type TEXT,\n  encoding     TEXT,       -- 'utf8' | 'base64' | 'blob'\n  content      TEXT,\n  created_hlc  TEXT,\n  __deleted    INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_site_files_site ON site_files(site_id);\n";
+export declare const CORE_SCHEMA = "\nCREATE TABLE IF NOT EXISTS meta (\n  key   TEXT PRIMARY KEY,\n  value TEXT\n);\n\n-- CRDT oplog: one row per field assignment. Source of truth for sync.\nCREATE TABLE IF NOT EXISTS crdt_changes (\n  hlc     TEXT NOT NULL,\n  node_id TEXT NOT NULL,\n  dataset TEXT NOT NULL,\n  row_id  TEXT NOT NULL,\n  col     TEXT NOT NULL,\n  value   TEXT,\n  PRIMARY KEY (dataset, row_id, col, hlc)\n);\nCREATE INDEX IF NOT EXISTS idx_changes_hlc ON crdt_changes(hlc);\n\n-- Per-peer replication cursors (SQLite rowids: monotonic in insertion order,\n-- so no change is ever skipped regardless of HLC/clock skew). Outbound side of\n-- a pairing: \"token\" is the credential the *remote* issued to us (sent as a\n-- Bearer header when we sync to them). See migratePeers in db.ts for the columns\n-- added to legacy databases.\nCREATE TABLE IF NOT EXISTS peers (\n  url          TEXT PRIMARY KEY,\n  pull_cursor  INTEGER NOT NULL DEFAULT 0,\n  push_cursor  INTEGER NOT NULL DEFAULT 0,\n  token        TEXT,\n  label        TEXT,\n  node_id      TEXT,\n  enabled      INTEGER NOT NULL DEFAULT 1,\n  last_sync_at INTEGER,\n  last_status  TEXT,\n  last_error   TEXT\n);\n\n-- Inbound side of a pairing: credentials *we* issued to remote devices. A peer\n-- presents one of these on /sync; acceptsSyncToken() checks it alongside the\n-- managed master token. Revoke by deleting the row.\nCREATE TABLE IF NOT EXISTS peer_grants (\n  token      TEXT PRIMARY KEY,\n  peer_url   TEXT,\n  node_id    TEXT,\n  created_at INTEGER\n);\n\n-- One-time pairing codes minted by \"mh config peer code\" / POST /api/pair/new.\n-- Short-lived and single-use: redeemed during the pairing handshake, then the\n-- two devices exchange durable peer_grants. used/exp gate redemption.\nCREATE TABLE IF NOT EXISTS pairing_codes (\n  code       TEXT PRIMARY KEY,\n  exp        INTEGER NOT NULL,\n  used       INTEGER NOT NULL DEFAULT 0,\n  created_at INTEGER\n);\n\nCREATE TABLE IF NOT EXISTS databases (\n  id          TEXT PRIMARY KEY,\n  name        TEXT,\n  icon        TEXT,\n  created_hlc TEXT,\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\n\nCREATE TABLE IF NOT EXISTS properties (\n  id          TEXT PRIMARY KEY,\n  database_id TEXT,\n  name        TEXT,\n  type        TEXT,\n  config      TEXT,\n  position    REAL,\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_properties_db ON properties(database_id);\n\n-- One row per record. Field cells live in the data JSON object, keyed by\n-- property id (rename-safe). Each (record,property) is still an independent\n-- CRDT register in the oplog; materialize() folds the winner into data via\n-- json_set/json_remove. Hot fields get expression indexes on data->>'propid'\n-- (see indexing.ts) so filter/sort/limit push down to SQL.\nCREATE TABLE IF NOT EXISTS records (\n  id          TEXT PRIMARY KEY,\n  database_id TEXT,\n  created_hlc TEXT,\n  order_key   TEXT,\n  data        TEXT NOT NULL DEFAULT '{}',\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_records_db_hlc ON records(database_id, created_hlc);\n\nCREATE TABLE IF NOT EXISTS documents (\n  id          TEXT PRIMARY KEY,\n  title       TEXT,\n  body        TEXT,        -- materialized cache: serialized from doc_blocks\n  database_id TEXT,\n  parent_id   TEXT,\n  created_hlc TEXT,\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\n\n-- Document body as an ordered list of blocks; each (block,field) is an\n-- independent CRDT register so concurrent edits to different blocks merge.\n-- order_key is a fractional index (ties broken by id) giving display order.\nCREATE TABLE IF NOT EXISTS doc_blocks (\n  id          TEXT PRIMARY KEY,\n  doc_id      TEXT,\n  text        TEXT,\n  order_key   TEXT,\n  blank_after INTEGER NOT NULL DEFAULT 0,  -- extra blank lines kept after this block (user spacing)\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_doc_blocks_doc ON doc_blocks(doc_id);\n\n-- A named static site (Supabase-Storage-style bucket). Served at /sites/<name>/.\nCREATE TABLE IF NOT EXISTS sites (\n  id          TEXT PRIMARY KEY,\n  name        TEXT,        -- URL slug; resolved by getSiteByName\n  title       TEXT,\n  created_hlc TEXT,\n  __deleted   INTEGER NOT NULL DEFAULT 0\n);\n\n-- One row per file in a site. content holds inline utf8/base64 text, or a blob\n-- hash (see cache.ts) when encoding = 'blob'. (site_id, path) maps to a stable\n-- id so re-uploads merge as a CRDT register instead of duplicating.\nCREATE TABLE IF NOT EXISTS site_files (\n  id           TEXT PRIMARY KEY,\n  site_id      TEXT,\n  path         TEXT,\n  content_type TEXT,\n  encoding     TEXT,       -- 'utf8' | 'base64' | 'blob'\n  content      TEXT,\n  created_hlc  TEXT,\n  __deleted    INTEGER NOT NULL DEFAULT 0\n);\nCREATE INDEX IF NOT EXISTS idx_site_files_site ON site_files(site_id);\n";
 export declare const FTS_SCHEMA = "\nCREATE VIRTUAL TABLE IF NOT EXISTS search_fts USING fts5(\n  kind UNINDEXED,\n  id UNINDEXED,\n  database_id UNINDEXED,\n  title,\n  body\n);\n";
 //# sourceMappingURL=schema.d.ts.map

package/dist/core/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,mpJAuIvB,CAAC;AAGF,eAAO,MAAM,UAAU,sJAQtB,CAAC"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/core/schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,mwJAwIvB,CAAC;AAGF,eAAO,MAAM,UAAU,sJAQtB,CAAC"}

package/dist/core/sync/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/sync/server.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qFAAqF;IACrF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,wFAAwF;IACxF,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,6EAA6E;AAC7E,qBAAa,cAAe,SAAQ,KAAK;IAErC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM;CAQxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAYD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,GAAE,aAAkB,GAAG,aAAa,CA8InE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/core/sync/server.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,qFAAqF;IACrF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,wFAAwF;IACxF,QAAQ,EAAE,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAC;IAC5C,8CAA8C;IAC9C,QAAQ,EAAE,OAAO,CAAC;IAClB,qEAAqE;IACrE,cAAc,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,IAAI,CAAC;CAClB;AAED,6EAA6E;AAC7E,qBAAa,cAAe,SAAQ,KAAK;IAErC,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBADZ,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM;CAQxB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qEAAqE;IACrE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,oEAAoE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAYD,gFAAgF;AAChF,wBAAgB,WAAW,CAAC,IAAI,GAAE,aAAkB,GAAG,aAAa,CAkJnE"}

package/dist/core/sync/webui.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webui.d.ts","sourceRoot":"","sources":["../../../src/core/sync/webui.ts"],"names":[],"mappings":"AAotBA;;;8EAG8E;AAC9E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE/C;AAoBD;;;;2EAI2E;AAC3E,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAM/C;AAED;0CAC0C;AAC1C,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAiBvE"}
+{"version":3,"file":"webui.d.ts","sourceRoot":"","sources":["../../../src/core/sync/webui.ts"],"names":[],"mappings":"AAgvBA;;;8EAG8E;AAC9E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAE/C;AAoBD;;;;2EAI2E;AAC3E,wBAAsB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAM/C;AAED;0CAC0C;AAC1C,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAsBvE"}

package/dist/index.js

@@ -1,12 +1,16 @@
 // @bun
 var __defProp = Object.defineProperty;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: (newValue) => all[name] = () => newValue
+      set: __exportSetter.bind(all, name)
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -121,7 +125,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, `
@@ -131,24 +135,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 m = raw.match(/^\s*(`{3,}|~{3,})\s*$/);
       if (m && m[1][0] === fenceChar && m[1].length >= fenceLen) {
-        blocks.push(cur.join(`
-`));
-        cur = [];
+        closeBlock();
         fenceChar = null;
         fenceLen = 0;
       }
@@ -156,28 +160,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 i = 0;i < blocks.length - 1; i++)
+    blocks[i].blankAfter = Math.max(0, blocks[i].blankAfter - 1);
   return blocks;
 }
-function serializeBlocks(texts) {
-  return texts.filter((t) => !!t && t.length > 0).join(`
-
+function serializeDocBlocks(blocks) {
+  const live = blocks.filter((b) => !!b.text && b.text.length > 0);
+  const out = [];
+  live.forEach((b, i) => {
+    out.push(...b.text.split(`
+`));
+    const extra = Math.max(0, b.blankAfter ?? 0);
+    if (i < live.length - 1)
+      out.push("");
+    for (let k = 0;k < extra; k++)
+      out.push("");
+  });
+  return out.join(`
 `);
 }
 function reconcile(oldTexts, newTexts) {
@@ -234,9 +244,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((r) => r.text)), docId);
+  db.query("UPDATE documents SET body = ? WHERE id = ?").run(serializeDocBlocks(rows.map((r) => ({ text: r.text, blankAfter: r.blank_after ?? 0 }))), docId);
 }
 function materialize(db, dataset, rowId, col, valueJson) {
   if (dataset === "records") {
@@ -336,7 +346,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",
@@ -572,6 +582,7 @@ async function serveWebui(req) {
         headers: { "content-type": "text/javascript; charset=utf-8" }
       });
     } catch (e) {
+      console.error("[webui] failed to serve /webui.js \u2014", e);
       return new Response(`webui build failed: ${e}`, { status: 500 });
     }
   }
@@ -605,6 +616,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;
@@ -637,7 +649,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); }
@@ -693,6 +705,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; }
@@ -702,8 +716,19 @@ var HTML = `<!doctype html>
   .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;
-    justify-content:center; gap:8px; color:var(--muted); font-size:12px; }
-  .set-footer-sep { opacity:.5; }
+    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);
@@ -796,8 +821,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; }
@@ -849,7 +876,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%; }
@@ -1036,14 +1064,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; }
@@ -1262,6 +1290,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). */
@@ -1434,11 +1473,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);
 
@@ -2126,6 +2166,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 });
@@ -2133,6 +2177,7 @@ function openMetahub() {
   runSchema(db);
   migrateRecords(db);
   migratePeers(db);
+  migrateDocBlocks(db);
   return db;
 }
 
@@ -2164,7 +2209,7 @@ function clearCurrentDatabase(db) {
 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(`
@@ -2174,29 +2219,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, i) => emitBlock(db, docId, { text, order_key: keys[i] }));
+function insertBlocks(db, docId, blocks, after, before) {
+  const keys = keysBetween(after, before, blocks.length);
+  blocks.forEach((b, i) => emitBlock(db, docId, { text: b.text, order_key: keys[i], blankAfter: b.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((b) => b.text), parseBlocks(body));
+  const next = parseDocBlocks(body);
+  const plan = reconcile(old.map((b) => b.text), next.map((b) => b.text));
   for (const oi of plan.deleted)
     emit(db, "doc_blocks", old[oi].id, "__deleted", 1);
   const { items } = plan;
   let i = 0;
   while (i < items.length) {
-    if ("keep" in items[i]) {
+    const it = items[i];
+    if ("keep" in it) {
+      const oldB = old[it.keep];
+      const want = next[i].blankAfter;
+      if ((oldB.blank_after ?? 0) !== want)
+        emit(db, "doc_blocks", oldB.id, "blank_after", want);
       i++;
       continue;
     }
@@ -2205,8 +2258,7 @@ function reconcileBody(db, docId, body) {
       j++;
     const left = i > 0 ? old[items[i - 1].keep].order_key : null;
     const right = j < items.length ? old[items[j].keep].order_key : null;
-    const texts = items.slice(i, j).map((it) => it.insert);
-    insertBlocks(db, docId, texts, left, right);
+    insertBlocks(db, docId, next.slice(i, j), left, right);
     i = j;
   }
 }
@@ -2225,9 +2277,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);
 }
@@ -2273,7 +2325,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((b) => b.text));
+  const body = serializeDocBlocks(blocks.map((b) => ({ text: b.text, blankAfter: b.blank_after })));
   const count = countOccurrences(body, opts.old);
   if (count === 0)
     throw new Error(`anchor not found: no match for --old`);
@@ -2300,25 +2352,25 @@ 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))
@@ -13981,7 +14033,7 @@ function finalize(ctx, schema) {
     result.$schema = "http://json-schema.org/draft-07/schema#";
   } else if (ctx.target === "draft-04") {
     result.$schema = "http://json-schema.org/draft-04/schema#";
-  } else if (ctx.target === "openapi-3.0") {} else {}
+  } else if (ctx.target === "openapi-3.0") {}
   if (ctx.external?.uri) {
     const id = ctx.external.registry.get(schema)?.id;
     if (!id)
@@ -14225,7 +14277,7 @@ var literalProcessor = (schema, ctx, json, _params) => {
     if (val === undefined) {
       if (ctx.unrepresentable === "throw") {
         throw new Error("Literal `undefined` cannot be represented in JSON Schema");
-      } else {}
+      }
     } else if (typeof val === "bigint") {
       if (ctx.unrepresentable === "throw") {
         throw new Error("BigInt literals cannot be represented in JSON Schema");
@@ -16964,8 +17016,9 @@ function getServerConfig(db) {
 // package.json
 var package_default = {
   name: "@tensorix/metahub",
-  version: "0.1.4",
+  version: "0.1.7",
   description: "Metahub core library and CLI",
+  license: "AGPL-3.0-only",
   type: "module",
   main: "./dist/index.js",
   module: "./dist/index.js",
@@ -16983,7 +17036,9 @@ var package_default = {
   },
   files: [
     "dist",
-    "README.md"
+    "README.md",
+    "README.zh-CN.md",
+    "LICENSE"
   ],
   scripts: {
     dev: "bun --hot src/cli/index.ts",
@@ -17927,7 +17982,7 @@ function startServer(opts = {}) {
   let timer = null;
   if (autoSync && syncIntervalMs > 0) {
     timer = setInterval(() => {
-      syncAllPeers(db).catch(() => {});
+      syncAllPeers(db).catch((e) => console.error("[sync] auto-sync tick failed \u2014", e));
     }, syncIntervalMs);
     timer.unref?.();
   }
@@ -17960,7 +18015,7 @@ export {
   slugify,
   setPropertyWidth,
   setCurrentDatabase,
-  serializeBlocks,
+  serializeDocBlocks,
   search,
   runSchema,
   resolveSite,
@@ -17975,7 +18030,7 @@ export {
   putBlob,
   prependDocument,
   parseHlc,
-  parseBlocks,
+  parseDocBlocks,
   openMetahub,
   observeHlc,
   nextHlc,
@@ -17983,6 +18038,7 @@ export {
   moveRecord,
   migrateRecords,
   migratePeers,
+  migrateDocBlocks,
   metahubHome,
   maybeAutoIndex,
   makeId,
@@ -18049,4 +18105,4 @@ export {
   ChangeSchema
 };
 
-//# debugId=539C6C8168968A4864756E2164756E21
+//# debugId=548591A808956A3F64756E2164756E21