@zxyycom/vibe-check 0.0.1

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

@@ -0,0 +1,43 @@
+import { defineCheck } from "../../check/check.mjs";
+import { executeFunctionMetrics } from "./execution.mjs";
+import { parseFunctionMetricsData } from "./final-data.mjs";
+import { resolveFunctionMetricsOptions } from "./options-resolution.mjs";
+import { validResolvedFunctionMetricsOptions } from "./options-validation.mjs";
+const FUNCTION_METRICS_CHECK_DEFINITION = {
+    checkId: "function-metrics",
+    displayName: "Function metrics"
+};
+/**
+ * 使用可省略的区域、阈值与 finding policy 构造一个完整 function-metrics Check。
+ *
+ * @param options - 省略字段由 package 补齐；显式 files 数组完整替换对应字段的默认数组。
+ * @returns 固定 `function-metrics` identity、完整冻结 options、preflight 与 execution。
+ * @throws {TypeError} input 含未知字段、空 area、非法 finding policy、非法 limit 或空 executable 时抛出。
+ */
+export function functionMetrics(options = {}) {
+    const resolvedOptions = resolveFunctionMetricsOptions(options);
+    if (resolvedOptions === undefined) {
+        throw new TypeError("functionMetrics options must use the documented closed policy: a non-empty area map, recognized finding policies, positive safe-integer limits, and a non-empty scanner executable");
+    }
+    return defineCheck({
+        ...FUNCTION_METRICS_CHECK_DEFINITION,
+        execution: executeFunctionMetrics,
+        parseData: parseFunctionMetricsData,
+        preflight: (preparedOptions) => validResolvedFunctionMetricsOptions(preparedOptions)
+            ? { status: "success", preparedOptions }
+            : {
+                status: "failure",
+                action: "block",
+                reason: { code: "invalid-options" },
+                messages: [
+                    {
+                        code: "invalid-options",
+                        level: "error",
+                        message: "functionMetrics options are invalid; recreate the Check with functionMetrics(options) or restore its complete resolved options."
+                    }
+                ]
+            },
+        options: resolvedOptions
+    });
+}
+//# sourceMappingURL=constructor.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"constructor.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/constructor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,iBAAiB,CAAC;AAE3D,OAAO,EAAE,6BAA6B,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,EAAE,mCAAmC,EAAE,MAAM,yBAAyB,CAAC;AAE9E,MAAM,iCAAiC,GAAG;IACxC,OAAO,EAAE,kBAAkB;IAC3B,WAAW,EAAE,kBAAkB;CACvB,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAO,GAA2B,EAAE;IAMpC,MAAM,eAAe,GAAG,6BAA6B,CAAC,OAAO,CAAC,CAAC;IAC/D,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CACjB,oLAAoL,CACrL,CAAC;IACJ,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,GAAG,iCAAiC;QACpC,SAAS,EAAE,sBAAsB;QACjC,SAAS,EAAE,wBAAwB;QACnC,SAAS,EAAE,CAAC,eAAe,EAAE,EAAE,CAC7B,mCAAmC,CAAC,eAAe,CAAC;YAClD,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,iIAAiI;qBACpI;iBACF;aACF;QACP,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { defineCheck, type TypedCheckWithOptions } from \"../../check/check.ts\";\nimport { executeFunctionMetrics } from \"./execution.ts\";\nimport { parseFunctionMetricsData } from \"./final-data.ts\";\nimport type { FunctionMetricsOptions, ResolvedFunctionMetricsOptions } from \"./options.ts\";\nimport { resolveFunctionMetricsOptions } from \"./options-resolution.ts\";\nimport { validResolvedFunctionMetricsOptions } from \"./options-validation.ts\";\n\nconst FUNCTION_METRICS_CHECK_DEFINITION = {\n  checkId: \"function-metrics\",\n  displayName: \"Function metrics\"\n} as const;\n\n/**\n * 使用可省略的区域、阈值与 finding policy 构造一个完整 function-metrics Check。\n *\n * @param options - 省略字段由 package 补齐；显式 files 数组完整替换对应字段的默认数组。\n * @returns 固定 `function-metrics` identity、完整冻结 options、preflight 与 execution。\n * @throws {TypeError} input 含未知字段、空 area、非法 finding policy、非法 limit 或空 executable 时抛出。\n */\nexport function functionMetrics(\n  options: FunctionMetricsOptions = {}\n): TypedCheckWithOptions<\n  \"function-metrics\",\n  ResolvedFunctionMetricsOptions,\n  typeof parseFunctionMetricsData\n> {\n  const resolvedOptions = resolveFunctionMetricsOptions(options);\n  if (resolvedOptions === undefined) {\n    throw new TypeError(\n      \"functionMetrics options must use the documented closed policy: a non-empty area map, recognized finding policies, positive safe-integer limits, and a non-empty scanner executable\"\n    );\n  }\n  return defineCheck({\n    ...FUNCTION_METRICS_CHECK_DEFINITION,\n    execution: executeFunctionMetrics,\n    parseData: parseFunctionMetricsData,\n    preflight: (preparedOptions) =>\n      validResolvedFunctionMetricsOptions(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                  \"functionMetrics options are invalid; recreate the Check with functionMetrics(options) or restore its complete resolved options.\"\n              }\n            ]\n          },\n    options: resolvedOptions\n  });\n}\n"]}

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

