@zxyycom/vibe-check 0.0.2 → 0.0.3

package/dist/esm/package-checks/markdown-link-validation/options-resolution.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAC/E,OAAO,EACL,uBAAuB,EACvB,gCAAgC,EAChC,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAElG,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAE7E,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC;IACnC,gBAAgB,EAAE,SAAS;IAC3B,cAAc,EAAE,MAAM;IACtB,cAAc,EAAE,KAAK;CACtB,CAAC,CAAC;AACH,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,2BAA2B,CAAC,OAAO;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,eAAe,EAAE,uCAAuC,CAAC,CAAC;IAClF,MAAM,EAAE,2BAA2B,CAAC,MAAM;CAC3C,CAAC,CAAC;AAEH,6DAA6D;AAC7D,MAAM,UAAU,oCAAoC,CAClD,KAAc;IAEd,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,CAAC,6BAA6B,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC5D,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,aAAa,GAAG,oBAAoB,CAAC,KAAK,CAAC,aAAa,EAAE,sBAAsB,CAAC,CAAC;IACxF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACzC,IACE,MAAM,KAAK,SAAS;QACpB,KAAK,KAAK,SAAS;QACnB,aAAa,KAAK,SAAS;QAC3B,KAAK,KAAK,SAAS;QAEnB,OAAO,SAAS,CAAC;IACnB,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/E,OAAO,SAAS,KAAK,SAAS,IAAI,kCAAkC,CAAC,SAAS,CAAC;QAC7E,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAwC,EACxC,KAA2D,EAC3D,aAA0E,EAC1E,MAAyC,EACzC,KAAqD;IAErD,OAAO,sBAAsB,CAAC;QAC5B,KAAK;QACL,aAAa;QACb,sBAAsB,EACpB,KAAK,CAAC,sBAAsB,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB;QAClF,2BAA2B,EACzB,KAAK,CAAC,2BAA2B,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,2BAA2B;QAC5F,4BAA4B,EAC1B,KAAK,CAAC,4BAA4B,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,4BAA4B;QAC9F,sBAAsB,EACpB,KAAK,CAAC,sBAAsB,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,sBAAsB;QACtF,0BAA0B,EACxB,KAAK,CAAC,0BAA0B,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,0BAA0B;QAC3F,KAAK;QACL,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,6BAA6B,CACpC,KAAoD;IAEpD,OAAO,CACL,KAAK,KAAK,SAAS;QACnB,gCAAgC,CAAC,KAAK,EAAE;YACtC,QAAQ,EAAE;gBACR,OAAO;gBACP,eAAe;gBACf,wBAAwB;gBACxB,6BAA6B;gBAC7B,8BAA8B;gBAC9B,wBAAwB;gBACxB,4BAA4B;gBAC5B,OAAO;gBACP,QAAQ;aACT;YACD,QAAQ,EAAE,EAAE;SACb,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAc,EAAE,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,uBAAuB,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC3E,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAc,EAAE,CAAC,CAAC;IACpD,CAAC;IACD,IACE,uBAAuB,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxD,KAAK,CAAC,OAAO,KAAK,IAAI;QACtB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,EACnC,CAAC;QACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,KAAK,KAAK,SAAS;QACxB,CAAC,CAAC,4BAA4B,CAAC,aAAa,CAAC;QAC7C,CAAC,CAAC,2BAA2B,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,cAAc,CAAC;IAC/C,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,IACE,MAAM,KAAK,SAAS;QACpB,CAAC,gCAAgC,CAAC,MAAM,EAAE;YACxC,QAAQ,EAAE,CAAC,kBAAkB,EAAE,gBAAgB,EAAE,gBAAgB,CAAC;YAClE,QAAQ,EAAE,EAAE;SACb,CAAC,EACF,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,gBAAgB,EACd,MAAM,CAAC,gBAAgB,KAAK,SAAS;YACnC,CAAC,CAAC,cAAc,CAAC,gBAAgB;YACjC,CAAC,CAAC,MAAM,CAAC,gBAAgB;QAC7B,cAAc,EACZ,MAAM,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc;QAC7F,cAAc,EACZ,MAAM,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc;KAC9F,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { canonicalizeJsonObject } from \"../../data-boundary/canonical-data.ts\";\nimport {\n  hasExactPlainRecordKeys,\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport {\n  defaultProjectFileSelection,\n  resolveProjectFileSelection,\n  snapshotProjectFileSelection\n} from \"../project-files/configuration.ts\";\nimport { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\nconst DEFAULT_LIMITS = Object.freeze({\n  maxMarkdownBytes: 1_048_576,\n  maxOccurrences: 10_000,\n  maxTargetReads: 1_000\n});\nconst DEFAULT_FILES = Object.freeze({\n  exclude: defaultProjectFileSelection.exclude,\n  include: Object.freeze([\"**/*.[mM][dD]\", \"**/*.[mM][aA][rR][kK][dD][oO][wW][nN]\"]),\n  source: defaultProjectFileSelection.source\n});\n\n/** 将可省略 Markdown link policy 物化为完整、冻结的 execution options。 */\nexport function resolveMarkdownLinkValidationOptions(\n  value: unknown\n): ResolvedMarkdownLinkValidationOptions | undefined {\n  const input = snapshotClosedRecord(value);\n  if (!isMarkdownLinkValidationInput(input)) return undefined;\n  const limits = resolvedLimits(input.limits);\n  const files = resolvedFiles(input.files);\n  const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);\n  const cache = resolvedCache(input.cache);\n  if (\n    limits === undefined ||\n    files === undefined ||\n    findingPolicy === undefined ||\n    cache === undefined\n  )\n    return undefined;\n  const candidate = optionsCandidate(input, files, findingPolicy, limits, cache);\n  return candidate !== undefined && validMarkdownLinkValidationOptions(candidate)\n    ? candidate\n    : undefined;\n}\n\nfunction optionsCandidate(\n  input: Readonly<Record<string, unknown>>,\n  files: Exclude<ReturnType<typeof resolvedFiles>, undefined>,\n  findingPolicy: Exclude<ReturnType<typeof resolveFindingPolicy>, undefined>,\n  limits: Readonly<Record<string, unknown>>,\n  cache: ResolvedMarkdownLinkValidationOptions[\"cache\"]\n) {\n  return canonicalizeJsonObject({\n    files,\n    findingPolicy,\n    requireExistingTargets:\n      input.requireExistingTargets === undefined ? true : input.requireExistingTargets,\n    validateSameDocumentAnchors:\n      input.validateSameDocumentAnchors === undefined ? true : input.validateSameDocumentAnchors,\n    validateCrossDocumentAnchors:\n      input.validateCrossDocumentAnchors === undefined ? true : input.validateCrossDocumentAnchors,\n    rootExternalTargetMode:\n      input.rootExternalTargetMode === undefined ? \"report\" : input.rootExternalTargetMode,\n    requireNonEmptyDirectories:\n      input.requireNonEmptyDirectories === undefined ? false : input.requireNonEmptyDirectories,\n    cache,\n    limits\n  });\n}\n\nfunction isMarkdownLinkValidationInput(\n  input: Readonly<Record<string, unknown>> | undefined\n): input is Readonly<Record<string, unknown>> {\n  return (\n    input !== undefined &&\n    hasRequiredAndOptionalRecordKeys(input, {\n      optional: [\n        \"files\",\n        \"findingPolicy\",\n        \"requireExistingTargets\",\n        \"validateSameDocumentAnchors\",\n        \"validateCrossDocumentAnchors\",\n        \"rootExternalTargetMode\",\n        \"requireNonEmptyDirectories\",\n        \"cache\",\n        \"limits\"\n      ],\n      required: []\n    })\n  );\n}\n\nfunction resolvedCache(value: unknown): ResolvedMarkdownLinkValidationOptions[\"cache\"] | undefined {\n  if (value === undefined) return Object.freeze({ enabled: false as const });\n  const cache = snapshotClosedRecord(value);\n  if (cache === undefined) return undefined;\n  if (hasExactPlainRecordKeys(cache, [\"enabled\"]) && cache.enabled === false) {\n    return Object.freeze({ enabled: false as const });\n  }\n  if (\n    hasExactPlainRecordKeys(cache, [\"enabled\", \"directory\"]) &&\n    cache.enabled === true &&\n    typeof cache.directory === \"string\"\n  ) {\n    return Object.freeze({ enabled: true as const, directory: cache.directory });\n  }\n  return undefined;\n}\n\nfunction resolvedFiles(value: unknown) {\n  return value === undefined\n    ? snapshotProjectFileSelection(DEFAULT_FILES)\n    : resolveProjectFileSelection(value, DEFAULT_FILES);\n}\n\nfunction resolvedLimits(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  if (value === undefined) return DEFAULT_LIMITS;\n  const limits = snapshotClosedRecord(value);\n  if (\n    limits === undefined ||\n    !hasRequiredAndOptionalRecordKeys(limits, {\n      optional: [\"maxMarkdownBytes\", \"maxOccurrences\", \"maxTargetReads\"],\n      required: []\n    })\n  ) {\n    return undefined;\n  }\n  return Object.freeze({\n    maxMarkdownBytes:\n      limits.maxMarkdownBytes === undefined\n        ? DEFAULT_LIMITS.maxMarkdownBytes\n        : limits.maxMarkdownBytes,\n    maxOccurrences:\n      limits.maxOccurrences === undefined ? DEFAULT_LIMITS.maxOccurrences : limits.maxOccurrences,\n    maxTargetReads:\n      limits.maxTargetReads === undefined ? DEFAULT_LIMITS.maxTargetReads : limits.maxTargetReads\n  });\n}\n"]}
+{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import { canonicalizeJsonObject } from \"../../data-boundary/canonical-data.ts\";\nimport {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport {\n  defaultProjectFileSelection,\n  resolveProjectFileSelection,\n  snapshotProjectFileSelection\n} from \"../project-files/configuration.ts\";\nimport { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport { resolveOptionalLocalCacheOptions } from \"../local-cache-options.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\nconst DEFAULT_LIMITS = Object.freeze({\n  maxMarkdownBytes: 1_048_576,\n  maxOccurrences: 10_000,\n  maxTargetReads: 1_000\n});\nconst DEFAULT_FILES = Object.freeze({\n  exclude: defaultProjectFileSelection.exclude,\n  include: Object.freeze([\"**/*.[mM][dD]\", \"**/*.[mM][aA][rR][kK][dD][oO][wW][nN]\"]),\n  source: defaultProjectFileSelection.source\n});\n\n/** 将可省略 Markdown link policy 物化为完整、冻结的 execution options。 */\nexport function resolveMarkdownLinkValidationOptions(\n  value: unknown\n): ResolvedMarkdownLinkValidationOptions | undefined {\n  const input = snapshotClosedRecord(value);\n  if (!isMarkdownLinkValidationInput(input)) return undefined;\n  const limits = resolvedLimits(input.limits);\n  const files = resolvedFiles(input.files);\n  const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);\n  const cache = resolveOptionalLocalCacheOptions(input.cache);\n  if (\n    limits === undefined ||\n    files === undefined ||\n    findingPolicy === undefined ||\n    cache === undefined\n  )\n    return undefined;\n  const candidate = optionsCandidate(input, files, findingPolicy, limits, cache);\n  return candidate !== undefined && validMarkdownLinkValidationOptions(candidate)\n    ? candidate\n    : undefined;\n}\n\nfunction optionsCandidate(\n  input: Readonly<Record<string, unknown>>,\n  files: Exclude<ReturnType<typeof resolvedFiles>, undefined>,\n  findingPolicy: Exclude<ReturnType<typeof resolveFindingPolicy>, undefined>,\n  limits: Readonly<Record<string, unknown>>,\n  cache: ResolvedMarkdownLinkValidationOptions[\"cache\"]\n) {\n  return canonicalizeJsonObject({\n    files,\n    findingPolicy,\n    requireExistingTargets:\n      input.requireExistingTargets === undefined ? true : input.requireExistingTargets,\n    validateSameDocumentAnchors:\n      input.validateSameDocumentAnchors === undefined ? true : input.validateSameDocumentAnchors,\n    validateCrossDocumentAnchors:\n      input.validateCrossDocumentAnchors === undefined ? true : input.validateCrossDocumentAnchors,\n    rootExternalTargetMode:\n      input.rootExternalTargetMode === undefined ? \"report\" : input.rootExternalTargetMode,\n    requireNonEmptyDirectories:\n      input.requireNonEmptyDirectories === undefined ? false : input.requireNonEmptyDirectories,\n    cache,\n    limits\n  });\n}\n\nfunction isMarkdownLinkValidationInput(\n  input: Readonly<Record<string, unknown>> | undefined\n): input is Readonly<Record<string, unknown>> {\n  return (\n    input !== undefined &&\n    hasRequiredAndOptionalRecordKeys(input, {\n      optional: [\n        \"files\",\n        \"findingPolicy\",\n        \"requireExistingTargets\",\n        \"validateSameDocumentAnchors\",\n        \"validateCrossDocumentAnchors\",\n        \"rootExternalTargetMode\",\n        \"requireNonEmptyDirectories\",\n        \"cache\",\n        \"limits\"\n      ],\n      required: []\n    })\n  );\n}\n\nfunction resolvedFiles(value: unknown) {\n  return value === undefined\n    ? snapshotProjectFileSelection(DEFAULT_FILES)\n    : resolveProjectFileSelection(value, DEFAULT_FILES);\n}\n\nfunction resolvedLimits(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  if (value === undefined) return DEFAULT_LIMITS;\n  const limits = snapshotClosedRecord(value);\n  if (\n    limits === undefined ||\n    !hasRequiredAndOptionalRecordKeys(limits, {\n      optional: [\"maxMarkdownBytes\", \"maxOccurrences\", \"maxTargetReads\"],\n      required: []\n    })\n  ) {\n    return undefined;\n  }\n  return Object.freeze({\n    maxMarkdownBytes:\n      limits.maxMarkdownBytes === undefined\n        ? DEFAULT_LIMITS.maxMarkdownBytes\n        : limits.maxMarkdownBytes,\n    maxOccurrences:\n      limits.maxOccurrences === undefined ? DEFAULT_LIMITS.maxOccurrences : limits.maxOccurrences,\n    maxTargetReads:\n      limits.maxTargetReads === undefined ? DEFAULT_LIMITS.maxTargetReads : limits.maxTargetReads\n  });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/options-validation.mjs

@@ -1,8 +1,8 @@
-import { isAbsolute } from "node:path";
 import { snapshotExactClosedRecord } from "../../data-boundary/closed-values.mjs";
 import { isPositiveSafeInteger } from "../../data-boundary/value-shapes.mjs";
 import { validProjectFileSelection } from "../project-files/configuration.mjs";
 import { validFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { validLocalCacheOptions } from "../local-cache-options.mjs";
 function boundedPositiveSafeInteger(value, maximum) {
     return isPositiveSafeInteger(value) && value <= maximum;
 }
@@ -24,21 +24,9 @@ function validOptionFields(options) {
     return (validProjectFileSelection(options.files) &&
         validFindingPolicy(options.findingPolicy) &&
         validAnchorValidationOptions(options) &&
-        validMarkdownLinkCache(options.cache) &&
+        validLocalCacheOptions(options.cache) &&
         validMarkdownLinkLimits(options.limits));
 }
-function validMarkdownLinkCache(value) {
-    const disabled = snapshotExactClosedRecord(value, ["enabled"]);
-    if (disabled !== undefined && disabled.enabled === false)
-        return true;
-    const enabled = snapshotExactClosedRecord(value, ["enabled", "directory"]);
-    return (enabled !== undefined &&
-        enabled.enabled === true &&
-        typeof enabled.directory === "string" &&
-        enabled.directory.length > 0 &&
-        !enabled.directory.includes("\0") &&
-        isAbsolute(enabled.directory));
-}
 function validAnchorValidationOptions(options) {
     return (typeof options.requireExistingTargets === "boolean" &&
         typeof options.validateSameDocumentAnchors === "boolean" &&

package/dist/esm/package-checks/markdown-link-validation/options-validation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { isAbsolute } from \"node:path\";\n\nimport { snapshotExactClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\n\nfunction boundedPositiveSafeInteger(value: unknown, maximum: number): value is number {\n  return isPositiveSafeInteger(value) && value <= maximum;\n}\n\nexport function validMarkdownLinkValidationOptions(\n  value: unknown\n): value is ResolvedMarkdownLinkValidationOptions {\n  const options = snapshotExactClosedRecord(value, [\n    \"files\",\n    \"findingPolicy\",\n    \"requireExistingTargets\",\n    \"validateSameDocumentAnchors\",\n    \"validateCrossDocumentAnchors\",\n    \"rootExternalTargetMode\",\n    \"requireNonEmptyDirectories\",\n    \"cache\",\n    \"limits\"\n  ]);\n  return options !== undefined && validOptionFields(options);\n}\n\nfunction validOptionFields(options: Readonly<Record<string, unknown>>): boolean {\n  return (\n    validProjectFileSelection(options.files) &&\n    validFindingPolicy(options.findingPolicy) &&\n    validAnchorValidationOptions(options) &&\n    validMarkdownLinkCache(options.cache) &&\n    validMarkdownLinkLimits(options.limits)\n  );\n}\n\nfunction validMarkdownLinkCache(value: unknown): boolean {\n  const disabled = snapshotExactClosedRecord(value, [\"enabled\"]);\n  if (disabled !== undefined && disabled.enabled === false) return true;\n  const enabled = snapshotExactClosedRecord(value, [\"enabled\", \"directory\"]);\n  return (\n    enabled !== undefined &&\n    enabled.enabled === true &&\n    typeof enabled.directory === \"string\" &&\n    enabled.directory.length > 0 &&\n    !enabled.directory.includes(\"\\0\") &&\n    isAbsolute(enabled.directory)\n  );\n}\n\nfunction validAnchorValidationOptions(options: Readonly<Record<string, unknown>>): boolean {\n  return (\n    typeof options.requireExistingTargets === \"boolean\" &&\n    typeof options.validateSameDocumentAnchors === \"boolean\" &&\n    typeof options.validateCrossDocumentAnchors === \"boolean\" &&\n    validRootExternalTargetMode(options.rootExternalTargetMode) &&\n    typeof options.requireNonEmptyDirectories === \"boolean\"\n  );\n}\n\nfunction validRootExternalTargetMode(value: unknown): boolean {\n  return value === \"ignore\" || value === \"report\" || value === \"validate\";\n}\n\nfunction validMarkdownLinkLimits(value: unknown): boolean {\n  const limits = snapshotExactClosedRecord(value, [\n    \"maxMarkdownBytes\",\n    \"maxOccurrences\",\n    \"maxTargetReads\"\n  ]);\n  return (\n    limits !== undefined &&\n    boundedPositiveSafeInteger(limits.maxMarkdownBytes, 16_777_216) &&\n    boundedPositiveSafeInteger(limits.maxOccurrences, 100_000) &&\n    boundedPositiveSafeInteger(limits.maxTargetReads, 10_000)\n  );\n}\n"]}
+{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/options-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AAGnE,SAAS,0BAA0B,CAAC,KAAc,EAAE,OAAe;IACjE,OAAO,qBAAqB,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,OAAO,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,kCAAkC,CAChD,KAAc;IAEd,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,EAAE;QAC/C,OAAO;QACP,eAAe;QACf,wBAAwB;QACxB,6BAA6B;QAC7B,8BAA8B;QAC9B,wBAAwB;QACxB,4BAA4B;QAC5B,OAAO;QACP,QAAQ;KACT,CAAC,CAAC;IACH,OAAO,OAAO,KAAK,SAAS,IAAI,iBAAiB,CAAC,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA0C;IACnE,OAAO,CACL,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,kBAAkB,CAAC,OAAO,CAAC,aAAa,CAAC;QACzC,4BAA4B,CAAC,OAAO,CAAC;QACrC,sBAAsB,CAAC,OAAO,CAAC,KAAK,CAAC;QACrC,uBAAuB,CAAC,OAAO,CAAC,MAAM,CAAC,CACxC,CAAC;AACJ,CAAC;AAED,SAAS,4BAA4B,CAAC,OAA0C;IAC9E,OAAO,CACL,OAAO,OAAO,CAAC,sBAAsB,KAAK,SAAS;QACnD,OAAO,OAAO,CAAC,2BAA2B,KAAK,SAAS;QACxD,OAAO,OAAO,CAAC,4BAA4B,KAAK,SAAS;QACzD,2BAA2B,CAAC,OAAO,CAAC,sBAAsB,CAAC;QAC3D,OAAO,OAAO,CAAC,0BAA0B,KAAK,SAAS,CACxD,CAAC;AACJ,CAAC;AAED,SAAS,2BAA2B,CAAC,KAAc;IACjD,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,UAAU,CAAC;AAC1E,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc;IAC7C,MAAM,MAAM,GAAG,yBAAyB,CAAC,KAAK,EAAE;QAC9C,kBAAkB;QAClB,gBAAgB;QAChB,gBAAgB;KACjB,CAAC,CAAC;IACH,OAAO,CACL,MAAM,KAAK,SAAS;QACpB,0BAA0B,CAAC,MAAM,CAAC,gBAAgB,EAAE,UAAU,CAAC;QAC/D,0BAA0B,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC;QAC1D,0BAA0B,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAC1D,CAAC;AACJ,CAAC","sourcesContent":["import { snapshotExactClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { validFindingPolicy } from \"../code-quality-findings/policy.ts\";\nimport { validLocalCacheOptions } from \"../local-cache-options.ts\";\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\n\nfunction boundedPositiveSafeInteger(value: unknown, maximum: number): value is number {\n  return isPositiveSafeInteger(value) && value <= maximum;\n}\n\nexport function validMarkdownLinkValidationOptions(\n  value: unknown\n): value is ResolvedMarkdownLinkValidationOptions {\n  const options = snapshotExactClosedRecord(value, [\n    \"files\",\n    \"findingPolicy\",\n    \"requireExistingTargets\",\n    \"validateSameDocumentAnchors\",\n    \"validateCrossDocumentAnchors\",\n    \"rootExternalTargetMode\",\n    \"requireNonEmptyDirectories\",\n    \"cache\",\n    \"limits\"\n  ]);\n  return options !== undefined && validOptionFields(options);\n}\n\nfunction validOptionFields(options: Readonly<Record<string, unknown>>): boolean {\n  return (\n    validProjectFileSelection(options.files) &&\n    validFindingPolicy(options.findingPolicy) &&\n    validAnchorValidationOptions(options) &&\n    validLocalCacheOptions(options.cache) &&\n    validMarkdownLinkLimits(options.limits)\n  );\n}\n\nfunction validAnchorValidationOptions(options: Readonly<Record<string, unknown>>): boolean {\n  return (\n    typeof options.requireExistingTargets === \"boolean\" &&\n    typeof options.validateSameDocumentAnchors === \"boolean\" &&\n    typeof options.validateCrossDocumentAnchors === \"boolean\" &&\n    validRootExternalTargetMode(options.rootExternalTargetMode) &&\n    typeof options.requireNonEmptyDirectories === \"boolean\"\n  );\n}\n\nfunction validRootExternalTargetMode(value: unknown): boolean {\n  return value === \"ignore\" || value === \"report\" || value === \"validate\";\n}\n\nfunction validMarkdownLinkLimits(value: unknown): boolean {\n  const limits = snapshotExactClosedRecord(value, [\n    \"maxMarkdownBytes\",\n    \"maxOccurrences\",\n    \"maxTargetReads\"\n  ]);\n  return (\n    limits !== undefined &&\n    boundedPositiveSafeInteger(limits.maxMarkdownBytes, 16_777_216) &&\n    boundedPositiveSafeInteger(limits.maxOccurrences, 100_000) &&\n    boundedPositiveSafeInteger(limits.maxTargetReads, 10_000)\n  );\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/options.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/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\nexport type MarkdownRootExternalTargetMode = \"ignore\" | \"report\" | \"validate\";\n\n/** 调用方显式拥有的 Link-private parse-facts local cache policy。 */\ntype MarkdownLinkValidationCacheOptions =\n  | Readonly<{ readonly enabled: false }>\n  | Readonly<{\n      readonly enabled: true;\n      readonly directory: string;\n    }>;\n\n/** 可省略的 Markdown validation work limits。 */\nexport interface MarkdownLinkValidationLimitOptions {\n  readonly maxMarkdownBytes?: number;\n  readonly maxOccurrences?: number;\n  readonly maxTargetReads?: number;\n}\n\n/** `markdownLinkValidation(options?)` 接受的可省略 authoring policy。 */\nexport interface MarkdownLinkValidationOptions {\n  /** 参与本 Check 的 Markdown source selection；省略字段使用 package defaults。 */\n  readonly files?: ProjectFileSelectionOptions;\n  /** local-reference finding 是否使本 Check failed；省略时为 non-blocking。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** `false` 时缺失的本地文件或目录不构成 finding。 */\n  readonly requireExistingTargets?: boolean;\n  /** 是否检查 `#anchor` 对当前 Markdown 文档标题的引用。 */\n  readonly validateSameDocumentAnchors?: boolean;\n  /** 是否检查直接指向的 Markdown 文件中的 `#anchor`。 */\n  readonly validateCrossDocumentAnchors?: boolean;\n  /** root 外本机目标的授权模式；不授权网络请求。 */\n  readonly rootExternalTargetMode?: MarkdownRootExternalTargetMode;\n  /** 是否将空目录目标视为 finding。 */\n  readonly requireNonEmptyDirectories?: boolean;\n  /** 每次运行的 Markdown 内容、occurrence 和 direct target work 上限。 */\n  readonly limits?: MarkdownLinkValidationLimitOptions;\n  /**\n   * 显式启用的、调用方拥有的 Link parse-facts persistent cache。省略时关闭；enabled directory 必须 absolute、可信且可删除。\n   * 本 Check 只在其中使用 `markdown-link-parse-facts-v1.jsonl` 保存 source-derived facts；调用方负责容量和删除，且不提供\n   * confidentiality、automatic cleanup、concurrency 或 durability guarantees。cache 不可用时 fresh-parse，Check 结果不变。\n   */\n  readonly cache?: MarkdownLinkValidationCacheOptions;\n}\n\n/** `markdown-link-validation` execution 消费的完整、冻结 options。 */\nexport interface ResolvedMarkdownLinkValidationOptions {\n  readonly files: ProjectFileSelection;\n  readonly findingPolicy: FindingPolicy;\n  readonly requireExistingTargets: boolean;\n  readonly validateSameDocumentAnchors: boolean;\n  readonly validateCrossDocumentAnchors: boolean;\n  readonly rootExternalTargetMode: MarkdownRootExternalTargetMode;\n  readonly requireNonEmptyDirectories: boolean;\n  readonly cache: MarkdownLinkValidationCacheOptions;\n  readonly limits: Readonly<{\n    readonly maxMarkdownBytes: number;\n    readonly maxOccurrences: number;\n    readonly maxTargetReads: number;\n  }>;\n}\n"]}
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/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 { LocalCacheOptions } from \"../local-cache-options.ts\";\n\nexport type MarkdownRootExternalTargetMode = \"ignore\" | \"report\" | \"validate\";\n\n/** 调用方显式拥有的 Link-private parse-facts local cache policy。 */\ntype MarkdownLinkValidationCacheOptions = LocalCacheOptions;\n\n/** 可省略的 Markdown validation work limits。 */\nexport interface MarkdownLinkValidationLimitOptions {\n  readonly maxMarkdownBytes?: number;\n  readonly maxOccurrences?: number;\n  readonly maxTargetReads?: number;\n}\n\n/** `markdownLinkValidation(options?)` 接受的可省略 authoring policy。 */\nexport interface MarkdownLinkValidationOptions<\n  Id extends string = string\n> extends PackageCheckAuthoringOptions<Id> {\n  /** 参与本 Check 的 Markdown source selection；省略字段使用 package defaults。 */\n  readonly files?: ProjectFileSelectionOptions;\n  /** local-reference finding 是否使本 Check failed；省略时为 non-blocking。 */\n  readonly findingPolicy?: FindingPolicy;\n  /** `false` 时缺失的本地文件或目录不构成 finding。 */\n  readonly requireExistingTargets?: boolean;\n  /** 是否检查 `#anchor` 对当前 Markdown 文档标题的引用。 */\n  readonly validateSameDocumentAnchors?: boolean;\n  /** 是否检查直接指向的 Markdown 文件中的 `#anchor`。 */\n  readonly validateCrossDocumentAnchors?: boolean;\n  /** root 外本机目标的授权模式；不授权网络请求。 */\n  readonly rootExternalTargetMode?: MarkdownRootExternalTargetMode;\n  /** 是否将空目录目标视为 finding。 */\n  readonly requireNonEmptyDirectories?: boolean;\n  /** 每次运行的 Markdown 内容、occurrence 和 direct target work 上限。 */\n  readonly limits?: MarkdownLinkValidationLimitOptions;\n  /**\n   * 显式启用的、调用方拥有的 Link parse-facts persistent cache。省略时关闭；enabled directory 必须 absolute、可信且可删除。\n   * 本 Check 只在其中使用 `markdown-link-parse-facts-v1.jsonl` 保存 source-derived facts；调用方负责容量和删除，且不提供\n   * confidentiality、automatic cleanup、concurrency 或 durability guarantees。cache 不可用时 fresh-parse，Check 结果不变。\n   */\n  readonly cache?: MarkdownLinkValidationCacheOptions;\n}\n\n/** `markdown-link-validation` execution 消费的完整、冻结 options。 */\nexport interface ResolvedMarkdownLinkValidationOptions {\n  readonly files: ProjectFileSelection;\n  readonly findingPolicy: FindingPolicy;\n  readonly requireExistingTargets: boolean;\n  readonly validateSameDocumentAnchors: boolean;\n  readonly validateCrossDocumentAnchors: boolean;\n  readonly rootExternalTargetMode: MarkdownRootExternalTargetMode;\n  readonly requireNonEmptyDirectories: boolean;\n  readonly cache: MarkdownLinkValidationCacheOptions;\n  readonly limits: Readonly<{\n    readonly maxMarkdownBytes: number;\n    readonly maxOccurrences: number;\n    readonly maxTargetReads: number;\n  }>;\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/parse-facts-cache-payload.mjs

@@ -70,11 +70,10 @@ export function parseMarkdownLinkParseFactsPayload(value) {
     return Object.freeze({ occurrences, headings });
 }
 function isCurrentCacheEnvelope(envelope) {
-    return (envelope !== undefined &&
-        envelope.cacheFormatVersion === CACHE_FORMAT_VERSION &&
-        validIdentityDigest(envelope.identityDigest) &&
-        envelope.parserContractVersion === MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION &&
-        envelope.payloadVersion === CACHE_PAYLOAD_VERSION);
+    return (envelope?.cacheFormatVersion === CACHE_FORMAT_VERSION &&
+        validIdentityDigest(envelope?.identityDigest) &&
+        envelope?.parserContractVersion === MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION &&
+        envelope?.payloadVersion === CACHE_PAYLOAD_VERSION);
 }
 function validIdentityDigest(value) {
     return typeof value === "string" && /^[a-f0-9]{64}$/u.test(value);

package/dist/esm/package-checks/markdown-link-validation/parse-facts-cache-payload.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"parse-facts-cache-payload.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/parse-facts-cache-payload.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport {\n  snapshotClosedArray,\n  snapshotExactClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { canonicalJsonText } from \"../../data-boundary/canonical-data.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport type {\n  MarkdownHeading,\n  MarkdownLinkOccurrence,\n  MarkdownSourcePosition,\n  MarkdownSourceRange,\n  ParsedMarkdownLinkFacts\n} from \"./markdown-parser.ts\";\n\nconst CACHE_FORMAT_VERSION = \"markdown-link-parse-facts-jsonl-v1\";\nconst CACHE_PAYLOAD_VERSION = \"1\";\n/** Version the resolver memo and persistent identity share when parser facts change. */\nexport const MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION =\n  \"mdast-gfm-frontmatter-github-slug-v1\";\nconst MAX_FACTS_PER_DOCUMENT = 100_000;\nconst MAX_FACT_STRING_LENGTH = 16_777_216;\n\ntype MarkdownLinkParseFactsPayload = Readonly<{\n  readonly occurrences: readonly MarkdownLinkOccurrence[];\n  readonly headings: readonly MarkdownHeading[];\n}>;\n\n/**\n * Serializes one complete Link-private JSONL envelope from immutable parser facts.\n * The session owns when this line is appended; this codec owns its shape and identity.\n */\nexport function cacheEnvelopeLine(identityDigest: string, facts: ParsedMarkdownLinkFacts): string {\n  return `${canonicalJsonText({\n    cacheFormatVersion: CACHE_FORMAT_VERSION,\n    identityDigest,\n    parserContractVersion: MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION,\n    payloadVersion: CACHE_PAYLOAD_VERSION,\n    payload: projectMarkdownLinkParseFactsPayload(facts)\n  })}\\n`;\n}\n\n/** Restores one complete, current-version JSONL envelope or rejects it as a cache miss. */\nexport function parseCacheEnvelopeLine(\n  line: string\n):\n  | Readonly<{ readonly identityDigest: string; readonly facts: ParsedMarkdownLinkFacts }>\n  | undefined {\n  try {\n    const envelope = snapshotExactClosedRecord(JSON.parse(line), [\n      \"cacheFormatVersion\",\n      \"identityDigest\",\n      \"parserContractVersion\",\n      \"payloadVersion\",\n      \"payload\"\n    ]);\n    if (!isCurrentCacheEnvelope(envelope)) return undefined;\n    return Object.freeze({\n      identityDigest: envelope.identityDigest,\n      facts: parseMarkdownLinkParseFactsPayload(envelope.payload)\n    });\n  } catch {\n    return undefined;\n  }\n}\n\n/** SHA-256 identity over the current, exact authorized Markdown bytes. */\nexport function markdownBytesDigest(bytes: Uint8Array): string {\n  return createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\n\n/** Converts parser-owned immutable facts to the closed persistent JSON payload. */\nexport function projectMarkdownLinkParseFactsPayload(\n  facts: ParsedMarkdownLinkFacts\n): MarkdownLinkParseFactsPayload {\n  return Object.freeze({\n    occurrences: Object.freeze(\n      facts.occurrences.map((occurrence) =>\n        Object.freeze({\n          kind: occurrence.kind,\n          rawDestination: occurrence.rawDestination,\n          range: projectSourceRange(occurrence.range)\n        })\n      )\n    ),\n    headings: Object.freeze(\n      facts.headings.map((heading) =>\n        Object.freeze({ slug: heading.slug, range: projectSourceRange(heading.range) })\n      )\n    )\n  });\n}\n\n/** Strictly restores the Link-private persistent JSON payload to immutable parser facts. */\nexport function parseMarkdownLinkParseFactsPayload(value: unknown): ParsedMarkdownLinkFacts {\n  const payload = snapshotExactClosedRecord(value, [\"occurrences\", \"headings\"]);\n  if (payload === undefined) throw new TypeError(\"Markdown Link cache payload must be closed\");\n  const occurrences = parseOccurrences(payload.occurrences);\n  const headings = parseHeadings(payload.headings);\n  if (occurrences === undefined || headings === undefined) {\n    throw new TypeError(\"Markdown Link cache payload contains invalid parse facts\");\n  }\n  return Object.freeze({ occurrences, headings });\n}\n\nfunction isCurrentCacheEnvelope(\n  envelope: Readonly<Record<string, unknown>> | undefined\n): envelope is Readonly<{\n  readonly identityDigest: string;\n  readonly payload: unknown;\n}> {\n  return (\n    envelope !== undefined &&\n    envelope.cacheFormatVersion === CACHE_FORMAT_VERSION &&\n    validIdentityDigest(envelope.identityDigest) &&\n    envelope.parserContractVersion === MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION &&\n    envelope.payloadVersion === CACHE_PAYLOAD_VERSION\n  );\n}\n\nfunction validIdentityDigest(value: unknown): value is string {\n  return typeof value === \"string\" && /^[a-f0-9]{64}$/u.test(value);\n}\n\nfunction parseOccurrences(value: unknown): readonly MarkdownLinkOccurrence[] | undefined {\n  const values = boundedPayloadArray(value);\n  if (values === undefined) return undefined;\n  const occurrences: MarkdownLinkOccurrence[] = [];\n  for (const candidate of values) {\n    const occurrence = snapshotExactClosedRecord(candidate, [\"kind\", \"rawDestination\", \"range\"]);\n    if (\n      occurrence === undefined ||\n      (occurrence.kind !== \"image\" && occurrence.kind !== \"link\") ||\n      !validFactString(occurrence.rawDestination)\n    ) {\n      return undefined;\n    }\n    const range = parseSourceRange(occurrence.range);\n    if (range === undefined) return undefined;\n    occurrences.push(\n      Object.freeze({ kind: occurrence.kind, rawDestination: occurrence.rawDestination, range })\n    );\n  }\n  return Object.freeze(occurrences);\n}\n\nfunction parseHeadings(value: unknown): readonly MarkdownHeading[] | undefined {\n  const values = boundedPayloadArray(value);\n  if (values === undefined) return undefined;\n  const headings: MarkdownHeading[] = [];\n  for (const candidate of values) {\n    const heading = snapshotExactClosedRecord(candidate, [\"slug\", \"range\"]);\n    if (heading === undefined || !validFactString(heading.slug)) return undefined;\n    const range = parseSourceRange(heading.range);\n    if (range === undefined) return undefined;\n    headings.push(Object.freeze({ slug: heading.slug, range }));\n  }\n  return Object.freeze(headings);\n}\n\nfunction boundedPayloadArray(value: unknown): readonly unknown[] | undefined {\n  const values = snapshotClosedArray(value);\n  return values !== undefined && values.length <= MAX_FACTS_PER_DOCUMENT ? values : undefined;\n}\n\nfunction validFactString(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.length <= MAX_FACT_STRING_LENGTH &&\n    !hasUnpairedSurrogate(value)\n  );\n}\n\nfunction parseSourceRange(value: unknown): MarkdownSourceRange | undefined {\n  const range = snapshotExactClosedRecord(value, [\"startOffset\", \"endOffset\", \"start\", \"end\"]);\n  if (\n    range === undefined ||\n    !boundedNonNegativeSafeInteger(range.startOffset) ||\n    !boundedNonNegativeSafeInteger(range.endOffset) ||\n    range.endOffset < range.startOffset\n  ) {\n    return undefined;\n  }\n  const start = parseSourcePosition(range.start);\n  const end = parseSourcePosition(range.end);\n  if (start === undefined || end === undefined || !sourcePositionFollows(end, start)) {\n    return undefined;\n  }\n  return Object.freeze({ startOffset: range.startOffset, endOffset: range.endOffset, start, end });\n}\n\nfunction sourcePositionFollows(\n  end: MarkdownSourcePosition,\n  start: MarkdownSourcePosition\n): boolean {\n  return end.line > start.line || (end.line === start.line && end.column >= start.column);\n}\n\nfunction parseSourcePosition(value: unknown): MarkdownSourcePosition | undefined {\n  const position = snapshotExactClosedRecord(value, [\"line\", \"column\"]);\n  if (\n    position === undefined ||\n    !boundedPositiveSafeInteger(position.line) ||\n    !boundedPositiveSafeInteger(position.column)\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ line: position.line, column: position.column });\n}\n\nfunction projectSourceRange(range: MarkdownSourceRange): MarkdownSourceRange {\n  return Object.freeze({\n    startOffset: range.startOffset,\n    endOffset: range.endOffset,\n    start: Object.freeze({ line: range.start.line, column: range.start.column }),\n    end: Object.freeze({ line: range.end.line, column: range.end.column })\n  });\n}\n\nfunction boundedNonNegativeSafeInteger(value: unknown): value is number {\n  return (\n    typeof value === \"number\" &&\n    Number.isSafeInteger(value) &&\n    value >= 0 &&\n    value <= MAX_FACT_STRING_LENGTH\n  );\n}\n\nfunction boundedPositiveSafeInteger(value: unknown): value is number {\n  return isPositiveSafeInteger(value) && value <= MAX_FACT_STRING_LENGTH + 1;\n}\n\nfunction hasUnpairedSurrogate(value: string): boolean {\n  for (let index = 0; index < value.length; index += 1) {\n    const codeUnit = value.charCodeAt(index);\n    if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {\n      const nextCodeUnit = value.charCodeAt(index + 1);\n      if (!(nextCodeUnit >= 0xdc00 && nextCodeUnit <= 0xdfff)) return true;\n      index += 1;\n      continue;\n    }\n    if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) return true;\n  }\n  return false;\n}\n"]}
+{"version":3,"file":"parse-facts-cache-payload.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/parse-facts-cache-payload.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport {\n  snapshotClosedArray,\n  snapshotExactClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { canonicalJsonText } from \"../../data-boundary/canonical-data.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport type {\n  MarkdownHeading,\n  MarkdownLinkOccurrence,\n  MarkdownSourcePosition,\n  MarkdownSourceRange,\n  ParsedMarkdownLinkFacts\n} from \"./markdown-parser.ts\";\n\nconst CACHE_FORMAT_VERSION = \"markdown-link-parse-facts-jsonl-v1\";\nconst CACHE_PAYLOAD_VERSION = \"1\";\n/** Version the resolver memo and persistent identity share when parser facts change. */\nexport const MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION =\n  \"mdast-gfm-frontmatter-github-slug-v1\";\nconst MAX_FACTS_PER_DOCUMENT = 100_000;\nconst MAX_FACT_STRING_LENGTH = 16_777_216;\n\ntype MarkdownLinkParseFactsPayload = Readonly<{\n  readonly occurrences: readonly MarkdownLinkOccurrence[];\n  readonly headings: readonly MarkdownHeading[];\n}>;\n\n/**\n * Serializes one complete Link-private JSONL envelope from immutable parser facts.\n * The session owns when this line is appended; this codec owns its shape and identity.\n */\nexport function cacheEnvelopeLine(identityDigest: string, facts: ParsedMarkdownLinkFacts): string {\n  return `${canonicalJsonText({\n    cacheFormatVersion: CACHE_FORMAT_VERSION,\n    identityDigest,\n    parserContractVersion: MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION,\n    payloadVersion: CACHE_PAYLOAD_VERSION,\n    payload: projectMarkdownLinkParseFactsPayload(facts)\n  })}\\n`;\n}\n\n/** Restores one complete, current-version JSONL envelope or rejects it as a cache miss. */\nexport function parseCacheEnvelopeLine(\n  line: string\n):\n  | Readonly<{ readonly identityDigest: string; readonly facts: ParsedMarkdownLinkFacts }>\n  | undefined {\n  try {\n    const envelope = snapshotExactClosedRecord(JSON.parse(line), [\n      \"cacheFormatVersion\",\n      \"identityDigest\",\n      \"parserContractVersion\",\n      \"payloadVersion\",\n      \"payload\"\n    ]);\n    if (!isCurrentCacheEnvelope(envelope)) return undefined;\n    return Object.freeze({\n      identityDigest: envelope.identityDigest,\n      facts: parseMarkdownLinkParseFactsPayload(envelope.payload)\n    });\n  } catch {\n    return undefined;\n  }\n}\n\n/** SHA-256 identity over the current, exact authorized Markdown bytes. */\nexport function markdownBytesDigest(bytes: Uint8Array): string {\n  return createHash(\"sha256\").update(bytes).digest(\"hex\");\n}\n\n/** Converts parser-owned immutable facts to the closed persistent JSON payload. */\nexport function projectMarkdownLinkParseFactsPayload(\n  facts: ParsedMarkdownLinkFacts\n): MarkdownLinkParseFactsPayload {\n  return Object.freeze({\n    occurrences: Object.freeze(\n      facts.occurrences.map((occurrence) =>\n        Object.freeze({\n          kind: occurrence.kind,\n          rawDestination: occurrence.rawDestination,\n          range: projectSourceRange(occurrence.range)\n        })\n      )\n    ),\n    headings: Object.freeze(\n      facts.headings.map((heading) =>\n        Object.freeze({ slug: heading.slug, range: projectSourceRange(heading.range) })\n      )\n    )\n  });\n}\n\n/** Strictly restores the Link-private persistent JSON payload to immutable parser facts. */\nexport function parseMarkdownLinkParseFactsPayload(value: unknown): ParsedMarkdownLinkFacts {\n  const payload = snapshotExactClosedRecord(value, [\"occurrences\", \"headings\"]);\n  if (payload === undefined) throw new TypeError(\"Markdown Link cache payload must be closed\");\n  const occurrences = parseOccurrences(payload.occurrences);\n  const headings = parseHeadings(payload.headings);\n  if (occurrences === undefined || headings === undefined) {\n    throw new TypeError(\"Markdown Link cache payload contains invalid parse facts\");\n  }\n  return Object.freeze({ occurrences, headings });\n}\n\nfunction isCurrentCacheEnvelope(\n  envelope: Readonly<Record<string, unknown>> | undefined\n): envelope is Readonly<{\n  readonly identityDigest: string;\n  readonly payload: unknown;\n}> {\n  return (\n    envelope?.cacheFormatVersion === CACHE_FORMAT_VERSION &&\n    validIdentityDigest(envelope?.identityDigest) &&\n    envelope?.parserContractVersion === MARKDOWN_LINK_PARSE_FACTS_PARSER_CONTRACT_VERSION &&\n    envelope?.payloadVersion === CACHE_PAYLOAD_VERSION\n  );\n}\n\nfunction validIdentityDigest(value: unknown): value is string {\n  return typeof value === \"string\" && /^[a-f0-9]{64}$/u.test(value);\n}\n\nfunction parseOccurrences(value: unknown): readonly MarkdownLinkOccurrence[] | undefined {\n  const values = boundedPayloadArray(value);\n  if (values === undefined) return undefined;\n  const occurrences: MarkdownLinkOccurrence[] = [];\n  for (const candidate of values) {\n    const occurrence = snapshotExactClosedRecord(candidate, [\"kind\", \"rawDestination\", \"range\"]);\n    if (\n      occurrence === undefined ||\n      (occurrence.kind !== \"image\" && occurrence.kind !== \"link\") ||\n      !validFactString(occurrence.rawDestination)\n    ) {\n      return undefined;\n    }\n    const range = parseSourceRange(occurrence.range);\n    if (range === undefined) return undefined;\n    occurrences.push(\n      Object.freeze({ kind: occurrence.kind, rawDestination: occurrence.rawDestination, range })\n    );\n  }\n  return Object.freeze(occurrences);\n}\n\nfunction parseHeadings(value: unknown): readonly MarkdownHeading[] | undefined {\n  const values = boundedPayloadArray(value);\n  if (values === undefined) return undefined;\n  const headings: MarkdownHeading[] = [];\n  for (const candidate of values) {\n    const heading = snapshotExactClosedRecord(candidate, [\"slug\", \"range\"]);\n    if (heading === undefined || !validFactString(heading.slug)) return undefined;\n    const range = parseSourceRange(heading.range);\n    if (range === undefined) return undefined;\n    headings.push(Object.freeze({ slug: heading.slug, range }));\n  }\n  return Object.freeze(headings);\n}\n\nfunction boundedPayloadArray(value: unknown): readonly unknown[] | undefined {\n  const values = snapshotClosedArray(value);\n  return values !== undefined && values.length <= MAX_FACTS_PER_DOCUMENT ? values : undefined;\n}\n\nfunction validFactString(value: unknown): value is string {\n  return (\n    typeof value === \"string\" &&\n    value.length <= MAX_FACT_STRING_LENGTH &&\n    !hasUnpairedSurrogate(value)\n  );\n}\n\nfunction parseSourceRange(value: unknown): MarkdownSourceRange | undefined {\n  const range = snapshotExactClosedRecord(value, [\"startOffset\", \"endOffset\", \"start\", \"end\"]);\n  if (\n    range === undefined ||\n    !boundedNonNegativeSafeInteger(range.startOffset) ||\n    !boundedNonNegativeSafeInteger(range.endOffset) ||\n    range.endOffset < range.startOffset\n  ) {\n    return undefined;\n  }\n  const start = parseSourcePosition(range.start);\n  const end = parseSourcePosition(range.end);\n  if (start === undefined || end === undefined || !sourcePositionFollows(end, start)) {\n    return undefined;\n  }\n  return Object.freeze({ startOffset: range.startOffset, endOffset: range.endOffset, start, end });\n}\n\nfunction sourcePositionFollows(\n  end: MarkdownSourcePosition,\n  start: MarkdownSourcePosition\n): boolean {\n  return end.line > start.line || (end.line === start.line && end.column >= start.column);\n}\n\nfunction parseSourcePosition(value: unknown): MarkdownSourcePosition | undefined {\n  const position = snapshotExactClosedRecord(value, [\"line\", \"column\"]);\n  if (\n    position === undefined ||\n    !boundedPositiveSafeInteger(position.line) ||\n    !boundedPositiveSafeInteger(position.column)\n  ) {\n    return undefined;\n  }\n  return Object.freeze({ line: position.line, column: position.column });\n}\n\nfunction projectSourceRange(range: MarkdownSourceRange): MarkdownSourceRange {\n  return Object.freeze({\n    startOffset: range.startOffset,\n    endOffset: range.endOffset,\n    start: Object.freeze({ line: range.start.line, column: range.start.column }),\n    end: Object.freeze({ line: range.end.line, column: range.end.column })\n  });\n}\n\nfunction boundedNonNegativeSafeInteger(value: unknown): value is number {\n  return (\n    typeof value === \"number\" &&\n    Number.isSafeInteger(value) &&\n    value >= 0 &&\n    value <= MAX_FACT_STRING_LENGTH\n  );\n}\n\nfunction boundedPositiveSafeInteger(value: unknown): value is number {\n  return isPositiveSafeInteger(value) && value <= MAX_FACT_STRING_LENGTH + 1;\n}\n\nfunction hasUnpairedSurrogate(value: string): boolean {\n  for (let index = 0; index < value.length; index += 1) {\n    const codeUnit = value.charCodeAt(index);\n    if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {\n      const nextCodeUnit = value.charCodeAt(index + 1);\n      if (!(nextCodeUnit >= 0xdc00 && nextCodeUnit <= 0xdfff)) return true;\n      index += 1;\n      continue;\n    }\n    if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) return true;\n  }\n  return false;\n}\n"]}

