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

@zxyycom/vibe-check 0.0.1 → 0.0.3

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

Files changed (1190) hide show

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

@@ -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,15 +46,34 @@ 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;
     }
 }
+/**
+ * 取得字段集合恰好匹配调用方字段表的闭合普通记录外层浅快照。
+ *
+ * 输入必须是使用 `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;
+}
 function closedArrayLength(shape) {
     const descriptor = shape.descriptors.length;
     if (typeof descriptor?.value !== "number" || descriptor.enumerable !== false)
@@ -66,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)
@@ -95,4 +124,15 @@ export function hasRequiredAndOptionalRecordKeys(value, keys) {
     return (keys.required.every((key) => Object.hasOwn(value, key)) &&
         Object.keys(value).every((key) => supportedKeys.has(key)));
 }
+/** Snapshots an authoring record whose keys are limited to one required/optional policy. */
+export function snapshotClosedPolicyRecord(value, keys) {
+    const record = snapshotClosedRecord(value);
+    return record !== undefined &&
+        hasRequiredAndOptionalRecordKeys(record, {
+            optional: keys.optional ?? [],
+            required: keys.required ?? []
+        })
+        ? record
+        : undefined;
+}
 //# sourceMappingURL=closed-values.mjs.map

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

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

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

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

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

@@ -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/data-boundary/value-shapes.mjs CHANGED Viewed

