@zxyycom/vibe-check 0.0.1

package/dist/esm/package-checks/json-validation/json-validation.mjs

@@ -0,0 +1,138 @@
+import { resolve } from "node:path";
+import { readStrictJsonDocument } from "../json-document/strict-document.mjs";
+import { collectProjectFiles } from "../project-files/collection.mjs";
+import { partitionProjectFilesByEligibility } from "../project-files/input-eligibility.mjs";
+import { validJsonValidationOptions } from "./options-validation.mjs";
+export const JSON_VALIDATION_CHECK_DEFINITION = {
+    checkId: "json-validation",
+    displayName: "JSON validation"
+};
+/** Validates the lower-case JSON subset selected by this Check's options. */
+export function executeJsonValidation(context) {
+    if (!validJsonValidationOptions(context.options))
+        return unavailable("invalid-options");
+    if (context.signal.aborted)
+        return unavailable("execution-cancelled");
+    const inputs = jsonInputPaths(context);
+    if (inputs === undefined)
+        return unavailable("scan-input-unavailable");
+    if (context.signal.aborted)
+        return unavailable("execution-cancelled");
+    if (inputs.selectedPathCount === 0)
+        return noEligibleInput();
+    reportRejectedInputs(context, inputs.rejectedPaths);
+    return appendRejectedInputMessage(validateJsonPaths(context, inputs.acceptedPaths, inputs.rejectedPaths.length), inputs.rejectedPaths.length);
+}
+function validateJsonPaths(context, paths, rejectedInputCount) {
+    const counts = { invalidFileCount: 0, validFileCount: 0 };
+    for (const path of paths) {
+        if (context.signal.aborted)
+            return unavailable("execution-cancelled");
+        const document = readJsonDocument(context, path);
+        if (context.signal.aborted)
+            return unavailable("execution-cancelled");
+        if (document.kind === "unavailable")
+            return unavailable("document-unavailable");
+        if (document.kind === "valid") {
+            counts.validFileCount += 1;
+            continue;
+        }
+        counts.invalidFileCount += 1;
+        reportInvalidDocument(context, path, document.reason);
+    }
+    return resultForValidationCounts(paths.length, rejectedInputCount, counts);
+}
+function jsonInputPaths(context) {
+    try {
+        const selectedPaths = collectProjectFiles(context.project.root, context.options.files);
+        const partition = partitionProjectFilesByEligibility(selectedPaths, isJsonInputPath);
+        return Object.freeze({ ...partition, selectedPathCount: selectedPaths.length });
+    }
+    catch {
+        return undefined;
+    }
+}
+function isJsonInputPath(path) {
+    return path.endsWith(".json");
+}
+function noEligibleInput() {
+    return Object.freeze({ status: "not-applicable", reason: { code: "no-eligible-input" } });
+}
+function readJsonDocument(context, path) {
+    return readStrictJsonDocument({
+        filePath: resolve(context.project.root, path),
+        maximumBytes: context.options.maximumBytes
+    });
+}
+function reportInvalidDocument(context, path, reason) {
+    const record = Object.freeze({ path, reason });
+    context.records.report({ id: path }, record);
+}
+function resultForValidationCounts(scannedFileCount, rejectedInputCount, counts) {
+    const data = Object.freeze({
+        scannedFileCount,
+        validFileCount: counts.validFileCount,
+        invalidFileCount: counts.invalidFileCount,
+        issueCount: counts.invalidFileCount + rejectedInputCount,
+        rejectedInputCount
+    });
+    if (counts.invalidFileCount === 0)
+        return Object.freeze({ data, status: "passed" });
+    return Object.freeze({
+        data,
+        messages: Object.freeze([
+            Object.freeze({
+                code: "invalid-json-documents",
+                level: "error",
+                message: `${counts.invalidFileCount} JSON document(s) are invalid; inspect this Check's Records for each path and reason.`
+            })
+        ]),
+        status: "failed"
+    });
+}
+function reportRejectedInputs(context, paths) {
+    for (const path of paths) {
+        const data = Object.freeze({
+            blocking: false,
+            kind: "input-rejected",
+            path,
+            reason: "unsupported-file-type"
+        });
+        context.records.report({ id: `/input-rejected/${path}` }, data);
+    }
+}
+function appendRejectedInputMessage(result, rejectedInputCount) {
+    if (rejectedInputCount === 0)
+        return result;
+    const message = Object.freeze({
+        code: "input-rejected",
+        level: "warning",
+        message: `${rejectedInputCount} selected jsonValidation input file(s) were rejected because only lower-case .json paths are supported; inspect this Check's Records and narrow files.include/exclude.`
+    });
+    return Object.freeze({
+        ...result,
+        messages: Object.freeze([...(result.messages ?? []), message])
+    });
+}
+function unavailable(code) {
+    return Object.freeze({
+        status: "unavailable",
+        reason: { code },
+        messages: Object.freeze([
+            Object.freeze({ code, level: "error", message: unavailableMessage(code) })
+        ])
+    });
+}
+function unavailableMessage(code) {
+    switch (code) {
+        case "invalid-options":
+            return "jsonValidation options are invalid; recreate the Check with jsonValidation(options) or restore its complete resolved options.";
+        case "scan-input-unavailable":
+            return "JSON validation could not collect its configured project files; check the project root, permissions, and selected file source.";
+        case "document-unavailable":
+            return "A selected JSON document could not be read safely; check that the file still exists, is readable, and was not replaced during the Run.";
+        case "execution-cancelled":
+            return "JSON validation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate.";
+    }
+}
+//# sourceMappingURL=json-validation.mjs.map