@@ -0,0 +1,178 @@
+import { collectProjectFileSets, requireProjectFileSet } from "../project-files/collection.mjs";
+import { partitionProjectFilesByEligibility } from "../project-files/input-eligibility.mjs";
+import { settleFindings } from "../code-quality-findings/policy.mjs";
+import { analyzeFunctionMetrics } from "./analysis.mjs";
+import { measureFunctionMetrics } from "./measurement.mjs";
+import { validResolvedFunctionMetricsOptions } from "./options-validation.mjs";
+import { buildFunctionInputRejectedCandidates, buildFunctionRecordCandidates } from "./records.mjs";
+import { isLizardTarget } from "./target-files.mjs";
+/** Default Check callback；一次扫描完整 area exact-input union。 */
+export async function executeFunctionMetrics(context) {
+    if (!validResolvedFunctionMetricsOptions(context.options))
+        return unavailable("invalid-options");
+    if (context.signal.aborted)
+        return unavailable("cancelled");
+    let prepared;
+    try {
+        prepared = prepareFunctionInputs(context.project.root, context.options.codeAreas);
+    }
+    catch {
+        return unavailable("source-unavailable");
+    }
+    if (context.signal.aborted)
+        return unavailable("cancelled");
+    return executePreparedFunctionMetrics(context, prepared);
+}
+async function executePreparedFunctionMetrics(context, prepared) {
+    if (prepared.selectedPathCount === 0) {
+        return Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } });
+    }
+    reportInputRejections(context, prepared.rejectedCandidates);
+    if (prepared.exactInput.approvedExactPaths.length === 0) {
+        return settleFunctionFindings([], prepared.rejectedCandidates);
+    }
+    const measurement = await measureFunctionMetrics({
+        dependency: context.options.scanner,
+        input: prepared.exactInput,
+        signal: context.signal
+    });
+    if (measurement.kind !== "complete") {
+        return appendInputRejectedMessage(directMeasurementFailure(measurement), prepared.rejectedCandidates.length);
+    }
+    const analysis = analyzeFunctionMetrics(measurement.metrics);
+    if (analysis === undefined) {
+        return appendInputRejectedMessage(unavailable("external-result-invalid"), prepared.rejectedCandidates.length);
+    }
+    const candidates = buildFunctionRecordCandidates(analysis, prepared.exactInput.areas);
+    if (candidates === undefined) {
+        return appendInputRejectedMessage(unavailable("external-result-invalid"), prepared.rejectedCandidates.length);
+    }
+    for (const candidate of candidates) {
+        context.records.report({ id: candidate.id }, candidate.data);
+    }
+    return settleFunctionFindings(candidates, prepared.rejectedCandidates);
+}
+function prepareFunctionInputs(rootDir, codeAreas) {
+    const collected = collectAreaInputs(rootDir, codeAreas);
+    return Object.freeze({
+        exactInput: Object.freeze({
+            approvedExactPaths: Object.freeze(uniqueSorted(collected.areas.flatMap((area) => area.approvedExactPaths))),
+            areas: collected.areas,
+            rootDir
+        }),
+        rejectedCandidates: buildFunctionInputRejectedCandidates(new Map([...collected.rejectedCodeAreasByPath].map(([path, matchingAreas]) => [
+            path,
+            Object.freeze(matchingAreas)
+        ]))),
+        selectedPathCount: collected.selectedPaths.size
+    });
+}
+function collectAreaInputs(rootDir, codeAreas) {
+    const areas = [];
+    const rejectedCodeAreasByPath = new Map();
+    const selectedPaths = new Set();
+    const orderedPolicies = Object.entries(codeAreas).sort(([left], [right]) => compareText(left, right));
+    const filesByArea = collectProjectFileSets(rootDir, Object.fromEntries(orderedPolicies.map(([areaId, policy]) => [areaId, policy.files])));
+    for (const [codeArea, policy] of orderedPolicies) {
+        const selectedForArea = requireProjectFileSet(filesByArea, codeArea);
+        for (const path of selectedForArea)
+            selectedPaths.add(path);
+        const partition = partitionProjectFilesByEligibility(selectedForArea, isLizardTarget);
+        for (const path of partition.rejectedPaths) {
+            const matchingAreas = rejectedCodeAreasByPath.get(path) ?? [];
+            matchingAreas.push(codeArea);
+            rejectedCodeAreasByPath.set(path, matchingAreas);
+        }
+        if (partition.acceptedPaths.length === 0)
+            continue;
+        areas.push(Object.freeze({
+            approvedExactPaths: partition.acceptedPaths,
+            codeArea,
+            findingPolicy: policy.findingPolicy,
+            limits: policy.limits
+        }));
+    }
+    return Object.freeze({
+        areas: Object.freeze(areas),
+        rejectedCodeAreasByPath,
+        selectedPaths
+    });
+}
+function reportInputRejections(context, candidates) {
+    for (const candidate of candidates) {
+        context.records.report({ id: candidate.id }, candidate.data);
+    }
+}
+function settleFunctionFindings(metricCandidates, rejectedCandidates) {
+    const settlement = settleFindings([
+        ...metricCandidates.map((candidate) => ({
+            actionable: true,
+            blocking: candidate.data.blocking
+        })),
+        ...rejectedCandidates.map(() => ({ actionable: false, blocking: false }))
+    ]);
+    return appendInputRejectedMessage(settlement, rejectedCandidates.length);
+}
+function appendInputRejectedMessage(result, rejectedInputCount) {
+    if (rejectedInputCount === 0)
+        return result;
+    const message = Object.freeze({
+        code: "input-rejected",
+        level: "warning",
+        message: `${rejectedInputCount} selected functionMetrics input file(s) were rejected because their file type is unsupported; inspect this Check's Records and narrow files.include/exclude.`
+    });
+    return Object.freeze({
+        ...result,
+        messages: Object.freeze([...(result.messages ?? []), message])
+    });
+}
+function directMeasurementFailure(measurement) {
+    switch (measurement.kind) {
+        case "cancelled":
+            return unavailable("cancelled");
+        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 "functionMetrics options are invalid; recreate the Check with functionMetrics(options) or restore its complete resolved options.";
+        case "cancelled":
+            return "Function metrics was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate.";
+        case "source-unavailable":
+            return "Function 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 Lizard command is unavailable or incompatible; install Lizard 1.23.0 or configure a compatible executable.";
+        case "external-execution-failed":
+            return "Lizard did not complete successfully; run the configured command directly and inspect its environment.";
+        case "external-result-invalid":
+            return "Lizard output could not form a trusted complete result; check the executable version and CSV compatibility.";
+    }
+}
+function uniqueSorted(values) {
+    return [...new Set(values)].sort(compareText);
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=execution.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckExecutionContext, CheckMessage, CheckResult } from \"../../check/check.ts\";\nimport { collectProjectFileSets, requireProjectFileSet } from \"../project-files/collection.ts\";\nimport { partitionProjectFilesByEligibility } from \"../project-files/input-eligibility.ts\";\nimport { settleFindings } from \"../code-quality-findings/policy.ts\";\nimport { analyzeFunctionMetrics } from \"./analysis.ts\";\nimport { measureFunctionMetrics, type FunctionMeasurementResult } from \"./measurement.ts\";\nimport type {\n  FunctionMetricsAreaInput,\n  FunctionMetricsExactInputSet\n} from \"./measurement-model.ts\";\nimport type {\n  ResolvedFunctionMetricsCodeAreaOptions,\n  ResolvedFunctionMetricsOptions\n} from \"./options.ts\";\nimport { validResolvedFunctionMetricsOptions } from \"./options-validation.ts\";\nimport {\n  buildFunctionInputRejectedCandidates,\n  buildFunctionRecordCandidates,\n  type FunctionInputRejectedCandidate,\n  type FunctionRecordCandidate\n} from \"./records.ts\";\nimport { isLizardTarget } from \"./target-files.ts\";\nimport type { FunctionMetricsFinalData } from \"./final-data.ts\";\n\n/** `function-metrics` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type FunctionMetricsUnavailableReasonCode =\n  | \"cancelled\"\n  | \"external-dependency-unavailable\"\n  | \"external-execution-failed\"\n  | \"external-result-invalid\"\n  | \"invalid-options\"\n  | \"source-unavailable\";\n\n/** Default Check callback；一次扫描完整 area exact-input union。 */\nexport async function executeFunctionMetrics(\n  context: CheckExecutionContext<ResolvedFunctionMetricsOptions>\n): Promise<CheckResult<FunctionMetricsFinalData>> {\n  if (!validResolvedFunctionMetricsOptions(context.options)) return unavailable(\"invalid-options\");\n  if (context.signal.aborted) return unavailable(\"cancelled\");\n\n  let prepared: PreparedFunctionInputs;\n  try {\n    prepared = prepareFunctionInputs(context.project.root, context.options.codeAreas);\n  } catch {\n    return unavailable(\"source-unavailable\");\n  }\n  if (context.signal.aborted) return unavailable(\"cancelled\");\n  return executePreparedFunctionMetrics(context, prepared);\n}\n\nasync function executePreparedFunctionMetrics(\n  context: CheckExecutionContext<ResolvedFunctionMetricsOptions>,\n  prepared: PreparedFunctionInputs\n): Promise<CheckResult<FunctionMetricsFinalData>> {\n  if (prepared.selectedPathCount === 0) {\n    return Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } });\n  }\n  reportInputRejections(context, prepared.rejectedCandidates);\n  if (prepared.exactInput.approvedExactPaths.length === 0) {\n    return settleFunctionFindings([], prepared.rejectedCandidates);\n  }\n  const measurement = await measureFunctionMetrics({\n    dependency: context.options.scanner,\n    input: prepared.exactInput,\n    signal: context.signal\n  });\n  if (measurement.kind !== \"complete\") {\n    return appendInputRejectedMessage(\n      directMeasurementFailure(measurement),\n      prepared.rejectedCandidates.length\n    );\n  }\n  const analysis = analyzeFunctionMetrics(measurement.metrics);\n  if (analysis === undefined) {\n    return appendInputRejectedMessage(\n      unavailable(\"external-result-invalid\"),\n      prepared.rejectedCandidates.length\n    );\n  }\n  const candidates = buildFunctionRecordCandidates(analysis, prepared.exactInput.areas);\n  if (candidates === undefined) {\n    return appendInputRejectedMessage(\n      unavailable(\"external-result-invalid\"),\n      prepared.rejectedCandidates.length\n    );\n  }\n  for (const candidate of candidates) {\n    context.records.report({ id: candidate.id }, candidate.data);\n  }\n  return settleFunctionFindings(candidates, prepared.rejectedCandidates);\n}\n\ninterface PreparedFunctionInputs {\n  readonly exactInput: FunctionMetricsExactInputSet;\n  readonly rejectedCandidates: readonly FunctionInputRejectedCandidate[];\n  readonly selectedPathCount: number;\n}\n\nfunction prepareFunctionInputs(\n  rootDir: string,\n  codeAreas: ResolvedFunctionMetricsOptions[\"codeAreas\"]\n): PreparedFunctionInputs {\n  const collected = collectAreaInputs(rootDir, codeAreas);\n  return Object.freeze({\n    exactInput: Object.freeze({\n      approvedExactPaths: Object.freeze(\n        uniqueSorted(collected.areas.flatMap((area) => area.approvedExactPaths))\n      ),\n      areas: collected.areas,\n      rootDir\n    }),\n    rejectedCandidates: buildFunctionInputRejectedCandidates(\n      new Map(\n        [...collected.rejectedCodeAreasByPath].map(([path, matchingAreas]) => [\n          path,\n          Object.freeze(matchingAreas)\n        ])\n      )\n    ),\n    selectedPathCount: collected.selectedPaths.size\n  });\n}\n\ninterface CollectedFunctionAreaInputs {\n  readonly areas: readonly FunctionMetricsAreaInput[];\n  readonly rejectedCodeAreasByPath: ReadonlyMap<string, readonly string[]>;\n  readonly selectedPaths: ReadonlySet<string>;\n}\n\nfunction collectAreaInputs(\n  rootDir: string,\n  codeAreas: Readonly<Record<string, ResolvedFunctionMetricsCodeAreaOptions>>\n): CollectedFunctionAreaInputs {\n  const areas: FunctionMetricsAreaInput[] = [];\n  const rejectedCodeAreasByPath = new Map<string, string[]>();\n  const selectedPaths = new Set<string>();\n  const orderedPolicies = Object.entries(codeAreas).sort(([left], [right]) =>\n    compareText(left, right)\n  );\n  const filesByArea = collectProjectFileSets(\n    rootDir,\n    Object.fromEntries(orderedPolicies.map(([areaId, policy]) => [areaId, policy.files]))\n  );\n  for (const [codeArea, policy] of orderedPolicies) {\n    const selectedForArea = requireProjectFileSet(filesByArea, codeArea);\n    for (const path of selectedForArea) selectedPaths.add(path);\n    const partition = partitionProjectFilesByEligibility(selectedForArea, isLizardTarget);\n    for (const path of partition.rejectedPaths) {\n      const matchingAreas = rejectedCodeAreasByPath.get(path) ?? [];\n      matchingAreas.push(codeArea);\n      rejectedCodeAreasByPath.set(path, matchingAreas);\n    }\n    if (partition.acceptedPaths.length === 0) continue;\n    areas.push(\n      Object.freeze({\n        approvedExactPaths: partition.acceptedPaths,\n        codeArea,\n        findingPolicy: policy.findingPolicy,\n        limits: policy.limits\n      })\n    );\n  }\n  return Object.freeze({\n    areas: Object.freeze(areas),\n    rejectedCodeAreasByPath,\n    selectedPaths\n  });\n}\n\nfunction reportInputRejections(\n  context: CheckExecutionContext<ResolvedFunctionMetricsOptions>,\n  candidates: readonly FunctionInputRejectedCandidate[]\n): void {\n  for (const candidate of candidates) {\n    context.records.report({ id: candidate.id }, candidate.data);\n  }\n}\n\nfunction settleFunctionFindings(\n  metricCandidates: readonly FunctionRecordCandidate[],\n  rejectedCandidates: readonly FunctionInputRejectedCandidate[]\n): CheckResult<FunctionMetricsFinalData> {\n  const settlement = settleFindings([\n    ...metricCandidates.map((candidate) => ({\n      actionable: true,\n      blocking: candidate.data.blocking\n    })),\n    ...rejectedCandidates.map(() => ({ actionable: false, blocking: false }))\n  ]);\n  return appendInputRejectedMessage(settlement, rejectedCandidates.length);\n}\n\nfunction appendInputRejectedMessage(\n  result: CheckResult<FunctionMetricsFinalData>,\n  rejectedInputCount: number\n): CheckResult<FunctionMetricsFinalData> {\n  if (rejectedInputCount === 0) return result;\n  const message: CheckMessage = Object.freeze({\n    code: \"input-rejected\",\n    level: \"warning\",\n    message: `${rejectedInputCount} selected functionMetrics input file(s) were rejected because their file type is unsupported; inspect this Check's Records and narrow files.include/exclude.`\n  });\n  return Object.freeze({\n    ...result,\n    messages: Object.freeze([...(result.messages ?? []), message])\n  });\n}\n\nfunction directMeasurementFailure(\n  measurement: Exclude<FunctionMeasurementResult, { kind: \"complete\" }>\n): CheckResult<FunctionMetricsFinalData> {\n  switch (measurement.kind) {\n    case \"cancelled\":\n      return unavailable(\"cancelled\");\n    case \"execution-failed\":\n      return unavailable(\"external-execution-failed\");\n    case \"invalid-result\":\n      return unavailable(\"external-result-invalid\");\n    case \"unavailable\":\n      return unavailable(\"external-dependency-unavailable\");\n  }\n  const exhaustiveMeasurement: never = measurement;\n  return exhaustiveMeasurement;\n}\n\nfunction unavailable(\n  code: FunctionMetricsUnavailableReasonCode\n): CheckResult<FunctionMetricsFinalData> {\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: FunctionMetricsUnavailableReasonCode): string {\n  switch (code) {\n    case \"invalid-options\":\n      return \"functionMetrics options are invalid; recreate the Check with functionMetrics(options) or restore its complete resolved options.\";\n    case \"cancelled\":\n      return \"Function metrics was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate.\";\n    case \"source-unavailable\":\n      return \"Function 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 Lizard command is unavailable or incompatible; install Lizard 1.23.0 or configure a compatible executable.\";\n    case \"external-execution-failed\":\n      return \"Lizard did not complete successfully; run the configured command directly and inspect its environment.\";\n    case \"external-result-invalid\":\n      return \"Lizard output could not form a trusted complete result; check the executable version and CSV compatibility.\";\n  }\n}\n\nfunction uniqueSorted(values: readonly string[]): string[] {\n  return [...new Set(values)].sort(compareText);\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}

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

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

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

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

