@zxyycom/vibe-check 0.0.2 → 0.0.3

package/dist/esm/data-boundary/closed-values.mjs

@@ -9,6 +9,8 @@ function ownDataShape(value) {
     }
     if (keys.some((key) => {
         const descriptor = descriptors[key];
+        if (descriptor === undefined)
+            return true;
         return descriptor.get !== undefined || descriptor.set !== undefined;
     }))
         return undefined;
@@ -44,16 +46,30 @@ export function snapshotClosedRecord(value) {
             return undefined;
         const shape = ownDataShape(value);
         if (shape === undefined ||
-            shape.keys.some((key) => shape.descriptors[key].enumerable !== true)) {
+            shape.keys.some((key) => shape.descriptors[key]?.enumerable !== true)) {
             return undefined;
         }
-        return Object.freeze(Object.fromEntries(shape.keys.map((key) => [key, shape.descriptors[key].value])));
+        const entries = shape.keys.map((key) => {
+            const descriptor = shape.descriptors[key];
+            if (descriptor === undefined)
+                throw new TypeError(`Missing own descriptor: ${key}`);
+            return [key, descriptor.value];
+        });
+        return Object.freeze(Object.fromEntries(entries));
     }
     catch {
         return undefined;
     }
 }
-/** Snapshots a closed plain record only when it has exactly the declared own keys. */
+/**
+ * 取得字段集合恰好匹配调用方字段表的闭合普通记录外层浅快照。
+ *
+ * 输入必须是使用 `Object.prototype` 或 null prototype 的非数组对象，且每个自有属性都是可枚举数据属性。
+ * 调用方持有的 `keys` 必须是稳定、无重复的字符串列表；缺字段、多字段、symbol 键、存取器或不可枚举属性
+ * 均返回 `undefined`。成功结果是使用 `Object.prototype` 的冻结浅副本：只固定外层字段，保留 callback、
+ * `undefined` 与嵌套对象或数组的原引用，调用方仍须逐字段验证。这不是 JSON 验证器；不调用 getter，
+ * 但反射 Proxy 可能执行其 trap，反射失败时返回 `undefined`。
+ */
 export function snapshotExactClosedRecord(value, keys) {
     const record = snapshotClosedRecord(value);
     return record !== undefined && hasExactPlainRecordKeys(record, keys) ? record : undefined;
@@ -71,12 +87,20 @@ function closedArrayItems(shape, length) {
     const items = [];
     for (let index = 0; index < length; index += 1) {
         const descriptor = shape.descriptors[String(index)];
-        if (descriptor === undefined || descriptor.enumerable !== true)
+        if (descriptor?.enumerable !== true)
             return undefined;
         items.push(descriptor.value);
     }
     return Object.freeze(items);
 }
+/**
+ * 取得标准无空洞数组的外层浅快照。
+ *
+ * 输入必须使用 `Array.prototype`，除标准 `length` 和可枚举索引外没有其它自有属性，也不能包含存取器；
+ * 稀疏数组、额外属性或其它不符合条件的输入返回 `undefined`。成功结果是冻结浅副本，只固定数组结构，
+ * 保留 callback、`undefined` 与嵌套值的原引用，不检查元素的业务类型或 JSON 合法性。不调用存取器，
+ * 但反射 Proxy 可能执行其 trap，反射失败时返回 `undefined`。
+ */
 export function snapshotClosedArray(value) {
     try {
         if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype)

package/dist/esm/data-boundary/closed-values.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"closed-values.mjs","sourceRoot":"","sources":["../../../src/data-boundary/closed-values.ts"],"names":[],"mappings":"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","sourcesContent":["interface OwnDataShape {\n  readonly descriptors: Readonly<Record<string, PropertyDescriptor>>;\n  readonly keys: readonly string[];\n}\n\nfunction ownDataShape(value: object): OwnDataShape | undefined {\n  const descriptors: Readonly<Record<string, PropertyDescriptor>> =\n    Object.getOwnPropertyDescriptors(value);\n  const ownKeys = Reflect.ownKeys(descriptors);\n  const keys: string[] = [];\n  for (const key of ownKeys) {\n    if (typeof key !== \"string\") return undefined;\n    keys.push(key);\n  }\n  if (\n    keys.some((key) => {\n      const descriptor = descriptors[key];\n      return descriptor.get !== undefined || descriptor.set !== undefined;\n    })\n  )\n    return undefined;\n  return { descriptors, keys };\n}\n\nexport function snapshotPlainRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  try {\n    if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n      return undefined;\n    }\n    const prototype: unknown = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) {\n      return undefined;\n    }\n    const descriptors: Readonly<Record<string, PropertyDescriptor>> =\n      Object.getOwnPropertyDescriptors(value);\n    if (\n      Object.values(descriptors).some(\n        (descriptor) => descriptor.get !== undefined || descriptor.set !== undefined\n      )\n    ) {\n      return undefined;\n    }\n    return Object.fromEntries(\n      Object.entries(descriptors)\n        .filter(([, descriptor]) => descriptor.enumerable === true)\n        .map(([key, descriptor]) => [key, descriptor.value as unknown])\n    );\n  } catch {\n    return undefined;\n  }\n}\n\nexport function snapshotClosedRecord(\n  value: unknown\n): Readonly<Record<string, unknown>> | undefined {\n  try {\n    if (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n    const prototype: unknown = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) return undefined;\n    const shape = ownDataShape(value);\n    if (\n      shape === undefined ||\n      shape.keys.some((key) => shape.descriptors[key].enumerable !== true)\n    ) {\n      return undefined;\n    }\n    return Object.freeze(\n      Object.fromEntries(shape.keys.map((key) => [key, shape.descriptors[key].value as unknown]))\n    );\n  } catch {\n    return undefined;\n  }\n}\n\n/** Snapshots a closed plain record only when it has exactly the declared own keys. */\nexport function snapshotExactClosedRecord(\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 closedArrayLength(shape: OwnDataShape): number | undefined {\n  const descriptor = shape.descriptors.length;\n  if (typeof descriptor?.value !== \"number\" || descriptor.enumerable !== false) return undefined;\n  const length = descriptor.value;\n  return Number.isSafeInteger(length) && length >= 0 && shape.keys.length === length + 1\n    ? length\n    : undefined;\n}\n\nfunction closedArrayItems(shape: OwnDataShape, length: number): readonly unknown[] | undefined {\n  const items: unknown[] = [];\n  for (let index = 0; index < length; index += 1) {\n    const descriptor = shape.descriptors[String(index)];\n    if (descriptor === undefined || descriptor.enumerable !== true) return undefined;\n    items.push(descriptor.value as unknown);\n  }\n  return Object.freeze(items);\n}\n\nexport function snapshotClosedArray(value: unknown): readonly unknown[] | undefined {\n  try {\n    if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype) return undefined;\n    const shape = ownDataShape(value);\n    if (shape === undefined) return undefined;\n    const length = closedArrayLength(shape);\n    return length === undefined ? undefined : closedArrayItems(shape, length);\n  } catch {\n    return undefined;\n  }\n}\n\nexport function hasExactPlainRecordKeys(\n  value: Readonly<Record<string, unknown>>,\n  keys: readonly string[]\n): boolean {\n  const actualKeys = Object.keys(value);\n  return actualKeys.length === keys.length && actualKeys.every((key) => keys.includes(key));\n}\n\nexport function hasRequiredAndOptionalRecordKeys(\n  value: Readonly<Record<string, unknown>>,\n  keys: Readonly<{\n    readonly optional: readonly string[];\n    readonly required: readonly string[];\n  }>\n): boolean {\n  const supportedKeys = new Set([...keys.required, ...keys.optional]);\n  return (\n    keys.required.every((key) => Object.hasOwn(value, key)) &&\n    Object.keys(value).every((key) => supportedKeys.has(key))\n  );\n}\n\nexport interface ClosedPolicyRecordKeys {\n  readonly optional?: readonly string[];\n  readonly required?: readonly string[];\n}\n\n/** Snapshots an authoring record whose keys are limited to one required/optional policy. */\nexport function snapshotClosedPolicyRecord(\n  value: unknown,\n  keys: ClosedPolicyRecordKeys\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  return record !== undefined &&\n    hasRequiredAndOptionalRecordKeys(record, {\n      optional: keys.optional ?? [],\n      required: keys.required ?? []\n    })\n    ? record\n    : undefined;\n}\n"]}
+{"version":3,"file":"closed-values.mjs","sourceRoot":"","sources":["../../../src/data-boundary/closed-values.ts"],"names":[],"mappings":"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","sourcesContent":["interface OwnDataShape {\n  readonly descriptors: Readonly<Record<string, PropertyDescriptor>>;\n  readonly keys: readonly string[];\n}\n\nfunction ownDataShape(value: object): OwnDataShape | undefined {\n  const descriptors: Readonly<Record<string, PropertyDescriptor>> =\n    Object.getOwnPropertyDescriptors(value);\n  const ownKeys = Reflect.ownKeys(descriptors);\n  const keys: string[] = [];\n  for (const key of ownKeys) {\n    if (typeof key !== \"string\") return undefined;\n    keys.push(key);\n  }\n  if (\n    keys.some((key) => {\n      const descriptor = descriptors[key];\n      if (descriptor === undefined) return true;\n      return descriptor.get !== undefined || descriptor.set !== undefined;\n    })\n  )\n    return undefined;\n  return { descriptors, keys };\n}\n\nexport function snapshotPlainRecord(value: unknown): Readonly<Record<string, unknown>> | undefined {\n  try {\n    if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n      return undefined;\n    }\n    const prototype: unknown = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) {\n      return undefined;\n    }\n    const descriptors: Readonly<Record<string, PropertyDescriptor>> =\n      Object.getOwnPropertyDescriptors(value);\n    if (\n      Object.values(descriptors).some(\n        (descriptor) => descriptor.get !== undefined || descriptor.set !== undefined\n      )\n    ) {\n      return undefined;\n    }\n    return Object.fromEntries(\n      Object.entries(descriptors)\n        .filter(([, descriptor]) => descriptor.enumerable === true)\n        .map(([key, descriptor]) => [key, descriptor.value as unknown])\n    );\n  } catch {\n    return undefined;\n  }\n}\n\nexport function snapshotClosedRecord(\n  value: unknown\n): Readonly<Record<string, unknown>> | undefined {\n  try {\n    if (value === null || typeof value !== \"object\" || Array.isArray(value)) return undefined;\n    const prototype: unknown = Object.getPrototypeOf(value);\n    if (prototype !== Object.prototype && prototype !== null) return undefined;\n    const shape = ownDataShape(value);\n    if (\n      shape === undefined ||\n      shape.keys.some((key) => shape.descriptors[key]?.enumerable !== true)\n    ) {\n      return undefined;\n    }\n    const entries = shape.keys.map((key) => {\n      const descriptor = shape.descriptors[key];\n      if (descriptor === undefined) throw new TypeError(`Missing own descriptor: ${key}`);\n      return [key, descriptor.value as unknown] as const;\n    });\n    return Object.freeze(Object.fromEntries(entries));\n  } catch {\n    return undefined;\n  }\n}\n\n/**\n * 取得字段集合恰好匹配调用方字段表的闭合普通记录外层浅快照。\n *\n * 输入必须是使用 `Object.prototype` 或 null prototype 的非数组对象，且每个自有属性都是可枚举数据属性。\n * 调用方持有的 `keys` 必须是稳定、无重复的字符串列表；缺字段、多字段、symbol 键、存取器或不可枚举属性\n * 均返回 `undefined`。成功结果是使用 `Object.prototype` 的冻结浅副本：只固定外层字段，保留 callback、\n * `undefined` 与嵌套对象或数组的原引用，调用方仍须逐字段验证。这不是 JSON 验证器；不调用 getter，\n * 但反射 Proxy 可能执行其 trap，反射失败时返回 `undefined`。\n */\nexport function snapshotExactClosedRecord(\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 closedArrayLength(shape: OwnDataShape): number | undefined {\n  const descriptor = shape.descriptors.length;\n  if (typeof descriptor?.value !== \"number\" || descriptor.enumerable !== false) return undefined;\n  const length = descriptor.value;\n  return Number.isSafeInteger(length) && length >= 0 && shape.keys.length === length + 1\n    ? length\n    : undefined;\n}\n\nfunction closedArrayItems(shape: OwnDataShape, length: number): readonly unknown[] | undefined {\n  const items: unknown[] = [];\n  for (let index = 0; index < length; index += 1) {\n    const descriptor = shape.descriptors[String(index)];\n    if (descriptor?.enumerable !== true) return undefined;\n    items.push(descriptor.value as unknown);\n  }\n  return Object.freeze(items);\n}\n\n/**\n * 取得标准无空洞数组的外层浅快照。\n *\n * 输入必须使用 `Array.prototype`，除标准 `length` 和可枚举索引外没有其它自有属性，也不能包含存取器；\n * 稀疏数组、额外属性或其它不符合条件的输入返回 `undefined`。成功结果是冻结浅副本，只固定数组结构，\n * 保留 callback、`undefined` 与嵌套值的原引用，不检查元素的业务类型或 JSON 合法性。不调用存取器，\n * 但反射 Proxy 可能执行其 trap，反射失败时返回 `undefined`。\n */\nexport function snapshotClosedArray(value: unknown): readonly unknown[] | undefined {\n  try {\n    if (!Array.isArray(value) || Object.getPrototypeOf(value) !== Array.prototype) return undefined;\n    const shape = ownDataShape(value);\n    if (shape === undefined) return undefined;\n    const length = closedArrayLength(shape);\n    return length === undefined ? undefined : closedArrayItems(shape, length);\n  } catch {\n    return undefined;\n  }\n}\n\nexport function hasExactPlainRecordKeys(\n  value: Readonly<Record<string, unknown>>,\n  keys: readonly string[]\n): boolean {\n  const actualKeys = Object.keys(value);\n  return actualKeys.length === keys.length && actualKeys.every((key) => keys.includes(key));\n}\n\nexport function hasRequiredAndOptionalRecordKeys(\n  value: Readonly<Record<string, unknown>>,\n  keys: Readonly<{\n    readonly optional: readonly string[];\n    readonly required: readonly string[];\n  }>\n): boolean {\n  const supportedKeys = new Set([...keys.required, ...keys.optional]);\n  return (\n    keys.required.every((key) => Object.hasOwn(value, key)) &&\n    Object.keys(value).every((key) => supportedKeys.has(key))\n  );\n}\n\nexport interface ClosedPolicyRecordKeys {\n  readonly optional?: readonly string[];\n  readonly required?: readonly string[];\n}\n\n/** Snapshots an authoring record whose keys are limited to one required/optional policy. */\nexport function snapshotClosedPolicyRecord(\n  value: unknown,\n  keys: ClosedPolicyRecordKeys\n): Readonly<Record<string, unknown>> | undefined {\n  const record = snapshotClosedRecord(value);\n  return record !== undefined &&\n    hasRequiredAndOptionalRecordKeys(record, {\n      optional: keys.optional ?? [],\n      required: keys.required ?? []\n    })\n    ? record\n    : undefined;\n}\n"]}

package/dist/esm/{package-checks/project-files → data-boundary}/config-glob.mjs

@@ -1,8 +1,8 @@
 import { minimatch } from "minimatch";
-import { toSlashPath } from "../host-environment/path.mjs";
+import { toSlashPath } from "./project-path.mjs";
 /**
- * Product config glob 的唯一 matcher boundary。
- * Candidate 使用 slash form；dot path 只由显式 glob 决定，不附加隐式忽略规则。
+ * Product config glob's single matcher boundary. Candidates use slash form;
+ * dot paths participate only when an explicit glob matches them.
  */
 export function matchesAnyConfigGlob(candidatePath, configGlobs) {
     const normalizedCandidatePath = toSlashPath(candidatePath);

package/dist/esm/data-boundary/config-glob.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-glob.mjs","sourceRoot":"","sources":["../../../src/data-boundary/config-glob.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,aAAqB,EACrB,WAA8B;IAE9B,MAAM,uBAAuB,GAAG,WAAW,CAAC,aAAa,CAAC,CAAC;IAC3D,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE,CACrC,SAAS,CAAC,uBAAuB,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAC9D,CAAC;AACJ,CAAC","sourcesContent":["import { minimatch } from \"minimatch\";\n\nimport { toSlashPath } from \"./project-path.ts\";\n\n/**\n * Product config glob's single matcher boundary. Candidates use slash form;\n * dot paths participate only when an explicit glob matches them.\n */\nexport function matchesAnyConfigGlob(\n  candidatePath: string,\n  configGlobs: readonly string[]\n): boolean {\n  const normalizedCandidatePath = toSlashPath(candidatePath);\n  return configGlobs.some((configGlob) =>\n    minimatch(normalizedCandidatePath, configGlob, { dot: true })\n  );\n}\n"]}