@@ -10,4 +10,13 @@ export function isUnknownArray(value) {
 export function isStringArray(value) {
     return isUnknownArray(value) && value.every((item) => typeof item === "string");
 }
+export function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+export function isPositiveSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value > 0;
+}
+export function isNonNegativeSafeInteger(value) {
+    return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
 //# sourceMappingURL=value-shapes.mjs.map

package/dist/esm/data-boundary/value-shapes.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"value-shapes.mjs","sourceRoot":"","sources":["../../../src/data-boundary/value-shapes.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAClF,CAAC","sourcesContent":["export function isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null;\n}\n\nexport function isNonArrayRecord(value: unknown): value is Record<string, unknown> {\n return isRecord(value) && !Array.isArray(value);\n}\n\nexport function isUnknownArray(value: unknown): value is unknown[] {\n return Array.isArray(value);\n}\n\nexport function isStringArray(value: unknown): value is string[] {\n return isUnknownArray(value) && value.every((item) => typeof item === \"string\");\n}\n"]}
1	+ {"version":3,"file":"value-shapes.mjs","sourceRoot":"","sources":["../../../src/data-boundary/value-shapes.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc;IACrD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;AAChF,CAAC","sourcesContent":["export function isRecord(value: unknown): value is Record<string, unknown> {\n return typeof value === \"object\" && value !== null;\n}\n\nexport function isNonArrayRecord(value: unknown): value is Record<string, unknown> {\n return isRecord(value) && !Array.isArray(value);\n}\n\nexport function isUnknownArray(value: unknown): value is unknown[] {\n return Array.isArray(value);\n}\n\nexport function isStringArray(value: unknown): value is string[] {\n return isUnknownArray(value) && value.every((item) => typeof item === \"string\");\n}\n\nexport function isNonEmptyString(value: unknown): value is string {\n return typeof value === \"string\" && value.length > 0;\n}\n\nexport function isPositiveSafeInteger(value: unknown): value is number {\n return typeof value === \"number\" && Number.isSafeInteger(value) && value > 0;\n}\n\nexport function isNonNegativeSafeInteger(value: unknown): value is number {\n return typeof value === \"number\" && Number.isSafeInteger(value) && value >= 0;\n}\n"]}

package/dist/esm/index.mjs CHANGED Viewed

@@ -1,26 +1,40 @@
 /**
- * Vibe Check 是由项目在 Bun runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。
+ * Vibe Check 是由项目在 Node runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。
  * 所有公开能力从 package root 导入；package `README.md` 说明 consumer authoring、结果读取和分发范围。
  *
  * @packageDocumentation
  */
+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";
 export { parseFileMetricsData } from "./package-checks/file-metrics/final-data.mjs";
 export { functionMetrics } from "./package-checks/function-metrics/constructor.mjs";
 export { parseFunctionMetricsData } from "./package-checks/function-metrics/final-data.mjs";
+export { secretDetection } from "./package-checks/secret-detection/default-check.mjs";
+export { parseSecretDetectionData } from "./package-checks/secret-detection/final-data.mjs";
 export { jsonSchemaValidation } from "./package-checks/json-schema-validation/default-check.mjs";
 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 { 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 { 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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uDAAuD,CAAC;AAC3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,oDAAoD,CAAC;AAQjG,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;AAQ3F,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,EAAE,6BAA6B,EAAE,MAAM,uDAAuD,CAAC;AAYtG,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;AAS9E,OAAO,EAAE,2BAA2B,EAAE,MAAM,iDAAiD,CAAC;AAM9F,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAYxD,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAW1E,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAC","sourcesContent":["/*\n Vibe Check 是由项目在 Bun runtime 中调用的 TypeScript API，用于定义并执行项目质量 Check。\n * 所有公开能力从 package root 导入；package `README.md` 说明 consumer authoring、结果读取和分发范围。\n \n @packageDocumentation\n */\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 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 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 { 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 JsonSchemaValidationOptions,\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 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 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 CheckExecution,\n CheckExecutionContext,\n CheckPreflight,\n CheckPreflightResult,\n CheckOutcome,\n CheckResult,\n CheckUnavailableReason,\n InheritableCheckCollection\n} from \"./check/check.ts\";\nexport { defineConfig } from \"./project-definition/project-definition.ts\";\nexport type {\n ProjectOutputs,\n ProjectDefinition,\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 { RunResult } from \"./project-run/result.ts\";\n"]}
1	+ {"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 CHANGED Viewed

@@ -2,12 +2,6 @@ import { randomUUID } from "node:crypto";
 import fs from "node:fs";
 import { join } from "node:path";
 const CANONICAL_NAMES = ["records.ndjson", "run.json"];
-const RETIRED_NAMES = [
-    "metrics.json",
-    "report.md",
-    "warnings-all.ndjson",
-    "warnings.ndjson"
-];
 const OWNED_TEMP_PREFIX = ".vibe-check-publication-";
 /** Writes an already validated two-file candidate set through owned temporary paths. */
 export function publishPublicationCandidatesV4(artifactDir, candidates) {
@@ -23,7 +17,6 @@ export function publishPublicationCandidatesV4(artifactDir, candidates) {
             fs.renameSync(file.temp, file.canonical);
             hasReplacedCanonicalPath = true;
         }
-        cleanupRetiredArtifacts(artifactDir);
     }
     catch (error) {
         if (hasReplacedCanonicalPath)
@@ -34,11 +27,7 @@ export function publishPublicationCandidatesV4(artifactDir, candidates) {
     }
 }
 export function cleanupPublicationV4(artifactDir) {
-    removePaths([
-        ...artifactPaths(artifactDir, CANONICAL_NAMES),
-        ...artifactPaths(artifactDir, RETIRED_NAMES),
-        ...ownedTempPaths(artifactDir)
-    ]);
+    removePaths([...artifactPaths(artifactDir, CANONICAL_NAMES), ...ownedTempPaths(artifactDir)]);
 }
 export function cleanupPublicationV4BestEffort(artifactDir) {
     try {
@@ -73,9 +62,6 @@ function cleanupOwnedTempsBestEffort(artifactDir) {
         // Failure cleanup cannot conceal the original publication failure.
     }
 }
-function cleanupRetiredArtifacts(artifactDir) {
-    removePaths(artifactPaths(artifactDir, RETIRED_NAMES));
-}
 function artifactPaths(artifactDir, names) {
     return names.map((name) => join(artifactDir, name));
 }
@@ -96,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 CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"atomic-publication.mjs","sourceRoot":"","sources":["../../../../src/machine-output/v4/atomic-publication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,eAAe,GAAG,CAAC,gBAAgB,EAAE,UAAU,CAAU,CAAC;AAChE,MAAM,~~aAAa,GAAG;IACpB,cAAc;IACd,WAAW;IACX,qBAAqB;IACrB,~~iBAAiB~~;CACT~~,~~CAAC;AACX,MAAM,iBAAiB,~~GAAG,0BAA0B,CAAC;AAarD,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAC5C,WAAmB,EACnB,UAAiC;IAEjC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,yBAAyB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/E,IAAI,wBAAwB,GAAG,KAAK,CAAC;IACrC,IAAI,CAAC;QACH,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,wBAAwB,GAAG,IAAI,CAAC;QAClC,CAAC;~~QACD~~,~~uBAAuB,~~CAAC~~,WAAW,CAAC,CAAC~~;~~IACvC,CAAC;~~IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,wBAAwB;YAAE,8BAA8B,CAAC,WAAW,CAAC,CAAC;;YACrE,2BAA2B,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,WAAW,CAAC~~;QACV~~,GAAG,aAAa,CAAC,WAAW,EAAE,eAAe,CAAC~~;QAC9C~~,~~GAAG,aAAa,CAAC,WAAW,~~EAAE,~~aAAa,CAAC;QAC5C,~~GAAG,cAAc,CAAC,WAAW,CAAC~~;KAC/B~~,CAAC,CAAC;~~AACL~~,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,WAAmB;IAChE,IAAI,CAAC;QACH,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAChC,WAAmB,EACnB,KAAa,EACb,UAAiC;IAEjC,OAAO;QACL;YACE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;YACxC,QAAQ,EAAE,UAAU,CAAC,OAAO;YAC5B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,2BAA2B,KAAK,eAAe,CAAC;SACzE;QACD;YACE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC;YAC9C,QAAQ,EAAE,UAAU,CAAC,aAAa;YAClC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,2BAA2B,KAAK,qBAAqB,CAAC;SAC/E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,2BAA2B,CAAC,WAAmB;IACtD,IAAI,CAAC;QACH,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,SAAS,~~uBAAuB,CAAC,WAAmB;IAClD,WAAW,CAAC,~~aAAa,CAAC,~~WAAW,EAAE,aAAa,CAAC,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,aAAa,CAAC,~~WAAmB,EAAE,KAAwB;IAClE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB;IACzC,OAAO,EAAE;SACN,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACjD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;SAC7C,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,KAAwB;IAC3C,IAAI,YAAqB,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,YAAY,KAAK,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,YAAY,KAAK,SAAS;QAAE,MAAM,YAAY,CAAC;~~AACrD~~,CAAC","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 ~~RETIRED_NAMES = [\n \"metrics.json\",\n \"report.md\",\n \"warnings-all.ndjson\",\n \"warnings.ndjson\"\n] 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 ~~cleanupRetiredArtifacts(artifactDir);\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([\n ...artifactPaths(artifactDir, CANONICAL_NAMES)~~,\n ...artifactPaths(artifactDir~~, ~~RETIRED_NAMES),\n~~ ...ownedTempPaths(artifactDir)\n ]);\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 ~~cleanupRetiredArtifacts(artifactDir: string): void {\n removePaths(~~artifactPaths(artifactDir~~, RETIRED_NAMES));\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"]}
1	+ {"version":3,"file":"atomic-publication.mjs","sourceRoot":"","sources":["../../../../src/machine-output/v4/atomic-publication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,eAAe,GAAG,CAAC,gBAAgB,EAAE,UAAU,CAAU,CAAC;AAChE,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAarD,wFAAwF;AACxF,MAAM,UAAU,8BAA8B,CAC5C,WAAmB,EACnB,UAAiC;IAEjC,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC/C,MAAM,KAAK,GAAG,yBAAyB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,UAAU,CAAC,CAAC;IAC/E,IAAI,wBAAwB,GAAG,KAAK,CAAC;IACrC,IAAI,CAAC;QACH,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/E,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;YACzC,wBAAwB,GAAG,IAAI,CAAC;QAClC,CAAC;IACH,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,IAAI,wBAAwB;YAAE,8BAA8B,CAAC,WAAW,CAAC,CAAC;;YACrE,2BAA2B,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,WAAW,CAAC,CAAC,GAAG,aAAa,CAAC,WAAW,EAAE,eAAe,CAAC,EAAE,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;AAChG,CAAC;AAED,MAAM,UAAU,8BAA8B,CAAC,WAAmB;IAChE,IAAI,CAAC;QACH,oBAAoB,CAAC,WAAW,CAAC,CAAC;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAChC,WAAmB,EACnB,KAAa,EACb,UAAiC;IAEjC,OAAO;QACL;YACE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,UAAU,CAAC;YACxC,QAAQ,EAAE,UAAU,CAAC,OAAO;YAC5B,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,2BAA2B,KAAK,eAAe,CAAC;SACzE;QACD;YACE,SAAS,EAAE,IAAI,CAAC,WAAW,EAAE,gBAAgB,CAAC;YAC9C,QAAQ,EAAE,UAAU,CAAC,aAAa;YAClC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,2BAA2B,KAAK,qBAAqB,CAAC;SAC/E;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,WAAmB;IAC5C,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,2BAA2B,CAAC,WAAmB;IACtD,IAAI,CAAC;QACH,iBAAiB,CAAC,WAAW,CAAC,CAAC;IACjC,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;IACrE,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,WAAmB,EAAE,KAAwB;IAClE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,cAAc,CAAC,WAAmB;IACzC,OAAO,EAAE;SACN,WAAW,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACjD,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;SAC3D,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;SAC7C,IAAI,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,WAAW,CAAC,KAAwB;IAC3C,IAAI,YAAqB,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACpD,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACxB,YAAY,KAAK,KAAK,CAAC;QACzB,CAAC;IACH,CAAC;IACD,IAAI,YAAY,KAAK,SAAS;QAAE,OAAO;IACvC,IAAI,YAAY,YAAY,KAAK;QAAE,MAAM,YAAY,CAAC;IACtD,MAAM,IAAI,KAAK,CAAC,4BAA4B,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC;AACzE,CAAC","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 ADDED Viewed

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

@@ -0,0 +1 @@

+ {"version":3,"file":"check-authoring.mjs","sourceRoot":"","sources":["../../../src/package-checks/check-authoring.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAC;AACpG,OAAO,EAAE,0BAA0B,EAAE,MAAM,4DAA4D,CAAC;AACxG,OAAO,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AAuBhG,MAAM,4BAA4B,GAAG;IACnC,mBAAmB;IACnB,SAAS;IACT,QAAQ;IACR,WAAW;IACX,aAAa;IACb,gBAAgB;IAChB,aAAa;IACb,OAAO;IACP,UAAU;IACV,oBAAoB;IACpB,gBAAgB;CACR,CAAC;AAgBX,gEAAgE;AAChE,MAAM,UAAU,iCAAiC,CAC/C,KAAgD,EAChD,UAA6B,EAC7B,QAIE;IAOF,MAAM,QAAQ,GAAG,0BAA0B,CAAC,KAAK,EAAE;QACjD,QAAQ,EAAE,CAAC,GAAG,UAAU,EAAE,GAAG,4BAA4B,CAAC;KAC3D,CAAC,CAAC;IACH,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAE7C,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC;IACrD,MAAM,WAAW,GAAG,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,WAAW,CAAC;IACjE,IAAI,CAAC,gBAAgB,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC;QAAE,OAAO,SAAS,CAAC;IACnF,IACE,CAAC,QAAQ,CAAC,kBAAkB,KAAK,SAAS;QACxC,OAAO,QAAQ,CAAC,kBAAkB,KAAK,SAAS,CAAC;QACnD,CAAC,yBAAyB,CAAC,QAAQ,CAAC,EACpC,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,kBAAkB,GACtB,QAAQ,CAAC,kBAAkB,KAAK,SAAS;QACvC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,KAAK,IAAI;QACtC,CAAC,CAAC,QAAQ,CAAC,kBAAkB,KAAK,IAAI,CAAC;IAE3C,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,CACjC,MAAM,CAAC,WAAW,CAChB,UAAU,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAC1F,CACF,CAAC;IACF,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,CAAC;QAC/B,GAAG,CAAC,QAAQ,CAAC,iBAAiB,KAAK,SAAS;YAC1C,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB,EAAE,CAAC;QACtD,GAAG,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrE,GAAG,CAAC,QAAQ,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC;QAC9E,GAAG,CAAC,QAAQ,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC7F,GAAG,CAAC,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;QACpF,GAAG,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;QAClE,GAAG,CAAC,QAAQ,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAC3E,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpE,GAAG,CAAC,QAAQ,CAAC,cAAc,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC7F,kGAAkG;QAClG,2KAA2K;QAC3K,OAAO,EAAE,OAAa;QACtB,WAAW;KACZ,CAAsC,CAAC;IACxC,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,yBAAyB,CAChC,KAAwC;IAExC,MAAM,UAAU,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC3C,IACE,KAAK,CAAC,cAAc,KAAK,SAAS;QAClC,0BAA0B,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,SAAS,EAC9D,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,KAAK,CAAC,MAAM,KAAK,SAAS,IAAI,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;AACvF,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC","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 ADDED Viewed

@@ -0,0 +1,40 @@
+import { canonicalJsonText } from "../../data-boundary/canonical-data.mjs";
+import { snapshotClosedArray, snapshotClosedPolicyRecord } from "../../data-boundary/closed-values.mjs";
+import { isNonEmptyString } from "../../data-boundary/value-shapes.mjs";
+/**
+ * Snapshots the shared closed waiver envelope while leaving identity grammar to the producing Check.
+ */
+export function resolveFindingWaiverAuthoring(value, resolveIdentity) {
+    if (value === undefined)
+        return Object.freeze([]);
+    const candidates = snapshotClosedArray(value);
+    if (candidates === undefined)
+        return undefined;
+    const waivers = [];
+    const seenIdentities = new Set();
+    for (const candidate of candidates) {
+        const authored = snapshotClosedPolicyRecord(candidate, { required: ["identity", "reason"] });
+        if (authored === undefined || !isNonEmptyString(authored.reason))
+            return undefined;
+        const identity = resolveIdentity(authored.identity);
+        if (identity === undefined)
+            return undefined;
+        let identityKey;
+        try {
+            identityKey = canonicalJsonText(identity);
+        }
+        catch {
+            return undefined;
+        }
+        if (seenIdentities.has(identityKey))
+            return undefined;
+        seenIdentities.add(identityKey);
+        waivers.push(Object.freeze({ identity, reason: authored.reason }));
+    }
+    return Object.freeze(waivers);
+}
+/** Validates the complete resolved waiver list through the same authoring boundary. */
+export function validResolvedFindingWaivers(value, resolveIdentity) {
+    return value !== undefined && resolveFindingWaiverAuthoring(value, resolveIdentity) !== undefined;
+}
+//# sourceMappingURL=finding-waiver-authoring.mjs.map

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

@@ -0,0 +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 \"../../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 ADDED Viewed

@@ -0,0 +1,48 @@
+import { createHash } from "node:crypto";
+import { canonicalJsonBytes } from "../../data-boundary/canonical-data.mjs";
+const FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX = "/finding-waiver-audit/";
+/** Builds the common immutable data shared by Check-owned waiver audit Records. */
+export function buildFindingWaiverAuditRecordData(identity, audit) {
+    return Object.freeze({
+        identity,
+        kind: "finding-waiver-audit",
+        matchCount: audit.matchCount,
+        reason: audit.waiver.reason,
+        status: audit.status
+    });
+}
+/** Builds the shared hash-addressed audit Record used by structured identities. */
+export function buildHashedFindingWaiverAuditRecord(identity, audit) {
+    const digest = createHash("sha256").update(canonicalJsonBytes(identity)).digest("hex");
+    return Object.freeze({
+        data: buildFindingWaiverAuditRecordData(identity, audit),
+        id: `${FINDING_WAIVER_AUDIT_RECORD_ID_PREFIX}sha256:${digest}`
+    });
+}
+/** Publishes every reconciled metric Finding while preserving applied waiver evidence. */
+export function reportReconciledCodeQualityFindingRecords(context, reconciliation) {
+    for (const finding of reconciliation.findings) {
+        const data = finding.disposition === "waived"
+            ? Object.freeze({
+                ...finding.finding.data,
+                blocking: false,
+                waiver: Object.freeze({ reason: finding.waiver.reason })
+            })
+            : finding.finding.data;
+        context.records.report({ id: finding.finding.id }, data);
+    }
+}
+/** Publishes only unused/overmatched audit rows built by the identity-owning Check. */
+export function reportFindingWaiverAudits(context, reconciliation, buildRecord) {
+    for (const audit of reconciliation.waiverAudits) {
+        if (audit.status === "applied")
+            continue;
+        const record = buildRecord(Object.freeze({
+            matchCount: audit.matchCount,
+            status: audit.status,
+            waiver: audit.waiver
+        }));
+        context.records.report({ id: record.id }, record.data);
+    }
+}
+//# sourceMappingURL=finding-waiver-evidence.mjs.map

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

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