@zxyycom/vibe-check 0.0.1

package/dist/esm/package-checks/duplicate-detection/area-policy.mjs

@@ -0,0 +1,71 @@
+import { isValidDuplicateFragment } from "./records.mjs";
+/** Restores every matching code area and applies the strictest involved policy. */
+export function applyDuplicateAreaPolicy(fragments, areas) {
+    const policiesByPath = buildPathPolicies(areas);
+    const accepted = [];
+    for (const fragment of fragments) {
+        if (!isValidDuplicateFragment(fragment))
+            return undefined;
+        const annotated = annotateFragment(fragment, policiesByPath);
+        if (annotated === undefined)
+            return undefined;
+        if (annotated.fragment.lineCount >= annotated.requiredMinimumLines &&
+            annotated.fragment.tokenCount >= annotated.requiredMinimumTokens) {
+            accepted.push(annotated.fragment);
+        }
+    }
+    return Object.freeze(accepted);
+}
+function buildPathPolicies(areas) {
+    const mutablePolicies = new Map();
+    for (const area of areas) {
+        for (const path of area.approvedExactPaths) {
+            const policies = mutablePolicies.get(path) ?? [];
+            policies.push(Object.freeze({
+                codeArea: area.codeArea,
+                minimumLines: area.minimumLines,
+                minimumTokens: area.minimumTokens
+            }));
+            mutablePolicies.set(path, policies);
+        }
+    }
+    return new Map(Array.from(mutablePolicies, ([path, policies]) => [path, Object.freeze(policies)]));
+}
+function annotateFragment(fragment, policiesByPath) {
+    const locations = [];
+    const involvedPolicies = [];
+    for (const location of fragment.locations) {
+        const pathPolicies = policiesByPath.get(location.path);
+        if (pathPolicies === undefined || pathPolicies.length === 0)
+            return undefined;
+        locations.push(Object.freeze({
+            endLine: location.endLine,
+            path: location.path,
+            startLine: location.startLine
+        }));
+        involvedPolicies.push(...pathPolicies);
+    }
+    if (involvedPolicies.length === 0)
+        return undefined;
+    const annotatedFragment = Object.freeze({
+        ...fragment,
+        codeAreas: Object.freeze(uniqueSorted(involvedPolicies.map((policy) => policy.codeArea))),
+        locations: Object.freeze(locations)
+    });
+    return Object.freeze({
+        fragment: annotatedFragment,
+        requiredMinimumLines: Math.max(...involvedPolicies.map((policy) => policy.minimumLines)),
+        requiredMinimumTokens: Math.max(...involvedPolicies.map((policy) => policy.minimumTokens))
+    });
+}
+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=area-policy.mjs.map

package/dist/esm/package-checks/duplicate-detection/area-policy.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"area-policy.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/area-policy.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  DuplicateCodeFragment,\n  DuplicateCodeLocation,\n  DuplicateDetectionAreaInput\n} from \"./measurement-model.ts\";\nimport { isValidDuplicateFragment } from \"./records.ts\";\n\ntype PathPolicy = Readonly<{\n  codeArea: string;\n  minimumLines: number;\n  minimumTokens: number;\n}>;\n\ntype AnnotatedFragment = Readonly<{\n  fragment: DuplicateCodeFragment;\n  requiredMinimumLines: number;\n  requiredMinimumTokens: number;\n}>;\n\n/** Restores every matching code area and applies the strictest involved policy. */\nexport function applyDuplicateAreaPolicy(\n  fragments: readonly DuplicateCodeFragment[],\n  areas: readonly DuplicateDetectionAreaInput[]\n): readonly DuplicateCodeFragment[] | undefined {\n  const policiesByPath = buildPathPolicies(areas);\n  const accepted: DuplicateCodeFragment[] = [];\n  for (const fragment of fragments) {\n    if (!isValidDuplicateFragment(fragment)) return undefined;\n    const annotated = annotateFragment(fragment, policiesByPath);\n    if (annotated === undefined) return undefined;\n    if (\n      annotated.fragment.lineCount >= annotated.requiredMinimumLines &&\n      annotated.fragment.tokenCount >= annotated.requiredMinimumTokens\n    ) {\n      accepted.push(annotated.fragment);\n    }\n  }\n  return Object.freeze(accepted);\n}\n\nfunction buildPathPolicies(\n  areas: readonly DuplicateDetectionAreaInput[]\n): ReadonlyMap<string, readonly PathPolicy[]> {\n  const mutablePolicies = new Map<string, PathPolicy[]>();\n  for (const area of areas) {\n    for (const path of area.approvedExactPaths) {\n      const policies = mutablePolicies.get(path) ?? [];\n      policies.push(\n        Object.freeze({\n          codeArea: area.codeArea,\n          minimumLines: area.minimumLines,\n          minimumTokens: area.minimumTokens\n        })\n      );\n      mutablePolicies.set(path, policies);\n    }\n  }\n  return new Map(\n    Array.from(mutablePolicies, ([path, policies]) => [path, Object.freeze(policies)] as const)\n  );\n}\n\nfunction annotateFragment(\n  fragment: DuplicateCodeFragment,\n  policiesByPath: ReadonlyMap<string, readonly PathPolicy[]>\n): AnnotatedFragment | undefined {\n  const locations: DuplicateCodeLocation[] = [];\n  const involvedPolicies: PathPolicy[] = [];\n  for (const location of fragment.locations) {\n    const pathPolicies = policiesByPath.get(location.path);\n    if (pathPolicies === undefined || pathPolicies.length === 0) return undefined;\n    locations.push(\n      Object.freeze({\n        endLine: location.endLine,\n        path: location.path,\n        startLine: location.startLine\n      })\n    );\n    involvedPolicies.push(...pathPolicies);\n  }\n  if (involvedPolicies.length === 0) return undefined;\n\n  const annotatedFragment = Object.freeze({\n    ...fragment,\n    codeAreas: Object.freeze(uniqueSorted(involvedPolicies.map((policy) => policy.codeArea))),\n    locations: Object.freeze(locations)\n  });\n  return Object.freeze({\n    fragment: annotatedFragment,\n    requiredMinimumLines: Math.max(...involvedPolicies.map((policy) => policy.minimumLines)),\n    requiredMinimumTokens: Math.max(...involvedPolicies.map((policy) => policy.minimumTokens))\n  });\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/duplicate-detection/cache/cache-contract.mjs

@@ -0,0 +1,2 @@
+export const SCAN_CACHE_VERSION = "quality-scan-cache-v3";
+//# sourceMappingURL=cache-contract.mjs.map

