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

@zxyycom/vibe-check 0.0.1 → 0.0.3

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

Files changed (1190) hide show

package/dist/esm/package-checks/local-cache-options.mjs.map ADDED Viewed

@@ -0,0 +1 @@

+ {"version":3,"file":"local-cache-options.mjs","sourceRoot":"","sources":["../../../src/package-checks/local-cache-options.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EAC1B,MAAM,mCAAmC,CAAC;AAO3C,MAAM,UAAU,gCAAgC,CAAC,KAAc;IAC7D,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAc,EAAE,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC1C,IAAI,uBAAuB,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK;QACxE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAc,EAAE,CAAC,CAAC;IACpD,IACE,uBAAuB,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QACxD,KAAK,CAAC,OAAO,KAAK,IAAI;QACtB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;QAEnC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAa,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC/E,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc;IACnD,MAAM,QAAQ,GAAG,yBAAyB,CAAC,KAAK,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAC/D,IAAI,QAAQ,EAAE,OAAO,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC;IAC7C,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3E,OAAO,CACL,OAAO,EAAE,OAAO,KAAK,IAAI;QACzB,OAAO,OAAO,CAAC,SAAS,KAAK,QAAQ;QACrC,OAAO,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAC5B,CAAC,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC;QACjC,UAAU,CAAC,OAAO,CAAC,SAAS,CAAC,CAC9B,CAAC;AACJ,CAAC","sourcesContent":["import { isAbsolute } from \"node:path\";\n\nimport {\n hasExactPlainRecordKeys,\n snapshotClosedRecord,\n snapshotExactClosedRecord\n} from \"../data-boundary/closed-values.ts\";\n\n/** Shared closed grammar for an explicitly owned, deletable local cache directory. */\nexport type LocalCacheOptions =\n | Readonly<{ readonly enabled: false }>\n | Readonly<{ readonly enabled: true; readonly directory: string }>;\n\nexport function resolveOptionalLocalCacheOptions(value: unknown): LocalCacheOptions | undefined {\n if (value === undefined) return Object.freeze({ enabled: false as const });\n const cache = snapshotClosedRecord(value);\n if (cache === undefined) return undefined;\n if (hasExactPlainRecordKeys(cache, [\"enabled\"]) && cache.enabled === false)\n return Object.freeze({ enabled: false as const });\n if (\n hasExactPlainRecordKeys(cache, [\"enabled\", \"directory\"]) &&\n cache.enabled === true &&\n typeof cache.directory === \"string\"\n )\n return Object.freeze({ enabled: true as const, directory: cache.directory });\n return undefined;\n}\n\nexport function validLocalCacheOptions(value: unknown): value is LocalCacheOptions {\n const disabled = snapshotExactClosedRecord(value, [\"enabled\"]);\n if (disabled?.enabled === false) return true;\n const enabled = snapshotExactClosedRecord(value, [\"enabled\", \"directory\"]);\n return (\n enabled?.enabled === true &&\n typeof enabled.directory === \"string\" &&\n enabled.directory.length > 0 &&\n !enabled.directory.includes(\"\\0\") &&\n isAbsolute(enabled.directory)\n );\n}\n"]}

package/dist/esm/package-checks/maintenance-reminders/final-data.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/final-data.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport {\n exactFinalDataRecord,\n finalDataArray,\n invalidFinalData,\n nonNegativeSafeInteger\n} from \"../final-data-parsing.ts\";\n\nconst EMPTY_EXCEEDED: readonly [] = Object.freeze([]);\n\nconst FULL_COMMIT_ID = /^(?:[0-9a-f]{40}\|[0-9a-f]{64})$/i;\nconst REMINDER_ID = /^[a-z][a-z0-9](?:-[a-z0-9]+)$/;\n\n/** 单条维护提醒无法测量时使用的稳定 reason code。 /\nexport const MAINTENANCE_REMINDER_UNAVAILABLE_REASON = Object.freeze({\n baseCommitUnavailable: \"base-commit-unavailable\",\n baseNotFirstParentAncestor: \"base-not-first-parent-ancestor\",\n firstParentHistoryInvalid: \"first-parent-history-invalid\",\n firstParentHistoryUnavailable: \"first-parent-history-unavailable\",\n headInvalid: \"head-invalid\",\n headUnavailable: \"head-unavailable\",\n numstatInvalid: \"numstat-invalid\",\n numstatUnavailable: \"numstat-unavailable\"\n} as const);\n\nexport type MaintenanceReminderMode = \"advisory\" \| \"enforcing\";\n\n/* 单条维护提醒无法测量时保留在 final data 中的稳定 reason。 /\nexport type MaintenanceReminderUnavailableReason =\n (typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON)[keyof typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON];\n\nconst MAINTENANCE_REMINDER_UNAVAILABLE_REASONS: readonly MaintenanceReminderUnavailableReason[] =\n Object.freeze(Object.values(MAINTENANCE_REMINDER_UNAVAILABLE_REASON));\n\n/* 判断 unknown value 是否为维护提醒的稳定局部 ID。 /\nexport function isMaintenanceReminderId(value: unknown): value is string {\n return typeof value === \"string\" && REMINDER_ID.test(value);\n}\n\n/* 判断 unknown value 是否为 Git 的完整 SHA-1 或 SHA-256 commit ID。 /\nexport function isMaintenanceCommitId(value: unknown): value is string {\n return typeof value === \"string\" && FULL_COMMIT_ID.test(value);\n}\n\nexport type MeasuredMaintenanceReminderAssessment = Readonly<{\n readonly assessment: \"clear\" \| \"due\";\n readonly baseCommit: string;\n readonly changedLines: number;\n readonly commitCount: number;\n readonly exceeded: readonly (\"commits\" \| \"changed-lines\")[];\n readonly headCommit: string;\n readonly id: string;\n readonly mode: MaintenanceReminderMode;\n}>;\n\nexport type UnavailableMaintenanceReminderAssessment = Readonly<{\n readonly assessment: \"unavailable\";\n readonly baseCommit: string;\n readonly changedLines: null;\n readonly commitCount: null;\n readonly exceeded: readonly [];\n readonly headCommit: string \| null;\n readonly id: string;\n readonly mode: MaintenanceReminderMode;\n readonly reason: MaintenanceReminderUnavailableReason;\n}>;\n\n/* 单条维护提醒的 measured 或 unavailable discriminated assessment。 /\nexport type MaintenanceReminderAssessment =\n \| MeasuredMaintenanceReminderAssessment\n \| UnavailableMaintenanceReminderAssessment;\n\n/* `maintenance-reminders` 在 passed/failed outcome 中发布的主数据。 /\nexport interface MaintenanceRemindersFinalData {\n readonly entries: readonly MaintenanceReminderAssessment[];\n}\n\n/* 验证 discriminated entry assessments 并脱离 canonical final data。 */\nexport function parseMaintenanceRemindersData(data: unknown): MaintenanceRemindersFinalData {\n const value = exactFinalDataRecord(data, [\"entries\"], \"maintenanceReminders\");\n const entries = finalDataArray(value.entries, \"maintenanceReminders\");\n const parsedEntries: MaintenanceReminderAssessment[] = [];\n const ids = new Set<string>();\n for (const entry of entries) {\n const parsed = parseAssessment(entry);\n if (ids.has(parsed.id)) throw invalidFinalData(\"maintenanceReminders\");\n ids.add(parsed.id);\n parsedEntries.push(parsed);\n }\n return Object.freeze({ entries: Object.freeze(parsedEntries) });\n}\n\nfunction parseAssessment(value: unknown): MaintenanceReminderAssessment {\n const record = assessmentRecord(value);\n const identity = assessmentIdentity(record);\n if (record.assessment === \"unavailable\") {\n return parseUnavailableAssessment(record, identity);\n }\n return parseMeasuredAssessment(record, identity);\n}\n\nfunction assessmentRecord(value: unknown): Readonly<Record<string, unknown>> {\n return exactFinalDataRecord(\n value,\n valueAssessment(value) === \"unavailable\"\n ? unavailableAssessmentKeys()\n : measuredAssessmentKeys(),\n \"maintenanceReminders\"\n );\n}\n\nfunction unavailableAssessmentKeys(): readonly string[] {\n return [\n \"assessment\",\n \"baseCommit\",\n \"changedLines\",\n \"commitCount\",\n \"exceeded\",\n \"headCommit\",\n \"id\",\n \"mode\",\n \"reason\"\n ];\n}\n\nfunction measuredAssessmentKeys(): readonly string[] {\n return [\n \"assessment\",\n \"baseCommit\",\n \"changedLines\",\n \"commitCount\",\n \"exceeded\",\n \"headCommit\",\n \"id\",\n \"mode\"\n ];\n}\n\nfunction assessmentIdentity(record: Readonly<Record<string, unknown>>): Readonly<{\n readonly baseCommit: string;\n readonly id: string;\n readonly mode: MaintenanceReminderMode;\n}> {\n const id = isMaintenanceReminderId(record.id) ? record.id : undefined;\n const mode = record.mode === \"advisory\" \|\| record.mode === \"enforcing\" ? record.mode : undefined;\n const baseCommit = isMaintenanceCommitId(record.baseCommit) ? record.baseCommit : undefined;\n if (id === undefined \|\| mode === undefined \|\| baseCommit === undefined)\n throw invalidFinalData(\"maintenanceReminders\");\n return { baseCommit, id, mode };\n}\n\nfunction parseMeasuredAssessment(\n record: Readonly<Record<string, unknown>>,\n identity: Readonly<{\n readonly baseCommit: string;\n readonly id: string;\n readonly mode: MaintenanceReminderMode;\n }>\n): MeasuredMaintenanceReminderAssessment {\n if (record.assessment !== \"clear\" && record.assessment !== \"due\")\n throw invalidFinalData(\"maintenanceReminders\");\n const commitCount = nonNegativeSafeInteger(record.commitCount);\n const changedLines = nonNegativeSafeInteger(record.changedLines);\n const headCommit = isMaintenanceCommitId(record.headCommit) ? record.headCommit : undefined;\n const exceeded = parseExceeded(record.exceeded);\n if (\n commitCount === undefined \|\|\n changedLines === undefined \|\|\n headCommit === undefined \|\|\n exceeded === undefined \|\|\n (record.assessment === \"clear\" ? exceeded.length !== 0 : exceeded.length === 0)\n ) {\n throw invalidFinalData(\"maintenanceReminders\");\n }\n return Object.freeze({\n assessment: record.assessment,\n baseCommit: identity.baseCommit,\n changedLines,\n commitCount,\n exceeded,\n headCommit,\n id: identity.id,\n mode: identity.mode\n });\n}\n\nfunction parseUnavailableAssessment(\n record: Readonly<Record<string, unknown>>,\n identity: Readonly<{\n readonly baseCommit: string;\n readonly id: string;\n readonly mode: MaintenanceReminderMode;\n }>\n): UnavailableMaintenanceReminderAssessment {\n const exceeded = finalDataArray(record.exceeded, \"maintenanceReminders\");\n const headCommit = record.headCommit;\n if (\n record.changedLines !== null \|\|\n record.commitCount !== null \|\|\n exceeded.length !== 0 \|\|\n (headCommit !== null && !isMaintenanceCommitId(headCommit)) \|\|\n !isUnavailableReason(record.reason)\n ) {\n throw invalidFinalData(\"maintenanceReminders\");\n }\n return Object.freeze({\n assessment: \"unavailable\",\n baseCommit: identity.baseCommit,\n changedLines: null,\n commitCount: null,\n exceeded: EMPTY_EXCEEDED,\n headCommit,\n id: identity.id,\n mode: identity.mode,\n reason: record.reason\n });\n}\n\nfunction valueAssessment(value: unknown): unknown {\n return snapshotClosedRecord(value)?.assessment;\n}\n\nfunction parseExceeded(value: unknown): readonly (\"commits\" \| \"changed-lines\")[] \| undefined {\n const entries = finalDataArray(value, \"maintenanceReminders\");\n const exceeded: (\"commits\" \| \"changed-lines\")[] = [];\n const uniqueEntries = new Set<string>();\n for (const entry of entries) {\n if ((entry !== \"commits\" && entry !== \"changed-lines\") \|\| uniqueEntries.has(entry)) {\n return undefined;\n }\n uniqueEntries.add(entry);\n exceeded.push(entry);\n }\n return Object.freeze(exceeded);\n}\n\nfunction isUnavailableReason(value: unknown): value is MaintenanceReminderUnavailableReason {\n return MAINTENANCE_REMINDER_UNAVAILABLE_REASONS.some((reason) => reason === value);\n}\n"]}
1	+ {"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/final-data.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport {\n exactFinalDataRecord,\n finalDataArray,\n invalidFinalData,\n nonNegativeSafeInteger\n} from \"../final-data-parsing.ts\";\n\nconst EMPTY_EXCEEDED: readonly [] = Object.freeze([]);\n\nconst FULL_COMMIT_ID = /^(?:[0-9a-f]{40}\|[0-9a-f]{64})$/i;\nconst REMINDER_ID = /^[a-z][a-z0-9](?:-[a-z0-9]+)$/;\n\n/** 单条维护提醒无法测量时使用的稳定 reason code。 /\nexport const MAINTENANCE_REMINDER_UNAVAILABLE_REASON = Object.freeze({\n baseCommitUnavailable: \"base-commit-unavailable\",\n baseNotFirstParentAncestor: \"base-not-first-parent-ancestor\",\n firstParentHistoryInvalid: \"first-parent-history-invalid\",\n firstParentHistoryUnavailable: \"first-parent-history-unavailable\",\n headInvalid: \"head-invalid\",\n headUnavailable: \"head-unavailable\",\n numstatInvalid: \"numstat-invalid\",\n numstatUnavailable: \"numstat-unavailable\"\n} as const);\n\nexport type MaintenanceReminderMode = \"advisory\" \| \"enforcing\";\n\n/* 单条维护提醒无法测量时保留在 final data 中的稳定 reason。 /\nexport type MaintenanceReminderUnavailableReason =\n (typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON)[keyof typeof MAINTENANCE_REMINDER_UNAVAILABLE_REASON];\n\nconst MAINTENANCE_REMINDER_UNAVAILABLE_REASONS: readonly MaintenanceReminderUnavailableReason[] =\n Object.freeze(Object.values(MAINTENANCE_REMINDER_UNAVAILABLE_REASON));\n\n/* 判断 unknown value 是否为维护提醒的稳定局部 ID。 /\nexport function isMaintenanceReminderId(value: unknown): value is string {\n return typeof value === \"string\" && REMINDER_ID.test(value);\n}\n\n/* 判断 unknown value 是否为 Git 的完整 SHA-1 或 SHA-256 commit ID。 /\nexport function isMaintenanceCommitId(value: unknown): value is string {\n return typeof value === \"string\" && FULL_COMMIT_ID.test(value);\n}\n\nexport type MeasuredMaintenanceReminderAssessment = Readonly<{\n /* 未超过任何阈值时为 clear；至少严格超过一个阈值时为 due。 /\n readonly assessment: \"clear\" \| \"due\";\n /* reminder 配置锁定的完整基线 commit ID。 /\n readonly baseCommit: string;\n /* first-parent 区间内 numstat additions 与 deletions 的总和。 /\n readonly changedLines: number;\n /* 从 HEAD 沿 first-parent 到 baseCommit 的 commit 数。 /\n readonly commitCount: number;\n /* 实际值严格超过配置上限的维度；clear assessment 时为空。 /\n readonly exceeded: readonly (\"commits\" \| \"changed-lines\")[];\n /* 测量时 HEAD 的完整 commit ID。 /\n readonly headCommit: string;\n /* Definition 中该 reminder 的稳定局部 ID。 /\n readonly id: string;\n /* due 或 unavailable 是否阻断 Check 的配置模式。 /\n readonly mode: MaintenanceReminderMode;\n}>;\n\nexport type UnavailableMaintenanceReminderAssessment = Readonly<{\n /* 表示该 reminder 未能形成计数测量。 /\n readonly assessment: \"unavailable\";\n /* reminder 配置锁定的完整基线 commit ID。 /\n readonly baseCommit: string;\n /* unavailable assessment 不发布 partial changed-line count。 /\n readonly changedLines: null;\n /* unavailable assessment 不发布 partial commit count。 /\n readonly commitCount: null;\n /* unavailable assessment 不判定任何阈值已超过。 /\n readonly exceeded: readonly [];\n /* 已成功解析时的完整 HEAD commit ID；解析 HEAD 失败时为 null。 /\n readonly headCommit: string \| null;\n /* Definition 中该 reminder 的稳定局部 ID。 /\n readonly id: string;\n /* due 或 unavailable 是否阻断 Check 的配置模式。 /\n readonly mode: MaintenanceReminderMode;\n /* 未能测量的稳定机器可读原因。 /\n readonly reason: MaintenanceReminderUnavailableReason;\n}>;\n\n/* 单条维护提醒的 measured 或 unavailable discriminated assessment。 /\nexport type MaintenanceReminderAssessment =\n \| MeasuredMaintenanceReminderAssessment\n \| UnavailableMaintenanceReminderAssessment;\n\n/* `maintenance-reminders` 在 passed/failed outcome 中发布的主数据。 /\nexport interface MaintenanceRemindersFinalData {\n /* 每个已配置 reminder 的唯一 assessment，按 Definition 顺序发布。 /\n readonly entries: readonly MaintenanceReminderAssessment[];\n}\n\n/* 验证 discriminated entry assessments 并脱离 canonical final data。 */\nexport function parseMaintenanceRemindersData(data: unknown): MaintenanceRemindersFinalData {\n const value = exactFinalDataRecord(data, [\"entries\"], \"maintenanceReminders\");\n const entries = finalDataArray(value.entries, \"maintenanceReminders\");\n const parsedEntries: MaintenanceReminderAssessment[] = [];\n const ids = new Set<string>();\n for (const entry of entries) {\n const parsed = parseAssessment(entry);\n if (ids.has(parsed.id)) throw invalidFinalData(\"maintenanceReminders\");\n ids.add(parsed.id);\n parsedEntries.push(parsed);\n }\n return Object.freeze({ entries: Object.freeze(parsedEntries) });\n}\n\nfunction parseAssessment(value: unknown): MaintenanceReminderAssessment {\n const record = assessmentRecord(value);\n const identity = assessmentIdentity(record);\n if (record.assessment === \"unavailable\") {\n return parseUnavailableAssessment(record, identity);\n }\n return parseMeasuredAssessment(record, identity);\n}\n\nfunction assessmentRecord(value: unknown): Readonly<Record<string, unknown>> {\n return exactFinalDataRecord(\n value,\n valueAssessment(value) === \"unavailable\"\n ? unavailableAssessmentKeys()\n : measuredAssessmentKeys(),\n \"maintenanceReminders\"\n );\n}\n\nfunction unavailableAssessmentKeys(): readonly string[] {\n return [\n \"assessment\",\n \"baseCommit\",\n \"changedLines\",\n \"commitCount\",\n \"exceeded\",\n \"headCommit\",\n \"id\",\n \"mode\",\n \"reason\"\n ];\n}\n\nfunction measuredAssessmentKeys(): readonly string[] {\n return [\n \"assessment\",\n \"baseCommit\",\n \"changedLines\",\n \"commitCount\",\n \"exceeded\",\n \"headCommit\",\n \"id\",\n \"mode\"\n ];\n}\n\nfunction assessmentIdentity(record: Readonly<Record<string, unknown>>): Readonly<{\n readonly baseCommit: string;\n readonly id: string;\n readonly mode: MaintenanceReminderMode;\n}> {\n const id = isMaintenanceReminderId(record.id) ? record.id : undefined;\n const mode = record.mode === \"advisory\" \|\| record.mode === \"enforcing\" ? record.mode : undefined;\n const baseCommit = isMaintenanceCommitId(record.baseCommit) ? record.baseCommit : undefined;\n if (id === undefined \|\| mode === undefined \|\| baseCommit === undefined)\n throw invalidFinalData(\"maintenanceReminders\");\n return { baseCommit, id, mode };\n}\n\nfunction parseMeasuredAssessment(\n record: Readonly<Record<string, unknown>>,\n identity: Readonly<{\n readonly baseCommit: string;\n readonly id: string;\n readonly mode: MaintenanceReminderMode;\n }>\n): MeasuredMaintenanceReminderAssessment {\n if (record.assessment !== \"clear\" && record.assessment !== \"due\")\n throw invalidFinalData(\"maintenanceReminders\");\n const commitCount = nonNegativeSafeInteger(record.commitCount);\n const changedLines = nonNegativeSafeInteger(record.changedLines);\n const headCommit = isMaintenanceCommitId(record.headCommit) ? record.headCommit : undefined;\n const exceeded = parseExceeded(record.exceeded);\n if (\n commitCount === undefined \|\|\n changedLines === undefined \|\|\n headCommit === undefined \|\|\n exceeded === undefined \|\|\n (record.assessment === \"clear\" ? exceeded.length !== 0 : exceeded.length === 0)\n ) {\n throw invalidFinalData(\"maintenanceReminders\");\n }\n return Object.freeze({\n assessment: record.assessment,\n baseCommit: identity.baseCommit,\n changedLines,\n commitCount,\n exceeded,\n headCommit,\n id: identity.id,\n mode: identity.mode\n });\n}\n\nfunction parseUnavailableAssessment(\n record: Readonly<Record<string, unknown>>,\n identity: Readonly<{\n readonly baseCommit: string;\n readonly id: string;\n readonly mode: MaintenanceReminderMode;\n }>\n): UnavailableMaintenanceReminderAssessment {\n const exceeded = finalDataArray(record.exceeded, \"maintenanceReminders\");\n const headCommit = record.headCommit;\n if (\n record.changedLines !== null \|\|\n record.commitCount !== null \|\|\n exceeded.length !== 0 \|\|\n (headCommit !== null && !isMaintenanceCommitId(headCommit)) \|\|\n !isUnavailableReason(record.reason)\n ) {\n throw invalidFinalData(\"maintenanceReminders\");\n }\n return Object.freeze({\n assessment: \"unavailable\",\n baseCommit: identity.baseCommit,\n changedLines: null,\n commitCount: null,\n exceeded: EMPTY_EXCEEDED,\n headCommit,\n id: identity.id,\n mode: identity.mode,\n reason: record.reason\n });\n}\n\nfunction valueAssessment(value: unknown): unknown {\n return snapshotClosedRecord(value)?.assessment;\n}\n\nfunction parseExceeded(value: unknown): readonly (\"commits\" \| \"changed-lines\")[] \| undefined {\n const entries = finalDataArray(value, \"maintenanceReminders\");\n const exceeded: (\"commits\" \| \"changed-lines\")[] = [];\n const uniqueEntries = new Set<string>();\n for (const entry of entries) {\n if ((entry !== \"commits\" && entry !== \"changed-lines\") \|\| uniqueEntries.has(entry)) {\n return undefined;\n }\n uniqueEntries.add(entry);\n exceeded.push(entry);\n }\n return Object.freeze(exceeded);\n}\n\nfunction isUnavailableReason(value: unknown): value is MaintenanceReminderUnavailableReason {\n return MAINTENANCE_REMINDER_UNAVAILABLE_REASONS.some((reason) => reason === value);\n}\n"]}

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

