@mx-space/cli 0.14.2 → 0.15.1

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

@@ -0,0 +1,19 @@
+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 unwrap = (value) => Option.getOrUndefined(value);
+export const byArticle = Command.make('by-article', { id, lang }, ({ id, lang }) => 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.getTranslationsByArticle(refId, {
+        lang: unwrap(lang),
+    });
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription("show an article's translations"));

package/dist/src/cli/ai/translate/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/translate/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.deleteTranslation(recordId);
+    yield* renderer.emitSuccess({ deleted: recordId });
+})).pipe(Command.withDescription('delete an AI translation'));

package/dist/src/cli/ai/translate/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/translate/edit.js

@@ -0,0 +1,97 @@
+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 PATCH_KEYS = [
+    'title',
+    'text',
+    'subtitle',
+    'summary',
+    'tags',
+    'content',
+];
+const editableFieldsOf = (doc) => {
+    const out = {};
+    for (const key of PATCH_KEYS) {
+        if (doc[key] !== undefined)
+            out[key] = doc[key];
+    }
+    return out;
+};
+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;
+    const patch = {};
+    if ('title' in obj) {
+        if (typeof obj.title !== 'string')
+            throw new Error('title must be a string');
+        patch.title = obj.title;
+    }
+    if ('text' in obj) {
+        if (typeof obj.text !== 'string')
+            throw new Error('text must be a string');
+        patch.text = obj.text;
+    }
+    if ('subtitle' in obj) {
+        if (obj.subtitle !== null && typeof obj.subtitle !== 'string')
+            throw new Error('subtitle must be a string or null');
+        patch.subtitle = obj.subtitle;
+    }
+    if ('summary' in obj) {
+        if (typeof obj.summary !== 'string')
+            throw new Error('summary must be a string');
+        patch.summary = obj.summary;
+    }
+    if ('tags' in obj) {
+        if (!Array.isArray(obj.tags) ||
+            !obj.tags.every((t) => typeof t === 'string'))
+            throw new Error('tags must be an array of strings');
+        patch.tags = obj.tags;
+    }
+    if ('content' in obj) {
+        if (typeof obj.content !== 'string')
+            throw new Error('content must be a string');
+        patch.content = obj.content;
+    }
+    return patch;
+};
+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.getTranslation(recordId));
+    const initial = formatJson(editableFieldsOf(current));
+    const next = yield* editor.openEditor({
+        filename: `ai-translation-${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.updateTranslation(recordId, parsed);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('edit an AI translation via $EDITOR'));

package/dist/src/cli/ai/translate/entries/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/translate/entries/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.deleteEntry(recordId);
+    yield* renderer.emitSuccess({ deleted: recordId });
+})).pipe(Command.withDescription('delete a translation entry'));

package/dist/src/cli/ai/translate/entries/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("../../../../services/Api").ApiError, {
+    readonly recordId: string;
+}>;

package/dist/src/cli/ai/translate/entries/edit.js

@@ -0,0 +1,73 @@
+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.translatedText !== 'string' || !obj.translatedText) {
+        throw new Error('expected non-empty `translatedText` string');
+    }
+    return { translatedText: obj.translatedText };
+};
+const asRows = (raw) => {
+    if (Array.isArray(raw))
+        return raw.filter((r) => !!r && typeof r === 'object');
+    if (raw && typeof raw === 'object') {
+        const data = raw.data;
+        if (Array.isArray(data))
+            return data.filter((r) => !!r && typeof r === 'object');
+    }
+    return [];
+};
+const fetchEntry = (ai, id) => Effect.gen(function* () {
+    const MAX = 20;
+    for (let page = 1; page <= MAX; page++) {
+        const raw = yield* ai
+            .listEntries({ page, size: 50 })
+            .pipe(Effect.catchAll(() => Effect.succeed(null)));
+        if (!raw)
+            return null;
+        const rows = asRows(raw);
+        for (const row of rows) {
+            if (row.id === id)
+                return row;
+        }
+        if (rows.length < 50)
+            break;
+    }
+    return null;
+});
+export const edit = Command.make('edit', { recordId }, ({ recordId }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const editor = yield* Editor;
+    const renderer = yield* Renderer;
+    const found = yield* fetchEntry(ai, recordId);
+    const initial = formatJson({
+        translatedText: typeof found?.translatedText === 'string' ? found.translatedText : '',
+    });
+    const next = yield* editor.openEditor({
+        filename: `ai-entry-${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.updateEntry(recordId, parsed);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('edit a translation entry via $EDITOR'));

package/dist/src/cli/ai/translate/entries/generate.d.ts

@@ -0,0 +1,7 @@
+import { Command } from '@effect/cli';
+import { Ai } from '../../../../services/Ai';
+import { Renderer } from '../../../../services/Renderer';
+export declare const generate: Command.Command<"generate", Ai | Renderer, import("../../../../services/Api").ApiError, {
+    readonly keyPath: string[];
+    readonly to: string[];
+}>;

package/dist/src/cli/ai/translate/entries/generate.js

@@ -0,0 +1,15 @@
+import { Command, Options } from '@effect/cli';
+import { Effect } from 'effect';
+import { Ai } from '../../../../services/Ai';
+import { Renderer } from '../../../../services/Renderer';
+const keyPath = Options.text('key-path').pipe(Options.repeated, Options.withDescription('restrict to a server-validated key path (repeatable). Allowed: category.name, topic.name, topic.introduce, topic.description, note.mood, note.weather'));
+const to = Options.text('to').pipe(Options.repeated, Options.withDescription('target language code (repeatable)'));
+export const generate = Command.make('generate', { keyPath, to }, ({ keyPath, to }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const res = yield* ai.generateEntries({
+        keyPaths: keyPath.length ? keyPath : undefined,
+        targetLangs: to.length ? to : undefined,
+    });
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('regenerate translation entries'));

package/dist/src/cli/ai/translate/entries/index.d.ts

@@ -0,0 +1,17 @@
+import { Command } from '@effect/cli';
+export declare const entriesCmd: Command.Command<"entries", import("../../../../services/Ai").Ai | import("../../_poll").Renderer | import("../../../../services/Editor").Editor, import("../../../../domain/errors").ValidationJson | import("../../../../services/Api").ApiError, {
+    readonly subcommand: import("effect/Option").Option<{
+        readonly recordId: string;
+        readonly force: boolean;
+    } | {
+        readonly recordId: string;
+    } | {
+        readonly keyPath: string[];
+        readonly to: string[];
+    } | {
+        readonly page: import("effect/Option").Option<number>;
+        readonly size: import("effect/Option").Option<number>;
+        readonly keyPath: import("effect/Option").Option<string>;
+        readonly lang: import("effect/Option").Option<string>;
+    }>;
+}>;

package/dist/src/cli/ai/translate/entries/index.js

@@ -0,0 +1,6 @@
+import { Command } from '@effect/cli';
+import { del } from './delete';
+import { edit } from './edit';
+import { generate } from './generate';
+import { list } from './list';
+export const entriesCmd = Command.make('entries').pipe(Command.withDescription('manage translation entries (i18n dictionary)'), Command.withSubcommands([list, generate, edit, del]));

package/dist/src/cli/ai/translate/entries/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 keyPath: Option.Option<string>;
+    readonly lang: Option.Option<string>;
+}>;

package/dist/src/cli/ai/translate/entries/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 keyPath = Options.text('key-path').pipe(Options.optional);
+const lang = Options.text('lang').pipe(Options.optional);
+const unwrap = (value) => Option.getOrUndefined(value);
+export const list = Command.make('list', { page, size, keyPath, lang }, ({ page, size, keyPath, lang }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const res = yield* ai.listEntries({
+        page: unwrap(page),
+        size: unwrap(size),
+        keyPath: unwrap(keyPath),
+        lang: unwrap(lang),
+    });
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('list AI translation entries (i18n dictionary)'));

package/dist/src/cli/ai/translate/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/translate/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.getTranslation(recordId);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('get an AI translation by record id'));

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

@@ -0,0 +1,40 @@
+import { Command } from '@effect/cli';
+export declare const translateCmd: Command.Command<"translate", 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 recordId: string;
+        readonly force: boolean;
+    } | {
+        readonly recordId: string;
+    } | {
+        readonly subcommand: import("effect/Option").Option<{
+            readonly recordId: string;
+            readonly force: boolean;
+        } | {
+            readonly recordId: string;
+        } | {
+            readonly keyPath: string[];
+            readonly to: string[];
+        } | {
+            readonly page: import("effect/Option").Option<number>;
+            readonly size: import("effect/Option").Option<number>;
+            readonly keyPath: import("effect/Option").Option<string>;
+            readonly lang: import("effect/Option").Option<string>;
+        }>;
+    } | {
+        readonly recordId: string;
+    } | {
+        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 id: string;
+        readonly to: string[];
+        readonly force: boolean;
+        readonly noWait: boolean;
+    }>;
+}>;

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

