@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/project-run/{completion.mjs → completion/completion.mjs}

@@ -1,9 +1,9 @@
-import { resolve } from "node:path";
-import { failedOutput } from "./output-status.mjs";
+import { failedOutput } from "../outputs/status.mjs";
+import { resolveFinalRunResult } from "./result-resolver.mjs";
 import { publishMachineOutput } from "./machine-publication.mjs";
-import { outputFailure } from "./result.mjs";
-import { diagnosticTags } from "./diagnostic-logging/logger.mjs";
-import { createPublicationModelV4 } from "../machine-output/v4/publication-model.mjs";
+import { outputFailure } from "../result.mjs";
+import { DIAGNOSTIC_CHANNELS, diagnosticTags } from "../diagnostic-logging/logger.mjs";
+import { createPublicationModelV4 } from "../../machine-output/v4/publication-model.mjs";
 export function completeInvocation(invocation, core) {
     const facts = runFacts(core);
     if (invocation.outputConfiguration.machinePublication.enabled) {
@@ -14,7 +14,7 @@ export function completeInvocation(invocation, core) {
             configuration: invocation.outputConfiguration.machinePublication,
             statuses: invocation.outputs,
             model,
-            directory: resolve(invocation.projectRoot, invocation.outputConfiguration.machinePublication.directory)
+            directory: invocation.paths.machinePublicationDirectory
         });
         if (!published)
             return failure(invocation, facts);
@@ -73,7 +73,7 @@ function isExecutionResult(value) {
 /** Closes diagnostic logging and applies final output priority to a non-configuration candidate. */
 export function finalizeInvocation(invocation, candidate) {
     const preCloseOutputs = invocation.outputs.value();
-    invocation.diagnosticLogger.observe({
+    invocation.diagnosticLogging.core.observe({
         event: "run.terminal-before-log-close",
         tags: diagnosticTags("RUN", "TERMINAL", terminalStatusTag(candidate)),
         details: {
@@ -82,33 +82,36 @@ export function finalizeInvocation(invocation, candidate) {
             outputs: preCloseOutputDetails(preCloseOutputs)
         }
     });
-    const diagnosticLoggingStatus = invocation.diagnosticLogger.close();
-    if (diagnosticLoggingStatus === "failed")
-        invocation.outputs.failed("diagnosticLogging");
-    if (diagnosticLoggingStatus === "succeeded")
-        invocation.outputs.succeeded("diagnosticLogging");
-    const outputs = invocation.outputs.value();
-    switch (candidate.kind) {
-        case "completed": {
-            const output = failedOutput(outputs);
-            return output === undefined
-                ? Object.freeze({ ...candidate, outputs })
-                : outputFailure(candidate.declarativeFingerprint, candidate.definitionWarnings, outputs, output, finalSnapshotFacts(candidate));
-        }
-        case "output": {
-            const output = failedOutput(outputs);
-            if (output === undefined)
-                throw new Error("Run output failed without a failed status");
-            return outputFailure(candidate.declarativeFingerprint, candidate.definitionWarnings, outputs, output, finalSnapshotFacts(candidate));
-        }
-        case "planning":
-        case "cancelled":
-        case "execution":
-            return Object.freeze({ ...candidate, outputs });
+    const diagnosticLoggingStatuses = invocation.diagnosticLogging.close();
+    for (const channel of DIAGNOSTIC_CHANNELS) {
+        const status = diagnosticLoggingStatuses[channel];
+        if (status === "failed")
+            invocation.outputs.failedDiagnosticChannel(channel);
+        if (status === "succeeded")
+            invocation.outputs.succeededDiagnosticChannel(channel);
+    }
+    invocation.progressRendering.close();
+    return resolveFinalRunResult(candidate, invocation.outputs.value());
+}
+/** Closes invocation-owned writers after aggregation rejects without fabricating a terminal Run result. */
+export function closeAggregationFailure(invocation) {
+    try {
+        invocation.diagnosticLogging.close();
+    }
+    catch {
+        // Cleanup must not replace the callback error returned to the caller.
+    }
+    try {
+        invocation.progressRendering.close();
+    }
+    catch {
+        // Cleanup must not replace the callback error returned to the caller.
     }
 }
 function terminalStatusTag(candidate) {
-    if ("aggregate" in candidate && candidate.aggregate !== null)
+    if (candidate.kind === "output")
+        return "OUTPUT";
+    if ("aggregate" in candidate)
         return candidate.aggregate.toUpperCase();
     if (candidate.kind === "cancelled")
         return "CANCELLED";
@@ -162,12 +165,4 @@ function nonPassedFact(check) {
         status: check.outcome.status
     });
 }
-function finalSnapshotFacts(candidate) {
-    return Object.freeze({
-        aggregate: candidate.aggregate,
-        checkDurations: candidate.checkDurations,
-        checkMessages: candidate.checkMessages,
-        snapshot: candidate.snapshot
-    });
-}
 //# sourceMappingURL=completion.mjs.map

package/dist/esm/project-run/completion/completion.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"completion.mjs","sourceRoot":"","sources":["../../../../src/project-run/completion/completion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EACL,aAAa,EAKd,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEtF,OAAO,EACL,wBAAwB,EAEzB,MAAM,8CAA8C,CAAC;AAkBtD,MAAM,UAAU,kBAAkB,CAChC,UAAsB,EACtB,IAAmB;IAEnB,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,UAAU,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,OAAO,EAAE,CAAC;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,iBAAiB,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAC3C,MAAM,SAAS,GAAG,oBAAoB,CAAC;YACrC,aAAa,EAAE,UAAU,CAAC,mBAAmB,CAAC,kBAAkB;YAChE,QAAQ,EAAE,UAAU,CAAC,OAAO;YAC5B,KAAK;YACL,SAAS,EAAE,UAAU,CAAC,KAAK,CAAC,2BAA2B;SACxD,CAAC,CAAC;QACH,IAAI,CAAC,SAAS;YAAE,OAAO,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IACD,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,OAAO,MAAM,KAAK,SAAS;QACzB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC;YACZ,IAAI,EAAE,WAAW;YACjB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;YACzD,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;YACjD,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE;YACnC,GAAG,KAAK;SACT,CAAC;QACJ,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC;AACD,SAAS,OAAO,CAAC,UAAsB,EAAE,KAAqB;IAC5D,MAAM,MAAM,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;IACxD,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACvF,OAAO,aAAa,CAClB,UAAU,CAAC,sBAAsB,EACjC,UAAU,CAAC,kBAAkB,EAC7B,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAC1B,MAAM,EACN,KAAK,CACN,CAAC;AACJ,CAAC;AACD,SAAS,QAAQ,CAAC,IAAmB;IACnC,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,aAAa,EAAE,IAAI,CAAC,aAAa;QACjC,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;AACL,CAAC;AACD,SAAS,WAAW,CAClB,UAAsB,EACtB,QAAmC;IAEnC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,YAAY,KAAK,IAAI;YAClC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,OAAO,wBAAwB,CAAC;YAC9B,UAAU,EAAE;gBACV,YAAY,EAAE,UAAU,CAAC,YAAY;gBACrC,WAAW,EAAE,GAAG;gBAChB,SAAS,EAAE,UAAU,CAAC,YAAY;aACnC;YACD,QAAQ;SACT,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,WAAW;YACjB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;YACzD,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;YACjD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,CAAC;YAC/D,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE;SACpC,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AACD,SAAS,iBAAiB,CACxB,KAEsE;IAEtE,OAAO,MAAM,IAAI,KAAK,CAAC;AACzB,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,kBAAkB,CAChC,UAAsB,EACtB,SAAoC;IAEpC,MAAM,eAAe,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACnD,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QACxC,KAAK,EAAE,+BAA+B;QACtC,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,iBAAiB,CAAC,SAAS,CAAC,CAAC;QACrE,OAAO,EAAE;YACP,GAAG,YAAY,CAAC,SAAS,CAAC;YAC1B,iBAAiB,EAAE,yBAAyB;YAC5C,OAAO,EAAE,qBAAqB,CAAC,eAAe,CAAC;SAChD;KACF,CAAC,CAAC;IACH,MAAM,yBAAyB,GAAG,UAAU,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;IACvE,KAAK,MAAM,OAAO,IAAI,mBAAmB,EAAE,CAAC;QAC1C,MAAM,MAAM,GAAG,yBAAyB,CAAC,OAAO,CAAC,CAAC;QAClD,IAAI,MAAM,KAAK,QAAQ;YAAE,UAAU,CAAC,OAAO,CAAC,uBAAuB,CAAC,OAAO,CAAC,CAAC;QAC7E,IAAI,MAAM,KAAK,WAAW;YAAE,UAAU,CAAC,OAAO,CAAC,0BAA0B,CAAC,OAAO,CAAC,CAAC;IACrF,CAAC;IACD,UAAU,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;IACrC,OAAO,qBAAqB,CAAC,SAAS,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,uBAAuB,CAAC,UAAsB;IAC5D,IAAI,CAAC;QACH,UAAU,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;IACD,IAAI,CAAC;QACH,UAAU,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;IACxE,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,SAAoC;IAC7D,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACjD,IAAI,WAAW,IAAI,SAAS;QAAE,OAAO,SAAS,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC;IACvE,IAAI,SAAS,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IACvD,OAAO,SAAS,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;AACtC,CAAC;AAED,SAAS,qBAAqB,CAAC,OAAmD;IAIhF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;QAC9C,iBAAiB,EAAE,OAAO,CAAC,iBAAiB;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,SAAoC;IAexD,IAAI,CAAC,CAAC,UAAU,IAAI,SAAS,CAAC,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,SAAS,EAAE,IAAI;YACf,aAAa,EAAE,SAAS,CAAC,IAAI;YAC7B,MAAM,EAAE,IAAI;YACZ,SAAS,EAAE,EAAE;SACd,CAAC,CAAC;IACL,CAAC;IACD,MAAM,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACtD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,WAAW,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI;QAChE,aAAa,EAAE,SAAS,CAAC,IAAI;QAC7B,GAAG,OAAO;KACX,CAAC,CAAC;AACL,CAAC;AAED,SAAS,iBAAiB,CAAC,QAAsB;IAQ/C,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,CAAC;IAC1E,MAAM,SAAS,GAA0E,EAAE,CAAC;IAC5F,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QAClC,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;KACpC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,KAAgB;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,gBAAgB,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;AAC5F,CAAC;AAED,SAAS,aAAa,CACpB,KAAgB;IAIhB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,IAAI,IAAI,CAAC;QACjF,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM;KAC7B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { failedOutput } from \"../outputs/status.ts\";\nimport { resolveFinalRunResult } from \"./result-resolver.ts\";\nimport { publishMachineOutput } from \"./machine-publication.ts\";\nimport {\n  outputFailure,\n  type CheckDuration,\n  type CheckRunMessage,\n  type NonConfigurationRunResult,\n  type RunResultFacts\n} from \"../result.ts\";\nimport type { CheckAggregate } from \"../controls/contract.ts\";\nimport { DIAGNOSTIC_CHANNELS, diagnosticTags } from \"../diagnostic-logging/logger.ts\";\nimport type { Invocation } from \"../invocation/run.ts\";\nimport {\n  createPublicationModelV4,\n  type TrustedPublicationModelV4\n} from \"../../machine-output/v4/publication-model.ts\";\nimport type { CoreCheck, CoreSnapshot } from \"../../check-settlement/facts.ts\";\n\ntype OutcomeCounts = {\n  readonly failed: number;\n  readonly notApplicable: number;\n  readonly passed: number;\n  readonly unavailable: number;\n};\n\n/** Settled Check facts consumed by completion and output publication. */\nexport type CoreExecution = Readonly<{\n  readonly aggregate: CheckAggregate;\n  readonly checkDurations: readonly CheckDuration[];\n  readonly checkMessages: readonly CheckRunMessage[];\n  readonly snapshot: CoreSnapshot;\n}>;\n\nexport function completeInvocation(\n  invocation: Invocation,\n  core: CoreExecution\n): NonConfigurationRunResult {\n  const facts = runFacts(core);\n  if (invocation.outputConfiguration.machinePublication.enabled) {\n    const model = createModel(invocation, core.snapshot);\n    if (isExecutionResult(model)) return model;\n    const published = publishMachineOutput({\n      configuration: invocation.outputConfiguration.machinePublication,\n      statuses: invocation.outputs,\n      model,\n      directory: invocation.paths.machinePublicationDirectory\n    });\n    if (!published) return failure(invocation, facts);\n  }\n  const output = failedOutput(invocation.outputs.value());\n  return output === undefined\n    ? Object.freeze({\n        kind: \"completed\",\n        declarativeFingerprint: invocation.declarativeFingerprint,\n        definitionWarnings: invocation.definitionWarnings,\n        outputs: invocation.outputs.value(),\n        ...facts\n      })\n    : failure(invocation, facts);\n}\nfunction failure(invocation: Invocation, facts: RunResultFacts): ReturnType<typeof outputFailure> {\n  const output = failedOutput(invocation.outputs.value());\n  if (output === undefined) throw new Error(\"Run output failed without a failed status\");\n  return outputFailure(\n    invocation.declarativeFingerprint,\n    invocation.definitionWarnings,\n    invocation.outputs.value(),\n    output,\n    facts\n  );\n}\nfunction runFacts(core: CoreExecution): RunResultFacts {\n  return Object.freeze({\n    aggregate: core.aggregate,\n    checkDurations: core.checkDurations,\n    checkMessages: core.checkMessages,\n    snapshot: core.snapshot\n  });\n}\nfunction createModel(\n  invocation: Invocation,\n  snapshot: CoreExecution[\"snapshot\"]\n): TrustedPublicationModelV4 | Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }> {\n  try {\n    if (invocation.startedAtUtc === null)\n      throw new Error(\"Machine publication requires an invocation timestamp\");\n    return createPublicationModelV4({\n      invocation: {\n        invocationId: invocation.invocationId,\n        projectRoot: \".\",\n        timestamp: invocation.startedAtUtc\n      },\n      snapshot\n    });\n  } catch {\n    return Object.freeze({\n      kind: \"execution\",\n      declarativeFingerprint: invocation.declarativeFingerprint,\n      definitionWarnings: invocation.definitionWarnings,\n      diagnostic: Object.freeze({ code: \"publication-model-failed\" }),\n      outputs: invocation.outputs.value()\n    });\n  }\n}\nfunction isExecutionResult(\n  value:\n    | TrustedPublicationModelV4\n    | Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }>\n): value is Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }> {\n  return \"kind\" in value;\n}\n\n/** Closes diagnostic logging and applies final output priority to a non-configuration candidate. */\nexport function finalizeInvocation(\n  invocation: Invocation,\n  candidate: NonConfigurationRunResult\n): NonConfigurationRunResult {\n  const preCloseOutputs = invocation.outputs.value();\n  invocation.diagnosticLogging.core.observe({\n    event: \"run.terminal-before-log-close\",\n    tags: diagnosticTags(\"RUN\", \"TERMINAL\", terminalStatusTag(candidate)),\n    details: {\n      ...closingFacts(candidate),\n      diagnosticLogging: \"close-not-yet-confirmed\",\n      outputs: preCloseOutputDetails(preCloseOutputs)\n    }\n  });\n  const diagnosticLoggingStatuses = invocation.diagnosticLogging.close();\n  for (const channel of DIAGNOSTIC_CHANNELS) {\n    const status = diagnosticLoggingStatuses[channel];\n    if (status === \"failed\") invocation.outputs.failedDiagnosticChannel(channel);\n    if (status === \"succeeded\") invocation.outputs.succeededDiagnosticChannel(channel);\n  }\n  invocation.progressRendering.close();\n  return resolveFinalRunResult(candidate, invocation.outputs.value());\n}\n\n/** Closes invocation-owned writers after aggregation rejects without fabricating a terminal Run result. */\nexport function closeAggregationFailure(invocation: Invocation): void {\n  try {\n    invocation.diagnosticLogging.close();\n  } catch {\n    // Cleanup must not replace the callback error returned to the caller.\n  }\n  try {\n    invocation.progressRendering.close();\n  } catch {\n    // Cleanup must not replace the callback error returned to the caller.\n  }\n}\n\nfunction terminalStatusTag(candidate: NonConfigurationRunResult): string {\n  if (candidate.kind === \"output\") return \"OUTPUT\";\n  if (\"aggregate\" in candidate) return candidate.aggregate.toUpperCase();\n  if (candidate.kind === \"cancelled\") return \"CANCELLED\";\n  return candidate.kind.toUpperCase();\n}\n\nfunction preCloseOutputDetails(outputs: ReturnType<Invocation[\"outputs\"][\"value\"]>): Readonly<{\n  readonly machinePublication: (typeof outputs)[\"machinePublication\"];\n  readonly progressRendering: (typeof outputs)[\"progressRendering\"];\n}> {\n  return Object.freeze({\n    machinePublication: outputs.machinePublication,\n    progressRendering: outputs.progressRendering\n  });\n}\n\nfunction closingFacts(candidate: NonConfigurationRunResult): Readonly<{\n  readonly aggregate: CheckAggregate | null;\n  readonly candidateKind: NonConfigurationRunResult[\"kind\"];\n  readonly counts: Readonly<{\n    readonly failed: number;\n    readonly notApplicable: number;\n    readonly passed: number;\n    readonly unavailable: number;\n  }> | null;\n  readonly nonPassed: readonly Readonly<{\n    readonly checkId: string;\n    readonly reason: unknown;\n    readonly status: string;\n  }>[];\n}> {\n  if (!(\"snapshot\" in candidate)) {\n    return Object.freeze({\n      aggregate: null,\n      candidateKind: candidate.kind,\n      counts: null,\n      nonPassed: []\n    });\n  }\n  const summary = summarizeSnapshot(candidate.snapshot);\n  return Object.freeze({\n    aggregate: \"aggregate\" in candidate ? candidate.aggregate : null,\n    candidateKind: candidate.kind,\n    ...summary\n  });\n}\n\nfunction summarizeSnapshot(snapshot: CoreSnapshot): Readonly<{\n  readonly counts: OutcomeCounts;\n  readonly nonPassed: readonly Readonly<{\n    readonly checkId: string;\n    readonly reason: unknown;\n    readonly status: string;\n  }>[];\n}> {\n  const counts = { failed: 0, notApplicable: 0, passed: 0, unavailable: 0 };\n  const nonPassed: Array<Readonly<{ checkId: string; reason: unknown; status: string }>> = [];\n  for (const check of snapshot.checks) {\n    counts[statusCountKey(check)] += 1;\n    const fact = nonPassedFact(check);\n    if (fact !== undefined) nonPassed.push(fact);\n  }\n  return Object.freeze({\n    counts: Object.freeze(counts),\n    nonPassed: Object.freeze(nonPassed)\n  });\n}\n\nfunction statusCountKey(check: CoreCheck): keyof OutcomeCounts {\n  return check.outcome.status === \"not-applicable\" ? \"notApplicable\" : check.outcome.status;\n}\n\nfunction nonPassedFact(\n  check: CoreCheck\n):\n  | Readonly<{ readonly checkId: string; readonly reason: unknown; readonly status: string }>\n  | undefined {\n  if (check.outcome.status === \"passed\") return undefined;\n  return Object.freeze({\n    checkId: check.checkId,\n    reason: check.outcome.status === \"failed\" ? null : (check.outcome.reason ?? null),\n    status: check.outcome.status\n  });\n}\n"]}

package/dist/esm/project-run/{machine-publication.mjs → completion/machine-publication.mjs}

@@ -1,4 +1,4 @@
-import { publishScanV4 } from "../machine-output/v4/publish.mjs";
+import { publishScanV4 } from "../../machine-output/v4/publish.mjs";
 /** Publishes an already-trusted v4 model as the Run-owned machine output. */
 export function publishMachineOutput(input) {
     if (!input.configuration.enabled)

package/dist/esm/project-run/completion/machine-publication.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"machine-publication.mjs","sourceRoot":"","sources":["../../../../src/project-run/completion/machine-publication.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEnE,6EAA6E;AAC7E,MAAM,UAAU,oBAAoB,CAClC,KAKE;IAEF,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC9C,IAAI,CAAC;QACH,aAAa,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QACpE,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC/C,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;QAC5C,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC","sourcesContent":["import type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\nimport type { TrustedPublicationModelV4 } from \"../../machine-output/v4/publication-model.ts\";\nimport { publishScanV4 } from \"../../machine-output/v4/publish.ts\";\nimport type { OutputStatuses } from \"../outputs/status.ts\";\n/** Publishes an already-trusted v4 model as the Run-owned machine output. */\nexport function publishMachineOutput(\n  input: Readonly<{\n    readonly configuration: ProjectOutputs[\"machinePublication\"];\n    readonly statuses: OutputStatuses;\n    readonly model: TrustedPublicationModelV4;\n    readonly directory: string;\n  }>\n): boolean {\n  if (!input.configuration.enabled) return true;\n  try {\n    publishScanV4({ artifactDir: input.directory, model: input.model });\n    input.statuses.succeeded(\"machinePublication\");\n    return true;\n  } catch {\n    input.statuses.failed(\"machinePublication\");\n    return false;\n  }\n}\n"]}

package/dist/esm/project-run/completion/result-resolver.mjs

@@ -0,0 +1,36 @@
+import { failedOutput } from "../outputs/status.mjs";
+import { outputFailure } from "../result.mjs";
+/** Resolves a terminal candidate against the output statuses after all owners have closed. */
+export function resolveFinalRunResult(candidate, outputs) {
+    switch (candidate.kind) {
+        case "completed":
+            return resolveCompletedCandidate(candidate, outputs);
+        case "output":
+            return resolveExistingOutputCandidate(candidate, outputs);
+        case "planning":
+        case "cancelled":
+        case "execution":
+            return Object.freeze({ ...candidate, outputs });
+    }
+}
+function resolveCompletedCandidate(candidate, outputs) {
+    const output = failedOutput(outputs);
+    if (output === undefined)
+        return Object.freeze({ ...candidate, outputs });
+    return outputFailure(candidate.declarativeFingerprint, candidate.definitionWarnings, outputs, output, finalSnapshotFacts(candidate));
+}
+function resolveExistingOutputCandidate(candidate, outputs) {
+    const output = failedOutput(outputs);
+    if (output === undefined)
+        throw new Error("Run output failed without a failed status");
+    return outputFailure(candidate.declarativeFingerprint, candidate.definitionWarnings, outputs, output, finalSnapshotFacts(candidate));
+}
+function finalSnapshotFacts(candidate) {
+    return Object.freeze({
+        aggregate: candidate.aggregate,
+        checkDurations: candidate.checkDurations,
+        checkMessages: candidate.checkMessages,
+        snapshot: candidate.snapshot
+    });
+}
+//# sourceMappingURL=result-resolver.mjs.map

package/dist/esm/project-run/completion/result-resolver.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"result-resolver.mjs","sourceRoot":"","sources":["../../../../src/project-run/completion/result-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA0B,MAAM,sBAAsB,CAAC;AAC5E,OAAO,EAAE,aAAa,EAAuD,MAAM,cAAc,CAAC;AAElG,8FAA8F;AAC9F,MAAM,UAAU,qBAAqB,CACnC,SAAoC,EACpC,OAA0B;IAE1B,QAAQ,SAAS,CAAC,IAAI,EAAE,CAAC;QACvB,KAAK,WAAW;YACd,OAAO,yBAAyB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QACvD,KAAK,QAAQ;YACX,OAAO,8BAA8B,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5D,KAAK,UAAU,CAAC;QAChB,KAAK,WAAW,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC;AACH,CAAC;AAED,SAAS,yBAAyB,CAChC,SAA6E,EAC7E,OAA0B;IAE1B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,SAAS,EAAE,OAAO,EAAE,CAAC,CAAC;IAC1E,OAAO,aAAa,CAClB,SAAS,CAAC,sBAAsB,EAChC,SAAS,CAAC,kBAAkB,EAC5B,OAAO,EACP,MAAM,EACN,kBAAkB,CAAC,SAAS,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,8BAA8B,CACrC,SAA0E,EAC1E,OAA0B;IAE1B,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,MAAM,KAAK,SAAS;QAAE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACvF,OAAO,aAAa,CAClB,SAAS,CAAC,sBAAsB,EAChC,SAAS,CAAC,kBAAkB,EAC5B,OAAO,EACP,MAAM,EACN,kBAAkB,CAAC,SAAS,CAAC,CAC9B,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CACzB,SAA6D;IAE7D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,cAAc,EAAE,SAAS,CAAC,cAAc;QACxC,aAAa,EAAE,SAAS,CAAC,aAAa;QACtC,QAAQ,EAAE,SAAS,CAAC,QAAQ;KAC7B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { failedOutput, type RunOutputStatuses } from \"../outputs/status.ts\";\nimport { outputFailure, type NonConfigurationRunResult, type RunResultFacts } from \"../result.ts\";\n\n/** Resolves a terminal candidate against the output statuses after all owners have closed. */\nexport function resolveFinalRunResult(\n  candidate: NonConfigurationRunResult,\n  outputs: RunOutputStatuses\n): NonConfigurationRunResult {\n  switch (candidate.kind) {\n    case \"completed\":\n      return resolveCompletedCandidate(candidate, outputs);\n    case \"output\":\n      return resolveExistingOutputCandidate(candidate, outputs);\n    case \"planning\":\n    case \"cancelled\":\n    case \"execution\":\n      return Object.freeze({ ...candidate, outputs });\n  }\n}\n\nfunction resolveCompletedCandidate(\n  candidate: Extract<NonConfigurationRunResult, { readonly kind: \"completed\" }>,\n  outputs: RunOutputStatuses\n): NonConfigurationRunResult {\n  const output = failedOutput(outputs);\n  if (output === undefined) return Object.freeze({ ...candidate, outputs });\n  return outputFailure(\n    candidate.declarativeFingerprint,\n    candidate.definitionWarnings,\n    outputs,\n    output,\n    finalSnapshotFacts(candidate)\n  );\n}\n\nfunction resolveExistingOutputCandidate(\n  candidate: Extract<NonConfigurationRunResult, { readonly kind: \"output\" }>,\n  outputs: RunOutputStatuses\n): NonConfigurationRunResult {\n  const output = failedOutput(outputs);\n  if (output === undefined) throw new Error(\"Run output failed without a failed status\");\n  return outputFailure(\n    candidate.declarativeFingerprint,\n    candidate.definitionWarnings,\n    outputs,\n    output,\n    finalSnapshotFacts(candidate)\n  );\n}\n\nfunction finalSnapshotFacts(\n  candidate: Extract<NonConfigurationRunResult, RunResultFacts>\n): RunResultFacts {\n  return Object.freeze({\n    aggregate: candidate.aggregate,\n    checkDurations: candidate.checkDurations,\n    checkMessages: candidate.checkMessages,\n    snapshot: candidate.snapshot\n  });\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"contract.mjs","sourceRoot":"","sources":["../../../../src/project-run/controls/contract.ts"],"names":[],"mappings":"","sourcesContent":["import type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\n/** 单次 run 调用的闭合上下文与 output override；Project Definition 保持为 authored input。 */\nexport interface RunControls {\n  readonly checkAggregation?: CheckAggregation;\n  /** 仅为本次调用覆盖 Run-owned outputs。 */\n  readonly outputs?: Partial<{\n    machinePublication: Partial<ProjectOutputs[\"machinePublication\"]>;\n    progressRendering: Partial<ProjectOutputs[\"progressRendering\"]>;\n    diagnosticLogging: Partial<ProjectOutputs[\"diagnosticLogging\"]>;\n  }>;\n  readonly flags?: readonly string[];\n  readonly projectRoot?: string;\n  readonly signal?: AbortSignal;\n}\n/** 将选定 Check statuses 折叠为 invocation aggregate 的规则。 */\nexport interface CheckAggregation {\n  readonly checks: \"all\" | readonly string[];\n  readonly mode: \"all\" | \"any\";\n  readonly unavailable: \"propagate\" | \"fail\" | \"exclude\";\n  readonly notApplicable: \"exclude\" | \"pass\" | \"fail\";\n  readonly empty: \"passed\" | \"failed\" | \"not-applicable\";\n}\n/** `CheckAggregation` 计算出的 invocation 级结果。 */\nexport type CheckAggregate = \"passed\" | \"failed\" | \"not-applicable\" | \"unavailable\";\n"]}
+{"version":3,"file":"contract.mjs","sourceRoot":"","sources":["../../../../src/project-run/controls/contract.ts"],"names":[],"mappings":"","sourcesContent":["import type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\nimport type { CoreCheck } from \"../../check-settlement/facts.ts\";\n/**\n * `run(definition, controls?)` 的第二个参数，只指定这一次怎么运行。\n *\n * root、flags、signal、Check 产物与日志目标以及 aggregation 属于本次调用；`outputs` 只逐字段\n * 覆盖 Definition 的输出默认值，不修改原 Definition。Checks、Check options 与 scheduler 仍在\n * `defineConfig(...)` 中声明，不能从这里替换；这些 Controls 不进入 Definition fingerprint。\n */\nexport interface RunControls {\n  /** 单次 diagnostic 文件命名；默认 `unique`，独占目录可选 `channel` 使用固定 Core/Scheduler 名，同名目标失败且不覆盖。 */\n  readonly diagnosticLogFileNaming?: DiagnosticLogFileNaming;\n  /** caller 为当前 Run 选择的 progress log exact target；省略时只写 terminal。 */\n  readonly progressLogFile?: string;\n  /** caller 选择的 Check-owned invocation artifact base；省略时不授予 artifact capability。 */\n  readonly checkArtifactBaseDirectory?: string;\n  /** 为本次 Run 解释有效 Check facts；省略时使用严格的 all-passed 默认折叠。 */\n  readonly checkAggregation?: CheckAggregation;\n  /** 仅为本次调用覆盖 Run-owned outputs。 */\n  readonly outputs?: Partial<{\n    machinePublication: Partial<ProjectOutputs[\"machinePublication\"]>;\n    progressRendering: Partial<ProjectOutputs[\"progressRendering\"]>;\n    diagnosticLogging: Partial<ProjectOutputs[\"diagnosticLogging\"]>;\n  }>;\n  /** 本次 Run 的 flag tokens；Product 去重排序后用于 Check selection 与 callback project context。 */\n  readonly flags?: readonly string[];\n  /** 项目相对输入与 output target 的解析根；省略时使用调用进程的当前工作目录。 */\n  readonly projectRoot?: string;\n  /** 供 planning、preparation 与 execution 协作响应的 caller cancellation signal。 */\n  readonly signal?: AbortSignal;\n}\n/** Diagnostic 文件名选择；不改变目录、日志内容或 invocation identity。 */\nexport type DiagnosticLogFileNaming = \"unique\" | \"channel\";\n/** `CheckAggregation` 计算出的 invocation 级结果。 */\nexport type CheckAggregate = \"passed\" | \"failed\" | \"not-applicable\" | \"unavailable\";\n/** 同步解释本次有效 Check facts 的 caller-local aggregation。 */\nexport type CheckAggregation = (checks: readonly CoreCheck[]) => CheckAggregate;\n"]}

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":"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","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,11 +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 CHECK_AGGREGATION_MODES = ["all", "any"];
-const UNAVAILABLE_HANDLING = ["propagate", "fail", "exclude"];
-const NOT_APPLICABLE_HANDLING = ["exclude", "pass", "fail"];
-const EMPTY_AGGREGATION_RESULTS = ["passed", "failed", "not-applicable"];
+import { CHANGE_FLAG_PREFIX } from "../changes/git.mjs";
+const RUN_CONTROL_KEYS = [
+    "checkArtifactBaseDirectory",
+    "checkAggregation",
+    "diagnosticLogFileNaming",
+    "progressLogFile",
+    "outputs",
+    "flags",
+    "projectRoot",
+    "signal"
+];
 export function validateRunControls(value = {}) {
     try {
         return validateRunControlsValue(value);
@@ -18,32 +24,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 +104,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 });
@@ -69,7 +124,7 @@ function parseFlags(value) {
         if (!Object.hasOwn(value, index))
             return invalidControls("controls.flags");
         const flag = value[index];
-        if (typeof flag !== "string" || flag.length === 0) {
+        if (typeof flag !== "string" || flag.length === 0 || flag.startsWith(CHANGE_FLAG_PREFIX)) {
             return invalidControls("controls.flags");
         }
         flags.push(flag);
@@ -82,57 +137,16 @@ function parseFlags(value) {
 function parseOptionalCheckAggregation(value) {
     if (value === undefined)
         return Object.freeze({ ok: true, value: undefined });
-    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);
-    if (checks === undefined)
-        return invalidControls("controls.checkAggregation.checks");
-    const mode = parseLiteral(data.mode, CHECK_AGGREGATION_MODES);
-    const unavailable = parseLiteral(data.unavailable, UNAVAILABLE_HANDLING);
-    const notApplicable = parseLiteral(data.notApplicable, NOT_APPLICABLE_HANDLING);
-    const empty = parseLiteral(data.empty, EMPTY_AGGREGATION_RESULTS);
-    if (mode === undefined ||
-        unavailable === undefined ||
-        notApplicable === undefined ||
-        empty === undefined)
-        return invalidControls("controls.checkAggregation");
-    return Object.freeze({
-        ok: true,
-        value: Object.freeze({
-            checks,
-            mode,
-            unavailable,
-            notApplicable,
-            empty
-        })
-    });
-}
-function parseClosedCheckIds(value) {
-    const values = snapshotClosedArray(value);
-    if (values === undefined)
-        return undefined;
-    const checkIds = [];
-    for (const checkId of values) {
-        if (typeof checkId !== "string" || checkId.length === 0)
-            return undefined;
-        checkIds.push(checkId);
-    }
-    return Object.freeze(checkIds);
+    return isCheckAggregation(value)
+        ? Object.freeze({ ok: true, value })
+        : invalidControls("controls.checkAggregation");
 }
-function parseLiteral(value, allowed) {
-    return typeof value === "string" ? allowed.find((option) => option === value) : undefined;
+function isCheckAggregation(value) {
+    return typeof value === "function";
 }
 function isRunControlKey(value) {
     return RUN_CONTROL_KEYS.some((key) => key === value);
 }
-function exactKeys(value, keys) {
-    if (!isNonArrayRecord(value))
-        return undefined;
-    return Object.keys(value).length === keys.length && keys.every((key) => Object.hasOwn(value, key))
-        ? value
-        : undefined;
-}
 function isAbortSignal(value) {
     return (isNonArrayRecord(value) &&
         typeof value.aborted === "boolean" &&
@@ -144,6 +158,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");
 }