package/dist/esm/package-checks/duplicate-detection/cache/cache-contract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-contract.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/duplicate-detection/cache/cache-contract.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC","sourcesContent":["import type { FileInputFingerprint } from \"../../project-files/file-fingerprint.ts\";\nimport type { DuplicateCodeFragment } from \"../measurement-model.ts\";\n\nexport const SCAN_CACHE_VERSION = \"quality-scan-cache-v3\";\n\nexport type DuplicateScannerCacheConfiguration = Readonly<{\n  backend: Readonly<{ kind: \"package\" } | { executable: string; kind: \"custom\" }>;\n  minimumLines: number;\n  minimumTokens: number;\n  reportedPathMode: \"absolute\";\n  reporter: \"json\";\n  workerPolicy: \"tool-default\";\n}>;\n\nexport type DuplicateCodeCacheIdentity = Readonly<{\n  commitSha: string;\n  configVersion: string;\n  inputFingerprint: FileInputFingerprint;\n  scannerConfiguration: DuplicateScannerCacheConfiguration;\n  toolName: \"jscpd\";\n  toolVersion: string;\n}>;\n\nexport type DuplicateCodeCacheHit = Readonly<{\n  cacheKey: string;\n  cachePath: string;\n  hit: true;\n  metrics: readonly DuplicateCodeFragment[];\n}>;\n\nexport type DuplicateCodeCacheMiss = Readonly<{\n  cacheKey: string;\n  cachePath: string;\n  hit: false;\n  reason: \"cache-miss\" | \"cache-payload-invalid\" | \"cache-payload-mismatch\";\n}>;\n\nexport type ScanCachePayload = Readonly<{\n  cacheKey: string;\n  commitSha: string;\n  configVersion: string;\n  createdAt: string;\n  inputFingerprint: FileInputFingerprint;\n  metrics: unknown;\n  scannerConfiguration: DuplicateScannerCacheConfiguration;\n  scanCacheVersion: string;\n  toolName: \"jscpd\";\n  toolVersion: string;\n}>;\n"]}

package/dist/esm/package-checks/duplicate-detection/cache/identity.mjs

@@ -0,0 +1,37 @@
+import { isPackageJscpdCommand } from "../jscpd/command-resolution.mjs";
+const RAW_SCAN_CONFIGURATION_VERSION = "3";
+export function createDuplicateScanCacheIdentity(input) {
+    return Object.freeze({
+        toolName: "jscpd",
+        toolVersion: input.toolVersion,
+        scannerConfiguration: jscpdCacheConfiguration({
+            dependency: input.dependency,
+            minimumLines: input.minimumLines,
+            minimumTokens: input.minimumTokens
+        }),
+        configVersion: RAW_SCAN_CONFIGURATION_VERSION,
+        commitSha: input.exactInput.commitSha,
+        inputFingerprint: {
+            fileCount: input.exactInput.inputFingerprint.fileCount,
+            fileList: [...input.exactInput.inputFingerprint.fileList],
+            fingerprint: input.exactInput.inputFingerprint.fingerprint
+        }
+    });
+}
+export function jscpdCacheConfiguration(input) {
+    const backend = isPackageJscpdCommand(input.dependency.command)
+        ? Object.freeze({ kind: "package" })
+        : Object.freeze({
+            executable: input.dependency.command.executable,
+            kind: "custom"
+        });
+    return Object.freeze({
+        backend,
+        minimumLines: input.minimumLines,
+        minimumTokens: input.minimumTokens,
+        reportedPathMode: "absolute",
+        reporter: "json",
+        workerPolicy: "tool-default"
+    });
+}
+//# sourceMappingURL=identity.mjs.map

package/dist/esm/package-checks/duplicate-detection/cache/identity.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/duplicate-detection/cache/identity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAMvE,MAAM,8BAA8B,GAAG,GAAG,CAAC;AAU3C,MAAM,UAAU,gCAAgC,CAC9C,KAAsC;IAEtC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ,EAAE,OAAO;QACjB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,oBAAoB,EAAE,uBAAuB,CAAC;YAC5C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,aAAa,EAAE,KAAK,CAAC,aAAa;SACnC,CAAC;QACF,aAAa,EAAE,8BAA8B;QAC7C,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS;QACrC,gBAAgB,EAAE;YAChB,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,SAAS;YACtD,QAAQ,EAAE,CAAC,GAAG,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,QAAQ,CAAC;YACzD,WAAW,EAAE,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,WAAW;SAC3D;KACF,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,KAIvC;IACC,MAAM,OAAO,GAAkD,qBAAqB,CAClF,KAAK,CAAC,UAAU,CAAC,OAAO,CACzB;QACC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;QACpC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,UAAU;YAC/C,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACP,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO;QACP,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,gBAAgB,EAAE,UAAU;QAC5B,QAAQ,EAAE,MAAM;QAChB,YAAY,EAAE,cAAc;KAC7B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { DuplicateDetectionExactInputSet } from \"../measurement-model.ts\";\nimport type { ResolvedDuplicateDetectionScannerOptions } from \"../options.ts\";\nimport { isPackageJscpdCommand } from \"../jscpd/command-resolution.ts\";\nimport type {\n  DuplicateCodeCacheIdentity,\n  DuplicateScannerCacheConfiguration\n} from \"./cache-contract.ts\";\n\nconst RAW_SCAN_CONFIGURATION_VERSION = \"3\";\n\ninterface DuplicateScanCacheIdentityInput {\n  readonly dependency: ResolvedDuplicateDetectionScannerOptions;\n  readonly exactInput: DuplicateDetectionExactInputSet;\n  readonly minimumLines: number;\n  readonly minimumTokens: number;\n  readonly toolVersion: string;\n}\n\nexport function createDuplicateScanCacheIdentity(\n  input: DuplicateScanCacheIdentityInput\n): DuplicateCodeCacheIdentity {\n  return Object.freeze({\n    toolName: \"jscpd\",\n    toolVersion: input.toolVersion,\n    scannerConfiguration: jscpdCacheConfiguration({\n      dependency: input.dependency,\n      minimumLines: input.minimumLines,\n      minimumTokens: input.minimumTokens\n    }),\n    configVersion: RAW_SCAN_CONFIGURATION_VERSION,\n    commitSha: input.exactInput.commitSha,\n    inputFingerprint: {\n      fileCount: input.exactInput.inputFingerprint.fileCount,\n      fileList: [...input.exactInput.inputFingerprint.fileList],\n      fingerprint: input.exactInput.inputFingerprint.fingerprint\n    }\n  });\n}\n\nexport function jscpdCacheConfiguration(input: {\n  readonly dependency: ResolvedDuplicateDetectionScannerOptions;\n  readonly minimumLines: number;\n  readonly minimumTokens: number;\n}): DuplicateScannerCacheConfiguration {\n  const backend: DuplicateScannerCacheConfiguration[\"backend\"] = isPackageJscpdCommand(\n    input.dependency.command\n  )\n    ? Object.freeze({ kind: \"package\" })\n    : Object.freeze({\n        executable: input.dependency.command.executable,\n        kind: \"custom\"\n      });\n  return Object.freeze({\n    backend,\n    minimumLines: input.minimumLines,\n    minimumTokens: input.minimumTokens,\n    reportedPathMode: \"absolute\",\n    reporter: \"json\",\n    workerPolicy: \"tool-default\"\n  });\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/cache/key.mjs