package/dist/esm/package-checks/function-metrics/lizard/availability.mjs

@@ -0,0 +1,64 @@
+import { errorMessage } from "../../host-environment/error-message.mjs";
+import { runProcess } from "../../host-environment/process/command.mjs";
+export async function checkLizard(rootDir, dependency) {
+    try {
+        const result = await runProcess({
+            args: ["--version"],
+            command: dependency.executable,
+            cwd: rootDir
+        });
+        return availabilityFromVersionResult(result);
+    }
+    catch (error) {
+        return unavailableLizard({
+            error: `lizard version error: ${errorMessage(error)}`,
+            reason: "execution-error"
+        });
+    }
+}
+function availabilityFromVersionResult(result) {
+    if (result.signal !== null) {
+        const output = commandOutput(result);
+        return unavailableLizard({
+            error: `lizard --version failed, signal ${result.signal}${output ? `: ${output}` : ""}`,
+            reason: "execution-error"
+        });
+    }
+    if (result.error)
+        return processErrorAvailability(result.error);
+    const output = commandOutput(result);
+    if (result.status !== 0) {
+        return unavailableLizard({
+            error: `lizard --version failed, ${processTermination(result)}${output ? `: ${output}` : ""}`,
+            reason: "execution-error"
+        });
+    }
+    if (output === "") {
+        return unavailableLizard({
+            error: "lizard --version returned empty output",
+            reason: "contract-error"
+        });
+    }
+    return Object.freeze({ available: true, version: output });
+}
+function processErrorAvailability(error) {
+    const isMissingTool = Object.hasOwn(error, "code") && Reflect.get(error, "code") === "ENOENT";
+    return unavailableLizard({
+        error: isMissingTool
+            ? `lizard command unavailable: ${error.message}`
+            : `lizard version error: ${error.message}`,
+        reason: isMissingTool ? "tool-unavailable" : "execution-error"
+    });
+}
+function unavailableLizard({ error, reason }) {
+    return Object.freeze({ available: false, error, reason });
+}
+function commandOutput(result) {
+    return (result.stdout || "").trim() || (result.stderr || "").trim();
+}
+function processTermination(result) {
+    return typeof result.status === "number"
+        ? `exit ${result.status}`
+        : `signal ${result.signal || "unknown"}`;
+}
+//# sourceMappingURL=availability.mjs.map

