@mx-space/cli 0.14.2 → 0.15.1

package/dist/src/domain/schema/api-envelope.js

@@ -0,0 +1,65 @@
+import { Schema } from 'effect';
+/**
+ * Wire-format error envelope emitted by `Renderer.emitError` (and consumed
+ * by tests as a regression oracle). Mirrors `MxsError.toJSON()` from the
+ * v0.2.x core, plus the `tagToCode` table in `domain/errors.ts`.
+ */
+export const ErrorEnvelopeSchema = Schema.Struct({
+    ok: Schema.Literal(false),
+    code: Schema.String,
+    message: Schema.String,
+    details: Schema.optional(Schema.Unknown),
+    hint: Schema.optional(Schema.String),
+});
+/**
+ * Server-side pagination block. mx-core servers emit `page/size/total` —
+ * the CLI also accepts the legacy aliases (`currentPage`/`pageSize`/
+ * `totalCount`) for back-compat with old fixtures.
+ */
+export const PaginationSchema = Schema.Struct({
+    page: Schema.optional(Schema.Number),
+    size: Schema.optional(Schema.Number),
+    total: Schema.optional(Schema.Number),
+    totalPage: Schema.optional(Schema.Number),
+    currentPage: Schema.optional(Schema.Number),
+    pageSize: Schema.optional(Schema.Number),
+    totalCount: Schema.optional(Schema.Number),
+});
+/**
+ * `{ data, pagination }` envelope — produced by paginator-decorated
+ * controllers in mx-core (`ResponseInterceptor`).
+ */
+export const paginatedEnvelopeSchema = (item) => Schema.Struct({
+    data: Schema.Array(item),
+    pagination: Schema.optional(PaginationSchema),
+});
+/**
+ * `{ data: [...] }` envelope — produced by array responses without
+ * paginator decoration.
+ */
+export const dataArrayEnvelopeSchema = (item) => Schema.Struct({
+    data: Schema.Array(item),
+});
+/**
+ * Common server error body shape — used to extract the human `message`
+ * when mapping non-2xx responses to `TaggedError`s.
+ */
+export const ServerErrorBodySchema = Schema.Struct({
+    message: Schema.optional(Schema.Union(Schema.String, Schema.Array(Schema.String))),
+    code: Schema.optional(Schema.String),
+    details: Schema.optional(Schema.Unknown),
+});
+/**
+ * Extract a flattened `message` string from an arbitrary error body,
+ * matching the legacy `extractMessage` helper in `api-client.ts`.
+ */
+export const extractServerMessage = (body) => {
+    if (!body || typeof body !== 'object')
+        return null;
+    const msg = body.message;
+    if (typeof msg === 'string')
+        return msg;
+    if (Array.isArray(msg) && typeof msg[0] === 'string')
+        return msg.join('; ');
+    return null;
+};

package/dist/src/domain/schema/category.d.ts

@@ -0,0 +1,23 @@
+import { Schema } from 'effect';
+export declare const CategoryTypeSchema: Schema.Union<[Schema.Literal<[0, 1]>, Schema.Literal<["0", "1"]>]>;
+export declare const CategorySchema: Schema.Struct<{
+    id: typeof Schema.String;
+    slug: typeof Schema.String;
+    name: typeof Schema.String;
+    createdAt: Schema.optional<typeof Schema.Any>;
+    type: Schema.optional<typeof Schema.Any>;
+    count: Schema.optional<typeof Schema.Any>;
+}>;
+export type Category = Schema.Schema.Type<typeof CategorySchema>;
+export declare const CategoryListResponse: Schema.Struct<{
+    data: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        slug: typeof Schema.String;
+        name: typeof Schema.String;
+        createdAt: Schema.optional<typeof Schema.Any>;
+        type: Schema.optional<typeof Schema.Any>;
+        count: Schema.optional<typeof Schema.Any>;
+    }>>;
+    pagination: Schema.optional<typeof Schema.Any>;
+}>;
+export type CategoryListResponse = Schema.Schema.Type<typeof CategoryListResponse>;

package/dist/src/domain/schema/category.js

