npm - @zxyycom/vibe-check - Versions diffs - 0.0.1 → 0.0.3 - Mend

@zxyycom/vibe-check 0.0.1 → 0.0.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1190) hide show

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1 @@

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

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

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

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

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

package/dist/esm/package-checks/file-metrics/options-validation.mjs CHANGED Viewed

@@ -1,10 +1,15 @@
-import { snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { snapshotClosedArray, snapshotClosedRecord, snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString, isNonNegativeSafeInteger, isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
 import { validProjectFileSelection } from "../project-files/configuration.mjs";
 import { validFindingPolicy } from "../code-quality-findings/policy.mjs";
 import { isNormalizedProjectRelativePath } from "../host-environment/path.mjs";
 /** 验证 constructor 产物或普通对象组合形成的完整 file-metrics options。 */
 export function isValidResolvedFileMetricsOptions(resolvedOptions) {
-    const options = exactRecord(resolvedOptions, ["codeAreas", "findingWaivers", "scanner"]);
+    const options = snapshotExactClosedRecord(resolvedOptions, [
+        "codeAreas",
+        "findingWaivers",
+        "scanner"
+    ]);
     return (options !== undefined &&
         isValidCodeAreas(options.codeAreas) &&
         isValidFindingWaivers(options.findingWaivers) &&
@@ -16,8 +21,10 @@ function isValidFindingWaivers(value) {
         return false;
     const identities = new Set();
     for (const candidate of waivers) {
-        const waiver = exactRecord(candidate, ["identity", "reason"]);
-        const identity = waiver === undefined ? undefined : exactRecord(waiver.identity, ["metric", "path"]);
+        const waiver = snapshotExactClosedRecord(candidate, ["identity", "reason"]);
+        const identity = waiver === undefined
+            ? undefined
+            : snapshotExactClosedRecord(waiver.identity, ["metric", "path"]);
         if (waiver === undefined ||
             identity === undefined ||
             identity.metric !== "code-lines" ||
@@ -39,17 +46,17 @@ function isValidCodeAreas(value) {
     return Object.entries(codeAreas).every(([areaId, candidate]) => areaId.length > 0 && isValidCodeArea(candidate));
 }
 function isValidCodeArea(value) {
-    const area = exactRecord(value, ["codeLines", "files", "findingPolicy"]);
+    const area = snapshotExactClosedRecord(value, ["codeLines", "files", "findingPolicy"]);
     return (area !== undefined &&
         validProjectFileSelection(area.files) &&
         validFindingPolicy(area.findingPolicy) &&
         isValidCodeLinePolicy(area.codeLines));
 }
 function isValidCodeLinePolicy(value) {
-    const policy = exactRecord(value, ["lowDecisionTokenAllowance", "maximum"]);
+    const policy = snapshotExactClosedRecord(value, ["lowDecisionTokenAllowance", "maximum"]);
     if (policy === undefined || !isPositiveSafeInteger(policy.maximum))
         return false;
-    const allowance = exactRecord(policy.lowDecisionTokenAllowance, [
+    const allowance = snapshotExactClosedRecord(policy.lowDecisionTokenAllowance, [
         "maximumCodeLines",
         "maximumDecisionTokens"
     ]);
@@ -59,24 +66,7 @@ function isValidCodeLinePolicy(value) {
         isNonNegativeSafeInteger(allowance.maximumDecisionTokens));
 }
 function isValidScanner(value) {
-    const scanner = exactRecord(value, ["executable"]);
+    const scanner = snapshotExactClosedRecord(value, ["executable"]);
     return scanner !== undefined && isNonEmptyString(scanner.executable);
 }
-function exactRecord(value, keys) {
-    const record = snapshotClosedRecord(value);
-    return record !== undefined &&
-        Object.keys(record).length === keys.length &&
-        keys.every((key) => Object.hasOwn(record, key))
-        ? record
-        : undefined;
-}
-function isPositiveSafeInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
-}
-function isNonNegativeSafeInteger(value) {
-    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
-}
-function isNonEmptyString(value) {
-    return typeof value === "string" && value.length > 0;
-}
 //# sourceMappingURL=options-validation.mjs.map