package/dist/esm/package-checks/function-metrics/lizard/availability.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/function-metrics/lizard/availability.ts"],"names":[],"mappings":"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","sourcesContent":["import { errorMessage } from \"../../host-environment/error-message.ts\";\nimport { runProcess } from \"../../host-environment/process/command.ts\";\nimport type { ResolvedFunctionMetricsScannerOptions } from \"../options.ts\";\n\ntype LizardAvailability = Readonly<\n  | {\n      readonly available: true;\n      readonly version: string;\n    }\n  | {\n      readonly available: false;\n      readonly error: string;\n      readonly reason: \"contract-error\" | \"execution-error\" | \"tool-unavailable\";\n    }\n>;\n\ninterface UnavailableLizardInput {\n  readonly error: string;\n  readonly reason: Extract<LizardAvailability, { available: false }>[\"reason\"];\n}\n\ntype ToolCommandResult = Awaited<ReturnType<typeof runProcess>>;\n\nexport async function checkLizard(\n  rootDir: string,\n  dependency: ResolvedFunctionMetricsScannerOptions\n): Promise<LizardAvailability> {\n  try {\n    const result = await runProcess({\n      args: [\"--version\"],\n      command: dependency.executable,\n      cwd: rootDir\n    });\n    return availabilityFromVersionResult(result);\n  } catch (error: unknown) {\n    return unavailableLizard({\n      error: `lizard version error: ${errorMessage(error)}`,\n      reason: \"execution-error\"\n    });\n  }\n}\n\nfunction availabilityFromVersionResult(result: ToolCommandResult): LizardAvailability {\n  if (result.signal !== null) {\n    const output = commandOutput(result);\n    return unavailableLizard({\n      error: `lizard --version failed, signal ${result.signal}${output ? `: ${output}` : \"\"}`,\n      reason: \"execution-error\"\n    });\n  }\n  if (result.error) return processErrorAvailability(result.error);\n  const output = commandOutput(result);\n  if (result.status !== 0) {\n    return unavailableLizard({\n      error: `lizard --version failed, ${processTermination(result)}${output ? `: ${output}` : \"\"}`,\n      reason: \"execution-error\"\n    });\n  }\n  if (output === \"\") {\n    return unavailableLizard({\n      error: \"lizard --version returned empty output\",\n      reason: \"contract-error\"\n    });\n  }\n  return Object.freeze({ available: true, version: output });\n}\n\nfunction processErrorAvailability(error: Error): LizardAvailability {\n  const isMissingTool = Object.hasOwn(error, \"code\") && Reflect.get(error, \"code\") === \"ENOENT\";\n  return unavailableLizard({\n    error: isMissingTool\n      ? `lizard command unavailable: ${error.message}`\n      : `lizard version error: ${error.message}`,\n    reason: isMissingTool ? \"tool-unavailable\" : \"execution-error\"\n  });\n}\n\nfunction unavailableLizard({ error, reason }: UnavailableLizardInput): LizardAvailability {\n  return Object.freeze({ available: false, error, reason });\n}\n\nfunction commandOutput(result: ToolCommandResult): string {\n  return (result.stdout || \"\").trim() || (result.stderr || \"\").trim();\n}\n\nfunction processTermination(result: ToolCommandResult): string {\n  return typeof result.status === \"number\"\n    ? `exit ${result.status}`\n    : `signal ${result.signal || \"unknown\"}`;\n}\n"]}