package/dist/esm/data-boundary/project-path.mjs

@@ -0,0 +1,19 @@
+/** Converts a host path spelling to the Product's slash-path form. */
+export function toSlashPath(filePath) {
+    return filePath.replace(/\\/g, "/");
+}
+/** Recognizes one stable project-root-relative slash path. */
+export function isNormalizedProjectRelativePath(value) {
+    if (typeof value !== "string" ||
+        value.length === 0 ||
+        value.startsWith("/") ||
+        value.includes("\\") ||
+        value.includes("\u0000") ||
+        /^[A-Za-z]:/u.test(value)) {
+        return false;
+    }
+    return value
+        .split("/")
+        .every((segment) => segment.length > 0 && segment !== "." && segment !== "..");
+}
+//# sourceMappingURL=project-path.mjs.map

package/dist/esm/data-boundary/project-path.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-path.mjs","sourceRoot":"","sources":["../../../src/data-boundary/project-path.ts"],"names":[],"mappings":"AAAA,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,+BAA+B,CAAC,KAAc;IAC5D,IACE,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;QACxB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EACzB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,KAAK,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,KAAK,GAAG,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC;AACnF,CAAC","sourcesContent":["/** Converts a host path spelling to the Product's slash-path form. */\nexport function toSlashPath(filePath: string): string {\n  return filePath.replace(/\\\\/g, \"/\");\n}\n\n/** Recognizes one stable project-root-relative slash path. */\nexport function isNormalizedProjectRelativePath(value: unknown): value is string {\n  if (\n    typeof value !== \"string\" ||\n    value.length === 0 ||\n    value.startsWith(\"/\") ||\n    value.includes(\"\\\\\") ||\n    value.includes(\"\\u0000\") ||\n    /^[A-Za-z]:/u.test(value)\n  ) {\n    return false;\n  }\n  return value\n    .split(\"/\")\n    .every((segment) => segment.length > 0 && segment !== \".\" && segment !== \"..\");\n}\n"]}

package/dist/esm/index.mjs

@@ -4,7 +4,9 @@
  *
  * @packageDocumentation
  */
-export { cacheJsonByKey } from "./cache/cache-json-by-key.mjs";
+export { cacheJsonByKey } from "./package-tools/cache/cache-json-by-key.mjs";
+export { canonicalizeJsonObject, canonicalizeJsonValue, canonicalJsonBytes, canonicalJsonText } from "./data-boundary/canonical-data.mjs";
+export { snapshotClosedArray, snapshotExactClosedRecord } from "./data-boundary/closed-values.mjs";
 export { duplicateDetection } from "./package-checks/duplicate-detection/default-check.mjs";
 export { parseDuplicateDetectionData } from "./package-checks/duplicate-detection/final-data.mjs";
 export { fileMetrics } from "./package-checks/file-metrics/constructor.mjs";
@@ -17,17 +19,22 @@ export { jsonSchemaValidation } from "./package-checks/json-schema-validation/de
 export { parseJsonSchemaValidationData } from "./package-checks/json-schema-validation/final-data.mjs";
 export { jsonValidation } from "./package-checks/json-validation/default-check.mjs";
 export { parseJsonValidationData } from "./package-checks/json-validation/final-data.mjs";
+export { commandCheck } from "./package-checks/command-check/command-check.mjs";
 export { maintenanceReminders } from "./package-checks/maintenance-reminders/maintenance-reminders.mjs";
 export { parseMaintenanceRemindersData } from "./package-checks/maintenance-reminders/final-data.mjs";
+export { markdownLint } from "./package-checks/markdown-lint/default-check.mjs";
+export { parseMarkdownLintData } from "./package-checks/markdown-lint/final-data.mjs";
 export { markdownLinkValidation } from "./package-checks/markdown-link-validation/default-check.mjs";
 export { parseMarkdownLinkValidationData } from "./package-checks/markdown-link-validation/final-data.mjs";
-export { reconcileFindingWaivers } from "./finding-waivers/reconciliation.mjs";
-export { presentCheckFindings } from "./check/finding-presentation.mjs";
+export { reconcileFindingWaivers } from "./package-tools/finding-waivers/reconciliation.mjs";
+export { presentCheckFindings } from "./package-tools/finding-presentation/finding-presentation.mjs";
 export { defaultProjectFileSelection } from "./package-checks/project-files/configuration.mjs";
 export { collectProjectFiles } from "./package-checks/project-files/public-collection.mjs";
 export { defineCheck, inherit } from "./check/check.mjs";
