@mx-space/cli 0.4.0 → 0.5.0

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.
@@ -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
 
@@ -314,6 +324,41 @@ Page edit and page file payloads currently reuse the `<mxpost>` envelope shape.
 | `--description <text>` | `description` |
 | `--icon <text>`        | `icon`        |
 
+## Comments
+
+Moderation commands for the comment queue. `state` is one of `unread`, `read`, or `junk` (server-side codes `0`, `1`, `2`).
+
+| Command                                | Description                                                       |
+| -------------------------------------- | ----------------------------------------------------------------- |
+| `mxs comment list`                     | List comments (default `--state unread`).                         |
+| `mxs comment unread`                   | Shortcut for `comment list --state unread` (accepts `--page` / `--size`). |
+| `mxs comment get <id>`                 | Show a single comment by id.                                      |
+| `mxs comment approve <id...>`          | Mark one or more comments as read (state→1).                      |
+| `mxs comment reject <id...>`           | Mark one or more comments as junk (state→2).                      |
+| `mxs comment delete <id...>`           | Soft-delete one or more comments.                                 |
+
+### Comment List Flags
+
+| Flag                          | Description                                                                |
+| ----------------------------- | -------------------------------------------------------------------------- |
+| `--page <n>` / `--size <n>`   | Standard paging knobs.                                                     |
+| `--state <unread|read|junk>`  | Filter by state. Defaults to `unread`.                                     |
+| `--all`                       | Aggregate every state into one response (issues three parallel requests).  |
+
+### Comment Moderation Flags
+
+| Flag                          | Applies to              | Description                                                                |
+| ----------------------------- | ----------------------- | -------------------------------------------------------------------------- |
+| `--all`                       | approve, reject, delete | Apply to every comment instead of the explicit `<id...>` list.             |
+| `--state <unread|read|junk>`  | approve, reject, delete | When used with `--all`, restricts the affected set by current state.       |
+| `--force`                     | delete, any `--all`     | Required in non-TTY contexts to confirm destructive operations.            |
+
+Guard summary:
+
+- `delete` of a single id refuses to run in a non-TTY context without `--force`.
+- Any `--all` invocation (`approve`, `reject`, `delete`) refuses to run in a non-TTY context without `--force`.
+- `approve` and `reject` of explicit ids run without confirmation.
+
 ## Configuration
 
 | Command                        | Description                                                    |

package/ROADMAP.md

@@ -8,7 +8,17 @@
 
 - Internal rewrite onto Effect-TS (`@effect/cli` + `@effect/platform`). User-facing CLI surface is unchanged — see [`README.md`](./README.md#v030-behavior-changes) for the small list of behavioral adjustments and [`docs/architecture.md`](./docs/architecture.md) for the new internal architecture.
 
-## v2
+## Next — Comment moderation
+
+- `mxs comment list [--page N] [--size N] [--state unread|read|junk] [--all]`
+- `mxs comment get <id>`
+- `mxs comment approve <id...> | --all [--state <s>]`
+- `mxs comment reject <id...> | --all [--state <s>]`
+- `mxs comment delete <id...> | --all [--state <s>] [--force]`
+
+State map: `unread=0`, `read=1`, `junk=2`. Routes single-id verbs through the server's batch endpoints (`PATCH /comments/batch/state`, `DELETE /comments/batch`) for one unified path.
+
+## v2 — AI
 
 > **Note (v0.3):** Service interface placeholders for AI, Backup, and Cache are reserved in `src/services/{Ai,Backup,Cache}.ts` and threaded through the layer composition. Implementation is pending.
 
@@ -17,12 +27,6 @@
   - `mxs ai translate <id> --to <locale>`
   - `mxs ai insights refresh`
   - `mxs ai tokens`
-- Comment moderation
-  - `mxs comment list`
-  - `mxs comment approve <id>`
-  - `mxs comment reject <id>`
-  - `mxs comment delete <id>`
-- Markdown → Lexical bridge (contingent on a haklex reader)
 
 ## v3
 

package/dist/bin/mxs.mjs

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import { t as run } from "../mxs-BbNjmEgB.mjs";
+import { t as run } from "../mxs-Dsh_ZkeN.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-BbNjmEgB.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-Dsh_ZkeN.mjs";
 export { codeForTag, defaultGlobalFlags, defaultMessageFor, exitCodeForError, exitCodeForTag, parseGlobalFlags, run, tagToCode, toErrorEnvelope };