@@ -0,0 +1,38 @@
+import { createHash } from "node:crypto";
+import { join } from "node:path";
+import { isNonArrayRecord } from "../../../data-boundary/value-shapes.mjs";
+import { SCAN_CACHE_VERSION } from "./cache-contract.mjs";
+export function buildScanCacheKey(identity) {
+    const keyInput = {
+        scan_cache_version: SCAN_CACHE_VERSION,
+        tool_name: identity.toolName,
+        tool_version: identity.toolVersion,
+        scanner_configuration: identity.scannerConfiguration,
+        config_version: identity.configVersion,
+        commit_sha: identity.commitSha,
+        input_fingerprint: identity.inputFingerprint
+    };
+    return hashStable(keyInput);
+}
+export function getScanCachePath(rootDir, cacheKey) {
+    return join(getQualityCacheRoot(rootDir), `${cacheKey}.json`);
+}
+function getQualityCacheRoot(rootDir) {
+    return join(rootDir, SCAN_CACHE_VERSION);
+}
+function hashStable(value) {
+    return createHash("sha256").update(stableStringify(value)).digest("hex");
+}
+export function stableStringify(value) {
+    if (Array.isArray(value)) {
+        return `[${value.map((item) => stableStringify(item)).join(",")}]`;
+    }
+    if (isNonArrayRecord(value)) {
+        return `{${Object.keys(value)
+            .sort()
+            .map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`)
+            .join(",")}}`;
+    }
+    return JSON.stringify(value);
+}
+//# sourceMappingURL=key.mjs.map

package/dist/esm/package-checks/duplicate-detection/cache/key.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/duplicate-detection/cache/key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAmC,MAAM,qBAAqB,CAAC;AAE1F,MAAM,UAAU,iBAAiB,CAAC,QAAoC;IACpE,MAAM,QAAQ,GAAG;QACf,kBAAkB,EAAE,kBAAkB;QACtC,SAAS,EAAE,QAAQ,CAAC,QAAQ;QAC5B,YAAY,EAAE,QAAQ,CAAC,WAAW;QAClC,qBAAqB,EAAE,QAAQ,CAAC,oBAAoB;QACpD,cAAc,EAAE,QAAQ,CAAC,aAAa;QACtC,UAAU,EAAE,QAAQ,CAAC,SAAS;QAC9B,iBAAiB,EAAE,QAAQ,CAAC,gBAAgB;KAC7C,CAAC;IAEF,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,OAAe,EAAE,QAAgB;IAChE,OAAO,IAAI,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;AAChE,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAe;IAC1C,OAAO,IAAI,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,UAAU,CAAC,KAAc;IAChC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC3E,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACrE,CAAC;IAED,IAAI,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;aAC1B,IAAI,EAAE;aACN,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;aACrE,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { join } from \"node:path\";\n\nimport { isNonArrayRecord } from \"../../../data-boundary/value-shapes.ts\";\nimport { SCAN_CACHE_VERSION, type DuplicateCodeCacheIdentity } from \"./cache-contract.ts\";\n\nexport function buildScanCacheKey(identity: DuplicateCodeCacheIdentity): string {\n  const keyInput = {\n    scan_cache_version: SCAN_CACHE_VERSION,\n    tool_name: identity.toolName,\n    tool_version: identity.toolVersion,\n    scanner_configuration: identity.scannerConfiguration,\n    config_version: identity.configVersion,\n    commit_sha: identity.commitSha,\n    input_fingerprint: identity.inputFingerprint\n  };\n\n  return hashStable(keyInput);\n}\n\nexport function getScanCachePath(rootDir: string, cacheKey: string): string {\n  return join(getQualityCacheRoot(rootDir), `${cacheKey}.json`);\n}\n\nfunction getQualityCacheRoot(rootDir: string): string {\n  return join(rootDir, SCAN_CACHE_VERSION);\n}\n\nfunction hashStable(value: unknown): string {\n  return createHash(\"sha256\").update(stableStringify(value)).digest(\"hex\");\n}\n\nexport function stableStringify(value: unknown): string {\n  if (Array.isArray(value)) {\n    return `[${value.map((item) => stableStringify(item)).join(\",\")}]`;\n  }\n\n  if (isNonArrayRecord(value)) {\n    return `{${Object.keys(value)\n      .sort()\n      .map((key) => `${JSON.stringify(key)}:${stableStringify(value[key])}`)\n      .join(\",\")}}`;\n  }\n\n  return JSON.stringify(value);\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/cache/payload.mjs

@@ -0,0 +1,47 @@
+import { isNonArrayRecord } from "../../../data-boundary/value-shapes.mjs";
+import { stableStringify } from "./key.mjs";
+import { SCAN_CACHE_VERSION } from "./cache-contract.mjs";
+export function isMatchingPayload(payload, identity, cacheKey) {
+    if (!isNonArrayRecord(payload))
+        return false;
+    return (cacheIdentityFieldsMatch(payload, identity, cacheKey) &&
+        cacheStructuredFieldsMatch(payload, identity));
+}
+export function isMetricArray(value) {
+    if (!Array.isArray(value))
+        return false;
+    return value.every(isDuplicateCodeFragment);
+}
+function cacheIdentityFieldsMatch(payload, identity, cacheKey) {
+    return (payload.scanCacheVersion === SCAN_CACHE_VERSION &&
+        payload.cacheKey === cacheKey &&
+        payload.toolName === identity.toolName &&
+        payload.toolVersion === identity.toolVersion &&
+        payload.configVersion === identity.configVersion &&
+        payload.commitSha === identity.commitSha);
+}
+function cacheStructuredFieldsMatch(payload, identity) {
+    return (stableStringify(payload.scannerConfiguration) ===
+        stableStringify(identity.scannerConfiguration) &&
+        stableStringify(payload.inputFingerprint) === stableStringify(identity.inputFingerprint));
+}
+function isDuplicateCodeFragment(value) {
+    return (isNonArrayRecord(value) &&
+        isFiniteNumber(value.id) &&
+        isFiniteNumber(value.tokenCount) &&
+        isFiniteNumber(value.lineCount) &&
+        Array.isArray(value.codeAreas) &&
+        value.codeAreas.every((area) => typeof area === "string") &&
+        Array.isArray(value.locations) &&
+        value.locations.every(isDuplicateCodeLocation));
+}
+function isDuplicateCodeLocation(value) {
+    return (isNonArrayRecord(value) &&
+        typeof value.path === "string" &&
+        isFiniteNumber(value.startLine) &&
+        isFiniteNumber(value.endLine));
+}
+function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+//# sourceMappingURL=payload.mjs.map

package/dist/esm/package-checks/duplicate-detection/cache/payload.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"payload.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/duplicate-detection/cache/payload.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,wCAAwC,CAAC;AAE1E,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,EACL,kBAAkB,EAGnB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,UAAU,iBAAiB,CAC/B,OAAgB,EAChB,QAAoC,EACpC,QAAgB;IAEhB,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IAE7C,OAAO,CACL,wBAAwB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC;QACrD,0BAA0B,CAAC,OAAO,EAAE,QAAQ,CAAC,CAC9C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACxC,OAAO,KAAK,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,wBAAwB,CAC/B,OAAgC,EAChC,QAAoC,EACpC,QAAgB;IAEhB,OAAO,CACL,OAAO,CAAC,gBAAgB,KAAK,kBAAkB;QAC/C,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAC7B,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC,QAAQ;QACtC,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW;QAC5C,OAAO,CAAC,aAAa,KAAK,QAAQ,CAAC,aAAa;QAChD,OAAO,CAAC,SAAS,KAAK,QAAQ,CAAC,SAAS,CACzC,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B,CACjC,OAAgC,EAChC,QAAoC;IAEpC,OAAO,CACL,eAAe,CAAC,OAAO,CAAC,oBAAoB,CAAC;QAC3C,eAAe,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAChD,eAAe,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,eAAe,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CACzF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,OAAO,CACL,gBAAgB,CAAC,KAAK,CAAC;QACvB,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QACxB,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC;QAChC,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC;QAC/B,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAC9B,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;QACzD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QAC9B,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAC/C,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,OAAO,CACL,gBAAgB,CAAC,KAAK,CAAC;QACvB,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;QAC9B,cAAc,CAAC,KAAK,CAAC,SAAS,CAAC;QAC/B,cAAc,CAAC,KAAK,CAAC,OAAO,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["import { isNonArrayRecord } from \"../../../data-boundary/value-shapes.ts\";\nimport type { DuplicateCodeFragment, DuplicateCodeLocation } from \"../measurement-model.ts\";\nimport { stableStringify } from \"./key.ts\";\nimport {\n  SCAN_CACHE_VERSION,\n  type DuplicateCodeCacheIdentity,\n  type ScanCachePayload\n} from \"./cache-contract.ts\";\n\nexport function isMatchingPayload(\n  payload: unknown,\n  identity: DuplicateCodeCacheIdentity,\n  cacheKey: string\n): payload is ScanCachePayload {\n  if (!isNonArrayRecord(payload)) return false;\n\n  return (\n    cacheIdentityFieldsMatch(payload, identity, cacheKey) &&\n    cacheStructuredFieldsMatch(payload, identity)\n  );\n}\n\nexport function isMetricArray(value: unknown): value is readonly DuplicateCodeFragment[] {\n  if (!Array.isArray(value)) return false;\n  return value.every(isDuplicateCodeFragment);\n}\n\nfunction cacheIdentityFieldsMatch(\n  payload: Record<string, unknown>,\n  identity: DuplicateCodeCacheIdentity,\n  cacheKey: string\n): boolean {\n  return (\n    payload.scanCacheVersion === SCAN_CACHE_VERSION &&\n    payload.cacheKey === cacheKey &&\n    payload.toolName === identity.toolName &&\n    payload.toolVersion === identity.toolVersion &&\n    payload.configVersion === identity.configVersion &&\n    payload.commitSha === identity.commitSha\n  );\n}\n\nfunction cacheStructuredFieldsMatch(\n  payload: Record<string, unknown>,\n  identity: DuplicateCodeCacheIdentity\n): boolean {\n  return (\n    stableStringify(payload.scannerConfiguration) ===\n      stableStringify(identity.scannerConfiguration) &&\n    stableStringify(payload.inputFingerprint) === stableStringify(identity.inputFingerprint)\n  );\n}\n\nfunction isDuplicateCodeFragment(value: unknown): value is DuplicateCodeFragment {\n  return (\n    isNonArrayRecord(value) &&\n    isFiniteNumber(value.id) &&\n    isFiniteNumber(value.tokenCount) &&\n    isFiniteNumber(value.lineCount) &&\n    Array.isArray(value.codeAreas) &&\n    value.codeAreas.every((area) => typeof area === \"string\") &&\n    Array.isArray(value.locations) &&\n    value.locations.every(isDuplicateCodeLocation)\n  );\n}\n\nfunction isDuplicateCodeLocation(value: unknown): value is DuplicateCodeLocation {\n  return (\n    isNonArrayRecord(value) &&\n    typeof value.path === \"string\" &&\n    isFiniteNumber(value.startLine) &&\n    isFiniteNumber(value.endLine)\n  );\n}\n\nfunction isFiniteNumber(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isFinite(value);\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/cache/store.mjs

@@ -0,0 +1,44 @@
+/** 读取和写入 duplicate-code raw-scan cache entries。 */
+import { readJsonFile, writeJsonFile } from "../../host-environment/filesystem.mjs";
+import { buildScanCacheKey, getScanCachePath } from "./key.mjs";
+import { isMatchingPayload, isMetricArray } from "./payload.mjs";
+import { SCAN_CACHE_VERSION } from "./cache-contract.mjs";
+export { buildScanCacheKey, getScanCachePath } from "./key.mjs";
+export { SCAN_CACHE_VERSION } from "./cache-contract.mjs";
+export function loadScanCacheEntry({ rootDir, identity }) {
+    const cacheKey = buildScanCacheKey(identity);
+    const cachePath = getScanCachePath(rootDir, cacheKey);
+    let payload;
+    try {
+        payload = readJsonFile(cachePath);
+    }
+    catch {
+        return { hit: false, reason: "cache-miss", cacheKey, cachePath };
+    }
+    if (!isMatchingPayload(payload, identity, cacheKey)) {
+        return { hit: false, reason: "cache-payload-mismatch", cacheKey, cachePath };
+    }
+    if (!isMetricArray(payload.metrics)) {
+        return { hit: false, reason: "cache-payload-invalid", cacheKey, cachePath };
+    }
+    return { hit: true, metrics: payload.metrics, cacheKey, cachePath };
+}
+export function writeScanCacheEntry({ rootDir, identity, metrics }) {
+    const cacheKey = buildScanCacheKey(identity);
+    const cachePath = getScanCachePath(rootDir, cacheKey);
+    const payload = {
+        scanCacheVersion: SCAN_CACHE_VERSION,
+        cacheKey,
+        toolName: identity.toolName,
+        toolVersion: identity.toolVersion,
+        scannerConfiguration: identity.scannerConfiguration,
+        configVersion: identity.configVersion,
+        commitSha: identity.commitSha,
+        inputFingerprint: identity.inputFingerprint,
+        metrics,
+        createdAt: new Date().toISOString()
+    };
+    writeJsonFile({ filePath: cachePath, value: payload });
+    return { cacheKey, cachePath };
+}
+//# sourceMappingURL=store.mjs.map

package/dist/esm/package-checks/duplicate-detection/cache/store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/duplicate-detection/cache/store.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAEnF,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EACL,kBAAkB,EAKnB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAOzD,MAAM,UAAU,kBAAkB,CAAC,EACjC,OAAO,EACP,QAAQ,EAIT;IACC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IAEtD,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IACnE,CAAC;IAED,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,wBAAwB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC/E,CAAC;IAED,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,uBAAuB,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;IAC9E,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACtE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,EAClC,OAAO,EACP,QAAQ,EACR,OAAO,EAKR;IACC,MAAM,QAAQ,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,OAAO,GAAqB;QAChC,gBAAgB,EAAE,kBAAkB;QACpC,QAAQ;QACR,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,oBAAoB,EAAE,QAAQ,CAAC,oBAAoB;QACnD,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;QAC3C,OAAO;QACP,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,aAAa,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACvD,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;AACjC,CAAC","sourcesContent":["/** 读取和写入 duplicate-code raw-scan cache entries。 */\n\nimport { readJsonFile, writeJsonFile } from \"../../host-environment/filesystem.ts\";\nimport type { DuplicateCodeFragment } from \"../measurement-model.ts\";\nimport { buildScanCacheKey, getScanCachePath } from \"./key.ts\";\nimport { isMatchingPayload, isMetricArray } from \"./payload.ts\";\nimport {\n  SCAN_CACHE_VERSION,\n  type DuplicateCodeCacheHit,\n  type DuplicateCodeCacheIdentity,\n  type DuplicateCodeCacheMiss,\n  type ScanCachePayload\n} from \"./cache-contract.ts\";\n\nexport { buildScanCacheKey, getScanCachePath } from \"./key.ts\";\nexport { SCAN_CACHE_VERSION } from \"./cache-contract.ts\";\nexport type {\n  DuplicateCodeCacheHit,\n  DuplicateCodeCacheIdentity,\n  DuplicateCodeCacheMiss\n} from \"./cache-contract.ts\";\n\nexport function loadScanCacheEntry({\n  rootDir,\n  identity\n}: {\n  identity: DuplicateCodeCacheIdentity;\n  rootDir: string;\n}): DuplicateCodeCacheHit | DuplicateCodeCacheMiss {\n  const cacheKey = buildScanCacheKey(identity);\n  const cachePath = getScanCachePath(rootDir, cacheKey);\n\n  let payload: unknown;\n  try {\n    payload = readJsonFile(cachePath);\n  } catch {\n    return { hit: false, reason: \"cache-miss\", cacheKey, cachePath };\n  }\n\n  if (!isMatchingPayload(payload, identity, cacheKey)) {\n    return { hit: false, reason: \"cache-payload-mismatch\", cacheKey, cachePath };\n  }\n\n  if (!isMetricArray(payload.metrics)) {\n    return { hit: false, reason: \"cache-payload-invalid\", cacheKey, cachePath };\n  }\n\n  return { hit: true, metrics: payload.metrics, cacheKey, cachePath };\n}\n\nexport function writeScanCacheEntry({\n  rootDir,\n  identity,\n  metrics\n}: {\n  identity: DuplicateCodeCacheIdentity;\n  metrics: readonly DuplicateCodeFragment[];\n  rootDir: string;\n}): { cacheKey: string; cachePath: string } {\n  const cacheKey = buildScanCacheKey(identity);\n  const cachePath = getScanCachePath(rootDir, cacheKey);\n  const payload: ScanCachePayload = {\n    scanCacheVersion: SCAN_CACHE_VERSION,\n    cacheKey,\n    toolName: identity.toolName,\n    toolVersion: identity.toolVersion,\n    scannerConfiguration: identity.scannerConfiguration,\n    configVersion: identity.configVersion,\n    commitSha: identity.commitSha,\n    inputFingerprint: identity.inputFingerprint,\n    metrics,\n    createdAt: new Date().toISOString()\n  };\n\n  writeJsonFile({ filePath: cachePath, value: payload });\n  return { cacheKey, cachePath };\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/default-check.mjs

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

package/dist/esm/package-checks/duplicate-detection/default-check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-check.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/default-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,oCAAoC,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AACjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,iBAAiB,CAAC;AAE9D,OAAO,EAAE,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAC;AAEjF;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAO,GAA8B,EAAE;IAMvC,MAAM,eAAe,GAAG,gCAAgC,CAAC,OAAO,CAAC,CAAC;IAClE,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CACjB,sFAAsF,CACvF,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,GAAG,oCAAoC;QACvC,SAAS,EAAE,yBAAyB;QACpC,SAAS,EAAE,2BAA2B;QACtC,SAAS,EAAE,CAAC,eAAe,EAAE,EAAE,CAC7B,sCAAsC,CAAC,eAAe,CAAC;YACrD,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,uIAAuI;qBAC1I;iBACF;aACF;QACP,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { defineCheck, type TypedCheckWithOptions } from \"../../check/check.ts\";\nimport { DUPLICATE_DETECTION_CHECK_DEFINITION, executeDuplicateDetection } from \"./execution.ts\";\nimport { parseDuplicateDetectionData } from \"./final-data.ts\";\nimport type { DuplicateDetectionOptions, ResolvedDuplicateDetectionOptions } from \"./options.ts\";\nimport { resolveDuplicateDetectionOptions } from \"./options-resolution.ts\";\nimport { validResolvedDuplicateDetectionOptions } from \"./options-validation.ts\";\n\n/**\n * 使用可省略的区域、cache 与 scanner policy 构造一个完整 duplicate-detection Check。\n *\n * @param options - 省略字段由 package 补齐；显式 files 数组作为对应字段的完整替换值。\n * @returns 固定 `duplicate-detection` identity、完整冻结 options、preflight 与 execution。\n * @throws {TypeError} input 含未知字段、空 area、非法阈值、非法 cache 或 scanner policy 时抛出。\n */\nexport function duplicateDetection(\n  options: DuplicateDetectionOptions = {}\n): TypedCheckWithOptions<\n  \"duplicate-detection\",\n  ResolvedDuplicateDetectionOptions,\n  typeof parseDuplicateDetectionData\n> {\n  const resolvedOptions = resolveDuplicateDetectionOptions(options);\n  if (resolvedOptions === undefined) {\n    throw new TypeError(\n      \"duplicateDetection options are invalid; use the documented closed constructor policy\"\n    );\n  }\n  return defineCheck({\n    ...DUPLICATE_DETECTION_CHECK_DEFINITION,\n    execution: executeDuplicateDetection,\n    parseData: parseDuplicateDetectionData,\n    preflight: (preparedOptions) =>\n      validResolvedDuplicateDetectionOptions(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                  \"duplicateDetection options are invalid; recreate the Check with duplicateDetection(options) or restore its complete resolved options.\"\n              }\n            ]\n          },\n    options: resolvedOptions\n  });\n}\n"]}

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

@@ -0,0 +1,124 @@
+import { resolve } from "node:path";
+import { collectProjectFileSets, requireProjectFileSet } from "../project-files/collection.mjs";
+import { fingerprintProjectFiles } from "../project-files/file-fingerprint.mjs";
+import { settleFindings } from "../code-quality-findings/policy.mjs";
+import { getGitSha } from "./project-revision.mjs";
+import { measureDuplicateDetection } from "./measurement.mjs";
+import { validResolvedDuplicateDetectionOptions } from "./options-validation.mjs";
+import { buildDuplicateRecordCandidates } from "./records.mjs";
+export const DUPLICATE_DETECTION_CHECK_DEFINITION = {
+    checkId: "duplicate-detection",
+    displayName: "Duplicate detection"
+};
+/** Default Check callback；scanner configuration 由其完整 options 拥有。 */
+export async function executeDuplicateDetection(context) {
+    if (!validResolvedDuplicateDetectionOptions(context.options))
+        return unavailable("invalid-options");
+    let exactInput;
+    try {
+        exactInput = prepareExactInputSet(context.project.root, context.options);
+    }
+    catch {
+        return unavailable("source-unavailable");
+    }
+    if (exactInput.approvedExactPaths.length < 2) {
+        return Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } });
+    }
+    const measurement = await measureDuplicateDetection({
+        cache: context.options.cache,
+        dependency: context.options.scanner,
+        exactInput
+    });
+    if (measurement.kind !== "complete")
+        return directMeasurementFailure(measurement);
+    const candidates = buildDuplicateRecordCandidates(measurement.fragments, context.options.codeAreas);
+    if (candidates === undefined)
+        return unavailable("external-result-invalid");
+    for (const candidate of candidates) {
+        context.records.report({ id: candidate.id }, candidate.data);
+    }
+    return settleFindings(candidates.map((candidate) => ({ actionable: true, blocking: candidate.data.blocking })));
+}
+function prepareExactInputSet(rootDir, options) {
+    const areas = collectAreaInputs(rootDir, options.codeAreas);
+    const approvedExactPaths = uniqueSorted(areas.flatMap((area) => area.approvedExactPaths));
+    const inputFingerprint = fingerprintProjectFiles(rootDir, approvedExactPaths);
+    return Object.freeze({
+        approvedExactPaths: Object.freeze(approvedExactPaths),
+        areas,
+        cacheRootDir: resolve(rootDir, options.cache.directory),
+        commitSha: getGitSha(rootDir),
+        inputFingerprint: Object.freeze({
+            ...inputFingerprint,
+            fileList: Object.freeze([...inputFingerprint.fileList])
+        }),
+        rootDir
+    });
+}
+function collectAreaInputs(rootDir, codeAreas) {
+    const areas = [];
+    const orderedPolicies = Object.entries(codeAreas).sort(([left], [right]) => compareText(left, right));
+    const filesByArea = collectProjectFileSets(rootDir, Object.fromEntries(orderedPolicies.map(([areaId, policy]) => [areaId, policy.files])));
+    for (const [codeArea, policy] of orderedPolicies) {
+        const approvedExactPaths = requireProjectFileSet(filesByArea, codeArea);
+        if (approvedExactPaths.length === 0)
+            continue;
+        areas.push(Object.freeze({
+            approvedExactPaths: Object.freeze(approvedExactPaths),
+            codeArea,
+            minimumLines: policy.minimumLines,
+            minimumTokens: policy.minimumTokens
+        }));
+    }
+    return Object.freeze(areas);
+}
+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;
+}
+function directMeasurementFailure(measurement) {
+    switch (measurement.kind) {
+        case "cache-write-failed":
+            return unavailable("cache-write-failed");
+        case "execution-failed":
+            return unavailable("external-execution-failed");
+        case "invalid-result":
+            return unavailable("external-result-invalid");
+        case "unavailable":
+            return unavailable("external-dependency-unavailable");
+    }
+    const exhaustiveMeasurement = measurement;
+    return exhaustiveMeasurement;
+}
+function unavailable(code) {
+    return Object.freeze({
+        status: "unavailable",
+        reason: { code },
+        messages: Object.freeze([
+            Object.freeze({ code, level: "error", message: unavailableMessage(code) })
+        ])
+    });
+}
+function unavailableMessage(code) {
+    switch (code) {
+        case "invalid-options":
+            return "duplicateDetection options are invalid; recreate the Check with duplicateDetection(options) or restore its complete resolved options.";
+        case "source-unavailable":
+            return "Duplicate detection could not collect its configured project files; check the project root, file permissions, and selected file source.";
+        case "external-dependency-unavailable":
+            return "The configured jscpd command is unavailable or incompatible; restore the package dependency or configure a compatible executable.";
+        case "external-execution-failed":
+            return "jscpd did not complete successfully; run the configured command directly and inspect its environment.";
+        case "external-result-invalid":
+            return "jscpd output could not form a trusted complete result; check command and report compatibility.";
+        case "cache-write-failed":
+            return "Duplicate detection completed scanning but could not write its cache; check the configured cache directory permissions.";
+    }
+}
+//# sourceMappingURL=execution.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolve } from \"node:path\";\n\nimport type { CheckExecutionContext, CheckResult } from \"../../check/check.ts\";\nimport { collectProjectFileSets, requireProjectFileSet } from \"../project-files/collection.ts\";\nimport { fingerprintProjectFiles } from \"../project-files/file-fingerprint.ts\";\nimport { settleFindings } from \"../code-quality-findings/policy.ts\";\nimport { getGitSha } from \"./project-revision.ts\";\nimport { measureDuplicateDetection, type DuplicateMeasurementResult } from \"./measurement.ts\";\nimport type {\n  DuplicateDetectionAreaInput,\n  DuplicateDetectionExactInputSet\n} from \"./measurement-model.ts\";\nimport type { ResolvedDuplicateDetectionOptions } from \"./options.ts\";\nimport { validResolvedDuplicateDetectionOptions } from \"./options-validation.ts\";\nimport { buildDuplicateRecordCandidates } from \"./records.ts\";\nimport type { DuplicateDetectionFinalData } from \"./final-data.ts\";\n\nexport const DUPLICATE_DETECTION_CHECK_DEFINITION = {\n  checkId: \"duplicate-detection\",\n  displayName: \"Duplicate detection\"\n} as const;\n\n/** `duplicate-detection` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type DuplicateDetectionUnavailableReasonCode =\n  | \"cache-write-failed\"\n  | \"external-dependency-unavailable\"\n  | \"external-execution-failed\"\n  | \"external-result-invalid\"\n  | \"invalid-options\"\n  | \"source-unavailable\";\n\n/** Default Check callback；scanner configuration 由其完整 options 拥有。 */\nexport async function executeDuplicateDetection(\n  context: CheckExecutionContext<ResolvedDuplicateDetectionOptions>\n): Promise<CheckResult<DuplicateDetectionFinalData>> {\n  if (!validResolvedDuplicateDetectionOptions(context.options))\n    return unavailable(\"invalid-options\");\n\n  let exactInput: DuplicateDetectionExactInputSet;\n  try {\n    exactInput = prepareExactInputSet(context.project.root, context.options);\n  } catch {\n    return unavailable(\"source-unavailable\");\n  }\n  if (exactInput.approvedExactPaths.length < 2) {\n    return Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } });\n  }\n  const measurement = await measureDuplicateDetection({\n    cache: context.options.cache,\n    dependency: context.options.scanner,\n    exactInput\n  });\n  if (measurement.kind !== \"complete\") return directMeasurementFailure(measurement);\n  const candidates = buildDuplicateRecordCandidates(\n    measurement.fragments,\n    context.options.codeAreas\n  );\n  if (candidates === undefined) return unavailable(\"external-result-invalid\");\n  for (const candidate of candidates) {\n    context.records.report({ id: candidate.id }, candidate.data);\n  }\n  return settleFindings(\n    candidates.map((candidate) => ({ actionable: true, blocking: candidate.data.blocking }))\n  );\n}\n\nfunction prepareExactInputSet(\n  rootDir: string,\n  options: ResolvedDuplicateDetectionOptions\n): DuplicateDetectionExactInputSet {\n  const areas = collectAreaInputs(rootDir, options.codeAreas);\n  const approvedExactPaths = uniqueSorted(areas.flatMap((area) => area.approvedExactPaths));\n  const inputFingerprint = fingerprintProjectFiles(rootDir, approvedExactPaths);\n  return Object.freeze({\n    approvedExactPaths: Object.freeze(approvedExactPaths),\n    areas,\n    cacheRootDir: resolve(rootDir, options.cache.directory),\n    commitSha: getGitSha(rootDir),\n    inputFingerprint: Object.freeze({\n      ...inputFingerprint,\n      fileList: Object.freeze([...inputFingerprint.fileList])\n    }),\n    rootDir\n  });\n}\n\nfunction collectAreaInputs(\n  rootDir: string,\n  codeAreas: ResolvedDuplicateDetectionOptions[\"codeAreas\"]\n): readonly DuplicateDetectionAreaInput[] {\n  const areas: DuplicateDetectionAreaInput[] = [];\n  const orderedPolicies = Object.entries(codeAreas).sort(([left], [right]) =>\n    compareText(left, right)\n  );\n  const filesByArea = collectProjectFileSets(\n    rootDir,\n    Object.fromEntries(orderedPolicies.map(([areaId, policy]) => [areaId, policy.files]))\n  );\n  for (const [codeArea, policy] of orderedPolicies) {\n    const approvedExactPaths = requireProjectFileSet(filesByArea, codeArea);\n    if (approvedExactPaths.length === 0) continue;\n    areas.push(\n      Object.freeze({\n        approvedExactPaths: Object.freeze(approvedExactPaths),\n        codeArea,\n        minimumLines: policy.minimumLines,\n        minimumTokens: policy.minimumTokens\n      })\n    );\n  }\n  return Object.freeze(areas);\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\nfunction directMeasurementFailure(\n  measurement: Exclude<DuplicateMeasurementResult, { kind: \"complete\" }>\n): CheckResult<DuplicateDetectionFinalData> {\n  switch (measurement.kind) {\n    case \"cache-write-failed\":\n      return unavailable(\"cache-write-failed\");\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(\n  code: DuplicateDetectionUnavailableReasonCode\n): CheckResult<DuplicateDetectionFinalData> {\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: DuplicateDetectionUnavailableReasonCode): string {\n  switch (code) {\n    case \"invalid-options\":\n      return \"duplicateDetection options are invalid; recreate the Check with duplicateDetection(options) or restore its complete resolved options.\";\n    case \"source-unavailable\":\n      return \"Duplicate detection 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 jscpd command is unavailable or incompatible; restore the package dependency or configure a compatible executable.\";\n    case \"external-execution-failed\":\n      return \"jscpd did not complete successfully; run the configured command directly and inspect its environment.\";\n    case \"external-result-invalid\":\n      return \"jscpd output could not form a trusted complete result; check command and report compatibility.\";\n    case \"cache-write-failed\":\n      return \"Duplicate detection completed scanning but could not write its cache; check the configured cache directory permissions.\";\n  }\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/final-data.mjs

