@nahisaho/katashiro-core 0.2.2 → 0.2.4

package/dist/errors/ErrorCodes.d.ts

@@ -0,0 +1,99 @@
+/**
+ * エラーコード定数
+ *
+ * @design DES-COMMON-001 §4
+ * @task TASK-000
+ */
+/**
+ * 共通エラーコード定数
+ *
+ * 形式: {MODULE}_{CATEGORY}_{NUMBER}
+ * - MODULE: モジュール識別子 (COR, COL, ANA, MED, GEN, KNW)
+ * - CATEGORY: カテゴリ (VAL, AUT, PRM, NTF, CNF, NET, TMO, SEC, SYS, EXT)
+ * - NUMBER: 連番 (001-999)
+ */
+export declare const ErrorCodes: {
+    /** パラメータが無効 */
+    readonly INVALID_PARAMETER: "COR_VAL_001";
+    /** 必須パラメータが欠落 */
+    readonly MISSING_REQUIRED: "COR_VAL_002";
+    /** 型が不一致 */
+    readonly TYPE_MISMATCH: "COR_VAL_003";
+    /** 内部エラー */
+    readonly INTERNAL_ERROR: "COR_SYS_001";
+    /** 未実装機能 */
+    readonly NOT_IMPLEMENTED: "COR_SYS_002";
+    /** 接続失敗 */
+    readonly CONNECTION_FAILED: "COR_NET_001";
+    /** 操作タイムアウト */
+    readonly OPERATION_TIMEOUT: "COR_TMO_001";
+    /** ファイルが見つからない */
+    readonly FILE_NOT_FOUND: "COL_NTF_001";
+    /** 未対応のファイル形式 */
+    readonly UNSUPPORTED_FORMAT: "COL_VAL_001";
+    /** ファイルが破損 */
+    readonly CORRUPTED_FILE: "COL_VAL_002";
+    /** パスワード保護 */
+    readonly PASSWORD_PROTECTED: "COL_SEC_001";
+    /** スクレイピング失敗 */
+    readonly SCRAPE_FAILED: "COL_NET_001";
+    /** レート制限 */
+    readonly RATE_LIMITED: "COL_NET_002";
+    /** リサーチタイムアウト */
+    readonly RESEARCH_TIMEOUT: "COL_TMO_001";
+    /** 検索APIエラー */
+    readonly SEARCH_API_ERROR: "COL_EXT_001";
+    /** コードが無効 */
+    readonly INVALID_CODE: "ANA_VAL_001";
+    /** ブロックされたモジュール */
+    readonly BLOCKED_MODULE: "ANA_VAL_002";
+    /** サンドボックス違反 */
+    readonly SANDBOX_VIOLATION: "ANA_SEC_001";
+    /** 権限拒否 */
+    readonly PERMISSION_DENIED: "ANA_SEC_002";
+    /** 実行タイムアウト */
+    readonly EXECUTION_TIMEOUT: "ANA_TMO_001";
+    /** メモリ超過 */
+    readonly MEMORY_EXCEEDED: "ANA_SYS_001";
+    /** 収束失敗 */
+    readonly CONVERGENCE_FAILED: "ANA_SYS_002";
+    /** LLM APIエラー */
+    readonly LLM_API_ERROR: "ANA_EXT_001";
+    /** プロンプトが無効 */
+    readonly INVALID_PROMPT: "MED_VAL_001";
+    /** コンテンツポリシー違反 */
+    readonly CONTENT_POLICY_VIOLATION: "MED_VAL_002";
+    /** 未対応の音声形式 */
+    readonly UNSUPPORTED_AUDIO_FORMAT: "MED_VAL_003";
+    /** 未対応の画像形式 */
+    readonly UNSUPPORTED_IMAGE_FORMAT: "MED_VAL_004";
+    /** 生成失敗 */
+    readonly GENERATION_FAILED: "MED_NET_001";
+    /** 生成タイムアウト */
+    readonly GENERATION_TIMEOUT: "MED_TMO_001";
+    /** プロバイダーエラー */
+    readonly PROVIDER_ERROR: "MED_EXT_001";
+    /** クォータ超過 */
+    readonly QUOTA_EXCEEDED: "MED_EXT_002";
+    /** テンプレートエラー */
+    readonly TEMPLATE_ERROR: "GEN_VAL_001";
+    /** レンダリング失敗 */
+    readonly RENDER_FAILED: "GEN_SYS_001";
+    /** ノードが見つからない */
+    readonly NODE_NOT_FOUND: "KNW_NTF_001";
+    /** エッジが見つからない */
+    readonly EDGE_NOT_FOUND: "KNW_NTF_002";
+    /** 永続化失敗 */
+    readonly PERSISTENCE_FAILED: "KNW_SYS_001";
+    /** クエリエラー */
+    readonly QUERY_ERROR: "KNW_VAL_001";
+};
+/**
+ * エラーコードキー型
+ */
+export type ErrorCodeKey = keyof typeof ErrorCodes;
+/**
+ * エラーコード値型
+ */
+export type ErrorCodeValue = (typeof ErrorCodes)[ErrorCodeKey];
+//# sourceMappingURL=ErrorCodes.d.ts.map

package/dist/errors/ErrorCodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCodes.d.ts","sourceRoot":"","sources":["../../src/errors/ErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU;IAKrB,eAAe;;IAEf,iBAAiB;;IAEjB,YAAY;;IAEZ,YAAY;;IAEZ,YAAY;;IAEZ,WAAW;;IAEX,eAAe;;IAOf,kBAAkB;;IAElB,iBAAiB;;IAEjB,cAAc;;IAEd,cAAc;;IAEd,gBAAgB;;IAEhB,YAAY;;IAEZ,iBAAiB;;IAEjB,eAAe;;IAOf,aAAa;;IAEb,mBAAmB;;IAEnB,gBAAgB;;IAEhB,WAAW;;IAEX,eAAe;;IAEf,YAAY;;IAEZ,WAAW;;IAEX,iBAAiB;;IAOjB,eAAe;;IAEf,kBAAkB;;IAElB,eAAe;;IAEf,eAAe;;IAEf,WAAW;;IAEX,eAAe;;IAEf,gBAAgB;;IAEhB,aAAa;;IAOb,gBAAgB;;IAEhB,eAAe;;IAOf,iBAAiB;;IAEjB,iBAAiB;;IAEjB,YAAY;;IAEZ,aAAa;;CAEL,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,OAAO,UAAU,CAAC;AAEnD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,YAAY,CAAC,CAAC"}

package/dist/errors/ErrorCodes.js