@@ -0,0 +1,19 @@
+import { Command } from '@effect/cli';
+import { byArticle } from './by-article';
+import { del } from './delete';
+import { edit } from './edit';
+import { entriesCmd } from './entries';
+import { get } from './get';
+import { languages } from './languages';
+import { list } from './list';
+import { run } from './run';
+export const translateCmd = Command.make('translate').pipe(Command.withDescription('manage AI translations'), Command.withSubcommands([
+    run,
+    list,
+    get,
+    byArticle,
+    languages,
+    edit,
+    del,
+    entriesCmd,
+]));

package/dist/src/cli/ai/translate/languages.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 languages: Command.Command<"languages", Ai | Renderer | Resolver, import("../../../services/Api").ApiError, {
+    readonly id: string;
+}>;

package/dist/src/cli/ai/translate/languages.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 languages = Command.make('languages', { 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.getTranslationLanguages(refId);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('list languages an article has been translated into'));

package/dist/src/cli/ai/translate/list.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';
+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>;
+}>;

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

@@ -0,0 +1,19 @@
+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 unwrap = (value) => Option.getOrUndefined(value);
+export const list = Command.make('list', { page, size, search }, ({ page, size, search }) => Effect.gen(function* () {
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const res = yield* ai.listTranslations({
+        page: unwrap(page),
+        size: unwrap(size),
+        grouped: true,
+        search: unwrap(search),
+    });
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription('list AI translations (grouped by article)'));

package/dist/src/cli/ai/translate/run.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 run: Command.Command<"run", 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/translate/run.js

@@ -0,0 +1,31 @@
+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';
+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, at least one)'));
+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 run = Command.make('run', { id, to, force, noWait }, ({ id, to, force, noWait }) => Effect.gen(function* () {
+    if (!to.length) {
+        return yield* Effect.fail(new ValidationFailed({
+            message: 'at least one --to <lang> is required',
+        }));
+    }
+    const ai = yield* Ai;
+    const renderer = yield* Renderer;
+    const resolver = yield* Resolver;
+    const refId = yield* resolveArticleId(resolver, id);
+    const created = yield* ai.translate({
+        refId,
+        targetLanguages: to,
+        force,
+    });
+    const final = yield* followTask(ai, renderer, created, noWait);
+    yield* renderer.emit(aiTaskView, final);
+})).pipe(Command.withDescription('translate an article into one or more languages'));

package/dist/src/cli/ai/tts/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/tts/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.getTtsByArticle(refId);
+    yield* renderer.emitSuccess(res);
+})).pipe(Command.withDescription("show an article's AI narrations (all rows)"));