-export { defineAdmissionPolicy, defineConfig } from "./project-definition/project-definition.mjs";
-export { createLearnedCriticalPathStrategy } from "./learned-critical-path/strategy.mjs";
+export { all, any, changeFlag, exactlyOne, none, not, notAll } from "./check/flag-enablement.mjs";
+export { defineAdmissionPolicy } from "./package-tools/admission-policy/define-admission-policy.mjs";
+export { defineConfig } from "./project-definition/project-definition.mjs";
+export { createLearnedCriticalPathStrategy } from "./package-tools/learned-critical-path/strategy.mjs";
 export { createAdmissionGraph } from "./project-run/task-scheduler/admission-core/core.mjs";
 export { run } from "./project-run/run.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/esm/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAWjG,OAAO,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAUnF,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAW3F,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAU3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uDAAuD,CAAC;AAkBtG,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAWzF,OAAO,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAC;AAMvG,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAMrG,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AACpG,OAAO,EAAE,+BAA+B,EAAE,MAAM,yDAAyD,CAAC;AAU1G,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AASvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAO1F,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAcxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AACjG,OAAO,EAAE,iCAAiC,EAAE,MAAM,qCAAqC,CAAC;AAKxF,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AA0C3F,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["/**\n * Vibe Check 是由项目在 Node runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。\n * 所有公开能力从 package root 导入；package `README.md` 说明 consumer authoring、结果读取和分发范围。\n *\n * @packageDocumentation\n */\nexport { cacheJsonByKey } from \"./cache/cache-json-by-key.ts\";\nexport type { CacheJsonByKeyOptions, CacheJsonByKeyResult } from \"./cache/cache-json-by-key.ts\";\nexport { duplicateDetection } from \"./package-checks/duplicate-detection/default-check.ts\";\nexport { parseDuplicateDetectionData } from \"./package-checks/duplicate-detection/final-data.ts\";\nexport type { DuplicateDetectionFinalData } from \"./package-checks/duplicate-detection/final-data.ts\";\nexport type {\n  DuplicateDetectionFindingIdentity,\n  DuplicateDetectionFindingLocation,\n  DuplicateDetectionFindingWaiver,\n  DuplicateDetectionOptions,\n  ResolvedDuplicateDetectionOptions\n} from \"./package-checks/duplicate-detection/options.ts\";\nexport type { DuplicateDetectionUnavailableReasonCode } from \"./package-checks/duplicate-detection/execution.ts\";\nexport type { DuplicateDetectionRecordData } from \"./package-checks/duplicate-detection/records.ts\";\nexport { fileMetrics } from \"./package-checks/file-metrics/constructor.ts\";\nexport { parseFileMetricsData } from \"./package-checks/file-metrics/final-data.ts\";\nexport type { FileMetricsFinalData } from \"./package-checks/file-metrics/final-data.ts\";\nexport type {\n  FileMetricsFindingIdentity,\n  FileMetricsFindingWaiver,\n  FileMetricsOptions,\n  ResolvedFileMetricsOptions\n} from \"./package-checks/file-metrics/options.ts\";\nexport type { FileMetricsUnavailableReasonCode } from \"./package-checks/file-metrics/execution.ts\";\nexport type { FileMetricsRecordData } from \"./package-checks/file-metrics/records.ts\";\nexport { functionMetrics } from \"./package-checks/function-metrics/constructor.ts\";\nexport { parseFunctionMetricsData } from \"./package-checks/function-metrics/final-data.ts\";\nexport type { FunctionMetricsFinalData } from \"./package-checks/function-metrics/final-data.ts\";\nexport type {\n  FunctionMetricsFindingIdentity,\n  FunctionMetricsFindingMetric,\n  FunctionMetricsFindingWaiver,\n  FunctionMetricsOptions,\n  ResolvedFunctionMetricsOptions\n} from \"./package-checks/function-metrics/options.ts\";\nexport type { FunctionMetricsUnavailableReasonCode } from \"./package-checks/function-metrics/execution.ts\";\nexport type { FunctionMetricsRecordData } from \"./package-checks/function-metrics/records.ts\";\nexport { secretDetection } from \"./package-checks/secret-detection/default-check.ts\";\nexport { parseSecretDetectionData } from \"./package-checks/secret-detection/final-data.ts\";\nexport type { SecretDetectionFinalData } from \"./package-checks/secret-detection/final-data.ts\";\nexport type {\n  ResolvedSecretDetectionOptions,\n  SecretDetectionFindingIdentity,\n  SecretDetectionFindingWaiver,\n  SecretDetectionOptions\n} from \"./package-checks/secret-detection/options.ts\";\nexport type { SecretDetectionUnavailableReasonCode } from \"./package-checks/secret-detection/execution.ts\";\nexport type { SecretDetectionRecordData } from \"./package-checks/secret-detection/records.ts\";\nexport { jsonSchemaValidation } from \"./package-checks/json-schema-validation/default-check.ts\";\nexport { parseJsonSchemaValidationData } from \"./package-checks/json-schema-validation/final-data.ts\";\nexport type { JsonSchemaValidationFinalData } from \"./package-checks/json-schema-validation/final-data.ts\";\nexport type {\n  JsonSchemaIdentity,\n  JsonSchemaIdentityMode,\n  JsonSchemaInstanceBinding,\n  JsonSchemaReferenceResolution,\n  JsonSchemaReferenceSource,\n  JsonSchemaValidationOptions,\n  RegisteredJsonSchema,\n  ResolvedJsonSchemaValidationOptions\n} from \"./package-checks/json-schema-validation/options.ts\";\nexport type {\n  JsonSchemaDocumentReason,\n  JsonSchemaValidationRecordData,\n  JsonSchemaValidationRecordReason,\n  JsonSchemaValidationUnavailableCode\n} from \"./package-checks/json-schema-validation/json-schema-validation.ts\";\nexport { jsonValidation } from \"./package-checks/json-validation/default-check.ts\";\nexport { parseJsonValidationData } from \"./package-checks/json-validation/final-data.ts\";\nexport type { JsonValidationFinalData } from \"./package-checks/json-validation/final-data.ts\";\nexport type {\n  JsonValidationOptions,\n  ResolvedJsonValidationOptions\n} from \"./package-checks/json-validation/options.ts\";\nexport type {\n  JsonValidationRecordData,\n  JsonValidationRecordReason,\n  JsonValidationUnavailableCode\n} from \"./package-checks/json-validation/json-validation.ts\";\nexport { maintenanceReminders } from \"./package-checks/maintenance-reminders/maintenance-reminders.ts\";\nexport type {\n  MaintenanceReminder,\n  MaintenanceReminderOptions,\n  MaintenanceRemindersUnavailableCode\n} from \"./package-checks/maintenance-reminders/maintenance-reminders.ts\";\nexport { parseMaintenanceRemindersData } from \"./package-checks/maintenance-reminders/final-data.ts\";\nexport type {\n  MaintenanceReminderAssessment,\n  MaintenanceReminderUnavailableReason,\n  MaintenanceRemindersFinalData\n} from \"./package-checks/maintenance-reminders/final-data.ts\";\nexport { markdownLinkValidation } from \"./package-checks/markdown-link-validation/default-check.ts\";\nexport { parseMarkdownLinkValidationData } from \"./package-checks/markdown-link-validation/final-data.ts\";\nexport type { MarkdownLinkValidationFinalData } from \"./package-checks/markdown-link-validation/final-data.ts\";\nexport type {\n  MarkdownLinkValidationOptions,\n  ResolvedMarkdownLinkValidationOptions\n} from \"./package-checks/markdown-link-validation/options.ts\";\nexport type { MarkdownLinkValidationUnavailableReason } from \"./package-checks/markdown-link-validation/execution.ts\";\nexport type { MarkdownLinkValidationRecordData } from \"./package-checks/markdown-link-validation/records.ts\";\nexport type { MarkdownLinkFindingReason } from \"./package-checks/markdown-link-validation/local-resolver.ts\";\nexport type { FindingPolicy } from \"./package-checks/code-quality-findings/policy.ts\";\nexport { reconcileFindingWaivers } from \"./finding-waivers/reconciliation.ts\";\nexport { presentCheckFindings } from \"./check/finding-presentation.ts\";\nexport type {\n  FindingWaiver,\n  FindingWaiverAudit,\n  FindingWaiverReconciliation,\n  MaterializedFindingWaiver,\n  ReconciledFinding,\n  ReconcileFindingWaiversOptions\n} from \"./finding-waivers/reconciliation.ts\";\nexport { defaultProjectFileSelection } from \"./package-checks/project-files/configuration.ts\";\nexport { collectProjectFiles } from \"./package-checks/project-files/public-collection.ts\";\nexport type { CollectProjectFilesOptions } from \"./package-checks/project-files/public-collection.ts\";\nexport type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions,\n  ProjectFileSource\n} from \"./package-checks/project-files/configuration.ts\";\nexport { defineCheck, inherit } from \"./check/check.ts\";\nexport type {\n  Check,\n  CheckDependencies,\n  CheckExecution,\n  CheckExecutionContext,\n  CheckPreflight,\n  CheckPreflightResult,\n  CheckResourceClaims,\n  CheckOutcome,\n  CheckResult,\n  CheckUnavailableReason,\n  InheritableCheckCollection\n} from \"./check/check.ts\";\nexport { defineAdmissionPolicy, defineConfig } from \"./project-definition/project-definition.ts\";\nexport { createLearnedCriticalPathStrategy } from \"./learned-critical-path/strategy.ts\";\nexport type {\n  LearnedCriticalPathObservation,\n  LearnedCriticalPathStrategyOptions\n} from \"./learned-critical-path/strategy.ts\";\nexport { createAdmissionGraph } from \"./project-run/task-scheduler/admission-core/core.ts\";\nexport type {\n  AdmissionPolicy,\n  AdmissionPolicyContext,\n  AdmissionPolicyMeasurement,\n  AdmissionProposal,\n  AdmissionCatalog,\n  AdmissionGraph,\n  AdmissionGraphInput,\n  AdmissionInspection,\n  AdmissionNonSelectableTask,\n  AdmissionRejectionReason,\n  AdmissionScopeLifecycle,\n  AdmissionSelectionRejectionReason,\n  AdmissionSelectionValidation,\n  AdmissionSelectionValidationRejectionReason,\n  AdmissionSettlementOutcome,\n  AdmissionSettledTask,\n  AdmissionState,\n  AdmissionTransitionResult,\n  CustomAdmissionPreparationContext,\n  CustomAdmissionStrategy,\n  PreparedCustomAdmissionStrategy,\n  ProgressPreviewFormatter,\n  ProjectOutputs,\n  ProjectDefinition,\n  SchedulerDecisionMeasurementCumulative,\n  SchedulerGraphSnapshot,\n  SchedulerMeasurementContext,\n  SchedulerMeasurementHook,\n  SchedulerMeasurementIntervalContribution,\n  SchedulerMeasurementActionObservationInterval,\n  SchedulerMeasurementActionObservation,\n  SchedulerMeasurementEffect,\n  SchedulerRawMeasurement,\n  SchedulerPolicy\n} from \"./project-definition/project-definition.ts\";\nexport type {\n  CheckAggregate,\n  CheckAggregation,\n  RunControls\n} from \"./project-run/controls/contract.ts\";\nexport { run } from \"./project-run/run.ts\";\nexport type { RunOutputStatus, RunOutputStatuses } from \"./project-run/outputs/status.ts\";\nexport type { RunResult } from \"./project-run/result.ts\";\n"]}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAK5E,OAAO,EACL,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,mCAAmC,CAAC;AAM3C,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClG,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAE3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAWjG,OAAO,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,6CAA6C,CAAC;AAUnF,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AACnF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAW3F,OAAO,EAAE,eAAe,EAAE,MAAM,oDAAoD,CAAC;AACrF,OAAO,EAAE,wBAAwB,EAAE,MAAM,iDAAiD,CAAC;AAU3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uDAAuD,CAAC;AAkBtG,OAAO,EAAE,cAAc,EAAE,MAAM,mDAAmD,CAAC;AACnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAC;AAWzF,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAiB/E,OAAO,EAAE,oBAAoB,EAAE,MAAM,iEAAiE,CAAC;AAOvG,OAAO,EAAE,6BAA6B,EAAE,MAAM,sDAAsD,CAAC;AAMrG,OAAO,EAAE,YAAY,EAAE,MAAM,iDAAiD,CAAC;AAC/E,OAAO,EAAE,qBAAqB,EAAE,MAAM,8CAA8C,CAAC;AAcrF,OAAO,EAAE,sBAAsB,EAAE,MAAM,4DAA4D,CAAC;AACpG,OAAO,EAAE,+BAA+B,EAAE,MAAM,yDAAyD,CAAC;AAU1G,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,8DAA8D,CAAC;AASpG,OAAO,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,MAAM,qDAAqD,CAAC;AAO1F,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACxD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAkBjG,OAAO,EAAE,qBAAqB,EAAE,MAAM,6DAA6D,CAAC;AACpG,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC1E,OAAO,EAAE,iCAAiC,EAAE,MAAM,mDAAmD,CAAC;AAKtG,OAAO,EAAE,oBAAoB,EAAE,MAAM,qDAAqD,CAAC;AAgD3F,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["/**\n * Vibe Check 是由项目在 Node runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。\n * 所有公开能力从 package root 导入；package `README.md` 说明 consumer authoring、结果读取和分发范围。\n *\n * @packageDocumentation\n */\nexport { cacheJsonByKey } from \"./package-tools/cache/cache-json-by-key.ts\";\nexport type {\n  CacheJsonByKeyOptions,\n  CacheJsonByKeyResult\n} from \"./package-tools/cache/cache-json-by-key.ts\";\nexport {\n  canonicalizeJsonObject,\n  canonicalizeJsonValue,\n  canonicalJsonBytes,\n  canonicalJsonText\n} from \"./data-boundary/canonical-data.ts\";\nexport type {\n  CanonicalJsonObject,\n  CanonicalJsonPrimitive,\n  CanonicalJsonValue\n} from \"./data-boundary/canonical-data.ts\";\nexport { snapshotClosedArray, snapshotExactClosedRecord } from \"./data-boundary/closed-values.ts\";\nexport { duplicateDetection } from \"./package-checks/duplicate-detection/default-check.ts\";\nexport type { PackageCheckAuthoringOptions } from \"./package-checks/check-authoring.ts\";\nexport { parseDuplicateDetectionData } from \"./package-checks/duplicate-detection/final-data.ts\";\nexport type { DuplicateDetectionFinalData } from \"./package-checks/duplicate-detection/final-data.ts\";\nexport type {\n  DuplicateDetectionFindingIdentity,\n  DuplicateDetectionFindingLocation,\n  DuplicateDetectionFindingWaiver,\n  DuplicateDetectionOptions,\n  ResolvedDuplicateDetectionOptions\n} from \"./package-checks/duplicate-detection/options.ts\";\nexport type { DuplicateDetectionUnavailableReasonCode } from \"./package-checks/duplicate-detection/execution.ts\";\nexport type { DuplicateDetectionRecordData } from \"./package-checks/duplicate-detection/records.ts\";\nexport { fileMetrics } from \"./package-checks/file-metrics/constructor.ts\";\nexport { parseFileMetricsData } from \"./package-checks/file-metrics/final-data.ts\";\nexport type { FileMetricsFinalData } from \"./package-checks/file-metrics/final-data.ts\";\nexport type {\n  FileMetricsFindingIdentity,\n  FileMetricsFindingWaiver,\n  FileMetricsOptions,\n  ResolvedFileMetricsOptions\n} from \"./package-checks/file-metrics/options.ts\";\nexport type { FileMetricsUnavailableReasonCode } from \"./package-checks/file-metrics/execution.ts\";\nexport type { FileMetricsRecordData } from \"./package-checks/file-metrics/records.ts\";\nexport { functionMetrics } from \"./package-checks/function-metrics/constructor.ts\";\nexport { parseFunctionMetricsData } from \"./package-checks/function-metrics/final-data.ts\";\nexport type { FunctionMetricsFinalData } from \"./package-checks/function-metrics/final-data.ts\";\nexport type {\n  FunctionMetricsFindingIdentity,\n  FunctionMetricsFindingMetric,\n  FunctionMetricsFindingWaiver,\n  FunctionMetricsOptions,\n  ResolvedFunctionMetricsOptions\n} from \"./package-checks/function-metrics/options.ts\";\nexport type { FunctionMetricsUnavailableReasonCode } from \"./package-checks/function-metrics/execution.ts\";\nexport type { FunctionMetricsRecordData } from \"./package-checks/function-metrics/records.ts\";\nexport { secretDetection } from \"./package-checks/secret-detection/default-check.ts\";\nexport { parseSecretDetectionData } from \"./package-checks/secret-detection/final-data.ts\";\nexport type { SecretDetectionFinalData } from \"./package-checks/secret-detection/final-data.ts\";\nexport type {\n  ResolvedSecretDetectionOptions,\n  SecretDetectionFindingIdentity,\n  SecretDetectionFindingWaiver,\n  SecretDetectionOptions\n} from \"./package-checks/secret-detection/options.ts\";\nexport type { SecretDetectionUnavailableReasonCode } from \"./package-checks/secret-detection/execution.ts\";\nexport type { SecretDetectionRecordData } from \"./package-checks/secret-detection/records.ts\";\nexport { jsonSchemaValidation } from \"./package-checks/json-schema-validation/default-check.ts\";\nexport { parseJsonSchemaValidationData } from \"./package-checks/json-schema-validation/final-data.ts\";\nexport type { JsonSchemaValidationFinalData } from \"./package-checks/json-schema-validation/final-data.ts\";\nexport type {\n  JsonSchemaIdentity,\n  JsonSchemaIdentityMode,\n  JsonSchemaInstanceBinding,\n  JsonSchemaReferenceResolution,\n  JsonSchemaReferenceSource,\n  JsonSchemaValidationOptions,\n  RegisteredJsonSchema,\n  ResolvedJsonSchemaValidationOptions\n} from \"./package-checks/json-schema-validation/options.ts\";\nexport type {\n  JsonSchemaDocumentReason,\n  JsonSchemaValidationRecordData,\n  JsonSchemaValidationRecordReason,\n  JsonSchemaValidationUnavailableCode\n} from \"./package-checks/json-schema-validation/json-schema-validation.ts\";\nexport { jsonValidation } from \"./package-checks/json-validation/default-check.ts\";\nexport { parseJsonValidationData } from \"./package-checks/json-validation/final-data.ts\";\nexport type { JsonValidationFinalData } from \"./package-checks/json-validation/final-data.ts\";\nexport type {\n  JsonValidationOptions,\n  ResolvedJsonValidationOptions\n} from \"./package-checks/json-validation/options.ts\";\nexport type {\n  JsonValidationRecordData,\n  JsonValidationRecordReason,\n  JsonValidationUnavailableCode\n} from \"./package-checks/json-validation/json-validation.ts\";\nexport { commandCheck } from \"./package-checks/command-check/command-check.ts\";\nexport type {\n  AfterCommand,\n  AfterCommandContext,\n  AfterCommandExecution,\n  CommandCheck,\n  CommandCheckEnvironment,\n  CommandCheckWithAfterCommand,\n  CommandEnvironmentContext,\n  CommandEnvironmentResolver,\n  CompletedCommand,\n  CommandCheckFinalData,\n  CommandCheckInput,\n  CommandCheckOutput,\n  CommandCheckUnavailableReasonCode,\n  TypedCommandCheck\n} from \"./package-checks/command-check/command-check.ts\";\nexport { maintenanceReminders } from \"./package-checks/maintenance-reminders/maintenance-reminders.ts\";\nexport type {\n  MaintenanceReminder,\n  MaintenanceReminderOptions,\n  MaintenanceRemindersInput,\n  MaintenanceRemindersUnavailableCode\n} from \"./package-checks/maintenance-reminders/maintenance-reminders.ts\";\nexport { parseMaintenanceRemindersData } from \"./package-checks/maintenance-reminders/final-data.ts\";\nexport type {\n  MaintenanceReminderAssessment,\n  MaintenanceReminderUnavailableReason,\n  MaintenanceRemindersFinalData\n} from \"./package-checks/maintenance-reminders/final-data.ts\";\nexport { markdownLint } from \"./package-checks/markdown-lint/default-check.ts\";\nexport { parseMarkdownLintData } from \"./package-checks/markdown-lint/final-data.ts\";\nexport type { MarkdownLintFinalData } from \"./package-checks/markdown-lint/final-data.ts\";\nexport type {\n  MarkdownLintFindingIdentity,\n  MarkdownLintFindingWaiver,\n  MarkdownLintOptions,\n  MarkdownLintRuleName,\n  ResolvedMarkdownLintOptions\n} from \"./package-checks/markdown-lint/options.ts\";\nexport type {\n  MarkdownLintFindingWaiverAuditRecordData,\n  MarkdownLintRecordData\n} from \"./package-checks/markdown-lint/records.ts\";\nexport type { MarkdownLintUnavailableReason } from \"./package-checks/markdown-lint/execution.ts\";\nexport { markdownLinkValidation } from \"./package-checks/markdown-link-validation/default-check.ts\";\nexport { parseMarkdownLinkValidationData } from \"./package-checks/markdown-link-validation/final-data.ts\";\nexport type { MarkdownLinkValidationFinalData } from \"./package-checks/markdown-link-validation/final-data.ts\";\nexport type {\n  MarkdownLinkValidationOptions,\n  ResolvedMarkdownLinkValidationOptions\n} from \"./package-checks/markdown-link-validation/options.ts\";\nexport type { MarkdownLinkValidationUnavailableReason } from \"./package-checks/markdown-link-validation/execution.ts\";\nexport type { MarkdownLinkValidationRecordData } from \"./package-checks/markdown-link-validation/records.ts\";\nexport type { MarkdownLinkFindingReason } from \"./package-checks/markdown-link-validation/local-resolver.ts\";\nexport type { FindingPolicy } from \"./package-checks/code-quality-findings/policy.ts\";\nexport { reconcileFindingWaivers } from \"./package-tools/finding-waivers/reconciliation.ts\";\nexport { presentCheckFindings } from \"./package-tools/finding-presentation/finding-presentation.ts\";\nexport type {\n  FindingWaiver,\n  FindingWaiverAudit,\n  FindingWaiverReconciliation,\n  MaterializedFindingWaiver,\n  ReconciledFinding,\n  ReconcileFindingWaiversOptions\n} from \"./package-tools/finding-waivers/reconciliation.ts\";\nexport { defaultProjectFileSelection } from \"./package-checks/project-files/configuration.ts\";\nexport { collectProjectFiles } from \"./package-checks/project-files/public-collection.ts\";\nexport type { CollectProjectFilesOptions } from \"./package-checks/project-files/public-collection.ts\";\nexport type {\n  ProjectFileSelection,\n  ProjectFileSelectionOptions,\n  ProjectFileSource\n} from \"./package-checks/project-files/configuration.ts\";\nexport { defineCheck, inherit } from \"./check/check.ts\";\nexport { all, any, changeFlag, exactlyOne, none, not, notAll } from \"./check/flag-enablement.ts\";\nexport type {\n  Check,\n  CheckDependencies,\n  CheckExecution,\n  CheckExecutionContext,\n  CheckFlagCondition,\n  CheckFlagEnablement,\n  CheckPreparation,\n  CheckPreparationResult,\n  CheckProjectContext,\n  CheckResourceClaims,\n  CheckOutcome,\n  ProjectChanges,\n  CheckResult,\n  CheckUnavailableReason,\n  InheritableCheckCollection\n} from \"./check/check.ts\";\nexport { defineAdmissionPolicy } from \"./package-tools/admission-policy/define-admission-policy.ts\";\nexport { defineConfig } from \"./project-definition/project-definition.ts\";\nexport { createLearnedCriticalPathStrategy } from \"./package-tools/learned-critical-path/strategy.ts\";\nexport type {\n  LearnedCriticalPathObservation,\n  LearnedCriticalPathStrategyOptions\n} from \"./package-tools/learned-critical-path/strategy.ts\";\nexport { createAdmissionGraph } from \"./project-run/task-scheduler/admission-core/core.ts\";\nexport type {\n  AdmissionPolicy,\n  AdmissionPolicyContext,\n  AdmissionPolicyMeasurement,\n  AdmissionProposal,\n  AdmissionCatalog,\n  AdmissionGraph,\n  AdmissionGraphInput,\n  AdmissionInspection,\n  AdmissionNonSelectableTask,\n  AdmissionRejectionReason,\n  AdmissionScopeLifecycle,\n  AdmissionSelectionRejectionReason,\n  AdmissionSelectionValidation,\n  AdmissionSelectionValidationRejectionReason,\n  AdmissionSettlementOutcome,\n  AdmissionSettledTask,\n  AdmissionState,\n  AdmissionTransitionResult,\n  CustomAdmissionPreparationContext,\n  CustomAdmissionStrategy,\n  PreparedCustomAdmissionStrategy,\n  ProgressPreviewFormatter,\n  ProjectOutputs,\n  ProjectDefinition,\n  SchedulerDecisionMeasurementCumulative,\n  SchedulerGraphSnapshot,\n  SchedulerMeasurementContext,\n  SchedulerTerminalEffect,\n  SchedulerMeasurementIntervalContribution,\n  SchedulerMeasurementActionObservationInterval,\n  SchedulerMeasurementActionObservation,\n  SchedulerMeasurementEffect,\n  SchedulerRawMeasurement,\n  SchedulerPolicy\n} from \"./project-definition/project-definition.ts\";\nexport type {\n  ProjectChangeFlagRegion,\n  ProjectChangeSource,\n  ProjectChangesConfiguration\n} from \"./project-definition/project-changes.ts\";\nexport type { CoreCheck } from \"./check-settlement/facts.ts\";\nexport type {\n  CheckAggregate,\n  CheckAggregation,\n  RunControls\n} from \"./project-run/controls/contract.ts\";\nexport { run } from \"./project-run/run.ts\";\nexport type { RunOutputStatus, RunOutputStatuses } from \"./project-run/outputs/status.ts\";\nexport type { RunResult } from \"./project-run/result.ts\";\n"]}