@@ -0,0 +1,109 @@
+/**
+ * エラーコード定数
+ *
+ * @design DES-COMMON-001 §4
+ * @task TASK-000
+ */
+/**
+ * 共通エラーコード定数
+ *
+ * 形式: {MODULE}_{CATEGORY}_{NUMBER}
+ * - MODULE: モジュール識別子 (COR, COL, ANA, MED, GEN, KNW)
+ * - CATEGORY: カテゴリ (VAL, AUT, PRM, NTF, CNF, NET, TMO, SEC, SYS, EXT)
+ * - NUMBER: 連番 (001-999)
+ */
+export const ErrorCodes = {
+    // ========================================
+    // Core (COR) - 共通エラー
+    // ========================================
+    /** パラメータが無効 */
+    INVALID_PARAMETER: 'COR_VAL_001',
+    /** 必須パラメータが欠落 */
+    MISSING_REQUIRED: 'COR_VAL_002',
+    /** 型が不一致 */
+    TYPE_MISMATCH: 'COR_VAL_003',
+    /** 内部エラー */
+    INTERNAL_ERROR: 'COR_SYS_001',
+    /** 未実装機能 */
+    NOT_IMPLEMENTED: 'COR_SYS_002',
+    /** 接続失敗 */
+    CONNECTION_FAILED: 'COR_NET_001',
+    /** 操作タイムアウト */
+    OPERATION_TIMEOUT: 'COR_TMO_001',
+    // ========================================
+    // Collector (COL) - 情報収集エラー
+    // ========================================
+    /** ファイルが見つからない */
+    FILE_NOT_FOUND: 'COL_NTF_001',
+    /** 未対応のファイル形式 */
+    UNSUPPORTED_FORMAT: 'COL_VAL_001',
+    /** ファイルが破損 */
+    CORRUPTED_FILE: 'COL_VAL_002',
+    /** パスワード保護 */
+    PASSWORD_PROTECTED: 'COL_SEC_001',
+    /** スクレイピング失敗 */
+    SCRAPE_FAILED: 'COL_NET_001',
+    /** レート制限 */
+    RATE_LIMITED: 'COL_NET_002',
+    /** リサーチタイムアウト */
+    RESEARCH_TIMEOUT: 'COL_TMO_001',
+    /** 検索APIエラー */
+    SEARCH_API_ERROR: 'COL_EXT_001',
+    // ========================================
+    // Analyzer (ANA) - 分析エラー
+    // ========================================
+    /** コードが無効 */
+    INVALID_CODE: 'ANA_VAL_001',
+    /** ブロックされたモジュール */
+    BLOCKED_MODULE: 'ANA_VAL_002',
+    /** サンドボックス違反 */
+    SANDBOX_VIOLATION: 'ANA_SEC_001',
+    /** 権限拒否 */
+    PERMISSION_DENIED: 'ANA_SEC_002',
+    /** 実行タイムアウト */
+    EXECUTION_TIMEOUT: 'ANA_TMO_001',
+    /** メモリ超過 */
+    MEMORY_EXCEEDED: 'ANA_SYS_001',
+    /** 収束失敗 */
+    CONVERGENCE_FAILED: 'ANA_SYS_002',
+    /** LLM APIエラー */
+    LLM_API_ERROR: 'ANA_EXT_001',
+    // ========================================
+    // Media (MED) - メディア生成エラー
+    // ========================================
+    /** プロンプトが無効 */
+    INVALID_PROMPT: 'MED_VAL_001',
+    /** コンテンツポリシー違反 */
+    CONTENT_POLICY_VIOLATION: 'MED_VAL_002',
+    /** 未対応の音声形式 */
+    UNSUPPORTED_AUDIO_FORMAT: 'MED_VAL_003',
+    /** 未対応の画像形式 */
+    UNSUPPORTED_IMAGE_FORMAT: 'MED_VAL_004',
+    /** 生成失敗 */
+    GENERATION_FAILED: 'MED_NET_001',
+    /** 生成タイムアウト */
+    GENERATION_TIMEOUT: 'MED_TMO_001',
+    /** プロバイダーエラー */
+    PROVIDER_ERROR: 'MED_EXT_001',
+    /** クォータ超過 */
+    QUOTA_EXCEEDED: 'MED_EXT_002',
+    // ========================================
+    // Generator (GEN) - コンテンツ生成エラー
+    // ========================================
+    /** テンプレートエラー */
+    TEMPLATE_ERROR: 'GEN_VAL_001',
+    /** レンダリング失敗 */
+    RENDER_FAILED: 'GEN_SYS_001',
+    // ========================================
+    // Knowledge (KNW) - 知識管理エラー
+    // ========================================
+    /** ノードが見つからない */
+    NODE_NOT_FOUND: 'KNW_NTF_001',
+    /** エッジが見つからない */
+    EDGE_NOT_FOUND: 'KNW_NTF_002',
+    /** 永続化失敗 */
+    PERSISTENCE_FAILED: 'KNW_SYS_001',
+    /** クエリエラー */
+    QUERY_ERROR: 'KNW_VAL_001',
+};
+//# sourceMappingURL=ErrorCodes.js.map

package/dist/errors/ErrorCodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorCodes.js","sourceRoot":"","sources":["../../src/errors/ErrorCodes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,2CAA2C;IAC3C,qBAAqB;IACrB,2CAA2C;IAE3C,eAAe;IACf,iBAAiB,EAAE,aAAa;IAChC,iBAAiB;IACjB,gBAAgB,EAAE,aAAa;IAC/B,YAAY;IACZ,aAAa,EAAE,aAAa;IAC5B,YAAY;IACZ,cAAc,EAAE,aAAa;IAC7B,YAAY;IACZ,eAAe,EAAE,aAAa;IAC9B,WAAW;IACX,iBAAiB,EAAE,aAAa;IAChC,eAAe;IACf,iBAAiB,EAAE,aAAa;IAEhC,2CAA2C;IAC3C,4BAA4B;IAC5B,2CAA2C;IAE3C,kBAAkB;IAClB,cAAc,EAAE,aAAa;IAC7B,iBAAiB;IACjB,kBAAkB,EAAE,aAAa;IACjC,cAAc;IACd,cAAc,EAAE,aAAa;IAC7B,cAAc;IACd,kBAAkB,EAAE,aAAa;IACjC,gBAAgB;IAChB,aAAa,EAAE,aAAa;IAC5B,YAAY;IACZ,YAAY,EAAE,aAAa;IAC3B,iBAAiB;IACjB,gBAAgB,EAAE,aAAa;IAC/B,eAAe;IACf,gBAAgB,EAAE,aAAa;IAE/B,2CAA2C;IAC3C,yBAAyB;IACzB,2CAA2C;IAE3C,aAAa;IACb,YAAY,EAAE,aAAa;IAC3B,mBAAmB;IACnB,cAAc,EAAE,aAAa;IAC7B,gBAAgB;IAChB,iBAAiB,EAAE,aAAa;IAChC,WAAW;IACX,iBAAiB,EAAE,aAAa;IAChC,eAAe;IACf,iBAAiB,EAAE,aAAa;IAChC,YAAY;IACZ,eAAe,EAAE,aAAa;IAC9B,WAAW;IACX,kBAAkB,EAAE,aAAa;IACjC,iBAAiB;IACjB,aAAa,EAAE,aAAa;IAE5B,2CAA2C;IAC3C,0BAA0B;IAC1B,2CAA2C;IAE3C,eAAe;IACf,cAAc,EAAE,aAAa;IAC7B,kBAAkB;IAClB,wBAAwB,EAAE,aAAa;IACvC,eAAe;IACf,wBAAwB,EAAE,aAAa;IACvC,eAAe;IACf,wBAAwB,EAAE,aAAa;IACvC,WAAW;IACX,iBAAiB,EAAE,aAAa;IAChC,eAAe;IACf,kBAAkB,EAAE,aAAa;IACjC,gBAAgB;IAChB,cAAc,EAAE,aAAa;IAC7B,aAAa;IACb,cAAc,EAAE,aAAa;IAE7B,2CAA2C;IAC3C,+BAA+B;IAC/B,2CAA2C;IAE3C,gBAAgB;IAChB,cAAc,EAAE,aAAa;IAC7B,eAAe;IACf,aAAa,EAAE,aAAa;IAE5B,2CAA2C;IAC3C,4BAA4B;IAC5B,2CAA2C;IAE3C,iBAAiB;IACjB,cAAc,EAAE,aAAa;IAC7B,iBAAiB;IACjB,cAAc,EAAE,aAAa;IAC7B,YAAY;IACZ,kBAAkB,EAAE,aAAa;IACjC,aAAa;IACb,WAAW,EAAE,aAAa;CAClB,CAAC"}

