@sugukuru/mcp-houjin-bangou 0.2.0

package/dist/completion/handler.js

@@ -0,0 +1,136 @@
+/**
+ * MCP Completion handler (completion/complete)
+ *
+ * Resource Template `corp://{corporate_number}` の引数補完では、
+ * normalizeCompanyName (T7) を裏で駆動して会社名ベースの候補を返す実装も可能だが、
+ * corporate_number は数字13桁なので、国税庁 API を叩かず「ローカルでのチェックデジット
+ * 検証済み候補」を補完対象とする。
+ *
+ * 根拠 / Source: MCP 公式仕様 server/utilities/completion
+ *   values: max 100 items
+ *   total: optional
+ *   hasMore: boolean
+ */
+import { CompleteRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { normalizeCompanyName } from '../domain/normalizer.js';
+export function registerCompletionHandler(server, deps) {
+    server.setRequestHandler(CompleteRequestSchema, async (req) => {
+        const { ref, argument } = req.params;
+        deps.logger.debug('completion.request', {
+            refType: ref.type,
+            argName: argument.name,
+            valueLength: argument.value.length,
+        });
+        // Prompt 引数補完 (v0.2.0 で prompt 実装時に動く)
+        if (ref.type === 'ref/prompt') {
+            return completePromptArgument(ref.name ?? '', argument.name, argument.value);
+        }
+        // Resource Template 引数補完
+        if (ref.type === 'ref/resource') {
+            const uri = 'uri' in ref ? ref.uri : '';
+            if (uri.startsWith('corp://')) {
+                return completeCorporateNumber(argument.value);
+            }
+        }
+        return {
+            completion: {
+                values: [],
+                total: 0,
+                hasMore: false,
+            },
+        };
+    });
+}
+/**
+ * corp://{corporate_number} の補完
+ * 入力が数字でない場合は T7 normalizer で会社名候補を返す (参考情報として)
+ */
+function completeCorporateNumber(value) {
+    const trimmed = value.trim();
+    if (/^\d+$/.test(trimmed)) {
+        // 途中までの数字が入力された場合、現時点では候補提示なし
+        // (国税庁 API に部分マッチ検索がないため、数字途中からの補完は仕様上不可)
+        return {
+            completion: {
+                values: [],
+                total: 0,
+                hasMore: false,
+            },
+        };
+    }
+    // 会社名が入力された場合、T7 で候補化して参考情報として返す
+    // 注: URI テンプレートの変数は13桁数字を期待するため、これらは「search_corporate_by_name で
+    //     使用できる候補」として提示される (MCP ホストが UI で補完候補を表示する際の参考)
+    if (trimmed.length > 0) {
+        const normalized = normalizeCompanyName(trimmed);
+        const values = normalized.normalized_candidates.slice(0, 20).map((c) => c.name);
+        return {
+            completion: {
+                values,
+                total: values.length,
+                hasMore: false,
+            },
+        };
+    }
+    return {
+        completion: {
+            values: [],
+            total: 0,
+            hasMore: false,
+        },
+    };
+}
+/**
+ * Prompt 引数の補完
+ *
+ * - business-card-to-database: target_database_format (enum)
+ * - sales-list-enrichment: output_format (enum)
+ * - customer-master-dedup: dedup_criteria (enum)
+ */
+function completePromptArgument(promptName, argName, value) {
+    const enumMap = {
+        'business-card-to-database': {
+            target_database_format: ['crm_json', 'salesforce_csv', 'hubspot_properties', 'plain_summary'],
+        },
+        'sales-list-enrichment': {
+            output_format: ['markdown_table', 'csv', 'jsonl'],
+        },
+        'customer-master-dedup': {
+            dedup_criteria: ['strict_corporate_number', 'fuzzy_name_address', 'conservative_flag_only'],
+        },
+    };
+    const enumValues = enumMap[promptName]?.[argName];
+    if (enumValues !== undefined) {
+        const filtered = enumValues.filter((v) => v.startsWith(value));
+        return {
+            completion: {
+                values: filtered,
+                total: filtered.length,
+                hasMore: false,
+            },
+        };
+    }
+    if (argName === 'company_name' || argName === 'name' || argName === 'raw_input') {
+        const trimmed = value.trim();
+        if (trimmed.length === 0) {
+            return { completion: { values: [], total: 0, hasMore: false } };
+        }
+        const normalized = normalizeCompanyName(trimmed);
+        const values = normalized.normalized_candidates.slice(0, 20).map((c) => c.name);
+        return {
+            completion: {
+                values,
+                total: values.length,
+                hasMore: false,
+            },
+        };
+    }
+    return {
+        completion: {
+            values: [],
+            total: 0,
+            hasMore: false,
+        },
+    };
+}
+//# sourceMappingURL=handler.js.map

package/dist/completion/handler.js.map

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

package/dist/domain/check-digit.d.ts

@@ -0,0 +1,47 @@
+/**
+ * 法人番号のチェックデジット計算
+ * Corporate number check digit computation
+ * Komputasi check digit nomor perusahaan
+ *
+ * 根拠 / Source / Sumber:
+ *   国税庁「法人番号システム Web-API 機能仕様書 第二編 1.2版」
+ *   第二編 §2「法人番号を指定して情報を取得する機能」
+ *   法人番号 = 13桁 = チェックデジット (1桁) + 基礎番号 (12桁)
+ *
+ * 計算式:
+ *   c = 9 - ( Σ_{n=1}^{12} (P_n × Q_n) mod 9 )
+ *   ただし c が 0 のとき c = 9 として扱う
+ *
+ *   P_n: 12 桁の基礎番号の各桁 (右から 1 桁目を P_1)
+ *   Q_n: n が偶数なら 1, 奇数なら 2
+ */
+/**
+ * 12 桁の基礎番号からチェックデジット (1桁) を計算
+ * Compute check digit from 12-digit basis number
+ * Menghitung check digit dari 12 digit basis
+ *
+ * 実検証により、P_n は左から n 桁目 (1-indexed) として扱う必要がある。
+ * 奇数位置 (n=1,3,5,...) は Q_n=2、偶数位置 (n=2,4,6,...) は Q_n=1。
+ * 国税庁公表の check_digit.pdf の計算例 5111101000006 等で検証済み。
+ */
+export declare function computeCheckDigit(twelveDigits: string): number;
+/**
+ * 13 桁文字列がチェックデジットとして妥当かを検証
+ * Verify 13-digit string has a valid check digit
+ * Memverifikasi bahwa string 13-digit memiliki check digit valid
+ */
+export declare function isValidCheckDigit(thirteenDigits: string): boolean;
+/**
+ * 文字列の正規化 + チェックデジット検証を一括実施
+ * Normalize (full-width, hyphens, spaces) + validate check digit
+ * Normalisasi lalu verifikasi check digit
+ */
+export declare function normalizeAndValidateCorporateNumber(raw: string): {
+    isValid: true;
+    normalized: string;
+} | {
+    isValid: false;
+    reason: ValidationReason;
+};
+export type ValidationReason = 'not_13_digits' | 'check_digit_mismatch' | 'invalid_characters' | 'first_digit_zero';
+//# sourceMappingURL=check-digit.d.ts.map

package/dist/domain/check-digit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-digit.d.ts","sourceRoot":"","sources":["../../src/domain/check-digit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAiB9D;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAWjE;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,GAAG,EAAE,MAAM,GACV;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,gBAAgB,CAAA;CAAE,CAuBtF;AAED,MAAM,MAAM,gBAAgB,GACxB,eAAe,GACf,sBAAsB,GACtB,oBAAoB,GACpB,kBAAkB,CAAC"}

package/dist/domain/check-digit.js

@@ -0,0 +1,91 @@
+/**
+ * 法人番号のチェックデジット計算
+ * Corporate number check digit computation
+ * Komputasi check digit nomor perusahaan
+ *
+ * 根拠 / Source / Sumber:
+ *   国税庁「法人番号システム Web-API 機能仕様書 第二編 1.2版」
+ *   第二編 §2「法人番号を指定して情報を取得する機能」
+ *   法人番号 = 13桁 = チェックデジット (1桁) + 基礎番号 (12桁)
+ *
+ * 計算式:
+ *   c = 9 - ( Σ_{n=1}^{12} (P_n × Q_n) mod 9 )
+ *   ただし c が 0 のとき c = 9 として扱う
+ *
+ *   P_n: 12 桁の基礎番号の各桁 (右から 1 桁目を P_1)
+ *   Q_n: n が偶数なら 1, 奇数なら 2
+ */
+/**
+ * 12 桁の基礎番号からチェックデジット (1桁) を計算
+ * Compute check digit from 12-digit basis number
+ * Menghitung check digit dari 12 digit basis
+ *
+ * 実検証により、P_n は左から n 桁目 (1-indexed) として扱う必要がある。
+ * 奇数位置 (n=1,3,5,...) は Q_n=2、偶数位置 (n=2,4,6,...) は Q_n=1。
+ * 国税庁公表の check_digit.pdf の計算例 5111101000006 等で検証済み。
+ */
+export function computeCheckDigit(twelveDigits) {
+    if (!/^\d{12}$/.test(twelveDigits)) {
+        throw new Error('twelveDigits must be exactly 12 digit characters');
+    }
+    let sum = 0;
+    for (let n = 1; n <= 12; n++) {
+        const digitChar = twelveDigits[n - 1];
+        if (digitChar === undefined) {
+            throw new Error('Unexpected index out of range');
+        }
+        const digit = Number(digitChar);
+        const q = n % 2 === 0 ? 1 : 2;
+        sum += digit * q;
+    }
+    const mod = sum % 9;
+    const c = 9 - mod;
+    return c === 0 ? 9 : c;
+}
+/**
+ * 13 桁文字列がチェックデジットとして妥当かを検証
+ * Verify 13-digit string has a valid check digit
+ * Memverifikasi bahwa string 13-digit memiliki check digit valid
+ */
+export function isValidCheckDigit(thirteenDigits) {
+    if (!/^\d{13}$/.test(thirteenDigits))
+        return false;
+    const firstChar = thirteenDigits[0];
+    if (firstChar === undefined)
+        return false;
+    const checkDigit = Number(firstChar);
+    if (checkDigit === 0) {
+        // 先頭が 0 の場合、チェックデジットとして無効 (1-9)
+        return false;
+    }
+    const basis = thirteenDigits.slice(1);
+    return computeCheckDigit(basis) === checkDigit;
+}
+/**
+ * 文字列の正規化 + チェックデジット検証を一括実施
+ * Normalize (full-width, hyphens, spaces) + validate check digit
+ * Normalisasi lalu verifikasi check digit
+ */
+export function normalizeAndValidateCorporateNumber(raw) {
+    if (raw.length === 0) {
+        return { isValid: false, reason: 'not_13_digits' };
+    }
+    // 全角数字を半角に、ハイフン/空白を除去
+    const normalized = raw
+        .replace(/[\uFF10-\uFF19]/g, (ch) => String.fromCharCode(ch.charCodeAt(0) - 0xfee0))
+        .replace(/[\s\-\u2010-\u2015\u30FC]/g, '');
+    if (!/^\d+$/.test(normalized)) {
+        return { isValid: false, reason: 'invalid_characters' };
+    }
+    if (normalized.length !== 13) {
+        return { isValid: false, reason: 'not_13_digits' };
+    }
+    if (normalized[0] === '0') {
+        return { isValid: false, reason: 'first_digit_zero' };
+    }
+    if (!isValidCheckDigit(normalized)) {
+        return { isValid: false, reason: 'check_digit_mismatch' };
+    }
+    return { isValid: true, normalized };
+}
+//# sourceMappingURL=check-digit.js.map

package/dist/domain/check-digit.js.map

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

package/dist/domain/close-cause-codes.d.ts

@@ -0,0 +1,28 @@
+/**
+ * 登記記録の閉鎖等の事由コード辞書
+ * Registry closure cause code dictionary
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 別紙1 項番26 登記記録の閉鎖等の事由
+ */
+export declare const CLOSE_CAUSE_CODES: {
+    readonly '01': {
+        readonly ja: "清算の結了等";
+        readonly en: "Liquidation completed";
+    };
+    readonly '11': {
+        readonly ja: "合併による解散等";
+        readonly en: "Dissolved via merger";
+    };
+    readonly '21': {
+        readonly ja: "登記官による閉鎖";
+        readonly en: "Closed by registrar (Article 81)";
+    };
+    readonly '31': {
+        readonly ja: "その他の清算の結了等";
+        readonly en: "Other liquidation (non-registered juridical persons)";
+    };
+};
+export type CloseCauseCode = keyof typeof CLOSE_CAUSE_CODES;
+export declare function isCloseCauseCode(value: string): value is CloseCauseCode;
+export declare function closeCauseLabel(code: string, lang?: 'ja' | 'en'): string;
+//# sourceMappingURL=close-cause-codes.d.ts.map

package/dist/domain/close-cause-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-cause-codes.d.ts","sourceRoot":"","sources":["../../src/domain/close-cause-codes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;CAQpB,CAAC;AAEX,MAAM,MAAM,cAAc,GAAG,MAAM,OAAO,iBAAiB,CAAC;AAE5D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,cAAc,CAEvE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,IAAI,GAAG,IAAW,GAAG,MAAM,CAM9E"}

package/dist/domain/close-cause-codes.js

@@ -0,0 +1,27 @@
+/**
+ * 登記記録の閉鎖等の事由コード辞書
+ * Registry closure cause code dictionary
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 別紙1 項番26 登記記録の閉鎖等の事由
+ */
+export const CLOSE_CAUSE_CODES = {
+    '01': { ja: '清算の結了等', en: 'Liquidation completed' },
+    '11': { ja: '合併による解散等', en: 'Dissolved via merger' },
+    '21': { ja: '登記官による閉鎖', en: 'Closed by registrar (Article 81)' },
+    '31': {
+        ja: 'その他の清算の結了等',
+        en: 'Other liquidation (non-registered juridical persons)',
+    },
+};
+export function isCloseCauseCode(value) {
+    return Object.prototype.hasOwnProperty.call(CLOSE_CAUSE_CODES, value);
+}
+export function closeCauseLabel(code, lang = 'ja') {
+    if (code === '' || code === undefined)
+        return '';
+    if (isCloseCauseCode(code)) {
+        return CLOSE_CAUSE_CODES[code][lang];
+    }
+    return `unknown(${code})`;
+}
+//# sourceMappingURL=close-cause-codes.js.map

package/dist/domain/close-cause-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"close-cause-codes.js","sourceRoot":"","sources":["../../src/domain/close-cause-codes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,IAAI,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,uBAAuB,EAAE;IACnD,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,sBAAsB,EAAE;IACpD,IAAI,EAAE,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,kCAAkC,EAAE;IAChE,IAAI,EAAE;QACJ,EAAE,EAAE,YAAY;QAChB,EAAE,EAAE,sDAAsD;KAC3D;CACO,CAAC;AAIX,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,iBAAiB,EAAE,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,OAAoB,IAAI;IACpE,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACjD,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3B,OAAO,iBAAiB,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,WAAW,IAAI,GAAG,CAAC;AAC5B,CAAC"}

package/dist/domain/corporate-number.d.ts

@@ -0,0 +1,81 @@
+/**
+ * 法人番号の Branded Type + Zod スキーマ
+ * Corporate number Branded Type + Zod schema
+ * Tipe branded + skema Zod untuk nomor perusahaan
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 §2.1.3 (13桁半角数字、チェックデジット付き)
+ */
+import { z } from 'zod';
+/**
+ * 13 桁・チェックデジット検証済の法人番号を表す Branded Type
+ * Branded type representing a validated 13-digit corporate number
+ */
+export declare const CorporateNumberSchema: z.core.$ZodBranded<z.ZodString, "CorporateNumber", "out">;
+export type CorporateNumber = z.infer<typeof CorporateNumberSchema>;
+/**
+ * 政府標準利用規約 + Web-API 利用規約 別添1 第6条 遵守のための出典情報
+ * Attribution field required by NTA Web-API Terms Article 6 and 公共データ利用規約 第1.0版
+ *
+ * 根拠: 国税庁仕様書 第一編 別添1 第6条・別添3 公共データ利用規約 第1.0版
+ */
+export declare const AttributionSchema: z.ZodObject<{
+    data_source: z.ZodString;
+    service_disclaimer: z.ZodString;
+    license: z.ZodLiteral<"公共データ利用規約 第1.0版">;
+    api_version: z.ZodLiteral<"Ver.4.0">;
+    accessed_at: z.ZodString;
+}, z.core.$strip>;
+export type Attribution = z.infer<typeof AttributionSchema>;
+/**
+ * 標準出典文を生成
+ * Generate standard attribution record
+ */
+export declare function buildAttribution(): Attribution;
+/**
+ * 国税庁レスポンスから MCP 出力形式の法人情報へ変換
+ * Canonical internal shape for corporate info
+ * 参考: 第二編 別紙1 リソース定義書 (36 項目)
+ */
+export declare const CorporationSchema: z.ZodObject<{
+    corporate_number: z.ZodString;
+    sequence_number: z.ZodNumber;
+    process: z.ZodString;
+    correct: z.ZodEnum<{
+        0: "0";
+        1: "1";
+    }>;
+    update_date: z.ZodString;
+    change_date: z.ZodString;
+    name: z.ZodString;
+    name_image_id: z.ZodString;
+    kind: z.ZodString;
+    prefecture_name: z.ZodString;
+    city_name: z.ZodString;
+    street_number: z.ZodString;
+    address_image_id: z.ZodString;
+    prefecture_code: z.ZodString;
+    city_code: z.ZodString;
+    post_code: z.ZodString;
+    address_outside: z.ZodString;
+    address_outside_image_id: z.ZodString;
+    close_date: z.ZodString;
+    close_cause: z.ZodString;
+    successor_corporate_number: z.ZodString;
+    change_cause: z.ZodString;
+    assignment_date: z.ZodString;
+    latest: z.ZodEnum<{
+        0: "0";
+        1: "1";
+    }>;
+    en_name: z.ZodString;
+    en_prefecture_name: z.ZodString;
+    en_city_name: z.ZodString;
+    en_address_outside: z.ZodString;
+    furigana: z.ZodString;
+    hihyoji: z.ZodEnum<{
+        0: "0";
+        1: "1";
+    }>;
+}, z.core.$strip>;
+export type Corporation = z.infer<typeof CorporationSchema>;
+//# sourceMappingURL=corporate-number.d.ts.map

package/dist/domain/corporate-number.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"corporate-number.d.ts","sourceRoot":"","sources":["../../src/domain/corporate-number.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB,2DAML,CAAC;AAE9B,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;iBAY5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,WAAW,CAS9C;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA+B5B,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/domain/corporate-number.js

@@ -0,0 +1,88 @@
+/**
+ * 法人番号の Branded Type + Zod スキーマ
+ * Corporate number Branded Type + Zod schema
+ * Tipe branded + skema Zod untuk nomor perusahaan
+ *
+ * 根拠 / Source: 国税庁仕様書 第二編 §2.1.3 (13桁半角数字、チェックデジット付き)
+ */
+import { z } from 'zod';
+import { isValidCheckDigit } from './check-digit.js';
+/**
+ * 13 桁・チェックデジット検証済の法人番号を表す Branded Type
+ * Branded type representing a validated 13-digit corporate number
+ */
+export const CorporateNumberSchema = z
+    .string()
+    .regex(/^\d{13}$/, '法人番号は半角数字 13 桁です / Must be 13 half-width digits')
+    .refine(isValidCheckDigit, {
+    message: 'チェックデジットが一致しません / Check digit mismatch',
+})
+    .brand();
+/**
+ * 政府標準利用規約 + Web-API 利用規約 別添1 第6条 遵守のための出典情報
+ * Attribution field required by NTA Web-API Terms Article 6 and 公共データ利用規約 第1.0版
+ *
+ * 根拠: 国税庁仕様書 第一編 別添1 第6条・別添3 公共データ利用規約 第1.0版
+ */
+export const AttributionSchema = z.object({
+    data_source: z
+        .string()
+        .describe('データ出典 / Data source / Sumber data (公共データ利用規約 第1.0版 に基づく)'),
+    service_disclaimer: z
+        .string()
+        .describe('利用規約別添1 第6条で求められる指定文言 / Required disclaimer per Article 6 of NTA Web-API ToS'),
+    license: z.literal('公共データ利用規約 第1.0版').describe('ライセンス / License'),
+    api_version: z.literal('Ver.4.0').describe('国税庁 Web-API バージョン'),
+    accessed_at: z.string().describe('アクセス日時 / Accessed at (ISO 8601)'),
+});
+/**
+ * 標準出典文を生成
+ * Generate standard attribution record
+ */
+export function buildAttribution() {
+    return {
+        data_source: '国税庁法人番号公表サイト（国税庁）https://www.houjin-bangou.nta.go.jp/',
+        service_disclaimer: 'このサービスは、国税庁法人番号システム Web-API 機能を利用して取得した情報をもとに作成しているが、サービスの内容は国税庁によって保証されたものではない。',
+        license: '公共データ利用規約 第1.0版',
+        api_version: 'Ver.4.0',
+        accessed_at: new Date().toISOString(),
+    };
+}
+/**
+ * 国税庁レスポンスから MCP 出力形式の法人情報へ変換
+ * Canonical internal shape for corporate info
+ * 参考: 第二編 別紙1 リソース定義書 (36 項目)
+ */
+export const CorporationSchema = z.object({
+    corporate_number: z.string().describe('法人番号 (13桁)'),
+    sequence_number: z.number().int().describe('一連番号 (第二編 項番7)'),
+    process: z.string().describe('処理区分 (01=新規 / 11=商号変更 / 12=所在地変更 ...)'),
+    correct: z.enum(['0', '1']).describe('訂正区分 (0=訂正以外 / 1=訂正)'),
+    update_date: z.string().describe('更新年月日 YYYY-MM-DD'),
+    change_date: z.string().describe('変更年月日 YYYY-MM-DD'),
+    name: z.string().describe('商号又は名称'),
+    name_image_id: z.string().describe('商号イメージID (JIS 第1/2水準外 or 150字超)'),
+    kind: z.string().describe('法人種別コード (101/201/301/302/303/304/305/399/401/499)'),
+    prefecture_name: z.string().describe('国内所在地 都道府県'),
+    city_name: z.string().describe('国内所在地 市区町村'),
+    street_number: z.string().describe('国内所在地 丁目番地等'),
+    address_image_id: z.string().describe('国内所在地イメージID'),
+    prefecture_code: z.string().describe('都道府県コード (JIS X 0401)'),
+    city_code: z.string().describe('市区町村コード (JIS X 0402)'),
+    post_code: z.string().describe('郵便番号 (7桁)'),
+    address_outside: z.string().describe('国外所在地'),
+    address_outside_image_id: z.string().describe('国外所在地イメージID'),
+    close_date: z.string().describe('登記記録の閉鎖等年月日'),
+    close_cause: z.string().describe('登記記録の閉鎖等の事由 (01/11/21/31)'),
+    successor_corporate_number: z.string().describe('承継先法人番号'),
+    change_cause: z.string().describe('変更事由の詳細'),
+    assignment_date: z.string().describe('法人番号指定年月日'),
+    latest: z.enum(['0', '1']).describe('最新履歴 (0=過去 / 1=最新)'),
+    en_name: z.string().describe('商号又は名称 (英語表記)'),
+    en_prefecture_name: z.string().describe('国内所在地 都道府県 (英語表記)'),
+    en_city_name: z.string().describe('国内所在地 市区町村丁目番地等 (英語表記)'),
+    en_address_outside: z.string().describe('国外所在地 (英語表記)'),
+    furigana: z.string().describe('フリガナ (全角カタカナ・長音のみ)'),
+    hihyoji: z.enum(['0', '1']).describe('検索対象除外 (0=対象 / 1=除外、Ver.4.0 追加)'),
+});
+//# sourceMappingURL=corporate-number.js.map

package/dist/domain/corporate-number.js.map

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