@@ -0,0 +1,19 @@
+import { Schema } from 'effect';
+// CategoryType enum mirrors `@mx-space/api-client` `CategoryType` (0 = category, 1 = tag).
+// We accept either numeric or string forms because legacy responses occasionally
+// stringify the value.
+export const CategoryTypeSchema = Schema.Union(Schema.Literal(0, 1), Schema.Literal('0', '1'));
+export const CategorySchema = Schema.Struct({
+    id: Schema.String,
+    slug: Schema.String,
+    name: Schema.String,
+    // Unknown / loosely typed fields — kept as `Any` so server-side additions
+    // don't break decoding. Critical fields above are strictly typed.
+    createdAt: Schema.optional(Schema.Any),
+    type: Schema.optional(Schema.Any),
+    count: Schema.optional(Schema.Any),
+});
+export const CategoryListResponse = Schema.Struct({
+    data: Schema.Array(CategorySchema),
+    pagination: Schema.optional(Schema.Any),
+});

package/dist/src/domain/schema/config.d.ts

@@ -0,0 +1,13 @@
+import { Schema } from 'effect';
+export declare const ProfileConfigSchema: Schema.Struct<{
+    api_url: Schema.optional<typeof Schema.String>;
+    api_version: Schema.optional<typeof Schema.Number>;
+    production: Schema.optional<typeof Schema.Boolean>;
+}>;
+export type ProfileConfig = Schema.Schema.Type<typeof ProfileConfigSchema>;
+export declare const LegacyConfigSchema: Schema.Struct<{
+    api_url: Schema.optional<typeof Schema.String>;
+    api_version: Schema.optional<typeof Schema.Number>;
+    production: Schema.optional<typeof Schema.Boolean>;
+}>;
+export type LegacyConfig = ProfileConfig;

package/dist/src/domain/schema/config.js

@@ -0,0 +1,18 @@
+import { Schema } from 'effect';
+// ---------------------------------------------------------------------------
+// Profile config schema — matches `~/.config/mxs/profiles/<name>/config.json`.
+//
+// `production` is optional and only present when explicitly marked. Legacy
+// fields (`api_base`, `auth_base`, `client_id`) are tolerated on read by
+// stripping them before decoding — see `stripLegacyConfigFields` in
+// `services/Config.ts`.
+// ---------------------------------------------------------------------------
+export const ProfileConfigSchema = Schema.Struct({
+    api_url: Schema.optional(Schema.String),
+    api_version: Schema.optional(Schema.Number),
+    production: Schema.optional(Schema.Boolean),
+});
+// Top-level `~/.config/mxs/config.json` is identical in shape today (it only
+// exists in the legacy single-profile layout). We re-export the same schema
+// under a distinct name to keep call sites self-documenting.
+export const LegacyConfigSchema = ProfileConfigSchema;

package/dist/src/domain/schema/note.d.ts