@@ -0,0 +1,6 @@
+import { parseFindingSummaryData } from "../final-data-parsing.mjs";
+/** 验证并脱离一份 `duplicate-detection` canonical final-data object。 */
+export function parseDuplicateDetectionData(data) {
+    return parseFindingSummaryData(data, "duplicateDetection");
+}
+//# sourceMappingURL=final-data.mjs.map

package/dist/esm/package-checks/duplicate-detection/final-data.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/final-data.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAKnE,iEAAiE;AACjE,MAAM,UAAU,2BAA2B,CAAC,IAAa;IACvD,OAAO,uBAAuB,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;AAC7D,CAAC","sourcesContent":["import type { FindingSummary } from \"../code-quality-findings/policy.ts\";\nimport { parseFindingSummaryData } from \"../final-data-parsing.ts\";\n\n/** `duplicate-detection` 在 passed/failed outcome 中发布的主数据。 */\nexport type DuplicateDetectionFinalData = FindingSummary;\n\n/** 验证并脱离一份 `duplicate-detection` canonical final-data object。 */\nexport function parseDuplicateDetectionData(data: unknown): DuplicateDetectionFinalData {\n  return parseFindingSummaryData(data, \"duplicateDetection\");\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/jscpd/availability.mjs

@@ -0,0 +1,77 @@
+import { runProcess } from "../../host-environment/process/command.mjs";
+import { isMissingExplicitCommand } from "./command-path.mjs";
+import { isPackageJscpdCommand, resolveJscpdCommand } from "./command-resolution.mjs";
+import { parseJscpdVersionOutput } from "./scanner.mjs";
+export async function checkJscpd(rootDir, dependency) {
+    const resolved = resolveJscpdCommand(dependency.command);
+    if (resolved.kind === "unavailable") {
+        return unavailableJscpd(resolved.error, "tool-unavailable", dependency);
+    }
+    if (isMissingExplicitCommand(resolved.command.executable)) {
+        return unavailableJscpd("jscpd dependency binary unavailable", "tool-unavailable", dependency);
+    }
+    try {
+        const result = await runProcess({
+            args: [...resolved.command.versionArguments],
+            command: resolved.command.executable,
+            cwd: rootDir
+        });
+        return availabilityFromVersionResult(result, dependency);
+    }
+    catch (error) {
+        return error instanceof Error
+            ? processErrorAvailability(error, dependency)
+            : unavailableJscpd("unknown error", "execution-error", dependency);
+    }
+}
+function availabilityFromVersionResult(result, dependency) {
+    if (result.error)
+        return processErrorAvailability(result.error, dependency);
+    const output = commandOutput(result);
+    if (result.status !== 0)
+        return failedVersionAvailability(result, output, dependency);
+    const version = parseJscpdVersionOutput(output);
+    if (version === null)
+        return unrecognizedVersionAvailability(dependency);
+    return {
+        name: "jscpd",
+        available: true,
+        version,
+        error: null,
+        source: jscpdSource(dependency),
+        reason: null
+    };
+}
+function failedVersionAvailability(result, output, dependency) {
+    const detail = output ? `: ${output}` : "";
+    return unavailableJscpd(`jscpd --version failed, ${processTermination(result)}${detail}`, "execution-error", dependency);
+}
+function unrecognizedVersionAvailability(dependency) {
+    return unavailableJscpd("jscpd --version returned unrecognized output", "execution-error", dependency);
+}
+function processErrorAvailability(error, dependency) {
+    const isMissingTool = error.code === "ENOENT";
+    return unavailableJscpd(isMissingTool ? "jscpd dependency binary unavailable" : `jscpd version error: ${error.message}`, isMissingTool ? "tool-unavailable" : "execution-error", dependency);
+}
+function unavailableJscpd(error, reason, dependency) {
+    return {
+        name: "jscpd",
+        available: false,
+        version: null,
+        error,
+        source: jscpdSource(dependency),
+        reason
+    };
+}
+function jscpdSource(dependency) {
+    return isPackageJscpdCommand(dependency.command) ? "package dependency" : "custom command";
+}
+function commandOutput(result) {
+    return (result.stdout || "").trim() || (result.stderr || "").trim();
+}
+function processTermination(result) {
+    return typeof result.status === "number"
+        ? `exit ${result.status}`
+        : `signal ${result.signal || "unknown"}`;
+}
+//# sourceMappingURL=availability.mjs.map