package/dist/errors/KatashiroError.d.ts

@@ -0,0 +1,82 @@
+/**
+ * KATASHIROエラークラス
+ *
+ * @design DES-COMMON-001 §5
+ * @task TASK-000
+ */
+import type { ErrorModule, ErrorCategory, StructuredErrorCode, KatashiroErrorOptions, SerializedError } from './types.js';
+/**
+ * エラーコードをパース
+ *
+ * @param code - エラーコード文字列 (e.g., "COL_NTF_001")
+ * @returns 構造化エラーコード
+ * @throws Error - 無効なフォーマットの場合
+ */
+export declare function parseErrorCode(code: string): StructuredErrorCode;
+/**
+ * KATASHIRO共通エラークラス
+ *
+ * @example
+ * ```typescript
+ * import { KatashiroError, ErrorCodes } from '@nahisaho/katashiro-core';
+ *
+ * throw new KatashiroError(
+ *   ErrorCodes.FILE_NOT_FOUND,
+ *   'File not found: document.pdf',
+ *   { details: { filePath: 'document.pdf' }, retryable: false }
+ * );
+ * ```
+ */
+export declare class KatashiroError extends Error {
+    /** 構造化エラーコード */
+    readonly code: StructuredErrorCode;
+    /** 追加詳細情報 */
+    readonly details?: Record<string, unknown>;
+    /** 原因となったエラー */
+    readonly cause?: Error;
+    /** リトライ可能か */
+    readonly retryable: boolean;
+    /** エラー発生時刻 */
+    readonly timestamp: Date;
+    /**
+     * KatashiroErrorを作成
+     *
+     * @param code - エラーコード (e.g., "COL_NTF_001")
+     * @param message - エラーメッセージ
+     * @param options - オプション
+     */
+    constructor(code: string, message: string, options?: KatashiroErrorOptions);
+    /**
+     * カテゴリに基づいてリトライ可能性を判定
+     */
+    private determineRetryable;
+    /**
+     * エラーコード文字列を取得
+     */
+    get errorCode(): string;
+    /**
+     * モジュール識別子を取得
+     */
+    get module(): ErrorModule;
+    /**
+     * カテゴリを取得
+     */
+    get category(): ErrorCategory;
+    /**
+     * JSON形式に変換
+     */
+    toJSON(): SerializedError;
+    /**
+     * 文字列に変換
+     */
+    toString(): string;
+    /**
+     * KatashiroErrorかどうかを判定
+     */
+    static isKatashiroError(error: unknown): error is KatashiroError;
+    /**
+     * 任意のエラーをKatashiroErrorに変換
+     */
+    static from(error: unknown, defaultCode?: string): KatashiroError;
+}
+//# sourceMappingURL=KatashiroError.d.ts.map

package/dist/errors/KatashiroError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KatashiroError.d.ts","sourceRoot":"","sources":["../../src/errors/KatashiroError.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,CA8ChE;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAe,SAAQ,KAAK;IACvC,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,aAAa;IACb,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,gBAAgB;IAChB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,cAAc;IACd,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,cAAc;IACd,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;IAEzB;;;;;;OAMG;gBACS,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,qBAAqB;IAe1E;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAK1B;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,WAAW,CAExB;IAED;;OAEG;IACH,IAAI,QAAQ,IAAI,aAAa,CAE5B;IAED;;OAEG;IACH,MAAM,IAAI,eAAe;IAYzB;;OAEG;IACH,QAAQ,IAAI,MAAM;IAIlB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc;IAIhE;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,SAAgB,GAAG,cAAc;CAgBzE"}

package/dist/errors/KatashiroError.js

