@zxyycom/vibe-check 0.0.1

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

@@ -0,0 +1,109 @@
+import { isBlockingFinding } from "../code-quality-findings/policy.mjs";
+import { isNormalizedProjectRelativePath } from "../host-environment/path.mjs";
+const FILE_CODE_LINES_METRIC = "code-lines";
+const FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX = "/finding-waiver-audit/";
+/** 仅为未使用和过宽 waiver 构造补充 audit Record；正常 applied waiver 由 finding Record 自己保留。 */
+export function fileMetricsWaiverAuditRecord(audit) {
+    if (audit.status === "applied")
+        return undefined;
+    const identity = fileMetricsWaiverIdentity(audit.waiver);
+    return Object.freeze({
+        data: Object.freeze({
+            identity,
+            kind: "finding-waiver-audit",
+            matchCount: audit.matchCount,
+            reason: audit.waiver.reason,
+            status: audit.status
+        }),
+        id: `${FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX}${identity.path}`
+    });
+}
+export function fileMetricsWaiverIdentity(waiver) {
+    const identity = waiver.identity;
+    if (!isCanonicalObject(identity) ||
+        identity.metric !== "code-lines" ||
+        typeof identity.path !== "string" ||
+        !isNormalizedProjectRelativePath(identity.path)) {
+        throw new TypeError("fileMetrics waiver identity must retain a normalized code-lines path");
+    }
+    return Object.freeze({ metric: "code-lines", path: identity.path });
+}
+function isCanonicalObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Converts trusted scanner metrics into area-policy-owned supplemental facts. */
+export function buildFileRecordCandidates(metrics, areaPolicy) {
+    const seenPaths = new Set();
+    const candidates = [];
+    for (const metric of metrics) {
+        if (!isValidUniqueFileMetric(metric, seenPaths))
+            return undefined;
+        seenPaths.add(metric.path);
+        const recordPolicy = effectiveFileRecordPolicy(metric, areaPolicy);
+        if (recordPolicy === undefined)
+            return undefined;
+        if (metric.codeLines <= recordPolicy.limit)
+            continue;
+        candidates.push(createFileRecordCandidate(metric, recordPolicy));
+    }
+    candidates.sort((left, right) => compareText(left.id, right.id));
+    return Object.freeze(candidates);
+}
+function isValidUniqueFileMetric(metric, seenPaths) {
+    return (typeof metric.path === "string" &&
+        metric.path.length > 0 &&
+        Number.isSafeInteger(metric.codeLines) &&
+        metric.codeLines >= 0 &&
+        !seenPaths.has(metric.path));
+}
+function effectiveFileRecordPolicy(metric, areaPolicy) {
+    const areaIds = areaPolicy.areaIdsByPath.get(metric.path);
+    if (areaIds === undefined || areaIds.length === 0)
+        return undefined;
+    const matchingAreas = [];
+    let strictestMaximum;
+    for (const areaId of areaIds) {
+        const codeArea = areaPolicy.codeAreas[areaId];
+        if (codeArea === undefined)
+            return undefined;
+        matchingAreas.push(codeArea);
+        const maximum = fileCodeLineMaximum(metric, codeArea);
+        strictestMaximum =
+            strictestMaximum === undefined ? maximum : Math.min(strictestMaximum, maximum);
+    }
+    return strictestMaximum === undefined
+        ? undefined
+        : Object.freeze({
+            areaIds,
+            blocking: isBlockingFinding(matchingAreas.map((area) => area.findingPolicy)),
+            limit: strictestMaximum
+        });
+}
+function createFileRecordCandidate(metric, recordPolicy) {
+    return Object.freeze({
+        id: metric.path,
+        data: Object.freeze({
+            blocking: recordPolicy.blocking,
+            codeAreas: Object.freeze([...recordPolicy.areaIds]),
+            codeLines: metric.codeLines,
+            limit: recordPolicy.limit,
+            metric: FILE_CODE_LINES_METRIC,
+            path: metric.path
+        })
+    });
+}
+function fileCodeLineMaximum(metric, area) {
+    const allowance = area.codeLines.lowDecisionTokenAllowance;
+    const decisionTokens = metric.decisionTokens.value;
+    return decisionTokens !== null && decisionTokens <= allowance.maximumDecisionTokens
+        ? allowance.maximumCodeLines
+        : area.codeLines.maximum;
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=records.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"records.mjs","sourceRoot":"","sources":["../../../../src/package-checks/file-metrics/records.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAU9E,MAAM,sBAAsB,GAAG,YAAqB,CAAC;AACrD,MAAM,qCAAqC,GAAG,wBAAwB,CAAC;AA4CvE,iFAAiF;AACjF,MAAM,UAAU,4BAA4B,CAC1C,KAAyB;IAIzB,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACjD,MAAM,QAAQ,GAAG,yBAAyB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,QAAQ;YACR,IAAI,EAAE,sBAAsB;YAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;YAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC;QACF,EAAE,EAAE,GAAG,qCAAqC,GAAG,QAAQ,CAAC,IAAI,EAAE;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAAiC;IAEjC,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IACjC,IACE,CAAC,iBAAiB,CAAC,QAAQ,CAAC;QAC5B,QAAQ,CAAC,MAAM,KAAK,YAAY;QAChC,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ;QACjC,CAAC,+BAA+B,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC/C,CAAC;QACD,MAAM,IAAI,SAAS,CAAC,sEAAsE,CAAC,CAAC;IAC9F,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAyB;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,yBAAyB,CACvC,OAA8B,EAC9B,UAAwC;IAExC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,MAAM,UAAU,GAA0B,EAAE,CAAC;IAC7C,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAClE,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAE3B,MAAM,YAAY,GAAG,yBAAyB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACnE,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QACjD,IAAI,MAAM,CAAC,SAAS,IAAI,YAAY,CAAC,KAAK;YAAE,SAAS;QACrD,UAAU,CAAC,IAAI,CAAC,yBAAyB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACnE,CAAC;IACD,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,uBAAuB,CAAC,MAAkB,EAAE,SAA8B;IACjF,OAAO,CACL,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;QAC/B,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;QACtB,MAAM,CAAC,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC;QACtC,MAAM,CAAC,SAAS,IAAI,CAAC;QACrB,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAC5B,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB,CAChC,MAAkB,EAClB,UAAwC;IAExC,MAAM,OAAO,GAAG,UAAU,CAAC,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC1D,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACpE,MAAM,aAAa,GAAyC,EAAE,CAAC;IAC/D,IAAI,gBAAoC,CAAC;IACzC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC9C,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC7C,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC7B,MAAM,OAAO,GAAG,mBAAmB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACtD,gBAAgB;YACd,gBAAgB,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IACnF,CAAC;IACD,OAAO,gBAAgB,KAAK,SAAS;QACnC,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,OAAO;YACP,QAAQ,EAAE,iBAAiB,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC5E,KAAK,EAAE,gBAAgB;SACxB,CAAC,CAAC;AACT,CAAC;AAED,SAAS,yBAAyB,CAChC,MAAkB,EAClB,YAAuC;IAEvC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,MAAM,CAAC,IAAI;QACf,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC;YAClB,QAAQ,EAAE,YAAY,CAAC,QAAQ;YAC/B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACnD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,KAAK,EAAE,YAAY,CAAC,KAAK;YACzB,MAAM,EAAE,sBAAsB;YAC9B,IAAI,EAAE,MAAM,CAAC,IAAI;SAClB,CAAC;KACH,CAAC,CAAC;AACL,CAAC;AAED,SAAS,mBAAmB,CAAC,MAAkB,EAAE,IAAwC;IACvF,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,yBAAyB,CAAC;IAC3D,MAAM,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC;IACnD,OAAO,cAAc,KAAK,IAAI,IAAI,cAAc,IAAI,SAAS,CAAC,qBAAqB;QACjF,CAAC,CAAC,SAAS,CAAC,gBAAgB;QAC5B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;AAC7B,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC,CAAC;IAC5B,IAAI,IAAI,GAAG,KAAK;QAAE,OAAO,CAAC,CAAC;IAC3B,OAAO,CAAC,CAAC;AACX,CAAC","sourcesContent":["import type { FileMetric } from \"./measurement-model.ts\";\nimport type { FileMetricsFindingIdentity, ResolvedFileMetricsCodeAreaOptions } from \"./options.ts\";\nimport { isBlockingFinding } from \"../code-quality-findings/policy.ts\";\nimport { isNormalizedProjectRelativePath } from \"../host-environment/path.ts\";\nimport type {\n  FindingWaiverAudit,\n  MaterializedFindingWaiver\n} from \"../../finding-waivers/reconciliation.ts\";\nimport type {\n  CanonicalJsonObject,\n  CanonicalJsonValue\n} from \"../../data-boundary/canonical-data.ts\";\n\nconst FILE_CODE_LINES_METRIC = \"code-lines\" as const;\nconst FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX = \"/finding-waiver-audit/\";\n\ninterface FileMetricsAreaPolicyContext {\n  readonly areaIdsByPath: ReadonlyMap<string, readonly string[]>;\n  readonly codeAreas: Readonly<Record<string, ResolvedFileMetricsCodeAreaOptions>>;\n}\n\ninterface EffectiveFileRecordPolicy {\n  readonly areaIds: readonly string[];\n  readonly blocking: boolean;\n  readonly limit: number;\n}\n\n/** 一条超出文件代码行上限的 supplemental Record data。 */\nexport type FileMetricsFindingRecordData = Readonly<{\n  readonly blocking: boolean;\n  readonly codeAreas: readonly string[];\n  readonly codeLines: number;\n  readonly limit: number;\n  readonly metric: \"code-lines\";\n  readonly path: string;\n  /** 精确匹配 waiver 时保留理由，并令该 finding 不再参与 actionable settlement。 */\n  readonly waiver?: Readonly<{ readonly reason: string }>;\n}>;\n\n/** 未使用或过宽 file-metrics waiver 的 supplemental audit Record data。 */\nexport type FileMetricsFindingWaiverAuditRecordData = Readonly<{\n  readonly identity: FileMetricsFindingIdentity;\n  readonly kind: \"finding-waiver-audit\";\n  readonly matchCount: number;\n  readonly reason: string;\n  readonly status: \"overmatched\" | \"unused\";\n}>;\n\n/** file-metrics 发布的 finding 或 waiver-audit supplemental Record data。 */\nexport type FileMetricsRecordData =\n  | FileMetricsFindingRecordData\n  | FileMetricsFindingWaiverAuditRecordData;\n\nexport interface FileRecordCandidate {\n  readonly data: FileMetricsFindingRecordData;\n  readonly id: string;\n}\n\n/** 仅为未使用和过宽 waiver 构造补充 audit Record；正常 applied waiver 由 finding Record 自己保留。 */\nexport function fileMetricsWaiverAuditRecord(\n  audit: FindingWaiverAudit\n):\n  | Readonly<{ readonly data: FileMetricsFindingWaiverAuditRecordData; readonly id: string }>\n  | undefined {\n  if (audit.status === \"applied\") return undefined;\n  const identity = fileMetricsWaiverIdentity(audit.waiver);\n  return Object.freeze({\n    data: Object.freeze({\n      identity,\n      kind: \"finding-waiver-audit\",\n      matchCount: audit.matchCount,\n      reason: audit.waiver.reason,\n      status: audit.status\n    }),\n    id: `${FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX}${identity.path}`\n  });\n}\n\nexport function fileMetricsWaiverIdentity(\n  waiver: MaterializedFindingWaiver\n): FileMetricsFindingIdentity {\n  const identity = waiver.identity;\n  if (\n    !isCanonicalObject(identity) ||\n    identity.metric !== \"code-lines\" ||\n    typeof identity.path !== \"string\" ||\n    !isNormalizedProjectRelativePath(identity.path)\n  ) {\n    throw new TypeError(\"fileMetrics waiver identity must retain a normalized code-lines path\");\n  }\n  return Object.freeze({ metric: \"code-lines\", path: identity.path });\n}\n\nfunction isCanonicalObject(value: CanonicalJsonValue): value is CanonicalJsonObject {\n  return typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\n/** Converts trusted scanner metrics into area-policy-owned supplemental facts. */\nexport function buildFileRecordCandidates(\n  metrics: readonly FileMetric[],\n  areaPolicy: FileMetricsAreaPolicyContext\n): readonly FileRecordCandidate[] | undefined {\n  const seenPaths = new Set<string>();\n  const candidates: FileRecordCandidate[] = [];\n  for (const metric of metrics) {\n    if (!isValidUniqueFileMetric(metric, seenPaths)) return undefined;\n    seenPaths.add(metric.path);\n\n    const recordPolicy = effectiveFileRecordPolicy(metric, areaPolicy);\n    if (recordPolicy === undefined) return undefined;\n    if (metric.codeLines <= recordPolicy.limit) continue;\n    candidates.push(createFileRecordCandidate(metric, recordPolicy));\n  }\n  candidates.sort((left, right) => compareText(left.id, right.id));\n  return Object.freeze(candidates);\n}\n\nfunction isValidUniqueFileMetric(metric: FileMetric, seenPaths: ReadonlySet<string>): boolean {\n  return (\n    typeof metric.path === \"string\" &&\n    metric.path.length > 0 &&\n    Number.isSafeInteger(metric.codeLines) &&\n    metric.codeLines >= 0 &&\n    !seenPaths.has(metric.path)\n  );\n}\n\nfunction effectiveFileRecordPolicy(\n  metric: FileMetric,\n  areaPolicy: FileMetricsAreaPolicyContext\n): EffectiveFileRecordPolicy | undefined {\n  const areaIds = areaPolicy.areaIdsByPath.get(metric.path);\n  if (areaIds === undefined || areaIds.length === 0) return undefined;\n  const matchingAreas: ResolvedFileMetricsCodeAreaOptions[] = [];\n  let strictestMaximum: number | undefined;\n  for (const areaId of areaIds) {\n    const codeArea = areaPolicy.codeAreas[areaId];\n    if (codeArea === undefined) return undefined;\n    matchingAreas.push(codeArea);\n    const maximum = fileCodeLineMaximum(metric, codeArea);\n    strictestMaximum =\n      strictestMaximum === undefined ? maximum : Math.min(strictestMaximum, maximum);\n  }\n  return strictestMaximum === undefined\n    ? undefined\n    : Object.freeze({\n        areaIds,\n        blocking: isBlockingFinding(matchingAreas.map((area) => area.findingPolicy)),\n        limit: strictestMaximum\n      });\n}\n\nfunction createFileRecordCandidate(\n  metric: FileMetric,\n  recordPolicy: EffectiveFileRecordPolicy\n): FileRecordCandidate {\n  return Object.freeze({\n    id: metric.path,\n    data: Object.freeze({\n      blocking: recordPolicy.blocking,\n      codeAreas: Object.freeze([...recordPolicy.areaIds]),\n      codeLines: metric.codeLines,\n      limit: recordPolicy.limit,\n      metric: FILE_CODE_LINES_METRIC,\n      path: metric.path\n    })\n  });\n}\n\nfunction fileCodeLineMaximum(metric: FileMetric, area: ResolvedFileMetricsCodeAreaOptions): number {\n  const allowance = area.codeLines.lowDecisionTokenAllowance;\n  const decisionTokens = metric.decisionTokens.value;\n  return decisionTokens !== null && decisionTokens <= allowance.maximumDecisionTokens\n    ? allowance.maximumCodeLines\n    : area.codeLines.maximum;\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/scc/availability.mjs

@@ -0,0 +1,59 @@
+import { errorMessage } from "../../host-environment/error-message.mjs";
+import { processFailure, runProcess } from "../../host-environment/process/command.mjs";
+import { SCC_VERSION_OUTPUT } from "./parser.mjs";
+const SCC_VERSION_ARGUMENTS = Object.freeze(["--version"]);
+export async function checkScc(rootDir, scanner) {
+    try {
+        const commandResult = await runProcess({
+            args: SCC_VERSION_ARGUMENTS,
+            command: scanner.executable,
+            cwd: rootDir
+        });
+        return availabilityFromVersionResult(commandResult);
+    }
+    catch (error) {
+        return unavailableScc(`scc version error: ${errorMessage(error)}`, "execution-error");
+    }
+}
+function availabilityFromVersionResult(commandResult) {
+    if (commandResult.error)
+        return processErrorAvailability(commandResult.error);
+    const version = commandOutput(commandResult);
+    if (commandResult.status !== 0) {
+        return unavailableScc(`scc --version failed, ${processTermination(commandResult)}${version ? `: ${version}` : ""}`, "execution-error");
+    }
+    if (version !== SCC_VERSION_OUTPUT) {
+        return unavailableScc(`expected ${SCC_VERSION_OUTPUT}, got "${version || "unknown"}"`, "contract-error");
+    }
+    return {
+        name: "scc",
+        available: true,
+        version,
+        error: null,
+        source: "configured command",
+        reason: null
+    };
+}
+function processErrorAvailability(error) {
+    const isMissingTool = processFailure(error).code === "ENOENT";
+    return unavailableScc(isMissingTool ? `scc not installed: ${error.message}` : `scc version error: ${error.message}`, isMissingTool ? "tool-unavailable" : "execution-error");
+}
+function unavailableScc(error, reason) {
+    return {
+        name: "scc",
+        available: false,
+        version: null,
+        error,
+        source: "configured command",
+        reason
+    };
+}
+function commandOutput(commandResult) {
+    return (commandResult.stdout || "").trim() || (commandResult.stderr || "").trim();
+}
+function processTermination(commandResult) {
+    return typeof commandResult.status === "number"
+        ? `exit ${commandResult.status}`
+        : `signal ${commandResult.signal || "unknown"}`;
+}
+//# sourceMappingURL=availability.mjs.map

package/dist/esm/package-checks/file-metrics/scc/availability.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"availability.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/file-metrics/scc/availability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,2CAA2C,CAAC;AAEvF,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAuB3D,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,OAAe,EACf,OAA0C;IAE1C,IAAI,CAAC;QACH,MAAM,aAAa,GAAG,MAAM,UAAU,CAAC;YACrC,IAAI,EAAE,qBAAqB;YAC3B,OAAO,EAAE,OAAO,CAAC,UAAU;YAC3B,GAAG,EAAE,OAAO;SACb,CAAC,CAAC;QACH,OAAO,6BAA6B,CAAC,aAAa,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,cAAc,CAAC,sBAAsB,YAAY,CAAC,KAAK,CAAC,EAAE,EAAE,iBAAiB,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,SAAS,6BAA6B,CAAC,aAAsC;IAC3E,IAAI,aAAa,CAAC,KAAK;QAAE,OAAO,wBAAwB,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;IAC7C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC/B,OAAO,cAAc,CACnB,yBAAyB,kBAAkB,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAC5F,iBAAiB,CAClB,CAAC;IACJ,CAAC;IACD,IAAI,OAAO,KAAK,kBAAkB,EAAE,CAAC;QACnC,OAAO,cAAc,CACnB,YAAY,kBAAkB,UAAU,OAAO,IAAI,SAAS,GAAG,EAC/D,gBAAgB,CACjB,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,IAAI;QACf,OAAO;QACP,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,oBAAoB;QAC5B,MAAM,EAAE,IAAI;KACb,CAAC;AACJ,CAAC;AAED,SAAS,wBAAwB,CAAC,KAAY;IAC5C,MAAM,aAAa,GAAG,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;IAC9D,OAAO,cAAc,CACnB,aAAa,CAAC,CAAC,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,sBAAsB,KAAK,CAAC,OAAO,EAAE,EAC7F,aAAa,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC,iBAAiB,CACvD,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CACrB,KAAa,EACb,MAAgD;IAEhD,OAAO;QACL,IAAI,EAAE,KAAK;QACX,SAAS,EAAE,KAAK;QAChB,OAAO,EAAE,IAAI;QACb,KAAK;QACL,MAAM,EAAE,oBAAoB;QAC5B,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,aAAsC;IAC3D,OAAO,CAAC,aAAa,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,aAAa,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACpF,CAAC;AAED,SAAS,kBAAkB,CAAC,aAAsC;IAChE,OAAO,OAAO,aAAa,CAAC,MAAM,KAAK,QAAQ;QAC7C,CAAC,CAAC,QAAQ,aAAa,CAAC,MAAM,EAAE;QAChC,CAAC,CAAC,UAAU,aAAa,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;AACpD,CAAC","sourcesContent":["import { errorMessage } from \"../../host-environment/error-message.ts\";\nimport { processFailure, runProcess } from \"../../host-environment/process/command.ts\";\nimport type { ResolvedFileMetricsScannerOptions } from \"../options.ts\";\nimport { SCC_VERSION_OUTPUT } from \"./parser.ts\";\n\nconst SCC_VERSION_ARGUMENTS = Object.freeze([\"--version\"]);\n\ntype SccAvailability = Readonly<\n  | {\n      readonly available: true;\n      readonly error: null;\n      readonly name: \"scc\";\n      readonly reason: null;\n      readonly source: \"configured command\";\n      readonly version: string;\n    }\n  | {\n      readonly available: false;\n      readonly error: string;\n      readonly name: \"scc\";\n      readonly reason: \"contract-error\" | \"execution-error\" | \"tool-unavailable\";\n      readonly source: \"configured command\";\n      readonly version: null;\n    }\n>;\n\ntype SccVersionCommandResult = Awaited<ReturnType<typeof runProcess>>;\n\nexport async function checkScc(\n  rootDir: string,\n  scanner: ResolvedFileMetricsScannerOptions\n): Promise<SccAvailability> {\n  try {\n    const commandResult = await runProcess({\n      args: SCC_VERSION_ARGUMENTS,\n      command: scanner.executable,\n      cwd: rootDir\n    });\n    return availabilityFromVersionResult(commandResult);\n  } catch (error: unknown) {\n    return unavailableScc(`scc version error: ${errorMessage(error)}`, \"execution-error\");\n  }\n}\n\nfunction availabilityFromVersionResult(commandResult: SccVersionCommandResult): SccAvailability {\n  if (commandResult.error) return processErrorAvailability(commandResult.error);\n  const version = commandOutput(commandResult);\n  if (commandResult.status !== 0) {\n    return unavailableScc(\n      `scc --version failed, ${processTermination(commandResult)}${version ? `: ${version}` : \"\"}`,\n      \"execution-error\"\n    );\n  }\n  if (version !== SCC_VERSION_OUTPUT) {\n    return unavailableScc(\n      `expected ${SCC_VERSION_OUTPUT}, got \"${version || \"unknown\"}\"`,\n      \"contract-error\"\n    );\n  }\n  return {\n    name: \"scc\",\n    available: true,\n    version,\n    error: null,\n    source: \"configured command\",\n    reason: null\n  };\n}\n\nfunction processErrorAvailability(error: Error): SccAvailability {\n  const isMissingTool = processFailure(error).code === \"ENOENT\";\n  return unavailableScc(\n    isMissingTool ? `scc not installed: ${error.message}` : `scc version error: ${error.message}`,\n    isMissingTool ? \"tool-unavailable\" : \"execution-error\"\n  );\n}\n\nfunction unavailableScc(\n  error: string,\n  reason: Exclude<SccAvailability[\"reason\"], null>\n): SccAvailability {\n  return {\n    name: \"scc\",\n    available: false,\n    version: null,\n    error,\n    source: \"configured command\",\n    reason\n  };\n}\n\nfunction commandOutput(commandResult: SccVersionCommandResult): string {\n  return (commandResult.stdout || \"\").trim() || (commandResult.stderr || \"\").trim();\n}\n\nfunction processTermination(commandResult: SccVersionCommandResult): string {\n  return typeof commandResult.status === \"number\"\n    ? `exit ${commandResult.status}`\n    : `signal ${commandResult.signal || \"unknown\"}`;\n}\n"]}

package/dist/esm/package-checks/file-metrics/scc/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/file-metrics/scc/csv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/file-metrics/scc/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/file-metrics/scc/parser.mjs

@@ -0,0 +1,145 @@
+import { errorMessage } from "../../host-environment/error-message.mjs";
+import { normalizeScannerReportedPath } from "../../project-files/reported-path.mjs";
+import { parseCsvRows } from "./csv.mjs";
+export const SCC_VERSION = "3.7.0";
+export const SCC_VERSION_OUTPUT = `scc version ${SCC_VERSION}`;
+export const SCC_BY_FILE_CSV_HEADER = "Language,Provider,Filename,Lines,Code,Comments,Blanks,Complexity,Bytes,ULOC";
+/**
+ * 解析 scc CSV 输出。
+ *
+ * scc 3.7.0 `--by-file --format csv` 列：
+ * Language,Provider,Filename,Lines,Code,Comments,Blanks,Complexity,Bytes,ULOC
+ *
+ * - Lines 包含所有行（code + comments + blanks）
+ * - Code 是文件级代码行数，用于 code-line finding
+ * - Complexity 是 scc complexitychecks token 命中数，用于 low-decision-token allowance，不是函数级 CC
+ * - ULOC (Usable Lines of Code) 由 3.7.0 输出，但首期不进入稳定 metrics
+ */
+export function parseSccCSV(csv, cwd) {
+    try {
+        const rows = parseCsvRows(csv);
+        const headerIndex = findSccHeaderIndex(rows);
+        if (headerIndex < 0) {
+            return {
+                ok: false,
+                error: `expected scc ${SCC_VERSION} by-file CSV header "${SCC_BY_FILE_CSV_HEADER}", got "${observedSccHeader(rows)}"`,
+                reason: "invalid-result"
+            };
+        }
+        const columns = sccColumnIndexes(rows[headerIndex] ?? []);
+        const measurements = parseSccMetrics(rows.slice(headerIndex + 1), columns, headerIndex + 2, cwd);
+        return {
+            ok: true,
+            measurements
+        };
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: `Failed to parse scc CSV: ${errorMessage(error)}`,
+            reason: "invalid-result"
+        };
+    }
+}
+function findSccHeaderIndex(rows) {
+    const expectedHeader = SCC_BY_FILE_CSV_HEADER.split(",");
+    return rows.findIndex((row) => isCsvRow(row, expectedHeader));
+}
+function observedSccHeader(rows) {
+    return rows.find((row) => row[0] === "Language")?.join(",") ?? rows[0]?.join(",") ?? "";
+}
+function sccColumnIndexes(headerColumns) {
+    return {
+        provider: headerColumns.indexOf("Provider"),
+        filename: headerColumns.indexOf("Filename"),
+        lines: headerColumns.indexOf("Lines"),
+        code: headerColumns.indexOf("Code"),
+        comments: headerColumns.indexOf("Comments"),
+        blanks: headerColumns.indexOf("Blanks"),
+        complexity: headerColumns.indexOf("Complexity")
+    };
+}
+function parseSccMetrics(rows, columns, firstRowNumber, cwd) {
+    const measurements = [];
+    for (const [index, row] of rows.entries()) {
+        const measurement = parseSccFileMetric(row, columns, firstRowNumber + index, cwd);
+        measurements.push(measurement);
+    }
+    measurements.sort((left, right) => compareText(left.payload.path, right.payload.path));
+    return measurements;
+}
+function parseSccFileMetric(rowValues, columns, rowNumber, cwd) {
+    const row = parseSccRow(rowValues, columns, rowNumber);
+    const sourcePath = normalizeScannerReportedPath(row.path, cwd);
+    return {
+        sourcePaths: [sourcePath],
+        payload: {
+            path: sourcePath,
+            codeLines: row.codeLines,
+            decisionTokens: {
+                value: row.complexity,
+                source: "scc"
+            }
+        }
+    };
+}
+function parseSccRow(rowValues, columns, rowNumber) {
+    const expectedColumnCount = SCC_BY_FILE_CSV_HEADER.split(",").length;
+    if (rowValues.length !== expectedColumnCount) {
+        throw new Error(`row ${rowNumber} has ${rowValues.length} columns; expected ${expectedColumnCount}`);
+    }
+    const rawRow = sccRawRow(rowValues, columns);
+    if (!rawRow.filename) {
+        throw new Error(`row ${rowNumber} field Filename must not be empty`);
+    }
+    validateSccRowCounts(rawRow, rowNumber);
+    return {
+        path: rawRow.providerPath || rawRow.filename,
+        codeLines: parseRequiredInteger(rawRow.codeLines, "Code", rowNumber),
+        complexity: parseOptionalInteger(rawRow.complexity, "Complexity", rowNumber)
+    };
+}
+function validateSccRowCounts(row, rowNumber) {
+    parseRequiredInteger(row.lineCount, "Lines", rowNumber);
+    parseRequiredInteger(row.commentLines, "Comments", rowNumber);
+    parseRequiredInteger(row.blankLines, "Blanks", rowNumber);
+}
+function sccRawRow(rowValues, columns) {
+    return {
+        blankLines: sccColumnValue(rowValues, columns.blanks),
+        codeLines: sccColumnValue(rowValues, columns.code),
+        commentLines: sccColumnValue(rowValues, columns.comments),
+        complexity: sccColumnValue(rowValues, columns.complexity),
+        filename: sccColumnValue(rowValues, columns.filename),
+        lineCount: sccColumnValue(rowValues, columns.lines),
+        providerPath: sccColumnValue(rowValues, columns.provider)
+    };
+}
+function parseRequiredInteger(value, field, rowNumber) {
+    if (!/^\d+$/.test(value)) {
+        throw new Error(`row ${rowNumber} field ${field} must be a non-negative integer`);
+    }
+    const parsed = Number(value);
+    if (!Number.isSafeInteger(parsed)) {
+        throw new Error(`row ${rowNumber} field ${field} exceeds the supported integer range`);
+    }
+    return parsed;
+}
+function parseOptionalInteger(value, field, rowNumber) {
+    return value === "" ? null : parseRequiredInteger(value, field, rowNumber);
+}
+function sccColumnValue(rowValues, index) {
+    return index >= 0 ? (rowValues[index] ?? "") : "";
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+function isCsvRow(row, expectedValues) {
+    return (row.length === expectedValues.length &&
+        row.every((value, index) => value === expectedValues[index]));
+}
+//# sourceMappingURL=parser.mjs.map

package/dist/esm/package-checks/file-metrics/scc/parser.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/file-metrics/scc/parser.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExactInputMeasurement } from \"../../project-files/exact-input-measurement.ts\";\nimport { errorMessage } from \"../../host-environment/error-message.ts\";\nimport { normalizeScannerReportedPath } from \"../../project-files/reported-path.ts\";\nimport type { FileMetric } from \"../measurement-model.ts\";\nimport { parseCsvRows } from \"./csv.ts\";\n\nexport const SCC_VERSION = \"3.7.0\";\nexport const SCC_VERSION_OUTPUT = `scc version ${SCC_VERSION}`;\nexport const SCC_BY_FILE_CSV_HEADER =\n  \"Language,Provider,Filename,Lines,Code,Comments,Blanks,Complexity,Bytes,ULOC\";\n\nexport type SccScanResult =\n  | {\n      readonly measurements: readonly ExactInputMeasurement<FileMetric>[];\n      readonly ok: true;\n    }\n  | {\n      readonly error: string;\n      readonly ok: false;\n      readonly reason: \"execution\" | \"invalid-result\";\n    };\n\ninterface SccColumnIndexes {\n  blanks: number;\n  code: number;\n  comments: number;\n  complexity: number;\n  filename: number;\n  lines: number;\n  provider: number;\n}\n\ninterface ParsedSccRow {\n  readonly codeLines: number;\n  readonly complexity: number | null;\n  readonly path: string;\n}\n\ninterface SccRawRow {\n  readonly blankLines: string;\n  readonly codeLines: string;\n  readonly commentLines: string;\n  readonly complexity: string;\n  readonly filename: string;\n  readonly lineCount: string;\n  readonly providerPath: string;\n}\n\n/**\n * 解析 scc CSV 输出。\n *\n * scc 3.7.0 `--by-file --format csv` 列：\n * Language,Provider,Filename,Lines,Code,Comments,Blanks,Complexity,Bytes,ULOC\n *\n * - Lines 包含所有行（code + comments + blanks）\n * - Code 是文件级代码行数，用于 code-line finding\n * - Complexity 是 scc complexitychecks token 命中数，用于 low-decision-token allowance，不是函数级 CC\n * - ULOC (Usable Lines of Code) 由 3.7.0 输出，但首期不进入稳定 metrics\n */\nexport function parseSccCSV(csv: string, cwd: string): SccScanResult {\n  try {\n    const rows = parseCsvRows(csv);\n    const headerIndex = findSccHeaderIndex(rows);\n    if (headerIndex < 0) {\n      return {\n        ok: false,\n        error: `expected scc ${SCC_VERSION} by-file CSV header \"${SCC_BY_FILE_CSV_HEADER}\", got \"${observedSccHeader(rows)}\"`,\n        reason: \"invalid-result\"\n      };\n    }\n\n    const columns = sccColumnIndexes(rows[headerIndex] ?? []);\n    const measurements = parseSccMetrics(\n      rows.slice(headerIndex + 1),\n      columns,\n      headerIndex + 2,\n      cwd\n    );\n    return {\n      ok: true,\n      measurements\n    };\n  } catch (error: unknown) {\n    return {\n      ok: false,\n      error: `Failed to parse scc CSV: ${errorMessage(error)}`,\n      reason: \"invalid-result\"\n    };\n  }\n}\n\nfunction findSccHeaderIndex(rows: string[][]): number {\n  const expectedHeader = SCC_BY_FILE_CSV_HEADER.split(\",\");\n  return rows.findIndex((row) => isCsvRow(row, expectedHeader));\n}\n\nfunction observedSccHeader(rows: string[][]): string {\n  return rows.find((row) => row[0] === \"Language\")?.join(\",\") ?? rows[0]?.join(\",\") ?? \"\";\n}\n\nfunction sccColumnIndexes(headerColumns: string[]): SccColumnIndexes {\n  return {\n    provider: headerColumns.indexOf(\"Provider\"),\n    filename: headerColumns.indexOf(\"Filename\"),\n    lines: headerColumns.indexOf(\"Lines\"),\n    code: headerColumns.indexOf(\"Code\"),\n    comments: headerColumns.indexOf(\"Comments\"),\n    blanks: headerColumns.indexOf(\"Blanks\"),\n    complexity: headerColumns.indexOf(\"Complexity\")\n  };\n}\n\nfunction parseSccMetrics(\n  rows: string[][],\n  columns: SccColumnIndexes,\n  firstRowNumber: number,\n  cwd: string\n): ExactInputMeasurement<FileMetric>[] {\n  const measurements: ExactInputMeasurement<FileMetric>[] = [];\n\n  for (const [index, row] of rows.entries()) {\n    const measurement = parseSccFileMetric(row, columns, firstRowNumber + index, cwd);\n    measurements.push(measurement);\n  }\n\n  measurements.sort((left, right) => compareText(left.payload.path, right.payload.path));\n  return measurements;\n}\n\nfunction parseSccFileMetric(\n  rowValues: string[],\n  columns: SccColumnIndexes,\n  rowNumber: number,\n  cwd: string\n): ExactInputMeasurement<FileMetric> {\n  const row = parseSccRow(rowValues, columns, rowNumber);\n  const sourcePath = normalizeScannerReportedPath(row.path, cwd);\n  return {\n    sourcePaths: [sourcePath],\n    payload: {\n      path: sourcePath,\n      codeLines: row.codeLines,\n      decisionTokens: {\n        value: row.complexity,\n        source: \"scc\"\n      }\n    }\n  };\n}\n\nfunction parseSccRow(\n  rowValues: string[],\n  columns: SccColumnIndexes,\n  rowNumber: number\n): ParsedSccRow {\n  const expectedColumnCount = SCC_BY_FILE_CSV_HEADER.split(\",\").length;\n  if (rowValues.length !== expectedColumnCount) {\n    throw new Error(\n      `row ${rowNumber} has ${rowValues.length} columns; expected ${expectedColumnCount}`\n    );\n  }\n  const rawRow = sccRawRow(rowValues, columns);\n  if (!rawRow.filename) {\n    throw new Error(`row ${rowNumber} field Filename must not be empty`);\n  }\n  validateSccRowCounts(rawRow, rowNumber);\n\n  return {\n    path: rawRow.providerPath || rawRow.filename,\n    codeLines: parseRequiredInteger(rawRow.codeLines, \"Code\", rowNumber),\n    complexity: parseOptionalInteger(rawRow.complexity, \"Complexity\", rowNumber)\n  };\n}\n\nfunction validateSccRowCounts(row: SccRawRow, rowNumber: number): void {\n  parseRequiredInteger(row.lineCount, \"Lines\", rowNumber);\n  parseRequiredInteger(row.commentLines, \"Comments\", rowNumber);\n  parseRequiredInteger(row.blankLines, \"Blanks\", rowNumber);\n}\n\nfunction sccRawRow(rowValues: string[], columns: SccColumnIndexes): SccRawRow {\n  return {\n    blankLines: sccColumnValue(rowValues, columns.blanks),\n    codeLines: sccColumnValue(rowValues, columns.code),\n    commentLines: sccColumnValue(rowValues, columns.comments),\n    complexity: sccColumnValue(rowValues, columns.complexity),\n    filename: sccColumnValue(rowValues, columns.filename),\n    lineCount: sccColumnValue(rowValues, columns.lines),\n    providerPath: sccColumnValue(rowValues, columns.provider)\n  };\n}\n\nfunction parseRequiredInteger(value: string, field: string, rowNumber: number): number {\n  if (!/^\\d+$/.test(value)) {\n    throw new Error(`row ${rowNumber} field ${field} must be a non-negative integer`);\n  }\n  const parsed = Number(value);\n  if (!Number.isSafeInteger(parsed)) {\n    throw new Error(`row ${rowNumber} field ${field} exceeds the supported integer range`);\n  }\n  return parsed;\n}\n\nfunction parseOptionalInteger(value: string, field: string, rowNumber: number): number | null {\n  return value === \"\" ? null : parseRequiredInteger(value, field, rowNumber);\n}\n\nfunction sccColumnValue(rowValues: string[], index: number): string {\n  return index >= 0 ? (rowValues[index] ?? \"\") : \"\";\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 isCsvRow(row: string[], expectedValues: string[]): boolean {\n  return (\n    row.length === expectedValues.length &&\n    row.every((value, index) => value === expectedValues[index])\n  );\n}\n"]}

