@zxyycom/vibe-check 0.0.1 → 0.0.2

package/dist/esm/package-checks/duplicate-detection/options-validation.mjs

@@ -1,25 +1,20 @@
-import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { snapshotClosedRecord, snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString, isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
 import { validProjectFileSelection } from "../project-files/configuration.mjs";
 import { validFindingPolicy } from "../code-quality-findings/policy.mjs";
-function exactRecord(value, keys) {
-    const record = snapshotClosedRecord(value);
-    return record !== undefined &&
-        Object.keys(record).length === keys.length &&
-        keys.every((key) => Object.hasOwn(record, key))
-        ? record
-        : undefined;
-}
-function positiveSafeInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
-}
-function nonEmptyString(value) {
-    return typeof value === "string" && value.length > 0;
-}
+import { validResolvedFindingWaivers } from "../code-quality-findings/finding-waiver-authoring.mjs";
+import { resolveDuplicateDetectionFindingIdentity } from "./finding-waiver-identity.mjs";
 export function validResolvedDuplicateDetectionOptions(value) {
-    const options = exactRecord(value, ["cache", "codeAreas", "scanner"]);
+    const options = snapshotExactClosedRecord(value, [
+        "cache",
+        "codeAreas",
+        "findingWaivers",
+        "scanner"
+    ]);
     return (options !== undefined &&
         validDuplicateCache(options.cache) &&
         validDuplicateCodeAreas(options.codeAreas) &&
+        validResolvedFindingWaivers(options.findingWaivers, resolveDuplicateDetectionFindingIdentity) &&
         validDuplicateDetectionScanner(options.scanner));
 }
 function validDuplicateCodeAreas(value) {
@@ -27,22 +22,22 @@ function validDuplicateCodeAreas(value) {
     if (areas === undefined || Object.keys(areas).length === 0)
         return false;
     return Object.entries(areas).every(([areaId, candidate]) => {
-        const area = exactRecord(candidate, [
+        const area = snapshotExactClosedRecord(candidate, [
             "files",
             "findingPolicy",
             "minimumLines",
             "minimumTokens"
         ]);
-        return (nonEmptyString(areaId) &&
+        return (isNonEmptyString(areaId) &&
             area !== undefined &&
             validProjectFileSelection(area.files) &&
             validFindingPolicy(area.findingPolicy) &&
-            positiveSafeInteger(area.minimumLines) &&
-            positiveSafeInteger(area.minimumTokens));
+            isPositiveSafeInteger(area.minimumLines) &&
+            isPositiveSafeInteger(area.minimumTokens));
     });
 }
 function validDuplicateDetectionScanner(value) {
-    const scanner = exactRecord(value, ["command"]);
+    const scanner = snapshotExactClosedRecord(value, ["command"]);
     return scanner !== undefined && validJscpdCommand(scanner.command);
 }
 function validJscpdCommand(value) {
@@ -50,11 +45,11 @@ function validJscpdCommand(value) {
     if (record?.kind === "package") {
         return Object.keys(record).length === 1;
     }
-    const command = exactRecord(value, ["executable", "kind"]);
-    return command?.kind === "custom" && nonEmptyString(command.executable);
+    const command = snapshotExactClosedRecord(value, ["executable", "kind"]);
+    return command?.kind === "custom" && isNonEmptyString(command.executable);
 }
 function validDuplicateCache(value) {
-    const cache = exactRecord(value, ["directory", "enabled"]);
-    return (cache !== undefined && nonEmptyString(cache.directory) && typeof cache.enabled === "boolean");
+    const cache = snapshotExactClosedRecord(value, ["directory", "enabled"]);
+    return (cache !== undefined && isNonEmptyString(cache.directory) && typeof cache.enabled === "boolean");
 }
 //# sourceMappingURL=options-validation.mjs.map

package/dist/esm/package-checks/duplicate-detection/options-validation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/options-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\n\nfunction exactRecord(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  return record !== undefined &&\n    Object.keys(record).length === keys.length &&\n    keys.every((key) => Object.hasOwn(record, key))\n    ? record\n    : undefined;\n}\n\nfunction positiveSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction nonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\nexport function validResolvedDuplicateDetectionOptions(value: object): boolean {\n  const options = exactRecord(value, [\"cache\", \"codeAreas\", \"scanner\"]);\n  return (\n    options !== undefined &&\n    validDuplicateCache(options.cache) &&\n    validDuplicateCodeAreas(options.codeAreas) &&\n    validDuplicateDetectionScanner(options.scanner)\n  );\n}\n\nfunction validDuplicateCodeAreas(value: unknown): boolean {\n  const areas = snapshotClosedRecord(value);\n  if (areas === undefined || Object.keys(areas).length === 0) return false;\n  return Object.entries(areas).every(([areaId, candidate]) => {\n    const area = exactRecord(candidate, [\n      \"files\",\n      \"findingPolicy\",\n      \"minimumLines\",\n      \"minimumTokens\"\n    ]);\n    return (\n      nonEmptyString(areaId) &&\n      area !== undefined &&\n      validProjectFileSelection(area.files) &&\n      validFindingPolicy(area.findingPolicy) &&\n      positiveSafeInteger(area.minimumLines) &&\n      positiveSafeInteger(area.minimumTokens)\n    );\n  });\n}\n\nfunction validDuplicateDetectionScanner(value: unknown): boolean {\n  const scanner = exactRecord(value, [\"command\"]);\n  return scanner !== undefined && validJscpdCommand(scanner.command);\n}\n\nfunction validJscpdCommand(value: unknown): boolean {\n  const record = snapshotClosedRecord(value);\n  if (record?.kind === \"package\") {\n    return Object.keys(record).length === 1;\n  }\n  const command = exactRecord(value, [\"executable\", \"kind\"]);\n  return command?.kind === \"custom\" && nonEmptyString(command.executable);\n}\n\nfunction validDuplicateCache(value: unknown): boolean {\n  const cache = exactRecord(value, [\"directory\", \"enabled\"]);\n  return (\n    cache !== undefined && nonEmptyString(cache.directory) && typeof cache.enabled === \"boolean\"\n  );\n}\n"]}
+{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/options-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  snapshotClosedRecord,\n  snapshotExactClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { isNonEmptyString, isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport { validResolvedFindingWaivers } from \"../code-quality-findings/finding-waiver-authoring.ts\";\nimport { resolveDuplicateDetectionFindingIdentity } from \"./finding-waiver-identity.ts\";\n\nexport function validResolvedDuplicateDetectionOptions(value: object): boolean {\n  const options = snapshotExactClosedRecord(value, [\n    \"cache\",\n    \"codeAreas\",\n    \"findingWaivers\",\n    \"scanner\"\n  ]);\n  return (\n    options !== undefined &&\n    validDuplicateCache(options.cache) &&\n    validDuplicateCodeAreas(options.codeAreas) &&\n    validResolvedFindingWaivers(options.findingWaivers, resolveDuplicateDetectionFindingIdentity) &&\n    validDuplicateDetectionScanner(options.scanner)\n  );\n}\n\nfunction validDuplicateCodeAreas(value: unknown): boolean {\n  const areas = snapshotClosedRecord(value);\n  if (areas === undefined || Object.keys(areas).length === 0) return false;\n  return Object.entries(areas).every(([areaId, candidate]) => {\n    const area = snapshotExactClosedRecord(candidate, [\n      \"files\",\n      \"findingPolicy\",\n      \"minimumLines\",\n      \"minimumTokens\"\n    ]);\n    return (\n      isNonEmptyString(areaId) &&\n      area !== undefined &&\n      validProjectFileSelection(area.files) &&\n      validFindingPolicy(area.findingPolicy) &&\n      isPositiveSafeInteger(area.minimumLines) &&\n      isPositiveSafeInteger(area.minimumTokens)\n    );\n  });\n}\n\nfunction validDuplicateDetectionScanner(value: unknown): boolean {\n  const scanner = snapshotExactClosedRecord(value, [\"command\"]);\n  return scanner !== undefined && validJscpdCommand(scanner.command);\n}\n\nfunction validJscpdCommand(value: unknown): boolean {\n  const record = snapshotClosedRecord(value);\n  if (record?.kind === \"package\") {\n    return Object.keys(record).length === 1;\n  }\n  const command = snapshotExactClosedRecord(value, [\"executable\", \"kind\"]);\n  return command?.kind === \"custom\" && isNonEmptyString(command.executable);\n}\n\nfunction validDuplicateCache(value: unknown): boolean {\n  const cache = snapshotExactClosedRecord(value, [\"directory\", \"enabled\"]);\n  return (\n    cache !== undefined && isNonEmptyString(cache.directory) && typeof cache.enabled === \"boolean\"\n  );\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/options.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\n\nexport type DuplicateDetectionScannerCommand =\n  /** 使用随 `@zxyycom/vibe-check` 安装的 jscpd。 */\n  | Readonly<{ readonly kind: \"package\" }>\n  /** 显式授权另一个 jscpd 命令。 */\n  | Readonly<{\n      /** 项目已授权且直接接受 jscpd CLI 参数的非空命令。 */\n      readonly executable: string;\n      readonly kind: \"custom\";\n    }>;\n\n/** `duplicateDetection` 构造函数可省略的缓存策略。 */\nexport interface DuplicateDetectionCacheOptions {\n  /** 省略时为 `.cache/vibe-check`；相对路径以项目根目录解析。 */\n  readonly directory?: string;\n  /** 省略时启用。 */\n  readonly enabled?: boolean;\n}\n\n/** `duplicateDetection` 构造函数可省略的 scanner 策略。 */\nexport interface DuplicateDetectionScannerOptions {\n  /** 省略时使用随 `@zxyycom/vibe-check` 安装的 jscpd。 */\n  readonly command?: DuplicateDetectionScannerCommand;\n}\n\n/** 重复代码区域可省略并由构造函数补齐的文件策略。 */\nexport type DuplicateDetectionFileOptions = ProjectFileSelectionOptions;\n\n/** 可独立选择文件、阈值和 finding policy 的重复代码区域。 */\nexport interface DuplicateDetectionCodeAreaOptions {\n  /** 显式区域必须声明本字段；其中各子字段可省略并使用 package 默认值。 */\n  readonly files: DuplicateDetectionFileOptions;\n  /** 省略时继承顶层 `findingPolicy`。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** 省略时为 `4`。 */\n  readonly minimumLines?: number;\n  /** 省略时为 `100`。 */\n  readonly minimumTokens?: number;\n}\n\n/** `duplicateDetection(options?)` 接受并补齐默认值的公开策略。 */\nexport interface DuplicateDetectionOptions {\n  /** 省略时建立默认 `project` 区域；显式映射必须非空。 */\n  readonly codeAreas?: Readonly<Record<string, DuplicateDetectionCodeAreaOptions>>;\n  readonly cache?: DuplicateDetectionCacheOptions;\n  /** 省略时为 `non-blocking`；区域可局部覆盖。 */\n  readonly findingPolicy?: FindingPolicy;\n  readonly scanner?: DuplicateDetectionScannerOptions;\n}\n\n/** 构造函数生成并由 Check preflight/execution 消费的完整 options。 */\nexport interface ResolvedDuplicateDetectionOptions {\n  readonly cache: Readonly<{ readonly directory: string; readonly enabled: boolean }>;\n  readonly codeAreas: Readonly<Record<string, ResolvedDuplicateDetectionCodeAreaOptions>>;\n  readonly scanner: ResolvedDuplicateDetectionScannerOptions;\n}\n\nexport interface ResolvedDuplicateDetectionCodeAreaOptions {\n  readonly files: ProjectFileSelection;\n  readonly findingPolicy: FindingPolicy;\n  readonly minimumLines: number;\n  readonly minimumTokens: number;\n}\n\nexport interface ResolvedDuplicateDetectionScannerOptions {\n  readonly command: DuplicateDetectionScannerCommand;\n}\n"]}
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/options.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { FindingWaiver } from \"../../finding-waivers/reconciliation.ts\";\n\nexport type DuplicateDetectionScannerCommand =\n  /** 使用随 `@zxyycom/vibe-check` 安装的 jscpd。 */\n  | Readonly<{ readonly kind: \"package\" }>\n  /** 显式授权另一个 jscpd 命令。 */\n  | Readonly<{\n      /** 项目已授权且直接接受 jscpd CLI 参数的非空命令。 */\n      readonly executable: string;\n      readonly kind: \"custom\";\n    }>;\n\n/** `duplicateDetection` 构造函数可省略的缓存策略。 */\nexport interface DuplicateDetectionCacheOptions {\n  /** 省略时为 `.cache/vibe-check`；相对路径以项目根目录解析。 */\n  readonly directory?: string;\n  /** 省略时启用。 */\n  readonly enabled?: boolean;\n}\n\n/** `duplicateDetection` 构造函数可省略的 scanner 策略。 */\nexport interface DuplicateDetectionScannerOptions {\n  /** 省略时使用随 `@zxyycom/vibe-check` 安装的 jscpd。 */\n  readonly command?: DuplicateDetectionScannerCommand;\n}\n\n/** duplicate-detection identity 的 locations 数组中的一段 project-relative range。 */\nexport interface DuplicateDetectionFindingLocation {\n  readonly endLine: number;\n  readonly path: string;\n  readonly startLine: number;\n}\n\n/** duplicate-detection 用于精确识别一条可豁免 finding 的稳定字段。 */\nexport interface DuplicateDetectionFindingIdentity {\n  readonly locations: readonly DuplicateDetectionFindingLocation[];\n  readonly metric: \"duplicate-tokens\";\n}\n\n/** 一项 duplicate-detection finding 的声明式豁免。 */\nexport type DuplicateDetectionFindingWaiver = FindingWaiver<DuplicateDetectionFindingIdentity>;\n\n/** 重复代码区域可省略并由构造函数补齐的文件策略。 */\nexport type DuplicateDetectionFileOptions = ProjectFileSelectionOptions;\n\n/** 同时拥有文件选择、比较边界、阈值和 finding policy 的重复代码区域。 */\nexport interface DuplicateDetectionCodeAreaOptions {\n  /** 显式区域必须声明本字段；其中各子字段可省略并使用 package 默认值。 */\n  readonly files: DuplicateDetectionFileOptions;\n  /** 省略时继承顶层 `findingPolicy`。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** 省略时为 `4`。 */\n  readonly minimumLines?: number;\n  /** 省略时为 `100`。 */\n  readonly minimumTokens?: number;\n}\n\n/** `duplicateDetection(options?)` 接受并补齐默认值的公开策略。 */\nexport interface DuplicateDetectionOptions {\n  /** 省略时建立默认 `project` 区域；显式映射必须非空。 */\n  readonly codeAreas?: Readonly<Record<string, DuplicateDetectionCodeAreaOptions>>;\n  readonly cache?: DuplicateDetectionCacheOptions;\n  /** 省略时为 `non-blocking`；区域可局部覆盖。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** 省略时没有豁免；identity 使用 Finding 发布的完整排序 location ranges。 */\n  readonly findingWaivers?: readonly DuplicateDetectionFindingWaiver[];\n  readonly scanner?: DuplicateDetectionScannerOptions;\n}\n\n/** 构造函数生成并由 Check preflight/execution 消费的完整 options。 */\nexport interface ResolvedDuplicateDetectionOptions {\n  readonly cache: Readonly<{ readonly directory: string; readonly enabled: boolean }>;\n  readonly codeAreas: Readonly<Record<string, ResolvedDuplicateDetectionCodeAreaOptions>>;\n  readonly findingWaivers: readonly DuplicateDetectionFindingWaiver[];\n  readonly scanner: ResolvedDuplicateDetectionScannerOptions;\n}\n\nexport interface ResolvedDuplicateDetectionCodeAreaOptions {\n  readonly files: ProjectFileSelection;\n  readonly findingPolicy: FindingPolicy;\n  readonly minimumLines: number;\n  readonly minimumTokens: number;\n}\n\nexport interface ResolvedDuplicateDetectionScannerOptions {\n  readonly command: DuplicateDetectionScannerCommand;\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/records.mjs

@@ -1,6 +1,26 @@
 import { createHash } from "node:crypto";
 import { canonicalJsonBytes } from "../../data-boundary/canonical-data.mjs";
+import { buildHashedFindingWaiverAuditRecord } from "../code-quality-findings/finding-waiver-evidence.mjs";
 import { isBlockingFinding } from "../code-quality-findings/policy.mjs";
+import { compareDuplicateFindingLocations, resolveDuplicateDetectionFindingIdentity } from "./finding-waiver-identity.mjs";
+export function duplicateDetectionFindingIdentity(candidate) {
+    return Object.freeze({
+        locations: candidate.data.locations,
+        metric: candidate.data.metric
+    });
+}
+export function duplicateDetectionWaiverIdentity(waiver) {
+    const identity = resolveDuplicateDetectionFindingIdentity(waiver.identity);
+    if (identity === undefined) {
+        throw new TypeError("duplicateDetection waiver identity must retain sorted valid locations");
+    }
+    return identity;
+}
+/** 为一项未使用或过宽 waiver 构造 Check-owned audit Record。 */
+export function duplicateDetectionWaiverAuditRecord(audit) {
+    const identity = duplicateDetectionWaiverIdentity(audit.waiver);
+    return buildHashedFindingWaiverAuditRecord(identity, audit);
+}
 /** Builds Check-owned supplemental facts without adding a Product record catalog. */
 export function buildDuplicateRecordCandidates(fragments, codeAreas) {
     const ids = duplicateIdsInOrder(fragments);
@@ -51,9 +71,15 @@ export function isValidDuplicateFragment(fragment) {
         Array.isArray(fragment.locations) &&
         fragment.locations.length >= 2 &&
         fragment.locations.every(isValidLocation) &&
+        locationsAreDistinct(fragment.locations) &&
         Array.isArray(fragment.codeAreas) &&
         fragment.codeAreas.every(nonEmptyString));
 }
+function locationsAreDistinct(locations) {
+    return locations.every((location, index) => locations
+        .slice(index + 1)
+        .every((other) => compareDuplicateFindingLocations(location, other) !== 0));
+}
 function hasValidFragmentMeasurements(fragment) {
     return (nonNegativeSafeInteger(fragment.id) &&
         nonNegativeSafeInteger(fragment.lineCount) &&
@@ -99,12 +125,7 @@ function duplicateFingerprint(fragment) {
         .digest("hex");
 }
 function sortedLocations(locations) {
-    return [...locations].sort((left, right) => compareText(locationSortKey(left), locationSortKey(right)));
-}
-function locationSortKey(location) {
-    const startLine = String(location.startLine).padStart(12, "0");
-    const endLine = String(location.endLine).padStart(12, "0");
-    return `${location.path}\u0000${startLine}\u0000${endLine}`;
+    return [...locations].sort(compareDuplicateFindingLocations);
 }
 function uniqueSorted(values) {
     return [...new Set(values)].sort(compareText);

package/dist/esm/package-checks/duplicate-detection/records.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"records.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/records.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport { canonicalJsonBytes } from \"../../data-boundary/canonical-data.ts\";\nimport { isBlockingFinding, type FindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { DuplicateCodeFragment, DuplicateCodeLocation } from \"./measurement-model.ts\";\nimport type { ResolvedDuplicateDetectionOptions } from \"./options.ts\";\n\n/** 一条可信重复片段 supplemental Record 的 data。 */\nexport type DuplicateDetectionRecordData = Readonly<{\n  readonly blocking: boolean;\n  readonly codeAreas: readonly string[];\n  readonly lineCount: number;\n  readonly locations: readonly Readonly<{\n    readonly endLine: number;\n    readonly path: string;\n    readonly startLine: number;\n  }>[];\n  readonly metric: \"duplicate-tokens\";\n  readonly tokenCount: number;\n}>;\n\nexport interface DuplicateRecordCandidate {\n  readonly data: DuplicateDetectionRecordData;\n  readonly id: string;\n}\n\n/** Builds Check-owned supplemental facts without adding a Product record catalog. */\nexport function buildDuplicateRecordCandidates(\n  fragments: readonly DuplicateCodeFragment[],\n  codeAreas: ResolvedDuplicateDetectionOptions[\"codeAreas\"]\n): readonly DuplicateRecordCandidate[] | undefined {\n  const ids = duplicateIdsInOrder(fragments);\n  if (ids === undefined) return undefined;\n\n  const candidates: DuplicateRecordCandidate[] = [];\n  for (const [index, fragment] of fragments.entries()) {\n    const candidate = createDuplicateRecordCandidate(fragment, ids[index], codeAreas);\n    if (candidate === undefined) return undefined;\n    candidates.push(candidate);\n  }\n  candidates.sort((left, right) => compareText(left.id, right.id));\n  return Object.freeze(candidates);\n}\n\nfunction createDuplicateRecordCandidate(\n  fragment: DuplicateCodeFragment,\n  id: string | undefined,\n  configuredAreas: ResolvedDuplicateDetectionOptions[\"codeAreas\"]\n): DuplicateRecordCandidate | undefined {\n  if (!isValidDuplicateFragment(fragment) || id === undefined) return undefined;\n\n  const locations = sortedLocations(fragment.locations);\n  const codeAreas = uniqueSorted(fragment.codeAreas);\n  if (codeAreas.length === 0 || !sameStrings(codeAreas, fragment.codeAreas)) return undefined;\n  const findingPolicies: FindingPolicy[] = [];\n  for (const areaId of codeAreas) {\n    const area = configuredAreas[areaId];\n    if (area === undefined) return undefined;\n    findingPolicies.push(area.findingPolicy);\n  }\n\n  return Object.freeze({\n    id,\n    data: Object.freeze({\n      blocking: isBlockingFinding(findingPolicies),\n      codeAreas: Object.freeze(codeAreas),\n      lineCount: fragment.lineCount,\n      locations: Object.freeze(\n        locations.map((location) =>\n          Object.freeze({\n            endLine: location.endLine,\n            path: location.path,\n            startLine: location.startLine\n          })\n        )\n      ),\n      metric: \"duplicate-tokens\",\n      tokenCount: fragment.tokenCount\n    })\n  });\n}\n\nexport function isValidDuplicateFragment(fragment: DuplicateCodeFragment): boolean {\n  return (\n    hasValidFragmentMeasurements(fragment) &&\n    Array.isArray(fragment.locations) &&\n    fragment.locations.length >= 2 &&\n    fragment.locations.every(isValidLocation) &&\n    Array.isArray(fragment.codeAreas) &&\n    fragment.codeAreas.every(nonEmptyString)\n  );\n}\n\nfunction hasValidFragmentMeasurements(fragment: DuplicateCodeFragment): boolean {\n  return (\n    nonNegativeSafeInteger(fragment.id) &&\n    nonNegativeSafeInteger(fragment.lineCount) &&\n    nonNegativeSafeInteger(fragment.tokenCount)\n  );\n}\n\nfunction nonNegativeSafeInteger(value: number): boolean {\n  return Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction isValidLocation(location: DuplicateCodeLocation): boolean {\n  const validPath = typeof location.path === \"string\" && location.path.length > 0;\n  const validLines =\n    Number.isSafeInteger(location.startLine) &&\n    location.startLine >= 1 &&\n    Number.isSafeInteger(location.endLine) &&\n    location.endLine >= location.startLine;\n  return validPath && validLines;\n}\n\nfunction nonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction duplicateIdsInOrder(\n  fragments: readonly DuplicateCodeFragment[]\n): readonly string[] | undefined {\n  const occurrences = new Map<string, number>();\n  const ids: string[] = [];\n  for (const fragment of fragments) {\n    if (!isValidDuplicateFragment(fragment)) return undefined;\n    const fingerprint = duplicateFingerprint(fragment);\n    const occurrence = (occurrences.get(fingerprint) ?? 0) + 1;\n    occurrences.set(fingerprint, occurrence);\n    ids.push(`duplicate-fragment/v1/sha256:${fingerprint}/occurrence:${occurrence}`);\n  }\n  return Object.freeze(ids);\n}\n\nfunction duplicateFingerprint(fragment: DuplicateCodeFragment): string {\n  return createHash(\"sha256\")\n    .update(\n      canonicalJsonBytes({\n        lineCount: fragment.lineCount,\n        paths: uniqueSorted(fragment.locations.map((location) => location.path)),\n        tokenCount: fragment.tokenCount\n      })\n    )\n    .digest(\"hex\");\n}\n\nfunction sortedLocations(locations: readonly DuplicateCodeLocation[]): DuplicateCodeLocation[] {\n  return [...locations].sort((left, right) =>\n    compareText(locationSortKey(left), locationSortKey(right))\n  );\n}\n\nfunction locationSortKey(location: DuplicateCodeLocation): string {\n  const startLine = String(location.startLine).padStart(12, \"0\");\n  const endLine = String(location.endLine).padStart(12, \"0\");\n  return `${location.path}\\u0000${startLine}\\u0000${endLine}`;\n}\n\nfunction uniqueSorted(values: readonly string[]): string[] {\n  return [...new Set(values)].sort(compareText);\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}
+{"version":3,"file":"records.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/records.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport { canonicalJsonBytes } from \"../../data-boundary/canonical-data.ts\";\nimport type { MaterializedFindingWaiver } from \"../../finding-waivers/reconciliation.ts\";\nimport {\n  buildHashedFindingWaiverAuditRecord,\n  type FindingWaiverAuditRecordData,\n  type FindingWaiverRecordAudit\n} from \"../code-quality-findings/finding-waiver-evidence.ts\";\nimport { isBlockingFinding, type FindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport {\n  compareDuplicateFindingLocations,\n  resolveDuplicateDetectionFindingIdentity\n} from \"./finding-waiver-identity.ts\";\nimport type { DuplicateCodeFragment, DuplicateCodeLocation } from \"./measurement-model.ts\";\nimport type {\n  DuplicateDetectionFindingIdentity,\n  ResolvedDuplicateDetectionOptions\n} from \"./options.ts\";\n\n/** 一条可信重复片段 supplemental Record 的 data。 */\nexport type DuplicateDetectionFindingRecordData = Readonly<{\n  readonly blocking: boolean;\n  readonly codeAreas: readonly string[];\n  readonly lineCount: number;\n  readonly locations: readonly Readonly<{\n    readonly endLine: number;\n    readonly path: string;\n    readonly startLine: number;\n  }>[];\n  readonly metric: \"duplicate-tokens\";\n  readonly tokenCount: number;\n  /** 精确匹配 waiver 时保留理由，并令该 finding 不再参与 actionable settlement。 */\n  readonly waiver?: Readonly<{ readonly reason: string }>;\n}>;\n\n/** 未使用或过宽 duplicate-detection waiver 的 supplemental audit Record data。 */\nexport type DuplicateDetectionFindingWaiverAuditRecordData =\n  FindingWaiverAuditRecordData<DuplicateDetectionFindingIdentity>;\n\n/** duplicateDetection 发布的 normal finding 或 waiver-audit Record data。 */\nexport type DuplicateDetectionRecordData =\n  | DuplicateDetectionFindingRecordData\n  | DuplicateDetectionFindingWaiverAuditRecordData;\n\nexport interface DuplicateRecordCandidate {\n  readonly data: DuplicateDetectionFindingRecordData;\n  readonly id: string;\n}\n\nexport function duplicateDetectionFindingIdentity(\n  candidate: DuplicateRecordCandidate\n): DuplicateDetectionFindingIdentity {\n  return Object.freeze({\n    locations: candidate.data.locations,\n    metric: candidate.data.metric\n  });\n}\n\nexport function duplicateDetectionWaiverIdentity(\n  waiver: MaterializedFindingWaiver\n): DuplicateDetectionFindingIdentity {\n  const identity = resolveDuplicateDetectionFindingIdentity(waiver.identity);\n  if (identity === undefined) {\n    throw new TypeError(\"duplicateDetection waiver identity must retain sorted valid locations\");\n  }\n  return identity;\n}\n\n/** 为一项未使用或过宽 waiver 构造 Check-owned audit Record。 */\nexport function duplicateDetectionWaiverAuditRecord(audit: FindingWaiverRecordAudit): Readonly<{\n  readonly data: DuplicateDetectionFindingWaiverAuditRecordData;\n  readonly id: string;\n}> {\n  const identity = duplicateDetectionWaiverIdentity(audit.waiver);\n  return buildHashedFindingWaiverAuditRecord(identity, audit);\n}\n\n/** Builds Check-owned supplemental facts without adding a Product record catalog. */\nexport function buildDuplicateRecordCandidates(\n  fragments: readonly DuplicateCodeFragment[],\n  codeAreas: ResolvedDuplicateDetectionOptions[\"codeAreas\"]\n): readonly DuplicateRecordCandidate[] | undefined {\n  const ids = duplicateIdsInOrder(fragments);\n  if (ids === undefined) return undefined;\n\n  const candidates: DuplicateRecordCandidate[] = [];\n  for (const [index, fragment] of fragments.entries()) {\n    const candidate = createDuplicateRecordCandidate(fragment, ids[index], codeAreas);\n    if (candidate === undefined) return undefined;\n    candidates.push(candidate);\n  }\n  candidates.sort((left, right) => compareText(left.id, right.id));\n  return Object.freeze(candidates);\n}\n\nfunction createDuplicateRecordCandidate(\n  fragment: DuplicateCodeFragment,\n  id: string | undefined,\n  configuredAreas: ResolvedDuplicateDetectionOptions[\"codeAreas\"]\n): DuplicateRecordCandidate | undefined {\n  if (!isValidDuplicateFragment(fragment) || id === undefined) return undefined;\n\n  const locations = sortedLocations(fragment.locations);\n  const codeAreas = uniqueSorted(fragment.codeAreas);\n  if (codeAreas.length === 0 || !sameStrings(codeAreas, fragment.codeAreas)) return undefined;\n  const findingPolicies: FindingPolicy[] = [];\n  for (const areaId of codeAreas) {\n    const area = configuredAreas[areaId];\n    if (area === undefined) return undefined;\n    findingPolicies.push(area.findingPolicy);\n  }\n\n  return Object.freeze({\n    id,\n    data: Object.freeze({\n      blocking: isBlockingFinding(findingPolicies),\n      codeAreas: Object.freeze(codeAreas),\n      lineCount: fragment.lineCount,\n      locations: Object.freeze(\n        locations.map((location) =>\n          Object.freeze({\n            endLine: location.endLine,\n            path: location.path,\n            startLine: location.startLine\n          })\n        )\n      ),\n      metric: \"duplicate-tokens\",\n      tokenCount: fragment.tokenCount\n    })\n  });\n}\n\nexport function isValidDuplicateFragment(fragment: DuplicateCodeFragment): boolean {\n  return (\n    hasValidFragmentMeasurements(fragment) &&\n    Array.isArray(fragment.locations) &&\n    fragment.locations.length >= 2 &&\n    fragment.locations.every(isValidLocation) &&\n    locationsAreDistinct(fragment.locations) &&\n    Array.isArray(fragment.codeAreas) &&\n    fragment.codeAreas.every(nonEmptyString)\n  );\n}\n\nfunction locationsAreDistinct(locations: readonly DuplicateCodeLocation[]): boolean {\n  return locations.every((location, index) =>\n    locations\n      .slice(index + 1)\n      .every((other) => compareDuplicateFindingLocations(location, other) !== 0)\n  );\n}\n\nfunction hasValidFragmentMeasurements(fragment: DuplicateCodeFragment): boolean {\n  return (\n    nonNegativeSafeInteger(fragment.id) &&\n    nonNegativeSafeInteger(fragment.lineCount) &&\n    nonNegativeSafeInteger(fragment.tokenCount)\n  );\n}\n\nfunction nonNegativeSafeInteger(value: number): boolean {\n  return Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction isValidLocation(location: DuplicateCodeLocation): boolean {\n  const validPath = typeof location.path === \"string\" && location.path.length > 0;\n  const validLines =\n    Number.isSafeInteger(location.startLine) &&\n    location.startLine >= 1 &&\n    Number.isSafeInteger(location.endLine) &&\n    location.endLine >= location.startLine;\n  return validPath && validLines;\n}\n\nfunction nonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n\nfunction sameStrings(left: readonly string[], right: readonly string[]): boolean {\n  return left.length === right.length && left.every((value, index) => value === right[index]);\n}\n\nfunction duplicateIdsInOrder(\n  fragments: readonly DuplicateCodeFragment[]\n): readonly string[] | undefined {\n  const occurrences = new Map<string, number>();\n  const ids: string[] = [];\n  for (const fragment of fragments) {\n    if (!isValidDuplicateFragment(fragment)) return undefined;\n    const fingerprint = duplicateFingerprint(fragment);\n    const occurrence = (occurrences.get(fingerprint) ?? 0) + 1;\n    occurrences.set(fingerprint, occurrence);\n    ids.push(`duplicate-fragment/v1/sha256:${fingerprint}/occurrence:${occurrence}`);\n  }\n  return Object.freeze(ids);\n}\n\nfunction duplicateFingerprint(fragment: DuplicateCodeFragment): string {\n  return createHash(\"sha256\")\n    .update(\n      canonicalJsonBytes({\n        lineCount: fragment.lineCount,\n        paths: uniqueSorted(fragment.locations.map((location) => location.path)),\n        tokenCount: fragment.tokenCount\n      })\n    )\n    .digest(\"hex\");\n}\n\nfunction sortedLocations(locations: readonly DuplicateCodeLocation[]): DuplicateCodeLocation[] {\n  return [...locations].sort(compareDuplicateFindingLocations);\n}\n\nfunction uniqueSorted(values: readonly string[]): string[] {\n  return [...new Set(values)].sort(compareText);\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}

package/dist/esm/package-checks/file-metrics/execution.mjs

@@ -1,6 +1,9 @@
 import { reconcileFindingWaivers } from "../../finding-waivers/reconciliation.mjs";
 import { collectProjectFileSets, requireProjectFileSet } from "../project-files/collection.mjs";
 import { settleFindings } from "../code-quality-findings/policy.mjs";
+import { reportFindingWaiverAudits, reportReconciledCodeQualityFindingRecords } from "../code-quality-findings/finding-waiver-evidence.mjs";
+import { appendCheckMessages } from "../../check/finding-presentation.mjs";
+import { fileMetricFindingMessages } from "./finding-messages.mjs";
 import { measureFileMetrics } from "./measurement.mjs";
 import { isValidResolvedFileMetricsOptions } from "./options-validation.mjs";
 import { buildFileRecordCandidates, fileMetricsWaiverAuditRecord, fileMetricsWaiverIdentity } from "./records.mjs";
@@ -32,22 +35,16 @@ export async function executeFileMetrics(context) {
     if (candidates === undefined)
         return unavailable("external-result-invalid");
     const reconciliation = reconcileFileMetricWaivers(candidates, context.options.findingWaivers);
-    for (const finding of reconciliation.findings) {
-        const data = finding.disposition === "waived"
-            ? Object.freeze({
-                ...finding.finding.data,
-                blocking: false,
-                waiver: Object.freeze({ reason: finding.waiver.reason })
-            })
-            : finding.finding.data;
-        context.records.report({ id: finding.finding.id }, data);
-    }
+    reportReconciledCodeQualityFindingRecords(context, reconciliation);
     reportWaiverAuditRecords(context, reconciliation);
     const settlement = settleFindings(reconciliation.findings.map(({ disposition, finding }) => ({
         actionable: disposition !== "waived",
         blocking: finding.data.blocking
     })));
-    return appendWaiverMessages(settlement, reconciliation);
+    const actionableFindings = reconciliation.findings
+        .filter(({ disposition }) => disposition !== "waived")
+        .map(({ finding }) => finding);
+    return appendWaiverMessages(appendCheckMessages(settlement, fileMetricFindingMessages(actionableFindings)), reconciliation);
 }
 function noEligibleInputResult(context) {
     const reconciliation = reconcileFileMetricWaivers([], context.options.findingWaivers);
@@ -62,11 +59,7 @@ function reconcileFileMetricWaivers(candidates, waivers) {
     });
 }
 function reportWaiverAuditRecords(context, reconciliation) {
-    for (const audit of reconciliation.waiverAudits) {
-        const record = fileMetricsWaiverAuditRecord(audit);
-        if (record !== undefined)
-            context.records.report({ id: record.id }, record.data);
-    }
+    reportFindingWaiverAudits(context, reconciliation, fileMetricsWaiverAuditRecord);
 }
 function appendWaiverMessages(settlement, reconciliation) {
     const waiverMessages = [];
@@ -153,7 +146,7 @@ function unavailableMessage(code) {
         case "source-unavailable":
             return "File metrics could not collect its configured project files; check the project root, file permissions, and selected file source.";
         case "external-dependency-unavailable":
-            return "The configured SCC command is unavailable or incompatible; install SCC 3.7.0 or configure a compatible executable.";
+            return "The configured SCC command is unavailable or incompatible; install SCC 4.0.0 or configure a compatible executable.";
         case "external-execution-failed":
             return "SCC did not complete successfully; run the configured command directly and inspect its environment.";
         case "external-result-invalid":

package/dist/esm/package-checks/file-metrics/execution.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckExecutionContext, CheckMessage, CheckResult } from \"../../check/check.ts\";\nimport {\n  reconcileFindingWaivers,\n  type FindingWaiverReconciliation\n} from \"../../finding-waivers/reconciliation.ts\";\nimport { collectProjectFileSets, requireProjectFileSet } from \"../project-files/collection.ts\";\nimport { settleFindings } from \"../code-quality-findings/policy.ts\";\nimport { measureFileMetrics, type FileMeasurementResult } from \"./measurement.ts\";\nimport type { FileMetricsExactInputSet } from \"./measurement-model.ts\";\nimport type {\n  FileMetricsFindingWaiver,\n  ResolvedFileMetricsCodeAreaOptions,\n  ResolvedFileMetricsOptions\n} from \"./options.ts\";\nimport { isValidResolvedFileMetricsOptions } from \"./options-validation.ts\";\nimport {\n  buildFileRecordCandidates,\n  fileMetricsWaiverAuditRecord,\n  fileMetricsWaiverIdentity,\n  type FileRecordCandidate\n} from \"./records.ts\";\nimport type { FileMetricsFinalData } from \"./final-data.ts\";\n\nexport const FILE_METRICS_CHECK_DEFINITION = {\n  checkId: \"file-metrics\",\n  displayName: \"File metrics\"\n} as const;\n\n/** `file-metrics` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type FileMetricsUnavailableReasonCode =\n  | \"external-dependency-unavailable\"\n  | \"external-execution-failed\"\n  | \"external-result-invalid\"\n  | \"invalid-options\"\n  | \"source-unavailable\";\n\ninterface CollectedFileMetricsScope extends FileMetricsExactInputSet {\n  readonly areaIdsByPath: ReadonlyMap<string, readonly string[]>;\n}\n\n/** 使用 resolved area policy 和 scanner selection 执行一次完整的 file-metrics measurement。 */\nexport async function executeFileMetrics(\n  context: CheckExecutionContext<ResolvedFileMetricsOptions>\n): Promise<CheckResult<FileMetricsFinalData>> {\n  if (!isValidResolvedFileMetricsOptions(context.options)) return unavailable(\"invalid-options\");\n\n  let collectedScope: CollectedFileMetricsScope;\n  try {\n    collectedScope = collectAreaScope(context.project.root, context.options.codeAreas);\n  } catch {\n    return unavailable(\"source-unavailable\");\n  }\n  if (collectedScope.approvedExactPaths.length === 0) {\n    return noEligibleInputResult(context);\n  }\n  const measurement = await measureFileMetrics(collectedScope, context.options.scanner);\n  if (measurement.kind !== \"complete\") return measurementFailureResult(measurement);\n  const candidates = buildFileRecordCandidates(measurement.metrics, {\n    areaIdsByPath: collectedScope.areaIdsByPath,\n    codeAreas: context.options.codeAreas\n  });\n  if (candidates === undefined) return unavailable(\"external-result-invalid\");\n  const reconciliation = reconcileFileMetricWaivers(candidates, context.options.findingWaivers);\n  for (const finding of reconciliation.findings) {\n    const data =\n      finding.disposition === \"waived\"\n        ? Object.freeze({\n            ...finding.finding.data,\n            blocking: false,\n            waiver: Object.freeze({ reason: finding.waiver.reason })\n          })\n        : finding.finding.data;\n    context.records.report({ id: finding.finding.id }, data);\n  }\n  reportWaiverAuditRecords(context, reconciliation);\n  const settlement = settleFindings(\n    reconciliation.findings.map(({ disposition, finding }) => ({\n      actionable: disposition !== \"waived\",\n      blocking: finding.data.blocking\n    }))\n  );\n  return appendWaiverMessages(settlement, reconciliation);\n}\n\nfunction noEligibleInputResult(\n  context: CheckExecutionContext<ResolvedFileMetricsOptions>\n): CheckResult<FileMetricsFinalData> {\n  const reconciliation = reconcileFileMetricWaivers([], context.options.findingWaivers);\n  reportWaiverAuditRecords(context, reconciliation);\n  return appendWaiverMessages(\n    Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } }),\n    reconciliation\n  );\n}\n\nfunction reconcileFileMetricWaivers(\n  candidates: readonly FileRecordCandidate[],\n  waivers: readonly FileMetricsFindingWaiver[]\n): FindingWaiverReconciliation<FileRecordCandidate> {\n  return reconcileFindingWaivers({\n    findings: candidates,\n    identify: ({ data }) => ({ metric: data.metric, path: data.path }),\n    waivers\n  });\n}\n\nfunction reportWaiverAuditRecords(\n  context: CheckExecutionContext<ResolvedFileMetricsOptions>,\n  reconciliation: FindingWaiverReconciliation<FileRecordCandidate>\n): void {\n  for (const audit of reconciliation.waiverAudits) {\n    const record = fileMetricsWaiverAuditRecord(audit);\n    if (record !== undefined) context.records.report({ id: record.id }, record.data);\n  }\n}\n\nfunction appendWaiverMessages(\n  settlement: CheckResult<FileMetricsFinalData>,\n  reconciliation: FindingWaiverReconciliation<FileRecordCandidate>\n): CheckResult<FileMetricsFinalData> {\n  const waiverMessages: CheckMessage[] = [];\n  for (const audit of reconciliation.waiverAudits) {\n    const identity = fileMetricsWaiverIdentity(audit.waiver);\n    switch (audit.status) {\n      case \"applied\":\n        waiverMessages.push(\n          Object.freeze({\n            code: \"finding-waived\",\n            level: \"info\",\n            message: `File metric finding for ${identity.path} was waived: ${audit.waiver.reason}`\n          })\n        );\n        break;\n      case \"unused\":\n        waiverMessages.push(\n          Object.freeze({\n            code: \"unused-finding-waiver\",\n            level: \"warning\",\n            message: `Configured file-metrics finding waiver for ${identity.path} matched no finding; remove it or update its identity. Reason: ${audit.waiver.reason}`\n          })\n        );\n        break;\n      case \"overmatched\":\n        waiverMessages.push(\n          Object.freeze({\n            code: \"overmatched-finding-waiver\",\n            level: \"warning\",\n            message: `Configured file-metrics finding waiver for ${identity.path} matched ${audit.matchCount} findings and was not applied; narrow its identity. Reason: ${audit.waiver.reason}`\n          })\n        );\n        break;\n    }\n  }\n  if (waiverMessages.length === 0) return settlement;\n  return Object.freeze({\n    ...settlement,\n    messages: Object.freeze([...(settlement.messages ?? []), ...waiverMessages])\n  });\n}\n\nfunction collectAreaScope(\n  rootDir: string,\n  codeAreas: Readonly<Record<string, ResolvedFileMetricsCodeAreaOptions>>\n): CollectedFileMetricsScope {\n  const areaIdsByPath = new Map<string, string[]>();\n  const filesByArea = collectProjectFileSets(\n    rootDir,\n    Object.fromEntries(Object.entries(codeAreas).map(([areaId, area]) => [areaId, area.files]))\n  );\n  for (const [areaId] of Object.entries(codeAreas)) {\n    for (const path of requireProjectFileSet(filesByArea, areaId)) {\n      const areaIds = areaIdsByPath.get(path);\n      if (areaIds === undefined) areaIdsByPath.set(path, [areaId]);\n      else areaIds.push(areaId);\n    }\n  }\n\n  const normalizedMembership = new Map<string, readonly string[]>();\n  for (const [path, areaIds] of areaIdsByPath) {\n    normalizedMembership.set(path, Object.freeze(areaIds.sort(compareText)));\n  }\n  return Object.freeze({\n    approvedExactPaths: Object.freeze([...normalizedMembership.keys()].sort(compareText)),\n    areaIdsByPath: normalizedMembership,\n    rootDir\n  });\n}\n\nfunction measurementFailureResult(\n  measurement: Exclude<FileMeasurementResult, { kind: \"complete\" }>\n): CheckResult<FileMetricsFinalData> {\n  switch (measurement.kind) {\n    case \"execution-failed\":\n      return unavailable(\"external-execution-failed\");\n    case \"invalid-result\":\n      return unavailable(\"external-result-invalid\");\n    case \"unavailable\":\n      return unavailable(\"external-dependency-unavailable\");\n  }\n  const exhaustiveMeasurement: never = measurement;\n  return exhaustiveMeasurement;\n}\n\nfunction unavailable(code: FileMetricsUnavailableReasonCode): CheckResult<FileMetricsFinalData> {\n  return Object.freeze({\n    status: \"unavailable\",\n    reason: { code },\n    messages: Object.freeze([\n      Object.freeze({ code, level: \"error\" as const, message: unavailableMessage(code) })\n    ])\n  });\n}\n\nfunction unavailableMessage(code: FileMetricsUnavailableReasonCode): string {\n  switch (code) {\n    case \"invalid-options\":\n      return \"fileMetrics options are invalid; recreate the Check with fileMetrics(options) or restore its complete resolved options.\";\n    case \"source-unavailable\":\n      return \"File metrics could not collect its configured project files; check the project root, file permissions, and selected file source.\";\n    case \"external-dependency-unavailable\":\n      return \"The configured SCC command is unavailable or incompatible; install SCC 3.7.0 or configure a compatible executable.\";\n    case \"external-execution-failed\":\n      return \"SCC did not complete successfully; run the configured command directly and inspect its environment.\";\n    case \"external-result-invalid\":\n      return \"SCC output could not form a trusted complete result; check the executable version and CSV compatibility.\";\n  }\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}
+{"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckExecutionContext, CheckMessage, CheckResult } from \"../../check/check.ts\";\nimport {\n  reconcileFindingWaivers,\n  type FindingWaiverReconciliation\n} from \"../../finding-waivers/reconciliation.ts\";\nimport { collectProjectFileSets, requireProjectFileSet } from \"../project-files/collection.ts\";\nimport { settleFindings } from \"../code-quality-findings/policy.ts\";\nimport {\n  reportFindingWaiverAudits,\n  reportReconciledCodeQualityFindingRecords\n} from \"../code-quality-findings/finding-waiver-evidence.ts\";\nimport { appendCheckMessages } from \"../../check/finding-presentation.ts\";\nimport { fileMetricFindingMessages } from \"./finding-messages.ts\";\nimport { measureFileMetrics, type FileMeasurementResult } from \"./measurement.ts\";\nimport type { FileMetricsExactInputSet } from \"./measurement-model.ts\";\nimport type {\n  FileMetricsFindingWaiver,\n  ResolvedFileMetricsCodeAreaOptions,\n  ResolvedFileMetricsOptions\n} from \"./options.ts\";\nimport { isValidResolvedFileMetricsOptions } from \"./options-validation.ts\";\nimport {\n  buildFileRecordCandidates,\n  fileMetricsWaiverAuditRecord,\n  fileMetricsWaiverIdentity,\n  type FileRecordCandidate\n} from \"./records.ts\";\nimport type { FileMetricsFinalData } from \"./final-data.ts\";\n\nexport const FILE_METRICS_CHECK_DEFINITION = {\n  checkId: \"file-metrics\",\n  displayName: \"File metrics\"\n} as const;\n\n/** `file-metrics` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type FileMetricsUnavailableReasonCode =\n  | \"external-dependency-unavailable\"\n  | \"external-execution-failed\"\n  | \"external-result-invalid\"\n  | \"invalid-options\"\n  | \"source-unavailable\";\n\ninterface CollectedFileMetricsScope extends FileMetricsExactInputSet {\n  readonly areaIdsByPath: ReadonlyMap<string, readonly string[]>;\n}\n\n/** 使用 resolved area policy 和 scanner selection 执行一次完整的 file-metrics measurement。 */\nexport async function executeFileMetrics(\n  context: CheckExecutionContext<ResolvedFileMetricsOptions>\n): Promise<CheckResult<FileMetricsFinalData>> {\n  if (!isValidResolvedFileMetricsOptions(context.options)) return unavailable(\"invalid-options\");\n\n  let collectedScope: CollectedFileMetricsScope;\n  try {\n    collectedScope = collectAreaScope(context.project.root, context.options.codeAreas);\n  } catch {\n    return unavailable(\"source-unavailable\");\n  }\n  if (collectedScope.approvedExactPaths.length === 0) {\n    return noEligibleInputResult(context);\n  }\n  const measurement = await measureFileMetrics(collectedScope, context.options.scanner);\n  if (measurement.kind !== \"complete\") return measurementFailureResult(measurement);\n  const candidates = buildFileRecordCandidates(measurement.metrics, {\n    areaIdsByPath: collectedScope.areaIdsByPath,\n    codeAreas: context.options.codeAreas\n  });\n  if (candidates === undefined) return unavailable(\"external-result-invalid\");\n  const reconciliation = reconcileFileMetricWaivers(candidates, context.options.findingWaivers);\n  reportReconciledCodeQualityFindingRecords(context, reconciliation);\n  reportWaiverAuditRecords(context, reconciliation);\n  const settlement = settleFindings(\n    reconciliation.findings.map(({ disposition, finding }) => ({\n      actionable: disposition !== \"waived\",\n      blocking: finding.data.blocking\n    }))\n  );\n  const actionableFindings = reconciliation.findings\n    .filter(({ disposition }) => disposition !== \"waived\")\n    .map(({ finding }) => finding);\n  return appendWaiverMessages(\n    appendCheckMessages(settlement, fileMetricFindingMessages(actionableFindings)),\n    reconciliation\n  );\n}\n\nfunction noEligibleInputResult(\n  context: CheckExecutionContext<ResolvedFileMetricsOptions>\n): CheckResult<FileMetricsFinalData> {\n  const reconciliation = reconcileFileMetricWaivers([], context.options.findingWaivers);\n  reportWaiverAuditRecords(context, reconciliation);\n  return appendWaiverMessages(\n    Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } }),\n    reconciliation\n  );\n}\n\nfunction reconcileFileMetricWaivers(\n  candidates: readonly FileRecordCandidate[],\n  waivers: readonly FileMetricsFindingWaiver[]\n): FindingWaiverReconciliation<FileRecordCandidate> {\n  return reconcileFindingWaivers({\n    findings: candidates,\n    identify: ({ data }) => ({ metric: data.metric, path: data.path }),\n    waivers\n  });\n}\n\nfunction reportWaiverAuditRecords(\n  context: CheckExecutionContext<ResolvedFileMetricsOptions>,\n  reconciliation: FindingWaiverReconciliation<FileRecordCandidate>\n): void {\n  reportFindingWaiverAudits(context, reconciliation, fileMetricsWaiverAuditRecord);\n}\n\nfunction appendWaiverMessages(\n  settlement: CheckResult<FileMetricsFinalData>,\n  reconciliation: FindingWaiverReconciliation<FileRecordCandidate>\n): CheckResult<FileMetricsFinalData> {\n  const waiverMessages: CheckMessage[] = [];\n  for (const audit of reconciliation.waiverAudits) {\n    const identity = fileMetricsWaiverIdentity(audit.waiver);\n    switch (audit.status) {\n      case \"applied\":\n        waiverMessages.push(\n          Object.freeze({\n            code: \"finding-waived\",\n            level: \"info\",\n            message: `File metric finding for ${identity.path} was waived: ${audit.waiver.reason}`\n          })\n        );\n        break;\n      case \"unused\":\n        waiverMessages.push(\n          Object.freeze({\n            code: \"unused-finding-waiver\",\n            level: \"warning\",\n            message: `Configured file-metrics finding waiver for ${identity.path} matched no finding; remove it or update its identity. Reason: ${audit.waiver.reason}`\n          })\n        );\n        break;\n      case \"overmatched\":\n        waiverMessages.push(\n          Object.freeze({\n            code: \"overmatched-finding-waiver\",\n            level: \"warning\",\n            message: `Configured file-metrics finding waiver for ${identity.path} matched ${audit.matchCount} findings and was not applied; narrow its identity. Reason: ${audit.waiver.reason}`\n          })\n        );\n        break;\n    }\n  }\n  if (waiverMessages.length === 0) return settlement;\n  return Object.freeze({\n    ...settlement,\n    messages: Object.freeze([...(settlement.messages ?? []), ...waiverMessages])\n  });\n}\n\nfunction collectAreaScope(\n  rootDir: string,\n  codeAreas: Readonly<Record<string, ResolvedFileMetricsCodeAreaOptions>>\n): CollectedFileMetricsScope {\n  const areaIdsByPath = new Map<string, string[]>();\n  const filesByArea = collectProjectFileSets(\n    rootDir,\n    Object.fromEntries(Object.entries(codeAreas).map(([areaId, area]) => [areaId, area.files]))\n  );\n  for (const [areaId] of Object.entries(codeAreas)) {\n    for (const path of requireProjectFileSet(filesByArea, areaId)) {\n      const areaIds = areaIdsByPath.get(path);\n      if (areaIds === undefined) areaIdsByPath.set(path, [areaId]);\n      else areaIds.push(areaId);\n    }\n  }\n\n  const normalizedMembership = new Map<string, readonly string[]>();\n  for (const [path, areaIds] of areaIdsByPath) {\n    normalizedMembership.set(path, Object.freeze(areaIds.sort(compareText)));\n  }\n  return Object.freeze({\n    approvedExactPaths: Object.freeze([...normalizedMembership.keys()].sort(compareText)),\n    areaIdsByPath: normalizedMembership,\n    rootDir\n  });\n}\n\nfunction measurementFailureResult(\n  measurement: Exclude<FileMeasurementResult, { kind: \"complete\" }>\n): CheckResult<FileMetricsFinalData> {\n  switch (measurement.kind) {\n    case \"execution-failed\":\n      return unavailable(\"external-execution-failed\");\n    case \"invalid-result\":\n      return unavailable(\"external-result-invalid\");\n    case \"unavailable\":\n      return unavailable(\"external-dependency-unavailable\");\n  }\n  const exhaustiveMeasurement: never = measurement;\n  return exhaustiveMeasurement;\n}\n\nfunction unavailable(code: FileMetricsUnavailableReasonCode): CheckResult<FileMetricsFinalData> {\n  return Object.freeze({\n    status: \"unavailable\",\n    reason: { code },\n    messages: Object.freeze([\n      Object.freeze({ code, level: \"error\" as const, message: unavailableMessage(code) })\n    ])\n  });\n}\n\nfunction unavailableMessage(code: FileMetricsUnavailableReasonCode): string {\n  switch (code) {\n    case \"invalid-options\":\n      return \"fileMetrics options are invalid; recreate the Check with fileMetrics(options) or restore its complete resolved options.\";\n    case \"source-unavailable\":\n      return \"File metrics could not collect its configured project files; check the project root, file permissions, and selected file source.\";\n    case \"external-dependency-unavailable\":\n      return \"The configured SCC command is unavailable or incompatible; install SCC 4.0.0 or configure a compatible executable.\";\n    case \"external-execution-failed\":\n      return \"SCC did not complete successfully; run the configured command directly and inspect its environment.\";\n    case \"external-result-invalid\":\n      return \"SCC output could not form a trusted complete result; check the executable version and CSV compatibility.\";\n  }\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}

package/dist/esm/package-checks/file-metrics/finding-messages.mjs

@@ -0,0 +1,22 @@
+import { presentCheckFindings } from "../../check/finding-presentation.mjs";
+const PRESENTED_FINDING_LIMIT = 10;
+/** Projects actionable file-metric Records into bounded terminal summaries. */
+export function fileMetricFindingMessages(findings) {
+    return presentCheckFindings({
+        findings,
+        limit: PRESENTED_FINDING_LIMIT,
+        message: ({ data }) => Object.freeze({
+            code: "finding-detail",
+            level: data.blocking ? "error" : "warning",
+            message: `${data.path}: ${data.codeLines} code lines exceeds the ${data.limit} line limit (areas: ${data.codeAreas.join(", ")}).`
+        }),
+        omittedMessage: ({ omittedCount, omittedFindings }) => Object.freeze({
+            code: "findings-omitted",
+            level: omittedFindings.some(({ data }) => data.blocking)
+                ? "error"
+                : "warning",
+            message: `${omittedCount} additional file metric finding(s) were not shown; inspect this Check's Records for the complete set.`
+        })
+    });
+}
+//# sourceMappingURL=finding-messages.mjs.map

package/dist/esm/package-checks/file-metrics/finding-messages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-messages.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/finding-messages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAG3E,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAEnC,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CACvC,QAAwC;IAExC,OAAO,oBAAoB,CAAC;QAC1B,QAAQ;QACR,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CACpB,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,gBAAgB;YACtB,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAE,SAAmB;YAChE,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,SAAS,2BAA2B,IAAI,CAAC,KAAK,uBAAuB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;SAClI,CAAC;QACJ,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,CACpD,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC;gBACtD,CAAC,CAAE,OAAiB;gBACpB,CAAC,CAAE,SAAmB;YACxB,OAAO,EAAE,GAAG,YAAY,uGAAuG;SAChI,CAAC;KACL,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage } from \"../../check/check.ts\";\nimport { presentCheckFindings } from \"../../check/finding-presentation.ts\";\nimport type { FileRecordCandidate } from \"./records.ts\";\n\nconst PRESENTED_FINDING_LIMIT = 10;\n\n/** Projects actionable file-metric Records into bounded terminal summaries. */\nexport function fileMetricFindingMessages(\n  findings: readonly FileRecordCandidate[]\n): readonly CheckMessage[] {\n  return presentCheckFindings({\n    findings,\n    limit: PRESENTED_FINDING_LIMIT,\n    message: ({ data }) =>\n      Object.freeze({\n        code: \"finding-detail\",\n        level: data.blocking ? (\"error\" as const) : (\"warning\" as const),\n        message: `${data.path}: ${data.codeLines} code lines exceeds the ${data.limit} line limit (areas: ${data.codeAreas.join(\", \")}).`\n      }),\n    omittedMessage: ({ omittedCount, omittedFindings }) =>\n      Object.freeze({\n        code: \"findings-omitted\",\n        level: omittedFindings.some(({ data }) => data.blocking)\n          ? (\"error\" as const)\n          : (\"warning\" as const),\n        message: `${omittedCount} additional file metric finding(s) were not shown; inspect this Check's Records for the complete set.`\n      })\n  });\n}\n"]}

package/dist/esm/package-checks/file-metrics/options-resolution.mjs

@@ -1,6 +1,7 @@
-import { hasRequiredAndOptionalRecordKeys, snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { snapshotClosedArray, snapshotClosedPolicyRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString, isNonNegativeSafeInteger, isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
 import { resolveProjectFileSelection, snapshotDefaultProjectFileSelection } from "../project-files/configuration.mjs";
-import { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { DEFAULT_FINDING_POLICY, resolveCodeAreaPolicyMap, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
 import { isNormalizedProjectRelativePath } from "../host-environment/path.mjs";
 import { isValidResolvedFileMetricsOptions } from "./options-validation.mjs";
 const DEFAULT_EXECUTABLE = "scc";
@@ -9,7 +10,7 @@ const DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES = 600;
 const DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS = 12;
 /** 校验 constructor input，并将所有可省略 policy 物化为完整、冻结的 Check options。 */
 export function resolveFileMetricsOptions(authoredOptions) {
-    const input = snapshotPolicyRecord(authoredOptions, {
+    const input = snapshotClosedPolicyRecord(authoredOptions, {
         optional: ["codeAreas", "findingPolicy", "findingWaivers", "scanner"]
     });
     if (input === undefined)
@@ -46,14 +47,14 @@ function resolveFindingWaivers(value) {
     return Object.freeze(waivers);
 }
 function resolveFindingWaiver(value) {
-    const waiver = snapshotPolicyRecord(value, { required: ["identity", "reason"] });
+    const waiver = snapshotClosedPolicyRecord(value, { required: ["identity", "reason"] });
     if (waiver === undefined || !isNonEmptyString(waiver.reason))
         return undefined;
     const identity = resolveFindingIdentity(waiver.identity);
     return identity === undefined ? undefined : Object.freeze({ identity, reason: waiver.reason });
 }
 function resolveFindingIdentity(value) {
-    const identity = snapshotPolicyRecord(value, { required: ["metric", "path"] });
+    const identity = snapshotClosedPolicyRecord(value, { required: ["metric", "path"] });
     return identity === undefined ||
         identity.metric !== "code-lines" ||
         !isNormalizedProjectRelativePath(identity.path)
@@ -61,21 +62,7 @@ function resolveFindingIdentity(value) {
         : Object.freeze({ metric: "code-lines", path: identity.path });
 }
 function resolveCodeAreas(value, defaultFindingPolicy) {
-    if (value === undefined)
-        return Object.freeze({ project: defaultCodeArea(defaultFindingPolicy) });
-    const areas = snapshotClosedRecord(value);
-    if (areas === undefined || Object.keys(areas).length === 0)
-        return undefined;
-    const resolvedEntries = [];
-    for (const [areaId, candidate] of Object.entries(areas)) {
-        if (!isNonEmptyString(areaId))
-            return undefined;
-        const area = resolveCodeArea(candidate, defaultFindingPolicy);
-        if (area === undefined)
-            return undefined;
-        resolvedEntries.push([areaId, area]);
-    }
-    return Object.freeze(Object.fromEntries(resolvedEntries));
+    return resolveCodeAreaPolicyMap(value, () => defaultCodeArea(defaultFindingPolicy), (candidate) => resolveCodeArea(candidate, defaultFindingPolicy));
 }
 function defaultCodeArea(findingPolicy) {
     return Object.freeze({
@@ -85,7 +72,7 @@ function defaultCodeArea(findingPolicy) {
     });
 }
 function resolveCodeArea(value, defaultFindingPolicy) {
-    const area = snapshotPolicyRecord(value, {
+    const area = snapshotClosedPolicyRecord(value, {
         optional: ["codeLines", "findingPolicy"],
         required: ["files"]
     });
@@ -101,7 +88,7 @@ function resolveCodeArea(value, defaultFindingPolicy) {
 function resolveCodeLines(value) {
     if (value === undefined)
         return defaultCodeLines();
-    const codeLines = snapshotPolicyRecord(value, {
+    const codeLines = snapshotClosedPolicyRecord(value, {
         optional: ["lowDecisionTokenAllowance", "maximum"]
     });
     if (codeLines === undefined)
@@ -127,7 +114,7 @@ function defaultCodeLines() {
 function resolveAllowance(value) {
     if (value === undefined)
         return defaultCodeLines().lowDecisionTokenAllowance;
-    const allowance = snapshotPolicyRecord(value, {
+    const allowance = snapshotClosedPolicyRecord(value, {
         optional: ["maximumCodeLines", "maximumDecisionTokens"]
     });
     if (allowance === undefined)
@@ -143,29 +130,10 @@ function resolveAllowance(value) {
 function resolveScanner(value) {
     if (value === undefined)
         return Object.freeze({ executable: DEFAULT_EXECUTABLE });
-    const scanner = snapshotPolicyRecord(value, { optional: ["executable"] });
+    const scanner = snapshotClosedPolicyRecord(value, { optional: ["executable"] });
     if (scanner === undefined)
         return undefined;
     const executable = scanner.executable ?? DEFAULT_EXECUTABLE;
     return isNonEmptyString(executable) ? Object.freeze({ executable }) : undefined;
 }
-function snapshotPolicyRecord(value, keys) {
-    const record = snapshotClosedRecord(value);
-    return record !== undefined &&
-        hasRequiredAndOptionalRecordKeys(record, {
-            optional: keys.optional ?? [],
-            required: keys.required ?? []
-        })
-        ? record
-        : undefined;
-}
-function isPositiveSafeInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
-}
-function isNonNegativeSafeInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
-}
-function isNonEmptyString(value) {
-    return typeof value === "string" && value.length > 0;
-}
 //# sourceMappingURL=options-resolution.mjs.map

package/dist/esm/package-checks/file-metrics/options-resolution.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/options-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedArray,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport {\n  resolveProjectFileSelection,\n  snapshotDefaultProjectFileSelection\n} from \"../project-files/configuration.ts\";\nimport {\n  DEFAULT_FINDING_POLICY,\n  resolveFindingPolicy,\n  type FindingPolicy\n} from \"../code-quality-findings/policy.ts\";\nimport { isNormalizedProjectRelativePath } from \"../host-environment/path.ts\";\nimport type {\n  FileMetricsFindingIdentity,\n  FileMetricsFindingWaiver,\n  ResolvedFileMetricsCodeAreaOptions,\n  ResolvedFileMetricsOptions\n} from \"./options.ts\";\nimport { isValidResolvedFileMetricsOptions } from \"./options-validation.ts\";\n\nconst DEFAULT_EXECUTABLE = \"scc\";\nconst DEFAULT_MAXIMUM_CODE_LINES = 360;\nconst DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES = 600;\nconst DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS = 12;\n\ninterface PolicyRecordKeys {\n  readonly optional?: readonly string[];\n  readonly required?: readonly string[];\n}\n\n/** 校验 constructor input，并将所有可省略 policy 物化为完整、冻结的 Check options。 */\nexport function resolveFileMetricsOptions(\n  authoredOptions: unknown\n): ResolvedFileMetricsOptions | undefined {\n  const input = snapshotPolicyRecord(authoredOptions, {\n    optional: [\"codeAreas\", \"findingPolicy\", \"findingWaivers\", \"scanner\"]\n  });\n  if (input === undefined) return undefined;\n\n  const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);\n  if (findingPolicy === undefined) return undefined;\n  const codeAreas = resolveCodeAreas(input.codeAreas, findingPolicy);\n  const findingWaivers = resolveFindingWaivers(input.findingWaivers);\n  const scanner = resolveScanner(input.scanner);\n  if (codeAreas === undefined || findingWaivers === undefined || scanner === undefined)\n    return undefined;\n\n  const options = Object.freeze({ codeAreas, findingWaivers, scanner });\n  return isValidResolvedFileMetricsOptions(options) ? options : undefined;\n}\n\nfunction resolveFindingWaivers(value: unknown): readonly FileMetricsFindingWaiver[] | undefined {\n  if (value === undefined) return Object.freeze([]);\n  const candidates = snapshotClosedArray(value);\n  if (candidates === undefined) return undefined;\n  const waivers: FileMetricsFindingWaiver[] = [];\n  const seenIdentities = new Set<string>();\n  for (const candidate of candidates) {\n    const waiver = resolveFindingWaiver(candidate);\n    if (waiver === undefined) return undefined;\n    const identityKey = `${waiver.identity.metric}\\u0000${waiver.identity.path}`;\n    if (seenIdentities.has(identityKey)) return undefined;\n    seenIdentities.add(identityKey);\n    waivers.push(waiver);\n  }\n  return Object.freeze(waivers);\n}\n\nfunction resolveFindingWaiver(value: unknown): FileMetricsFindingWaiver | undefined {\n  const waiver = snapshotPolicyRecord(value, { required: [\"identity\", \"reason\"] });\n  if (waiver === undefined || !isNonEmptyString(waiver.reason)) return undefined;\n  const identity = resolveFindingIdentity(waiver.identity);\n  return identity === undefined ? undefined : Object.freeze({ identity, reason: waiver.reason });\n}\n\nfunction resolveFindingIdentity(value: unknown): FileMetricsFindingIdentity | undefined {\n  const identity = snapshotPolicyRecord(value, { required: [\"metric\", \"path\"] });\n  return identity === undefined ||\n    identity.metric !== \"code-lines\" ||\n    !isNormalizedProjectRelativePath(identity.path)\n    ? undefined\n    : Object.freeze({ metric: \"code-lines\", path: identity.path });\n}\n\nfunction resolveCodeAreas(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedFileMetricsOptions[\"codeAreas\"] | undefined {\n  if (value === undefined) return Object.freeze({ project: defaultCodeArea(defaultFindingPolicy) });\n  const areas = snapshotClosedRecord(value);\n  if (areas === undefined || Object.keys(areas).length === 0) return undefined;\n\n  const resolvedEntries: Array<readonly [string, ResolvedFileMetricsCodeAreaOptions]> = [];\n  for (const [areaId, candidate] of Object.entries(areas)) {\n    if (!isNonEmptyString(areaId)) return undefined;\n    const area = resolveCodeArea(candidate, defaultFindingPolicy);\n    if (area === undefined) return undefined;\n    resolvedEntries.push([areaId, area]);\n  }\n  return Object.freeze(Object.fromEntries(resolvedEntries));\n}\n\nfunction defaultCodeArea(findingPolicy: FindingPolicy): ResolvedFileMetricsCodeAreaOptions {\n  return Object.freeze({\n    codeLines: defaultCodeLines(),\n    files: snapshotDefaultProjectFileSelection(),\n    findingPolicy\n  });\n}\n\nfunction resolveCodeArea(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedFileMetricsCodeAreaOptions | undefined {\n  const area = snapshotPolicyRecord(value, {\n    optional: [\"codeLines\", \"findingPolicy\"],\n    required: [\"files\"]\n  });\n  if (area === undefined) return undefined;\n  const files = resolveProjectFileSelection(area.files);\n  const findingPolicy = resolveFindingPolicy(area.findingPolicy, defaultFindingPolicy);\n  const codeLines = resolveCodeLines(area.codeLines);\n  return files === undefined || findingPolicy === undefined || codeLines === undefined\n    ? undefined\n    : Object.freeze({ codeLines, files, findingPolicy });\n}\n\nfunction resolveCodeLines(\n  value: unknown\n): ResolvedFileMetricsCodeAreaOptions[\"codeLines\"] | undefined {\n  if (value === undefined) return defaultCodeLines();\n  const codeLines = snapshotPolicyRecord(value, {\n    optional: [\"lowDecisionTokenAllowance\", \"maximum\"]\n  });\n  if (codeLines === undefined) return undefined;\n  const maximum = codeLines.maximum ?? DEFAULT_MAXIMUM_CODE_LINES;\n  const lowDecisionTokenAllowance = resolveAllowance(codeLines.lowDecisionTokenAllowance);\n  if (\n    !isPositiveSafeInteger(maximum) ||\n    lowDecisionTokenAllowance === undefined ||\n    lowDecisionTokenAllowance.maximumCodeLines <= maximum\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ lowDecisionTokenAllowance, maximum });\n}\n\nfunction defaultCodeLines(): ResolvedFileMetricsCodeAreaOptions[\"codeLines\"] {\n  return Object.freeze({\n    lowDecisionTokenAllowance: Object.freeze({\n      maximumCodeLines: DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES,\n      maximumDecisionTokens: DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS\n    }),\n    maximum: DEFAULT_MAXIMUM_CODE_LINES\n  });\n}\n\nfunction resolveAllowance(\n  value: unknown\n): ResolvedFileMetricsCodeAreaOptions[\"codeLines\"][\"lowDecisionTokenAllowance\"] | undefined {\n  if (value === undefined) return defaultCodeLines().lowDecisionTokenAllowance;\n  const allowance = snapshotPolicyRecord(value, {\n    optional: [\"maximumCodeLines\", \"maximumDecisionTokens\"]\n  });\n  if (allowance === undefined) return undefined;\n  const maximumCodeLines = allowance.maximumCodeLines ?? DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES;\n  const maximumDecisionTokens =\n    allowance.maximumDecisionTokens ?? DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS;\n  if (\n    !isPositiveSafeInteger(maximumCodeLines) ||\n    !isNonNegativeSafeInteger(maximumDecisionTokens)\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ maximumCodeLines, maximumDecisionTokens });\n}\n\nfunction resolveScanner(value: unknown): ResolvedFileMetricsOptions[\"scanner\"] | undefined {\n  if (value === undefined) return Object.freeze({ executable: DEFAULT_EXECUTABLE });\n  const scanner = snapshotPolicyRecord(value, { optional: [\"executable\"] });\n  if (scanner === undefined) return undefined;\n  const executable = scanner.executable ?? DEFAULT_EXECUTABLE;\n  return isNonEmptyString(executable) ? Object.freeze({ executable }) : undefined;\n}\n\nfunction snapshotPolicyRecord(\n  value: unknown,\n  keys: PolicyRecordKeys\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  return record !== undefined &&\n    hasRequiredAndOptionalRecordKeys(record, {\n      optional: keys.optional ?? [],\n      required: keys.required ?? []\n    })\n    ? record\n    : undefined;\n}\n\nfunction isPositiveSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction isNonNegativeSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n"]}
+{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/options-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  snapshotClosedArray,\n  snapshotClosedPolicyRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport {\n  isNonEmptyString,\n  isNonNegativeSafeInteger,\n  isPositiveSafeInteger\n} from \"../../data-boundary/value-shapes.ts\";\nimport {\n  resolveProjectFileSelection,\n  snapshotDefaultProjectFileSelection\n} from \"../project-files/configuration.ts\";\nimport {\n  DEFAULT_FINDING_POLICY,\n  resolveCodeAreaPolicyMap,\n  resolveFindingPolicy,\n  type FindingPolicy\n} from \"../code-quality-findings/policy.ts\";\nimport { isNormalizedProjectRelativePath } from \"../host-environment/path.ts\";\nimport type {\n  FileMetricsFindingIdentity,\n  FileMetricsFindingWaiver,\n  ResolvedFileMetricsCodeAreaOptions,\n  ResolvedFileMetricsOptions\n} from \"./options.ts\";\nimport { isValidResolvedFileMetricsOptions } from \"./options-validation.ts\";\n\nconst DEFAULT_EXECUTABLE = \"scc\";\nconst DEFAULT_MAXIMUM_CODE_LINES = 360;\nconst DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES = 600;\nconst DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS = 12;\n\n/** 校验 constructor input，并将所有可省略 policy 物化为完整、冻结的 Check options。 */\nexport function resolveFileMetricsOptions(\n  authoredOptions: unknown\n): ResolvedFileMetricsOptions | undefined {\n  const input = snapshotClosedPolicyRecord(authoredOptions, {\n    optional: [\"codeAreas\", \"findingPolicy\", \"findingWaivers\", \"scanner\"]\n  });\n  if (input === undefined) return undefined;\n\n  const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);\n  if (findingPolicy === undefined) return undefined;\n  const codeAreas = resolveCodeAreas(input.codeAreas, findingPolicy);\n  const findingWaivers = resolveFindingWaivers(input.findingWaivers);\n  const scanner = resolveScanner(input.scanner);\n  if (codeAreas === undefined || findingWaivers === undefined || scanner === undefined)\n    return undefined;\n\n  const options = Object.freeze({ codeAreas, findingWaivers, scanner });\n  return isValidResolvedFileMetricsOptions(options) ? options : undefined;\n}\n\nfunction resolveFindingWaivers(value: unknown): readonly FileMetricsFindingWaiver[] | undefined {\n  if (value === undefined) return Object.freeze([]);\n  const candidates = snapshotClosedArray(value);\n  if (candidates === undefined) return undefined;\n  const waivers: FileMetricsFindingWaiver[] = [];\n  const seenIdentities = new Set<string>();\n  for (const candidate of candidates) {\n    const waiver = resolveFindingWaiver(candidate);\n    if (waiver === undefined) return undefined;\n    const identityKey = `${waiver.identity.metric}\\u0000${waiver.identity.path}`;\n    if (seenIdentities.has(identityKey)) return undefined;\n    seenIdentities.add(identityKey);\n    waivers.push(waiver);\n  }\n  return Object.freeze(waivers);\n}\n\nfunction resolveFindingWaiver(value: unknown): FileMetricsFindingWaiver | undefined {\n  const waiver = snapshotClosedPolicyRecord(value, { required: [\"identity\", \"reason\"] });\n  if (waiver === undefined || !isNonEmptyString(waiver.reason)) return undefined;\n  const identity = resolveFindingIdentity(waiver.identity);\n  return identity === undefined ? undefined : Object.freeze({ identity, reason: waiver.reason });\n}\n\nfunction resolveFindingIdentity(value: unknown): FileMetricsFindingIdentity | undefined {\n  const identity = snapshotClosedPolicyRecord(value, { required: [\"metric\", \"path\"] });\n  return identity === undefined ||\n    identity.metric !== \"code-lines\" ||\n    !isNormalizedProjectRelativePath(identity.path)\n    ? undefined\n    : Object.freeze({ metric: \"code-lines\", path: identity.path });\n}\n\nfunction resolveCodeAreas(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedFileMetricsOptions[\"codeAreas\"] | undefined {\n  return resolveCodeAreaPolicyMap(\n    value,\n    () => defaultCodeArea(defaultFindingPolicy),\n    (candidate) => resolveCodeArea(candidate, defaultFindingPolicy)\n  );\n}\n\nfunction defaultCodeArea(findingPolicy: FindingPolicy): ResolvedFileMetricsCodeAreaOptions {\n  return Object.freeze({\n    codeLines: defaultCodeLines(),\n    files: snapshotDefaultProjectFileSelection(),\n    findingPolicy\n  });\n}\n\nfunction resolveCodeArea(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedFileMetricsCodeAreaOptions | undefined {\n  const area = snapshotClosedPolicyRecord(value, {\n    optional: [\"codeLines\", \"findingPolicy\"],\n    required: [\"files\"]\n  });\n  if (area === undefined) return undefined;\n  const files = resolveProjectFileSelection(area.files);\n  const findingPolicy = resolveFindingPolicy(area.findingPolicy, defaultFindingPolicy);\n  const codeLines = resolveCodeLines(area.codeLines);\n  return files === undefined || findingPolicy === undefined || codeLines === undefined\n    ? undefined\n    : Object.freeze({ codeLines, files, findingPolicy });\n}\n\nfunction resolveCodeLines(\n  value: unknown\n): ResolvedFileMetricsCodeAreaOptions[\"codeLines\"] | undefined {\n  if (value === undefined) return defaultCodeLines();\n  const codeLines = snapshotClosedPolicyRecord(value, {\n    optional: [\"lowDecisionTokenAllowance\", \"maximum\"]\n  });\n  if (codeLines === undefined) return undefined;\n  const maximum = codeLines.maximum ?? DEFAULT_MAXIMUM_CODE_LINES;\n  const lowDecisionTokenAllowance = resolveAllowance(codeLines.lowDecisionTokenAllowance);\n  if (\n    !isPositiveSafeInteger(maximum) ||\n    lowDecisionTokenAllowance === undefined ||\n    lowDecisionTokenAllowance.maximumCodeLines <= maximum\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ lowDecisionTokenAllowance, maximum });\n}\n\nfunction defaultCodeLines(): ResolvedFileMetricsCodeAreaOptions[\"codeLines\"] {\n  return Object.freeze({\n    lowDecisionTokenAllowance: Object.freeze({\n      maximumCodeLines: DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES,\n      maximumDecisionTokens: DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS\n    }),\n    maximum: DEFAULT_MAXIMUM_CODE_LINES\n  });\n}\n\nfunction resolveAllowance(\n  value: unknown\n): ResolvedFileMetricsCodeAreaOptions[\"codeLines\"][\"lowDecisionTokenAllowance\"] | undefined {\n  if (value === undefined) return defaultCodeLines().lowDecisionTokenAllowance;\n  const allowance = snapshotClosedPolicyRecord(value, {\n    optional: [\"maximumCodeLines\", \"maximumDecisionTokens\"]\n  });\n  if (allowance === undefined) return undefined;\n  const maximumCodeLines = allowance.maximumCodeLines ?? DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES;\n  const maximumDecisionTokens =\n    allowance.maximumDecisionTokens ?? DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS;\n  if (\n    !isPositiveSafeInteger(maximumCodeLines) ||\n    !isNonNegativeSafeInteger(maximumDecisionTokens)\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ maximumCodeLines, maximumDecisionTokens });\n}\n\nfunction resolveScanner(value: unknown): ResolvedFileMetricsOptions[\"scanner\"] | undefined {\n  if (value === undefined) return Object.freeze({ executable: DEFAULT_EXECUTABLE });\n  const scanner = snapshotClosedPolicyRecord(value, { optional: [\"executable\"] });\n  if (scanner === undefined) return undefined;\n  const executable = scanner.executable ?? DEFAULT_EXECUTABLE;\n  return isNonEmptyString(executable) ? Object.freeze({ executable }) : undefined;\n}\n"]}