@zxyycom/vibe-check 0.0.1

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

@@ -0,0 +1,170 @@
+import { reconcileFindingWaivers } from "../../finding-waivers/reconciliation.mjs";
+import { collectProjectFileSets, requireProjectFileSet } from "../project-files/collection.mjs";
+import { settleFindings } from "../code-quality-findings/policy.mjs";
+import { measureFileMetrics } from "./measurement.mjs";
+import { isValidResolvedFileMetricsOptions } from "./options-validation.mjs";
+import { buildFileRecordCandidates, fileMetricsWaiverAuditRecord, fileMetricsWaiverIdentity } from "./records.mjs";
+export const FILE_METRICS_CHECK_DEFINITION = {
+    checkId: "file-metrics",
+    displayName: "File metrics"
+};
+/** 使用 resolved area policy 和 scanner selection 执行一次完整的 file-metrics measurement。 */
+export async function executeFileMetrics(context) {
+    if (!isValidResolvedFileMetricsOptions(context.options))
+        return unavailable("invalid-options");
+    let collectedScope;
+    try {
+        collectedScope = collectAreaScope(context.project.root, context.options.codeAreas);
+    }
+    catch {
+        return unavailable("source-unavailable");
+    }
+    if (collectedScope.approvedExactPaths.length === 0) {
+        return noEligibleInputResult(context);
+    }
+    const measurement = await measureFileMetrics(collectedScope, context.options.scanner);
+    if (measurement.kind !== "complete")
+        return measurementFailureResult(measurement);
+    const candidates = buildFileRecordCandidates(measurement.metrics, {
+        areaIdsByPath: collectedScope.areaIdsByPath,
+        codeAreas: context.options.codeAreas
+    });
+    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);
+    }
+    reportWaiverAuditRecords(context, reconciliation);
+    const settlement = settleFindings(reconciliation.findings.map(({ disposition, finding }) => ({
+        actionable: disposition !== "waived",
+        blocking: finding.data.blocking
+    })));
+    return appendWaiverMessages(settlement, reconciliation);
+}
+function noEligibleInputResult(context) {
+    const reconciliation = reconcileFileMetricWaivers([], context.options.findingWaivers);
+    reportWaiverAuditRecords(context, reconciliation);
+    return appendWaiverMessages(Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } }), reconciliation);
+}
+function reconcileFileMetricWaivers(candidates, waivers) {
+    return reconcileFindingWaivers({
+        findings: candidates,
+        identify: ({ data }) => ({ metric: data.metric, path: data.path }),
+        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);
+    }
+}
+function appendWaiverMessages(settlement, reconciliation) {
+    const waiverMessages = [];
+    for (const audit of reconciliation.waiverAudits) {
+        const identity = fileMetricsWaiverIdentity(audit.waiver);
+        switch (audit.status) {
+            case "applied":
+                waiverMessages.push(Object.freeze({
+                    code: "finding-waived",
+                    level: "info",
+                    message: `File metric finding for ${identity.path} was waived: ${audit.waiver.reason}`
+                }));
+                break;
+            case "unused":
+                waiverMessages.push(Object.freeze({
+                    code: "unused-finding-waiver",
+                    level: "warning",
+                    message: `Configured file-metrics finding waiver for ${identity.path} matched no finding; remove it or update its identity. Reason: ${audit.waiver.reason}`
+                }));
+                break;
+            case "overmatched":
+                waiverMessages.push(Object.freeze({
+                    code: "overmatched-finding-waiver",
+                    level: "warning",
+                    message: `Configured file-metrics finding waiver for ${identity.path} matched ${audit.matchCount} findings and was not applied; narrow its identity. Reason: ${audit.waiver.reason}`
+                }));
+                break;
+        }
+    }
+    if (waiverMessages.length === 0)
+        return settlement;
+    return Object.freeze({
+        ...settlement,
+        messages: Object.freeze([...(settlement.messages ?? []), ...waiverMessages])
+    });
+}
+function collectAreaScope(rootDir, codeAreas) {
+    const areaIdsByPath = new Map();
+    const filesByArea = collectProjectFileSets(rootDir, Object.fromEntries(Object.entries(codeAreas).map(([areaId, area]) => [areaId, area.files])));
+    for (const [areaId] of Object.entries(codeAreas)) {
+        for (const path of requireProjectFileSet(filesByArea, areaId)) {
+            const areaIds = areaIdsByPath.get(path);
+            if (areaIds === undefined)
+                areaIdsByPath.set(path, [areaId]);
+            else
+                areaIds.push(areaId);
+        }
+    }
+    const normalizedMembership = new Map();
+    for (const [path, areaIds] of areaIdsByPath) {
+        normalizedMembership.set(path, Object.freeze(areaIds.sort(compareText)));
+    }
+    return Object.freeze({
+        approvedExactPaths: Object.freeze([...normalizedMembership.keys()].sort(compareText)),
+        areaIdsByPath: normalizedMembership,
+        rootDir
+    });
+}
+function measurementFailureResult(measurement) {
+    switch (measurement.kind) {
+        case "execution-failed":
+            return unavailable("external-execution-failed");
+        case "invalid-result":
+            return unavailable("external-result-invalid");
+        case "unavailable":
+            return unavailable("external-dependency-unavailable");
+    }
+    const exhaustiveMeasurement = measurement;
+    return exhaustiveMeasurement;
+}
+function unavailable(code) {
+    return Object.freeze({
+        status: "unavailable",
+        reason: { code },
+        messages: Object.freeze([
+            Object.freeze({ code, level: "error", message: unavailableMessage(code) })
+        ])
+    });
+}
+function unavailableMessage(code) {
+    switch (code) {
+        case "invalid-options":
+            return "fileMetrics options are invalid; recreate the Check with fileMetrics(options) or restore its complete resolved options.";
+        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.";
+        case "external-execution-failed":
+            return "SCC did not complete successfully; run the configured command directly and inspect its environment.";
+        case "external-result-invalid":
+            return "SCC output could not form a trusted complete result; check the executable version and CSV compatibility.";
+    }
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=execution.mjs.map

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

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

package/dist/esm/package-checks/file-metrics/final-data.mjs

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

package/dist/esm/package-checks/file-metrics/final-data.mjs.map

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

package/dist/esm/package-checks/file-metrics/measurement-model.mjs

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

package/dist/esm/package-checks/file-metrics/measurement-model.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"measurement-model.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/measurement-model.ts"],"names":[],"mappings":"","sourcesContent":["export interface FileMetric {\n  readonly codeLines: number;\n  readonly decisionTokens: Readonly<{ readonly source: \"scc\"; readonly value: number | null }>;\n  readonly path: string;\n}\n\nexport interface FileMetricsExactInputSet {\n  readonly approvedExactPaths: readonly string[];\n  readonly rootDir: string;\n}\n"]}

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

