@zxyycom/vibe-check 0.0.1

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

@@ -0,0 +1,155 @@
+import { defineCheck } from "../../check/check.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";
+import { completedResult, reminderEvaluation, unavailableAssessment, unavailableHistory, unavailableResult } from "./assessment-results.mjs";
+import { measureReminder, parseCommitId, parseFirstParentHistory } from "./measurement.mjs";
+export const MAINTENANCE_REMINDERS_CHECK_ID = "maintenance-reminders";
+const MAINTENANCE_REMINDER_OPTION_KEYS = ["entries", "git"];
+const WHOLE_CHECK_UNAVAILABLE_CODE = Object.freeze({
+    invalidOptions: "invalid-options",
+    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) {
+    return defineCheck({
+        checkId: MAINTENANCE_REMINDERS_CHECK_ID,
+        displayName: "Maintenance reminders",
+        execution: executeMaintenanceReminders,
+        parseData: parseMaintenanceRemindersData,
+        preflight: (options) => validMaintenanceReminderOptions(options)
+            ? { status: "success", preparedOptions: options }
+            : {
+                status: "failure",
+                action: "block",
+                reason: { code: "invalid-options" },
+                messages: [
+                    {
+                        code: "invalid-options",
+                        level: "error",
+                        message: "maintenanceReminders options are invalid; recreate the Check with maintenanceReminders(entries) or restore its complete resolved options."
+                    }
+                ]
+            },
+        options: {
+            entries,
+            git: { executable: "git" }
+        },
+        visibility: "attention"
+    });
+}
+/** 在普通对象组合后验证完整的选项形状。 */
+export function validMaintenanceReminderOptions(value) {
+    const options = exactRecord(value, MAINTENANCE_REMINDER_OPTION_KEYS);
+    return options !== undefined && validEntries(options.entries) && validGit(options.git);
+}
+async function executeMaintenanceReminders(context) {
+    if (!validMaintenanceReminderOptions(context.options))
+        return unavailableResult("invalid-options");
+    if (context.signal.aborted)
+        return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);
+    try {
+        const history = await resolveFirstParentHistory({
+            executable: context.options.git.executable,
+            projectRoot: context.project.root,
+            signal: context.signal
+        });
+        if (history.kind === "cancelled") {
+            return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);
+        }
+        if (history.kind === "unavailable") {
+            return completedResult(context.options.entries.map((entry) => reminderEvaluation(entry, unavailableAssessment(entry, null, history.reason))));
+        }
+        const evaluations = [];
+        for (const entry of context.options.entries) {
+            const measurement = await measureReminder({
+                entry,
+                executable: context.options.git.executable,
+                history: history.value,
+                projectRoot: context.project.root,
+                signal: context.signal
+            });
+            if (measurement.kind === "cancelled") {
+                return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.executionCancelled);
+            }
+            evaluations.push(measurement.value);
+        }
+        return completedResult(evaluations);
+    }
+    catch {
+        return unavailableResult(WHOLE_CHECK_UNAVAILABLE_CODE.internalFailure);
+    }
+}
+async function resolveFirstParentHistory(input) {
+    const head = await runGit({
+        args: ["rev-parse", "--verify", "HEAD^{commit}"],
+        executable: input.executable,
+        projectRoot: input.projectRoot,
+        signal: input.signal
+    });
+    if (head.kind === "cancelled")
+        return head;
+    if (head.kind === "failed")
+        return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headUnavailable);
+    const headCommit = parseCommitId(head.stdout);
+    if (headCommit === null)
+        return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.headInvalid);
+    const history = await runGit({
+        args: ["rev-list", "--first-parent", "HEAD"],
+        executable: input.executable,
+        projectRoot: input.projectRoot,
+        signal: input.signal
+    });
+    if (history.kind === "cancelled")
+        return history;
+    if (history.kind === "failed") {
+        return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryUnavailable);
+    }
+    const firstParentHistory = parseFirstParentHistory(history.stdout, headCommit);
+    if (firstParentHistory === undefined) {
+        return unavailableHistory(MAINTENANCE_REMINDER_UNAVAILABLE_REASON.firstParentHistoryInvalid);
+    }
+    return {
+        kind: "succeeded",
+        value: firstParentHistory
+    };
+}
+//# sourceMappingURL=maintenance-reminders.mjs.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,58 @@
+import { spawn } from "node:child_process";
+const MAX_GIT_OUTPUT_BYTES = 64 * 1024 * 1024;
+export async function runGit(input) {
+    if (input.signal.aborted)
+        return { kind: "cancelled" };
+    return new Promise((resolve) => {
+        let settled = false;
+        let outputBytes = 0;
+        let stdout = "";
+        let overflowed = false;
+        let child;
+        const settle = (result) => {
+            if (settled)
+                return;
+            settled = true;
+            input.signal.removeEventListener("abort", abort);
+            resolve(result);
+        };
+        const abort = () => {
+            child.kill("SIGTERM");
+        };
+        try {
+            child = spawn(input.executable, input.args, {
+                cwd: input.projectRoot,
+                stdio: ["ignore", "pipe", "ignore"],
+                windowsHide: true
+            });
+        }
+        catch {
+            settle({ kind: "failed" });
+            return;
+        }
+        input.signal.addEventListener("abort", abort, { once: true });
+        child.stdout?.on("data", (chunk) => {
+            const text = String(chunk);
+            outputBytes += Buffer.byteLength(text);
+            if (outputBytes > MAX_GIT_OUTPUT_BYTES) {
+                overflowed = true;
+                child.kill("SIGTERM");
+                return;
+            }
+            stdout += text;
+        });
+        child.once("error", () => settle(input.signal.aborted ? { kind: "cancelled" } : { kind: "failed" }));
+        child.once("close", (status) => {
+            if (input.signal.aborted) {
+                settle({ kind: "cancelled" });
+            }
+            else if (overflowed || status !== 0) {
+                settle({ kind: "failed" });
+            }
+            else {
+                settle({ kind: "succeeded", stdout });
+            }
+        });
+    });
+}
+//# sourceMappingURL=maintenance-support.mjs.map

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