package/dist/esm/package-checks/function-metrics/lizard/csv.mjs

@@ -0,0 +1,17 @@
+import { parse } from "csv-parse/sync";
+export function parseCsvRows(csv) {
+    const records = parse(csv, {
+        bom: true,
+        relax_column_count: true,
+        skip_empty_lines: true,
+        trim: true
+    });
+    if (!Array.isArray(records) || !records.every(isStringRow)) {
+        throw new Error("CSV parser returned non-string rows");
+    }
+    return records;
+}
+function isStringRow(value) {
+    return Array.isArray(value) && value.every((item) => typeof item === "string");
+}
+//# sourceMappingURL=csv.mjs.map

package/dist/esm/package-checks/function-metrics/lizard/csv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/function-metrics/lizard/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,OAAO,GAAY,KAAK,CAAC,GAAG,EAAE;QAClC,GAAG,EAAE,IAAI;QACT,kBAAkB,EAAE,IAAI;QACxB,gBAAgB,EAAE,IAAI;QACtB,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;IAEH,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,CAAC;QAC3D,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AACjF,CAAC","sourcesContent":["import { parse } from \"csv-parse/sync\";\n\nexport function parseCsvRows(csv: string): string[][] {\n  const records: unknown = parse(csv, {\n    bom: true,\n    relax_column_count: true,\n    skip_empty_lines: true,\n    trim: true\n  });\n\n  if (!Array.isArray(records) || !records.every(isStringRow)) {\n    throw new Error(\"CSV parser returned non-string rows\");\n  }\n\n  return records;\n}\n\nfunction isStringRow(value: unknown): value is string[] {\n  return Array.isArray(value) && value.every((item) => typeof item === \"string\");\n}\n"]}

package/dist/esm/package-checks/function-metrics/lizard/parser.mjs

