@yhotamos/enja-cli 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 yhotta240
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# Enja CLI
+
+![NPM Version](https://img.shields.io/npm/v/%40yhotamos%2Fenja-cli)
+![NPM Downloads](https://img.shields.io/npm/dm/%40yhotamos%2Fenja-cli)
+![NPM License](https://img.shields.io/npm/l/%40yhotamos%2Fenja-cli)
+
+英語を日本語に翻訳するシンプルなコマンドラインツール
+
+## 特徴
+
+- インストール後すぐ使える（セットアップ不要）
+- Google Apps Script の LanguageApp を使用した軽量な翻訳
+- 引数，パイプ，ファイルから翻訳可能
+- HTML タグ除去機能で Web ページも翻訳可能
+- API キー不要，課金なし
+- カスタム翻訳エンドポイント対応
+- 翻訳履歴の保存・参照機能
+
+## インストール
+
+```bash
+npm install -g @yhotamos/enja-cli
+```
+
+## 使い方
+
+### 基本的な使い方
+
+```bash
+# 引数で渡された文字列を翻訳
+enja "Hello, world!"
+
+# パイプで翻訳
+echo "Hello, world!" | enja
+
+# ファイルから読み込み
+enja -f input.txt -o output.txt
+
+# 翻訳方向を逆にする (日本語 → 英語)
+enja "こんにちは" -F
+```
+
+### 履歴と設定
+
+```bash
+# 翻訳履歴を表示
+enja history
+
+# 設定を表示・変更
+enja config
+enja config endpoint https://api.example.com/translate
+```
+
+### 実用例
+
+```bash
+# エラーメッセージの翻訳
+npm install nonexistent-package 2>&1 | enja
+
+# Git コマンドのヘルプを日本語化
+git --help | enja
+
+# 英語のドキュメントを日本語に変換
+enja -f CONTRIBUTING.md -o CONTRIBUTING.ja.md
+
+# Webページの本文を翻訳（HTMLタグ除去）
+curl -s https://example.com | enja -s
+
+# APIドキュメントなどテキストコンテンツの翻訳
+curl -s https://example.com/api/docs | enja
+```
+
+## コマンド
+
+[COMMANDS.md](docs/COMMANDS.md) を参照してください．
+
+## セキュリティとプライバシー
+
+- 翻訳データは保存されません（リクエストごとに処理し，即座にレスポンス）
+- 他のユーザーの翻訳内容は見えません（完全にステートレス）
+- 機密情報の翻訳は避けてください（公開エンドポイントを使用しているため）
+
+## 制限事項
+
+- 1 日あたりのリクエスト数: すべてのユーザーで共有で約 5,000 リクエスト
+- 文字数制限: 1 リクエストあたり最大 100,000 文字
+
+制限に達した場合はエラーメッセージが表示されます．
+
+## 今後の予定
+
+- [ ] 複数言語対応
+- [ ] プロファイル機能（複数の設定を切り替え）
+- [ ] API キーの暗号化保存
+
+## 貢献
+
+バグ報告や機能リクエストは [GitHub Issues](https://github.com/yhotamos/enja-cli/issues) へお願いします．
+
+## 作者
+
+yhotta240
+
+- Email: yhotta240@gmail.com
+- GitHub: [@yhotta240](https://github.com/yhotta240)

package/dist/commands/config.js

@@ -0,0 +1,69 @@
+import { ConfigStorage } from '../services/config/storage.js';
+import kleur from 'kleur';
+/** 設定コマンドの実行 */
+export async function config(key, value, options) {
+    const storage = new ConfigStorage();
+    try {
+        // --reset: すべての設定をリセット
+        if (options?.reset) {
+            await storage.reset();
+            console.log(`${kleur.green('✔')} 設定をリセットしました`);
+            return;
+        }
+        // --unset: 指定したキーを削除（デフォルトに戻す）
+        if (options?.unset) {
+            await storage.unset(options.unset);
+            console.log(`${kleur.green('✔')} ${options.unset} をリセットしました`);
+            return;
+        }
+        // key と value が指定された場合: 設定を保存
+        if (key && value) {
+            await storage.set(key, value);
+            console.log(`${kleur.green('✔')} ${key} を設定しました`);
+            return;
+        }
+        // key のみ指定された場合: その設定値を表示
+        if (key && !value) {
+            const config = await storage.get();
+            if (key === 'endpoint') {
+                console.log(config.endpoint);
+            }
+            else if (key === 'api-key') {
+                console.log(config.apiKey ? maskApiKey(config.apiKey) : '(not set)');
+            }
+            else if (key === 'provider') {
+                console.log(config.provider);
+            }
+            else {
+                console.error(`error: 無効な設定キー (${key})`);
+                process.exit(1);
+            }
+            return;
+        }
+        // --list または引数なし: すべての設定を表示
+        const config = await storage.get();
+        console.log(`${kleur.blue('provider:')} ${config.provider}`);
+        console.log(`${kleur.blue('endpoint:')} ${config.endpoint}`);
+        console.log(`${kleur.blue('apiKey:')} ${config.apiKey ? maskApiKey(config.apiKey) : '(not set)'}`);
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(error.message);
+        }
+        else {
+            console.error(error);
+        }
+        process.exit(1);
+    }
+}
+// APIキーのマスキング表示
+function maskApiKey(apiKey) {
+    if (apiKey.length <= 8) {
+        return '*'.repeat(apiKey.length);
+    }
+    const visible = 4;
+    const start = apiKey.slice(0, visible);
+    const end = apiKey.slice(-visible);
+    const masked = '*'.repeat(apiKey.length - visible * 2);
+    return `${start}${masked}${end}`;
+}

package/dist/commands/history.js

@@ -0,0 +1,96 @@
+import { HistoryStorage } from '../services/history/storage.js';
+import { formatHistory } from '../services/history/formatter.js';
+import kleur from 'kleur';
+/** 履歴コマンドの実行 */
+export async function history(id, options) {
+    try {
+        const storage = new HistoryStorage();
+        // 特定IDの履歴表示
+        if (id) {
+            const trimmed = id.trim();
+            if (!trimmed) {
+                throw new Error(`空のIDが指定されました`);
+            }
+            // 完全IDらしければ完全一致で検索
+            if (trimmed.length >= 36) {
+                const entry = await storage.findById(trimmed);
+                if (!entry) {
+                    throw new Error(`指定されたIDの履歴が見つかりません (${id})`);
+                }
+                console.log(formatHistory([entry], options.detail));
+                return;
+            }
+            // 短縮IDは最低 8 文字を要求
+            if (trimmed.length < 8) {
+                throw new Error(`短縮IDは少なくとも8文字を指定してください (${trimmed.length})`);
+            }
+            // 短縮IDで先頭一致検索
+            const matches = await storage.findByShortId(trimmed);
+            if (matches.length === 0) {
+                throw new Error(`指定されたIDの履歴が見つかりません (${id})`);
+            }
+            // 複数マッチしても表示する
+            const output = formatHistory(matches, options.detail);
+            console.log(output);
+            return;
+        }
+        // 履歴削除
+        if (options.delete) {
+            const delId = options.delete.trim();
+            if (!delId) {
+                throw new Error(`空のIDが指定されました`);
+            }
+            // 完全IDらしければ直接削除を試みる
+            if (delId.length >= 36) {
+                const deleted = await storage.deleteById(delId);
+                if (deleted) {
+                    console.log(`${kleur.green('✔')} 履歴ID ${delId} を削除しました`);
+                }
+                else {
+                    throw new Error(`指定されたIDの履歴が見つかりません (${delId})`);
+                }
+                return;
+            }
+            // 短縮IDは最低 8 文字を要求
+            if (delId.length < 8) {
+                throw new Error(`短縮IDで削除する場合は少なくとも8文字を指定してください (${delId.length})`);
+            }
+            // 短縮IDで先頭一致検索（複数ヒットする可能性あり）
+            const matches = await storage.findByShortId(delId);
+            if (matches.length === 0) {
+                throw new Error(`指定されたIDの履歴が見つかりません (${delId})`);
+            }
+            if (matches.length > 1) {
+                console.error('error: 指定された短縮IDは複数の履歴に一致しました．完全なIDを指定してください．');
+                const output = formatHistory(matches, false);
+                console.error(output);
+                process.exit(1);
+            }
+            // 単一マッチなら削除
+            const targetId = matches[0].id;
+            const deleted = await storage.deleteById(targetId);
+            if (deleted) {
+                console.log(`${kleur.green('✔')} 履歴ID ${targetId} を削除しました`);
+            }
+            else {
+                throw new Error(`削除に失敗しました (${targetId})`);
+            }
+            return;
+        }
+        // 履歴クリア
+        if (options.clear) {
+            await storage.clear();
+            console.log(`${kleur.green('✔')} 履歴をクリアしました`);
+            return;
+        }
+        // 履歴表示
+        const limit = Number(options.number) || 10;
+        const entries = await storage.getRecent(limit);
+        const output = formatHistory(entries, options.detail);
+        console.log(output);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? `error: ${error.message}` : error);
+        process.exit(1);
+    }
+}

package/dist/commands/translate.js

@@ -0,0 +1,144 @@
+import * as fs from 'fs';
+import ora from 'ora';
+import { createTranslator } from '../services/translator/factory.js';
+import { HistoryStorage } from '../services/history/storage.js';
+import { hashText } from '../utils/hash.js';
+import kleur from 'kleur';
+export async function translate(text, options) {
+    try {
+        // 標準入力からの読み込み処理
+        if (!text && !options.file && !process.stdin.isTTY) {
+            const stdin = await readStdin();
+            await processTranslation(stdin, options, 'stdin');
+            return;
+        }
+        // ファイルからの読み込み処理
+        if (options.file) {
+            if (!fs.existsSync(options.file)) {
+                throw new Error(`error: ファイルが見つかりません (${options.file})`);
+            }
+            const fileContent = fs.readFileSync(options.file, 'utf-8');
+            await processTranslation(fileContent, options, 'file');
+            return;
+        }
+        // 引数で渡されたテキストの処理
+        if (text) {
+            await processTranslation(text, options, 'arg');
+            return;
+        }
+        console.error('error: 入力が提供されていません');
+        console.error('使い方: enja <テキスト> または enja -f <ファイル> または パイプ入力');
+        process.exit(1);
+    }
+    catch (error) {
+        console.error(error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+async function processTranslation(text, options, inputMethod) {
+    if (!text || text.trim().length === 0) {
+        throw new Error('error: 翻訳するテキストが空です');
+    }
+    // HTMLタグ除去
+    let processedText = text;
+    if (options.stripHtml) {
+        processedText = stripHtmlTags(text);
+        if (!processedText || processedText.trim().length === 0) {
+            throw new Error('error: HTMLタグを除去した結果、翻訳するテキストが空になりました');
+        }
+    }
+    // 翻訳サービスの初期化
+    const translator = await createTranslator(options);
+    const historyStorage = new HistoryStorage();
+    // 翻訳処理
+    const sourceLang = options.flip ? 'ja' : 'en';
+    const targetLang = options.flip ? 'en' : 'ja';
+    // キャッシュチェック
+    const textHash = hashText(processedText);
+    const cachedEntry = await historyStorage.findByHash(textHash, sourceLang, targetLang);
+    if (cachedEntry && options.cache !== false) {
+        console.log(`${kleur.green('✔')} キャッシュから翻訳結果を取得しました`);
+        const translated = cachedEntry.translatedText;
+        // 出力処理
+        if (options.output) {
+            try {
+                fs.writeFileSync(options.output, translated, 'utf-8');
+                console.log(`${kleur.green('✔')} ${options.output} に翻訳結果を保存しました`);
+            }
+            catch (error) {
+                throw new Error(`error: ファイルへの書き込みに失敗しました (${options.output})`);
+            }
+        }
+        else {
+            console.log(translated);
+        }
+        return;
+    }
+    const dir = `(${sourceLang} → ${targetLang})`;
+    const spinner = ora(`翻訳中... ${dir}`).start();
+    try {
+        const result = await translator.translate(processedText, sourceLang, targetLang);
+        const translated = result.text;
+        spinner.succeed(`翻訳完了 ${dir}`);
+        // 履歴に保存
+        await historyStorage.add({
+            sourceText: processedText,
+            translatedText: translated,
+            sourceLang,
+            targetLang,
+            textLength: processedText.length,
+            sourceHash: textHash,
+            options: {
+                stripHtml: options.stripHtml,
+                file: options.file,
+                inputMethod,
+            },
+        });
+        // 出力処理
+        if (options.output) {
+            try {
+                fs.writeFileSync(options.output, translated, 'utf-8');
+                console.log(`${kleur.green('✔')} ${options.output} に翻訳結果を保存しました`);
+            }
+            catch (error) {
+                throw new Error(`error: ファイルへの書き込みに失敗しました (${options.output})`);
+            }
+        }
+        else {
+            console.log(translated);
+        }
+    }
+    catch (error) {
+        spinner.fail(`翻訳失敗 ${dir}`);
+        throw error;
+    }
+}
+function readStdin() {
+    return new Promise((resolve, reject) => {
+        let data = '';
+        process.stdin.setEncoding('utf-8');
+        process.stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on('end', () => {
+            resolve(data);
+        });
+        process.stdin.on('error', (error) => {
+            reject(error);
+        });
+    });
+}
+function stripHtmlTags(html) {
+    return html
+        .replace(/<script\b[^<]*(?:(?!<\/script>)<[^<]*)*<\/script>/gi, '')
+        .replace(/<style\b[^<]*(?:(?!<\/style>)<[^<]*)*<\/style>/gi, '')
+        .replace(/<[^>]+>/g, '')
+        .replace(/&nbsp;/g, ' ')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/\n\s*\n/g, '\n')
+        .trim();
+}

package/dist/config/index.js

@@ -0,0 +1,22 @@
+import { ConfigStorage } from '../services/config/storage.js';
+const DEFAULT_GAS_API_URL = "https://script.google.com/macros/s/AKfycbxOSbKD0aBTaQqIzHv00BMzp6WwrtWHBU3gJY0vhB2HblgUO-cgesfT1l-rrfttnWZzew/exec";
+export async function getConfig(options) {
+    // 設定ファイルから読み込み
+    const storage = new ConfigStorage();
+    const fileConfig = await storage.get();
+    // 優先順位: コマンドラインオプション > 設定ファイル > デフォルト値
+    const endpoint = options?.endpoint ||
+        fileConfig.endpoint ||
+        DEFAULT_GAS_API_URL;
+    const apiKey = options?.apiKey ||
+        fileConfig.apiKey ||
+        undefined;
+    const provider = options?.provider ||
+        fileConfig.provider ||
+        'gas';
+    return {
+        endpoint,
+        provider,
+        apiKey,
+    };
+}

package/dist/index.js

@@ -0,0 +1,67 @@
+#!/usr/bin/env node
+import { readFileSync } from "fs";
+import { Command } from 'commander';
+import { translate } from "./commands/translate.js";
+import { history } from "./commands/history.js";
+import { config } from "./commands/config.js";
+const pkgJson = JSON.parse(readFileSync(new URL("../package.json", import.meta.url), "utf-8"));
+const program = new Command();
+program
+    .name('enja')
+    .usage('[arguments] [options]')
+    .description(`Description: ${pkgJson.description}`)
+    .version(pkgJson.version, '-v, --version', 'output the current version');
+// 翻訳コマンド (デフォルト)
+program
+    .argument('[text]', 'テキストを翻訳する')
+    .option('-f, --file <path>', 'ファイルを翻訳する')
+    .option('-o, --output <path>', 'ファイルに出力する (デフォルト: 標準出力)')
+    .option('-s, --strip-html', 'HTMLタグを除去してから翻訳する')
+    .option('-N, --no-cache', 'キャッシュを使用せずに再翻訳する')
+    .option('-F, --flip', '翻訳方向を逆にする (デフォルト: 英語→日本語)')
+    .option('--endpoint <url>', 'カスタム翻訳エンドポイントを指定')
+    .option('--api-key <key>', 'API キーを指定')
+    .option('--provider <name>', '翻訳プロバイダーを指定 (gas, custom)')
+    .showHelpAfterError()
+    .addHelpText('after', `\nExamples:
+  $ enja "Hello, world!"     # 引数で渡された文字列を翻訳
+  $ git --help | enja        # パイプ(標準入力)で渡されたテキストを翻訳
+  $ enja -f input.txt        # ファイルからテキストを読み込んで翻訳
+  $ enja -f input.txt -o output.txt  # ファイルから読み込み，翻訳結果をファイルに保存
+  $ cat README.md | enja -o japanese.md  # パイプとファイル出力の組み合わせ
+  $ curl -s https://example.com | enja -s  # HTMLタグを除去して翻訳
+  $ enja "Hello" --endpoint https://api.example.com/translate --api-key YOUR_KEY  # カスタムエンドポイント`)
+    .addHelpText('afterAll', `\nEnja CLI v${pkgJson.version}`)
+    .addHelpText('afterAll', 'Copyright (c) 2025 yhotta240')
+    .addHelpText('afterAll', 'GitHub: https://github.com/yhotamos/enja-cli')
+    .action(translate);
+// 履歴コマンド
+program
+    .command('history')
+    .description('翻訳履歴を表示する')
+    .argument('[id]', 'ID で履歴を表示する（完全 ID または短縮 ID）')
+    .option('-d, --detail', '詳細表示')
+    .option('-n, --number <number>', '表示件数 (デフォルト: 10)', '10')
+    .option('--delete <id>', '特定の履歴を削除する')
+    .option('--clear', '履歴をクリア')
+    .action(history);
+// 設定コマンド
+program
+    .command('config')
+    .description('設定を管理する')
+    .argument('[key]', '設定キー (endpoint, api-key, provider)')
+    .argument('[value]', '設定値')
+    .option('-l, --list', '設定を一覧表示')
+    .option('--unset <key>', '設定を削除（デフォルトに戻す）')
+    .option('--reset', 'すべての設定をリセット')
+    .addHelpText('after', `\nExamples:
+  $ enja config                           # すべての設定を表示
+  $ enja config --list                    # すべての設定を表示
+  $ enja config endpoint                  # endpoint の値を表示
+  $ enja config endpoint <URL>            # endpoint を設定
+  $ enja config api-key <KEY>             # API キーを設定
+  $ enja config provider gas              # プロバイダーを設定
+  $ enja config --unset api-key           # API キーを削除
+  $ enja config --reset                   # すべての設定をリセット`)
+    .action(config);
+program.parse();

package/dist/services/config/index.js

@@ -0,0 +1 @@
+export {};

package/dist/services/config/storage.js

@@ -0,0 +1,89 @@
+import * as fs from 'fs';
+import { getConfigFilePath, getConfigDir } from '../../utils/paths.js';
+const DEFAULT_CONFIG = {
+    provider: 'gas',
+    endpoint: 'https://script.google.com/macros/s/AKfycbxOSbKD0aBTaQqIzHv00BMzp6WwrtWHBU3gJY0vhB2HblgUO-cgesfT1l-rrfttnWZzew/exec',
+    apiKey: undefined,
+};
+/** 設定の永続化を管理するクラス */
+export class ConfigStorage {
+    filePath;
+    constructor() {
+        this.filePath = getConfigFilePath();
+    }
+    ensureConfigDir() {
+        const configDir = getConfigDir();
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+    }
+    async readConfig() {
+        try {
+            if (!fs.existsSync(this.filePath)) {
+                return { ...DEFAULT_CONFIG };
+            }
+            const data = fs.readFileSync(this.filePath, 'utf-8');
+            const config = JSON.parse(data);
+            return { ...DEFAULT_CONFIG, ...config };
+        }
+        catch (error) {
+            return { ...DEFAULT_CONFIG };
+        }
+    }
+    async writeConfig(config) {
+        try {
+            this.ensureConfigDir();
+            fs.writeFileSync(this.filePath, JSON.stringify(config, null, 2), 'utf-8');
+        }
+        catch (error) {
+            throw new Error(`error: 設定ファイルの書き込みに失敗しました`);
+        }
+    }
+    /** 設定を取得 */
+    async get() {
+        return await this.readConfig();
+    }
+    /** 設定を保存 */
+    async set(key, value) {
+        const config = await this.readConfig();
+        switch (key) {
+            case 'endpoint':
+                config.endpoint = value;
+                break;
+            case 'api-key':
+                config.apiKey = value;
+                break;
+            case 'provider':
+                if (value !== 'gas' && value !== 'custom') {
+                    throw new Error(`error: 無効なプロバイダー (${value}): gas または custom を指定してください`);
+                }
+                config.provider = value;
+                break;
+            default:
+                throw new Error(`error: 無効な設定キー (${key})`);
+        }
+        await this.writeConfig(config);
+    }
+    /** 指定したキーを削除（デフォルトに戻す） */
+    async unset(key) {
+        const config = await this.readConfig();
+        switch (key) {
+            case 'endpoint':
+                config.endpoint = DEFAULT_CONFIG.endpoint;
+                break;
+            case 'api-key':
+                config.apiKey = undefined;
+                break;
+            case 'provider':
+                config.provider = DEFAULT_CONFIG.provider;
+                break;
+            default:
+                throw new Error(`error: 無効な設定キー (${key})`);
+        }
+        await this.writeConfig(config);
+    }
+    /** 設定をリセット */
+    async reset() {
+        await this.writeConfig({ ...DEFAULT_CONFIG });
+    }
+}

package/dist/services/history/formatter.js

@@ -0,0 +1,61 @@
+import kleur from 'kleur';
+/** 履歴エントリをフォーマットして文字列として返す */
+export function formatHistory(entries, detailed = false) {
+    if (entries.length === 0) {
+        return '履歴はありません';
+    }
+    if (!detailed) {
+        return formatSimple(entries);
+    }
+    return formatDetailed(entries);
+}
+/** 簡易フォーマット */
+function formatSimple(entries) {
+    const lines = [];
+    lines.push(`全 ${entries.length} 件の履歴\n`);
+    entries.forEach((entry, index) => {
+        const date = new Date(entry.timestamp).toLocaleString('ja-JP');
+        const preview = entry.sourceText.length > 30
+            ? entry.sourceText.replace(/[\r\n]+/g, ' ').substring(0, 30) + '...'
+            : entry.sourceText;
+        lines.push(`${kleur.cyan('[' + (index + 1) + ']')} ${entry.id.substring(0, 8)} | ${date}`);
+        lines.push(`    ${entry.sourceLang} → ${entry.targetLang} | ${preview}`);
+        lines.push('');
+    });
+    return lines.join('\n');
+}
+/** 詳細フォーマット */
+function formatDetailed(entries) {
+    const lines = [];
+    lines.push(`全 ${entries.length} 件の履歴の詳細\n`);
+    entries.forEach((entry, index) => {
+        if (index > 0) {
+            lines.push('─'.repeat(60));
+        }
+        const date = new Date(entry.timestamp).toLocaleString('ja-JP');
+        lines.push(`${kleur.cyan('ID:')} ${entry.id}`);
+        lines.push(`${kleur.cyan('Date:')} ${date}`);
+        lines.push(`${kleur.cyan('Direction:')} ${entry.sourceLang} → ${entry.targetLang}`);
+        lines.push(`${kleur.cyan('Length:')} ${entry.textLength} characters`);
+        if (entry.options) {
+            const opts = [];
+            if (entry.options.inputMethod)
+                opts.push(`input=${entry.options.inputMethod}`);
+            if (entry.options.stripHtml)
+                opts.push('stripHtml=true');
+            if (entry.options.file)
+                opts.push(`file=${entry.options.file}`);
+            if (opts.length > 0) {
+                lines.push(`${kleur.cyan('Options:')} ${opts.join(', ')}`);
+            }
+        }
+        lines.push('');
+        lines.push(`${kleur.cyan('Input:')}`);
+        lines.push(entry.sourceText);
+        lines.push('');
+        lines.push(`${kleur.cyan('Output:')}`);
+        lines.push(entry.translatedText);
+        lines.push('');
+    });
+    return lines.join('\n');
+}

package/dist/services/history/index.js

@@ -0,0 +1 @@
+export {};

package/dist/services/history/storage.js

@@ -0,0 +1,104 @@
+import * as fs from 'fs';
+import { promises as fsp } from 'fs';
+import { randomUUID } from 'crypto';
+import { getHistoryFilePath, getConfigDir } from '../../utils/paths.js';
+const MAX_HISTORY_ENTRIES = 100;
+/** 履歴管理のためのストレージクラス */
+export class HistoryStorage {
+    filePath;
+    constructor() {
+        this.filePath = getHistoryFilePath();
+    }
+    /** 設定ディレクトリが存在しない場合は作成 */
+    ensureConfigDir() {
+        const configDir = getConfigDir();
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+    }
+    /** 履歴ファイルを読み込む */
+    async readHistory() {
+        try {
+            // ファイルが存在しない場合は空配列を返す
+            await fsp.access(this.filePath).catch(() => { throw new Error('NO_FILE'); });
+            const data = await fsp.readFile(this.filePath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch (error) {
+            // 読み取りや JSON パースに失敗した場合は安全に空配列を返す
+            return [];
+        }
+    }
+    /** 履歴ファイルに書き込む */
+    async writeHistory(entries) {
+        try {
+            this.ensureConfigDir();
+            // 一時ファイルに書き込み、リネームで原子性を確保
+            const tmpPath = `${this.filePath}.tmp`;
+            const data = JSON.stringify(entries, null, 2);
+            await fsp.writeFile(tmpPath, data, 'utf-8');
+            await fsp.rename(tmpPath, this.filePath);
+        }
+        catch (error) {
+            throw new Error(`error: 履歴ファイルの書き込みに失敗しました`);
+        }
+    }
+    /** 履歴にエントリを追加 */
+    async add(entry) {
+        const entries = await this.readHistory();
+        const newEntry = {
+            ...entry,
+            id: randomUUID(),
+            timestamp: new Date().toISOString(),
+        };
+        entries.unshift(newEntry);
+        // 最大エントリ数を超えた場合は古いエントリを削除
+        if (entries.length > MAX_HISTORY_ENTRIES) {
+            entries.splice(MAX_HISTORY_ENTRIES);
+        }
+        await this.writeHistory(entries);
+    }
+    /** すべての履歴を取得 */
+    async getAll() {
+        return await this.readHistory();
+    }
+    /** 最近の履歴を取得 */
+    async getRecent(limit) {
+        const entries = await this.readHistory();
+        return entries.slice(0, limit);
+    }
+    /** 履歴を削除 */
+    async deleteById(id) {
+        const entries = await this.readHistory();
+        const filteredEntries = entries.filter(entry => entry.id !== id);
+        // 変更がなければ書き込みを行わない
+        if (filteredEntries.length === entries.length)
+            return false;
+        await this.writeHistory(filteredEntries);
+        return true;
+    }
+    /** 履歴をクリア */
+    async clear() {
+        await this.writeHistory([]);
+    }
+    /** IDで履歴を検索 */
+    async findById(id) {
+        const entries = await this.readHistory();
+        return entries.find(entry => entry.id === id) || null;
+    }
+    /**
+     * 短縮IDで履歴を検索（先頭一致）
+     * 複数マッチする可能性があるため配列を返す
+     */
+    async findByShortId(id) {
+        const entries = await this.readHistory();
+        return entries.filter(entry => entry.id.startsWith(id));
+    }
+    /** ハッシュと翻訳方向で履歴を検索 */
+    async findByHash(hash, sourceLang, targetLang) {
+        const entries = await this.readHistory();
+        return entries.find(entry => entry.sourceHash === hash &&
+            entry.sourceLang === sourceLang &&
+            entry.targetLang === targetLang) || null;
+    }
+}

package/dist/services/translator/deepl.js

@@ -0,0 +1,25 @@
+import * as deepl from 'deepl-node';
+export class DeepLTranslator {
+    translator;
+    constructor(apiKey) {
+        this.translator = new deepl.Translator(apiKey);
+    }
+    async translate(text, sourceLang, targetLang) {
+        try {
+            const result = await this.translator.translateText(text, sourceLang, targetLang);
+            return {
+                text: result.text,
+                detectedSourceLang: result.detectedSourceLang,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw new Error(`DeepL translation failed: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+    async checkUsage() {
+        return await this.translator.getUsage();
+    }
+}

package/dist/services/translator/factory.js

@@ -0,0 +1,12 @@
+import { GASTranslator } from './gas.js';
+import { getConfig } from '../../config/index.js';
+export async function createTranslator(options) {
+    const config = await getConfig(options);
+    switch (config.provider) {
+        case 'gas':
+        case 'custom':
+            return new GASTranslator(config.endpoint, config.apiKey);
+        default:
+            throw new Error(`error: サポートされていないプロバイダー (${config.provider})`);
+    }
+}

package/dist/services/translator/gas.js

@@ -0,0 +1,44 @@
+export class GASTranslator {
+    apiUrl;
+    apiKey;
+    constructor(apiUrl, apiKey) {
+        this.apiUrl = apiUrl;
+        this.apiKey = apiKey;
+    }
+    async translate(text, sourceLang, targetLang) {
+        try {
+            const headers = {
+                'Content-Type': 'application/json',
+            };
+            if (this.apiKey) {
+                headers['Authorization'] = `Bearer ${this.apiKey}`;
+            }
+            const response = await fetch(this.apiUrl, {
+                method: 'POST',
+                headers,
+                body: JSON.stringify({
+                    text,
+                    sourceLang,
+                    targetLang,
+                }),
+            });
+            if (!response.ok) {
+                throw new Error(`error: HTTP ${response.status} ${response.statusText}`);
+            }
+            const data = await response.json();
+            if (data.code !== 200 || !data.translatedText) {
+                throw new Error(`error: ${data.error || '翻訳に失敗しました'}`);
+            }
+            return {
+                text: data.translatedText,
+                detectedSourceLang: data.detectedSourceLang,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                throw error;
+            }
+            throw new Error(`error: 翻訳に失敗しました`);
+        }
+    }
+}

package/dist/services/translator/index.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/hash.js

@@ -0,0 +1,5 @@
+import { createHash } from 'crypto';
+/** テキストの SHA-256 ハッシュを計算して返す */
+export function hashText(text) {
+    return createHash('sha256').update(text).digest('hex');
+}

package/dist/utils/paths.js

@@ -0,0 +1,23 @@
+import * as path from 'path';
+import * as os from 'os';
+/** OS の設定ディレクトリのパスを取得 */
+export function getConfigDir() {
+    const platform = process.platform;
+    if (platform === 'win32') {
+        const appData = process.env.APPDATA;
+        if (!appData) {
+            throw new Error('error: APPDATA 環境変数が設定されていません');
+        }
+        return path.join(appData, 'enja-cli');
+    }
+    const homeDir = os.homedir();
+    return path.join(homeDir, '.config', 'enja-cli');
+}
+/** 履歴ファイルのパスを取得 */
+export function getHistoryFilePath() {
+    return path.join(getConfigDir(), 'history.json');
+}
+/** 設定ファイルのパスを取得 */
+export function getConfigFilePath() {
+    return path.join(getConfigDir(), 'config.json');
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@yhotamos/enja-cli",
+  "version": "1.0.0",
+  "description": "英語を日本語に翻訳するシンプルなコマンドラインツール",
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "enja": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch"
+  },
+  "keywords": [
+    "translation",
+    "cli",
+    "english",
+    "japanese",
+    "enja"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "author": "yhotta240 <yhotta240@gmail.com> (https://github.com/yhotta240)",
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yhotamos/enja-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/yhotamos/enja-cli/issues"
+  },
+  "homepage": "https://github.com/yhotamos/enja-cli#readme",
+  "dependencies": {
+    "commander": "^14.0.2",
+    "kleur": "^4.1.5",
+    "ora": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3"
+  }
+}