@zxyycom/vibe-check 0.0.1

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

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/measurement.ts"],"names":[],"mappings":"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","sourcesContent":["import { acceptExactInputMeasurements } from \"../project-files/exact-input-measurement.ts\";\nimport { applyDuplicateAreaPolicy } from \"./area-policy.ts\";\nimport {\n  loadScanCacheEntry,\n  writeScanCacheEntry,\n  type DuplicateCodeCacheIdentity\n} from \"./cache/store.ts\";\nimport { createDuplicateScanCacheIdentity } from \"./cache/identity.ts\";\nimport { checkJscpd } from \"./jscpd/availability.ts\";\nimport { scanWithJscpdAsync } from \"./jscpd/scanner.ts\";\nimport { toScopedJscpdMeasurements } from \"./jscpd/scoped-fragments.ts\";\nimport type {\n  DuplicateCodeFragment,\n  DuplicateDetectionAreaInput,\n  DuplicateDetectionExactInputSet,\n  DuplicateMeasurementInput\n} from \"./measurement-model.ts\";\nimport type { ResolvedDuplicateDetectionScannerOptions } from \"./options.ts\";\nimport { isValidDuplicateFragment } from \"./records.ts\";\n\nexport type DuplicateMeasurementResult = Readonly<\n  | { fragments: readonly DuplicateCodeFragment[]; kind: \"complete\" }\n  | { kind: \"execution-failed\" }\n  | { kind: \"invalid-result\" }\n  | { kind: \"cache-write-failed\" }\n  | { kind: \"unavailable\" }\n>;\n\ntype RawMeasurementResult = Readonly<\n  | { fragments: readonly DuplicateCodeFragment[]; kind: \"complete\" }\n  | { kind: \"execution-failed\" }\n  | { kind: \"invalid-result\" }\n  | { kind: \"cache-write-failed\" }\n>;\n\ninterface RawScopeMeasurementInput {\n  readonly cache: DuplicateMeasurementInput[\"cache\"];\n  readonly dependency: ResolvedDuplicateDetectionScannerOptions;\n  readonly exactInput: DuplicateDetectionExactInputSet;\n  readonly minimumLines: number;\n  readonly minimumTokens: number;\n  readonly toolVersion: string;\n}\n\nexport async function measureDuplicateDetection(\n  options: DuplicateMeasurementInput\n): Promise<DuplicateMeasurementResult> {\n  const { dependency, exactInput } = options;\n  if (!validMeasurementInput(exactInput)) {\n    return Object.freeze({ kind: \"invalid-result\" });\n  }\n  const availability = await checkJscpd(exactInput.rootDir, dependency);\n  if (!availability.available) {\n    return Object.freeze({ kind: \"unavailable\" });\n  }\n\n  const minimumLines = Math.min(...exactInput.areas.map((area) => area.minimumLines));\n  const minimumTokens = Math.min(...exactInput.areas.map((area) => area.minimumTokens));\n  const rawMeasurement = await measureRawScope({\n    cache: options.cache,\n    dependency,\n    exactInput,\n    minimumLines,\n    minimumTokens,\n    toolVersion: availability.version\n  });\n  if (rawMeasurement.kind !== \"complete\") return rawMeasurement;\n\n  const fragments = applyDuplicateAreaPolicy(rawMeasurement.fragments, exactInput.areas);\n  return fragments === undefined\n    ? Object.freeze({ kind: \"invalid-result\" })\n    : Object.freeze({ fragments, kind: \"complete\" });\n}\n\nfunction validMeasurementInput(exactInput: DuplicateDetectionExactInputSet): boolean {\n  const approvedExactPaths = exactInput.approvedExactPaths;\n  if (!hasValidScopeIdentity(exactInput) || !hasValidApprovedPaths(exactInput)) return false;\n\n  const approvedPathSet = new Set(approvedExactPaths);\n  const coveredPathSet = new Set<string>();\n  const codeAreaSet = new Set<string>();\n  for (const area of exactInput.areas) {\n    if (!isValidAreaInput(area) || codeAreaSet.has(area.codeArea)) return false;\n    codeAreaSet.add(area.codeArea);\n    for (const path of area.approvedExactPaths) {\n      if (!approvedPathSet.has(path)) return false;\n      coveredPathSet.add(path);\n    }\n  }\n  return coveredPathSet.size === approvedPathSet.size;\n}\n\nfunction hasValidScopeIdentity(exactInput: DuplicateDetectionExactInputSet): boolean {\n  return (\n    exactInput.approvedExactPaths.length >= 2 &&\n    nonEmptyString(exactInput.rootDir) &&\n    nonEmptyString(exactInput.cacheRootDir) &&\n    nonEmptyString(exactInput.commitSha)\n  );\n}\n\nfunction hasValidApprovedPaths(exactInput: DuplicateDetectionExactInputSet): boolean {\n  const paths = exactInput.approvedExactPaths;\n  return (\n    paths.every(nonEmptyString) &&\n    sameStrings(paths, uniqueSorted(paths)) &&\n    validFingerprintForPaths(exactInput.inputFingerprint, paths)\n  );\n}\n\nfunction isValidAreaInput(area: DuplicateDetectionAreaInput): boolean {\n  return (\n    nonEmptyString(area.codeArea) &&\n    positiveSafeInteger(area.minimumLines) &&\n    positiveSafeInteger(area.minimumTokens) &&\n    area.approvedExactPaths.length > 0 &&\n    area.approvedExactPaths.every(nonEmptyString) &&\n    sameStrings(area.approvedExactPaths, uniqueSorted(area.approvedExactPaths))\n  );\n}\n\nfunction validFingerprintForPaths(\n  fingerprint: DuplicateDetectionExactInputSet[\"inputFingerprint\"],\n  approvedExactPaths: readonly string[]\n): boolean {\n  const expectedFileList = approvedExactPaths.slice(0, 200);\n  return (\n    fingerprint.fileCount === approvedExactPaths.length &&\n    sameStrings(fingerprint.fileList, expectedFileList) &&\n    nonEmptyString(fingerprint.fingerprint)\n  );\n}\n\nasync function measureRawScope(input: RawScopeMeasurementInput): Promise<RawMeasurementResult> {\n  const identity = createDuplicateScanCacheIdentity(input);\n  const exactPaths = input.exactInput.approvedExactPaths;\n  if (input.cache.enabled) {\n    const cachedFragments = loadValidCachedFragments(\n      input.exactInput.cacheRootDir,\n      identity,\n      exactPaths\n    );\n    if (cachedFragments !== null) {\n      return Object.freeze({ fragments: cachedFragments, kind: \"complete\" });\n    }\n  }\n  return scanAndCacheScope(input, identity, exactPaths);\n}\n\nfunction loadValidCachedFragments(\n  cacheRootDir: string,\n  identity: DuplicateCodeCacheIdentity,\n  exactPaths: readonly string[]\n): readonly DuplicateCodeFragment[] | null {\n  const cached = loadScanCacheEntry({ rootDir: cacheRootDir, identity });\n  if (!cached.hit) return null;\n  const accepted = acceptExactInputMeasurements(\n    toScopedJscpdMeasurements(cached.metrics),\n    exactPaths\n  );\n  return accepted.ok && accepted.payloads.every(isValidDuplicateFragment)\n    ? Object.freeze(accepted.payloads)\n    : null;\n}\n\nasync function scanAndCacheScope(\n  input: RawScopeMeasurementInput,\n  identity: DuplicateCodeCacheIdentity,\n  exactPaths: readonly string[]\n): Promise<RawMeasurementResult> {\n  const result = await scanWithJscpdAsync({\n    cwd: input.exactInput.rootDir,\n    dependency: input.dependency,\n    files: exactPaths,\n    minimumLines: input.minimumLines,\n    minimumTokens: input.minimumTokens\n  });\n  if (!result.ok) {\n    return Object.freeze({\n      kind: result.reason === \"jscpd-execution-error\" ? \"execution-failed\" : \"invalid-result\"\n    });\n  }\n\n  const accepted = acceptExactInputMeasurements(result.measurements, exactPaths);\n  if (!accepted.ok || !accepted.payloads.every(isValidDuplicateFragment)) {\n    return Object.freeze({ kind: \"invalid-result\" });\n  }\n  const fragments = Object.freeze(accepted.payloads);\n  if (input.cache.enabled) {\n    try {\n      writeScanCacheEntry({\n        rootDir: input.exactInput.cacheRootDir,\n        identity,\n        metrics: [...fragments]\n      });\n    } catch {\n      return Object.freeze({ kind: \"cache-write-failed\" });\n    }\n  }\n  return Object.freeze({ fragments, kind: \"complete\" });\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\nfunction uniqueSorted(values: readonly string[]): string[] {\n  return [...new Set(values)].sort(compareText);\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 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/duplicate-detection/options-resolution.mjs