package/dist/esm/package-checks/file-metrics/scc/scanner.mjs

@@ -0,0 +1,54 @@
+/**
+ * scc 文件级 code-line 指标 wrapper。
+ *
+ * 封装 adapter-owned CLI 调用，输出 exact-path code lines 与 decision-token count。
+ */
+import { errorMessage } from "../../host-environment/error-message.mjs";
+import { runProcessSync } from "../../host-environment/process/command.mjs";
+import { parseSccCSV } from "./parser.mjs";
+const SCC_BY_FILE_ARGUMENTS = Object.freeze(["--by-file", "--format", "csv"]);
+const SCC_SCAN_TIMEOUT_MS = 300_000;
+export function scanWithScc({ cwd, includePaths, scanner }) {
+    try {
+        if (includePaths.length === 0)
+            return { ok: true, measurements: [] };
+        const scanArguments = buildSccArgs(includePaths);
+        const commandResult = runProcessSync({
+            args: scanArguments,
+            command: scanner.executable,
+            cwd,
+            timeout: SCC_SCAN_TIMEOUT_MS
+        });
+        if (commandResult.error) {
+            return {
+                ok: false,
+                error: `scc process error: ${commandResult.error.message}`,
+                reason: "execution"
+            };
+        }
+        if (commandResult.status !== 0) {
+            const stderr = (commandResult.stderr || "").trim();
+            const stdout = (commandResult.stdout || "").trim();
+            const termination = commandResult.status === null
+                ? `signal ${commandResult.signal ?? "unknown"}`
+                : `exit ${commandResult.status}`;
+            return {
+                ok: false,
+                error: `scc ${termination}: ${stderr || stdout || "no output"}`,
+                reason: "execution"
+            };
+        }
+        return parseSccCSV(commandResult.stdout || "", cwd);
+    }
+    catch (error) {
+        return {
+            ok: false,
+            error: `scc adapter error: ${errorMessage(error)}`,
+            reason: "execution"
+        };
+    }
+}
+function buildSccArgs(includePaths) {
+    return [...SCC_BY_FILE_ARGUMENTS, ...includePaths];
+}
+//# sourceMappingURL=scanner.mjs.map

