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

@zxyycom/vibe-check 0.0.1 → 0.0.2

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 (950) hide show

package/dist/esm/package-checks/json-validation/options-validation.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/json-validation/options-validation.ts"],"names":[],"mappings":"AAAA,OAAO,~~EACL~~,~~uBAAuB~~,~~EACvB~~,~~oBAAoB,EACrB,~~MAAM,sCAAsC,CAAC;~~AAC9C~~,OAAO,EAAE,~~yBAAyB~~,EAAE,MAAM,~~mCAAmC~~,CAAC;~~AAG9E~~,~~SAAS,WAAW,CAClB,KAAc,EACd,IAAuB;IAEvB,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,~~OAAO,~~MAAM~~,~~KAAK~~,~~SAAS,IAAI,uBAAuB,CAAC,MAAM,~~EAAE,~~IAAI,CAAC,CAAC,CAAC,CAAC,~~MAAM,~~CAAC~~,CAAC~~,CAAC,SAAS,CAAC~~;~~AAC5F~~,~~CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,~~MAAM,~~CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,~~UAAU,0BAA0B,CAAC,KAAc;IACvD,MAAM,OAAO,GAAG,~~WAAW~~,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;~~IAC9D~~,OAAO,CACL,OAAO,KAAK,SAAS;QACrB,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,~~mBAAmB~~,CAAC,OAAO,CAAC,YAAY,CAAC,~~CAC1C~~,CAAC;AACJ,CAAC","sourcesContent":["import {~~\n hasExactPlainRecordKeys,\n snapshotClosedRecord\n~~} from \"../../data-boundary/closed-values.ts\";\nimport { ~~validProjectFileSelection~~ } from \"~~../project~~-~~files~~/~~configuration~~.ts\";\nimport ~~type~~ { ~~ResolvedJsonValidationOptions~~ } from \"~~./options~~.ts\";\~~n\nfunction~~ ~~exactRecord(\n value:~~ ~~unknown,\n keys: readonly string[]\n): Readonly<Record<string, unknown>> \| undefined~~ {~~\n const~~ ~~record~~ ~~= snapshotClosedRecord(value);\n return record !== undefined && hasExactPlainRecordKeys(record, keys) ? record : undefined;\n~~}~~\n\nfunction~~ ~~positiveSafeInteger(value:~~ ~~unknown): value is number {~~\~~n return typeof value === \~~"~~number~~\" ~~&& Number.isSafeInteger(value) && value > 0~~;\n}\n\nexport function validJsonValidationOptions(value: unknown): value is ResolvedJsonValidationOptions {\n const options = ~~exactRecord~~(value, [\"files\", \"maximumBytes\"]);\n return (\n options !== undefined &&\n validProjectFileSelection(options.files) &&\n ~~positiveSafeInteger~~(options.maximumBytes)\n );\n}\n"]}
1	+ {"version":3,"file":"options-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/json-validation/options-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAG9E,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,MAAM,OAAO,GAAG,yBAAyB,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IAC5E,OAAO,CACL,OAAO,KAAK,SAAS;QACrB,yBAAyB,CAAC,OAAO,CAAC,KAAK,CAAC;QACxC,qBAAqB,CAAC,OAAO,CAAC,YAAY,CAAC,CAC5C,CAAC;AACJ,CAAC","sourcesContent":["import { snapshotExactClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isPositiveSafeInteger } from \"../../data-boundary/value-shapes.ts\";\nimport { validProjectFileSelection } from \"../project-files/configuration.ts\";\nimport type { ResolvedJsonValidationOptions } from \"./options.ts\";\n\nexport function validJsonValidationOptions(value: unknown): value is ResolvedJsonValidationOptions {\n const options = snapshotExactClosedRecord(value, [\"files\", \"maximumBytes\"]);\n return (\n options !== undefined &&\n validProjectFileSelection(options.files) &&\n isPositiveSafeInteger(options.maximumBytes)\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":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EACL,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAElC,MAAM,cAAc,GAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAEtD,MAAM,cAAc,GAAG,kCAAkC,CAAC;AAC1D,MAAM,WAAW,GAAG,iCAAiC,CAAC;AAEtD,oCAAoC;AACpC,MAAM,CAAC,MAAM,uCAAuC,GAAG,MAAM,CAAC,MAAM,CAAC;IACnE,qBAAqB,EAAE,yBAAyB;IAChD,0BAA0B,EAAE,gCAAgC;IAC5D,yBAAyB,EAAE,8BAA8B;IACzD,6BAA6B,EAAE,kCAAkC;IACjE,WAAW,EAAE,cAAc;IAC3B,eAAe,EAAE,kBAAkB;IACnC,cAAc,EAAE,iBAAiB;IACjC,kBAAkB,EAAE,qBAAqB;CACjC,CAAC,CAAC;AAQZ,MAAM,wCAAwC,GAC5C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,uCAAuC,CAAC,CAAC,CAAC;AAExE,wCAAwC;AACxC,MAAM,UAAU,uBAAuB,CAAC,KAAc;IACpD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,cAAc,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAqDD,mEAAmE;AACnE,MAAM,UAAU,6BAA6B,CAAC,IAAa;IACzD,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,EAAE,sBAAsB,CAAC,CAAC;IAC9E,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,CAAC,OAAO,EAAE,sBAAsB,CAAC,CAAC;IACtE,MAAM,aAAa,GAAoC,EAAE,CAAC;IAC1D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,MAAM,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YAAE,MAAM,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;QACvE,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACvC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;IAC5C,IAAI,MAAM,CAAC,UAAU,KAAK,aAAa,EAAE,CAAC;QACxC,OAAO,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,uBAAuB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,oBAAoB,CACzB,KAAK,EACL,eAAe,CAAC,KAAK,CAAC,KAAK,aAAa;QACtC,CAAC,CAAC,yBAAyB,EAAE;QAC7B,CAAC,CAAC,sBAAsB,EAAE,EAC5B,sBAAsB,CACvB,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB;IAChC,OAAO;QACL,YAAY;QACZ,YAAY;QACZ,cAAc;QACd,aAAa;QACb,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,MAAM;QACN,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,sBAAsB;IAC7B,OAAO;QACL,YAAY;QACZ,YAAY;QACZ,cAAc;QACd,aAAa;QACb,UAAU;QACV,YAAY;QACZ,IAAI;QACJ,MAAM;KACP,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,MAAyC;IAKnE,MAAM,EAAE,GAAG,uBAAuB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,UAAU,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACjG,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,IAAI,EAAE,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,IAAI,UAAU,KAAK,SAAS;QACpE,MAAM,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,uBAAuB,CAC9B,MAAyC,EACzC,QAIE;IAEF,IAAI,MAAM,CAAC,UAAU,KAAK,OAAO,IAAI,MAAM,CAAC,UAAU,KAAK,KAAK;QAC9D,MAAM,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,sBAAsB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC/D,MAAM,YAAY,GAAG,sBAAsB,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,qBAAqB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5F,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAChD,IACE,WAAW,KAAK,SAAS;QACzB,YAAY,KAAK,SAAS;QAC1B,UAAU,KAAK,SAAS;QACxB,QAAQ,KAAK,SAAS;QACtB,CAAC,MAAM,CAAC,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAAC,EAC/E,CAAC;QACD,MAAM,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,YAAY;QACZ,WAAW;QACX,QAAQ;QACR,UAAU;QACV,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI;KACpB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,0BAA0B,CACjC,MAAyC,EACzC,QAIE;IAEF,MAAM,QAAQ,GAAG,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IACzE,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IACrC,IACE,MAAM,CAAC,YAAY,KAAK,IAAI;QAC5B,MAAM,CAAC,WAAW,KAAK,IAAI;QAC3B,QAAQ,CAAC,MAAM,KAAK,CAAC;QACrB,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QAC3D,CAAC,mBAAmB,CAAC,MAAM,CAAC,MAAM,CAAC,EACnC,CAAC;QACD,MAAM,gBAAgB,CAAC,sBAAsB,CAAC,CAAC;IACjD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,UAAU,EAAE,aAAa;QACzB,UAAU,EAAE,QAAQ,CAAC,UAAU;QAC/B,YAAY,EAAE,IAAI;QAClB,WAAW,EAAE,IAAI;QACjB,QAAQ,EAAE,cAAc;QACxB,UAAU;QACV,EAAE,EAAE,QAAQ,CAAC,EAAE;QACf,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;KACtB,CAAC,CAAC;AACL,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,oBAAoB,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,MAAM,OAAO,GAAG,cAAc,CAAC,KAAK,EAAE,sBAAsB,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAoC,EAAE,CAAC;IACrD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,eAAe,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACnF,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACzB,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,OAAO,wCAAwC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC;AACrF,CAAC","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/markdown-link-validation/default-check.mjs CHANGED Viewed

@@ -6,15 +6,21 @@ import { validMarkdownLinkValidationOptions } from "./options-validation.mjs";
 /**
  * 使用可省略的 source、target 与 work-limit policy 构造离线 Markdown 引用 Check。
  *
- * @param options - 省略字段由 package 补齐；files 数组是完整替换值，limits fields 可分别省略。
+ * @param options - 省略字段由 package 补齐；files 数组是完整替换值，limits fields 可分别省略；cache 省略时关闭，启用时由调用方提供 absolute、可信且可删除的 directory，其中本 Check 只维护一个 source-derived JSONL local state；调用方负责容量和删除，cache 不可用不改变 Check 结果。
  * @returns 固定 `markdown-link-validation` identity、完整冻结 options、parser 与执行逻辑。
- * @throws {TypeError} input 含未知字段、非法 target policy 或非法 work limit 时抛出。
+ * @throws {TypeError} input 含未知字段、非法 target policy、cache branch/directory 或非法 work limit 时抛出。
  * @example 离线 Markdown 本地链接完整性
  * ```ts
  * import { defineConfig, markdownLinkValidation, run } from "@zxyycom/vibe-check";
  *
+ * // 此调用方自有目录是 absolute、可删除的，并且可能保存 source-derived parse facts。
+ * const cacheDirectory = new URL(".vibe-check/markdown-link-parse-cache", import.meta.url).pathname;
  * const definition = defineConfig({
- *   checks: [markdownLinkValidation()],
+ *   checks: [
+ *     markdownLinkValidation({
+ *       cache: { enabled: true, directory: cacheDirectory }
+ *     })
+ *   ],
  *   outputs: {
  *     diagnosticLogging: { enabled: false },
  *     machinePublication: { enabled: false },

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,yCAAyC,EACzC,6BAA6B,EAC9B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAKlE,OAAO,EAAE,oCAAoC,EAAE,MAAM,yBAAyB,CAAC;AAC/E,OAAO,EAAE,kCAAkC,EAAE,MAAM,yBAAyB,CAAC;AAE7E;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAO,GAAkC,EAAE;IAM3C,MAAM,eAAe,GAAG,oCAAoC,CAAC,OAAO,CAAC,CAAC;IACtE,IAAI,eAAe,KAAK,SAAS,EAAE,CAAC;QAClC,MAAM,IAAI,SAAS,CAAC,wEAAwE,CAAC,CAAC;IAChG,CAAC;IACD,OAAO,WAAW,CAAC;QACjB,GAAG,yCAAyC;QAC5C,SAAS,EAAE,6BAA6B;QACxC,SAAS,EAAE,+BAA+B;QAC1C,SAAS,EAAE,CAAC,eAAe,EAAE,EAAE,CAC7B,kCAAkC,CAAC,eAAe,CAAC;YACjD,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE;YACxC,CAAC,CAAC;gBACE,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,OAAO;gBACf,MAAM,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE;gBACnC,QAAQ,EAAE;oBACR;wBACE,IAAI,EAAE,iBAAiB;wBACvB,KAAK,EAAE,OAAO;wBACd,OAAO,EACL,+IAA+I;qBAClJ;iBACF;aACF;QACP,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { defineCheck, type TypedCheckWithOptions } from \"../../check/check.ts\";\nimport {\n MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION,\n executeMarkdownLinkValidation\n} from \"./execution.ts\";\nimport { parseMarkdownLinkValidationData } from \"./final-data.ts\";\nimport type {\n MarkdownLinkValidationOptions,\n ResolvedMarkdownLinkValidationOptions\n} from \"./options.ts\";\nimport { resolveMarkdownLinkValidationOptions } from \"./options-resolution.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\n/*\n 使用可省略的 source、target 与 work-limit policy 构造离线 Markdown 引用 Check。\n \n @param options - 省略字段由 package 补齐；files 数组是完整替换值，limits fields 可分别省略；cache 省略时关闭，启用时由调用方提供 absolute、可信且可删除的 directory，其中本 Check 只维护一个 source-derived JSONL local state；调用方负责容量和删除，cache 不可用不改变 Check 结果。\n * @returns 固定 `markdown-link-validation` identity、完整冻结 options、parser 与执行逻辑。\n * @throws {TypeError} input 含未知字段、非法 target policy、cache branch/directory 或非法 work limit 时抛出。\n * @example 离线 Markdown 本地链接完整性\n * ```ts\n * import { defineConfig, markdownLinkValidation, run } from \"@zxyycom/vibe-check\";\n \n // 此调用方自有目录是 absolute、可删除的，并且可能保存 source-derived parse facts。\n * const cacheDirectory = new URL(\".vibe-check/markdown-link-parse-cache\", import.meta.url).pathname;\n * const definition = defineConfig({\n * checks: [\n * markdownLinkValidation({\n * cache: { enabled: true, directory: cacheDirectory }\n * })\n * ],\n * outputs: {\n * diagnosticLogging: { enabled: false },\n * machinePublication: { enabled: false },\n * progressRendering: { enabled: false }\n * }\n * });\n \n const result = await run(definition);\n * if (result.kind !== \"completed\") throw new Error(`Run did not complete: ${result.kind}`);\n * ```\n */\nexport function markdownLinkValidation(\n options: MarkdownLinkValidationOptions = {}\n): TypedCheckWithOptions<\n \"markdown-link-validation\",\n ResolvedMarkdownLinkValidationOptions,\n typeof parseMarkdownLinkValidationData\n> {\n const resolvedOptions = resolveMarkdownLinkValidationOptions(options);\n if (resolvedOptions === undefined) {\n throw new TypeError(\"markdownLinkValidation options must match the documented closed policy\");\n }\n return defineCheck({\n ...MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION,\n execution: executeMarkdownLinkValidation,\n parseData: parseMarkdownLinkValidationData,\n preflight: (preparedOptions) =>\n validMarkdownLinkValidationOptions(preparedOptions)\n ? { status: \"success\", preparedOptions }\n : {\n status: \"failure\",\n action: \"block\",\n reason: { code: \"invalid-options\" },\n messages: [\n {\n code: \"invalid-options\",\n level: \"error\",\n message:\n \"markdownLinkValidation options are invalid; recreate the Check with markdownLinkValidation(options) or restore its complete resolved options.\"\n }\n ]\n },\n options: resolvedOptions\n });\n}\n"]}

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 "../../check/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 \"../../check/finding-presentation.ts\";\nimport { createMarkdownLocalResolver, type MarkdownLocalResolver } from \"./local-resolver.ts\";\nimport type { MarkdownLinkValidationFinalData } from \"./final-data.ts\";\nimport { markdownFindingMessages } from \"./finding-messages.ts\";\nimport {\n buildMarkdownInputRejectedRecord,\n buildMarkdownLinkRecordCandidate,\n type MarkdownLinkRecordCandidate\n} from \"./records.ts\";\nimport { settledMarkdownTraversalResult } from \"./traversal-result.ts\";\nimport {\n markdownLinkUnavailableMessage,\n type MarkdownLinkValidationUnavailableReason\n} from \"./unavailable-reasons.ts\";\nimport { validMarkdownLinkValidationOptions } from \"./options-validation.ts\";\n\nexport type { MarkdownLinkValidationUnavailableReason } from \"./unavailable-reasons.ts\";\n\nexport const MARKDOWN_LINK_VALIDATION_CHECK_DEFINITION = {\n checkId: \"markdown-link-validation\",\n displayName: \"Markdown link validation\"\n} as const;\n\ninterface MarkdownLinkValidationRun {\n readonly options: ResolvedMarkdownLinkValidationOptions;\n readonly resolver: MarkdownLocalResolver;\n readonly signal: AbortSignal;\n}\n\ntype MarkdownLinkValidationUnavailable = Readonly<{\n readonly kind: \"unavailable\";\n readonly reason: MarkdownLinkValidationUnavailableReason;\n}>;\n\ntype MarkdownSourceDiscovery =\n \| Readonly<{\n readonly kind: \"complete\";\n readonly rejectedPaths: readonly string[];\n readonly selectedPathCount: number;\n readonly sourcePaths: readonly string[];\n }>\n \| MarkdownLinkValidationUnavailable;\n\ntype MarkdownSourceValidation =\n \| Readonly<{\n readonly kind: \"complete\";\n readonly candidates: readonly MarkdownLinkRecordCandidate[];\n readonly occurrenceCount: number;\n }>\n \| MarkdownLinkValidationUnavailable;\n\ntype MarkdownLinkTraversal =\n \| Readonly<{\n readonly kind: \"complete\";\n readonly candidates: readonly MarkdownLinkRecordCandidate[];\n readonly occurrenceCount: number;\n readonly sourceFileCount: number;\n }>\n \| MarkdownLinkValidationUnavailable;\n\n/** 验证本 Check 选中的 Markdown source 的离线本地链接完整性。 */\nexport async function executeMarkdownLinkValidation(\n context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>\n): Promise<CheckResult<MarkdownLinkValidationFinalData>> {\n if (!validMarkdownLinkValidationOptions(context.options)) return unavailable(\"invalid-options\");\n const prepared = await prepareMarkdownTraversal(context);\n if (prepared.kind === \"result\") return prepared.result;\n const { rejectedPaths, traversal, resolver } = prepared;\n\n for (const candidate of traversal.candidates) {\n context.records.report({ id: candidate.id }, candidate.data);\n }\n return appendCheckMessages(\n settledMarkdownTraversalResult({\n findingCount: traversal.candidates.length,\n findingPolicy: context.options.findingPolicy,\n occurrenceCount: traversal.occurrenceCount,\n rejectedInputCount: rejectedPaths.length,\n sourceFileCount: traversal.sourceFileCount,\n targetReadCount: resolver.targetReadCount\n }),\n markdownFindingMessages(\n traversal.candidates,\n rejectedPaths,\n context.options.findingPolicy === \"blocking\"\n )\n );\n}\n\ntype PreparedMarkdownTraversal =\n \| Readonly<{\n readonly kind: \"result\";\n readonly result: CheckResult<MarkdownLinkValidationFinalData>;\n }>\n \| Readonly<{\n readonly kind: \"traversal\";\n readonly rejectedPaths: readonly string[];\n readonly resolver: MarkdownLocalResolver;\n readonly traversal: Extract<MarkdownLinkTraversal, { readonly kind: \"complete\" }>;\n }>;\n\nasync function prepareMarkdownTraversal(\n context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>\n): Promise<PreparedMarkdownTraversal> {\n if (context.signal.aborted) return result(unavailable(\"cancelled\"));\n const created = await createMarkdownLocalResolver(\n context.project.root,\n context.options.limits.maxTargetReads,\n context.options.cache,\n context.signal\n );\n if (!created.ok) return result(unavailable(created.reason));\n let prepared: PreparedMarkdownTraversal;\n try {\n prepared = await prepareCreatedMarkdownTraversal(context, created.resolver);\n } finally {\n await created.resolver.finalize();\n }\n return context.signal.aborted ? result(unavailable(\"cancelled\")) : prepared;\n}\n\nasync function prepareCreatedMarkdownTraversal(\n context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>,\n resolver: MarkdownLocalResolver\n): Promise<PreparedMarkdownTraversal> {\n if (context.signal.aborted) return result(unavailable(\"cancelled\"));\n const sourceDiscovery = discoverMarkdownSourcePaths(context.project, context.options.files);\n if (sourceDiscovery.kind === \"unavailable\") return result(unavailable(sourceDiscovery.reason));\n if (sourceDiscovery.selectedPathCount === 0) return result(noEligibleInput());\n if (context.signal.aborted) return result(unavailable(\"cancelled\"));\n reportRejectedInputs(context, sourceDiscovery.rejectedPaths);\n const traversal = await traverseMarkdownSources(sourceDiscovery.sourcePaths, {\n resolver,\n options: context.options,\n signal: context.signal\n });\n if (traversal.kind === \"unavailable\") {\n return result(\n appendRejectedInputMessage(\n unavailable(traversal.reason),\n sourceDiscovery.rejectedPaths.length\n )\n );\n }\n if (context.signal.aborted) {\n return result(\n appendRejectedInputMessage(unavailable(\"cancelled\"), sourceDiscovery.rejectedPaths.length)\n );\n }\n return Object.freeze({\n kind: \"traversal\",\n rejectedPaths: sourceDiscovery.rejectedPaths,\n resolver,\n traversal\n });\n}\n\nfunction result(\n checkResult: CheckResult<MarkdownLinkValidationFinalData>\n): PreparedMarkdownTraversal {\n return Object.freeze({ kind: \"result\", result: checkResult });\n}\n\nfunction noEligibleInput(): CheckResult<MarkdownLinkValidationFinalData> {\n return Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } });\n}\n\nfunction discoverMarkdownSourcePaths(\n project: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>[\"project\"],\n files: ProjectFileSelection\n): MarkdownSourceDiscovery {\n try {\n const selectedPaths = collectProjectFiles(project.root, files);\n const partition = partitionProjectFilesByEligibility(selectedPaths, isMarkdownSourcePath);\n return Object.freeze({\n kind: \"complete\" as const,\n rejectedPaths: partition.rejectedPaths,\n selectedPathCount: selectedPaths.length,\n sourcePaths: partition.acceptedPaths\n });\n } catch {\n return unavailableValidation(\"source-unavailable\");\n }\n}\n\nfunction reportRejectedInputs(\n context: CheckExecutionContext<ResolvedMarkdownLinkValidationOptions>,\n paths: readonly string[]\n): void {\n for (const selectedPath of paths) {\n const record = buildMarkdownInputRejectedRecord(selectedPath);\n context.records.report({ id: record.id }, record.data);\n }\n}\n\nfunction appendRejectedInputMessage(\n checkResult: CheckResult<MarkdownLinkValidationFinalData>,\n rejectedInputCount: number\n): CheckResult<MarkdownLinkValidationFinalData> {\n if (rejectedInputCount === 0) return checkResult;\n return Object.freeze({\n ...checkResult,\n messages: Object.freeze([\n ...(checkResult.messages ?? []),\n Object.freeze({\n code: \"input-rejected\",\n level: \"warning\" as const,\n message: `${rejectedInputCount} selected markdownLinkValidation input file(s) were rejected because only .md/.markdown paths are supported; inspect this Check's Records and narrow files.include/exclude.`\n })\n ])\n });\n}\n\nfunction unavailableValidation(\n reason: MarkdownLinkValidationUnavailableReason\n): MarkdownLinkValidationUnavailable {\n return Object.freeze({ kind: \"unavailable\", reason });\n}\n\nasync function traverseMarkdownSources(\n sourcePaths: readonly string[],\n run: MarkdownLinkValidationRun\n): Promise<MarkdownLinkTraversal> {\n const candidates: MarkdownLinkRecordCandidate[] = [];\n let occurrenceCount = 0;\n let sourceFileCount = 0;\n\n // The Run's shared Scheduler owns cross-Check concurrency; this Check processes sources strictly in order.\n for (const sourcePath of sourcePaths) {\n const sourceValidation = await validateMarkdownSource(sourcePath, occurrenceCount, run);\n if (sourceValidation.kind === \"unavailable\") return sourceValidation;\n\n candidates.push(...sourceValidation.candidates);\n occurrenceCount = sourceValidation.occurrenceCount;\n sourceFileCount += 1;\n }\n\n return Object.freeze({\n kind: \"complete\" as const,\n candidates: Object.freeze(candidates),\n occurrenceCount,\n sourceFileCount\n });\n}\n\nasync function validateMarkdownSource(\n sourcePath: string,\n occurrenceCountBeforeSource: number,\n run: MarkdownLinkValidationRun\n): Promise<MarkdownSourceValidation> {\n if (run.signal.aborted) return unavailableValidation(\"cancelled\");\n const sourceRead = await run.resolver.readSource(sourcePath, run.options.limits.maxMarkdownBytes);\n if (run.signal.aborted) return unavailableValidation(\"cancelled\");\n if (!sourceRead.ok) return unavailableValidation(sourceRead.reason);\n\n const candidates: MarkdownLinkRecordCandidate[] = [];\n let occurrenceCount = occurrenceCountBeforeSource;\n for (const [occurrenceIndex, occurrence] of sourceRead.source.facts.occurrences.entries()) {\n if (run.signal.aborted) return unavailableValidation(\"cancelled\");\n occurrenceCount += 1;\n if (occurrenceCount > run.options.limits.maxOccurrences) {\n return unavailableValidation(\"occurrence-limit-exceeded\");\n }\n\n const resolution = await run.resolver.resolve({\n source: sourceRead.source,\n rawDestination: occurrence.rawDestination,\n rootExternalTargetMode: run.options.rootExternalTargetMode,\n requireExistingTargets: run.options.requireExistingTargets,\n requireNonEmptyDirectories: run.options.requireNonEmptyDirectories,\n validateSameDocumentAnchors: run.options.validateSameDocumentAnchors,\n validateCrossDocumentAnchors: run.options.validateCrossDocumentAnchors,\n maxMarkdownBytes: run.options.limits.maxMarkdownBytes\n });\n if (run.signal.aborted) return unavailableValidation(\"cancelled\");\n if (resolution.kind === \"unavailable\") return unavailableValidation(resolution.reason);\n const candidate = buildMarkdownLinkRecordCandidate(\n sourceRead.source.path,\n occurrenceIndex,\n occurrence,\n resolution\n );\n if (candidate !== undefined) candidates.push(candidate);\n }\n\n return Object.freeze({\n kind: \"complete\" as const,\n candidates: Object.freeze(candidates),\n occurrenceCount\n });\n}\n\nfunction isMarkdownSourcePath(filePath: string): boolean {\n const extension = path.extname(filePath).toLowerCase();\n return extension === \".md\" \|\| extension === \".markdown\";\n}\n\nfunction unavailable(\n reason: MarkdownLinkValidationUnavailableReason\n): CheckResult<MarkdownLinkValidationFinalData> {\n return Object.freeze({\n status: \"unavailable\",\n reason: { code: reason },\n messages: Object.freeze([\n Object.freeze({\n code: reason,\n level: \"error\" as const,\n message: markdownLinkUnavailableMessage(reason)\n })\n ])\n });\n}\n"]}

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

