@mx-space/cli 0.13.2 → 0.14.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mx-space/cli",
-  "version": "0.13.2",
+  "version": "0.14.0",
   "description": "Command line interface for mx-space (mx-core) — auth, content, configuration",
   "keywords": [
     "mx-space",
@@ -47,16 +47,20 @@
   "publishConfig": {
     "access": "public"
   },
-  "dependencies": {
+  "devDependencies": {
     "@clack/prompts": "^1.6.0",
     "@effect/cli": "0.75.2",
     "@effect/platform": "0.96.2",
     "@effect/platform-node": "0.107.0",
-    "@haklex/rich-headless": "0.29.1",
-    "@haklex/rich-litexml": "0.29.0",
-    "@haklex/rich-litexml-cli": "0.29.0",
+    "@effect/vitest": "0.29.0",
+    "@haklex/rich-compose": "0.30.1",
+    "@haklex/rich-headless": "0.30.0",
+    "@haklex/rich-litexml": "0.30.0",
+    "@haklex/rich-litexml-cli": "0.30.1",
     "@lexical/headless": "^0.46.0",
-    "better-auth": "^1.6.20",
+    "@types/node": "26.0.1",
+    "@types/semver": "7.7.1",
+    "better-auth": "^1.6.23",
     "effect": "3.21.4",
     "fast-xml-parser": "5.9.3",
     "get-east-asian-width": "^1.6.0",
@@ -64,17 +68,12 @@
     "minisearch": "^7.2.0",
     "open": "^11.0.0",
     "semver": "7.8.5",
-    "@mx-space/api-client": "5.4.0",
-    "@mx-space/editor": "0.2.0"
-  },
-  "devDependencies": {
-    "@effect/vitest": "0.29.0",
-    "@types/node": "26.0.0",
-    "@types/semver": "7.7.1",
     "tsdown": "0.22.3",
     "tsx": "^4.22.4",
     "typescript": "6.0.3",
-    "vitest": "4.1.9"
+    "vitest": "4.1.9",
+    "@mx-space/editor": "0.2.0",
+    "@mx-space/api-client": "5.4.0"
   },
   "scripts": {
     "package": "rm -rf dist && tsdown",

package/skills/commands-draft.md

@@ -0,0 +1,45 @@
+---
+slug: commands-draft
+title: Draft commands
+description: draft list/get/create/update/publish/delete syntax — standalone server-side drafts
+order: 43
+---
+
+# Draft commands
+
+Drafts are standalone server-side entities, separate from a post's publish
+state. A new draft is not visible anywhere on the site until `draft publish`
+turns it into a real post/note/page. Drafts keep version history on every
+content change.
+
+| Command                  | Purpose                                                     | Flags                                                                      |
+| ------------------------ | ----------------------------------------------------------- | -------------------------------------------------------------------------- |
+| `mxs draft list`         | List drafts.                                                | `--type post\|note\|page`, `--new` (unlinked only), `--linked`, `--page`, `--size` |
+| `mxs draft get <id>`     | Read a draft by Snowflake id.                               | global flags                                                                |
+| `mxs draft create`       | Create a standalone post draft.                             | same authoring flags as `post create` (`--file`, `--title`, `--content`, `--format`, `--meta`, ...); `--silent` emits `{ok, id}` |
+| `mxs draft update <id>`  | Update a draft; bumps version, records history.             | same authoring flags; `--silent`                                            |
+| `mxs draft publish <id>` | Publish: creates the live post/note/page (or applies to the linked one). | `--silent`, `--open`                                            |
+| `mxs draft delete <id>`  | Delete a draft.                                             | `--force`; prefer `--dry-run` first                                          |
+
+## Recommended authoring flow for a new post
+
+```bash
+mxs draft create --file article.xml --silent   # → { ok: true, id: <draftId> }
+mxs draft update <draftId> --file article.xml  # iterate after review feedback
+mxs draft publish <draftId>                    # go live in one step
+```
+
+Notes:
+
+- `draft create` always targets `refType: post`. Note/page drafts are
+  authored in the admin dashboard; `draft publish` handles all three types.
+- `--state` is ignored for drafts: a draft has no publish state.
+  `draft publish` always makes the result live.
+- For staging changes to an **already published** post, prefer
+  `mxs post stage <slugOrId>` + `mxs post apply <slugOrId>` — same server
+  entity, resolved by post slug instead of draft id.
+- `publish` sends `draftId` to the server, which links the draft to the
+  created resource and marks the draft version as published; the draft and
+  its history are retained.
+
+Dry-run support: `create`, `update`, `publish`, `delete`.

package/skills/commands-preview.md

@@ -7,7 +7,7 @@ order: 41
 
 # Preview command
 
-`mxs preview` renders a LiteXML fragment or `<mxpost>` / `<mxnote>` envelope to HTML and (by default) opens it in the system browser. It is a thin wrapper around the `@haklex/rich-litexml-cli` `litexml --format html` pipeline, so the output matches what the editor would render once published.
+`mxs preview` renders a LiteXML fragment or `<mxpost>` / `<mxnote>` envelope to HTML and (by default) opens it in the system browser. It uses the LiteXML preview renderer vendored into the published CLI bundle, so the output matches what the editor would render once published without requiring runtime package dependencies.
 
 | Command                                  | Behavior                                                                    |
 | ---------------------------------------- | --------------------------------------------------------------------------- |
@@ -56,7 +56,7 @@ mxs preview ./post.xml --print > preview.html
 
 | Symptom                                                  | Likely cause                                                                                   |
 | -------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
-| `cannot resolve @haklex/rich-litexml-cli binary`         | Installed dep is broken; reinstall `@mx-space/cli` or run `pnpm install`.                      |
-| `Cannot resolve @haklex/rich-compose asset "style.css"`  | Outdated `@haklex/rich-compose` (< 0.15.2). Upgrade or reinstall.                              |
+| `cannot resolve LiteXML preview renderer`               | Published package is incomplete; reinstall `@mx-space/cli` or rebuild the CLI package.          |
+| `Cannot resolve @haklex/rich-compose asset "style.css"`  | Vendored preview assets are missing; reinstall `@mx-space/cli` or rebuild the CLI package.      |
 | `expected root <mxpost>` / `expected root <mxnote>`      | Input begins with the wrong envelope root, or the envelope is malformed. Check the root tag.   |
 | Browser does not open                                    | `--open` shells out to the system `open`/`xdg-open`/`start`. Use `--save` or `--print` instead. |

package/dist/esm-BumPuCXw.mjs

@@ -1,2 +0,0 @@
-import { E as Schema_exports } from "./esm-DupC6TTP.mjs";
-export { Schema_exports as Schema };