@zxyycom/vibe-check 0.0.1

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

@@ -0,0 +1,199 @@
+import path from "node:path";
+import { collectProjectFiles } from "../project-files/collection.mjs";
+import { partitionProjectFilesByEligibility } from "../project-files/input-eligibility.mjs";
+import { createMarkdownLocalResolver } from "./local-resolver.mjs";
+import { buildMarkdownInputRejectedRecord, buildMarkdownLinkRecordCandidate } from "./records.mjs";
+import { settledMarkdownTraversalResult } from "./traversal-result.mjs";
+import { validMarkdownLinkValidationOptions } from "./options-validation.mjs";
+export const MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION = {
+    checkId: "markdown-link-validation",
+    displayName: "Markdown link validation"
+};
+/** 验证本 Check 选中的 Markdown source 的离线本地链接完整性。 */
+export async function executeMarkdownLinkValidation(context) {
+    if (!validMarkdownLinkValidationOptions(context.options))
+        return unavailable("invalid-options");
+    const prepared = await prepareMarkdownTraversal(context);
+    if (prepared.kind === "result")
+        return prepared.result;
+    const { rejectedInputCount, traversal, resolver } = prepared;
+    for (const candidate of traversal.candidates) {
+        context.records.report({ id: candidate.id }, candidate.data);
+    }
+    return settledMarkdownTraversalResult({
+        findingCount: traversal.candidates.length,
+        findingPolicy: context.options.findingPolicy,
+        occurrenceCount: traversal.occurrenceCount,
+        rejectedInputCount,
+        sourceFileCount: traversal.sourceFileCount,
+        targetReadCount: resolver.targetReadCount
+    });
+}
+async function prepareMarkdownTraversal(context) {
+    if (context.signal.aborted)
+        return result(unavailable("cancelled"));
+    const created = await createMarkdownLocalResolver(context.project.root, context.options.limits.maxTargetReads);
+    if (!created.ok)
+        return result(unavailable(created.reason));
+    if (context.signal.aborted)
+        return result(unavailable("cancelled"));
+    const sourceDiscovery = discoverMarkdownSourcePaths(context.project, context.options.files);
+    if (sourceDiscovery.kind === "unavailable")
+        return result(unavailable(sourceDiscovery.reason));
+    if (sourceDiscovery.selectedPathCount === 0)
+        return result(noEligibleInput());
+    if (context.signal.aborted)
+        return result(unavailable("cancelled"));
+    reportRejectedInputs(context, sourceDiscovery.rejectedPaths);
+    const traversal = await traverseMarkdownSources(sourceDiscovery.sourcePaths, {
+        resolver: created.resolver,
+        options: context.options,
+        signal: context.signal
+    });
+    if (traversal.kind === "unavailable") {
+        return result(appendRejectedInputMessage(unavailable(traversal.reason), sourceDiscovery.rejectedPaths.length));
+    }
+    if (context.signal.aborted) {
+        return result(appendRejectedInputMessage(unavailable("cancelled"), sourceDiscovery.rejectedPaths.length));
+    }
+    return Object.freeze({
+        kind: "traversal",
+        rejectedInputCount: sourceDiscovery.rejectedPaths.length,
+        resolver: created.resolver,
+        traversal
+    });
+}
+function result(checkResult) {
+    return Object.freeze({ kind: "result", result: checkResult });
+}
+function noEligibleInput() {
+    return Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } });
+}
+function discoverMarkdownSourcePaths(project, files) {
+    try {
+        const selectedPaths = collectProjectFiles(project.root, files);
+        const partition = partitionProjectFilesByEligibility(selectedPaths, isMarkdownSourcePath);
+        return Object.freeze({
+            kind: "complete",
+            rejectedPaths: partition.rejectedPaths,
+            selectedPathCount: selectedPaths.length,
+            sourcePaths: partition.acceptedPaths
+        });
+    }
+    catch {
+        return unavailableValidation("source-unavailable");
+    }
+}
+function reportRejectedInputs(context, paths) {
+    for (const selectedPath of paths) {
+        const record = buildMarkdownInputRejectedRecord(selectedPath);
+        context.records.report({ id: record.id }, record.data);
+    }
+}
+function appendRejectedInputMessage(checkResult, rejectedInputCount) {
+    if (rejectedInputCount === 0)
+        return checkResult;
+    return Object.freeze({
+        ...checkResult,
+        messages: Object.freeze([
+            ...(checkResult.messages ?? []),
+            Object.freeze({
+                code: "input-rejected",
+                level: "warning",
+                message: `${rejectedInputCount} selected markdownLinkValidation input file(s) were rejected because only .md/.markdown paths are supported; inspect this Check's Records and narrow files.include/exclude.`
+            })
+        ])
+    });
+}
+function unavailableValidation(reason) {
+    return Object.freeze({ kind: "unavailable", reason });
+}
+async function traverseMarkdownSources(sourcePaths, run) {
+    const candidates = [];
+    let occurrenceCount = 0;
+    let sourceFileCount = 0;
+    for (const sourcePath of sourcePaths) {
+        const sourceValidation = await validateMarkdownSource(sourcePath, occurrenceCount, run);
+        if (sourceValidation.kind === "unavailable")
+            return sourceValidation;
+        candidates.push(...sourceValidation.candidates);
+        occurrenceCount = sourceValidation.occurrenceCount;
+        sourceFileCount += 1;
+    }
+    return Object.freeze({
+        kind: "complete",
+        candidates: Object.freeze(candidates),
+        occurrenceCount,
+        sourceFileCount
+    });
+}
+async function validateMarkdownSource(sourcePath, occurrenceCountBeforeSource, run) {
+    if (run.signal.aborted)
+        return unavailableValidation("cancelled");
+    const sourceRead = await run.resolver.readSource(sourcePath, run.options.limits.maxMarkdownBytes);
+    if (run.signal.aborted)
+        return unavailableValidation("cancelled");
+    if (!sourceRead.ok)
+        return unavailableValidation(sourceRead.reason);
+    const candidates = [];
+    let occurrenceCount = occurrenceCountBeforeSource;
+    for (const [occurrenceIndex, occurrence] of sourceRead.source.facts.occurrences.entries()) {
+        if (run.signal.aborted)
+            return unavailableValidation("cancelled");
+        occurrenceCount += 1;
+        if (occurrenceCount > run.options.limits.maxOccurrences) {
+            return unavailableValidation("occurrence-limit-exceeded");
+        }
+        const resolution = await run.resolver.resolve({
+            source: sourceRead.source,
+            rawDestination: occurrence.rawDestination,
+            rootExternalTargetMode: run.options.rootExternalTargetMode,
+            requireExistingTargets: run.options.requireExistingTargets,
+            requireNonEmptyDirectories: run.options.requireNonEmptyDirectories,
+            validateSameDocumentAnchors: run.options.validateSameDocumentAnchors,
+            validateCrossDocumentAnchors: run.options.validateCrossDocumentAnchors,
+            maxMarkdownBytes: run.options.limits.maxMarkdownBytes
+        });
+        if (run.signal.aborted)
+            return unavailableValidation("cancelled");
+        if (resolution.kind === "unavailable")
+            return unavailableValidation(resolution.reason);
+        const candidate = buildMarkdownLinkRecordCandidate(sourceRead.source.path, occurrenceIndex, occurrence, resolution);
+        if (candidate !== undefined)
+            candidates.push(candidate);
+    }
+    return Object.freeze({
+        kind: "complete",
+        candidates: Object.freeze(candidates),
+        occurrenceCount
+    });
+}
+function isMarkdownSourcePath(filePath) {
+    const extension = path.extname(filePath).toLowerCase();
+    return extension === ".md" || extension === ".markdown";
+}
+function unavailable(reason) {
+    return Object.freeze({
+        status: "unavailable",
+        reason: { code: reason },
+        messages: Object.freeze([
+            Object.freeze({ code: reason, level: "error", message: unavailableMessage(reason) })
+        ])
+    });
+}
+function unavailableMessage(reason) {
+    return UNAVAILABLE_MESSAGES[reason];
+}
+const UNAVAILABLE_MESSAGES = {
+    "invalid-options": "markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options.",
+    "project-root-unavailable": "Markdown link validation could not resolve the project root; check that the path exists and is accessible.",
+    "source-unavailable": "A selected Markdown source could not be collected, read, decoded, or contained safely; check the file source and permissions.",
+    "source-too-large": "A selected Markdown source exceeds maxMarkdownBytes; narrow the file selection or raise the bounded limit.",
+    "markdown-parse-failed": "A selected Markdown source could not be parsed completely; inspect that document's Markdown syntax and encoding.",
+    "invalid-local-destination": "A local Markdown destination could not be parsed safely; inspect the affected link destination syntax.",
+    "target-unavailable": "A local Markdown target could not be probed or read safely; check the target path, permissions, size, and encoding.",
+    "occurrence-limit-exceeded": "Markdown link validation exceeded maxOccurrences; narrow the source selection or raise the bounded limit.",
+    "target-read-limit-exceeded": "Markdown link validation exceeded maxTargetReads; narrow the source selection or raise the bounded limit.",
+    cancelled: "Markdown link validation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate."
+};
+//# sourceMappingURL=execution.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"node:path\";\n\nimport type { ResolvedMarkdownLinkValidationOptions } from \"./options.ts\";\nimport type { CheckExecutionContext, CheckResult } from \"../../check/check.ts\";\nimport { collectProjectFiles } from \"../project-files/collection.ts\";\nimport type { ProjectFileSelection } from \"../project-files/configuration.ts\";\nimport { partitionProjectFilesByEligibility } from \"../project-files/input-eligibility.ts\";\nimport {\n  createMarkdownLocalResolver,\n  type MarkdownLocalResolutionReason,\n  type MarkdownLocalResolver,\n  type MarkdownSourceReadFailureReason\n} from \"./local-resolver.ts\";\nimport type { MarkdownLinkValidationFinalData } from \"./final-data.ts\";\nimport {\n  buildMarkdownInputRejectedRecord,\n  buildMarkdownLinkRecordCandidate,\n  type MarkdownLinkRecordCandidate\n} from \"./records.ts\";\nimport { settledMarkdownTraversalResult } from \"./traversal-result.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\nexport const MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION = {\n  checkId: \"markdown-link-validation\",\n  displayName: \"Markdown link validation\"\n} as const;\n\ninterface MarkdownLinkValidationRun {\n  readonly options: ResolvedMarkdownLinkValidationOptions;\n  readonly resolver: MarkdownLocalResolver;\n  readonly signal: AbortSignal;\n}\n\n/** `markdown-link-validation` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type MarkdownLinkValidationUnavailableReason =\n  | \"invalid-options\"\n  | \"cancelled\"\n  | \"occurrence-limit-exceeded\"\n  | \"project-root-unavailable\"\n  | MarkdownLocalResolutionReason\n  | MarkdownSourceReadFailureReason;\n\ntype MarkdownLinkValidationUnavailable = Readonly<{\n  readonly kind: \"unavailable\";\n  readonly reason: MarkdownLinkValidationUnavailableReason;\n}>;\n\ntype MarkdownSourceDiscovery =\n  | Readonly<{\n      readonly kind: \"complete\";\n      readonly rejectedPaths: readonly string[];\n      readonly selectedPathCount: number;\n      readonly sourcePaths: readonly string[];\n    }>\n  | MarkdownLinkValidationUnavailable;\n\ntype MarkdownSourceValidation =\n  | Readonly<{\n      readonly kind: \"complete\";\n      readonly candidates: readonly MarkdownLinkRecordCandidate[];\n      readonly occurrenceCount: number;\n    }>\n  | MarkdownLinkValidationUnavailable;\n\ntype MarkdownLinkTraversal =\n  | Readonly<{\n      readonly kind: \"complete\";\n      readonly candidates: readonly MarkdownLinkRecordCandidate[];\n      readonly occurrenceCount: number;\n      readonly sourceFileCount: number;\n    }>\n  | MarkdownLinkValidationUnavailable;\n\n/** 验证本 Check 选中的 Markdown source 的离线本地链接完整性。 */\nexport async function executeMarkdownLinkValidation(\n  context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>\n): Promise<CheckResult<MarkdownLinkValidationFinalData>> {\n  if (!validMarkdownLinkValidationOptions(context.options)) return unavailable(\"invalid-options\");\n  const prepared = await prepareMarkdownTraversal(context);\n  if (prepared.kind === \"result\") return prepared.result;\n  const { rejectedInputCount, traversal, resolver } = prepared;\n\n  for (const candidate of traversal.candidates) {\n    context.records.report({ id: candidate.id }, candidate.data);\n  }\n  return settledMarkdownTraversalResult({\n    findingCount: traversal.candidates.length,\n    findingPolicy: context.options.findingPolicy,\n    occurrenceCount: traversal.occurrenceCount,\n    rejectedInputCount,\n    sourceFileCount: traversal.sourceFileCount,\n    targetReadCount: resolver.targetReadCount\n  });\n}\n\ntype PreparedMarkdownTraversal =\n  | Readonly<{\n      readonly kind: \"result\";\n      readonly result: CheckResult<MarkdownLinkValidationFinalData>;\n    }>\n  | Readonly<{\n      readonly kind: \"traversal\";\n      readonly rejectedInputCount: number;\n      readonly resolver: MarkdownLocalResolver;\n      readonly traversal: Extract<MarkdownLinkTraversal, { readonly kind: \"complete\" }>;\n    }>;\n\nasync function prepareMarkdownTraversal(\n  context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>\n): Promise<PreparedMarkdownTraversal> {\n  if (context.signal.aborted) return result(unavailable(\"cancelled\"));\n  const created = await createMarkdownLocalResolver(\n    context.project.root,\n    context.options.limits.maxTargetReads\n  );\n  if (!created.ok) return result(unavailable(created.reason));\n  if (context.signal.aborted) return result(unavailable(\"cancelled\"));\n  const sourceDiscovery = discoverMarkdownSourcePaths(context.project, context.options.files);\n  if (sourceDiscovery.kind === \"unavailable\") return result(unavailable(sourceDiscovery.reason));\n  if (sourceDiscovery.selectedPathCount === 0) return result(noEligibleInput());\n  if (context.signal.aborted) return result(unavailable(\"cancelled\"));\n  reportRejectedInputs(context, sourceDiscovery.rejectedPaths);\n  const traversal = await traverseMarkdownSources(sourceDiscovery.sourcePaths, {\n    resolver: created.resolver,\n    options: context.options,\n    signal: context.signal\n  });\n  if (traversal.kind === \"unavailable\") {\n    return result(\n      appendRejectedInputMessage(\n        unavailable(traversal.reason),\n        sourceDiscovery.rejectedPaths.length\n      )\n    );\n  }\n  if (context.signal.aborted) {\n    return result(\n      appendRejectedInputMessage(unavailable(\"cancelled\"), sourceDiscovery.rejectedPaths.length)\n    );\n  }\n  return Object.freeze({\n    kind: \"traversal\",\n    rejectedInputCount: sourceDiscovery.rejectedPaths.length,\n    resolver: created.resolver,\n    traversal\n  });\n}\n\nfunction result(\n  checkResult: CheckResult<MarkdownLinkValidationFinalData>\n): PreparedMarkdownTraversal {\n  return Object.freeze({ kind: \"result\", result: checkResult });\n}\n\nfunction noEligibleInput(): CheckResult<MarkdownLinkValidationFinalData> {\n  return Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } });\n}\n\nfunction discoverMarkdownSourcePaths(\n  project: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>[\"project\"],\n  files: ProjectFileSelection\n): MarkdownSourceDiscovery {\n  try {\n    const selectedPaths = collectProjectFiles(project.root, files);\n    const partition = partitionProjectFilesByEligibility(selectedPaths, isMarkdownSourcePath);\n    return Object.freeze({\n      kind: \"complete\" as const,\n      rejectedPaths: partition.rejectedPaths,\n      selectedPathCount: selectedPaths.length,\n      sourcePaths: partition.acceptedPaths\n    });\n  } catch {\n    return unavailableValidation(\"source-unavailable\");\n  }\n}\n\nfunction reportRejectedInputs(\n  context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>,\n  paths: readonly string[]\n): void {\n  for (const selectedPath of paths) {\n    const record = buildMarkdownInputRejectedRecord(selectedPath);\n    context.records.report({ id: record.id }, record.data);\n  }\n}\n\nfunction appendRejectedInputMessage(\n  checkResult: CheckResult<MarkdownLinkValidationFinalData>,\n  rejectedInputCount: number\n): CheckResult<MarkdownLinkValidationFinalData> {\n  if (rejectedInputCount === 0) return checkResult;\n  return Object.freeze({\n    ...checkResult,\n    messages: Object.freeze([\n      ...(checkResult.messages ?? []),\n      Object.freeze({\n        code: \"input-rejected\",\n        level: \"warning\" as const,\n        message: `${rejectedInputCount} selected markdownLinkValidation input file(s) were rejected because only .md/.markdown paths are supported; inspect this Check's Records and narrow files.include/exclude.`\n      })\n    ])\n  });\n}\n\nfunction unavailableValidation(\n  reason: MarkdownLinkValidationUnavailableReason\n): MarkdownLinkValidationUnavailable {\n  return Object.freeze({ kind: \"unavailable\", reason });\n}\n\nasync function traverseMarkdownSources(\n  sourcePaths: readonly string[],\n  run: MarkdownLinkValidationRun\n): Promise<MarkdownLinkTraversal> {\n  const candidates: MarkdownLinkRecordCandidate[] = [];\n  let occurrenceCount = 0;\n  let sourceFileCount = 0;\n\n  for (const sourcePath of sourcePaths) {\n    const sourceValidation = await validateMarkdownSource(sourcePath, occurrenceCount, run);\n    if (sourceValidation.kind === \"unavailable\") return sourceValidation;\n\n    candidates.push(...sourceValidation.candidates);\n    occurrenceCount = sourceValidation.occurrenceCount;\n    sourceFileCount += 1;\n  }\n\n  return Object.freeze({\n    kind: \"complete\" as const,\n    candidates: Object.freeze(candidates),\n    occurrenceCount,\n    sourceFileCount\n  });\n}\n\nasync function validateMarkdownSource(\n  sourcePath: string,\n  occurrenceCountBeforeSource: number,\n  run: MarkdownLinkValidationRun\n): Promise<MarkdownSourceValidation> {\n  if (run.signal.aborted) return unavailableValidation(\"cancelled\");\n  const sourceRead = await run.resolver.readSource(sourcePath, run.options.limits.maxMarkdownBytes);\n  if (run.signal.aborted) return unavailableValidation(\"cancelled\");\n  if (!sourceRead.ok) return unavailableValidation(sourceRead.reason);\n\n  const candidates: MarkdownLinkRecordCandidate[] = [];\n  let occurrenceCount = occurrenceCountBeforeSource;\n  for (const [occurrenceIndex, occurrence] of sourceRead.source.facts.occurrences.entries()) {\n    if (run.signal.aborted) return unavailableValidation(\"cancelled\");\n    occurrenceCount += 1;\n    if (occurrenceCount > run.options.limits.maxOccurrences) {\n      return unavailableValidation(\"occurrence-limit-exceeded\");\n    }\n\n    const resolution = await run.resolver.resolve({\n      source: sourceRead.source,\n      rawDestination: occurrence.rawDestination,\n      rootExternalTargetMode: run.options.rootExternalTargetMode,\n      requireExistingTargets: run.options.requireExistingTargets,\n      requireNonEmptyDirectories: run.options.requireNonEmptyDirectories,\n      validateSameDocumentAnchors: run.options.validateSameDocumentAnchors,\n      validateCrossDocumentAnchors: run.options.validateCrossDocumentAnchors,\n      maxMarkdownBytes: run.options.limits.maxMarkdownBytes\n    });\n    if (run.signal.aborted) return unavailableValidation(\"cancelled\");\n    if (resolution.kind === \"unavailable\") return unavailableValidation(resolution.reason);\n    const candidate = buildMarkdownLinkRecordCandidate(\n      sourceRead.source.path,\n      occurrenceIndex,\n      occurrence,\n      resolution\n    );\n    if (candidate !== undefined) candidates.push(candidate);\n  }\n\n  return Object.freeze({\n    kind: \"complete\" as const,\n    candidates: Object.freeze(candidates),\n    occurrenceCount\n  });\n}\n\nfunction isMarkdownSourcePath(filePath: string): boolean {\n  const extension = path.extname(filePath).toLowerCase();\n  return extension === \".md\" || extension === \".markdown\";\n}\n\nfunction unavailable(\n  reason: MarkdownLinkValidationUnavailableReason\n): CheckResult<MarkdownLinkValidationFinalData> {\n  return Object.freeze({\n    status: \"unavailable\",\n    reason: { code: reason },\n    messages: Object.freeze([\n      Object.freeze({ code: reason, level: \"error\" as const, message: unavailableMessage(reason) })\n    ])\n  });\n}\n\nfunction unavailableMessage(reason: MarkdownLinkValidationUnavailableReason): string {\n  return UNAVAILABLE_MESSAGES[reason];\n}\n\nconst UNAVAILABLE_MESSAGES: Readonly<Record<MarkdownLinkValidationUnavailableReason, string>> = {\n  \"invalid-options\":\n    \"markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options.\",\n  \"project-root-unavailable\":\n    \"Markdown link validation could not resolve the project root; check that the path exists and is accessible.\",\n  \"source-unavailable\":\n    \"A selected Markdown source could not be collected, read, decoded, or contained safely; check the file source and permissions.\",\n  \"source-too-large\":\n    \"A selected Markdown source exceeds maxMarkdownBytes; narrow the file selection or raise the bounded limit.\",\n  \"markdown-parse-failed\":\n    \"A selected Markdown source could not be parsed completely; inspect that document's Markdown syntax and encoding.\",\n  \"invalid-local-destination\":\n    \"A local Markdown destination could not be parsed safely; inspect the affected link destination syntax.\",\n  \"target-unavailable\":\n    \"A local Markdown target could not be probed or read safely; check the target path, permissions, size, and encoding.\",\n  \"occurrence-limit-exceeded\":\n    \"Markdown link validation exceeded maxOccurrences; narrow the source selection or raise the bounded limit.\",\n  \"target-read-limit-exceeded\":\n    \"Markdown link validation exceeded maxTargetReads; narrow the source selection or raise the bounded limit.\",\n  cancelled:\n    \"Markdown link validation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate.\"\n};\n"]}

