@zxyycom/vibe-check 0.0.1 → 0.0.2

package/dist/esm/project-run/controls/outputs-override-validation.mjs

@@ -1,61 +1,81 @@
 import { snapshotClosedRecord } from "../../data-boundary/closed-values.mjs";
-import { isContainedRelativeDirectory } from "../../project-definition/output-validation.mjs";
+import { isOutputDirectory } from "../../project-definition/output-validation.mjs";
+import { parseProgressRenderingFields } from "../../project-definition/progress-rendering-output.mjs";
 /** Parses invocation-local outputs without changing Definition defaults. */
 export function parseOutputsOverride(value) {
+    if (value === undefined)
+        return { ok: true, value: undefined };
     const data = snapshotClosedRecord(value);
-    if (data === undefined ||
-        Object.keys(data).some((key) => key !== "machinePublication" && key !== "progressRendering" && key !== "diagnosticLogging"))
-        return undefined;
+    const path = "controls.outputs";
+    if (data === undefined)
+        return invalidOutput(path, "invalid-value", "plain-data-object");
+    const unknownKey = Object.keys(data).find((key) => key !== "machinePublication" && key !== "progressRendering" && key !== "diagnosticLogging");
+    if (unknownKey !== undefined)
+        return invalidOutput(`${path}.${unknownKey}`, "unknown-key");
     const machinePublication = optionalOutput(data, "machinePublication", parseDirectoryOutputOverride);
-    const progressRendering = optionalOutput(data, "progressRendering", parseProgressOutputOverride);
-    const diagnosticLogging = optionalOutput(data, "diagnosticLogging", parseDiagnosticLoggingOverride);
-    if (!machinePublication.ok || !progressRendering.ok || !diagnosticLogging.ok)
-        return undefined;
-    return Object.freeze({
-        ...(machinePublication.value === undefined
-            ? {}
-            : { machinePublication: machinePublication.value }),
-        ...(progressRendering.value === undefined
-            ? {}
-            : { progressRendering: progressRendering.value }),
-        ...(diagnosticLogging.value === undefined ? {} : { diagnosticLogging: diagnosticLogging.value })
-    });
+    if (!machinePublication.ok)
+        return machinePublication;
+    const progressRendering = optionalOutput(data, "progressRendering", parseProgressOverride);
+    if (!progressRendering.ok)
+        return progressRendering;
+    const diagnosticLogging = optionalOutput(data, "diagnosticLogging", parseDirectoryOutputOverride);
+    if (!diagnosticLogging.ok)
+        return diagnosticLogging;
+    return {
+        ok: true,
+        value: Object.freeze({
+            ...(machinePublication.value === undefined
+                ? {}
+                : { machinePublication: machinePublication.value }),
+            ...(progressRendering.value === undefined
+                ? {}
+                : { progressRendering: progressRendering.value }),
+            ...(diagnosticLogging.value === undefined
+                ? {}
+                : { diagnosticLogging: diagnosticLogging.value })
+        })
+    };
 }
 function optionalOutput(value, key, parse) {
     if (value[key] === undefined)
-        return Object.freeze({ ok: true });
-    const parsed = parse(value[key]);
-    return parsed === undefined
-        ? Object.freeze({ ok: false })
-        : Object.freeze({ ok: true, value: parsed });
+        return { ok: true, value: undefined };
+    return parse(value[key], `controls.outputs.${key}`);
 }