package/dist/esm/package-checks/markdown-lint/adapter.mjs

@@ -0,0 +1,125 @@
+import { lint } from "markdownlint/promise";
+import { snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { MARKDOWN_LINT_RULE_NAMES } from "./options.mjs";
+const FRONT_MATTER = /((^---[^\S\r\n\u2028\u2029]*$[\s\S]+?^---\s*)|(^\+\+\+[^\S\r\n\u2028\u2029]*$[\s\S]+?^(\+\+\+|\.\.\.)\s*)|(^\{[^\S\r\n\u2028\u2029]*$[\s\S]+?^\}\s*))(\r\n|\r|\n|$)/m;
+const BACKEND_BY_RULE = {
+    "heading-increment": "MD001",
+    "no-reversed-links": "MD011",
+    "no-missing-space-atx": "MD018",
+    "fenced-code-language": "MD040",
+    "no-empty-links": "MD042",
+    "no-alt-text": "MD045",
+    "link-fragments": "MD051",
+    "reference-links-images": "MD052",
+    "table-column-count": "MD056"
+};
+/** Runs the fixed markdownlint Promise strings API and validates its raw protocol. */
+export async function lintMarkdownString(sourcePath, sourceText, rules) {
+    let raw;
+    try {
+        raw = await lint({
+            config: backendConfiguration(rules),
+            frontMatter: FRONT_MATTER,
+            noInlineConfig: true,
+            strings: { [sourcePath]: sourceText }
+        });
+    }
+    catch {
+        return "backend-failed";
+    }
+    return parseBackendFindings(raw, sourcePath, sourceText, rules);
+}
+function backendConfiguration(rules) {
+    const configuration = { default: false };
+    for (const rule of rules)
+        configuration[BACKEND_BY_RULE[rule]] = configurationFor(rule);
+    if (rules.includes("reference-links-images") && !rules.includes("heading-increment")) {
+        configuration.MD001 = configurationFor("heading-increment");
+    }
+    return configuration;
+}
+function configurationFor(rule) {
+    switch (rule) {
+        case "heading-increment":
+            return { front_matter_title: "^\\s*title\\s*[:=]" };
+        case "fenced-code-language":
+            return { allowed_languages: [], language_only: false };
+        case "link-fragments":
+            return { ignore_case: false, ignored_pattern: "" };
+        case "reference-links-images":
+            return { ignored_labels: ["x"], shortcut_syntax: false };
+        case "no-reversed-links":
+        case "no-missing-space-atx":
+        case "no-empty-links":
+        case "no-alt-text":
+        case "table-column-count":
+            return true;
+    }
+}
+function parseBackendFindings(value, sourcePath, sourceText, selectedRules) {
+    const result = snapshotClosedRecord(value);
+    if (result === undefined ||
+        Object.keys(result).length !== 1 ||
+        !Object.hasOwn(result, sourcePath) ||
+        !Array.isArray(result[sourcePath]))
+        return "backend-protocol-invalid";
+    const lines = sourceText.split(/\r\n|\r|\n/u);
+    const findings = [];
+    for (const rawFinding of result[sourcePath]) {
+        const finding = parseBackendFinding(rawFinding, lines);
+        if (finding === undefined)
+            return "backend-protocol-invalid";
+        if (selectedRules.includes(finding.rule))
+            findings.push(finding);
+    }
+    return Object.freeze(findings);
+}
+function parseBackendFinding(value, lines) {
+    const fields = validatedBackendFindingFields(value, lines);
+    if (fields === undefined)
+        return undefined;
+    const range = parseMarkdownLintRange(fields.errorRange, fields.line);
+    return range === undefined
+        ? undefined
+        : Object.freeze({ lineNumber: fields.lineNumber, range, rule: fields.rule });
+}
+function validatedBackendFindingFields(value, lines) {
+    const finding = snapshotClosedRecord(value);
+    if (finding === undefined)
+        return undefined;
+    const ruleNames = finding.ruleNames;
+    const lineNumber = finding.lineNumber;
+    if (!Array.isArray(ruleNames) ||
+        typeof ruleNames[0] !== "string" ||
+        typeof lineNumber !== "number")
+        return undefined;
+    if (!Number.isSafeInteger(lineNumber) || lineNumber < 1 || lineNumber > lines.length)
+        return undefined;
+    const rule = ruleForBackend(ruleNames[0]);
+    const line = lines[lineNumber - 1];
+    return rule === undefined || line === undefined
+        ? undefined
+        : Object.freeze({ errorRange: finding.errorRange, line, lineNumber, rule });
+}
+function ruleForBackend(backendRule) {
+    return MARKDOWN_LINT_RULE_NAMES.find((rule) => BACKEND_BY_RULE[rule] === backendRule);
+}
+/** Validates one backend or restored-cache range against the current source line. */
+export function parseMarkdownLintRange(value, line) {
+    if (value === null)
+        return null;
+    const range = snapshotClosedArray(value);
+    if (range?.length !== 2)
+        return undefined;
+    const [column, length] = range;
+    if (typeof column !== "number" ||
+        typeof length !== "number" ||
+        !Number.isSafeInteger(column) ||
+        !Number.isSafeInteger(length) ||
+        column < 1 ||
+        length < 1 ||
+        column - 1 + length > line.length)
+        return undefined;
+    return Object.freeze([column, length]);
+}
+//# sourceMappingURL=adapter.mjs.map

package/dist/esm/package-checks/markdown-lint/adapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/adapter.ts"],"names":[],"mappings":"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","sourcesContent":["import { lint } from \"markdownlint/promise\";\n\nimport { snapshotClosedArray, snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { MARKDOWN_LINT_RULE_NAMES, type MarkdownLintRuleName } from \"./options.ts\";\n\nconst FRONT_MATTER =\n  /((^---[^\\S\\r\\n\\u2028\\u2029]*$[\\s\\S]+?^---\\s*)|(^\\+\\+\\+[^\\S\\r\\n\\u2028\\u2029]*$[\\s\\S]+?^(\\+\\+\\+|\\.\\.\\.)\\s*)|(^\\{[^\\S\\r\\n\\u2028\\u2029]*$[\\s\\S]+?^\\}\\s*))(\\r\\n|\\r|\\n|$)/m;\n\nconst BACKEND_BY_RULE: Readonly<Record<MarkdownLintRuleName, string>> = {\n  \"heading-increment\": \"MD001\",\n  \"no-reversed-links\": \"MD011\",\n  \"no-missing-space-atx\": \"MD018\",\n  \"fenced-code-language\": \"MD040\",\n  \"no-empty-links\": \"MD042\",\n  \"no-alt-text\": \"MD045\",\n  \"link-fragments\": \"MD051\",\n  \"reference-links-images\": \"MD052\",\n  \"table-column-count\": \"MD056\"\n};\n\nexport interface MarkdownLintBackendFinding {\n  readonly lineNumber: number;\n  readonly range: readonly [number, number] | null;\n  readonly rule: MarkdownLintRuleName;\n}\n\n/** Runs the fixed markdownlint Promise strings API and validates its raw protocol. */\nexport async function lintMarkdownString(\n  sourcePath: string,\n  sourceText: string,\n  rules: readonly MarkdownLintRuleName[]\n): Promise<readonly MarkdownLintBackendFinding[] | \"backend-failed\" | \"backend-protocol-invalid\"> {\n  let raw: unknown;\n  try {\n    raw = await lint({\n      config: backendConfiguration(rules),\n      frontMatter: FRONT_MATTER,\n      noInlineConfig: true,\n      strings: { [sourcePath]: sourceText }\n    });\n  } catch {\n    return \"backend-failed\";\n  }\n  return parseBackendFindings(raw, sourcePath, sourceText, rules);\n}\n\nfunction backendConfiguration(\n  rules: readonly MarkdownLintRuleName[]\n): Readonly<Record<string, unknown>> {\n  const configuration: Record<string, unknown> = { default: false };\n  for (const rule of rules) configuration[BACKEND_BY_RULE[rule]] = configurationFor(rule);\n  if (rules.includes(\"reference-links-images\") && !rules.includes(\"heading-increment\")) {\n    configuration.MD001 = configurationFor(\"heading-increment\");\n  }\n  return configuration;\n}\n\nfunction configurationFor(rule: MarkdownLintRuleName): unknown {\n  switch (rule) {\n    case \"heading-increment\":\n      return { front_matter_title: \"^\\\\s*title\\\\s*[:=]\" };\n    case \"fenced-code-language\":\n      return { allowed_languages: [], language_only: false };\n    case \"link-fragments\":\n      return { ignore_case: false, ignored_pattern: \"\" };\n    case \"reference-links-images\":\n      return { ignored_labels: [\"x\"], shortcut_syntax: false };\n    case \"no-reversed-links\":\n    case \"no-missing-space-atx\":\n    case \"no-empty-links\":\n    case \"no-alt-text\":\n    case \"table-column-count\":\n      return true;\n  }\n}\n\nfunction parseBackendFindings(\n  value: unknown,\n  sourcePath: string,\n  sourceText: string,\n  selectedRules: readonly MarkdownLintRuleName[]\n): readonly MarkdownLintBackendFinding[] | \"backend-protocol-invalid\" {\n  const result = snapshotClosedRecord(value);\n  if (\n    result === undefined ||\n    Object.keys(result).length !== 1 ||\n    !Object.hasOwn(result, sourcePath) ||\n    !Array.isArray(result[sourcePath])\n  )\n    return \"backend-protocol-invalid\";\n  const lines = sourceText.split(/\\r\\n|\\r|\\n/u);\n  const findings: MarkdownLintBackendFinding[] = [];\n  for (const rawFinding of result[sourcePath]) {\n    const finding = parseBackendFinding(rawFinding, lines);\n    if (finding === undefined) return \"backend-protocol-invalid\";\n    if (selectedRules.includes(finding.rule)) findings.push(finding);\n  }\n  return Object.freeze(findings);\n}\n\nfunction parseBackendFinding(\n  value: unknown,\n  lines: readonly string[]\n): MarkdownLintBackendFinding | undefined {\n  const fields = validatedBackendFindingFields(value, lines);\n  if (fields === undefined) return undefined;\n  const range = parseMarkdownLintRange(fields.errorRange, fields.line);\n  return range === undefined\n    ? undefined\n    : Object.freeze({ lineNumber: fields.lineNumber, range, rule: fields.rule });\n}\n\nfunction validatedBackendFindingFields(\n  value: unknown,\n  lines: readonly string[]\n):\n  | Readonly<{\n      readonly errorRange: unknown;\n      readonly line: string;\n      readonly lineNumber: number;\n      readonly rule: MarkdownLintRuleName;\n    }>\n  | undefined {\n  const finding = snapshotClosedRecord(value);\n  if (finding === undefined) return undefined;\n  const ruleNames = finding.ruleNames;\n  const lineNumber = finding.lineNumber;\n  if (\n    !Array.isArray(ruleNames) ||\n    typeof ruleNames[0] !== \"string\" ||\n    typeof lineNumber !== \"number\"\n  )\n    return undefined;\n  if (!Number.isSafeInteger(lineNumber) || lineNumber < 1 || lineNumber > lines.length)\n    return undefined;\n  const rule = ruleForBackend(ruleNames[0]);\n  const line = lines[lineNumber - 1];\n  return rule === undefined || line === undefined\n    ? undefined\n    : Object.freeze({ errorRange: finding.errorRange, line, lineNumber, rule });\n}\n\nfunction ruleForBackend(backendRule: string): MarkdownLintRuleName | undefined {\n  return MARKDOWN_LINT_RULE_NAMES.find((rule) => BACKEND_BY_RULE[rule] === backendRule);\n}\n\n/** Validates one backend or restored-cache range against the current source line. */\nexport function parseMarkdownLintRange(\n  value: unknown,\n  line: string\n): readonly [number, number] | null | undefined {\n  if (value === null) return null;\n  const range = snapshotClosedArray(value);\n  if (range?.length !== 2) return undefined;\n  const [column, length] = range;\n  if (\n    typeof column !== \"number\" ||\n    typeof length !== \"number\" ||\n    !Number.isSafeInteger(column) ||\n    !Number.isSafeInteger(length) ||\n    column < 1 ||\n    length < 1 ||\n    column - 1 + length > line.length\n  )\n    return undefined;\n  return Object.freeze([column, length] as const);\n}\n"]}