@@ -6,71 +6,88 @@ export async function probeRootContainedPath(canonicalProjectRoot, candidatePath
     if (!isWithinRoot(canonicalProjectRoot, candidatePath)) {
         return Object.freeze({ kind: "outside" });
     }
-    let pendingSegments = relativeSegments(canonicalProjectRoot, candidatePath);
-    let currentPath = canonicalProjectRoot;
-    let symlinkHops = 0;
-    while (pendingSegments.length > 0) {
-        const segment = pendingSegments.shift();
-        if (segment === undefined) {
-            return Object.freeze({ kind: "unavailable" });
-        }
-        const nextPath = path.join(currentPath, segment);
-        let status;
-        try {
-            status = await lstat(nextPath);
-        }
-        catch (error) {
-            if (isNotFound(error)) {
-                return Object.freeze({ kind: "missing", absolutePath: nextPath });
-            }
-            return Object.freeze({ kind: "unavailable" });
-        }
-        if (!status.isSymbolicLink()) {
-            currentPath = nextPath;
-            continue;
-        }
-        if (symlinkHops >= 40) {
-            return Object.freeze({ kind: "unavailable" });
-        }
-        symlinkHops += 1;
-        let linkDestination;
-        try {
-            linkDestination = path.resolve(path.dirname(nextPath), await readlink(nextPath));
-        }
-        catch {
-            return Object.freeze({ kind: "unavailable" });
-        }
-        if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {
-            return Object.freeze({ kind: "outside" });
-        }
-        pendingSegments = [
-            ...relativeSegments(canonicalProjectRoot, linkDestination),
-            ...pendingSegments
-        ];
-        currentPath = canonicalProjectRoot;
+    let state = {
+        currentPath: canonicalProjectRoot,
+        pendingSegments: relativeSegments(canonicalProjectRoot, candidatePath),
+        symlinkHops: 0
+    };
+    while (state.pendingSegments.length > 0) {
+        const advance = await advanceRootContainedPathProbe(canonicalProjectRoot, state);
+        if (!isRootContainedPathProbeState(advance))
+            return advance;
+        state = advance;
     }
-    return Object.freeze({ kind: "contained", absolutePath: currentPath });
+    return Object.freeze({ kind: "contained", absolutePath: state.currentPath });
 }
-export async function probeEndpoint(targetPath) {
-    let status;
+function isRootContainedPathProbeState(value) {
+    return "currentPath" in value;
+}
+async function advanceRootContainedPathProbe(canonicalProjectRoot, state) {
+    const [segment, ...remainingSegments] = state.pendingSegments;
+    if (segment === undefined)
+        return Object.freeze({ kind: "unavailable" });
+    const nextPath = path.join(state.currentPath, segment);
+    const pathStatus = await rootContainedPathStatus(nextPath);
+    if (pathStatus.kind !== "status")
+        return pathStatus;
+    if (!pathStatus.status.isSymbolicLink()) {
+        return remainingSegments.length === 0
+            ? Object.freeze({
+                kind: "contained",
+                absolutePath: nextPath,
+                endpoint: endpointFromStatus(pathStatus.status)
+            })
+            : Object.freeze({
+                currentPath: nextPath,
+                pendingSegments: remainingSegments,
+                symlinkHops: state.symlinkHops
+            });
+    }
+    return advanceThroughContainedSymlink(canonicalProjectRoot, nextPath, remainingSegments, state.symlinkHops);
+}
+async function rootContainedPathStatus(nextPath) {
     try {
-        status = await lstat(targetPath);
+        return Object.freeze({ kind: "status", status: await lstat(nextPath) });
     }
     catch (error) {
         return isNotFound(error)
-            ? Object.freeze({ kind: "missing" })
+            ? Object.freeze({ kind: "missing", absolutePath: nextPath })
             : Object.freeze({ kind: "unavailable" });
     }
-    if (status.isSymbolicLink()) {
+}
+async function advanceThroughContainedSymlink(canonicalProjectRoot, linkPath, remainingSegments, symlinkHops) {
+    if (symlinkHops >= 40)
         return Object.freeze({ kind: "unavailable" });
+    let linkDestination;
+    try {
+        linkDestination = path.resolve(path.dirname(linkPath), await readlink(linkPath));
     }
-    if (status.isDirectory()) {
-        return Object.freeze({ kind: "directory" });
+    catch {
+        return Object.freeze({ kind: "unavailable" });
     }
-    if (status.isFile()) {
-        return Object.freeze({ kind: "file" });
+    if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {
+        return Object.freeze({ kind: "outside" });
     }
-    return Object.freeze({ kind: "unsupported" });
+    return Object.freeze({
+        currentPath: canonicalProjectRoot,
+        pendingSegments: [
+            ...relativeSegments(canonicalProjectRoot, linkDestination),
+            ...remainingSegments
+        ],
+        symlinkHops: symlinkHops + 1
+    });
+}
+export async function probeEndpoint(targetPath) {
+    let status;
+    try {
+        status = await lstat(targetPath);
+    }
+    catch (error) {
+        return isNotFound(error)
+            ? Object.freeze({ kind: "missing" })
+            : Object.freeze({ kind: "unavailable" });
+    }
+    return endpointFromStatus(status);
 }
 export async function readRegularFile(filePath, maxBytes) {
     let handle;
@@ -106,4 +123,16 @@ async function readBoundedBytes(handle, maxBytes) {
     }
     return offset > maxBytes ? null : bytes.slice(0, offset);
 }
+function endpointFromStatus(status) {
+    if (status.isSymbolicLink()) {
+        return Object.freeze({ kind: "unavailable" });
+    }
+    if (status.isDirectory()) {
+        return Object.freeze({ kind: "directory" });
+    }
+    if (status.isFile()) {
+        return Object.freeze({ kind: "file" });
+    }
+    return Object.freeze({ kind: "unsupported" });
+}
 //# sourceMappingURL=filesystem-probes.mjs.map

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

	@@ -1 +1 @@
1	- {"version":3,"file":"filesystem-probes.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/filesystem-probes.ts"],"names":[],"mappings":"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","sourcesContent":["import { constants } from \"node:fs\";\nimport { lstat, open, readlink } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n isNotFound,\n isWithinRoot,\n relativeSegments,\n type EndpointProbe,\n type RootProbe\n} from \"./local-resolution.ts\";\n\nexport async function probeRootContainedPath(\n canonicalProjectRoot: string,\n candidatePath: string\n): Promise<RootProbe> {\n if (!isWithinRoot(canonicalProjectRoot, candidatePath)) {\n return Object.freeze({ kind: \"outside\" as const });\n }\n let pendingSegments = relativeSegments(canonicalProjectRoot, candidatePath);\n let currentPath = canonicalProjectRoot;\n let symlinkHops = 0;\n\n while (pendingSegments.length > 0) {\n const segment = pendingSegments.shift();\n if (segment === undefined) {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n const nextPath = path.join(currentPath, segment);\n let status: Awaited<ReturnType<typeof lstat>>;\n try {\n status = await lstat(nextPath);\n } catch (error: unknown) {\n if (isNotFound(error)) {\n return Object.freeze({ kind: \"missing\" as const, absolutePath: nextPath });\n }\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (!status.isSymbolicLink()) {\n currentPath = nextPath;\n continue;\n }\n if (symlinkHops >= 40) {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n symlinkHops += 1;\n let linkDestination: string;\n try {\n linkDestination = path.resolve(path.dirname(nextPath), await readlink(nextPath));\n } catch {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {\n return Object.freeze({ kind: \"outside\" as const });\n }\n pendingSegments = [\n ...relativeSegments(canonicalProjectRoot, linkDestination),\n ...pendingSegments\n ];\n currentPath = canonicalProjectRoot;\n }\n\n return Object.freeze({ kind: \"contained\" as const, absolutePath: currentPath });\n}\n\nexport async function probeEndpoint(targetPath: string): Promise<EndpointProbe> {\n let status: Awaited<ReturnType<typeof lstat>>;\n try {\n status = await lstat(targetPath);\n } catch (error: unknown) {\n return isNotFound(error)\n ? Object.freeze({ kind: \"missing\" as const })\n : Object.freeze({ kind: \"unavailable\" as const });\n }\n if (status.isSymbolicLink()) {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (status.isDirectory()) {\n return Object.freeze({ kind: \"directory\" as const });\n }\n if (status.isFile()) {\n return Object.freeze({ kind: \"file\" as const });\n }\n return Object.freeze({ kind: \"unsupported\" as const });\n}\n\nexport async function readRegularFile(\n filePath: string,\n maxBytes: number\n): Promise<\n \| Readonly<{ readonly ok: true; readonly bytes: Uint8Array }>\n \| Readonly<{ readonly ok: false; readonly reason: \"too-large\" \| \"unavailable\" }>\n> {\n let handle: Awaited<ReturnType<typeof open>> \| undefined;\n try {\n handle = await open(filePath, constants.O_RDONLY \| (constants.O_NOFOLLOW ?? 0));\n const status = await handle.stat();\n if (!status.isFile()) {\n return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n }\n if (status.size > maxBytes) {\n return Object.freeze({ ok: false as const, reason: \"too-large\" as const });\n }\n const bytes = await readBoundedBytes(handle, maxBytes);\n return bytes === null\n ? Object.freeze({ ok: false as const, reason: \"too-large\" as const })\n : Object.freeze({ ok: true as const, bytes });\n } catch {\n return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n } finally {\n await handle?.close().catch(() => undefined);\n }\n}\n\nasync function readBoundedBytes(\n handle: Awaited<ReturnType<typeof open>>,\n maxBytes: number\n): Promise<Uint8Array \| null> {\n const bytes = new Uint8Array(maxBytes + 1);\n let offset = 0;\n while (offset < bytes.byteLength) {\n const result = await handle.read(bytes, offset, bytes.byteLength - offset, offset);\n if (result.bytesRead === 0) break;\n offset += result.bytesRead;\n }\n return offset > maxBytes ? null : bytes.slice(0, offset);\n}\n"]}
1	+ {"version":3,"file":"filesystem-probes.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/filesystem-probes.ts"],"names":[],"mappings":"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","sourcesContent":["import { constants } from \"node:fs\";\nimport { lstat, open, readlink } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nimport {\n isNotFound,\n isWithinRoot,\n relativeSegments,\n type ExistingEndpointProbe,\n type EndpointProbe,\n type RootProbe\n} from \"./local-resolution.ts\";\n\ninterface RootContainedPathProbeState {\n readonly currentPath: string;\n readonly pendingSegments: readonly string[];\n readonly symlinkHops: number;\n}\n\ntype RootContainedPathProbeAdvance = RootProbe \| RootContainedPathProbeState;\ntype RootContainedPathStatus =\n \| RootProbe\n \| Readonly<{ readonly kind: \"status\"; readonly status: Awaited<ReturnType<typeof lstat>> }>;\n\nexport async function probeRootContainedPath(\n canonicalProjectRoot: string,\n candidatePath: string\n): Promise<RootProbe> {\n if (!isWithinRoot(canonicalProjectRoot, candidatePath)) {\n return Object.freeze({ kind: \"outside\" as const });\n }\n let state: RootContainedPathProbeState = {\n currentPath: canonicalProjectRoot,\n pendingSegments: relativeSegments(canonicalProjectRoot, candidatePath),\n symlinkHops: 0\n };\n\n while (state.pendingSegments.length > 0) {\n const advance = await advanceRootContainedPathProbe(canonicalProjectRoot, state);\n if (!isRootContainedPathProbeState(advance)) return advance;\n state = advance;\n }\n\n return Object.freeze({ kind: \"contained\" as const, absolutePath: state.currentPath });\n}\n\nfunction isRootContainedPathProbeState(\n value: RootContainedPathProbeAdvance\n): value is RootContainedPathProbeState {\n return \"currentPath\" in value;\n}\n\nasync function advanceRootContainedPathProbe(\n canonicalProjectRoot: string,\n state: RootContainedPathProbeState\n): Promise<RootContainedPathProbeAdvance> {\n const [segment, ...remainingSegments] = state.pendingSegments;\n if (segment === undefined) return Object.freeze({ kind: \"unavailable\" as const });\n const nextPath = path.join(state.currentPath, segment);\n const pathStatus = await rootContainedPathStatus(nextPath);\n if (pathStatus.kind !== \"status\") return pathStatus;\n if (!pathStatus.status.isSymbolicLink()) {\n return remainingSegments.length === 0\n ? Object.freeze({\n kind: \"contained\" as const,\n absolutePath: nextPath,\n endpoint: endpointFromStatus(pathStatus.status)\n })\n : Object.freeze({\n currentPath: nextPath,\n pendingSegments: remainingSegments,\n symlinkHops: state.symlinkHops\n });\n }\n return advanceThroughContainedSymlink(\n canonicalProjectRoot,\n nextPath,\n remainingSegments,\n state.symlinkHops\n );\n}\n\nasync function rootContainedPathStatus(nextPath: string): Promise<RootContainedPathStatus> {\n try {\n return Object.freeze({ kind: \"status\" as const, status: await lstat(nextPath) });\n } catch (error: unknown) {\n return isNotFound(error)\n ? Object.freeze({ kind: \"missing\" as const, absolutePath: nextPath })\n : Object.freeze({ kind: \"unavailable\" as const });\n }\n}\n\nasync function advanceThroughContainedSymlink(\n canonicalProjectRoot: string,\n linkPath: string,\n remainingSegments: readonly string[],\n symlinkHops: number\n): Promise<RootContainedPathProbeAdvance> {\n if (symlinkHops >= 40) return Object.freeze({ kind: \"unavailable\" as const });\n let linkDestination: string;\n try {\n linkDestination = path.resolve(path.dirname(linkPath), await readlink(linkPath));\n } catch {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (!isWithinRoot(canonicalProjectRoot, linkDestination)) {\n return Object.freeze({ kind: \"outside\" as const });\n }\n return Object.freeze({\n currentPath: canonicalProjectRoot,\n pendingSegments: [\n ...relativeSegments(canonicalProjectRoot, linkDestination),\n ...remainingSegments\n ],\n symlinkHops: symlinkHops + 1\n });\n}\n\nexport async function probeEndpoint(targetPath: string): Promise<EndpointProbe> {\n let status: Awaited<ReturnType<typeof lstat>>;\n try {\n status = await lstat(targetPath);\n } catch (error: unknown) {\n return isNotFound(error)\n ? Object.freeze({ kind: \"missing\" as const })\n : Object.freeze({ kind: \"unavailable\" as const });\n }\n return endpointFromStatus(status);\n}\n\nexport async function readRegularFile(\n filePath: string,\n maxBytes: number\n): Promise<\n \| Readonly<{ readonly ok: true; readonly bytes: Uint8Array }>\n \| Readonly<{ readonly ok: false; readonly reason: \"too-large\" \| \"unavailable\" }>\n> {\n let handle: Awaited<ReturnType<typeof open>> \| undefined;\n try {\n handle = await open(filePath, constants.O_RDONLY \| (constants.O_NOFOLLOW ?? 0));\n const status = await handle.stat();\n if (!status.isFile()) {\n return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n }\n if (status.size > maxBytes) {\n return Object.freeze({ ok: false as const, reason: \"too-large\" as const });\n }\n const bytes = await readBoundedBytes(handle, maxBytes);\n return bytes === null\n ? Object.freeze({ ok: false as const, reason: \"too-large\" as const })\n : Object.freeze({ ok: true as const, bytes });\n } catch {\n return Object.freeze({ ok: false as const, reason: \"unavailable\" as const });\n } finally {\n await handle?.close().catch(() => undefined);\n }\n}\n\nasync function readBoundedBytes(\n handle: Awaited<ReturnType<typeof open>>,\n maxBytes: number\n): Promise<Uint8Array \| null> {\n const bytes = new Uint8Array(maxBytes + 1);\n let offset = 0;\n while (offset < bytes.byteLength) {\n const result = await handle.read(bytes, offset, bytes.byteLength - offset, offset);\n if (result.bytesRead === 0) break;\n offset += result.bytesRead;\n }\n return offset > maxBytes ? null : bytes.slice(0, offset);\n}\n\nfunction endpointFromStatus(status: Awaited<ReturnType<typeof lstat>>): ExistingEndpointProbe {\n if (status.isSymbolicLink()) {\n return Object.freeze({ kind: \"unavailable\" as const });\n }\n if (status.isDirectory()) {\n return Object.freeze({ kind: \"directory\" as const });\n }\n if (status.isFile()) {\n return Object.freeze({ kind: \"file\" as const });\n }\n return Object.freeze({ kind: \"unsupported\" as const });\n}\n"]}

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

	@@ -1 +1 @@
1	- {"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/final-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;~~AAWlC~~,gDAAgD;AAChD,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,MAAM,KAAK,GAAG,oBAAoB,CAChC,IAAI,EACJ,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,CAAC,EAC/F,wBAAwB,CACzB,CAAC;IACF,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5E,IACE,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,YAAY,KAAK,SAAS;QAC1B,kBAAkB,KAAK,SAAS;QAChC,eAAe,GAAG,eAAe;QACjC,YAAY,GAAG,kBAAkB;QACjC,YAAY,GAAG,kBAAkB,GAAG,eAAe,EACnD,CAAC;QACD,MAAM,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,eAAe;QACf,eAAe;QACf,eAAe;QACf,YAAY;QACZ,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n exactFinalDataRecord,\n invalidFinalData,\n nonNegativeSafeInteger\n} from \"../final-data-parsing.ts\";\n\n/** `markdown-link-validation` 在 passed/failed outcome 中发布的主数据。 /\nexport interface MarkdownLinkValidationFinalData {\n readonly sourceFileCount: number;\n readonly occurrenceCount: number;\n readonly targetReadCount: number;\n readonly findingCount: number;\n readonly rejectedInputCount: number;\n}\n\n/* 验证计数不变量并脱离一份 canonical final-data object。 */\nexport function parseMarkdownLinkValidationData(data: unknown): MarkdownLinkValidationFinalData {\n const value = exactFinalDataRecord(\n data,\n [\"sourceFileCount\", \"occurrenceCount\", \"targetReadCount\", \"findingCount\", \"rejectedInputCount\"],\n \"markdownLinkValidation\"\n );\n const sourceFileCount = nonNegativeSafeInteger(value.sourceFileCount);\n const occurrenceCount = nonNegativeSafeInteger(value.occurrenceCount);\n const targetReadCount = nonNegativeSafeInteger(value.targetReadCount);\n const findingCount = nonNegativeSafeInteger(value.findingCount);\n const rejectedInputCount = nonNegativeSafeInteger(value.rejectedInputCount);\n if (\n sourceFileCount === undefined \|\|\n occurrenceCount === undefined \|\|\n targetReadCount === undefined \|\|\n findingCount === undefined \|\|\n rejectedInputCount === undefined \|\|\n targetReadCount > occurrenceCount \|\|\n findingCount < rejectedInputCount \|\|\n findingCount - rejectedInputCount > occurrenceCount\n ) {\n throw invalidFinalData(\"markdownLinkValidation\");\n }\n return Object.freeze({\n sourceFileCount,\n occurrenceCount,\n targetReadCount,\n findingCount,\n rejectedInputCount\n });\n}\n"]}
1	+ {"version":3,"file":"final-data.mjs","sourceRoot":"","sources":["../../../../src/package-checks/markdown-link-validation/final-data.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,oBAAoB,EACpB,gBAAgB,EAChB,sBAAsB,EACvB,MAAM,0BAA0B,CAAC;AAgBlC,gDAAgD;AAChD,MAAM,UAAU,+BAA+B,CAAC,IAAa;IAC3D,MAAM,KAAK,GAAG,oBAAoB,CAChC,IAAI,EACJ,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,cAAc,EAAE,oBAAoB,CAAC,EAC/F,wBAAwB,CACzB,CAAC;IACF,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,eAAe,GAAG,sBAAsB,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC;IACtE,MAAM,YAAY,GAAG,sBAAsB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChE,MAAM,kBAAkB,GAAG,sBAAsB,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IAC5E,IACE,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,eAAe,KAAK,SAAS;QAC7B,YAAY,KAAK,SAAS;QAC1B,kBAAkB,KAAK,SAAS;QAChC,eAAe,GAAG,eAAe;QACjC,YAAY,GAAG,kBAAkB;QACjC,YAAY,GAAG,kBAAkB,GAAG,eAAe,EACnD,CAAC;QACD,MAAM,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;IACnD,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,eAAe;QACf,eAAe;QACf,eAAe;QACf,YAAY;QACZ,kBAAkB;KACnB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import {\n exactFinalDataRecord,\n invalidFinalData,\n nonNegativeSafeInteger\n} from \"../final-data-parsing.ts\";\n\n/** `markdown-link-validation` 在 passed/failed outcome 中发布的主数据。 /\nexport interface MarkdownLinkValidationFinalData {\n /* 已成功读取并完成 Markdown link occurrence 提取的 source 文件数。 /\n readonly sourceFileCount: number;\n /* 从已处理 source 中提取的 semantic link occurrence 数。 /\n readonly occurrenceCount: number;\n /* 进入 direct endpoint validation 的 logical occurrence 数，包括 target memo hit。 /\n readonly targetReadCount: number;\n /* occurrence finding 与 rejected input 的合计数。 /\n readonly findingCount: number;\n /* files policy 已选中、但因不是 `.md`/`.markdown` path 而被拒绝的输入数。 /\n readonly rejectedInputCount: number;\n}\n\n/* 验证计数不变量并脱离一份 canonical final-data object。 */\nexport function parseMarkdownLinkValidationData(data: unknown): MarkdownLinkValidationFinalData {\n const value = exactFinalDataRecord(\n data,\n [\"sourceFileCount\", \"occurrenceCount\", \"targetReadCount\", \"findingCount\", \"rejectedInputCount\"],\n \"markdownLinkValidation\"\n );\n const sourceFileCount = nonNegativeSafeInteger(value.sourceFileCount);\n const occurrenceCount = nonNegativeSafeInteger(value.occurrenceCount);\n const targetReadCount = nonNegativeSafeInteger(value.targetReadCount);\n const findingCount = nonNegativeSafeInteger(value.findingCount);\n const rejectedInputCount = nonNegativeSafeInteger(value.rejectedInputCount);\n if (\n sourceFileCount === undefined \|\|\n occurrenceCount === undefined \|\|\n targetReadCount === undefined \|\|\n findingCount === undefined \|\|\n rejectedInputCount === undefined \|\|\n targetReadCount > occurrenceCount \|\|\n findingCount < rejectedInputCount \|\|\n findingCount - rejectedInputCount > occurrenceCount\n ) {\n throw invalidFinalData(\"markdownLinkValidation\");\n }\n return Object.freeze({\n sourceFileCount,\n occurrenceCount,\n targetReadCount,\n findingCount,\n rejectedInputCount\n });\n}\n"]}

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

@@ -0,0 +1,36 @@
+import { presentCheckFindings } from "../../check/finding-presentation.mjs";
+const PRESENTED_FINDING_LIMIT = 10;
+/** Projects completed Link findings without copying raw destinations into presentation. */
+export function markdownFindingMessages(candidates, rejectedPaths, blocking) {
+    const findings = [
+        ...candidates.map((candidate) => Object.freeze({ kind: "link", candidate })),
+        ...rejectedPaths.map((path) => Object.freeze({ kind: "input-rejected", path }))
+    ];
+    return presentCheckFindings({
+        findings,
+        limit: PRESENTED_FINDING_LIMIT,
+        message: (finding) => {
+            if (finding.kind === "input-rejected") {
+                return Object.freeze({
+                    code: "finding-detail",
+                    level: "warning",
+                    message: `${finding.path}: selected input is not a supported Markdown source.`
+                });
+            }
+            const { occurrenceKind, range, reason, sourcePath } = finding.candidate.data;
+            return Object.freeze({
+                code: "finding-detail",
+                level: blocking ? "error" : "warning",
+                message: `${sourcePath}:${range.start.line}:${range.start.column} ${occurrenceKind}: ${reason}.`
+            });
+        },
+        omittedMessage: ({ omittedCount, omittedFindings }) => Object.freeze({
+            code: "findings-omitted",
+            level: omittedFindings.some((finding) => finding.kind === "link" && blocking)
+                ? "error"
+                : "warning",
+            message: `${omittedCount} additional Markdown link finding(s) were not shown; inspect this Check's Records for the complete set.`
+        })
+    });
+}
+//# sourceMappingURL=finding-messages.mjs.map