@mx-space/cli 0.14.2 → 0.15.1

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@mx-space/cli",
-  "version": "0.14.2",
-  "description": "Command line interface for mx-space (mx-core) — auth, content, configuration",
+  "version": "0.15.1",
+  "description": "Command line interface for mx-space (mx-core) \u2014 auth, content, configuration",
   "keywords": [
     "mx-space",
     "mx-core",
@@ -35,7 +35,7 @@
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "bin": {
-    "mxs": "./bin/mxs.cjs"
+    "mxs": "bin/mxs.cjs"
   },
   "exports": {
     ".": {
@@ -59,32 +59,34 @@
     "test:watch": "vitest",
     "typecheck": "tsc -p tsconfig.json --noEmit"
   },
+  "dependencies": {
+    "@haklex/rich-litexml": "^0.36.1"
+  },
   "devDependencies": {
     "@clack/prompts": "^1.7.0",
-    "@effect/cli": "0.76.0",
-    "@effect/platform": "0.97.0",
-    "@effect/platform-node": "0.108.0",
+    "@effect/cli": "0.77.0",
+    "@effect/platform": "0.97.1",
+    "@effect/platform-node": "0.108.1",
     "@effect/vitest": "0.30.0",
-    "@haklex/rich-compose": "0.31.1",
-    "@haklex/rich-headless": "0.31.1",
-    "@haklex/rich-litexml": "0.31.1",
-    "@haklex/rich-litexml-cli": "0.31.1",
-    "@lexical/headless": "^0.48.0",
+    "@haklex/rich-compose": "0.36.0",
+    "@haklex/rich-headless": "0.36.0",
+    "@haklex/rich-litexml-cli": "0.36.0",
+    "@lexical/headless": "^0.49.0",
     "@mx-space/api-client": "workspace:*",
     "@mx-space/editor": "workspace:*",
-    "@types/node": "26.1.1",
-    "@types/semver": "7.7.1",
-    "better-auth": "^1.6.23",
-    "effect": "3.22.0",
-    "fast-xml-parser": "5.10.0",
+    "@types/node": "26.2.0",
+    "@types/semver": "7.8.0",
+    "better-auth": "^1.6.27",
+    "effect": "3.22.1",
+    "fast-xml-parser": "5.11.0",
     "get-east-asian-width": "^1.6.0",
-    "lexical": "^0.48.0",
+    "lexical": "^0.49.0",
     "minisearch": "^7.2.0",
-    "open": "^11.0.0",
+    "open": "^11.0.1",
     "semver": "7.8.5",
-    "tsdown": "0.22.8",
-    "tsx": "^4.23.1",
+    "tsdown": "0.22.14",
+    "tsx": "^4.23.12",
     "typescript": "6.0.3",
-    "vitest": "4.1.10"
+    "vitest": "4.1.11"
   }
 }

package/skills/commands-ai.md

@@ -1,40 +1,46 @@
 ---
 slug: commands-ai
 title: AI commands
-description: mxs ai — manage AI summary / translation / insights artifacts
+description: mxs ai — manage AI summary / translation / insights / tts / overview artifacts
 order: 45
 ---
 
 # AI commands
 
-`mxs ai` manages every AI artifact the core server produces: per-article **summary**, per-article **translation**, per-article **insights**, plus the i18n **translation entries** dictionary used for category / topic / note metadata.
+`mxs ai` manages every AI artifact the core server produces: per-article **summary**, per-article **translation**, per-article **insights**, per-article **tts** narrations, the read-only **overview** board, plus the i18n **translation entries** dictionary used for category / topic / note metadata.
 
 Article references (`<id>`) accept a Snowflake id, a post slug, or a numeric note nid. The CLI resolves through post first, then note. Record references (`<recordId>`) are raw Snowflakes — they are NOT resolved.
 
 ## Generate verbs (async)
 
-`summary regen`, `translate run`, `insights refresh` enqueue a task and poll `GET /tasks/:id` until terminal (`succeeded` / `failed` / `cancelled`, or the spec-2 `completed` / `partial_failed` aliases). Progress lines write to stderr. `--no-wait` returns immediately with `status: pending`. If the server reports `created: false`, an in-flight deduplicated task already exists; the CLI joins it instead of erroring. Polling cadence is 1000 ms by default; override with `MXS_AI_POLL_MS=<ms>` for tests.
+`summary regen`, `summary translate`, `translate run`, `insights refresh`, `insights translate`, `tts run` enqueue a task and poll `GET /tasks/:id` until terminal (`succeeded` / `failed` / `cancelled`, or the spec-2 `completed` / `partial_failed` aliases). Progress lines write to stderr. `--no-wait` returns immediately with `status: pending`. If the server reports `created: false`, an in-flight deduplicated task already exists; the CLI joins it instead of erroring. Polling cadence is 1000 ms by default; override with `MXS_AI_POLL_MS=<ms>` for tests.
 
 | Command                                              | Purpose                                                         |
 | ---------------------------------------------------- | --------------------------------------------------------------- |
-| `mxs ai summary regen <id> [--to <lang>...]`         | Regenerate an article's AI summary.                             |
-| `mxs ai translate run <id> --to <lang>...`           | Translate an article into one or more languages (`--to` required, repeatable). |
-| `mxs ai insights refresh <id> [--to <lang>...]`      | Refresh AI insights for an article.                             |
+| `mxs ai summary regen <id> [--to <lang>...] [--force]` | Regenerate an article's AI summary.                           |
+| `mxs ai summary translate <id> --to <lang> [--force]` | Translate the existing base summary into ONE language.         |
+| `mxs ai translate run <id> --to <lang>... [--force]` | Translate an article into one or more languages (`--to` required, repeatable). |
+| `mxs ai insights refresh <id> [--to <lang>...] [--force]` | Refresh AI insights; `--to` also translates the result once generated. |
+| `mxs ai insights translate <id> --to <lang> [--force]` | Translate the existing base insights into ONE language.       |
+| `mxs ai tts run <id> [--to <lang>...] [--force]`     | Generate AI narration for an article (per language).            |
 
-Common flags on the three generate verbs:
+Common flags on the generate verbs:
 
 | Flag             | Effect                                                             |
 | ---------------- | ------------------------------------------------------------------ |
-| `--to <lang>`    | Target language code (repeatable). Forwarded as `targetLanguages`. |
+| `--to <lang>`    | Target language code (repeatable, max 8 server-side). Forwarded as `targetLanguages`. On `summary translate` / `insights translate` it is single-valued and forwarded as `targetLang`; on `tts run` it is forwarded as `langs`. |
+| `--force`        | Regenerate even when an up-to-date result exists (incremental skip otherwise). |
 | `--no-wait`      | Return after task creation; print `status: pending` and exit 0.    |
 
+`summary translate` / `insights translate` require an existing base record; when it is missing the server answers `taskId: null, reason: 'source-missing'` and the CLI fails with a hint to run `regen` / `refresh` first.
+
 On success the CLI emits an `ai-task` view: `taskId`, `status`, `refId`, `targetLanguages`, `totalTokens`, `totalCost` (cents), `resultIds`.
 
 ## Summary read / manage
 
 | Command                                                       | Purpose                                                       |
 | ------------------------------------------------------------- | ------------------------------------------------------------- |
-| `mxs ai summary list [--page <n>] [--size <n>] [--grouped]`   | List summaries (flat or grouped by article).                  |
+| `mxs ai summary list [--page <n>] [--size <n>] [--grouped] [--search <q>]` | List summaries (flat or grouped by article).     |
 | `mxs ai summary get <recordId>`                               | Get one summary by record id.                                 |
 | `mxs ai summary by-article <id> [--lang <l>] [--only-db]`     | Show an article's summary; `--only-db` skips auto-generation. |
 | `mxs ai summary edit <recordId>`                              | Edit the `summary` field via `$EDITOR` (JSON envelope).       |
@@ -46,7 +52,7 @@ There is no flat list endpoint for translations server-side. `mxs ai translate l
 
 | Command                                                  | Purpose                                                  |
 | -------------------------------------------------------- | -------------------------------------------------------- |
-| `mxs ai translate list [--page <n>] [--size <n>]`        | List translations (grouped by article).                  |
+| `mxs ai translate list [--page <n>] [--size <n>] [--search <q>]` | List translations (grouped by article).          |
 | `mxs ai translate get <recordId>`                        | Get one translation by record id.                        |
 | `mxs ai translate by-article <id> [--lang <l>]`          | Show an article's translations (single lang or all).     |
 | `mxs ai translate languages <id>`                        | List languages an article has been translated into.      |
@@ -70,12 +76,32 @@ The dictionary layer used for category / topic / note metadata translations. `--
 
 | Command                                                       | Purpose                                                        |
 | ------------------------------------------------------------- | -------------------------------------------------------------- |
-| `mxs ai insights list [--page <n>] [--size <n>] [--grouped]`  | List insights (flat or grouped by article).                    |
+| `mxs ai insights list [--page <n>] [--size <n>] [--grouped] [--search <q>]` | List insights (flat or grouped by article).      |
 | `mxs ai insights get <recordId>`                              | Get one insights record by record id.                          |
 | `mxs ai insights by-article <id> [--lang <l>] [--only-db]`    | Show an article's insights; `--only-db` skips auto-generation. |
 | `mxs ai insights edit <recordId>`                             | Edit the `content` field via `$EDITOR` (JSON envelope).        |
 | `mxs ai insights delete <recordId> [--force]`                 | Delete an insights record.                                     |
 
+## TTS read / manage
+
+| Command                                                       | Purpose                                                |
+| ------------------------------------------------------------- | ------------------------------------------------------ |
+| `mxs ai tts list [--page <n>] [--size <n>] [--grouped] [--search <q>]` | List narrations (flat or grouped by article). |
+| `mxs ai tts by-article <id>`                                  | Show all narration rows for an article (admin view).   |
+| `mxs ai tts voices --provider <id> --model <m>`               | Discover TTS voices; BOTH flags are required.          |
+| `mxs ai tts delete <recordId> [--force]`                      | Delete a narration record.                             |
+
+There is no `tts get <recordId>` or `tts edit` — narrations are regenerated, not hand-edited.
+
+## Overview board (read-only)
+
+Aggregates each article's AI artifact state (summary / translation / insights coverage) in one view.
+
+| Command                                                       | Purpose                                            |
+| ------------------------------------------------------------- | -------------------------------------------------- |
+| `mxs ai overview list [--page <n>] [--size <n>] [--search <q>] [--type post\|note\|page]` | List the per-article board. |
+| `mxs ai overview by-article <id>`                             | Show the AI artifact overview for one article.     |
+
 ## Exit codes specific to `ai`
 
 | Code   | When                                                                                     |
@@ -99,8 +125,15 @@ mxs ai translate run my-post --to ja --no-wait
 mxs ai insights refresh my-post
 mxs ai insights by-article my-post --only-db
 
+# Translate an existing summary into Japanese, forcing regeneration
+mxs ai summary translate my-post --to ja --force
+
+# Generate a Chinese narration
+mxs ai tts run my-post --to zh
+
 # Inventory
-mxs ai summary list --grouped --output json | jq .
+mxs ai summary list --grouped --search hello --output json | jq .
+mxs ai overview list --type post
 mxs ai translate languages my-post
 
 # Patch a translation record through $EDITOR

package/skills/overview.md

@@ -25,7 +25,7 @@ The audience is **AI agents**. Pass `--output llm` for raw markdown suitable for
 | Categories                                    | `commands-category`              |
 | Topics                                        | `commands-topic`                 |
 | Snippets (server data / functions)            | `commands-snippet`               |
-| AI summary / translation / insights / entries | `commands-ai`                    |
+| AI summary / translation / insights / tts / overview / entries | `commands-ai`   |
 | Server-side options                           | `commands-config`                |
 | Authentication                                | `commands-auth`                  |
 | Local profile management                      | `commands-profile`               |

package/skills/safety.md

@@ -49,7 +49,7 @@ Use this reference for every mutation, deletion, publication change, or failed c
 | `validation.xml`                                      | Invalid LiteXML envelope.                                                     | Check root tag, `<meta>`, `<content>`, nested tags, and line detail.        |
 | `resource.not_found`                                  | Wrong slug/id, deleted resource, or wrong target.                             | Re-run list/get on the confirmed target.                                   |
 | `profile.write_requires_explicit`                     | Active profile is flagged production; mutation refused without `--profile`.   | Pass `--profile <name>` explicitly, or `mxs profile mark <name> --no-production`. |
-| `skill.chapter_not_found`                             | Requested chapter slug is not in the registry.                                | `mxs skill` to list; for `litexml-*` upgrade `@haklex/rich-litexml` to ≥0.16.0. |
+| `skill.chapter_not_found`                             | Requested chapter slug is not in the registry.                                | `mxs skill` to list; for `litexml-*` upgrade `@haklex/rich-litexml` to ≥0.36.1. |
 | `EDITOR is not set`                                   | Interactive edit requested without editor.                                    | Set `EDITOR` or use flags/file instead.                                    |
 | Large noisy JSON output                               | Raw document payload is too verbose.                                          | Use `--output llm` for read-back and `--json` for mutations.                |
 | Link or embed URLs become empty during dry-run        | LiteXML round-trip lost node attributes or the agent is using an older CLI build. | Stop before writing; update/fix the CLI and repeat dry-run before mutation. |

package/dist/esm-CH7CrOvh.mjs

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