@@ -0,0 +1,126 @@
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { resolveProjectFileSelection, snapshotDefaultProjectFileSelection } from "../project-files/configuration.mjs";
+import { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { DEFAULT_JSCPD_COMMAND } from "./jscpd/command-resolution.mjs";
+import { validResolvedDuplicateDetectionOptions } from "./options-validation.mjs";
+const DEFAULT_CACHE_DIRECTORY = ".cache/vibe-check";
+const DEFAULT_MINIMUM_LINES = 4;
+const DEFAULT_MINIMUM_TOKENS = 100;
+/** 校验 constructor input，并将所有可省略 policy 物化为完整、冻结的 Check options。 */
+export function resolveDuplicateDetectionOptions(value) {
+    const input = snapshotPolicyRecord(value, {
+        optional: ["cache", "codeAreas", "findingPolicy", "scanner"]
+    });
+    if (input === undefined)
+        return undefined;
+    const cache = resolveCache(input.cache);
+    const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);
+    if (findingPolicy === undefined)
+        return undefined;
+    const codeAreas = resolveCodeAreas(input.codeAreas, findingPolicy);
+    const scanner = resolveScanner(input.scanner);
+    if (cache === undefined || codeAreas === undefined || scanner === undefined)
+        return undefined;
+    const options = Object.freeze({ cache, codeAreas, scanner });
+    return validResolvedDuplicateDetectionOptions(options) ? options : undefined;
+}
+function resolveCache(value) {
+    if (value === undefined) {
+        return Object.freeze({ directory: DEFAULT_CACHE_DIRECTORY, enabled: true });
+    }
+    const cache = snapshotPolicyRecord(value, { optional: ["directory", "enabled"] });
+    if (cache === undefined)
+        return undefined;
+    const directory = cache.directory ?? DEFAULT_CACHE_DIRECTORY;
+    const enabled = cache.enabled ?? true;
+    if (!nonEmptyString(directory) || typeof enabled !== "boolean")
+        return undefined;
+    return Object.freeze({ directory, enabled });
+}
+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 (!nonEmptyString(areaId))
+            return undefined;
+        const area = resolveCodeArea(candidate, defaultFindingPolicy);
+        if (area === undefined)
+            return undefined;
+        resolvedEntries.push([areaId, area]);
+    }
+    return Object.freeze(Object.fromEntries(resolvedEntries));
+}
+function defaultCodeArea(findingPolicy) {
+    return Object.freeze({
+        files: snapshotDefaultProjectFileSelection(),
+        findingPolicy,
+        minimumLines: DEFAULT_MINIMUM_LINES,
+        minimumTokens: DEFAULT_MINIMUM_TOKENS
+    });
+}
+function resolveCodeArea(value, defaultFindingPolicy) {
+    const area = snapshotPolicyRecord(value, {
+        optional: ["findingPolicy", "minimumLines", "minimumTokens"],
+        required: ["files"]
+    });
+    if (area === undefined)
+        return undefined;
+    const files = resolveProjectFileSelection(area.files);
+    const findingPolicy = resolveFindingPolicy(area.findingPolicy, defaultFindingPolicy);
+    const minimumLines = area.minimumLines ?? DEFAULT_MINIMUM_LINES;
+    const minimumTokens = area.minimumTokens ?? DEFAULT_MINIMUM_TOKENS;
+    if (files === undefined ||
+        findingPolicy === undefined ||
+        !positiveSafeInteger(minimumLines) ||
+        !positiveSafeInteger(minimumTokens)) {
+        return undefined;
+    }
+    return Object.freeze({ files, findingPolicy, minimumLines, minimumTokens });
+}
+function resolveScanner(value) {
+    if (value === undefined)
+        return Object.freeze({ command: DEFAULT_JSCPD_COMMAND });
+    const scanner = snapshotPolicyRecord(value, { optional: ["command"] });
+    if (scanner === undefined)
+        return undefined;
+    const command = resolveScannerCommand(scanner.command);
+    return command === undefined ? undefined : Object.freeze({ command });
+}
+function resolveScannerCommand(value) {
+    if (value === undefined)
+        return DEFAULT_JSCPD_COMMAND;
+    const command = snapshotClosedRecord(value);
+    if (command?.kind === "package") {
+        return Object.keys(command).length === 1 ? DEFAULT_JSCPD_COMMAND : undefined;
+    }
+    if (command?.kind !== "custom")
+        return undefined;
+    const custom = snapshotPolicyRecord(command, { required: ["executable", "kind"] });
+    if (custom === undefined || custom.kind !== "custom" || !nonEmptyString(custom.executable)) {
+        return undefined;
+    }
+    return Object.freeze({ executable: custom.executable, kind: "custom" });
+}
+function snapshotPolicyRecord(value, keys) {
+    const record = snapshotClosedRecord(value);
+    if (record === undefined ||
+        !hasRequiredAndOptionalRecordKeys(record, {
+            optional: keys.optional ?? [],
+            required: keys.required ?? []
+        })) {
+        return undefined;
+    }
+    return record;
+}
+function positiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+//# sourceMappingURL=options-resolution.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/options-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  hasRequiredAndOptionalRecordKeys,\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 { DEFAULT_JSCPD_COMMAND } from \"./jscpd/command-resolution.ts\";\nimport type {\n  DuplicateDetectionScannerCommand,\n  ResolvedDuplicateDetectionCodeAreaOptions,\n  ResolvedDuplicateDetectionOptions,\n  ResolvedDuplicateDetectionScannerOptions\n} from \"./options.ts\";\nimport { validResolvedDuplicateDetectionOptions } from \"./options-validation.ts\";\n\nconst DEFAULT_CACHE_DIRECTORY = \".cache/vibe-check\";\nconst DEFAULT_MINIMUM_LINES = 4;\nconst DEFAULT_MINIMUM_TOKENS = 100;\n\ninterface PolicyRecordKeys {\n  readonly optional?: readonly string[];\n  readonly required?: readonly string[];\n}\n\n/** 校验 constructor input，并将所有可省略 policy 物化为完整、冻结的 Check options。 */\nexport function resolveDuplicateDetectionOptions(\n  value: unknown\n): ResolvedDuplicateDetectionOptions | undefined {\n  const input = snapshotPolicyRecord(value, {\n    optional: [\"cache\", \"codeAreas\", \"findingPolicy\", \"scanner\"]\n  });\n  if (input === undefined) return undefined;\n\n  const cache = resolveCache(input.cache);\n  const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);\n  if (findingPolicy === undefined) return undefined;\n  const codeAreas = resolveCodeAreas(input.codeAreas, findingPolicy);\n  const scanner = resolveScanner(input.scanner);\n  if (cache === undefined || codeAreas === undefined || scanner === undefined) return undefined;\n\n  const options = Object.freeze({ cache, codeAreas, scanner });\n  return validResolvedDuplicateDetectionOptions(options) ? options : undefined;\n}\n\nfunction resolveCache(value: unknown): ResolvedDuplicateDetectionOptions[\"cache\"] | undefined {\n  if (value === undefined) {\n    return Object.freeze({ directory: DEFAULT_CACHE_DIRECTORY, enabled: true });\n  }\n  const cache = snapshotPolicyRecord(value, { optional: [\"directory\", \"enabled\"] });\n  if (cache === undefined) return undefined;\n  const directory = cache.directory ?? DEFAULT_CACHE_DIRECTORY;\n  const enabled = cache.enabled ?? true;\n  if (!nonEmptyString(directory) || typeof enabled !== \"boolean\") return undefined;\n  return Object.freeze({ directory, enabled });\n}\n\nfunction resolveCodeAreas(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedDuplicateDetectionOptions[\"codeAreas\"] | undefined {\n  if (value === undefined) {\n    return Object.freeze({ project: defaultCodeArea(defaultFindingPolicy) });\n  }\n  const areas = snapshotClosedRecord(value);\n  if (areas === undefined || Object.keys(areas).length === 0) return undefined;\n\n  const resolvedEntries: Array<readonly [string, ResolvedDuplicateDetectionCodeAreaOptions]> = [];\n  for (const [areaId, candidate] of Object.entries(areas)) {\n    if (!nonEmptyString(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): ResolvedDuplicateDetectionCodeAreaOptions {\n  return Object.freeze({\n    files: snapshotDefaultProjectFileSelection(),\n    findingPolicy,\n    minimumLines: DEFAULT_MINIMUM_LINES,\n    minimumTokens: DEFAULT_MINIMUM_TOKENS\n  });\n}\n\nfunction resolveCodeArea(\n  value: unknown,\n  defaultFindingPolicy: FindingPolicy\n): ResolvedDuplicateDetectionCodeAreaOptions | undefined {\n  const area = snapshotPolicyRecord(value, {\n    optional: [\"findingPolicy\", \"minimumLines\", \"minimumTokens\"],\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 minimumLines = area.minimumLines ?? DEFAULT_MINIMUM_LINES;\n  const minimumTokens = area.minimumTokens ?? DEFAULT_MINIMUM_TOKENS;\n  if (\n    files === undefined ||\n    findingPolicy === undefined ||\n    !positiveSafeInteger(minimumLines) ||\n    !positiveSafeInteger(minimumTokens)\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ files, findingPolicy, minimumLines, minimumTokens });\n}\n\nfunction resolveScanner(value: unknown): ResolvedDuplicateDetectionScannerOptions | undefined {\n  if (value === undefined) return Object.freeze({ command: DEFAULT_JSCPD_COMMAND });\n  const scanner = snapshotPolicyRecord(value, { optional: [\"command\"] });\n  if (scanner === undefined) return undefined;\n  const command = resolveScannerCommand(scanner.command);\n  return command === undefined ? undefined : Object.freeze({ command });\n}\n\nfunction resolveScannerCommand(value: unknown): DuplicateDetectionScannerCommand | undefined {\n  if (value === undefined) return DEFAULT_JSCPD_COMMAND;\n  const command = snapshotClosedRecord(value);\n  if (command?.kind === \"package\") {\n    return Object.keys(command).length === 1 ? DEFAULT_JSCPD_COMMAND : undefined;\n  }\n  if (command?.kind !== \"custom\") return undefined;\n  const custom = snapshotPolicyRecord(command, { required: [\"executable\", \"kind\"] });\n  if (custom === undefined || custom.kind !== \"custom\" || !nonEmptyString(custom.executable)) {\n    return undefined;\n  }\n  return Object.freeze({ executable: custom.executable, kind: \"custom\" });\n}\n\nfunction snapshotPolicyRecord(\n  value: unknown,\n  keys: PolicyRecordKeys\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  if (\n    record === undefined ||\n    !hasRequiredAndOptionalRecordKeys(record, {\n      optional: keys.optional ?? [],\n      required: keys.required ?? []\n    })\n  ) {\n    return undefined;\n  }\n  return record;\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"]}

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