package/dist/esm/package-checks/markdown-link-validation/filesystem-probes.mjs

@@ -0,0 +1,109 @@
+import { constants } from "node:fs";
+import { lstat, open, readlink } from "node:fs/promises";
+import path from "node:path";
+import { isNotFound, isWithinRoot, relativeSegments } from "./local-resolution.mjs";
+export async function probeRootContainedPath(canonicalProjectRoot, candidatePath) {
+    if (!isWithinRoot(canonicalProjectRoot, candidatePath)) {
+        return Object.freeze({ kind: "outside" });
+    }
+    let pendingSegments = relativeSegments(canonicalProjectRoot, candidatePath);
+    let currentPath = canonicalProjectRoot;
+    let symlinkHops = 0;
+    while (pendingSegments.length > 0) {
+        const segment = pendingSegments.shift();
+        if (segment === undefined) {
+            return Object.freeze({ kind: "unavailable" });
+        }
+        const nextPath = path.join(currentPath, segment);
+        let status;
+        try {
+            status = await lstat(nextPath);
+        }
+        catch (error) {
+            if (isNotFound(error)) {
+                return Object.freeze({ kind: "missing", absolutePath: nextPath });
+            }
+            return Object.freeze({ kind: "unavailable" });
+        }
+        if (!status.isSymbolicLink()) {
+            currentPath = nextPath;
+            continue;
+        }
+        if (symlinkHops >= 40) {
+            return Object.freeze({ kind: "unavailable" });
+        }
+        symlinkHops += 1;
+        let linkDestination;
+        try {
+            linkDestination = path.resolve(path.dirname(nextPath), await readlink(nextPath));
+        }
+        catch {
+            return Object.freeze({ kind: "unavailable" });
+        }
+        if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {
+            return Object.freeze({ kind: "outside" });
+        }
+        pendingSegments = [
+            ...relativeSegments(canonicalProjectRoot, linkDestination),
+            ...pendingSegments
+        ];
+        currentPath = canonicalProjectRoot;
+    }
+    return Object.freeze({ kind: "contained", absolutePath: currentPath });
+}
+export async function probeEndpoint(targetPath) {
+    let status;
+    try {
+        status = await lstat(targetPath);
+    }
+    catch (error) {
+        return isNotFound(error)
+            ? Object.freeze({ kind: "missing" })
+            : Object.freeze({ kind: "unavailable" });
+    }
+    if (status.isSymbolicLink()) {
+        return Object.freeze({ kind: "unavailable" });
+    }
+    if (status.isDirectory()) {
+        return Object.freeze({ kind: "directory" });
+    }
+    if (status.isFile()) {
+        return Object.freeze({ kind: "file" });
+    }
+    return Object.freeze({ kind: "unsupported" });
+}
+export async function readRegularFile(filePath, maxBytes) {
+    let handle;
+    try {
+        handle = await open(filePath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));
+        const status = await handle.stat();
+        if (!status.isFile()) {
+            return Object.freeze({ ok: false, reason: "unavailable" });
+        }
+        if (status.size > maxBytes) {
+            return Object.freeze({ ok: false, reason: "too-large" });
+        }
+        const bytes = await readBoundedBytes(handle, maxBytes);
+        return bytes === null
+            ? Object.freeze({ ok: false, reason: "too-large" })
+            : Object.freeze({ ok: true, bytes });
+    }
+    catch {
+        return Object.freeze({ ok: false, reason: "unavailable" });
+    }
+    finally {
+        await handle?.close().catch(() => undefined);
+    }
+}
+async function readBoundedBytes(handle, maxBytes) {
+    const bytes = new Uint8Array(maxBytes + 1);
+    let offset = 0;
+    while (offset < bytes.byteLength) {
+        const result = await handle.read(bytes, offset, bytes.byteLength - offset, offset);
+        if (result.bytesRead === 0)
+            break;
+        offset += result.bytesRead;
+    }
+    return offset > maxBytes ? null : bytes.slice(0, offset);
+}
+//# sourceMappingURL=filesystem-probes.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filesystem-probes.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/filesystem-probes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,UAAU,EACV,YAAY,EACZ,gBAAgB,EAGjB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,oBAA4B,EAC5B,aAAqB;IAErB,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,aAAa,CAAC,EAAE,CAAC;QACvD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,eAAe,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;IAC5E,IAAI,WAAW,GAAG,oBAAoB,CAAC;IACvC,IAAI,WAAW,GAAG,CAAC,CAAC;IAEpB,OAAO,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,eAAe,CAAC,KAAK,EAAE,CAAC;QACxC,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC1B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QACjD,IAAI,MAAyC,CAAC;QAC9C,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,CAAC;QACjC,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,IAAI,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7E,CAAC;YACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;YAC7B,WAAW,GAAG,QAAQ,CAAC;YACvB,SAAS;QACX,CAAC;QACD,IAAI,WAAW,IAAI,EAAE,EAAE,CAAC;YACtB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,WAAW,IAAI,CAAC,CAAC;QACjB,IAAI,eAAuB,CAAC;QAC5B,IAAI,CAAC;YACH,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;QACnF,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,eAAe,CAAC,EAAE,CAAC;YACzD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC,CAAC;QACrD,CAAC;QACD,eAAe,GAAG;YAChB,GAAG,gBAAgB,CAAC,oBAAoB,EAAE,eAAe,CAAC;YAC1D,GAAG,eAAe;SACnB,CAAC;QACF,WAAW,GAAG,oBAAoB,CAAC;IACrC,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,UAAkB;IACpD,IAAI,MAAyC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,KAAK,CAAC,UAAU,CAAC,CAAC;IACnC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO,UAAU,CAAC,KAAK,CAAC;YACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC;YAC7C,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;IACzD,CAAC;IACD,IAAI,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACzB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAoB,EAAE,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAsB,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,QAAgB,EAChB,QAAgB;IAKhB,IAAI,MAAoD,CAAC;IACzD,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,CAAC;YACrB,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,MAAM,CAAC,IAAI,GAAG,QAAQ,EAAE,CAAC;YAC3B,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,WAAoB,EAAE,CAAC,CAAC;QAC7E,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACvD,OAAO,KAAK,KAAK,IAAI;YACnB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,WAAoB,EAAE,CAAC;YACrE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,IAAa,EAAE,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,aAAsB,EAAE,CAAC,CAAC;IAC/E,CAAC;YAAS,CAAC;QACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,gBAAgB,CAC7B,MAAwC,EACxC,QAAgB;IAEhB,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IAC3C,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,OAAO,MAAM,GAAG,KAAK,CAAC,UAAU,EAAE,CAAC;QACjC,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,UAAU,GAAG,MAAM,EAAE,MAAM,CAAC,CAAC;QACnF,IAAI,MAAM,CAAC,SAAS,KAAK,CAAC;YAAE,MAAM;QAClC,MAAM,IAAI,MAAM,CAAC,SAAS,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AAC3D,CAAC","sourcesContent":["import { constants } from \"node:fs\";\nimport { lstat, open, readlink } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n  isNotFound,\n  isWithinRoot,\n  relativeSegments,\n  type EndpointProbe,\n  type RootProbe\n} from \"./local-resolution.ts\";\n\nexport async function probeRootContainedPath(\n  canonicalProjectRoot: string,\n  candidatePath: string\n): Promise<RootProbe> {\n  if (!isWithinRoot(canonicalProjectRoot, candidatePath)) {\n    return Object.freeze({ kind: \"outside\" as const });\n  }\n  let pendingSegments = relativeSegments(canonicalProjectRoot, candidatePath);\n  let currentPath = canonicalProjectRoot;\n  let symlinkHops = 0;\n\n  while (pendingSegments.length > 0) {\n    const segment = pendingSegments.shift();\n    if (segment === undefined) {\n      return Object.freeze({ kind: \"unavailable\" as const });\n    }\n    const nextPath = path.join(currentPath, segment);\n    let status: Awaited<ReturnType<typeof lstat>>;\n    try {\n      status = await lstat(nextPath);\n    } catch (error: unknown) {\n      if (isNotFound(error)) {\n        return Object.freeze({ kind: \"missing\" as const, absolutePath: nextPath });\n      }\n      return Object.freeze({ kind: \"unavailable\" as const });\n    }\n    if (!status.isSymbolicLink()) {\n      currentPath = nextPath;\n      continue;\n    }\n    if (symlinkHops >= 40) {\n      return Object.freeze({ kind: \"unavailable\" as const });\n    }\n    symlinkHops += 1;\n    let linkDestination: string;\n    try {\n      linkDestination = path.resolve(path.dirname(nextPath), await readlink(nextPath));\n    } catch {\n      return Object.freeze({ kind: \"unavailable\" as const });\n    }\n    if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {\n      return Object.freeze({ kind: \"outside\" as const });\n    }\n    pendingSegments = [\n      ...relativeSegments(canonicalProjectRoot, linkDestination),\n      ...pendingSegments\n    ];\n    currentPath = canonicalProjectRoot;\n  }\n\n  return Object.freeze({ kind: \"contained\" as const, absolutePath: currentPath });\n}\n\nexport async function probeEndpoint(targetPath: string): Promise<EndpointProbe> {\n  let status: Awaited<ReturnType<typeof lstat>>;\n  try {\n    status = await lstat(targetPath);\n  } catch (error: unknown) {\n    return isNotFound(error)\n      ? Object.freeze({ kind: \"missing\" as const })\n      : Object.freeze({ kind: \"unavailable\" as const });\n  }\n  if (status.isSymbolicLink()) {\n    return Object.freeze({ kind: \"unavailable\" as const });\n  }\n  if (status.isDirectory()) {\n    return Object.freeze({ kind: \"directory\" as const });\n  }\n  if (status.isFile()) {\n    return Object.freeze({ kind: \"file\" as const });\n  }\n  return Object.freeze({ kind: \"unsupported\" as const });\n}\n\nexport async function readRegularFile(\n  filePath: string,\n  maxBytes: number\n): Promise<\n  | Readonly<{ readonly ok: true; readonly bytes: Uint8Array }>\n  | Readonly<{ readonly ok: false; readonly reason: \"too-large\" | \"unavailable\" }>\n> {\n  let handle: Awaited<ReturnType<typeof open>> | undefined;\n  try {\n    handle = await open(filePath, constants.O_RDONLY | (constants.O_NOFOLLOW ?? 0));\n    const status = await handle.stat();\n    if (!status.isFile()) {\n      return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n    }\n    if (status.size > maxBytes) {\n      return Object.freeze({ ok: false as const, reason: \"too-large\" as const });\n    }\n    const bytes = await readBoundedBytes(handle, maxBytes);\n    return bytes === null\n      ? Object.freeze({ ok: false as const, reason: \"too-large\" as const })\n      : Object.freeze({ ok: true as const, bytes });\n  } catch {\n    return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n  } finally {\n    await handle?.close().catch(() => undefined);\n  }\n}\n\nasync function readBoundedBytes(\n  handle: Awaited<ReturnType<typeof open>>,\n  maxBytes: number\n): Promise<Uint8Array | null> {\n  const bytes = new Uint8Array(maxBytes + 1);\n  let offset = 0;\n  while (offset < bytes.byteLength) {\n    const result = await handle.read(bytes, offset, bytes.byteLength - offset, offset);\n    if (result.bytesRead === 0) break;\n    offset += result.bytesRead;\n  }\n  return offset > maxBytes ? null : bytes.slice(0, offset);\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/final-data.mjs