@@ -0,0 +1,76 @@
+import { Schema } from 'effect';
+export declare const NoteSchema: Schema.Struct<{
+    id: typeof Schema.String;
+    title: typeof Schema.String;
+    nid: Schema.optional<typeof Schema.Any>;
+    slug: Schema.optional<typeof Schema.Any>;
+    text: Schema.optional<typeof Schema.Any>;
+    content: Schema.optional<typeof Schema.Any>;
+    contentFormat: Schema.optional<typeof Schema.Any>;
+    isPublished: Schema.optional<typeof Schema.Any>;
+    hasPassword: Schema.optional<typeof Schema.Any>;
+    publicAt: Schema.optional<typeof Schema.Any>;
+    mood: Schema.optional<typeof Schema.Any>;
+    weather: Schema.optional<typeof Schema.Any>;
+    bookmark: Schema.optional<typeof Schema.Any>;
+    location: Schema.optional<typeof Schema.Any>;
+    coordinates: Schema.optional<typeof Schema.Any>;
+    topicId: Schema.optional<typeof Schema.Any>;
+    topic: Schema.optional<Schema.Union<[Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        slug: typeof Schema.String;
+        description: Schema.optional<typeof Schema.Any>;
+        introduce: Schema.optional<typeof Schema.Any>;
+        icon: Schema.optional<typeof Schema.Any>;
+        createdAt: Schema.optional<typeof Schema.Any>;
+    }>, typeof Schema.Null]>>;
+    summary: Schema.optional<typeof Schema.Any>;
+    meta: Schema.optional<typeof Schema.Any>;
+    images: Schema.optional<typeof Schema.Any>;
+    readCount: Schema.optional<typeof Schema.Any>;
+    likeCount: Schema.optional<typeof Schema.Any>;
+    createdAt: Schema.optional<typeof Schema.Any>;
+    modifiedAt: Schema.optional<typeof Schema.Any>;
+    enrichments: Schema.optional<typeof Schema.Any>;
+}>;
+export type Note = Schema.Schema.Type<typeof NoteSchema>;
+export declare const NoteListResponse: Schema.Struct<{
+    data: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        title: typeof Schema.String;
+        nid: Schema.optional<typeof Schema.Any>;
+        slug: Schema.optional<typeof Schema.Any>;
+        text: Schema.optional<typeof Schema.Any>;
+        content: Schema.optional<typeof Schema.Any>;
+        contentFormat: Schema.optional<typeof Schema.Any>;
+        isPublished: Schema.optional<typeof Schema.Any>;
+        hasPassword: Schema.optional<typeof Schema.Any>;
+        publicAt: Schema.optional<typeof Schema.Any>;
+        mood: Schema.optional<typeof Schema.Any>;
+        weather: Schema.optional<typeof Schema.Any>;
+        bookmark: Schema.optional<typeof Schema.Any>;
+        location: Schema.optional<typeof Schema.Any>;
+        coordinates: Schema.optional<typeof Schema.Any>;
+        topicId: Schema.optional<typeof Schema.Any>;
+        topic: Schema.optional<Schema.Union<[Schema.Struct<{
+            id: typeof Schema.String;
+            name: typeof Schema.String;
+            slug: typeof Schema.String;
+            description: Schema.optional<typeof Schema.Any>;
+            introduce: Schema.optional<typeof Schema.Any>;
+            icon: Schema.optional<typeof Schema.Any>;
+            createdAt: Schema.optional<typeof Schema.Any>;
+        }>, typeof Schema.Null]>>;
+        summary: Schema.optional<typeof Schema.Any>;
+        meta: Schema.optional<typeof Schema.Any>;
+        images: Schema.optional<typeof Schema.Any>;
+        readCount: Schema.optional<typeof Schema.Any>;
+        likeCount: Schema.optional<typeof Schema.Any>;
+        createdAt: Schema.optional<typeof Schema.Any>;
+        modifiedAt: Schema.optional<typeof Schema.Any>;
+        enrichments: Schema.optional<typeof Schema.Any>;
+    }>>;
+    pagination: Schema.optional<typeof Schema.Any>;
+}>;
+export type NoteListResponse = Schema.Schema.Type<typeof NoteListResponse>;

package/dist/src/domain/schema/note.js

@@ -0,0 +1,35 @@
+import { Schema } from 'effect';
+import { TopicSchema } from './topic';
+export const NoteSchema = Schema.Struct({
+    id: Schema.String,
+    title: Schema.String,
+    // `nid` is required by api-client but stays loose so legacy / older
+    // payloads decode cleanly.
+    nid: Schema.optional(Schema.Any),
+    slug: Schema.optional(Schema.Any),
+    text: Schema.optional(Schema.Any),
+    content: Schema.optional(Schema.Any),
+    contentFormat: Schema.optional(Schema.Any),
+    isPublished: Schema.optional(Schema.Any),
+    hasPassword: Schema.optional(Schema.Any),
+    publicAt: Schema.optional(Schema.Any),
+    mood: Schema.optional(Schema.Any),
+    weather: Schema.optional(Schema.Any),
+    bookmark: Schema.optional(Schema.Any),
+    location: Schema.optional(Schema.Any),
+    coordinates: Schema.optional(Schema.Any),
+    topicId: Schema.optional(Schema.Any),
+    topic: Schema.optional(Schema.Union(TopicSchema, Schema.Null)),
+    summary: Schema.optional(Schema.Any),
+    meta: Schema.optional(Schema.Any),
+    images: Schema.optional(Schema.Any),
+    readCount: Schema.optional(Schema.Any),
+    likeCount: Schema.optional(Schema.Any),
+    createdAt: Schema.optional(Schema.Any),
+    modifiedAt: Schema.optional(Schema.Any),
+    enrichments: Schema.optional(Schema.Any),
+});
+export const NoteListResponse = Schema.Struct({
+    data: Schema.Array(NoteSchema),
+    pagination: Schema.optional(Schema.Any),
+});