@@ -0,0 +1,60 @@
+import { snapshotClosedRecord } from "../../data-boundary/closed-values.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;
+}
+export function validResolvedDuplicateDetectionOptions(value) {
+    const options = exactRecord(value, ["cache", "codeAreas", "scanner"]);
+    return (options !== undefined &&
+        validDuplicateCache(options.cache) &&
+        validDuplicateCodeAreas(options.codeAreas) &&
+        validDuplicateDetectionScanner(options.scanner));
+}
+function validDuplicateCodeAreas(value) {
+    const areas = snapshotClosedRecord(value);
+    if (areas === undefined || Object.keys(areas).length === 0)
+        return false;
+    return Object.entries(areas).every(([areaId, candidate]) => {
+        const area = exactRecord(candidate, [
+            "files",
+            "findingPolicy",
+            "minimumLines",
+            "minimumTokens"
+        ]);
+        return (nonEmptyString(areaId) &&
+            area !== undefined &&
+            validProjectFileSelection(area.files) &&
+            validFindingPolicy(area.findingPolicy) &&
+            positiveSafeInteger(area.minimumLines) &&
+            positiveSafeInteger(area.minimumTokens));
+    });
+}
+function validDuplicateDetectionScanner(value) {
+    const scanner = exactRecord(value, ["command"]);
+    return scanner !== undefined && validJscpdCommand(scanner.command);
+}
+function validJscpdCommand(value) {
+    const record = snapshotClosedRecord(value);
+    if (record?.kind === "package") {
+        return Object.keys(record).length === 1;
+    }
+    const command = exactRecord(value, ["executable", "kind"]);
+    return command?.kind === "custom" && nonEmptyString(command.executable);
+}
+function validDuplicateCache(value) {
+    const cache = exactRecord(value, ["directory", "enabled"]);
+    return (cache !== undefined && nonEmptyString(cache.directory) && typeof cache.enabled === "boolean");
+}
+//# sourceMappingURL=options-validation.mjs.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.mjs.map

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

