@mx-space/cli 0.4.1 → 0.5.0

package/README.md

@@ -324,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-D9X72Mkv.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-D9X72Mkv.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 };