package/dist/esm/package-checks/json-validation/json-validation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-validation.mjs","sourceRoot":"","sources":["../../../../src/package-checks/json-validation/json-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { resolve } from \"node:path\";\n\nimport type { CheckExecutionContext, CheckMessage, CheckResult } from \"../../check/check.ts\";\nimport {\n  readStrictJsonDocument,\n  type JsonDocumentIssue\n} from \"../json-document/strict-document.ts\";\nimport { collectProjectFiles } from \"../project-files/collection.ts\";\nimport { partitionProjectFilesByEligibility } from \"../project-files/input-eligibility.ts\";\nimport type { JsonValidationFinalData } from \"./final-data.ts\";\nimport type { ResolvedJsonValidationOptions } from \"./options.ts\";\nimport { validJsonValidationOptions } from \"./options-validation.ts\";\n\nexport const JSON_VALIDATION_CHECK_DEFINITION = {\n  checkId: \"json-validation\",\n  displayName: \"JSON validation\"\n} as const;\n\n/** `json-validation` whole-Check unavailable outcome 的稳定 reason code。 */\nexport type JsonValidationUnavailableCode =\n  | \"invalid-options\"\n  | \"document-unavailable\"\n  | \"execution-cancelled\"\n  | \"scan-input-unavailable\";\n\n/** Validates the lower-case JSON subset selected by this Check's options. */\nexport function executeJsonValidation(\n  context: CheckExecutionContext<ResolvedJsonValidationOptions>\n): CheckResult<JsonValidationFinalData> {\n  if (!validJsonValidationOptions(context.options)) return unavailable(\"invalid-options\");\n  if (context.signal.aborted) return unavailable(\"execution-cancelled\");\n\n  const inputs = jsonInputPaths(context);\n  if (inputs === undefined) return unavailable(\"scan-input-unavailable\");\n  if (context.signal.aborted) return unavailable(\"execution-cancelled\");\n  if (inputs.selectedPathCount === 0) return noEligibleInput();\n  reportRejectedInputs(context, inputs.rejectedPaths);\n  return appendRejectedInputMessage(\n    validateJsonPaths(context, inputs.acceptedPaths, inputs.rejectedPaths.length),\n    inputs.rejectedPaths.length\n  );\n}\n\nfunction validateJsonPaths(\n  context: CheckExecutionContext<ResolvedJsonValidationOptions>,\n  paths: readonly string[],\n  rejectedInputCount: number\n): CheckResult<JsonValidationFinalData> {\n  const counts = { invalidFileCount: 0, validFileCount: 0 };\n  for (const path of paths) {\n    if (context.signal.aborted) return unavailable(\"execution-cancelled\");\n    const document = readJsonDocument(context, path);\n    if (context.signal.aborted) return unavailable(\"execution-cancelled\");\n    if (document.kind === \"unavailable\") return unavailable(\"document-unavailable\");\n    if (document.kind === \"valid\") {\n      counts.validFileCount += 1;\n      continue;\n    }\n\n    counts.invalidFileCount += 1;\n    reportInvalidDocument(context, path, document.reason);\n  }\n\n  return resultForValidationCounts(paths.length, rejectedInputCount, counts);\n}\n\ninterface JsonInputPaths {\n  readonly acceptedPaths: readonly string[];\n  readonly rejectedPaths: readonly string[];\n  readonly selectedPathCount: number;\n}\n\nfunction jsonInputPaths(\n  context: CheckExecutionContext<ResolvedJsonValidationOptions>\n): JsonInputPaths | undefined {\n  try {\n    const selectedPaths = collectProjectFiles(context.project.root, context.options.files);\n    const partition = partitionProjectFilesByEligibility(selectedPaths, isJsonInputPath);\n    return Object.freeze({ ...partition, selectedPathCount: selectedPaths.length });\n  } catch {\n    return undefined;\n  }\n}\n\nfunction isJsonInputPath(path: string): boolean {\n  return path.endsWith(\".json\");\n}\n\nfunction noEligibleInput(): CheckResult<JsonValidationFinalData> {\n  return Object.freeze({ status: \"not-applicable\", reason: { code: \"no-eligible-input\" } });\n}\n\nfunction readJsonDocument(\n  context: CheckExecutionContext<ResolvedJsonValidationOptions>,\n  path: string\n) {\n  return readStrictJsonDocument({\n    filePath: resolve(context.project.root, path),\n    maximumBytes: context.options.maximumBytes\n  });\n}\n\nfunction reportInvalidDocument(\n  context: CheckExecutionContext<ResolvedJsonValidationOptions>,\n  path: string,\n  reason: JsonDocumentIssue\n): void {\n  const record: JsonValidationRecordData = Object.freeze({ path, reason });\n  context.records.report({ id: path }, record);\n}\n\nfunction resultForValidationCounts(\n  scannedFileCount: number,\n  rejectedInputCount: number,\n  counts: Readonly<{ invalidFileCount: number; validFileCount: number }>\n): CheckResult<JsonValidationFinalData> {\n  const data = Object.freeze({\n    scannedFileCount,\n    validFileCount: counts.validFileCount,\n    invalidFileCount: counts.invalidFileCount,\n    issueCount: counts.invalidFileCount + rejectedInputCount,\n    rejectedInputCount\n  });\n  if (counts.invalidFileCount === 0) return Object.freeze({ data, status: \"passed\" });\n  return Object.freeze({\n    data,\n    messages: Object.freeze([\n      Object.freeze({\n        code: \"invalid-json-documents\",\n        level: \"error\" as const,\n        message: `${counts.invalidFileCount} JSON document(s) are invalid; inspect this Check's Records for each path and reason.`\n      })\n    ]),\n    status: \"failed\"\n  });\n}\n\nfunction reportRejectedInputs(\n  context: CheckExecutionContext<ResolvedJsonValidationOptions>,\n  paths: readonly string[]\n): void {\n  for (const path of paths) {\n    const data: JsonValidationInputRejectedRecordData = Object.freeze({\n      blocking: false,\n      kind: \"input-rejected\",\n      path,\n      reason: \"unsupported-file-type\"\n    });\n    context.records.report({ id: `/input-rejected/${path}` }, data);\n  }\n}\n\nfunction appendRejectedInputMessage(\n  result: CheckResult<JsonValidationFinalData>,\n  rejectedInputCount: number\n): CheckResult<JsonValidationFinalData> {\n  if (rejectedInputCount === 0) return result;\n  const message: CheckMessage = Object.freeze({\n    code: \"input-rejected\",\n    level: \"warning\",\n    message: `${rejectedInputCount} selected jsonValidation input file(s) were rejected because only lower-case .json paths are supported; inspect this Check's Records and narrow files.include/exclude.`\n  });\n  return Object.freeze({\n    ...result,\n    messages: Object.freeze([...(result.messages ?? []), message])\n  });\n}\n\nfunction unavailable(code: JsonValidationUnavailableCode): CheckResult<JsonValidationFinalData> {\n  return Object.freeze({\n    status: \"unavailable\",\n    reason: { code },\n    messages: Object.freeze([\n      Object.freeze({ code, level: \"error\" as const, message: unavailableMessage(code) })\n    ])\n  });\n}\n\nfunction unavailableMessage(code: JsonValidationUnavailableCode): string {\n  switch (code) {\n    case \"invalid-options\":\n      return \"jsonValidation options are invalid; recreate the Check with jsonValidation(options) or restore its complete resolved options.\";\n    case \"scan-input-unavailable\":\n      return \"JSON validation could not collect its configured project files; check the project root, permissions, and selected file source.\";\n    case \"document-unavailable\":\n      return \"A selected JSON document could not be read safely; check that the file still exists, is readable, and was not replaced during the Run.\";\n    case \"execution-cancelled\":\n      return \"JSON validation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate.\";\n  }\n}\n\n/** 一条 invalid JSON document supplemental Record 的 data。 */\nexport interface JsonValidationDocumentRecordData {\n  readonly path: string;\n  readonly reason: JsonValidationRecordReason;\n}\n\n/** 一条 files policy 已选中但不受 JSON validation 支持的输入 Finding。 */\nexport interface JsonValidationInputRejectedRecordData {\n  readonly blocking: false;\n  readonly kind: \"input-rejected\";\n  readonly path: string;\n  readonly reason: \"unsupported-file-type\";\n}\n\n/** JSON validation 发布的 document issue 或 input-rejection Record data。 */\nexport type JsonValidationRecordData =\n  | JsonValidationDocumentRecordData\n  | JsonValidationInputRejectedRecordData;\n\n/** JSON document Record 的稳定问题原因。 */\nexport type JsonValidationRecordReason = JsonDocumentIssue;\n"]}

