@mx-space/cli 0.3.1 → 0.4.1

package/README.md

@@ -19,9 +19,11 @@ Node.js 22 or newer is required.
 
 ```bash
 mxs auth login
-mxs post create --file ./post.xml
-mxs post update my-slug --title "New title" --state publish
-mxs post get my-slug --output llm
+mxs post create --file ./post.xml --open --silent     # open admin preview, terse output
+mxs post get my-slug --output xml > /tmp/post.xml     # round-trip envelope
+# edit /tmp/post.xml ...
+mxs post update my-slug --file /tmp/post.xml --open
+mxs post publish my-slug
 ```
 
 When the CLI cannot resolve an API URL, it starts an interactive onboarding prompt in TTY contexts. Use `MXS_API_URL` or `--api-url` for non-interactive environments.
@@ -31,7 +33,7 @@ When the CLI cannot resolve an API URL, it starts an interactive onboarding prom
 | Flag               | Effect                                                                        |
 | ------------------ | ----------------------------------------------------------------------------- |
 | `--json`           | Emit `{ ok: true, data }` on stdout. Takes precedence over `--output`.        |
-| `--output <mode>`  | Output mode. Supported: `pretty-json`, `json`, `readable`, `llm`, `envelope`. |
+| `--output <mode>`  | Output mode. Supported: `pretty-json`, `json`, `readable`, `llm`, `xml`. |
 | `--api-url <url>`  | Override the configured mx-core API origin.                                   |
 | `--token <token>`  | Override the stored access token.                                             |
 | `--api-key <key>`  | Authenticate with an API key through the `x-api-key` header.                  |
@@ -41,7 +43,7 @@ When the CLI cannot resolve an API URL, it starts an interactive onboarding prom
 | `--dry-run`        | Resolve payloads without mutating the server where supported.                 |
 | `--profile <name>` | Profile to use (overrides `MXS_PROFILE` and the active pointer).              |
 
-`readable`, `llm`, and `envelope` are document output modes for `post get`, `note get`, and `page get`. `post list` additionally supports `readable` and `llm` for concise list summaries. Other commands keep their existing JSON-oriented output.
+`readable`, `llm`, and `xml` are document output modes for `post get`, `note get`, and `page get`. `post list` additionally supports `readable` and `llm` for concise list summaries. Other commands keep their existing JSON-oriented output.
 
 ## Output Modes
 
@@ -51,9 +53,9 @@ When the CLI cannot resolve an API URL, it starts an interactive onboarding prom
 | `json`        | `{ ok: true, data }` JSON envelope.              | Scripts and structured automation.            |
 | `readable`    | Compact key-value metadata plus readable body.   | Human terminal reading.                       |
 | `llm`         | Same stable readable structure as `readable`.    | AI-agent context with lower structural noise. |
-| `envelope`    | `<mxpost>` or `<mxnote>` LiteXML envelope.       | Editable document round trips.                |
+| `xml`         | `<mxpost>` or `<mxnote>` LiteXML envelope.       | Editable document round trips.                |
 
-For Lexical documents, `readable`, `llm`, and `envelope` render the body as LiteXML through `@haklex/rich-litexml` instead of exposing Lexical JSON.
+For Lexical documents, `readable`, `llm`, and `xml` render the body as LiteXML through `@haklex/rich-litexml` instead of exposing Lexical JSON.
 
 Example:
 
@@ -206,6 +208,14 @@ Existing installations that use the legacy flat files (`~/.config/mxs/config.jso
 | `--related <csv>`         | Comma-separated related document ids.                                  |
 | `--meta <spec>`           | JSON literal or `file=<path>`.                                         |
 | `--file <path>`           | LiteXML envelope.                                                      |
+| `--open`                  | After success, open the admin edit page in the default browser.        |
+| `--silent`                | On success, emit `ok` instead of the full server response.             |
+
+`--open` and `--silent` are also available on `post update`, `post edit`,
+`note create`/`update`, and `page create`/`update`. The admin URL is
+resolved from the server's `/options/url.admin_url` config; the opened
+URL follows the admin-vue3 hash-router convention
+(`${admin_url}#/<kind>/edit?id=<id>`).
 
 ## Notes
 

package/dist/bin/mxs.mjs

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

package/dist/index.d.mts

@@ -1471,8 +1471,8 @@ interface ErrorEnvelope {
 }
 declare const toErrorEnvelope: (err: CliError) => ErrorEnvelope;
 //#endregion
-//#region src/services/Renderer.d.ts
-type OutputMode = 'pretty-json' | 'json' | 'readable' | 'llm' | 'envelope';
+//#region src/services/Renderer/options.d.ts
+type OutputMode = 'pretty-json' | 'json' | 'readable' | 'llm' | 'xml';
 interface OutputOptions {
   readonly json: boolean;
   readonly output: OutputMode;

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-D-YXaS2T.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-D9X72Mkv.mjs";
 export { codeForTag, defaultGlobalFlags, defaultMessageFor, exitCodeForError, exitCodeForTag, parseGlobalFlags, run, tagToCode, toErrorEnvelope };