@mx-space/cli 0.8.0 → 0.9.0

package/README.md

@@ -288,6 +288,36 @@ URL follows the admin-vue3 hash-router convention
 
 Page edit and page file payloads currently reuse the `<mxpost>` envelope shape.
 
+## Projects
+
+| Command                          | Description                                                                                                |
+| -------------------------------- | ---------------------------------------------------------------------------------------------------------- |
+| `mxs project list`               | List projects.                                                                                             |
+| `mxs project get <nameOrId>`     | Read a project by Snowflake id or unique `name` (raw envelope).                                            |
+| `mxs project view <nameOrId>`    | Show a project rendered for terminal / LLM consumption.                                                    |
+| `mxs project create`             | Create a project. `--name` and `--description` are required.                                               |
+| `mxs project edit <nameOrId>`    | Edit through `$EDITOR` using a JSON envelope of editable fields. No change → no PATCH; malformed JSON exits with `validation.json`. |
+| `mxs project update <nameOrId>`  | Patch selected project fields. Missing flags leave the field untouched.                                    |
+| `mxs project delete <nameOrId>`  | Delete a project. Requires `--force` in non-TTY contexts.                                                  |
+
+### Project Write Flags
+
+| Flag                   | Field           | Notes                                          |
+| ---------------------- | --------------- | ---------------------------------------------- |
+| `--name <text>`        | `name`          | Required on `create`. Unique server-side.       |
+| `--description <text>` | `description`   | Required on `create`.                          |
+| `--preview-url <url>`  | `previewUrl`    | http(s) URL.                                   |
+| `--project-url <url>`  | `projectUrl`    | http(s) URL.                                   |
+| `--doc-url <url>`      | `docUrl`        | http(s) URL.                                   |
+| `--avatar <url>`       | `avatar`        | http(s) URL.                                   |
+| `--images <csv>`       | `images`        | Comma-separated list of URLs (≤ 20).            |
+| `--text <text>`        | `text`          | Free-form plain text.                          |
+| `--file <path>`        | (merge)         | JSON file whose recognised keys merge in first; per-flag values override. |
+| `--open`               | —               | After success, open the admin edit page.       |
+| `--silent`             | —               | On success, emit `{ ok: true }` instead of the full row. |
+
+Resolver: `<nameOrId>` accepts a Snowflake id directly, or a `name` resolved via `GET /projects/all`. Duplicate names surface from the server as `PROJECT_NAME_TAKEN` (409).
+
 ## Categories
 
 | Command                                           | Description                                                       |

package/ROADMAP.md

@@ -12,6 +12,7 @@
 
 - `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.
+- `mxs project` — full CRUD for portfolio projects: `list`, `get`, `view`, `create`, `edit` ($EDITOR JSON envelope), `update`, `delete`. Resolver accepts unique `name` or Snowflake id. Server adds `PATCH /projects/:id`, a Zod DTO on create/update, and a `PROJECT_NAME_TAKEN` (409) error on duplicate names.
 
 ## Next — Comment moderation
 

package/dist/bin/mxs.mjs

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

package/dist/index.d.mts

@@ -1322,6 +1322,15 @@ declare class ValidationXml extends ValidationXml_base<{
   readonly hint?: string;
   readonly cause?: unknown;
 }> {}
+declare const ValidationJson_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: "ValidationJson";
+} & Readonly<A>;
+declare class ValidationJson extends ValidationJson_base<{
+  readonly message?: string;
+  readonly details?: unknown;
+  readonly hint?: string;
+  readonly cause?: unknown;
+}> {}
 declare const ServerError_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: "ServerError";
 } & Readonly<A>;
@@ -1493,7 +1502,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 | ChapterNotFound | SkillCorpusEmpty | Generic;
+type CliError = AuthMissing | AuthExpired | AuthDenied | AuthProbe | NetworkTimeout | NetworkDns | NetworkRefused | ValidationFailed | ValidationXml | ValidationJson | 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-DT0oYk6U.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-BR5Y5ash.mjs";
 export { codeForTag, defaultGlobalFlags, defaultMessageFor, exitCodeForError, exitCodeForTag, parseGlobalFlags, run, tagToCode, toErrorEnvelope };