@mx-space/cli 0.15.0 → 0.15.1

package/dist/src/cli/ai/insights/edit.js

@@ -0,0 +1,54 @@
+import { Args, Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { ValidationJson } from '../../../domain/errors';
+import { Ai } from '../../../services/Ai';
+import { Editor } from '../../../services/Editor';
+import { Renderer } from '../../../services/Renderer';
+const recordId = Args.text({ name: 'recordId' });
+const formatJson = (value) => `${JSON.stringify(value, null, 2)}\n`;
+const parseEnvelope = (raw) => {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('expected a JSON object');
+    }
+    const obj = parsed;
+    if (typeof obj.content !== 'string') {
+        throw new Error('expected `content` field of type string');
+    }
+    return { content: obj.content };
+};
+const unwrapDoc = (raw) => {
+    if (!raw || typeof raw !== 'object')
+        return {};
+    const r = raw;
+    if (r.data && typeof r.data === 'object' && !Array.isArray(r.data)) {
+        return r.data;
+    }
+    return r;
+};
+export const edit = Command.make('edit', { recordId }, ({ recordId }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const editor = yield* Editor;
+    const renderer = yield* Renderer;
+    const current = unwrapDoc(yield* ai.getInsights(recordId));
+    const initial = formatJson({
+        content: typeof current.content === 'string' ? current.content : '',
+    });
+    const next = yield* editor.openEditor({
+        filename: `ai-insights-${recordId}.json`,
+        initialContent: initial,
+    });
+    if (next.trim() === initial.trim()) {
+        yield* renderer.emitInfo('no changes');
+        return;
+    }
+    const parsed = yield* Effect.try({
+        try: () => parseEnvelope(next),
+        catch: (err) => new ValidationJson({
+            message: err instanceof Error ? err.message : String(err),
+            cause: err,
+        }),
+    });
+    const res = yield* ai.updateInsights(recordId, parsed);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('edit AI insights via $EDITOR'));

package/dist/src/cli/ai/insights/get.d.ts

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

package/dist/src/cli/ai/insights/get.js

@@ -0,0 +1,11 @@
+import { Args, Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+const recordId = Args.text({ name: 'recordId' });
+export const get = Command.make('get', { recordId }, ({ recordId }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const res = yield* ai.getInsights(recordId);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('get AI insights by record id'));

package/dist/src/cli/ai/insights/index.d.ts

@@ -0,0 +1,30 @@
+import { Command } from '@effect/cli';
+export declare const insightsCmd: Command.Command<"insights", import("../../../services/Ai").Ai | import("../_poll").Renderer | import("../../../services/Resolver").Resolver | import("../../../services/Editor").Editor, import("../../../domain/errors").ValidationJson | import("../../../domain/errors").AiTaskCreateFailed | import("../../../domain/errors").AiTaskFailed | import("../../../domain/errors").AiRecordNotFound | import("../../../services/Api").ApiError, {
+    readonly subcommand: import("effect/Option").Option<{
+        readonly id: string;
+        readonly lang: import("effect/Option").Option<string>;
+        readonly onlyDb: boolean;
+    } | {
+        readonly recordId: string;
+        readonly force: boolean;
+    } | {
+        readonly recordId: string;
+    } | {
+        readonly recordId: string;
+    } | {
+        readonly page: import("effect/Option").Option<number>;
+        readonly size: import("effect/Option").Option<number>;
+        readonly grouped: boolean;
+        readonly search: import("effect/Option").Option<string>;
+    } | {
+        readonly id: string;
+        readonly to: string[];
+        readonly force: boolean;
+        readonly noWait: boolean;
+    } | {
+        readonly id: string;
+        readonly to: string;
+        readonly force: boolean;
+        readonly noWait: boolean;
+    }>;
+}>;

package/dist/src/cli/ai/insights/index.js

@@ -0,0 +1,17 @@
+import { Command } from '@effect/cli';
+import { byArticle } from './by-article';
+import { del } from './delete';
+import { edit } from './edit';
+import { get } from './get';
+import { list } from './list';
+import { refresh } from './refresh';
+import { translate } from './translate';
+export const insightsCmd = Command.make('insights').pipe(Command.withDescription('manage AI insights'), Command.withSubcommands([
+    refresh,
+    translate,
+    list,
+    get,
+    byArticle,
+    edit,
+    del,
+]));

package/dist/src/cli/ai/insights/list.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+export declare const list: Command.Command<"list", Ai | Renderer, import("../../../services/Api").ApiError, {
+    readonly page: Option.Option<number>;
+    readonly size: Option.Option<number>;
+    readonly grouped: boolean;
+    readonly search: Option.Option<string>;
+}>;

package/dist/src/cli/ai/insights/list.js

@@ -0,0 +1,20 @@
+import { Command, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+const page = Options.integer('page').pipe(Options.optional);
+const size = Options.integer('size').pipe(Options.optional);
+const grouped = Options.boolean('grouped').pipe(Options.withDescription('group rows by article'));
+const search = Options.text('search').pipe(Options.optional, Options.withDescription('filter by article title (grouped mode)'));
+const unwrap = (value) => Option.getOrUndefined(value);
+export const list = Command.make('list', { page, size, grouped, search }, ({ page, size, grouped, search }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const res = yield* ai.listInsights({
+        page: unwrap(page),
+        size: unwrap(size),
+        grouped,
+        search: unwrap(search),
+    });
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('list AI insights'));

package/dist/src/cli/ai/insights/refresh.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+export declare const refresh: Command.Command<"refresh", Ai | Renderer | Resolver, import("../../../domain/errors").AiTaskCreateFailed | import("../../../domain/errors").AiTaskFailed | import("../../../services/Api").ApiError, {
+    readonly id: string;
+    readonly to: string[];
+    readonly force: boolean;
+    readonly noWait: boolean;
+}>;

package/dist/src/cli/ai/insights/refresh.js

@@ -0,0 +1,25 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+import { followTask } from '../_poll';
+import { resolveArticleId } from '../_resolve';
+import { aiTaskView } from '../views';
+const id = Args.text({ name: 'idOrSlug' });
+const to = Options.text('to').pipe(Options.repeated, Options.withDescription('language to translate the insights into once generated (repeatable)'));
+const force = Options.boolean('force').pipe(Options.withDescription('regenerate even when an up-to-date result exists'));
+const noWait = Options.boolean('no-wait').pipe(Options.withDescription('return immediately after creating the task'));
+export const refresh = Command.make('refresh', { id, to, force, noWait }, ({ id, to, force, noWait }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const resolver = yield* Resolver;
+    const refId = yield* resolveArticleId(resolver, id);
+    const created = yield* ai.refreshInsights({
+        refId,
+        targetLanguages: to.length ? to : undefined,
+        force,
+    });
+    const final = yield* followTask(ai, renderer, created, noWait);
+    yield* renderer.emit(aiTaskView, final);
+})).pipe(Command.withDescription('refresh AI insights for an article'));

package/dist/src/cli/ai/insights/translate.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+export declare const translate: Command.Command<"translate", Ai | Renderer | Resolver, import("../../../domain/errors").AiTaskCreateFailed | import("../../../domain/errors").AiTaskFailed | import("../../../services/Api").ApiError, {
+    readonly id: string;
+    readonly to: string;
+    readonly force: boolean;
+    readonly noWait: boolean;
+}>;

package/dist/src/cli/ai/insights/translate.js

@@ -0,0 +1,25 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+import { followTask } from '../_poll';
+import { resolveArticleId } from '../_resolve';
+import { aiTaskView } from '../views';
+const id = Args.text({ name: 'idOrSlug' });
+const to = Options.text('to').pipe(Options.withDescription('target language code (single)'));
+const force = Options.boolean('force').pipe(Options.withDescription('retranslate even when an up-to-date result exists'));
+const noWait = Options.boolean('no-wait').pipe(Options.withDescription('return immediately after creating the task'));
+export const translate = Command.make('translate', { id, to, force, noWait }, ({ id, to, force, noWait }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const resolver = yield* Resolver;
+    const refId = yield* resolveArticleId(resolver, id);
+    const created = yield* ai.translateInsights({
+        refId,
+        targetLang: to,
+        force,
+    });
+    const final = yield* followTask(ai, renderer, created, noWait);
+    yield* renderer.emit(aiTaskView, final);
+})).pipe(Command.withDescription('translate the existing AI insights into another language'));

package/dist/src/cli/ai/overview/by-article.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@effect/cli';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+export declare const byArticle: Command.Command<"by-article", Ai | Renderer | Resolver, import("../../../services/Api").ApiError, {
+    readonly id: string;
+}>;

package/dist/src/cli/ai/overview/by-article.js

@@ -0,0 +1,15 @@
+import { Args, Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+import { resolveArticleId } from '../_resolve';
+const id = Args.text({ name: 'idOrSlug' });
+export const byArticle = Command.make('by-article', { id }, ({ id }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const resolver = yield* Resolver;
+    const refId = yield* resolveArticleId(resolver, id);
+    const res = yield* ai.getOverviewByArticle(refId);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('show the AI artifact overview for one article'));

package/dist/src/cli/ai/overview/index.d.ts

@@ -0,0 +1,11 @@
+import { Command } from '@effect/cli';
+export declare const overviewCmd: Command.Command<"overview", import("../../../services/Ai").Ai | import("../_poll").Renderer | import("../../../services/Resolver").Resolver, import("../../../services/Api").ApiError, {
+    readonly subcommand: import("effect/Option").Option<{
+        readonly id: string;
+    } | {
+        readonly page: import("effect/Option").Option<number>;
+        readonly size: import("effect/Option").Option<number>;
+        readonly search: import("effect/Option").Option<string>;
+        readonly type: import("effect/Option").Option<"post" | "note" | "page">;
+    }>;
+}>;

package/dist/src/cli/ai/overview/index.js

@@ -0,0 +1,4 @@
+import { Command } from '@effect/cli';
+import { byArticle } from './by-article';
+import { list } from './list';
+export const overviewCmd = Command.make('overview').pipe(Command.withDescription('inspect the per-article AI overview board'), Command.withSubcommands([list, byArticle]));

package/dist/src/cli/ai/overview/list.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+export declare const list: Command.Command<"list", Ai | Renderer, import("../../../services/Api").ApiError, {
+    readonly page: Option.Option<number>;
+    readonly size: Option.Option<number>;
+    readonly search: Option.Option<string>;
+    readonly type: Option.Option<"post" | "note" | "page">;
+}>;

package/dist/src/cli/ai/overview/list.js

@@ -0,0 +1,20 @@
+import { Command, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+const page = Options.integer('page').pipe(Options.optional);
+const size = Options.integer('size').pipe(Options.optional);
+const search = Options.text('search').pipe(Options.optional, Options.withDescription('filter by article title'));
+const type = Options.choice('type', ['post', 'note', 'page']).pipe(Options.optional, Options.withDescription('filter by article type'));
+const unwrap = (value) => Option.getOrUndefined(value);
+export const list = Command.make('list', { page, size, search, type }, ({ page, size, search, type }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const res = yield* ai.listOverview({
+        page: unwrap(page),
+        size: unwrap(size),
+        search: unwrap(search),
+        type: unwrap(type),
+    });
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('list the per-article AI overview board (grouped)'));

package/dist/src/cli/ai/summary/by-article.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+export declare const byArticle: Command.Command<"by-article", Ai | Renderer | Resolver, import("../../../services/Api").ApiError, {
+    readonly id: string;
+    readonly lang: Option.Option<string>;
+    readonly onlyDb: boolean;
+}>;

package/dist/src/cli/ai/summary/by-article.js

@@ -0,0 +1,21 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+import { resolveArticleId } from '../_resolve';
+const id = Args.text({ name: 'idOrSlug' });
+const lang = Options.text('lang').pipe(Options.optional);
+const onlyDb = Options.boolean('only-db').pipe(Options.withDescription('do not auto-generate on miss'));
+const unwrap = (value) => Option.getOrUndefined(value);
+export const byArticle = Command.make('by-article', { id, lang, onlyDb }, ({ id, lang, onlyDb }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const resolver = yield* Resolver;
+    const refId = yield* resolveArticleId(resolver, id);
+    const res = yield* ai.getSummariesByArticle(refId, {
+        lang: unwrap(lang),
+        onlyDb,
+    });
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription("show an article's AI summary"));

package/dist/src/cli/ai/summary/delete.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@effect/cli';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+export declare const del: Command.Command<"delete", Ai | Renderer, import("../../../services/Api").ApiError, {
+    readonly recordId: string;
+    readonly force: boolean;
+}>;

package/dist/src/cli/ai/summary/delete.js

@@ -0,0 +1,18 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { ValidationFailed } from '../../../domain/errors';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+const recordId = Args.text({ name: 'recordId' });
+const force = Options.boolean('force').pipe(Options.withDescription('skip the non-TTY guard'));
+export const del = Command.make('delete', { recordId, force }, ({ recordId, force }) => Effect.gen(function* () {
+    if (!force && !process.stdin.isTTY) {
+        return yield* Effect.fail(new ValidationFailed({
+            message: 'refusing to delete without --force in non-TTY context',
+        }));
+    }
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    yield* ai.deleteSummary(recordId);
+    yield* renderer.emitSuccess({ deleted: recordId });
+})).pipe(Command.withDescription('delete an AI summary'));

package/dist/src/cli/ai/summary/edit.d.ts

@@ -0,0 +1,8 @@
+import { Command } from '@effect/cli';
+import { ValidationJson } from '../../../domain/errors';
+import { Ai } from '../../../services/Ai';
+import { Editor } from '../../../services/Editor';
+import { Renderer } from '../../../services/Renderer';
+export declare const edit: Command.Command<"edit", Ai | Renderer | Editor, ValidationJson | import("../../../domain/errors").AiRecordNotFound | import("../../../services/Api").ApiError, {
+    readonly recordId: string;
+}>;

package/dist/src/cli/ai/summary/edit.js

@@ -0,0 +1,54 @@
+import { Args, Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { ValidationJson } from '../../../domain/errors';
+import { Ai } from '../../../services/Ai';
+import { Editor } from '../../../services/Editor';
+import { Renderer } from '../../../services/Renderer';
+const recordId = Args.text({ name: 'recordId' });
+const formatJson = (value) => `${JSON.stringify(value, null, 2)}\n`;
+const parseEnvelope = (raw) => {
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error('expected a JSON object');
+    }
+    const obj = parsed;
+    if (typeof obj.summary !== 'string') {
+        throw new Error('expected `summary` field of type string');
+    }
+    return { summary: obj.summary };
+};
+const unwrapDoc = (raw) => {
+    if (!raw || typeof raw !== 'object')
+        return {};
+    const r = raw;
+    if (r.data && typeof r.data === 'object' && !Array.isArray(r.data)) {
+        return r.data;
+    }
+    return r;
+};
+export const edit = Command.make('edit', { recordId }, ({ recordId }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const editor = yield* Editor;
+    const renderer = yield* Renderer;
+    const current = unwrapDoc(yield* ai.getSummary(recordId));
+    const initial = formatJson({
+        summary: typeof current.summary === 'string' ? current.summary : '',
+    });
+    const next = yield* editor.openEditor({
+        filename: `ai-summary-${recordId}.json`,
+        initialContent: initial,
+    });
+    if (next.trim() === initial.trim()) {
+        yield* renderer.emitInfo('no changes');
+        return;
+    }
+    const parsed = yield* Effect.try({
+        try: () => parseEnvelope(next),
+        catch: (err) => new ValidationJson({
+            message: err instanceof Error ? err.message : String(err),
+            cause: err,
+        }),
+    });
+    const res = yield* ai.updateSummary(recordId, parsed);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('edit an AI summary via $EDITOR'));

package/dist/src/cli/ai/summary/get.d.ts

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

package/dist/src/cli/ai/summary/get.js

@@ -0,0 +1,11 @@
+import { Args, Command } from '@effect/cli';
+import { Effect } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+const recordId = Args.text({ name: 'recordId' });
+export const get = Command.make('get', { recordId }, ({ recordId }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const res = yield* ai.getSummary(recordId);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('get an AI summary by record id'));

package/dist/src/cli/ai/summary/index.d.ts

@@ -0,0 +1,30 @@
+import { Command } from '@effect/cli';
+export declare const summaryCmd: Command.Command<"summary", import("../../../services/Ai").Ai | import("../_poll").Renderer | import("../../../services/Resolver").Resolver | import("../../../services/Editor").Editor, import("../../../domain/errors").ValidationJson | import("../../../domain/errors").AiTaskCreateFailed | import("../../../domain/errors").AiTaskFailed | import("../../../domain/errors").AiRecordNotFound | import("../../../services/Api").ApiError, {
+    readonly subcommand: import("effect/Option").Option<{
+        readonly id: string;
+        readonly lang: import("effect/Option").Option<string>;
+        readonly onlyDb: boolean;
+    } | {
+        readonly recordId: string;
+        readonly force: boolean;
+    } | {
+        readonly recordId: string;
+    } | {
+        readonly recordId: string;
+    } | {
+        readonly page: import("effect/Option").Option<number>;
+        readonly size: import("effect/Option").Option<number>;
+        readonly grouped: boolean;
+        readonly search: import("effect/Option").Option<string>;
+    } | {
+        readonly id: string;
+        readonly to: string[];
+        readonly force: boolean;
+        readonly noWait: boolean;
+    } | {
+        readonly id: string;
+        readonly to: string;
+        readonly force: boolean;
+        readonly noWait: boolean;
+    }>;
+}>;

package/dist/src/cli/ai/summary/index.js

@@ -0,0 +1,9 @@
+import { Command } from '@effect/cli';
+import { byArticle } from './by-article';
+import { del } from './delete';
+import { edit } from './edit';
+import { get } from './get';
+import { list } from './list';
+import { regen } from './regen';
+import { translate } from './translate';
+export const summaryCmd = Command.make('summary').pipe(Command.withDescription('manage AI summaries'), Command.withSubcommands([regen, translate, list, get, byArticle, edit, del]));

package/dist/src/cli/ai/summary/list.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+export declare const list: Command.Command<"list", Ai | Renderer, import("../../../services/Api").ApiError, {
+    readonly page: Option.Option<number>;
+    readonly size: Option.Option<number>;
+    readonly grouped: boolean;
+    readonly search: Option.Option<string>;
+}>;

package/dist/src/cli/ai/summary/list.js

@@ -0,0 +1,20 @@
+import { Command, Options } from '@effect/cli';
+import { Effect, Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+const page = Options.integer('page').pipe(Options.optional);
+const size = Options.integer('size').pipe(Options.optional);
+const grouped = Options.boolean('grouped').pipe(Options.withDescription('group rows by article'));
+const search = Options.text('search').pipe(Options.optional, Options.withDescription('filter by article title (grouped mode)'));
+const unwrap = (value) => Option.getOrUndefined(value);
+export const list = Command.make('list', { page, size, grouped, search }, ({ page, size, grouped, search }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const res = yield* ai.listSummaries({
+        page: unwrap(page),
+        size: unwrap(size),
+        grouped,
+        search: unwrap(search),
+    });
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('list AI summaries'));

package/dist/src/cli/ai/summary/regen.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+export declare const regen: Command.Command<"regen", Ai | Renderer | Resolver, import("../../../domain/errors").AiTaskCreateFailed | import("../../../domain/errors").AiTaskFailed | import("../../../services/Api").ApiError, {
+    readonly id: string;
+    readonly to: string[];
+    readonly force: boolean;
+    readonly noWait: boolean;
+}>;

package/dist/src/cli/ai/summary/regen.js

@@ -0,0 +1,25 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+import { followTask } from '../_poll';
+import { resolveArticleId } from '../_resolve';
+import { aiTaskView } from '../views';
+const id = Args.text({ name: 'idOrSlug' });
+const to = Options.text('to').pipe(Options.repeated, Options.withDescription('target language code (repeatable)'));
+const force = Options.boolean('force').pipe(Options.withDescription('regenerate even when an up-to-date result exists'));
+const noWait = Options.boolean('no-wait').pipe(Options.withDescription('return immediately after creating the task'));
+export const regen = Command.make('regen', { id, to, force, noWait }, ({ id, to, force, noWait }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const resolver = yield* Resolver;
+    const refId = yield* resolveArticleId(resolver, id);
+    const created = yield* ai.regenSummary({
+        refId,
+        targetLanguages: to.length ? to : undefined,
+        force,
+    });
+    const final = yield* followTask(ai, renderer, created, noWait);
+    yield* renderer.emit(aiTaskView, final);
+})).pipe(Command.withDescription('regenerate the AI summary for an article'));

package/dist/src/cli/ai/summary/translate.d.ts

@@ -0,0 +1,10 @@
+import { Command } from '@effect/cli';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+export declare const translate: Command.Command<"translate", Ai | Renderer | Resolver, import("../../../domain/errors").AiTaskCreateFailed | import("../../../domain/errors").AiTaskFailed | import("../../../services/Api").ApiError, {
+    readonly id: string;
+    readonly to: string;
+    readonly force: boolean;
+    readonly noWait: boolean;
+}>;

package/dist/src/cli/ai/summary/translate.js

@@ -0,0 +1,25 @@
+import { Args, Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+import { followTask } from '../_poll';
+import { resolveArticleId } from '../_resolve';
+import { aiTaskView } from '../views';
+const id = Args.text({ name: 'idOrSlug' });
+const to = Options.text('to').pipe(Options.withDescription('target language code (single)'));
+const force = Options.boolean('force').pipe(Options.withDescription('retranslate even when an up-to-date result exists'));
+const noWait = Options.boolean('no-wait').pipe(Options.withDescription('return immediately after creating the task'));
+export const translate = Command.make('translate', { id, to, force, noWait }, ({ id, to, force, noWait }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const resolver = yield* Resolver;
+    const refId = yield* resolveArticleId(resolver, id);
+    const created = yield* ai.translateSummary({
+        refId,
+        targetLang: to,
+        force,
+    });
+    const final = yield* followTask(ai, renderer, created, noWait);
+    yield* renderer.emit(aiTaskView, final);
+})).pipe(Command.withDescription('translate the existing AI summary into another language'));

package/dist/src/cli/ai/translate/by-article.d.ts

@@ -0,0 +1,9 @@
+import { Command } from '@effect/cli';
+import { Option } from 'effect';
+import { Ai } from '../../../services/Ai';
+import { Renderer } from '../../../services/Renderer';
+import { Resolver } from '../../../services/Resolver';
+export declare const byArticle: Command.Command<"by-article", Ai | Renderer | Resolver, import("../../../services/Api").ApiError, {
+    readonly id: string;
+    readonly lang: Option.Option<string>;
+}>;