package/dist/src/domain/schema/page.d.ts

@@ -0,0 +1,40 @@
+import { Schema } from 'effect';
+export declare const PageSchema: Schema.Struct<{
+    id: typeof Schema.String;
+    title: typeof Schema.String;
+    slug: typeof Schema.String;
+    subtitle: Schema.optional<typeof Schema.Any>;
+    text: Schema.optional<typeof Schema.Any>;
+    content: Schema.optional<typeof Schema.Any>;
+    contentFormat: Schema.optional<typeof Schema.Any>;
+    order: Schema.optional<typeof Schema.Any>;
+    type: Schema.optional<typeof Schema.Any>;
+    options: Schema.optional<typeof Schema.Any>;
+    meta: Schema.optional<typeof Schema.Any>;
+    images: Schema.optional<typeof Schema.Any>;
+    createdAt: Schema.optional<typeof Schema.Any>;
+    modifiedAt: Schema.optional<typeof Schema.Any>;
+    enrichments: Schema.optional<typeof Schema.Any>;
+}>;
+export type Page = Schema.Schema.Type<typeof PageSchema>;
+export declare const PageListResponse: Schema.Struct<{
+    data: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        title: typeof Schema.String;
+        slug: typeof Schema.String;
+        subtitle: Schema.optional<typeof Schema.Any>;
+        text: Schema.optional<typeof Schema.Any>;
+        content: Schema.optional<typeof Schema.Any>;
+        contentFormat: Schema.optional<typeof Schema.Any>;
+        order: Schema.optional<typeof Schema.Any>;
+        type: Schema.optional<typeof Schema.Any>;
+        options: Schema.optional<typeof Schema.Any>;
+        meta: Schema.optional<typeof Schema.Any>;
+        images: Schema.optional<typeof Schema.Any>;
+        createdAt: Schema.optional<typeof Schema.Any>;
+        modifiedAt: Schema.optional<typeof Schema.Any>;
+        enrichments: Schema.optional<typeof Schema.Any>;
+    }>>;
+    pagination: Schema.optional<typeof Schema.Any>;
+}>;
+export type PageListResponse = Schema.Schema.Type<typeof PageListResponse>;

package/dist/src/domain/schema/page.js

@@ -0,0 +1,22 @@
+import { Schema } from 'effect';
+export const PageSchema = Schema.Struct({
+    id: Schema.String,
+    title: Schema.String,
+    slug: Schema.String,
+    subtitle: Schema.optional(Schema.Any),
+    text: Schema.optional(Schema.Any),
+    content: Schema.optional(Schema.Any),
+    contentFormat: Schema.optional(Schema.Any),
+    order: Schema.optional(Schema.Any),
+    type: Schema.optional(Schema.Any),
+    options: Schema.optional(Schema.Any),
+    meta: Schema.optional(Schema.Any),
+    images: Schema.optional(Schema.Any),
+    createdAt: Schema.optional(Schema.Any),
+    modifiedAt: Schema.optional(Schema.Any),
+    enrichments: Schema.optional(Schema.Any),
+});
+export const PageListResponse = Schema.Struct({
+    data: Schema.Array(PageSchema),
+    pagination: Schema.optional(Schema.Any),
+});

package/dist/src/domain/schema/post.d.ts