@@ -0,0 +1,168 @@
+/**
+ * KATASHIROエラークラス
+ *
+ * @design DES-COMMON-001 §5
+ * @task TASK-000
+ */
+/**
+ * エラーコードをパース
+ *
+ * @param code - エラーコード文字列 (e.g., "COL_NTF_001")
+ * @returns 構造化エラーコード
+ * @throws Error - 無効なフォーマットの場合
+ */
+export function parseErrorCode(code) {
+    const parts = code.split('_');
+    if (parts.length !== 3) {
+        throw new Error(`Invalid error code format: ${code}. Expected format: MODULE_CATEGORY_NUMBER`);
+    }
+    const module = parts[0];
+    const category = parts[1];
+    const number = parts[2];
+    // モジュール検証
+    const validModules = ['COR', 'COL', 'ANA', 'MED', 'GEN', 'KNW'];
+    if (!validModules.includes(module)) {
+        throw new Error(`Invalid module: ${module}. Valid modules: ${validModules.join(', ')}`);
+    }
+    // カテゴリ検証
+    const validCategories = [
+        'VAL',
+        'AUT',
+        'PRM',
+        'NTF',
+        'CNF',
+        'NET',
+        'TMO',
+        'SEC',
+        'SYS',
+        'EXT',
+    ];
+    if (!validCategories.includes(category)) {
+        throw new Error(`Invalid category: ${category}. Valid categories: ${validCategories.join(', ')}`);
+    }
+    // 番号検証
+    if (!/^\d{3}$/.test(number)) {
+        throw new Error(`Invalid number: ${number}. Expected 3-digit number (e.g., 001)`);
+    }
+    return {
+        code,
+        module: module,
+        category: category,
+        number,
+    };
+}
+/**
+ * KATASHIRO共通エラークラス
+ *
+ * @example
+ * ```typescript
+ * import { KatashiroError, ErrorCodes } from '@nahisaho/katashiro-core';
+ *
+ * throw new KatashiroError(
+ *   ErrorCodes.FILE_NOT_FOUND,
+ *   'File not found: document.pdf',
+ *   { details: { filePath: 'document.pdf' }, retryable: false }
+ * );
+ * ```
+ */
+export class KatashiroError extends Error {
+    /** 構造化エラーコード */
+    code;
+    /** 追加詳細情報 */
+    details;
+    /** 原因となったエラー */
+    cause;
+    /** リトライ可能か */
+    retryable;
+    /** エラー発生時刻 */
+    timestamp;
+    /**
+     * KatashiroErrorを作成
+     *
+     * @param code - エラーコード (e.g., "COL_NTF_001")
+     * @param message - エラーメッセージ
+     * @param options - オプション
+     */
+    constructor(code, message, options) {
+        super(message);
+        this.name = 'KatashiroError';
+        this.code = parseErrorCode(code);
+        this.details = options?.details;
+        this.cause = options?.cause;
+        this.retryable = options?.retryable ?? this.determineRetryable();
+        this.timestamp = new Date();
+        // スタックトレースを正しく設定
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, KatashiroError);
+        }
+    }
+    /**
+     * カテゴリに基づいてリトライ可能性を判定
+     */
+    determineRetryable() {
+        const retryableCategories = ['NET', 'TMO', 'EXT'];
+        return retryableCategories.includes(this.code.category);
+    }
+    /**
+     * エラーコード文字列を取得
+     */
+    get errorCode() {
+        return this.code.code;
+    }
+    /**
+     * モジュール識別子を取得
+     */
+    get module() {
+        return this.code.module;
+    }
+    /**
+     * カテゴリを取得
+     */
+    get category() {
+        return this.code.category;
+    }
+    /**
+     * JSON形式に変換
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            code: this.code.code,
+            message: this.message,
+            details: this.details,
+            retryable: this.retryable,
+            timestamp: this.timestamp.toISOString(),
+            cause: this.cause?.message,
+        };
+    }
+    /**
+     * 文字列に変換
+     */
+    toString() {
+        return `[${this.code.code}] ${this.message}`;
+    }
+    /**
+     * KatashiroErrorかどうかを判定
+     */
+    static isKatashiroError(error) {
+        return error instanceof KatashiroError;
+    }
+    /**
+     * 任意のエラーをKatashiroErrorに変換
+     */
+    static from(error, defaultCode = 'COR_SYS_001') {
+        if (KatashiroError.isKatashiroError(error)) {
+            return error;
+        }
+        if (error instanceof Error) {
+            return new KatashiroError(defaultCode, error.message, {
+                cause: error,
+                retryable: false,
+            });
+        }
+        return new KatashiroError(defaultCode, String(error), {
+            retryable: false,
+        });
+    }
+}
+//# sourceMappingURL=KatashiroError.js.map

package/dist/errors/KatashiroError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KatashiroError.js","sourceRoot":"","sources":["../../src/errors/KatashiroError.ts"],"names":[],"mappings":"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"}

package/dist/errors/__tests__/KatashiroError.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * KatashiroError テスト
+ *
+ * @design DES-COMMON-001
+ * @task TASK-000-5
+ */
+export {};
+//# sourceMappingURL=KatashiroError.test.d.ts.map

package/dist/errors/__tests__/KatashiroError.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KatashiroError.test.d.ts","sourceRoot":"","sources":["../../../src/errors/__tests__/KatashiroError.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/errors/__tests__/KatashiroError.test.js

