@mx-space/cli 0.14.2 → 0.15.1

package/dist/src/cli/category/index.d.ts

@@ -0,0 +1,20 @@
+import { Command } from '@effect/cli';
+export declare const categoryCmd: Command.Command<"category", import("../../services/Api").Api | import("../ai/_poll").Renderer | import("../../services/Resolver").Resolver, import("../../services/Api").ApiError, {
+    readonly subcommand: import("effect/Option").Option<{
+        readonly name: string;
+        readonly slug: string;
+        readonly type: import("effect/Option").Option<"tag" | "category">;
+        readonly icon: import("effect/Option").Option<string>;
+    } | {
+        readonly slugOrId: string;
+        readonly force: boolean;
+    } | {
+        readonly slugOrId: string;
+    } | {} | {
+        readonly slugOrId: string;
+        readonly name: import("effect/Option").Option<string>;
+        readonly slug: import("effect/Option").Option<string>;
+        readonly type: import("effect/Option").Option<"tag" | "category">;
+        readonly icon: import("effect/Option").Option<string>;
+    }>;
+}>;

package/dist/src/cli/category/index.js

@@ -0,0 +1,41 @@
+import { Command } from '@effect/cli';
+import { registerCommandHelp } from '../help/registry';
+import { create } from './create';
+import { del } from './delete';
+import { get } from './get';
+import { list } from './list';
+import { update } from './update';
+const help = registerCommandHelp({
+    name: 'category',
+    description: 'manage categories / tags',
+    skillChapter: 'commands-category',
+    verbs: [
+        { name: 'list', description: 'list categories and tags' },
+        {
+            name: 'get',
+            args: ['<slugOrId>'],
+            description: 'show a single category',
+        },
+        {
+            name: 'create',
+            args: [
+                '--name <n>',
+                '--slug <s>',
+                '[--type <category/tag>]',
+                '[--icon ...]',
+            ],
+            description: 'create a category or tag',
+        },
+        {
+            name: 'update',
+            args: ['<slugOrId>', '[--name ...]', '[--slug ...]', '...'],
+            description: 'update a category',
+        },
+        {
+            name: 'delete',
+            args: ['<slugOrId>', '[--force]'],
+            description: 'delete a category',
+        },
+    ],
+});
+export const categoryCmd = Command.make('category').pipe(Command.withDescription(help.description), Command.withSubcommands([list, get, create, update, del]));

package/dist/src/cli/category/list.d.ts

@@ -0,0 +1,4 @@
+import { Command } from '@effect/cli';
+import { Api } from '../../services/Api';
+import { Renderer } from '../../services/Renderer';
+export declare const list: Command.Command<"list", Api | Renderer, import("../../services/Api").ApiError, {}>;

package/dist/src/cli/category/list.js

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { Api } from '../../services/Api';
+import { Renderer } from '../../services/Renderer';
+export const list = Command.make('list', {}, () => Effect.gen(function* () {
+    const api = yield* Api;
+    const renderer = yield* Renderer;
+    const res = yield* api.request('/categories');
+    yield* renderer.emitSuccess(res);
+}));

package/dist/src/cli/category/update.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@effect/cli';
+import { Option } from 'effect';
+import { Api } from '../../services/Api';
+import { Renderer } from '../../services/Renderer';
+import { Resolver } from '../../services/Resolver';
+export declare const update: Command.Command<"update", Api | Renderer | Resolver, import("../../services/Api").ApiError, {
+    readonly slugOrId: string;
+    readonly name: Option.Option<string>;
+    readonly slug: Option.Option<string>;
+    readonly type: Option.Option<"tag" | "category">;
+    readonly icon: Option.Option<string>;
+}>;

package/dist/src/cli/category/update.js