@@ -0,0 +1,68 @@
+import { Schema } from 'effect';
+export declare const PostSchema: Schema.Struct<{
+    id: typeof Schema.String;
+    title: typeof Schema.String;
+    slug: typeof Schema.String;
+    text: Schema.optional<typeof Schema.Any>;
+    content: Schema.optional<typeof Schema.Any>;
+    contentFormat: Schema.optional<typeof Schema.Any>;
+    summary: Schema.optional<typeof Schema.Any>;
+    copyright: Schema.optional<typeof Schema.Any>;
+    tags: Schema.optional<typeof Schema.Any>;
+    isPublished: Schema.optional<typeof Schema.Any>;
+    pinAt: Schema.optional<typeof Schema.Any>;
+    pinOrder: Schema.optional<typeof Schema.Any>;
+    categoryId: Schema.optional<typeof Schema.Any>;
+    category: Schema.optional<Schema.Struct<{
+        id: typeof Schema.String;
+        slug: typeof Schema.String;
+        name: typeof Schema.String;
+        createdAt: Schema.optional<typeof Schema.Any>;
+        type: Schema.optional<typeof Schema.Any>;
+        count: Schema.optional<typeof Schema.Any>;
+    }>>;
+    meta: Schema.optional<typeof Schema.Any>;
+    images: Schema.optional<typeof Schema.Any>;
+    readCount: Schema.optional<typeof Schema.Any>;
+    likeCount: Schema.optional<typeof Schema.Any>;
+    createdAt: Schema.optional<typeof Schema.Any>;
+    modifiedAt: Schema.optional<typeof Schema.Any>;
+    related: Schema.optional<typeof Schema.Any>;
+    enrichments: Schema.optional<typeof Schema.Any>;
+}>;
+export type Post = Schema.Schema.Type<typeof PostSchema>;
+export declare const PostListResponse: Schema.Struct<{
+    data: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        title: typeof Schema.String;
+        slug: typeof Schema.String;
+        text: Schema.optional<typeof Schema.Any>;
+        content: Schema.optional<typeof Schema.Any>;
+        contentFormat: Schema.optional<typeof Schema.Any>;
+        summary: Schema.optional<typeof Schema.Any>;
+        copyright: Schema.optional<typeof Schema.Any>;
+        tags: Schema.optional<typeof Schema.Any>;
+        isPublished: Schema.optional<typeof Schema.Any>;
+        pinAt: Schema.optional<typeof Schema.Any>;
+        pinOrder: Schema.optional<typeof Schema.Any>;
+        categoryId: Schema.optional<typeof Schema.Any>;
+        category: Schema.optional<Schema.Struct<{
+            id: typeof Schema.String;
+            slug: typeof Schema.String;
+            name: typeof Schema.String;
+            createdAt: Schema.optional<typeof Schema.Any>;
+            type: Schema.optional<typeof Schema.Any>;
+            count: Schema.optional<typeof Schema.Any>;
+        }>>;
+        meta: Schema.optional<typeof Schema.Any>;
+        images: Schema.optional<typeof Schema.Any>;
+        readCount: Schema.optional<typeof Schema.Any>;
+        likeCount: Schema.optional<typeof Schema.Any>;
+        createdAt: Schema.optional<typeof Schema.Any>;
+        modifiedAt: Schema.optional<typeof Schema.Any>;
+        related: Schema.optional<typeof Schema.Any>;
+        enrichments: Schema.optional<typeof Schema.Any>;
+    }>>;
+    pagination: Schema.optional<typeof Schema.Any>;
+}>;
+export type PostListResponse = Schema.Schema.Type<typeof PostListResponse>;

package/dist/src/domain/schema/post.js

@@ -0,0 +1,35 @@
+import { Schema } from 'effect';
+import { CategorySchema } from './category';
+// Strictly typed: `id`, `title`, `slug` are the fields the CLI surfaces in
+// every output mode (`readable`, `llm`, `envelope`). Everything else is left
+// as `Schema.Any` so server-side additions (new flags, enrichments, etc.) do
+// not break decoding.
+export const PostSchema = Schema.Struct({
+    id: Schema.String,
+    title: Schema.String,
+    slug: Schema.String,
+    // Optional / loose typed fields
+    text: Schema.optional(Schema.Any),
+    content: Schema.optional(Schema.Any),
+    contentFormat: Schema.optional(Schema.Any),
+    summary: Schema.optional(Schema.Any),
+    copyright: Schema.optional(Schema.Any),
+    tags: Schema.optional(Schema.Any),
+    isPublished: Schema.optional(Schema.Any),
+    pinAt: Schema.optional(Schema.Any),
+    pinOrder: Schema.optional(Schema.Any),
+    categoryId: Schema.optional(Schema.Any),
+    category: Schema.optional(CategorySchema),
+    meta: Schema.optional(Schema.Any),
+    images: Schema.optional(Schema.Any),
+    readCount: Schema.optional(Schema.Any),
+    likeCount: Schema.optional(Schema.Any),
+    createdAt: Schema.optional(Schema.Any),
+    modifiedAt: Schema.optional(Schema.Any),
+    related: Schema.optional(Schema.Any),
+    enrichments: Schema.optional(Schema.Any),
+});
+export const PostListResponse = Schema.Struct({
+    data: Schema.Array(PostSchema),
+    pagination: Schema.optional(Schema.Any),
+});