@@ -0,0 +1,263 @@
+/**
+ * KatashiroError テスト
+ *
+ * @design DES-COMMON-001
+ * @task TASK-000-5
+ */
+import { describe, it, expect } from 'vitest';
+import { KatashiroError, parseErrorCode, ErrorCodes, withRetry, retry, calculateBackoffDelay, DEFAULT_RETRY_CONFIG, } from '../index.js';
+import { ok, err } from '../../result.js';
+describe('parseErrorCode', () => {
+    it('正常なエラーコードをパースできる', () => {
+        const result = parseErrorCode('COL_NTF_001');
+        expect(result).toEqual({
+            code: 'COL_NTF_001',
+            module: 'COL',
+            category: 'NTF',
+            number: '001',
+        });
+    });
+    it('全モジュールをパースできる', () => {
+        const modules = ['COR', 'COL', 'ANA', 'MED', 'GEN', 'KNW'];
+        for (const mod of modules) {
+            const result = parseErrorCode(`${mod}_VAL_001`);
+            expect(result.module).toBe(mod);
+        }
+    });
+    it('全カテゴリをパースできる', () => {
+        const categories = ['VAL', 'AUT', 'PRM', 'NTF', 'CNF', 'NET', 'TMO', 'SEC', 'SYS', 'EXT'];
+        for (const cat of categories) {
+            const result = parseErrorCode(`COR_${cat}_001`);
+            expect(result.category).toBe(cat);
+        }
+    });
+    it('無効なフォーマットでエラーをスロー', () => {
+        expect(() => parseErrorCode('INVALID')).toThrow('Invalid error code format');
+        expect(() => parseErrorCode('COL_NTF')).toThrow('Invalid error code format');
+        expect(() => parseErrorCode('COL_NTF_001_EXTRA')).toThrow('Invalid error code format');
+    });
+    it('無効なモジュールでエラーをスロー', () => {
+        expect(() => parseErrorCode('XXX_VAL_001')).toThrow('Invalid module');
+    });
+    it('無効なカテゴリでエラーをスロー', () => {
+        expect(() => parseErrorCode('COR_XXX_001')).toThrow('Invalid category');
+    });
+    it('無効な番号でエラーをスロー', () => {
+        expect(() => parseErrorCode('COR_VAL_1')).toThrow('Invalid number');
+        expect(() => parseErrorCode('COR_VAL_1000')).toThrow('Invalid number');
+        expect(() => parseErrorCode('COR_VAL_ABC')).toThrow('Invalid number');
+    });
+});
+describe('KatashiroError', () => {
+    it('基本的なエラーを作成できる', () => {
+        const error = new KatashiroError(ErrorCodes.FILE_NOT_FOUND, 'File not found: test.pdf');
+        expect(error.name).toBe('KatashiroError');
+        expect(error.message).toBe('File not found: test.pdf');
+        expect(error.errorCode).toBe('COL_NTF_001');
+        expect(error.module).toBe('COL');
+        expect(error.category).toBe('NTF');
+        expect(error.retryable).toBe(false); // NTFはリトライ不可
+        expect(error.timestamp).toBeInstanceOf(Date);
+    });
+    it('詳細情報付きエラーを作成できる', () => {
+        const error = new KatashiroError(ErrorCodes.SCRAPE_FAILED, 'Scrape failed', {
+            details: { url: 'https://example.com', statusCode: 403 },
+            retryable: true,
+        });
+        expect(error.details).toEqual({ url: 'https://example.com', statusCode: 403 });
+        expect(error.retryable).toBe(true);
+    });
+    it('原因エラー付きで作成できる', () => {
+        const cause = new Error('Network timeout');
+        const error = new KatashiroError(ErrorCodes.CONNECTION_FAILED, 'Connection failed', {
+            cause,
+        });
+        expect(error.cause).toBe(cause);
+    });
+    it('NETカテゴリはデフォルトでリトライ可能', () => {
+        const error = new KatashiroError(ErrorCodes.SCRAPE_FAILED, 'Scrape failed');
+        expect(error.retryable).toBe(true);
+    });
+    it('TMOカテゴリはデフォルトでリトライ可能', () => {
+        const error = new KatashiroError(ErrorCodes.OPERATION_TIMEOUT, 'Timeout');
+        expect(error.retryable).toBe(true);
+    });
+    it('EXTカテゴリはデフォルトでリトライ可能', () => {
+        const error = new KatashiroError(ErrorCodes.SEARCH_API_ERROR, 'API error');
+        expect(error.retryable).toBe(true);
+    });
+    it('VALカテゴリはデフォルトでリトライ不可', () => {
+        const error = new KatashiroError(ErrorCodes.INVALID_PARAMETER, 'Invalid param');
+        expect(error.retryable).toBe(false);
+    });
+    it('toJSON()で正しくシリアライズできる', () => {
+        const error = new KatashiroError(ErrorCodes.FILE_NOT_FOUND, 'Not found', {
+            details: { path: '/test' },
+        });
+        const json = error.toJSON();
+        expect(json.name).toBe('KatashiroError');
+        expect(json.code).toBe('COL_NTF_001');
+        expect(json.message).toBe('Not found');
+        expect(json.details).toEqual({ path: '/test' });
+        expect(json.retryable).toBe(false);
+        expect(json.timestamp).toBeDefined();
+    });
+    it('toString()でフォーマットされる', () => {
+        const error = new KatashiroError(ErrorCodes.FILE_NOT_FOUND, 'File not found');
+        expect(error.toString()).toBe('[COL_NTF_001] File not found');
+    });
+    it('isKatashiroError()で判定できる', () => {
+        const katashiroError = new KatashiroError(ErrorCodes.INTERNAL_ERROR, 'Error');
+        const regularError = new Error('Regular error');
+        expect(KatashiroError.isKatashiroError(katashiroError)).toBe(true);
+        expect(KatashiroError.isKatashiroError(regularError)).toBe(false);
+        expect(KatashiroError.isKatashiroError(null)).toBe(false);
+        expect(KatashiroError.isKatashiroError('string')).toBe(false);
+    });
+    it('from()でErrorを変換できる', () => {
+        const original = new Error('Original error');
+        const converted = KatashiroError.from(original);
+        expect(converted).toBeInstanceOf(KatashiroError);
+        expect(converted.message).toBe('Original error');
+        expect(converted.cause).toBe(original);
+        expect(converted.errorCode).toBe('COR_SYS_001');
+    });
+    it('from()でKatashiroErrorはそのまま返す', () => {
+        const original = new KatashiroError(ErrorCodes.FILE_NOT_FOUND, 'Not found');
+        const result = KatashiroError.from(original);
+        expect(result).toBe(original);
+    });
+    it('from()で文字列を変換できる', () => {
+        const converted = KatashiroError.from('String error');
+        expect(converted.message).toBe('String error');
+    });
+});
+describe('ErrorCodes', () => {
+    it('全てのエラーコードが正しいフォーマット', () => {
+        for (const [, code] of Object.entries(ErrorCodes)) {
+            expect(() => parseErrorCode(code)).not.toThrow();
+        }
+    });
+    it('主要なエラーコードが定義されている', () => {
+        expect(ErrorCodes.INVALID_PARAMETER).toBe('COR_VAL_001');
+        expect(ErrorCodes.FILE_NOT_FOUND).toBe('COL_NTF_001');
+        expect(ErrorCodes.SANDBOX_VIOLATION).toBe('ANA_SEC_001');
+        expect(ErrorCodes.INVALID_PROMPT).toBe('MED_VAL_001');
+    });
+});
+describe('calculateBackoffDelay', () => {
+    it('指数バックオフで増加する', () => {
+        const base = 1000;
+        const max = 30000;
+        // ジッターがあるので範囲でチェック
+        const delay0 = calculateBackoffDelay(0, base, max);
+        expect(delay0).toBeGreaterThanOrEqual(base);
+        expect(delay0).toBeLessThanOrEqual(base * 1.3);
+        const delay1 = calculateBackoffDelay(1, base, max);
+        expect(delay1).toBeGreaterThanOrEqual(base * 2);
+        expect(delay1).toBeLessThanOrEqual(base * 2 * 1.3);
+        const delay2 = calculateBackoffDelay(2, base, max);
+        expect(delay2).toBeGreaterThanOrEqual(base * 4);
+        expect(delay2).toBeLessThanOrEqual(base * 4 * 1.3);
+    });
+    it('最大値を超えない', () => {
+        const delay = calculateBackoffDelay(10, 1000, 5000);
+        expect(delay).toBeLessThanOrEqual(5000);
+    });
+});
+describe('withRetry', () => {
+    it('成功時は1回で完了', async () => {
+        let callCount = 0;
+        const fn = async () => {
+            callCount++;
+            return ok('success');
+        };
+        const result = await withRetry(fn);
+        expect(result._tag).toBe('Ok');
+        if (result._tag === 'Ok') {
+            expect(result.value).toBe('success');
+        }
+        expect(callCount).toBe(1);
+    });
+    it('リトライ可能なエラーでリトライする', async () => {
+        let callCount = 0;
+        const fn = async () => {
+            callCount++;
+            if (callCount < 3) {
+                return err(new KatashiroError(ErrorCodes.SCRAPE_FAILED, 'Failed', { retryable: true }));
+            }
+            return ok('success');
+        };
+        const result = await withRetry(fn, { maxRetries: 3, baseDelayMs: 10, maxDelayMs: 100 });
+        expect(result._tag).toBe('Ok');
+        expect(callCount).toBe(3);
+    });
+    it('リトライ不可のエラーはリトライしない', async () => {
+        let callCount = 0;
+        const fn = async () => {
+            callCount++;
+            return err(new KatashiroError(ErrorCodes.INVALID_PARAMETER, 'Invalid', { retryable: false }));
+        };
+        const result = await withRetry(fn, { maxRetries: 3 });
+        expect(result._tag).toBe('Err');
+        expect(callCount).toBe(1);
+    });
+    it('最大リトライ回数後は失敗', async () => {
+        let callCount = 0;
+        const fn = async () => {
+            callCount++;
+            return err(new KatashiroError(ErrorCodes.SCRAPE_FAILED, 'Failed', { retryable: true }));
+        };
+        const result = await withRetry(fn, { maxRetries: 2, baseDelayMs: 10, maxDelayMs: 100 });
+        expect(result._tag).toBe('Err');
+        expect(callCount).toBe(3); // 初回 + 2回リトライ
+    });
+    it('コールバックが呼ばれる', async () => {
+        let retryCount = 0;
+        let successCalled = false;
+        let callCount = 0;
+        const fn = async () => {
+            callCount++;
+            if (callCount < 2) {
+                return err(new KatashiroError(ErrorCodes.SCRAPE_FAILED, 'Failed', { retryable: true }));
+            }
+            return ok('success');
+        };
+        await withRetry(fn, { maxRetries: 3, baseDelayMs: 10, maxDelayMs: 100 }, {
+            onRetry: () => {
+                retryCount++;
+            },
+            onSuccess: () => {
+                successCalled = true;
+            },
+        });
+        expect(retryCount).toBe(1);
+        expect(successCalled).toBe(true);
+    });
+});
+describe('retry', () => {
+    it('簡易リトライが動作する', async () => {
+        let callCount = 0;
+        const fn = async () => {
+            callCount++;
+            if (callCount < 2) {
+                return err(new KatashiroError(ErrorCodes.CONNECTION_FAILED, 'Failed', { retryable: true }));
+            }
+            return ok('success');
+        };
+        const result = await retry(fn, 3);
+        expect(result._tag).toBe('Ok');
+        expect(callCount).toBe(2);
+    });
+});
+describe('DEFAULT_RETRY_CONFIG', () => {
+    it('デフォルト値が設定されている', () => {
+        expect(DEFAULT_RETRY_CONFIG.maxRetries).toBe(3);
+        expect(DEFAULT_RETRY_CONFIG.baseDelayMs).toBe(1000);
+        expect(DEFAULT_RETRY_CONFIG.maxDelayMs).toBe(30000);
+        expect(DEFAULT_RETRY_CONFIG.retryableCategories).toContain('NET');
+        expect(DEFAULT_RETRY_CONFIG.retryableCategories).toContain('TMO');
+        expect(DEFAULT_RETRY_CONFIG.retryableCategories).toContain('EXT');
+    });
+});
+//# sourceMappingURL=KatashiroError.test.js.map