@@ -0,0 +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"]}

package/dist/esm/package-checks/duplicate-detection/project-revision.mjs

@@ -0,0 +1,5 @@
+import { gitHeadSha } from "../host-environment/git.mjs";
+export function getGitSha(cwd) {
+    return gitHeadSha(cwd) ?? "unknown";
+}
+//# sourceMappingURL=project-revision.mjs.map

package/dist/esm/package-checks/duplicate-detection/project-revision.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-revision.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/project-revision.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAExD,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,UAAU,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC;AACtC,CAAC","sourcesContent":["import { gitHeadSha } from \"../host-environment/git.ts\";\n\nexport function getGitSha(cwd: string): string {\n  return gitHeadSha(cwd) ?? \"unknown\";\n}\n"]}

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

@@ -0,0 +1,119 @@
+import { createHash } from "node:crypto";
+import { canonicalJsonBytes } from "../../data-boundary/canonical-data.mjs";
+import { isBlockingFinding } from "../code-quality-findings/policy.mjs";
+/** Builds Check-owned supplemental facts without adding a Product record catalog. */
+export function buildDuplicateRecordCandidates(fragments, codeAreas) {
+    const ids = duplicateIdsInOrder(fragments);
+    if (ids === undefined)
+        return undefined;
+    const candidates = [];
+    for (const [index, fragment] of fragments.entries()) {
+        const candidate = createDuplicateRecordCandidate(fragment, ids[index], codeAreas);
+        if (candidate === undefined)
+            return undefined;
+        candidates.push(candidate);
+    }
+    candidates.sort((left, right) => compareText(left.id, right.id));
+    return Object.freeze(candidates);
+}
+function createDuplicateRecordCandidate(fragment, id, configuredAreas) {
+    if (!isValidDuplicateFragment(fragment) || id === undefined)
+        return undefined;
+    const locations = sortedLocations(fragment.locations);
+    const codeAreas = uniqueSorted(fragment.codeAreas);
+    if (codeAreas.length === 0 || !sameStrings(codeAreas, fragment.codeAreas))
+        return undefined;
+    const findingPolicies = [];
+    for (const areaId of codeAreas) {
+        const area = configuredAreas[areaId];
+        if (area === undefined)
+            return undefined;
+        findingPolicies.push(area.findingPolicy);
+    }
+    return Object.freeze({
+        id,
+        data: Object.freeze({
+            blocking: isBlockingFinding(findingPolicies),
+            codeAreas: Object.freeze(codeAreas),
+            lineCount: fragment.lineCount,
+            locations: Object.freeze(locations.map((location) => Object.freeze({
+                endLine: location.endLine,
+                path: location.path,
+                startLine: location.startLine
+            }))),
+            metric: "duplicate-tokens",
+            tokenCount: fragment.tokenCount
+        })
+    });
+}
+export function isValidDuplicateFragment(fragment) {
+    return (hasValidFragmentMeasurements(fragment) &&
+        Array.isArray(fragment.locations) &&
+        fragment.locations.length >= 2 &&
+        fragment.locations.every(isValidLocation) &&
+        Array.isArray(fragment.codeAreas) &&
+        fragment.codeAreas.every(nonEmptyString));
+}
+function hasValidFragmentMeasurements(fragment) {
+    return (nonNegativeSafeInteger(fragment.id) &&
+        nonNegativeSafeInteger(fragment.lineCount) &&
+        nonNegativeSafeInteger(fragment.tokenCount));
+}
+function nonNegativeSafeInteger(value) {
+    return Number.isSafeInteger(value) && value >= 0;
+}
+function isValidLocation(location) {
+    const validPath = typeof location.path === "string" && location.path.length > 0;
+    const validLines = Number.isSafeInteger(location.startLine) &&
+        location.startLine >= 1 &&
+        Number.isSafeInteger(location.endLine) &&
+        location.endLine >= location.startLine;
+    return validPath && validLines;
+}
+function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+function sameStrings(left, right) {
+    return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function duplicateIdsInOrder(fragments) {
+    const occurrences = new Map();
+    const ids = [];
+    for (const fragment of fragments) {
+        if (!isValidDuplicateFragment(fragment))
+            return undefined;
+        const fingerprint = duplicateFingerprint(fragment);
+        const occurrence = (occurrences.get(fingerprint) ?? 0) + 1;
+        occurrences.set(fingerprint, occurrence);
+        ids.push(`duplicate-fragment/v1/sha256:${fingerprint}/occurrence:${occurrence}`);
+    }
+    return Object.freeze(ids);
+}
+function duplicateFingerprint(fragment) {
+    return createHash("sha256")
+        .update(canonicalJsonBytes({
+        lineCount: fragment.lineCount,
+        paths: uniqueSorted(fragment.locations.map((location) => location.path)),
+        tokenCount: fragment.tokenCount
+    }))
+        .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}`;
+}
+function uniqueSorted(values) {
+    return [...new Set(values)].sort(compareText);
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=records.mjs.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,39 @@
+import { defineCheck } from "../../check/check.mjs";
+import { FILE_METRICS_CHECK_DEFINITION, executeFileMetrics } from "./execution.mjs";
+import { parseFileMetricsData } from "./final-data.mjs";
+import { resolveFileMetricsOptions } from "./options-resolution.mjs";
+import { isValidResolvedFileMetricsOptions } from "./options-validation.mjs";
+/**
+ * 使用可省略的区域、代码行与 scanner policy 构造一个完整 file-metrics Check。
+ *
+ * @param options - 省略字段由 package 补齐；显式 files 数组作为对应字段的完整替换值。
+ * @returns 固定 `file-metrics` identity、完整冻结 options、preflight 与 execution。
+ * @throws {TypeError} input 含未知字段、空 area、非法代码行 policy、非法 waiver 或空 executable 时抛出。
+ */
+export function fileMetrics(options = {}) {
+    const resolvedOptions = resolveFileMetricsOptions(options);
+    if (resolvedOptions === undefined) {
+        throw new TypeError("fileMetrics options must match the documented closed { codeAreas?, findingPolicy?, findingWaivers?, scanner? } constructor policy");
+    }
+    return defineCheck({
+        ...FILE_METRICS_CHECK_DEFINITION,
+        execution: executeFileMetrics,
+        parseData: parseFileMetricsData,
+        preflight: (preparedOptions) => isValidResolvedFileMetricsOptions(preparedOptions)
+            ? { status: "success", preparedOptions }
+            : {
+                status: "failure",
+                action: "block",
+                reason: { code: "invalid-options" },
+                messages: [
+                    {
+                        code: "invalid-options",
+                        level: "error",
+                        message: "fileMetrics options are invalid; recreate the Check with fileMetrics(options) or restore its complete resolved options."
+                    }
+                ]
+            },
+        options: resolvedOptions
+    });
+}
+//# sourceMappingURL=constructor.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constructor.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,6BAA6B,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAE5E;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CACzB,OAAO,GAAuB,EAAE;IAEhC,MAAM,eAAe,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;IAC3D,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CACjB,mIAAmI,CACpI,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,GAAG,6BAA6B;QAChC,SAAS,EAAE,kBAAkB;QAC7B,SAAS,EAAE,oBAAoB;QAC/B,SAAS,EAAE,CAAC,eAAe,EAAE,EAAE,CAC7B,iCAAiC,CAAC,eAAe,CAAC;YAChD,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE;YACxC,CAAC,CAAC;gBACE,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;gBACnC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,iBAAiB;wBACvB,KAAK,EAAE,OAAO;wBACd,OAAO,EACL,yHAAyH;qBAC5H;iBACF;aACF;QACP,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { defineCheck, type TypedCheckWithOptions } from \"../../check/check.ts\";\nimport { FILE_METRICS_CHECK_DEFINITION, executeFileMetrics } from \"./execution.ts\";\nimport { parseFileMetricsData } from \"./final-data.ts\";\nimport type { FileMetricsOptions, ResolvedFileMetricsOptions } from \"./options.ts\";\nimport { resolveFileMetricsOptions } from \"./options-resolution.ts\";\nimport { isValidResolvedFileMetricsOptions } from \"./options-validation.ts\";\n\n/**\n * 使用可省略的区域、代码行与 scanner policy 构造一个完整 file-metrics Check。\n *\n * @param options - 省略字段由 package 补齐；显式 files 数组作为对应字段的完整替换值。\n * @returns 固定 `file-metrics` identity、完整冻结 options、preflight 与 execution。\n * @throws {TypeError} input 含未知字段、空 area、非法代码行 policy、非法 waiver 或空 executable 时抛出。\n */\nexport function fileMetrics(\n  options: FileMetricsOptions = {}\n): TypedCheckWithOptions<\"file-metrics\", ResolvedFileMetricsOptions, typeof parseFileMetricsData> {\n  const resolvedOptions = resolveFileMetricsOptions(options);\n  if (resolvedOptions === undefined) {\n    throw new TypeError(\n      \"fileMetrics options must match the documented closed { codeAreas?, findingPolicy?, findingWaivers?, scanner? } constructor policy\"\n    );\n  }\n  return defineCheck({\n    ...FILE_METRICS_CHECK_DEFINITION,\n    execution: executeFileMetrics,\n    parseData: parseFileMetricsData,\n    preflight: (preparedOptions) =>\n      isValidResolvedFileMetricsOptions(preparedOptions)\n        ? { status: \"success\", preparedOptions }\n        : {\n            status: \"failure\",\n            action: \"block\",\n            reason: { code: \"invalid-options\" },\n            messages: [\n              {\n                code: \"invalid-options\",\n                level: \"error\",\n                message:\n                  \"fileMetrics options are invalid; recreate the Check with fileMetrics(options) or restore its complete resolved options.\"\n              }\n            ]\n          },\n    options: resolvedOptions\n  });\n}\n"]}