@zxyycom/vibe-check 0.0.1 → 0.0.2

package/dist/esm/package-checks/code-quality-findings/finding-waiver-authoring.mjs

@@ -0,0 +1,40 @@
+import { canonicalJsonText } from "../../data-boundary/canonical-data.mjs";
+import { snapshotClosedArray, snapshotClosedPolicyRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString } from "../../data-boundary/value-shapes.mjs";
+/**
+ * Snapshots the shared closed waiver envelope while leaving identity grammar to the producing Check.
+ */
+export function resolveFindingWaiverAuthoring(value, resolveIdentity) {
+    if (value === undefined)
+        return Object.freeze([]);
+    const candidates = snapshotClosedArray(value);
+    if (candidates === undefined)
+        return undefined;
+    const waivers = [];
+    const seenIdentities = new Set();
+    for (const candidate of candidates) {
+        const authored = snapshotClosedPolicyRecord(candidate, { required: ["identity", "reason"] });
+        if (authored === undefined || !isNonEmptyString(authored.reason))
+            return undefined;
+        const identity = resolveIdentity(authored.identity);
+        if (identity === undefined)
+            return undefined;
+        let identityKey;
+        try {
+            identityKey = canonicalJsonText(identity);
+        }
+        catch {
+            return undefined;
+        }
+        if (seenIdentities.has(identityKey))
+            return undefined;
+        seenIdentities.add(identityKey);
+        waivers.push(Object.freeze({ identity, reason: authored.reason }));
+    }
+    return Object.freeze(waivers);
+}
+/** Validates the complete resolved waiver list through the same authoring boundary. */
+export function validResolvedFindingWaivers(value, resolveIdentity) {
+    return value !== undefined && resolveFindingWaiverAuthoring(value, resolveIdentity) !== undefined;
+}
+//# sourceMappingURL=finding-waiver-authoring.mjs.map

package/dist/esm/package-checks/code-quality-findings/finding-waiver-authoring.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-waiver-authoring.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/finding-waiver-authoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGvE;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,eAAyD;IAEzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7F,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QACnF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC7C,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,OAAO,SAAS,CAAC;QACtD,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,eAAyD;IAEzD,OAAO,KAAK,KAAK,SAAS,IAAI,6BAA6B,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,SAAS,CAAC;AACpG,CAAC","sourcesContent":["import { canonicalJsonText } from \"../../data-boundary/canonical-data.ts\";\nimport {\n  snapshotClosedArray,\n  snapshotClosedPolicyRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { isNonEmptyString } from \"../../data-boundary/value-shapes.ts\";\nimport type { FindingWaiver } from \"../../finding-waivers/reconciliation.ts\";\n\n/**\n * Snapshots the shared closed waiver envelope while leaving identity grammar to the producing Check.\n */\nexport function resolveFindingWaiverAuthoring<Identity>(\n  value: unknown,\n  resolveIdentity: (value: unknown) => Identity | undefined\n): readonly FindingWaiver<Identity>[] | undefined {\n  if (value === undefined) return Object.freeze([]);\n  const candidates = snapshotClosedArray(value);\n  if (candidates === undefined) return undefined;\n\n  const waivers: FindingWaiver<Identity>[] = [];\n  const seenIdentities = new Set<string>();\n  for (const candidate of candidates) {\n    const authored = snapshotClosedPolicyRecord(candidate, { required: [\"identity\", \"reason\"] });\n    if (authored === undefined || !isNonEmptyString(authored.reason)) return undefined;\n    const identity = resolveIdentity(authored.identity);\n    if (identity === undefined) return undefined;\n    let identityKey: string;\n    try {\n      identityKey = canonicalJsonText(identity);\n    } catch {\n      return undefined;\n    }\n    if (seenIdentities.has(identityKey)) return undefined;\n    seenIdentities.add(identityKey);\n    waivers.push(Object.freeze({ identity, reason: authored.reason }));\n  }\n  return Object.freeze(waivers);\n}\n\n/** Validates the complete resolved waiver list through the same authoring boundary. */\nexport function validResolvedFindingWaivers<Identity>(\n  value: unknown,\n  resolveIdentity: (value: unknown) => Identity | undefined\n): value is readonly FindingWaiver<Identity>[] {\n  return value !== undefined && resolveFindingWaiverAuthoring(value, resolveIdentity) !== undefined;\n}\n"]}

package/dist/esm/package-checks/code-quality-findings/finding-waiver-evidence.mjs

@@ -0,0 +1,48 @@
+import { createHash } from "node:crypto";
+import { canonicalJsonBytes } from "../../data-boundary/canonical-data.mjs";
+const FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX = "/finding-waiver-audit/";
+/** Builds the common immutable data shared by Check-owned waiver audit Records. */
+export function buildFindingWaiverAuditRecordData(identity, audit) {
+    return Object.freeze({
+        identity,
+        kind: "finding-waiver-audit",
+        matchCount: audit.matchCount,
+        reason: audit.waiver.reason,
+        status: audit.status
+    });
+}
+/** Builds the shared hash-addressed audit Record used by structured identities. */
+export function buildHashedFindingWaiverAuditRecord(identity, audit) {
+    const digest = createHash("sha256").update(canonicalJsonBytes(identity)).digest("hex");
+    return Object.freeze({
+        data: buildFindingWaiverAuditRecordData(identity, audit),
+        id: `${FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX}sha256:${digest}`
+    });
+}
+/** Publishes every reconciled metric Finding while preserving applied waiver evidence. */
+export function reportReconciledCodeQualityFindingRecords(context, reconciliation) {
+    for (const finding of reconciliation.findings) {
+        const data = finding.disposition === "waived"
+            ? Object.freeze({
+                ...finding.finding.data,
+                blocking: false,
+                waiver: Object.freeze({ reason: finding.waiver.reason })
+            })
+            : finding.finding.data;
+        context.records.report({ id: finding.finding.id }, data);
+    }
+}
+/** Publishes only unused/overmatched audit rows built by the identity-owning Check. */
+export function reportFindingWaiverAudits(context, reconciliation, buildRecord) {
+    for (const audit of reconciliation.waiverAudits) {
+        if (audit.status === "applied")
+            continue;
+        const record = buildRecord(Object.freeze({
+            matchCount: audit.matchCount,
+            status: audit.status,
+            waiver: audit.waiver
+        }));
+        context.records.report({ id: record.id }, record.data);
+    }
+}
+//# sourceMappingURL=finding-waiver-evidence.mjs.map

