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

@zxyycom/vibe-check 0.0.1 → 0.0.3

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

Files changed (1190) hide show

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

	@@ -1 +1 @@
1	- {"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options-validation.ts"],"names":[],"mappings":"AAAA,OAAO,~~EAAE~~,oBAAoB,~~EAAE~~,MAAM,sCAAsC,CAAC;~~AAC5E~~,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;~~AAGxE~~,sDAAsD;AACtD,MAAM,UAAU,mCAAmC,CACjD,KAAc;IAEd,MAAM,OAAO,GAAG,~~WAAW~~,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,~~SAAS~~,CAAC,CAAC,CAAC;~~IAC7D~~,OAAO,CACL,OAAO,KAAK,SAAS,~~IAAI,~~cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,~~IAAI~~,~~YAAY,~~CAAC,OAAO,CAAC,~~OAAO~~,CAAC,~~CAC5F~~,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,EAAE;QACzD,MAAM,IAAI,GAAG,~~WAAW~~,CAAC,SAAS,EAAE,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,CAAC;~~QAC1E~~,OAAO,CACL,~~cAAc~~,CAAC,MAAM,CAAC;~~YACtB~~,IAAI,KAAK,SAAS;YAClB,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC;YACrC,kBAAkB,CAAC,IAAI,CAAC,aAAa,CAAC;YACtC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CACzB,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,MAAM,GAAG,~~WAAW~~,CAAC,KAAK,EAAE,~~CAAC,~~WAAW,~~EAAE,~~sBAAsB,~~EAAE~~,YAAY,CAAC,CAAC~~,CAAC~~;~~IACvF~~,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC5D,MAAM,oBAAoB,GAAG,gBAAgB,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAC3E,MAAM,UAAU,GAAG,gBAAgB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;IACvD,OAAO,CACL,cAAc,KAAK,SAAS;QAC5B,oBAAoB,KAAK,SAAS;QAClC,UAAU,KAAK,SAAS;QACxB,~~mBAAmB~~,CAAC,oBAAoB,CAAC,OAAO,CAAC;~~QACjD~~,~~mBAAmB~~,CAAC,UAAU,CAAC,OAAO,CAAC,~~CACxC~~,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,MAAM,SAAS,GAAG,~~WAAW~~,CAAC,KAAK,EAAE,CAAC,wBAAwB,EAAE,SAAS,CAAC,CAAC,CAAC;~~IAC5E~~,MAAM,SAAS,GAAG,~~WAAW~~,CAAC,SAAS,EAAE,sBAAsB,EAAE;~~QAC/D~~,2BAA2B;QAC3B,SAAS;KACV,CAAC,CAAC;IACH,OAAO,SAAS,KAAK,SAAS;QAC5B,SAAS,KAAK,SAAS;QACvB,~~mBAAmB~~,CAAC,SAAS,CAAC,OAAO,CAAC;~~QACtC~~,~~mBAAmB~~,CAAC,SAAS,CAAC,OAAO,CAAC;~~QACtC~~,SAAS,CAAC,OAAO,IAAI,SAAS,CAAC,OAAO;QACtC,~~mBAAmB~~,CAAC,SAAS,CAAC,yBAAyB,CAAC;~~QACxD~~,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,~~WAAW~~,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC;IACnD,OAAO,OAAO,KAAK,SAAS,IAAI,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;AACrE,CAAC;AAED,SAAS,WAAW,CAClB,KAAc,EACd,IAAuB;IAEvB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,MAAM,KAAK,SAAS;QACzB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC1C,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC","sourcesContent":["import { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { ResolvedFunctionMetricsOptions } from \"./options.ts\";\n\n/** 验证 constructor 已物化的完整 function-metrics options。 */\nexport function validResolvedFunctionMetricsOptions(\n value: unknown\n): value is ResolvedFunctionMetricsOptions {\n const options = ~~exactRecord~~(value, [\"codeAreas\", \"~~scanner~~\"]);\n return (\n options !== undefined && validCodeAreas(options.codeAreas) ~~&& validScanner~~(options.~~scanner~~)\n );\n}\n\nfunction validCodeAreas(value: unknown): boolean {\n const areas = snapshotClosedRecord(value);\n if (areas === undefined \|\| Object.keys(areas).length === 0) return false;\n return Object.entries(areas).every(([areaId, candidate]) => {\n const area = ~~exactRecord~~(candidate, [\"files\", \"findingPolicy\", \"limits\"]);\n return (\n ~~nonEmptyString~~(areaId) &&\n area !== undefined &&\n validProjectFileSelection(area.files) &&\n validFindingPolicy(area.findingPolicy) &&\n validLimits(area.limits)\n );\n });\n}\n\nfunction validLimits(value: unknown): boolean {\n const limits = ~~exactRecord~~(value, [\"codeLines\", \"cyclomaticComplexity\", \"parameters\"]);\n if (limits === undefined) return false;\n const codeLineLimits = codeLineLimitsFrom(limits.codeLines);\n const cyclomaticComplexity = maximumLimitFrom(limits.cyclomaticComplexity);\n const parameters = maximumLimitFrom(limits.parameters);\n return (\n codeLineLimits !== undefined &&\n cyclomaticComplexity !== undefined &&\n parameters !== undefined &&\n ~~positiveSafeInteger~~(cyclomaticComplexity.maximum) &&\n ~~positiveSafeInteger~~(parameters.maximum)\n );\n}\n\nfunction codeLineLimitsFrom(value: unknown): Readonly<Record<string, unknown>> \| undefined {\n const codeLines = ~~exactRecord~~(value, [\"lowComplexityAllowance\", \"maximum\"]);\n const allowance = ~~exactRecord~~(codeLines?.lowComplexityAllowance, [\n \"cyclomaticComplexityBelow\",\n \"maximum\"\n ]);\n return codeLines !== undefined &&\n allowance !== undefined &&\n ~~positiveSafeInteger~~(codeLines.maximum) &&\n ~~positiveSafeInteger~~(allowance.maximum) &&\n allowance.maximum >= codeLines.maximum &&\n ~~positiveSafeInteger~~(allowance.cyclomaticComplexityBelow)\n ? codeLines\n : undefined;\n}\n\nfunction maximumLimitFrom(value: unknown): Readonly<Record<string, unknown>> \| undefined {\n return ~~exactRecord~~(value, [\"maximum\"]);\n}\n~~\nfunction validScanner(value: unknown): boolean {\n const scanner = exactRecord(value, [\~~"~~executable\"~~]~~);\n return scanner !== undefined && nonEmptyString(scanner.executable);\n~~}\n\nfunction exactRecord(\n value: unknown,\n keys: readonly string[]\n): Readonly<Record<string, unknown>> \| undefined {\n const record = snapshotClosedRecord(value);\n return record !== undefined &&\n Object.keys(record).length === keys.length &&\n keys.every((key) => Object.hasOwn(record, key))\n ? record\n : undefined;\n}\n\nfunction positiveSafeInteger(value: unknown): value is number {\n return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nfunction nonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0;\n}\n"]}
1	+ {"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n snapshotClosedRecord,\n snapshotExactClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { isNonEmptyString, isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport { validResolvedFindingWaivers } from \"../code-quality-findings/finding-waiver-authoring.ts\";\nimport { resolveFunctionMetricsFindingIdentity } from \"./finding-waiver-identity.ts\";\nimport type { ResolvedFunctionMetricsOptions } from \"./options.ts\";\n\n/** 验证 constructor 已物化的完整 function-metrics options。 */\nexport function validResolvedFunctionMetricsOptions(\n value: unknown\n): value is ResolvedFunctionMetricsOptions {\n const options = snapshotExactClosedRecord(value, [\"codeAreas\", \"findingWaivers\"]);\n return (\n options !== undefined &&\n validCodeAreas(options.codeAreas) &&\n validResolvedFindingWaivers(options.findingWaivers, resolveFunctionMetricsFindingIdentity)\n );\n}\n\nfunction validCodeAreas(value: unknown): boolean {\n const areas = snapshotClosedRecord(value);\n if (areas === undefined \|\| Object.keys(areas).length === 0) return false;\n return Object.entries(areas).every(([areaId, candidate]) => {\n const area = snapshotExactClosedRecord(candidate, [\"files\", \"findingPolicy\", \"limits\"]);\n return (\n isNonEmptyString(areaId) &&\n area !== undefined &&\n validProjectFileSelection(area.files) &&\n validFindingPolicy(area.findingPolicy) &&\n validLimits(area.limits)\n );\n });\n}\n\nfunction validLimits(value: unknown): boolean {\n const limits = snapshotExactClosedRecord(value, [\n \"codeLines\",\n \"cyclomaticComplexity\",\n \"nestingDepth\",\n \"parameters\"\n ]);\n if (limits === undefined) return false;\n const codeLineLimits = codeLineLimitsFrom(limits.codeLines);\n const cyclomaticComplexity = maximumLimitFrom(limits.cyclomaticComplexity);\n const nestingDepth = maximumLimitFrom(limits.nestingDepth);\n const parameters = maximumLimitFrom(limits.parameters);\n return (\n codeLineLimits !== undefined &&\n cyclomaticComplexity !== undefined &&\n nestingDepth !== undefined &&\n parameters !== undefined &&\n isPositiveSafeInteger(cyclomaticComplexity.maximum) &&\n isPositiveSafeInteger(nestingDepth.maximum) &&\n isPositiveSafeInteger(parameters.maximum)\n );\n}\n\nfunction codeLineLimitsFrom(value: unknown): Readonly<Record<string, unknown>> \| undefined {\n const codeLines = snapshotExactClosedRecord(value, [\"lowComplexityAllowance\", \"maximum\"]);\n const allowance = snapshotExactClosedRecord(codeLines?.lowComplexityAllowance, [\n \"cyclomaticComplexityBelow\",\n \"maximum\"\n ]);\n return codeLines !== undefined &&\n allowance !== undefined &&\n isPositiveSafeInteger(codeLines.maximum) &&\n isPositiveSafeInteger(allowance.maximum) &&\n allowance.maximum >= codeLines.maximum &&\n isPositiveSafeInteger(allowance.cyclomaticComplexityBelow)\n ? codeLines\n : undefined;\n}\n\nfunction maximumLimitFrom(value: unknown): Readonly<Record<string, unknown>> \| undefined {\n return snapshotExactClosedRecord(value, [\"maximum\"]);\n}\n"]}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n ProjectFileSelection,\n ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\n\n/** `functionMetrics` 构造函数可省略的文件选择策略。 /\nexport type FunctionMetricsFileOptions = ProjectFileSelectionOptions;\n\n/* `functionMetrics` 构造函数可省略的函数指标上限。 /\nexport interface FunctionMetricsLimitOptions {\n readonly codeLines?: Readonly<{\n /* 省略时为 `60`；函数 NLOC 超过此值时产生 finding。 /\n readonly maximum?: number;\n readonly lowComplexityAllowance?: Readonly<{\n /* 省略时为 `6`；复杂度小于此值时可使用较高 NLOC 上限。 /\n readonly cyclomaticComplexityBelow?: number;\n /* 省略时为 `180`；不得小于普通代码行上限。 /\n readonly maximum?: number;\n }>;\n }>;\n readonly cyclomaticComplexity?: Readonly<{\n /* 省略时为 `12`。 /\n readonly maximum?: number;\n }>;\n readonly parameters?: Readonly<{\n /* 省略时为 `6`。 /\n readonly maximum?: number;\n }>;\n}\n\n/* 可独立选择文件、指标上限和 finding policy 的 function-metrics 区域。 /\nexport interface FunctionMetricsCodeAreaOptions {\n /* 显式区域必须声明本字段；其中各子字段可省略并使用 package 默认值。 /\n readonly files: FunctionMetricsFileOptions;\n /* 省略时继承顶层 `findingPolicy`。 /\n readonly findingPolicy?: FindingPolicy;\n /* 省略的嵌套上限使用 package 默认值。 /\n readonly limits?: FunctionMetricsLimitOptions;\n}\n\n/* ~~`functionMetrics`~~ ~~构造函数可省略的~~ ~~Lizard~~ ~~可执行文件策略。~~ /\nexport interface ~~FunctionMetricsScannerOptions~~ {\n /* ~~省略时为~~ ~~`lizard`；显式命令必须直接接受~~ ~~adapter~~ ~~拥有的~~ ~~Lizard~~ ~~参数。~~ /\n readonly ~~executable?:~~ string;\n}\n\n/* `functionMetrics(options?)` 接受并补齐默认值的公开策略。 /\nexport interface FunctionMetricsOptions {\n /* 省略时建立默认 `project` 区域；显式映射必须非空，且每个区域必须声明 `files`。 /\n readonly codeAreas?: Readonly<Record<string, FunctionMetricsCodeAreaOptions>>;\n /* 省略时为 `non-blocking`；区域可局部覆盖。 /\n readonly findingPolicy?: FindingPolicy;\n /* ~~省略时使用~~ ~~PATH~~ 中的 ~~`lizard`。~~ /\n readonly ~~scanner~~?: ~~FunctionMetricsScannerOptions~~;\n}\n\n/* 构造函数生成并由 Check ~~preflight~~/execution 消费的完整 options。 */\nexport interface ResolvedFunctionMetricsOptions {\n readonly codeAreas: Readonly<Record<string, ResolvedFunctionMetricsCodeAreaOptions>>;\n readonly ~~scanner~~: ~~ResolvedFunctionMetricsScannerOptions~~;\n}\n\nexport interface ResolvedFunctionMetricsCodeAreaOptions {\n readonly files: ProjectFileSelection;\n readonly findingPolicy: FindingPolicy;\n readonly limits: ResolvedFunctionMetricsLimits;\n}\n\nexport interface ResolvedFunctionMetricsLimits {\n readonly codeLines: Readonly<{\n readonly maximum: number;\n readonly lowComplexityAllowance: Readonly<{\n readonly cyclomaticComplexityBelow: number;\n readonly maximum: number;\n }>;\n }>;\n readonly cyclomaticComplexity: Readonly<{ readonly maximum: number }>;\n readonly ~~parameters~~: Readonly<{ readonly maximum: number }>;\n~~}\n\nexport~~ ~~interface~~ ~~ResolvedFunctionMetricsScannerOptions~~ ~~{\n~~ readonly ~~executable~~: ~~string;\~~n}\n"]}
1	+ {"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/options.ts"],"names":[],"mappings":"","sourcesContent":["import type { PackageCheckAuthoringOptions } from \"../check-authoring.ts\";\nimport type {\n ProjectFileSelection,\n ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\nimport type { FindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { FindingWaiver } from \"../../package-tools/finding-waivers/reconciliation.ts\";\n\n/** `functionMetrics` 构造函数可省略的文件选择策略。 /\nexport type FunctionMetricsFileOptions = ProjectFileSelectionOptions;\n\n/* `functionMetrics` 构造函数可省略的函数指标上限。 /\nexport interface FunctionMetricsLimitOptions {\n readonly codeLines?: Readonly<{\n /* 省略时为 `60`；函数 NLOC 超过此值时产生 finding。 /\n readonly maximum?: number;\n readonly lowComplexityAllowance?: Readonly<{\n /* 省略时为 `6`；复杂度小于此值时可使用较高 NLOC 上限。 /\n readonly cyclomaticComplexityBelow?: number;\n /* 省略时为 `180`；不得小于普通代码行上限。 /\n readonly maximum?: number;\n }>;\n }>;\n readonly cyclomaticComplexity?: Readonly<{\n /* 省略时为 `12`。 /\n readonly maximum?: number;\n }>;\n readonly nestingDepth?: Readonly<{\n /* 省略时为 `7`。 /\n readonly maximum?: number;\n }>;\n readonly parameters?: Readonly<{\n /* 省略时为 `6`。 /\n readonly maximum?: number;\n }>;\n}\n\n/* 可独立选择文件、指标上限和 finding policy 的 function-metrics 区域。 /\nexport interface FunctionMetricsCodeAreaOptions {\n /* 显式区域必须声明本字段；其中各子字段可省略并使用 package 默认值。 /\n readonly files: FunctionMetricsFileOptions;\n /* 省略时继承顶层 `findingPolicy`。 /\n readonly findingPolicy?: FindingPolicy;\n /* 省略的嵌套上限使用 package 默认值。 /\n readonly limits?: FunctionMetricsLimitOptions;\n}\n\n/* function-metrics 可形成 Finding 的封闭 metric 名称。 /\nexport type FunctionMetricsFindingMetric =\n \| \"cyclomatic-complexity\"\n \| \"function-code-density\"\n \| \"nesting-depth\"\n \| \"parameter-count\";\n\n/* function-metrics 用于精确识别一条可豁免 metric finding 的稳定字段。 /\nexport interface FunctionMetricsFindingIdentity {\n readonly functionName: string;\n readonly metric: FunctionMetricsFindingMetric;\n /* 已 normalized 的 project-root-relative slash path。 /\n readonly path: string;\n /* 该次 finding 中函数起始位置的一基行号；位置变化会让旧 waiver 进入 unused audit。 /\n readonly startLine: number;\n}\n\n/* 一项 function-metrics metric finding 的声明式豁免。 /\nexport type FunctionMetricsFindingWaiver = FindingWaiver<FunctionMetricsFindingIdentity>;\n\n/* `functionMetrics(options?)` 接受并补齐默认值的公开策略。 /\nexport interface FunctionMetricsOptions<\n Id extends string = string\n> extends PackageCheckAuthoringOptions<Id> {\n /* 省略时建立默认 `project` 区域；显式映射必须非空，且每个区域必须声明 `files`。 /\n readonly codeAreas?: Readonly<Record<string, FunctionMetricsCodeAreaOptions>>;\n /* 省略时为 `non-blocking`；区域可局部覆盖。 /\n readonly findingPolicy?: FindingPolicy;\n /* 省略时没有豁免；只匹配 normal metric finding，不匹配 input rejection。 /\n readonly findingWaivers?: readonly FunctionMetricsFindingWaiver[];\n}\n\n/* 构造函数生成并由 Check preparation/execution 消费的完整 options。 */\nexport interface ResolvedFunctionMetricsOptions {\n readonly codeAreas: Readonly<Record<string, ResolvedFunctionMetricsCodeAreaOptions>>;\n readonly findingWaivers: readonly FunctionMetricsFindingWaiver[];\n}\n\nexport interface ResolvedFunctionMetricsCodeAreaOptions {\n readonly files: ProjectFileSelection;\n readonly findingPolicy: FindingPolicy;\n readonly limits: ResolvedFunctionMetricsLimits;\n}\n\nexport interface ResolvedFunctionMetricsLimits {\n readonly codeLines: Readonly<{\n readonly maximum: number;\n readonly lowComplexityAllowance: Readonly<{\n readonly cyclomaticComplexityBelow: number;\n readonly maximum: number;\n }>;\n }>;\n readonly cyclomaticComplexity: Readonly<{ readonly maximum: number }>;\n readonly nestingDepth: Readonly<{ readonly maximum: number }>;\n readonly parameters: Readonly<{ readonly maximum: number }>;\n}\n"]}