@@ -0,0 +1,138 @@
+import { errorMessage } from "../../host-environment/error-message.mjs";
+import { parseCsvRows } from "./csv.mjs";
+import { normalizeScannerReportedPath } from "../../project-files/reported-path.mjs";
+const LIZARD_COLUMNS = {
+    nloc: 0,
+    ccn: 1,
+    parameterCount: 3,
+    filePath: 6,
+    functionName: 7,
+    startLine: 9,
+    endLine: 10
+};
+/**
+ * 将 Lizard CSV 输出解析为 FunctionMetric 数组。
+ *
+ * Lizard 1.23 CSV 列（--csv）：
+ * NLOC,CCN,token count,parameter count,length,location,file path,function name,long name,start line,end line
+ */
+export function parseLizardCSV(csv, cwd) {
+    try {
+        const measurements = [];
+        for (const [index, row] of lizardDataRows(parseCsvRows(csv)).entries()) {
+            const measurement = functionMetricFromLizardRow(row, cwd);
+            if (!measurement) {
+                throw new Error(`invalid Lizard 1.23 CSV row ${index + 1}`);
+            }
+            measurements.push(measurement);
+        }
+        measurements.sort((a, b) => compareFunctionMetrics(a.payload, b.payload));
+        return { ok: true, measurements };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: `Failed to parse lizard CSV: ${errorMessage(error)}`,
+            reason: "invalid-result"
+        };
+    }
+}
+function lizardDataRows(rows) {
+    const header = rows[0] ?? [];
+    return isLizard123Header(header) ? rows.slice(1) : rows;
+}
+function functionMetricFromLizardRow(parts, cwd) {
+    if (parts.length < 11) {
+        return null;
+    }
+    const values = parseLizardMetricValues(parts);
+    if (!values) {
+        return null;
+    }
+    const filePath = (parts[LIZARD_COLUMNS.filePath] ?? "").trim();
+    if (filePath.length === 0 || values.endLine < values.startLine) {
+        return null;
+    }
+    const sourcePath = normalizeScannerReportedPath(filePath, cwd);
+    return {
+        sourcePaths: [sourcePath],
+        payload: {
+            name: parts[LIZARD_COLUMNS.functionName] || "unknown",
+            file: sourcePath,
+            startLine: values.startLine,
+            endLine: values.endLine,
+            lines: values.nloc,
+            parameterCount: values.parameterCount,
+            cyclomaticComplexity: {
+                value: values.ccn,
+                source: "lizard"
+            }
+        }
+    };
+}
+function parseLizardMetricValues(parts) {
+    const ccnText = parts[LIZARD_COLUMNS.ccn].trim();
+    const ccn = ccnText === "" ? null : parseInteger(ccnText, 0);
+    const endLine = parseInteger(parts[LIZARD_COLUMNS.endLine], 1);
+    const nloc = parseInteger(parts[LIZARD_COLUMNS.nloc], 0);
+    const parameterCount = parseInteger(parts[LIZARD_COLUMNS.parameterCount], 0);
+    const startLine = parseInteger(parts[LIZARD_COLUMNS.startLine], 1);
+    if ((ccnText !== "" && ccn === null) ||
+        endLine === null ||
+        nloc === null ||
+        parameterCount === null ||
+        startLine === null) {
+        return null;
+    }
+    return {
+        ccn,
+        endLine,
+        nloc,
+        parameterCount,
+        startLine
+    };
+}
+function compareFunctionMetrics(a, b) {
+    for (const comparison of functionMetricComparisons(a, b)) {
+        if (comparison !== 0)
+            return comparison;
+    }
+    return 0;
+}
+function functionMetricComparisons(a, b) {
+    return [
+        compareText(a.file, b.file),
+        a.startLine - b.startLine,
+        a.endLine - b.endLine,
+        compareText(a.name, b.name),
+        a.lines - b.lines,
+        (a.cyclomaticComplexity.value ?? -1) - (b.cyclomaticComplexity.value ?? -1),
+        a.parameterCount - b.parameterCount
+    ];
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function parseInteger(value, minimum) {
+    const text = (value ?? "").trim();
+    if (!/^\d+$/.test(text)) {
+        return null;
+    }
+    const parsed = Number(text);
+    return Number.isSafeInteger(parsed) && parsed >= minimum ? parsed : null;
+}
+function isLizard123Header(parts) {
+    return (parts.length >= 11 &&
+        parts[LIZARD_COLUMNS.nloc] === "NLOC" &&
+        parts[LIZARD_COLUMNS.ccn] === "CCN" &&
+        parts[LIZARD_COLUMNS.parameterCount] === "parameter count" &&
+        parts[LIZARD_COLUMNS.filePath] === "file path" &&
+        parts[LIZARD_COLUMNS.functionName] === "function name" &&
+        parts[LIZARD_COLUMNS.startLine] === "start line" &&
+        parts[LIZARD_COLUMNS.endLine] === "end line");
+}
+//# sourceMappingURL=parser.mjs.map

package/dist/esm/package-checks/function-metrics/lizard/parser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/function-metrics/lizard/parser.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FunctionMetric } from \"../measurement-model.ts\";\nimport type { ExactInputMeasurement } from \"../../project-files/exact-input-measurement.ts\";\nimport { errorMessage } from \"../../host-environment/error-message.ts\";\nimport { parseCsvRows } from \"./csv.ts\";\nimport { normalizeScannerReportedPath } from \"../../project-files/reported-path.ts\";\n\nexport type LizardParseResult =\n  | {\n      readonly measurements: readonly ExactInputMeasurement<FunctionMetric>[];\n      readonly ok: true;\n    }\n  | {\n      readonly error: string;\n      readonly ok: false;\n      readonly reason: \"invalid-result\";\n    };\n\nconst LIZARD_COLUMNS = {\n  nloc: 0,\n  ccn: 1,\n  parameterCount: 3,\n  filePath: 6,\n  functionName: 7,\n  startLine: 9,\n  endLine: 10\n} as const;\n\n/**\n * 将 Lizard CSV 输出解析为 FunctionMetric 数组。\n *\n * Lizard 1.23 CSV 列（--csv）：\n * NLOC,CCN,token count,parameter count,length,location,file path,function name,long name,start line,end line\n */\nexport function parseLizardCSV(csv: string, cwd: string): LizardParseResult {\n  try {\n    const measurements: ExactInputMeasurement<FunctionMetric>[] = [];\n\n    for (const [index, row] of lizardDataRows(parseCsvRows(csv)).entries()) {\n      const measurement = functionMetricFromLizardRow(row, cwd);\n      if (!measurement) {\n        throw new Error(`invalid Lizard 1.23 CSV row ${index + 1}`);\n      }\n      measurements.push(measurement);\n    }\n\n    measurements.sort((a, b) => compareFunctionMetrics(a.payload, b.payload));\n\n    return { ok: true, measurements };\n  } catch (error: unknown) {\n    return {\n      ok: false,\n      error: `Failed to parse lizard CSV: ${errorMessage(error)}`,\n      reason: \"invalid-result\"\n    };\n  }\n}\n\nfunction lizardDataRows(rows: string[][]): string[][] {\n  const header = rows[0] ?? [];\n  return isLizard123Header(header) ? rows.slice(1) : rows;\n}\n\nfunction functionMetricFromLizardRow(\n  parts: string[],\n  cwd: string\n): ExactInputMeasurement<FunctionMetric> | null {\n  if (parts.length < 11) {\n    return null;\n  }\n\n  const values = parseLizardMetricValues(parts);\n  if (!values) {\n    return null;\n  }\n\n  const filePath = (parts[LIZARD_COLUMNS.filePath] ?? \"\").trim();\n  if (filePath.length === 0 || values.endLine < values.startLine) {\n    return null;\n  }\n  const sourcePath = normalizeScannerReportedPath(filePath, cwd);\n\n  return {\n    sourcePaths: [sourcePath],\n    payload: {\n      name: parts[LIZARD_COLUMNS.functionName] || \"unknown\",\n      file: sourcePath,\n      startLine: values.startLine,\n      endLine: values.endLine,\n      lines: values.nloc,\n      parameterCount: values.parameterCount,\n      cyclomaticComplexity: {\n        value: values.ccn,\n        source: \"lizard\"\n      }\n    }\n  };\n}\n\ninterface LizardMetricValues {\n  readonly ccn: number | null;\n  readonly endLine: number;\n  readonly nloc: number;\n  readonly parameterCount: number;\n  readonly startLine: number;\n}\n\nfunction parseLizardMetricValues(parts: string[]): LizardMetricValues | null {\n  const ccnText = parts[LIZARD_COLUMNS.ccn].trim();\n  const ccn = ccnText === \"\" ? null : parseInteger(ccnText, 0);\n  const endLine = parseInteger(parts[LIZARD_COLUMNS.endLine], 1);\n  const nloc = parseInteger(parts[LIZARD_COLUMNS.nloc], 0);\n  const parameterCount = parseInteger(parts[LIZARD_COLUMNS.parameterCount], 0);\n  const startLine = parseInteger(parts[LIZARD_COLUMNS.startLine], 1);\n\n  if (\n    (ccnText !== \"\" && ccn === null) ||\n    endLine === null ||\n    nloc === null ||\n    parameterCount === null ||\n    startLine === null\n  ) {\n    return null;\n  }\n\n  return {\n    ccn,\n    endLine,\n    nloc,\n    parameterCount,\n    startLine\n  };\n}\n\nfunction compareFunctionMetrics(a: FunctionMetric, b: FunctionMetric): number {\n  for (const comparison of functionMetricComparisons(a, b)) {\n    if (comparison !== 0) return comparison;\n  }\n  return 0;\n}\n\nfunction functionMetricComparisons(a: FunctionMetric, b: FunctionMetric): readonly number[] {\n  return [\n    compareText(a.file, b.file),\n    a.startLine - b.startLine,\n    a.endLine - b.endLine,\n    compareText(a.name, b.name),\n    a.lines - b.lines,\n    (a.cyclomaticComplexity.value ?? -1) - (b.cyclomaticComplexity.value ?? -1),\n    a.parameterCount - b.parameterCount\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\nfunction parseInteger(value: string | undefined, minimum: number): number | null {\n  const text = (value ?? \"\").trim();\n  if (!/^\\d+$/.test(text)) {\n    return null;\n  }\n  const parsed = Number(text);\n  return Number.isSafeInteger(parsed) && parsed >= minimum ? parsed : null;\n}\n\nfunction isLizard123Header(parts: string[]): boolean {\n  return (\n    parts.length >= 11 &&\n    parts[LIZARD_COLUMNS.nloc] === \"NLOC\" &&\n    parts[LIZARD_COLUMNS.ccn] === \"CCN\" &&\n    parts[LIZARD_COLUMNS.parameterCount] === \"parameter count\" &&\n    parts[LIZARD_COLUMNS.filePath] === \"file path\" &&\n    parts[LIZARD_COLUMNS.functionName] === \"function name\" &&\n    parts[LIZARD_COLUMNS.startLine] === \"start line\" &&\n    parts[LIZARD_COLUMNS.endLine] === \"end line\"\n  );\n}\n"]}