@@ -0,0 +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"]}

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

@@ -0,0 +1,125 @@
+import { isMaintenanceCommitId } from "./final-data.mjs";
+import { completedMeasurement, modeOf, unavailableAssessment } from "./assessment-results.mjs";
+import { runGit } from "./maintenance-support.mjs";
+export async function measureReminder(input) {
+    const base = await resolvedBaseCommit(input);
+    if (base.kind === "cancelled")
+        return base;
+    if (base.kind === "unavailable")
+        return unavailableMeasurement(input, base.reason);
+    const changedLines = await measuredChangedLines(input, base.value);
+    if (changedLines.kind === "cancelled")
+        return changedLines;
+    if (changedLines.kind === "unavailable")
+        return unavailableMeasurement(input, changedLines.reason);
+    return completedMeasurement(input.entry, measuredAssessment(input, base.value, changedLines.value));
+}
+async function resolvedBaseCommit(input) {
+    const base = await runGit({
+        args: ["rev-parse", "--verify", `${input.entry.baseCommit}^{commit}`],
+        executable: input.executable,
+        projectRoot: input.projectRoot,
+        signal: input.signal
+    });
+    if (base.kind === "cancelled")
+        return base;
+    if (base.kind === "failed")
+        return unavailableMeasure("base-commit-unavailable");
+    const baseCommit = parseCommitId(base.stdout);
+    if (baseCommit === null)
+        return unavailableMeasure("base-commit-unavailable");
+    const baseIndex = input.history.commits.indexOf(baseCommit);
+    return baseIndex < 0
+        ? unavailableMeasure("base-not-first-parent-ancestor")
+        : completeMeasure(baseIndex);
+}
+async function measuredChangedLines(input, baseIndex) {
+    let changedLines = 0;
+    for (const commit of input.history.commits.slice(0, baseIndex)) {
+        const numstat = await runGit({
+            args: ["diff-tree", "--no-commit-id", "--numstat", "-r", `${commit}^`, commit],
+            executable: input.executable,
+            projectRoot: input.projectRoot,
+            signal: input.signal
+        });
+        if (numstat.kind === "cancelled")
+            return numstat;
+        if (numstat.kind === "failed")
+            return unavailableMeasure("numstat-unavailable");
+        const count = parseChangedLines(numstat.stdout);
+        if (count === null || !Number.isSafeInteger(changedLines + count))
+            return unavailableMeasure("numstat-invalid");
+        changedLines += count;
+    }
+    return completeMeasure(changedLines);
+}
+function measuredAssessment(input, baseIndex, changedLines) {
+    const mode = modeOf(input.entry);
+    const exceeded = [
+        ...(input.entry.limits.commits !== undefined && baseIndex > input.entry.limits.commits
+            ? ["commits"]
+            : []),
+        ...(input.entry.limits.changedLines !== undefined &&
+            changedLines > input.entry.limits.changedLines
+            ? ["changed-lines"]
+            : [])
+    ];
+    return {
+        assessment: exceeded.length > 0 ? "due" : "clear",
+        baseCommit: input.entry.baseCommit,
+        changedLines,
+        commitCount: baseIndex,
+        exceeded,
+        headCommit: input.history.headCommit,
+        id: input.entry.id,
+        mode
+    };
+}
+function unavailableMeasurement(input, reason) {
+    return completedMeasurement(input.entry, unavailableAssessment(input.entry, input.history.headCommit, reason));
+}
+function completeMeasure(value) {
+    return { kind: "complete", value };
+}
+function unavailableMeasure(reason) {
+    return { kind: "unavailable", reason };
+}
+export function parseCommitId(stdout) {
+    const value = stdout.trim();
+    return isMaintenanceCommitId(value) ? value.toLowerCase() : null;
+}
+export function parseFirstParentHistory(stdout, headCommit) {
+    const commits = [];
+    for (const line of stdout.split(/\r?\n/)) {
+        if (line.trim().length === 0)
+            continue;
+        const commit = parseCommitId(line);
+        if (commit === null)
+            return undefined;
+        commits.push(commit);
+    }
+    if (commits.length === 0 || commits[0] !== headCommit)
+        return undefined;
+    return Object.freeze({ commits: Object.freeze(commits), headCommit });
+}
+function parseChangedLines(stdout) {
+    let changedLines = 0;
+    for (const line of stdout.split(/\r?\n/)) {
+        if (line.length === 0)
+            continue;
+        const [additions, deletions] = line.split("\t", 3);
+        if (additions === "-" && deletions === "-")
+            continue;
+        if (!decimal(additions) || !decimal(deletions))
+            return null;
+        const count = Number(additions) + Number(deletions);
+        if (!Number.isSafeInteger(count) || !Number.isSafeInteger(changedLines + count))
+            return null;
+        changedLines += count;
+    }
+    return changedLines;
+}
+function decimal(value) {
+    return value !== undefined && /^(?:0|[1-9]\d*)$/.test(value);
+}
+//# sourceMappingURL=measurement.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"measurement.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/measurement.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  isMaintenanceCommitId,\n  type MaintenanceReminderAssessment,\n  type MaintenanceReminderUnavailableReason\n} from \"./final-data.ts\";\nimport { completedMeasurement, modeOf, unavailableAssessment } from \"./assessment-results.ts\";\nimport { runGit } from \"./maintenance-support.ts\";\nimport type {\n  FirstParentHistory,\n  MaintenanceReminder,\n  ReminderMeasurement\n} from \"./maintenance-reminders.ts\";\n\nexport async function measureReminder(input: {\n  readonly entry: Readonly<MaintenanceReminder>;\n  readonly executable: string;\n  readonly history: FirstParentHistory;\n  readonly projectRoot: string;\n  readonly signal: AbortSignal;\n}): Promise<ReminderMeasurement> {\n  const base = await resolvedBaseCommit(input);\n  if (base.kind === \"cancelled\") return base;\n  if (base.kind === \"unavailable\") return unavailableMeasurement(input, base.reason);\n  const changedLines = await measuredChangedLines(input, base.value);\n  if (changedLines.kind === \"cancelled\") return changedLines;\n  if (changedLines.kind === \"unavailable\")\n    return unavailableMeasurement(input, changedLines.reason);\n  return completedMeasurement(\n    input.entry,\n    measuredAssessment(input, base.value, changedLines.value)\n  );\n}\n\ntype ReminderMeasureStage<T> =\n  | Readonly<{ readonly kind: \"cancelled\" }>\n  | Readonly<{ readonly kind: \"complete\"; readonly value: T }>\n  | Readonly<{\n      readonly kind: \"unavailable\";\n      readonly reason: MaintenanceReminderUnavailableReason;\n    }>;\n\nasync function resolvedBaseCommit(input: {\n  readonly entry: Readonly<MaintenanceReminder>;\n  readonly executable: string;\n  readonly history: FirstParentHistory;\n  readonly projectRoot: string;\n  readonly signal: AbortSignal;\n}): Promise<ReminderMeasureStage<number>> {\n  const base = await runGit({\n    args: [\"rev-parse\", \"--verify\", `${input.entry.baseCommit}^{commit}`],\n    executable: input.executable,\n    projectRoot: input.projectRoot,\n    signal: input.signal\n  });\n  if (base.kind === \"cancelled\") return base;\n  if (base.kind === \"failed\") return unavailableMeasure(\"base-commit-unavailable\");\n\n  const baseCommit = parseCommitId(base.stdout);\n  if (baseCommit === null) return unavailableMeasure(\"base-commit-unavailable\");\n\n  const baseIndex = input.history.commits.indexOf(baseCommit);\n  return baseIndex < 0\n    ? unavailableMeasure(\"base-not-first-parent-ancestor\")\n    : completeMeasure(baseIndex);\n}\n\nasync function measuredChangedLines(\n  input: {\n    readonly executable: string;\n    readonly history: FirstParentHistory;\n    readonly projectRoot: string;\n    readonly signal: AbortSignal;\n  },\n  baseIndex: number\n): Promise<ReminderMeasureStage<number>> {\n  let changedLines = 0;\n  for (const commit of input.history.commits.slice(0, baseIndex)) {\n    const numstat = await runGit({\n      args: [\"diff-tree\", \"--no-commit-id\", \"--numstat\", \"-r\", `${commit}^`, commit],\n      executable: input.executable,\n      projectRoot: input.projectRoot,\n      signal: input.signal\n    });\n    if (numstat.kind === \"cancelled\") return numstat;\n    if (numstat.kind === \"failed\") return unavailableMeasure(\"numstat-unavailable\");\n    const count = parseChangedLines(numstat.stdout);\n    if (count === null || !Number.isSafeInteger(changedLines + count))\n      return unavailableMeasure(\"numstat-invalid\");\n    changedLines += count;\n  }\n  return completeMeasure(changedLines);\n}\n\nfunction measuredAssessment(\n  input: Readonly<{\n    readonly entry: Readonly<MaintenanceReminder>;\n    readonly history: FirstParentHistory;\n  }>,\n  baseIndex: number,\n  changedLines: number\n): MaintenanceReminderAssessment {\n  const mode = modeOf(input.entry);\n  const exceeded = [\n    ...(input.entry.limits.commits !== undefined && baseIndex > input.entry.limits.commits\n      ? ([\"commits\"] as const)\n      : []),\n    ...(input.entry.limits.changedLines !== undefined &&\n    changedLines > input.entry.limits.changedLines\n      ? ([\"changed-lines\"] as const)\n      : [])\n  ];\n  return {\n    assessment: exceeded.length > 0 ? \"due\" : \"clear\",\n    baseCommit: input.entry.baseCommit,\n    changedLines,\n    commitCount: baseIndex,\n    exceeded,\n    headCommit: input.history.headCommit,\n    id: input.entry.id,\n    mode\n  };\n}\n\nfunction unavailableMeasurement(\n  input: Readonly<{\n    readonly entry: Readonly<MaintenanceReminder>;\n    readonly history: FirstParentHistory;\n  }>,\n  reason: MaintenanceReminderUnavailableReason\n): ReminderMeasurement {\n  return completedMeasurement(\n    input.entry,\n    unavailableAssessment(input.entry, input.history.headCommit, reason)\n  );\n}\n\nfunction completeMeasure<T>(value: T): ReminderMeasureStage<T> {\n  return { kind: \"complete\", value };\n}\n\nfunction unavailableMeasure(\n  reason: MaintenanceReminderUnavailableReason\n): ReminderMeasureStage<never> {\n  return { kind: \"unavailable\", reason };\n}\n\nexport function parseCommitId(stdout: string): string | null {\n  const value = stdout.trim();\n  return isMaintenanceCommitId(value) ? value.toLowerCase() : null;\n}\n\nexport function parseFirstParentHistory(\n  stdout: string,\n  headCommit: string\n): FirstParentHistory | undefined {\n  const commits: string[] = [];\n  for (const line of stdout.split(/\\r?\\n/)) {\n    if (line.trim().length === 0) continue;\n    const commit = parseCommitId(line);\n    if (commit === null) return undefined;\n    commits.push(commit);\n  }\n  if (commits.length === 0 || commits[0] !== headCommit) return undefined;\n  return Object.freeze({ commits: Object.freeze(commits), headCommit });\n}\n\nfunction parseChangedLines(stdout: string): number | null {\n  let changedLines = 0;\n  for (const line of stdout.split(/\\r?\\n/)) {\n    if (line.length === 0) continue;\n    const [additions, deletions] = line.split(\"\\t\", 3);\n    if (additions === \"-\" && deletions === \"-\") continue;\n    if (!decimal(additions) || !decimal(deletions)) return null;\n    const count = Number(additions) + Number(deletions);\n    if (!Number.isSafeInteger(count) || !Number.isSafeInteger(changedLines + count)) return null;\n    changedLines += count;\n  }\n  return changedLines;\n}\n\nfunction decimal(value: string | undefined): value is string {\n  return value !== undefined && /^(?:0|[1-9]\\d*)$/.test(value);\n}\n"]}

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

