@zxyycom/vibe-check 0.0.2 → 0.0.3

package/dist/esm/package-checks/maintenance-reminders/maintenance-reminders.mjs

@@ -1,4 +1,5 @@
 import { defineCheck } from "../../check/check.mjs";
+import { resolvePackageCheckAuthoringInput } from "../check-authoring.mjs";
 import { MAINTENANCE_REMINDER_UNAVAILABLE_REASON, parseMaintenanceRemindersData } from "./final-data.mjs";
 import { runGit } from "./maintenance-support.mjs";
 import { exactRecord, validEntries, validGit } from "./options-validation.mjs";
@@ -11,51 +12,26 @@ const WHOLE_CHECK_UNAVAILABLE_CODE = Object.freeze({
     executionCancelled: "execution-cancelled",
     internalFailure: "maintenance-reminders-internal-failure"
 });
-/**
- * 创建一个固定 ID 的普通 Check，并在其局部最终数据中评估多条维护提醒。
- *
- * @remarks 构造函数只接收项目无法可靠推断的提醒政策；它补齐 Git 可执行文件、身份、可见性和直接执行逻辑。返回值仍是普通 Check，可按现有原生对象组合规则替换完整 `options` 分支。
- * @example 创建一个单一 Check 的维护提醒
- * ```ts
- * import { defineConfig, maintenanceReminders, run } from "@zxyycom/vibe-check";
- *
- * // 下列 baseCommit 都是示例占位值；实际使用时，每条都必须替换为该提醒最近一次真实复核对应的完整 commit ID。
- * const maintenance = maintenanceReminders([
- *   {
- *     id: "documentation-review",
- *     baseCommit: "0123456789abcdef0123456789abcdef01234567",
- *     limits: { commits: 40, changedLines: 2_000 },
- *     message: "Review the documentation structure after this body of change."
- *   },
- *   {
- *     id: "optimization-audit",
- *     baseCommit: "89abcdef0123456789abcdef0123456789abcdef",
- *     limits: { commits: 80 },
- *     message: "Audit optimization quality before this becomes older.",
- *     mode: "enforcing"
- *   }
- * ]);
- *
- * const definition = defineConfig({
- *   checks: [maintenance],
- *   outputs: {
- *     diagnosticLogging: { enabled: false },
- *     machinePublication: { enabled: false },
- *     progressRendering: { enabled: false }
- *   }
- * });
- *
- * const result = await run(definition);
- * if (result.kind !== "completed") throw new Error(`Run did not complete: ${result.kind}`);
- * ```
- */
-export function maintenanceReminders(entries) {
+export function maintenanceReminders(input) {
+    if (isMaintenanceReminderEntries(input)) {
+        return createMaintenanceRemindersCheck({
+            checkId: MAINTENANCE_REMINDERS_CHECK_ID,
+            displayName: "Maintenance reminders",
+            omitQuietPassedRow: true
+        }, input);
+    }
+    const resolvedInput = resolveMaintenanceRemindersInput(input);
+    if (resolvedInput === undefined) {
+        throw new TypeError("maintenanceReminders input must be entries or a closed { entries, checkId?, displayName?, enabledByFlags?, checks?, dependsOn?, observes?, maxParallel?, admissionPriority?, mutex?, resourceClaims?, omitQuietPassedRow? } object");
+    }
+    return createMaintenanceRemindersCheck(resolvedInput.definition, resolvedInput.entries);
+}
+function createMaintenanceRemindersCheck(definition, entries) {
     return defineCheck({
-        checkId: MAINTENANCE_REMINDERS_CHECK_ID,
-        displayName: "Maintenance reminders",
-        execution: executeMaintenanceReminders,
+        ...definition,
+        execute: executeMaintenanceReminders,
         parseData: parseMaintenanceRemindersData,
-        preflight: (options) => validMaintenanceReminderOptions(options)
+        prepare: (options) => validMaintenanceReminderOptions(options)
             ? { status: "success", preparedOptions: options }
             : {
                 status: "failure",
@@ -72,9 +48,25 @@ export function maintenanceReminders(entries) {
         options: {
             entries,
             git: { executable: "git" }
-        },
-        visibility: "attention"
+        }
+    });
+}
+function isMaintenanceReminderEntries(input) {
+    return Array.isArray(input);
+}
+function resolveMaintenanceRemindersInput(input) {
+    const resolved = resolvePackageCheckAuthoringInput(input, ["entries"], {
+        checkId: MAINTENANCE_REMINDERS_CHECK_ID,
+        displayName: "Maintenance reminders",
+        omitQuietPassedRow: true
     });
+    if (resolved === undefined)
+        return undefined;
+    const entries = resolved.domainOptions.entries;
+    if (!Array.isArray(entries))
+        return undefined;
+    const reminderEntries = entries;
+    return Object.freeze({ definition: resolved.definition, entries: reminderEntries });
 }
 /** 在普通对象组合后验证完整的选项形状。 */
 export function validMaintenanceReminderOptions(value) {

package/dist/esm/package-checks/maintenance-reminders/maintenance-reminders.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"maintenance-reminders.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/maintenance-reminders.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  defineCheck,\n  type CheckExecutionContext,\n  type CheckResult,\n  type TypedCheckWithOptions\n} from \"../../check/check.ts\";\nimport {\n  MAINTENANCE_REMINDER_UNAVAILABLE_REASON,\n  parseMaintenanceRemindersData,\n  type MaintenanceReminderAssessment,\n  type MaintenanceRemindersFinalData\n} from \"./final-data.ts\";\nimport { runGit } from \"./maintenance-support.ts\";\nimport { exactRecord, validEntries, validGit } from \"./options-validation.ts\";\nimport {\n  completedResult,\n  reminderEvaluation,\n  unavailableAssessment,\n  unavailableHistory,\n  unavailableResult\n} from \"./assessment-results.ts\";\nimport { measureReminder, parseCommitId, parseFirstParentHistory } from \"./measurement.ts\";\n\nexport const MAINTENANCE_REMINDERS_CHECK_ID = \"maintenance-reminders\";\n\nconst MAINTENANCE_REMINDER_OPTION_KEYS: readonly string[] = [\"entries\", \"git\"];\nconst WHOLE_CHECK_UNAVAILABLE_CODE = Object.freeze({\n  invalidOptions: \"invalid-options\",\n  executionCancelled: \"execution-cancelled\",\n  internalFailure: \"maintenance-reminders-internal-failure\"\n});\n\n/** 一项维护提醒的项目政策输入。 */\nexport interface MaintenanceReminder {\n  /** 在同一次构造函数调用中唯一的小写短横线命名局部标识。 */\n  readonly id: string;\n  /** 维护者在完成真实复核后手动推进的不可变完整 Git commit ID。 */\n  readonly baseCommit: string;\n  /** 超过任一已配置上限时触发该提醒。 */\n  readonly limits: Readonly<{\n    /** 从基线到 `HEAD` 的 `first-parent` 提交数上限。 */\n    readonly commits?: number;\n    /** 从基线到 `HEAD` 的累计 Git `numstat` 增加行加删除行上限。 */\n    readonly changedLines?: number;\n  }>;\n  /** 到期或无法评估时展示给人的非空提醒正文。 */\n  readonly message: string;\n  /** 省略时只提示；`enforcing` 会使到期或不可测量的条目令所属 Check 失败。 */\n  readonly mode?: \"advisory\" | \"enforcing\";\n}\n\n/** `maintenanceReminders` 生成且完全由 Check 持有的选项。 */\nexport interface MaintenanceReminderOptions {\n  /** 保留作者声明顺序的提醒政策条目。 */\n  readonly entries: readonly MaintenanceReminder[];\n  /** 执行已提交历史测量的 Git 可执行文件。 */\n  readonly git: Readonly<{\n    readonly executable: string;\n  }>;\n}\n\n/** `maintenance-reminders` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type MaintenanceRemindersUnavailableCode =\n  (typeof WHOLE_CHECK_UNAVAILABLE_CODE)[keyof typeof WHOLE_CHECK_UNAVAILABLE_CODE];\nexport type FirstParentHistoryUnavailableReason =\n  | typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryInvalid\n  | typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryUnavailable\n  | typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headInvalid\n  | typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headUnavailable;\n\nexport type ReminderEvaluation = Readonly<{\n  readonly assessment: MaintenanceReminderAssessment;\n  readonly message: string;\n}>;\n\nexport type GitCommandResult =\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"failed\" }>\n  | Readonly<{ readonly kind: \"succeeded\"; readonly stdout: string }>;\n\nexport type FirstParentHistory = Readonly<{\n  readonly commits: readonly string[];\n  readonly headCommit: string;\n}>;\n\nexport type FirstParentHistoryResolution =\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"unavailable\"; readonly reason: FirstParentHistoryUnavailableReason }>\n  | Readonly<{ readonly kind: \"succeeded\"; readonly value: FirstParentHistory }>;\n\nexport type ReminderMeasurement =\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"succeeded\"; readonly value: ReminderEvaluation }>;\n\n/**\n * 创建一个固定 ID 的普通 Check，并在其局部最终数据中评估多条维护提醒。\n *\n * @remarks 构造函数只接收项目无法可靠推断的提醒政策；它补齐 Git 可执行文件、身份、可见性和直接执行逻辑。返回值仍是普通 Check，可按现有原生对象组合规则替换完整 `options` 分支。\n * @example 创建一个单一 Check 的维护提醒\n * ```ts\n * import { defineConfig, maintenanceReminders, run } from \"@zxyycom/vibe-check\";\n *\n * // 下列 baseCommit 都是示例占位值；实际使用时，每条都必须替换为该提醒最近一次真实复核对应的完整 commit ID。\n * const maintenance = maintenanceReminders([\n *   {\n *     id: \"documentation-review\",\n *     baseCommit: \"0123456789abcdef0123456789abcdef01234567\",\n *     limits: { commits: 40, changedLines: 2_000 },\n *     message: \"Review the documentation structure after this body of change.\"\n *   },\n *   {\n *     id: \"optimization-audit\",\n *     baseCommit: \"89abcdef0123456789abcdef0123456789abcdef\",\n *     limits: { commits: 80 },\n *     message: \"Audit optimization quality before this becomes older.\",\n *     mode: \"enforcing\"\n *   }\n * ]);\n *\n * const definition = defineConfig({\n *   checks: [maintenance],\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 * ```\n */\nexport function maintenanceReminders(\n  entries: readonly MaintenanceReminder[]\n): TypedCheckWithOptions<\n  typeof MAINTENANCE_REMINDERS_CHECK_ID,\n  MaintenanceReminderOptions,\n  typeof parseMaintenanceRemindersData\n> {\n  return defineCheck({\n    checkId: MAINTENANCE_REMINDERS_CHECK_ID,\n    displayName: \"Maintenance reminders\",\n    execution: executeMaintenanceReminders,\n    parseData: parseMaintenanceRemindersData,\n    preflight: (options) =>\n      validMaintenanceReminderOptions(options)\n        ? { status: \"success\", preparedOptions: options }\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                  \"maintenanceReminders options are invalid; recreate the Check with maintenanceReminders(entries) or restore its complete resolved options.\"\n              }\n            ]\n          },\n    options: {\n      entries,\n      git: { executable: \"git\" }\n    },\n    visibility: \"attention\"\n  });\n}\n\n/** 在普通对象组合后验证完整的选项形状。 */\nexport function validMaintenanceReminderOptions(\n  value: unknown\n): value is MaintenanceReminderOptions {\n  const options = exactRecord(value, MAINTENANCE_REMINDER_OPTION_KEYS);\n  return options !== undefined && validEntries(options.entries) && validGit(options.git);\n}\n\nasync function executeMaintenanceReminders(\n  context: CheckExecutionContext<MaintenanceReminderOptions>\n): Promise<CheckResult<MaintenanceRemindersFinalData>> {\n  if (!validMaintenanceReminderOptions(context.options))\n    return unavailableResult(\"invalid-options\");\n  if (context.signal.aborted)\n    return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);\n\n  try {\n    const history = await resolveFirstParentHistory({\n      executable: context.options.git.executable,\n      projectRoot: context.project.root,\n      signal: context.signal\n    });\n    if (history.kind === \"cancelled\") {\n      return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);\n    }\n\n    if (history.kind === \"unavailable\") {\n      return completedResult(\n        context.options.entries.map((entry) =>\n          reminderEvaluation(entry, unavailableAssessment(entry, null, history.reason))\n        )\n      );\n    }\n\n    const evaluations: ReminderEvaluation[] = [];\n    for (const entry of context.options.entries) {\n      const measurement = await measureReminder({\n        entry,\n        executable: context.options.git.executable,\n        history: history.value,\n        projectRoot: context.project.root,\n        signal: context.signal\n      });\n      if (measurement.kind === \"cancelled\") {\n        return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);\n      }\n      evaluations.push(measurement.value);\n    }\n    return completedResult(evaluations);\n  } catch {\n    return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.internalFailure);\n  }\n}\n\nasync function resolveFirstParentHistory(input: {\n  readonly executable: string;\n  readonly projectRoot: string;\n  readonly signal: AbortSignal;\n}): Promise<FirstParentHistoryResolution> {\n  const head = await runGit({\n    args: [\"rev-parse\", \"--verify\", \"HEAD^{commit}\"],\n    executable: input.executable,\n    projectRoot: input.projectRoot,\n    signal: input.signal\n  });\n  if (head.kind === \"cancelled\") return head;\n  if (head.kind === \"failed\")\n    return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headUnavailable);\n\n  const headCommit = parseCommitId(head.stdout);\n  if (headCommit === null)\n    return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headInvalid);\n\n  const history = await runGit({\n    args: [\"rev-list\", \"--first-parent\", \"HEAD\"],\n    executable: input.executable,\n    projectRoot: input.projectRoot,\n    signal: input.signal\n  });\n  if (history.kind === \"cancelled\") return history;\n  if (history.kind === \"failed\") {\n    return unavailableHistory(\n      MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryUnavailable\n    );\n  }\n\n  const firstParentHistory = parseFirstParentHistory(history.stdout, headCommit);\n  if (firstParentHistory === undefined) {\n    return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryInvalid);\n  }\n\n  return {\n    kind: \"succeeded\",\n    value: firstParentHistory\n  };\n}\n"]}
+{"version":3,"file":"maintenance-reminders.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/maintenance-reminders.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  defineCheck,\n  type CheckExecutionContext,\n  type CheckResult,\n  type TypedCheckWithOptions\n} from \"../../check/check.ts\";\nimport {\n  resolvePackageCheckAuthoringInput,\n  type PackageCheckAuthoringOptions,\n  type PackageCheckIdentityInput\n} from \"../check-authoring.ts\";\nimport {\n  MAINTENANCE_REMINDER_UNAVAILABLE_REASON,\n  parseMaintenanceRemindersData,\n  type MaintenanceReminderAssessment,\n  type MaintenanceRemindersFinalData\n} from \"./final-data.ts\";\nimport { runGit } from \"./maintenance-support.ts\";\nimport { exactRecord, validEntries, validGit } from \"./options-validation.ts\";\nimport {\n  completedResult,\n  reminderEvaluation,\n  unavailableAssessment,\n  unavailableHistory,\n  unavailableResult\n} from \"./assessment-results.ts\";\nimport { measureReminder, parseCommitId, parseFirstParentHistory } from \"./measurement.ts\";\n\nexport const MAINTENANCE_REMINDERS_CHECK_ID = \"maintenance-reminders\";\n\nconst MAINTENANCE_REMINDER_OPTION_KEYS: readonly string[] = [\"entries\", \"git\"];\nconst WHOLE_CHECK_UNAVAILABLE_CODE = Object.freeze({\n  invalidOptions: \"invalid-options\",\n  executionCancelled: \"execution-cancelled\",\n  internalFailure: \"maintenance-reminders-internal-failure\"\n});\n\n/** 一项维护提醒的项目政策输入。 */\nexport interface MaintenanceReminder {\n  /** 在同一次构造函数调用中唯一的小写短横线命名局部标识。 */\n  readonly id: string;\n  /** 维护者在完成真实复核后手动推进的不可变完整 Git commit ID。 */\n  readonly baseCommit: string;\n  /** 超过任一已配置上限时触发该提醒。 */\n  readonly limits: Readonly<{\n    /** 从基线到 `HEAD` 的 `first-parent` 提交数上限。 */\n    readonly commits?: number;\n    /** 从基线到 `HEAD` 的累计 Git `numstat` 增加行加删除行上限。 */\n    readonly changedLines?: number;\n  }>;\n  /** 到期或无法评估时展示给人的非空提醒正文。 */\n  readonly message: string;\n  /** 省略时只提示；`enforcing` 会使到期或不可测量的条目令所属 Check 失败。 */\n  readonly mode?: \"advisory\" | \"enforcing\";\n}\n\n/** `maintenanceReminders` 生成且完全由 Check 持有的选项。 */\nexport interface MaintenanceReminderOptions {\n  /** 保留作者声明顺序的提醒政策条目。 */\n  readonly entries: readonly MaintenanceReminder[];\n  /** 执行已提交历史测量的 Git 可执行文件。 */\n  readonly git: Readonly<{\n    readonly executable: string;\n  }>;\n}\n\n/** `maintenanceReminders` 的对象式构造输入，组合提醒政策与项目 Check 声明。 */\nexport interface MaintenanceRemindersInput<\n  Id extends string = string\n> extends PackageCheckAuthoringOptions<Id> {\n  /** 保留作者声明顺序的提醒政策条目。 */\n  readonly entries: readonly MaintenanceReminder[];\n}\n\n/** `maintenance-reminders` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type MaintenanceRemindersUnavailableCode =\n  (typeof WHOLE_CHECK_UNAVAILABLE_CODE)[keyof typeof WHOLE_CHECK_UNAVAILABLE_CODE];\nexport type FirstParentHistoryUnavailableReason =\n  | typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryInvalid\n  | typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryUnavailable\n  | typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headInvalid\n  | typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headUnavailable;\n\nexport type ReminderEvaluation = Readonly<{\n  readonly assessment: MaintenanceReminderAssessment;\n  readonly message: string;\n}>;\n\nexport type GitCommandResult =\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"failed\" }>\n  | Readonly<{ readonly kind: \"succeeded\"; readonly stdout: string }>;\n\nexport type FirstParentHistory = Readonly<{\n  readonly commits: readonly string[];\n  readonly headCommit: string;\n}>;\n\nexport type FirstParentHistoryResolution =\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"unavailable\"; readonly reason: FirstParentHistoryUnavailableReason }>\n  | Readonly<{ readonly kind: \"succeeded\"; readonly value: FirstParentHistory }>;\n\nexport type ReminderMeasurement =\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"succeeded\"; readonly value: ReminderEvaluation }>;\n\n/**\n * 创建一个维护提醒普通 Check，并在其局部最终数据中评估多条维护提醒。\n *\n * @remarks 传入 entries 数组会保留默认 identity；对象输入可同时声明项目 Check 字段。构造函数补齐 Git 可执行文件、默认展示和直接执行逻辑，返回值仍是普通 Check，可按现有原生对象组合规则替换完整 `options` 分支。\n * @example 创建一个单一 Check 的维护提醒\n * ```ts\n * import { defineConfig, maintenanceReminders, run } from \"@zxyycom/vibe-check\";\n *\n * // 下列 baseCommit 都是示例占位值；实际使用时，每条都必须替换为该提醒最近一次真实复核对应的完整 commit ID。\n * const maintenance = maintenanceReminders([\n *   {\n *     id: \"documentation-review\",\n *     baseCommit: \"0123456789abcdef0123456789abcdef01234567\",\n *     limits: { commits: 40, changedLines: 2_000 },\n *     message: \"Review the documentation structure after this body of change.\"\n *   },\n *   {\n *     id: \"optimization-audit\",\n *     baseCommit: \"89abcdef0123456789abcdef0123456789abcdef\",\n *     limits: { commits: 80 },\n *     message: \"Audit optimization quality before this becomes older.\",\n *     mode: \"enforcing\"\n *   }\n * ]);\n *\n * const definition = defineConfig({\n *   checks: [maintenance],\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 * ```\n */\nexport function maintenanceReminders(\n  entries: readonly MaintenanceReminder[]\n): TypedCheckWithOptions<\n  typeof MAINTENANCE_REMINDERS_CHECK_ID,\n  MaintenanceReminderOptions,\n  typeof parseMaintenanceRemindersData\n>;\nexport function maintenanceReminders(\n  input: MaintenanceRemindersInput<typeof MAINTENANCE_REMINDERS_CHECK_ID>\n): TypedCheckWithOptions<\n  typeof MAINTENANCE_REMINDERS_CHECK_ID,\n  MaintenanceReminderOptions,\n  typeof parseMaintenanceRemindersData\n>;\nexport function maintenanceReminders<const Id extends string>(\n  input: MaintenanceRemindersInput<Id> & PackageCheckIdentityInput<Id>\n): TypedCheckWithOptions<Id, MaintenanceReminderOptions, typeof parseMaintenanceRemindersData>;\nexport function maintenanceReminders(\n  input: MaintenanceRemindersInput\n): TypedCheckWithOptions<string, MaintenanceReminderOptions, typeof parseMaintenanceRemindersData>;\nexport function maintenanceReminders(\n  input: readonly MaintenanceReminder[] | MaintenanceRemindersInput\n): TypedCheckWithOptions<string, MaintenanceReminderOptions, typeof parseMaintenanceRemindersData> {\n  if (isMaintenanceReminderEntries(input)) {\n    return createMaintenanceRemindersCheck(\n      {\n        checkId: MAINTENANCE_REMINDERS_CHECK_ID,\n        displayName: \"Maintenance reminders\",\n        omitQuietPassedRow: true\n      },\n      input\n    );\n  }\n  const resolvedInput = resolveMaintenanceRemindersInput(input);\n  if (resolvedInput === undefined) {\n    throw new TypeError(\n      \"maintenanceReminders input must be entries or a closed { entries, checkId?, displayName?, enabledByFlags?, checks?, dependsOn?, observes?, maxParallel?, admissionPriority?, mutex?, resourceClaims?, omitQuietPassedRow? } object\"\n    );\n  }\n  return createMaintenanceRemindersCheck(resolvedInput.definition, resolvedInput.entries);\n}\n\ntype PackageCheckDefinition<Id extends string> = NonNullable<\n  ReturnType<typeof resolvePackageCheckAuthoringInput<Id>>\n>[\"definition\"];\n\nfunction createMaintenanceRemindersCheck<Id extends string>(\n  definition: PackageCheckDefinition<Id>,\n  entries: readonly MaintenanceReminder[]\n): TypedCheckWithOptions<Id, MaintenanceReminderOptions, typeof parseMaintenanceRemindersData> {\n  return defineCheck({\n    ...definition,\n    execute: executeMaintenanceReminders,\n    parseData: parseMaintenanceRemindersData,\n    prepare: (options) =>\n      validMaintenanceReminderOptions(options)\n        ? { status: \"success\", preparedOptions: options }\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                  \"maintenanceReminders options are invalid; recreate the Check with maintenanceReminders(entries) or restore its complete resolved options.\"\n              }\n            ]\n          },\n    options: {\n      entries,\n      git: { executable: \"git\" }\n    }\n  });\n}\n\nfunction isMaintenanceReminderEntries(\n  input: readonly MaintenanceReminder[] | MaintenanceRemindersInput\n): input is readonly MaintenanceReminder[] {\n  return Array.isArray(input);\n}\n\nfunction resolveMaintenanceRemindersInput<Id extends string>(\n  input: MaintenanceRemindersInput<Id>\n):\n  | Readonly<{\n      readonly definition: PackageCheckDefinition<Id>;\n      readonly entries: readonly MaintenanceReminder[];\n    }>\n  | undefined {\n  const resolved = resolvePackageCheckAuthoringInput(input, [\"entries\"], {\n    checkId: MAINTENANCE_REMINDERS_CHECK_ID,\n    displayName: \"Maintenance reminders\",\n    omitQuietPassedRow: true\n  });\n  if (resolved === undefined) return undefined;\n  const entries = resolved.domainOptions.entries;\n  if (!Array.isArray(entries)) return undefined;\n  const reminderEntries: readonly MaintenanceReminder[] = entries;\n  return Object.freeze({ definition: resolved.definition, entries: reminderEntries });\n}\n\n/** 在普通对象组合后验证完整的选项形状。 */\nexport function validMaintenanceReminderOptions(\n  value: unknown\n): value is MaintenanceReminderOptions {\n  const options = exactRecord(value, MAINTENANCE_REMINDER_OPTION_KEYS);\n  return options !== undefined && validEntries(options.entries) && validGit(options.git);\n}\n\nasync function executeMaintenanceReminders(\n  context: CheckExecutionContext<MaintenanceReminderOptions>\n): Promise<CheckResult<MaintenanceRemindersFinalData>> {\n  if (!validMaintenanceReminderOptions(context.options))\n    return unavailableResult(\"invalid-options\");\n  if (context.signal.aborted)\n    return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);\n\n  try {\n    const history = await resolveFirstParentHistory({\n      executable: context.options.git.executable,\n      projectRoot: context.project.root,\n      signal: context.signal\n    });\n    if (history.kind === \"cancelled\") {\n      return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);\n    }\n\n    if (history.kind === \"unavailable\") {\n      return completedResult(\n        context.options.entries.map((entry) =>\n          reminderEvaluation(entry, unavailableAssessment(entry, null, history.reason))\n        )\n      );\n    }\n\n    const evaluations: ReminderEvaluation[] = [];\n    for (const entry of context.options.entries) {\n      const measurement = await measureReminder({\n        entry,\n        executable: context.options.git.executable,\n        history: history.value,\n        projectRoot: context.project.root,\n        signal: context.signal\n      });\n      if (measurement.kind === \"cancelled\") {\n        return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);\n      }\n      evaluations.push(measurement.value);\n    }\n    return completedResult(evaluations);\n  } catch {\n    return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.internalFailure);\n  }\n}\n\nasync function resolveFirstParentHistory(input: {\n  readonly executable: string;\n  readonly projectRoot: string;\n  readonly signal: AbortSignal;\n}): Promise<FirstParentHistoryResolution> {\n  const head = await runGit({\n    args: [\"rev-parse\", \"--verify\", \"HEAD^{commit}\"],\n    executable: input.executable,\n    projectRoot: input.projectRoot,\n    signal: input.signal\n  });\n  if (head.kind === \"cancelled\") return head;\n  if (head.kind === \"failed\")\n    return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headUnavailable);\n\n  const headCommit = parseCommitId(head.stdout);\n  if (headCommit === null)\n    return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headInvalid);\n\n  const history = await runGit({\n    args: [\"rev-list\", \"--first-parent\", \"HEAD\"],\n    executable: input.executable,\n    projectRoot: input.projectRoot,\n    signal: input.signal\n  });\n  if (history.kind === \"cancelled\") return history;\n  if (history.kind === \"failed\") {\n    return unavailableHistory(\n      MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryUnavailable\n    );\n  }\n\n  const firstParentHistory = parseFirstParentHistory(history.stdout, headCommit);\n  if (firstParentHistory === undefined) {\n    return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryInvalid);\n  }\n\n  return {\n    kind: \"succeeded\",\n    value: firstParentHistory\n  };\n}\n"]}