package/dist/esm/machine-output/v4/atomic-publication.mjs

@@ -82,7 +82,10 @@ function removePaths(paths) {
             firstFailure ??= error;
         }
     }
-    if (firstFailure !== undefined)
+    if (firstFailure === undefined)
+        return;
+    if (firstFailure instanceof Error)
         throw firstFailure;
+    throw new Error("publication cleanup failed", { cause: firstFailure });
 }
 //# sourceMappingURL=atomic-publication.mjs.map

package/dist/esm/machine-output/v4/atomic-publication.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"atomic-publication.mjs","sourceRoot":"","sources":["../../../../src/machine-output/v4/atomic-publication.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst CANONICAL_NAMES = [\"records.ndjson\", \"run.json\"] as const;\nconst OWNED_TEMP_PREFIX = \".vibe-check-publication-\";\n\ninterface PublicationCandidatePath {\n  readonly canonical: string;\n  readonly contents: string;\n  readonly temp: string;\n}\n\ninterface PublicationCandidates {\n  readonly recordsNdjson: string;\n  readonly runJson: string;\n}\n\n/** Writes an already validated two-file candidate set through owned temporary paths. */\nexport function publishPublicationCandidatesV4(\n  artifactDir: string,\n  candidates: PublicationCandidates\n): void {\n  fs.mkdirSync(artifactDir, { recursive: true });\n  const files = publicationCandidatePaths(artifactDir, randomUUID(), candidates);\n  let hasReplacedCanonicalPath = false;\n  try {\n    cleanupOwnedTemps(artifactDir);\n    for (const file of files) {\n      fs.writeFileSync(file.temp, file.contents, { encoding: \"utf8\", flag: \"wx\" });\n    }\n    for (const file of files) {\n      fs.renameSync(file.temp, file.canonical);\n      hasReplacedCanonicalPath = true;\n    }\n  } catch (error: unknown) {\n    if (hasReplacedCanonicalPath) cleanupPublicationV4BestEffort(artifactDir);\n    else cleanupOwnedTempsBestEffort(artifactDir);\n    throw error;\n  }\n}\n\nexport function cleanupPublicationV4(artifactDir: string): void {\n  removePaths([...artifactPaths(artifactDir, CANONICAL_NAMES), ...ownedTempPaths(artifactDir)]);\n}\n\nexport function cleanupPublicationV4BestEffort(artifactDir: string): void {\n  try {\n    cleanupPublicationV4(artifactDir);\n  } catch {\n    // Failure cleanup cannot conceal the original publication failure.\n  }\n}\n\nfunction publicationCandidatePaths(\n  artifactDir: string,\n  token: string,\n  candidates: PublicationCandidates\n): readonly PublicationCandidatePath[] {\n  return [\n    {\n      canonical: join(artifactDir, \"run.json\"),\n      contents: candidates.runJson,\n      temp: join(artifactDir, `.vibe-check-publication-${token}-run.json.tmp`)\n    },\n    {\n      canonical: join(artifactDir, \"records.ndjson\"),\n      contents: candidates.recordsNdjson,\n      temp: join(artifactDir, `.vibe-check-publication-${token}-records.ndjson.tmp`)\n    }\n  ];\n}\n\nfunction cleanupOwnedTemps(artifactDir: string): void {\n  removePaths(ownedTempPaths(artifactDir));\n}\n\nfunction cleanupOwnedTempsBestEffort(artifactDir: string): void {\n  try {\n    cleanupOwnedTemps(artifactDir);\n  } catch {\n    // Failure cleanup cannot conceal the original publication failure.\n  }\n}\n\nfunction artifactPaths(artifactDir: string, names: readonly string[]): readonly string[] {\n  return names.map((name) => join(artifactDir, name));\n}\n\nfunction ownedTempPaths(artifactDir: string): readonly string[] {\n  return fs\n    .readdirSync(artifactDir, { withFileTypes: true })\n    .filter((entry) => entry.name.startsWith(OWNED_TEMP_PREFIX))\n    .map((entry) => join(artifactDir, entry.name))\n    .sort();\n}\n\nfunction removePaths(paths: readonly string[]): void {\n  let firstFailure: unknown;\n  for (const path of paths) {\n    try {\n      fs.rmSync(path, { force: true, recursive: true });\n    } catch (error: unknown) {\n      firstFailure ??= error;\n    }\n  }\n  if (firstFailure !== undefined) throw firstFailure;\n}\n"]}
+{"version":3,"file":"atomic-publication.mjs","sourceRoot":"","sources":["../../../../src/machine-output/v4/atomic-publication.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport fs from \"node:fs\";\nimport { join } from \"node:path\";\n\nconst CANONICAL_NAMES = [\"records.ndjson\", \"run.json\"] as const;\nconst OWNED_TEMP_PREFIX = \".vibe-check-publication-\";\n\ninterface PublicationCandidatePath {\n  readonly canonical: string;\n  readonly contents: string;\n  readonly temp: string;\n}\n\ninterface PublicationCandidates {\n  readonly recordsNdjson: string;\n  readonly runJson: string;\n}\n\n/** Writes an already validated two-file candidate set through owned temporary paths. */\nexport function publishPublicationCandidatesV4(\n  artifactDir: string,\n  candidates: PublicationCandidates\n): void {\n  fs.mkdirSync(artifactDir, { recursive: true });\n  const files = publicationCandidatePaths(artifactDir, randomUUID(), candidates);\n  let hasReplacedCanonicalPath = false;\n  try {\n    cleanupOwnedTemps(artifactDir);\n    for (const file of files) {\n      fs.writeFileSync(file.temp, file.contents, { encoding: \"utf8\", flag: \"wx\" });\n    }\n    for (const file of files) {\n      fs.renameSync(file.temp, file.canonical);\n      hasReplacedCanonicalPath = true;\n    }\n  } catch (error: unknown) {\n    if (hasReplacedCanonicalPath) cleanupPublicationV4BestEffort(artifactDir);\n    else cleanupOwnedTempsBestEffort(artifactDir);\n    throw error;\n  }\n}\n\nexport function cleanupPublicationV4(artifactDir: string): void {\n  removePaths([...artifactPaths(artifactDir, CANONICAL_NAMES), ...ownedTempPaths(artifactDir)]);\n}\n\nexport function cleanupPublicationV4BestEffort(artifactDir: string): void {\n  try {\n    cleanupPublicationV4(artifactDir);\n  } catch {\n    // Failure cleanup cannot conceal the original publication failure.\n  }\n}\n\nfunction publicationCandidatePaths(\n  artifactDir: string,\n  token: string,\n  candidates: PublicationCandidates\n): readonly PublicationCandidatePath[] {\n  return [\n    {\n      canonical: join(artifactDir, \"run.json\"),\n      contents: candidates.runJson,\n      temp: join(artifactDir, `.vibe-check-publication-${token}-run.json.tmp`)\n    },\n    {\n      canonical: join(artifactDir, \"records.ndjson\"),\n      contents: candidates.recordsNdjson,\n      temp: join(artifactDir, `.vibe-check-publication-${token}-records.ndjson.tmp`)\n    }\n  ];\n}\n\nfunction cleanupOwnedTemps(artifactDir: string): void {\n  removePaths(ownedTempPaths(artifactDir));\n}\n\nfunction cleanupOwnedTempsBestEffort(artifactDir: string): void {\n  try {\n    cleanupOwnedTemps(artifactDir);\n  } catch {\n    // Failure cleanup cannot conceal the original publication failure.\n  }\n}\n\nfunction artifactPaths(artifactDir: string, names: readonly string[]): readonly string[] {\n  return names.map((name) => join(artifactDir, name));\n}\n\nfunction ownedTempPaths(artifactDir: string): readonly string[] {\n  return fs\n    .readdirSync(artifactDir, { withFileTypes: true })\n    .filter((entry) => entry.name.startsWith(OWNED_TEMP_PREFIX))\n    .map((entry) => join(artifactDir, entry.name))\n    .sort();\n}\n\nfunction removePaths(paths: readonly string[]): void {\n  let firstFailure: unknown;\n  for (const path of paths) {\n    try {\n      fs.rmSync(path, { force: true, recursive: true });\n    } catch (error: unknown) {\n      firstFailure ??= error;\n    }\n  }\n  if (firstFailure === undefined) return;\n  if (firstFailure instanceof Error) throw firstFailure;\n  throw new Error(\"publication cleanup failed\", { cause: firstFailure });\n}\n"]}