package/dist/esm/package-checks/file-metrics/scc/scanner.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/file-metrics/scc/scanner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAE3E,OAAO,EAAE,WAAW,EAAsB,MAAM,aAAa,CAAC;AAE9D,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AAC9E,MAAM,mBAAmB,GAAG,OAAO,CAAC;AAQpC,MAAM,UAAU,WAAW,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,OAAO,EAAsB;IAC5E,IAAI,CAAC;QACH,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;QAErE,MAAM,aAAa,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QAEjD,MAAM,aAAa,GAAG,cAAc,CAAC;YACnC,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,OAAO,CAAC,UAAU;YAC3B,GAAG;YACH,OAAO,EAAE,mBAAmB;SAC7B,CAAC,CAAC;QAEH,IAAI,aAAa,CAAC,KAAK,EAAE,CAAC;YACxB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,sBAAsB,aAAa,CAAC,KAAK,CAAC,OAAO,EAAE;gBAC1D,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACnD,MAAM,MAAM,GAAG,CAAC,aAAa,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACnD,MAAM,WAAW,GACf,aAAa,CAAC,MAAM,KAAK,IAAI;gBAC3B,CAAC,CAAC,UAAU,aAAa,CAAC,MAAM,IAAI,SAAS,EAAE;gBAC/C,CAAC,CAAC,QAAQ,aAAa,CAAC,MAAM,EAAE,CAAC;YACrC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,OAAO,WAAW,KAAK,MAAM,IAAI,MAAM,IAAI,WAAW,EAAE;gBAC/D,MAAM,EAAE,WAAW;aACpB,CAAC;QACJ,CAAC;QAED,OAAO,WAAW,CAAC,aAAa,CAAC,MAAM,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,KAAK,EAAE,sBAAsB,YAAY,CAAC,KAAK,CAAC,EAAE;YAClD,MAAM,EAAE,WAAW;SACpB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,YAA+B;IACnD,OAAO,CAAC,GAAG,qBAAqB,EAAE,GAAG,YAAY,CAAC,CAAC;AACrD,CAAC","sourcesContent":["/**\n * scc 文件级 code-line 指标 wrapper。\n *\n * 封装 adapter-owned CLI 调用，输出 exact-path code lines 与 decision-token count。\n */\n\nimport { errorMessage } from \"../../host-environment/error-message.ts\";\nimport { runProcessSync } from \"../../host-environment/process/command.ts\";\nimport type { ResolvedFileMetricsScannerOptions } from \"../options.ts\";\nimport { parseSccCSV, type SccScanResult } from \"./parser.ts\";\n\nconst SCC_BY_FILE_ARGUMENTS = Object.freeze([\"--by-file\", \"--format\", \"csv\"]);\nconst SCC_SCAN_TIMEOUT_MS = 300_000;\n\ninterface ScanWithSccOptions {\n  readonly cwd: string;\n  readonly includePaths: readonly string[];\n  readonly scanner: ResolvedFileMetricsScannerOptions;\n}\n\nexport function scanWithScc({ cwd, includePaths, scanner }: ScanWithSccOptions): SccScanResult {\n  try {\n    if (includePaths.length === 0) return { ok: true, measurements: [] };\n\n    const scanArguments = buildSccArgs(includePaths);\n\n    const commandResult = runProcessSync({\n      args: scanArguments,\n      command: scanner.executable,\n      cwd,\n      timeout: SCC_SCAN_TIMEOUT_MS\n    });\n\n    if (commandResult.error) {\n      return {\n        ok: false,\n        error: `scc process error: ${commandResult.error.message}`,\n        reason: \"execution\"\n      };\n    }\n\n    if (commandResult.status !== 0) {\n      const stderr = (commandResult.stderr || \"\").trim();\n      const stdout = (commandResult.stdout || \"\").trim();\n      const termination =\n        commandResult.status === null\n          ? `signal ${commandResult.signal ?? \"unknown\"}`\n          : `exit ${commandResult.status}`;\n      return {\n        ok: false,\n        error: `scc ${termination}: ${stderr || stdout || \"no output\"}`,\n        reason: \"execution\"\n      };\n    }\n\n    return parseSccCSV(commandResult.stdout || \"\", cwd);\n  } catch (error: unknown) {\n    return {\n      ok: false,\n      error: `scc adapter error: ${errorMessage(error)}`,\n      reason: \"execution\"\n    };\n  }\n}\n\nfunction buildSccArgs(includePaths: readonly string[]): string[] {\n  return [...SCC_BY_FILE_ARGUMENTS, ...includePaths];\n}\n"]}