@@ -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 CHANGED Viewed

	@@ -1 +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"]}
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 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 CHANGED Viewed

@@ -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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"maintenance-support.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/maintenance-support.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAI3C,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,KAK5B;IACC,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAEvD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,IAAI,OAAO,GAAG,KAAK,CAAC;QACpB,IAAI,WAAW,GAAG,CAAC,CAAC;QACpB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,UAAU,GAAG,KAAK,CAAC;QACvB,IAAI,KAA+B,CAAC;QAEpC,MAAM,MAAM,GAAG,CAAC,MAAwB,EAAQ,EAAE;YAChD,IAAI,OAAO;gBAAE,OAAO;YACpB,OAAO,GAAG,IAAI,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;YACjD,OAAO,CAAC,MAAM,CAAC,CAAC;QAClB,CAAC,CAAC;QACF,MAAM,KAAK,GAAG,GAAS,EAAE;YACvB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,CAAC;QAEF,IAAI,CAAC;YACH,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE;gBAC1C,GAAG,EAAE,KAAK,CAAC,WAAW;gBACtB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;gBACnC,WAAW,EAAE,IAAI;aAClB,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC3B,OAAO;QACT,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9D,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAsB,EAAE,EAAE;YAClD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;YAC3B,WAAW,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,WAAW,GAAG,oBAAoB,EAAE,CAAC;gBACvC,UAAU,GAAG,IAAI,CAAC;gBAClB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBACtB,OAAO;YACT,CAAC;YACD,MAAM,IAAI,IAAI,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,~~CACvB,~~MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,~~CAC1E~~,CAAC;~~QACF~~,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YAC7B,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACzB,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;YAChC,CAAC;iBAAM,IAAI,UAAU,IAAI,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtC,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC7B,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;YACxC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC","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"]}
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/markdown-link-validation/default-check.mjs CHANGED Viewed