package/dist/esm/package-checks/check-authoring.mjs

@@ -0,0 +1,69 @@
+import { snapshotClosedArray, snapshotClosedPolicyRecord } from "../data-boundary/closed-values.mjs";
+import { parseFlagEnablementControl } from "../project-definition/check-tree/check-fields-authoring.mjs";
+import { parseCheckScheduling } from "../project-definition/check-tree/scheduling-authoring.mjs";
+const PACKAGE_CHECK_AUTHORING_KEYS = [
+    "admissionPriority",
+    "checkId",
+    "checks",
+    "dependsOn",
+    "displayName",
+    "enabledByFlags",
+    "maxParallel",
+    "mutex",
+    "observes",
+    "omitQuietPassedRow",
+    "resourceClaims"
+];
+/** 对一个 closed 构造输入执行安全 shape 校验，并分流领域 policy 与普通 Check 声明字段。 */
+export function resolvePackageCheckAuthoringInput(input, domainKeys, defaults) {
+    const snapshot = snapshotClosedPolicyRecord(input, {
+        optional: [...domainKeys, ...PACKAGE_CHECK_AUTHORING_KEYS]
+    });
+    if (snapshot === undefined)
+        return undefined;
+    const checkId = snapshot.checkId ?? defaults.checkId;
+    const displayName = snapshot.displayName ?? defaults.displayName;
+    if (!isNonEmptyString(checkId) || !isNonEmptyString(displayName))
+        return undefined;
+    if ((snapshot.omitQuietPassedRow !== undefined &&
+        typeof snapshot.omitQuietPassedRow !== "boolean") ||
+        !hasSafeProjectFieldShapes(snapshot)) {
+        return undefined;
+    }
+    const omitQuietPassedRow = snapshot.omitQuietPassedRow === undefined
+        ? defaults.omitQuietPassedRow === true
+        : snapshot.omitQuietPassedRow === true;
+    const domainOptions = Object.freeze(Object.fromEntries(domainKeys.flatMap((key) => (Object.hasOwn(snapshot, key) ? [[key, snapshot[key]]] : []))));
+    const definition = Object.freeze({
+        ...(snapshot.admissionPriority === undefined
+            ? {}
+            : { admissionPriority: snapshot.admissionPriority }),
+        ...(snapshot.checks === undefined ? {} : { checks: snapshot.checks }),
+        ...(snapshot.dependsOn === undefined ? {} : { dependsOn: snapshot.dependsOn }),
+        ...(snapshot.enabledByFlags === undefined ? {} : { enabledByFlags: snapshot.enabledByFlags }),
+        ...(snapshot.maxParallel === undefined ? {} : { maxParallel: snapshot.maxParallel }),
+        ...(snapshot.mutex === undefined ? {} : { mutex: snapshot.mutex }),
+        ...(snapshot.observes === undefined ? {} : { observes: snapshot.observes }),
+        ...(omitQuietPassedRow ? { omitQuietPassedRow: true } : {}),
+        ...(snapshot.resourceClaims === undefined ? {} : { resourceClaims: snapshot.resourceClaims }),
+        // Runtime defaults are strings; constructor signatures bind this field to the input literal type.
+        // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- The runtime default is fixed by the constructor, while the public signature retains an input literal ID.
+        checkId: checkId,
+        displayName
+    });
+    return Object.freeze({ definition, domainOptions });
+}
+function hasSafeProjectFieldShapes(input) {
+    const scheduling = parseCheckScheduling(input);
+    if (scheduling === undefined)
+        return false;
+    if (input.enabledByFlags !== undefined &&
+        parseFlagEnablementControl(input.enabledByFlags) === undefined) {
+        return false;
+    }
+    return input.checks === undefined || snapshotClosedArray(input.checks) !== undefined;
+}
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+//# sourceMappingURL=check-authoring.mjs.map