package/dist/esm/package-checks/maintenance-reminders/maintenance-support.mjs

@@ -41,7 +41,9 @@ export async function runGit(input) {
             }
             stdout += text;
         });
-        child.once("error", () => settle(input.signal.aborted ? { kind: "cancelled" } : { kind: "failed" }));
+        child.once("error", () => {
+            settle(input.signal.aborted ? { kind: "cancelled" } : { kind: "failed" });
+        });
         child.once("close", (status) => {
             if (input.signal.aborted) {
                 settle({ kind: "cancelled" });

package/dist/esm/package-checks/maintenance-reminders/maintenance-support.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"maintenance-support.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/maintenance-support.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\n\nimport type { GitCommandResult } from \"./maintenance-reminders.ts\";\n\nconst MAX_GIT_OUTPUT_BYTES = 64 * 1024 * 1024;\n\nexport async function runGit(input: {\n  readonly args: readonly string[];\n  readonly executable: string;\n  readonly projectRoot: string;\n  readonly signal: AbortSignal;\n}): Promise<GitCommandResult> {\n  if (input.signal.aborted) return { kind: \"cancelled\" };\n\n  return new Promise((resolve) => {\n    let settled = false;\n    let outputBytes = 0;\n    let stdout = \"\";\n    let overflowed = false;\n    let child: ReturnType<typeof spawn>;\n\n    const settle = (result: GitCommandResult): void => {\n      if (settled) return;\n      settled = true;\n      input.signal.removeEventListener(\"abort\", abort);\n      resolve(result);\n    };\n    const abort = (): void => {\n      child.kill(\"SIGTERM\");\n    };\n\n    try {\n      child = spawn(input.executable, input.args, {\n        cwd: input.projectRoot,\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n        windowsHide: true\n      });\n    } catch {\n      settle({ kind: \"failed\" });\n      return;\n    }\n\n    input.signal.addEventListener(\"abort\", abort, { once: true });\n    child.stdout?.on(\"data\", (chunk: Buffer | string) => {\n      const text = String(chunk);\n      outputBytes += Buffer.byteLength(text);\n      if (outputBytes > MAX_GIT_OUTPUT_BYTES) {\n        overflowed = true;\n        child.kill(\"SIGTERM\");\n        return;\n      }\n      stdout += text;\n    });\n    child.once(\"error\", () =>\n      settle(input.signal.aborted ? { kind: \"cancelled\" } : { kind: \"failed\" })\n    );\n    child.once(\"close\", (status) => {\n      if (input.signal.aborted) {\n        settle({ kind: \"cancelled\" });\n      } else if (overflowed || status !== 0) {\n        settle({ kind: \"failed\" });\n      } else {\n        settle({ kind: \"succeeded\", stdout });\n      }\n    });\n  });\n}\n"]}
+{"version":3,"file":"maintenance-support.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/maintenance-support.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from \"node:child_process\";\n\nimport type { GitCommandResult } from \"./maintenance-reminders.ts\";\n\nconst MAX_GIT_OUTPUT_BYTES = 64 * 1024 * 1024;\n\nexport async function runGit(input: {\n  readonly args: readonly string[];\n  readonly executable: string;\n  readonly projectRoot: string;\n  readonly signal: AbortSignal;\n}): Promise<GitCommandResult> {\n  if (input.signal.aborted) return { kind: \"cancelled\" };\n\n  return new Promise((resolve) => {\n    let settled = false;\n    let outputBytes = 0;\n    let stdout = \"\";\n    let overflowed = false;\n    let child: ReturnType<typeof spawn>;\n\n    const settle = (result: GitCommandResult): void => {\n      if (settled) return;\n      settled = true;\n      input.signal.removeEventListener(\"abort\", abort);\n      resolve(result);\n    };\n    const abort = (): void => {\n      child.kill(\"SIGTERM\");\n    };\n\n    try {\n      child = spawn(input.executable, input.args, {\n        cwd: input.projectRoot,\n        stdio: [\"ignore\", \"pipe\", \"ignore\"],\n        windowsHide: true\n      });\n    } catch {\n      settle({ kind: \"failed\" });\n      return;\n    }\n\n    input.signal.addEventListener(\"abort\", abort, { once: true });\n    child.stdout?.on(\"data\", (chunk: Buffer | string) => {\n      const text = String(chunk);\n      outputBytes += Buffer.byteLength(text);\n      if (outputBytes > MAX_GIT_OUTPUT_BYTES) {\n        overflowed = true;\n        child.kill(\"SIGTERM\");\n        return;\n      }\n      stdout += text;\n    });\n    child.once(\"error\", () => {\n      settle(input.signal.aborted ? { kind: \"cancelled\" } : { kind: \"failed\" });\n    });\n    child.once(\"close\", (status) => {\n      if (input.signal.aborted) {\n        settle({ kind: \"cancelled\" });\n      } else if (overflowed || status !== 0) {\n        settle({ kind: \"failed\" });\n      } else {\n        settle({ kind: \"succeeded\", stdout });\n      }\n    });\n  });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/default-check.mjs

@@ -1,47 +1,33 @@
 import { defineCheck } from "../../check/check.mjs";
+import { resolvePackageCheckAuthoringInput } from "../check-authoring.mjs";
 import { MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION, executeMarkdownLinkValidation } from "./execution.mjs";
 import { parseMarkdownLinkValidationData } from "./final-data.mjs";
 import { resolveMarkdownLinkValidationOptions } from "./options-resolution.mjs";
 import { validMarkdownLinkValidationOptions } from "./options-validation.mjs";
-/**
- * 使用可省略的 source、target 与 work-limit policy 构造离线 Markdown 引用 Check。
- *
- * @param options - 省略字段由 package 补齐；files 数组是完整替换值，limits fields 可分别省略；cache 省略时关闭，启用时由调用方提供 absolute、可信且可删除的 directory，其中本 Check 只维护一个 source-derived JSONL local state；调用方负责容量和删除，cache 不可用不改变 Check 结果。
- * @returns 固定 `markdown-link-validation` identity、完整冻结 options、parser 与执行逻辑。
- * @throws {TypeError} input 含未知字段、非法 target policy、cache branch/directory 或非法 work limit 时抛出。
- * @example 离线 Markdown 本地链接完整性
- * ```ts
- * import { defineConfig, markdownLinkValidation, run } from "@zxyycom/vibe-check";
- *
- * // 此调用方自有目录是 absolute、可删除的，并且可能保存 source-derived parse facts。
- * const cacheDirectory = new URL(".vibe-check/markdown-link-parse-cache", import.meta.url).pathname;
- * const definition = defineConfig({
- *   checks: [
- *     markdownLinkValidation({
- *       cache: { enabled: true, directory: cacheDirectory }
- *     })
- *   ],
- *   outputs: {
- *     diagnosticLogging: { enabled: false },
- *     machinePublication: { enabled: false },
- *     progressRendering: { enabled: false }
- *   }
- * });
- *
- * const result = await run(definition);
- * if (result.kind !== "completed") throw new Error(`Run did not complete: ${result.kind}`);
- * ```
- */
 export function markdownLinkValidation(options = {}) {
-    const resolvedOptions = resolveMarkdownLinkValidationOptions(options);
+    const input = resolvePackageCheckAuthoringInput(options, [
+        "files",
+        "findingPolicy",
+        "requireExistingTargets",
+        "validateSameDocumentAnchors",
+        "validateCrossDocumentAnchors",
+        "rootExternalTargetMode",
+        "requireNonEmptyDirectories",
+        "limits",
+        "cache"
+    ], MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION);
+    if (input === undefined) {
+        throw new TypeError("markdownLinkValidation options must match the documented closed policy");
+    }
+    const resolvedOptions = resolveMarkdownLinkValidationOptions(input.domainOptions);
     if (resolvedOptions === undefined) {
         throw new TypeError("markdownLinkValidation options must match the documented closed policy");
     }
     return defineCheck({
-        ...MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION,
-        execution: executeMarkdownLinkValidation,
+        ...input.definition,
+        execute: executeMarkdownLinkValidation,
         parseData: parseMarkdownLinkValidationData,
-        preflight: (preparedOptions) => validMarkdownLinkValidationOptions(preparedOptions)
+        prepare: (preparedOptions) => validMarkdownLinkValidationOptions(preparedOptions)
             ? { status: "success", preparedOptions }
             : {
                 status: "failure",

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

@@ -1 +1 @@
-{"version":3,"file":"default-check.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/default-check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA8B,MAAM,sBAAsB,CAAC;AAC/E,OAAO,EACL,yCAAyC,EACzC,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAKlE,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAO,GAAkC,EAAE;IAM3C,MAAM,eAAe,GAAG,oCAAoC,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CAAC,wEAAwE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,GAAG,yCAAyC;QAC5C,SAAS,EAAE,6BAA6B;QACxC,SAAS,EAAE,+BAA+B;QAC1C,SAAS,EAAE,CAAC,eAAe,EAAE,EAAE,CAC7B,kCAAkC,CAAC,eAAe,CAAC;YACjD,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,+IAA+I;qBAClJ;iBACF;aACF;QACP,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { defineCheck, type TypedCheckWithOptions } from \"../../check/check.ts\";\nimport {\n  MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION,\n  executeMarkdownLinkValidation\n} from \"./execution.ts\";\nimport { parseMarkdownLinkValidationData } from \"./final-data.ts\";\nimport type {\n  MarkdownLinkValidationOptions,\n  ResolvedMarkdownLinkValidationOptions\n} from \"./options.ts\";\nimport { resolveMarkdownLinkValidationOptions } from \"./options-resolution.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\n/**\n * 使用可省略的 source、target 与 work-limit policy 构造离线 Markdown 引用 Check。\n *\n * @param options - 省略字段由 package 补齐；files 数组是完整替换值，limits fields 可分别省略；cache 省略时关闭，启用时由调用方提供 absolute、可信且可删除的 directory，其中本 Check 只维护一个 source-derived JSONL local state；调用方负责容量和删除，cache 不可用不改变 Check 结果。\n * @returns 固定 `markdown-link-validation` identity、完整冻结 options、parser 与执行逻辑。\n * @throws {TypeError} input 含未知字段、非法 target policy、cache branch/directory 或非法 work limit 时抛出。\n * @example 离线 Markdown 本地链接完整性\n * ```ts\n * import { defineConfig, markdownLinkValidation, run } from \"@zxyycom/vibe-check\";\n *\n * // 此调用方自有目录是 absolute、可删除的，并且可能保存 source-derived parse facts。\n * const cacheDirectory = new URL(\".vibe-check/markdown-link-parse-cache\", import.meta.url).pathname;\n * const definition = defineConfig({\n *   checks: [\n *     markdownLinkValidation({\n *       cache: { enabled: true, directory: cacheDirectory }\n *     })\n *   ],\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 * ```\n */\nexport function markdownLinkValidation(\n  options: MarkdownLinkValidationOptions = {}\n): TypedCheckWithOptions<\n  \"markdown-link-validation\",\n  ResolvedMarkdownLinkValidationOptions,\n  typeof parseMarkdownLinkValidationData\n> {\n  const resolvedOptions = resolveMarkdownLinkValidationOptions(options);\n  if (resolvedOptions === undefined) {\n    throw new TypeError(\"markdownLinkValidation options must match the documented closed policy\");\n  }\n  return defineCheck({\n    ...MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION,\n    execution: executeMarkdownLinkValidation,\n    parseData: parseMarkdownLinkValidationData,\n    preflight: (preparedOptions) =>\n      validMarkdownLinkValidationOptions(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                  \"markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options.\"\n              }\n            ]\n          },\n    options: resolvedOptions\n  });\n}\n"]}
+{"version":3,"file":"default-check.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/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,EACL,yCAAyC,EACzC,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAKlE,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAoD7E,MAAM,UAAU,sBAAsB,CACpC,OAAO,GAAkC,EAAE;IAM3C,MAAM,KAAK,GAAG,iCAAiC,CAC7C,OAAO,EACP;QACE,OAAO;QACP,eAAe;QACf,wBAAwB;QACxB,6BAA6B;QAC7B,8BAA8B;QAC9B,wBAAwB;QACxB,4BAA4B;QAC5B,QAAQ;QACR,OAAO;KACR,EACD,yCAAyC,CAC1C,CAAC;IACF,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAI,SAAS,CAAC,wEAAwE,CAAC,CAAC;IAChG,CAAC;IACD,MAAM,eAAe,GAAG,oCAAoC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAClF,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CAAC,wEAAwE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,GAAG,KAAK,CAAC,UAAU;QACnB,OAAO,EAAE,6BAA6B;QACtC,SAAS,EAAE,+BAA+B;QAC1C,OAAO,EAAE,CAAC,eAAe,EAAE,EAAE,CAC3B,kCAAkC,CAAC,eAAe,CAAC;YACjD,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,+IAA+I;qBAClJ;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 {\n  MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION,\n  executeMarkdownLinkValidation\n} from \"./execution.ts\";\nimport { parseMarkdownLinkValidationData } from \"./final-data.ts\";\nimport type {\n  MarkdownLinkValidationOptions,\n  ResolvedMarkdownLinkValidationOptions\n} from \"./options.ts\";\nimport { resolveMarkdownLinkValidationOptions } from \"./options-resolution.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\n/**\n * 使用可省略的 source、target 与 work-limit policy 构造离线 Markdown 引用 Check。\n *\n * @param options - 省略字段由 package 补齐；files 数组是完整替换值，limits fields 可分别省略；cache 省略时关闭，启用时由调用方提供 absolute、可信且可删除的 directory，其中本 Check 只维护一个 source-derived JSONL local state；调用方负责容量和删除，cache 不可用不改变 Check 结果。\n * @returns 固定 `markdown-link-validation` identity、完整冻结 options、parser 与执行逻辑。\n * @throws {TypeError} input 含未知字段、非法 target policy、cache branch/directory 或非法 work limit 时抛出。\n * @example 离线 Markdown 本地链接完整性\n * ```ts\n * import { defineConfig, markdownLinkValidation, run } from \"@zxyycom/vibe-check\";\n *\n * // 此调用方自有目录是 absolute、可删除的，并且可能保存 source-derived parse facts。\n * const cacheDirectory = new URL(\".vibe-check/markdown-link-parse-cache\", import.meta.url).pathname;\n * const definition = defineConfig({\n *   checks: [\n *     markdownLinkValidation({\n *       cache: { enabled: true, directory: cacheDirectory }\n *     })\n *   ],\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 * ```\n */\nexport function markdownLinkValidation(\n  options?: MarkdownLinkValidationOptions<\"markdown-link-validation\">\n): TypedCheckWithOptions<\n  \"markdown-link-validation\",\n  ResolvedMarkdownLinkValidationOptions,\n  typeof parseMarkdownLinkValidationData\n>;\nexport function markdownLinkValidation<const Id extends string>(\n  options: MarkdownLinkValidationOptions<Id> & PackageCheckIdentityInput<Id>\n): TypedCheckWithOptions<\n  Id,\n  ResolvedMarkdownLinkValidationOptions,\n  typeof parseMarkdownLinkValidationData\n>;\nexport function markdownLinkValidation(\n  options: MarkdownLinkValidationOptions\n): TypedCheckWithOptions<\n  string,\n  ResolvedMarkdownLinkValidationOptions,\n  typeof parseMarkdownLinkValidationData\n>;\nexport function markdownLinkValidation(\n  options: MarkdownLinkValidationOptions = {}\n): TypedCheckWithOptions<\n  string,\n  ResolvedMarkdownLinkValidationOptions,\n  typeof parseMarkdownLinkValidationData\n> {\n  const input = resolvePackageCheckAuthoringInput(\n    options,\n    [\n      \"files\",\n      \"findingPolicy\",\n      \"requireExistingTargets\",\n      \"validateSameDocumentAnchors\",\n      \"validateCrossDocumentAnchors\",\n      \"rootExternalTargetMode\",\n      \"requireNonEmptyDirectories\",\n      \"limits\",\n      \"cache\"\n    ],\n    MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION\n  );\n  if (input === undefined) {\n    throw new TypeError(\"markdownLinkValidation options must match the documented closed policy\");\n  }\n  const resolvedOptions = resolveMarkdownLinkValidationOptions(input.domainOptions);\n  if (resolvedOptions === undefined) {\n    throw new TypeError(\"markdownLinkValidation options must match the documented closed policy\");\n  }\n  return defineCheck({\n    ...input.definition,\n    execute: executeMarkdownLinkValidation,\n    parseData: parseMarkdownLinkValidationData,\n    prepare: (preparedOptions) =>\n      validMarkdownLinkValidationOptions(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                  \"markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options.\"\n              }\n            ]\n          },\n    options: resolvedOptions\n  });\n}\n"]}

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

@@ -1,7 +1,7 @@
 import path from "node:path";
 import { collectProjectFiles } from "../project-files/collection.mjs";
 import { partitionProjectFilesByEligibility } from "../project-files/input-eligibility.mjs";
-import { appendCheckMessages } from "../../check/finding-presentation.mjs";
+import { appendCheckMessages } from "../../package-tools/finding-presentation/finding-presentation.mjs";
 import { createMarkdownLocalResolver } from "./local-resolver.mjs";
 import { markdownFindingMessages } from "./finding-messages.mjs";
 import { buildMarkdownInputRejectedRecord, buildMarkdownLinkRecordCandidate } from "./records.mjs";

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

@@ -1 +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 { appendCheckMessages } from \"../../check/finding-presentation.ts\";\nimport { createMarkdownLocalResolver, type MarkdownLocalResolver } from \"./local-resolver.ts\";\nimport type { MarkdownLinkValidationFinalData } from \"./final-data.ts\";\nimport { markdownFindingMessages } from \"./finding-messages.ts\";\nimport {\n  buildMarkdownInputRejectedRecord,\n  buildMarkdownLinkRecordCandidate,\n  type MarkdownLinkRecordCandidate\n} from \"./records.ts\";\nimport { settledMarkdownTraversalResult } from \"./traversal-result.ts\";\nimport {\n  markdownLinkUnavailableMessage,\n  type MarkdownLinkValidationUnavailableReason\n} from \"./unavailable-reasons.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\nexport type { MarkdownLinkValidationUnavailableReason } from \"./unavailable-reasons.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\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 { rejectedPaths, traversal, resolver } = prepared;\n\n  for (const candidate of traversal.candidates) {\n    context.records.report({ id: candidate.id }, candidate.data);\n  }\n  return appendCheckMessages(\n    settledMarkdownTraversalResult({\n      findingCount: traversal.candidates.length,\n      findingPolicy: context.options.findingPolicy,\n      occurrenceCount: traversal.occurrenceCount,\n      rejectedInputCount: rejectedPaths.length,\n      sourceFileCount: traversal.sourceFileCount,\n      targetReadCount: resolver.targetReadCount\n    }),\n    markdownFindingMessages(\n      traversal.candidates,\n      rejectedPaths,\n      context.options.findingPolicy === \"blocking\"\n    )\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 rejectedPaths: readonly string[];\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    context.options.cache,\n    context.signal\n  );\n  if (!created.ok) return result(unavailable(created.reason));\n  let prepared: PreparedMarkdownTraversal;\n  try {\n    prepared = await prepareCreatedMarkdownTraversal(context, created.resolver);\n  } finally {\n    await created.resolver.finalize();\n  }\n  return context.signal.aborted ? result(unavailable(\"cancelled\")) : prepared;\n}\n\nasync function prepareCreatedMarkdownTraversal(\n  context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>,\n  resolver: MarkdownLocalResolver\n): Promise<PreparedMarkdownTraversal> {\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,\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    rejectedPaths: sourceDiscovery.rejectedPaths,\n    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  // The Run's shared Scheduler owns cross-Check concurrency; this Check processes sources strictly in order.\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({\n        code: reason,\n        level: \"error\" as const,\n        message: markdownLinkUnavailableMessage(reason)\n      })\n    ])\n  });\n}\n"]}
+{"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 { appendCheckMessages } from \"../../package-tools/finding-presentation/finding-presentation.ts\";\nimport { createMarkdownLocalResolver, type MarkdownLocalResolver } from \"./local-resolver.ts\";\nimport type { MarkdownLinkValidationFinalData } from \"./final-data.ts\";\nimport { markdownFindingMessages } from \"./finding-messages.ts\";\nimport {\n  buildMarkdownInputRejectedRecord,\n  buildMarkdownLinkRecordCandidate,\n  type MarkdownLinkRecordCandidate\n} from \"./records.ts\";\nimport { settledMarkdownTraversalResult } from \"./traversal-result.ts\";\nimport {\n  markdownLinkUnavailableMessage,\n  type MarkdownLinkValidationUnavailableReason\n} from \"./unavailable-reasons.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\nexport type { MarkdownLinkValidationUnavailableReason } from \"./unavailable-reasons.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\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 { rejectedPaths, traversal, resolver } = prepared;\n\n  for (const candidate of traversal.candidates) {\n    context.records.report({ id: candidate.id }, candidate.data);\n  }\n  return appendCheckMessages(\n    settledMarkdownTraversalResult({\n      findingCount: traversal.candidates.length,\n      findingPolicy: context.options.findingPolicy,\n      occurrenceCount: traversal.occurrenceCount,\n      rejectedInputCount: rejectedPaths.length,\n      sourceFileCount: traversal.sourceFileCount,\n      targetReadCount: resolver.targetReadCount\n    }),\n    markdownFindingMessages(\n      traversal.candidates,\n      rejectedPaths,\n      context.options.findingPolicy === \"blocking\"\n    )\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 rejectedPaths: readonly string[];\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    context.options.cache,\n    context.signal\n  );\n  if (!created.ok) return result(unavailable(created.reason));\n  let prepared: PreparedMarkdownTraversal;\n  try {\n    prepared = await prepareCreatedMarkdownTraversal(context, created.resolver);\n  } finally {\n    await created.resolver.finalize();\n  }\n  return context.signal.aborted ? result(unavailable(\"cancelled\")) : prepared;\n}\n\nasync function prepareCreatedMarkdownTraversal(\n  context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>,\n  resolver: MarkdownLocalResolver\n): Promise<PreparedMarkdownTraversal> {\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,\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    rejectedPaths: sourceDiscovery.rejectedPaths,\n    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  // The Run's shared Scheduler owns cross-Check concurrency; this Check processes sources strictly in order.\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({\n        code: reason,\n        level: \"error\" as const,\n        message: markdownLinkUnavailableMessage(reason)\n      })\n    ])\n  });\n}\n"]}

package/dist/esm/package-checks/markdown-link-validation/finding-messages.mjs

@@ -1,4 +1,4 @@
-import { presentCheckFindings } from "../../check/finding-presentation.mjs";
+import { presentCheckFindings } from "../../package-tools/finding-presentation/finding-presentation.mjs";
 const PRESENTED_FINDING_LIMIT = 10;
 /** Projects completed Link findings without copying raw destinations into presentation. */
 export function markdownFindingMessages(candidates, rejectedPaths, blocking) {

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

@@ -1 +1 @@
-{"version":3,"file":"finding-messages.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/finding-messages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAG3E,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAMnC,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CACrC,UAAkD,EAClD,aAAgC,EAChC,QAAiB;IAEjB,MAAM,QAAQ,GAA+B;QAC3C,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,SAAS,EAAE,CAAC,CAAC;QACrF,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAyB,EAAE,IAAI,EAAE,CAAC,CAAC;KACzF,CAAC;IACF,OAAO,oBAAoB,CAAC;QAC1B,QAAQ;QACR,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,IAAI,OAAO,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACtC,OAAO,MAAM,CAAC,MAAM,CAAC;oBACnB,IAAI,EAAE,gBAAgB;oBACtB,KAAK,EAAE,SAAkB;oBACzB,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,sDAAsD;iBAC/E,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;YAC7E,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAE,SAAmB;gBAC3D,OAAO,EAAE,GAAG,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,cAAc,KAAK,MAAM,GAAG;aACjG,CAAC,CAAC;QACL,CAAC;QACD,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,CACpD,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC;gBAC3E,CAAC,CAAE,OAAiB;gBACpB,CAAC,CAAE,SAAmB;YACxB,OAAO,EAAE,GAAG,YAAY,yGAAyG;SAClI,CAAC;KACL,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage } from \"../../check/check.ts\";\nimport { presentCheckFindings } from \"../../check/finding-presentation.ts\";\nimport type { MarkdownLinkRecordCandidate } from \"./records.ts\";\n\nconst PRESENTED_FINDING_LIMIT = 10;\n\ntype PresentedMarkdownFinding =\n  | Readonly<{ readonly kind: \"link\"; readonly candidate: MarkdownLinkRecordCandidate }>\n  | Readonly<{ readonly kind: \"input-rejected\"; readonly path: string }>;\n\n/** Projects completed Link findings without copying raw destinations into presentation. */\nexport function markdownFindingMessages(\n  candidates: readonly MarkdownLinkRecordCandidate[],\n  rejectedPaths: readonly string[],\n  blocking: boolean\n): readonly CheckMessage[] {\n  const findings: PresentedMarkdownFinding[] = [\n    ...candidates.map((candidate) => Object.freeze({ kind: \"link\" as const, candidate })),\n    ...rejectedPaths.map((path) => Object.freeze({ kind: \"input-rejected\" as const, path }))\n  ];\n  return presentCheckFindings({\n    findings,\n    limit: PRESENTED_FINDING_LIMIT,\n    message: (finding) => {\n      if (finding.kind === \"input-rejected\") {\n        return Object.freeze({\n          code: \"finding-detail\",\n          level: \"warning\" as const,\n          message: `${finding.path}: selected input is not a supported Markdown source.`\n        });\n      }\n      const { occurrenceKind, range, reason, sourcePath } = finding.candidate.data;\n      return Object.freeze({\n        code: \"finding-detail\",\n        level: blocking ? (\"error\" as const) : (\"warning\" as const),\n        message: `${sourcePath}:${range.start.line}:${range.start.column} ${occurrenceKind}: ${reason}.`\n      });\n    },\n    omittedMessage: ({ omittedCount, omittedFindings }) =>\n      Object.freeze({\n        code: \"findings-omitted\",\n        level: omittedFindings.some((finding) => finding.kind === \"link\" && blocking)\n          ? (\"error\" as const)\n          : (\"warning\" as const),\n        message: `${omittedCount} additional Markdown link finding(s) were not shown; inspect this Check's Records for the complete set.`\n      })\n  });\n}\n"]}
+{"version":3,"file":"finding-messages.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/finding-messages.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kEAAkE,CAAC;AAGxG,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAMnC,2FAA2F;AAC3F,MAAM,UAAU,uBAAuB,CACrC,UAAkD,EAClD,aAAgC,EAChC,QAAiB;IAEjB,MAAM,QAAQ,GAA+B;QAC3C,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,SAAS,EAAE,CAAC,CAAC;QACrF,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAyB,EAAE,IAAI,EAAE,CAAC,CAAC;KACzF,CAAC;IACF,OAAO,oBAAoB,CAAC;QAC1B,QAAQ;QACR,KAAK,EAAE,uBAAuB;QAC9B,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE;YACnB,IAAI,OAAO,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACtC,OAAO,MAAM,CAAC,MAAM,CAAC;oBACnB,IAAI,EAAE,gBAAgB;oBACtB,KAAK,EAAE,SAAkB;oBACzB,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,sDAAsD;iBAC/E,CAAC,CAAC;YACL,CAAC;YACD,MAAM,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC;YAC7E,OAAO,MAAM,CAAC,MAAM,CAAC;gBACnB,IAAI,EAAE,gBAAgB;gBACtB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAE,OAAiB,CAAC,CAAC,CAAE,SAAmB;gBAC3D,OAAO,EAAE,GAAG,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,IAAI,cAAc,KAAK,MAAM,GAAG;aACjG,CAAC,CAAC;QACL,CAAC;QACD,cAAc,EAAE,CAAC,EAAE,YAAY,EAAE,eAAe,EAAE,EAAE,EAAE,CACpD,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,kBAAkB;YACxB,KAAK,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC;gBAC3E,CAAC,CAAE,OAAiB;gBACpB,CAAC,CAAE,SAAmB;YACxB,OAAO,EAAE,GAAG,YAAY,yGAAyG;SAClI,CAAC;KACL,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage } from \"../../check/check.ts\";\nimport { presentCheckFindings } from \"../../package-tools/finding-presentation/finding-presentation.ts\";\nimport type { MarkdownLinkRecordCandidate } from \"./records.ts\";\n\nconst PRESENTED_FINDING_LIMIT = 10;\n\ntype PresentedMarkdownFinding =\n  | Readonly<{ readonly kind: \"link\"; readonly candidate: MarkdownLinkRecordCandidate }>\n  | Readonly<{ readonly kind: \"input-rejected\"; readonly path: string }>;\n\n/** Projects completed Link findings without copying raw destinations into presentation. */\nexport function markdownFindingMessages(\n  candidates: readonly MarkdownLinkRecordCandidate[],\n  rejectedPaths: readonly string[],\n  blocking: boolean\n): readonly CheckMessage[] {\n  const findings: PresentedMarkdownFinding[] = [\n    ...candidates.map((candidate) => Object.freeze({ kind: \"link\" as const, candidate })),\n    ...rejectedPaths.map((path) => Object.freeze({ kind: \"input-rejected\" as const, path }))\n  ];\n  return presentCheckFindings({\n    findings,\n    limit: PRESENTED_FINDING_LIMIT,\n    message: (finding) => {\n      if (finding.kind === \"input-rejected\") {\n        return Object.freeze({\n          code: \"finding-detail\",\n          level: \"warning\" as const,\n          message: `${finding.path}: selected input is not a supported Markdown source.`\n        });\n      }\n      const { occurrenceKind, range, reason, sourcePath } = finding.candidate.data;\n      return Object.freeze({\n        code: \"finding-detail\",\n        level: blocking ? (\"error\" as const) : (\"warning\" as const),\n        message: `${sourcePath}:${range.start.line}:${range.start.column} ${occurrenceKind}: ${reason}.`\n      });\n    },\n    omittedMessage: ({ omittedCount, omittedFindings }) =>\n      Object.freeze({\n        code: \"findings-omitted\",\n        level: omittedFindings.some((finding) => finding.kind === \"link\" && blocking)\n          ? (\"error\" as const)\n          : (\"warning\" as const),\n        message: `${omittedCount} additional Markdown link finding(s) were not shown; inspect this Check's Records for the complete set.`\n      })\n  });\n}\n"]}

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