@@ -0,0 +1,34 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { Api } from '../../services/Api';
+import { Renderer } from '../../services/Renderer';
+import { Resolver } from '../../services/Resolver';
+const slugOrId = Args.text({ name: 'slugOrId' });
+const name = Options.text('name').pipe(Options.optional);
+const slug = Options.text('slug').pipe(Options.optional);
+const type_ = Options.choice('type', ['category', 'tag']).pipe(Options.optional);
+const icon = Options.text('icon').pipe(Options.optional);
+export const update = Command.make('update', { slugOrId, name, slug, type: type_, icon }, ({ slugOrId, name, slug, type, icon }) => Effect.gen(function* () {
+    const body = {};
+    const n = Option.getOrUndefined(name);
+    if (n)
+        body.name = n;
+    const s = Option.getOrUndefined(slug);
+    if (s)
+        body.slug = s;
+    const t = Option.getOrUndefined(type);
+    if (t)
+        body.type = t === 'tag' ? 1 : 0;
+    const ic = Option.getOrUndefined(icon);
+    if (ic)
+        body.icon = ic;
+    const api = yield* Api;
+    const renderer = yield* Renderer;
+    const resolver = yield* Resolver;
+    const id = yield* resolver.resolveCategoryId(slugOrId);
+    const res = yield* api.request(`/categories/${id}`, {
+        method: 'PATCH',
+        body,
+    });
+    yield* renderer.emitSuccess(res);
+}));

package/dist/src/cli/comment/_flags.d.ts