package/dist/esm/package-checks/code-quality-findings/finding-waiver-evidence.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-waiver-evidence.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/finding-waiver-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAa3E,MAAM,qCAAqC,GAAG,wBAAwB,CAAC;AAgBvE,mFAAmF;AACnF,MAAM,UAAU,iCAAiC,CAC/C,QAAkB,EAClB,KAA+B;IAE/B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ;QACR,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mCAAmC,CACjD,QAAkB,EAClB,KAA+B;IAE/B,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,iCAAiC,CAAC,QAAQ,EAAE,KAAK,CAAC;QACxD,EAAE,EAAE,GAAG,qCAAqC,UAAU,MAAM,EAAE;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,yCAAyC,CAEvD,OAA6B,EAAE,cAAoD;IACnF,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,GACR,OAAO,CAAC,WAAW,KAAK,QAAQ;YAC9B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;gBACZ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI;gBACvB,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;aACzD,CAAC;YACJ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CACvC,OAA6B,EAC7B,cAAoD,EACpD,WAEgE;IAEhE,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,YAAY,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,SAAS;QACzC,MAAM,MAAM,GAAG,WAAW,CACxB,MAAM,CAAC,MAAM,CAAC;YACZ,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CACH,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport type { CheckExecutionContext } from \"../../check/check.ts\";\nimport { canonicalJsonBytes } from \"../../data-boundary/canonical-data.ts\";\nimport type {\n  FindingWaiverAudit,\n  FindingWaiverReconciliation\n} from \"../../finding-waivers/reconciliation.ts\";\n\ninterface CodeQualityFindingCandidate {\n  readonly data: Readonly<{ readonly blocking: boolean }>;\n  readonly id: string;\n}\n\ntype FindingRecordContext = Pick<CheckExecutionContext<object>, \"records\">;\n\nconst FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX = \"/finding-waiver-audit/\";\n\nexport type FindingWaiverRecordAudit = Readonly<\n  Omit<FindingWaiverAudit, \"status\"> & {\n    readonly status: \"overmatched\" | \"unused\";\n  }\n>;\n\nexport type FindingWaiverAuditRecordData<Identity> = Readonly<{\n  readonly identity: Identity;\n  readonly kind: \"finding-waiver-audit\";\n  readonly matchCount: number;\n  readonly reason: string;\n  readonly status: \"overmatched\" | \"unused\";\n}>;\n\n/** Builds the common immutable data shared by Check-owned waiver audit Records. */\nexport function buildFindingWaiverAuditRecordData<Identity>(\n  identity: Identity,\n  audit: FindingWaiverRecordAudit\n): FindingWaiverAuditRecordData<Identity> {\n  return Object.freeze({\n    identity,\n    kind: \"finding-waiver-audit\",\n    matchCount: audit.matchCount,\n    reason: audit.waiver.reason,\n    status: audit.status\n  });\n}\n\n/** Builds the shared hash-addressed audit Record used by structured identities. */\nexport function buildHashedFindingWaiverAuditRecord<Identity>(\n  identity: Identity,\n  audit: FindingWaiverRecordAudit\n): Readonly<{ readonly data: FindingWaiverAuditRecordData<Identity>; readonly id: string }> {\n  const digest = createHash(\"sha256\").update(canonicalJsonBytes(identity)).digest(\"hex\");\n  return Object.freeze({\n    data: buildFindingWaiverAuditRecordData(identity, audit),\n    id: `${FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX}sha256:${digest}`\n  });\n}\n\n/** Publishes every reconciled metric Finding while preserving applied waiver evidence. */\nexport function reportReconciledCodeQualityFindingRecords<\n  Finding extends CodeQualityFindingCandidate\n>(context: FindingRecordContext, reconciliation: FindingWaiverReconciliation<Finding>): void {\n  for (const finding of reconciliation.findings) {\n    const data =\n      finding.disposition === \"waived\"\n        ? Object.freeze({\n            ...finding.finding.data,\n            blocking: false,\n            waiver: Object.freeze({ reason: finding.waiver.reason })\n          })\n        : finding.finding.data;\n    context.records.report({ id: finding.finding.id }, data);\n  }\n}\n\n/** Publishes only unused/overmatched audit rows built by the identity-owning Check. */\nexport function reportFindingWaiverAudits<Finding, AuditData extends object>(\n  context: FindingRecordContext,\n  reconciliation: FindingWaiverReconciliation<Finding>,\n  buildRecord: (\n    audit: FindingWaiverRecordAudit\n  ) => Readonly<{ readonly data: AuditData; readonly id: string }>\n): void {\n  for (const audit of reconciliation.waiverAudits) {\n    if (audit.status === \"applied\") continue;\n    const record = buildRecord(\n      Object.freeze({\n        matchCount: audit.matchCount,\n        status: audit.status,\n        waiver: audit.waiver\n      })\n    );\n    context.records.report({ id: record.id }, record.data);\n  }\n}\n"]}

package/dist/esm/package-checks/code-quality-findings/policy.mjs

