@mx-space/cli 0.10.0 → 0.11.0

package/dist/bin/mxs.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { t as run } from "../mxs-BLgwEih6.mjs";
+import { t as run } from "../mxs-BNvfyLLp.mjs";
 export { run };

package/dist/index.mjs

@@ -1,2 +1,2 @@
-import { a as defaultMessageFor, c as tagToCode, i as codeForTag, l as toErrorEnvelope, n as defaultGlobalFlags, o as exitCodeForError, r as parseGlobalFlags, s as exitCodeForTag, t as run } from "./mxs-BLgwEih6.mjs";
+import { a as defaultMessageFor, c as tagToCode, i as codeForTag, l as toErrorEnvelope, n as defaultGlobalFlags, o as exitCodeForError, r as parseGlobalFlags, s as exitCodeForTag, t as run } from "./mxs-BNvfyLLp.mjs";
 export { codeForTag, defaultGlobalFlags, defaultMessageFor, exitCodeForError, exitCodeForTag, parseGlobalFlags, run, tagToCode, toErrorEnvelope };

package/dist/{mxs-BLgwEih6.mjs → mxs-BNvfyLLp.mjs}

@@ -13,7 +13,7 @@ import fs, { existsSync, mkdirSync, openSync, readFileSync, realpathSync, rename
 import * as OS from "node:os";
 import os, { arch, platform } from "node:os";
 import * as Path from "node:path";
-import path from "node:path";
+import path, { basename } from "node:path";
 import * as NodeUrl from "node:url";
 import { fileURLToPath } from "node:url";
 import * as readline from "node:readline";
@@ -23,7 +23,7 @@ import * as Https from "node:https";
 import { pipeline } from "node:stream/promises";
 import { promisify, styleText } from "node:util";
 import { Buffer as Buffer$1 } from "node:buffer";
-import fs$1, { constants } from "node:fs/promises";
+import fs$1, { constants, readFile } from "node:fs/promises";
 import process$1, { stdin, stdout } from "node:process";
 //#region ../../node_modules/.pnpm/@effect+platform@0.96.1_effect@3.21.2/node_modules/@effect/platform/dist/esm/Error.js
 /**
@@ -4640,7 +4640,7 @@ const levensteinDistance = (first, second, config) => {
 //#endregion
 //#region ../../node_modules/.pnpm/@effect+cli@0.75.2_@effect+platform@0.96.1_effect@3.21.2__@effect+printer-ansi@0.49.0_@_4d5fe3e52e753e91ea7f4be1c61c2cec/node_modules/@effect/cli/dist/esm/internal/prompt/list.js
 /** @internal */
-const list$9 = (options) => text$9(options).pipe(map$3((output) => output.split(options.delimiter || ",")));
+const list$10 = (options) => text$9(options).pipe(map$3((output) => output.split(options.delimiter || ",")));
 /** @internal */
 const OptionsTypeId = /*#__PURE__*/ Symbol.for("@effect/cli/Options");
 const proto$2 = {
@@ -4684,8 +4684,8 @@ const boolean$1 = (name, options) => {
 		...options
 	};
 	const option = makeSingle(name, aliases, boolean$2(some(ifPresent)));
-	if (isNonEmptyReadonlyArray(negationNames)) return withDefault(orElse(option, makeSingle(headNonEmpty(negationNames), tailNonEmpty(negationNames), boolean$2(some(!ifPresent)))), !ifPresent);
-	return withDefault(option, !ifPresent);
+	if (isNonEmptyReadonlyArray(negationNames)) return withDefault$1(orElse(option, makeSingle(headNonEmpty(negationNames), tailNonEmpty(negationNames), boolean$2(some(!ifPresent)))), !ifPresent);
+	return withDefault$1(option, !ifPresent);
 };
 /** @internal */
 const choice$1 = (name, choices) => {
@@ -4711,7 +4711,7 @@ const getUsage$1 = (self) => getUsageInternal$1(self);
 /** @internal */
 const map$1 = /*#__PURE__*/ dual(2, (self, f) => makeMap(self, (a) => right(f(a))));
 /** @internal */
-const optional$4 = (self) => withDefault(map$1(self, some), none$3());
+const optional$4 = (self) => withDefault$1(map$1(self, some), none$3());
 /** @internal */
 const orElse = /*#__PURE__*/ dual(2, (self, that) => orElseEither(self, that).pipe(map$1(merge$2)));
 /** @internal */
@@ -4731,7 +4731,7 @@ const withAlias = /*#__PURE__*/ dual(2, (self, alias) => modifySingle(self, (sin
 	return makeSingle(single.name, aliases, single.primitiveType, single.description, single.pseudoName);
 }));
 /** @internal */
-const withDefault = /*#__PURE__*/ dual(2, (self, fallback) => makeWithDefault(self, fallback));
+const withDefault$1 = /*#__PURE__*/ dual(2, (self, fallback) => makeWithDefault(self, fallback));
 /** @internal */
 const withDescription$4 = /*#__PURE__*/ dual(2, (self, desc) => modifySingle(self, (single) => {
 	const description = sequence(single.description, p$1(desc));
@@ -5058,7 +5058,7 @@ const wizardInternal$1 = (self, config) => {
 				return parseCommandLine(self, args, config).pipe(as(args));
 			}), zipLeft(log()));
 		}
-		case "KeyValueMap": return list$9({
+		case "KeyValueMap": return list$10({
 			message: toAnsiText(p$1("Enter `key=value` pairs separated by spaces")).trim(),
 			delimiter: " "
 		}).pipe(flatMap$1((args) => {
@@ -5641,6 +5641,11 @@ const optional$3 = optional$4;
 * @since 1.0.0
 * @category combinators
 */
+const withDefault = withDefault$1;
+/**
+* @since 1.0.0
+* @category combinators
+*/
 const withDescription$3 = withDescription$4;
 //#endregion
 //#region ../../node_modules/.pnpm/@effect+cli@0.75.2_@effect+platform@0.96.1_effect@3.21.2__@effect+printer-ansi@0.49.0_@_4d5fe3e52e753e91ea7f4be1c61c2cec/node_modules/@effect/cli/dist/esm/internal/builtInOptions.js
@@ -7249,7 +7254,7 @@ const readDirectory = (path, options) => tryPromise({
 	try: () => NFS.promises.readdir(path, options),
 	catch: (err) => handleErrnoException("FileSystem", "readDirectory")(err, [path])
 });
-const readFile = (path) => async((resume, signal) => {
+const readFile$1 = (path) => async((resume, signal) => {
 	try {
 		NFS.readFile(path, { signal }, (err, data) => {
 			if (err) resume(fail$2(handleErrnoException("FileSystem", "readFile")(err, [path])));
@@ -7267,7 +7272,7 @@ const realPath = /*#__PURE__*/ (() => {
 	const nodeRealPath = /*#__PURE__*/ effectify(NFS.realpath, /*#__PURE__*/ handleErrnoException("FileSystem", "realPath"), /*#__PURE__*/ handleBadArgument("realPath"));
 	return (path) => nodeRealPath(path);
 })();
-const rename = /*#__PURE__*/ (() => {
+const rename$1 = /*#__PURE__*/ (() => {
 	const nodeRename = /*#__PURE__*/ effectify(NFS.rename, /*#__PURE__*/ handleErrnoException("FileSystem", "rename"), /*#__PURE__*/ handleBadArgument("rename"));
 	return (oldPath, newPath) => nodeRename(oldPath, newPath);
 })();
@@ -7370,11 +7375,11 @@ const layer$7 = /* @__PURE__ */ effect(FileSystem, /* @__PURE__ */ map$6(/*#__PU
 	makeTempFileScoped,
 	open: open$1,
 	readDirectory,
-	readFile,
+	readFile: readFile$1,
 	readLink,
 	realPath,
 	remove: remove$3,
-	rename,
+	rename: rename$1,
 	stat,
 	symlink,
 	truncate,
@@ -8340,7 +8345,7 @@ const put$1 = /*#__PURE__*/ make$10("PUT");
 /** @internal */
 const patch$1 = /*#__PURE__*/ make$10("PATCH");
 /** @internal */
-const del$8 = /*#__PURE__*/ make$10("DELETE");
+const del$9 = /*#__PURE__*/ make$10("DELETE");
 /** @internal */
 const head$1 = /*#__PURE__*/ make$10("HEAD");
 /** @internal */
@@ -8449,7 +8454,7 @@ const ClientProto = {
 		return this.execute(patch$1(url, options));
 	},
 	del(url, options) {
-		return this.execute(del$8(url, options));
+		return this.execute(del$9(url, options));
 	},
 	options(url, options) {
 		return this.execute(options$1(url, options));
@@ -8612,7 +8617,7 @@ var InterruptibleResponse = class {
 		return this.original[NodeInspectSymbol]();
 	}
 };
-const { del: del$7, execute, get: get$9, head, options, patch, post, put } = /*#__PURE__*/ serviceFunctions(tag);
+const { del: del$8, execute, get: get$9, head, options, patch, post, put } = /*#__PURE__*/ serviceFunctions(tag);
 /** @internal */
 const transformResponse = /*#__PURE__*/ dual(2, (self, f) => {
 	const client = self;
@@ -12570,7 +12575,7 @@ function customAlphabet(alphabet, size = 21) {
 	return customRandom(alphabet, size, random);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@haklex+rich-litexml@0.21.0/node_modules/@haklex/rich-litexml/dist/src-CWxDj4Bd.js
+//#region ../../node_modules/.pnpm/@haklex+rich-litexml@0.22.0/node_modules/@haklex/rich-litexml/dist/src-CWxDj4Bd.js
 var impl = null;
 function registerParseHTML(fn) {
 	impl = fn;
@@ -24908,7 +24913,7 @@ function Document() {
 }
 setPrototypeOf(Document, Document$1).prototype = Document$1.prototype;
 //#endregion
-//#region ../../node_modules/.pnpm/@haklex+rich-litexml@0.21.0/node_modules/@haklex/rich-litexml/dist/node.mjs
+//#region ../../node_modules/.pnpm/@haklex+rich-litexml@0.22.0/node_modules/@haklex/rich-litexml/dist/node.mjs
 registerParseHTML((html) => parseHTML(html).document);
 //#endregion
 //#region ../editor/src/core/litexml.ts
@@ -25048,7 +25053,7 @@ const TRANSFORMERS = mod$1.TRANSFORMERS;
 mod$1.UNORDERED_LIST;
 mod$1.registerMarkdownShortcuts;
 //#endregion
-//#region ../../node_modules/.pnpm/@haklex+rich-headless@0.20.0_lexical@0.45.0/node_modules/@haklex/rich-headless/dist/transformers.mjs
+//#region ../../node_modules/.pnpm/@haklex+rich-headless@0.22.0_lexical@0.45.0/node_modules/@haklex/rich-headless/dist/transformers.mjs
 /**
 * Headless Markdown transformers — export-only (Lexical → Markdown).
 * Import stubs are no-ops; used only for $convertToMarkdownString.
@@ -25475,7 +25480,7 @@ function $toMarkdown() {
 	return $convertToMarkdownString(allHeadlessTransformers);
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@haklex+rich-headless@0.20.0_lexical@0.45.0/node_modules/@haklex/rich-headless/dist/index.mjs
+//#region ../../node_modules/.pnpm/@haklex+rich-headless@0.22.0_lexical@0.45.0/node_modules/@haklex/rich-headless/dist/index.mjs
 var INTRINSIC_TYPES = [
 	"root",
 	"paragraph",
@@ -26468,7 +26473,7 @@ const codeblockRenderer = (node, ctx) => {
 };
 //#endregion
 //#region src/cli/render/lexical/embeds.ts
-const basename = (path) => {
+const basename$1 = (path) => {
 	const idx = path.lastIndexOf("/");
 	return idx >= 0 ? path.slice(idx + 1) : path;
 };
@@ -26476,7 +26481,7 @@ const imgRenderer = (node, ctx) => {
 	const { alt, src, caption } = node.attrs;
 	let label;
 	if (alt) label = `[image: ${alt}]`;
-	else if (src) label = `[image: ${basename(src)}]`;
+	else if (src) label = `[image: ${basename$1(src)}]`;
 	else label = "[image]";
 	const main = wrap(ANSI.dim, label, ctx.color);
 	if (caption) return `${main}\n${wrap(ANSI.dim, caption, ctx.color)}`;
@@ -30971,7 +30976,7 @@ const whoami = make$13("whoami", {}, () => gen(function* () {
 }));
 //#endregion
 //#region src/cli/auth/index.ts
-const help$10 = registerCommandHelp({
+const help$11 = registerCommandHelp({
 	name: "auth",
 	description: "authentication",
 	verbs: [
@@ -30994,7 +30999,7 @@ const help$10 = registerCommandHelp({
 		}
 	]
 });
-const authCmd = make$13("auth").pipe(withDescription(help$10.description), withSubcommands([
+const authCmd = make$13("auth").pipe(withDescription(help$11.description), withSubcommands([
 	login,
 	logout,
 	whoami,
@@ -31614,7 +31619,7 @@ var Resolver = class Resolver extends Tag$2("Resolver")() {
 		return make$3(yield* Api);
 	}));
 };
-const del$6 = make$13("delete", {
+const del$7 = make$13("delete", {
 	slugOrId: text$6({ name: "slugOrId" }),
 	force: boolean("force")
 }, ({ slugOrId, force }) => gen(function* () {
@@ -31633,7 +31638,7 @@ const get$8 = make$13("get", { slugOrId: text$6({ name: "slugOrId" }) }, ({ slug
 }));
 //#endregion
 //#region src/cli/category/list.ts
-const list$8 = make$13("list", {}, () => gen(function* () {
+const list$9 = make$13("list", {}, () => gen(function* () {
 	const api = yield* Api;
 	const renderer = yield* Renderer;
 	const res = yield* api.request("/categories");
@@ -31666,7 +31671,7 @@ const update$5 = make$13("update", {
 }));
 //#endregion
 //#region src/cli/category/index.ts
-const help$9 = registerCommandHelp({
+const help$10 = registerCommandHelp({
 	name: "category",
 	description: "manage categories / tags",
 	verbs: [
@@ -31706,12 +31711,12 @@ const help$9 = registerCommandHelp({
 		}
 	]
 });
-const categoryCmd = make$13("category").pipe(withDescription(help$9.description), withSubcommands([
-	list$8,
+const categoryCmd = make$13("category").pipe(withDescription(help$10.description), withSubcommands([
+	list$9,
 	get$8,
 	create$5,
 	update$5,
-	del$6
+	del$7
 ]));
 //#endregion
 //#region src/services/Comment.ts
@@ -31814,7 +31819,7 @@ var Comment = class Comment extends Tag$2("Comment")() {
 //#region src/cli/comment/_flags.ts
 const ids = text$6({ name: "id" }).pipe(repeated);
 const all$1 = boolean("all").pipe(withDescription$3("apply to every comment (optionally filtered by --state)"));
-const force$7 = boolean("force").pipe(withDescription$3("skip TTY confirmation guard"));
+const force$8 = boolean("force").pipe(withDescription$3("skip TTY confirmation guard"));
 const stateFilter = choice("state", [
 	"unread",
 	"read",
@@ -31845,7 +31850,7 @@ const requireForceForSingleDelete = (params) => suspend(() => {
 const approve = make$13("approve", {
 	ids,
 	all: all$1,
-	force: force$7,
+	force: force$8,
 	state: stateFilter
 }, ({ ids, all, force, state }) => gen(function* () {
 	yield* validateBatchSelection({
@@ -31869,10 +31874,10 @@ const approve = make$13("approve", {
 })).pipe(withDescription("mark comments as read; pass ids or --all [--state <s>]"));
 //#endregion
 //#region src/cli/comment/delete.ts
-const del$5 = make$13("delete", {
+const del$6 = make$13("delete", {
 	ids,
 	all: all$1,
-	force: force$7,
+	force: force$8,
 	state: stateFilter
 }, ({ ids, all, force, state }) => gen(function* () {
 	yield* validateBatchSelection({
@@ -32042,7 +32047,7 @@ const get$7 = make$13("get", { id: text$6({ name: "id" }) }, ({ id }) => gen(fun
 	const res = yield* comment.get(id);
 	yield* renderer.emit(commentView, res);
 })).pipe(withDescription("show a single comment by id"));
-const list$7 = make$13("list", {
+const list$8 = make$13("list", {
 	page: integer("page").pipe(optional$3),
 	size: integer("size").pipe(optional$3),
 	state: stateFilter,
@@ -32063,7 +32068,7 @@ const list$7 = make$13("list", {
 const reject = make$13("reject", {
 	ids,
 	all: all$1,
-	force: force$7,
+	force: force$8,
 	state: stateFilter
 }, ({ ids, all, force, state }) => gen(function* () {
 	yield* validateBatchSelection({
@@ -32181,7 +32186,7 @@ const unread = make$13("unread", {
 })).pipe(withDescription("list unread comments (alias for `comment list --state unread`)"));
 //#endregion
 //#region src/cli/comment/index.ts
-const help$8 = registerCommandHelp({
+const help$9 = registerCommandHelp({
 	name: "comment",
 	description: "list and moderate comments",
 	verbs: [
@@ -32248,14 +32253,14 @@ const help$8 = registerCommandHelp({
 		}
 	]
 });
-const commentCmd = make$13("comment").pipe(withDescription(help$8.description), withSubcommands([
-	list$7,
+const commentCmd = make$13("comment").pipe(withDescription(help$9.description), withSubcommands([
+	list$8,
 	unread,
 	get$7,
 	reply,
 	approve,
 	reject,
-	del$5
+	del$6
 ]));
 //#endregion
 //#region src/cli/config/edit.ts
@@ -32292,7 +32297,7 @@ const get$6 = make$13("get", { key: text$6({ name: "key" }) }, ({ key }) => gen(
 }));
 //#endregion
 //#region src/cli/config/list.ts
-const list$6 = make$13("list", {}, () => gen(function* () {
+const list$7 = make$13("list", {}, () => gen(function* () {
 	const api = yield* Api;
 	const renderer = yield* Renderer;
 	const res = yield* api.request("/options");
@@ -32339,7 +32344,7 @@ const set = make$13("set", {
 }));
 //#endregion
 //#region src/cli/config/index.ts
-const help$7 = registerCommandHelp({
+const help$8 = registerCommandHelp({
 	name: "config",
 	description: "manage server options",
 	verbs: [
@@ -32367,13 +32372,130 @@ const help$7 = registerCommandHelp({
 		}
 	]
 });
-const configCmd = make$13("config").pipe(withDescription(help$7.description), withSubcommands([
-	list$6,
+const configCmd = make$13("config").pipe(withDescription(help$8.description), withSubcommands([
+	list$7,
 	get$6,
 	set,
 	edit$4
 ]));
 //#endregion
+//#region src/cli/file/_shared.ts
+/** Mirrors the server's `FileTypeEnum` (apps/core modules/file/file.type.ts). */
+const FILE_TYPES = [
+	"file",
+	"image",
+	"icon",
+	"avatar"
+];
+const typeOption = choice("type", FILE_TYPES).pipe(withDescription$3("server-side storage bucket for the file"), withDefault("file"));
+const silentFlag$5 = boolean("silent").pipe(withDescription$3("On success, emit a minimal `ok` instead of the full server response."));
+const del$5 = make$13("delete", {
+	name: text$6({ name: "name" }),
+	type: typeOption,
+	force: boolean("force").pipe(withDescription$3("skip confirmation"))
+}, ({ name, type, force }) => gen(function* () {
+	if (!force && !process.stdin.isTTY) return yield* fail$2(new ValidationFailed({ message: "refusing to delete without --force in non-TTY context" }));
+	const api = yield* Api;
+	const renderer = yield* Renderer;
+	yield* api.request(`/objects/${type}/${encodeURIComponent(name)}`, { method: "DELETE" });
+	yield* renderer.emitSuccess({ deleted: `${type}/${name}` });
+})).pipe(withDescription("delete an uploaded file"));
+//#endregion
+//#region src/cli/file/list.ts
+const list$6 = make$13("list", { type: typeOption }, ({ type }) => gen(function* () {
+	const api = yield* Api;
+	const renderer = yield* Renderer;
+	const res = yield* api.request(`/objects/${type}`);
+	yield* renderer.emitSuccess(res);
+})).pipe(withDescription("list uploaded files of a type (name, url, created)"));
+const rename = make$13("rename", {
+	name: text$6({ name: "name" }),
+	newName: text$6({ name: "newName" }),
+	type: typeOption
+}, ({ name, newName, type }) => gen(function* () {
+	const api = yield* Api;
+	const renderer = yield* Renderer;
+	yield* api.request(`/objects/${type}/${encodeURIComponent(name)}/rename`, {
+		method: "PATCH",
+		query: { newName }
+	});
+	yield* renderer.emitSuccess({
+		renamed: `${type}/${name}`,
+		to: newName
+	});
+})).pipe(withDescription("rename an uploaded file"));
+const upload = make$13("upload", {
+	path: text$6({ name: "path" }),
+	type: typeOption,
+	name: text$4("name").pipe(withDescription$3("override the uploaded filename (defaults to the local basename)"), optional$3),
+	silent: silentFlag$5
+}, ({ path, type, name, silent }) => gen(function* () {
+	const buffer = yield* tryPromise({
+		try: () => readFile(path),
+		catch: (err) => new Generic({
+			message: `cannot read file: ${path}`,
+			cause: err
+		})
+	});
+	const filename = name._tag === "Some" ? name.value : basename(path);
+	const form = new FormData();
+	form.append("file", new File([new Uint8Array(buffer)], filename));
+	const api = yield* Api;
+	const renderer = yield* Renderer;
+	const res = yield* api.request(`/objects/upload`, {
+		method: "POST",
+		query: { type },
+		body: form
+	});
+	yield* renderer.emitSuccess(silent ? { ok: true } : res);
+})).pipe(withDescription(`upload a local file (--type ${FILE_TYPES.join("|")}); returns { url, name }`));
+//#endregion
+//#region src/cli/file/index.ts
+const help$7 = registerCommandHelp({
+	name: "file",
+	description: "upload and manage static files (images, icons, avatars)",
+	verbs: [
+		{
+			name: "upload",
+			args: [
+				"<path>",
+				"[--type file|image|icon|avatar]",
+				"[--name <n>]"
+			],
+			description: "upload a local file; returns { url, name }"
+		},
+		{
+			name: "list",
+			args: ["[--type <t>]"],
+			description: "list uploaded files of a type"
+		},
+		{
+			name: "delete",
+			args: [
+				"<name>",
+				"[--type <t>]",
+				"[--force]"
+			],
+			description: "delete an uploaded file"
+		},
+		{
+			name: "rename",
+			args: [
+				"<name>",
+				"<newName>",
+				"[--type <t>]"
+			],
+			description: "rename an uploaded file"
+		}
+	]
+});
+const fileCmd = make$13("file").pipe(withDescription(help$7.description), withSubcommands([
+	upload,
+	list$6,
+	del$5,
+	rename
+]));
+//#endregion
 //#region src/domain/admin-link.ts
 const buildEditUrl = (adminUrl, kind, id) => {
 	const base = adminUrl.replace(/\/+$/, "");
@@ -33080,7 +33202,7 @@ const del$4 = make$13("delete", {
 })).pipe(withDescription("delete a note"));
 //#endregion
 //#region src/cli/note/edit.ts
-const slugOrId$17 = text$6({ name: "slugOrId" });
+const slugOrId$19 = text$6({ name: "slugOrId" });
 const esc = (s) => s.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 const materializeForEditor$2 = (slugOrId) => gen(function* () {
 	const api = yield* Api;
@@ -33123,7 +33245,7 @@ const applyNoteEnvelopeMeta = (payload, rawMeta) => {
 	return next;
 };
 const edit$3 = make$13("edit", {
-	slugOrId: slugOrId$17,
+	slugOrId: slugOrId$19,
 	...noteWriteOptions
 }, ({ slugOrId, ...rest }) => gen(function* () {
 	const flags = toNoteFlagInputs(rest);
@@ -33373,6 +33495,7 @@ const update$4 = make$13("update", {
 		delete payload.text;
 		delete payload.contentFormat;
 	}
+	if (flags.state === void 0) delete payload.isPublished;
 	const resolved = yield* resolveTopicRefs(payload);
 	const id = yield* (yield* Resolver).resolveNoteId(slugOrId);
 	const api = yield* Api;
@@ -33498,7 +33621,7 @@ const create$3 = make$13("create", pageWriteOptions, (opts) => gen(function* ()
 }));
 //#endregion
 //#region src/cli/page/delete.ts
-const slugOrId$12 = text$6({ name: "slugOrId" });
+const slugOrId$14 = text$6({ name: "slugOrId" });
 const force$5 = boolean("force");
 const resolvePageId$2 = (api, ref) => gen(function* () {
 	if (isSnowflakeId(ref)) return ref;
@@ -33512,7 +33635,7 @@ const resolvePageId$2 = (api, ref) => gen(function* () {
 	return id;
 });
 const del$3 = make$13("delete", {
-	slugOrId: slugOrId$12,
+	slugOrId: slugOrId$14,
 	force: force$5
 }, ({ slugOrId, force }) => gen(function* () {
 	if (!force && !process.stdin.isTTY) return yield* fail$2(new ValidationFailed({ message: "refusing to delete without --force in non-TTY context" }));
@@ -33524,7 +33647,7 @@ const del$3 = make$13("delete", {
 }));
 //#endregion
 //#region src/cli/page/edit.ts
-const slugOrId$11 = text$6({ name: "slugOrId" });
+const slugOrId$13 = text$6({ name: "slugOrId" });
 const escapeXml$1 = (s) => s.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 const resolvePageId$1 = (api, ref) => gen(function* () {
 	if (isSnowflakeId(ref)) return ref;
@@ -33569,7 +33692,7 @@ const overlayPageMeta = (payload, rawMeta) => {
 	return next;
 };
 const edit$2 = make$13("edit", {
-	slugOrId: slugOrId$11,
+	slugOrId: slugOrId$13,
 	...pageWriteOptions
 }, ({ slugOrId, ...rest }) => gen(function* () {
 	const flags = toPageFlagInputs(rest);
@@ -33700,7 +33823,7 @@ const list$4 = make$13("list", {}, () => gen(function* () {
 }));
 //#endregion
 //#region src/cli/page/update.ts
-const slugOrId$9 = text$6({ name: "slugOrId" });
+const slugOrId$11 = text$6({ name: "slugOrId" });
 const resolvePageId = (api, ref) => gen(function* () {
 	if (isSnowflakeId(ref)) return ref;
 	const res = yield* api.request(`/pages/slug/${encodeURIComponent(ref)}`).pipe(catchAll(() => succeed$1(null)));
@@ -33713,7 +33836,7 @@ const resolvePageId = (api, ref) => gen(function* () {
 	return id;
 });
 const update$3 = make$13("update", {
-	slugOrId: slugOrId$9,
+	slugOrId: slugOrId$11,
 	...pageWriteOptions
 }, ({ slugOrId, ...rest }) => gen(function* () {
 	const flags = toPageFlagInputs(rest);
@@ -33791,6 +33914,41 @@ const pageCmd = make$13("page").pipe(withDescription(help$5.description), withSu
 	del$3
 ]));
 //#endregion
+//#region src/cli/post/apply.ts
+const slugOrId$10 = text$6({ name: "slugOrId" });
+const parseTypeSpecificData = (raw) => {
+	if (!raw) return {};
+	if (typeof raw === "object") return raw;
+	try {
+		const parsed = JSON.parse(raw);
+		return typeof parsed === "object" && parsed !== null ? parsed : {};
+	} catch {
+		return {};
+	}
+};
+const apply = make$13("apply", { slugOrId: slugOrId$10 }, ({ slugOrId }) => gen(function* () {
+	const resolver = yield* Resolver;
+	const api = yield* Api;
+	const renderer = yield* Renderer;
+	const id = yield* resolver.resolvePostId(slugOrId);
+	const draft = yield* api.request(`/drafts/by-ref/post/${id}`);
+	if (!draft || !draft.id) return yield* fail$2(new Generic({
+		message: `no staged changes for post ${slugOrId}`,
+		hint: "stage changes first with `mxs post stage <slugOrId> --file <article.xml>`"
+	}));
+	const body = { ...parseTypeSpecificData(draft.typeSpecificData) };
+	if (draft.title !== void 0) body.title = draft.title;
+	if (draft.text !== void 0) body.text = draft.text;
+	if (draft.content !== void 0 && draft.content !== null) body.content = draft.content;
+	if (draft.contentFormat !== void 0) body.contentFormat = draft.contentFormat;
+	body.draftId = draft.id;
+	const res = yield* api.request(`/posts/${id}`, {
+		method: "PATCH",
+		body
+	});
+	yield* renderer.emitSuccess(res);
+})).pipe(withDescription("apply the staged draft of a post to the live post (the confirm step after `post stage`)"));
+//#endregion
 //#region src/cli/post/create.ts
 const create$2 = make$13("create", postWriteOptions, (opts) => gen(function* () {
 	const payload = yield* resolveCategoryRefs((yield* buildPostPayload(toPostFlagInputs(opts))).payload);
@@ -33820,7 +33978,7 @@ const del$2 = make$13("delete", {
 })).pipe(withDescription("delete a post"));
 //#endregion
 //#region src/cli/post/edit.ts
-const slugOrId$7 = text$6({ name: "slugOrId" });
+const slugOrId$8 = text$6({ name: "slugOrId" });
 const escapeXml = (s) => s.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
 const materializeForEditor = (slugOrId) => gen(function* () {
 	const api = yield* Api;
@@ -33860,7 +34018,7 @@ const metaFromEnvelope = (meta) => {
 	return overlay;
 };
 const edit$1 = make$13("edit", {
-	slugOrId: slugOrId$7,
+	slugOrId: slugOrId$8,
 	...postWriteOptions
 }, ({ slugOrId, ...rest }) => gen(function* () {
 	const flags = toPostFlagInputs(rest);
@@ -34072,6 +34230,42 @@ const publish = make$13("publish", { slugOrId: text$6({ name: "slugOrId" }) }, (
 	});
 	yield* renderer.emitSuccess(res);
 })).pipe(withDescription("publish a post"));
+//#endregion
+//#region src/cli/post/stage.ts
+const slugOrId$5 = text$6({ name: "slugOrId" });
+/** Draft-native fields; everything else rides along in `typeSpecificData`. */
+const DRAFT_CORE_KEYS = new Set([
+	"title",
+	"text",
+	"content",
+	"contentFormat",
+	"meta"
+]);
+const stage = make$13("stage", {
+	slugOrId: slugOrId$5,
+	...postWriteOptions
+}, ({ slugOrId, ...rest }) => gen(function* () {
+	const payload = yield* resolveCategoryRefs({ ...(yield* buildPostPayload(toPostFlagInputs(rest))).payload });
+	delete payload.isPublished;
+	if (Object.keys(payload).filter((k) => k !== "contentFormat").length === 0) return yield* fail$2(new ValidationFailed({ message: "nothing to stage: provide --file or content/meta flags" }));
+	const draftBody = {};
+	const typeSpecificData = {};
+	for (const [key, value] of Object.entries(payload)) if (DRAFT_CORE_KEYS.has(key)) draftBody[key] = value;
+	else typeSpecificData[key] = value;
+	if (Object.keys(typeSpecificData).length > 0) draftBody.typeSpecificData = typeSpecificData;
+	const id = yield* (yield* Resolver).resolvePostId(slugOrId);
+	const api = yield* Api;
+	const renderer = yield* Renderer;
+	const res = yield* api.request(`/drafts`, {
+		method: "POST",
+		body: {
+			refType: "post",
+			refId: id,
+			...draftBody
+		}
+	});
+	yield* renderer.emitSuccess(rest.silent ? { ok: true } : res);
+})).pipe(withDescription("stage changes as a draft attached to a published post (the live post is untouched until `post apply`)"));
 const unpublish = make$13("unpublish", { slugOrId: text$6({ name: "slugOrId" }) }, ({ slugOrId }) => gen(function* () {
 	const resolver = yield* Resolver;
 	const api = yield* Api;
@@ -34094,6 +34288,7 @@ const update$2 = make$13("update", {
 		delete payload.text;
 		delete payload.contentFormat;
 	}
+	if (flags.state === void 0) delete payload.isPublished;
 	const resolved = yield* resolveCategoryRefs(payload);
 	const id = yield* (yield* Resolver).resolvePostId(slugOrId);
 	const api = yield* Api;
@@ -34167,6 +34362,20 @@ const help$4 = registerCommandHelp({
 			name: "unpublish",
 			args: ["<slugOrId>"],
 			description: "unpublish a post"
+		},
+		{
+			name: "stage",
+			args: [
+				"<slugOrId>",
+				"[--file <path>]",
+				"..."
+			],
+			description: "stage changes as a draft; the live post stays untouched"
+		},
+		{
+			name: "apply",
+			args: ["<slugOrId>"],
+			description: "apply the staged draft to the live post"
 		}
 	]
 });
@@ -34178,7 +34387,9 @@ const postCmd = make$13("post").pipe(withDescription(help$4.description), withSu
 	update$2,
 	del$2,
 	publish,
-	unpublish
+	unpublish,
+	stage,
+	apply
 ]));
 //#endregion
 //#region src/cli/preview/index.ts
@@ -39819,6 +40030,7 @@ const rootCmd = make$13("mxs", {}, () => flatMap$1(Renderer, (r) => r.emitInfo("
 	topicCmd,
 	commentCmd,
 	configCmd,
+	fileCmd,
 	skillCmd,
 	previewCmd,
 	updateCmd

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/cli",
-  "version": "0.10.0",
+  "version": "0.11.0",
   "description": "Command line interface for mx-space (mx-core) — auth, content, configuration",
   "keywords": [
     "mx-space",
@@ -52,9 +52,9 @@
     "@effect/cli": "0.75.2",
     "@effect/platform": "0.96.1",
     "@effect/platform-node": "0.107.0",
-    "@haklex/rich-headless": "0.20.0",
-    "@haklex/rich-litexml": "0.21.0",
-    "@haklex/rich-litexml-cli": "0.20.0",
+    "@haklex/rich-headless": "0.22.0",
+    "@haklex/rich-litexml": "0.22.0",
+    "@haklex/rich-litexml-cli": "0.22.0",
     "@lexical/headless": "^0.45.0",
     "better-auth": "^1.6.14",
     "effect": "3.21.2",