package/dist/esm/package-checks/function-metrics/lizard/scanner.mjs

@@ -0,0 +1,35 @@
+/** 对 approved exact paths 执行 adapter-owned Lizard CSV 协议。 */
+import { errorMessage } from "../../host-environment/error-message.mjs";
+import { runProcessSync } from "../../host-environment/process/command.mjs";
+import { parseLizardCSV } from "./parser.mjs";
+export function scanWithLizard({ files, cwd, dependency }) {
+    try {
+        if (files.length === 0)
+            return { ok: true, measurements: [] };
+        const child = runProcessSync({
+            args: [...files, "--csv"],
+            command: dependency.executable,
+            cwd,
+            timeout: 300_000
+        });
+        if (child.signal !== null) {
+            return failedLizardScan(`lizard signal ${child.signal}: ${(child.stderr || child.stdout || "no output").trim()}`);
+        }
+        if (child.error) {
+            return failedLizardScan(`lizard process error: ${child.error.message}`);
+        }
+        if (child.status !== 0) {
+            const stderr = (child.stderr || "").trim();
+            const stdout = (child.stdout || "").trim();
+            return failedLizardScan(`lizard ${child.status === null ? "invalid process state" : `exit ${child.status}`}: ${stderr || stdout || "no output"}`);
+        }
+        return parseLizardCSV(child.stdout || "", cwd);
+    }
+    catch (error) {
+        return failedLizardScan(`lizard adapter error: ${errorMessage(error)}`);
+    }
+}
+function failedLizardScan(error) {
+    return Object.freeze({ error, ok: false, reason: "execution" });
+}
+//# sourceMappingURL=scanner.mjs.map