-function parseDirectoryOutputOverride(value) {
-    const data = snapshotClosedRecord(value);
-    if (data === undefined ||
-        Object.keys(data).some((key) => key !== "directory" && key !== "enabled"))
-        return undefined;
-    if (data.directory !== undefined && typeof data.directory !== "string")
-        return undefined;
-    if (data.enabled !== undefined && typeof data.enabled !== "boolean")
-        return undefined;
-    return Object.freeze({
-        ...(data.directory === undefined ? {} : { directory: data.directory }),
-        ...(data.enabled === undefined ? {} : { enabled: data.enabled })
-    });
+function parseProgressOverride(value, path) {
+    const fields = parseProgressRenderingFields(value);
+    if (fields.ok)
+        return fields;
+    return invalidOutput(fields.key === null ? path : `${path}.${fields.key}`, fields.reason, fields.expected);
 }
-function parseProgressOutputOverride(value) {
+function parseDirectoryOutputOverride(value, path) {
     const data = snapshotClosedRecord(value);
-    if (data === undefined || Object.keys(data).some((key) => key !== "enabled"))
-        return undefined;
-    if (data.enabled !== undefined && typeof data.enabled !== "boolean")
-        return undefined;
-    return Object.freeze(data.enabled === undefined ? {} : { enabled: data.enabled });
+    if (data === undefined)
+        return invalidOutput(path, "invalid-value", "plain-data-object");
+    const unknownKey = Object.keys(data).find((key) => key !== "directory" && key !== "enabled");
+    if (unknownKey !== undefined)
+        return invalidOutput(`${path}.${unknownKey}`, "unknown-key");
+    if (data.directory !== undefined &&
+        (typeof data.directory !== "string" || !isOutputDirectory(data.directory)))
+        return invalidOutput(`${path}.directory`, "invalid-value", "non-empty-string-without-nul");
+    if (data.enabled !== undefined && typeof data.enabled !== "boolean") {
+        return invalidOutput(`${path}.enabled`, "invalid-value", "boolean");
+    }
+    return {
+        ok: true,
+        value: Object.freeze({
+            ...(data.directory === undefined ? {} : { directory: data.directory }),
+            ...(data.enabled === undefined ? {} : { enabled: data.enabled })
+        })
+    };
 }
-function parseDiagnosticLoggingOverride(value) {
-    const parsed = parseDirectoryOutputOverride(value);
-    return parsed === undefined ||
-        (parsed.directory !== undefined && !isContainedRelativeDirectory(parsed.directory))
-        ? undefined
-        : parsed;
+function invalidOutput(path, reason, expected) {
+    return Object.freeze({
+        ok: false,
+        error: Object.freeze({
+            kind: "invalid-run-controls",
+            path,
+            ...(reason === "invalid-value" && expected !== undefined ? { reason, expected } : { reason })
+        })
+    });
 }
 //# sourceMappingURL=outputs-override-validation.mjs.map

package/dist/esm/project-run/controls/outputs-override-validation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"outputs-override-validation.mjs","sourceRoot":"","sources":["../../../../src/project-run/controls/outputs-override-validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isContainedRelativeDirectory } from \"../../project-definition/output-validation.ts\";\nimport type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\nimport type { RunControls } from \"./contract.ts\";\n\ntype DirectoryOutputOverride = Readonly<{\n  readonly directory?: string;\n  readonly enabled?: boolean;\n}>;\n\n/** Parses invocation-local outputs without changing Definition defaults. */\nexport function parseOutputsOverride(value: unknown): RunControls[\"outputs\"] | undefined {\n  const data = snapshotClosedRecord(value);\n  if (\n    data === undefined ||\n    Object.keys(data).some(\n      (key) =>\n        key !== \"machinePublication\" && key !== \"progressRendering\" && key !== \"diagnosticLogging\"\n    )\n  )\n    return undefined;\n  const machinePublication = optionalOutput(\n    data,\n    \"machinePublication\",\n    parseDirectoryOutputOverride\n  );\n  const progressRendering = optionalOutput(data, \"progressRendering\", parseProgressOutputOverride);\n  const diagnosticLogging = optionalOutput(\n    data,\n    \"diagnosticLogging\",\n    parseDiagnosticLoggingOverride\n  );\n  if (!machinePublication.ok || !progressRendering.ok || !diagnosticLogging.ok) return undefined;\n  return Object.freeze({\n    ...(machinePublication.value === undefined\n      ? {}\n      : { machinePublication: machinePublication.value }),\n    ...(progressRendering.value === undefined\n      ? {}\n      : { progressRendering: progressRendering.value }),\n    ...(diagnosticLogging.value === undefined ? {} : { diagnosticLogging: diagnosticLogging.value })\n  });\n}\nfunction optionalOutput<T>(\n  value: Readonly<Record<string, unknown>>,\n  key: string,\n  parse: (candidate: unknown) => T | undefined\n): Readonly<{ readonly ok: boolean; readonly value?: T }> {\n  if (value[key] === undefined) return Object.freeze({ ok: true });\n  const parsed = parse(value[key]);\n  return parsed === undefined\n    ? Object.freeze({ ok: false })\n    : Object.freeze({ ok: true, value: parsed });\n}\nfunction parseDirectoryOutputOverride(value: unknown): DirectoryOutputOverride | undefined {\n  const data = snapshotClosedRecord(value);\n  if (\n    data === undefined ||\n    Object.keys(data).some((key) => key !== \"directory\" && key !== \"enabled\")\n  )\n    return undefined;\n  if (data.directory !== undefined && typeof data.directory !== \"string\") return undefined;\n  if (data.enabled !== undefined && typeof data.enabled !== \"boolean\") return undefined;\n  return Object.freeze({\n    ...(data.directory === undefined ? {} : { directory: data.directory }),\n    ...(data.enabled === undefined ? {} : { enabled: data.enabled })\n  });\n}\nfunction parseProgressOutputOverride(\n  value: unknown\n): Partial<ProjectOutputs[\"progressRendering\"]> | undefined {\n  const data = snapshotClosedRecord(value);\n  if (data === undefined || Object.keys(data).some((key) => key !== \"enabled\")) return undefined;\n  if (data.enabled !== undefined && typeof data.enabled !== \"boolean\") return undefined;\n  return Object.freeze(data.enabled === undefined ? {} : { enabled: data.enabled });\n}\n\nfunction parseDiagnosticLoggingOverride(\n  value: unknown\n): Partial<ProjectOutputs[\"diagnosticLogging\"]> | undefined {\n  const parsed = parseDirectoryOutputOverride(value);\n  return parsed === undefined ||\n    (parsed.directory !== undefined && !isContainedRelativeDirectory(parsed.directory))\n    ? undefined\n    : parsed;\n}\n"]}
+{"version":3,"file":"outputs-override-validation.mjs","sourceRoot":"","sources":["../../../../src/project-run/controls/outputs-override-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,EAAE,4BAA4B,EAAE,MAAM,uDAAuD,CAAC;AAUrG,4EAA4E;AAC5E,MAAM,UAAU,oBAAoB,CAClC,KAAc;IAEd,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IAC/D,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC;IAChC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CACvC,CAAC,GAAG,EAAE,EAAE,CACN,GAAG,KAAK,oBAAoB,IAAI,GAAG,KAAK,mBAAmB,IAAI,GAAG,KAAK,mBAAmB,CAC7F,CAAC;IACF,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,GAAG,IAAI,IAAI,UAAU,EAAE,EAAE,aAAa,CAAC,CAAC;IAC3F,MAAM,kBAAkB,GAAG,cAAc,CACvC,IAAI,EACJ,oBAAoB,EACpB,4BAA4B,CAC7B,CAAC;IACF,IAAI,CAAC,kBAAkB,CAAC,EAAE;QAAE,OAAO,kBAAkB,CAAC;IACtD,MAAM,iBAAiB,GAAG,cAAc,CAAC,IAAI,EAAE,mBAAmB,EAAE,qBAAqB,CAAC,CAAC;IAC3F,IAAI,CAAC,iBAAiB,CAAC,EAAE;QAAE,OAAO,iBAAiB,CAAC;IACpD,MAAM,iBAAiB,GAAG,cAAc,CAAC,IAAI,EAAE,mBAAmB,EAAE,4BAA4B,CAAC,CAAC;IAClG,IAAI,CAAC,iBAAiB,CAAC,EAAE;QAAE,OAAO,iBAAiB,CAAC;IACpD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,CAAC,kBAAkB,CAAC,KAAK,KAAK,SAAS;gBACxC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,kBAAkB,EAAE,kBAAkB,CAAC,KAAK,EAAE,CAAC;YACrD,GAAG,CAAC,iBAAiB,CAAC,KAAK,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,EAAE,CAAC;YACnD,GAAG,CAAC,iBAAiB,CAAC,KAAK,KAAK,SAAS;gBACvC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,iBAAiB,EAAE,iBAAiB,CAAC,KAAK,EAAE,CAAC;SACpD,CAAC;KACH,CAAC;AACJ,CAAC;AACD,SAAS,cAAc,CACrB,KAAwC,EACxC,GAAW,EACX,KAA0E;IAE1E,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;IACpE,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,oBAAoB,GAAG,EAAE,CAAC,CAAC;AACtD,CAAC;AACD,SAAS,qBAAqB,CAC5B,KAAc,EACd,IAAY;IAEZ,MAAM,MAAM,GAAG,4BAA4B,CAAC,KAAK,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,EAAE;QAAE,OAAO,MAAM,CAAC;IAC7B,OAAO,aAAa,CAClB,MAAM,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,MAAM,CAAC,GAAG,EAAE,EACpD,MAAM,CAAC,MAAM,EACb,MAAM,CAAC,QAAQ,CAChB,CAAC;AACJ,CAAC;AACD,SAAS,4BAA4B,CACnC,KAAc,EACd,IAAY;IAEZ,MAAM,IAAI,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,mBAAmB,CAAC,CAAC;IACzF,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,SAAS,CAAC,CAAC;IAC7F,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,aAAa,CAAC,GAAG,IAAI,IAAI,UAAU,EAAE,EAAE,aAAa,CAAC,CAAC;IAC3F,IACE,IAAI,CAAC,SAAS,KAAK,SAAS;QAC5B,CAAC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAE1E,OAAO,aAAa,CAAC,GAAG,IAAI,YAAY,EAAE,eAAe,EAAE,8BAA8B,CAAC,CAAC;IAC7F,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACpE,OAAO,aAAa,CAAC,GAAG,IAAI,UAAU,EAAE,eAAe,EAAE,SAAS,CAAC,CAAC;IACtE,CAAC;IACD,OAAO;QACL,EAAE,EAAE,IAAI;QACR,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,GAAG,CAAC,IAAI,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;YACtE,GAAG,CAAC,IAAI,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC;SACjE,CAAC;KACH,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,IAAY,EACZ,MAAsC,EACtC,QAA2C;IAE3C,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,KAAK;QACT,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,sBAAsB;YAC5B,IAAI;YACJ,GAAG,CAAC,MAAM,KAAK,eAAe,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC;SAC9F,CAAC;KACH,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { snapshotClosedRecord } from \"../../data-boundary/closed-values.ts\";\nimport { isOutputDirectory } from \"../../project-definition/output-validation.ts\";\nimport { parseProgressRenderingFields } from \"../../project-definition/progress-rendering-output.ts\";\nimport type { ProgressRenderingOutput } from \"../../project-definition/progress-rendering-output.ts\";\nimport type { RunControls } from \"./contract.ts\";\nimport type { RunControlDiagnostic, RunControlValidationResult } from \"./validation-result.ts\";\n\ntype DirectoryOutputOverride = Readonly<{\n  readonly directory?: string;\n  readonly enabled?: boolean;\n}>;\n\n/** Parses invocation-local outputs without changing Definition defaults. */\nexport function parseOutputsOverride(\n  value: unknown\n): RunControlValidationResult<RunControls[\"outputs\"]> {\n  if (value === undefined) return { ok: true, value: undefined };\n  const data = snapshotClosedRecord(value);\n  const path = \"controls.outputs\";\n  if (data === undefined) return invalidOutput(path, \"invalid-value\", \"plain-data-object\");\n  const unknownKey = Object.keys(data).find(\n    (key) =>\n      key !== \"machinePublication\" && key !== \"progressRendering\" && key !== \"diagnosticLogging\"\n  );\n  if (unknownKey !== undefined) return invalidOutput(`${path}.${unknownKey}`, \"unknown-key\");\n  const machinePublication = optionalOutput(\n    data,\n    \"machinePublication\",\n    parseDirectoryOutputOverride\n  );\n  if (!machinePublication.ok) return machinePublication;\n  const progressRendering = optionalOutput(data, \"progressRendering\", parseProgressOverride);\n  if (!progressRendering.ok) return progressRendering;\n  const diagnosticLogging = optionalOutput(data, \"diagnosticLogging\", parseDirectoryOutputOverride);\n  if (!diagnosticLogging.ok) return diagnosticLogging;\n  return {\n    ok: true,\n    value: Object.freeze({\n      ...(machinePublication.value === undefined\n        ? {}\n        : { machinePublication: machinePublication.value }),\n      ...(progressRendering.value === undefined\n        ? {}\n        : { progressRendering: progressRendering.value }),\n      ...(diagnosticLogging.value === undefined\n        ? {}\n        : { diagnosticLogging: diagnosticLogging.value })\n    })\n  };\n}\nfunction optionalOutput<T>(\n  value: Readonly<Record<string, unknown>>,\n  key: string,\n  parse: (candidate: unknown, path: string) => RunControlValidationResult<T>\n): RunControlValidationResult<T | undefined> {\n  if (value[key] === undefined) return { ok: true, value: undefined };\n  return parse(value[key], `controls.outputs.${key}`);\n}\nfunction parseProgressOverride(\n  value: unknown,\n  path: string\n): RunControlValidationResult<Partial<ProgressRenderingOutput>> {\n  const fields = parseProgressRenderingFields(value);\n  if (fields.ok) return fields;\n  return invalidOutput(\n    fields.key === null ? path : `${path}.${fields.key}`,\n    fields.reason,\n    fields.expected\n  );\n}\nfunction parseDirectoryOutputOverride(\n  value: unknown,\n  path: string\n): RunControlValidationResult<DirectoryOutputOverride> {\n  const data = snapshotClosedRecord(value);\n  if (data === undefined) return invalidOutput(path, \"invalid-value\", \"plain-data-object\");\n  const unknownKey = Object.keys(data).find((key) => key !== \"directory\" && key !== \"enabled\");\n  if (unknownKey !== undefined) return invalidOutput(`${path}.${unknownKey}`, \"unknown-key\");\n  if (\n    data.directory !== undefined &&\n    (typeof data.directory !== \"string\" || !isOutputDirectory(data.directory))\n  )\n    return invalidOutput(`${path}.directory`, \"invalid-value\", \"non-empty-string-without-nul\");\n  if (data.enabled !== undefined && typeof data.enabled !== \"boolean\") {\n    return invalidOutput(`${path}.enabled`, \"invalid-value\", \"boolean\");\n  }\n  return {\n    ok: true,\n    value: Object.freeze({\n      ...(data.directory === undefined ? {} : { directory: data.directory }),\n      ...(data.enabled === undefined ? {} : { enabled: data.enabled })\n    })\n  };\n}\n\nfunction invalidOutput(\n  path: string,\n  reason: RunControlDiagnostic[\"reason\"],\n  expected?: RunControlDiagnostic[\"expected\"]\n): RunControlValidationResult<never> {\n  return Object.freeze({\n    ok: false,\n    error: Object.freeze({\n      kind: \"invalid-run-controls\",\n      path,\n      ...(reason === \"invalid-value\" && expected !== undefined ? { reason, expected } : { reason })\n    })\n  });\n}\n"]}

package/dist/esm/project-run/controls/validation-result.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validation-result.mjs","sourceRoot":"","sources":["../../../../src/project-run/controls/validation-result.ts"],"names":[],"mappings":"","sourcesContent":["/** Diagnostic emitted when one invocation control is not a closed supported value. */\nexport interface RunControlDiagnostic {\n  readonly kind: \"invalid-run-controls\";\n  readonly path: string;\n  readonly reason: \"invalid-value\" | \"unknown-key\";\n}\n\n/** Closed validation result for a Run-owned invocation control. */\nexport type RunControlValidationResult<T> = Readonly<\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: RunControlDiagnostic }\n>;\n"]}
+{"version":3,"file":"validation-result.mjs","sourceRoot":"","sources":["../../../../src/project-run/controls/validation-result.ts"],"names":[],"mappings":"","sourcesContent":["import type { ProgressRenderingFieldExpectation } from \"../../project-definition/progress-rendering-output.ts\";\n\n/** 本次 controls 不符合封闭输入契约时的定位诊断；不包含被拒绝的原始值。 */\nexport type RunControlDiagnostic = Readonly<\n  {\n    readonly kind: \"invalid-run-controls\";\n    /** 被拒绝的字段；对象本身无法安全读取时指向该对象。 */\n    readonly path: string;\n  } & (\n    | {\n        readonly reason: \"invalid-value\";\n        /** 输出覆盖值非法时的合法值要求；未提供此提示的诊断省略。 */\n        readonly expected?: ProgressRenderingFieldExpectation | \"non-empty-string-without-nul\";\n      }\n    | { readonly reason: \"unknown-key\"; readonly expected?: never }\n  )\n>;\n\n/** Closed validation result for a Run-owned invocation control. */\nexport type RunControlValidationResult<T> = Readonly<\n  | { readonly ok: true; readonly value: T }\n  | { readonly ok: false; readonly error: RunControlDiagnostic }\n>;\n"]}

package/dist/esm/project-run/controls/validation.mjs

@@ -1,7 +1,17 @@
 import { snapshotClosedArray } from "../../data-boundary/closed-values.mjs";
+import { isOutputDirectory } from "../../project-definition/output-validation.mjs";
 import { isNonArrayRecord, isUnknownArray } from "../../data-boundary/value-shapes.mjs";
 import { parseOutputsOverride } from "./outputs-override-validation.mjs";
-const RUN_CONTROL_KEYS = ["checkAggregation", "outputs", "flags", "projectRoot", "signal"];
+const RUN_CONTROL_KEYS = [
+    "checkArtifactBaseDirectory",
+    "checkAggregation",
+    "diagnosticLogFileNaming",
+    "progressLogFile",
+    "outputs",
+    "flags",
+    "projectRoot",
+    "signal"
+];
 const CHECK_AGGREGATION_MODES = ["all", "any"];
 const UNAVAILABLE_HANDLING = ["propagate", "fail", "exclude"];
 const NOT_APPLICABLE_HANDLING = ["exclude", "pass", "fail"];
@@ -18,32 +28,78 @@ function validateRunControlsValue(value) {
     const data = exactControlRecord(value);
     if (!data.ok)
         return data;
-    const flags = parseFlags(data.value.flags);
+    const fields = parseRunControlFields(data.value);
+    if (!fields.ok)
+        return fields;
+    return Object.freeze({ ok: true, value: runControlsFromFields(fields.value) });
+}
+function parseRunControlFields(data) {
+    const outputTargets = parseInvocationOutputTargets(data);
+    if (!outputTargets.ok)
+        return outputTargets;
+    const flags = parseFlags(data.flags);
     if (!flags.ok)
         return flags;
-    const checkAggregation = parseOptionalCheckAggregation(data.value.checkAggregation);
+    const checkAggregation = parseOptionalCheckAggregation(data.checkAggregation);
     if (!checkAggregation.ok)
         return checkAggregation;
-    const outputs = optionalControl(data.value.outputs, parseOutputsOverride, "controls.outputs");
+    const outputs = parseOutputsOverride(data.outputs);
     if (!outputs.ok)
         return outputs;
-    const projectRoot = optionalControl(data.value.projectRoot, parseString, "controls.projectRoot");
+    const projectRoot = optionalControl(data.projectRoot, parseString, "controls.projectRoot");
     if (!projectRoot.ok)
         return projectRoot;
-    const signal = optionalControl(data.value.signal, parseAbortSignal, "controls.signal");
+    const signal = optionalControl(data.signal, parseAbortSignal, "controls.signal");
     if (!signal.ok)
         return signal;
     return Object.freeze({
         ok: true,
         value: Object.freeze({
-            ...(checkAggregation.value === undefined ? {} : { checkAggregation: checkAggregation.value }),
-            ...(outputs.value === undefined ? {} : { outputs: outputs.value }),
+            ...outputTargets.value,
+            checkAggregation: checkAggregation.value,
             flags: flags.value,
-            ...(projectRoot.value === undefined ? {} : { projectRoot: projectRoot.value }),
-            ...(signal.value === undefined ? {} : { signal: signal.value })
+            outputs: outputs.value,
+            projectRoot: projectRoot.value,
+            signal: signal.value
+        })
+    });
+}
+/** Parse caller-owned invocation output targets separately from Run execution controls. */
+function parseInvocationOutputTargets(data) {
+    const diagnosticLogFileNaming = optionalControl(data.diagnosticLogFileNaming, parseDiagnosticLogFileNaming, "controls.diagnosticLogFileNaming");
+    if (!diagnosticLogFileNaming.ok)
+        return diagnosticLogFileNaming;
+    const checkArtifactBaseDirectory = optionalControl(data.checkArtifactBaseDirectory, parseOutputDirectory, "controls.checkArtifactBaseDirectory");
+    if (!checkArtifactBaseDirectory.ok)
+        return checkArtifactBaseDirectory;
+    const progressLogFile = optionalControl(data.progressLogFile, parseOutputDirectory, "controls.progressLogFile");
+    if (!progressLogFile.ok)
+        return progressLogFile;
+    return Object.freeze({
+        ok: true,
+        value: Object.freeze({
+            diagnosticLogFileNaming: diagnosticLogFileNaming.value,
+            checkArtifactBaseDirectory: checkArtifactBaseDirectory.value,
+            progressLogFile: progressLogFile.value
         })
     });
 }
+function runControlsFromFields(fields) {
+    return Object.freeze({
+        ...(fields.diagnosticLogFileNaming === undefined
+            ? {}
+            : { diagnosticLogFileNaming: fields.diagnosticLogFileNaming }),
+        ...(fields.checkArtifactBaseDirectory === undefined
+            ? {}
+            : { checkArtifactBaseDirectory: fields.checkArtifactBaseDirectory }),
+        ...(fields.checkAggregation === undefined ? {} : { checkAggregation: fields.checkAggregation }),
+        ...(fields.outputs === undefined ? {} : { outputs: fields.outputs }),
+        ...(fields.progressLogFile === undefined ? {} : { progressLogFile: fields.progressLogFile }),
+        flags: fields.flags,
+        ...(fields.projectRoot === undefined ? {} : { projectRoot: fields.projectRoot }),
+        ...(fields.signal === undefined ? {} : { signal: fields.signal })
+    });
+}
 function exactControlRecord(value) {
     if (!isNonArrayRecord(value))
         return invalidControls("controls");
@@ -52,6 +108,9 @@ function exactControlRecord(value) {
         ? Object.freeze({ ok: true, value })
         : invalidRunControl(`controls.${unknownKey}`, "unknown-key");
 }
+function parseDiagnosticLogFileNaming(value) {
+    return value === "unique" || value === "channel" ? value : undefined;
+}
 function optionalControl(value, parse, path) {
     if (value === undefined)
         return Object.freeze({ ok: true, value: undefined });
@@ -85,7 +144,9 @@ function parseOptionalCheckAggregation(value) {
     const data = exactKeys(value, ["checks", "mode", "unavailable", "notApplicable", "empty"]);
     if (data === undefined)
         return invalidControls("controls.checkAggregation");
-    const checks = data.checks === "all" ? "all" : parseClosedCheckIds(data.checks);
+    const checks = data.checks === "all" || data.checks === "effective"
+        ? data.checks
+        : parseClosedCheckIds(data.checks);
     if (checks === undefined)
         return invalidControls("controls.checkAggregation.checks");
     const mode = parseLiteral(data.mode, CHECK_AGGREGATION_MODES);
@@ -144,6 +205,9 @@ function parseAbortSignal(value) {
 function parseString(value) {
     return typeof value === "string" ? value : undefined;
 }
+function parseOutputDirectory(value) {
+    return typeof value === "string" && isOutputDirectory(value) ? value : undefined;
+}
 function invalidControls(path) {
     return invalidRunControl(path, "invalid-value");
 }

package/dist/esm/project-run/controls/validation.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"validation.mjs","sourceRoot":"","sources":["../../../../src/project-run/controls/validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotClosedArray } from \"../../data-boundary/closed-values.ts\";\nimport { isNonArrayRecord, isUnknownArray } from \"../../data-boundary/value-shapes.ts\";\nimport { parseOutputsOverride } from \"./outputs-override-validation.ts\";\nimport type { RunControlDiagnostic, RunControlValidationResult } from \"./validation-result.ts\";\nimport type { CheckAggregation, RunControls } from \"./contract.ts\";\n\nconst RUN_CONTROL_KEYS = [\"checkAggregation\", \"outputs\", \"flags\", \"projectRoot\", \"signal\"] as const;\nconst CHECK_AGGREGATION_MODES = [\"all\", \"any\"] as const;\nconst UNAVAILABLE_HANDLING = [\"propagate\", \"fail\", \"exclude\"] as const;\nconst NOT_APPLICABLE_HANDLING = [\"exclude\", \"pass\", \"fail\"] as const;\nconst EMPTY_AGGREGATION_RESULTS = [\"passed\", \"failed\", \"not-applicable\"] as const;\n\nexport function validateRunControls(value: unknown = {}): RunControlValidationResult<RunControls> {\n  try {\n    return validateRunControlsValue(value);\n  } catch {\n    return invalidControls(\"controls\");\n  }\n}\n\nfunction validateRunControlsValue(value: unknown): RunControlValidationResult<RunControls> {\n  const data = exactControlRecord(value);\n  if (!data.ok) return data;\n  const flags = parseFlags(data.value.flags);\n  if (!flags.ok) return flags;\n  const checkAggregation = parseOptionalCheckAggregation(data.value.checkAggregation);\n  if (!checkAggregation.ok) return checkAggregation;\n  const outputs = optionalControl(data.value.outputs, parseOutputsOverride, \"controls.outputs\");\n  if (!outputs.ok) return outputs;\n  const projectRoot = optionalControl(data.value.projectRoot, parseString, \"controls.projectRoot\");\n  if (!projectRoot.ok) return projectRoot;\n  const signal = optionalControl(data.value.signal, parseAbortSignal, \"controls.signal\");\n  if (!signal.ok) return signal;\n  return Object.freeze({\n    ok: true,\n    value: Object.freeze({\n      ...(checkAggregation.value === undefined ? {} : { checkAggregation: checkAggregation.value }),\n      ...(outputs.value === undefined ? {} : { outputs: outputs.value }),\n      flags: flags.value,\n      ...(projectRoot.value === undefined ? {} : { projectRoot: projectRoot.value }),\n      ...(signal.value === undefined ? {} : { signal: signal.value })\n    })\n  });\n}\n\nfunction exactControlRecord(\n  value: unknown\n): RunControlValidationResult<Readonly<Record<string, unknown>>> {\n  if (!isNonArrayRecord(value)) return invalidControls(\"controls\");\n  const unknownKey = Object.keys(value).find((key) => !isRunControlKey(key));\n  return unknownKey === undefined\n    ? Object.freeze({ ok: true, value })\n    : invalidRunControl(`controls.${unknownKey}`, \"unknown-key\");\n}\n\nfunction optionalControl<T>(\n  value: unknown,\n  parse: (candidate: unknown) => T | undefined,\n  path: string\n): RunControlValidationResult<T | undefined> {\n  if (value === undefined) return Object.freeze({ ok: true, value: undefined });\n  const parsed = parse(value);\n  return parsed === undefined ? invalidControls(path) : Object.freeze({ ok: true, value: parsed });\n}\n\nfunction parseFlags(value: unknown): RunControlValidationResult<readonly string[]> {\n  if (value === undefined) return Object.freeze({ ok: true, value: Object.freeze([]) });\n  if (!isUnknownArray(value)) return invalidControls(\"controls.flags\");\n  const flags: string[] = [];\n  const length = value.length;\n  for (let index = 0; index < length; index += 1) {\n    if (!Object.hasOwn(value, index)) return invalidControls(\"controls.flags\");\n    const flag = value[index];\n    if (typeof flag !== \"string\" || flag.length === 0) {\n      return invalidControls(\"controls.flags\");\n    }\n    flags.push(flag);\n  }\n  return Object.freeze({\n    ok: true,\n    value: Object.freeze([...new Set(flags)].sort())\n  });\n}\n\nfunction parseOptionalCheckAggregation(\n  value: unknown\n): RunControlValidationResult<CheckAggregation | undefined> {\n  if (value === undefined) return Object.freeze({ ok: true, value: undefined });\n  const data = exactKeys(value, [\"checks\", \"mode\", \"unavailable\", \"notApplicable\", \"empty\"]);\n  if (data === undefined) return invalidControls(\"controls.checkAggregation\");\n  const checks = data.checks === \"all\" ? \"all\" : parseClosedCheckIds(data.checks);\n  if (checks === undefined) return invalidControls(\"controls.checkAggregation.checks\");\n  const mode = parseLiteral(data.mode, CHECK_AGGREGATION_MODES);\n  const unavailable = parseLiteral(data.unavailable, UNAVAILABLE_HANDLING);\n  const notApplicable = parseLiteral(data.notApplicable, NOT_APPLICABLE_HANDLING);\n  const empty = parseLiteral(data.empty, EMPTY_AGGREGATION_RESULTS);\n  if (\n    mode === undefined ||\n    unavailable === undefined ||\n    notApplicable === undefined ||\n    empty === undefined\n  )\n    return invalidControls(\"controls.checkAggregation\");\n  return Object.freeze({\n    ok: true,\n    value: Object.freeze({\n      checks,\n      mode,\n      unavailable,\n      notApplicable,\n      empty\n    })\n  });\n}\n\nfunction parseClosedCheckIds(value: unknown): readonly string[] | undefined {\n  const values = snapshotClosedArray(value);\n  if (values === undefined) return undefined;\n  const checkIds: string[] = [];\n  for (const checkId of values) {\n    if (typeof checkId !== \"string\" || checkId.length === 0) return undefined;\n    checkIds.push(checkId);\n  }\n  return Object.freeze(checkIds);\n}\n\nfunction parseLiteral<Value extends string>(\n  value: unknown,\n  allowed: readonly Value[]\n): Value | undefined {\n  return typeof value === \"string\" ? allowed.find((option) => option === value) : undefined;\n}\n\nfunction isRunControlKey(value: string): boolean {\n  return RUN_CONTROL_KEYS.some((key) => key === value);\n}\n\nfunction exactKeys(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  if (!isNonArrayRecord(value)) return undefined;\n  return Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key))\n    ? value\n    : undefined;\n}\n\nfunction isAbortSignal(value: unknown): value is AbortSignal {\n  return (\n    isNonArrayRecord(value) &&\n    typeof value.aborted === \"boolean\" &&\n    typeof value.addEventListener === \"function\"\n  );\n}\n\nfunction parseAbortSignal(value: unknown): AbortSignal | undefined {\n  return isAbortSignal(value) ? value : undefined;\n}\n\nfunction parseString(value: unknown): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n\nfunction invalidControls(path: string): RunControlValidationResult<never> {\n  return invalidRunControl(path, \"invalid-value\");\n}\n\nfunction invalidRunControl(\n  path: string,\n  reason: RunControlDiagnostic[\"reason\"]\n): RunControlValidationResult<never> {\n  return Object.freeze({\n    ok: false,\n    error: Object.freeze({ kind: \"invalid-run-controls\", path, reason })\n  });\n}\n"]}
+{"version":3,"file":"validation.mjs","sourceRoot":"","sources":["../../../../src/project-run/controls/validation.ts"],"names":[],"mappings":"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","sourcesContent":["import { snapshotClosedArray } from \"../../data-boundary/closed-values.ts\";\nimport { isOutputDirectory } from \"../../project-definition/output-validation.ts\";\nimport { isNonArrayRecord, isUnknownArray } from \"../../data-boundary/value-shapes.ts\";\nimport { parseOutputsOverride } from \"./outputs-override-validation.ts\";\nimport type { RunControlDiagnostic, RunControlValidationResult } from \"./validation-result.ts\";\nimport type { CheckAggregation, DiagnosticLogFileNaming, RunControls } from \"./contract.ts\";\n\nconst RUN_CONTROL_KEYS = [\n  \"checkArtifactBaseDirectory\",\n  \"checkAggregation\",\n  \"diagnosticLogFileNaming\",\n  \"progressLogFile\",\n  \"outputs\",\n  \"flags\",\n  \"projectRoot\",\n  \"signal\"\n] as const;\nconst CHECK_AGGREGATION_MODES = [\"all\", \"any\"] as const;\nconst UNAVAILABLE_HANDLING = [\"propagate\", \"fail\", \"exclude\"] as const;\nconst NOT_APPLICABLE_HANDLING = [\"exclude\", \"pass\", \"fail\"] as const;\nconst EMPTY_AGGREGATION_RESULTS = [\"passed\", \"failed\", \"not-applicable\"] as const;\n\ninterface ParsedInvocationOutputTargets {\n  readonly diagnosticLogFileNaming: DiagnosticLogFileNaming | undefined;\n  readonly checkArtifactBaseDirectory: string | undefined;\n  readonly progressLogFile: string | undefined;\n}\n\ninterface ParsedRunControlFields extends ParsedInvocationOutputTargets {\n  readonly checkAggregation: CheckAggregation | undefined;\n  readonly flags: readonly string[];\n  readonly outputs: RunControls[\"outputs\"] | undefined;\n  readonly projectRoot: string | undefined;\n  readonly signal: AbortSignal | undefined;\n}\n\nexport function validateRunControls(value: unknown = {}): RunControlValidationResult<RunControls> {\n  try {\n    return validateRunControlsValue(value);\n  } catch {\n    return invalidControls(\"controls\");\n  }\n}\n\nfunction validateRunControlsValue(value: unknown): RunControlValidationResult<RunControls> {\n  const data = exactControlRecord(value);\n  if (!data.ok) return data;\n  const fields = parseRunControlFields(data.value);\n  if (!fields.ok) return fields;\n  return Object.freeze({ ok: true, value: runControlsFromFields(fields.value) });\n}\n\nfunction parseRunControlFields(\n  data: Readonly<Record<string, unknown>>\n): RunControlValidationResult<ParsedRunControlFields> {\n  const outputTargets = parseInvocationOutputTargets(data);\n  if (!outputTargets.ok) return outputTargets;\n  const flags = parseFlags(data.flags);\n  if (!flags.ok) return flags;\n  const checkAggregation = parseOptionalCheckAggregation(data.checkAggregation);\n  if (!checkAggregation.ok) return checkAggregation;\n  const outputs = parseOutputsOverride(data.outputs);\n  if (!outputs.ok) return outputs;\n  const projectRoot = optionalControl(data.projectRoot, parseString, \"controls.projectRoot\");\n  if (!projectRoot.ok) return projectRoot;\n  const signal = optionalControl(data.signal, parseAbortSignal, \"controls.signal\");\n  if (!signal.ok) return signal;\n  return Object.freeze({\n    ok: true,\n    value: Object.freeze({\n      ...outputTargets.value,\n      checkAggregation: checkAggregation.value,\n      flags: flags.value,\n      outputs: outputs.value,\n      projectRoot: projectRoot.value,\n      signal: signal.value\n    })\n  });\n}\n\n/** Parse caller-owned invocation output targets separately from Run execution controls. */\nfunction parseInvocationOutputTargets(\n  data: Readonly<Record<string, unknown>>\n): RunControlValidationResult<ParsedInvocationOutputTargets> {\n  const diagnosticLogFileNaming = optionalControl(\n    data.diagnosticLogFileNaming,\n    parseDiagnosticLogFileNaming,\n    \"controls.diagnosticLogFileNaming\"\n  );\n  if (!diagnosticLogFileNaming.ok) return diagnosticLogFileNaming;\n  const checkArtifactBaseDirectory = optionalControl(\n    data.checkArtifactBaseDirectory,\n    parseOutputDirectory,\n    \"controls.checkArtifactBaseDirectory\"\n  );\n  if (!checkArtifactBaseDirectory.ok) return checkArtifactBaseDirectory;\n  const progressLogFile = optionalControl(\n    data.progressLogFile,\n    parseOutputDirectory,\n    \"controls.progressLogFile\"\n  );\n  if (!progressLogFile.ok) return progressLogFile;\n  return Object.freeze({\n    ok: true,\n    value: Object.freeze({\n      diagnosticLogFileNaming: diagnosticLogFileNaming.value,\n      checkArtifactBaseDirectory: checkArtifactBaseDirectory.value,\n      progressLogFile: progressLogFile.value\n    })\n  });\n}\n\nfunction runControlsFromFields(fields: ParsedRunControlFields): RunControls {\n  return Object.freeze({\n    ...(fields.diagnosticLogFileNaming === undefined\n      ? {}\n      : { diagnosticLogFileNaming: fields.diagnosticLogFileNaming }),\n    ...(fields.checkArtifactBaseDirectory === undefined\n      ? {}\n      : { checkArtifactBaseDirectory: fields.checkArtifactBaseDirectory }),\n    ...(fields.checkAggregation === undefined ? {} : { checkAggregation: fields.checkAggregation }),\n    ...(fields.outputs === undefined ? {} : { outputs: fields.outputs }),\n    ...(fields.progressLogFile === undefined ? {} : { progressLogFile: fields.progressLogFile }),\n    flags: fields.flags,\n    ...(fields.projectRoot === undefined ? {} : { projectRoot: fields.projectRoot }),\n    ...(fields.signal === undefined ? {} : { signal: fields.signal })\n  });\n}\n\nfunction exactControlRecord(\n  value: unknown\n): RunControlValidationResult<Readonly<Record<string, unknown>>> {\n  if (!isNonArrayRecord(value)) return invalidControls(\"controls\");\n  const unknownKey = Object.keys(value).find((key) => !isRunControlKey(key));\n  return unknownKey === undefined\n    ? Object.freeze({ ok: true, value })\n    : invalidRunControl(`controls.${unknownKey}`, \"unknown-key\");\n}\n\nfunction parseDiagnosticLogFileNaming(value: unknown): DiagnosticLogFileNaming | undefined {\n  return value === \"unique\" || value === \"channel\" ? value : undefined;\n}\n\nfunction optionalControl<T>(\n  value: unknown,\n  parse: (candidate: unknown) => T | undefined,\n  path: string\n): RunControlValidationResult<T | undefined> {\n  if (value === undefined) return Object.freeze({ ok: true, value: undefined });\n  const parsed = parse(value);\n  return parsed === undefined ? invalidControls(path) : Object.freeze({ ok: true, value: parsed });\n}\n\nfunction parseFlags(value: unknown): RunControlValidationResult<readonly string[]> {\n  if (value === undefined) return Object.freeze({ ok: true, value: Object.freeze([]) });\n  if (!isUnknownArray(value)) return invalidControls(\"controls.flags\");\n  const flags: string[] = [];\n  const length = value.length;\n  for (let index = 0; index < length; index += 1) {\n    if (!Object.hasOwn(value, index)) return invalidControls(\"controls.flags\");\n    const flag = value[index];\n    if (typeof flag !== \"string\" || flag.length === 0) {\n      return invalidControls(\"controls.flags\");\n    }\n    flags.push(flag);\n  }\n  return Object.freeze({\n    ok: true,\n    value: Object.freeze([...new Set(flags)].sort())\n  });\n}\n\nfunction parseOptionalCheckAggregation(\n  value: unknown\n): RunControlValidationResult<CheckAggregation | undefined> {\n  if (value === undefined) return Object.freeze({ ok: true, value: undefined });\n  const data = exactKeys(value, [\"checks\", \"mode\", \"unavailable\", \"notApplicable\", \"empty\"]);\n  if (data === undefined) return invalidControls(\"controls.checkAggregation\");\n  const checks =\n    data.checks === \"all\" || data.checks === \"effective\"\n      ? data.checks\n      : parseClosedCheckIds(data.checks);\n  if (checks === undefined) return invalidControls(\"controls.checkAggregation.checks\");\n  const mode = parseLiteral(data.mode, CHECK_AGGREGATION_MODES);\n  const unavailable = parseLiteral(data.unavailable, UNAVAILABLE_HANDLING);\n  const notApplicable = parseLiteral(data.notApplicable, NOT_APPLICABLE_HANDLING);\n  const empty = parseLiteral(data.empty, EMPTY_AGGREGATION_RESULTS);\n  if (\n    mode === undefined ||\n    unavailable === undefined ||\n    notApplicable === undefined ||\n    empty === undefined\n  )\n    return invalidControls(\"controls.checkAggregation\");\n  return Object.freeze({\n    ok: true,\n    value: Object.freeze({\n      checks,\n      mode,\n      unavailable,\n      notApplicable,\n      empty\n    })\n  });\n}\n\nfunction parseClosedCheckIds(value: unknown): readonly string[] | undefined {\n  const values = snapshotClosedArray(value);\n  if (values === undefined) return undefined;\n  const checkIds: string[] = [];\n  for (const checkId of values) {\n    if (typeof checkId !== \"string\" || checkId.length === 0) return undefined;\n    checkIds.push(checkId);\n  }\n  return Object.freeze(checkIds);\n}\n\nfunction parseLiteral<Value extends string>(\n  value: unknown,\n  allowed: readonly Value[]\n): Value | undefined {\n  return typeof value === \"string\" ? allowed.find((option) => option === value) : undefined;\n}\n\nfunction isRunControlKey(value: string): boolean {\n  return RUN_CONTROL_KEYS.some((key) => key === value);\n}\n\nfunction exactKeys(\n  value: unknown,\n  keys: readonly string[]\n): Readonly<Record<string, unknown>> | undefined {\n  if (!isNonArrayRecord(value)) return undefined;\n  return Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key))\n    ? value\n    : undefined;\n}\n\nfunction isAbortSignal(value: unknown): value is AbortSignal {\n  return (\n    isNonArrayRecord(value) &&\n    typeof value.aborted === \"boolean\" &&\n    typeof value.addEventListener === \"function\"\n  );\n}\n\nfunction parseAbortSignal(value: unknown): AbortSignal | undefined {\n  return isAbortSignal(value) ? value : undefined;\n}\n\nfunction parseString(value: unknown): string | undefined {\n  return typeof value === \"string\" ? value : undefined;\n}\n\nfunction parseOutputDirectory(value: unknown): string | undefined {\n  return typeof value === \"string\" && isOutputDirectory(value) ? value : undefined;\n}\n\nfunction invalidControls(path: string): RunControlValidationResult<never> {\n  return invalidRunControl(path, \"invalid-value\");\n}\n\nfunction invalidRunControl(\n  path: string,\n  reason: RunControlDiagnostic[\"reason\"]\n): RunControlValidationResult<never> {\n  return Object.freeze({\n    ok: false,\n    error: Object.freeze({ kind: \"invalid-run-controls\", path, reason })\n  });\n}\n"]}