@@ -0,0 +1,33 @@
+import { acceptExactInputMeasurements } from "../project-files/exact-input-measurement.mjs";
+import { checkScc } from "./scc/availability.mjs";
+import { scanWithScc } from "./scc/scanner.mjs";
+export async function measureFileMetrics(exactInputs, scanner) {
+    if (exactInputs.approvedExactPaths.length === 0) {
+        return Object.freeze({ kind: "complete", metrics: Object.freeze([]) });
+    }
+    const scannerAvailability = await checkScc(exactInputs.rootDir, scanner);
+    if (!scannerAvailability.available) {
+        return Object.freeze({ kind: "unavailable" });
+    }
+    return runFileScanner(exactInputs, scanner);
+}
+function runFileScanner(exactInputs, scanner) {
+    const scanResult = scanWithScc({
+        cwd: exactInputs.rootDir,
+        scanner,
+        includePaths: exactInputs.approvedExactPaths
+    });
+    if (!scanResult.ok) {
+        return Object.freeze({
+            kind: scanResult.reason === "execution" ? "execution-failed" : "invalid-result"
+        });
+    }
+    const acceptedMeasurements = acceptExactInputMeasurements(scanResult.measurements, exactInputs.approvedExactPaths);
+    return acceptedMeasurements.ok
+        ? Object.freeze({
+            kind: "complete",
+            metrics: Object.freeze([...acceptedMeasurements.payloads])
+        })
+        : Object.freeze({ kind: "invalid-result" });
+}
+//# sourceMappingURL=measurement.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/measurement.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAG3F,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAS/C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,WAAqC,EACrC,OAA0C;IAE1C,IAAI,WAAW,CAAC,kBAAkB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,mBAAmB,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IACzE,IAAI,CAAC,mBAAmB,CAAC,SAAS,EAAE,CAAC;QACnC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC9C,CAAC;AAED,SAAS,cAAc,CACrB,WAAqC,EACrC,OAA0C;IAE1C,MAAM,UAAU,GAAG,WAAW,CAAC;QAC7B,GAAG,EAAE,WAAW,CAAC,OAAO;QACxB,OAAO;QACP,YAAY,EAAE,WAAW,CAAC,kBAAkB;KAC7C,CAAC,CAAC;IACH,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,UAAU,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,gBAAgB;SAChF,CAAC,CAAC;IACL,CAAC;IACD,MAAM,oBAAoB,GAAG,4BAA4B,CACvD,UAAU,CAAC,YAAY,EACvB,WAAW,CAAC,kBAAkB,CAC/B,CAAC;IACF,OAAO,oBAAoB,CAAC,EAAE;QAC5B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,oBAAoB,CAAC,QAAQ,CAAC,CAAC;SAC3D,CAAC;QACJ,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC;AAChD,CAAC","sourcesContent":["import { acceptExactInputMeasurements } from \"../project-files/exact-input-measurement.ts\";\nimport type { FileMetric, FileMetricsExactInputSet } from \"./measurement-model.ts\";\nimport type { ResolvedFileMetricsScannerOptions } from \"./options.ts\";\nimport { checkScc } from \"./scc/availability.ts\";\nimport { scanWithScc } from \"./scc/scanner.ts\";\n\nexport type FileMeasurementResult = Readonly<\n  | { kind: \"complete\"; metrics: readonly FileMetric[] }\n  | { kind: \"execution-failed\" }\n  | { kind: \"invalid-result\" }\n  | { kind: \"unavailable\" }\n>;\n\nexport async function measureFileMetrics(\n  exactInputs: FileMetricsExactInputSet,\n  scanner: ResolvedFileMetricsScannerOptions\n): Promise<FileMeasurementResult> {\n  if (exactInputs.approvedExactPaths.length === 0) {\n    return Object.freeze({ kind: \"complete\", metrics: Object.freeze([]) });\n  }\n  const scannerAvailability = await checkScc(exactInputs.rootDir, scanner);\n  if (!scannerAvailability.available) {\n    return Object.freeze({ kind: \"unavailable\" });\n  }\n  return runFileScanner(exactInputs, scanner);\n}\n\nfunction runFileScanner(\n  exactInputs: FileMetricsExactInputSet,\n  scanner: ResolvedFileMetricsScannerOptions\n): FileMeasurementResult {\n  const scanResult = scanWithScc({\n    cwd: exactInputs.rootDir,\n    scanner,\n    includePaths: exactInputs.approvedExactPaths\n  });\n  if (!scanResult.ok) {\n    return Object.freeze({\n      kind: scanResult.reason === \"execution\" ? \"execution-failed\" : \"invalid-result\"\n    });\n  }\n  const acceptedMeasurements = acceptExactInputMeasurements(\n    scanResult.measurements,\n    exactInputs.approvedExactPaths\n  );\n  return acceptedMeasurements.ok\n    ? Object.freeze({\n        kind: \"complete\",\n        metrics: Object.freeze([...acceptedMeasurements.payloads])\n      })\n    : Object.freeze({ kind: \"invalid-result\" });\n}\n"]}

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