package/dist/errors/__tests__/KatashiroError.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KatashiroError.test.js","sourceRoot":"","sources":["../../../src/errors/__tests__/KatashiroError.test.ts"],"names":[],"mappings":"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"}

package/dist/errors/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * エラーモジュール
+ *
+ * @design DES-COMMON-001
+ * @task TASK-000
+ */
+export type { ErrorModule, ErrorCategory, StructuredErrorCode, KatashiroErrorOptions, SerializedError, RetryConfig, } from './types.js';
+export { DEFAULT_RETRY_CONFIG } from './types.js';
+export { KatashiroError, parseErrorCode } from './KatashiroError.js';
+export { ErrorCodes } from './ErrorCodes.js';
+export type { ErrorCodeKey, ErrorCodeValue } from './ErrorCodes.js';
+export { withRetry, retry, withRetryPromise, calculateBackoffDelay, } from './retry.js';
+export type { RetryResult, RetryCallbacks } from './retry.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,YAAY,EACV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGpE,OAAO,EACL,SAAS,EACT,KAAK,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,YAAY,CAAC;AACpB,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/errors/index.js

@@ -0,0 +1,14 @@
+/**
+ * エラーモジュール
+ *
+ * @design DES-COMMON-001
+ * @task TASK-000
+ */
+export { DEFAULT_RETRY_CONFIG } from './types.js';
+// エラークラス
+export { KatashiroError, parseErrorCode } from './KatashiroError.js';
+// エラーコード定数
+export { ErrorCodes } from './ErrorCodes.js';
+// リトライユーティリティ
+export { withRetry, retry, withRetryPromise, calculateBackoffDelay, } from './retry.js';
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAElD,SAAS;AACT,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErE,WAAW;AACX,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,cAAc;AACd,OAAO,EACL,SAAS,EACT,KAAK,EACL,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,YAAY,CAAC"}

package/dist/errors/retry.d.ts

@@ -0,0 +1,79 @@
+/**
+ * リトライユーティリティ
+ *
+ * @design DES-COMMON-001 §6.2
+ * @task TASK-000
+ */
+import type { Result } from '../result.js';
+import type { RetryConfig } from './types.js';
+import { KatashiroError } from './KatashiroError.js';
+/**
+ * 指数バックオフ遅延を計算
+ *
+ * @param attempt - 試行回数 (0から開始)
+ * @param baseDelayMs - 基本遅延時間
+ * @param maxDelayMs - 最大遅延時間
+ * @returns 遅延時間 (ms)
+ */
+export declare function calculateBackoffDelay(attempt: number, baseDelayMs: number, maxDelayMs: number): number;
+/**
+ * リトライ実行結果
+ */
+export interface RetryResult<T> {
+    /** 成功したか */
+    readonly success: boolean;
+    /** 結果（成功時） */
+    readonly value?: T;
+    /** 最後のエラー（失敗時） */
+    readonly lastError?: KatashiroError;
+    /** 試行回数 */
+    readonly attempts: number;
+    /** 総実行時間 (ms) */
+    readonly totalTimeMs: number;
+}
+/**
+ * リトライコールバック
+ */
+export interface RetryCallbacks<T> {
+    /** リトライ前に呼ばれる */
+    onRetry?: (attempt: number, error: KatashiroError, delayMs: number) => void;
+    /** 成功時に呼ばれる */
+    onSuccess?: (result: T, attempts: number) => void;
+    /** 最終失敗時に呼ばれる */
+    onFailure?: (error: KatashiroError, attempts: number) => void;
+}
+/**
+ * リトライ付きで関数を実行
+ *
+ * @param fn - 実行する関数
+ * @param config - リトライ設定
+ * @param callbacks - コールバック
+ * @returns 結果
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchData(url),
+ *   { maxRetries: 3, baseDelayMs: 1000, maxDelayMs: 10000 },
+ *   { onRetry: (attempt) => console.log(`Retry ${attempt}`) }
+ * );
+ * ```
+ */
+export declare function withRetry<T>(fn: () => Promise<Result<T, KatashiroError>>, config?: Partial<RetryConfig>, callbacks?: RetryCallbacks<T>): Promise<Result<T, KatashiroError>>;
+/**
+ * 簡易リトライ（設定なし）
+ *
+ * @param fn - 実行する関数
+ * @param maxRetries - 最大リトライ回数（デフォルト: 3）
+ * @returns 結果
+ */
+export declare function retry<T>(fn: () => Promise<Result<T, KatashiroError>>, maxRetries?: number): Promise<Result<T, KatashiroError>>;
+/**
+ * Promise版リトライ（Result型を使わない場合）
+ *
+ * @param fn - 実行する関数
+ * @param config - リトライ設定
+ * @returns 結果
+ */
+export declare function withRetryPromise<T>(fn: () => Promise<T>, config?: Partial<RetryConfig>): Promise<T>;
+//# sourceMappingURL=retry.d.ts.map