package/dist/esm/package-checks/final-data-parsing.mjs

@@ -0,0 +1,35 @@
+import { hasExactPlainRecordKeys, snapshotClosedArray, snapshotClosedRecord } from "../data-boundary/closed-values.mjs";
+/** Parses the final-data shape shared by the three area-based quality Checks. */
+export function parseFindingSummaryData(data, checkName) {
+    const summary = exactFinalDataRecord(data, ["blockingFindingCount", "findingCount"], checkName);
+    const blockingFindingCount = nonNegativeSafeInteger(summary.blockingFindingCount);
+    const findingCount = nonNegativeSafeInteger(summary.findingCount);
+    if (blockingFindingCount === undefined ||
+        findingCount === undefined ||
+        blockingFindingCount > findingCount) {
+        throw invalidFinalData(checkName);
+    }
+    return Object.freeze({ blockingFindingCount, findingCount });
+}
+/** Returns a detached exact record or rejects an unsupported final-data shape. */
+export function exactFinalDataRecord(data, keys, checkName) {
+    const record = snapshotClosedRecord(data);
+    if (record === undefined || !hasExactPlainRecordKeys(record, keys)) {
+        throw invalidFinalData(checkName);
+    }
+    return record;
+}
+/** Returns a detached closed array or rejects an unsupported final-data shape. */
+export function finalDataArray(data, checkName) {
+    const items = snapshotClosedArray(data);
+    if (items === undefined)
+        throw invalidFinalData(checkName);
+    return items;
+}
+export function nonNegativeSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;
+}
+export function invalidFinalData(checkName) {
+    return new TypeError(`${checkName} final data does not match the supported package contract`);
+}
+//# sourceMappingURL=final-data-parsing.mjs.map