@@ -0,0 +1,28 @@
+import { exactFinalDataRecord, invalidFinalData, nonNegativeSafeInteger } from "../final-data-parsing.mjs";
+/** 验证计数不变量并脱离一份 canonical final-data object。 */
+export function parseMarkdownLinkValidationData(data) {
+    const value = exactFinalDataRecord(data, ["sourceFileCount", "occurrenceCount", "targetReadCount", "findingCount", "rejectedInputCount"], "markdownLinkValidation");
+    const sourceFileCount = nonNegativeSafeInteger(value.sourceFileCount);
+    const occurrenceCount = nonNegativeSafeInteger(value.occurrenceCount);
+    const targetReadCount = nonNegativeSafeInteger(value.targetReadCount);
+    const findingCount = nonNegativeSafeInteger(value.findingCount);
+    const rejectedInputCount = nonNegativeSafeInteger(value.rejectedInputCount);
+    if (sourceFileCount === undefined ||
+        occurrenceCount === undefined ||
+        targetReadCount === undefined ||
+        findingCount === undefined ||
+        rejectedInputCount === undefined ||
+        targetReadCount > occurrenceCount ||
+        findingCount < rejectedInputCount ||
+        findingCount - rejectedInputCount > occurrenceCount) {
+        throw invalidFinalData("markdownLinkValidation");
+    }
+    return Object.freeze({
+        sourceFileCount,
+        occurrenceCount,
+        targetReadCount,
+        findingCount,
+        rejectedInputCount
+    });
+}
+//# sourceMappingURL=final-data.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/final-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAWlC,gDAAgD;AAChD,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,MAAM,KAAK,GAAG,oBAAoB,CAChC,IAAI,EACJ,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,CAAC,EAC/F,wBAAwB,CACzB,CAAC;IACF,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5E,IACE,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,YAAY,KAAK,SAAS;QAC1B,kBAAkB,KAAK,SAAS;QAChC,eAAe,GAAG,eAAe;QACjC,YAAY,GAAG,kBAAkB;QACjC,YAAY,GAAG,kBAAkB,GAAG,eAAe,EACnD,CAAC;QACD,MAAM,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,eAAe;QACf,eAAe;QACf,eAAe;QACf,YAAY;QACZ,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n  exactFinalDataRecord,\n  invalidFinalData,\n  nonNegativeSafeInteger\n} from \"../final-data-parsing.ts\";\n\n/** `markdown-link-validation` 在 passed/failed outcome 中发布的主数据。 */\nexport interface MarkdownLinkValidationFinalData {\n  readonly sourceFileCount: number;\n  readonly occurrenceCount: number;\n  readonly targetReadCount: number;\n  readonly findingCount: number;\n  readonly rejectedInputCount: number;\n}\n\n/** 验证计数不变量并脱离一份 canonical final-data object。 */\nexport function parseMarkdownLinkValidationData(data: unknown): MarkdownLinkValidationFinalData {\n  const value = exactFinalDataRecord(\n    data,\n    [\"sourceFileCount\", \"occurrenceCount\", \"targetReadCount\", \"findingCount\", \"rejectedInputCount\"],\n    \"markdownLinkValidation\"\n  );\n  const sourceFileCount = nonNegativeSafeInteger(value.sourceFileCount);\n  const occurrenceCount = nonNegativeSafeInteger(value.occurrenceCount);\n  const targetReadCount = nonNegativeSafeInteger(value.targetReadCount);\n  const findingCount = nonNegativeSafeInteger(value.findingCount);\n  const rejectedInputCount = nonNegativeSafeInteger(value.rejectedInputCount);\n  if (\n    sourceFileCount === undefined ||\n    occurrenceCount === undefined ||\n    targetReadCount === undefined ||\n    findingCount === undefined ||\n    rejectedInputCount === undefined ||\n    targetReadCount > occurrenceCount ||\n    findingCount < rejectedInputCount ||\n    findingCount - rejectedInputCount > occurrenceCount\n  ) {\n    throw invalidFinalData(\"markdownLinkValidation\");\n  }\n  return Object.freeze({\n    sourceFileCount,\n    occurrenceCount,\n    targetReadCount,\n    findingCount,\n    rejectedInputCount\n  });\n}\n"]}

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

