@sugukuru/mcp-houjin-bangou 0.2.0

package/dist/domain/normalizer.js

@@ -0,0 +1,280 @@
+/**
+ * 表記揺れ正規化 (T7 の核)
+ * Company name normalization (T7 core logic)
+ * Normalisasi nama perusahaan (inti T7)
+ *
+ * ポジショニング / Positioning:
+ *   国税庁 API `target=1` が既にあいまい検索を内蔵する (第二編 §4.6.2):
+ *     - ひらがな → カタカナ置換
+ *     - 英小文字 → 英大文字置換
+ *     - 中点 (・) や全角スペース削除
+ *
+ *   T7 はこれらを重複実装せず、国税庁が拾えない 7 パターンを補完:
+ *     1. (株)/㈱/株式会社 表記揺れ (前株・後株・省略 の3展開)
+ *     2. 法人種別 [株式/有限/合同/合名/合資/一般社団/...] の正規化 + 分離
+ *     3. 英語法人名 → 日本語候補 (K.K. / Kabushiki Kaisha / Inc. 検出)
+ *     4. 半角/全角英数字の正規化 (NFKC)
+ *     5. 旧字体 → 新字体 (髙 → 高、齋 → 斎 等)
+ *     6. 異体字セレクタ (IVS / VS) 除去
+ *     7. 空白類の揃え (タブ・連続スペース・全角/半角スペース)
+ */
+/**
+ * 旧字体 → 新字体 辞書 (JIS 第一・第二水準への縮退補助)
+ * 根拠: 法務省「戸籍統一文字」「人名用漢字の新字旧字対応表」
+ *
+ * 国税庁 API の `target=1` (第二編 §4.6.2) は ひらがな↔カタカナ・英大小・中点削除は
+ * 吸収するが、旧字体→新字体変換は未対応なので本 lookup で補う。
+ */
+const OLD_TO_NEW = {
+    髙: '高',
+    﨑: '崎',
+    齋: '斎',
+    齊: '斉',
+    濵: '浜',
+    濱: '浜',
+    德: '徳',
+    眞: '真',
+    曻: '昇',
+    晄: '晃',
+    淸: '清',
+    廣: '広',
+    禮: '礼',
+    藪: '薮',
+    邉: '辺',
+    邊: '辺',
+    澤: '沢',
+    國: '国',
+    團: '団',
+    寳: '宝',
+    寶: '宝',
+    應: '応',
+    靑: '青',
+    權: '権',
+    氣: '気',
+    專: '専',
+    單: '単',
+    學: '学',
+    樂: '楽',
+    劍: '剣',
+    續: '続',
+    圖: '図',
+    鐵: '鉄',
+    齒: '歯',
+    歷: '歴',
+    藝: '芸',
+    戰: '戦',
+    驛: '駅',
+    檢: '検',
+    營: '営',
+    舊: '旧',
+    醫: '医',
+    號: '号',
+    獨: '独',
+    讀: '読',
+    變: '変',
+    體: '体',
+};
+const KIND_KEYWORDS_JA = [
+    { word: '株式会社', hint: 'kabushiki_kaisha' },
+    { word: '㈱', hint: 'kabushiki_kaisha' },
+    { word: '（株）', hint: 'kabushiki_kaisha' },
+    { word: '(株)', hint: 'kabushiki_kaisha' },
+    { word: '有限会社', hint: 'yugen_kaisha' },
+    { word: '（有）', hint: 'yugen_kaisha' },
+    { word: '(有)', hint: 'yugen_kaisha' },
+    { word: '㈲', hint: 'yugen_kaisha' },
+    { word: '合同会社', hint: 'godo_kaisha' },
+    { word: '合名会社', hint: 'gomei_kaisha' },
+    { word: '合資会社', hint: 'goshi_kaisha' },
+    { word: '一般社団法人', hint: 'ippan_shadan_hojin' },
+    { word: '一般財団法人', hint: 'ippan_zaidan_hojin' },
+    { word: '公益社団法人', hint: 'koueki_shadan_hojin' },
+    { word: '公益財団法人', hint: 'koueki_zaidan_hojin' },
+    { word: '特定非営利活動法人', hint: 'npo_hojin' },
+    { word: 'NPO法人', hint: 'npo_hojin' },
+];
+const EN_SUFFIX_PATTERNS = [
+    { regex: /\b(K\.?\s*K\.?)\b/gi, hint: 'kabushiki_kaisha' },
+    { regex: /\bKabushiki\s*Kaisha\b/gi, hint: 'kabushiki_kaisha' },
+    { regex: /\bCo\.?\s*,?\s*Ltd\.?\b/gi, hint: 'kabushiki_kaisha' },
+    { regex: /\bCorp\.?\b/gi, hint: 'other_registered' },
+    { regex: /\bInc\.?\b/gi, hint: 'foreign_company' },
+    { regex: /\bLLC\b/gi, hint: 'godo_kaisha' },
+];
+/**
+ * 文字列を正規化して法人名候補リストを生成
+ *
+ * @param raw 入力文字列 (名刺OCR や手入力の揺れを含む)
+ * @returns 最大10件の正規化候補
+ */
+export function normalizeCompanyName(raw) {
+    const trimmed = raw.trim();
+    if (trimmed.length === 0) {
+        return {
+            original: raw,
+            extracted_core_name: '',
+            normalized_candidates: [],
+            fallback_note: 'Empty input',
+        };
+    }
+    const appliedRules = [];
+    // Rule 7: 空白類の揃え (NFKC で全角→半角 の前段、連続空白の除去)
+    let work = trimmed.replace(/[\t\u3000]+/g, ' ').replace(/ {2,}/g, ' ');
+    if (work !== trimmed)
+        appliedRules.push('rule7_whitespace');
+    // Rule 4: NFKC 正規化 (半角/全角英数字の揃え)
+    const beforeNfkc = work;
+    work = work.normalize('NFKC');
+    if (work !== beforeNfkc)
+        appliedRules.push('rule4_nfkc');
+    // Rule 6: 異体字セレクタ除去 (BMP Variation Selectors + Supplementary IVS)
+    // 注意: \uE0100 は 4 hex digit 評価 + 余剰トークンになり char class を破壊するため
+    //       \u{...} 表記を u フラグ下で使用する必要がある
+    const beforeVs = work;
+    work = work.replace(/[\uFE00-\uFE0F]|[\u{E0100}-\u{E01EF}]/gu, '');
+    if (work !== beforeVs)
+        appliedRules.push('rule6_ivs_removed');
+    // Rule 5: 旧字体 → 新字体 (候補として別バージョンも保持)
+    let newVariant = null;
+    const newWork = applyOldToNew(work);
+    if (newWork !== work) {
+        newVariant = newWork;
+        appliedRules.push('rule5_old_to_new_char');
+    }
+    // Rule 1/2: 法人種別検出 + 前株/後株判定
+    const kindDetection = detectKind(work);
+    // Rule 3: 英語法人名検出
+    const enDetection = detectEnglishKind(work);
+    // ターゲット推定
+    const suggestedTarget = enDetection.hint !== null ? '3' : '1';
+    // コア名 (法人種別を取り除いた部分)
+    const coreName = stripKindFromName(work, kindDetection);
+    // 候補生成
+    const candidates = [];
+    // a. 正規化済みの元のまま (core name 保持)
+    candidates.push({
+        name: work,
+        kind_hint: kindDetection.hint ?? enDetection.hint ?? 'unknown',
+        prefix_or_suffix: kindDetection.position,
+        suggested_target: suggestedTarget,
+        confidence: 0.95,
+        applied_rules: [...appliedRules],
+    });
+    // b. 法人種別を除去したコア名のみ
+    if (coreName !== work && coreName.length > 0) {
+        candidates.push({
+            name: coreName,
+            kind_hint: kindDetection.hint ?? 'unknown',
+            prefix_or_suffix: 'none',
+            suggested_target: suggestedTarget,
+            confidence: 0.9,
+            applied_rules: [...appliedRules, 'rule2_kind_separated'],
+        });
+    }
+    // c. 前株 ↔ 後株 の反転候補 (株式会社のみ)
+    if (kindDetection.hint === 'kabushiki_kaisha' && coreName.length > 0) {
+        if (kindDetection.position === 'mae_kabu') {
+            candidates.push({
+                name: `${coreName}株式会社`,
+                kind_hint: 'kabushiki_kaisha',
+                prefix_or_suffix: 'ato_kabu',
+                suggested_target: suggestedTarget,
+                confidence: 0.75,
+                applied_rules: [...appliedRules, 'rule1_kabu_position_inverted'],
+            });
+        }
+        else if (kindDetection.position === 'ato_kabu') {
+            candidates.push({
+                name: `株式会社${coreName}`,
+                kind_hint: 'kabushiki_kaisha',
+                prefix_or_suffix: 'mae_kabu',
+                suggested_target: suggestedTarget,
+                confidence: 0.75,
+                applied_rules: [...appliedRules, 'rule1_kabu_position_inverted'],
+            });
+        }
+    }
+    // d. 英語法人名が検出された場合、英語表記での検索候補
+    if (enDetection.hint !== null) {
+        const enCore = enDetection.stripped;
+        candidates.push({
+            name: enCore,
+            kind_hint: enDetection.hint,
+            prefix_or_suffix: 'none',
+            suggested_target: '3',
+            confidence: 0.7,
+            applied_rules: [...appliedRules, 'rule3_english_detected'],
+        });
+    }
+    // e. 旧字体→新字体の候補
+    if (newVariant !== null) {
+        candidates.push({
+            name: newVariant,
+            kind_hint: kindDetection.hint ?? 'unknown',
+            prefix_or_suffix: kindDetection.position,
+            suggested_target: '1',
+            confidence: 0.8,
+            applied_rules: [...appliedRules, 'rule5_old_to_new_applied'],
+        });
+    }
+    // 重複除去 + 10件上限
+    const seen = new Set();
+    const uniqueCandidates = candidates
+        .filter((c) => {
+        if (seen.has(c.name))
+            return false;
+        seen.add(c.name);
+        return true;
+    })
+        .slice(0, 10);
+    return {
+        original: raw,
+        extracted_core_name: coreName,
+        normalized_candidates: uniqueCandidates,
+    };
+}
+function detectKind(text) {
+    for (const { word, hint } of KIND_KEYWORDS_JA) {
+        const idx = text.indexOf(word);
+        if (idx === -1)
+            continue;
+        const atStart = idx === 0;
+        const atEnd = idx + word.length === text.length;
+        let position = 'none';
+        if (atStart)
+            position = 'mae_kabu';
+        else if (atEnd)
+            position = 'ato_kabu';
+        return { hint, position, matchedWord: word };
+    }
+    return { hint: null, position: 'none', matchedWord: null };
+}
+function stripKindFromName(text, detection) {
+    if (detection.matchedWord === null)
+        return text;
+    return text.replace(detection.matchedWord, '').trim();
+}
+function detectEnglishKind(text) {
+    for (const { regex, hint } of EN_SUFFIX_PATTERNS) {
+        const freshRegex = new RegExp(regex.source, regex.flags);
+        const match = freshRegex.exec(text);
+        if (match !== null) {
+            const stripped = text
+                .replace(freshRegex, '')
+                .replace(/\s+,?\s*$/, '')
+                .trim();
+            return { hint, stripped, matchedSuffix: match[0] };
+        }
+    }
+    return { hint: null, stripped: text, matchedSuffix: null };
+}
+function applyOldToNew(text) {
+    let result = text;
+    for (const [oldChar, newChar] of Object.entries(OLD_TO_NEW)) {
+        if (result.includes(oldChar)) {
+            result = result.split(oldChar).join(newChar);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=normalizer.js.map

package/dist/domain/normalizer.js.map

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

package/dist/domain/prefecture-codes.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 都道府県コード (JIS X 0401) + 国外
+ * Prefecture code (JIS X 0401) + foreign
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 §3.1.3・§4.1.3 (address パラメータ)
+ * 99 は国外所在地を表す
+ */
+export declare const PREFECTURE_CODES: {
+    readonly '01': "北海道";
+    readonly '02': "青森県";
+    readonly '03': "岩手県";
+    readonly '04': "宮城県";
+    readonly '05': "秋田県";
+    readonly '06': "山形県";
+    readonly '07': "福島県";
+    readonly '08': "茨城県";
+    readonly '09': "栃木県";
+    readonly '10': "群馬県";
+    readonly '11': "埼玉県";
+    readonly '12': "千葉県";
+    readonly '13': "東京都";
+    readonly '14': "神奈川県";
+    readonly '15': "新潟県";
+    readonly '16': "富山県";
+    readonly '17': "石川県";
+    readonly '18': "福井県";
+    readonly '19': "山梨県";
+    readonly '20': "長野県";
+    readonly '21': "岐阜県";
+    readonly '22': "静岡県";
+    readonly '23': "愛知県";
+    readonly '24': "三重県";
+    readonly '25': "滋賀県";
+    readonly '26': "京都府";
+    readonly '27': "大阪府";
+    readonly '28': "兵庫県";
+    readonly '29': "奈良県";
+    readonly '30': "和歌山県";
+    readonly '31': "鳥取県";
+    readonly '32': "島根県";
+    readonly '33': "岡山県";
+    readonly '34': "広島県";
+    readonly '35': "山口県";
+    readonly '36': "徳島県";
+    readonly '37': "香川県";
+    readonly '38': "愛媛県";
+    readonly '39': "高知県";
+    readonly '40': "福岡県";
+    readonly '41': "佐賀県";
+    readonly '42': "長崎県";
+    readonly '43': "熊本県";
+    readonly '44': "大分県";
+    readonly '45': "宮崎県";
+    readonly '46': "鹿児島県";
+    readonly '47': "沖縄県";
+    readonly '99': "国外";
+};
+export type PrefectureCode = keyof typeof PREFECTURE_CODES;
+export declare function isPrefectureCode(value: string): value is PrefectureCode;
+export declare function prefectureName(code: string): string;
+//# sourceMappingURL=prefecture-codes.d.ts.map

package/dist/domain/prefecture-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefecture-codes.d.ts","sourceRoot":"","sources":["../../src/domain/prefecture-codes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiDnB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,gBAAgB,CAAC;AAE3D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAKnD"}

package/dist/domain/prefecture-codes.js

@@ -0,0 +1,67 @@
+/**
+ * 都道府県コード (JIS X 0401) + 国外
+ * Prefecture code (JIS X 0401) + foreign
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 §3.1.3・§4.1.3 (address パラメータ)
+ * 99 は国外所在地を表す
+ */
+export const PREFECTURE_CODES = {
+    '01': '北海道',
+    '02': '青森県',
+    '03': '岩手県',
+    '04': '宮城県',
+    '05': '秋田県',
+    '06': '山形県',
+    '07': '福島県',
+    '08': '茨城県',
+    '09': '栃木県',
+    '10': '群馬県',
+    '11': '埼玉県',
+    '12': '千葉県',
+    '13': '東京都',
+    '14': '神奈川県',
+    '15': '新潟県',
+    '16': '富山県',
+    '17': '石川県',
+    '18': '福井県',
+    '19': '山梨県',
+    '20': '長野県',
+    '21': '岐阜県',
+    '22': '静岡県',
+    '23': '愛知県',
+    '24': '三重県',
+    '25': '滋賀県',
+    '26': '京都府',
+    '27': '大阪府',
+    '28': '兵庫県',
+    '29': '奈良県',
+    '30': '和歌山県',
+    '31': '鳥取県',
+    '32': '島根県',
+    '33': '岡山県',
+    '34': '広島県',
+    '35': '山口県',
+    '36': '徳島県',
+    '37': '香川県',
+    '38': '愛媛県',
+    '39': '高知県',
+    '40': '福岡県',
+    '41': '佐賀県',
+    '42': '長崎県',
+    '43': '熊本県',
+    '44': '大分県',
+    '45': '宮崎県',
+    '46': '鹿児島県',
+    '47': '沖縄県',
+    '99': '国外',
+};
+export function isPrefectureCode(value) {
+    return Object.prototype.hasOwnProperty.call(PREFECTURE_CODES, value);
+}
+export function prefectureName(code) {
+    if (isPrefectureCode(code)) {
+        return PREFECTURE_CODES[code];
+    }
+    return `unknown(${code})`;
+}
+//# sourceMappingURL=prefecture-codes.js.map

package/dist/domain/prefecture-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefecture-codes.js","sourceRoot":"","sources":["../../src/domain/prefecture-codes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,KAAK;IACX,IAAI,EAAE,IAAI;CACF,CAAC;AAIX,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,gBAAgB,EAAE,KAAK,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,WAAW,IAAI,GAAG,CAAC;AAC5B,CAAC"}

package/dist/domain/process-codes.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 処理区分コード辞書
+ * Process division code dictionary
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 別紙1 項番9 処理区分
+ */
+export declare const PROCESS_CODES: {
+    readonly '01': {
+        readonly ja: "新規";
+        readonly en: "Newly assigned";
+    };
+    readonly '11': {
+        readonly ja: "商号又は名称の変更";
+        readonly en: "Name change";
+    };
+    readonly '12': {
+        readonly ja: "国内所在地の変更";
+        readonly en: "Domestic address change";
+    };
+    readonly '13': {
+        readonly ja: "国外所在地の変更";
+        readonly en: "Foreign address change";
+    };
+    readonly '21': {
+        readonly ja: "登記記録の閉鎖等";
+        readonly en: "Registry closure";
+    };
+    readonly '22': {
+        readonly ja: "登記記録の復活等";
+        readonly en: "Registry revival";
+    };
+    readonly '71': {
+        readonly ja: "吸収合併";
+        readonly en: "Merger by absorption";
+    };
+    readonly '72': {
+        readonly ja: "吸収合併無効";
+        readonly en: "Merger invalidated";
+    };
+    readonly '81': {
+        readonly ja: "商号の登記の抹消";
+        readonly en: "Name registration cancelled";
+    };
+    readonly '99': {
+        readonly ja: "削除";
+        readonly en: "Deleted (duplicate/withdrawal)";
+    };
+};
+export type ProcessCode = keyof typeof PROCESS_CODES;
+export declare function isProcessCode(value: string): value is ProcessCode;
+export declare function processLabel(code: string, lang?: 'ja' | 'en'): string;
+//# sourceMappingURL=process-codes.d.ts.map

package/dist/domain/process-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-codes.d.ts","sourceRoot":"","sources":["../../src/domain/process-codes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAWhB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,aAAa,CAAC;AAErD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAEjE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,GAAG,IAAW,GAAG,MAAM,CAK3E"}

package/dist/domain/process-codes.js

@@ -0,0 +1,28 @@
+/**
+ * 処理区分コード辞書
+ * Process division code dictionary
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 別紙1 項番9 処理区分
+ */
+export const PROCESS_CODES = {
+    '01': { ja: '新規', en: 'Newly assigned' },
+    '11': { ja: '商号又は名称の変更', en: 'Name change' },
+    '12': { ja: '国内所在地の変更', en: 'Domestic address change' },
+    '13': { ja: '国外所在地の変更', en: 'Foreign address change' },
+    '21': { ja: '登記記録の閉鎖等', en: 'Registry closure' },
+    '22': { ja: '登記記録の復活等', en: 'Registry revival' },
+    '71': { ja: '吸収合併', en: 'Merger by absorption' },
+    '72': { ja: '吸収合併無効', en: 'Merger invalidated' },
+    '81': { ja: '商号の登記の抹消', en: 'Name registration cancelled' },
+    '99': { ja: '削除', en: 'Deleted (duplicate/withdrawal)' },
+};
+export function isProcessCode(value) {
+    return Object.prototype.hasOwnProperty.call(PROCESS_CODES, value);
+}
+export function processLabel(code, lang = 'ja') {
+    if (isProcessCode(code)) {
+        return PROCESS_CODES[code][lang];
+    }
+    return `unknown(${code})`;
+}
+//# sourceMappingURL=process-codes.js.map

package/dist/domain/process-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-codes.js","sourceRoot":"","sources":["../../src/domain/process-codes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,gBAAgB,EAAE;IACxC,IAAI,EAAE,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,aAAa,EAAE;IAC5C,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,yBAAyB,EAAE;IACvD,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,wBAAwB,EAAE;IACtD,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,kBAAkB,EAAE;IAChD,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,kBAAkB,EAAE;IAChD,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,sBAAsB,EAAE;IAChD,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,oBAAoB,EAAE;IAChD,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,6BAA6B,EAAE;IAC3D,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,gCAAgC,EAAE;CAChD,CAAC;AAIX,MAAM,UAAU,aAAa,CAAC,KAAa;IACzC,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,OAAoB,IAAI;IACjE,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,WAAW,IAAI,GAAG,CAAC;AAC5B,CAAC"}

package/dist/lib/env.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 環境変数の Zod validation
+ * Startup-time environment variable validation with Zod
+ * Validasi variabel lingkungan saat startup
+ */
+import { z } from 'zod';
+declare const EnvSchema: z.ZodObject<{
+    NTA_APPLICATION_ID: z.ZodString;
+    NTA_BASE_URL: z.ZodDefault<z.ZodString>;
+    PORT: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    LOG_LEVEL: z.ZodDefault<z.ZodEnum<{
+        error: "error";
+        debug: "debug";
+        info: "info";
+        fatal: "fatal";
+        warn: "warn";
+        trace: "trace";
+    }>>;
+    NODE_ENV: z.ZodDefault<z.ZodEnum<{
+        development: "development";
+        test: "test";
+        production: "production";
+    }>>;
+    NTA_RATE_LIMIT_RPS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+    NTA_TIMEOUT_MS: z.ZodDefault<z.ZodCoercedNumber<unknown>>;
+}, z.core.$strip>;
+export type Env = z.infer<typeof EnvSchema>;
+/**
+ * 環境変数を取得 (起動時に一度だけ parse、以降はキャッシュ)
+ */
+export declare function getEnv(): Env;
+/** テスト専用: 環境変数キャッシュをリセット */
+export declare function resetEnvCache(): void;
+export {};
+//# sourceMappingURL=env.d.ts.map

package/dist/lib/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,QAAA,MAAM,SAAS;;;;;;;;;;;;;;;;;;;iBAab,CAAC;AAEH,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAI5C;;GAEG;AACH,wBAAgB,MAAM,IAAI,GAAG,CAY5B;AAED,4BAA4B;AAC5B,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/lib/env.js

@@ -0,0 +1,40 @@
+/**
+ * 環境変数の Zod validation
+ * Startup-time environment variable validation with Zod
+ * Validasi variabel lingkungan saat startup
+ */
+import { z } from 'zod';
+const EnvSchema = z.object({
+    NTA_APPLICATION_ID: z
+        .string()
+        .min(1, 'NTA_APPLICATION_ID is required')
+        .describe('国税庁が発行したアプリケーション ID (13桁)。GitHub へのコミット厳禁。第一編 §5.1 参照。'),
+    NTA_BASE_URL: z.string().url().default('https://api.houjin-bangou.nta.go.jp/4'),
+    PORT: z.coerce.number().int().positive().default(3001),
+    LOG_LEVEL: z.enum(['fatal', 'error', 'warn', 'info', 'debug', 'trace']).default('info'),
+    NODE_ENV: z.enum(['development', 'test', 'production']).default('development'),
+    NTA_RATE_LIMIT_RPS: z.coerce.number().positive().default(1),
+    NTA_TIMEOUT_MS: z.coerce.number().int().positive().default(8000),
+});
+let cachedEnv;
+/**
+ * 環境変数を取得 (起動時に一度だけ parse、以降はキャッシュ)
+ */
+export function getEnv() {
+    if (cachedEnv === undefined) {
+        const result = EnvSchema.safeParse(process.env);
+        if (!result.success) {
+            const issues = result.error.issues
+                .map((i) => `  - ${i.path.join('.')}: ${i.message}`)
+                .join('\n');
+            throw new Error(`Invalid environment variables:\n${issues}`);
+        }
+        cachedEnv = result.data;
+    }
+    return cachedEnv;
+}
+/** テスト専用: 環境変数キャッシュをリセット */
+export function resetEnvCache() {
+    cachedEnv = undefined;
+}
+//# sourceMappingURL=env.js.map

package/dist/lib/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/lib/env.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,CAAC;IACzB,kBAAkB,EAAE,CAAC;SAClB,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,QAAQ,CACP,wDAAwD,CACzD;IACH,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,uCAAuC,CAAC;IAC/E,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IACtD,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACvF,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,aAAa,CAAC;IAC9E,kBAAkB,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3D,cAAc,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;CACjE,CAAC,CAAC;AAIH,IAAI,SAA0B,CAAC;AAE/B;;GAEG;AACH,MAAM,UAAU,MAAM;IACpB,IAAI,SAAS,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;iBAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;iBACnD,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,mCAAmC,MAAM,EAAE,CAAC,CAAC;QAC/D,CAAC;QACD,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,4BAA4B;AAC5B,MAAM,UAAU,aAAa;IAC3B,SAAS,GAAG,SAAS,CAAC;AACxB,CAAC"}

package/dist/lib/errors.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 型付きエラー階層
+ * Typed error hierarchy
+ * Hierarki error bertipe
+ *
+ * 根拠: SEP-1303 Input Validation Errors as Tool Execution Errors
+ *   → バリデーション失敗は JSON-RPC エラーではなく tool 結果 (isError: true) として返す
+ */
+export type NtaErrorCode = 'http_400' | 'http_403' | 'http_404' | 'http_500' | 'http_other' | 'timeout' | 'parse_error' | 'network_error' | 'unknown';
+/**
+ * 国税庁 API 由来のエラー
+ * Error originating from NTA Web-API
+ */
+export declare class NtaApiError extends Error {
+    readonly code: NtaErrorCode;
+    readonly httpStatus?: number | undefined;
+    readonly ntaErrorCode?: string | undefined;
+    readonly name = "NtaApiError";
+    constructor(message: string, code: NtaErrorCode, httpStatus?: number | undefined, ntaErrorCode?: string | undefined);
+    static fromHttpStatus(status: number, body?: string): NtaApiError;
+    static fromUnknown(err: unknown): NtaApiError;
+}
+/**
+ * 入力バリデーションエラー (SEP-1303 でツール実行エラーとして返却)
+ */
+export declare class InputValidationError extends Error {
+    readonly field?: string | undefined;
+    readonly guidance?: string | undefined;
+    readonly name = "InputValidationError";
+    constructor(message: string, field?: string | undefined, guidance?: string | undefined);
+}
+/**
+ * レート制限関連エラー
+ */
+export declare class RateLimitError extends Error {
+    readonly retryAfterMs: number;
+    readonly name = "RateLimitError";
+    constructor(message: string, retryAfterMs: number);
+}
+/**
+ * 未実装 (部分実装への明示的マーカー、Zero Placeholder 原則)
+ */
+export declare class NotImplementedError extends Error {
+    readonly name = "NotImplementedError";
+    constructor(feature: string, targetVersion: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/lib/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,MAAM,YAAY,GACpB,UAAU,GACV,UAAU,GACV,UAAU,GACV,UAAU,GACV,YAAY,GACZ,SAAS,GACT,aAAa,GACb,eAAe,GACf,SAAS,CAAC;AAEd;;;GAGG;AACH,qBAAa,WAAY,SAAQ,KAAK;aAIlB,IAAI,EAAE,YAAY;aAClB,UAAU,CAAC,EAAE,MAAM;aACnB,YAAY,CAAC,EAAE,MAAM;IALvC,SAAkB,IAAI,iBAAiB;gBAErC,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,YAAY,EAClB,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,YAAY,CAAC,EAAE,MAAM,YAAA;IAKvC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW;IAwBjE,MAAM,CAAC,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,WAAW;CAU9C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;aAI3B,KAAK,CAAC,EAAE,MAAM;aACd,QAAQ,CAAC,EAAE,MAAM;IAJnC,SAAkB,IAAI,0BAA0B;gBAE9C,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,QAAQ,CAAC,EAAE,MAAM,YAAA;CAIpC;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;aAIrB,YAAY,EAAE,MAAM;IAHtC,SAAkB,IAAI,oBAAoB;gBAExC,OAAO,EAAE,MAAM,EACC,YAAY,EAAE,MAAM;CAIvC;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAkB,IAAI,yBAAyB;gBACnC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAGnD"}