package/dist/esm/package-checks/final-data-parsing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"final-data-parsing.mjs","sourceRoot":"","sources":["../../../src/package-checks/final-data-parsing.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,mCAAmC,CAAC;AAG3C,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CAAC,IAAa,EAAE,SAAiB;IACtE,MAAM,OAAO,GAAG,oBAAoB,CAAC,IAAI,EAAE,CAAC,sBAAsB,EAAE,cAAc,CAAC,EAAE,SAAS,CAAC,CAAC;IAChG,MAAM,oBAAoB,GAAG,sBAAsB,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAClF,MAAM,YAAY,GAAG,sBAAsB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAClE,IACE,oBAAoB,KAAK,SAAS;QAClC,YAAY,KAAK,SAAS;QAC1B,oBAAoB,GAAG,YAAY,EACnC,CAAC;QACD,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,YAAY,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,oBAAoB,CAClC,IAAa,EACb,IAAuB,EACvB,SAAiB;IAEjB,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,uBAAuB,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;QACnE,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,cAAc,CAAC,IAAa,EAAE,SAAiB;IAC7D,MAAM,KAAK,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,KAAK,KAAK,SAAS;QAAE,MAAM,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC3D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACpG,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,IAAI,SAAS,CAAC,GAAG,SAAS,2DAA2D,CAAC,CAAC;AAChG,CAAC","sourcesContent":["import {\n  hasExactPlainRecordKeys,\n  snapshotClosedArray,\n  snapshotClosedRecord\n} from \"../data-boundary/closed-values.ts\";\nimport type { FindingSummary } from \"./code-quality-findings/policy.ts\";\n\n/** Parses the final-data shape shared by the three area-based quality Checks. */\nexport function parseFindingSummaryData(data: unknown, checkName: string): FindingSummary {\n  const summary = exactFinalDataRecord(data, [\"blockingFindingCount\", \"findingCount\"], checkName);\n  const blockingFindingCount = nonNegativeSafeInteger(summary.blockingFindingCount);\n  const findingCount = nonNegativeSafeInteger(summary.findingCount);\n  if (\n    blockingFindingCount === undefined ||\n    findingCount === undefined ||\n    blockingFindingCount > findingCount\n  ) {\n    throw invalidFinalData(checkName);\n  }\n  return Object.freeze({ blockingFindingCount, findingCount });\n}\n\n/** Returns a detached exact record or rejects an unsupported final-data shape. */\nexport function exactFinalDataRecord(\n  data: unknown,\n  keys: readonly string[],\n  checkName: string\n): Readonly<Record<string, unknown>> {\n  const record = snapshotClosedRecord(data);\n  if (record === undefined || !hasExactPlainRecordKeys(record, keys)) {\n    throw invalidFinalData(checkName);\n  }\n  return record;\n}\n\n/** Returns a detached closed array or rejects an unsupported final-data shape. */\nexport function finalDataArray(data: unknown, checkName: string): readonly unknown[] {\n  const items = snapshotClosedArray(data);\n  if (items === undefined) throw invalidFinalData(checkName);\n  return items;\n}\n\nexport function nonNegativeSafeInteger(value: unknown): number | undefined {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0 ? value : undefined;\n}\n\nexport function invalidFinalData(checkName: string): TypeError {\n  return new TypeError(`${checkName} final data does not match the supported package contract`);\n}\n"]}

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