package/dist/esm/package-checks/check-authoring.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"check-authoring.mjs","sourceRoot":"","sources":["../../../src/package-checks/check-authoring.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  Check,\n  CheckFlagEnablement,\n  CheckResourceClaims,\n  InheritableCheckCollection\n} from \"../check/check.ts\";\nimport { snapshotClosedArray, snapshotClosedPolicyRecord } from \"../data-boundary/closed-values.ts\";\nimport { parseFlagEnablementControl } from \"../project-definition/check-tree/check-fields-authoring.ts\";\nimport { parseCheckScheduling } from \"../project-definition/check-tree/scheduling-authoring.ts\";\n\n/** 固定身份随包 Check 构造器与领域 policy 并列接收的项目声明字段；Project Definition 保留语义校验所有权。 */\nexport interface PackageCheckAuthoringOptions<Id extends string = string> {\n  /** Overrides the constructor's package default identity. */\n  readonly checkId?: Id;\n  /** Overrides the constructor's package default presentation name. */\n  readonly displayName?: string;\n  readonly enabledByFlags?: CheckFlagEnablement;\n  readonly checks?: readonly Check[];\n  readonly dependsOn?: InheritableCheckCollection<string>;\n  readonly observes?: InheritableCheckCollection<string>;\n  readonly maxParallel?: number;\n  readonly admissionPriority?: number;\n  readonly mutex?: InheritableCheckCollection<string>;\n  readonly resourceClaims?: CheckResourceClaims;\n  /** `false` explicitly restores the package default of rendering quiet passed rows. */\n  readonly omitQuietPassedRow?: boolean;\n}\n\n/** 自定义随包 Check identity 时必须声明与返回类型一致的 runtime `checkId`。 */\nexport type PackageCheckIdentityInput<Id extends string> = Readonly<{ readonly checkId: Id }>;\n\nconst PACKAGE_CHECK_AUTHORING_KEYS = [\n  \"admissionPriority\",\n  \"checkId\",\n  \"checks\",\n  \"dependsOn\",\n  \"displayName\",\n  \"enabledByFlags\",\n  \"maxParallel\",\n  \"mutex\",\n  \"observes\",\n  \"omitQuietPassedRow\",\n  \"resourceClaims\"\n] as const;\n\ntype PackageCheckDefinition<Id extends string> = Readonly<{\n  readonly checkId: Id;\n  readonly displayName: string;\n  readonly enabledByFlags?: CheckFlagEnablement;\n  readonly checks?: readonly Check[];\n  readonly dependsOn?: InheritableCheckCollection<string>;\n  readonly observes?: InheritableCheckCollection<string>;\n  readonly maxParallel?: number;\n  readonly admissionPriority?: number;\n  readonly mutex?: InheritableCheckCollection<string>;\n  readonly resourceClaims?: CheckResourceClaims;\n  readonly omitQuietPassedRow?: true;\n}>;\n\n/** 对一个 closed 构造输入执行安全 shape 校验，并分流领域 policy 与普通 Check 声明字段。 */\nexport function resolvePackageCheckAuthoringInput<const Id extends string>(\n  input: PackageCheckAuthoringOptions<Id> & object,\n  domainKeys: readonly string[],\n  defaults: Readonly<{\n    readonly checkId: string;\n    readonly displayName: string;\n    readonly omitQuietPassedRow?: true;\n  }>\n):\n  | Readonly<{\n      readonly definition: PackageCheckDefinition<Id>;\n      readonly domainOptions: Readonly<Record<string, unknown>>;\n    }>\n  | undefined {\n  const snapshot = snapshotClosedPolicyRecord(input, {\n    optional: [...domainKeys, ...PACKAGE_CHECK_AUTHORING_KEYS]\n  });\n  if (snapshot === undefined) return undefined;\n\n  const checkId = snapshot.checkId ?? defaults.checkId;\n  const displayName = snapshot.displayName ?? defaults.displayName;\n  if (!isNonEmptyString(checkId) || !isNonEmptyString(displayName)) return undefined;\n  if (\n    (snapshot.omitQuietPassedRow !== undefined &&\n      typeof snapshot.omitQuietPassedRow !== \"boolean\") ||\n    !hasSafeProjectFieldShapes(snapshot)\n  ) {\n    return undefined;\n  }\n  const omitQuietPassedRow =\n    snapshot.omitQuietPassedRow === undefined\n      ? defaults.omitQuietPassedRow === true\n      : snapshot.omitQuietPassedRow === true;\n\n  const domainOptions = Object.freeze(\n    Object.fromEntries(\n      domainKeys.flatMap((key) => (Object.hasOwn(snapshot, key) ? [[key, snapshot[key]]] : []))\n    )\n  );\n  const definition = Object.freeze({\n    ...(snapshot.admissionPriority === undefined\n      ? {}\n      : { admissionPriority: snapshot.admissionPriority }),\n    ...(snapshot.checks === undefined ? {} : { checks: snapshot.checks }),\n    ...(snapshot.dependsOn === undefined ? {} : { dependsOn: snapshot.dependsOn }),\n    ...(snapshot.enabledByFlags === undefined ? {} : { enabledByFlags: snapshot.enabledByFlags }),\n    ...(snapshot.maxParallel === undefined ? {} : { maxParallel: snapshot.maxParallel }),\n    ...(snapshot.mutex === undefined ? {} : { mutex: snapshot.mutex }),\n    ...(snapshot.observes === undefined ? {} : { observes: snapshot.observes }),\n    ...(omitQuietPassedRow ? { omitQuietPassedRow: true as const } : {}),\n    ...(snapshot.resourceClaims === undefined ? {} : { resourceClaims: snapshot.resourceClaims }),\n    // Runtime defaults are strings; constructor signatures bind this field to the input literal type.\n    // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- The runtime default is fixed by the constructor, while the public signature retains an input literal ID.\n    checkId: checkId as Id,\n    displayName\n  }) satisfies PackageCheckDefinition<Id>;\n  return Object.freeze({ definition, domainOptions });\n}\n\nfunction hasSafeProjectFieldShapes(\n  input: Readonly<Record<string, unknown>>\n): input is Readonly<Record<string, unknown>> & PackageCheckAuthoringOptions {\n  const scheduling = parseCheckScheduling(input);\n  if (scheduling === undefined) return false;\n  if (\n    input.enabledByFlags !== undefined &&\n    parseFlagEnablementControl(input.enabledByFlags) === undefined\n  ) {\n    return false;\n  }\n  return input.checks === undefined || snapshotClosedArray(input.checks) !== undefined;\n}\n\nfunction isNonEmptyString(value: unknown): value is string {\n  return typeof value === \"string\" && value.length > 0;\n}\n"]}

package/dist/esm/package-checks/code-quality-findings/finding-waiver-authoring.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"finding-waiver-authoring.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/finding-waiver-authoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGvE;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,eAAyD;IAEzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7F,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QACnF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC7C,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,OAAO,SAAS,CAAC;QACtD,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,eAAyD;IAEzD,OAAO,KAAK,KAAK,SAAS,IAAI,6BAA6B,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,SAAS,CAAC;AACpG,CAAC","sourcesContent":["import { canonicalJsonText } from \"../../data-boundary/canonical-data.ts\";\nimport {\n  snapshotClosedArray,\n  snapshotClosedPolicyRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { isNonEmptyString } from \"../../data-boundary/value-shapes.ts\";\nimport type { FindingWaiver } from \"../../finding-waivers/reconciliation.ts\";\n\n/**\n * Snapshots the shared closed waiver envelope while leaving identity grammar to the producing Check.\n */\nexport function resolveFindingWaiverAuthoring<Identity>(\n  value: unknown,\n  resolveIdentity: (value: unknown) => Identity | undefined\n): readonly FindingWaiver<Identity>[] | undefined {\n  if (value === undefined) return Object.freeze([]);\n  const candidates = snapshotClosedArray(value);\n  if (candidates === undefined) return undefined;\n\n  const waivers: FindingWaiver<Identity>[] = [];\n  const seenIdentities = new Set<string>();\n  for (const candidate of candidates) {\n    const authored = snapshotClosedPolicyRecord(candidate, { required: [\"identity\", \"reason\"] });\n    if (authored === undefined || !isNonEmptyString(authored.reason)) return undefined;\n    const identity = resolveIdentity(authored.identity);\n    if (identity === undefined) return undefined;\n    let identityKey: string;\n    try {\n      identityKey = canonicalJsonText(identity);\n    } catch {\n      return undefined;\n    }\n    if (seenIdentities.has(identityKey)) return undefined;\n    seenIdentities.add(identityKey);\n    waivers.push(Object.freeze({ identity, reason: authored.reason }));\n  }\n  return Object.freeze(waivers);\n}\n\n/** Validates the complete resolved waiver list through the same authoring boundary. */\nexport function validResolvedFindingWaivers<Identity>(\n  value: unknown,\n  resolveIdentity: (value: unknown) => Identity | undefined\n): value is readonly FindingWaiver<Identity>[] {\n  return value !== undefined && resolveFindingWaiverAuthoring(value, resolveIdentity) !== undefined;\n}\n"]}
+{"version":3,"file":"finding-waiver-authoring.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/finding-waiver-authoring.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,uCAAuC,CAAC;AAC1E,OAAO,EACL,mBAAmB,EACnB,0BAA0B,EAC3B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAGvE;;GAEG;AACH,MAAM,UAAU,6BAA6B,CAC3C,KAAc,EACd,eAAyD;IAEzD,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;IAC9C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE/C,MAAM,OAAO,GAA8B,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IACzC,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,0BAA0B,CAAC,SAAS,EAAE,EAAE,QAAQ,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC7F,IAAI,QAAQ,KAAK,SAAS,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QACnF,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,QAAQ,KAAK,SAAS;YAAE,OAAO,SAAS,CAAC;QAC7C,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;QAC5C,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,IAAI,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC;YAAE,OAAO,SAAS,CAAC;QACtD,cAAc,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAChC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACrE,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAChC,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,2BAA2B,CACzC,KAAc,EACd,eAAyD;IAEzD,OAAO,KAAK,KAAK,SAAS,IAAI,6BAA6B,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,SAAS,CAAC;AACpG,CAAC","sourcesContent":["import { canonicalJsonText } from \"../../data-boundary/canonical-data.ts\";\nimport {\n  snapshotClosedArray,\n  snapshotClosedPolicyRecord\n} from \"../../data-boundary/closed-values.ts\";\nimport { isNonEmptyString } from \"../../data-boundary/value-shapes.ts\";\nimport type { FindingWaiver } from \"../../package-tools/finding-waivers/reconciliation.ts\";\n\n/**\n * Snapshots the shared closed waiver envelope while leaving identity grammar to the producing Check.\n */\nexport function resolveFindingWaiverAuthoring<Identity>(\n  value: unknown,\n  resolveIdentity: (value: unknown) => Identity | undefined\n): readonly FindingWaiver<Identity>[] | undefined {\n  if (value === undefined) return Object.freeze([]);\n  const candidates = snapshotClosedArray(value);\n  if (candidates === undefined) return undefined;\n\n  const waivers: FindingWaiver<Identity>[] = [];\n  const seenIdentities = new Set<string>();\n  for (const candidate of candidates) {\n    const authored = snapshotClosedPolicyRecord(candidate, { required: [\"identity\", \"reason\"] });\n    if (authored === undefined || !isNonEmptyString(authored.reason)) return undefined;\n    const identity = resolveIdentity(authored.identity);\n    if (identity === undefined) return undefined;\n    let identityKey: string;\n    try {\n      identityKey = canonicalJsonText(identity);\n    } catch {\n      return undefined;\n    }\n    if (seenIdentities.has(identityKey)) return undefined;\n    seenIdentities.add(identityKey);\n    waivers.push(Object.freeze({ identity, reason: authored.reason }));\n  }\n  return Object.freeze(waivers);\n}\n\n/** Validates the complete resolved waiver list through the same authoring boundary. */\nexport function validResolvedFindingWaivers<Identity>(\n  value: unknown,\n  resolveIdentity: (value: unknown) => Identity | undefined\n): value is readonly FindingWaiver<Identity>[] {\n  return value !== undefined && resolveFindingWaiverAuthoring(value, resolveIdentity) !== undefined;\n}\n"]}