package/dist/errors/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/errors/retry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AASrD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,GACjB,MAAM,CAKR;AAED;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,YAAY;IACZ,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,cAAc;IACd,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnB,kBAAkB;IAClB,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAC;IACpC,WAAW;IACX,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,iBAAiB;IACjB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,iBAAiB;IACjB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,eAAe;IACf,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClD,iBAAiB;IACjB,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/D;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,EAC5C,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,EACjC,SAAS,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAiEpC;AAeD;;;;;;GAMG;AACH,wBAAsB,KAAK,CAAC,CAAC,EAC3B,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,EAC5C,UAAU,SAAI,GACb,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,CAEpC;AAED;;;;;;GAMG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,OAAO,CAAC,WAAW,CAAM,GAChC,OAAO,CAAC,CAAC,CAAC,CAmCZ"}

package/dist/errors/retry.js

@@ -0,0 +1,150 @@
+/**
+ * リトライユーティリティ
+ *
+ * @design DES-COMMON-001 §6.2
+ * @task TASK-000
+ */
+import { isOk, err } from '../result.js';
+import { DEFAULT_RETRY_CONFIG } from './types.js';
+import { KatashiroError } from './KatashiroError.js';
+/**
+ * スリープ関数
+ */
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * 指数バックオフ遅延を計算
+ *
+ * @param attempt - 試行回数 (0から開始)
+ * @param baseDelayMs - 基本遅延時間
+ * @param maxDelayMs - 最大遅延時間
+ * @returns 遅延時間 (ms)
+ */
+export function calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs) {
+    // ジッター付き指数バックオフ
+    const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
+    const jitter = Math.random() * 0.3 * exponentialDelay; // 30%のジッター
+    return Math.min(exponentialDelay + jitter, maxDelayMs);
+}
+/**
+ * リトライ付きで関数を実行
+ *
+ * @param fn - 実行する関数
+ * @param config - リトライ設定
+ * @param callbacks - コールバック
+ * @returns 結果
+ *
+ * @example
+ * ```typescript
+ * const result = await withRetry(
+ *   () => fetchData(url),
+ *   { maxRetries: 3, baseDelayMs: 1000, maxDelayMs: 10000 },
+ *   { onRetry: (attempt) => console.log(`Retry ${attempt}`) }
+ * );
+ * ```
+ */
+export async function withRetry(fn, config = {}, callbacks) {
+    const mergedConfig = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...config,
+    };
+    let lastError = null;
+    for (let attempt = 0; attempt <= mergedConfig.maxRetries; attempt++) {
+        try {
+            const result = await fn();
+            if (isOk(result)) {
+                callbacks?.onSuccess?.(result.value, attempt + 1);
+                return result;
+            }
+            lastError = result.error;
+            // リトライ不可のエラーはすぐに返す
+            if (!shouldRetry(lastError, mergedConfig)) {
+                callbacks?.onFailure?.(lastError, attempt + 1);
+                return result;
+            }
+            // 最後の試行ならリトライしない
+            if (attempt === mergedConfig.maxRetries) {
+                callbacks?.onFailure?.(lastError, attempt + 1);
+                return result;
+            }
+            // バックオフ遅延
+            const delay = calculateBackoffDelay(attempt, mergedConfig.baseDelayMs, mergedConfig.maxDelayMs);
+            callbacks?.onRetry?.(attempt + 1, lastError, delay);
+            await sleep(delay);
+        }
+        catch (error) {
+            // 予期しないエラーをKatashiroErrorに変換
+            lastError = KatashiroError.from(error);
+            if (!shouldRetry(lastError, mergedConfig)) {
+                callbacks?.onFailure?.(lastError, attempt + 1);
+                return err(lastError);
+            }
+            if (attempt === mergedConfig.maxRetries) {
+                callbacks?.onFailure?.(lastError, attempt + 1);
+                return err(lastError);
+            }
+            const delay = calculateBackoffDelay(attempt, mergedConfig.baseDelayMs, mergedConfig.maxDelayMs);
+            callbacks?.onRetry?.(attempt + 1, lastError, delay);
+            await sleep(delay);
+        }
+    }
+    // ここには到達しないはずだが、型安全のために
+    return err(lastError);
+}
+/**
+ * リトライすべきかを判定
+ */
+function shouldRetry(error, config) {
+    // 明示的にリトライ不可の場合
+    if (!error.retryable) {
+        return false;
+    }
+    // カテゴリがリトライ対象か
+    return config.retryableCategories.includes(error.category);
+}
+/**
+ * 簡易リトライ（設定なし）
+ *
+ * @param fn - 実行する関数
+ * @param maxRetries - 最大リトライ回数（デフォルト: 3）
+ * @returns 結果
+ */
+export async function retry(fn, maxRetries = 3) {
+    return withRetry(fn, { maxRetries });
+}
+/**
+ * Promise版リトライ（Result型を使わない場合）
+ *
+ * @param fn - 実行する関数
+ * @param config - リトライ設定
+ * @returns 結果
+ */
+export async function withRetryPromise(fn, config = {}) {
+    const mergedConfig = {
+        ...DEFAULT_RETRY_CONFIG,
+        ...config,
+    };
+    let lastError = null;
+    for (let attempt = 0; attempt <= mergedConfig.maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // KatashiroErrorの場合はリトライ可能性をチェック
+            if (KatashiroError.isKatashiroError(error)) {
+                if (!shouldRetry(error, mergedConfig)) {
+                    throw error;
+                }
+            }
+            if (attempt === mergedConfig.maxRetries) {
+                throw lastError;
+            }
+            const delay = calculateBackoffDelay(attempt, mergedConfig.baseDelayMs, mergedConfig.maxDelayMs);
+            await sleep(delay);
+        }
+    }
+    throw lastError;
+}
+//# sourceMappingURL=retry.js.map

package/dist/errors/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../../src/errors/retry.ts"],"names":[],"mappings":"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"}

package/dist/errors/types.d.ts