@@ -0,0 +1,28 @@
+import { Args, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { ValidationFailed } from '../../domain/errors';
+import type { CommentStateName } from '../../services/Comment';
+export declare const ids: Args.Args<string[]>;
+export declare const all: Options.Options<boolean>;
+export declare const force: Options.Options<boolean>;
+export declare const stateFilter: Options.Options<Option.Option<"unread" | "read" | "junk">>;
+export declare const unwrapOption: <A>(value: Option.Option<A>) => A | undefined;
+/**
+ * Shared invariants for ids/--all batch verbs (`approve`, `reject`, `delete`).
+ *
+ *   - exactly one of `ids` (>= 1) or `--all` MUST be supplied
+ *   - `--all` in a non-TTY context requires `--force`
+ *   - additional guards (e.g. single-id `delete`) are applied per-verb
+ */
+export declare const validateBatchSelection: (params: {
+    readonly verb: "approve" | "reject" | "delete";
+    readonly ids: ReadonlyArray<string>;
+    readonly all: boolean;
+    readonly force: boolean;
+}) => Effect.Effect<void, ValidationFailed>;
+export declare const requireForceForSingleDelete: (params: {
+    readonly ids: ReadonlyArray<string>;
+    readonly all: boolean;
+    readonly force: boolean;
+}) => Effect.Effect<void, ValidationFailed>;
+export type CurrentStateFilter = CommentStateName | undefined;

package/dist/src/cli/comment/_flags.js

@@ -0,0 +1,48 @@
+import { Args, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { ValidationFailed } from '../../domain/errors';
+export const ids = Args.text({ name: 'id' }).pipe(Args.repeated);
+export const all = Options.boolean('all').pipe(Options.withDescription('apply to every comment (optionally filtered by --state)'));
+export const force = Options.boolean('force').pipe(Options.withDescription('skip TTY confirmation guard'));
+export const stateFilter = Options.choice('state', [
+    'unread',
+    'read',
+    'junk',
+]).pipe(Options.optional);
+export const unwrapOption = (value) => Option.getOrUndefined(value);
+/**
+ * Shared invariants for ids/--all batch verbs (`approve`, `reject`, `delete`).
+ *
+ *   - exactly one of `ids` (>= 1) or `--all` MUST be supplied
+ *   - `--all` in a non-TTY context requires `--force`
+ *   - additional guards (e.g. single-id `delete`) are applied per-verb
+ */
+export const validateBatchSelection = (params) => Effect.suspend(() => {
+    if (params.all && params.ids.length > 0) {
+        return Effect.fail(new ValidationFailed({
+            message: '--all cannot be combined with explicit ids',
+        }));
+    }
+    if (!params.all && params.ids.length === 0) {
+        return Effect.fail(new ValidationFailed({
+            message: `${params.verb} requires at least one id or --all`,
+        }));
+    }
+    if (params.all && !params.force && !process.stdin.isTTY) {
+        return Effect.fail(new ValidationFailed({
+            message: `refusing to ${params.verb} --all without --force in non-TTY context`,
+        }));
+    }
+    return Effect.void;
+});
+export const requireForceForSingleDelete = (params) => Effect.suspend(() => {
+    if (params.all)
+        return Effect.void;
+    if (params.force)
+        return Effect.void;
+    if (process.stdin.isTTY)
+        return Effect.void;
+    return Effect.fail(new ValidationFailed({
+        message: 'refusing to delete without --force in non-TTY context',
+    }));
+});

package/dist/src/cli/comment/approve.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@effect/cli';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+export declare const approve: Command.Command<"approve", Renderer | Comment, import("../../services/Api").ApiError, {
+    readonly ids: string[];
+    readonly all: boolean;
+    readonly force: boolean;
+    readonly state: import("effect/Option").Option<"unread" | "read" | "junk">;
+}>;

package/dist/src/cli/comment/approve.js

@@ -0,0 +1,23 @@
+import { Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+import { all, force, ids, stateFilter, unwrapOption, validateBatchSelection, } from './_flags';
+export const approve = Command.make('approve', { ids, all, force, state: stateFilter }, ({ ids, all, force, state }) => Effect.gen(function* () {
+    yield* validateBatchSelection({ verb: 'approve', ids, all, force });
+    const comment = yield* Comment;
+    const renderer = yield* Renderer;
+    if (all) {
+        yield* comment.approveAll({
+            currentState: unwrapOption(state),
+        });
+        yield* renderer.emitSuccess({
+            approved: 'all',
+            filter: { currentState: unwrapOption(state) ?? null },
+        });
+    }
+    else {
+        yield* comment.approve(ids);
+        yield* renderer.emitSuccess({ approved: ids });
+    }
+})).pipe(Command.withDescription('mark comments as read; pass ids or --all [--state <s>]'));

package/dist/src/cli/comment/delete.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@effect/cli';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+export declare const del: Command.Command<"delete", Renderer | Comment, import("../../services/Api").ApiError, {
+    readonly ids: string[];
+    readonly all: boolean;
+    readonly force: boolean;
+    readonly state: import("effect/Option").Option<"unread" | "read" | "junk">;
+}>;

package/dist/src/cli/comment/delete.js

@@ -0,0 +1,24 @@
+import { Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+import { all, force, ids, requireForceForSingleDelete, stateFilter, unwrapOption, validateBatchSelection, } from './_flags';
+export const del = Command.make('delete', { ids, all, force, state: stateFilter }, ({ ids, all, force, state }) => Effect.gen(function* () {
+    yield* validateBatchSelection({ verb: 'delete', ids, all, force });
+    yield* requireForceForSingleDelete({ ids, all, force });
+    const comment = yield* Comment;
+    const renderer = yield* Renderer;
+    if (all) {
+        yield* comment.deleteAll({
+            currentState: unwrapOption(state),
+        });
+        yield* renderer.emitSuccess({
+            deleted: 'all',
+            filter: { currentState: unwrapOption(state) ?? null },
+        });
+    }
+    else {
+        yield* comment.delete(ids);
+        yield* renderer.emitSuccess({ deleted: ids });
+    }
+})).pipe(Command.withDescription('soft-delete comments; pass ids or --all [--state <s>]'));

package/dist/src/cli/comment/get.d.ts

@@ -0,0 +1,6 @@
+import { Command } from '@effect/cli';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+export declare const get: Command.Command<"get", Renderer | Comment, import("../../services/Api").ApiError, {
+    readonly id: string;
+}>;

package/dist/src/cli/comment/get.js

@@ -0,0 +1,12 @@
+import { Args, Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+import { commentView } from './view';
+const id = Args.text({ name: 'id' });
+export const get = Command.make('get', { id }, ({ id }) => Effect.gen(function* () {
+    const comment = yield* Comment;
+    const renderer = yield* Renderer;
+    const res = yield* comment.get(id);
+    yield* renderer.emit(commentView, res);
+})).pipe(Command.withDescription('show a single comment by id'));

package/dist/src/cli/comment/index.d.ts

@@ -0,0 +1,34 @@
+import { Command } from '@effect/cli';
+export declare const commentCmd: Command.Command<"comment", import("@effect/platform/Path").Path | import("@effect/platform/FileSystem").FileSystem | import("../ai/_poll").Renderer | import("../../services/Comment").Comment, import("../../services/Api").ApiError, {
+    readonly subcommand: import("effect/Option").Option<{
+        readonly ids: string[];
+        readonly all: boolean;
+        readonly force: boolean;
+        readonly state: import("effect/Option").Option<"unread" | "read" | "junk">;
+    } | {
+        readonly ids: string[];
+        readonly all: boolean;
+        readonly force: boolean;
+        readonly state: import("effect/Option").Option<"unread" | "read" | "junk">;
+    } | {
+        readonly id: string;
+    } | {
+        readonly page: import("effect/Option").Option<number>;
+        readonly size: import("effect/Option").Option<number>;
+        readonly state: import("effect/Option").Option<"unread" | "read" | "junk">;
+        readonly all: boolean;
+    } | {
+        readonly ids: string[];
+        readonly all: boolean;
+        readonly force: boolean;
+        readonly state: import("effect/Option").Option<"unread" | "read" | "junk">;
+    } | {
+        readonly id: string;
+        readonly text: import("effect/Option").Option<string>;
+        readonly whispers: boolean;
+        readonly silent: boolean;
+    } | {
+        readonly page: import("effect/Option").Option<number>;
+        readonly size: import("effect/Option").Option<number>;
+    }>;
+}>;

package/dist/src/cli/comment/index.js

@@ -0,0 +1,53 @@
+import { Command } from '@effect/cli';
+import { registerCommandHelp } from '../help/registry';
+import { approve } from './approve';
+import { del } from './delete';
+import { get } from './get';
+import { list } from './list';
+import { reject } from './reject';
+import { reply } from './reply';
+import { unread } from './unread';
+const help = registerCommandHelp({
+    name: 'comment',
+    description: 'list and moderate comments',
+    skillChapter: 'commands-comment',
+    verbs: [
+        {
+            name: 'list',
+            args: ['[--page <n>]', '[--size <n>]', '[--state <s>]', '[--all]'],
+            description: 'list comments (default state: unread; --all aggregates every state)',
+        },
+        {
+            name: 'unread',
+            args: ['[--page <n>]', '[--size <n>]'],
+            description: 'alias for `list --state unread`',
+        },
+        { name: 'get', args: ['<id>'], description: 'show a single comment' },
+        {
+            name: 'reply',
+            args: [
+                '<id>',
+                '--text <inline|file=<path>|->',
+                '[--whispers]',
+                '[--silent]',
+            ],
+            description: 'post an owner reply to a comment',
+        },
+        {
+            name: 'approve',
+            args: ['<id...>', '|', '--all', '[--state <s>]'],
+            description: 'mark comments as read',
+        },
+        {
+            name: 'reject',
+            args: ['<id...>', '|', '--all', '[--state <s>]'],
+            description: 'mark comments as junk',
+        },
+        {
+            name: 'delete',
+            args: ['<id...>', '|', '--all', '[--state <s>]', '[--force]'],
+            description: 'soft-delete comments',
+        },
+    ],
+});
+export const commentCmd = Command.make('comment').pipe(Command.withDescription(help.description), Command.withSubcommands([list, unread, get, reply, approve, reject, del]));

package/dist/src/cli/comment/list.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@effect/cli';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+export declare const list: Command.Command<"list", Renderer | Comment, import("../../services/Api").ApiError, {
+    readonly page: import("effect/Option").Option<number>;
+    readonly size: import("effect/Option").Option<number>;
+    readonly state: import("effect/Option").Option<"unread" | "read" | "junk">;
+    readonly all: boolean;
+}>;

package/dist/src/cli/comment/list.js

@@ -0,0 +1,20 @@
+import { Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+import { stateFilter, unwrapOption } from './_flags';
+import { commentListView } from './view';
+const page = Options.integer('page').pipe(Options.optional);
+const size = Options.integer('size').pipe(Options.optional);
+const allFlag = Options.boolean('all').pipe(Options.withDescription('list comments across every state (ignores --state)'));
+export const list = Command.make('list', { page, size, state: stateFilter, all: allFlag }, ({ page, size, state, all }) => Effect.gen(function* () {
+    const comment = yield* Comment;
+    const renderer = yield* Renderer;
+    const res = yield* comment.list({
+        page: unwrapOption(page),
+        size: unwrapOption(size),
+        state: unwrapOption(state),
+        all,
+    });
+    yield* renderer.emit(commentListView, res);
+})).pipe(Command.withDescription('list comments (default state: unread; use --all for every state)'));

package/dist/src/cli/comment/reject.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@effect/cli';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+export declare const reject: Command.Command<"reject", Renderer | Comment, import("../../services/Api").ApiError, {
+    readonly ids: string[];
+    readonly all: boolean;
+    readonly force: boolean;
+    readonly state: import("effect/Option").Option<"unread" | "read" | "junk">;
+}>;

package/dist/src/cli/comment/reject.js

@@ -0,0 +1,23 @@
+import { Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+import { all, force, ids, stateFilter, unwrapOption, validateBatchSelection, } from './_flags';
+export const reject = Command.make('reject', { ids, all, force, state: stateFilter }, ({ ids, all, force, state }) => Effect.gen(function* () {
+    yield* validateBatchSelection({ verb: 'reject', ids, all, force });
+    const comment = yield* Comment;
+    const renderer = yield* Renderer;
+    if (all) {
+        yield* comment.rejectAll({
+            currentState: unwrapOption(state),
+        });
+        yield* renderer.emitSuccess({
+            rejected: 'all',
+            filter: { currentState: unwrapOption(state) ?? null },
+        });
+    }
+    else {
+        yield* comment.reject(ids);
+        yield* renderer.emitSuccess({ rejected: ids });
+    }
+})).pipe(Command.withDescription('mark comments as junk; pass ids or --all [--state <s>]'));

package/dist/src/cli/comment/reply.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@effect/cli';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+export declare const reply: Command.Command<"reply", import("@effect/platform/Path").Path | import("@effect/platform/FileSystem").FileSystem | Renderer | Comment, import("../../services/Api").ApiError, {
+    readonly id: string;
+    readonly text: import("effect/Option").Option<string>;
+    readonly whispers: boolean;
+    readonly silent: boolean;
+}>;

package/dist/src/cli/comment/reply.js

@@ -0,0 +1,31 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { readContentSpec } from '../../domain/content-spec';
+import { ValidationFailed } from '../../domain/errors';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+import { unwrapOption } from './_flags';
+const id = Args.text({ name: 'id' });
+const text = Options.text('text').pipe(Options.withDescription('reply text — inline literal, `file=<path>`, or `-`/`stdin` to read stdin'), Options.optional);
+const whispers = Options.boolean('whispers').pipe(Options.withDescription('mark this reply as whispers (owner-only visible)'));
+const silent = Options.boolean('silent').pipe(Options.withDescription('on success, emit a minimal `ok` instead of the full server response'));
+export const reply = Command.make('reply', { id, text, whispers, silent }, ({ id, text, whispers, silent }) => Effect.gen(function* () {
+    const spec = unwrapOption(text);
+    if (spec === undefined) {
+        return yield* Effect.fail(new ValidationFailed({
+            message: 'reply requires --text (inline, `file=<path>`, or `-` for stdin)',
+        }));
+    }
+    const source = yield* readContentSpec(spec);
+    const body = source?.text.trim() ?? '';
+    if (body.length === 0) {
+        return yield* Effect.fail(new ValidationFailed({ message: 'reply text must not be empty' }));
+    }
+    const comment = yield* Comment;
+    const renderer = yield* Renderer;
+    const res = yield* comment.reply(id, {
+        text: body,
+        ...(whispers ? { isWhispers: true } : {}),
+    });
+    yield* renderer.emitSuccess(silent ? { ok: true } : res);
+})).pipe(Command.withDescription('post an owner reply to a comment; pass --text inline, --text file=<path>, or --text -'));

package/dist/src/cli/comment/unread.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@effect/cli';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+export declare const unread: Command.Command<"unread", Renderer | Comment, import("../../services/Api").ApiError, {
+    readonly page: import("effect/Option").Option<number>;
+    readonly size: import("effect/Option").Option<number>;
+}>;

package/dist/src/cli/comment/unread.js

@@ -0,0 +1,21 @@
+import { Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { Comment } from '../../services/Comment';
+import { Renderer } from '../../services/Renderer';
+import { unwrapOption } from './_flags';
+import { commentListView } from './view';
+// Convenience alias for `mxs comment list --state unread`. Accepts only the
+// paging knobs — state is fixed, and `--all` is intentionally omitted (would
+// defeat the purpose of the alias).
+const page = Options.integer('page').pipe(Options.optional);
+const size = Options.integer('size').pipe(Options.optional);
+export const unread = Command.make('unread', { page, size }, ({ page, size }) => Effect.gen(function* () {
+    const comment = yield* Comment;
+    const renderer = yield* Renderer;
+    const res = yield* comment.list({
+        page: unwrapOption(page),
+        size: unwrapOption(size),
+        state: 'unread',
+    });
+    yield* renderer.emit(commentListView, res);
+})).pipe(Command.withDescription('list unread comments (alias for `comment list --state unread`)'));

package/dist/src/cli/comment/view.d.ts

@@ -0,0 +1,3 @@
+import type { View } from '../../services/Renderer/view';
+export declare const commentView: View<unknown>;
+export declare const commentListView: View<unknown>;