package/dist/esm/package-checks/json-validation/options-resolution.mjs

@@ -0,0 +1,33 @@
+import { hasRequiredAndOptionalRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { defaultProjectFileSelection, resolveProjectFileSelection, snapshotProjectFileSelection } from "../project-files/configuration.mjs";
+import { validJsonValidationOptions } from "./options-validation.mjs";
+const DEFAULT_MAXIMUM_BYTES = 1_048_576;
+const DEFAULT_FILES = Object.freeze({
+    exclude: defaultProjectFileSelection.exclude,
+    include: Object.freeze(["**/*.json"]),
+    source: defaultProjectFileSelection.source
+});
+/** 将可省略 JSON validation policy 物化为完整、冻结的 execution options。 */
+export function resolveJsonValidationOptions(value) {
+    const input = snapshotClosedRecord(value);
+    if (input === undefined ||
+        !hasRequiredAndOptionalRecordKeys(input, {
+            optional: ["files", "maximumBytes"],
+            required: []
+        })) {
+        return undefined;
+    }
+    const files = input.files === undefined
+        ? snapshotProjectFileSelection(DEFAULT_FILES)
+        : resolveProjectFileSelection(input.files, DEFAULT_FILES);
+    const maximumBytes = input.maximumBytes === undefined ? DEFAULT_MAXIMUM_BYTES : input.maximumBytes;
+    if (files === undefined ||
+        typeof maximumBytes !== "number" ||
+        !Number.isSafeInteger(maximumBytes) ||
+        maximumBytes <= 0) {
+        return undefined;
+    }
+    const options = Object.freeze({ files, maximumBytes });
+    return validJsonValidationOptions(options) ? options : undefined;
+}
+//# sourceMappingURL=options-resolution.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options-resolution.mjs","sourceRoot":"","sources":["../../../../src/package-checks/json-validation/options-resolution.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,gCAAgC,EAChC,oBAAoB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EACL,2BAA2B,EAC3B,2BAA2B,EAC3B,4BAA4B,EAC7B,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAErE,MAAM,qBAAqB,GAAG,SAAS,CAAC;AACxC,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,2BAA2B,CAAC,OAAO;IAC5C,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,CAAC,CAAC;IACrC,MAAM,EAAE,2BAA2B,CAAC,MAAM;CAC3C,CAAC,CAAC;AAEH,+DAA+D;AAC/D,MAAM,UAAU,4BAA4B,CAC1C,KAAc;IAEd,MAAM,KAAK,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC1C,IACE,KAAK,KAAK,SAAS;QACnB,CAAC,gCAAgC,CAAC,KAAK,EAAE;YACvC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,CAAC;YACnC,QAAQ,EAAE,EAAE;SACb,CAAC,EACF,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,KAAK,GACT,KAAK,CAAC,KAAK,KAAK,SAAS;QACvB,CAAC,CAAC,4BAA4B,CAAC,aAAa,CAAC;QAC7C,CAAC,CAAC,2BAA2B,CAAC,KAAK,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC9D,MAAM,YAAY,GAChB,KAAK,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAChF,IACE,KAAK,KAAK,SAAS;QACnB,OAAO,YAAY,KAAK,QAAQ;QAChC,CAAC,MAAM,CAAC,aAAa,CAAC,YAAY,CAAC;QACnC,YAAY,IAAI,CAAC,EACjB,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;IACvD,OAAO,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACnE,CAAC","sourcesContent":["import {\n  hasRequiredAndOptionalRecordKeys,\n  snapshotClosedRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport {\n  defaultProjectFileSelection,\n  resolveProjectFileSelection,\n  snapshotProjectFileSelection\n} from \"../project-files/configuration.ts\";\nimport type { ResolvedJsonValidationOptions } from \"./options.ts\";\nimport { validJsonValidationOptions } from \"./options-validation.ts\";\n\nconst DEFAULT_MAXIMUM_BYTES = 1_048_576;\nconst DEFAULT_FILES = Object.freeze({\n  exclude: defaultProjectFileSelection.exclude,\n  include: Object.freeze([\"**/*.json\"]),\n  source: defaultProjectFileSelection.source\n});\n\n/** 将可省略 JSON validation policy 物化为完整、冻结的 execution options。 */\nexport function resolveJsonValidationOptions(\n  value: unknown\n): ResolvedJsonValidationOptions | undefined {\n  const input = snapshotClosedRecord(value);\n  if (\n    input === undefined ||\n    !hasRequiredAndOptionalRecordKeys(input, {\n      optional: [\"files\", \"maximumBytes\"],\n      required: []\n    })\n  ) {\n    return undefined;\n  }\n  const files =\n    input.files === undefined\n      ? snapshotProjectFileSelection(DEFAULT_FILES)\n      : resolveProjectFileSelection(input.files, DEFAULT_FILES);\n  const maximumBytes =\n    input.maximumBytes === undefined ? DEFAULT_MAXIMUM_BYTES : input.maximumBytes;\n  if (\n    files === undefined ||\n    typeof maximumBytes !== \"number\" ||\n    !Number.isSafeInteger(maximumBytes) ||\n    maximumBytes <= 0\n  ) {\n    return undefined;\n  }\n  const options = Object.freeze({ files, maximumBytes });\n  return validJsonValidationOptions(options) ? options : undefined;\n}\n"]}

package/dist/esm/package-checks/json-validation/options-validation.mjs

@@ -0,0 +1,16 @@
+import { hasExactPlainRecordKeys, snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { validProjectFileSelection } from "../project-files/configuration.mjs";
+function exactRecord(value, keys) {
+    const record = snapshotClosedRecord(value);
+    return record !== undefined && hasExactPlainRecordKeys(record, keys) ? record : undefined;
+}
+function positiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+export function validJsonValidationOptions(value) {
+    const options = exactRecord(value, ["files", "maximumBytes"]);
+    return (options !== undefined &&
+        validProjectFileSelection(options.files) &&
+        positiveSafeInteger(options.maximumBytes));
+}
+//# sourceMappingURL=options-validation.mjs.map

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

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

package/dist/esm/package-checks/json-validation/options.mjs

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=options.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"options.mjs","sourceRoot":"","sources":["../../../../src/package-checks/json-validation/options.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions\n} from \"../project-files/configuration.ts\";\n\n/** `jsonValidation(options?)` 接受的可省略 authoring policy。 */\nexport interface JsonValidationOptions {\n  /** 参与本 Check 的 repository-file selection；省略字段使用 package defaults。 */\n  readonly files?: ProjectFileSelectionOptions;\n  /** 单个 JSON document 允许的最大 raw byte 数；省略时为 1 MiB。 */\n  readonly maximumBytes?: number;\n}\n\n/** `json-validation` execution 消费的完整、冻结 options。 */\nexport interface ResolvedJsonValidationOptions {\n  readonly files: ProjectFileSelection;\n  readonly maximumBytes: number;\n}\n"]}

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

@@ -0,0 +1,73 @@
+const REMINDER_MESSAGE_CODE = Object.freeze({
+    due: "maintenance-reminder-due",
+    unavailable: "maintenance-reminder-unavailable"
+});
+export function completedResult(evaluations) {
+    const assessments = evaluations.map((evaluation) => evaluation.assessment);
+    const messages = evaluations.flatMap(messageForEvaluation);
+    const failed = evaluations.some((evaluation) => evaluation.assessment.mode === "enforcing" && evaluation.assessment.assessment !== "clear");
+    return {
+        status: failed ? "failed" : "passed",
+        data: { entries: assessments },
+        ...(messages.length === 0 ? {} : { messages })
+    };
+}
+export function unavailableResult(code) {
+    return {
+        status: "unavailable",
+        reason: { code },
+        messages: [{ code, level: "error", message: wholeCheckUnavailableMessage(code) }]
+    };
+}
+function wholeCheckUnavailableMessage(code) {
+    switch (code) {
+        case "invalid-options":
+            return "maintenanceReminders options are invalid; recreate the Check with maintenanceReminders(entries) or restore its complete resolved options.";
+        case "execution-cancelled":
+            return "Maintenance reminder evaluation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate.";
+        case "maintenance-reminders-internal-failure":
+            return "Maintenance reminders could not form a complete ordered assessment; check package/runtime integrity and retry.";
+    }
+}
+function messageForEvaluation(evaluation) {
+    const { assessment, message } = evaluation;
+    if (assessment.assessment === "clear")
+        return [];
+    const level = assessment.mode === "enforcing" ? "error" : "warning";
+    const suffix = assessment.assessment === "unavailable" ? ` (${assessment.reason})` : "";
+    return [
+        {
+            code: assessment.assessment === "due"
+                ? REMINDER_MESSAGE_CODE.due
+                : REMINDER_MESSAGE_CODE.unavailable,
+            level,
+            message: `${assessment.id}: ${message}${suffix}`
+        }
+    ];
+}
+export function unavailableAssessment(entry, headCommit, reason) {
+    return {
+        assessment: "unavailable",
+        baseCommit: entry.baseCommit,
+        changedLines: null,
+        commitCount: null,
+        exceeded: [],
+        headCommit,
+        id: entry.id,
+        mode: modeOf(entry),
+        reason
+    };
+}
+export function modeOf(entry) {
+    return entry.mode === "enforcing" ? "enforcing" : "advisory";
+}
+export function unavailableHistory(reason) {
+    return { kind: "unavailable", reason };
+}
+export function reminderEvaluation(entry, assessment) {
+    return { assessment, message: entry.message };
+}
+export function completedMeasurement(entry, assessment) {
+    return { kind: "succeeded", value: reminderEvaluation(entry, assessment) };
+}
+//# sourceMappingURL=assessment-results.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"assessment-results.mjs","sourceRoot":"","sources":["../../../../src/package-checks/maintenance-reminders/assessment-results.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckMessage, CheckResult } from \"../../check/check.ts\";\nimport type {\n  MaintenanceReminder,\n  MaintenanceRemindersUnavailableCode,\n  ReminderEvaluation,\n  ReminderMeasurement,\n  FirstParentHistoryResolution,\n  FirstParentHistoryUnavailableReason\n} from \"./maintenance-reminders.ts\";\nimport type {\n  MaintenanceReminderAssessment,\n  MaintenanceReminderMode,\n  MaintenanceReminderUnavailableReason,\n  MaintenanceRemindersFinalData,\n  UnavailableMaintenanceReminderAssessment\n} from \"./final-data.ts\";\n\nconst REMINDER_MESSAGE_CODE = Object.freeze({\n  due: \"maintenance-reminder-due\",\n  unavailable: \"maintenance-reminder-unavailable\"\n});\n\nexport function completedResult(\n  evaluations: readonly ReminderEvaluation[]\n): CheckResult<MaintenanceRemindersFinalData> {\n  const assessments = evaluations.map((evaluation) => evaluation.assessment);\n  const messages = evaluations.flatMap(messageForEvaluation);\n  const failed = evaluations.some(\n    (evaluation) =>\n      evaluation.assessment.mode === \"enforcing\" && evaluation.assessment.assessment !== \"clear\"\n  );\n  return {\n    status: failed ? (\"failed\" as const) : (\"passed\" as const),\n    data: { entries: assessments },\n    ...(messages.length === 0 ? {} : { messages })\n  };\n}\n\nexport function unavailableResult(\n  code: MaintenanceRemindersUnavailableCode\n): CheckResult<MaintenanceRemindersFinalData> {\n  return {\n    status: \"unavailable\" as const,\n    reason: { code },\n    messages: [{ code, level: \"error\", message: wholeCheckUnavailableMessage(code) }]\n  };\n}\n\nfunction wholeCheckUnavailableMessage(code: MaintenanceRemindersUnavailableCode): string {\n  switch (code) {\n    case \"invalid-options\":\n      return \"maintenanceReminders options are invalid; recreate the Check with maintenanceReminders(entries) or restore its complete resolved options.\";\n    case \"execution-cancelled\":\n      return \"Maintenance reminder evaluation was cancelled before it could form a complete result; inspect the caller's cancellation reason and retry if appropriate.\";\n    case \"maintenance-reminders-internal-failure\":\n      return \"Maintenance reminders could not form a complete ordered assessment; check package/runtime integrity and retry.\";\n  }\n}\n\nfunction messageForEvaluation(evaluation: ReminderEvaluation): readonly CheckMessage[] {\n  const { assessment, message } = evaluation;\n  if (assessment.assessment === \"clear\") return [];\n  const level = assessment.mode === \"enforcing\" ? (\"error\" as const) : (\"warning\" as const);\n  const suffix = assessment.assessment === \"unavailable\" ? ` (${assessment.reason})` : \"\";\n  return [\n    {\n      code:\n        assessment.assessment === \"due\"\n          ? REMINDER_MESSAGE_CODE.due\n          : REMINDER_MESSAGE_CODE.unavailable,\n      level,\n      message: `${assessment.id}: ${message}${suffix}`\n    }\n  ];\n}\n\nexport function unavailableAssessment(\n  entry: Readonly<MaintenanceReminder>,\n  headCommit: string | null,\n  reason: MaintenanceReminderUnavailableReason\n): UnavailableMaintenanceReminderAssessment {\n  return {\n    assessment: \"unavailable\",\n    baseCommit: entry.baseCommit,\n    changedLines: null,\n    commitCount: null,\n    exceeded: [],\n    headCommit,\n    id: entry.id,\n    mode: modeOf(entry),\n    reason\n  };\n}\n\nexport function modeOf(entry: Readonly<MaintenanceReminder>): MaintenanceReminderMode {\n  return entry.mode === \"enforcing\" ? \"enforcing\" : \"advisory\";\n}\n\nexport function unavailableHistory(\n  reason: FirstParentHistoryUnavailableReason\n): FirstParentHistoryResolution {\n  return { kind: \"unavailable\", reason };\n}\n\nexport function reminderEvaluation(\n  entry: Readonly<MaintenanceReminder>,\n  assessment: MaintenanceReminderAssessment\n): ReminderEvaluation {\n  return { assessment, message: entry.message };\n}\n\nexport function completedMeasurement(\n  entry: Readonly<MaintenanceReminder>,\n  assessment: MaintenanceReminderAssessment\n): ReminderMeasurement {\n  return { kind: \"succeeded\", value: reminderEvaluation(entry, assessment) };\n}\n"]}

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

@@ -0,0 +1,153 @@
+import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
+import { exactFinalDataRecord, finalDataArray, invalidFinalData, nonNegativeSafeInteger } from "../final-data-parsing.mjs";
+const EMPTY_EXCEEDED = Object.freeze([]);
+const FULL_COMMIT_ID = /^(?:[0-9a-f]{40}|[0-9a-f]{64})$/i;
+const REMINDER_ID = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+/** 单条维护提醒无法测量时使用的稳定 reason code。 */
+export const MAINTENANCE_REMINDER_UNAVAILABLE_REASON = Object.freeze({
+    baseCommitUnavailable: "base-commit-unavailable",
+    baseNotFirstParentAncestor: "base-not-first-parent-ancestor",
+    firstParentHistoryInvalid: "first-parent-history-invalid",
+    firstParentHistoryUnavailable: "first-parent-history-unavailable",
+    headInvalid: "head-invalid",
+    headUnavailable: "head-unavailable",
+    numstatInvalid: "numstat-invalid",
+    numstatUnavailable: "numstat-unavailable"
+});
+const MAINTENANCE_REMINDER_UNAVAILABLE_REASONS = Object.freeze(Object.values(MAINTENANCE_REMINDER_UNAVAILABLE_REASON));
+/** 判断 unknown value 是否为维护提醒的稳定局部 ID。 */
+export function isMaintenanceReminderId(value) {
+    return typeof value === "string" && REMINDER_ID.test(value);
+}
+/** 判断 unknown value 是否为 Git 的完整 SHA-1 或 SHA-256 commit ID。 */
+export function isMaintenanceCommitId(value) {
+    return typeof value === "string" && FULL_COMMIT_ID.test(value);
+}
+/** 验证 discriminated entry assessments 并脱离 canonical final data。 */
+export function parseMaintenanceRemindersData(data) {
+    const value = exactFinalDataRecord(data, ["entries"], "maintenanceReminders");
+    const entries = finalDataArray(value.entries, "maintenanceReminders");
+    const parsedEntries = [];
+    const ids = new Set();
+    for (const entry of entries) {
+        const parsed = parseAssessment(entry);
+        if (ids.has(parsed.id))
+            throw invalidFinalData("maintenanceReminders");
+        ids.add(parsed.id);
+        parsedEntries.push(parsed);
+    }
+    return Object.freeze({ entries: Object.freeze(parsedEntries) });
+}
+function parseAssessment(value) {
+    const record = assessmentRecord(value);
+    const identity = assessmentIdentity(record);
+    if (record.assessment === "unavailable") {
+        return parseUnavailableAssessment(record, identity);
+    }
+    return parseMeasuredAssessment(record, identity);
+}
+function assessmentRecord(value) {
+    return exactFinalDataRecord(value, valueAssessment(value) === "unavailable"
+        ? unavailableAssessmentKeys()
+        : measuredAssessmentKeys(), "maintenanceReminders");
+}
+function unavailableAssessmentKeys() {
+    return [
+        "assessment",
+        "baseCommit",
+        "changedLines",
+        "commitCount",
+        "exceeded",
+        "headCommit",
+        "id",
+        "mode",
+        "reason"
+    ];
+}
+function measuredAssessmentKeys() {
+    return [
+        "assessment",
+        "baseCommit",
+        "changedLines",
+        "commitCount",
+        "exceeded",
+        "headCommit",
+        "id",
+        "mode"
+    ];
+}
+function assessmentIdentity(record) {
+    const id = isMaintenanceReminderId(record.id) ? record.id : undefined;
+    const mode = record.mode === "advisory" || record.mode === "enforcing" ? record.mode : undefined;
+    const baseCommit = isMaintenanceCommitId(record.baseCommit) ? record.baseCommit : undefined;
+    if (id === undefined || mode === undefined || baseCommit === undefined)
+        throw invalidFinalData("maintenanceReminders");
+    return { baseCommit, id, mode };
+}
+function parseMeasuredAssessment(record, identity) {
+    if (record.assessment !== "clear" && record.assessment !== "due")
+        throw invalidFinalData("maintenanceReminders");
+    const commitCount = nonNegativeSafeInteger(record.commitCount);
+    const changedLines = nonNegativeSafeInteger(record.changedLines);
+    const headCommit = isMaintenanceCommitId(record.headCommit) ? record.headCommit : undefined;
+    const exceeded = parseExceeded(record.exceeded);
+    if (commitCount === undefined ||
+        changedLines === undefined ||
+        headCommit === undefined ||
+        exceeded === undefined ||
+        (record.assessment === "clear" ? exceeded.length !== 0 : exceeded.length === 0)) {
+        throw invalidFinalData("maintenanceReminders");
+    }
+    return Object.freeze({
+        assessment: record.assessment,
+        baseCommit: identity.baseCommit,
+        changedLines,
+        commitCount,
+        exceeded,
+        headCommit,
+        id: identity.id,
+        mode: identity.mode
+    });
+}
+function parseUnavailableAssessment(record, identity) {
+    const exceeded = finalDataArray(record.exceeded, "maintenanceReminders");
+    const headCommit = record.headCommit;
+    if (record.changedLines !== null ||
+        record.commitCount !== null ||
+        exceeded.length !== 0 ||
+        (headCommit !== null && !isMaintenanceCommitId(headCommit)) ||
+        !isUnavailableReason(record.reason)) {
+        throw invalidFinalData("maintenanceReminders");
+    }
+    return Object.freeze({
+        assessment: "unavailable",
+        baseCommit: identity.baseCommit,
+        changedLines: null,
+        commitCount: null,
+        exceeded: EMPTY_EXCEEDED,
+        headCommit,
+        id: identity.id,
+        mode: identity.mode,
+        reason: record.reason
+    });
+}
+function valueAssessment(value) {
+    return snapshotClosedRecord(value)?.assessment;
+}
+function parseExceeded(value) {
+    const entries = finalDataArray(value, "maintenanceReminders");
+    const exceeded = [];
+    const uniqueEntries = new Set();
+    for (const entry of entries) {
+        if ((entry !== "commits" && entry !== "changed-lines") || uniqueEntries.has(entry)) {
+            return undefined;
+        }
+        uniqueEntries.add(entry);
+        exceeded.push(entry);
+    }
+    return Object.freeze(exceeded);
+}
+function isUnavailableReason(value) {
+    return MAINTENANCE_REMINDER_UNAVAILABLE_REASONS.some((reason) => reason === value);
+}
+//# sourceMappingURL=final-data.mjs.map

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

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