package/dist/esm/package-checks/code-quality-findings/finding-waiver-evidence.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"finding-waiver-evidence.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/finding-waiver-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAa3E,MAAM,qCAAqC,GAAG,wBAAwB,CAAC;AAgBvE,mFAAmF;AACnF,MAAM,UAAU,iCAAiC,CAC/C,QAAkB,EAClB,KAA+B;IAE/B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ;QACR,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mCAAmC,CACjD,QAAkB,EAClB,KAA+B;IAE/B,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,iCAAiC,CAAC,QAAQ,EAAE,KAAK,CAAC;QACxD,EAAE,EAAE,GAAG,qCAAqC,UAAU,MAAM,EAAE;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,yCAAyC,CAEvD,OAA6B,EAAE,cAAoD;IACnF,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,GACR,OAAO,CAAC,WAAW,KAAK,QAAQ;YAC9B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;gBACZ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI;gBACvB,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;aACzD,CAAC;YACJ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CACvC,OAA6B,EAC7B,cAAoD,EACpD,WAEgE;IAEhE,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,YAAY,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,SAAS;QACzC,MAAM,MAAM,GAAG,WAAW,CACxB,MAAM,CAAC,MAAM,CAAC;YACZ,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CACH,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport type { CheckExecutionContext } from \"../../check/check.ts\";\nimport { canonicalJsonBytes } from \"../../data-boundary/canonical-data.ts\";\nimport type {\n  FindingWaiverAudit,\n  FindingWaiverReconciliation\n} from \"../../finding-waivers/reconciliation.ts\";\n\ninterface CodeQualityFindingCandidate {\n  readonly data: Readonly<{ readonly blocking: boolean }>;\n  readonly id: string;\n}\n\ntype FindingRecordContext = Pick<CheckExecutionContext<object>, \"records\">;\n\nconst FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX = \"/finding-waiver-audit/\";\n\nexport type FindingWaiverRecordAudit = Readonly<\n  Omit<FindingWaiverAudit, \"status\"> & {\n    readonly status: \"overmatched\" | \"unused\";\n  }\n>;\n\nexport type FindingWaiverAuditRecordData<Identity> = Readonly<{\n  readonly identity: Identity;\n  readonly kind: \"finding-waiver-audit\";\n  readonly matchCount: number;\n  readonly reason: string;\n  readonly status: \"overmatched\" | \"unused\";\n}>;\n\n/** Builds the common immutable data shared by Check-owned waiver audit Records. */\nexport function buildFindingWaiverAuditRecordData<Identity>(\n  identity: Identity,\n  audit: FindingWaiverRecordAudit\n): FindingWaiverAuditRecordData<Identity> {\n  return Object.freeze({\n    identity,\n    kind: \"finding-waiver-audit\",\n    matchCount: audit.matchCount,\n    reason: audit.waiver.reason,\n    status: audit.status\n  });\n}\n\n/** Builds the shared hash-addressed audit Record used by structured identities. */\nexport function buildHashedFindingWaiverAuditRecord<Identity>(\n  identity: Identity,\n  audit: FindingWaiverRecordAudit\n): Readonly<{ readonly data: FindingWaiverAuditRecordData<Identity>; readonly id: string }> {\n  const digest = createHash(\"sha256\").update(canonicalJsonBytes(identity)).digest(\"hex\");\n  return Object.freeze({\n    data: buildFindingWaiverAuditRecordData(identity, audit),\n    id: `${FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX}sha256:${digest}`\n  });\n}\n\n/** Publishes every reconciled metric Finding while preserving applied waiver evidence. */\nexport function reportReconciledCodeQualityFindingRecords<\n  Finding extends CodeQualityFindingCandidate\n>(context: FindingRecordContext, reconciliation: FindingWaiverReconciliation<Finding>): void {\n  for (const finding of reconciliation.findings) {\n    const data =\n      finding.disposition === \"waived\"\n        ? Object.freeze({\n            ...finding.finding.data,\n            blocking: false,\n            waiver: Object.freeze({ reason: finding.waiver.reason })\n          })\n        : finding.finding.data;\n    context.records.report({ id: finding.finding.id }, data);\n  }\n}\n\n/** Publishes only unused/overmatched audit rows built by the identity-owning Check. */\nexport function reportFindingWaiverAudits<Finding, AuditData extends object>(\n  context: FindingRecordContext,\n  reconciliation: FindingWaiverReconciliation<Finding>,\n  buildRecord: (\n    audit: FindingWaiverRecordAudit\n  ) => Readonly<{ readonly data: AuditData; readonly id: string }>\n): void {\n  for (const audit of reconciliation.waiverAudits) {\n    if (audit.status === \"applied\") continue;\n    const record = buildRecord(\n      Object.freeze({\n        matchCount: audit.matchCount,\n        status: audit.status,\n        waiver: audit.waiver\n      })\n    );\n    context.records.report({ id: record.id }, record.data);\n  }\n}\n"]}
+{"version":3,"file":"finding-waiver-evidence.mjs","sourceRoot":"","sources":["../../../../src/package-checks/code-quality-findings/finding-waiver-evidence.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAa3E,MAAM,qCAAqC,GAAG,wBAAwB,CAAC;AAgBvE,mFAAmF;AACnF,MAAM,UAAU,iCAAiC,CAC/C,QAAkB,EAClB,KAA+B;IAE/B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,QAAQ;QACR,IAAI,EAAE,sBAAsB;QAC5B,UAAU,EAAE,KAAK,CAAC,UAAU;QAC5B,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM;QAC3B,MAAM,EAAE,KAAK,CAAC,MAAM;KACrB,CAAC,CAAC;AACL,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,mCAAmC,CACjD,QAAkB,EAClB,KAA+B;IAE/B,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACvF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,iCAAiC,CAAC,QAAQ,EAAE,KAAK,CAAC;QACxD,EAAE,EAAE,GAAG,qCAAqC,UAAU,MAAM,EAAE;KAC/D,CAAC,CAAC;AACL,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,yCAAyC,CAEvD,OAA6B,EAAE,cAAoD;IACnF,KAAK,MAAM,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,GACR,OAAO,CAAC,WAAW,KAAK,QAAQ;YAC9B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;gBACZ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI;gBACvB,QAAQ,EAAE,KAAK;gBACf,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;aACzD,CAAC;YACJ,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3B,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,yBAAyB,CACvC,OAA6B,EAC7B,cAAoD,EACpD,WAEgE;IAEhE,KAAK,MAAM,KAAK,IAAI,cAAc,CAAC,YAAY,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;YAAE,SAAS;QACzC,MAAM,MAAM,GAAG,WAAW,CACxB,MAAM,CAAC,MAAM,CAAC;YACZ,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,MAAM,EAAE,KAAK,CAAC,MAAM;SACrB,CAAC,CACH,CAAC;QACF,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\n\nimport type { CheckExecutionContext } from \"../../check/check.ts\";\nimport { canonicalJsonBytes } from \"../../data-boundary/canonical-data.ts\";\nimport type {\n  FindingWaiverAudit,\n  FindingWaiverReconciliation\n} from \"../../package-tools/finding-waivers/reconciliation.ts\";\n\ninterface CodeQualityFindingCandidate {\n  readonly data: Readonly<{ readonly blocking: boolean }>;\n  readonly id: string;\n}\n\ntype FindingRecordContext = Pick<CheckExecutionContext<object>, \"records\">;\n\nconst FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX = \"/finding-waiver-audit/\";\n\nexport type FindingWaiverRecordAudit = Readonly<\n  Omit<FindingWaiverAudit, \"status\"> & {\n    readonly status: \"overmatched\" | \"unused\";\n  }\n>;\n\nexport type FindingWaiverAuditRecordData<Identity> = Readonly<{\n  readonly identity: Identity;\n  readonly kind: \"finding-waiver-audit\";\n  readonly matchCount: number;\n  readonly reason: string;\n  readonly status: \"overmatched\" | \"unused\";\n}>;\n\n/** Builds the common immutable data shared by Check-owned waiver audit Records. */\nexport function buildFindingWaiverAuditRecordData<Identity>(\n  identity: Identity,\n  audit: FindingWaiverRecordAudit\n): FindingWaiverAuditRecordData<Identity> {\n  return Object.freeze({\n    identity,\n    kind: \"finding-waiver-audit\",\n    matchCount: audit.matchCount,\n    reason: audit.waiver.reason,\n    status: audit.status\n  });\n}\n\n/** Builds the shared hash-addressed audit Record used by structured identities. */\nexport function buildHashedFindingWaiverAuditRecord<Identity>(\n  identity: Identity,\n  audit: FindingWaiverRecordAudit\n): Readonly<{ readonly data: FindingWaiverAuditRecordData<Identity>; readonly id: string }> {\n  const digest = createHash(\"sha256\").update(canonicalJsonBytes(identity)).digest(\"hex\");\n  return Object.freeze({\n    data: buildFindingWaiverAuditRecordData(identity, audit),\n    id: `${FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX}sha256:${digest}`\n  });\n}\n\n/** Publishes every reconciled metric Finding while preserving applied waiver evidence. */\nexport function reportReconciledCodeQualityFindingRecords<\n  Finding extends CodeQualityFindingCandidate\n>(context: FindingRecordContext, reconciliation: FindingWaiverReconciliation<Finding>): void {\n  for (const finding of reconciliation.findings) {\n    const data =\n      finding.disposition === \"waived\"\n        ? Object.freeze({\n            ...finding.finding.data,\n            blocking: false,\n            waiver: Object.freeze({ reason: finding.waiver.reason })\n          })\n        : finding.finding.data;\n    context.records.report({ id: finding.finding.id }, data);\n  }\n}\n\n/** Publishes only unused/overmatched audit rows built by the identity-owning Check. */\nexport function reportFindingWaiverAudits<Finding, AuditData extends object>(\n  context: FindingRecordContext,\n  reconciliation: FindingWaiverReconciliation<Finding>,\n  buildRecord: (\n    audit: FindingWaiverRecordAudit\n  ) => Readonly<{ readonly data: AuditData; readonly id: string }>\n): void {\n  for (const audit of reconciliation.waiverAudits) {\n    if (audit.status === \"applied\") continue;\n    const record = buildRecord(\n      Object.freeze({\n        matchCount: audit.matchCount,\n        status: audit.status,\n        waiver: audit.waiver\n      })\n    );\n    context.records.report({ id: record.id }, record.data);\n  }\n}\n"]}

package/dist/esm/package-checks/command-check/command-check.mjs

@@ -0,0 +1,55 @@
+import { executeCommandCheck } from "./execution.mjs";
+import { resolveCommandCheckInput } from "./options.mjs";
+export function commandCheck(input) {
+    const commandInput = input;
+    const resolved = resolveCommandCheckInput(input);
+    if (resolved === undefined) {
+        throw new TypeError("commandCheck input must match the documented closed command and ordinary Check authoring policy");
+    }
+    return {
+        ...(commandInput.admissionPriority === undefined
+            ? {}
+            : { admissionPriority: commandInput.admissionPriority }),
+        ...(commandInput.checks === undefined ? {} : { checks: commandInput.checks }),
+        ...(commandInput.dependsOn === undefined ? {} : { dependsOn: commandInput.dependsOn }),
+        ...(commandInput.enabledByFlags === undefined
+            ? {}
+            : { enabledByFlags: commandInput.enabledByFlags }),
+        ...(commandInput.maxParallel === undefined ? {} : { maxParallel: commandInput.maxParallel }),
+        ...(commandInput.mutex === undefined ? {} : { mutex: commandInput.mutex }),
+        ...(commandInput.observes === undefined ? {} : { observes: commandInput.observes }),
+        ...(commandInput.omitQuietPassedRow === undefined
+            ? {}
+            : { omitQuietPassedRow: commandInput.omitQuietPassedRow }),
+        ...(commandInput.resourceClaims === undefined
+            ? {}
+            : { resourceClaims: commandInput.resourceClaims }),
+        checkId: commandInput.checkId,
+        displayName: commandInput.displayName,
+        execute: (context) => executeCommandCheck(context, {
+            afterCommand: resolved.afterCommand,
+            resolveEnvironment: resolved.resolveEnvironment
+        }),
+        options: resolved.options,
+        prepare: (options) => isRevalidatedCommandOptions(options, commandInput.checkId, commandInput.displayName)
+            ? { status: "success", preparedOptions: options }
+            : { status: "failure", action: "block", reason: { code: "invalid-options" } },
+        ...(resolved.afterCommand?.parseData === undefined
+            ? {}
+            : { parseData: resolved.afterCommand.parseData })
+    };
+}
+function isRevalidatedCommandOptions(options, checkId, displayName) {
+    return (resolveCommandCheckInput({
+        checkId,
+        displayName,
+        executable: options.executable,
+        arguments: options.arguments,
+        environment: options.environment,
+        output: options.output,
+        outputByteLimit: options.outputByteLimit,
+        timeoutMs: options.timeoutMs,
+        ...(options.workingDirectory === null ? {} : { workingDirectory: options.workingDirectory })
+    }) !== undefined);
+}
+//# sourceMappingURL=command-check.mjs.map