@@ -1,3 +1,5 @@
+import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString } from "../../data-boundary/value-shapes.mjs";
 export const FINDING_POLICIES = Object.freeze(["blocking", "non-blocking"]);
 export const DEFAULT_FINDING_POLICY = "non-blocking";
 export function resolveFindingPolicy(value, fallback = DEFAULT_FINDING_POLICY) {
@@ -8,6 +10,24 @@ export function resolveFindingPolicy(value, fallback = DEFAULT_FINDING_POLICY) {
 export function validFindingPolicy(value) {
     return FINDING_POLICIES.some((policy) => policy === value);
 }
+/** Resolves the closed, non-empty named area map shared by code-quality Checks. */
+export function resolveCodeAreaPolicyMap(value, defaultArea, resolveArea) {
+    if (value === undefined)
+        return Object.freeze({ project: defaultArea() });
+    const areas = snapshotClosedRecord(value);
+    if (areas === undefined || Object.keys(areas).length === 0)
+        return undefined;
+    const resolvedEntries = [];
+    for (const [areaId, candidate] of Object.entries(areas)) {
+        if (!isNonEmptyString(areaId))
+            return undefined;
+        const area = resolveArea(candidate);
+        if (area === undefined)
+            return undefined;
+        resolvedEntries.push([areaId, area]);
+    }
+    return Object.freeze(Object.fromEntries(resolvedEntries));
+}
 export function isBlockingFinding(policies) {
     return policies.some((policy) => policy === "blocking");
 }

package/dist/esm/package-checks/code-quality-findings/policy.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"policy.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/policy.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,cAAc,CAAU,CAAC,CAAC;AAKrF,MAAM,CAAC,MAAM,sBAAsB,GAAkB,cAAc,CAAC;AAepE,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,QAAQ,GAAkB,sBAAsB;IAEhD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAkC;IAClE,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,QAAsC;IAEtC,MAAM,oBAAoB,GAAG,QAAQ,CAAC,MAAM,CAC1C,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,OAAO,CAAC,QAAQ,CACpD,CAAC,MAAM,CAAC;IACT,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC;IACrC,MAAM,iCAAiC,GAAG,QAAQ,CAAC,MAAM,CACvD,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,UAAU,IAAI,CAAC,OAAO,CAAC,QAAQ,CACrD,CAAC,MAAM,CAAC;IACT,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,iCAAiC,EAAE,oBAAoB,EAAE,CAAC,CAAC;IAC9F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,oBAAoB,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ;QACtD,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,oBAAoB;YACpB,YAAY;SACb,CAAC;QACF,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC;KAC/C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CACtB,OAGE;IAEF,IAAI,OAAO,CAAC,oBAAoB,GAAG,CAAC,EAAE,CAAC;QACrC,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC;gBACZ,IAAI,EAAE,mBAAmB;gBACzB,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,GAAG,OAAO,CAAC,oBAAoB,2IAA2I;aACpL,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,CAAC,iCAAiC,GAAG,CAAC,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,MAAM,CAAC,MAAM,CAAC;gBACZ,IAAI,EAAE,uBAAuB;gBAC7B,KAAK,EAAE,SAAS;gBAChB,OAAO,EAAE,GAAG,OAAO,CAAC,iCAAiC,2IAA2I;aACjM,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC3B,CAAC","sourcesContent":["import type { CheckMessage, CheckResult } from \"../../check/check.ts\";\n\nexport const FINDING_POLICIES = Object.freeze([\"blocking\", \"non-blocking\"] as const);\n\n/** package-provided Check 用于结算 normal finding 的阻断策略。 */\nexport type FindingPolicy = (typeof FINDING_POLICIES)[number];\n\nexport const DEFAULT_FINDING_POLICY: FindingPolicy = \"non-blocking\";\n\n/** 三个代码质量 Check 正常完成时返回的精确 finding 计数。 */\nexport interface FindingSummary {\n  readonly blockingFindingCount: number;\n  readonly findingCount: number;\n}\n\n/** 一项 finding 在 Check 自己结算前的领域中性处置。 */\nexport interface FindingSettlement {\n  /** 该 finding 是否仍需要进入该 Check 的正常 finding 结算。 */\n  readonly actionable: boolean;\n  readonly blocking: boolean;\n}\n\nexport function resolveFindingPolicy(\n  value: unknown,\n  fallback: FindingPolicy = DEFAULT_FINDING_POLICY\n): FindingPolicy | undefined {\n  if (value === undefined) return fallback;\n  return FINDING_POLICIES.find((policy) => policy === value);\n}\n\nexport function validFindingPolicy(value: unknown): value is FindingPolicy {\n  return FINDING_POLICIES.some((policy) => policy === value);\n}\n\nexport function isBlockingFinding(policies: readonly FindingPolicy[]): boolean {\n  return policies.some((policy) => policy === \"blocking\");\n}\n\nexport function settleFindings(\n  findings: readonly FindingSettlement[]\n): CheckResult<FindingSummary> {\n  const blockingFindingCount = findings.filter(\n    (finding) => finding.actionable && finding.blocking\n  ).length;\n  const findingCount = findings.length;\n  const actionableNonBlockingFindingCount = findings.filter(\n    (finding) => finding.actionable && !finding.blocking\n  ).length;\n  const messages = findingMessages({ actionableNonBlockingFindingCount, blockingFindingCount });\n  return Object.freeze({\n    status: blockingFindingCount > 0 ? \"failed\" : \"passed\",\n    data: Object.freeze({\n      blockingFindingCount,\n      findingCount\n    }),\n    ...(messages.length === 0 ? {} : { messages })\n  });\n}\n\nfunction findingMessages(\n  summary: Readonly<{\n    readonly actionableNonBlockingFindingCount: number;\n    readonly blockingFindingCount: number;\n  }>\n): readonly CheckMessage[] {\n  if (summary.blockingFindingCount > 0) {\n    return Object.freeze([\n      Object.freeze({\n        code: \"blocking-findings\",\n        level: \"error\",\n        message: `${summary.blockingFindingCount} blocking finding(s) require attention; inspect this Check's Records for affected paths and measurements, then update the code or policy.`\n      })\n    ]);\n  }\n  if (summary.actionableNonBlockingFindingCount > 0) {\n    return Object.freeze([\n      Object.freeze({\n        code: \"non-blocking-findings\",\n        level: \"warning\",\n        message: `${summary.actionableNonBlockingFindingCount} non-blocking finding(s) were recorded; inspect this Check's Records for affected paths and measurements, then update the code or policy.`\n      })\n    ]);\n  }\n  return Object.freeze([]);\n}\n"]}
+{"version":3,"file":"policy.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/policy.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckMessage, CheckResult } from \"../../check/check.ts\";\nimport { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isNonEmptyString } from \"../../data-boundary/value-shapes.ts\";\n\nexport const FINDING_POLICIES = Object.freeze([\"blocking\", \"non-blocking\"] as const);\n\n/** package-provided Check 用于结算 normal finding 的阻断策略。 */\nexport type FindingPolicy = (typeof FINDING_POLICIES)[number];\n\nexport const DEFAULT_FINDING_POLICY: FindingPolicy = \"non-blocking\";\n\n/** 三个代码质量 Check 正常完成时返回的精确 finding 计数。 */\nexport interface FindingSummary {\n  /** 仍可处置且采用 blocking policy 的 finding 数；waived finding 不计入。 */\n  readonly blockingFindingCount: number;\n  /** Check 发现的全部 finding 数，包括已 waived 或 non-blocking 的 finding。 */\n  readonly findingCount: number;\n}\n\n/** 一项 finding 在 Check 自己结算前的领域中性处置。 */\nexport interface FindingSettlement {\n  /** 该 finding 是否仍需要进入该 Check 的正常 finding 结算。 */\n  readonly actionable: boolean;\n  readonly blocking: boolean;\n}\n\nexport function resolveFindingPolicy(\n  value: unknown,\n  fallback: FindingPolicy = DEFAULT_FINDING_POLICY\n): FindingPolicy | undefined {\n  if (value === undefined) return fallback;\n  return FINDING_POLICIES.find((policy) => policy === value);\n}\n\nexport function validFindingPolicy(value: unknown): value is FindingPolicy {\n  return FINDING_POLICIES.some((policy) => policy === value);\n}\n\n/** Resolves the closed, non-empty named area map shared by code-quality Checks. */\nexport function resolveCodeAreaPolicyMap<Area>(\n  value: unknown,\n  defaultArea: () => Area,\n  resolveArea: (candidate: unknown) => Area | undefined\n): Readonly<Record<string, Area>> | undefined {\n  if (value === undefined) return Object.freeze({ project: defaultArea() });\n  const areas = snapshotClosedRecord(value);\n  if (areas === undefined || Object.keys(areas).length === 0) return undefined;\n  const resolvedEntries: Array<readonly [string, Area]> = [];\n  for (const [areaId, candidate] of Object.entries(areas)) {\n    if (!isNonEmptyString(areaId)) return undefined;\n    const area = resolveArea(candidate);\n    if (area === undefined) return undefined;\n    resolvedEntries.push([areaId, area]);\n  }\n  return Object.freeze(Object.fromEntries(resolvedEntries));\n}\n\nexport function isBlockingFinding(policies: readonly FindingPolicy[]): boolean {\n  return policies.some((policy) => policy === \"blocking\");\n}\n\nexport function settleFindings(\n  findings: readonly FindingSettlement[]\n): CheckResult<FindingSummary> {\n  const blockingFindingCount = findings.filter(\n    (finding) => finding.actionable && finding.blocking\n  ).length;\n  const findingCount = findings.length;\n  const actionableNonBlockingFindingCount = findings.filter(\n    (finding) => finding.actionable && !finding.blocking\n  ).length;\n  const messages = findingMessages({ actionableNonBlockingFindingCount, blockingFindingCount });\n  return Object.freeze({\n    status: blockingFindingCount > 0 ? \"failed\" : \"passed\",\n    data: Object.freeze({\n      blockingFindingCount,\n      findingCount\n    }),\n    ...(messages.length === 0 ? {} : { messages })\n  });\n}\n\nfunction findingMessages(\n  summary: Readonly<{\n    readonly actionableNonBlockingFindingCount: number;\n    readonly blockingFindingCount: number;\n  }>\n): readonly CheckMessage[] {\n  if (summary.blockingFindingCount > 0) {\n    return Object.freeze([\n      Object.freeze({\n        code: \"blocking-findings\",\n        level: \"error\",\n        message: `${summary.blockingFindingCount} blocking finding(s) require attention; inspect this Check's Records for affected paths and measurements, then update the code or policy.`\n      })\n    ]);\n  }\n  if (summary.actionableNonBlockingFindingCount > 0) {\n    return Object.freeze([\n      Object.freeze({\n        code: \"non-blocking-findings\",\n        level: \"warning\",\n        message: `${summary.actionableNonBlockingFindingCount} non-blocking finding(s) were recorded; inspect this Check's Records for affected paths and measurements, then update the code or policy.`\n      })\n    ]);\n  }\n  return Object.freeze([]);\n}\n"]}

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