package/dist/src/domain/schema/profile.d.ts

@@ -0,0 +1,14 @@
+import { Schema } from 'effect';
+export declare const ProfileCredentialsSchema: Schema.Struct<{
+    access_token: typeof Schema.String;
+    refresh_token: Schema.optional<typeof Schema.String>;
+    expires_at: typeof Schema.Number;
+    user: Schema.optional<Schema.Struct<{
+        id: Schema.optional<typeof Schema.String>;
+        email: Schema.optional<typeof Schema.String>;
+        name: Schema.optional<typeof Schema.String>;
+    }>>;
+}>;
+export type ProfileCredentials = Schema.Schema.Type<typeof ProfileCredentialsSchema>;
+export declare const ProfileNameSchema: Schema.filter<Schema.filter<typeof Schema.String>>;
+export type ProfileName = Schema.Schema.Type<typeof ProfileNameSchema>;

package/dist/src/domain/schema/profile.js

@@ -0,0 +1,22 @@
+import { Schema } from 'effect';
+// ---------------------------------------------------------------------------
+// Profile credentials schema — matches
+// `~/.config/mxs/profiles/<name>/credentials.json`.
+// ---------------------------------------------------------------------------
+const ProfileUserSchema = Schema.Struct({
+    id: Schema.optional(Schema.String),
+    email: Schema.optional(Schema.String),
+    name: Schema.optional(Schema.String),
+});
+export const ProfileCredentialsSchema = Schema.Struct({
+    access_token: Schema.String,
+    refresh_token: Schema.optional(Schema.String),
+    expires_at: Schema.Number,
+    user: Schema.optional(ProfileUserSchema),
+});
+// ---------------------------------------------------------------------------
+// Profile name — `^[a-z0-9_-]{1,32}$`, excluding the reserved word `current`.
+// ---------------------------------------------------------------------------
+export const ProfileNameSchema = Schema.String.pipe(Schema.pattern(/^[\d_a-z-]{1,32}$/, {
+    message: () => 'profile name must match ^[a-z0-9_-]{1,32}$ and is case-sensitive',
+}), Schema.filter((s) => (s === 'current' ? "'current' is reserved" : true)));

package/dist/src/domain/schema/topic.d.ts

@@ -0,0 +1,24 @@
+import { Schema } from 'effect';
+export declare const TopicSchema: Schema.Struct<{
+    id: typeof Schema.String;
+    name: typeof Schema.String;
+    slug: typeof Schema.String;
+    description: Schema.optional<typeof Schema.Any>;
+    introduce: Schema.optional<typeof Schema.Any>;
+    icon: Schema.optional<typeof Schema.Any>;
+    createdAt: Schema.optional<typeof Schema.Any>;
+}>;
+export type Topic = Schema.Schema.Type<typeof TopicSchema>;
+export declare const TopicListResponse: Schema.Struct<{
+    data: Schema.Array$<Schema.Struct<{
+        id: typeof Schema.String;
+        name: typeof Schema.String;
+        slug: typeof Schema.String;
+        description: Schema.optional<typeof Schema.Any>;
+        introduce: Schema.optional<typeof Schema.Any>;
+        icon: Schema.optional<typeof Schema.Any>;
+        createdAt: Schema.optional<typeof Schema.Any>;
+    }>>;
+    pagination: Schema.optional<typeof Schema.Any>;
+}>;
+export type TopicListResponse = Schema.Schema.Type<typeof TopicListResponse>;

package/dist/src/domain/schema/topic.js

