@abraca/cli 1.8.0 → 2.3.0

package/dist/abracadabra-cli.cjs

@@ -37,6 +37,10 @@ node_fs = __toESM(node_fs);
 let node_os = require("node:os");
 let node_path = require("node:path");
 node_path = __toESM(node_path);
+let wtf_wikipedia = require("wtf_wikipedia");
+wtf_wikipedia = __toESM(wtf_wikipedia);
+let wtf_plugin_api = require("wtf-plugin-api");
+wtf_plugin_api = __toESM(wtf_plugin_api);
 
 //#region packages/cli/src/parser.ts
 /**
@@ -83,97 +87,205 @@ function parseArgs(argv) {
 }
 
 //#endregion
-//#region packages/cli/node_modules/@noble/hashes/esm/utils.js
-/** Checks if something is Uint8Array. Be careful: nodejs Buffer will return true. */
+//#region node_modules/@noble/hashes/utils.js
+/**
+* Checks if something is Uint8Array. Be careful: nodejs Buffer will return true.
+* @param a - value to test
+* @returns `true` when the value is a Uint8Array-compatible view.
+* @example
+* Check whether a value is a Uint8Array-compatible view.
+* ```ts
+* isBytes(new Uint8Array([1, 2, 3]));
+* ```
+*/
 function isBytes(a) {
-	return a instanceof Uint8Array || ArrayBuffer.isView(a) && a.constructor.name === "Uint8Array";
+	return a instanceof Uint8Array || ArrayBuffer.isView(a) && a.constructor.name === "Uint8Array" && "BYTES_PER_ELEMENT" in a && a.BYTES_PER_ELEMENT === 1;
 }