@@ -0,0 +1,158 @@
+import path from "node:path";
+const NOT_LOCAL_FILE_URI = Symbol("not-local-file-uri");
+export function parseLocalDestination(rawDestination) {
+    if (rawDestination.startsWith("//") || rawDestination.startsWith("\\\\")) {
+        return "not-local";
+    }
+    if (isHostWindowsDriveAbsolute(rawDestination)) {
+        return parsePathAndFragment(rawDestination, false);
+    }
+    const scheme = /^([A-Za-z][A-Za-z\d+.-]*):/u.exec(rawDestination);
+    if (scheme !== null) {
+        if (scheme[1]?.toLowerCase() !== "file") {
+            return "not-local";
+        }
+        return parseFileDestination(rawDestination);
+    }
+    if (path.sep !== "\\" && /^[A-Za-z]:[\\/]/u.test(rawDestination)) {
+        return "not-local";
+    }
+    return parsePathAndFragment(rawDestination, false);
+}
+function parseFileDestination(rawDestination) {
+    const match = /^file:\/\/(\/.*)$/iu.exec(rawDestination);
+    if (match === null) {
+        return "not-local";
+    }
+    const uriPathAndFragment = match[1];
+    if (uriPathAndFragment === undefined || uriPathAndFragment.startsWith("//")) {
+        return "not-local";
+    }
+    if (hasUriQuery(uriPathAndFragment) || containsUnsafeRawFileCharacter(uriPathAndFragment)) {
+        return "not-local";
+    }
+    const parsed = parsePathAndFragment(uriPathAndFragment, true);
+    if (parsed === null || parsed === "not-local") {
+        return parsed;
+    }
+    return Object.freeze({ ...parsed, isAbsolute: true });
+}
+function parsePathAndFragment(rawDestination, isFileUri) {
+    const hashIndex = rawDestination.indexOf("#");
+    const queryIndex = rawDestination.indexOf("?");
+    const pathEnd = [hashIndex, queryIndex]
+        .filter((index) => index >= 0)
+        .reduce((smallest, index) => Math.min(smallest, index), rawDestination.length);
+    const rawPath = rawDestination.slice(0, pathEnd);
+    const rawFragment = hashIndex >= 0 ? rawDestination.slice(hashIndex + 1) : null;
+    const decodedPath = decodeLocalComponent(rawPath);
+    const decodedFragment = rawFragment === null ? null : decodeLocalComponent(rawFragment);
+    if (decodedPath === null || (decodedFragment === null && rawFragment !== null)) {
+        return null;
+    }
+    const resolvedPath = isFileUri ? hostFileUriPath(decodedPath) : decodedPath;
+    if (resolvedPath === null)
+        return null;
+    if (resolvedPath === NOT_LOCAL_FILE_URI)
+        return "not-local";
+    return Object.freeze({
+        path: resolvedPath,
+        fragment: decodedFragment,
+        isAbsolute: isFileUri || path.isAbsolute(resolvedPath)
+    });
+}
+function decodeLocalComponent(rawComponent) {
+    if (containsControlCharacter(rawComponent) || /%(?:2f|5c|00|0[0-9a-f]|7f)/iu.test(rawComponent)) {
+        return null;
+    }
+    try {
+        const decoded = decodeURIComponent(rawComponent);
+        return containsControlCharacter(decoded) ? null : decoded;
+    }
+    catch {
+        return null;
+    }
+}
+function isHostWindowsDriveAbsolute(value) {
+    return path.sep === "\\" && /^[A-Za-z]:[\\/]/u.test(value);
+}
+function hostFileUriPath(decodedPath) {
+    if (decodedPath.includes("\\"))
+        return null;
+    if (path.sep === "\\") {
+        if (!/^\/[A-Za-z]:\//u.test(decodedPath))
+            return NOT_LOCAL_FILE_URI;
+        return path.normalize(decodedPath.slice(1));
+    }
+    if (/^\/[A-Za-z]:\//u.test(decodedPath))
+        return NOT_LOCAL_FILE_URI;
+    return path.isAbsolute(decodedPath) ? decodedPath : null;
+}
+function hasUriQuery(uriPathAndFragment) {
+    const queryIndex = uriPathAndFragment.indexOf("?");
+    if (queryIndex < 0)
+        return false;
+    const fragmentIndex = uriPathAndFragment.indexOf("#");
+    return fragmentIndex < 0 || queryIndex < fragmentIndex;
+}
+export function anchorResolution(headings, fragment, target) {
+    return headings.some((heading) => heading.slug === fragment)
+        ? valid(target)
+        : finding("missing-anchor", target);
+}
+export function isRootRelativePath(canonicalProjectRoot, rootRelativePath) {
+    return (!path.isAbsolute(rootRelativePath) &&
+        isWithinRoot(canonicalProjectRoot, path.resolve(canonicalProjectRoot, rootRelativePath)));
+}
+export function isWithinRoot(root, candidate) {
+    const relativePath = path.relative(root, candidate);
+    return (relativePath === "" ||
+        (!relativePath.startsWith(`..${path.sep}`) &&
+            relativePath !== ".." &&
+            !path.isAbsolute(relativePath)));
+}
+export function relativeSegments(root, candidate) {
+    const relativePath = path.relative(root, candidate);
+    return relativePath === ""
+        ? []
+        : relativePath.split(path.sep).filter((segment) => segment !== "");
+}
+export function sameRootRelativePath(rootRelativePath, targetPath, canonicalProjectRoot) {
+    return toSlashPath(path.relative(canonicalProjectRoot, targetPath)) === rootRelativePath;
+}
+export function isMarkdownPath(targetPath) {
+    const extension = path.extname(targetPath).toLowerCase();
+    return extension === ".md" || extension === ".markdown";
+}
+export function toSlashPath(filePath) {
+    return filePath.split(path.sep).join("/");
+}
+function containsUnsafeRawFileCharacter(value) {
+    return value.includes("\\") || containsControlCharacter(value) || /\s/u.test(value);
+}
+function containsControlCharacter(value) {
+    for (const character of value) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint !== undefined &&
+            (codePoint <= 0x1f || (codePoint >= 0x7f && codePoint <= 0x9f))) {
+            return true;
+        }
+    }
+    return false;
+}
+export function isNotFound(error) {
+    return typeof error === "object" && error !== null && "code" in error && error.code === "ENOENT";
+}
+export function sourceUnavailable() {
+    return Object.freeze({ ok: false, reason: "source-unavailable" });
+}
+export function valid(target) {
+    return Object.freeze({ kind: "valid", target });
+}
+export function finding(reason, target) {
+    return Object.freeze({ kind: "finding", reason, target });
+}
+export function unavailable(reason) {
+    return Object.freeze({ kind: "unavailable", reason });
+}
+//# sourceMappingURL=local-resolution.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/local-resolution.ts"],"names":[],"mappings":"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","sourcesContent":["import path from \"node:path\";\n\nimport type { MarkdownHeading, ParsedMarkdownLinkFacts } from \"./markdown-parser.ts\";\n\ntype RootExternalTargetMode = \"ignore\" | \"report\" | \"validate\";\nconst NOT_LOCAL_FILE_URI: unique symbol = Symbol(\"not-local-file-uri\");\n\n/** Markdown local-link finding Record 的稳定 reason。 */\nexport type MarkdownLinkFindingReason =\n  | \"anchor-on-directory\"\n  | \"anchor-target-not-markdown\"\n  | \"empty-directory\"\n  | \"missing-anchor\"\n  | \"missing-target\"\n  | \"target-outside-project-root\"\n  | \"unsupported-target-type\";\n\ntype MarkdownLocalResolutionReason =\n  | \"invalid-local-destination\"\n  | \"target-read-limit-exceeded\"\n  | \"target-unavailable\";\n\ntype MarkdownSourceReadFailureReason =\n  | \"markdown-parse-failed\"\n  | \"source-unavailable\"\n  | \"source-too-large\";\n\ninterface MarkdownLinkSource {\n  readonly path: string;\n  readonly facts: ParsedMarkdownLinkFacts;\n}\n\ninterface MarkdownLocalResolver {\n  readSource(rootRelativePath: string, maxMarkdownBytes: number): Promise<MarkdownSourceReadResult>;\n  resolve(request: MarkdownLocalResolutionRequest): Promise<MarkdownLocalResolution>;\n  readonly targetReadCount: number;\n}\n\ninterface MarkdownLocalResolutionRequest {\n  readonly source: MarkdownLinkSource;\n  readonly rawDestination: string;\n  readonly rootExternalTargetMode: RootExternalTargetMode;\n  readonly requireExistingTargets: boolean;\n  readonly requireNonEmptyDirectories: boolean;\n  readonly validateSameDocumentAnchors: boolean;\n  readonly validateCrossDocumentAnchors: boolean;\n  readonly maxMarkdownBytes: number;\n}\n\ntype MarkdownLocalResolverCreation =\n  | Readonly<{ readonly ok: true; readonly resolver: MarkdownLocalResolver }>\n  | Readonly<{ readonly ok: false; readonly reason: \"project-root-unavailable\" }>;\n\ntype MarkdownSourceReadResult =\n  | Readonly<{ readonly ok: true; readonly source: MarkdownLinkSource }>\n  | Readonly<{\n      readonly ok: false;\n      readonly reason: MarkdownSourceReadFailureReason;\n    }>;\n\ntype MarkdownLocalResolution =\n  | Readonly<{ readonly kind: \"not-local\" | \"ignored\" }>\n  | Readonly<{ readonly kind: \"valid\"; readonly target: MarkdownSafeTargetDescriptor }>\n  | Readonly<{\n      readonly kind: \"finding\";\n      readonly reason: MarkdownLinkFindingReason;\n      readonly target: MarkdownSafeTargetDescriptor;\n    }>\n  | Readonly<{ readonly kind: \"unavailable\"; readonly reason: MarkdownLocalResolutionReason }>;\n\ntype MarkdownSafeTargetDescriptor =\n  | Readonly<{\n      readonly kind: \"same-document\" | \"project-file\" | \"project-directory\" | \"project-path\";\n      readonly path: string;\n      readonly fragment: string | null;\n    }>\n  | Readonly<{ readonly kind: \"outside-project-root\" }>;\n\ninterface ParsedLocalDestination {\n  readonly path: string;\n  readonly fragment: string | null;\n  readonly isAbsolute: boolean;\n}\n\ninterface RootContainedPath {\n  readonly kind: \"contained\" | \"missing\";\n  readonly absolutePath: string;\n}\n\ntype RootProbe =\n  | RootContainedPath\n  | Readonly<{ readonly kind: \"outside\" }>\n  | Readonly<{ readonly kind: \"unavailable\" }>;\n\ntype EndpointProbe =\n  | Readonly<{ readonly kind: \"missing\" }>\n  | Readonly<{ readonly kind: \"directory\" | \"file\" | \"unsupported\" | \"unavailable\" }>;\n\nexport function parseLocalDestination(\n  rawDestination: string\n): ParsedLocalDestination | \"not-local\" | null {\n  if (rawDestination.startsWith(\"//\") || rawDestination.startsWith(\"\\\\\\\\\")) {\n    return \"not-local\";\n  }\n  if (isHostWindowsDriveAbsolute(rawDestination)) {\n    return parsePathAndFragment(rawDestination, false);\n  }\n  const scheme = /^([A-Za-z][A-Za-z\\d+.-]*):/u.exec(rawDestination);\n  if (scheme !== null) {\n    if (scheme[1]?.toLowerCase() !== \"file\") {\n      return \"not-local\";\n    }\n    return parseFileDestination(rawDestination);\n  }\n  if (path.sep !== \"\\\\\" && /^[A-Za-z]:[\\\\/]/u.test(rawDestination)) {\n    return \"not-local\";\n  }\n  return parsePathAndFragment(rawDestination, false);\n}\n\nfunction parseFileDestination(rawDestination: string): ParsedLocalDestination | \"not-local\" | null {\n  const match = /^file:\\/\\/(\\/.*)$/iu.exec(rawDestination);\n  if (match === null) {\n    return \"not-local\";\n  }\n  const uriPathAndFragment = match[1];\n  if (uriPathAndFragment === undefined || uriPathAndFragment.startsWith(\"//\")) {\n    return \"not-local\";\n  }\n  if (hasUriQuery(uriPathAndFragment) || containsUnsafeRawFileCharacter(uriPathAndFragment)) {\n    return \"not-local\";\n  }\n  const parsed = parsePathAndFragment(uriPathAndFragment, true);\n  if (parsed === null || parsed === \"not-local\") {\n    return parsed;\n  }\n  return Object.freeze({ ...parsed, isAbsolute: true });\n}\n\nfunction parsePathAndFragment(\n  rawDestination: string,\n  isFileUri: boolean\n): ParsedLocalDestination | \"not-local\" | null {\n  const hashIndex = rawDestination.indexOf(\"#\");\n  const queryIndex = rawDestination.indexOf(\"?\");\n  const pathEnd = [hashIndex, queryIndex]\n    .filter((index) => index >= 0)\n    .reduce((smallest, index) => Math.min(smallest, index), rawDestination.length);\n  const rawPath = rawDestination.slice(0, pathEnd);\n  const rawFragment = hashIndex >= 0 ? rawDestination.slice(hashIndex + 1) : null;\n  const decodedPath = decodeLocalComponent(rawPath);\n  const decodedFragment = rawFragment === null ? null : decodeLocalComponent(rawFragment);\n  if (decodedPath === null || (decodedFragment === null && rawFragment !== null)) {\n    return null;\n  }\n  const resolvedPath = isFileUri ? hostFileUriPath(decodedPath) : decodedPath;\n  if (resolvedPath === null) return null;\n  if (resolvedPath === NOT_LOCAL_FILE_URI) return \"not-local\";\n  return Object.freeze({\n    path: resolvedPath,\n    fragment: decodedFragment,\n    isAbsolute: isFileUri || path.isAbsolute(resolvedPath)\n  });\n}\n\nfunction decodeLocalComponent(rawComponent: string): string | null {\n  if (containsControlCharacter(rawComponent) || /%(?:2f|5c|00|0[0-9a-f]|7f)/iu.test(rawComponent)) {\n    return null;\n  }\n  try {\n    const decoded = decodeURIComponent(rawComponent);\n    return containsControlCharacter(decoded) ? null : decoded;\n  } catch {\n    return null;\n  }\n}\n\nfunction isHostWindowsDriveAbsolute(value: string): boolean {\n  return path.sep === \"\\\\\" && /^[A-Za-z]:[\\\\/]/u.test(value);\n}\n\nfunction hostFileUriPath(decodedPath: string): string | typeof NOT_LOCAL_FILE_URI | null {\n  if (decodedPath.includes(\"\\\\\")) return null;\n  if (path.sep === \"\\\\\") {\n    if (!/^\\/[A-Za-z]:\\//u.test(decodedPath)) return NOT_LOCAL_FILE_URI;\n    return path.normalize(decodedPath.slice(1));\n  }\n  if (/^\\/[A-Za-z]:\\//u.test(decodedPath)) return NOT_LOCAL_FILE_URI;\n  return path.isAbsolute(decodedPath) ? decodedPath : null;\n}\n\nfunction hasUriQuery(uriPathAndFragment: string): boolean {\n  const queryIndex = uriPathAndFragment.indexOf(\"?\");\n  if (queryIndex < 0) return false;\n  const fragmentIndex = uriPathAndFragment.indexOf(\"#\");\n  return fragmentIndex < 0 || queryIndex < fragmentIndex;\n}\n\nexport function anchorResolution(\n  headings: readonly MarkdownHeading[],\n  fragment: string,\n  target: MarkdownSafeTargetDescriptor\n): MarkdownLocalResolution {\n  return headings.some((heading) => heading.slug === fragment)\n    ? valid(target)\n    : finding(\"missing-anchor\", target);\n}\n\nexport function isRootRelativePath(\n  canonicalProjectRoot: string,\n  rootRelativePath: string\n): boolean {\n  return (\n    !path.isAbsolute(rootRelativePath) &&\n    isWithinRoot(canonicalProjectRoot, path.resolve(canonicalProjectRoot, rootRelativePath))\n  );\n}\n\nexport function isWithinRoot(root: string, candidate: string): boolean {\n  const relativePath = path.relative(root, candidate);\n  return (\n    relativePath === \"\" ||\n    (!relativePath.startsWith(`..${path.sep}`) &&\n      relativePath !== \"..\" &&\n      !path.isAbsolute(relativePath))\n  );\n}\n\nexport function relativeSegments(root: string, candidate: string): string[] {\n  const relativePath = path.relative(root, candidate);\n  return relativePath === \"\"\n    ? []\n    : relativePath.split(path.sep).filter((segment) => segment !== \"\");\n}\n\nexport function sameRootRelativePath(\n  rootRelativePath: string,\n  targetPath: string,\n  canonicalProjectRoot: string\n): boolean {\n  return toSlashPath(path.relative(canonicalProjectRoot, targetPath)) === rootRelativePath;\n}\n\nexport function isMarkdownPath(targetPath: string): boolean {\n  const extension = path.extname(targetPath).toLowerCase();\n  return extension === \".md\" || extension === \".markdown\";\n}\n\nexport function toSlashPath(filePath: string): string {\n  return filePath.split(path.sep).join(\"/\");\n}\n\nfunction containsUnsafeRawFileCharacter(value: string): boolean {\n  return value.includes(\"\\\\\") || containsControlCharacter(value) || /\\s/u.test(value);\n}\n\nfunction containsControlCharacter(value: string): boolean {\n  for (const character of value) {\n    const codePoint = character.codePointAt(0);\n    if (\n      codePoint !== undefined &&\n      (codePoint <= 0x1f || (codePoint >= 0x7f && codePoint <= 0x9f))\n    ) {\n      return true;\n    }\n  }\n  return false;\n}\n\nexport function isNotFound(error: unknown): boolean {\n  return typeof error === \"object\" && error !== null && \"code\" in error && error.code === \"ENOENT\";\n}\n\nexport function sourceUnavailable(): MarkdownSourceReadResult {\n  return Object.freeze({ ok: false as const, reason: \"source-unavailable\" as const });\n}\n\nexport function valid(target: MarkdownSafeTargetDescriptor): MarkdownLocalResolution {\n  return Object.freeze({ kind: \"valid\" as const, target });\n}\n\nexport function finding(\n  reason: MarkdownLinkFindingReason,\n  target: MarkdownSafeTargetDescriptor\n): MarkdownLocalResolution {\n  return Object.freeze({ kind: \"finding\" as const, reason, target });\n}\n\nexport function unavailable(reason: MarkdownLocalResolutionReason): MarkdownLocalResolution {\n  return Object.freeze({ kind: \"unavailable\" as const, reason });\n}\n\nexport type {\n  MarkdownLinkSource,\n  MarkdownLocalResolution,\n  MarkdownLocalResolutionReason,\n  MarkdownLocalResolver,\n  MarkdownLocalResolverCreation,\n  MarkdownLocalResolutionRequest,\n  MarkdownSafeTargetDescriptor,\n  MarkdownSourceReadResult,\n  MarkdownSourceReadFailureReason,\n  RootProbe,\n  EndpointProbe,\n  RootExternalTargetMode\n};\n"]}