@@ -138,9 +138,7 @@ function isMarkdownAstNode(value) {
     return typeof value.type === "string";
 }
 function sourceRangeFromPosition(position) {
-    if (position === undefined ||
-        position.start.offset === undefined ||
-        position.end.offset === undefined) {
+    if (position?.start.offset === undefined || position?.end.offset === undefined) {
         return null;
     }
     return Object.freeze({

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

@@ -1 +1 @@
-{"version":3,"file":"markdown-parser.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/markdown-parser.ts"],"names":[],"mappings":"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","sourcesContent":["import GithubSlugger from \"github-slugger\";\nimport { fromMarkdown } from \"mdast-util-from-markdown\";\nimport { frontmatterFromMarkdown } from \"mdast-util-frontmatter\";\nimport { gfmFromMarkdown } from \"mdast-util-gfm\";\nimport { frontmatter } from \"micromark-extension-frontmatter\";\nimport { gfm } from \"micromark-extension-gfm\";\n\ninterface MarkdownAstPoint {\n  readonly line: number;\n  readonly column: number;\n  readonly offset?: number;\n}\n\ninterface MarkdownAstPosition {\n  readonly start: MarkdownAstPoint;\n  readonly end: MarkdownAstPoint;\n}\n\ninterface MarkdownAstNode {\n  readonly type: string;\n  readonly position?: MarkdownAstPosition;\n  readonly children?: readonly MarkdownAstNode[];\n  readonly value?: string;\n  readonly url?: string;\n  readonly identifier?: string;\n  readonly alt?: string | null;\n}\n\ntype MarkdownOccurrenceKind = \"image\" | \"link\";\n\ninterface MarkdownSourcePosition {\n  readonly line: number;\n  readonly column: number;\n}\n\ninterface MarkdownSourceRange {\n  readonly startOffset: number;\n  readonly endOffset: number;\n  readonly start: MarkdownSourcePosition;\n  readonly end: MarkdownSourcePosition;\n}\n\ninterface MarkdownLinkOccurrence {\n  readonly kind: MarkdownOccurrenceKind;\n  readonly rawDestination: string;\n  readonly range: MarkdownSourceRange;\n}\n\ninterface MarkdownHeading {\n  readonly slug: string;\n  readonly range: MarkdownSourceRange;\n}\n\ninterface ParsedMarkdownLinkFacts {\n  readonly occurrences: readonly MarkdownLinkOccurrence[];\n  readonly headings: readonly MarkdownHeading[];\n}\n\ntype MarkdownLinkParseResult =\n  | Readonly<{\n      readonly ok: true;\n      readonly facts: ParsedMarkdownLinkFacts;\n    }>\n  | Readonly<{\n      readonly ok: false;\n      readonly reason: \"markdown-parse-failure\";\n    }>;\n\n/**\n * Link-private Markdown grammar adapter. It deliberately exposes facts rather\n * than the dependency AST, so resolver ownership starts after parsing.\n */\nexport function parseMarkdownLinkFacts(markdown: string): MarkdownLinkParseResult {\n  if (hasUnpairedSurrogate(markdown)) {\n    return parseFailure();\n  }\n\n  try {\n    const tree: unknown = fromMarkdown(markdown, {\n      extensions: [gfm(), frontmatter([\"yaml\"])],\n      mdastExtensions: [gfmFromMarkdown(), frontmatterFromMarkdown([\"yaml\"])]\n    });\n    if (!isMarkdownAstNode(tree)) {\n      return parseFailure();\n    }\n    return collectMarkdownLinkFacts(tree);\n  } catch {\n    return parseFailure();\n  }\n}\n\nfunction collectMarkdownLinkFacts(tree: MarkdownAstNode): MarkdownLinkParseResult {\n  const definitions = definitionsByIdentifier(tree);\n  const occurrences: MarkdownLinkOccurrence[] = [];\n  const headings: MarkdownHeading[] = [];\n  const slugger = new GithubSlugger();\n\n  forEachNode(tree, (node) => {\n    const occurrence = occurrenceFromNode(node, definitions);\n    if (occurrence !== null) {\n      occurrences.push(occurrence);\n    }\n\n    if (node.type === \"heading\") {\n      const heading = headingFromNode(node, slugger);\n      if (heading === null) {\n        throw new Error(\"Markdown heading did not include a source range.\");\n      }\n      headings.push(heading);\n    }\n  });\n\n  return Object.freeze({\n    ok: true as const,\n    facts: Object.freeze({\n      occurrences: Object.freeze(occurrences),\n      headings: Object.freeze(headings)\n    })\n  });\n}\n\nfunction definitionsByIdentifier(tree: MarkdownAstNode): ReadonlyMap<string, string> {\n  const definitions = new Map<string, string>();\n\n  forEachNode(tree, (node) => {\n    if (node.type !== \"definition\") {\n      return;\n    }\n    if (node.identifier === undefined || node.url === undefined) {\n      throw new Error(\"Markdown definition was missing a destination.\");\n    }\n    if (!definitions.has(node.identifier)) {\n      definitions.set(node.identifier, node.url);\n    }\n  });\n\n  return definitions;\n}\n\nfunction occurrenceFromNode(\n  node: MarkdownAstNode,\n  definitions: ReadonlyMap<string, string>\n): MarkdownLinkOccurrence | null {\n  if (node.type === \"link\") {\n    return occurrenceFromResource(node, \"link\");\n  }\n  if (node.type === \"image\") {\n    return occurrenceFromResource(node, \"image\");\n  }\n  if (node.type === \"linkReference\") {\n    return occurrenceFromReference(node, \"link\", definitions);\n  }\n  if (node.type === \"imageReference\") {\n    return occurrenceFromReference(node, \"image\", definitions);\n  }\n  return null;\n}\n\nfunction occurrenceFromResource(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind\n): MarkdownLinkOccurrence | null {\n  if (node.url === undefined) {\n    throw new Error(\"Markdown occurrence was missing a destination.\");\n  }\n  return occurrenceWithDestination(node, kind, node.url);\n}\n\nfunction occurrenceWithDestination(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind,\n  rawDestination: string\n): MarkdownLinkOccurrence | null {\n  const range = sourceRangeFromPosition(node.position);\n  if (range === null) {\n    throw new Error(\"Markdown occurrence did not include a source range.\");\n  }\n  return Object.freeze({ kind, rawDestination, range });\n}\n\nfunction occurrenceFromReference(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind,\n  definitions: ReadonlyMap<string, string>\n): MarkdownLinkOccurrence | null {\n  if (node.identifier === undefined) {\n    throw new Error(\"Markdown reference was missing an identifier.\");\n  }\n  const rawDestination = definitions.get(node.identifier);\n  if (rawDestination === undefined) {\n    return null;\n  }\n  return occurrenceWithDestination(node, kind, rawDestination);\n}\n\nfunction headingFromNode(node: MarkdownAstNode, slugger: GithubSlugger): MarkdownHeading | null {\n  const range = sourceRangeFromPosition(node.position);\n  if (range === null) {\n    return null;\n  }\n  return Object.freeze({\n    slug: slugger.slug(markdownText(node)),\n    range\n  });\n}\n\nfunction markdownText(node: MarkdownAstNode): string {\n  if (node.value !== undefined) {\n    return node.value;\n  }\n  if (node.children !== undefined) {\n    return node.children.map(markdownText).join(\"\");\n  }\n  if (node.type === \"image\" || node.type === \"imageReference\") {\n    return node.alt ?? \"\";\n  }\n  return \"\";\n}\n\nfunction isMarkdownAstNode(value: unknown): value is MarkdownAstNode {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    !(\"type\" in value) ||\n    !(\"children\" in value) ||\n    !Array.isArray(value.children)\n  ) {\n    return false;\n  }\n  return typeof value.type === \"string\";\n}\n\nfunction sourceRangeFromPosition(\n  position: MarkdownAstPosition | undefined\n): MarkdownSourceRange | null {\n  if (\n    position === undefined ||\n    position.start.offset === undefined ||\n    position.end.offset === undefined\n  ) {\n    return null;\n  }\n\n  return Object.freeze({\n    startOffset: position.start.offset,\n    endOffset: position.end.offset,\n    start: Object.freeze({ line: position.start.line, column: position.start.column }),\n    end: Object.freeze({ line: position.end.line, column: position.end.column })\n  });\n}\n\nfunction forEachNode(root: MarkdownAstNode, visitor: (node: MarkdownAstNode) => void): void {\n  const nodes: MarkdownAstNode[] = [root];\n\n  while (nodes.length > 0) {\n    const node = nodes.pop();\n    if (node === undefined) {\n      return;\n    }\n    visitor(node);\n    if (node.children !== undefined) {\n      for (let index = node.children.length - 1; index >= 0; index -= 1) {\n        const child = node.children[index];\n        if (child !== undefined) {\n          nodes.push(child);\n        }\n      }\n    }\n  }\n}\n\nfunction hasUnpairedSurrogate(markdown: string): boolean {\n  for (let index = 0; index < markdown.length; index += 1) {\n    const codeUnit = markdown.charCodeAt(index);\n    if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {\n      const nextCodeUnit = markdown.charCodeAt(index + 1);\n      if (!(nextCodeUnit >= 0xdc00 && nextCodeUnit <= 0xdfff)) {\n        return true;\n      }\n      index += 1;\n      continue;\n    }\n    if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction parseFailure(): MarkdownLinkParseResult {\n  return Object.freeze({ ok: false as const, reason: \"markdown-parse-failure\" as const });\n}\n\nexport type {\n  MarkdownHeading,\n  MarkdownLinkOccurrence,\n  MarkdownLinkParseResult,\n  MarkdownOccurrenceKind,\n  MarkdownSourcePosition,\n  MarkdownSourceRange,\n  ParsedMarkdownLinkFacts\n};\n"]}
+{"version":3,"file":"markdown-parser.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/markdown-parser.ts"],"names":[],"mappings":"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","sourcesContent":["import GithubSlugger from \"github-slugger\";\nimport { fromMarkdown } from \"mdast-util-from-markdown\";\nimport { frontmatterFromMarkdown } from \"mdast-util-frontmatter\";\nimport { gfmFromMarkdown } from \"mdast-util-gfm\";\nimport { frontmatter } from \"micromark-extension-frontmatter\";\nimport { gfm } from \"micromark-extension-gfm\";\n\ninterface MarkdownAstPoint {\n  readonly line: number;\n  readonly column: number;\n  readonly offset?: number;\n}\n\ninterface MarkdownAstPosition {\n  readonly start: MarkdownAstPoint;\n  readonly end: MarkdownAstPoint;\n}\n\ninterface MarkdownAstNode {\n  readonly type: string;\n  readonly position?: MarkdownAstPosition;\n  readonly children?: readonly MarkdownAstNode[];\n  readonly value?: string;\n  readonly url?: string;\n  readonly identifier?: string;\n  readonly alt?: string | null;\n}\n\ntype MarkdownOccurrenceKind = \"image\" | \"link\";\n\ninterface MarkdownSourcePosition {\n  readonly line: number;\n  readonly column: number;\n}\n\ninterface MarkdownSourceRange {\n  readonly startOffset: number;\n  readonly endOffset: number;\n  readonly start: MarkdownSourcePosition;\n  readonly end: MarkdownSourcePosition;\n}\n\ninterface MarkdownLinkOccurrence {\n  readonly kind: MarkdownOccurrenceKind;\n  readonly rawDestination: string;\n  readonly range: MarkdownSourceRange;\n}\n\ninterface MarkdownHeading {\n  readonly slug: string;\n  readonly range: MarkdownSourceRange;\n}\n\ninterface ParsedMarkdownLinkFacts {\n  readonly occurrences: readonly MarkdownLinkOccurrence[];\n  readonly headings: readonly MarkdownHeading[];\n}\n\ntype MarkdownLinkParseResult =\n  | Readonly<{\n      readonly ok: true;\n      readonly facts: ParsedMarkdownLinkFacts;\n    }>\n  | Readonly<{\n      readonly ok: false;\n      readonly reason: \"markdown-parse-failure\";\n    }>;\n\n/**\n * Link-private Markdown grammar adapter. It deliberately exposes facts rather\n * than the dependency AST, so resolver ownership starts after parsing.\n */\nexport function parseMarkdownLinkFacts(markdown: string): MarkdownLinkParseResult {\n  if (hasUnpairedSurrogate(markdown)) {\n    return parseFailure();\n  }\n\n  try {\n    const tree: unknown = fromMarkdown(markdown, {\n      extensions: [gfm(), frontmatter([\"yaml\"])],\n      mdastExtensions: [gfmFromMarkdown(), frontmatterFromMarkdown([\"yaml\"])]\n    });\n    if (!isMarkdownAstNode(tree)) {\n      return parseFailure();\n    }\n    return collectMarkdownLinkFacts(tree);\n  } catch {\n    return parseFailure();\n  }\n}\n\nfunction collectMarkdownLinkFacts(tree: MarkdownAstNode): MarkdownLinkParseResult {\n  const definitions = definitionsByIdentifier(tree);\n  const occurrences: MarkdownLinkOccurrence[] = [];\n  const headings: MarkdownHeading[] = [];\n  const slugger = new GithubSlugger();\n\n  forEachNode(tree, (node) => {\n    const occurrence = occurrenceFromNode(node, definitions);\n    if (occurrence !== null) {\n      occurrences.push(occurrence);\n    }\n\n    if (node.type === \"heading\") {\n      const heading = headingFromNode(node, slugger);\n      if (heading === null) {\n        throw new Error(\"Markdown heading did not include a source range.\");\n      }\n      headings.push(heading);\n    }\n  });\n\n  return Object.freeze({\n    ok: true as const,\n    facts: Object.freeze({\n      occurrences: Object.freeze(occurrences),\n      headings: Object.freeze(headings)\n    })\n  });\n}\n\nfunction definitionsByIdentifier(tree: MarkdownAstNode): ReadonlyMap<string, string> {\n  const definitions = new Map<string, string>();\n\n  forEachNode(tree, (node) => {\n    if (node.type !== \"definition\") {\n      return;\n    }\n    if (node.identifier === undefined || node.url === undefined) {\n      throw new Error(\"Markdown definition was missing a destination.\");\n    }\n    if (!definitions.has(node.identifier)) {\n      definitions.set(node.identifier, node.url);\n    }\n  });\n\n  return definitions;\n}\n\nfunction occurrenceFromNode(\n  node: MarkdownAstNode,\n  definitions: ReadonlyMap<string, string>\n): MarkdownLinkOccurrence | null {\n  if (node.type === \"link\") {\n    return occurrenceFromResource(node, \"link\");\n  }\n  if (node.type === \"image\") {\n    return occurrenceFromResource(node, \"image\");\n  }\n  if (node.type === \"linkReference\") {\n    return occurrenceFromReference(node, \"link\", definitions);\n  }\n  if (node.type === \"imageReference\") {\n    return occurrenceFromReference(node, \"image\", definitions);\n  }\n  return null;\n}\n\nfunction occurrenceFromResource(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind\n): MarkdownLinkOccurrence | null {\n  if (node.url === undefined) {\n    throw new Error(\"Markdown occurrence was missing a destination.\");\n  }\n  return occurrenceWithDestination(node, kind, node.url);\n}\n\nfunction occurrenceWithDestination(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind,\n  rawDestination: string\n): MarkdownLinkOccurrence | null {\n  const range = sourceRangeFromPosition(node.position);\n  if (range === null) {\n    throw new Error(\"Markdown occurrence did not include a source range.\");\n  }\n  return Object.freeze({ kind, rawDestination, range });\n}\n\nfunction occurrenceFromReference(\n  node: MarkdownAstNode,\n  kind: MarkdownOccurrenceKind,\n  definitions: ReadonlyMap<string, string>\n): MarkdownLinkOccurrence | null {\n  if (node.identifier === undefined) {\n    throw new Error(\"Markdown reference was missing an identifier.\");\n  }\n  const rawDestination = definitions.get(node.identifier);\n  if (rawDestination === undefined) {\n    return null;\n  }\n  return occurrenceWithDestination(node, kind, rawDestination);\n}\n\nfunction headingFromNode(node: MarkdownAstNode, slugger: GithubSlugger): MarkdownHeading | null {\n  const range = sourceRangeFromPosition(node.position);\n  if (range === null) {\n    return null;\n  }\n  return Object.freeze({\n    slug: slugger.slug(markdownText(node)),\n    range\n  });\n}\n\nfunction markdownText(node: MarkdownAstNode): string {\n  if (node.value !== undefined) {\n    return node.value;\n  }\n  if (node.children !== undefined) {\n    return node.children.map(markdownText).join(\"\");\n  }\n  if (node.type === \"image\" || node.type === \"imageReference\") {\n    return node.alt ?? \"\";\n  }\n  return \"\";\n}\n\nfunction isMarkdownAstNode(value: unknown): value is MarkdownAstNode {\n  if (\n    typeof value !== \"object\" ||\n    value === null ||\n    !(\"type\" in value) ||\n    !(\"children\" in value) ||\n    !Array.isArray(value.children)\n  ) {\n    return false;\n  }\n  return typeof value.type === \"string\";\n}\n\nfunction sourceRangeFromPosition(\n  position: MarkdownAstPosition | undefined\n): MarkdownSourceRange | null {\n  if (position?.start.offset === undefined || position?.end.offset === undefined) {\n    return null;\n  }\n\n  return Object.freeze({\n    startOffset: position.start.offset,\n    endOffset: position.end.offset,\n    start: Object.freeze({ line: position.start.line, column: position.start.column }),\n    end: Object.freeze({ line: position.end.line, column: position.end.column })\n  });\n}\n\nfunction forEachNode(root: MarkdownAstNode, visitor: (node: MarkdownAstNode) => void): void {\n  const nodes: MarkdownAstNode[] = [root];\n\n  while (nodes.length > 0) {\n    const node = nodes.pop();\n    if (node === undefined) {\n      return;\n    }\n    visitor(node);\n    if (node.children !== undefined) {\n      for (let index = node.children.length - 1; index >= 0; index -= 1) {\n        const child = node.children[index];\n        if (child !== undefined) {\n          nodes.push(child);\n        }\n      }\n    }\n  }\n}\n\nfunction hasUnpairedSurrogate(markdown: string): boolean {\n  for (let index = 0; index < markdown.length; index += 1) {\n    const codeUnit = markdown.charCodeAt(index);\n    if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {\n      const nextCodeUnit = markdown.charCodeAt(index + 1);\n      if (!(nextCodeUnit >= 0xdc00 && nextCodeUnit <= 0xdfff)) {\n        return true;\n      }\n      index += 1;\n      continue;\n    }\n    if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) {\n      return true;\n    }\n  }\n  return false;\n}\n\nfunction parseFailure(): MarkdownLinkParseResult {\n  return Object.freeze({ ok: false as const, reason: \"markdown-parse-failure\" as const });\n}\n\nexport type {\n  MarkdownHeading,\n  MarkdownLinkOccurrence,\n  MarkdownLinkParseResult,\n  MarkdownOccurrenceKind,\n  MarkdownSourcePosition,\n  MarkdownSourceRange,\n  ParsedMarkdownLinkFacts\n};\n"]}

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

@@ -1,7 +1,8 @@
 import { canonicalizeJsonObject } from "../../data-boundary/canonical-data.mjs";
-import { hasExactPlainRecordKeys, hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
 import { defaultProjectFileSelection, resolveProjectFileSelection, snapshotProjectFileSelection } from "../project-files/configuration.mjs";
 import { DEFAULT_FINDING_POLICY, resolveFindingPolicy } from "../code-quality-findings/policy.mjs";
+import { resolveOptionalLocalCacheOptions } from "../local-cache-options.mjs";
 import { validMarkdownLinkValidationOptions } from "./options-validation.mjs";
 const DEFAULT_LIMITS = Object.freeze({
     maxMarkdownBytes: 1_048_576,
@@ -21,7 +22,7 @@ export function resolveMarkdownLinkValidationOptions(value) {
     const limits = resolvedLimits(input.limits);
     const files = resolvedFiles(input.files);
     const findingPolicy = resolveFindingPolicy(input.findingPolicy, DEFAULT_FINDING_POLICY);
-    const cache = resolvedCache(input.cache);
+    const cache = resolveOptionalLocalCacheOptions(input.cache);
     if (limits === undefined ||
         files === undefined ||
         findingPolicy === undefined ||
@@ -62,22 +63,6 @@ function isMarkdownLinkValidationInput(input) {
             required: []
         }));
 }
-function resolvedCache(value) {
-    if (value === undefined)
-        return Object.freeze({ enabled: false });
-    const cache = snapshotClosedRecord(value);
-    if (cache === undefined)
-        return undefined;
-    if (hasExactPlainRecordKeys(cache, ["enabled"]) && cache.enabled === false) {
-        return Object.freeze({ enabled: false });
-    }
-    if (hasExactPlainRecordKeys(cache, ["enabled", "directory"]) &&
-        cache.enabled === true &&
-        typeof cache.directory === "string") {
-        return Object.freeze({ enabled: true, directory: cache.directory });
-    }
-    return undefined;
-}
 function resolvedFiles(value) {
     return value === undefined
         ? snapshotProjectFileSelection(DEFAULT_FILES)