@@ -0,0 +1,16 @@
+import { Schema } from 'effect';
+export const TopicSchema = Schema.Struct({
+    id: Schema.String,
+    name: Schema.String,
+    slug: Schema.String,
+    // Loose fields — mirror api-client `TopicModel` without forcing nullability
+    // shape since the wire payload occasionally omits them.
+    description: Schema.optional(Schema.Any),
+    introduce: Schema.optional(Schema.Any),
+    icon: Schema.optional(Schema.Any),
+    createdAt: Schema.optional(Schema.Any),
+});
+export const TopicListResponse = Schema.Struct({
+    data: Schema.Array(TopicSchema),
+    pagination: Schema.optional(Schema.Any),
+});

package/dist/src/domain/version.d.ts

@@ -0,0 +1,15 @@
+import { release } from 'node:os';
+export declare const CLI_VERSION: string;
+/**
+ * RFC-7231-style User-Agent. Format:
+ *   `mxs/<cli-version> (<os-platform> <os-arch>; node/<node-version>)`
+ *
+ * Example: `mxs/0.4.0 (darwin arm64; node/v22.22.2)`
+ *
+ * mx-core's spider guard whitelists any UA containing `mx-space`; this string
+ * does (`mxs` is the @mx-space/cli binary). Authenticated requests bypass the
+ * guard regardless of UA, but a well-formed UA helps server-side analytics
+ * tell agent traffic apart from human browser sessions.
+ */
+export declare const USER_AGENT: string;
+export declare const HOST_KERNEL_RELEASE: typeof release;

package/dist/src/domain/version.js

@@ -0,0 +1,43 @@
+import { createRequire } from 'node:module';
+import { arch, platform, release } from 'node:os';
+// `import.meta.url` resolves to one of:
+//   `<root>/packages/cli/src/.../*.ts`     (tsx, dev)
+//   `<root>/packages/cli/dist/*.mjs`       (bundled)
+//   `<root>/packages/cli/dist/bin/*.mjs`   (bin shim)
+// Walk up until we find the @mx-space/cli package.json.
+const requireFrom = createRequire(import.meta.url);
+const resolveCliVersion = () => {
+    const candidates = [
+        '../package.json',
+        '../../package.json',
+        '../../../package.json',
+    ];
+    for (const candidate of candidates) {
+        try {
+            const pkg = requireFrom(candidate);
+            if (pkg.name === '@mx-space/cli' && typeof pkg.version === 'string') {
+                return pkg.version;
+            }
+        }
+        catch {
+            // try next candidate
+        }
+    }
+    return '0.0.0-unknown';
+};
+export const CLI_VERSION = resolveCliVersion();
+/**
+ * RFC-7231-style User-Agent. Format:
+ *   `mxs/<cli-version> (<os-platform> <os-arch>; node/<node-version>)`
+ *
+ * Example: `mxs/0.4.0 (darwin arm64; node/v22.22.2)`
+ *
+ * mx-core's spider guard whitelists any UA containing `mx-space`; this string
+ * does (`mxs` is the @mx-space/cli binary). Authenticated requests bypass the
+ * guard regardless of UA, but a well-formed UA helps server-side analytics
+ * tell agent traffic apart from human browser sessions.
+ */
+export const USER_AGENT = `mxs/${CLI_VERSION} (${platform()} ${arch()}; node/${process.version}) @mx-space/cli`;
+// `release()` is exposed for future enrichment (build/dist channel) — kept off
+// the default UA to avoid leaking host detail unnecessarily.
+export const HOST_KERNEL_RELEASE = release;

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export { run } from './bin/mxs';
+export { type CliError, type CliErrorTag, codeForTag, defaultMessageFor, type ErrorEnvelope, exitCodeForError, exitCodeForTag, tagToCode, toErrorEnvelope, } from './domain/errors';
+export { defaultGlobalFlags, type GlobalFlags, parseGlobalFlags, } from './domain/runtime-flags';
+export type { OutputMode, OutputOptions } from './services/Renderer';

package/dist/src/index.js