@@ -0,0 +1,171 @@
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { resolveProjectFileSelection, snapshotDefaultProjectFileSelection } from "../project-files/configuration.mjs";
+import { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { isNormalizedProjectRelativePath } from "../host-environment/path.mjs";
+import { isValidResolvedFileMetricsOptions } from "./options-validation.mjs";
+const DEFAULT_EXECUTABLE = "scc";
+const DEFAULT_MAXIMUM_CODE_LINES = 360;
+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, {
+        optional: ["codeAreas", "findingPolicy", "findingWaivers", "scanner"]
+    });
+    if (input === undefined)
+        return undefined;
+    const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);
+    if (findingPolicy === undefined)
+        return undefined;
+    const codeAreas = resolveCodeAreas(input.codeAreas, findingPolicy);
+    const findingWaivers = resolveFindingWaivers(input.findingWaivers);
+    const scanner = resolveScanner(input.scanner);
+    if (codeAreas === undefined || findingWaivers === undefined || scanner === undefined)
+        return undefined;
+    const options = Object.freeze({ codeAreas, findingWaivers, scanner });
+    return isValidResolvedFileMetricsOptions(options) ? options : undefined;
+}
+function resolveFindingWaivers(value) {
+    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 waiver = resolveFindingWaiver(candidate);
+        if (waiver === undefined)
+            return undefined;
+        const identityKey = `${waiver.identity.metric}\u0000${waiver.identity.path}`;
+        if (seenIdentities.has(identityKey))
+            return undefined;
+        seenIdentities.add(identityKey);
+        waivers.push(waiver);
+    }
+    return Object.freeze(waivers);
+}
+function resolveFindingWaiver(value) {
+    const waiver = snapshotPolicyRecord(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"] });
+    return identity === undefined ||
+        identity.metric !== "code-lines" ||
+        !isNormalizedProjectRelativePath(identity.path)
+        ? undefined
+        : 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));
+}
+function defaultCodeArea(findingPolicy) {
+    return Object.freeze({
+        codeLines: defaultCodeLines(),
+        files: snapshotDefaultProjectFileSelection(),
+        findingPolicy
+    });
+}
+function resolveCodeArea(value, defaultFindingPolicy) {
+    const area = snapshotPolicyRecord(value, {
+        optional: ["codeLines", "findingPolicy"],
+        required: ["files"]
+    });
+    if (area === undefined)
+        return undefined;
+    const files = resolveProjectFileSelection(area.files);
+    const findingPolicy = resolveFindingPolicy(area.findingPolicy, defaultFindingPolicy);
+    const codeLines = resolveCodeLines(area.codeLines);
+    return files === undefined || findingPolicy === undefined || codeLines === undefined
+        ? undefined
+        : Object.freeze({ codeLines, files, findingPolicy });
+}
+function resolveCodeLines(value) {
+    if (value === undefined)
+        return defaultCodeLines();
+    const codeLines = snapshotPolicyRecord(value, {
+        optional: ["lowDecisionTokenAllowance", "maximum"]
+    });
+    if (codeLines === undefined)
+        return undefined;
+    const maximum = codeLines.maximum ?? DEFAULT_MAXIMUM_CODE_LINES;
+    const lowDecisionTokenAllowance = resolveAllowance(codeLines.lowDecisionTokenAllowance);
+    if (!isPositiveSafeInteger(maximum) ||
+        lowDecisionTokenAllowance === undefined ||
+        lowDecisionTokenAllowance.maximumCodeLines <= maximum) {
+        return undefined;
+    }
+    return Object.freeze({ lowDecisionTokenAllowance, maximum });
+}
+function defaultCodeLines() {
+    return Object.freeze({
+        lowDecisionTokenAllowance: Object.freeze({
+            maximumCodeLines: DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES,
+            maximumDecisionTokens: DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS
+        }),
+        maximum: DEFAULT_MAXIMUM_CODE_LINES
+    });
+}
+function resolveAllowance(value) {
+    if (value === undefined)
+        return defaultCodeLines().lowDecisionTokenAllowance;
+    const allowance = snapshotPolicyRecord(value, {
+        optional: ["maximumCodeLines", "maximumDecisionTokens"]
+    });
+    if (allowance === undefined)
+        return undefined;
+    const maximumCodeLines = allowance.maximumCodeLines ?? DEFAULT_ALLOWANCE_MAXIMUM_CODE_LINES;
+    const maximumDecisionTokens = allowance.maximumDecisionTokens ?? DEFAULT_ALLOWANCE_MAXIMUM_DECISION_TOKENS;
+    if (!isPositiveSafeInteger(maximumCodeLines) ||
+        !isNonNegativeSafeInteger(maximumDecisionTokens)) {
+        return undefined;
+    }
+    return Object.freeze({ maximumCodeLines, maximumDecisionTokens });
+}
+function resolveScanner(value) {
+    if (value === undefined)
+        return Object.freeze({ executable: DEFAULT_EXECUTABLE });
+    const scanner = snapshotPolicyRecord(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

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

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

@@ -0,0 +1,82 @@
+import { snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.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"]);
+    return (options !== undefined &&
+        isValidCodeAreas(options.codeAreas) &&
+        isValidFindingWaivers(options.findingWaivers) &&
+        isValidScanner(options.scanner));
+}
+function isValidFindingWaivers(value) {
+    const waivers = snapshotClosedArray(value);
+    if (waivers === undefined)
+        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"]);
+        if (waiver === undefined ||
+            identity === undefined ||
+            identity.metric !== "code-lines" ||
+            !isNormalizedProjectRelativePath(identity.path) ||
+            !isNonEmptyString(waiver.reason)) {
+            return false;
+        }
+        const identityKey = `${identity.metric}\u0000${identity.path}`;
+        if (identities.has(identityKey))
+            return false;
+        identities.add(identityKey);
+    }
+    return true;
+}
+function isValidCodeAreas(value) {
+    const codeAreas = snapshotClosedRecord(value);
+    if (codeAreas === undefined || Object.keys(codeAreas).length === 0)
+        return false;
+    return Object.entries(codeAreas).every(([areaId, candidate]) => areaId.length > 0 && isValidCodeArea(candidate));
+}
+function isValidCodeArea(value) {
+    const area = exactRecord(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"]);
+    if (policy === undefined || !isPositiveSafeInteger(policy.maximum))
+        return false;
+    const allowance = exactRecord(policy.lowDecisionTokenAllowance, [
+        "maximumCodeLines",
+        "maximumDecisionTokens"
+    ]);
+    return (allowance !== undefined &&
+        isPositiveSafeInteger(allowance.maximumCodeLines) &&
+        allowance.maximumCodeLines > policy.maximum &&
+        isNonNegativeSafeInteger(allowance.maximumDecisionTokens));
+}
+function isValidScanner(value) {
+    const scanner = exactRecord(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

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

@@ -0,0 +1 @@
+{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/options-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjG,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAG9E,0DAA0D;AAC1D,MAAM,UAAU,iCAAiC,CAC/C,eAAwB;IAExB,MAAM,OAAO,GAAG,WAAW,CAAC,eAAe,EAAE,CAAC,WAAW,EAAE,gBAAgB,EAAE,SAAS,CAAC,CAAC,CAAC;IACzF,OAAO,CACL,OAAO,KAAK,SAAS;QACrB,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC;QACnC,qBAAqB,CAAC,OAAO,CAAC,cAAc,CAAC;QAC7C,cAAc,CAAC,OAAO,CAAC,OAAO,CAAC,CAChC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,KAAK,MAAM,SAAS,IAAI,OAAO,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,MAAM,QAAQ,GACZ,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACtF,IACE,MAAM,KAAK,SAAS;YACpB,QAAQ,KAAK,SAAS;YACtB,QAAQ,CAAC,MAAM,KAAK,YAAY;YAChC,CAAC,+BAA+B,CAAC,QAAQ,CAAC,IAAI,CAAC;YAC/C,CAAC,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,EAChC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,WAAW,GAAG,GAAG,QAAQ,CAAC,MAAM,SAAS,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAI,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,OAAO,KAAK,CAAC;QAC9C,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IAC9B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,MAAM,SAAS,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,SAAS,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACjF,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,KAAK,CACpC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,CAAC,SAAS,CAAC,CACzE,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC;IACzE,OAAO,CACL,IAAI,KAAK,SAAS;QAClB,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;QACrC,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC;QACtC,qBAAqB,CAAC,IAAI,CAAC,SAAS,CAAC,CACtC,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,2BAA2B,EAAE,SAAS,CAAC,CAAC,CAAC;IAC5E,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC;QAAE,OAAO,KAAK,CAAC;IACjF,MAAM,SAAS,GAAG,WAAW,CAAC,MAAM,CAAC,yBAAyB,EAAE;QAC9D,kBAAkB;QAClB,uBAAuB;KACxB,CAAC,CAAC;IACH,OAAO,CACL,SAAS,KAAK,SAAS;QACvB,qBAAqB,CAAC,SAAS,CAAC,gBAAgB,CAAC;QACjD,SAAS,CAAC,gBAAgB,GAAG,MAAM,CAAC,OAAO;QAC3C,wBAAwB,CAAC,SAAS,CAAC,qBAAqB,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,OAAO,OAAO,KAAK,SAAS,IAAI,gBAAgB,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACvE,CAAC;AAED,SAAS,WAAW,CAClB,KAAc,EACd,IAAuB;IAEvB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,MAAM,KAAK,SAAS;QACzB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC1C,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAc;IAC9C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC","sourcesContent":["import { snapshotClosedArray, snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport { isNormalizedProjectRelativePath } from \"../host-environment/path.ts\";\nimport type { ResolvedFileMetricsOptions } from \"./options.ts\";\n\n/** 验证 constructor 产物或普通对象组合形成的完整 file-metrics options。 */\nexport function isValidResolvedFileMetricsOptions(\n  resolvedOptions: unknown\n): resolvedOptions is ResolvedFileMetricsOptions {\n  const options = exactRecord(resolvedOptions, [\"codeAreas\", \"findingWaivers\", \"scanner\"]);\n  return (\n    options !== undefined &&\n    isValidCodeAreas(options.codeAreas) &&\n    isValidFindingWaivers(options.findingWaivers) &&\n    isValidScanner(options.scanner)\n  );\n}\n\nfunction isValidFindingWaivers(value: unknown): boolean {\n  const waivers = snapshotClosedArray(value);\n  if (waivers === undefined) return false;\n  const identities = new Set<string>();\n  for (const candidate of waivers) {\n    const waiver = exactRecord(candidate, [\"identity\", \"reason\"]);\n    const identity =\n      waiver === undefined ? undefined : exactRecord(waiver.identity, [\"metric\", \"path\"]);\n    if (\n      waiver === undefined ||\n      identity === undefined ||\n      identity.metric !== \"code-lines\" ||\n      !isNormalizedProjectRelativePath(identity.path) ||\n      !isNonEmptyString(waiver.reason)\n    ) {\n      return false;\n    }\n    const identityKey = `${identity.metric}\\u0000${identity.path}`;\n    if (identities.has(identityKey)) return false;\n    identities.add(identityKey);\n  }\n  return true;\n}\n\nfunction isValidCodeAreas(value: unknown): boolean {\n  const codeAreas = snapshotClosedRecord(value);\n  if (codeAreas === undefined || Object.keys(codeAreas).length === 0) return false;\n  return Object.entries(codeAreas).every(\n    ([areaId, candidate]) => areaId.length > 0 && isValidCodeArea(candidate)\n  );\n}\n\nfunction isValidCodeArea(value: unknown): boolean {\n  const area = exactRecord(value, [\"codeLines\", \"files\", \"findingPolicy\"]);\n  return (\n    area !== undefined &&\n    validProjectFileSelection(area.files) &&\n    validFindingPolicy(area.findingPolicy) &&\n    isValidCodeLinePolicy(area.codeLines)\n  );\n}\n\nfunction isValidCodeLinePolicy(value: unknown): boolean {\n  const policy = exactRecord(value, [\"lowDecisionTokenAllowance\", \"maximum\"]);\n  if (policy === undefined || !isPositiveSafeInteger(policy.maximum)) return false;\n  const allowance = exactRecord(policy.lowDecisionTokenAllowance, [\n    \"maximumCodeLines\",\n    \"maximumDecisionTokens\"\n  ]);\n  return (\n    allowance !== undefined &&\n    isPositiveSafeInteger(allowance.maximumCodeLines) &&\n    allowance.maximumCodeLines > policy.maximum &&\n    isNonNegativeSafeInteger(allowance.maximumDecisionTokens)\n  );\n}\n\nfunction isValidScanner(value: unknown): boolean {\n  const scanner = exactRecord(value, [\"executable\"]);\n  return scanner !== undefined && isNonEmptyString(scanner.executable);\n}\n\nfunction exactRecord(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  return record !== undefined &&\n    Object.keys(record).length === keys.length &&\n    keys.every((key) => Object.hasOwn(record, key))\n    ? record\n    : undefined;\n}\n\nfunction 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"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/options.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { FindingWaiver } from \"../../finding-waivers/reconciliation.ts\";\n\n/** `fileMetrics` 构造函数可省略的 SCC 可执行文件策略。 */\nexport interface FileMetricsScannerOptions {\n  /** 省略时直接执行 `scc`；显式命令必须直接接受 adapter 拥有的 SCC 参数。 */\n  readonly executable?: string;\n}\n\n/** file-metrics 区域可省略并由构造函数补齐的文件策略。 */\nexport type FileMetricsFileOptions = ProjectFileSelectionOptions;\n\n/** SCC decision-token 数较低的文件可使用的代码行宽限策略。 */\nexport interface FileMetricsLowDecisionTokenAllowanceOptions {\n  /** 省略时为 `600`；必须严格大于同一区域的普通代码行上限。 */\n  readonly maximumCodeLines?: number;\n  /** 省略时为 `12`；decision-token measurement 不大于此值时应用宽限上限。 */\n  readonly maximumDecisionTokens?: number;\n}\n\n/** 一个区域可省略的文件代码行策略。 */\nexport interface FileMetricsCodeLineOptions {\n  /** 省略时为 `360`；只有严格超过此值才产生 finding。 */\n  readonly maximum?: number;\n  /** 省略时使用完整默认宽限策略。 */\n  readonly lowDecisionTokenAllowance?: FileMetricsLowDecisionTokenAllowanceOptions;\n}\n\n/** 可独立选择文件并定义代码行与 finding policy 的 file-metrics 区域。 */\nexport interface FileMetricsCodeAreaOptions {\n  /** 显式区域必须声明本字段；其中各子字段可省略并使用 package 默认值。 */\n  readonly files: FileMetricsFileOptions;\n  /** 省略时继承顶层 `findingPolicy`。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** 省略时使用 package 默认代码行策略。 */\n  readonly codeLines?: FileMetricsCodeLineOptions;\n}\n\n/** file-metrics 用于识别可豁免 finding 的稳定语义字段。 */\nexport interface FileMetricsFindingIdentity {\n  /** file-metrics 当前只产生文件代码行 finding。 */\n  readonly metric: \"code-lines\";\n  /** 已 normalized 的 project-root-relative slash path；不得为绝对、含反斜杠或含 `.`/`..` 的路径。 */\n  readonly path: string;\n}\n\n/** 一项 file-metrics finding 的声明式豁免；执行时仍会扫描并发布该 finding。 */\nexport type FileMetricsFindingWaiver = FindingWaiver<FileMetricsFindingIdentity>;\n\n/** `fileMetrics(options?)` 接受并补齐默认值的公开策略。 */\nexport interface FileMetricsOptions {\n  /** 省略时建立默认 `project` 区域；显式映射必须非空。 */\n  readonly codeAreas?: Readonly<Record<string, FileMetricsCodeAreaOptions>>;\n  /** 省略时为 `non-blocking`；区域可局部覆盖。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** 省略时没有豁免；每项以 `{ metric, path }` 精确匹配，并必须提供非空理由。 */\n  readonly findingWaivers?: readonly FileMetricsFindingWaiver[];\n  /** 省略时直接执行 `scc`；CLI 协议由 owning adapter 固定。 */\n  readonly scanner?: FileMetricsScannerOptions;\n}\n\n/** 构造函数生成并由 Check preflight/execution 消费的完整 options。 */\nexport interface ResolvedFileMetricsOptions {\n  readonly codeAreas: Readonly<Record<string, ResolvedFileMetricsCodeAreaOptions>>;\n  readonly findingWaivers: readonly FileMetricsFindingWaiver[];\n  readonly scanner: ResolvedFileMetricsScannerOptions;\n}\n\nexport interface ResolvedFileMetricsCodeAreaOptions {\n  readonly codeLines: ResolvedFileMetricsCodeLineOptions;\n  readonly files: ProjectFileSelection;\n  readonly findingPolicy: FindingPolicy;\n}\n\nexport interface ResolvedFileMetricsCodeLineOptions {\n  readonly lowDecisionTokenAllowance: ResolvedFileMetricsLowDecisionTokenAllowanceOptions;\n  readonly maximum: number;\n}\n\nexport interface ResolvedFileMetricsLowDecisionTokenAllowanceOptions {\n  readonly maximumCodeLines: number;\n  readonly maximumDecisionTokens: number;\n}\n\nexport interface ResolvedFileMetricsScannerOptions {\n  readonly executable: string;\n}\n"]}