promptkaizen-agent 0.6.3 → 0.7.2

package/dist/secret-detector.js

@@ -1,120 +1,48 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SecretDetector = exports.MAX_DETECTIONS_PER_ENTRY = void 0;
-exports.normalizeForDetection = normalizeForDetection;
-exports.luhnValid = luhnValid;
-exports.isValidMyNumber = isValidMyNumber;
-exports.isValidCorporateNumber = isValidCorporateNumber;
-exports.shannonEntropy = shannonEntropy;
+exports.SecretDetector = exports.MAX_DETECTIONS_PER_ENTRY = exports.normalizeWithMap = exports.isLikelyCredential = exports.shannonEntropy = exports.isValidCorporateNumber = exports.isValidMyNumber = exports.luhnValid = exports.normalizeForDetection = void 0;
 exports.maskMatch = maskMatch;
 exports.hashMatch = hashMatch;
 exports.hmacHash = hmacHash;
 exports.collectStrings = collectStrings;
-exports.isLikelyCredential = isLikelyCredential;
 const crypto_1 = require("crypto");
+// =============================================
+// 流出検知 (Issue #42 / Phase S1) — 検出・記録レイヤ
+// =============================================
+//
+// pii-masker.ts が「送信前に伏せる(マスキング)」なのに対し、本モジュールは
+// 「何が貼られたかを統制側が把握する(検出・記録)」が目的。両者は別レイヤとして
+// 同じ前処理パイプラインに差し込まれる。
+//
+// **ルール定義そのものは本ファイルに持たない (R1/T1)。**
+// 正は shared/src/detection/rules.ts で、`npm run sync:detection` が
+// agent/src/detection/ へコピーする。以前はここに独自のルール表があり、
+// extension 側の表とドリフトして「high と判定したカード番号が伏字にならない」
+// 事故を生んだ。本ファイルはハッシュ化・集計・キャップなど agent 固有の責務のみ扱う。
+//
+// 重要 (受け入れ条件): 検知結果は生機密本文を一切持たない。category・ruleId・
+// severity・count・マスク済みプレビュー・マッチのハッシュのみを保持し、クラウドへ
+// 送るのもこのメタデータだけ。
+//
+// 誤検知方針 / 閾値は agent/docs/leak-detection.md に文書化。
+const detection_1 = require("./detection");
+var detection_2 = require("./detection");
+Object.defineProperty(exports, "normalizeForDetection", { enumerable: true, get: function () { return detection_2.normalizeForDetection; } });
+Object.defineProperty(exports, "luhnValid", { enumerable: true, get: function () { return detection_2.luhnValid; } });
+Object.defineProperty(exports, "isValidMyNumber", { enumerable: true, get: function () { return detection_2.isValidMyNumber; } });
+Object.defineProperty(exports, "isValidCorporateNumber", { enumerable: true, get: function () { return detection_2.isValidCorporateNumber; } });
+Object.defineProperty(exports, "shannonEntropy", { enumerable: true, get: function () { return detection_2.shannonEntropy; } });
+Object.defineProperty(exports, "isLikelyCredential", { enumerable: true, get: function () { return detection_2.isLikelyCredential; } });
+Object.defineProperty(exports, "normalizeWithMap", { enumerable: true, get: function () { return detection_2.normalizeWithMap; } });
 /** 1 entry あたりの検知メタ上限。超過分は重大度順 (high>medium>low) で切り捨てる。 */
 exports.MAX_DETECTIONS_PER_ENTRY = 50;