package/dist/esm/package-checks/duplicate-detection/jscpd/availability.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/duplicate-detection/jscpd/availability.ts"],"names":[],"mappings":"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","sourcesContent":["import { runProcess } from \"../../host-environment/process/command.ts\";\nimport type { ResolvedDuplicateDetectionScannerOptions } from \"../options.ts\";\nimport { isMissingExplicitCommand } from \"./command-path.ts\";\nimport { isPackageJscpdCommand, resolveJscpdCommand } from \"./command-resolution.ts\";\nimport { parseJscpdVersionOutput } from \"./scanner.ts\";\n\ntype JscpdAvailability = Readonly<\n  | {\n      available: true;\n      error: null;\n      name: \"jscpd\";\n      reason: null;\n      source: JscpdSource;\n      version: string;\n    }\n  | {\n      available: false;\n      error: string;\n      name: \"jscpd\";\n      reason: \"execution-error\" | \"tool-unavailable\";\n      source: JscpdSource;\n      version: null;\n    }\n>;\n\ntype JscpdSource = \"custom command\" | \"package dependency\";\n\ntype ToolCommandResult = Awaited<ReturnType<typeof runProcess>>;\n\nexport async function checkJscpd(\n  rootDir: string,\n  dependency: ResolvedDuplicateDetectionScannerOptions\n): Promise<JscpdAvailability> {\n  const resolved = resolveJscpdCommand(dependency.command);\n  if (resolved.kind === \"unavailable\") {\n    return unavailableJscpd(resolved.error, \"tool-unavailable\", dependency);\n  }\n  if (isMissingExplicitCommand(resolved.command.executable)) {\n    return unavailableJscpd(\"jscpd dependency binary unavailable\", \"tool-unavailable\", dependency);\n  }\n\n  try {\n    const result = await runProcess({\n      args: [...resolved.command.versionArguments],\n      command: resolved.command.executable,\n      cwd: rootDir\n    });\n    return availabilityFromVersionResult(result, dependency);\n  } catch (error: unknown) {\n    return error instanceof Error\n      ? processErrorAvailability(error, dependency)\n      : unavailableJscpd(\"unknown error\", \"execution-error\", dependency);\n  }\n}\n\nfunction availabilityFromVersionResult(\n  result: ToolCommandResult,\n  dependency: ResolvedDuplicateDetectionScannerOptions\n): JscpdAvailability {\n  if (result.error) return processErrorAvailability(result.error, dependency);\n  const output = commandOutput(result);\n  if (result.status !== 0) return failedVersionAvailability(result, output, dependency);\n  const version = parseJscpdVersionOutput(output);\n  if (version === null) return unrecognizedVersionAvailability(dependency);\n  return {\n    name: \"jscpd\",\n    available: true,\n    version,\n    error: null,\n    source: jscpdSource(dependency),\n    reason: null\n  };\n}\n\nfunction failedVersionAvailability(\n  result: ToolCommandResult,\n  output: string,\n  dependency: ResolvedDuplicateDetectionScannerOptions\n): JscpdAvailability {\n  const detail = output ? `: ${output}` : \"\";\n  return unavailableJscpd(\n    `jscpd --version failed, ${processTermination(result)}${detail}`,\n    \"execution-error\",\n    dependency\n  );\n}\n\nfunction unrecognizedVersionAvailability(\n  dependency: ResolvedDuplicateDetectionScannerOptions\n): JscpdAvailability {\n  return unavailableJscpd(\n    \"jscpd --version returned unrecognized output\",\n    \"execution-error\",\n    dependency\n  );\n}\n\nfunction processErrorAvailability(\n  error: Error,\n  dependency: ResolvedDuplicateDetectionScannerOptions\n): JscpdAvailability {\n  const isMissingTool = (error as NodeJS.ErrnoException).code === \"ENOENT\";\n  return unavailableJscpd(\n    isMissingTool ? \"jscpd dependency binary unavailable\" : `jscpd version error: ${error.message}`,\n    isMissingTool ? \"tool-unavailable\" : \"execution-error\",\n    dependency\n  );\n}\n\nfunction unavailableJscpd(\n  error: string,\n  reason: Exclude<JscpdAvailability[\"reason\"], null>,\n  dependency: ResolvedDuplicateDetectionScannerOptions\n): JscpdAvailability {\n  return {\n    name: \"jscpd\",\n    available: false,\n    version: null,\n    error,\n    source: jscpdSource(dependency),\n    reason\n  };\n}\n\nfunction jscpdSource(dependency: ResolvedDuplicateDetectionScannerOptions): JscpdSource {\n  return isPackageJscpdCommand(dependency.command) ? \"package dependency\" : \"custom command\";\n}\n\nfunction commandOutput(result: ToolCommandResult): string {\n  return (result.stdout || \"\").trim() || (result.stderr || \"\").trim();\n}\n\nfunction processTermination(result: ToolCommandResult): string {\n  return typeof result.status === \"number\"\n    ? `exit ${result.status}`\n    : `signal ${result.signal || \"unknown\"}`;\n}\n"]}

package/dist/esm/package-checks/duplicate-detection/jscpd/command-path.mjs

@@ -0,0 +1,6 @@
+import { existsSync } from "node:fs";
+import { isAbsolute } from "node:path";
+export function isMissingExplicitCommand(command) {
+    return ((isAbsolute(command) || command.includes("/") || command.includes("\\")) && !existsSync(command));
+}
+//# sourceMappingURL=command-path.mjs.map