package/dist/esm/package-checks/command-check/command-check.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-check.mjs","sourceRoot":"","sources":["../../../../src/package-checks/command-check/command-check.ts"],"names":[],"mappings":"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","sourcesContent":["import { executeCommandCheck } from \"./execution.ts\";\nimport type { Check, CheckDataParser } from \"../../check/check.ts\";\nimport { resolveCommandCheckInput } from \"./options.ts\";\nimport type {\n  AfterCommand,\n  AfterCommandExecution,\n  CommandCheck,\n  CommandCheckInput,\n  CommandCheckWithAfterCommand,\n  ResolvedCommandCheckOptions,\n  TypedCommandCheck\n} from \"./contract.ts\";\n\nexport type {\n  AfterCommand,\n  AfterCommandContext,\n  AfterCommandExecution,\n  CommandCheckWithAfterCommand,\n  CommandEnvironmentContext,\n  CommandEnvironmentResolver,\n  CompletedCommand,\n  CommandCheck,\n  CommandCheckEnvironment,\n  CommandCheckFinalData,\n  CommandCheckInput,\n  CommandCheckOutput,\n  CommandCheckUnavailableReasonCode,\n  TypedCommandCheck\n} from \"./contract.ts\";\n\ntype CommandCheckImplementationInput = CommandCheckInput<string, AfterCommand | undefined>;\n\n/**\n * 构造一个单一 no-shell executable 的 ordinary Check。\n *\n * @remarks constructor 会闭合并冻结 command-owned options；ordinary selection、relation 与 scheduling fields 仍按普通 Check lifecycle 传递。默认 exact-empty environment 与 discard output 不会把 ambient variables、child stdout/stderr 或 native error text 发布到 Check facts。`output: { mode: \"transcript\" }` 仅在 invocation 授予此 Check artifact directory 时，将 raw stdout/stderr 写入固定 `process.log`。\n * @example 以 process.execPath 构造无 shell command Check\n * ```ts\n * import { commandCheck, defineConfig, run } from \"@zxyycom/vibe-check\";\n *\n * const nodeProbe = commandCheck({\n *   checkId: \"node-probe\",\n *   displayName: \"Node probe\",\n *   executable: process.execPath,\n *   arguments: [\"--eval\", \"process.exit(0)\"],\n *   timeoutMs: 5_000,\n *   outputByteLimit: 64 * 1024\n * });\n *\n * const definition = defineConfig({\n *   checks: [nodeProbe],\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 * const outcome = result.snapshot.checks.find(\n *   ({ checkId }) => checkId === nodeProbe.checkId\n * )?.outcome;\n * if (outcome?.status !== \"passed\" || outcome.data.exitCode !== 0) {\n *   throw new Error(\"Node probe did not produce the expected passed outcome\");\n * }\n * ```\n */\nexport function commandCheck<const Id extends string, const FinalData extends object>(\n  input: CommandCheckInput<\n    Id,\n    Readonly<{\n      readonly execute: AfterCommandExecution<FinalData>;\n      readonly parseData?: never;\n    }>\n  >\n): CommandCheckWithAfterCommand<Id, FinalData>;\nexport function commandCheck<const Id extends string, const Parser extends CheckDataParser>(\n  input: CommandCheckInput<\n    Id,\n    Readonly<{\n      readonly execute: AfterCommandExecution<NoInfer<ReturnType<Parser>>>;\n      readonly parseData: Parser;\n    }>\n  >\n): TypedCommandCheck<Id, Parser>;\nexport function commandCheck<const Id extends string>(\n  input: CommandCheckInput<Id>\n): CommandCheck<Id>;\nexport function commandCheck(input: CommandCheckImplementationInput): Check {\n  const commandInput = input;\n  const resolved = resolveCommandCheckInput(input);\n  if (resolved === undefined) {\n    throw new TypeError(\n      \"commandCheck input must match the documented closed command and ordinary Check authoring policy\"\n    );\n  }\n  return {\n    ...(commandInput.admissionPriority === undefined\n      ? {}\n      : { admissionPriority: commandInput.admissionPriority }),\n    ...(commandInput.checks === undefined ? {} : { checks: commandInput.checks }),\n    ...(commandInput.dependsOn === undefined ? {} : { dependsOn: commandInput.dependsOn }),\n    ...(commandInput.enabledByFlags === undefined\n      ? {}\n      : { enabledByFlags: commandInput.enabledByFlags }),\n    ...(commandInput.maxParallel === undefined ? {} : { maxParallel: commandInput.maxParallel }),\n    ...(commandInput.mutex === undefined ? {} : { mutex: commandInput.mutex }),\n    ...(commandInput.observes === undefined ? {} : { observes: commandInput.observes }),\n    ...(commandInput.omitQuietPassedRow === undefined\n      ? {}\n      : { omitQuietPassedRow: commandInput.omitQuietPassedRow }),\n    ...(commandInput.resourceClaims === undefined\n      ? {}\n      : { resourceClaims: commandInput.resourceClaims }),\n    checkId: commandInput.checkId,\n    displayName: commandInput.displayName,\n    execute: (context: Parameters<CommandCheck[\"execute\"]>[0]) =>\n      executeCommandCheck(context, {\n        afterCommand: resolved.afterCommand,\n        resolveEnvironment: resolved.resolveEnvironment\n      }),\n    options: resolved.options,\n    prepare: (options: ResolvedCommandCheckOptions) =>\n      isRevalidatedCommandOptions(options, commandInput.checkId, commandInput.displayName)\n        ? { status: \"success\", preparedOptions: options }\n        : { status: \"failure\", action: \"block\", reason: { code: \"invalid-options\" } },\n    ...(resolved.afterCommand?.parseData === undefined\n      ? {}\n      : { parseData: resolved.afterCommand.parseData })\n  };\n}\n\nfunction isRevalidatedCommandOptions<Id extends string>(\n  options: ResolvedCommandCheckOptions,\n  checkId: Id,\n  displayName: string\n): boolean {\n  return (\n    resolveCommandCheckInput({\n      checkId,\n      displayName,\n      executable: options.executable,\n      arguments: options.arguments,\n      environment: options.environment,\n      output: options.output,\n      outputByteLimit: options.outputByteLimit,\n      timeoutMs: options.timeoutMs,\n      ...(options.workingDirectory === null ? {} : { workingDirectory: options.workingDirectory })\n    }) !== undefined\n  );\n}\n"]}

package/dist/esm/package-checks/command-check/contract.mjs

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

package/dist/esm/package-checks/command-check/contract.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.mjs","sourceRoot":"","sources":["../../../../src/package-checks/command-check/contract.ts"],"names":[],"mappings":"","sourcesContent":["import type {\n  Check,\n  CheckDataParser,\n  CheckDependencies,\n  CheckExecutionContext,\n  CheckFlagEnablement,\n  CheckProjectContext,\n  CheckResourceClaims,\n  CheckResult,\n  CheckWithOptions,\n  DeepReadonly,\n  InheritableCheckCollection,\n  TypedCheckWithOptions\n} from \"../../check/check.ts\";\n\n/** command Check 的显式环境策略；默认 exact-empty，避免定义时读取 ambient environment。 */\nexport type CommandCheckEnvironment =\n  | Readonly<{\n      readonly mode: \"exact\";\n      readonly variables?: Readonly<Record<string, string>>;\n    }>\n  | Readonly<{\n      readonly mode: \"inherit\";\n      readonly overrides?: Readonly<Record<string, string | null>>;\n    }>;\n\n/** child stdout/stderr 的处理边界；默认 discard。 */\nexport type CommandCheckOutput = Readonly<{ readonly mode: \"discard\" | \"transcript\" }>;\n\n/** command 以 numeric exit status 结束时发布的唯一 final data。 */\nexport interface CommandCheckFinalData {\n  /** child process 的 numeric exit status。 */\n  readonly exitCode: number;\n}\n\n/** 已完整结束且只在 invocation-local callback 中可见的 child material。 */\nexport interface CompletedCommand {\n  readonly exitCode: number;\n  readonly stderr: string;\n  readonly stdout: string;\n}\n\n/** spawn 前 environment resolver 可读取的最小 invocation context。 */\nexport interface CommandEnvironmentContext {\n  readonly dependencies: CheckDependencies;\n  readonly options: DeepReadonly<ResolvedCommandCheckOptions>;\n  readonly project: CheckProjectContext;\n  readonly signal: AbortSignal;\n}\n\n/** 完整 command 后 caller-owned settlement 可读取的 context。 */\nexport type AfterCommandContext = CheckExecutionContext<ResolvedCommandCheckOptions> &\n  Readonly<{ readonly command: CompletedCommand }>;\n\n/** 完整 command 的 caller-owned settlement callback。 */\nexport type AfterCommandExecution<FinalData extends object = object> = (\n  this: void,\n  context: AfterCommandContext\n) => CheckResult<FinalData> | Promise<CheckResult<FinalData>>;\n\n/** command 完成后的可选 caller-owned settlement 与 typed-provider parser。 */\nexport type AfterCommand<FinalData extends object = object> = Readonly<{\n  readonly execute: AfterCommandExecution<FinalData>;\n  readonly parseData?: CheckDataParser | undefined;\n}>;\n\n/** spawn 前解析此次 command closed environment policy 的 callback。 */\nexport type CommandEnvironmentResolver = (\n  this: void,\n  context: CommandEnvironmentContext\n) => CommandCheckEnvironment | Promise<CommandCheckEnvironment>;\n\n/** command Check 自己产生的 stable unavailable reason code。 */\nexport type CommandCheckUnavailableReasonCode =\n  | \"command-environment-resolution-failed\"\n  | \"command-output-limit-exceeded\"\n  | \"command-start-failed\"\n  | \"command-terminated-by-signal\"\n  | \"command-timeout\"\n  | \"command-transcript-unavailable\"\n  | \"invalid-options\";\n\n/** `commandCheck` 的 closed authoring input；ordinary Check composition fields 原样交由 Core 处理。 */\ninterface CommandCheckBaseInput<Id extends string> {\n  readonly checkId: Id;\n  readonly displayName: string;\n  readonly executable: string;\n  readonly arguments?: readonly string[];\n  readonly workingDirectory?: string;\n  readonly timeoutMs: number;\n  readonly outputByteLimit: number;\n  readonly output?: CommandCheckOutput;\n  readonly enabledByFlags?: CheckFlagEnablement;\n  readonly checks?: readonly Check[];\n  readonly dependsOn?: InheritableCheckCollection<string>;\n  readonly observes?: InheritableCheckCollection<string>;\n  readonly maxParallel?: number;\n  readonly admissionPriority?: number;\n  readonly mutex?: InheritableCheckCollection<string>;\n  readonly resourceClaims?: CheckResourceClaims;\n  readonly omitQuietPassedRow?: true;\n}\n\n/** Static environment 与 invocation-time resolver 互斥；两者都省略时使用 exact-empty。 */\nexport type CommandCheckInput<\n  Id extends string = string,\n  After extends AfterCommand | undefined = undefined\n> = CommandCheckBaseInput<Id> &\n  (\n    | Readonly<{\n        readonly environment?: CommandCheckEnvironment;\n        readonly resolveEnvironment?: never;\n      }>\n    | Readonly<{\n        readonly environment?: never;\n        readonly resolveEnvironment: CommandEnvironmentResolver;\n      }>\n  ) &\n  (After extends undefined\n    ? Readonly<{ readonly afterCommand?: undefined }>\n    : Readonly<{ readonly afterCommand: After }>);\n\n/** command constructor materializes、冻结并在 preparation 再次验证的内部完整 options。 */\nexport interface ResolvedCommandCheckOptions {\n  readonly arguments: readonly string[];\n  readonly environment:\n    | Readonly<{ readonly mode: \"exact\"; readonly variables: Readonly<Record<string, string>> }>\n    | Readonly<{\n        readonly mode: \"inherit\";\n        readonly overrides: Readonly<Record<string, string | null>>;\n      }>;\n  readonly executable: string;\n  readonly output: Readonly<{ readonly mode: \"discard\" | \"transcript\" }>;\n  readonly outputByteLimit: number;\n  readonly timeoutMs: number;\n  /** `null` 表示 execution 时使用 invocation project root。 */\n  readonly workingDirectory: string | null;\n}\n\n/** 可放入普通 Project Definition 的 process-backed Check。 */\nexport type CommandCheck<Id extends string = string> = CheckWithOptions<\n  Id,\n  ResolvedCommandCheckOptions\n> &\n  Readonly<{\n    execute(\n      this: void,\n      context: CheckExecutionContext<ResolvedCommandCheckOptions>\n    ): CheckResult<CommandCheckFinalData> | Promise<CheckResult<CommandCheckFinalData>>;\n  }>;\n\n/** 带 caller-owned completion callback 的 ordinary command Check。 */\nexport type CommandCheckWithAfterCommand<Id extends string, FinalData extends object> = Omit<\n  CheckWithOptions<Id, ResolvedCommandCheckOptions>,\n  \"execute\"\n> &\n  Readonly<{\n    execute(\n      this: void,\n      context: CheckExecutionContext<ResolvedCommandCheckOptions>\n    ): CheckResult<FinalData> | Promise<CheckResult<FinalData>>;\n  }>;\n\n/** 带 caller-owned completion callback 与 parser 的 typed-provider command Check。 */\nexport type TypedCommandCheck<\n  Id extends string,\n  Parser extends CheckDataParser\n> = TypedCheckWithOptions<Id, ResolvedCommandCheckOptions, Parser>;\n"]}