-// ---------------------------------------------
-// 正規化前処理 (全角→半角 / 単一桁の漢数字→算用数字)
-// ---------------------------------------------
-// NFKC で全角英数字・記号を半角化 (例: ＳＫ-… / １２３ → SK-… / 123)。
-// 漢数字は位取り (十/百/千) の誤変換を避け、単一桁文字のみ算用数字へ寄せる。
-const KANJI_DIGITS = {
-    〇: '0',
-    零: '0',
-    一: '1',
-    二: '2',
-    三: '3',
-    四: '4',
-    五: '5',
-    六: '6',
-    七: '7',
-    八: '8',
-    九: '9',
-};
-function normalizeForDetection(text) {
-    let t = text.normalize('NFKC');
-    t = t.replace(/[〇零一二三四五六七八九]/g, (c) => KANJI_DIGITS[c] ?? c);
-    return t;
-}
-// ---------------------------------------------
-// 検証ヘルパ (誤検知抑制)
-// ---------------------------------------------
-/** クレジットカード番号の Luhn チェック (13〜19 桁)。 */
-function luhnValid(value) {
-    const digits = value.replace(/\D/g, '');
-    if (digits.length < 13 || digits.length > 19)
-        return false;
-    let sum = 0;
-    let alt = false;
-    for (let i = digits.length - 1; i >= 0; i--) {
-        let d = Number(digits[i]);
-        if (alt) {
-            d *= 2;
-            if (d > 9)
-                d -= 9;
-        }
-        sum += d;
-        alt = !alt;
-    }
-    return sum % 10 === 0;
-}
-/** マイナンバー (個人番号, 12 桁) のチェックデジット検証。 */
-function isValidMyNumber(value) {
-    const d = value.replace(/\D/g, '');
-    if (!/^\d{12}$/.test(d))
-        return false;
-    const body = d.slice(0, 11);
-    const check = Number(d[11]);
-    let sum = 0;
-    for (let n = 1; n <= 11; n++) {
-        const pn = Number(body[11 - n]); // body 最下位を 1 桁目
-        const qn = n <= 6 ? n + 1 : n - 5;
-        sum += pn * qn;
-    }
-    const r = sum % 11;
-    const expected = r <= 1 ? 0 : 11 - r;
-    return expected === check;
-}
-/** 法人番号 (13 桁) のチェックデジット検証 (先頭 1 桁が検査数字)。 */
-function isValidCorporateNumber(value) {
-    const d = value.replace(/\D/g, '');
-    if (!/^\d{13}$/.test(d))
-        return false;
-    const check = Number(d[0]);
-    const body = d.slice(1); // 12 桁
-    let sum = 0;
-    for (let n = 1; n <= 12; n++) {
-        const pn = Number(body[12 - n]);
-        const qn = n % 2 === 1 ? 1 : 2;
-        sum += pn * qn;
-    }
-    const r = sum % 9;
-    const expected = 9 - r;
-    return expected === check;
-}
-/** Shannon エントロピー (bits/char)。高エントロピー文字列の「シークレットらしさ」。 */
-function shannonEntropy(s) {
-    if (s.length === 0)
-        return 0;
-    const freq = {};
-    for (const ch of s)
-        freq[ch] = (freq[ch] ?? 0) + 1;
-    let e = 0;
-    for (const k of Object.keys(freq)) {
-        const p = freq[k] / s.length;
-        e -= p * Math.log2(p);
-    }
-    return e;
-}
-// エントロピー検出の閾値 (誤検知抑制のため正規表現と併用)。詳細は docs 参照。
-const ENTROPY_MIN_LENGTH = 20;
-const ENTROPY_THRESHOLD = 4.0; // bits/char
+/** ブロック理由に出す抜粋の最大長。 */
+const SNIPPET_MAX_CHARS = 120;
 /**
  * 復元不能なマスク済みプレビュー。
- * - pii / pii_jp: 末尾 2 文字のみ可視 (`…18`)。マイナンバー等の低エントロピー値は
+ * - pii / pii_jp: 末尾 2 文字のみ可視。マイナンバー等の低エントロピー値は
  *   先頭を見せると桁の大半が漏れるため、先頭は一切露出しない。
- * - secret / custom: 先頭 4 + 末尾 2 文字のみ可視 (`sk-a…yz`)。prefix によるキー種別の
+ * - secret / custom: 先頭 4 + 末尾 2 文字のみ可視。prefix によるキー種別の
  *   識別性を優先 (高エントロピー値のため 6 文字露出しても復元不能)。
  */
 function maskMatch(value, category) {
@@ -137,12 +65,12 @@ function hashMatch(value) {
  * マイナンバー (10^12 通り) のような低エントロピー値は無塩 sha256 だと総当たりで
  * 復元できてしまうため、ローカル鍵 (クラウドへ送らない) で鍵付きハッシュにする。
  */
-function hmacHash(value, secret) {
-    return (0, crypto_1.createHmac)('sha256', secret).update(value).digest('hex').slice(0, 12);
+function hmacHash(value, secretKey) {
+    return (0, crypto_1.createHmac)('sha256', secretKey).update(value).digest('hex').slice(0, 12);
 }
 /**
  * 任意のパース済み値 (entry.raw) から全 string を再帰収集して連結する。
- * JSON.stringify だとエスケープ (\n, \") でパターンが壊れるため、生の string を集める。
+ * JSON.stringify だとエスケープでパターンが壊れるため、生の string を集める。
  * maxChars で総量を上限化 (巨大 entry でのメモリ/CPU 暴発を防止)。
  */
 function collectStrings(value, maxChars = 200_000) {
@@ -167,251 +95,42 @@ function collectStrings(value, maxChars = 200_000) {
     walk(value);
     return parts.join('\n');
 }
-// ---------------------------------------------
-// マスキング用ラベル / 補助 (Issue #104 redact 用)
-// ---------------------------------------------
-//
-// redact() が伏せ字に使う置換ラベル。pii-masker.ts が従来使っていた表記を保持し
-// (ダッシュボード / 既存テストとの整合)、未定義の ruleId は `[MASKED_<RULEID>]` に倒す。
-const REDACTION_LABELS = {
-    aws_access_key: '[MASKED_AWS_KEY]',
-    gcp_api_key: '[MASKED_GCP_KEY]',
-    bearer_token: 'Bearer [MASKED_TOKEN]',
-    private_key_block: '[MASKED_PRIVATE_KEY]',
-    high_entropy: '[MASKED_SECRET]',
-    credit_card: '[MASKED_CREDIT_CARD]',
-    jp_mynumber: '[MASKED_MYNUMBER]',
-    generic_credential: '[MASKED_CREDENTIAL]',
-};
-function redactionLabel(ruleId) {
-    return REDACTION_LABELS[ruleId] ?? `[MASKED_${ruleId.toUpperCase()}]`;
-}
-/** start 昇順 → 長い順に整列し、貪欲に非重複なスパンだけ残す (redact 用)。 */
-function selectNonOverlapping(spans) {
-    spans.sort((a, b) => a.start - b.start || b.end - b.start - (a.end - a.start));
-    const out = [];
-    let lastEnd = -1;
-    for (const s of spans) {
-        if (s.start >= lastEnd) {
-            out.push(s);
-            lastEnd = s.end;
-        }
-    }
-    return out;
-}
-// 秘密鍵 (PEM) は検出ルール (private_key_block) が BEGIN 行のみを拾うのに対し、
-// マスキングでは鍵本体ごと伏せないと平文が残る (#104)。BEGIN〜END を一括で伏せる。
-const PEM_BLOCK = /-----BEGIN (?:RSA |EC |OPENSSH |DSA |PGP )?PRIVATE KEY-----[\s\S]*?-----END (?:RSA |EC |OPENSSH |DSA |PGP )?PRIVATE KEY-----/g;
-// 都道府県 (住所検出用)。
-const PREFECTURES = '北海道|青森県|岩手県|宮城県|秋田県|山形県|福島県|茨城県|栃木県|群馬県|埼玉県|千葉県|東京都|神奈川県|新潟県|富山県|石川県|福井県|山梨県|長野県|岐阜県|静岡県|愛知県|三重県|滋賀県|京都府|大阪府|兵庫県|奈良県|和歌山県|鳥取県|島根県|岡山県|広島県|山口県|徳島県|香川県|愛媛県|高知県|福岡県|佐賀県|長崎県|熊本県|大分県|宮崎県|鹿児島県|沖縄県';
-// 汎用クレデンシャル (#204): ラベル (password/secret/token/api_key 等) に続く値を拾う。
-// lookbehind でラベル・区切り・開き引用符を消費し、**値のみ**を m[0] にする
-// (= 検出 preview/hash も redact もラベルを残して値だけ伏せる)。redact は生テキストに
-// 走るため全角コロン/イコール (：＝) と全角空白 (\s に含まれる) にも対応する。
-// 高エントロピーを有効化せずに弱いパスワード直書き (password: hunter2) を伏せられる。
-const CREDENTIAL_LABEL = '(?:password|passwd|pwd|secret|token|api[_-]?key|access[_-]?key|client[_-]?secret)';
-const GENERIC_CREDENTIAL_RE = new RegExp(`(?<=\\b${CREDENTIAL_LABEL}\\s*[:=：＝]\\s*["']?)[^\\s"']{6,}`, 'gi');
-/** 汎用クレデンシャルの値が「本物っぽい」か (プレースホルダ/自然文を弾く)。 */
-function isLikelyCredential(value) {
-    const v = value.trim();
-    if (v.length < 6)
-        return false;
-    if (/^<.*>$/.test(v))
-        return false; // <your-password> 等のプレースホルダ
-    if (/^[\W_]+$/.test(v))
-        return false; // ***, ----, ____ など記号のみ
-    if (/^(.)\1{5,}$/i.test(v))
-        return false; // xxxxxx, aaaaaa など同一文字反復
-    // 末尾/先頭の句読点を除いた語幹でプレースホルダ/自然文ワードを判定。
-    const core = v
-        .replace(/^[^\p{L}\p{N}]+/u, '')
-        .replace(/[^\p{L}\p{N}]+$/u, '')
-        .toLowerCase();
-    const DENY = new Set([
-        'redacted', 'none', 'null', 'nil', 'true', 'false', 'required', 'optional',
-        'example', 'changeme', 'placeholder', 'password', 'passwd', 'secret', 'token',
-        'your_password', 'yourpassword', 'test', 'enabled', 'disabled', 'undefined', 'empty',
-    ]);
-    return !DENY.has(core);
-}
-// 全ルールは正規化済みテキスト (NFKC + 漢数字寄せ) に対して実行する。
-const BUILTIN_RULES = [
-    // --- シークレット ---
-    // Anthropic を OpenAR より先に: OpenAI 側は sk-ant- を negative lookahead で除外。
-    {
-        ruleId: 'anthropic_key',
-        category: 'secret',
-        severity: 'high',
-        regex: /sk-ant-(?:api|oat|ort)\d+-[A-Za-z0-9_-]{40,}/g,
-    },
-    {
-        ruleId: 'openai_key',
-        category: 'secret',
-        severity: 'high',
-        regex: /sk-(?!ant-)(?:proj-)?[A-Za-z0-9]{40,}/g,
-    },
-    {
-        ruleId: 'github_token',
-        category: 'secret',
-        severity: 'high',
-        regex: /gh[pousr]_[A-Za-z0-9]{36}/g,
-    },
-    {
-        ruleId: 'slack_token',
-        category: 'secret',
-        severity: 'high',
-        regex: /xox[baprs]-[A-Za-z0-9-]{10,}/g,
-    },
-    {
-        ruleId: 'aws_access_key',
-        category: 'secret',
-        severity: 'high',
-        regex: /\bAKIA[0-9A-Z]{16}\b/g,
-    },
-    {
-        ruleId: 'gcp_api_key',
-        category: 'secret',
-        severity: 'high',
-        regex: /\bAIza[0-9A-Za-z_-]{35}\b/g,
-    },
-    {
-        ruleId: 'private_key_block',
-        category: 'secret',
-        severity: 'high',
-        regex: /-----BEGIN (?:RSA |EC |OPENSSH |DSA |PGP )?PRIVATE KEY-----/g,
-    },
-    {
-        ruleId: 'jwt',
-        category: 'secret',
-        severity: 'medium',
-        regex: /\beyJ[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\.[A-Za-z0-9_-]{10,}\b/g,
-    },
-    {
-        ruleId: 'bearer_token',
-        category: 'secret',
-        severity: 'medium',
-        regex: /Bearer\s+[A-Za-z0-9._-]{20,}/g,
-    },
-    {
-        // #204: password: hunter2 等のラベル付きクレデンシャル (弱パスワード含む)。値のみ伏せる。
-        ruleId: 'generic_credential',
-        category: 'secret',
-        severity: 'high',
-        regex: GENERIC_CREDENTIAL_RE,
-        validate: isLikelyCredential,
-    },
-    // --- PII (汎用) ---
-    {
-        ruleId: 'email',
-        category: 'pii',
-        severity: 'low',
-        regex: /[a-zA-Z0-9._%+-]{2,}@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}/g,
-    },
-    {
-        ruleId: 'credit_card',
-        category: 'pii',
-        severity: 'high',
-        // 13〜19 桁を区切り (空白/ハイフン) 込みで候補化し Luhn 検証。
-        regex: /\b(?:\d[ -]?){12,18}\d\b/g,
-        validate: luhnValid,
-    },
-    // --- 日本語 PII (APPI の個人情報・個人識別符号) ---
-    {
-        ruleId: 'jp_mynumber',
-        category: 'pii_jp',
-        severity: 'high',
-        regex: /\b\d{4}[\s-]?\d{4}[\s-]?\d{4}\b/g,
-        validate: isValidMyNumber,
-    },
-    {
-        ruleId: 'jp_corporate_number',
-        category: 'pii_jp',
-        severity: 'medium',
-        regex: /\b\d{13}\b/g,
-        validate: isValidCorporateNumber,
-    },
-    {
-        ruleId: 'jp_phone',
-        category: 'pii_jp',
-        severity: 'medium',
-        // 携帯 (070/080/090) / フリーダイヤル (0120,0800) / 固定 (区切り必須)。
-        regex: /\b0[789]0-\d{4}-\d{4}\b|\b0120-\d{3}-\d{3}\b|\b0800-\d{3}-\d{4}\b|\b0\d{1,3}-\d{2,4}-\d{4}\b/g,
-    },
-    {
-        ruleId: 'jp_postal',
-        category: 'pii_jp',
-        severity: 'low',
-        // 電話番号の一部 (前後に数字/ハイフン) を除外。〒 付きは可視性が高い。
-        regex: /(?<![\d-])(?:〒\s?)?\d{3}-\d{4}(?![\d-])/g,
-    },
-    {
-        ruleId: 'jp_address',
-        category: 'pii_jp',
-        severity: 'medium',
-        regex: new RegExp(`(?:${PREFECTURES})[^\\s「」、。]{0,18}?[市区町村郡][^\\s「」、。]{0,20}?(?:\\d+|[十百千]+)(?:丁目|番地|番|-|−)`, 'g'),
-    },
-    {
-        ruleId: 'jp_wareki_date',
-        category: 'pii_jp',
-        severity: 'low',
-        regex: /(?:令和|平成|昭和|大正|明治)\s?(?:元|\d{1,2})\s?年(?:\s?\d{1,2}\s?月(?:\s?\d{1,2}\s?日)?)?/g,
-    },
-];
 const SEVERITY_RANK = { high: 0, medium: 1, low: 2 };
 class SecretDetector {
     rules;
     enableEntropy;
-    hmacSecret;
+    hmacKey;
     constructor(opts = {}) {
-        const custom = (opts.customDictionary ?? [])
-            .map((e) => {
-            try {
-                return {
-                    ruleId: e.ruleId,
-                    category: 'custom',
-                    severity: e.severity ?? 'medium',
-                    regex: new RegExp(e.pattern, 'g'),
-                };
-            }
-            catch {
-                // 不正な正規表現は無視 (辞書のせいで検知全体を落とさない)。
-                return null;
-            }
-        })
-            .filter((r) => r !== null);
-        this.rules = [...BUILTIN_RULES, ...custom];
+        this.rules = (0, detection_1.compileRules)({
+            custom: (opts.customDictionary ?? []).map((e) => ({
+                ruleId: e.ruleId,
+                pattern: e.pattern,
+                severity: e.severity ?? 'medium',
+            })),
+        });
         this.enableEntropy = opts.enableEntropy ?? true;
-        this.hmacSecret = opts.hmacSecret ?? (0, crypto_1.randomBytes)(32).toString('hex');
+        this.hmacKey = opts.hmacSecret ?? (0, crypto_1.randomBytes)(32).toString('hex');
     }
     /** テキストから検知メタを返す。生機密本文は保持しない。 */
     detect(text) {
+        return this.detectWithContext(text).detections;
+    }
+    /**
+     * detect() に加えて、各検知の出現位置とマスク済みの行抜粋を返す。
+     *
+     * ブロック理由に「どの語が原因か」を出すために使う。マスク済みプレビューが
+     * 末尾 2 文字だけでは原因語を特定できず、利用者が二分探索で切り分ける羽目になる。
+     * contexts は端末内の表示専用で、クラウドへは送らない (DetectionContext 参照)。
+     */
+    detectWithContext(text) {
         if (!text)
-            return [];
-        const norm = normalizeForDetection(text);
-        const rawHits = [];
-        for (const rule of this.rules) {
-            rule.regex.lastIndex = 0;
-            let m;
-            while ((m = rule.regex.exec(norm)) !== null) {
-                const matched = m[0];
-                // ゼロ幅マッチの無限ループ回避。
-                if (m.index === rule.regex.lastIndex)
-                    rule.regex.lastIndex++;
-                if (rule.validate && !rule.validate(matched))
-                    continue;
-                rawHits.push({
-                    ruleId: rule.ruleId,
-                    category: rule.category,
-                    severity: rule.severity,
-                    value: matched,
-                    start: m.index,
-                    end: m.index + matched.length,
-                });
-            }
-        }
+            return { detections: [], contexts: [] };
+        const mapped = (0, detection_1.normalizeWithMap)(text);
+        const norm = mapped.text;
+        const rawHits = (0, detection_1.findHits)(norm, this.rules);
         // スパン重複除外 (secret カテゴリのみ): 同一箇所を複数ルールが拾う二重計上を防ぐ。
-        // 例: `Bearer eyJ…` は jwt と bearer_token の両方にマッチする。ルール定義順
-        // (特異的なルールが先) を優先し、重複した後段ルールのヒットは破棄する。
+        // 例: Bearer + JWT は両方にマッチする。ルール定義順 (特異的なルールが先) を
+        // 優先し、重複した後段ルールのヒットは破棄する。
         // pii/pii_jp は別個の値が隣接し得る (住所+郵便番号等) ため対象外。
         const hits = [];
         for (const h of rawHits) {
@@ -420,29 +139,8 @@ class SecretDetector {
             if (!dup)
                 hits.push(h);
         }
-        const matchedValues = hits.map((h) => h.value);
         if (this.enableEntropy) {
-            for (const token of norm.split(/[^A-Za-z0-9+/=_-]+/)) {
-                if (token.length < ENTROPY_MIN_LENGTH)
-                    continue;
-                // 英字と数字が混在する文字列のみ (英文/数字列の誤検出を抑制)。
-                if (!(/[A-Za-z]/.test(token) && /\d/.test(token)))
-                    continue;
-                if (shannonEntropy(token) < ENTROPY_THRESHOLD)
-                    continue;
-                // 既存の正規表現ヒットと重複するトークンは二重計上しない。
-                if (matchedValues.some((v) => v.includes(token) || token.includes(v)))
-                    continue;
-                // start/end は重複除外 (上で完了済み) では使わないため -1 で埋める。
-                hits.push({
-                    ruleId: 'high_entropy',
-                    category: 'secret',
-                    severity: 'medium',
-                    value: token,
-                    start: -1,
-                    end: -1,
-                });
-            }
+            hits.push(...(0, detection_1.findEntropyHits)(norm, hits.map((h) => h.value)));
         }
         // (category, ruleId) ごとに集約。生 value はここで preview/hash に変換して破棄。
         const groups = new Map();
@@ -461,95 +159,66 @@ class SecretDetector {
             count: values.length,
             maskedPreview: maskMatch(values[0], hit.category),
             matchHash: hit.category === 'pii' || hit.category === 'pii_jp'
-                ? hmacHash(values[0], this.hmacSecret)
+                ? hmacHash(values[0], this.hmacKey)
                 : hashMatch(values[0]),
         }));
         // 重大度順 (high>medium>low、同重大度はルール定義順) に整列し、1 entry あたり
         // MAX_DETECTIONS_PER_ENTRY 件へキャップ (cloud 側で batch ごと棄却されないため)。
         metas.sort((a, b) => SEVERITY_RANK[a.severity] - SEVERITY_RANK[b.severity]);
-        return metas.slice(0, exports.MAX_DETECTIONS_PER_ENTRY);
+        const detections = metas.slice(0, exports.MAX_DETECTIONS_PER_ENTRY);
+        // ruleId ごとに最初の 1 件だけ位置を出す (理由文が長くなりすぎないため)。
+        const seen = new Set();
+        const contexts = [];
+        for (const h of hits) {
+            if (seen.has(h.ruleId))
+                continue;
+            seen.add(h.ruleId);
+            const ctx = this.buildContext(text, mapped, h);
+            if (ctx)
+                contexts.push(ctx);
+        }
+        return { detections, contexts };
+    }
+    /**
+     * ヒット位置を原文へ戻し、その行を **マスクしたまま** 抜粋する。
+     *
+     * 該当値そのものは出さない。理由文は端末にも Claude の文脈にも載るので、
+     * 「生機密を理由文に出さない」という既存の性質は崩さない。原因の特定には
+     * 行番号と、伏字を挟んだ前後の文脈で足りる。
+     */
+    buildContext(raw, mapped, hit) {
+        const rawStart = mapped.starts[hit.start];
+        const rawEnd = mapped.ends[Math.max(hit.start, hit.end - 1)];
+        if (rawStart === undefined || rawEnd === undefined)
+            return null;
+        const line = raw.slice(0, rawStart).split('\n').length;
+        const lineStart = raw.lastIndexOf('\n', Math.max(0, rawStart - 1)) + 1;
+        const lineEndIdx = raw.indexOf('\n', rawEnd);
+        const lineEnd = lineEndIdx === -1 ? raw.length : lineEndIdx;
+        // 長い行は検知位置の周りだけ切り出す。
+        const from = Math.max(lineStart, rawStart - SNIPPET_MAX_CHARS / 2);
+        const to = Math.min(lineEnd, rawEnd + SNIPPET_MAX_CHARS / 2);
+        const head = from > lineStart ? '…' : '';
+        const tail = to < lineEnd ? '…' : '';
+        // 抜粋は必ずマスクを通す。同じ行に別の機密が居合わせていても漏らさない。
+        const snippet = this.redact(raw.slice(from, to)).text.replace(/\s+/g, ' ').trim();
+        return { ruleId: hit.ruleId, line, snippet: `${head}${snippet}${tail}` };
     }
     /**
-     * テキストから「秘密情報」を伏せ字へ置換して返す (Issue #104)。
+     * テキストから秘密情報を伏せ字へ置換して返す (Issue #104)。
      *
      * 検出 (detect) と同じルール集合を流用することで、**検出できるものは必ずマスクできる**
-     * を保証し、検出器とマスカのドリフトを防ぐ。マスク対象は:
-     *   - category==='secret' の全ルール (API キー / トークン / 秘密鍵 / JWT / 高エントロピー)
-     *   - severity==='high' のルール (クレジットカード / マイナンバー — 検査数字で誤検知が低い)
-     *   - 秘密鍵は BEGIN〜END を一括 (検出ルールは BEGIN 行のみのため本体が残るのを防ぐ)
+     * を保証する。マスク範囲は shared の AGENT_REDACT_POLICY:
+     *   - secret 全ルール (API キー / トークン / 秘密鍵 / 汎用クレデンシャル)
+     *   - strong_pii (カード / マイナンバー / 口座 / 人名 — 検査数字やラベルで裏取り済み)
+     * 連絡先系 (電話 / 住所 / 郵便番号) とメールは対象外 — pii-masker のトグルが扱う。
      *
-     * email や中低重大度の一般 PII (電話 / 住所 等) は対象外 — それらはマスカ側のトグル
-     * (maskEmails) や組織ルールが扱う。生テキストに対して動作する (置換位置を保つため
-     * 正規化はしない。全角の難読化対策は将来課題)。
+     * 生テキストに対して動作する (置換位置を保つため正規化はしない)。
      *
      * @returns 置換後テキストと ruleId ごとの置換件数 (MaskStat 連携用)。
      */
     redact(text) {
-        if (!text)
-            return { text, counts: {} };
-        // --- 確定ルール (PEM 全ブロック + secret 全カテゴリ + high severity) ---
-        const specific = [];
-        PEM_BLOCK.lastIndex = 0;
-        let pm;
-        while ((pm = PEM_BLOCK.exec(text)) !== null) {
-            specific.push({ start: pm.index, end: pm.index + pm[0].length, ruleId: 'private_key_block' });
-            if (pm.index === PEM_BLOCK.lastIndex)
-                PEM_BLOCK.lastIndex++;
-        }
-        for (const rule of this.rules) {
-            if (!(rule.category === 'secret' || rule.severity === 'high'))
-                continue;
-            rule.regex.lastIndex = 0;
-            let m;
-            while ((m = rule.regex.exec(text)) !== null) {
-                const matched = m[0];
-                if (m.index === rule.regex.lastIndex)
-                    rule.regex.lastIndex++;
-                if (rule.validate && !rule.validate(matched))
-                    continue;
-                specific.push({ start: m.index, end: m.index + matched.length, ruleId: rule.ruleId });
-            }
-        }
-        // 確定ルールを貪欲に非重複選択 (start 昇順 → 長い順)。
-        const chosen = selectNonOverlapping(specific);
-        // --- 高エントロピー (パターン外のランダム秘密) ---
-        // 既定では無効 (マスカは enableEntropy=false で構築する)。理由: エントロピー基準は
-        // 正当な識別子 (job-id 等) や base64 断片まで潰し、保存本文を破壊し得るため、
-        // マスキングは確定ルールに限定する。検出 (detect) では従来どおり高エントロピーを
-        // フラグする。有効化時も確定ルールを優先し、空き領域のみ伏せる。
-        if (this.enableEntropy) {
-            const entropy = [];
-            const tokenRe = new RegExp(`[A-Za-z0-9+/=_-]{${ENTROPY_MIN_LENGTH},}`, 'g');
-            let tm;
-            while ((tm = tokenRe.exec(text)) !== null) {
-                const token = tm[0];
-                if (/[/\\]/.test(token))
-                    continue;
-                if (!(/[A-Za-z]/.test(token) && /\d/.test(token)))
-                    continue;
-                if (shannonEntropy(token) < ENTROPY_THRESHOLD)
-                    continue;
-                const start = tm.index;
-                const end = start + token.length;
-                // 確定スパンと重なるものは捨てる (specific ラベルを優先)。
-                if (chosen.some((c) => start < c.end && c.start < end))
-                    continue;
-                entropy.push({ start, end, ruleId: 'high_entropy' });
-            }
-            chosen.push(...selectNonOverlapping(entropy));
-        }
-        if (chosen.length === 0)
-            return { text, counts: {} };
-        chosen.sort((a, b) => a.start - b.start);
-        // 右端から置換してインデックスのずれを防ぐ。
-        const counts = {};
-        let out = text;
-        for (let i = chosen.length - 1; i >= 0; i--) {
-            const s = chosen[i];
-            out = out.slice(0, s.start) + redactionLabel(s.ruleId) + out.slice(s.end);
-            counts[s.ruleId] = (counts[s.ruleId] ?? 0) + 1;
-        }
-        return { text: out, counts };
+        return (0, detection_1.redactText)(text, this.rules, { ...detection_1.AGENT_REDACT_POLICY, entropy: this.enableEntropy });
     }
 }
 exports.SecretDetector = SecretDetector;