@@ -0,0 +1,96 @@
+import { canonicalJsonBytes } from "../../data-boundary/canonical-data.mjs";
+export function analyzeFunctionMetrics(metrics) {
+    const metricsByIdentity = groupValidMetrics(metrics);
+    if (metricsByIdentity === undefined) {
+        return undefined;
+    }
+    const instances = [];
+    for (const group of metricsByIdentity.values()) {
+        const sortedGroup = [...group].sort(compareFunctionInstances);
+        instances.push(...createFunctionInstances(sortedGroup));
+    }
+    instances.sort((left, right) => compareText(left.semanticSubject, right.semanticSubject));
+    return Object.freeze({ instances: Object.freeze(instances) });
+}
+function groupValidMetrics(metrics) {
+    const groups = new Map();
+    for (const metric of metrics) {
+        if (!isValidFunctionMetric(metric)) {
+            return undefined;
+        }
+        const key = functionIdentityKey(metric);
+        const group = groups.get(key) ?? [];
+        group.push(metric);
+        groups.set(key, group);
+    }
+    return groups;
+}
+function createFunctionInstances(sortedGroup) {
+    return sortedGroup.map((metric, index) => Object.freeze({
+        metric,
+        semanticSubject: isStableFunctionName(metric.name) && sortedGroup.length === 1
+            ? functionSubject(metric)
+            : ambiguousFunctionSubject(metric, index + 1)
+    }));
+}
+function isValidFunctionMetric(metric) {
+    return (typeof metric.file === "string" &&
+        metric.file.length > 0 &&
+        typeof metric.name === "string" &&
+        metric.name.length > 0 &&
+        hasValidFunctionLocation(metric) &&
+        hasValidFunctionMeasurements(metric));
+}
+function hasValidFunctionLocation(metric) {
+    return (Number.isSafeInteger(metric.startLine) &&
+        metric.startLine >= 1 &&
+        Number.isSafeInteger(metric.endLine) &&
+        metric.endLine >= metric.startLine);
+}
+function hasValidFunctionMeasurements(metric) {
+    const complexity = metric.cyclomaticComplexity.value;
+    return (Number.isSafeInteger(metric.lines) &&
+        metric.lines >= 0 &&
+        Number.isSafeInteger(metric.parameterCount) &&
+        metric.parameterCount >= 0 &&
+        (complexity === null || isValidComplexity(complexity)));
+}
+function isValidComplexity(complexity) {
+    return Number.isSafeInteger(complexity) && complexity >= 0;
+}
+function functionSubject(metric) {
+    const identity = new TextDecoder().decode(canonicalJsonBytes({
+        file: metric.file,
+        name: metric.name
+    }));
+    return `function:${identity}`;
+}
+function ambiguousFunctionSubject(metric, occurrence) {
+    const identity = new TextDecoder().decode(canonicalJsonBytes({
+        file: metric.file,
+        name: metric.name,
+        occurrence
+    }));
+    return `function-instance:${identity}`;
+}
+function functionIdentityKey(metric) {
+    return `${metric.file}\u0000${metric.name}`;
+}
+function compareFunctionInstances(left, right) {
+    return (left.startLine - right.startLine ||
+        left.endLine - right.endLine ||
+        left.lines - right.lines ||
+        (left.cyclomaticComplexity.value ?? -1) - (right.cyclomaticComplexity.value ?? -1) ||
+        left.parameterCount - right.parameterCount);
+}
+export function isStableFunctionName(name) {
+    return name.trim() !== "" && name !== "(anonymous)" && name !== "unknown";
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=analysis.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/analysis.ts"],"names":[],"mappings":"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","sourcesContent":["import type { FunctionMetric } from \"./measurement-model.ts\";\nimport { canonicalJsonBytes } from \"../../data-boundary/canonical-data.ts\";\n\nexport interface FunctionMetricInstance {\n  readonly metric: FunctionMetric;\n  readonly semanticSubject: string;\n}\n\nexport interface FunctionMetricAnalysis {\n  readonly instances: readonly FunctionMetricInstance[];\n}\n\nexport function analyzeFunctionMetrics(\n  metrics: readonly FunctionMetric[]\n): FunctionMetricAnalysis | undefined {\n  const metricsByIdentity = groupValidMetrics(metrics);\n  if (metricsByIdentity === undefined) {\n    return undefined;\n  }\n  const instances: FunctionMetricInstance[] = [];\n  for (const group of metricsByIdentity.values()) {\n    const sortedGroup = [...group].sort(compareFunctionInstances);\n    instances.push(...createFunctionInstances(sortedGroup));\n  }\n  instances.sort((left, right) => compareText(left.semanticSubject, right.semanticSubject));\n  return Object.freeze({ instances: Object.freeze(instances) });\n}\n\nfunction groupValidMetrics(\n  metrics: readonly FunctionMetric[]\n): Map<string, FunctionMetric[]> | undefined {\n  const groups = new Map<string, FunctionMetric[]>();\n  for (const metric of metrics) {\n    if (!isValidFunctionMetric(metric)) {\n      return undefined;\n    }\n    const key = functionIdentityKey(metric);\n    const group = groups.get(key) ?? [];\n    group.push(metric);\n    groups.set(key, group);\n  }\n  return groups;\n}\n\nfunction createFunctionInstances(sortedGroup: readonly FunctionMetric[]): FunctionMetricInstance[] {\n  return sortedGroup.map((metric, index) =>\n    Object.freeze({\n      metric,\n      semanticSubject:\n        isStableFunctionName(metric.name) && sortedGroup.length === 1\n          ? functionSubject(metric)\n          : ambiguousFunctionSubject(metric, index + 1)\n    })\n  );\n}\n\nfunction isValidFunctionMetric(metric: FunctionMetric): boolean {\n  return (\n    typeof metric.file === \"string\" &&\n    metric.file.length > 0 &&\n    typeof metric.name === \"string\" &&\n    metric.name.length > 0 &&\n    hasValidFunctionLocation(metric) &&\n    hasValidFunctionMeasurements(metric)\n  );\n}\n\nfunction hasValidFunctionLocation(metric: FunctionMetric): boolean {\n  return (\n    Number.isSafeInteger(metric.startLine) &&\n    metric.startLine >= 1 &&\n    Number.isSafeInteger(metric.endLine) &&\n    metric.endLine >= metric.startLine\n  );\n}\n\nfunction hasValidFunctionMeasurements(metric: FunctionMetric): boolean {\n  const complexity = metric.cyclomaticComplexity.value;\n  return (\n    Number.isSafeInteger(metric.lines) &&\n    metric.lines >= 0 &&\n    Number.isSafeInteger(metric.parameterCount) &&\n    metric.parameterCount >= 0 &&\n    (complexity === null || isValidComplexity(complexity))\n  );\n}\n\nfunction isValidComplexity(complexity: number): boolean {\n  return Number.isSafeInteger(complexity) && complexity >= 0;\n}\n\nfunction functionSubject(metric: Pick<FunctionMetric, \"file\" | \"name\">): string {\n  const identity = new TextDecoder().decode(\n    canonicalJsonBytes({\n      file: metric.file,\n      name: metric.name\n    })\n  );\n  return `function:${identity}`;\n}\n\nfunction ambiguousFunctionSubject(\n  metric: Pick<FunctionMetric, \"file\" | \"name\">,\n  occurrence: number\n): string {\n  const identity = new TextDecoder().decode(\n    canonicalJsonBytes({\n      file: metric.file,\n      name: metric.name,\n      occurrence\n    })\n  );\n  return `function-instance:${identity}`;\n}\n\nfunction functionIdentityKey(metric: Pick<FunctionMetric, \"file\" | \"name\">): string {\n  return `${metric.file}\\u0000${metric.name}`;\n}\n\nfunction compareFunctionInstances(left: FunctionMetric, right: FunctionMetric): number {\n  return (\n    left.startLine - right.startLine ||\n    left.endLine - right.endLine ||\n    left.lines - right.lines ||\n    (left.cyclomaticComplexity.value ?? -1) - (right.cyclomaticComplexity.value ?? -1) ||\n    left.parameterCount - right.parameterCount\n  );\n}\n\nexport function isStableFunctionName(name: string): boolean {\n  return name.trim() !== \"\" && name !== \"(anonymous)\" && name !== \"unknown\";\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"]}