package/dist/esm/package-checks/function-metrics/records.mjs CHANGED Viewed

@@ -1,5 +1,7 @@
 import { isStableFunctionName } from "./analysis.mjs";
 import { isBlockingFinding } from "../code-quality-findings/policy.mjs";
+import { buildHashedFindingWaiverAuditRecord } from "../code-quality-findings/finding-waiver-evidence.mjs";
+import { resolveFunctionMetricsFindingIdentity } from "./finding-waiver-identity.mjs";
 const INPUT_REJECTED_RECORD_ID_PREFIX = "/input-rejected/";
 /** 为每个 rejected path 构造一条 area-aware、固定 non-blocking 的 Finding。 */
 export function buildFunctionInputRejectedCandidates(codeAreasByPath) {
@@ -16,6 +18,22 @@ export function buildFunctionInputRejectedCandidates(codeAreasByPath) {
         id: `${INPUT_REJECTED_RECORD_ID_PREFIX}${path}`
     })));
 }
+export function functionMetricsFindingIdentity(candidate) {
+    const { functionName, metric, path, startLine } = candidate.data;
+    return Object.freeze({ functionName, metric, path, startLine });
+}
+export function functionMetricsWaiverIdentity(waiver) {
+    const identity = resolveFunctionMetricsFindingIdentity(waiver.identity);
+    if (identity === undefined) {
+        throw new TypeError("functionMetrics waiver identity must retain a valid metric subject");
+    }
+    return identity;
+}
+/** 为一项未使用或过宽 waiver 构造 Check-owned audit Record。 */
+export function functionMetricsWaiverAuditRecord(audit) {
+    const identity = functionMetricsWaiverIdentity(audit.waiver);
+    return buildHashedFindingWaiverAuditRecord(identity, audit);
+}
 /** 为每个超过 matching-area 最严格阈值的 metric 构造 supplemental fact。 */
 export function buildFunctionRecordCandidates(analysis, areas) {
     const areasByPath = indexAreasByPath(areas);
@@ -56,7 +74,7 @@ function metricEvaluations(instance, policyContext, matchingAreas) {
     const complexityEvaluation = complexityMetricEvaluation(instance, policyContext, matchingAreas);
     if (complexityEvaluation !== null)
         evaluations.push(complexityEvaluation);
-    evaluations.push(codeLinesMetricEvaluation(instance, policyContext, matchingAreas), parameterMetricEvaluation(instance, policyContext, matchingAreas));
+    evaluations.push(codeLinesMetricEvaluation(instance, policyContext, matchingAreas), nestingDepthMetricEvaluation(instance, policyContext, matchingAreas), parameterMetricEvaluation(instance, policyContext, matchingAreas));
     return evaluations;
 }
 function sharedMetricEvaluation(instance, policyContext) {
@@ -75,11 +93,20 @@ function complexityMetricEvaluation(instance, policyContext, matchingAreas) {
         return null;
     return {
         ...sharedMetricEvaluation(instance, policyContext),
+        complexityContributors: instance.metric.complexityContributors,
         limit: Math.min(...matchingAreas.map((area) => area.limits.cyclomaticComplexity.maximum)),
         metric: "cyclomatic-complexity",
         value
     };
 }
+function nestingDepthMetricEvaluation(instance, policyContext, matchingAreas) {
+    return {
+        ...sharedMetricEvaluation(instance, policyContext),
+        limit: Math.min(...matchingAreas.map((area) => area.limits.nestingDepth.maximum)),
+        metric: "nesting-depth",
+        value: instance.metric.nestingDepth.value
+    };
+}
 function codeLinesMetricEvaluation(instance, policyContext, matchingAreas) {
     return {
         ...sharedMetricEvaluation(instance, policyContext),
@@ -104,6 +131,9 @@ function appendFindingCandidate(candidates, evaluation) {
         data: Object.freeze({
             blocking: evaluation.blocking,
             codeAreas: evaluation.codeAreas,
+            ...(evaluation.complexityContributors === undefined
+                ? {}
+                : { complexityContributors: evaluation.complexityContributors }),
             functionName: evaluation.functionName,
             limit: evaluation.limit,
             metric: evaluation.metric,

package/dist/esm/package-checks/function-metrics/records.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"records.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/records.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n isStableFunctionName,\n type FunctionMetricAnalysis,\n type FunctionMetricInstance\n} from \"./analysis.ts\";\nimport { isBlockingFinding } from \"../code-quality-findings/policy.ts\";\nimport type { FunctionMetric, FunctionMetricsAreaInput } from \"./measurement-model.ts\";\nimport type { ResolvedFunctionMetricsLimits } from \"./options.ts\";\n\ntype FunctionMetricName = \"cyclomatic-complexity\" \| \"function-code-density\" \| \"parameter-count\";\nconst INPUT_REJECTED_RECORD_ID_PREFIX = \"/input-rejected/\";\n\n/** 一条超出函数 metric 上限的 supplemental Record data。 /\nexport type FunctionMetricsFindingRecordData = Readonly<{\n readonly blocking: boolean;\n readonly codeAreas: readonly string[];\n readonly functionName: string;\n readonly limit: number;\n readonly metric: FunctionMetricName;\n readonly path: string;\n readonly startLine: number;\n readonly value: number;\n}>;\n\n/* 一条已被 files policy 选中、但不受 functionMetrics 支持的输入 Finding。 /\nexport type FunctionMetricsInputRejectedRecordData = Readonly<{\n readonly blocking: false;\n readonly codeAreas: readonly string[];\n readonly kind: \"input-rejected\";\n readonly path: string;\n readonly reason: \"unsupported-file-type\";\n}>;\n\n/* functionMetrics 发布的 metric 或 input-rejection Record data。 /\nexport type FunctionMetricsRecordData =\n \| FunctionMetricsFindingRecordData\n \| FunctionMetricsInputRejectedRecordData;\n\nexport interface FunctionRecordCandidate {\n readonly data: FunctionMetricsFindingRecordData;\n readonly id: string;\n}\n\nexport interface FunctionInputRejectedCandidate {\n readonly data: FunctionMetricsInputRejectedRecordData;\n readonly id: string;\n}\n\n/* 为每个 rejected path 构造一条 area-aware、固定 non-blocking 的 Finding。 /\nexport function buildFunctionInputRejectedCandidates(\n codeAreasByPath: ReadonlyMap<string, readonly string[]>\n): readonly FunctionInputRejectedCandidate[] {\n return Object.freeze(\n [...codeAreasByPath]\n .sort(([left], [right]) => compareText(left, right))\n .map(([path, codeAreas]) =>\n Object.freeze({\n data: Object.freeze({\n blocking: false as const,\n codeAreas: Object.freeze(uniqueSorted(codeAreas)),\n kind: \"input-rejected\" as const,\n path,\n reason: \"unsupported-file-type\" as const\n }),\n id: `${INPUT_REJECTED_RECORD_ID_PREFIX}${path}`\n })\n )\n );\n}\n\ntype MatchingFunctionMetricAreas = readonly [\n FunctionMetricsAreaInput,\n ...FunctionMetricsAreaInput[]\n];\n\ninterface FunctionPolicyContext {\n readonly blocking: boolean;\n readonly codeAreas: readonly string[];\n readonly functionName: string;\n}\n\ninterface FunctionMetricEvaluation {\n readonly blocking: boolean;\n readonly codeAreas: readonly string[];\n readonly functionName: string;\n readonly limit: number;\n readonly metric: FunctionMetricName;\n readonly path: string;\n readonly startLine: number;\n readonly subject: string;\n readonly value: number;\n}\n\n/* 为每个超过 matching-area 最严格阈值的 metric 构造 supplemental fact。 */\nexport function buildFunctionRecordCandidates(\n analysis: FunctionMetricAnalysis,\n areas: readonly FunctionMetricsAreaInput[]\n): readonly FunctionRecordCandidate[] \| undefined {\n const areasByPath = indexAreasByPath(areas);\n const candidates: FunctionRecordCandidate[] = [];\n for (const instance of analysis.instances) {\n const [firstArea, ...remainingAreas] = areasByPath.get(instance.metric.file) ?? [];\n if (firstArea === undefined) return undefined;\n const matchingAreas = [firstArea, ...remainingAreas] as const;\n const policyContext = resolveFunctionPolicyContext(instance, matchingAreas);\n for (const evaluation of metricEvaluations(instance, policyContext, matchingAreas)) {\n appendFindingCandidate(candidates, evaluation);\n }\n }\n candidates.sort((left, right) => compareText(left.id, right.id));\n return Object.freeze(candidates);\n}\n\nfunction indexAreasByPath(\n areas: readonly FunctionMetricsAreaInput[]\n): ReadonlyMap<string, readonly FunctionMetricsAreaInput[]> {\n const mutableAreas = new Map<string, FunctionMetricsAreaInput[]>();\n for (const area of areas) {\n for (const path of area.approvedExactPaths) {\n const matchingAreas = mutableAreas.get(path) ?? [];\n matchingAreas.push(area);\n mutableAreas.set(path, matchingAreas);\n }\n }\n return new Map(\n Array.from(mutableAreas, ([path, matchingAreas]) => [path, Object.freeze(matchingAreas)])\n );\n}\n\nfunction resolveFunctionPolicyContext(\n instance: FunctionMetricInstance,\n matchingAreas: MatchingFunctionMetricAreas\n): Readonly<FunctionPolicyContext> {\n return Object.freeze({\n blocking: isBlockingFinding(matchingAreas.map((area) => area.findingPolicy)),\n codeAreas: Object.freeze(uniqueSorted(matchingAreas.map((area) => area.codeArea))),\n functionName: isStableFunctionName(instance.metric.name) ? instance.metric.name : \"<anonymous>\"\n });\n}\n\nfunction metricEvaluations(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation[] {\n const evaluations: FunctionMetricEvaluation[] = [];\n const complexityEvaluation = complexityMetricEvaluation(instance, policyContext, matchingAreas);\n if (complexityEvaluation !== null) evaluations.push(complexityEvaluation);\n evaluations.push(\n codeLinesMetricEvaluation(instance, policyContext, matchingAreas),\n parameterMetricEvaluation(instance, policyContext, matchingAreas)\n );\n return evaluations;\n}\n\nfunction sharedMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext\n) {\n return {\n blocking: policyContext.blocking,\n codeAreas: policyContext.codeAreas,\n functionName: policyContext.functionName,\n path: instance.metric.file,\n startLine: instance.metric.startLine,\n subject: instance.semanticSubject\n } as const;\n}\n\nfunction complexityMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation \| null {\n const value = instance.metric.cyclomaticComplexity.value;\n if (value === null) return null;\n return {\n ...sharedMetricEvaluation(instance, policyContext),\n limit: Math.min(...matchingAreas.map((area) => area.limits.cyclomaticComplexity.maximum)),\n metric: \"cyclomatic-complexity\",\n value\n };\n}\n\nfunction codeLinesMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation {\n return {\n ...sharedMetricEvaluation(instance, policyContext),\n limit: Math.min(\n ...matchingAreas.map((area) => functionCodeLineMaximum(instance.metric, area.limits))\n ),\n metric: \"function-code-density\",\n value: instance.metric.lines\n };\n}\n\nfunction parameterMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation {\n return {\n ...sharedMetricEvaluation(instance, policyContext),\n limit: Math.min(...matchingAreas.map((area) => area.limits.parameters.maximum)),\n metric: \"parameter-count\",\n value: instance.metric.parameterCount\n };\n}\n\nfunction appendFindingCandidate(\n candidates: FunctionRecordCandidate[],\n evaluation: FunctionMetricEvaluation\n): void {\n if (evaluation.value <= evaluation.limit) return;\n candidates.push(\n Object.freeze({\n id: `${evaluation.subject}:${evaluation.metric}`,\n data: Object.freeze({\n blocking: evaluation.blocking,\n codeAreas: evaluation.codeAreas,\n functionName: evaluation.functionName,\n limit: evaluation.limit,\n metric: evaluation.metric,\n path: evaluation.path,\n startLine: evaluation.startLine,\n value: evaluation.value\n })\n })\n );\n}\n\nfunction functionCodeLineMaximum(\n metric: FunctionMetric,\n limits: ResolvedFunctionMetricsLimits\n): number {\n const allowance = limits.codeLines.lowComplexityAllowance;\n const complexity = metric.cyclomaticComplexity.value;\n return complexity !== null && complexity < allowance.cyclomaticComplexityBelow\n ? allowance.maximum\n : limits.codeLines.maximum;\n}\n\nfunction uniqueSorted(values: readonly string[]): string[] {\n return [...new Set(values)].sort(compareText);\n}\n\nfunction compareText(left: string, right: string): number {\n if (left < right) return -1;\n if (left > right) return 1;\n return 0;\n}\n"]}
1	+ {"version":3,"file":"records.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/records.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n isStableFunctionName,\n type FunctionMetricAnalysis,\n type FunctionMetricInstance\n} from \"./analysis.ts\";\nimport type { MaterializedFindingWaiver } from \"../../package-tools/finding-waivers/reconciliation.ts\";\nimport { isBlockingFinding } from \"../code-quality-findings/policy.ts\";\nimport {\n buildHashedFindingWaiverAuditRecord,\n type FindingWaiverAuditRecordData,\n type FindingWaiverRecordAudit\n} from \"../code-quality-findings/finding-waiver-evidence.ts\";\nimport type { FunctionMetric, FunctionMetricsAreaInput } from \"./measurement-model.ts\";\nimport type {\n FunctionMetricsFindingIdentity,\n FunctionMetricsFindingMetric,\n ResolvedFunctionMetricsLimits\n} from \"./options.ts\";\nimport { resolveFunctionMetricsFindingIdentity } from \"./finding-waiver-identity.ts\";\n\nconst INPUT_REJECTED_RECORD_ID_PREFIX = \"/input-rejected/\";\n/** 一条超出函数 metric 上限的 supplemental Record data。 /\nexport type FunctionMetricsFindingRecordData = Readonly<{\n readonly blocking: boolean;\n readonly codeAreas: readonly string[];\n /* Complete source-ordered CCN contributors; present only for CCN findings. /\n readonly complexityContributors?: readonly Readonly<{\n readonly line: number;\n readonly token: string;\n }>[];\n readonly functionName: string;\n readonly limit: number;\n readonly metric: FunctionMetricsFindingMetric;\n readonly path: string;\n readonly startLine: number;\n readonly value: number;\n /* 精确匹配 waiver 时保留理由，并令该 finding 不再参与 actionable settlement。 /\n readonly waiver?: Readonly<{ readonly reason: string }>;\n}>;\n\n/* 未使用或过宽 function-metrics waiver 的 supplemental audit Record data。 /\nexport type FunctionMetricsFindingWaiverAuditRecordData =\n FindingWaiverAuditRecordData<FunctionMetricsFindingIdentity>;\n\n/* 一条已被 files policy 选中、但不受 functionMetrics 支持的输入 Finding。 /\nexport type FunctionMetricsInputRejectedRecordData = Readonly<{\n readonly blocking: false;\n readonly codeAreas: readonly string[];\n readonly kind: \"input-rejected\";\n readonly path: string;\n readonly reason: \"unsupported-file-type\";\n}>;\n\n/* functionMetrics 发布的 metric、input-rejection 或 finding-waiver audit Record data。 /\nexport type FunctionMetricsRecordData =\n \| FunctionMetricsFindingRecordData\n \| FunctionMetricsInputRejectedRecordData\n \| FunctionMetricsFindingWaiverAuditRecordData;\n\nexport interface FunctionRecordCandidate {\n readonly data: FunctionMetricsFindingRecordData;\n readonly id: string;\n}\n\nexport interface FunctionInputRejectedCandidate {\n readonly data: FunctionMetricsInputRejectedRecordData;\n readonly id: string;\n}\n\n/* 为每个 rejected path 构造一条 area-aware、固定 non-blocking 的 Finding。 /\nexport function buildFunctionInputRejectedCandidates(\n codeAreasByPath: ReadonlyMap<string, readonly string[]>\n): readonly FunctionInputRejectedCandidate[] {\n return Object.freeze(\n [...codeAreasByPath]\n .sort(([left], [right]) => compareText(left, right))\n .map(([path, codeAreas]) =>\n Object.freeze({\n data: Object.freeze({\n blocking: false as const,\n codeAreas: Object.freeze(uniqueSorted(codeAreas)),\n kind: \"input-rejected\" as const,\n path,\n reason: \"unsupported-file-type\" as const\n }),\n id: `${INPUT_REJECTED_RECORD_ID_PREFIX}${path}`\n })\n )\n );\n}\n\ntype MatchingFunctionMetricAreas = readonly [\n FunctionMetricsAreaInput,\n ...FunctionMetricsAreaInput[]\n];\n\ninterface FunctionPolicyContext {\n readonly blocking: boolean;\n readonly codeAreas: readonly string[];\n readonly functionName: string;\n}\n\ninterface FunctionMetricEvaluation {\n readonly blocking: boolean;\n readonly codeAreas: readonly string[];\n readonly complexityContributors?: FunctionMetric[\"complexityContributors\"];\n readonly functionName: string;\n readonly limit: number;\n readonly metric: FunctionMetricsFindingMetric;\n readonly path: string;\n readonly startLine: number;\n readonly subject: string;\n readonly value: number;\n}\n\nexport function functionMetricsFindingIdentity(\n candidate: FunctionRecordCandidate\n): FunctionMetricsFindingIdentity {\n const { functionName, metric, path, startLine } = candidate.data;\n return Object.freeze({ functionName, metric, path, startLine });\n}\n\nexport function functionMetricsWaiverIdentity(\n waiver: MaterializedFindingWaiver\n): FunctionMetricsFindingIdentity {\n const identity = resolveFunctionMetricsFindingIdentity(waiver.identity);\n if (identity === undefined) {\n throw new TypeError(\"functionMetrics waiver identity must retain a valid metric subject\");\n }\n return identity;\n}\n\n/* 为一项未使用或过宽 waiver 构造 Check-owned audit Record。 /\nexport function functionMetricsWaiverAuditRecord(audit: FindingWaiverRecordAudit): Readonly<{\n readonly data: FunctionMetricsFindingWaiverAuditRecordData;\n readonly id: string;\n}> {\n const identity = functionMetricsWaiverIdentity(audit.waiver);\n return buildHashedFindingWaiverAuditRecord(identity, audit);\n}\n\n/* 为每个超过 matching-area 最严格阈值的 metric 构造 supplemental fact。 */\nexport function buildFunctionRecordCandidates(\n analysis: FunctionMetricAnalysis,\n areas: readonly FunctionMetricsAreaInput[]\n): readonly FunctionRecordCandidate[] \| undefined {\n const areasByPath = indexAreasByPath(areas);\n const candidates: FunctionRecordCandidate[] = [];\n for (const instance of analysis.instances) {\n const [firstArea, ...remainingAreas] = areasByPath.get(instance.metric.file) ?? [];\n if (firstArea === undefined) return undefined;\n const matchingAreas = [firstArea, ...remainingAreas] as const;\n const policyContext = resolveFunctionPolicyContext(instance, matchingAreas);\n for (const evaluation of metricEvaluations(instance, policyContext, matchingAreas)) {\n appendFindingCandidate(candidates, evaluation);\n }\n }\n candidates.sort((left, right) => compareText(left.id, right.id));\n return Object.freeze(candidates);\n}\n\nfunction indexAreasByPath(\n areas: readonly FunctionMetricsAreaInput[]\n): ReadonlyMap<string, readonly FunctionMetricsAreaInput[]> {\n const mutableAreas = new Map<string, FunctionMetricsAreaInput[]>();\n for (const area of areas) {\n for (const path of area.approvedExactPaths) {\n const matchingAreas = mutableAreas.get(path) ?? [];\n matchingAreas.push(area);\n mutableAreas.set(path, matchingAreas);\n }\n }\n return new Map(\n Array.from(mutableAreas, ([path, matchingAreas]) => [path, Object.freeze(matchingAreas)])\n );\n}\n\nfunction resolveFunctionPolicyContext(\n instance: FunctionMetricInstance,\n matchingAreas: MatchingFunctionMetricAreas\n): Readonly<FunctionPolicyContext> {\n return Object.freeze({\n blocking: isBlockingFinding(matchingAreas.map((area) => area.findingPolicy)),\n codeAreas: Object.freeze(uniqueSorted(matchingAreas.map((area) => area.codeArea))),\n functionName: isStableFunctionName(instance.metric.name) ? instance.metric.name : \"<anonymous>\"\n });\n}\n\nfunction metricEvaluations(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation[] {\n const evaluations: FunctionMetricEvaluation[] = [];\n const complexityEvaluation = complexityMetricEvaluation(instance, policyContext, matchingAreas);\n if (complexityEvaluation !== null) evaluations.push(complexityEvaluation);\n evaluations.push(\n codeLinesMetricEvaluation(instance, policyContext, matchingAreas),\n nestingDepthMetricEvaluation(instance, policyContext, matchingAreas),\n parameterMetricEvaluation(instance, policyContext, matchingAreas)\n );\n return evaluations;\n}\n\nfunction sharedMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext\n) {\n return {\n blocking: policyContext.blocking,\n codeAreas: policyContext.codeAreas,\n functionName: policyContext.functionName,\n path: instance.metric.file,\n startLine: instance.metric.startLine,\n subject: instance.semanticSubject\n } as const;\n}\n\nfunction complexityMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation \| null {\n const value = instance.metric.cyclomaticComplexity.value;\n if (value === null) return null;\n return {\n ...sharedMetricEvaluation(instance, policyContext),\n complexityContributors: instance.metric.complexityContributors,\n limit: Math.min(...matchingAreas.map((area) => area.limits.cyclomaticComplexity.maximum)),\n metric: \"cyclomatic-complexity\",\n value\n };\n}\n\nfunction nestingDepthMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation {\n return {\n ...sharedMetricEvaluation(instance, policyContext),\n limit: Math.min(...matchingAreas.map((area) => area.limits.nestingDepth.maximum)),\n metric: \"nesting-depth\",\n value: instance.metric.nestingDepth.value\n };\n}\n\nfunction codeLinesMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation {\n return {\n ...sharedMetricEvaluation(instance, policyContext),\n limit: Math.min(\n ...matchingAreas.map((area) => functionCodeLineMaximum(instance.metric, area.limits))\n ),\n metric: \"function-code-density\",\n value: instance.metric.lines\n };\n}\n\nfunction parameterMetricEvaluation(\n instance: FunctionMetricInstance,\n policyContext: FunctionPolicyContext,\n matchingAreas: MatchingFunctionMetricAreas\n): FunctionMetricEvaluation {\n return {\n ...sharedMetricEvaluation(instance, policyContext),\n limit: Math.min(...matchingAreas.map((area) => area.limits.parameters.maximum)),\n metric: \"parameter-count\",\n value: instance.metric.parameterCount\n };\n}\n\nfunction appendFindingCandidate(\n candidates: FunctionRecordCandidate[],\n evaluation: FunctionMetricEvaluation\n): void {\n if (evaluation.value <= evaluation.limit) return;\n candidates.push(\n Object.freeze({\n id: `${evaluation.subject}:${evaluation.metric}`,\n data: Object.freeze({\n blocking: evaluation.blocking,\n codeAreas: evaluation.codeAreas,\n ...(evaluation.complexityContributors === undefined\n ? {}\n : { complexityContributors: evaluation.complexityContributors }),\n functionName: evaluation.functionName,\n limit: evaluation.limit,\n metric: evaluation.metric,\n path: evaluation.path,\n startLine: evaluation.startLine,\n value: evaluation.value\n })\n })\n );\n}\n\nfunction functionCodeLineMaximum(\n metric: FunctionMetric,\n limits: ResolvedFunctionMetricsLimits\n): number {\n const allowance = limits.codeLines.lowComplexityAllowance;\n const complexity = metric.cyclomaticComplexity.value;\n return complexity !== null && complexity < allowance.cyclomaticComplexityBelow\n ? allowance.maximum\n : limits.codeLines.maximum;\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/target-files.mjs CHANGED Viewed

@@ -1,70 +1,9 @@
-/** Lizard 1.23.0 官方 language readers 支持的 exact input 扩展名。 */
-const LIZARD_SUPPORTED_FILE_EXTENSIONS = Object.freeze([
-    "c",
-    "cc",
-    "cjs",
-    "cpp",
-    "cs",
-    "cxx",
-    "erl",
-    "es",
-    "escript",
-    "f",
-    "f03",
-    "f08",
-    "f70",
-    "f90",
-    "f95",
-    "for",
-    "fpp",
-    "ftn",
-    "gd",
-    "go",
-    "h",
-    "hpp",
-    "hrl",
-    "java",
-    "js",
-    "jsx",
-    "kt",
-    "kts",
-    "lua",
-    "m",
-    "mjs",
-    "mm",
-    "pck",
-    "php",
-    "pkb",
-    "pks",
-    "pl",
-    "plb",
-    "pls",
-    "pm",
-    "py",
-    "r",
-    "rb",
-    "rs",
-    "scala",
-    "sol",
-    "sql",
-    "st",
-    "swift",
-    "ts",
-    "ttcn",
-    "ttcnpp",
-    "tsx",
-    "vue",
-    "zig"
-]);
-const LIZARD_SUPPORTED_FILE_EXTENSION_SET = new Set(LIZARD_SUPPORTED_FILE_EXTENSIONS);
-/** functionMetrics 默认 files.include 使用的 case-insensitive extension globs。 */
-export const LIZARD_SUPPORTED_FILE_GLOBS = Object.freeze(LIZARD_SUPPORTED_FILE_EXTENSIONS.map((extension) => `**/*.${caseInsensitiveExtensionPattern(extension)}`));
-export function isLizardTarget(filePath) {
-    const extensionSeparator = filePath.lastIndexOf(".");
-    if (extensionSeparator < 0)
-        return false;
-    const extension = filePath.slice(extensionSeparator + 1).toLowerCase();
-    return LIZARD_SUPPORTED_FILE_EXTENSION_SET.has(extension);
+import { FUNCTION_METRICS_SUPPORTED_FILE_EXTENSIONS, isFunctionMetricsAnalyzerSourceSupported } from "./analyzer-adapter.mjs";
+/** functionMetrics default files.include uses the adapter's case-insensitive suffix capability. */
+export const FUNCTION_METRICS_SUPPORTED_FILE_GLOBS = Object.freeze(FUNCTION_METRICS_SUPPORTED_FILE_EXTENSIONS.map((extension) => `**/*.${caseInsensitiveExtensionPattern(extension)}`));
+/** Whether an exact project-relative path has a translated analyzer reader. */
+export function isFunctionMetricsTarget(filePath) {
+    return isFunctionMetricsAnalyzerSourceSupported(filePath);
 }
 function caseInsensitiveExtensionPattern(extension) {
     return extension

package/dist/esm/package-checks/function-metrics/target-files.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"target-files.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/target-files.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,MAAM,gCAAgC,GAAG,MAAM,CAAC,MAAM,CAAC;IACrD,GAAG;IACH,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,SAAS;IACT,GAAG;IACH,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,GAAG;IACH,KAAK;IACL,KAAK;IACL,MAAM;IACN,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,GAAG;IACH,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,OAAO~~;IACP~~,~~KAAK;IACL~~,~~KAAK;IACL~~,~~IAAI;IACJ~~,~~OAAO;IACP~~,~~IAAI;IACJ~~,MAAM~~;IACN~~,~~QAAQ;IACR~~,~~KAAK;IACL,KAAK;IACL,KAAK;CACG,~~CAAC~~,CAAC~~;~~AAEZ~~,~~MAAM,mCAAmC,GAAwB,IAAI,GAAG,CACtE,gCAAgC,CACjC,CAAC~~;~~AAEF~~,~~6EAA6E;AAC7E,~~MAAM,CAAC,MAAM,~~2BAA2B~~,GAAG,MAAM,CAAC,MAAM,~~CACtD~~,~~gCAAgC~~,CAAC,GAAG,~~CAClC~~,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,+BAA+B,CAAC,SAAS,CAAC,EAAE,CACpE,CACF,CAAC;AAEF,MAAM,UAAU,~~cAAc~~,CAAC,QAAgB;~~IAC7C~~,~~MAAM,kBAAkB,GAAG,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACrD,IAAI,kBAAkB,GAAG,CAAC;QAAE,~~OAAO,~~KAAK~~,CAAC~~;IACzC~~,~~MAAM,SAAS,GAAG,~~QAAQ,CAAC,~~KAAK,~~CAAC~~,kBAAkB,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC~~;~~IACvE,OAAO,mCAAmC,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;~~AAC5D,CAAC;AAED,SAAS,+BAA+B,CAAC,SAAiB;IACxD,OAAO,SAAS;SACb,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACjB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAClF;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC","sourcesContent":["/** ~~Lizard 1.23.0 官方 language readers 支持的 exact input 扩展名。 /\nconst LIZARD_SUPPORTED_FILE_EXTENSIONS = Object.freeze([~~\n ~~\"c\"~~,\n \~~"cc\",\~~n \"cjs\",\n \"cpp\",\n \"cs\",\n \"cxx\",\n \"erl\",\n \"es\",\n \"escript\",\n \"f\",\n \"f03\",\n \"f08\",\n \"f70\",\n \"f90\",\n \"f95\",\n \"for\",\n \"fpp\",\n \"ftn\",\n \"gd\",\n \"go\",\n \"h\",\n \"hpp\",\n \"hrl\",\n \"java\",\n \"js\",\n \"jsx\",\n \"kt\",\n \"kts\",\n \"lua\",\n \"m\",\n \"mjs\",\n \"mm\",\n \"pck\",\n \"php\",\n \"pkb\",\n \"pks\",\n \"pl\",\n \"plb\",\n \"pls\",\n \"pm\",\n \"py\",\n \"r\",\n \"rb\",\n \"rs\",\n \"scala\",\n \"sol\",\n \"sql\",\n \"st\",\n \"swift\",\n \"ts\"~~,\n \"ttcn\",\n \"ttcnpp\",\n \"tsx\",\n \"vue\",\n \"zig\"\n] as const)~~;\n\~~nconst LIZARD_SUPPORTED_FILE_EXTENSION_SET: ReadonlySet<string> = new Set(\~~n ~~LIZARD_SUPPORTED_FILE_EXTENSIONS\n);\n\n~~/* functionMetrics 默认 files.include ~~使用的~~ case-insensitive ~~extension~~ ~~globs。~~ /\nexport const ~~LIZARD_SUPPORTED_FILE_GLOBS~~ = Object.freeze(\n ~~LIZARD_SUPPORTED_FILE_EXTENSIONS~~.map(\n (extension) => `/.${caseInsensitiveExtensionPattern(extension)}`\n )\n);\n\nexport function ~~isLizardTarget~~(filePath: string): boolean {\n ~~const~~ ~~extensionSeparator = filePath.lastIndexOf~~(~~\".\");\n if (extensionSeparator < 0) return false;\n const extension =~~ filePath~~.slice(extensionSeparator + 1~~)~~.toLowerCase()~~;\n ~~return LIZARD_SUPPORTED_FILE_EXTENSION_SET.has(extension);\n~~}\n\nfunction caseInsensitiveExtensionPattern(extension: string): string {\n return extension\n .split(\"\")\n .map((character) =>\n /[a-z]/u.test(character) ? `[${character}${character.toUpperCase()}]` : character\n )\n .join(\"\");\n}\n"]}
1	+ {"version":3,"file":"target-files.mjs","sourceRoot":"","sources":["../../../../src/package-checks/function-metrics/target-files.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0CAA0C,EAC1C,wCAAwC,EACzC,MAAM,uBAAuB,CAAC;AAE/B,mGAAmG;AACnG,MAAM,CAAC,MAAM,qCAAqC,GAAG,MAAM,CAAC,MAAM,CAChE,0CAA0C,CAAC,GAAG,CAC5C,CAAC,SAAS,EAAE,EAAE,CAAC,QAAQ,+BAA+B,CAAC,SAAS,CAAC,EAAE,CACpE,CACF,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IACtD,OAAO,wCAAwC,CAAC,QAAQ,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,+BAA+B,CAAC,SAAiB;IACxD,OAAO,SAAS;SACb,KAAK,CAAC,EAAE,CAAC;SACT,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CACjB,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,SAAS,GAAG,SAAS,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,CAAC,SAAS,CAClF;SACA,IAAI,CAAC,EAAE,CAAC,CAAC;AACd,CAAC","sourcesContent":["import {\n FUNCTION_METRICS_SUPPORTED_FILE_EXTENSIONS,\n isFunctionMetricsAnalyzerSourceSupported\n} from \"./analyzer-adapter.ts\";\n\n/** functionMetrics default files.include uses the adapter's case-insensitive suffix capability. /\nexport const FUNCTION_METRICS_SUPPORTED_FILE_GLOBS = Object.freeze(\n FUNCTION_METRICS_SUPPORTED_FILE_EXTENSIONS.map(\n (extension) => `/.${caseInsensitiveExtensionPattern(extension)}`\n )\n);\n\n/** Whether an exact project-relative path has a translated analyzer reader. */\nexport function isFunctionMetricsTarget(filePath: string): boolean {\n return isFunctionMetricsAnalyzerSourceSupported(filePath);\n}\n\nfunction caseInsensitiveExtensionPattern(extension: string): string {\n return extension\n .split(\"\")\n .map((character) =>\n /[a-z]/u.test(character) ? `[${character}${character.toUpperCase()}]` : character\n )\n .join(\"\");\n}\n"]}

package/dist/esm/package-checks/{function-metrics/lizard → host-environment}/csv.mjs RENAMED Viewed

@@ -1,4 +1,5 @@
 import { parse } from "csv-parse/sync";
+/** Parses untrusted scanner CSV into a complete matrix of strings. */
 export function parseCsvRows(csv) {
     const records = parse(csv, {
         bom: true,

package/dist/esm/package-checks/host-environment/csv.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"csv.mjs","sourceRoot":"","sources":["../../../../src/package-checks/host-environment/csv.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,sEAAsE;AACtE,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;IACH,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;IACD,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\n/** Parses untrusted scanner CSV into a complete matrix of strings. */\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 if (!Array.isArray(records) || !records.every(isStringRow)) {\n throw new Error(\"CSV parser returned non-string rows\");\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/host-environment/git.mjs CHANGED Viewed

@@ -1,8 +1,19 @@
-import { processFailed, runProcessSync } from "./process/command.mjs";
+import { processFailed, runProcessSync } from "./process.mjs";
 import { toSlashPath } from "./path.mjs";
 export function runGit(options) {
     return runProcessSync({ command: "git", ...options });
 }
+/** Renders the actionable failure evidence shared by Git operation boundaries. */
+export function gitFailureDetail(result) {
+    const stderr = result.stderr.trim();
+    if (stderr.length > 0)
+        return stderr;
+    const processErrorMessage = result.error?.message;
+    if (processErrorMessage !== undefined && processErrorMessage.length > 0) {
+        return processErrorMessage;
+    }
+    return result.signal === null ? `exit status ${result.status}` : `signal ${result.signal}`;
+}
 export function gitHeadSha(cwd) {
     const result = runGit({ args: ["rev-parse", "HEAD"], cwd });
     if (processFailed(result))

package/dist/esm/package-checks/host-environment/git.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"git.mjs","sourceRoot":"","sources":["../../../../src/package-checks/host-environment/git.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,~~sBAAsB~~,CAAC;~~AAErE~~,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAaxC,MAAM,UAAU,MAAM,CAAC,OAAsB;IAC3C,OAAO,cAAc,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,MAAM,MAAM,GAAG,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5D,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,OAAyB;IACrD,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAyB;IACtD,OAAO,WAAW,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,OAAO,MAAM;SACV,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC;SACzC,GAAG,CAAC,WAAW,CAAC,CAAC;AACtB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,MAAc;IAChD,OAAO,MAAM;SACV,KAAK,CAAC,OAAO,CAAC;SACd,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;SAC7B,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACrC,MAAM,YAAY,GAAG,MAAM,CAAC;QAC5B,OAAO,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;YACnC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,MAAM,CAAC;YACpE,CAAC,CAAC,OAAO,CAAC;IACd,CAAC,CAAC;SACD,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,WAAW,CAAC,CAAC;AACtB,CAAC;AAED,SAAS,WAAW,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,EAAsB;IAC7D,MAAM,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI,EAAE,CAAC,KAAK,EAAE,YAAY,MAAM,EAAE,EAAE,eAAe,EAAE,OAAO,CAAC,GAAG,CAAC;QACjE,GAAG,EAAE,OAAO,CAAC,GAAG;KACjB,CAAC,CAAC;IACH,IAAI,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACvC,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;AACtC,CAAC","sourcesContent":["import { processFailed, runProcessSync } from \"./process~~/command~~.ts\";\nimport type { ProcessResult, RunProcessSyncOptions } from \"./process~~/command~~.ts\";\nimport { toSlashPath } from \"./path.ts\";\n\nexport type RunGitOptions = Omit<RunProcessSyncOptions, \"command\">;\n\nexport type GitCommitOptions = {\n readonly cwd: string;\n readonly sha: string;\n};\n\ntype GitLogFieldOptions = GitCommitOptions & {\n readonly format: string;\n};\n\nexport function runGit(options: RunGitOptions): ProcessResult {\n return runProcessSync({ command: \"git\", ...options });\n}\n\nexport function gitHeadSha(cwd: string): string \| null {\n const result = runGit({ args: [\"rev-parse\", \"HEAD\"], cwd });\n if (processFailed(result)) return null;\n return result.stdout.trim() \|\| null;\n}\n\nexport function gitCommitDate(options: GitCommitOptions): string \| null {\n return gitLogField({ format: \"%aI\", ...options });\n}\n\nexport function gitCommitTitle(options: GitCommitOptions): string \| null {\n return gitLogField({ format: \"%s\", ...options });\n}\n\nexport function splitGitFileList(stdout: string): string[] {\n return stdout.trim().split(/\\r?\\n/).filter(Boolean).map(toSlashPath);\n}\n\nexport function splitNulDelimitedGitFileList(stdout: string): string[] {\n return stdout\n .split(\"\\0\")\n .filter((filePath) => filePath.length > 0)\n .map(toSlashPath);\n}\n\nexport function parseGitStatusPaths(stdout: string): string[] {\n return stdout\n .split(/\\r?\\n/)\n .map((line) => line.trimEnd())\n .filter(Boolean)\n .map((line) => {\n const rawPath = line.slice(3).trim();\n const renameMarker = \" -> \";\n return rawPath.includes(renameMarker)\n ? rawPath.slice(rawPath.indexOf(renameMarker) + renameMarker.length)\n : rawPath;\n })\n .filter(Boolean)\n .map(toSlashPath);\n}\n\nfunction gitLogField({ format, ...options }: GitLogFieldOptions): string \| null {\n const result = runGit({\n args: [\"log\", `--format=${format}`, \"--max-count=1\", options.sha],\n cwd: options.cwd\n });\n if (processFailed(result)) return null;\n return result.stdout.trim() \|\| null;\n}\n"]}
1	+ {"version":3,"file":"git.mjs","sourceRoot":"","sources":["../../../../src/package-checks/host-environment/git.ts"],"names":[],"mappings":"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","sourcesContent":["import { processFailed, runProcessSync } from \"./process.ts\";\nimport type { ProcessResult, RunProcessSyncOptions } from \"./process.ts\";\nimport { toSlashPath } from \"./path.ts\";\n\nexport type RunGitOptions = Omit<RunProcessSyncOptions, \"command\">;\n\nexport type GitCommitOptions = {\n readonly cwd: string;\n readonly sha: string;\n};\n\ntype GitLogFieldOptions = GitCommitOptions & {\n readonly format: string;\n};\n\nexport function runGit(options: RunGitOptions): ProcessResult {\n return runProcessSync({ command: \"git\", ...options });\n}\n\n/** Renders the actionable failure evidence shared by Git operation boundaries. */\nexport function gitFailureDetail(result: ProcessResult): string {\n const stderr = result.stderr.trim();\n if (stderr.length > 0) return stderr;\n const processErrorMessage = result.error?.message;\n if (processErrorMessage !== undefined && processErrorMessage.length > 0) {\n return processErrorMessage;\n }\n return result.signal === null ? `exit status ${result.status}` : `signal ${result.signal}`;\n}\n\nexport function gitHeadSha(cwd: string): string \| null {\n const result = runGit({ args: [\"rev-parse\", \"HEAD\"], cwd });\n if (processFailed(result)) return null;\n return result.stdout.trim() \|\| null;\n}\n\nexport function gitCommitDate(options: GitCommitOptions): string \| null {\n return gitLogField({ format: \"%aI\", ...options });\n}\n\nexport function gitCommitTitle(options: GitCommitOptions): string \| null {\n return gitLogField({ format: \"%s\", ...options });\n}\n\nexport function splitGitFileList(stdout: string): string[] {\n return stdout.trim().split(/\\r?\\n/).filter(Boolean).map(toSlashPath);\n}\n\nexport function splitNulDelimitedGitFileList(stdout: string): string[] {\n return stdout\n .split(\"\\0\")\n .filter((filePath) => filePath.length > 0)\n .map(toSlashPath);\n}\n\nexport function parseGitStatusPaths(stdout: string): string[] {\n return stdout\n .split(/\\r?\\n/)\n .map((line) => line.trimEnd())\n .filter(Boolean)\n .map((line) => {\n const rawPath = line.slice(3).trim();\n const renameMarker = \" -> \";\n return rawPath.includes(renameMarker)\n ? rawPath.slice(rawPath.indexOf(renameMarker) + renameMarker.length)\n : rawPath;\n })\n .filter(Boolean)\n .map(toSlashPath);\n}\n\nfunction gitLogField({ format, ...options }: GitLogFieldOptions): string \| null {\n const result = runGit({\n args: [\"log\", `--format=${format}`, \"--max-count=1\", options.sha],\n cwd: options.cwd\n });\n if (processFailed(result)) return null;\n return result.stdout.trim() \|\| null;\n}\n"]}

package/dist/esm/package-checks/host-environment/path.mjs CHANGED Viewed

@@ -1,18 +1,2 @@
-export function toSlashPath(filePath) {
-    return filePath.replace(/\\/g, "/");
-}
-/** 判断值是否已是跨平台可稳定发布的 project-root-relative slash path。 */
-export function isNormalizedProjectRelativePath(value) {
-    if (typeof value !== "string" ||
-        value.length === 0 ||
-        value.startsWith("/") ||
-        value.includes("\\") ||
-        value.includes("\u0000") ||
-        /^[A-Za-z]:/u.test(value)) {
-        return false;
-    }
-    return value
-        .split("/")
-        .every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
-}
+export { isNormalizedProjectRelativePath, toSlashPath } from "../../data-boundary/project-path.mjs";
 //# sourceMappingURL=path.mjs.map

package/dist/esm/package-checks/host-environment/path.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"path.mjs","sourceRoot":"","sources":["../../../../src/package-checks/host-environment/path.ts"],"names":[],"mappings":"AAAA,~~MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,~~OAAO,~~QAAQ,CAAC,OAAO,CAAC,KAAK,~~EAAE~~,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU~~,+BAA+B,~~CAAC~~,~~KAAc;IAC5D~~,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,KAAK,CAAC,CAAC,OAAO,EAAE,~~EAAE,CAAC,OAAO,CAAC,~~MAAM,~~GAAG~~,CAAC~~,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC;AACnF,CAAC~~","sourcesContent":["export ~~function toSlashPath(filePath: string): string~~ {~~\n return~~ ~~filePath.replace(/\\\\/g~~, ~~\"/\");\n~~}\n\n/** ~~判断值是否已是跨平台可稳定发布的~~ ~~project-root-relative slash path。 */\nexport function isNormalizedProjectRelativePath(value: unknown): value is string {~~\~~n if (\n typeof value !== \~~"~~string\" \|\|\n value.length === 0 \|\|\n value.startsWith(\"/\") \|\|\n value.includes(\"\\\\\") \|\|\n value.includes(\"\\u0000\") \|\|\n /^[A~~-Za-~~z]:/u~~.~~test(value)~~\~~n ) {\n return false;\n }\n return value\n .split(\~~"~~/\")\n .every((segment) => segment.length > 0 && segment !== \".\" && segment !== \"..\")~~;\n~~}\n~~"]}
1	+ {"version":3,"file":"path.mjs","sourceRoot":"","sources":["../../../../src/package-checks/host-environment/path.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAC","sourcesContent":["export { isNormalizedProjectRelativePath, toSlashPath } from \"../../data-boundary/project-path.ts\";\n"]}

package/dist/esm/package-checks/host-environment/process/contract.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"contract.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/host-environment/process/contract.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC","sourcesContent":["import type { SyncOptions } from \"execa\";\n\nexport const DEFAULT_PROCESS_MAX_BUFFER_BYTES = 64 * 1024 * 1024;\n\nexport interface ProcessFailure extends Error {\n code?: number \| string \| null;\n signal?: NodeJS.Signals \| null;\n status?: number \| null;\n stderr?: Buffer \| string;\n stdout?: Buffer \| string;\n}\n\nexport type ProcessResult = {\n readonly error?: Error;\n readonly signal: NodeJS.Signals \| null;\n readonly status: number \| null;\n readonly stderr: string;\n readonly stdout: string;\n};\n\nexport type RunProcessSyncOptions = {\n readonly args: readonly string[];\n readonly command: string;\n readonly cwd?: string \| URL;\n readonly encoding?: SyncOptions[\"encoding\"];\n readonly env?: NodeJS.ProcessEnv;\n readonly maxBuffer?: number;\n readonly stdio?: SyncOptions[\"stdio\"];\n readonly timeout?: number;\n readonly windowsHide?: boolean;\n};\n\nexport type RunProcessOptions = {\n readonly args?: readonly string[];\n readonly command: string;\n readonly cwd?: string \| URL;\n readonly env?: NodeJS.ProcessEnv;\n readonly label?: string;\n readonly maxBuffer?: number;\n readonly timeout?: number;\n readonly windowsHide?: boolean;\n};\n\nexport type ExecaResultLike = {\n readonly code?: string;\n readonly exitCode?: number;\n readonly failed?: boolean;\n readonly isMaxBuffer?: boolean;\n readonly message?: string;\n readonly originalMessage?: string;\n readonly shortMessage?: string;\n readonly signal?: NodeJS.Signals;\n readonly stderr?: unknown;\n readonly stdout?: unknown;\n readonly timedOut?: boolean;\n};\n"]}
1	+ {"version":3,"file":"contract.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/host-environment/process/contract.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gCAAgC,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC","sourcesContent":["import type { SyncOptions } from \"execa\";\n\nexport const DEFAULT_PROCESS_MAX_BUFFER_BYTES = 64 * 1024 * 1024;\n\nexport interface ProcessFailure extends Error {\n code?: number \| string \| null;\n signal?: NodeJS.Signals \| null;\n status?: number \| null;\n stderr?: Buffer \| string;\n stdout?: Buffer \| string;\n}\n\nexport type ProcessResult = {\n readonly error?: Error;\n readonly isCanceled?: true;\n readonly isMaxBuffer?: true;\n readonly signal: NodeJS.Signals \| null;\n readonly status: number \| null;\n readonly stderr: string;\n readonly timedOut?: true;\n readonly stdout: string;\n};\n\nexport type RunProcessSyncOptions = {\n readonly args: readonly string[];\n readonly command: string;\n readonly cwd?: string \| URL;\n readonly encoding?: SyncOptions[\"encoding\"];\n readonly env?: NodeJS.ProcessEnv;\n readonly maxBuffer?: number;\n readonly stdio?: SyncOptions[\"stdio\"];\n readonly timeout?: number;\n readonly windowsHide?: boolean;\n};\n\nexport type RunProcessOptions = {\n readonly args?: readonly string[];\n readonly cancelSignal?: AbortSignal;\n readonly command: string;\n readonly cwd?: string \| URL;\n /** `false` uses only the supplied `env`; omission preserves Execa's inherited default. /\n readonly extendEnv?: boolean;\n readonly env?: NodeJS.ProcessEnv;\n readonly label?: string;\n readonly maxBuffer?: number;\n readonly timeout?: number;\n readonly windowsHide?: boolean;\n};\n\nexport type ExecaResultLike = {\n /* Execa's imported result types permit explicitly present `undefined` values. */\n readonly code?: string \| undefined;\n readonly exitCode?: number \| undefined;\n readonly failed?: boolean \| undefined;\n readonly isCanceled?: boolean \| undefined;\n readonly isMaxBuffer?: boolean \| undefined;\n readonly message?: string \| undefined;\n readonly originalMessage?: string \| undefined;\n readonly shortMessage?: string \| undefined;\n readonly signal?: NodeJS.Signals \| undefined;\n readonly stderr?: unknown;\n readonly stdout?: unknown;\n readonly timedOut?: boolean \| undefined;\n};\n"]}

package/dist/esm/package-checks/host-environment/process/result.mjs CHANGED Viewed

@@ -1,33 +1,59 @@
 export function toProcessResult(result, label) {
+    const cause = processCause(result);
+    const error = processErrorFor(result, label, cause);
     return {
-        error: processErrorFor(result, label),
+        ...(error === undefined ? {} : { error }),
+        ...(cause === "cancellation" ? { isCanceled: true } : {}),
+        ...(cause === "max-buffer" ? { isMaxBuffer: true } : {}),
         signal: result.signal ?? null,
         status: result.exitCode ?? null,
         stderr: outputString(result.stderr),
+        ...(cause === "timeout" ? { timedOut: true } : {}),
         stdout: outputString(result.stdout)
     };
 }
 function outputString(output) {
     return typeof output === "string" ? output : "";
 }
-function processErrorFor(result, label = "process") {
-    if (!isExecutionError(result)) {
+function processCause(result) {
+    if (typeof result.exitCode === "number" && result.exitCode !== 0)
+        return "exit";
+    if (result.isCanceled === true)
+        return "cancellation";
+    if (result.timedOut === true)
+        return "timeout";
+    if (result.isMaxBuffer === true)
+        return "max-buffer";
+    if (result.signal !== undefined)
+        return "signal";
+    if (result.exitCode === 0)
+        return "exit";
+    return "startup-failure";
+}
+function processErrorFor(result, label, cause) {
+    if (!requiresProcessError(cause, result))
         return undefined;
-    }
-    const message = result.originalMessage ?? result.shortMessage ?? result.message ?? `${label} failed`;
-    const error = new Error(message);
-    if (result.code) {
-        error.code = result.code;
-    }
+    const error = new Error(processErrorMessage(result, label));
+    const code = processErrorCode(result);
+    if (code !== undefined)
+        error.code = code;
     return error;
 }
-function isExecutionError(result) {
-    if (!result.failed) {
-        return false;
-    }
-    if (typeof result.exitCode === "number") {
-        return false;
-    }
-    return Boolean(result.code || result.timedOut || result.isMaxBuffer || result.signal);
+function requiresProcessError(cause, result) {
+    return cause !== "exit" && result.failed === true;
+}
+function processErrorMessage(result, label) {
+    if (result.originalMessage !== undefined)
+        return result.originalMessage;
+    if (result.shortMessage !== undefined)
+        return result.shortMessage;
+    if (result.message !== undefined)
+        return result.message;
+    return `${label} failed`;
+}
+function processErrorCode(result) {
+    if (result.code === undefined || result.code.length === 0)
+        return undefined;
+    return result.code;
 }
 //# sourceMappingURL=result.mjs.map

package/dist/esm/package-checks/host-environment/process/result.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"result.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/host-environment/process/result.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,eAAe,CAAC,MAAuB,EAAE,KAAa;IACpE,OAAO;QACL,KAAK,EAAE,~~eAAe~~,CAAC,~~MAAM~~,EAAE,KAAK,CAAC;~~QACrC~~,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,IAAI;QAC7B,MAAM,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI;QAC/B,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;QACnC,MAAM,EAAE,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAAe;IACnC,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;AAClD,CAAC;~~AAED~~,SAAS,~~eAAe~~,CAAC,MAAuB,~~EAAE~~,KAAK,~~GAAG~~,~~SAAS~~;~~IACjE~~,IAAI,CAAC,~~gBAAgB~~,CAAC,MAAM,CAAC,~~EAAE~~,~~CAAC~~;~~QAC9B~~,OAAO,SAAS,CAAC;~~IACnB~~,CAAC;~~IAED~~,~~MAAM,~~OAAO,~~GACX~~,MAAM,CAAC,~~eAAe~~,IAAI,MAAM,CAAC,~~YAAY~~,~~IAAI~~,MAAM,CAAC,OAAO,IAAI,~~GAAG~~,KAAK,SAAS,CAAC;~~IACvF~~,MAAM,KAAK,GAA0B,IAAI,KAAK,CAAC,~~OAAO~~,CAAC,CAAC;~~IACxD~~,IAAI,MAAM,CAAC,IAAI,~~EAAE~~,~~CAAC~~;~~QAChB~~,KAAK,CAAC,IAAI,GAAG,~~MAAM~~,CAAC,~~IAAI~~,CAAC;~~IAC3B~~,CAAC;~~IACD~~,OAAO,KAAK,CAAC;~~AACf~~,CAAC;AAED,SAAS,~~gBAAgB~~,CAAC,MAAuB;~~IAC/C~~,IAAI,CAAC,MAAM,CAAC,MAAM,~~EAAE~~,~~CAAC~~;~~QACnB~~,OAAO,~~KAAK~~,CAAC~~;IACf~~,CAAC;~~IACD~~,IAAI,~~OAAO,~~MAAM,CAAC,~~QAAQ~~,KAAK,~~QAAQ~~,~~EAAE~~,CAAC;~~QACxC~~,OAAO,KAAK,CAAC;~~IACf~~,CAAC;~~IACD~~,~~OAAO~~,~~OAAO~~,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,~~QAAQ,~~IAAI,MAAM,CAAC,~~WAAW~~,~~IAAI~~,~~MAAM,~~CAAC,MAAM,CAAC,CAAC;~~AACxF~~,CAAC","sourcesContent":["import type { ExecaResultLike, ProcessResult } from \"./contract.ts\";\n\nexport function toProcessResult(result: ExecaResultLike, label: string): ProcessResult {\n return {\n error: ~~processErrorFor~~(~~result,~~ ~~label~~),\n signal: result.signal ?? null,\n status: result.exitCode ?? null,\n stderr: outputString(result.stderr),\n stdout: outputString(result.stdout)\n };\n}\n\nfunction outputString(output: unknown): string {\n return typeof output === \"string\" ? output : \"\";\n}\n\nfunction ~~processErrorFor~~(result: ExecaResultLike, ~~label~~ = \"~~process~~\"): ~~Error~~ \| ~~undefined~~ {\n if (~~!isExecutionError~~(result)) {\n return ~~undefined~~;\n }\n\n ~~const~~ ~~message~~ =\n ~~result.originalMessage~~ ?? ~~result.shortMessage~~ ?? result~~.message~~ ?? ~~`${label} failed`;\~~n const error: NodeJS.ErrnoException = new Error(~~message~~);\n if (~~result.~~code) ~~{\n~~ error.code = ~~result.~~code;\n }\n return ~~error~~;\n}\n\nfunction ~~isExecutionError~~(result: ExecaResultLike): ~~boolean~~ {\n if (!result.~~failed~~) ~~{\n~~ return ~~false~~;\n }\n if (~~typeof~~ result.~~exitCode~~ ~~===~~ ~~\"number\"~~) ~~{\n~~ return ~~false~~;\n }\n ~~return~~ ~~Boolean~~(result.code \|\| ~~result.timedOut~~ \|\| result.~~isMaxBuffer~~ \|\| result.~~signal)~~;\n}\n"]}
1	+ {"version":3,"file":"result.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/host-environment/process/result.ts"],"names":[],"mappings":"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","sourcesContent":["import type { ExecaResultLike, ProcessResult } from \"./contract.ts\";\n\nexport function toProcessResult(result: ExecaResultLike, label: string): ProcessResult {\n const cause = processCause(result);\n const error = processErrorFor(result, label, cause);\n return {\n ...(error === undefined ? {} : { error }),\n ...(cause === \"cancellation\" ? { isCanceled: true as const } : {}),\n ...(cause === \"max-buffer\" ? { isMaxBuffer: true as const } : {}),\n signal: result.signal ?? null,\n status: result.exitCode ?? null,\n stderr: outputString(result.stderr),\n ...(cause === \"timeout\" ? { timedOut: true as const } : {}),\n stdout: outputString(result.stdout)\n };\n}\n\nfunction outputString(output: unknown): string {\n return typeof output === \"string\" ? output : \"\";\n}\n\ntype ProcessCause =\n \| \"cancellation\"\n \| \"exit\"\n \| \"max-buffer\"\n \| \"signal\"\n \| \"startup-failure\"\n \| \"timeout\";\n\nfunction processCause(result: ExecaResultLike): ProcessCause {\n if (typeof result.exitCode === \"number\" && result.exitCode !== 0) return \"exit\";\n if (result.isCanceled === true) return \"cancellation\";\n if (result.timedOut === true) return \"timeout\";\n if (result.isMaxBuffer === true) return \"max-buffer\";\n if (result.signal !== undefined) return \"signal\";\n if (result.exitCode === 0) return \"exit\";\n return \"startup-failure\";\n}\n\nfunction processErrorFor(\n result: ExecaResultLike,\n label: string,\n cause: ProcessCause\n): Error \| undefined {\n if (!requiresProcessError(cause, result)) return undefined;\n\n const error: NodeJS.ErrnoException = new Error(processErrorMessage(result, label));\n const code = processErrorCode(result);\n if (code !== undefined) error.code = code;\n return error;\n}\n\nfunction requiresProcessError(cause: ProcessCause, result: ExecaResultLike): boolean {\n return cause !== \"exit\" && result.failed === true;\n}\n\nfunction processErrorMessage(result: ExecaResultLike, label: string): string {\n if (result.originalMessage !== undefined) return result.originalMessage;\n if (result.shortMessage !== undefined) return result.shortMessage;\n if (result.message !== undefined) return result.message;\n return `${label} failed`;\n}\n\nfunction processErrorCode(result: ExecaResultLike): string \| undefined {\n if (result.code === undefined \|\| result.code.length === 0) return undefined;\n return result.code;\n}\n"]}

package/dist/esm/package-checks/host-environment/process/runner.mjs CHANGED Viewed

@@ -7,7 +7,7 @@ export function runProcessSync(options) {
     const result = execaSync(command, args, {
         ...processOptions,
         encoding: processOptions.encoding ?? "utf8",
-        env: plainTextProcessEnv({ env: processOptions.env }),
+        env: plainTextProcessEnv(processOptions.env === undefined ? {} : { env: processOptions.env }),
         maxBuffer: processOptions.maxBuffer ?? DEFAULT_PROCESS_MAX_BUFFER_BYTES,
         reject: false,
         stripFinalNewline: false,
@@ -16,14 +16,16 @@ export function runProcessSync(options) {
     return toProcessResult(result, command);
 }
 export function runProcess(options) {
-    const { args = [], command, cwd, env, label = command, maxBuffer = DEFAULT_PROCESS_MAX_BUFFER_BYTES, timeout, windowsHide = true } = options;
+    const { args = [], cancelSignal, command, cwd, env, extendEnv, label = command, maxBuffer = DEFAULT_PROCESS_MAX_BUFFER_BYTES, timeout, windowsHide = true } = options;
     return execa(command, args, {
-        cwd,
-        env: plainTextProcessEnv({ env }),
+        ...(cancelSignal === undefined ? {} : { cancelSignal }),
+        ...(cwd === undefined ? {} : { cwd }),
+        ...(extendEnv === undefined ? {} : { extendEnv }),
+        env: plainTextProcessEnv(env === undefined ? {} : { env }),
         maxBuffer,
         reject: false,
         stripFinalNewline: false,
-        timeout,
+        ...(timeout === undefined ? {} : { timeout }),
         windowsHide
     }).then((result) => toProcessResult(result, label));
 }

package/dist/esm/package-checks/host-environment/process/runner.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"runner.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/host-environment/process/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,gCAAgC,EAIjC,MAAM,eAAe,CAAC;AAEvB,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,GAAG,cAAc;QACjB,QAAQ,EAAE,cAAc,CAAC,QAAQ,IAAI,MAAM;QAC3C,GAAG,EAAE,mBAAmB,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,CAAC;~~QACrD~~,SAAS,EAAE,cAAc,CAAC,SAAS,IAAI,gCAAgC;QACvE,MAAM,EAAE,KAAK;QACb,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,cAAc,CAAC,WAAW,IAAI,IAAI;KAChD,CAAC,CAAC;IACH,OAAO,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,MAAM,EACJ,IAAI,GAAG,EAAE,EACT,OAAO,EACP,GAAG,EACH,GAAG,EACH,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,gCAAgC,EAC5C,OAAO,EACP,WAAW,GAAG,IAAI,EACnB,GAAG,OAAO,CAAC;IAEZ,OAAO,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;QAC1B,GAAG;~~QACH~~,GAAG,EAAE,mBAAmB,CAAC,EAAE,GAAG,EAAE,CAAC;~~QACjC~~,SAAS;QACT,MAAM,EAAE,KAAK;QACb,iBAAiB,EAAE,KAAK;QACxB,OAAO;~~QACP~~,WAAW;KACZ,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import { execa, execaSync } from \"execa\";\n\nimport { plainTextProcessEnv } from \"./env.ts\";\nimport { toProcessResult } from \"./result.ts\";\nimport {\n DEFAULT_PROCESS_MAX_BUFFER_BYTES,\n type ProcessResult,\n type RunProcessOptions,\n type RunProcessSyncOptions\n} from \"./contract.ts\";\n\nexport function runProcessSync(options: RunProcessSyncOptions): ProcessResult {\n const { args, command, ...processOptions } = options;\n const result = execaSync(command, args, {\n ...processOptions,\n encoding: processOptions.encoding ?? \"utf8\",\n env: plainTextProcessEnv({ env: processOptions.env }),\n maxBuffer: processOptions.maxBuffer ?? DEFAULT_PROCESS_MAX_BUFFER_BYTES,\n reject: false,\n stripFinalNewline: false,\n windowsHide: processOptions.windowsHide ?? true\n });\n return toProcessResult(result, command);\n}\n\nexport function runProcess(options: RunProcessOptions): Promise<ProcessResult> {\n const {\n args = [],\n command,\n cwd,\n env,\n label = command,\n maxBuffer = DEFAULT_PROCESS_MAX_BUFFER_BYTES,\n timeout,\n windowsHide = true\n } = options;\n\n return execa(command, args, {\n cwd,\n env: plainTextProcessEnv({ env }),\n maxBuffer,\n reject: false,\n stripFinalNewline: false,\n timeout,\n windowsHide\n }).then((result) => toProcessResult(result, label));\n}\n"]}
1	+ {"version":3,"file":"runner.mjs","sourceRoot":"","sources":["../../../../../src/package-checks/host-environment/process/runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EACL,gCAAgC,EAIjC,MAAM,eAAe,CAAC;AAEvB,MAAM,UAAU,cAAc,CAAC,OAA8B;IAC3D,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,GAAG,OAAO,CAAC;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE;QACtC,GAAG,cAAc;QACjB,QAAQ,EAAE,cAAc,CAAC,QAAQ,IAAI,MAAM;QAC3C,GAAG,EAAE,mBAAmB,CAAC,cAAc,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,CAAC;QAC7F,SAAS,EAAE,cAAc,CAAC,SAAS,IAAI,gCAAgC;QACvE,MAAM,EAAE,KAAK;QACb,iBAAiB,EAAE,KAAK;QACxB,WAAW,EAAE,cAAc,CAAC,WAAW,IAAI,IAAI;KAChD,CAAC,CAAC;IACH,OAAO,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,OAA0B;IACnD,MAAM,EACJ,IAAI,GAAG,EAAE,EACT,YAAY,EACZ,OAAO,EACP,GAAG,EACH,GAAG,EACH,SAAS,EACT,KAAK,GAAG,OAAO,EACf,SAAS,GAAG,gCAAgC,EAC5C,OAAO,EACP,WAAW,GAAG,IAAI,EACnB,GAAG,OAAO,CAAC;IAEZ,OAAO,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;QAC1B,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC;QACvD,GAAG,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QACrC,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;QACjD,GAAG,EAAE,mBAAmB,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC;QAC1D,SAAS;QACT,MAAM,EAAE,KAAK;QACb,iBAAiB,EAAE,KAAK;QACxB,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;QAC7C,WAAW;KACZ,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;AACtD,CAAC","sourcesContent":["import { execa, execaSync } from \"execa\";\n\nimport { plainTextProcessEnv } from \"./env.ts\";\nimport { toProcessResult } from \"./result.ts\";\nimport {\n DEFAULT_PROCESS_MAX_BUFFER_BYTES,\n type ProcessResult,\n type RunProcessOptions,\n type RunProcessSyncOptions\n} from \"./contract.ts\";\n\nexport function runProcessSync(options: RunProcessSyncOptions): ProcessResult {\n const { args, command, ...processOptions } = options;\n const result = execaSync(command, args, {\n ...processOptions,\n encoding: processOptions.encoding ?? \"utf8\",\n env: plainTextProcessEnv(processOptions.env === undefined ? {} : { env: processOptions.env }),\n maxBuffer: processOptions.maxBuffer ?? DEFAULT_PROCESS_MAX_BUFFER_BYTES,\n reject: false,\n stripFinalNewline: false,\n windowsHide: processOptions.windowsHide ?? true\n });\n return toProcessResult(result, command);\n}\n\nexport function runProcess(options: RunProcessOptions): Promise<ProcessResult> {\n const {\n args = [],\n cancelSignal,\n command,\n cwd,\n env,\n extendEnv,\n label = command,\n maxBuffer = DEFAULT_PROCESS_MAX_BUFFER_BYTES,\n timeout,\n windowsHide = true\n } = options;\n\n return execa(command, args, {\n ...(cancelSignal === undefined ? {} : { cancelSignal }),\n ...(cwd === undefined ? {} : { cwd }),\n ...(extendEnv === undefined ? {} : { extendEnv }),\n env: plainTextProcessEnv(env === undefined ? {} : { env }),\n maxBuffer,\n reject: false,\n stripFinalNewline: false,\n ...(timeout === undefined ? {} : { timeout }),\n windowsHide\n }).then((result) => toProcessResult(result, label));\n}\n"]}

package/dist/esm/package-checks/host-environment/process.mjs ADDED Viewed

@@ -0,0 +1,5 @@
+export { processFailure, processFailureFromResult, processFailed } from "./process/failure.mjs";
+export { PLAIN_TEXT_PROCESS_ENV, plainTextProcessEnv } from "./process/env.mjs";
+export { runProcess, runProcessSync } from "./process/runner.mjs";
+export { DEFAULT_PROCESS_MAX_BUFFER_BYTES } from "./process/contract.mjs";
+//# sourceMappingURL=process.mjs.map

package/dist/esm/package-checks/host-environment/process.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"process.mjs","sourceRoot":"","sources":["../../../../src/package-checks/host-environment/process.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC/F,OAAO,EAAE,sBAAsB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,gCAAgC,EAAE,MAAM,uBAAuB,CAAC","sourcesContent":["export { processFailure, processFailureFromResult, processFailed } from \"./process/failure.ts\";\nexport { PLAIN_TEXT_PROCESS_ENV, plainTextProcessEnv } from \"./process/env.ts\";\nexport { runProcess, runProcessSync } from \"./process/runner.ts\";\nexport { DEFAULT_PROCESS_MAX_BUFFER_BYTES } from \"./process/contract.ts\";\nexport type {\n ProcessFailure,\n ProcessResult,\n RunProcessOptions,\n RunProcessSyncOptions\n} from \"./process/contract.ts\";\n"]}

package/dist/esm/package-checks/json-schema-validation/default-check.mjs CHANGED Viewed

@@ -1,25 +1,23 @@
 import { defineCheck } from "../../check/check.mjs";
+import { resolvePackageCheckAuthoringInput } from "../check-authoring.mjs";
 import { JSON_SCHEMA_VALIDATION_CHECK_DEFINITION, executeJsonSchemaValidation } from "./json-schema-validation.mjs";
 import { parseJsonSchemaValidationData } from "./final-data.mjs";
 import { resolveJsonSchemaValidationOptions } from "./options-resolution.mjs";
 import { validJsonSchemaValidationOptions } from "./options-validation.mjs";
-/**
- * 使用可省略的 file、identity、reference、schema 与 binding policy 构造 Check。
- *
- * @param options - 省略顶层字段和 file fields 使用 package defaults；显式数组是完整替换值。
- * @returns 固定 `json-schema-validation` identity、完整冻结 options、parser 与执行逻辑。
- * @throws {TypeError} input 不符合 closed authoring policy、identity 或 binding 不变量时抛出。
- */
 export function jsonSchemaValidation(options = {}) {
-    const resolvedOptions = resolveJsonSchemaValidationOptions(options);
+    const input = resolvePackageCheckAuthoringInput(options, ["files", "maximumBytes", "schemaIdentity", "referenceResolution", "schemas", "bindings"], JSON_SCHEMA_VALIDATION_CHECK_DEFINITION);
+    if (input === undefined) {
+        throw new TypeError("jsonSchemaValidation options must match the documented closed policy");
+    }
+    const resolvedOptions = resolveJsonSchemaValidationOptions(input.domainOptions);
     if (resolvedOptions === undefined) {
         throw new TypeError("jsonSchemaValidation options must match the documented closed policy");
     }
     return defineCheck({
-        ...JSON_SCHEMA_VALIDATION_CHECK_DEFINITION,
-        execution: executeJsonSchemaValidation,
+        ...input.definition,
+        execute: executeJsonSchemaValidation,
         parseData: parseJsonSchemaValidationData,
-        preflight: (preparedOptions) => validJsonSchemaValidationOptions(preparedOptions)
+        prepare: (preparedOptions) => validJsonSchemaValidationOptions(preparedOptions)
             ? { status: "success", preparedOptions }
             : {
                 status: "failure",