@mx-space/cli 0.6.0 → 0.6.2

package/README.md

@@ -485,6 +485,40 @@ Example profile config:
 | `6`  | Server 5xx failure                                                           |
 | `7`  | Resource not found                                                           |
 
+## Preview
+
+`mxs preview <file>` renders a LiteXML fragment or `<mxpost>` / `<mxnote>` envelope to HTML and opens it in your default browser. Use it to sanity-check what the article will look like before publishing.
+
+```bash
+mxs preview ./post.xml                 # open in browser
+mxs preview - < note.xml               # read stdin
+mxs preview ./post.xml --theme dark    # dark theme
+mxs preview ./post.xml --save out.html # write HTML to file
+mxs preview ./post.xml --print         # emit HTML to stdout
+```
+
+The variant (`article` / `note`) is auto-detected from the envelope root. Override with `--variant` for raw LiteXML fragments. The command does not contact `mx-core` — it's a pure local render via `@haklex/rich-litexml-cli`.
+
+## Skill bundle
+
+`mxs skill` exposes the bundled AI-agent documentation directly from the CLI binary. Chapters are shipped inside the published `@mx-space/cli` package; liteXML chapters are pulled live from `@haklex/rich-litexml` at runtime (requires `@haklex/rich-litexml@>=0.16.0`).
+
+| Command                          | Behaviour                                                  |
+| -------------------------------- | ---------------------------------------------------------- |
+| `mxs skill`                      | List every chapter (slug + one-line description).          |
+| `mxs skill get <slug>`           | Print one chapter; default output is markdown for agents.  |
+| `mxs skill all`                  | Concatenate every chapter in registry order.               |
+| `mxs skill search <keyword>`     | Substring search across title / description / body.        |
+
+All four verbs honour the global `--json`, `--output llm`, `--output xml`, and `--output readable` flags.
+
+Override paths for development or vendoring:
+
+| Variable                | Effect                                                                 |
+| ----------------------- | ---------------------------------------------------------------------- |
+| `MXS_SKILL_CLI_DIR`     | Override the CLI-native skill directory (default: `<pkg>/skills/`).    |
+| `MXS_SKILL_HAKLEX_DIR`  | Override the haklex liteXML skill directory.                           |
+
 ## Troubleshooting
 
 | Symptom                                            | Resolution                                                                                                                |

package/ROADMAP.md

@@ -8,6 +8,11 @@
 
 - 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.
 
+## Shipped in v0.6
+
+- `mxs skill` — bundled AI-agent documentation. List, get, all, search across chapters shipped inside the CLI (`packages/cli/skills/*.md`); liteXML chapters loaded live from the installed `@haklex/rich-litexml` package. Default output is raw markdown for direct context injection.
+- `mxs preview <file>` — local HTML preview of a LiteXML fragment or `<mxpost>` / `<mxnote>` envelope. Wraps `@haklex/rich-litexml-cli` so the output matches the editor renderer.
+
 ## Next — Comment moderation
 
 - `mxs comment list [--page N] [--size N] [--state unread|read|junk] [--all]`

package/dist/bin/mxs.mjs

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

package/dist/index.d.mts

@@ -1446,6 +1446,24 @@ declare class ArgvParse extends ArgvParse_base<{
   readonly details?: unknown;
   readonly hint?: string;
 }> {}
+declare const ChapterNotFound_base: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
+  readonly _tag: "ChapterNotFound";
+} & Readonly<A>;
+declare class ChapterNotFound extends ChapterNotFound_base<{
+  readonly message?: string;
+  readonly slug?: string;
+  readonly details?: unknown;
+  readonly hint?: string;
+}> {}
+declare const SkillCorpusEmpty_base: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
+  readonly _tag: "SkillCorpusEmpty";
+} & Readonly<A>;
+declare class SkillCorpusEmpty extends SkillCorpusEmpty_base<{
+  readonly message?: string;
+  readonly details?: unknown;
+  readonly hint?: string;
+  readonly cause?: unknown;
+}> {}
 declare const Generic_base: new <A extends Record<string, any> = {}>(args: VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P] }>) => YieldableError & {
   readonly _tag: "Generic";
 } & Readonly<A>;
@@ -1455,7 +1473,7 @@ declare class Generic extends Generic_base<{
   readonly hint?: string;
   readonly cause?: unknown;
 }> {}
-type CliError = AuthMissing | AuthExpired | AuthDenied | AuthProbe | NetworkTimeout | NetworkDns | NetworkRefused | ValidationFailed | ValidationXml | ServerError | ResourceNotFound | ConfigMissingApiUrl | ConfigMissingToken | ConfigMigrationFailed | ProfileNotFound | ProfileNoneActive | ProfileInvalidName | WriteRequiresExplicit | UpdateDevEnvironment | UpdateTransientInstall | UpdatePmUnknown | UpdateRegistryUnreachable | UpdateNodeIncompatible | UpdateSpawnFailed | UpdatePermissionDenied | ArgvParse | Generic;
+type CliError = AuthMissing | AuthExpired | AuthDenied | AuthProbe | NetworkTimeout | NetworkDns | NetworkRefused | ValidationFailed | ValidationXml | ServerError | ResourceNotFound | ConfigMissingApiUrl | ConfigMissingToken | ConfigMigrationFailed | ProfileNotFound | ProfileNoneActive | ProfileInvalidName | WriteRequiresExplicit | UpdateDevEnvironment | UpdateTransientInstall | UpdatePmUnknown | UpdateRegistryUnreachable | UpdateNodeIncompatible | UpdateSpawnFailed | UpdatePermissionDenied | ArgvParse | ChapterNotFound | SkillCorpusEmpty | Generic;
 type CliErrorTag = CliError['_tag'];
 declare const tagToCode: Record<CliErrorTag, string>;
 declare const codeForTag: (tag: CliErrorTag) => string;

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