@@ -0,0 +1,68 @@
+/**
+ * エラー型定義
+ *
+ * @design DES-COMMON-001
+ * @task TASK-000
+ */
+/**
+ * エラーモジュール識別子
+ */
+export type ErrorModule = 'COR' | 'COL' | 'ANA' | 'MED' | 'GEN' | 'KNW';
+/**
+ * エラーカテゴリ
+ */
+export type ErrorCategory = 'VAL' | 'AUT' | 'PRM' | 'NTF' | 'CNF' | 'NET' | 'TMO' | 'SEC' | 'SYS' | 'EXT';
+/**
+ * 構造化エラーコード
+ */
+export interface StructuredErrorCode {
+    /** 完全なエラーコード (e.g., "COL_NTF_001") */
+    readonly code: string;
+    /** モジュール識別子 */
+    readonly module: ErrorModule;
+    /** カテゴリ */
+    readonly category: ErrorCategory;
+    /** 連番 */
+    readonly number: string;
+}
+/**
+ * エラーオプション
+ */
+export interface KatashiroErrorOptions {
+    /** 追加詳細情報 */
+    readonly details?: Record<string, unknown>;
+    /** 原因となったエラー */
+    readonly cause?: Error;
+    /** リトライ可能か */
+    readonly retryable?: boolean;
+}
+/**
+ * シリアライズされたエラー
+ */
+export interface SerializedError {
+    readonly name: string;
+    readonly code: string;
+    readonly message: string;
+    readonly details?: Record<string, unknown>;
+    readonly retryable: boolean;
+    readonly timestamp: string;
+    readonly cause?: string;
+}
+/**
+ * リトライ設定
+ */
+export interface RetryConfig {
+    /** 最大リトライ回数 */
+    readonly maxRetries: number;
+    /** 基本遅延時間 (ms) */
+    readonly baseDelayMs: number;
+    /** 最大遅延時間 (ms) */
+    readonly maxDelayMs: number;
+    /** リトライ対象カテゴリ */
+    readonly retryableCategories: ReadonlyArray<ErrorCategory>;
+}
+/**
+ * デフォルトリトライ設定
+ */
+export declare const DEFAULT_RETRY_CONFIG: RetryConfig;
+//# sourceMappingURL=types.d.ts.map

package/dist/errors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAExE;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,GACL,KAAK,CAAC;AAEV;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,eAAe;IACf,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,WAAW;IACX,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,SAAS;IACT,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,aAAa;IACb,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,gBAAgB;IAChB,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,cAAc;IACd,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,eAAe;IACf,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kBAAkB;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iBAAiB;IACjB,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC;CAC5D;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAKlC,CAAC"}

package/dist/errors/types.js

@@ -0,0 +1,16 @@
+/**
+ * エラー型定義
+ *
+ * @design DES-COMMON-001
+ * @task TASK-000
+ */
+/**
+ * デフォルトリトライ設定
+ */
+export const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    baseDelayMs: 1000,
+    maxDelayMs: 30000,
+    retryableCategories: ['NET', 'TMO', 'EXT'],
+};
+//# sourceMappingURL=types.js.map

package/dist/errors/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/errors/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA2EH;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgB;IAC/C,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,IAAI;IACjB,UAAU,EAAE,KAAK;IACjB,mBAAmB,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;CAC3C,CAAC"}

package/dist/index.d.ts

@@ -3,13 +3,15 @@
  * 共通型・ユーティリティ
  *
  * @requirement REQ-NFR-006, REQ-NFR-007
- * @design DES-KATASHIRO-001 §2.2
- * @task TSK-001
+ * @design DES-KATASHIRO-001 §2.2, DES-COMMON-001
+ * @task TSK-001, TASK-000
  */
 export type { Result, Ok, Err } from './result.js';
 export { ok, err, isOk, isErr } from './result.js';
-export type { ID, Timestamp, URL, SearchQuery, SearchResult, SearchOptions, Source, SourceMetadata, Content, ContentType, KatashiroError, ErrorCode, } from './types.js';
+export type { ID, Timestamp, URL, SearchQuery, SearchResult, SearchOptions, Source, SourceMetadata, Content, ContentType, KatashiroError as LegacyKatashiroError, ErrorCode as LegacyErrorCode, } from './types.js';
 export { generateId, formatTimestamp, validateUrl } from './utils.js';
 export type { LogLevel, LogEntry, Logger as LoggerInterface } from './logger.js';
 export { Logger, LoggerClass, createLogger } from './logger.js';
+export { KatashiroError, parseErrorCode, ErrorCodes, withRetry, retry, withRetryPromise, calculateBackoffDelay, DEFAULT_RETRY_CONFIG, } from './errors/index.js';
+export type { ErrorModule, ErrorCategory, StructuredErrorCode, KatashiroErrorOptions, SerializedError, RetryConfig, ErrorCodeKey, ErrorCodeValue, RetryResult, RetryCallbacks, } from './errors/index.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGnD,YAAY,EAEV,EAAE,EACF,SAAS,EACT,GAAG,EAEH,WAAW,EACX,YAAY,EACZ,aAAa,EAEb,MAAM,EACN,cAAc,EAEd,OAAO,EACP,WAAW,EAEX,cAAc,EACd,SAAS,GACV,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGtE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAGnD,YAAY,EAEV,EAAE,EACF,SAAS,EACT,GAAG,EAEH,WAAW,EACX,YAAY,EACZ,aAAa,EAEb,MAAM,EACN,cAAc,EAEd,OAAO,EACP,WAAW,EAEX,cAAc,IAAI,oBAAoB,EACtC,SAAS,IAAI,eAAe,GAC7B,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAGtE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,aAAa,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhE,OAAO,EAEL,cAAc,EACd,cAAc,EAEd,UAAU,EAEV,SAAS,EACT,KAAK,EACL,gBAAgB,EAChB,qBAAqB,EAErB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAEV,WAAW,EACX,aAAa,EACb,mBAAmB,EACnB,qBAAqB,EACrB,eAAe,EACf,WAAW,EACX,YAAY,EACZ,cAAc,EACd,WAAW,EACX,cAAc,GACf,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -3,11 +3,21 @@
  * 共通型・ユーティリティ
  *
  * @requirement REQ-NFR-006, REQ-NFR-007
- * @design DES-KATASHIRO-001 §2.2
- * @task TSK-001
+ * @design DES-KATASHIRO-001 §2.2, DES-COMMON-001
+ * @task TSK-001, TASK-000
  */
 export { ok, err, isOk, isErr } from './result.js';
 // ユーティリティ
 export { generateId, formatTimestamp, validateUrl } from './utils.js';
 export { Logger, LoggerClass, createLogger } from './logger.js';
+// エラーモジュール (DES-COMMON-001)
+export { 
+// エラークラス
+KatashiroError, parseErrorCode, 
+// エラーコード定数
+ErrorCodes, 
+// リトライユーティリティ
+withRetry, retry, withRetryPromise, calculateBackoffDelay, 
+// デフォルト設定
+DEFAULT_RETRY_CONFIG, } from './errors/index.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAuBnD,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAItE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAuBnD,UAAU;AACV,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAItE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhE,4BAA4B;AAC5B,OAAO;AACL,SAAS;AACT,cAAc,EACd,cAAc;AACd,WAAW;AACX,UAAU;AACV,cAAc;AACd,SAAS,EACT,KAAK,EACL,gBAAgB,EAChB,qBAAqB;AACrB,UAAU;AACV,oBAAoB,GACrB,MAAM,mBAAmB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nahisaho/katashiro-core",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "KATASHIRO Core - 共通型・ユーティリティ",
   "type": "module",
   "main": "./dist/index.js",