@@ -1,5 +1,5 @@
 import { isValidDuplicateFragment } from "./records.mjs";
-/** Restores every matching code area and applies the strictest involved policy. */
+/** Retains fragments whose locations share an area and applies its strictest policy. */
 export function applyDuplicateAreaPolicy(fragments, areas) {
     const policiesByPath = buildPathPolicies(areas);
     const accepted = [];
@@ -9,6 +9,8 @@ export function applyDuplicateAreaPolicy(fragments, areas) {
         const annotated = annotateFragment(fragment, policiesByPath);
         if (annotated === undefined)
             return undefined;
+        if (annotated.kind === "outside-common-area")
+            continue;
         if (annotated.fragment.lineCount >= annotated.requiredMinimumLines &&
             annotated.fragment.tokenCount >= annotated.requiredMinimumTokens) {
             accepted.push(annotated.fragment);
@@ -33,7 +35,7 @@ function buildPathPolicies(areas) {
 }
 function annotateFragment(fragment, policiesByPath) {
     const locations = [];
-    const involvedPolicies = [];
+    let commonPolicies;
     for (const location of fragment.locations) {
         const pathPolicies = policiesByPath.get(location.path);
         if (pathPolicies === undefined || pathPolicies.length === 0)
@@ -43,19 +45,25 @@ function annotateFragment(fragment, policiesByPath) {
             path: location.path,
             startLine: location.startLine
         }));
-        involvedPolicies.push(...pathPolicies);
+        commonPolicies =
+            commonPolicies === undefined
+                ? pathPolicies
+                : commonPolicies.filter((policy) => pathPolicies.some((candidate) => candidate.codeArea === policy.codeArea));
     }
-    if (involvedPolicies.length === 0)
+    if (commonPolicies === undefined)
         return undefined;
+    if (commonPolicies.length === 0)
+        return Object.freeze({ kind: "outside-common-area" });
     const annotatedFragment = Object.freeze({
         ...fragment,
-        codeAreas: Object.freeze(uniqueSorted(involvedPolicies.map((policy) => policy.codeArea))),
+        codeAreas: Object.freeze(uniqueSorted(commonPolicies.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))
+        kind: "comparable",
+        requiredMinimumLines: Math.max(...commonPolicies.map((policy) => policy.minimumLines)),
+        requiredMinimumTokens: Math.max(...commonPolicies.map((policy) => policy.minimumTokens))
     });
 }
 function uniqueSorted(values) {

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

@@ -1 +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"]}
+{"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 FragmentAnnotation =\n  | Readonly<{\n      fragment: DuplicateCodeFragment;\n      kind: \"comparable\";\n      requiredMinimumLines: number;\n      requiredMinimumTokens: number;\n    }>\n  | Readonly<{ kind: \"outside-common-area\" }>;\n\n/** Retains fragments whose locations share an area and applies its strictest 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 (annotated.kind === \"outside-common-area\") continue;\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): FragmentAnnotation | undefined {\n  const locations: DuplicateCodeLocation[] = [];\n  let commonPolicies: readonly PathPolicy[] | undefined;\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    commonPolicies =\n      commonPolicies === undefined\n        ? pathPolicies\n        : commonPolicies.filter((policy) =>\n            pathPolicies.some((candidate) => candidate.codeArea === policy.codeArea)\n          );\n  }\n  if (commonPolicies === undefined) return undefined;\n  if (commonPolicies.length === 0) return Object.freeze({ kind: \"outside-common-area\" });\n\n  const annotatedFragment = Object.freeze({\n    ...fragment,\n    codeAreas: Object.freeze(uniqueSorted(commonPolicies.map((policy) => policy.codeArea))),\n    locations: Object.freeze(locations)\n  });\n  return Object.freeze({\n    fragment: annotatedFragment,\n    kind: \"comparable\",\n    requiredMinimumLines: Math.max(...commonPolicies.map((policy) => policy.minimumLines)),\n    requiredMinimumTokens: Math.max(...commonPolicies.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/identity.mjs

@@ -1,5 +1,5 @@
 import { isPackageJscpdCommand } from "../jscpd/command-resolution.mjs";
-const RAW_SCAN_CONFIGURATION_VERSION = "3";
+const RAW_SCAN_CONFIGURATION_VERSION = "4";
 export function createDuplicateScanCacheIdentity(input) {
     return Object.freeze({
         toolName: "jscpd",

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

@@ -1 +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"]}
+{"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 = \"4\";\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/default-check.mjs

@@ -13,7 +13,7 @@ import { validResolvedDuplicateDetectionOptions } from "./options-validation.mjs
 export function duplicateDetection(options = {}) {
     const resolvedOptions = resolveDuplicateDetectionOptions(options);
     if (resolvedOptions === undefined) {
-        throw new TypeError("duplicateDetection options are invalid; use the documented closed constructor policy");
+        throw new TypeError("duplicateDetection options are invalid; use the documented closed constructor policy including exact finding waivers");
     }
     return defineCheck({
         ...DUPLICATE_DETECTION_CHECK_DEFINITION,

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

@@ -1 +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"]}
+{"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,sHAAsH,CACvH,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 including exact finding waivers\"\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

@@ -1,11 +1,15 @@
 import { resolve } from "node:path";
+import { reconcileFindingWaivers } from "../../finding-waivers/reconciliation.mjs";
 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 { reportFindingWaiverAudits, reportReconciledCodeQualityFindingRecords } from "../code-quality-findings/finding-waiver-evidence.mjs";
+import { appendCheckMessages } from "../../check/finding-presentation.mjs";
+import { duplicateFindingMessages, duplicateWaiverMessages } from "./finding-messages.mjs";
 import { getGitSha } from "./project-revision.mjs";
 import { measureDuplicateDetection } from "./measurement.mjs";
 import { validResolvedDuplicateDetectionOptions } from "./options-validation.mjs";
-import { buildDuplicateRecordCandidates } from "./records.mjs";
+import { buildDuplicateRecordCandidates, duplicateDetectionFindingIdentity, duplicateDetectionWaiverAuditRecord } from "./records.mjs";
 export const DUPLICATE_DETECTION_CHECK_DEFINITION = {
     checkId: "duplicate-detection",
     displayName: "Duplicate detection"
@@ -22,7 +26,7 @@ export async function executeDuplicateDetection(context) {
         return unavailable("source-unavailable");
     }
     if (exactInput.approvedExactPaths.length < 2) {
-        return Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } });
+        return noEligibleDuplicateInputResult(context);
     }
     const measurement = await measureDuplicateDetection({
         cache: context.options.cache,
@@ -34,10 +38,32 @@ export async function executeDuplicateDetection(context) {
     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 })));
+    const reconciliation = reconcileDuplicateFindingWaivers(candidates, context.options.findingWaivers);
+    reportReconciledCodeQualityFindingRecords(context, reconciliation);
+    reportFindingWaiverAudits(context, reconciliation, duplicateDetectionWaiverAuditRecord);
+    return settleDuplicateFindings(reconciliation);
+}
+function noEligibleDuplicateInputResult(context) {
+    const reconciliation = reconcileDuplicateFindingWaivers([], context.options.findingWaivers);
+    reportFindingWaiverAudits(context, reconciliation, duplicateDetectionWaiverAuditRecord);
+    return appendCheckMessages(Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } }), duplicateWaiverMessages(reconciliation));
+}
+function reconcileDuplicateFindingWaivers(candidates, waivers) {
+    return reconcileFindingWaivers({
+        findings: candidates,
+        identify: duplicateDetectionFindingIdentity,
+        waivers
+    });
+}
+function settleDuplicateFindings(reconciliation) {
+    const settlement = settleFindings(reconciliation.findings.map((finding) => ({
+        actionable: finding.disposition !== "waived",
+        blocking: finding.finding.data.blocking
+    })));
+    const actionableCandidates = reconciliation.findings
+        .filter(({ disposition }) => disposition !== "waived")
+        .map(({ finding }) => finding);
+    return appendCheckMessages(appendCheckMessages(settlement, duplicateFindingMessages(actionableCandidates)), duplicateWaiverMessages(reconciliation));
 }
 function prepareExactInputSet(rootDir, options) {
     const areas = collectAreaInputs(rootDir, options.codeAreas);
@@ -56,21 +82,21 @@ function prepareExactInputSet(rootDir, options) {
     });
 }
 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) {
+    return Object.freeze(orderedPolicies.flatMap(([codeArea, policy]) => {
         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);
+        return approvedExactPaths.length === 0
+            ? []
+            : [
+                Object.freeze({
+                    approvedExactPaths: Object.freeze(approvedExactPaths),
+                    codeArea,
+                    minimumLines: policy.minimumLines,
+                    minimumTokens: policy.minimumTokens
+                })
+            ];
+    }));
 }
 function uniqueSorted(values) {
     return [...new Set(values)].sort(compareText);

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

@@ -1 +1 @@
-{"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/execution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAGpC,OAAO,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAmC,MAAM,kBAAkB,CAAC;AAM9F,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAC;AACjF,OAAO,EAAE,8BAA8B,EAAE,MAAM,cAAc,CAAC;AAG9D,MAAM,CAAC,MAAM,oCAAoC,GAAG;IAClD,OAAO,EAAE,qBAAqB;IAC9B,WAAW,EAAE,qBAAqB;CAC1B,CAAC;AAWX,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,OAAiE;IAEjE,IAAI,CAAC,sCAAsC,CAAC,OAAO,CAAC,OAAO,CAAC;QAC1D,OAAO,WAAW,CAAC,iBAAiB,CAAC,CAAC;IAExC,IAAI,UAA2C,CAAC;IAChD,IAAI,CAAC;QACH,UAAU,GAAG,oBAAoB,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;IAC3C,CAAC;IACD,IAAI,UAAU,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,MAAM,WAAW,GAAG,MAAM,yBAAyB,CAAC;QAClD,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,KAAK;QAC5B,UAAU,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO;QACnC,UAAU;KACX,CAAC,CAAC;IACH,IAAI,WAAW,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,wBAAwB,CAAC,WAAW,CAAC,CAAC;IAClF,MAAM,UAAU,GAAG,8BAA8B,CAC/C,WAAW,CAAC,SAAS,EACrB,OAAO,CAAC,OAAO,CAAC,SAAS,CAC1B,CAAC;IACF,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,WAAW,CAAC,yBAAyB,CAAC,CAAC;IAC5E,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/D,CAAC;IACD,OAAO,cAAc,CACnB,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CACzF,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAC3B,OAAe,EACf,OAA0C;IAE1C,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,kBAAkB,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,uBAAuB,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IAC9E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC;QACrD,KAAK;QACL,YAAY,EAAE,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC;QACvD,SAAS,EAAE,SAAS,CAAC,OAAO,CAAC;QAC7B,gBAAgB,EAAE,MAAM,CAAC,MAAM,CAAC;YAC9B,GAAG,gBAAgB;YACnB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;SACxD,CAAC;QACF,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CACxB,OAAe,EACf,SAAyD;IAEzD,MAAM,KAAK,GAAkC,EAAE,CAAC;IAChD,MAAM,eAAe,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CACzE,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CACzB,CAAC;IACF,MAAM,WAAW,GAAG,sBAAsB,CACxC,OAAO,EACP,MAAM,CAAC,WAAW,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CACtF,CAAC;IACF,KAAK,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,eAAe,EAAE,CAAC;QACjD,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;QACxE,IAAI,kBAAkB,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAC9C,KAAK,CAAC,IAAI,CACR,MAAM,CAAC,MAAM,CAAC;YACZ,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC;YACrD,QAAQ;YACR,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC,CACH,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,YAAY,CAAC,MAAyB;IAC7C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAS,wBAAwB,CAC/B,WAAsE;IAEtE,QAAQ,WAAW,CAAC,IAAI,EAAE,CAAC;QACzB,KAAK,oBAAoB;YACvB,OAAO,WAAW,CAAC,oBAAoB,CAAC,CAAC;QAC3C,KAAK,kBAAkB;YACrB,OAAO,WAAW,CAAC,2BAA2B,CAAC,CAAC;QAClD,KAAK,gBAAgB;YACnB,OAAO,WAAW,CAAC,yBAAyB,CAAC,CAAC;QAChD,KAAK,aAAa;YAChB,OAAO,WAAW,CAAC,iCAAiC,CAAC,CAAC;IAC1D,CAAC;IACD,MAAM,qBAAqB,GAAU,WAAW,CAAC;IACjD,OAAO,qBAAqB,CAAC;AAC/B,CAAC;AAED,SAAS,WAAW,CAClB,IAA6C;IAE7C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,aAAa;QACrB,MAAM,EAAE,EAAE,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC;YACtB,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,OAAgB,EAAE,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,EAAE,CAAC;SACpF,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CAAC,IAA6C;IACvE,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,iBAAiB;YACpB,OAAO,uIAAuI,CAAC;QACjJ,KAAK,oBAAoB;YACvB,OAAO,yIAAyI,CAAC;QACnJ,KAAK,iCAAiC;YACpC,OAAO,mIAAmI,CAAC;QAC7I,KAAK,2BAA2B;YAC9B,OAAO,uGAAuG,CAAC;QACjH,KAAK,yBAAyB;YAC5B,OAAO,gGAAgG,CAAC;QAC1G,KAAK,oBAAoB;YACvB,OAAO,yHAAyH,CAAC;IACrI,CAAC;AACH,CAAC","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"]}
+{"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 {\n  reconcileFindingWaivers,\n  type FindingWaiverReconciliation\n} from \"../../finding-waivers/reconciliation.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 {\n  reportFindingWaiverAudits,\n  reportReconciledCodeQualityFindingRecords\n} from \"../code-quality-findings/finding-waiver-evidence.ts\";\nimport { appendCheckMessages } from \"../../check/finding-presentation.ts\";\nimport { duplicateFindingMessages, duplicateWaiverMessages } from \"./finding-messages.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 {\n  DuplicateDetectionFindingWaiver,\n  ResolvedDuplicateDetectionOptions\n} from \"./options.ts\";\nimport { validResolvedDuplicateDetectionOptions } from \"./options-validation.ts\";\nimport {\n  buildDuplicateRecordCandidates,\n  duplicateDetectionFindingIdentity,\n  duplicateDetectionWaiverAuditRecord,\n  type DuplicateRecordCandidate\n} 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 noEligibleDuplicateInputResult(context);\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  const reconciliation = reconcileDuplicateFindingWaivers(\n    candidates,\n    context.options.findingWaivers\n  );\n  reportReconciledCodeQualityFindingRecords(context, reconciliation);\n  reportFindingWaiverAudits(context, reconciliation, duplicateDetectionWaiverAuditRecord);\n  return settleDuplicateFindings(reconciliation);\n}\n\nfunction noEligibleDuplicateInputResult(\n  context: CheckExecutionContext<ResolvedDuplicateDetectionOptions>\n): CheckResult<DuplicateDetectionFinalData> {\n  const reconciliation = reconcileDuplicateFindingWaivers([], context.options.findingWaivers);\n  reportFindingWaiverAudits(context, reconciliation, duplicateDetectionWaiverAuditRecord);\n  return appendCheckMessages(\n    Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } }),\n    duplicateWaiverMessages(reconciliation)\n  );\n}\n\nfunction reconcileDuplicateFindingWaivers(\n  candidates: readonly DuplicateRecordCandidate[],\n  waivers: readonly DuplicateDetectionFindingWaiver[]\n): FindingWaiverReconciliation<DuplicateRecordCandidate> {\n  return reconcileFindingWaivers({\n    findings: candidates,\n    identify: duplicateDetectionFindingIdentity,\n    waivers\n  });\n}\n\nfunction settleDuplicateFindings(\n  reconciliation: FindingWaiverReconciliation<DuplicateRecordCandidate>\n): CheckResult<DuplicateDetectionFinalData> {\n  const settlement = settleFindings(\n    reconciliation.findings.map((finding) => ({\n      actionable: finding.disposition !== \"waived\",\n      blocking: finding.finding.data.blocking\n    }))\n  );\n  const actionableCandidates = reconciliation.findings\n    .filter(({ disposition }) => disposition !== \"waived\")\n    .map(({ finding }) => finding);\n  return appendCheckMessages(\n    appendCheckMessages(settlement, duplicateFindingMessages(actionableCandidates)),\n    duplicateWaiverMessages(reconciliation)\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 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  return Object.freeze(\n    orderedPolicies.flatMap(([codeArea, policy]) => {\n      const approvedExactPaths = requireProjectFileSet(filesByArea, codeArea);\n      return approvedExactPaths.length === 0\n        ? []\n        : [\n            Object.freeze({\n              approvedExactPaths: Object.freeze(approvedExactPaths),\n              codeArea,\n              minimumLines: policy.minimumLines,\n              minimumTokens: policy.minimumTokens\n            })\n          ];\n    })\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\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/finding-messages.mjs

@@ -0,0 +1,59 @@
+import { presentCheckFindings } from "../../check/finding-presentation.mjs";
+import { duplicateDetectionWaiverIdentity } from "./records.mjs";
+const PRESENTED_FINDING_LIMIT = 10;
+/** Projects duplicate Records into bounded, project-relative terminal summaries. */
+export function duplicateFindingMessages(candidates) {
+    return presentCheckFindings({
+        findings: candidates,
+        limit: PRESENTED_FINDING_LIMIT,
+        message: ({ data }) => Object.freeze({
+            code: "finding-detail",
+            level: data.blocking ? "error" : "warning",
+            message: `Duplicate fragment contains ${data.tokenCount} tokens across ${data.lineCount} lines at ${duplicateLocationSummary(data.locations)}.`
+        }),
+        omittedMessage: ({ omittedCount, omittedFindings }) => Object.freeze({
+            code: "findings-omitted",
+            level: omittedFindings.some(({ data }) => data.blocking)
+                ? "error"
+                : "warning",
+            message: `${omittedCount} additional duplicate finding(s) were not shown; inspect this Check's Records for the complete set.`
+        })
+    });
+}
+/** 将每项 duplicate-detection waiver audit 投影为可行动的 terminal message。 */
+export function duplicateWaiverMessages(reconciliation) {
+    return Object.freeze(reconciliation.waiverAudits.map(duplicateWaiverMessage));
+}
+function duplicateWaiverMessage(audit) {
+    const identity = duplicateDetectionWaiverIdentity(audit.waiver);
+    const subject = duplicateLocationSummary(identity.locations);
+    switch (audit.status) {
+        case "applied":
+            return Object.freeze({
+                code: "finding-waived",
+                level: "info",
+                message: `Duplicate finding at ${subject} was waived: ${audit.waiver.reason}`
+            });
+        case "unused":
+            return Object.freeze({
+                code: "unused-finding-waiver",
+                level: "warning",
+                message: `Configured duplicate-detection finding waiver at ${subject} matched no finding; remove it or update its identity. Reason: ${audit.waiver.reason}`
+            });
+        case "overmatched":
+            return Object.freeze({
+                code: "overmatched-finding-waiver",
+                level: "warning",
+                message: `Configured duplicate-detection finding waiver at ${subject} matched ${audit.matchCount} findings and was not applied; narrow its identity. Reason: ${audit.waiver.reason}`
+            });
+    }
+}
+function duplicateLocationSummary(locations) {
+    const presented = locations
+        .slice(0, 2)
+        .map(({ endLine, path, startLine }) => `${path}:${startLine}-${endLine}`)
+        .join(", ");
+    const omitted = locations.length - 2;
+    return omitted > 0 ? `${presented}, and ${omitted} more location(s)` : presented;
+}
+//# sourceMappingURL=finding-messages.mjs.map

package/dist/esm/package-checks/duplicate-detection/finding-messages.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"finding-messages.mjs","sourceRoot":"","sources":["../../../../src/package-checks/duplicate-detection/finding-messages.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckMessage } from \"../../check/check.ts\";\nimport { presentCheckFindings } from \"../../check/finding-presentation.ts\";\nimport type {\n  FindingWaiverAudit,\n  FindingWaiverReconciliation\n} from \"../../finding-waivers/reconciliation.ts\";\nimport type { DuplicateDetectionFindingLocation } from \"./options.ts\";\nimport { duplicateDetectionWaiverIdentity, type DuplicateRecordCandidate } from \"./records.ts\";\n\nconst PRESENTED_FINDING_LIMIT = 10;\n\n/** Projects duplicate Records into bounded, project-relative terminal summaries. */\nexport function duplicateFindingMessages(\n  candidates: readonly DuplicateRecordCandidate[]\n): readonly CheckMessage[] {\n  return presentCheckFindings({\n    findings: candidates,\n    limit: PRESENTED_FINDING_LIMIT,\n    message: ({ data }) =>\n      Object.freeze({\n        code: \"finding-detail\",\n        level: data.blocking ? (\"error\" as const) : (\"warning\" as const),\n        message: `Duplicate fragment contains ${data.tokenCount} tokens across ${data.lineCount} lines at ${duplicateLocationSummary(data.locations)}.`\n      }),\n    omittedMessage: ({ omittedCount, omittedFindings }) =>\n      Object.freeze({\n        code: \"findings-omitted\",\n        level: omittedFindings.some(({ data }) => data.blocking)\n          ? (\"error\" as const)\n          : (\"warning\" as const),\n        message: `${omittedCount} additional duplicate finding(s) were not shown; inspect this Check's Records for the complete set.`\n      })\n  });\n}\n\n/** 将每项 duplicate-detection waiver audit 投影为可行动的 terminal message。 */\nexport function duplicateWaiverMessages(\n  reconciliation: FindingWaiverReconciliation<DuplicateRecordCandidate>\n): readonly CheckMessage[] {\n  return Object.freeze(reconciliation.waiverAudits.map(duplicateWaiverMessage));\n}\n\nfunction duplicateWaiverMessage(audit: FindingWaiverAudit): CheckMessage {\n  const identity = duplicateDetectionWaiverIdentity(audit.waiver);\n  const subject = duplicateLocationSummary(identity.locations);\n  switch (audit.status) {\n    case \"applied\":\n      return Object.freeze({\n        code: \"finding-waived\",\n        level: \"info\",\n        message: `Duplicate finding at ${subject} was waived: ${audit.waiver.reason}`\n      });\n    case \"unused\":\n      return Object.freeze({\n        code: \"unused-finding-waiver\",\n        level: \"warning\",\n        message: `Configured duplicate-detection finding waiver at ${subject} matched no finding; remove it or update its identity. Reason: ${audit.waiver.reason}`\n      });\n    case \"overmatched\":\n      return Object.freeze({\n        code: \"overmatched-finding-waiver\",\n        level: \"warning\",\n        message: `Configured duplicate-detection finding waiver at ${subject} matched ${audit.matchCount} findings and was not applied; narrow its identity. Reason: ${audit.waiver.reason}`\n      });\n  }\n}\n\nfunction duplicateLocationSummary(locations: readonly DuplicateDetectionFindingLocation[]): string {\n  const presented = locations\n    .slice(0, 2)\n    .map(({ endLine, path, startLine }) => `${path}:${startLine}-${endLine}`)\n    .join(\", \");\n  const omitted = locations.length - 2;\n  return omitted > 0 ? `${presented}, and ${omitted} more location(s)` : presented;\n}\n"]}