@@ -1,41 +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 可分别省略。
- * @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);
+    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 CHANGED Viewed

	@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;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"]}
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,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 CHANGED Viewed

@@ -1,9 +1,12 @@
 import path from "node:path";
 import { collectProjectFiles } from "../project-files/collection.mjs";
 import { partitionProjectFilesByEligibility } from "../project-files/input-eligibility.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";
 import { settledMarkdownTraversalResult } from "./traversal-result.mjs";
+import { markdownLinkUnavailableMessage } from "./unavailable-reasons.mjs";
 import { validMarkdownLinkValidationOptions } from "./options-validation.mjs";
 export const MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION = {
     checkId: "markdown-link-validation",
@@ -16,25 +19,35 @@ export async function executeMarkdownLinkValidation(context) {
     const prepared = await prepareMarkdownTraversal(context);
     if (prepared.kind === "result")
         return prepared.result;
-    const { rejectedInputCount, traversal, resolver } = prepared;
+    const { rejectedPaths, traversal, resolver } = prepared;
     for (const candidate of traversal.candidates) {
         context.records.report({ id: candidate.id }, candidate.data);
     }
-    return settledMarkdownTraversalResult({
+    return appendCheckMessages(settledMarkdownTraversalResult({
         findingCount: traversal.candidates.length,
         findingPolicy: context.options.findingPolicy,
         occurrenceCount: traversal.occurrenceCount,
-        rejectedInputCount,
+        rejectedInputCount: rejectedPaths.length,
         sourceFileCount: traversal.sourceFileCount,
         targetReadCount: resolver.targetReadCount
-    });
+    }), markdownFindingMessages(traversal.candidates, rejectedPaths, context.options.findingPolicy === "blocking"));
 }
 async function prepareMarkdownTraversal(context) {
     if (context.signal.aborted)
         return result(unavailable("cancelled"));
-    const created = await createMarkdownLocalResolver(context.project.root, context.options.limits.maxTargetReads);
+    const created = await createMarkdownLocalResolver(context.project.root, context.options.limits.maxTargetReads, context.options.cache, context.signal);
     if (!created.ok)
         return result(unavailable(created.reason));
+    let prepared;
+    try {
+        prepared = await prepareCreatedMarkdownTraversal(context, created.resolver);
+    }
+    finally {
+        await created.resolver.finalize();
+    }
+    return context.signal.aborted ? result(unavailable("cancelled")) : prepared;
+}
+async function prepareCreatedMarkdownTraversal(context, resolver) {
     if (context.signal.aborted)
         return result(unavailable("cancelled"));
     const sourceDiscovery = discoverMarkdownSourcePaths(context.project, context.options.files);
@@ -46,7 +59,7 @@ async function prepareMarkdownTraversal(context) {
         return result(unavailable("cancelled"));
     reportRejectedInputs(context, sourceDiscovery.rejectedPaths);
     const traversal = await traverseMarkdownSources(sourceDiscovery.sourcePaths, {
-        resolver: created.resolver,
+        resolver,
         options: context.options,
         signal: context.signal
     });
@@ -58,8 +71,8 @@ async function prepareMarkdownTraversal(context) {
     }
     return Object.freeze({
         kind: "traversal",
-        rejectedInputCount: sourceDiscovery.rejectedPaths.length,
-        resolver: created.resolver,
+        rejectedPaths: sourceDiscovery.rejectedPaths,
+        resolver,
         traversal
     });
 }
@@ -112,6 +125,7 @@ async function traverseMarkdownSources(sourcePaths, run) {
     const candidates = [];
     let occurrenceCount = 0;
     let sourceFileCount = 0;
+    // The Run's shared Scheduler owns cross-Check concurrency; this Check processes sources strictly in order.
     for (const sourcePath of sourcePaths) {
         const sourceValidation = await validateMarkdownSource(sourcePath, occurrenceCount, run);
         if (sourceValidation.kind === "unavailable")
@@ -177,23 +191,12 @@ function unavailable(reason) {
         status: "unavailable",
         reason: { code: reason },
         messages: Object.freeze([
-            Object.freeze({ code: reason, level: "error", message: unavailableMessage(reason) })
+            Object.freeze({
+                code: reason,
+                level: "error",
+                message: markdownLinkUnavailableMessage(reason)
+            })
         ])
     });
 }
-function unavailableMessage(reason) {
-    return UNAVAILABLE_MESSAGES[reason];
-}
-const UNAVAILABLE_MESSAGES = {
-    "invalid-options": "markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options.",
-    "project-root-unavailable": "Markdown link validation could not resolve the project root; check that the path exists and is accessible.",
-    "source-unavailable": "A selected Markdown source could not be collected, read, decoded, or contained safely; check the file source and permissions.",
-    "source-too-large": "A selected Markdown source exceeds maxMarkdownBytes; narrow the file selection or raise the bounded limit.",
-    "markdown-parse-failed": "A selected Markdown source could not be parsed completely; inspect that document's Markdown syntax and encoding.",
-    "invalid-local-destination": "A local Markdown destination could not be parsed safely; inspect the affected link destination syntax.",
-    "target-unavailable": "A local Markdown target could not be probed or read safely; check the target path, permissions, size, and encoding.",
-    "occurrence-limit-exceeded": "Markdown link validation exceeded maxOccurrences; narrow the source selection or raise the bounded limit.",
-    "target-read-limit-exceeded": "Markdown link validation exceeded maxTargetReads; narrow the source selection or raise the bounded limit.",
-    cancelled: "Markdown link validation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate."
-};
 //# sourceMappingURL=execution.mjs.map

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

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