@@ -0,0 +1,72 @@
+import { snapshotClosedArray, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { isMaintenanceCommitId, isMaintenanceReminderId } from "./final-data.mjs";
+const MAINTENANCE_REMINDER_ENTRY_KEYS = [
+    "id",
+    "baseCommit",
+    "limits",
+    "message",
+    "mode"
+];
+const MAINTENANCE_REMINDER_LIMIT_KEYS = ["commits", "changedLines"];
+const MAINTENANCE_REMINDER_GIT_KEYS = ["executable"];
+export function validEntries(value) {
+    const entries = snapshotClosedArray(value);
+    if (entries === undefined)
+        return false;
+    const identifiers = new Set();
+    return entries.every((candidate) => {
+        const entry = snapshotClosedRecord(candidate);
+        if (entry === undefined || !validEntry(entry))
+            return false;
+        const identifier = entry.id;
+        if (typeof identifier !== "string" || identifiers.has(identifier))
+            return false;
+        identifiers.add(identifier);
+        return true;
+    });
+}
+function validEntry(entry) {
+    return (hasExpectedEntryKeys(entry) &&
+        validEntryIdentity(entry) &&
+        validLimits(entry.limits) &&
+        validEntryMode(entry));
+}
+function hasExpectedEntryKeys(entry) {
+    return (Object.keys(entry).every((key) => MAINTENANCE_REMINDER_ENTRY_KEYS.includes(key)) &&
+        ["id", "baseCommit", "limits", "message"].every((key) => Object.hasOwn(entry, key)));
+}
+function validEntryIdentity(entry) {
+    return (isMaintenanceReminderId(entry.id) &&
+        isMaintenanceCommitId(entry.baseCommit) &&
+        typeof entry.message === "string" &&
+        entry.message.length > 0);
+}
+function validEntryMode(entry) {
+    return !Object.hasOwn(entry, "mode") || entry.mode === "advisory" || entry.mode === "enforcing";
+}
+export function validGit(value) {
+    const git = exactRecord(value, MAINTENANCE_REMINDER_GIT_KEYS);
+    return git !== undefined && typeof git.executable === "string" && git.executable.length > 0;
+}
+function validLimits(value) {
+    const limits = snapshotClosedRecord(value);
+    if (limits === undefined)
+        return false;
+    const keys = Object.keys(limits);
+    return (keys.length > 0 &&
+        keys.every((key) => MAINTENANCE_REMINDER_LIMIT_KEYS.includes(key)) &&
+        (!Object.hasOwn(limits, "commits") || positiveSafeInteger(limits.commits)) &&
+        (!Object.hasOwn(limits, "changedLines") || positiveSafeInteger(limits.changedLines)));
+}
+export function exactRecord(value, keys) {
+    const record = snapshotClosedRecord(value);
+    return record !== undefined &&
+        Object.keys(record).length === keys.length &&
+        keys.every((key) => Object.hasOwn(record, key))
+        ? record
+        : undefined;
+}
+function positiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+//# sourceMappingURL=options-validation.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/options-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AACjG,OAAO,EAAE,qBAAqB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAEjF,MAAM,+BAA+B,GAAsB;IACzD,IAAI;IACJ,YAAY;IACZ,QAAQ;IACR,SAAS;IACT,MAAM;CACP,CAAC;AACF,MAAM,+BAA+B,GAAsB,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;AACvF,MAAM,6BAA6B,GAAsB,CAAC,YAAY,CAAC,CAAC;AAExE,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,OAAO,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAU,CAAC;IACtC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,KAAK,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC5D,MAAM,UAAU,GAAG,KAAK,CAAC,EAAE,CAAC;QAC5B,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,OAAO,KAAK,CAAC;QAChF,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,UAAU,CAAC,KAAwC;IAC1D,OAAO,CACL,oBAAoB,CAAC,KAAK,CAAC;QAC3B,kBAAkB,CAAC,KAAK,CAAC;QACzB,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC;QACzB,cAAc,CAAC,KAAK,CAAC,CACtB,CAAC;AACJ,CAAC;AAED,SAAS,oBAAoB,CAAC,KAAwC;IACpE,OAAO,CACL,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,+BAA+B,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAChF,CAAC,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CACpF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAwC;IAClE,OAAO,CACL,uBAAuB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC;QACvC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;QACjC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CACzB,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,KAAwC;IAC9D,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,MAAM,GAAG,GAAG,WAAW,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;IAC9D,OAAO,GAAG,KAAK,SAAS,IAAI,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;AAC9F,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,CACL,IAAI,CAAC,MAAM,GAAG,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,+BAA+B,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAClE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1E,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,mBAAmB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CACrF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,KAAc,EACd,IAAuB;IAEvB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,MAAM,KAAK,SAAS;QACzB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QAC1C,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QAC/C,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC/E,CAAC","sourcesContent":["import { snapshotClosedArray, snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isMaintenanceCommitId, isMaintenanceReminderId } from \"./final-data.ts\";\n\nconst MAINTENANCE_REMINDER_ENTRY_KEYS: readonly string[] = [\n  \"id\",\n  \"baseCommit\",\n  \"limits\",\n  \"message\",\n  \"mode\"\n];\nconst MAINTENANCE_REMINDER_LIMIT_KEYS: readonly string[] = [\"commits\", \"changedLines\"];\nconst MAINTENANCE_REMINDER_GIT_KEYS: readonly string[] = [\"executable\"];\n\nexport function validEntries(value: unknown): boolean {\n  const entries = snapshotClosedArray(value);\n  if (entries === undefined) return false;\n  const identifiers = new Set<string>();\n  return entries.every((candidate) => {\n    const entry = snapshotClosedRecord(candidate);\n    if (entry === undefined || !validEntry(entry)) return false;\n    const identifier = entry.id;\n    if (typeof identifier !== \"string\" || identifiers.has(identifier)) return false;\n    identifiers.add(identifier);\n    return true;\n  });\n}\n\nfunction validEntry(entry: Readonly<Record<string, unknown>>): boolean {\n  return (\n    hasExpectedEntryKeys(entry) &&\n    validEntryIdentity(entry) &&\n    validLimits(entry.limits) &&\n    validEntryMode(entry)\n  );\n}\n\nfunction hasExpectedEntryKeys(entry: Readonly<Record<string, unknown>>): boolean {\n  return (\n    Object.keys(entry).every((key) => MAINTENANCE_REMINDER_ENTRY_KEYS.includes(key)) &&\n    [\"id\", \"baseCommit\", \"limits\", \"message\"].every((key) => Object.hasOwn(entry, key))\n  );\n}\n\nfunction validEntryIdentity(entry: Readonly<Record<string, unknown>>): boolean {\n  return (\n    isMaintenanceReminderId(entry.id) &&\n    isMaintenanceCommitId(entry.baseCommit) &&\n    typeof entry.message === \"string\" &&\n    entry.message.length > 0\n  );\n}\n\nfunction validEntryMode(entry: Readonly<Record<string, unknown>>): boolean {\n  return !Object.hasOwn(entry, \"mode\") || entry.mode === \"advisory\" || entry.mode === \"enforcing\";\n}\n\nexport function validGit(value: unknown): boolean {\n  const git = exactRecord(value, MAINTENANCE_REMINDER_GIT_KEYS);\n  return git !== undefined && typeof git.executable === \"string\" && git.executable.length > 0;\n}\n\nfunction validLimits(value: unknown): boolean {\n  const limits = snapshotClosedRecord(value);\n  if (limits === undefined) return false;\n  const keys = Object.keys(limits);\n  return (\n    keys.length > 0 &&\n    keys.every((key) => MAINTENANCE_REMINDER_LIMIT_KEYS.includes(key)) &&\n    (!Object.hasOwn(limits, \"commits\") || positiveSafeInteger(limits.commits)) &&\n    (!Object.hasOwn(limits, \"changedLines\") || positiveSafeInteger(limits.changedLines))\n  );\n}\n\nexport function exactRecord(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  return record !== undefined &&\n    Object.keys(record).length === keys.length &&\n    keys.every((key) => Object.hasOwn(record, key))\n    ? record\n    : undefined;\n}\n\nfunction positiveSafeInteger(value: unknown): value is number {\n  return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n"]}

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

@@ -0,0 +1,55 @@
+import { defineCheck } from "../../check/check.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 可分别省略。
+ * @returns 固定 `markdown-link-validation` identity、完整冻结 options、parser 与执行逻辑。
+ * @throws {TypeError} input 含未知字段、非法 target policy 或非法 work limit 时抛出。
+ * @example 离线 Markdown 本地链接完整性
+ * ```ts
+ * import { defineConfig, markdownLinkValidation, run } from "@zxyycom/vibe-check";
+ *
+ * const definition = defineConfig({
+ *   checks: [markdownLinkValidation()],
+ *   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);
+    if (resolvedOptions === undefined) {
+        throw new TypeError("markdownLinkValidation options must match the documented closed policy");
+    }
+    return defineCheck({
+        ...MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION,
+        execution: executeMarkdownLinkValidation,
+        parseData: parseMarkdownLinkValidationData,
+        preflight: (preparedOptions) => validMarkdownLinkValidationOptions(preparedOptions)
+            ? { status: "success", preparedOptions }
+            : {
+                status: "failure",
+                action: "block",
+                reason: { code: "invalid-options" },
+                messages: [
+                    {
+                        code: "invalid-options",
+                        level: "error",
+                        message: "markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options."
+                    }
+                ]
+            },
+        options: resolvedOptions
+    });
+}
+//# sourceMappingURL=default-check.mjs.map

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

@@ -0,0 +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;;;;;;;;;;;;;;;;;;;;;;GAsBG;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 可分别省略。\n * @returns 固定 `markdown-link-validation` identity、完整冻结 options、parser 与执行逻辑。\n * @throws {TypeError} input 含未知字段、非法 target policy 或非法 work limit 时抛出。\n * @example 离线 Markdown 本地链接完整性\n * ```ts\n * import { defineConfig, markdownLinkValidation, run } from \"@zxyycom/vibe-check\";\n *\n * const definition = defineConfig({\n *   checks: [markdownLinkValidation()],\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"]}