package/dist/esm/package-checks/function-metrics/lizard/scanner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/function-metrics/lizard/scanner.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAE3E,OAAO,EAAE,cAAc,EAA0B,MAAM,aAAa,CAAC;AAgBrE,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EACL,GAAG,EACH,UAAU,EACY;IACtB,IAAI,CAAC;QACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;QAE9D,MAAM,KAAK,GAAG,cAAc,CAAC;YAC3B,IAAI,EAAE,CAAC,GAAG,KAAK,EAAE,OAAO,CAAC;YACzB,OAAO,EAAE,UAAU,CAAC,UAAU;YAC9B,GAAG;YACH,OAAO,EAAE,OAAO;SACjB,CAAC,CAAC;QAEH,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YAC1B,OAAO,gBAAgB,CACrB,iBAAiB,KAAK,CAAC,MAAM,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,IAAI,EAAE,EAAE,CACzF,CAAC;QACJ,CAAC;QACD,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,gBAAgB,CAAC,yBAAyB,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3C,OAAO,gBAAgB,CACrB,UAAU,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,QAAQ,KAAK,CAAC,MAAM,EAAE,KAAK,MAAM,IAAI,MAAM,IAAI,WAAW,EAAE,CACzH,CAAC;QACJ,CAAC;QAED,OAAO,cAAc,CAAC,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,gBAAgB,CAAC,yBAAyB,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAa;IACrC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;AAClE,CAAC","sourcesContent":["/** 对 approved exact paths 执行 adapter-owned Lizard CSV 协议。 */\n\nimport { errorMessage } from \"../../host-environment/error-message.ts\";\nimport { runProcessSync } from \"../../host-environment/process/command.ts\";\nimport type { ResolvedFunctionMetricsScannerOptions } from \"../options.ts\";\nimport { parseLizardCSV, type LizardParseResult } from \"./parser.ts\";\n\nexport type LizardScanResult =\n  | LizardParseResult\n  | Readonly<{\n      error: string;\n      ok: false;\n      reason: \"execution\";\n    }>;\n\ninterface ScanWithLizardOptions {\n  readonly cwd: string;\n  readonly dependency: ResolvedFunctionMetricsScannerOptions;\n  readonly files: readonly string[];\n}\n\nexport function scanWithLizard({\n  files,\n  cwd,\n  dependency\n}: ScanWithLizardOptions): LizardScanResult {\n  try {\n    if (files.length === 0) return { ok: true, measurements: [] };\n\n    const child = runProcessSync({\n      args: [...files, \"--csv\"],\n      command: dependency.executable,\n      cwd,\n      timeout: 300_000\n    });\n\n    if (child.signal !== null) {\n      return failedLizardScan(\n        `lizard signal ${child.signal}: ${(child.stderr || child.stdout || \"no output\").trim()}`\n      );\n    }\n    if (child.error) {\n      return failedLizardScan(`lizard process error: ${child.error.message}`);\n    }\n\n    if (child.status !== 0) {\n      const stderr = (child.stderr || \"\").trim();\n      const stdout = (child.stdout || \"\").trim();\n      return failedLizardScan(\n        `lizard ${child.status === null ? \"invalid process state\" : `exit ${child.status}`}: ${stderr || stdout || \"no output\"}`\n      );\n    }\n\n    return parseLizardCSV(child.stdout || \"\", cwd);\n  } catch (error: unknown) {\n    return failedLizardScan(`lizard adapter error: ${errorMessage(error)}`);\n  }\n}\n\nfunction failedLizardScan(error: string): LizardScanResult {\n  return Object.freeze({ error, ok: false, reason: \"execution\" });\n}\n"]}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"measurement-model.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/measurement-model.ts"],"names":[],"mappings":"","sourcesContent":["import type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { ResolvedFunctionMetricsLimits } from \"./options.ts\";\n\nexport interface MetricValue {\n  readonly source: \"lizard\";\n  readonly value: number | null;\n}\n\nexport interface FunctionMetric {\n  readonly cyclomaticComplexity: MetricValue;\n  readonly endLine: number;\n  readonly file: string;\n  readonly lines: number;\n  readonly name: string;\n  readonly parameterCount: number;\n  readonly startLine: number;\n}\n\nexport interface FunctionMetricsAreaInput {\n  readonly approvedExactPaths: readonly string[];\n  readonly codeArea: string;\n  readonly findingPolicy: FindingPolicy;\n  readonly limits: ResolvedFunctionMetricsLimits;\n}\n\nexport interface FunctionMetricsExactInputSet {\n  readonly approvedExactPaths: readonly string[];\n  readonly areas: readonly FunctionMetricsAreaInput[];\n  readonly rootDir: string;\n}\n"]}

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

@@ -0,0 +1,35 @@
+import { acceptExactInputMeasurements } from "../project-files/exact-input-measurement.mjs";
+import { checkLizard } from "./lizard/availability.mjs";
+import { scanWithLizard } from "./lizard/scanner.mjs";
+export async function measureFunctionMetrics({ dependency, input, signal }) {
+    if (signal.aborted)
+        return Object.freeze({ kind: "cancelled" });
+    if (input.approvedExactPaths.length === 0) {
+        return Object.freeze({ kind: "complete", metrics: Object.freeze([]) });
+    }
+    const availability = await checkLizard(input.rootDir, dependency);
+    if (signal.aborted)
+        return Object.freeze({ kind: "cancelled" });
+    if (!availability.available) {
+        return Object.freeze({ kind: "unavailable" });
+    }
+    const measurement = runFunctionScanner(input, dependency);
+    return signal.aborted ? Object.freeze({ kind: "cancelled" }) : measurement;
+}
+function runFunctionScanner(input, dependency) {
+    const result = scanWithLizard({
+        cwd: input.rootDir,
+        dependency,
+        files: input.approvedExactPaths
+    });
+    if (!result.ok) {
+        return Object.freeze({
+            kind: result.reason === "execution" ? "execution-failed" : "invalid-result"
+        });
+    }
+    const accepted = acceptExactInputMeasurements(result.measurements, input.approvedExactPaths);
+    return accepted.ok
+        ? Object.freeze({ kind: "complete", metrics: Object.freeze([...accepted.payloads]) })
+        : Object.freeze({ kind: "invalid-result" });
+}
+//# sourceMappingURL=measurement.mjs.map