package/dist/src/cli/ai/tts/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/tts/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.deleteTts(recordId);
+    yield* renderer.emitSuccess({ deleted: recordId });
+})).pipe(Command.withDescription('delete an AI narration record'));

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

@@ -0,0 +1,22 @@
+import { Command } from '@effect/cli';
+export declare const ttsCmd: Command.Command<"tts", import("../../../services/Ai").Ai | import("../_poll").Renderer | import("../../../services/Resolver").Resolver, import("../../../domain/errors").AiTaskCreateFailed | import("../../../domain/errors").AiTaskFailed | import("../../../services/Api").ApiError, {
+    readonly subcommand: import("effect/Option").Option<{
+        readonly id: string;
+    } | {
+        readonly recordId: string;
+        readonly force: boolean;
+    } | {
+        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 provider: string;
+        readonly model: string;
+    }>;
+}>;

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

@@ -0,0 +1,7 @@
+import { Command } from '@effect/cli';
+import { byArticle } from './by-article';
+import { del } from './delete';
+import { list } from './list';
+import { run } from './run';
+import { voices } from './voices';
+export const ttsCmd = Command.make('tts').pipe(Command.withDescription('manage AI narrations (text-to-speech)'), Command.withSubcommands([run, list, byArticle, voices, del]));

package/dist/src/cli/ai/tts/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>;
+}>;