-/** Asserts something is Uint8Array. */
-function abytes(b, ...lengths) {
-	if (!isBytes(b)) throw new Error("Uint8Array expected");
-	if (lengths.length > 0 && !lengths.includes(b.length)) throw new Error("Uint8Array expected of length " + lengths + ", got length=" + b.length);
+/**
+* Asserts something is Uint8Array.
+* @param value - value to validate
+* @param length - optional exact length constraint
+* @param title - label included in thrown errors
+* @returns The validated byte array.
+* @throws On wrong argument types. {@link TypeError}
+* @throws On wrong argument ranges or values. {@link RangeError}
+* @example
+* Validate that a value is a byte array.
+* ```ts
+* abytes(new Uint8Array([1, 2, 3]));
+* ```
+*/
+function abytes(value, length, title = "") {
+	const bytes = isBytes(value);
+	const len = value?.length;
+	const needsLen = length !== void 0;
+	if (!bytes || needsLen && len !== length) {
+		const prefix = title && `"${title}" `;
+		const ofLen = needsLen ? ` of length ${length}` : "";
+		const got = bytes ? `length=${len}` : `type=${typeof value}`;
+		const message = prefix + "expected Uint8Array" + ofLen + ", got " + got;
+		if (!bytes) throw new TypeError(message);
+		throw new RangeError(message);
+	}
+	return value;
 }
-/** Asserts a hash instance has not been destroyed / finished */
+/**
+* Asserts a hash instance has not been destroyed or finished.
+* @param instance - hash instance to validate
+* @param checkFinished - whether to reject finalized instances
+* @throws If the hash instance has already been destroyed or finalized. {@link Error}
+* @example
+* Validate that a hash instance is still usable.
+* ```ts
+* import { aexists } from '@noble/hashes/utils.js';
+* import { sha256 } from '@noble/hashes/sha2.js';
+* const hash = sha256.create();
+* aexists(hash);
+* ```
+*/
 function aexists(instance, checkFinished = true) {
 	if (instance.destroyed) throw new Error("Hash instance has been destroyed");
 	if (checkFinished && instance.finished) throw new Error("Hash#digest() has already been called");
 }
-/** Asserts output is properly-sized byte array */
+/**
+* Asserts output is a sufficiently-sized byte array.
+* @param out - destination buffer
+* @param instance - hash instance providing output length
+* Oversized buffers are allowed; downstream code only promises to fill the first `outputLen` bytes.
+* @throws On wrong argument types. {@link TypeError}
+* @throws On wrong argument ranges or values. {@link RangeError}
+* @example
+* Validate a caller-provided digest buffer.
+* ```ts
+* import { aoutput } from '@noble/hashes/utils.js';
+* import { sha256 } from '@noble/hashes/sha2.js';
+* const hash = sha256.create();
+* aoutput(new Uint8Array(hash.outputLen), hash);
+* ```
+*/
 function aoutput(out, instance) {
-	abytes(out);
+	abytes(out, void 0, "digestInto() output");
 	const min = instance.outputLen;
-	if (out.length < min) throw new Error("digestInto() expects output buffer of length at least " + min);
+	if (out.length < min) throw new RangeError("\"digestInto() output\" expected to be of length >=" + min);
 }
-/** Zeroize a byte array. Warning: JS provides no guarantees. */
+/**
+* Zeroizes typed arrays in place. Warning: JS provides no guarantees.
+* @param arrays - arrays to overwrite with zeros
+* @example
+* Zeroize sensitive buffers in place.
+* ```ts
+* clean(new Uint8Array([1, 2, 3]));
+* ```
+*/
 function clean(...arrays) {
 	for (let i = 0; i < arrays.length; i++) arrays[i].fill(0);
 }
-/** Create DataView of an array for easy byte-level manipulation. */
+/**
+* Creates a DataView for byte-level manipulation.
+* @param arr - source typed array
+* @returns DataView over the same buffer region.
+* @example
+* Create a DataView over an existing buffer.
+* ```ts
+* createView(new Uint8Array(4));
+* ```
+*/
 function createView(arr) {
 	return new DataView(arr.buffer, arr.byteOffset, arr.byteLength);
 }
-/** Is current platform little-endian? Most are. Big-Endian platform: IBM */
+/** Whether the current platform is little-endian. */
 const isLE = new Uint8Array(new Uint32Array([287454020]).buffer)[0] === 68;
 const hasHexBuiltin = typeof Uint8Array.from([]).toHex === "function" && typeof Uint8Array.fromHex === "function";
 /**
-* Converts string to bytes using UTF8 encoding.
-* @example utf8ToBytes('abc') // Uint8Array.from([97, 98, 99])
-*/
-function utf8ToBytes(str) {
-	if (typeof str !== "string") throw new Error("string expected");
-	return new Uint8Array(new TextEncoder().encode(str));
-}
-/**
-* Normalizes (non-hex) string or Uint8Array to Uint8Array.
-* Warning: when Uint8Array is passed, it would NOT get copied.
-* Keep in mind for future mutable operations.
+* Creates a callable hash function from a stateful class constructor.
+* @param hashCons - hash constructor or factory
+* @param info - optional metadata such as DER OID
+* @returns Frozen callable hash wrapper with `.create()`.
+*   Wrapper construction eagerly calls `hashCons(undefined)` once to read
+*   `outputLen` / `blockLen`, so constructor side effects happen at module
+*   init time.
+* @example
+* Wrap a stateful hash constructor into a callable helper.
+* ```ts
+* import { createHasher } from '@noble/hashes/utils.js';
+* import { sha256 } from '@noble/hashes/sha2.js';
+* const wrapped = createHasher(sha256.create, { oid: sha256.oid });
+* wrapped(new Uint8Array([1]));
+* ```
 */
-function toBytes(data) {
-	if (typeof data === "string") data = utf8ToBytes(data);
-	abytes(data);
-	return data;
-}
-/** For runtime check if class implements interface */
-var Hash = class {};
-/** Wraps hash function, creating an interface on top of it */
-function createHasher(hashCons) {
-	const hashC = (msg) => hashCons().update(toBytes(msg)).digest();
-	const tmp = hashCons();
+function createHasher(hashCons, info = {}) {
+	const hashC = (msg, opts) => hashCons(opts).update(msg).digest();
+	const tmp = hashCons(void 0);
 	hashC.outputLen = tmp.outputLen;
 	hashC.blockLen = tmp.blockLen;
-	hashC.create = () => hashCons();
-	return hashC;
+	hashC.canXOF = tmp.canXOF;
+	hashC.create = (opts) => hashCons(opts);
+	Object.assign(hashC, info);
+	return Object.freeze(hashC);
 }
+/**
+* Creates OID metadata for NIST hashes with prefix `06 09 60 86 48 01 65 03 04 02`.
+* @param suffix - final OID byte for the selected hash.
+*   The helper accepts any byte even though only the documented NIST hash
+*   suffixes are meaningful downstream.
+* @returns Object containing the DER-encoded OID.
+* @example
+* Build OID metadata for a NIST hash.
+* ```ts
+* oidNist(0x01);
+* ```
+*/
+const oidNist = (suffix) => ({ oid: Uint8Array.from([
+	6,
+	9,
+	96,
+	134,
+	72,
+	1,
+	101,
+	3,
+	4,
+	2,
+	suffix
+]) });
 
 //#endregion
-//#region packages/cli/node_modules/@noble/hashes/esm/_md.js
+//#region node_modules/@noble/hashes/_md.js
 /**
 * Internal Merkle-Damgard hash utils.
 * @module
 */
-/** Polyfill for Safari 14. https://caniuse.com/mdn-javascript_builtins_dataview_setbiguint64 */
-function setBigUint64(view, byteOffset, value, isLE) {
-	if (typeof view.setBigUint64 === "function") return view.setBigUint64(byteOffset, value, isLE);
-	const _32n = BigInt(32);
-	const _u32_max = BigInt(4294967295);
-	const wh = Number(value >> _32n & _u32_max);
-	const wl = Number(value & _u32_max);
-	const h = isLE ? 4 : 0;
-	const l = isLE ? 0 : 4;
-	view.setUint32(byteOffset + h, wh, isLE);
-	view.setUint32(byteOffset + l, wl, isLE);
-}
 /**
 * Merkle-Damgard hash construction base class.
 * Could be used to create MD5, RIPEMD, SHA1, SHA2.
+* Accepts only byte-aligned `Uint8Array` input, even when the underlying spec describes bit
+* strings with partial-byte tails.
+* @param blockLen - internal block size in bytes
+* @param outputLen - digest size in bytes
+* @param padOffset - trailing length field size in bytes
+* @param isLE - whether length and state words are encoded in little-endian
+* @example
+* Use a concrete subclass to get the shared Merkle-Damgard update/digest flow.
+* ```ts
+* import { _SHA1 } from '@noble/hashes/legacy.js';
+* const hash = new _SHA1();
+* hash.update(new Uint8Array([97, 98, 99]));
+* hash.digest();
+* ```
 */
-var HashMD = class extends Hash {
+var HashMD = class {
+	blockLen;
+	outputLen;
+	canXOF = false;
+	padOffset;
+	isLE;
+	buffer;
+	view;
+	finished = false;
+	length = 0;
+	pos = 0;
+	destroyed = false;
 	constructor(blockLen, outputLen, padOffset, isLE) {
-		super();
-		this.finished = false;
-		this.length = 0;
-		this.pos = 0;
-		this.destroyed = false;
 		this.blockLen = blockLen;
 		this.outputLen = outputLen;
 		this.padOffset = padOffset;
@@ -183,7 +295,6 @@ var HashMD = class extends Hash {
 	}
 	update(data) {
 		aexists(this);
-		data = toBytes(data);
 		abytes(data);
 		const { view, buffer, blockLen } = this;
 		const len = data.length;
@@ -219,11 +330,11 @@ var HashMD = class extends Hash {
 			pos = 0;
 		}
 		for (let i = pos; i < blockLen; i++) buffer[i] = 0;
-		setBigUint64(view, blockLen - 8, BigInt(this.length * 8), isLE);
+		view.setBigUint64(blockLen - 8, BigInt(this.length * 8), isLE);
 		this.process(view, 0);
 		const oview = createView(out);
 		const len = this.outputLen;
-		if (len % 4) throw new Error("_sha2: outputLen should be aligned to 32bit");
+		if (len % 4) throw new Error("_sha2: outputLen must be aligned to 32bit");
 		const outLen = len / 4;
 		const state = this.get();
 		if (outLen > state.length) throw new Error("_sha2: outputLen bigger than state");
@@ -237,7 +348,7 @@ var HashMD = class extends Hash {
 		return res;
 	}
 	_cloneInto(to) {
-		to || (to = new this.constructor());
+		to ||= new this.constructor();
 		to.set(...this.get());
 		const { blockLen, buffer, length, finished, destroyed, pos } = this;
 		to.destroyed = destroyed;
@@ -251,7 +362,10 @@ var HashMD = class extends Hash {
 		return this._cloneInto();
 	}
 };
-/** Initial SHA512 state. Bits 0..64 of frac part of sqrt of primes 2..19 */
+/** Initial SHA512 state from RFC 6234 §6.3: eight RFC 64-bit `H(0)` words stored as sixteen
+* big-endian 32-bit halves. Derived from the fractional parts of the square roots of the first
+* eight prime numbers. Exported as a shared table; callers must treat it as read-only because
+* constructors copy halves from it by index. */
 const SHA512_IV = /* @__PURE__ */ Uint32Array.from([
 	1779033703,
 	4089235720,
@@ -272,12 +386,7 @@ const SHA512_IV = /* @__PURE__ */ Uint32Array.from([
 ]);
 
 //#endregion
-//#region packages/cli/node_modules/@noble/hashes/esm/_u64.js
-/**
-* Internal helpers for u64. BigUint64Array is too slow as per 2025, so we implement it using Uint32Array.
-* @todo re-check https://issues.chromium.org/issues/42212588
-* @module
-*/
+//#region node_modules/@noble/hashes/_u64.js
 const U32_MASK64 = /* @__PURE__ */ BigInt(2 ** 32 - 1);
 const _32n = /* @__PURE__ */ BigInt(32);
 function fromBig(n, le = false) {
@@ -321,12 +430,12 @@ const add5L = (Al, Bl, Cl, Dl, El) => (Al >>> 0) + (Bl >>> 0) + (Cl >>> 0) + (Dl
 const add5H = (low, Ah, Bh, Ch, Dh, Eh) => Ah + Bh + Ch + Dh + Eh + (low / 2 ** 32 | 0) | 0;
 
 //#endregion
-//#region packages/cli/node_modules/@noble/hashes/esm/sha2.js
+//#region node_modules/@noble/hashes/sha2.js
 /**
 * SHA2 hash function. A.k.a. sha256, sha384, sha512, sha512_224, sha512_256.
 * SHA256 is the fastest hash implementable in JS, even faster than Blake3.
-* Check out [RFC 4634](https://datatracker.ietf.org/doc/html/rfc4634) and
-* [FIPS 180-4](https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf).
+* Check out {@link https://www.rfc-editor.org/rfc/rfc4634 | RFC 4634} and
+* {@link https://nvlpubs.nist.gov/nistpubs/FIPS/NIST.FIPS.180-4.pdf | FIPS 180-4}.
 * @module
 */
 const K512 = split([
@@ -415,25 +524,10 @@ const SHA512_Kh = K512[0];
 const SHA512_Kl = K512[1];
 const SHA512_W_H = /* @__PURE__ */ new Uint32Array(80);
 const SHA512_W_L = /* @__PURE__ */ new Uint32Array(80);
-var SHA512 = class extends HashMD {
-	constructor(outputLen = 64) {
+/** Internal SHA-384 / SHA-512 compression engine from RFC 6234 §6.4. */
+var SHA2_64B = class extends HashMD {
+	constructor(outputLen) {
 		super(128, outputLen, 16, false);
-		this.Ah = SHA512_IV[0] | 0;
-		this.Al = SHA512_IV[1] | 0;
-		this.Bh = SHA512_IV[2] | 0;
-		this.Bl = SHA512_IV[3] | 0;
-		this.Ch = SHA512_IV[4] | 0;
-		this.Cl = SHA512_IV[5] | 0;
-		this.Dh = SHA512_IV[6] | 0;
-		this.Dl = SHA512_IV[7] | 0;
-		this.Eh = SHA512_IV[8] | 0;
-		this.El = SHA512_IV[9] | 0;
-		this.Fh = SHA512_IV[10] | 0;
-		this.Fl = SHA512_IV[11] | 0;
-		this.Gh = SHA512_IV[12] | 0;
-		this.Gl = SHA512_IV[13] | 0;
-		this.Hh = SHA512_IV[14] | 0;
-		this.Hl = SHA512_IV[15] | 0;
 	}
 	get() {
 		const { Ah, Al, Bh, Bl, Ch, Cl, Dh, Dl, Eh, El, Fh, Fl, Gh, Gl, Hh, Hl } = this;
@@ -536,12 +630,44 @@ var SHA512 = class extends HashMD {
 		clean(SHA512_W_H, SHA512_W_L);
 	}
 	destroy() {
+		this.destroyed = true;
 		clean(this.buffer);
 		this.set(0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0);
 	}
 };
-/** SHA2-512 hash function from RFC 4634. */
-const sha512 = /* @__PURE__ */ createHasher(() => new SHA512());
+/** Internal SHA-512 hash class grounded in RFC 6234 §6.3 and §6.4. */
+var _SHA512 = class extends SHA2_64B {
+	Ah = SHA512_IV[0] | 0;
+	Al = SHA512_IV[1] | 0;
+	Bh = SHA512_IV[2] | 0;
+	Bl = SHA512_IV[3] | 0;
+	Ch = SHA512_IV[4] | 0;
+	Cl = SHA512_IV[5] | 0;
+	Dh = SHA512_IV[6] | 0;
+	Dl = SHA512_IV[7] | 0;
+	Eh = SHA512_IV[8] | 0;
+	El = SHA512_IV[9] | 0;
+	Fh = SHA512_IV[10] | 0;
+	Fl = SHA512_IV[11] | 0;
+	Gh = SHA512_IV[12] | 0;
+	Gl = SHA512_IV[13] | 0;
+	Hh = SHA512_IV[14] | 0;
+	Hl = SHA512_IV[15] | 0;
+	constructor() {
+		super(64);
+	}
+};
+/**
+* SHA2-512 hash function from RFC 4634.
+* @param msg - message bytes to hash
+* @returns Digest bytes.
+* @example
+* Hash a message with SHA2-512.
+* ```ts
+* sha512(new Uint8Array([97, 98, 99]));
+* ```
+*/
+const sha512 = /* @__PURE__ */ createHasher(() => new _SHA512(), /* @__PURE__ */ oidNist(3));
 
 //#endregion
 //#region packages/cli/src/crypto.ts
@@ -549,7 +675,8 @@ const sha512 = /* @__PURE__ */ createHasher(() => new SHA512());
 * Ed25519 key generation, persistence, and challenge signing for CLI auth.
 * Mirrors @abraca/mcp/src/crypto.ts — standalone to avoid MCP SDK dependency.
 */
-_noble_ed25519.etc.sha512Sync = (...msgs) => sha512(_noble_ed25519.etc.concatBytes(...msgs));
+_noble_ed25519.hashes.sha512 = sha512;
+_noble_ed25519.hashes.sha512Async = (m) => Promise.resolve(sha512(m));
 const DEFAULT_KEY_PATH = (0, node_path.join)((0, node_os.homedir)(), ".abracadabra", "cli.key");
 function toBase64url(bytes) {
 	return Buffer.from(bytes).toString("base64url");
@@ -572,7 +699,7 @@ async function loadOrCreateKeypair(keyPath) {
 			publicKeyB64: toBase64url(_noble_ed25519.getPublicKey(privateKey))
 		};
 	}
-	const privateKey = _noble_ed25519.utils.randomPrivateKey();
+	const privateKey = _noble_ed25519.utils.randomSecretKey();
 	const publicKey = _noble_ed25519.getPublicKey(privateKey);
 	const dir = (0, node_path.dirname)(path);
 	if (!(0, node_fs.existsSync)(dir)) await (0, node_fs_promises.mkdir)(dir, {
@@ -614,24 +741,6 @@ function waitForSync(provider, timeoutMs = 15e3) {
 		provider.on("synced", handler);
 	});
 }
-/** Map a DocumentMeta to SpaceMeta shape for display compatibility. */
-function docToSpaceMeta(doc) {
-	const publicAccess = doc.public_access;
-	let visibility = "private";
-	if (publicAccess && publicAccess !== "none") visibility = "public";
-	return {
-		id: doc.id,
-		doc_id: doc.id,
-		name: doc.label ?? doc.id,
-		description: doc.description ?? null,
-		visibility,
-		is_hub: doc.is_hub ?? false,
-		owner_id: doc.owner_id ?? null,
-		created_at: 0,
-		updated_at: doc.updated_at ?? 0,
-		public_access: publicAccess ?? null
-	};
-}
 var CLIConnection = class {
 	config;
 	client;
@@ -701,29 +810,12 @@ var CLIConnection = class {
 		}
 		this.log(`Authenticated as ${this.displayName} (${keypair.publicKeyB64.slice(0, 12)}...)`);
 		this._serverInfo = await this.client.serverInfo();
-		let initialDocId = this._serverInfo.index_doc_id ?? null;
-		try {
-			const roots = await this.client.listRootDocuments();
-			this._spaces = roots.map(docToSpaceMeta);
-			const hub = roots.find((d) => d.is_hub);
-			if (hub) {
-				initialDocId = hub.id;
-				this.log(`Hub document: ${hub.label ?? hub.id} (${hub.id})`);
-			} else if (roots.length > 0) {
-				initialDocId = roots[0].id;
-				this.log(`No hub, using first root doc: ${roots[0].label ?? roots[0].id}`);
-			}
-		} catch {
-			try {
-				this._spaces = await this.client.listSpaces();
-				const hub = this._spaces.find((s) => s.is_hub);
-				if (hub) initialDocId = hub.doc_id;
-				else if (this._spaces.length > 0) initialDocId = this._spaces[0].doc_id;
-			} catch {
-				this.log("Neither /docs?root=true nor /spaces available, using index_doc_id");
-			}
-		}
-		if (!initialDocId) throw new Error("No entry point found: server has neither spaces nor index_doc_id configured.");
+		const roots = await this.client.listChildren();
+		this._spaces = roots.filter((d) => d.kind === _abraca_dabra.Kind.Space);
+		const first = this._spaces[0] ?? roots[0];
+		const initialDocId = first?.id ?? null;
+		if (first) this.log(`Entry document: ${first.label ?? first.id} (${first.id})`);
+		if (!initialDocId) throw new Error("No entry point found: server has no top-level documents. Create a Space first.");
 		this._rootDocId = initialDocId;
 		const doc = new yjs.Doc({ guid: initialDocId });
 		const provider = new _abraca_dabra.AbracadabraProvider({
@@ -1098,7 +1190,7 @@ registerCommand({
 			`URL:         ${conn.config.url}`,
 			`Version:     ${si.version ?? "—"}`,
 			`Protocol:    ${si.protocol_version ?? "—"}`,
-			`Hub Doc:     ${conn.rootDocId ?? "—"}`,
+			`Active Doc:  ${conn.rootDocId ?? "—"}`,
 			`Auth:        ${si.auth_methods?.join(", ") ?? "—"}`,
 			`Registration:${si.registration_allowed ? " open" : " closed"}${si.invite_only ? " (invite only)" : ""}`,
 			`Documents:   ${docCount}`,
@@ -1108,7 +1200,7 @@ registerCommand({
 });
 registerCommand({
 	name: "spaces",
-	description: "List available spaces/root documents.",
+	description: "List available spaces (top-level documents).",
 	usage: "spaces [--format=json|tsv]",
 	async run(conn, args) {
 		if (!conn) return "Not connected";
@@ -1118,19 +1210,20 @@ registerCommand({
 		const active = conn.rootDocId;
 		if (format === "json") return printJson(spaces.map((s) => ({
 			...s,
-			active: s.doc_id === active
+			active: s.id === active
 		})));
-		return printTable(spaces.map((s) => [
-			s.doc_id === active ? "▸" : " ",
-			s.doc_id.slice(0, 8) + "…",
-			s.name,
-			s.is_hub ? "hub" : "",
-			s.visibility
-		]), [
+		return printTable(spaces.map((s) => {
+			const visibility = s.public_access === "observer" ? "public" : "private";
+			return [
+				s.id === active ? "▸" : " ",
+				s.id.slice(0, 8) + "…",
+				s.label ?? s.id,
+				visibility
+			];
+		}), [
 			"",
 			"ID",
 			"NAME",
-			"HUB",
 			"VISIBILITY"
 		]);
 	}
@@ -1148,12 +1241,12 @@ registerCommand({
 		if (targetId) docId = targetId;
 		else if (targetName) {
 			const lower = targetName.toLowerCase();
-			const space = conn.spaces.find((s) => s.name.toLowerCase() === lower || s.doc_id === targetName);
-			if (space) docId = space.doc_id;
+			const space = conn.spaces.find((s) => (s.label ?? s.id).toLowerCase() === lower || s.id === targetName);
+			if (space) docId = space.id;
 		}
 		if (!docId) return "Space not found. Use \"abracadabra spaces\" to list available spaces.";
 		await conn.switchSpace(docId);
-		return `Switched to space "${conn.spaces.find((s) => s.doc_id === docId)?.name ?? docId}"`;
+		return `Switched to space "${conn.spaces.find((s) => s.id === docId)?.label ?? docId}"`;
 	}
 });
 
@@ -1184,7 +1277,7 @@ registerCommand({
 		const tree = buildTree(readEntries(treeMap), rootId, maxDepth);
 		if (format === "json") return printJson(tree);
 		if (tree.length === 0) return "(empty tree)";
-		return (conn.spaces.find((s) => s.doc_id === conn.rootDocId)?.name ?? conn.rootDocId ?? "Workspace") + "\n" + printTree(toTreeNodes(tree));
+		return (conn.spaces.find((s) => s.id === conn.rootDocId)?.label ?? conn.rootDocId ?? "Workspace") + "\n" + printTree(toTreeNodes(tree));
 	}
 });
 registerCommand({
@@ -1256,238 +1349,14 @@ registerCommand({
 });
 
 //#endregion
-//#region packages/mcp/src/converters/yjsToMarkdown.ts
-/**
-* Y.XmlFragment → Markdown serializer.
-* Walks the TipTap document structure and produces markdown text.
-*/
-function deltaToMarkdown(delta) {
-	return delta.map((op) => {
-		let text = op.insert;
-		if (!op.attributes) return text;
-		const a = op.attributes;
-		if (a.code) text = `\`${text}\``;
-		if (a.bold) text = `**${text}**`;
-		if (a.italic) text = `*${text}*`;
-		if (a.strike) text = `~~${text}~~`;
-		if (a.link?.href) text = `[${text}](${a.link.href})`;
-		if (a.badge) text = `:badge[${a.badge.label || text}]`;
-		if (a.kbd) text = `:kbd{value="${a.kbd.value || text}"}`;
-		if (a.proseIcon) text = `:icon{name="${a.proseIcon.name}"}`;
-		return text;
-	}).join("");
-}
-function xmlTextToMarkdown(xmlText) {
-	return deltaToMarkdown(xmlText.toDelta());
-}
-function elementTextContent(el) {
-	const parts = [];
-	for (let i = 0; i < el.length; i++) {
-		const child = el.get(i);
-		if (child instanceof yjs.XmlText) parts.push(xmlTextToMarkdown(child));
-		else if (child instanceof yjs.XmlElement) parts.push(elementTextContent(child));
-	}
-	return parts.join("");
-}
-function serializeElement(el, indent = "") {
-	switch (el.nodeName) {
-		case "documentHeader":
-		case "documentMeta": return "";
-		case "heading": {
-			const level = Number(el.getAttribute("level")) || 1;
-			return `${"#".repeat(level)} ${elementTextContent(el)}`;
-		}
-		case "paragraph": return elementTextContent(el);
-		case "bulletList": return serializeList(el, "bullet", indent);
-		case "orderedList": return serializeList(el, "ordered", indent);
-		case "taskList": return serializeTaskList(el, indent);
-		case "codeBlock": return `\`\`\`${el.getAttribute("language") || ""}\n${elementTextContent(el)}\n\`\`\``;
-		case "blockquote": {
-			const lines = [];
-			for (let i = 0; i < el.length; i++) {
-				const child = el.get(i);
-				if (child instanceof yjs.XmlElement) lines.push(serializeElement(child, indent));
-			}
-			return lines.map((l) => `> ${l}`).join("\n");
-		}
-		case "horizontalRule": return "---";
-		case "table": return serializeTable(el);
-		case "docEmbed": {
-			const docId = el.getAttribute("docId");
-			return docId ? `![[${docId}]]` : "";
-		}
-		case "svgEmbed": {
-			const svg = el.getAttribute("svg") || "";
-			const svgTitle = el.getAttribute("title") || "";
-			if (!svg) return "";
-			return `\`\`\`svg${svgTitle ? ` ${svgTitle}` : ""}\n${svg}\n\`\`\``;
-		}
-		case "image": {
-			const src = el.getAttribute("src") || "";
-			const alt = el.getAttribute("alt") || "";
-			const w = el.getAttribute("width");
-			const h = el.getAttribute("height");
-			let attrs = "";
-			if (w || h) {
-				const parts = [];
-				if (w) parts.push(`width="${w}"`);
-				if (h) parts.push(`height="${h}"`);
-				attrs = `{${parts.join(" ")}}`;
-			}
-			return `![${alt}](${src})${attrs}`;
-		}
-		case "callout": return `::${el.getAttribute("type") || "note"}\n${serializeChildren(el, indent)}\n::`;
-		case "collapsible": {
-			const label = el.getAttribute("label") || "Details";
-			const open = el.getAttribute("open");
-			const props = [`label="${label}"`];
-			if (open === true || open === "true") props.push("open=\"true\"");
-			const inner = serializeChildren(el, indent);
-			return `::collapsible{${props.join(" ")}}\n${inner}\n::`;
-		}
-		case "steps": return `::steps\n${serializeChildren(el, indent)}\n::`;
-		case "card": {
-			const title = el.getAttribute("title") || "";
-			const icon = el.getAttribute("icon") || "";
-			const to = el.getAttribute("to") || "";
-			const props = [];
-			if (title) props.push(`title="${title}"`);
-			if (icon) props.push(`icon="${icon}"`);
-			if (to) props.push(`to="${to}"`);
-			const inner = serializeChildren(el, indent);
-			return `::card{${props.join(" ")}}\n${inner}\n::`;
-		}
-		case "cardGroup": return `::card-group\n${serializeChildren(el, indent)}\n::`;
-		case "codeCollapse": return `::code-collapse\n${serializeChildren(el, indent)}\n::`;
-		case "codeGroup": return `::code-group\n${serializeChildren(el, indent)}\n::`;
-		case "codePreview": return `::code-preview\n${serializeChildren(el, indent)}\n::`;
-		case "codeTree": return `::code-tree{files="${el.getAttribute("files") || "[]"}"}\n::`;
-		case "accordion": return serializeSlottedComponent(el, "accordion", "accordionItem", "item");
-		case "tabs": return serializeSlottedComponent(el, "tabs", "tabsItem", "tab");
-		case "field": {
-			const fieldName = el.getAttribute("name") || "";
-			const fieldType = el.getAttribute("type") || "string";
-			const required = el.getAttribute("required");
-			const props = [];
-			if (fieldName) props.push(`name="${fieldName}"`);
-			props.push(`type="${fieldType}"`);
-			if (required === true || required === "true") props.push("required=\"true\"");
-			const inner = serializeChildren(el, indent);
-			return `::field{${props.join(" ")}}\n${inner}\n::`;
-		}
-		case "fieldGroup": return `::field-group\n${serializeChildren(el, indent)}\n::`;
-		default: return serializeChildren(el, indent);
-	}
-}
-function serializeList(el, type, indent) {
-	const lines = [];
-	for (let i = 0; i < el.length; i++) {
-		const item = el.get(i);
-		if (item instanceof yjs.XmlElement && item.nodeName === "listItem") {
-			const prefix = type === "bullet" ? "- " : `${i + 1}. `;
-			const content = elementTextContent(item);
-			lines.push(`${indent}${prefix}${content}`);
-		}
-	}
-	return lines.join("\n");
-}
-function serializeTaskList(el, indent) {
-	const lines = [];
-	for (let i = 0; i < el.length; i++) {
-		const item = el.get(i);
-		if (item instanceof yjs.XmlElement && item.nodeName === "taskItem") {
-			const checked = item.getAttribute("checked");
-			const marker = checked === true || checked === "true" ? "[x]" : "[ ]";
-			const content = elementTextContent(item);
-			lines.push(`${indent}- ${marker} ${content}`);
-		}
-	}
-	return lines.join("\n");
-}
-function serializeTable(el) {
-	const rows = [];
-	for (let i = 0; i < el.length; i++) {
-		const row = el.get(i);
-		if (!(row instanceof yjs.XmlElement) || row.nodeName !== "tableRow") continue;
-		const cells = [];
-		for (let j = 0; j < row.length; j++) {
-			const cell = row.get(j);
-			if (cell instanceof yjs.XmlElement) cells.push(elementTextContent(cell));
-		}
-		rows.push(cells);
-	}
-	if (!rows.length) return "";
-	const headerRow = rows[0];
-	const lines = [`| ${headerRow.join(" | ")} |`];
-	lines.push(`| ${headerRow.map(() => "---").join(" | ")} |`);
-	for (let i = 1; i < rows.length; i++) lines.push(`| ${rows[i].join(" | ")} |`);
-	return lines.join("\n");
-}
-function serializeSlottedComponent(el, componentName, childNodeName, slotName) {
-	const parts = [`::${componentName}`];
-	for (let i = 0; i < el.length; i++) {
-		const child = el.get(i);
-		if (!(child instanceof yjs.XmlElement) || child.nodeName !== childNodeName) continue;
-		const label = child.getAttribute("label") || `Item ${i + 1}`;
-		const icon = child.getAttribute("icon") || "";
-		const props = [`label="${label}"`];
-		if (icon) props.push(`icon="${icon}"`);
-		parts.push(`#${slotName}{${props.join(" ")}}`);
-		const inner = serializeChildren(child, "");
-		if (inner) parts.push(inner);
-	}
-	parts.push("::");
-	return parts.join("\n");
-}
-function serializeChildren(el, indent) {
-	const parts = [];
-	for (let i = 0; i < el.length; i++) {
-		const child = el.get(i);
-		if (child instanceof yjs.XmlElement) {
-			const serialized = serializeElement(child, indent);
-			if (serialized) parts.push(serialized);
-		} else if (child instanceof yjs.XmlText) {
-			const text = xmlTextToMarkdown(child);
-			if (text) parts.push(text);
-		}
-	}
-	return parts.join("\n\n");
-}
-/**
-* Converts a Y.XmlFragment (TipTap document) to markdown.
-* Extracts the title from the documentHeader element.
-*
-* @returns `{ title, markdown }` where title is the H1/header text
-*/
-function yjsToMarkdown(fragment) {
-	let title = "Untitled";
-	const bodyParts = [];
-	for (let i = 0; i < fragment.length; i++) {
-		const child = fragment.get(i);
-		if (!(child instanceof yjs.XmlElement)) continue;
-		if (child.nodeName === "documentHeader") {
-			title = elementTextContent(child) || "Untitled";
-			continue;
-		}
-		if (child.nodeName === "documentMeta") continue;
-		const serialized = serializeElement(child);
-		if (serialized !== "") bodyParts.push(serialized);
-	}
-	return {
-		title,
-		markdown: bodyParts.join("\n\n")
-	};
-}
-
-//#endregion
-//#region packages/mcp/src/converters/markdownToYjs.ts
-/**
-* Markdown → Y.js converter.
-* Ported from cou-sh/app/utils/markdownToYjs.ts with Vue dependency removed.
-*/
+//#region packages/convert/src/markdown-to-yjs.ts
 function parseInlineArray(raw) {
 	return raw.slice(1, -1).split(",").map((s) => s.trim()).filter(Boolean);
 }
+function stripQuotes(s) {
+	if (s.length >= 2 && (s.startsWith("\"") && s.endsWith("\"") || s.startsWith("'") && s.endsWith("'"))) return s.slice(1, -1).replace(/\\"/g, "\"").replace(/\\\\/g, "\\");
+	return s;
+}
 function parseFrontmatter(markdown) {
 	const noResult = {
 		meta: {},
@@ -1518,8 +1387,8 @@ function parseFrontmatter(markdown) {
 		if (kvMatch) {
 			const key = kvMatch[1];
 			const val = kvMatch[2].trim();
-			if (val.startsWith("[") && val.endsWith("]")) raw[key] = parseInlineArray(val);
-			else raw[key] = val;
+			if (val.startsWith("[") && val.endsWith("]")) raw[key] = parseInlineArray(val).map(stripQuotes);
+			else raw[key] = stripQuotes(val);
 		}
 		i++;
 	}
@@ -1546,54 +1415,27 @@ function parseFrontmatter(markdown) {
 	}[priorityRaw.toLowerCase()] ?? (Number(priorityRaw) || 0);
 	const checkedRaw = raw["checked"] ?? raw["done"];
 	if (checkedRaw !== void 0) meta.checked = checkedRaw === "true" || checkedRaw === true;
-	const dateStart = getStr(["date", "created"]);
+	const dateStart = getStr([
+		"dateStart",
+		"date",
+		"created"
+	]);
 	if (dateStart) meta.dateStart = dateStart;
-	const dateEnd = getStr(["due"]);
+	const dateEnd = getStr(["dateEnd", "due"]);
 	if (dateEnd) meta.dateEnd = dateEnd;
-	const subtitle = getStr(["description", "subtitle"]);
+	const subtitle = getStr(["subtitle", "description"]);
 	if (subtitle) meta.subtitle = subtitle;
 	const url = getStr(["url"]);
 	if (url) meta.url = url;
-	const email = getStr(["email"]);
-	if (email) meta.email = email;
-	const phone = getStr(["phone"]);
-	if (phone) meta.phone = phone;
 	const ratingRaw = getStr(["rating"]);
 	if (ratingRaw !== void 0) {
 		const n = Number(ratingRaw);
 		if (!Number.isNaN(n)) meta.rating = Math.min(5, Math.max(0, n));
 	}
-	const datetimeStart = getStr(["datetimeStart"]);
-	if (datetimeStart) meta.datetimeStart = datetimeStart;
-	const datetimeEnd = getStr(["datetimeEnd"]);
-	if (datetimeEnd) meta.datetimeEnd = datetimeEnd;
-	const allDayRaw = raw["allDay"];
-	if (allDayRaw !== void 0) meta.allDay = allDayRaw === "true" || allDayRaw === true;
-	const geoLatRaw = getStr(["geoLat"]);
-	if (geoLatRaw !== void 0) {
-		const n = Number(geoLatRaw);
-		if (!Number.isNaN(n)) meta.geoLat = n;
-	}
-	const geoLngRaw = getStr(["geoLng"]);
-	if (geoLngRaw !== void 0) {
-		const n = Number(geoLngRaw);
-		if (!Number.isNaN(n)) meta.geoLng = n;
-	}
-	const geoType = getStr(["geoType"]);
-	if (geoType && (geoType === "marker" || geoType === "line" || geoType === "measure")) meta.geoType = geoType;
-	const geoDescription = getStr(["geoDescription"]);
-	if (geoDescription) meta.geoDescription = geoDescription;
-	const numberRaw = getStr(["number"]);
-	if (numberRaw !== void 0) {
-		const n = Number(numberRaw);
-		if (!Number.isNaN(n)) meta.number = n;
-	}
-	const unit = getStr(["unit"]);
-	if (unit) meta.unit = unit;
-	const note = getStr(["note"]);
-	if (note) meta.note = note;
+	const rawTitle = typeof raw["title"] === "string" ? raw["title"] : void 0;
 	return {
-		title: typeof raw["title"] === "string" ? raw["title"] : void 0,
+		title: rawTitle !== void 0 ? stripQuotes(rawTitle) : void 0,
+		type: getStr(["type"]),
 		meta,
 		body
 	};
@@ -1601,63 +1443,74 @@ function parseFrontmatter(markdown) {
 function parseInline(text) {
 	const stripped = text.replace(/\{lang="[^"]*"\}/g, "").replace(/:(?!badge|icon|kbd)(\w[\w-]*)\[([^\]]*)\](\{[^}]*\})?/g, "$2").replace(/:(?!badge|icon|kbd)(\w[\w-]*)(\{[^}]*\})/g, "");
 	const tokens = [];
-	const re = /:badge\[([^\]]*)\](\{[^}]*\})?|:icon\{([^}]*)\}|:kbd\{([^}]*)\}|!?\[\[([^\]|]+?)(?:\|([^\]]+?))?\]\]|~~(.+?)~~|\*\*(.+?)\*\*|\*(.+?)\*|_(.+?)_|`(.+?)`|\[(.+?)\]\((.+?)\)/g;
+	const re = /\$([^$\n]+?)\$|@\[([^\]]+?)\]\(user:([^)]+?)\)|:badge\[([^\]]*)\](\{[^}]*\})?|:icon\{([^}]*)\}|:kbd\{([^}]*)\}|\[\[([0-9a-fA-F-]{36})(?:\|([^\]]+?))?\]\]|~~(.+?)~~|\*\*(.+?)\*\*|\*(.+?)\*|_(.+?)_|`(.+?)`|\[(.+?)\]\((.+?)\)/g;
 	let lastIndex = 0;
 	let match;
 	while ((match = re.exec(stripped)) !== null) {
 		if (match.index > lastIndex) tokens.push({ text: stripped.slice(lastIndex, match.index) });
-		if (match[1] !== void 0) {
-			const badgeProps = parseMdcProps(match[2]);
+		if (match[1] !== void 0) tokens.push({
+			text: match[1],
+			attrs: { mathInline: { expression: match[1] } }
+		});
+		else if (match[2] !== void 0 && match[3] !== void 0) tokens.push({
+			text: match[2],
+			attrs: { mention: {
+				userId: match[3],
+				label: match[2]
+			} }
+		});
+		else if (match[4] !== void 0) {
+			const badgeProps = parseMdcProps(match[5]);
 			tokens.push({
-				text: match[1] || "Badge",
+				text: match[4] || "Badge",
 				attrs: { badge: {
-					label: match[1] || "Badge",
+					label: match[4] || "Badge",
 					color: badgeProps["color"] || "neutral",
 					variant: badgeProps["variant"] || "subtle"
 				} }
 			});
-		} else if (match[3] !== void 0) {
-			const iconProps = parseMdcProps(`{${match[3]}}`);
+		} else if (match[6] !== void 0) {
+			const iconProps = parseMdcProps(`{${match[6]}}`);
 			tokens.push({
 				text: "​",
 				attrs: { proseIcon: { name: iconProps["name"] || "i-lucide-star" } }
 			});
-		} else if (match[4] !== void 0) {
-			const kbdProps = parseMdcProps(`{${match[4]}}`);
+		} else if (match[7] !== void 0) {
+			const kbdProps = parseMdcProps(`{${match[7]}}`);
 			tokens.push({
 				text: kbdProps["value"] || "",
 				attrs: { kbd: { value: kbdProps["value"] || "" } }
 			});
-		} else if (match[5] !== void 0) {
-			const docId = match[5];
-			const displayText = match[6] ?? docId;
+		} else if (match[8] !== void 0) {
+			const docId = match[8];
+			const label = match[9] ?? docId;
 			tokens.push({
-				text: displayText,
-				attrs: { link: { href: `/doc/${docId}` } }
+				text: label,
+				attrs: { docLink: { docId } }
 			});
-		} else if (match[7] !== void 0) tokens.push({
-			text: match[7],
+		} else if (match[10] !== void 0) tokens.push({
+			text: match[10],
 			attrs: { strike: true }
 		});
-		else if (match[8] !== void 0) tokens.push({
-			text: match[8],
+		else if (match[11] !== void 0) tokens.push({
+			text: match[11],
 			attrs: { bold: true }
 		});
-		else if (match[9] !== void 0) tokens.push({
-			text: match[9],
+		else if (match[12] !== void 0) tokens.push({
+			text: match[12],
 			attrs: { italic: true }
 		});
-		else if (match[10] !== void 0) tokens.push({
-			text: match[10],
+		else if (match[13] !== void 0) tokens.push({
+			text: match[13],
 			attrs: { italic: true }
 		});
-		else if (match[11] !== void 0) tokens.push({
-			text: match[11],
+		else if (match[14] !== void 0) tokens.push({
+			text: match[14],
 			attrs: { code: true }
 		});
-		else if (match[12] !== void 0 && match[13] !== void 0) tokens.push({
-			text: match[12],
-			attrs: { link: { href: match[13] } }
+		else if (match[15] !== void 0 && match[16] !== void 0) tokens.push({
+			text: match[15],
+			attrs: { link: { href: match[16] } }
 		});
 		lastIndex = match.index + match[0].length;
 	}
@@ -1671,6 +1524,7 @@ function parseTableRow(line) {
 function isTableSeparator(line) {
 	return /^\|[\s|:-]+\|$/.test(line.trim());
 }
+/** Extract fenced code blocks from MDC #code slot lines. */
 function extractFencedCode(lines) {
 	const result = [];
 	let i = 0;
@@ -1697,14 +1551,23 @@ function extractFencedCode(lines) {
 	}
 	return result;
 }
+/** Extract key="value" pairs from MDC prop syntax `{key="value" other="x"}` */
 function parseMdcProps(propsStr) {
 	if (!propsStr) return {};
 	const result = {};
-	const re = /(\w[\w-]*)="([^"]*)"/g;
+	let s = propsStr.trim();
+	if (s.startsWith("{") && s.endsWith("}")) s = s.slice(1, -1);
+	const re = /(\w[\w-]*)(?:=(?:"([^"]*)"|([^\s"}]+)))?/g;
 	let m;
-	while ((m = re.exec(propsStr)) !== null) result[m[1]] = m[2];
+	while ((m = re.exec(s)) !== null) {
+		const key = m[1];
+		if (m[2] !== void 0) result[key] = m[2];
+		else if (m[3] !== void 0) result[key] = m[3];
+		else result[key] = "true";
+	}
 	return result;
 }
+/** Parse named child MDC blocks from inner lines (e.g. #item for accordion, #tab for tabs) */
 function parseMdcChildren(innerLines, slotPrefix) {
 	const items = [];
 	let current = null;
@@ -1736,6 +1599,95 @@ function parseMdcChildren(innerLines, slotPrefix) {
 	}));
 }
 const TASK_RE = /^[-*+]\s+\[([ xX])\]\s+(.*)/;
+/**
+* Consume a list (bullet / ordered / task) starting at `start`. Indented
+* continuation lines and nested lists are captured into each item's
+* `innerBlocks` so the parse → serialise → parse cycle preserves tree
+* structure instead of flattening nested lists onto a single line.
+*
+* `indent` is the column of the item marker for the current list. A
+* nested list starts ≥2 columns deeper. Lines with less indent than
+* `indent` belong to the outer block and stop consumption.
+*/
+function consumeList(lines, start, indent, kind) {
+	const items = [];
+	let i = start;
+	while (i < lines.length) {
+		const line = lines[i];
+		if (line.trim() === "") {
+			let j = i + 1;
+			while (j < lines.length && lines[j].trim() === "") j++;
+			if (j >= lines.length) break;
+			const lookahead = lines[j];
+			if (leadingSpaces(lookahead) < indent) break;
+			if (!matchMarker(lookahead.slice(indent), kind)) break;
+			i = j;
+			continue;
+		}
+		const leading = leadingSpaces(line);
+		if (leading < indent) break;
+		if (leading > indent) break;
+		const m = matchMarker(line.slice(indent), kind);
+		if (!m) break;
+		const item = { text: m.text };
+		if (kind === "task") item.checked = m.checked;
+		i++;
+		const contLines = [];
+		while (i < lines.length) {
+			const next = lines[i];
+			if (next.trim() === "") {
+				let k = i + 1;
+				while (k < lines.length && lines[k].trim() === "") k++;
+				if (k >= lines.length) break;
+				if (leadingSpaces(lines[k]) <= indent) break;
+				contLines.push("");
+				i++;
+				continue;
+			}
+			const nextIndent = leadingSpaces(next);
+			if (nextIndent <= indent) break;
+			const deindentBy = Math.min(nextIndent, indent + 2);
+			contLines.push(next.slice(deindentBy));
+			i++;
+		}
+		if (contLines.length > 0) item.innerBlocks = parseBlocks(contLines.join("\n"));
+		items.push(item);
+	}
+	return {
+		items,
+		next: i
+	};
+}
+function leadingSpaces(s) {
+	let n = 0;
+	while (n < s.length && s[n] === " ") n++;
+	return n;
+}
+function matchMarker(s, kind) {
+	if (kind === "task") {
+		const m = s.match(TASK_RE);
+		if (!m) return null;
+		return {
+			text: m[2],
+			checked: m[1].toLowerCase() === "x"
+		};
+	}
+	if (kind === "bullet") {
+		if (TASK_RE.test(s)) return null;
+		const m = s.match(/^[-*+]\s+(.*)$/);
+		if (!m) return null;
+		return {
+			text: m[1],
+			checked: false
+		};
+	}
+	const m = s.match(/^\d+\.\s+(.*)$/);
+	if (!m) return null;
+	return {
+		text: m[1],
+		checked: false
+	};
+}
 function parseBlocks(markdown) {
 	const rawLines = markdown.split("\n");
 	let firstContentLine = 0;
@@ -1761,17 +1713,15 @@ function parseBlocks(markdown) {
 				i++;
 			}
 			i++;
-			if (lang === "svg" || lang.startsWith("svg ")) {
-				const svgTitle = lang === "svg" ? "" : lang.slice(4).trim();
-				blocks.push({
-					type: "svgEmbed",
-					svg: codeLines.join("\n"),
-					title: svgTitle
-				});
-			} else blocks.push({
+			const code = codeLines.join("\n");
+			if (lang === "math") blocks.push({
+				type: "mathBlock",
+				expression: code
+			});
+			else blocks.push({
 				type: "codeBlock",
 				lang,
-				code: codeLines.join("\n")
+				code
 			});
 			continue;
 		}
@@ -1790,11 +1740,16 @@ function parseBlocks(markdown) {
 			i++;
 			continue;
 		}
-		const docEmbedMatch = line.match(/^!\[\[([^\]|]+?)(?:\|[^\]]*?)?\]\]\s*$/);
-		if (docEmbedMatch) {
+		const embedMatch = line.match(/^!\[\[([0-9a-fA-F-]{36})(?:\|([^\]]+))?\]\](\{[^}]*\})?\s*$/);
+		if (embedMatch) {
+			const docId = embedMatch[1];
+			const label = embedMatch[2] ?? "";
+			const props = parseMdcProps(embedMatch[3]);
 			blocks.push({
 				type: "docEmbed",
-				docId: docEmbedMatch[1]
+				docId,
+				label,
+				props
 			});
 			i++;
 			continue;
@@ -1846,6 +1801,23 @@ function parseBlocks(markdown) {
 			});
 			continue;
 		}
+		const atomMatch = line.match(/^:(\w[\w-]*)(\{[^}]*\})?\s*$/);
+		if (atomMatch && atomMatch[1] === "file") {
+			const props = parseMdcProps(atomMatch[2]);
+			const uploadId = props["upload-id"] ?? props["uploadId"] ?? "";
+			const filename = props["filename"] ?? "";
+			const mime = props["mime"] ?? "";
+			const src = props["src"] ?? (uploadId && filename ? `.abracadabra/files/${uploadId}-${filename}` : "");
+			blocks.push({
+				type: "fileBlock",
+				src,
+				mime,
+				uploadId,
+				filename
+			});
+			i++;
+			continue;
+		}
 		const MDC_OPEN = /^\s*(:{2,})(\w[\w-]*)(\{[^}]*\})?\s*$/;
 		if (MDC_OPEN.test(line)) {
 			const colons = line.match(/^\s*(:+)/)?.[1]?.length ?? 2;
@@ -2014,15 +1986,8 @@ function parseBlocks(markdown) {
 			continue;
 		}
 		if (TASK_RE.test(line)) {
-			const items = [];
-			while (i < lines.length && TASK_RE.test(lines[i])) {
-				const m = lines[i].match(TASK_RE);
-				items.push({
-					checked: m[1].toLowerCase() === "x",
-					text: m[2]
-				});
-				i++;
-			}
+			const { items, next } = consumeList(lines, i, 0, "task");
+			i = next;
 			blocks.push({
 				type: "taskList",
 				items
@@ -2030,12 +1995,9 @@ function parseBlocks(markdown) {
 			continue;
 		}
 		if (/^[-*+]\s+/.test(line)) {
-			const items = [];
-			while (i < lines.length && /^[-*+]\s+/.test(lines[i]) && !TASK_RE.test(lines[i])) {
-				items.push(lines[i].replace(/^[-*+]\s+/, ""));
-				i++;
-			}
-			if (items.length) {
+			const { items, next } = consumeList(lines, i, 0, "bullet");
+			if (items.length > 0) {
+				i = next;
 				blocks.push({
 					type: "bulletList",
 					items
@@ -2044,16 +2006,15 @@ function parseBlocks(markdown) {
 			}
 		}
 		if (/^\d+\.\s+/.test(line)) {
-			const items = [];
-			while (i < lines.length && /^\d+\.\s+/.test(lines[i])) {
-				items.push(lines[i].replace(/^\d+\.\s+/, ""));
-				i++;
+			const { items, next } = consumeList(lines, i, 0, "ordered");
+			if (items.length > 0) {
+				i = next;
+				blocks.push({
+					type: "orderedList",
+					items
+				});
+				continue;
 			}
-			blocks.push({
-				type: "orderedList",
-				items
-			});
-			continue;
 		}
 		if (line.trim() === "") {
 			i++;
@@ -2071,6 +2032,10 @@ function parseBlocks(markdown) {
 	}
 	return blocks;
 }
+/**
+* Insert formatted inline tokens into an already-attached Y.XmlElement.
+* Creates one Y.XmlText per token (attach first, fill second).
+*/
 function fillTextInto(el, tokens) {
 	const filtered = tokens.filter((t) => t.text.length > 0);
 	if (!filtered.length) return;
@@ -2107,9 +2072,19 @@ function blockElName(b) {
 		case "fieldGroup": return "fieldGroup";
 		case "image": return "image";
 		case "docEmbed": return "docEmbed";
-		case "svgEmbed": return "svgEmbed";
+		case "mathBlock": return "mathBlock";
+		case "fileBlock": return "fileBlock";
 	}
 }
+function populateListItemChildren(itemEl, item, _itemKind) {
+	const paraEl = new yjs.XmlElement("paragraph");
+	itemEl.insert(itemEl.length, [paraEl]);
+	fillTextInto(paraEl, parseInline(item.text));
+	if (!item.innerBlocks?.length) return;
+	const innerEls = item.innerBlocks.map((b) => new yjs.XmlElement(blockElName(b)));
+	itemEl.insert(itemEl.length, innerEls);
+	item.innerBlocks.forEach((b, i) => fillBlock(innerEls[i], b));
+}
 function fillBlock(el, block) {
 	switch (block.type) {
 		case "heading":
@@ -2123,10 +2098,8 @@ function fillBlock(el, block) {
 		case "orderedList": {
 			const listItemEls = block.items.map(() => new yjs.XmlElement("listItem"));
 			el.insert(0, listItemEls);
-			block.items.forEach((text, i) => {
-				const paraEl = new yjs.XmlElement("paragraph");
-				listItemEls[i].insert(0, [paraEl]);
-				fillTextInto(paraEl, parseInline(text));
+			block.items.forEach((item, i) => {
+				populateListItemChildren(listItemEls[i], item, "listItem");
 			});
 			break;
 		}
@@ -2134,10 +2107,8 @@ function fillBlock(el, block) {
 			const taskItemEls = block.items.map(() => new yjs.XmlElement("taskItem"));
 			el.insert(0, taskItemEls);
 			block.items.forEach((item, i) => {
-				taskItemEls[i].setAttribute("checked", item.checked);
-				const paraEl = new yjs.XmlElement("paragraph");
-				taskItemEls[i].insert(0, [paraEl]);
-				fillTextInto(paraEl, parseInline(item.text));
+				taskItemEls[i].setAttribute("checked", !!item.checked);
+				populateListItemChildren(taskItemEls[i], item, "taskItem");
 			});
 			break;
 		}
@@ -2325,31 +2296,55 @@ function fillBlock(el, block) {
 			break;
 		case "docEmbed":
 			el.setAttribute("docId", block.docId);
+			for (const flag of [
+				"collapsed",
+				"tall",
+				"seamless"
+			]) if (block.props[flag] === "true" || block.props[flag] === "1") el.setAttribute(flag, true);
 			break;
-		case "svgEmbed":
-			el.setAttribute("svg", block.svg);
-			if (block.title) el.setAttribute("title", block.title);
+		case "mathBlock":
+			el.setAttribute("expression", block.expression);
+			break;
+		case "fileBlock":
+			if (block.src) el.setAttribute("src", block.src);
+			if (block.mime) el.setAttribute("mime", block.mime);
+			if (block.uploadId) el.setAttribute("uploadId", block.uploadId);
+			if (block.filename) el.setAttribute("filename", block.filename);
 			break;
 	}
 }
+/**
+* Parses markdown text and writes the result into a Y.XmlFragment that
+* TipTap's Collaboration extension can read.
+*
+* Requires `fragment.doc` to be set (i.e. the fragment must already be
+* obtained from a live Y.Doc via `ydoc.getXmlFragment('default')`).
+*
+* @param fragment      The target `Y.Doc.getXmlFragment('default')`
+* @param markdown      Raw markdown string
+* @param fallbackTitle Used as the title when the markdown has no H1
+*/
 function populateYDocFromMarkdown(fragment, markdown, fallbackTitle = "Untitled") {
 	const ydoc = fragment.doc;
 	if (!ydoc) {
 		console.warn("[markdownToYjs] fragment has no doc — skipping population");
 		return;
 	}
-	const blocks = parseBlocks(markdown);
+	const fm = parseFrontmatter(markdown);
+	const blocks = parseBlocks(fm.body);
 	let title = fallbackTitle;
+	let titleSource;
+	if (fm.title !== void 0) {
+		title = fm.title;
+		titleSource = "frontmatter";
+	}
 	let contentBlocks = blocks;
 	const h1 = blocks.findIndex((b) => b.type === "heading" && b.level === 1);
 	if (h1 !== -1) {
 		title = blocks[h1].text;
 		contentBlocks = blocks.filter((_, i) => i !== h1);
+		titleSource = "h1";
 	}
-	if (!contentBlocks.length) contentBlocks = [{
-		type: "paragraph",
-		text: ""
-	}];
 	ydoc.transact(() => {
 		const headerEl = new yjs.XmlElement("documentHeader");
 		const metaEl = new yjs.XmlElement("documentMeta");
@@ -2379,7 +2374,8 @@ function populateYDocFromMarkdown(fragment, markdown, fallbackTitle = "Untitled"
 				case "fieldGroup": return new yjs.XmlElement("fieldGroup");
 				case "image": return new yjs.XmlElement("image");
 				case "docEmbed": return new yjs.XmlElement("docEmbed");
-				case "svgEmbed": return new yjs.XmlElement("svgEmbed");
+				case "mathBlock": return new yjs.XmlElement("mathBlock");
+				case "fileBlock": return new yjs.XmlElement("fileBlock");
 			}
 		});
 		fragment.insert(0, [
@@ -2387,61 +2383,1324 @@ function populateYDocFromMarkdown(fragment, markdown, fallbackTitle = "Untitled"
 			metaEl,
 			...bodyEls
 		]);
+		if (titleSource) headerEl.setAttribute("titleSource", titleSource);
 		const headerXt = new yjs.XmlText();
 		headerEl.insert(0, [headerXt]);
 		headerXt.insert(0, title);
+		for (const k of Object.keys(fm.meta)) {
+			const v = fm.meta[k];
+			if (v === void 0 || v === null) continue;
+			metaEl.setAttribute(k, v);
+		}
+		if (fm.type) metaEl.setAttribute("type", fm.type);
 		contentBlocks.forEach((block, i) => fillBlock(bodyEls[i], block));
 	});
 }
 
 //#endregion
-//#region packages/cli/src/commands/documents.ts
-/**
-* Document CRUD commands: read, create, rename, move, delete, type, doc.
-*/
-/** Safely read a tree map value, converting Y.Map to plain object if needed. */
-function toPlain$1(val) {
-	return val instanceof yjs.Map ? val.toJSON() : val;
-}
-registerCommand({
-	name: "doc",
-	aliases: ["info:doc"],
-	description: "Show document metadata (label, type, meta, dates).",
-	usage: "doc id=<docId> | name=<label> | path=<a/b/c>",
-	async run(conn, args) {
-		if (!conn) return "Not connected";
-		const docId = resolveDocument(conn, args.params, args.positional);
-		if (!docId) return "Document not found. Specify id=, name=, or path= to identify the document.";
-		const treeMap = conn.getTreeMap();
-		if (!treeMap) return "Not connected";
-		const raw = treeMap.get(docId);
-		if (!raw) return `Document ${docId} not found in tree.`;
-		const entry = toPlain$1(raw);
-		const lines = [
-			`id:        ${docId}`,
-			`label:     ${entry.label || "Untitled"}`,
-			`type:      ${entry.type ?? "—"}`,
-			`parent:    ${entry.parentId ?? "(root)"}`,
-			`order:     ${entry.order ?? 0}`,
-			`created:   ${entry.createdAt ? new Date(entry.createdAt).toISOString() : "—"}`,
-			`updated:   ${entry.updatedAt ? new Date(entry.updatedAt).toISOString() : "—"} (${relativeTime(entry.updatedAt)})`
-		];
-		if (entry.meta && Object.keys(entry.meta).length > 0) {
-			lines.push(`meta:`);
-			for (const [k, v] of Object.entries(entry.meta)) lines.push(`  ${k}: ${typeof v === "object" ? JSON.stringify(v) : v}`);
+//#region packages/convert/src/yjs-to-markdown.ts
+function serializeDelta(delta) {
+	let result = "";
+	for (const op of delta) {
+		if (typeof op.insert !== "string") continue;
+		let text = op.insert;
+		const attrs = op.attributes ?? {};
+		if (attrs.code) {
+			result += `\`${text}\``;
+			continue;
 		}
-		const children = childrenOf(readEntries(treeMap), docId);
-		lines.push(`children:  ${children.length}`);
-		return lines.join("\n");
-	}
-});
-registerCommand({
-	name: "read",
-	aliases: ["cat", "r"],
-	description: "Read document content as markdown.",
-	usage: "read id=<docId> | name=<label> | path=<a/b/c> [--format=json|md]",
-	async run(conn, args) {
-		if (!conn) return "Not connected";
+		if (attrs.badge) {
+			const b = attrs.badge;
+			const props = [];
+			if (b.color && b.color !== "neutral") props.push(`color="${b.color}"`);
+			if (b.variant && b.variant !== "subtle") props.push(`variant="${b.variant}"`);
+			result += `:badge[${b.label || text}]${props.length ? `{${props.join(" ")}}` : ""}`;
+			continue;
+		}
+		if (attrs.proseIcon) {
+			const icon = attrs.proseIcon.name || "i-lucide-star";
+			result += `:icon{name="${icon}"}`;
+			continue;
+		}
+		if (attrs.kbd) {
+			const value = attrs.kbd.value || text;
+			result += `:kbd{value="${value}"}`;
+			continue;
+		}
+		if (attrs.docLink) {
+			const docId = attrs.docLink.docId;
+			if (docId) {
+				result += text === docId ? `[[${docId}]]` : `[[${docId}|${text}]]`;
+				continue;
+			}
+		}
+		if (attrs.mention) {
+			const { userId, label } = attrs.mention;
+			if (userId) {
+				result += `@[${label || text}](user:${userId})`;
+				continue;
+			}
+		}
+		if (attrs.mathInline) {
+			const expr = attrs.mathInline.expression ?? text;
+			result += `$${expr}$`;
+			continue;
+		}
+		if (attrs.bold) text = `**${text}**`;
+		if (attrs.italic) text = `*${text}*`;
+		if (attrs.strike) text = `~~${text}~~`;
+		if (attrs.link) {
+			const href = attrs.link.href ?? "";
+			text = `[${text}](${href})`;
+		}
+		result += text;
+	}
+	return result;
+}
+function serializeInline(el) {
+	const parts = [];
+	for (const child of el.toArray()) if (child instanceof yjs.XmlText) parts.push(serializeDelta(child.toDelta()));
+	else if (child instanceof yjs.XmlElement) parts.push(serializeInline(child));
+	return parts.join("");
+}
+function serializeBlock(el, indent = "") {
+	if (el instanceof yjs.XmlText) return serializeDelta(el.toDelta());
+	switch (el.nodeName) {
+		case "documentHeader":
+		case "documentMeta": return "";
+		case "heading": {
+			const level = Number(el.getAttribute("level") ?? 2);
+			return `${"#".repeat(level)} ${serializeInline(el)}`;
+		}
+		case "paragraph": return serializeInline(el);
+		case "bulletList": return serializeListItems(el, "bullet", indent);
+		case "orderedList": return serializeListItems(el, "ordered", indent);
+		case "taskList": return serializeTaskList(el, indent);
+		case "codeBlock": {
+			const lang = el.getAttribute("language") ?? "";
+			const code = getCodeBlockText(el);
+			if (code === "") return `\`\`\`${lang}\n\`\`\``;
+			return `\`\`\`${lang}\n${code}\n\`\`\``;
+		}
+		case "blockquote": {
+			const lines = [];
+			for (const child of el.toArray()) if (child instanceof yjs.XmlElement) {
+				const text = serializeBlock(child);
+				for (const line of text.split("\n")) lines.push(`> ${line}`);
+			}
+			return lines.join("\n");
+		}
+		case "table": return serializeTable(el);
+		case "horizontalRule": return "---";
+		case "image": {
+			const src = el.getAttribute("src") ?? "";
+			const alt = el.getAttribute("alt") ?? "";
+			const width = el.getAttribute("width");
+			const height = el.getAttribute("height");
+			const attrs = [];
+			if (width) attrs.push(`width=${width}`);
+			if (height) attrs.push(`height=${height}`);
+			return `![${alt}](${src})${attrs.length ? `{${attrs.join(" ")}}` : ""}`;
+		}
+		case "docEmbed": {
+			const docId = el.getAttribute("docId") ?? "";
+			const collapsed = el.getAttribute("collapsed");
+			const tall = el.getAttribute("tall");
+			const seamless = el.getAttribute("seamless");
+			const flags = [];
+			if (collapsed === true || collapsed === "true") flags.push("collapsed");
+			if (tall === true || tall === "true") flags.push("tall");
+			if (seamless === true || seamless === "true") flags.push("seamless");
+			return `![[${docId}]]${flags.length ? `{${flags.join(" ")}}` : ""}`;
+		}
+		case "mathBlock": return `\`\`\`math\n${el.getAttribute("expression") ?? ""}\n\`\`\``;
+		case "fileBlock": {
+			const uploadId = el.getAttribute("uploadId") ?? "";
+			const filename = el.getAttribute("filename") ?? "";
+			const mime = el.getAttribute("mime") ?? "";
+			const src = el.getAttribute("src") ?? (uploadId && filename ? `.abracadabra/files/${uploadId}-${filename}` : "");
+			const props = [];
+			if (src) props.push(`src="${src}"`);
+			if (mime) props.push(`mime="${mime}"`);
+			if (uploadId) props.push(`upload-id="${uploadId}"`);
+			if (filename) props.push(`filename="${filename}"`);
+			return `:file{${props.join(" ")}}`;
+		}
+		case "callout": return `::${el.getAttribute("type") ?? "note"}\n${serializeChildren(el)}\n::`;
+		case "collapsible": {
+			const label = el.getAttribute("label") ?? "Details";
+			const open = el.getAttribute("open");
+			const props = [`label="${label}"`];
+			if (open === true || open === "true") props.push("open=\"true\"");
+			return `::collapsible{${props.join(" ")}}\n${serializeChildren(el)}\n::`;
+		}
+		case "steps": return `::steps\n${serializeChildren(el)}\n::`;
+		case "card": {
+			const props = [];
+			const title = el.getAttribute("title");
+			const icon = el.getAttribute("icon");
+			const to = el.getAttribute("to");
+			if (title) props.push(`title="${title}"`);
+			if (icon) props.push(`icon="${icon}"`);
+			if (to) props.push(`to="${to}"`);
+			return `::card${props.length ? `{${props.join(" ")}}` : ""}\n${serializeChildren(el)}\n::`;
+		}
+		case "cardGroup": return `::card-group\n${el.toArray().filter((c) => c instanceof yjs.XmlElement).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "codeCollapse": return `::code-collapse\n${el.toArray().filter((c) => c instanceof yjs.XmlElement && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "codeGroup": return `::code-group\n${el.toArray().filter((c) => c instanceof yjs.XmlElement && c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		case "codePreview": {
+			const children = el.toArray().filter((c) => c instanceof yjs.XmlElement);
+			const nonCode = children.filter((c) => c.nodeName !== "codeBlock").map((c) => serializeBlock(c)).join("\n\n");
+			const code = children.filter((c) => c.nodeName === "codeBlock").map((c) => serializeBlock(c)).join("\n\n");
+			const parts = [nonCode];
+			if (code) parts.push(`#code\n${code}`);
+			return `::code-preview\n${parts.filter(Boolean).join("\n\n")}\n::`;
+		}
+		case "codeTree": return `::code-tree{files="${el.getAttribute("files") ?? "[]"}"}\n::`;
+		case "accordion": return serializeSlottedContainer(el, "accordion", "accordionItem", "item");
+		case "tabs": return serializeSlottedContainer(el, "tabs", "tabsItem", "tab");
+		case "field": {
+			const fieldName = el.getAttribute("name") ?? "";
+			const fieldType = el.getAttribute("type") ?? "string";
+			const required = el.getAttribute("required");
+			const props = [`name="${fieldName}"`, `type="${fieldType}"`];
+			if (required === true || required === "true") props.push("required=\"true\"");
+			return `::field{${props.join(" ")}}\n${serializeChildren(el)}\n::`;
+		}
+		case "fieldGroup": return `::field-group\n${el.toArray().filter((c) => c instanceof yjs.XmlElement).map((c) => serializeBlock(c)).join("\n\n")}\n::`;
+		default: return serializeChildren(el);
+	}
+}
+function serializeChildren(el) {
+	const blocks = [];
+	for (const child of el.toArray()) if (child instanceof yjs.XmlElement) {
+		const text = serializeBlock(child);
+		if (text) blocks.push(text);
+	} else if (child instanceof yjs.XmlText) {
+		const text = serializeDelta(child.toDelta());
+		if (text) blocks.push(text);
+	}
+	return blocks.join("\n\n");
+}
+function serializeListItems(el, type, indent) {
+	const lines = [];
+	let counter = 1;
+	for (const child of el.toArray()) {
+		if (!(child instanceof yjs.XmlElement) || child.nodeName !== "listItem") continue;
+		const prefix = type === "bullet" ? "- " : `${counter++}. `;
+		const subParts = [];
+		for (const sub of child.toArray()) {
+			if (!(sub instanceof yjs.XmlElement)) continue;
+			if (sub.nodeName === "bulletList") subParts.push(serializeListItems(sub, "bullet", indent + "  "));
+			else if (sub.nodeName === "orderedList") subParts.push(serializeListItems(sub, "ordered", indent + "  "));
+			else subParts.push(serializeInline(sub));
+		}
+		if (subParts.length <= 1) lines.push(`${indent}${prefix}${subParts[0] ?? ""}`);
+		else {
+			lines.push(`${indent}${prefix}${subParts[0] ?? ""}`);
+			for (let i = 1; i < subParts.length; i++) lines.push(subParts[i]);
+		}
+	}
+	return lines.join("\n");
+}
+function serializeTaskList(el, indent) {
+	const lines = [];
+	for (const child of el.toArray()) {
+		if (!(child instanceof yjs.XmlElement) || child.nodeName !== "taskItem") continue;
+		const checked = child.getAttribute("checked");
+		const marker = checked === true || checked === "true" ? "[x]" : "[ ]";
+		let header = "";
+		const nestedParts = [];
+		for (const sub of child.toArray()) {
+			if (!(sub instanceof yjs.XmlElement)) continue;
+			if (sub.nodeName === "paragraph" && header === "") header = serializeInline(sub);
+			else if (sub.nodeName === "bulletList") nestedParts.push(serializeListItems(sub, "bullet", indent + "  "));
+			else if (sub.nodeName === "orderedList") nestedParts.push(serializeListItems(sub, "ordered", indent + "  "));
+			else if (sub.nodeName === "taskList") nestedParts.push(serializeTaskList(sub, indent + "  "));
+			else nestedParts.push(indent + "  " + serializeBlock(sub, indent + "  "));
+		}
+		lines.push(`${indent}- ${marker} ${header}`);
+		for (const part of nestedParts) lines.push(part);
+	}
+	return lines.join("\n");
+}
+function getCodeBlockText(el) {
+	for (const child of el.toArray()) if (child instanceof yjs.XmlText) return child.toString();
+	return "";
+}
+function serializeTable(el) {
+	const rows = el.toArray().filter((c) => c instanceof yjs.XmlElement);
+	if (!rows.length) return "";
+	const serializedRows = [];
+	for (const row of rows) {
+		const cells = row.toArray().filter((c) => c instanceof yjs.XmlElement).map((cell) => {
+			return cell.toArray().filter((c) => c instanceof yjs.XmlElement).map((c) => serializeInline(c)).join(" ");
+		});
+		serializedRows.push(cells);
+	}
+	if (!serializedRows.length) return "";
+	const colCount = Math.max(...serializedRows.map((r) => r.length));
+	const headerRow = serializedRows[0];
+	const separator = Array(colCount).fill("---");
+	const dataRows = serializedRows.slice(1);
+	const formatRow = (cells) => {
+		return `| ${Array(colCount).fill("").map((_, i) => cells[i] ?? "").join(" | ")} |`;
+	};
+	return [
+		formatRow(headerRow),
+		formatRow(separator),
+		...dataRows.map(formatRow)
+	].join("\n");
+}
+function serializeSlottedContainer(el, containerName, childName, slotPrefix) {
+	return `::${containerName}\n${el.toArray().filter((c) => c instanceof yjs.XmlElement && c.nodeName === childName).map((item) => {
+		const label = item.getAttribute("label") ?? "";
+		const icon = item.getAttribute("icon") ?? "";
+		const props = [];
+		if (label) props.push(`label="${label}"`);
+		if (icon) props.push(`icon="${icon}"`);
+		const content = serializeChildren(item);
+		return `#${slotPrefix}{${props.join(" ")}}\n${content}`;
+	}).join("\n\n")}\n::`;
+}
+function generateFrontmatter(label, meta, type) {
+	const lines = [];
+	if (label !== void 0) lines.push(`title: "${escapeYaml(label)}"`);
+	if (type && type !== "doc") lines.push(`type: ${type}`);
+	if (!meta) return `---\n${lines.join("\n")}\n---`;
+	if (meta.tags?.length) lines.push(`tags: [${meta.tags.join(", ")}]`);
+	if (meta.color) lines.push(`color: ${yamlScalar(meta.color)}`);
+	if (meta.icon) lines.push(`icon: ${yamlScalar(meta.icon)}`);
+	if (meta.status) lines.push(`status: ${yamlScalar(meta.status)}`);
+	if (meta.priority !== void 0 && meta.priority !== 0) lines.push(`priority: ${{
+		1: "low",
+		2: "medium",
+		3: "high",
+		4: "urgent"
+	}[meta.priority] ?? meta.priority}`);
+	if (meta.checked !== void 0) lines.push(`checked: ${meta.checked}`);
+	if (meta.dateStart) lines.push(`dateStart: "${escapeYaml(meta.dateStart)}"`);
+	if (meta.dateEnd) lines.push(`dateEnd: "${escapeYaml(meta.dateEnd)}"`);
+	if (meta.subtitle) lines.push(`subtitle: "${escapeYaml(meta.subtitle)}"`);
+	if (meta.url) lines.push(`url: ${meta.url}`);
+	if (meta.rating !== void 0 && meta.rating !== 0) lines.push(`rating: ${meta.rating}`);
+	return `---\n${lines.join("\n")}\n---`;
+}
+/**
+* Render a YAML scalar — bare when safe, double-quoted when the value
+* needs escaping. YAML treats `#`, `:`, leading whitespace, and a few
+* other characters as syntactically significant, so anything starting
+* with one of those gets quoted to stay round-trip safe.
+*/
+function yamlScalar(s) {
+	if (s === "") return "\"\"";
+	if (/^[#&*!|>%@`]/.test(s)) return `"${escapeYaml(s)}"`;
+	if (/[:"]/.test(s)) return `"${escapeYaml(s)}"`;
+	if (/^\s|\s$/.test(s)) return `"${escapeYaml(s)}"`;
+	return s;
+}
+function escapeYaml(s) {
+	return s.replace(/\\/g, "\\\\").replace(/"/g, "\\\"");
+}
+function yjsToMarkdown(fragment, label, meta, type) {
+	const { text: headerText, source: titleSource } = readDocumentHeader(fragment);
+	const effectiveTitle = headerText || label;
+	const docMeta = readDocumentMeta(fragment);
+	const effectiveMeta = meta ?? docMeta.meta;
+	const effectiveType = type ?? docMeta.type;
+	const metaIsEmpty = isMetaEmpty(effectiveMeta);
+	const typeIsDefault = !effectiveType || effectiveType === "doc";
+	const bodyBlocks = collectBodyBlocks(fragment);
+	let body;
+	if (titleSource === "h1" && effectiveTitle) {
+		const tail = serializeBlocksClean(bodyBlocks);
+		body = tail === "" ? `# ${effectiveTitle}` : `# ${effectiveTitle}\n\n${tail}`;
+	} else body = serializeBlocksClean(bodyBlocks);
+	const wantFrontmatterTitle = titleSource === "frontmatter";
+	if (!wantFrontmatterTitle && !(!metaIsEmpty || !typeIsDefault)) return body === "" ? "" : `${body}\n`;
+	const frontmatter = generateFrontmatter(wantFrontmatterTitle ? effectiveTitle : void 0, effectiveMeta, effectiveType);
+	if (body === "") return `${frontmatter}\n`;
+	return `${frontmatter}\n\n${body}\n`;
+}
+function readDocumentMeta(fragment) {
+	const meta = {};
+	let type;
+	for (const child of fragment.toArray()) {
+		if (!(child instanceof yjs.XmlElement) || child.nodeName !== "documentMeta") continue;
+		const attrs = child.getAttributes();
+		for (const k of Object.keys(attrs)) {
+			const v = attrs[k];
+			if (v === void 0 || v === null) continue;
+			if (k === "type" && typeof v === "string") {
+				type = v;
+				continue;
+			}
+			meta[k] = v;
+		}
+		break;
+	}
+	return {
+		meta,
+		type
+	};
+}
+function readDocumentHeader(fragment) {
+	for (const child of fragment.toArray()) {
+		if (!(child instanceof yjs.XmlElement) || child.nodeName !== "documentHeader") continue;
+		const text = child.toArray().find((c) => c instanceof yjs.XmlText);
+		const src = child.getAttribute("titleSource");
+		const source = src === "h1" || src === "frontmatter" ? src : void 0;
+		return {
+			text: text ? text.toString() : "",
+			source
+		};
+	}
+	return { text: "" };
+}
+function collectBodyBlocks(fragment) {
+	const out = [];
+	for (const child of fragment.toArray()) {
+		if (!(child instanceof yjs.XmlElement)) continue;
+		if (child.nodeName === "documentHeader" || child.nodeName === "documentMeta") continue;
+		out.push(child);
+	}
+	return out;
+}
+function serializeBlocksClean(blocks) {
+	const parts = [];
+	for (const block of blocks) {
+		if (block.nodeName === "paragraph" && block.length === 0) {
+			parts.push("");
+			continue;
+		}
+		parts.push(serializeBlock(block));
+	}
+	while (parts.length && parts[parts.length - 1] === "") parts.pop();
+	return parts.join("\n\n");
+}
+function isMetaEmpty(meta) {
+	if (!meta) return true;
+	for (const key of Object.keys(meta)) {
+		const v = meta[key];
+		if (v === void 0 || v === null) continue;
+		if (typeof v === "string" && v === "") continue;
+		if (Array.isArray(v) && v.length === 0) continue;
+		return false;
+	}
+	return true;
+}
+
+//#endregion
+//#region packages/convert/src/spec/nodes.ts
+const BOOL_FALSE_DEFAULT = {
+	key: "",
+	type: "boolean",
+	default: false,
+	optional: true
+};
+const bool = (key) => ({
+	...BOOL_FALSE_DEFAULT,
+	key
+});
+const str = (key, def) => ({
+	key,
+	type: "string",
+	default: def,
+	optional: true
+});
+const num = (key) => ({
+	key,
+	type: "number",
+	optional: true
+});
+const int = (key) => ({
+	key,
+	type: "integer",
+	optional: true
+});
+const VANILLA_BLOCKS = [
+	{
+		name: "documentHeader",
+		group: "block",
+		wire: "special",
+		doc: "Holds the title; hoisted to frontmatter on serialise."
+	},
+	{
+		name: "documentMeta",
+		group: "block",
+		wire: "special",
+		doc: "Holds page-level meta; serialised into frontmatter."
+	},
+	{
+		name: "paragraph",
+		group: "block",
+		wire: "vanilla",
+		contentBearing: true
+	},
+	{
+		name: "heading",
+		group: "block",
+		wire: "vanilla",
+		attrs: [int("level")],
+		contentBearing: true
+	},
+	{
+		name: "blockquote",
+		group: "block",
+		wire: "vanilla",
+		contentBearing: true
+	},
+	{
+		name: "codeBlock",
+		group: "block",
+		wire: "fence",
+		attrs: [str("language", "")]
+	},
+	{
+		name: "bulletList",
+		group: "block",
+		wire: "vanilla"
+	},
+	{
+		name: "orderedList",
+		group: "block",
+		wire: "vanilla"
+	},
+	{
+		name: "listItem",
+		group: "block",
+		wire: "vanilla",
+		contentBearing: true
+	},
+	{
+		name: "taskList",
+		group: "block",
+		wire: "vanilla"
+	},
+	{
+		name: "taskItem",
+		group: "block",
+		wire: "vanilla",
+		attrs: [bool("checked")],
+		contentBearing: true
+	},
+	{
+		name: "table",
+		group: "block",
+		wire: "vanilla"
+	},
+	{
+		name: "tableRow",
+		group: "block",
+		wire: "vanilla"
+	},
+	{
+		name: "tableHeader",
+		group: "block",
+		wire: "vanilla",
+		contentBearing: true
+	},
+	{
+		name: "tableCell",
+		group: "block",
+		wire: "vanilla",
+		contentBearing: true
+	},
+	{
+		name: "horizontalRule",
+		group: "block",
+		wire: "vanilla"
+	},
+	{
+		name: "image",
+		group: "block",
+		wire: "special",
+		attrs: [
+			str("src"),
+			str("alt", ""),
+			int("width"),
+			int("height")
+		]
+	},
+	{
+		name: "hardBreak",
+		group: "inline",
+		wire: "vanilla"
+	}
+];
+const MDC_CONTAINERS = [
+	{
+		name: "callout",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			{
+				key: "type",
+				type: "string",
+				default: "note",
+				optional: true,
+				values: [
+					"note",
+					"tip",
+					"warning",
+					"danger",
+					"info",
+					"caution",
+					"alert",
+					"success",
+					"error"
+				]
+			},
+			str("title"),
+			str("icon")
+		]
+	},
+	{
+		name: "collapsible",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [str("label", "Details"), bool("open")]
+	},
+	{
+		name: "accordion",
+		group: "block",
+		wire: "mdc-slotted",
+		slotChild: "accordionItem"
+	},
+	{
+		name: "accordionItem",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "accordion-item",
+		attrs: [str("label", "Item"), str("icon")]
+	},
+	{
+		name: "tabs",
+		group: "block",
+		wire: "mdc-slotted",
+		slotChild: "tabsItem"
+	},
+	{
+		name: "tabsItem",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "tabs-item",
+		attrs: [str("label"), str("icon")]
+	},
+	{
+		name: "steps",
+		group: "block",
+		wire: "mdc-container"
+	},
+	{
+		name: "card",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			str("title"),
+			str("icon"),
+			str("to")
+		]
+	},
+	{
+		name: "cardGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "card-group",
+		slotChild: "card"
+	},
+	{
+		name: "field",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			str("name"),
+			str("type", "string"),
+			bool("required")
+		]
+	},
+	{
+		name: "fieldGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "field-group",
+		slotChild: "field"
+	},
+	{
+		name: "codeGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "code-group",
+		slotChild: "codeBlock"
+	},
+	{
+		name: "codeCollapse",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "code-collapse"
+	},
+	{
+		name: "codePreview",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "code-preview"
+	},
+	{
+		name: "codeTree",
+		group: "block",
+		wire: "mdc-atom-block",
+		mdcTag: "code-tree",
+		attrs: [{
+			key: "files",
+			type: "json"
+		}]
+	},
+	{
+		name: "figure",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			str("src"),
+			str("alt", ""),
+			str("caption")
+		]
+	},
+	{
+		name: "video",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [
+			str("src"),
+			str("poster"),
+			bool("autoplay"),
+			bool("loop"),
+			bool("controls")
+		]
+	},
+	{
+		name: "embed",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [str("src"), str("title")]
+	},
+	{
+		name: "svgEmbed",
+		group: "block",
+		wire: "fence",
+		attrs: [str("title")],
+		mdcTag: "svg",
+		doc: "Serialised as a ```svg fenced block; the SVG markup is the body."
+	},
+	{
+		name: "divider",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [str("label"), str("icon")]
+	},
+	{
+		name: "quote",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [str("cite")]
+	},
+	{
+		name: "progress",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [
+			num("value"),
+			num("max"),
+			str("label")
+		]
+	},
+	{
+		name: "spoiler",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [str("label")]
+	},
+	{
+		name: "colorSwatch",
+		group: "block",
+		wire: "mdc-atom-block",
+		mdcTag: "color-swatch",
+		attrs: [str("color"), str("label")]
+	},
+	{
+		name: "stat",
+		group: "block",
+		wire: "mdc-container",
+		attrs: [
+			str("label"),
+			str("value"),
+			str("icon")
+		]
+	},
+	{
+		name: "statGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "stat-group",
+		slotChild: "stat"
+	},
+	{
+		name: "button",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [
+			str("label"),
+			str("to"),
+			str("icon"),
+			str("variant")
+		]
+	},
+	{
+		name: "buttonGroup",
+		group: "block",
+		wire: "mdc-slotted",
+		mdcTag: "button-group",
+		slotChild: "button"
+	},
+	{
+		name: "timeline",
+		group: "block",
+		wire: "mdc-slotted",
+		slotChild: "timelineItem"
+	},
+	{
+		name: "timelineItem",
+		group: "block",
+		wire: "mdc-container",
+		mdcTag: "timeline-item",
+		attrs: [
+			str("label"),
+			str("icon"),
+			str("date")
+		]
+	},
+	{
+		name: "diff",
+		group: "block",
+		wire: "mdc-atom-block",
+		attrs: [str("language", ""), {
+			key: "value",
+			type: "string"
+		}]
+	}
+];
+const INLINE_AND_SPECIAL = [
+	{
+		name: "docLink",
+		group: "inline",
+		wire: "special",
+		attrs: [str("docId")],
+		doc: "Wire form `[[uuid|label]]`; label regenerated on export."
+	},
+	{
+		name: "docEmbed",
+		group: "block",
+		wire: "special",
+		attrs: [
+			str("docId"),
+			bool("collapsed"),
+			bool("tall"),
+			bool("seamless")
+		],
+		doc: "Wire form `![[uuid|label]]{collapsed tall seamless}`."
+	},
+	{
+		name: "mention",
+		group: "inline",
+		wire: "special",
+		attrs: [str("userId")],
+		doc: "Wire form `@[label](user:uuid)`; label regenerated on export."
+	},
+	{
+		name: "mathInline",
+		group: "inline",
+		wire: "special",
+		attrs: [{
+			key: "expression",
+			type: "string"
+		}],
+		doc: "Wire form `$expression$`."
+	},
+	{
+		name: "mathBlock",
+		group: "block",
+		wire: "fence",
+		attrs: [{
+			key: "expression",
+			type: "string"
+		}],
+		mdcTag: "math",
+		doc: "Wire form ``` ```math\\nexpression\\n``` ```."
+	},
+	{
+		name: "fileBlock",
+		group: "block",
+		wire: "mdc-atom-block",
+		mdcTag: "file",
+		attrs: [
+			str("src"),
+			str("mime"),
+			str("uploadId"),
+			str("filename")
+		],
+		doc: "Wire form `:file{src=… mime=… upload-id=… filename=…}`; binary in sidecar."
+	},
+	{
+		name: "badge",
+		group: "inline",
+		wire: "mdc-atom-inl",
+		attrs: [
+			str("label"),
+			str("color"),
+			str("variant", "subtle")
+		],
+		doc: "Wire form `:badge[Label]{color=… variant=…}`."
+	},
+	{
+		name: "proseIcon",
+		group: "inline",
+		wire: "mdc-atom-inl",
+		mdcTag: "icon",
+		attrs: [str("name")],
+		doc: "Wire form `:icon{name=…}`."
+	},
+	{
+		name: "kbd",
+		group: "inline",
+		wire: "mdc-atom-inl",
+		attrs: [str("value")],
+		doc: "Wire form `:kbd{value=…}`."
+	}
+];
+const NODE_SPECS = [
+	...VANILLA_BLOCKS,
+	...MDC_CONTAINERS,
+	...INLINE_AND_SPECIAL
+];
+const NODE_SPEC_BY_NAME = new Map(NODE_SPECS.map((spec) => [spec.name, spec]));
+
+//#endregion
+//#region packages/convert/src/spec/marks.ts
+const MARK_SPECS = [
+	{
+		name: "bold",
+		wire: "delimited",
+		delim: "**"
+	},
+	{
+		name: "italic",
+		wire: "delimited",
+		delim: "*"
+	},
+	{
+		name: "strike",
+		wire: "delimited",
+		delim: "~~"
+	},
+	{
+		name: "code",
+		wire: "delimited",
+		delim: "`"
+	},
+	{
+		name: "link",
+		wire: "link",
+		attrs: [{
+			key: "href",
+			type: "string"
+		}, {
+			key: "title",
+			type: "string",
+			optional: true
+		}]
+	},
+	{
+		name: "underline",
+		wire: "delimited",
+		delim: "__",
+		doc: "Disambiguated from bold by delimiter character. Two underscores = underline; two asterisks = bold."
+	},
+	{
+		name: "highlight",
+		wire: "delimited",
+		delim: "==",
+		doc: "Pandoc-style."
+	},
+	{
+		name: "subscript",
+		wire: "delimited",
+		delim: "~",
+		doc: "Single tilde; double tilde is strike."
+	},
+	{
+		name: "superscript",
+		wire: "delimited",
+		delim: "^"
+	},
+	{
+		name: "textStyle",
+		wire: "mdc-span",
+		attrs: [
+			{
+				key: "color",
+				type: "string",
+				optional: true
+			},
+			{
+				key: "backgroundColor",
+				type: "string",
+				optional: true
+			},
+			{
+				key: "fontSize",
+				type: "string",
+				optional: true
+			},
+			{
+				key: "fontFamily",
+				type: "string",
+				optional: true
+			}
+		],
+		doc: "Wire form `:span[text]{color=\"…\" font-size=\"…\"}`. Any of the attrs may be set."
+	}
+];
+const MARK_SPEC_BY_NAME = new Map(MARK_SPECS.map((spec) => [spec.name, spec]));
+const MARK_SPEC_BY_DELIM = new Map(MARK_SPECS.filter((spec) => spec.wire === "delimited" && !!spec.delim).map((spec) => [spec.delim, spec]));
+
+//#endregion
+//#region packages/convert/src/spec/universal-meta.ts
+const UNIVERSAL_META_KEYS = [
+	{
+		key: "title",
+		type: "string",
+		doc: "Display title; the first H1 is hoisted into this field on import."
+	},
+	{
+		key: "type",
+		type: "string",
+		doc: "Page type (doc, kanban, table, …). Omitted on serialise when \"doc\"."
+	},
+	{
+		key: "color",
+		type: "string",
+		doc: "Hex or CSS color name."
+	},
+	{
+		key: "icon",
+		type: "string",
+		doc: "Lucide icon name in kebab-case."
+	},
+	{
+		key: "datetimeStart",
+		type: "iso-datetime"
+	},
+	{
+		key: "datetimeEnd",
+		type: "iso-datetime"
+	},
+	{
+		key: "allDay",
+		type: "boolean"
+	},
+	{
+		key: "dateTaken",
+		type: "iso-datetime"
+	},
+	{
+		key: "dateStart",
+		type: "iso-date",
+		parseAliases: ["date", "created"]
+	},
+	{
+		key: "dateEnd",
+		type: "iso-date",
+		parseAliases: ["due"]
+	},
+	{
+		key: "timeStart",
+		type: "hh-mm"
+	},
+	{
+		key: "timeEnd",
+		type: "hh-mm"
+	},
+	{
+		key: "tags",
+		type: "string[]"
+	},
+	{
+		key: "checked",
+		type: "boolean",
+		parseAliases: ["done"]
+	},
+	{
+		key: "priority",
+		type: "integer",
+		min: 0,
+		max: 4,
+		doc: "Numeric or named (low/medium/high/urgent → 1/2/3/4)."
+	},
+	{
+		key: "status",
+		type: "string"
+	},
+	{
+		key: "rating",
+		type: "number",
+		min: 0,
+		max: 5
+	},
+	{
+		key: "url",
+		type: "string"
+	},
+	{
+		key: "email",
+		type: "string"
+	},
+	{
+		key: "phone",
+		type: "string"
+	},
+	{
+		key: "number",
+		type: "number"
+	},
+	{
+		key: "unit",
+		type: "string"
+	},
+	{
+		key: "subtitle",
+		type: "string",
+		parseAliases: ["description"]
+	},
+	{
+		key: "note",
+		type: "string"
+	},
+	{
+		key: "taskProgress",
+		type: "integer",
+		min: 0,
+		max: 100
+	},
+	{
+		key: "members",
+		type: "members"
+	},
+	{
+		key: "coverUploadId",
+		type: "string"
+	},
+	{
+		key: "coverDocId",
+		type: "string"
+	},
+	{
+		key: "coverMimeType",
+		type: "string"
+	},
+	{
+		key: "geoType",
+		type: "string-enum",
+		values: [
+			"marker",
+			"line",
+			"measure"
+		]
+	},
+	{
+		key: "geoLat",
+		type: "number"
+	},
+	{
+		key: "geoLng",
+		type: "number"
+	},
+	{
+		key: "geoDescription",
+		type: "string"
+	},
+	{
+		key: "deskX",
+		type: "number"
+	},
+	{
+		key: "deskY",
+		type: "number"
+	},
+	{
+		key: "deskZ",
+		type: "number"
+	},
+	{
+		key: "deskMode",
+		type: "string-enum",
+		values: [
+			"icon",
+			"widget-sm",
+			"widget-lg"
+		]
+	},
+	{
+		key: "mmX",
+		type: "number"
+	},
+	{
+		key: "mmY",
+		type: "number"
+	},
+	{
+		key: "graphX",
+		type: "number"
+	},
+	{
+		key: "graphY",
+		type: "number"
+	},
+	{
+		key: "graphPinned",
+		type: "boolean"
+	},
+	{
+		key: "spX",
+		type: "number"
+	},
+	{
+		key: "spY",
+		type: "number"
+	},
+	{
+		key: "spZ",
+		type: "number"
+	},
+	{
+		key: "spRX",
+		type: "number"
+	},
+	{
+		key: "spRY",
+		type: "number"
+	},
+	{
+		key: "spRZ",
+		type: "number"
+	},
+	{
+		key: "spSX",
+		type: "number"
+	},
+	{
+		key: "spSY",
+		type: "number"
+	},
+	{
+		key: "spSZ",
+		type: "number"
+	},
+	{
+		key: "spShape",
+		type: "string-enum",
+		values: [
+			"box",
+			"sphere",
+			"cylinder",
+			"cone",
+			"plane",
+			"torus",
+			"glb"
+		]
+	},
+	{
+		key: "spOpacity",
+		type: "integer",
+		min: 0,
+		max: 100
+	},
+	{
+		key: "spModelUploadId",
+		type: "string"
+	},
+	{
+		key: "spModelDocId",
+		type: "string"
+	},
+	{
+		key: "slidesTransition",
+		type: "string-enum",
+		values: [
+			"none",
+			"fade",
+			"slide"
+		]
+	},
+	{
+		key: "slidesTheme",
+		type: "string-enum",
+		values: ["dark", "light"]
+	},
+	{
+		key: "__schemaVersion",
+		type: "integer",
+		min: 0
+	}
+];
+const UNIVERSAL_META_KEY_NAMES = new Set(UNIVERSAL_META_KEYS.map((k) => k.key));
+
+//#endregion
+//#region packages/cli/src/commands/documents.ts
+/**
+* Document CRUD commands: read, create, rename, move, delete, type, doc.
+*/
+/** Safely read a tree map value, converting Y.Map to plain object if needed. */
+function toPlain$1(val) {
+	return val instanceof yjs.Map ? val.toJSON() : val;
+}
+registerCommand({
+	name: "doc",
+	aliases: ["info:doc"],
+	description: "Show document metadata (label, type, meta, dates).",
+	usage: "doc id=<docId> | name=<label> | path=<a/b/c>",
+	async run(conn, args) {
+		if (!conn) return "Not connected";
+		const docId = resolveDocument(conn, args.params, args.positional);
+		if (!docId) return "Document not found. Specify id=, name=, or path= to identify the document.";
+		const treeMap = conn.getTreeMap();
+		if (!treeMap) return "Not connected";
+		const raw = treeMap.get(docId);
+		if (!raw) return `Document ${docId} not found in tree.`;
+		const entry = toPlain$1(raw);
+		const lines = [
+			`id:        ${docId}`,
+			`label:     ${entry.label || "Untitled"}`,
+			`type:      ${entry.type ?? "—"}`,
+			`parent:    ${entry.parentId ?? "(root)"}`,
+			`order:     ${entry.order ?? 0}`,
+			`created:   ${entry.createdAt ? new Date(entry.createdAt).toISOString() : "—"}`,
+			`updated:   ${entry.updatedAt ? new Date(entry.updatedAt).toISOString() : "—"} (${relativeTime(entry.updatedAt)})`
+		];
+		if (entry.meta && Object.keys(entry.meta).length > 0) {
+			lines.push(`meta:`);
+			for (const [k, v] of Object.entries(entry.meta)) lines.push(`  ${k}: ${typeof v === "object" ? JSON.stringify(v) : v}`);
+		}
+		const children = childrenOf(readEntries(treeMap), docId);
+		lines.push(`children:  ${children.length}`);
+		return lines.join("\n");
+	}
+});
+registerCommand({
+	name: "read",
+	aliases: ["cat", "r"],
+	description: "Read document content as markdown.",
+	usage: "read id=<docId> | name=<label> | path=<a/b/c> [--format=json|md]",
+	async run(conn, args) {
+		if (!conn) return "Not connected";
 		const docId = resolveDocument(conn, args.params, args.positional);
 		if (!docId) return "Document not found. Specify id=, name=, or path= to identify the document.";
 		try {
@@ -3123,23 +4382,24 @@ registerCommand({
 registerCommand({
 	name: "chat",
 	aliases: ["send"],
-	description: "Send a chat message to a channel.",
-	usage: "chat channel=<group:docId> text=<message>",
+	description: "Send a chat message to a channel doc.",
+	usage: "chat channel_doc_id=<docId> text=<message>",
 	async run(conn, args) {
 		if (!conn) return "Not connected";
 		const rootProvider = conn.rootProvider;
 		if (!rootProvider) return "Not connected";
-		const channel = args.params["channel"];
-		if (!channel) return "Missing required parameter: channel=<group:docId>";
+		const raw = args.params["channel_doc_id"] || args.params["channel"];
+		if (!raw) return "Missing required parameter: channel_doc_id=<docId>";
+		const channel_doc_id = raw.startsWith("group:") ? raw.slice(6) : raw;
 		const text = args.params["text"] || args.params["content"] || args.positional[0];
 		if (!text) return "Missing required parameter: text=<message>";
 		rootProvider.sendStateless(JSON.stringify({
-			type: "chat:send",
-			channel,
+			type: "messages:send",
+			channel_doc_id,
 			content: text,
-			sender_name: conn.displayName
+			mentions: []
 		}));
-		return `Sent to ${channel}`;
+		return `Sent to ${channel_doc_id}`;
 	}
 });
 
@@ -3309,6 +4569,16 @@ const PAGE_TYPES = {
 		core: true,
 		supportsChildren: true
 	},
+	prose: {
+		key: "prose",
+		label: "Prose",
+		icon: "pen-tool",
+		description: "Long-form prose with serif typography and a narrow readable measure",
+		core: true,
+		supportsChildren: true,
+		childLabel: "Item",
+		defaultDepth: -1
+	},
 	kanban: {
 		key: "kanban",
 		label: "Kanban",
@@ -4093,6 +5363,695 @@ registerCommand({
 	}
 });
 
+//#endregion
+//#region packages/cli/src/commands/wiki/wikipedia.ts
+/**
+* Rate-limited wrapper around wtf_wikipedia + wtf-plugin-api.
+*
+* Responsibilities:
+*   - Throttle requests to respect Wikimedia API etiquette
+*   - Cache parsed Documents by canonical title
+*   - Resolve redirects so callers always see the redirect target
+*   - Expose getCategoryPages via wtf-plugin-api
+*/
+let pluginExtended = false;
+function ensurePlugin() {
+	if (pluginExtended) return;
+	wtf_wikipedia.default.extend(wtf_plugin_api.default);
+	pluginExtended = true;
+}
+/** A token-bucket-ish throttle: at most `rate` calls per second, FIFO. */
+var RateLimiter = class {
+	lastTickMs = 0;
+	constructor(intervalMs) {
+		this.intervalMs = intervalMs;
+	}
+	async wait() {
+		const now = Date.now();
+		const earliest = this.lastTickMs + this.intervalMs;
+		if (now < earliest) await new Promise((r) => setTimeout(r, earliest - now));
+		this.lastTickMs = Math.max(now, earliest);
+	}
+};
+var WikipediaClient = class {
+	cache = /* @__PURE__ */ new Map();
+	redirects = /* @__PURE__ */ new Map();
+	limiter;
+	fetchOpts;
+	constructor(config) {
+		this.config = config;
+		ensurePlugin();
+		this.limiter = new RateLimiter(Math.max(50, Math.floor(1e3 / Math.max(.1, config.rate))));
+		this.fetchOpts = {
+			lang: config.lang,
+			"Api-User-Agent": config.userAgent,
+			follow_redirects: true
+		};
+		if (config.domain) this.fetchOpts.domain = config.domain;
+	}
+	/**
+	* Fetch and parse a Wikipedia article.
+	* - Returns the cached Document if we've seen this title before.
+	* - Follows redirects and caches under both source and target titles.
+	* - Returns null when the page does not exist.
+	*/
+	async fetchArticle(rawTitle) {
+		const title = canonicalTitle(rawTitle);
+		if (this.cache.has(title)) return this.cache.get(title);
+		if (this.redirects.has(title)) {
+			const target = this.redirects.get(title);
+			return this.cache.get(target) ?? null;
+		}
+		await this.limiter.wait();
+		let doc;
+		try {
+			doc = await wtf_wikipedia.default.fetch(title, this.fetchOpts);
+		} catch (err) {
+			throw new Error(`Wikipedia fetch failed for "${title}": ${err?.message ?? err}`);
+		}
+		if (!doc) return null;
+		if (typeof doc.isRedirect === "function" && doc.isRedirect()) {
+			const target = doc.redirectTo?.()?.page;
+			if (typeof target === "string") {
+				this.redirects.set(title, canonicalTitle(target));
+				return await this.fetchArticle(target);
+			}
+		}
+		const resolvedTitle = canonicalTitle(doc.title?.() ?? title);
+		this.cache.set(resolvedTitle, doc);
+		if (resolvedTitle !== title) this.redirects.set(title, resolvedTitle);
+		return doc;
+	}
+	/**
+	* Fetch the member pages of a category (and optionally sub-categories).
+	* @param category Category title (with or without "Category:" prefix).
+	* @param recursive Whether to traverse sub-categories.
+	* @param maxDepth Recursion depth when recursive=true.
+	*/
+	async fetchCategoryPages(category, recursive, maxDepth) {
+		await this.limiter.wait();
+		const opts = {
+			lang: this.config.lang,
+			"Api-User-Agent": this.config.userAgent,
+			recursive,
+			maxDepth
+		};
+		if (this.config.domain) opts.domain = this.config.domain;
+		return (await wtf_wikipedia.default.getCategoryPages(category, opts) ?? []).map((m) => ({
+			title: canonicalTitle(m.title),
+			type: m.type === "subcat" ? "subcat" : "page"
+		}));
+	}
+};
+/** Normalize a Wikipedia title — trim, collapse spaces, strip leading/trailing colons. */
+function canonicalTitle(s) {
+	return (s ?? "").toString().replace(/_/g, " ").replace(/\s+/g, " ").trim();
+}
+/** Detect a category-namespaced title. */
+const CATEGORY_PREFIX = /^(Category|Catégorie|Kategorie|Categoría|Categoria|Categorie|Kategoria):/i;
+function isCategoryTitle(title) {
+	return CATEGORY_PREFIX.test(title);
+}
+/** Strip the "Category:" prefix for display. */
+function stripCategoryPrefix(title) {
+	return title.replace(CATEGORY_PREFIX, "").trim();
+}
+
+//#endregion
+//#region packages/cli/src/commands/wiki/snapshot.ts
+function snapshotArticle(doc, title) {
+	return {
+		title,
+		linkTitles: collectLinkTitles(doc),
+		categories: collectCategories(doc),
+		sections: snapshotSections(doc.sections?.() ?? []),
+		infobox: snapshotInfobox(doc.infobox?.()),
+		lead: leadParagraph(doc),
+		url: typeof doc.url === "function" ? doc.url() : null
+	};
+}
+function prettyCategoryLabel(catTitle) {
+	return stripCategoryPrefix(catTitle);
+}
+function collectLinkTitles(doc) {
+	const links = doc.links?.() ?? [];
+	const out = /* @__PURE__ */ new Set();
+	for (const l of links) {
+		if (!l) continue;
+		const page = typeof l.page === "function" ? l.page() : null;
+		if (typeof page !== "string" || page.length === 0) continue;
+		if (isCategoryTitle(page)) continue;
+		out.add(canonicalTitle(page));
+	}
+	return [...out];
+}
+function collectCategories(doc) {
+	const out = [];
+	for (const c of doc.categories?.() ?? []) {
+		const norm = canonicalTitle(c);
+		if (norm) out.push(norm);
+	}
+	return out;
+}
+function snapshotSections(rawSections) {
+	const all = rawSections.map((s) => ({
+		raw: s,
+		title: s.title?.() || "",
+		parentRef: typeof s.parent === "function" ? s.parent() : null,
+		children: []
+	}));
+	const byRaw = /* @__PURE__ */ new Map();
+	for (const s of all) byRaw.set(s.raw, s);
+	const roots = [];
+	for (const s of all) if (s.parentRef && byRaw.has(s.parentRef)) byRaw.get(s.parentRef).children.push(materialize(s));
+	else roots.push(s);
+	return roots.map(materialize);
+}
+function materialize(node) {
+	const lists = node.raw.lists?.() ?? [];
+	const paragraphs = node.raw.paragraphs?.() ?? [];
+	let listLength = 0;
+	for (const l of lists) {
+		const lines = l.lines?.() ?? [];
+		listLength += lines.length;
+	}
+	const isList = lists.length > 0 && (paragraphs.length === 0 || listLength >= paragraphs.length * 2);
+	const bodyParts = [];
+	for (const p of paragraphs) {
+		const md = paragraphMarkdown(p);
+		if (md) bodyParts.push(md);
+	}
+	for (const l of lists) {
+		const lines = l.lines?.() ?? [];
+		for (const line of lines) {
+			const text = lineText(line);
+			if (text) bodyParts.push(`- ${text}`);
+		}
+	}
+	return {
+		title: node.title,
+		body: bodyParts.join("\n\n"),
+		isList,
+		listLength,
+		children: node.children
+	};
+}
+function snapshotInfobox(box) {
+	if (!box) return void 0;
+	const data = typeof box.json === "function" ? box.json() : null;
+	if (!data || typeof data !== "object") return void 0;
+	const rows = [];
+	for (const [key, val] of Object.entries(data)) {
+		const value = stringifyInfoboxValue(val);
+		if (!value) continue;
+		rows.push({
+			key: humanKey(key),
+			value
+		});
+	}
+	return rows.length > 0 ? rows : void 0;
+}
+function stringifyInfoboxValue(val) {
+	if (val == null) return "";
+	if (typeof val === "string") return val;
+	if (typeof val === "number" || typeof val === "boolean") return String(val);
+	if (Array.isArray(val)) return val.map(stringifyInfoboxValue).filter(Boolean).join(", ");
+	if (typeof val === "object") {
+		const o = val;
+		if (typeof o.text === "string") return o.text;
+		if (typeof o.number === "number") return String(o.number);
+	}
+	return "";
+}
+function humanKey(k) {
+	return k.replace(/_/g, " ").replace(/^./, (m) => m.toUpperCase());
+}
+function leadParagraph(doc) {
+	const first = (doc.paragraphs?.() ?? [])[0];
+	if (!first) return "";
+	return paragraphMarkdown(first);
+}
+/**
+* Render a paragraph as markdown, replacing internal links with `[[Title]]`.
+* The streaming orchestrator's link rewriter later swaps `[[Title]]` →
+* `[[docId|label]]` once IDs are known.
+*/
+function paragraphMarkdown(paragraph) {
+	const sentences = paragraph.sentences?.() ?? [];
+	const out = [];
+	for (const s of sentences) out.push(sentenceWithWikilinks(s));
+	return out.join(" ").trim();
+}
+function sentenceWithWikilinks(sentence) {
+	const text = (sentence.text?.() ?? "").toString();
+	const links = sentence.links?.() ?? [];
+	if (links.length === 0) return text;
+	let result = text;
+	const replacements = links.map((l) => {
+		const page = typeof l.page === "function" ? l.page() : null;
+		const display = typeof l.text === "function" ? l.text() : null;
+		if (typeof page !== "string" || page.length === 0) return null;
+		if (isCategoryTitle(page)) return null;
+		const shown = display && display.length > 0 ? display : page;
+		return {
+			page: canonicalTitle(page),
+			shown
+		};
+	}).filter((x) => x !== null).sort((a, b) => b.shown.length - a.shown.length);
+	for (const { page, shown } of replacements) {
+		if (!result.includes(shown)) continue;
+		const replacement = shown === page ? `[[${page}]]` : `[[${page}|${shown}]]`;
+		result = result.replace(shown, replacement);
+	}
+	return result;
+}
+function lineText(line) {
+	if (!line) return "";
+	if (typeof line === "string") return line;
+	if (typeof line.text === "string") return line.text;
+	if (typeof line.text === "function") return line.text();
+	return "";
+}
+
+//#endregion
+//#region packages/cli/src/commands/wiki/render.ts
+const ICONS = {
+	graph: "git-fork",
+	article: "book-open",
+	category: "tag",
+	infobox: "info",
+	outline: "list",
+	gallery: "images",
+	section: "pilcrow",
+	categories: "tags"
+};
+/** Decide a page type for a section based on its shape. */
+function pickSectionType(section) {
+	if (section.children.length > 0) return {
+		type: "outline",
+		icon: ICONS.outline
+	};
+	if (section.isList && section.listLength >= 5) return {
+		type: "outline",
+		icon: ICONS.outline
+	};
+	return {
+		type: "doc",
+		icon: ICONS.section
+	};
+}
+/** Render the lead paragraph as the article-doc body. */
+function renderArticleLead(article) {
+	return article.lead ?? "";
+}
+/** Render the article as a single doc, sections + infobox inlined. */
+function renderArticleSingleDoc(article) {
+	const parts = [];
+	if (article.lead) parts.push(article.lead);
+	if (article.infobox && article.infobox.length > 0) parts.push("## Infobox", renderInfoboxBody(article.infobox));
+	for (const section of article.sections) parts.push(...renderSectionInline(section, 2));
+	return parts.join("\n\n");
+}
+function renderSectionInline(section, level) {
+	const out = [];
+	const prefix = "#".repeat(Math.min(6, level));
+	if (section.title) out.push(`${prefix} ${section.title}`);
+	if (section.body.trim()) out.push(section.body);
+	for (const child of section.children) out.push(...renderSectionInline(child, level + 1));
+	return out;
+}
+function renderInfoboxBody(rows) {
+	return rows.map((r) => `- **${r.key}:** ${r.value}`).join("\n");
+}
+function renderCategoryBody(members, subcategories) {
+	const parts = [];
+	if (members.length > 0) {
+		parts.push("## Pages");
+		parts.push(members.map((m) => `- [[${m}]]`).join("\n"));
+	}
+	if (subcategories.length > 0) {
+		parts.push("## Sub-categories");
+		parts.push(subcategories.map((s) => `- ${s}`).join("\n"));
+	}
+	return parts.join("\n\n");
+}
+/**
+* Replace `[[Title]]` / `[[Title|Alias]]` in markdown with
+* `[[docId|label]]` using the title→docId map. Unresolved titles fall
+* back to plain text (their alias or original title).
+*/
+function rewriteLinks(markdown, titleToDocId) {
+	return markdown.replace(/\[\[([^\]|]+?)(?:\|([^\]]+?))?\]\]/g, (_match, target, alias) => {
+		const title = target.trim();
+		const docId = titleToDocId.get(title);
+		const display = (alias && alias.trim().length > 0 ? alias : title).trim();
+		if (!docId) return display;
+		return `[[${docId}|${display}]]`;
+	});
+}
+
+//#endregion
+//#region packages/cli/src/commands/wiki/connect.ts
+/**
+* Open a DocumentManager session for the wiki command, mirroring the
+* auth/register flow that CLIConnection uses but using the modern public API.
+*
+* Reuses the CLI's Ed25519 keypair handling (loadOrCreateKeypair, signChallenge)
+* so the wiki command authenticates with the same identity as every other
+* subcommand.
+*/
+async function openSession(config) {
+	const keypair = await loadOrCreateKeypair(config.keyFile);
+	const sign = (challenge) => Promise.resolve(signChallenge(challenge, keypair.privateKey));
+	const dm = new _abraca_dabra.DocumentManager({
+		url: config.url,
+		name: config.name ?? "Wiki Extractor",
+		color: config.color,
+		quiet: config.quiet
+	});
+	try {
+		await dm.client.loginWithKey(keypair.publicKeyB64, sign);
+	} catch (err) {
+		const status = err?.status ?? err?.response?.status;
+		if (status === 404 || status === 422) {
+			if (!config.quiet) console.error("[abracadabra] Key not registered, creating new account...");
+			await dm.client.registerWithKey({
+				publicKey: keypair.publicKeyB64,
+				username: (config.name ?? "wiki-extractor").replace(/\s+/g, "-").toLowerCase(),
+				displayName: config.name ?? "Wiki Extractor",
+				deviceName: "CLI Wiki",
+				inviteCode: config.inviteCode
+			});
+			await dm.client.loginWithKey(keypair.publicKeyB64, sign);
+		} else throw err;
+	}
+	await dm.connect();
+	const rootDocId = dm.rootDocId;
+	if (!rootDocId) throw new Error("Connected but no rootDocId — server has no spaces.");
+	return {
+		dm,
+		rootDocId
+	};
+}
+
+//#endregion
+//#region packages/cli/src/commands/wiki/index.ts
+registerCommand({
+	name: "wiki",
+	aliases: ["wikipedia"],
+	description: "Fetch Wikipedia articles into a graph of docs (streaming).",
+	usage: [
+		"wiki \"<Article Title>\"",
+		"  mode=single|split   single doc per article OR split into sections+infobox  [split]",
+		"  depth=<n>           follow internal links to depth N                       [1]",
+		"  category-depth=<n>  recurse into sub-categories                            [1]",
+		"  lang=<code>         wiki language                                          [en]",
+		"  domain=<host>       3rd-party MediaWiki host (overrides lang)",
+		"  parent=<docId>      parent doc for the new graph                           [active space root]",
+		"  user-agent=<str>    Api-User-Agent header (REQUIRED by Wikimedia etiquette)",
+		"  rate=<rps>          max wikipedia requests per second                      [3]",
+		"  --include-categories   expand each article's categories into nested graphs",
+		"  --dry-run              fetch only the entry article, print outline, no writes"
+	].join("\n"),
+	async run(_conn, args) {
+		const opts = parseOptions(args);
+		if (typeof opts === "string") return opts;
+		const log = (msg) => {
+			if (!args.flags.has("quiet") && !args.flags.has("q")) console.error(`[wiki] ${msg}`);
+		};
+		const wp = new WikipediaClient({
+			lang: opts.lang,
+			domain: opts.domain,
+			userAgent: opts.userAgent,
+			rate: opts.rate
+		});
+		if (opts.dryRun) {
+			log(`fetch ${opts.title}`);
+			const doc = await wp.fetchArticle(opts.title);
+			if (!doc) return `Article not found: "${opts.title}"`;
+			const snap = snapshotArticle(doc, canonicalTitle(doc.title?.() ?? opts.title));
+			return [
+				`Entry: ${snap.title}`,
+				`URL: ${snap.url ?? "(none)"}`,
+				`Internal links: ${snap.linkTitles.length}`,
+				`Categories: ${snap.categories.length}`,
+				`Sections: ${snap.sections.length}`,
+				`Has infobox: ${snap.infobox && snap.infobox.length > 0 ? "yes" : "no"}`,
+				"",
+				"── Sections ──",
+				printSections(snap.sections, "")
+			].join("\n");
+		}
+		const env = globalThis.process?.env ?? {};
+		const url = env["ABRA_URL"];
+		if (!url) return "ABRA_URL is required to write to the server. Set it or pass --dry-run.";
+		const { dm } = await openSession({
+			url,
+			name: env["ABRA_NAME"],
+			color: env["ABRA_COLOR"],
+			inviteCode: env["ABRA_INVITE_CODE"],
+			keyFile: env["ABRA_KEY_FILE"],
+			quiet: args.flags.has("quiet") || args.flags.has("q")
+		});
+		try {
+			const result = await runStreaming(dm, wp, opts, log);
+			return [`Done. Created ${result.articleCount} articles${result.categoryCount > 0 ? ` + ${result.categoryCount} categories` : ""}.`, `Root: ${result.rootDocId}`].join("\n");
+		} finally {
+			await dm.destroy().catch(() => {});
+		}
+	}
+});
+async function runStreaming(dm, wp, opts, log) {
+	const titleToDocId = /* @__PURE__ */ new Map();
+	const fetched = /* @__PURE__ */ new Map();
+	const childrenCreated = /* @__PURE__ */ new Set();
+	const categoryToDocId = /* @__PURE__ */ new Map();
+	let categoriesContainerId = null;
+	log(`fetch ${opts.title}`);
+	const entryDoc = await wp.fetchArticle(opts.title);
+	if (!entryDoc) throw new Error(`Article not found: "${opts.title}"`);
+	const entryTitle = canonicalTitle(entryDoc.title?.() ?? opts.title);
+	const entrySnap = snapshotArticle(entryDoc, entryTitle);
+	fetched.set(entryTitle, entrySnap);
+	const rootEntry = dm.tree.create({
+		parentId: opts.parentDocId ?? null,
+		label: entryTitle,
+		type: "graph",
+		meta: { icon: ICONS.graph }
+	});
+	log(`+ ${rootEntry.id.slice(0, 8)}…  ${entryTitle} (graph)`);
+	const entryArticleId = createArticleShell(dm, entrySnap, rootEntry.id, log);
+	titleToDocId.set(entryTitle, entryArticleId);
+	const queue = [{
+		title: entryTitle,
+		depth: 0
+	}];
+	let articleCount = 0;
+	while (queue.length > 0) {
+		const { title, depth } = queue.shift();
+		const articleDocId = titleToDocId.get(title);
+		let snap = fetched.get(title);
+		if (!snap) {
+			log(`fetch [d${depth}] ${title}`);
+			try {
+				const doc = await wp.fetchArticle(title);
+				if (!doc) {
+					log(`  not found — leaving stub`);
+					continue;
+				}
+				snap = snapshotArticle(doc, canonicalTitle(doc.title?.() ?? title));
+				fetched.set(title, snap);
+			} catch (err) {
+				log(`! fetch failed: ${err?.message ?? err}`);
+				continue;
+			}
+		}
+		if (opts.mode === "split" && !childrenCreated.has(title)) {
+			createArticleChildren(dm, snap, articleDocId, log);
+			childrenCreated.add(title);
+		}
+		if (depth < opts.depth) for (const linkTitle of snap.linkTitles) {
+			if (titleToDocId.has(linkTitle)) continue;
+			const shell = dm.tree.create({
+				parentId: rootEntry.id,
+				label: linkTitle,
+				type: "doc",
+				meta: { icon: ICONS.article }
+			});
+			titleToDocId.set(linkTitle, shell.id);
+			queue.push({
+				title: linkTitle,
+				depth: depth + 1
+			});
+			log(`+ ${shell.id.slice(0, 8)}…  ${linkTitle} (doc, shell)`);
+		}
+		if (opts.includeCategories && snap.categories.length > 0) {
+			if (!categoriesContainerId) {
+				const c = dm.tree.create({
+					parentId: rootEntry.id,
+					label: "Categories",
+					type: "graph",
+					meta: { icon: ICONS.categories }
+				});
+				categoriesContainerId = c.id;
+				log(`+ ${c.id.slice(0, 8)}…  Categories (graph)`);
+			}
+			for (const catTitle of snap.categories) {
+				if (categoryToDocId.has(catTitle)) continue;
+				const cat = dm.tree.create({
+					parentId: categoriesContainerId,
+					label: prettyCategoryLabel(catTitle),
+					type: "graph",
+					meta: { icon: ICONS.category }
+				});
+				categoryToDocId.set(catTitle, cat.id);
+				log(`+ ${cat.id.slice(0, 8)}…  ${prettyCategoryLabel(catTitle)} (graph, cat)`);
+			}
+		}
+		const body = opts.mode === "split" ? renderArticleLead(snap) : renderArticleSingleDoc(snap);
+		if (body.trim().length > 0) {
+			const rewritten = rewriteLinks(body, titleToDocId);
+			try {
+				await dm.content.write(articleDocId, rewritten);
+				log(`✓ body  ${title}`);
+			} catch (err) {
+				log(`! body write failed for ${title}: ${err?.message ?? err}`);
+			}
+		}
+		if (opts.mode === "split") await writeChildrenBodies(dm, snap, articleDocId, titleToDocId, log);
+		articleCount++;
+	}
+	let categoryCount = 0;
+	if (opts.includeCategories && categoryToDocId.size > 0) for (const [catTitle, catDocId] of categoryToDocId) {
+		log(`category ${catTitle}`);
+		try {
+			const members = await wp.fetchCategoryPages(catTitle, opts.categoryDepth > 0, Math.max(0, opts.categoryDepth));
+			const memberArticles = [];
+			const subcats = [];
+			for (const m of members) if (m.type === "subcat") subcats.push(prettyCategoryLabel(m.title));
+			else memberArticles.push(m.title);
+			const rewritten = rewriteLinks(renderCategoryBody(memberArticles, subcats), titleToDocId);
+			if (rewritten.trim().length > 0) {
+				await dm.content.write(catDocId, rewritten);
+				log(`✓ body  category ${catTitle}`);
+			}
+			categoryCount++;
+		} catch (err) {
+			log(`! category ${catTitle}: ${err?.message ?? err}`);
+		}
+	}
+	return {
+		rootDocId: rootEntry.id,
+		articleCount,
+		categoryCount
+	};
+}
+function createArticleShell(dm, article, parentId, log) {
+	const meta = { icon: ICONS.article };
+	if (article.url) meta.url = article.url;
+	const entry = dm.tree.create({
+		parentId,
+		label: article.title,
+		type: "doc",
+		meta
+	});
+	log(`+ ${entry.id.slice(0, 8)}…  ${article.title} (doc)`);
+	return entry.id;
+}
+/**
+* Create section + infobox child docs for a split-mode article. Returns nothing
+* — children get bodies written later in writeChildrenBodies.
+*/
+function createArticleChildren(dm, article, articleDocId, log) {
+	if (article.infobox && article.infobox.length > 0) {
+		const ib = dm.tree.create({
+			parentId: articleDocId,
+			label: "Infobox",
+			type: "outline",
+			meta: { icon: ICONS.infobox }
+		});
+		log(`  + ${ib.id.slice(0, 8)}…  Infobox (outline)`);
+		article._infoboxDocId = ib.id;
+	}
+	for (const section of article.sections) createSectionShell(dm, section, articleDocId, log);
+}
+function createSectionShell(dm, section, parentDocId, log) {
+	const hasChildren = section.children.length > 0;
+	if (!section.body.trim() && !hasChildren) return;
+	const { type, icon } = pickSectionType(section);
+	const entry = dm.tree.create({
+		parentId: parentDocId,
+		label: section.title || "Untitled section",
+		type,
+		meta: { icon }
+	});
+	log(`  + ${entry.id.slice(0, 8)}…  ${entry.label} (${type})`);
+	section._docId = entry.id;
+	for (const child of section.children) createSectionShell(dm, child, entry.id, log);
+}
+async function writeChildrenBodies(dm, article, _articleDocId, titleToDocId, log) {
+	const infoboxDocId = article._infoboxDocId;
+	if (infoboxDocId && article.infobox && article.infobox.length > 0) try {
+		await dm.content.write(infoboxDocId, renderInfoboxBody(article.infobox));
+	} catch (err) {
+		log(`! infobox body write failed: ${err?.message ?? err}`);
+	}
+	for (const section of article.sections) await writeSectionBody(dm, section, titleToDocId, log);
+}
+async function writeSectionBody(dm, section, titleToDocId, log) {
+	const docId = section._docId;
+	if (docId && section.body.trim().length > 0) try {
+		await dm.content.write(docId, rewriteLinks(section.body, titleToDocId));
+	} catch (err) {
+		log(`! section body write failed for ${section.title}: ${err?.message ?? err}`);
+	}
+	for (const child of section.children) await writeSectionBody(dm, child, titleToDocId, log);
+}
+function parseOptions(args) {
+	const title = args.positional[0]?.trim() || args.params["title"];
+	if (!title) return "Missing required positional argument: <title>. Example: abracadabra wiki \"Toronto Raptors\"";
+	const env = globalThis.process?.env ?? {};
+	const userAgent = args.params["user-agent"] || args.params["userAgent"] || env["ABRA_WIKI_USER_AGENT"];
+	if (!userAgent) return ["Missing required parameter: user-agent=\"your-name (you@example.com)\"", "(Wikimedia etiquette requires an Api-User-Agent header. Pass user-agent=... or set ABRA_WIKI_USER_AGENT.)"].join("\n");
+	const mode = args.params["mode"] ?? "split";
+	if (mode !== "single" && mode !== "split") return `Invalid mode "${mode}". Use mode=single or mode=split.`;
+	const depth = parseIntOr(args.params["depth"], 1);
+	const categoryDepth = parseIntOr(args.params["category-depth"] ?? args.params["categoryDepth"], 1);
+	const rate = parseFloatOr(args.params["rate"], 3);
+	return {
+		title,
+		mode,
+		depth,
+		categoryDepth,
+		includeCategories: args.flags.has("include-categories") || args.flags.has("includeCategories"),
+		lang: args.params["lang"] ?? "en",
+		domain: args.params["domain"],
+		parentDocId: args.params["parent"],
+		userAgent,
+		rate,
+		dryRun: args.flags.has("dry-run") || args.flags.has("dryRun")
+	};
+}
+function parseIntOr(s, fallback) {
+	if (!s) return fallback;
+	const n = Number.parseInt(s, 10);
+	return Number.isFinite(n) && n >= 0 ? n : fallback;
+}
+function parseFloatOr(s, fallback) {
+	if (!s) return fallback;
+	const n = Number.parseFloat(s);
+	return Number.isFinite(n) && n > 0 ? n : fallback;
+}
+function printSections(sections, indent) {
+	const lines = [];
+	for (const s of sections) {
+		const hint = s.body ? ` (${s.body.length}b)` : "";
+		lines.push(`${indent}- ${s.title}${hint}${s.children.length > 0 ? ` [${s.children.length} sub]` : ""}`);
+		if (s.children.length > 0) lines.push(printSections(s.children, indent + "  "));
+	}
+	return lines.join("\n");
+}
+
 //#endregion
 //#region packages/cli/src/index.ts
 /**
@@ -4116,7 +6075,9 @@ const NO_CONNECT_COMMANDS = new Set([
 	"v",
 	"page-types",
 	"types",
-	"doctypes"
+	"doctypes",
+	"wiki",
+	"wikipedia"
 ]);
 async function main() {
 	const args = parseArgs(process.argv);