package/dist/esm/package-checks/markdown-lint/default-check.mjs

@@ -0,0 +1,37 @@
+import { defineCheck } from "../../check/check.mjs";
+import { resolvePackageCheckAuthoringInput } from "../check-authoring.mjs";
+import { MARKDOWN_LINT_CHECK_DEFINITION, executeMarkdownLint } from "./execution.mjs";
+import { parseMarkdownLintData } from "./final-data.mjs";
+import { resolveMarkdownLintOptions } from "./options-resolution.mjs";
+import { validMarkdownLintOptions } from "./options-validation.mjs";
+export function markdownLint(options = {}) {
+    const input = resolvePackageCheckAuthoringInput(options, ["files", "findingPolicy", "findingWaivers", "rules", "limits", "cache"], MARKDOWN_LINT_CHECK_DEFINITION);
+    if (input === undefined) {
+        throw new TypeError("markdownLint options must match the documented closed policy");
+    }
+    const resolvedOptions = resolveMarkdownLintOptions(input.domainOptions);
+    if (resolvedOptions === undefined) {
+        throw new TypeError("markdownLint options must match the documented closed policy");
+    }
+    return defineCheck({
+        ...input.definition,
+        execute: executeMarkdownLint,
+        parseData: parseMarkdownLintData,
+        prepare: (preparedOptions) => validMarkdownLintOptions(preparedOptions)
+            ? { status: "success", preparedOptions }
+            : {
+                status: "failure",
+                action: "block",
+                reason: { code: "invalid-options" },
+                messages: [
+                    {
+                        code: "invalid-options",
+                        level: "error",
+                        message: "markdownLint options are invalid; recreate the Check with markdownLint(options) or restore its complete resolved options."
+                    }
+                ]
+            },
+        options: resolvedOptions
+    });
+}
+//# sourceMappingURL=default-check.mjs.map