@@ -0,0 +1,8 @@
+// Public surface for `@mx-space/cli`. The v0.3 rewrite is internal: most of
+// what we exported in v0.2.x was structural plumbing that has since been
+// replaced by Effect services. Downstream consumers that still want to
+// programmatically drive the CLI use `run` below; everything else is
+// available through the namespaced `domain/`, `services/`, `cli/` exports.
+export { run } from './bin/mxs';
+export { codeForTag, defaultMessageFor, exitCodeForError, exitCodeForTag, tagToCode, toErrorEnvelope, } from './domain/errors';
+export { defaultGlobalFlags, parseGlobalFlags, } from './domain/runtime-flags';

package/dist/src/layers/App.d.ts

@@ -0,0 +1,30 @@
+import type { FileSystem, HttpClient, Path } from '@effect/platform';
+import { Layer } from 'effect';
+import { Auth } from '../services/Auth';
+import { Config } from '../services/Config';
+import { Editor } from '../services/Editor';
+import { Lexical } from '../services/Lexical';
+import { Migration } from '../services/Migration';
+import { Profile } from '../services/Profile';
+import { Renderer } from '../services/Renderer';
+import { Skill } from '../services/Skill';
+import { UpdateNotifier } from '../services/UpdateNotifier';
+/**
+ * Application-wide service layer — everything EXCEPT `Api` and `Resolver`,
+ * which depend on per-invocation global flags (`--api-url`, `--token`,
+ * `--api-key`, `--profile`, `--dry-run`, `--lang`) and must be constructed
+ * inside `bin/mxs.ts` after `parseGlobalFlags`.
+ *
+ * Internal dependencies are wired here so callers only need to provide the
+ * platform-level services: `FileSystem`, `Path`, `HttpClient`.
+ *
+ *   Config       ← FileSystem, Path
+ *   Profile      ← Config
+ *   Migration    ← Config, FileSystem
+ *   Auth         ← Config, HttpClient
+ *   Editor       ← FileSystem
+ *   Renderer     — pure
+ *   Lexical      — pure
+ *   UpdateNotifier — pure
+ */
+export declare const AppLayer: Layer.Layer<Auth | Config | Editor | Lexical | Migration | Profile | Renderer | Skill | UpdateNotifier, never, FileSystem.FileSystem | HttpClient.HttpClient | Path.Path>;

package/dist/src/layers/App.js

@@ -0,0 +1,39 @@
+import { Layer } from 'effect';
+import { Auth } from '../services/Auth';
+import { Config } from '../services/Config';
+import { Editor } from '../services/Editor';
+import { Lexical } from '../services/Lexical';
+import { Migration } from '../services/Migration';
+import { Profile } from '../services/Profile';
+import { Renderer } from '../services/Renderer';
+import { Skill } from '../services/Skill';
+import { UpdateNotifier } from '../services/UpdateNotifier';
+// NOTE: `Comment` depends on `Api`, so it is layered into the composition in
+// `bin/mxs.ts` (alongside `Resolver`) — NOT here. Listing it would create a
+// dependency on per-invocation flags. See `bin/mxs.ts#fullAppLayer`.
+/**
+ * Application-wide service layer — everything EXCEPT `Api` and `Resolver`,
+ * which depend on per-invocation global flags (`--api-url`, `--token`,
+ * `--api-key`, `--profile`, `--dry-run`, `--lang`) and must be constructed
+ * inside `bin/mxs.ts` after `parseGlobalFlags`.
+ *
+ * Internal dependencies are wired here so callers only need to provide the
+ * platform-level services: `FileSystem`, `Path`, `HttpClient`.
+ *
+ *   Config       ← FileSystem, Path
+ *   Profile      ← Config
+ *   Migration    ← Config, FileSystem
+ *   Auth         ← Config, HttpClient
+ *   Editor       ← FileSystem
+ *   Renderer     — pure
+ *   Lexical      — pure
+ *   UpdateNotifier — pure
+ */
+export const AppLayer = (() => {
+    const configLayer = Config.Default;
+    const profileLayer = Profile.Default.pipe(Layer.provide(configLayer));
+    const migrationLayer = Migration.Default.pipe(Layer.provide(configLayer));
+    const authLayer = Auth.Default.pipe(Layer.provide(configLayer));
+    const editorLayer = Editor.Default;
+    return Layer.mergeAll(configLayer, profileLayer, migrationLayer, authLayer, editorLayer, Renderer.Default, Lexical.Default, Skill.Default, UpdateNotifier.Default);
+})();