package/dist/esm/package-checks/markdown-link-validation/local-resolver.mjs

@@ -0,0 +1,17 @@
+import { realpath } from "node:fs/promises";
+import { LinkLocalResolver } from "./resolver-engine.mjs";
+/** Link-private, per-invocation state for source reads and direct local targets. */
+export async function createMarkdownLocalResolver(projectRoot, maxTargetReads) {
+    try {
+        const canonicalProjectRoot = await realpath(projectRoot);
+        return Object.freeze({
+            ok: true,
+            resolver: new LinkLocalResolver(canonicalProjectRoot, maxTargetReads)
+        });
+    }
+    catch {
+        return Object.freeze({ ok: false, reason: "project-root-unavailable" });
+    }
+}
+export { anchorResolution, finding, isMarkdownPath, isNotFound, isRootRelativePath, isWithinRoot, parseLocalDestination, relativeSegments, sameRootRelativePath, sourceUnavailable, toSlashPath, unavailable, valid } from "./local-resolution.mjs";
+//# sourceMappingURL=local-resolver.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"local-resolver.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/local-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAGzD,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,WAAmB,EACnB,cAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,oBAAoB,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAC;QACzD,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,EAAE,EAAE,IAAa;YACjB,QAAQ,EAAE,IAAI,iBAAiB,CAAC,oBAAoB,EAAE,cAAc,CAAC;SACtE,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,KAAc,EAAE,MAAM,EAAE,0BAAmC,EAAE,CAAC,CAAC;IAC5F,CAAC;AACH,CAAC;AAED,OAAO,EACL,gBAAgB,EAChB,OAAO,EACP,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,YAAY,EACZ,qBAAqB,EACrB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,KAAK,EACN,MAAM,uBAAuB,CAAC","sourcesContent":["import { realpath } from \"node:fs/promises\";\n\nimport { LinkLocalResolver } from \"./resolver-engine.ts\";\nimport type { MarkdownLocalResolverCreation } from \"./local-resolution.ts\";\n\n/** Link-private, per-invocation state for source reads and direct local targets. */\nexport async function createMarkdownLocalResolver(\n  projectRoot: string,\n  maxTargetReads: number\n): Promise<MarkdownLocalResolverCreation> {\n  try {\n    const canonicalProjectRoot = await realpath(projectRoot);\n    return Object.freeze({\n      ok: true as const,\n      resolver: new LinkLocalResolver(canonicalProjectRoot, maxTargetReads)\n    });\n  } catch {\n    return Object.freeze({ ok: false as const, reason: \"project-root-unavailable\" as const });\n  }\n}\n\nexport {\n  anchorResolution,\n  finding,\n  isMarkdownPath,\n  isNotFound,\n  isRootRelativePath,\n  isWithinRoot,\n  parseLocalDestination,\n  relativeSegments,\n  sameRootRelativePath,\n  sourceUnavailable,\n  toSlashPath,\n  unavailable,\n  valid\n} from \"./local-resolution.ts\";\nexport type {\n  EndpointProbe,\n  MarkdownLinkFindingReason,\n  MarkdownLinkSource,\n  MarkdownLocalResolution,\n  MarkdownLocalResolutionReason,\n  MarkdownLocalResolutionRequest,\n  MarkdownLocalResolver,\n  MarkdownLocalResolverCreation,\n  MarkdownSafeTargetDescriptor,\n  MarkdownSourceReadFailureReason,\n  MarkdownSourceReadResult,\n  RootExternalTargetMode,\n  RootProbe\n} from \"./local-resolution.ts\";\n"]}