package/dist/esm/package-checks/markdown-lint/default-check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"default-check.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-lint/default-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,iCAAiC,EAElC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,8BAA8B,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACrF,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAExD,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,yBAAyB,CAAC;AA6CnE,MAAM,UAAU,YAAY,CAC1B,OAAO,GAAwB,EAAE;IAEjC,MAAM,KAAK,GAAG,iCAAiC,CAC7C,OAAO,EACP,CAAC,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EACxE,8BAA8B,CAC/B,CAAC;IACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,eAAe,GAAG,0BAA0B,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACxE,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;IACtF,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,GAAG,KAAK,CAAC,UAAU;QACnB,OAAO,EAAE,mBAAmB;QAC5B,SAAS,EAAE,qBAAqB;QAChC,OAAO,EAAE,CAAC,eAAe,EAAE,EAAE,CAC3B,wBAAwB,CAAC,eAAe,CAAC;YACvC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE;YACxC,CAAC,CAAC;gBACE,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;gBACnC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,iBAAiB;wBACvB,KAAK,EAAE,OAAO;wBACd,OAAO,EACL,2HAA2H;qBAC9H;iBACF;aACF;QACP,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { defineCheck, type TypedCheckWithOptions } from \"../../check/check.ts\";\nimport {\n  resolvePackageCheckAuthoringInput,\n  type PackageCheckIdentityInput\n} from \"../check-authoring.ts\";\nimport { MARKDOWN_LINT_CHECK_DEFINITION, executeMarkdownLint } from \"./execution.ts\";\nimport { parseMarkdownLintData } from \"./final-data.ts\";\nimport type { MarkdownLintOptions, ResolvedMarkdownLintOptions } from \"./options.ts\";\nimport { resolveMarkdownLintOptions } from \"./options-resolution.ts\";\nimport { validMarkdownLintOptions } from \"./options-validation.ts\";\n\n/**\n * 构造使用稳定闭合规则与受限输入的 Markdown 结构检查。\n * 精确 findingWaivers 只在完整 traversal 后应用；原 Finding、计数与缓存 facts 保留。\n *\n * @param options - 省略时采用八项 recommended 规则；非空 rules 数组完整替换该集合。\n * @returns 使用默认或指定 checkId 的 typed Check，携带完整冻结 options、parser 与执行逻辑。\n * @throws {TypeError} options 含未知字段、未知/重复规则、非法 limits 或 findingWaivers 时抛出。\n * @example 最小用法\n * ```ts\n * import { defineConfig, markdownLint, run } from \"@zxyycom/vibe-check\";\n *\n * const check = markdownLint({ findingPolicy: \"blocking\" });\n * const definition = defineConfig({\n *   checks: [check],\n *   outputs: {\n *     diagnosticLogging: { enabled: false },\n *     machinePublication: { enabled: false },\n *     progressRendering: { enabled: false }\n *   }\n * });\n *\n * const result = await run(definition);\n * if (result.kind !== \"completed\") throw new Error(`Run did not complete: ${result.kind}`);\n * const outcome = result.snapshot.checks.find(({ checkId }) => checkId === check.checkId)?.outcome;\n * if (outcome?.status !== \"passed\" && outcome?.status !== \"not-applicable\") {\n *   throw new Error(`Markdown lint did not pass: ${outcome?.status ?? \"no outcome\"}`);\n * }\n * if (outcome.status === \"not-applicable\") console.warn(\"No Markdown input selected; no lint evidence.\");\n * ```\n */\nexport function markdownLint(\n  options?: MarkdownLintOptions<\"markdown-lint\">\n): TypedCheckWithOptions<\n  \"markdown-lint\",\n  ResolvedMarkdownLintOptions,\n  typeof parseMarkdownLintData\n>;\nexport function markdownLint<const Id extends string>(\n  options: MarkdownLintOptions<Id> & PackageCheckIdentityInput<Id>\n): TypedCheckWithOptions<Id, ResolvedMarkdownLintOptions, typeof parseMarkdownLintData>;\nexport function markdownLint(\n  options: MarkdownLintOptions\n): TypedCheckWithOptions<string, ResolvedMarkdownLintOptions, typeof parseMarkdownLintData>;\nexport function markdownLint(\n  options: MarkdownLintOptions = {}\n): TypedCheckWithOptions<string, ResolvedMarkdownLintOptions, typeof parseMarkdownLintData> {\n  const input = resolvePackageCheckAuthoringInput(\n    options,\n    [\"files\", \"findingPolicy\", \"findingWaivers\", \"rules\", \"limits\", \"cache\"],\n    MARKDOWN_LINT_CHECK_DEFINITION\n  );\n  if (input === undefined) {\n    throw new TypeError(\"markdownLint options must match the documented closed policy\");\n  }\n  const resolvedOptions = resolveMarkdownLintOptions(input.domainOptions);\n  if (resolvedOptions === undefined) {\n    throw new TypeError(\"markdownLint options must match the documented closed policy\");\n  }\n  return defineCheck({\n    ...input.definition,\n    execute: executeMarkdownLint,\n    parseData: parseMarkdownLintData,\n    prepare: (preparedOptions) =>\n      validMarkdownLintOptions(preparedOptions)\n        ? { status: \"success\", preparedOptions }\n        : {\n            status: \"failure\",\n            action: \"block\",\n            reason: { code: \"invalid-options\" },\n            messages: [\n              {\n                code: \"invalid-options\",\n                level: \"error\",\n                message:\n                  \"markdownLint options are invalid; recreate the Check with markdownLint(options) or restore its complete resolved options.\"\n              }\n            ]\n          },\n    options: resolvedOptions\n  });\n}\n"]}

package/dist/esm/package-checks/markdown-lint/execution.mjs

@@ -0,0 +1,202 @@
+import path from "node:path";
+import { realpath } from "node:fs/promises";
+import { appendCheckMessages } from "../../package-tools/finding-presentation/finding-presentation.mjs";
+import { reconcileFindingWaivers } from "../../package-tools/finding-waivers/reconciliation.mjs";
+import { reportFindingWaiverAudits } from "../code-quality-findings/finding-waiver-evidence.mjs";
+import { collectProjectFiles } from "../project-files/collection.mjs";
+import { partitionProjectFilesByEligibility } from "../project-files/input-eligibility.mjs";
+import { probeRootContainedPath, readRegularFile } from "../markdown-link-validation/filesystem-probes.mjs";
+import { isRootRelativePath } from "../markdown-link-validation/local-resolution.mjs";
+import { lintMarkdownWithCache } from "./findings-cache.mjs";
+import { markdownLintFindingMessages, markdownLintWaiverMessages } from "./finding-messages.mjs";
+import { validMarkdownLintOptions } from "./options-validation.mjs";
+import { buildMarkdownLintInputRejectedRecord, markdownLintFindingIdentity, markdownLintWaiverAuditRecord, orderedMarkdownLintCandidates } from "./records.mjs";
+import { markdownLintUnavailableMessage } from "./unavailable-reasons.mjs";
+export const MARKDOWN_LINT_CHECK_DEFINITION = {
+    checkId: "markdown-lint",
+    displayName: "Markdown lint"
+};
+/** Executes one bounded, ordered lint pass over the exact selected Markdown source paths. */
+export async function executeMarkdownLint(context) {
+    return validMarkdownLintOptions(context.options)
+        ? executeResolvedMarkdownLint(context)
+        : unavailable("invalid-options");
+}
+async function executeResolvedMarkdownLint(context) {
+    if (context.signal.aborted)
+        return unavailable("cancelled");
+    const discovered = discoverSources(context);
+    if (discovered.kind === "unavailable")
+        return unavailable(discovered.reason);
+    if (discovered.selectedPathCount === 0) {
+        return Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } });
+    }
+    for (const rejectedPath of discovered.rejectedPaths) {
+        const record = buildMarkdownLintInputRejectedRecord(rejectedPath);
+        context.records.report({ id: record.id }, record.data);
+    }
+    const root = await canonicalProjectRoot(context.project.root);
+    if (root === undefined)
+        return unavailable("project-root-unavailable");
+    const traversal = await traverseSources(discovered.sourcePaths, root, context.options, context.signal);
+    if (traversal.kind === "unavailable")
+        return appendRejected(unavailable(traversal.reason), discovered.rejectedPaths.length);
+    if (context.signal.aborted)
+        return appendRejected(unavailable("cancelled"), discovered.rejectedPaths.length);
+    return publishMarkdownLintTraversal(context, traversal, discovered.rejectedPaths);
+}
+/** Reconciles only a complete traversal, then publishes all evidence and the live policy outcome. */
+export function publishMarkdownLintTraversal(context, traversal, rejectedPaths) {
+    const reconciliation = reconcileFindingWaivers({
+        findings: traversal.candidates,
+        identify: markdownLintFindingIdentity,
+        waivers: context.options.findingWaivers
+    });
+    const actionable = [];
+    for (const finding of reconciliation.findings) {
+        const data = finding.disposition === "waived"
+            ? Object.freeze({
+                ...finding.finding.data,
+                waiver: Object.freeze({ reason: finding.waiver.reason })
+            })
+            : finding.finding.data;
+        context.records.report({ id: finding.finding.id }, data);
+        if (finding.disposition !== "waived")
+            actionable.push(finding.finding);
+    }
+    reportFindingWaiverAudits(context, reconciliation, markdownLintWaiverAuditRecord);
+    const findingCount = traversal.candidates.length + rejectedPaths.length;
+    const blocking = context.options.findingPolicy === "blocking";
+    const result = Object.freeze({
+        status: actionable.length > 0 && blocking ? "failed" : "passed",
+        data: Object.freeze({
+            sourceFileCount: traversal.sourceFileCount,
+            findingCount,
+            rejectedInputCount: rejectedPaths.length
+        })
+    });
+    return appendCheckMessages(result, [
+        ...markdownLintFindingMessages(actionable, rejectedPaths, 
+        // Preserve legacy summaries without waivers; fully waived lint must not make rejected-input summaries errors.
+        blocking && (reconciliation.waiverAudits.length === 0 || actionable.length > 0)),
+        ...markdownLintWaiverMessages(reconciliation)
+    ]);
+}
+function discoverSources(context) {
+    try {
+        const selectedPaths = collectProjectFiles(context.project.root, context.options.files);
+        const partition = partitionProjectFilesByEligibility(selectedPaths, isMarkdownPath);
+        return Object.freeze({
+            kind: "complete",
+            sourcePaths: partition.acceptedPaths,
+            rejectedPaths: partition.rejectedPaths,
+            selectedPathCount: selectedPaths.length
+        });
+    }
+    catch {
+        return Object.freeze({ kind: "unavailable", reason: "source-unavailable" });
+    }
+}
+async function canonicalProjectRoot(projectRoot) {
+    try {
+        return await realpath(projectRoot);
+    }
+    catch {
+        return undefined;
+    }
+}
+async function traverseSources(sourcePaths, rootPath, options, signal) {
+    const rawFindings = [];
+    let sourceFileCount = 0;
+    for (const sourcePath of sourcePaths) {
+        if (signal.aborted)
+            return unavailableTraversal("cancelled");
+        const source = await readMarkdownSource(rootPath, sourcePath, options.limits.maxMarkdownBytes);
+        if (!source.ok)
+            return unavailableTraversal(source.reason);
+        const text = source.text;
+        if (signal.aborted)
+            return unavailableTraversal("cancelled");
+        const linted = await lintMarkdownWithCache({
+            sourcePath,
+            sourceText: text,
+            rules: options.rules,
+            cache: options.cache,
+            signal
+        });
+        const findings = typeof linted === "string" ? linted : linted.findings;
+        if (typeof findings === "string")
+            return unavailableTraversal(findings);
+        if (signal.aborted)
+            return unavailableTraversal("cancelled");
+        sourceFileCount += 1;
+        for (const finding of findings)
+            rawFindings.push(Object.freeze({ path: sourcePath, finding }));
+        if (rawFindings.length > options.limits.maxFindings)
+            return unavailableTraversal("finding-limit-exceeded");
+    }
+    return Object.freeze({
+        kind: "complete",
+        candidates: orderedMarkdownLintCandidates(rawFindings, options.rules),
+        sourceFileCount
+    });
+}
+async function readMarkdownSource(rootPath, rootRelativePath, maxBytes) {
+    if (!isRootRelativePath(rootPath, rootRelativePath))
+        return Object.freeze({ ok: false, reason: "source-unavailable" });
+    const candidatePath = path.resolve(rootPath, rootRelativePath);
+    const probe = await probeRootContainedPath(rootPath, candidatePath);
+    if (probe.kind !== "contained")
+        return Object.freeze({ ok: false, reason: "source-unavailable" });
+    const source = await readRegularFile(probe.absolutePath, maxBytes);
+    if (!source.ok)
+        return Object.freeze({
+            ok: false,
+            reason: source.reason === "too-large" ? "source-too-large" : "source-unavailable"
+        });
+    try {
+        return Object.freeze({
+            ok: true,
+            text: new TextDecoder("utf-8", { fatal: true }).decode(source.bytes)
+        });
+    }
+    catch {
+        return Object.freeze({ ok: false, reason: "source-unavailable" });
+    }
+}
+function isMarkdownPath(filePath) {
+    const extension = path.extname(filePath).toLowerCase();
+    return extension === ".md" || extension === ".markdown";
+}
+function unavailableTraversal(reason) {
+    return Object.freeze({ kind: "unavailable", reason });
+}
+function unavailable(reason) {
+    return Object.freeze({
+        status: "unavailable",
+        reason: { code: reason },
+        messages: Object.freeze([
+            Object.freeze({
+                code: reason,
+                level: "error",
+                message: markdownLintUnavailableMessage(reason)
+            })
+        ])
+    });
+}
+function appendRejected(result, rejectedInputCount) {
+    if (rejectedInputCount === 0)
+        return result;
+    return Object.freeze({
+        ...result,
+        messages: Object.freeze([
+            ...(result.messages ?? []),
+            Object.freeze({
+                code: "input-rejected",
+                level: "warning",
+                message: `${rejectedInputCount} selected markdownLint input file(s) were rejected because only .md/.markdown paths are supported; inspect this Check's Records and narrow files.include/exclude.`
+            })
+        ])
+    });
+}
+//# sourceMappingURL=execution.mjs.map