@zxyycom/vibe-check 0.0.1 → 0.0.3

package/dist/esm/project-run/diagnostic-logging/observation-rendering.mjs

@@ -0,0 +1,159 @@
+import { renderSafeDiagnosticDetail } from "./diagnostic-detail-rendering.mjs";
+export function renderDiagnosticObservation(input) {
+    const tags = input.observation.tags.map((tag) => `[${escapeLogHeaderField(tag)}]`).join(" ");
+    const invocation = input.invocationId === undefined ? "" : ` invocationId=${JSON.stringify(input.invocationId)}`;
+    const header = `#${String(input.sequence).padStart(6, "0")} +${formatElapsed(input.elapsedMs)} ${tags}${invocation} ${escapeLogHeaderField(input.observation.event)}`;
+    return renderFactLines(header, diagnosticFacts(input.observation));
+}
+/** Keeps author-controlled header fields on one physical header line. */
+function escapeLogHeaderField(text) {
+    let escaped = "";
+    for (const character of text) {
+        if (character === "\\") {
+            escaped += "\\\\";
+            continue;
+        }
+        const codeUnit = character.charCodeAt(0);
+        escaped +=
+            codeUnit <= 0x1f ||
+                (codeUnit >= 0x7f && codeUnit <= 0x9f) ||
+                codeUnit === 0x5b ||
+                codeUnit === 0x5d ||
+                codeUnit === 0x2028 ||
+                codeUnit === 0x2029
+                ? `\\u${codeUnit.toString(16).padStart(4, "0")}`
+                : character;
+    }
+    return escaped;
+}
+function diagnosticFacts(observation) {
+    if (observation.details === undefined)
+        return Object.freeze([]);
+    const rendered = renderSafeDiagnosticDetail(observation.details);
+    if (!rendered.ok)
+        return Object.freeze([`details=unavailable:${escapeLogHeaderField(rendered.reason)}`]);
+    const value = JSON.parse(rendered.text);
+    const facts = [];
+    flattenDiagnosticFacts(value, [], facts, observation);
+    return Object.freeze(facts);
+}
+function flattenDiagnosticFacts(value, path, facts, observation) {
+    if (Array.isArray(value)) {
+        flattenDiagnosticArrayFacts(value, path, facts, observation);
+        return;
+    }
+    if (value !== null && typeof value === "object") {
+        flattenDiagnosticRecordFacts(value, path, facts, observation);
+        return;
+    }
+    facts.push(`${factKey(path)}=${factValue(path, value)}`);
+}
+function flattenDiagnosticArrayFacts(value, path, facts, observation) {
+    const inline = JSON.stringify(value);
+    if (inline.length <= MAX_INLINE_DIAGNOSTIC_VALUE_CHARACTERS) {
+        facts.push(`${factKey(path)}=${inline}`);
+        return;
+    }
+    const arrayPath = path.length === 0 ? ["details"] : path;
+    for (let index = 0; index < value.length; index += 1) {
+        flattenDiagnosticFacts(value[index], [...arrayPath, String(index)], facts, observation);
+    }
+}
+function flattenDiagnosticRecordFacts(value, path, facts, observation) {
+    const entries = Object.entries(value);
+    if (entries.length === 0) {
+        facts.push(`${factKey(path)}={}`);
+        return;
+    }
+    for (const [key, nested] of entries) {
+        if (path.length === 0 && isTopLevelFactRepresentedByTag(observation, key, nested))
+            continue;
+        flattenDiagnosticFacts(nested, [...path, key], facts, observation);
+    }
+}
+/** Omits only exact producer facts already visible in the observation's filter tags. */
+function isTopLevelFactRepresentedByTag(observation, key, value) {
+    if (typeof value !== "string")
+        return false;
+    if (observation.event === "scheduler.decision") {
+        if (key === "kind")
+            return observation.tags.includes(value.toUpperCase());
+        return key === "taskId" && observation.tags.includes(`TASK:${value}`);
+    }
+    return (observation.event === "record.reported" &&
+        key === "result" &&
+        observation.tags.includes(value.toUpperCase()));
+}
+const MAX_INLINE_DIAGNOSTIC_VALUE_CHARACTERS = 120;
+function factKey(path) {
+    if (path.length === 0)
+        return "details";
+    const joined = path.join(".");
+    return /^[A-Za-z_][A-Za-z0-9_.-]*$/u.test(joined) ? joined : JSON.stringify(joined);
+}
+function factValue(path, value) {
+    const key = path.at(-1);
+    if (typeof value === "number" && key?.endsWith("Ms") === true) {
+        return String(Math.round(value * 1_000) / 1_000);
+    }
+    return JSON.stringify(value);
+}
+const MAX_DIAGNOSTIC_LINE_CHARACTERS = 200;
+function renderFactLines(header, facts) {
+    if (facts.length === 0)
+        return `${header}\n`;
+    const lines = [];
+    let current = header;
+    for (const fact of facts) {
+        if (current.length + 1 + fact.length <= MAX_DIAGNOSTIC_LINE_CHARACTERS) {
+            current += ` ${fact}`;
+            continue;
+        }
+        lines.push(current);
+        const firstCapacity = MAX_DIAGNOSTIC_LINE_CHARACTERS - "│ ".length;
+        const continuationCapacity = MAX_DIAGNOSTIC_LINE_CHARACTERS - "│   ".length;
+        let offset = 0;
+        let prefix = "│ ";
+        while (fact.length - offset > (prefix === "│ " ? firstCapacity : continuationCapacity)) {
+            const capacity = prefix === "│ " ? firstCapacity : continuationCapacity;
+            const end = diagnosticChunkEnd(fact, offset, capacity);
+            lines.push(`${prefix}${fact.slice(offset, end)}`);
+            offset = end;
+            prefix = "│   ";
+        }
+        current = `${prefix}${fact.slice(offset)}`;
+    }
+    lines.push(current);
+    return `${lines.join("\n")}\n`;
+}
+function diagnosticChunkEnd(text, offset, capacity) {
+    let end = offset + capacity;
+    const preferredMinimum = offset + Math.floor(capacity * 0.6);
+    for (let index = end - 1; index >= preferredMinimum; index -= 1) {
+        if (text[index] === " ") {
+            end = index;
+            break;
+        }
+        if (text[index] === ",") {
+            end = index + 1;
+            break;
+        }
+    }
+    if (end < text.length &&
+        text.charCodeAt(end - 1) >= 0xd800 &&
+        text.charCodeAt(end - 1) <= 0xdbff &&
+        text.charCodeAt(end) >= 0xdc00 &&
+        text.charCodeAt(end) <= 0xdfff) {
+        end -= 1;
+    }
+    return end;
+}
+function formatElapsed(elapsedMs) {
+    const totalMilliseconds = Math.round(elapsedMs);
+    const hours = Math.floor(totalMilliseconds / 3_600_000);
+    const minutes = Math.floor((totalMilliseconds % 3_600_000) / 60_000);
+    const seconds = Math.floor((totalMilliseconds % 60_000) / 1_000);
+    const milliseconds = totalMilliseconds % 1_000;
+    return `${String(hours).padStart(2, "0")}:${String(minutes).padStart(2, "0")}:${String(seconds).padStart(2, "0")}.${String(milliseconds).padStart(3, "0")}`;
+}
+//# sourceMappingURL=observation-rendering.mjs.map

package/dist/esm/project-run/diagnostic-logging/observation-rendering.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"observation-rendering.mjs","sourceRoot":"","sources":["../../../../src/project-run/diagnostic-logging/observation-rendering.ts"],"names":[],"mappings":"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","sourcesContent":["import type { DiagnosticObservation } from \"./logger.ts\";\nimport { renderSafeDiagnosticDetail } from \"./diagnostic-detail-rendering.ts\";\n\nexport function renderDiagnosticObservation(\n  input: Readonly<{\n    readonly elapsedMs: number;\n    readonly invocationId: string | undefined;\n    readonly observation: DiagnosticObservation;\n    readonly sequence: number;\n  }>\n): string {\n  const tags = input.observation.tags.map((tag) => `[${escapeLogHeaderField(tag)}]`).join(\" \");\n  const invocation =\n    input.invocationId === undefined ? \"\" : ` invocationId=${JSON.stringify(input.invocationId)}`;\n  const header = `#${String(input.sequence).padStart(6, \"0\")} +${formatElapsed(input.elapsedMs)} ${tags}${invocation} ${escapeLogHeaderField(input.observation.event)}`;\n  return renderFactLines(header, diagnosticFacts(input.observation));\n}\n\n/** Keeps author-controlled header fields on one physical header line. */\nfunction escapeLogHeaderField(text: string): string {\n  let escaped = \"\";\n  for (const character of text) {\n    if (character === \"\\\\\") {\n      escaped += \"\\\\\\\\\";\n      continue;\n    }\n    const codeUnit = character.charCodeAt(0);\n    escaped +=\n      codeUnit <= 0x1f ||\n      (codeUnit >= 0x7f && codeUnit <= 0x9f) ||\n      codeUnit === 0x5b ||\n      codeUnit === 0x5d ||\n      codeUnit === 0x2028 ||\n      codeUnit === 0x2029\n        ? `\\\\u${codeUnit.toString(16).padStart(4, \"0\")}`\n        : character;\n  }\n  return escaped;\n}\n\nfunction diagnosticFacts(observation: DiagnosticObservation): readonly string[] {\n  if (observation.details === undefined) return Object.freeze([]);\n  const rendered = renderSafeDiagnosticDetail(observation.details);\n  if (!rendered.ok)\n    return Object.freeze([`details=unavailable:${escapeLogHeaderField(rendered.reason)}`]);\n\n  const value: unknown = JSON.parse(rendered.text);\n  const facts: string[] = [];\n  flattenDiagnosticFacts(value, [], facts, observation);\n  return Object.freeze(facts);\n}\n\nfunction flattenDiagnosticFacts(\n  value: unknown,\n  path: readonly string[],\n  facts: string[],\n  observation: DiagnosticObservation\n): void {\n  if (Array.isArray(value)) {\n    flattenDiagnosticArrayFacts(value, path, facts, observation);\n    return;\n  }\n\n  if (value !== null && typeof value === \"object\") {\n    flattenDiagnosticRecordFacts(value, path, facts, observation);\n    return;\n  }\n\n  facts.push(`${factKey(path)}=${factValue(path, value)}`);\n}\n\nfunction flattenDiagnosticArrayFacts(\n  value: readonly unknown[],\n  path: readonly string[],\n  facts: string[],\n  observation: DiagnosticObservation\n): void {\n  const inline = JSON.stringify(value);\n  if (inline.length <= MAX_INLINE_DIAGNOSTIC_VALUE_CHARACTERS) {\n    facts.push(`${factKey(path)}=${inline}`);\n    return;\n  }\n  const arrayPath = path.length === 0 ? [\"details\"] : path;\n  for (let index = 0; index < value.length; index += 1) {\n    flattenDiagnosticFacts(value[index], [...arrayPath, String(index)], facts, observation);\n  }\n}\n\nfunction flattenDiagnosticRecordFacts(\n  value: object,\n  path: readonly string[],\n  facts: string[],\n  observation: DiagnosticObservation\n): void {\n  const entries = Object.entries(value);\n  if (entries.length === 0) {\n    facts.push(`${factKey(path)}={}`);\n    return;\n  }\n  for (const [key, nested] of entries) {\n    if (path.length === 0 && isTopLevelFactRepresentedByTag(observation, key, nested)) continue;\n    flattenDiagnosticFacts(nested, [...path, key], facts, observation);\n  }\n}\n\n/** Omits only exact producer facts already visible in the observation's filter tags. */\nfunction isTopLevelFactRepresentedByTag(\n  observation: DiagnosticObservation,\n  key: string,\n  value: unknown\n): boolean {\n  if (typeof value !== \"string\") return false;\n  if (observation.event === \"scheduler.decision\") {\n    if (key === \"kind\") return observation.tags.includes(value.toUpperCase());\n    return key === \"taskId\" && observation.tags.includes(`TASK:${value}`);\n  }\n  return (\n    observation.event === \"record.reported\" &&\n    key === \"result\" &&\n    observation.tags.includes(value.toUpperCase())\n  );\n}\n\nconst MAX_INLINE_DIAGNOSTIC_VALUE_CHARACTERS = 120;\n\nfunction factKey(path: readonly string[]): string {\n  if (path.length === 0) return \"details\";\n  const joined = path.join(\".\");\n  return /^[A-Za-z_][A-Za-z0-9_.-]*$/u.test(joined) ? joined : JSON.stringify(joined);\n}\n\nfunction factValue(path: readonly string[], value: unknown): string {\n  const key = path.at(-1);\n  if (typeof value === \"number\" && key?.endsWith(\"Ms\") === true) {\n    return String(Math.round(value * 1_000) / 1_000);\n  }\n  return JSON.stringify(value);\n}\n\nconst MAX_DIAGNOSTIC_LINE_CHARACTERS = 200;\n\nfunction renderFactLines(header: string, facts: readonly string[]): string {\n  if (facts.length === 0) return `${header}\\n`;\n\n  const lines: string[] = [];\n  let current = header;\n  for (const fact of facts) {\n    if (current.length + 1 + fact.length <= MAX_DIAGNOSTIC_LINE_CHARACTERS) {\n      current += ` ${fact}`;\n      continue;\n    }\n\n    lines.push(current);\n    const firstCapacity = MAX_DIAGNOSTIC_LINE_CHARACTERS - \"│ \".length;\n    const continuationCapacity = MAX_DIAGNOSTIC_LINE_CHARACTERS - \"│   \".length;\n    let offset = 0;\n    let prefix = \"│ \";\n    while (fact.length - offset > (prefix === \"│ \" ? firstCapacity : continuationCapacity)) {\n      const capacity = prefix === \"│ \" ? firstCapacity : continuationCapacity;\n      const end = diagnosticChunkEnd(fact, offset, capacity);\n      lines.push(`${prefix}${fact.slice(offset, end)}`);\n      offset = end;\n      prefix = \"│   \";\n    }\n    current = `${prefix}${fact.slice(offset)}`;\n  }\n  lines.push(current);\n  return `${lines.join(\"\\n\")}\\n`;\n}\n\nfunction diagnosticChunkEnd(text: string, offset: number, capacity: number): number {\n  let end = offset + capacity;\n  const preferredMinimum = offset + Math.floor(capacity * 0.6);\n  for (let index = end - 1; index >= preferredMinimum; index -= 1) {\n    if (text[index] === \" \") {\n      end = index;\n      break;\n    }\n    if (text[index] === \",\") {\n      end = index + 1;\n      break;\n    }\n  }\n  if (\n    end < text.length &&\n    text.charCodeAt(end - 1) >= 0xd800 &&\n    text.charCodeAt(end - 1) <= 0xdbff &&\n    text.charCodeAt(end) >= 0xdc00 &&\n    text.charCodeAt(end) <= 0xdfff\n  ) {\n    end -= 1;\n  }\n  return end;\n}\n\nfunction formatElapsed(elapsedMs: number): string {\n  const totalMilliseconds = Math.round(elapsedMs);\n  const hours = Math.floor(totalMilliseconds / 3_600_000);\n  const minutes = Math.floor((totalMilliseconds % 3_600_000) / 60_000);\n  const seconds = Math.floor((totalMilliseconds % 60_000) / 1_000);\n  const milliseconds = totalMilliseconds % 1_000;\n  return `${String(hours).padStart(2, \"0\")}:${String(minutes).padStart(2, \"0\")}:${String(seconds).padStart(2, \"0\")}.${String(milliseconds).padStart(3, \"0\")}`;\n}\n"]}

package/dist/esm/project-run/invocation/candidate.mjs

@@ -0,0 +1,65 @@
+import { aggregateEffectiveChecks } from "../aggregation.mjs";
+import { completeInvocation } from "../completion/completion.mjs";
+import { diagnosticTags } from "../diagnostic-logging/logger.mjs";
+import { elapsedSince, outcomeCounts } from "./progress.mjs";
+import { executionCancellation } from "../result.mjs";
+/** Maps a sealed Scheduler result into the Run-owned candidate before terminal output closure. */
+export function mapResolvedExecutionToRunCandidate(input) {
+    const { executed, invocation } = input;
+    if (executed.kind === "admission-policy-failed")
+        return admissionPolicyFailure(invocation);
+    if (executed.kind === "cancelled") {
+        invocation.progressRendering.final({
+            counts: outcomeCounts(executed.snapshot),
+            elapsedMs: elapsedSince(input.executionStartedAt, invocation.clock),
+            execution: executed.kind
+        });
+        return cancelledExecutionCandidate(invocation, executed);
+    }
+    return completedExecutionCandidate(invocation, input.aggregation, executed, input.executionStartedAt);
+}
+function admissionPolicyFailure(invocation) {
+    return Object.freeze({
+        kind: "execution",
+        declarativeFingerprint: invocation.declarativeFingerprint,
+        definitionWarnings: invocation.definitionWarnings,
+        diagnostic: Object.freeze({ code: "admission-policy-failed" }),
+        outputs: invocation.outputs.value()
+    });
+}
+function cancelledExecutionCandidate(invocation, executed) {
+    invocation.diagnosticLogging.core.observe({
+        event: "run.execution.cancelled",
+        tags: diagnosticTags("RUN", "EXECUTION", "CANCELLED"),
+        details: { checkCount: executed.snapshot.checks.length }
+    });
+    return executionCancellation({
+        checkDurations: executed.checkDurations,
+        checkMessages: executed.checkMessages,
+        declarativeFingerprint: invocation.declarativeFingerprint,
+        definitionWarnings: invocation.definitionWarnings,
+        outputs: invocation.outputs.value(),
+        snapshot: executed.snapshot
+    });
+}
+function completedExecutionCandidate(invocation, aggregation, executed, executionStartedAt) {
+    const aggregate = aggregateEffectiveChecks(executed.snapshot, executed.effectiveCheckIds, aggregation);
+    invocation.diagnosticLogging.core.observe({
+        event: "run.aggregation.completed",
+        tags: diagnosticTags("RUN", "AGGREGATION", "COMPLETED"),
+        details: { aggregate, aggregation: aggregation === undefined ? "default" : "custom" }
+    });
+    const core = Object.freeze({
+        aggregate,
+        checkDurations: executed.checkDurations,
+        checkMessages: executed.checkMessages,
+        snapshot: executed.snapshot
+    });
+    invocation.progressRendering.final({
+        counts: outcomeCounts(executed.snapshot),
+        elapsedMs: elapsedSince(executionStartedAt, invocation.clock),
+        execution: "completed"
+    });
+    return completeInvocation(invocation, core);
+}
+//# sourceMappingURL=candidate.mjs.map

package/dist/esm/project-run/invocation/candidate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidate.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/candidate.ts"],"names":[],"mappings":"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","sourcesContent":["import { aggregateEffectiveChecks } from \"../aggregation.ts\";\nimport { completeInvocation, type CoreExecution } from \"../completion/completion.ts\";\nimport type { CheckAggregation } from \"../controls/contract.ts\";\nimport { diagnosticTags } from \"../diagnostic-logging/logger.ts\";\nimport type { Invocation } from \"./run.ts\";\nimport { elapsedSince, outcomeCounts } from \"./progress.ts\";\nimport { executionCancellation, type NonConfigurationRunResult } from \"../result.ts\";\nimport type { ResolvedCheckExecution } from \"../check-execution/resolved-execution-result.ts\";\n\nexport type ResolvedExecutionCandidateInput = Readonly<{\n  readonly aggregation: CheckAggregation | undefined;\n  readonly executed: ResolvedCheckExecution;\n  readonly executionStartedAt: number;\n  readonly invocation: Invocation;\n}>;\n\n/** Maps a sealed Scheduler result into the Run-owned candidate before terminal output closure. */\nexport function mapResolvedExecutionToRunCandidate(\n  input: ResolvedExecutionCandidateInput\n): NonConfigurationRunResult {\n  const { executed, invocation } = input;\n  if (executed.kind === \"admission-policy-failed\") return admissionPolicyFailure(invocation);\n\n  if (executed.kind === \"cancelled\") {\n    invocation.progressRendering.final({\n      counts: outcomeCounts(executed.snapshot),\n      elapsedMs: elapsedSince(input.executionStartedAt, invocation.clock),\n      execution: executed.kind\n    });\n    return cancelledExecutionCandidate(invocation, executed);\n  }\n  return completedExecutionCandidate(\n    invocation,\n    input.aggregation,\n    executed,\n    input.executionStartedAt\n  );\n}\n\nfunction admissionPolicyFailure(\n  invocation: Invocation\n): Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }> {\n  return Object.freeze({\n    kind: \"execution\",\n    declarativeFingerprint: invocation.declarativeFingerprint,\n    definitionWarnings: invocation.definitionWarnings,\n    diagnostic: Object.freeze({ code: \"admission-policy-failed\" }),\n    outputs: invocation.outputs.value()\n  });\n}\n\nfunction cancelledExecutionCandidate(\n  invocation: Invocation,\n  executed: Extract<ResolvedCheckExecution, { readonly kind: \"cancelled\" }>\n): NonConfigurationRunResult {\n  invocation.diagnosticLogging.core.observe({\n    event: \"run.execution.cancelled\",\n    tags: diagnosticTags(\"RUN\", \"EXECUTION\", \"CANCELLED\"),\n    details: { checkCount: executed.snapshot.checks.length }\n  });\n  return executionCancellation({\n    checkDurations: executed.checkDurations,\n    checkMessages: executed.checkMessages,\n    declarativeFingerprint: invocation.declarativeFingerprint,\n    definitionWarnings: invocation.definitionWarnings,\n    outputs: invocation.outputs.value(),\n    snapshot: executed.snapshot\n  });\n}\n\nfunction completedExecutionCandidate(\n  invocation: Invocation,\n  aggregation: CheckAggregation | undefined,\n  executed: Extract<ResolvedCheckExecution, { readonly kind: \"completed\" }>,\n  executionStartedAt: number\n): NonConfigurationRunResult {\n  const aggregate = aggregateEffectiveChecks(\n    executed.snapshot,\n    executed.effectiveCheckIds,\n    aggregation\n  );\n  invocation.diagnosticLogging.core.observe({\n    event: \"run.aggregation.completed\",\n    tags: diagnosticTags(\"RUN\", \"AGGREGATION\", \"COMPLETED\"),\n    details: { aggregate, aggregation: aggregation === undefined ? \"default\" : \"custom\" }\n  });\n  const core: CoreExecution = Object.freeze({\n    aggregate,\n    checkDurations: executed.checkDurations,\n    checkMessages: executed.checkMessages,\n    snapshot: executed.snapshot\n  });\n  invocation.progressRendering.final({\n    counts: outcomeCounts(executed.snapshot),\n    elapsedMs: elapsedSince(executionStartedAt, invocation.clock),\n    execution: \"completed\"\n  });\n  return completeInvocation(invocation, core);\n}\n"]}

package/dist/esm/project-run/invocation/candidates.mjs

@@ -0,0 +1,26 @@
+import { diagnosticTags } from "../diagnostic-logging/logger.mjs";
+import { planning, preExecutionCancellation } from "../result.mjs";
+/** Records a pre-execution cancellation as the Run-owned candidate result. */
+export function cancelledBeforeExecution(invocation, phase) {
+    invocation.diagnosticLogging.core.observe({
+        event: "run.cancelled",
+        tags: diagnosticTags("RUN", "CANCELLED"),
+        details: { phase }
+    });
+    return preExecutionCancellation(invocation.declarativeFingerprint, invocation.definitionWarnings, invocation.outputs.value(), phase);
+}
+/** Constructs the planning failure candidate after the static graph has been rejected. */
+export function planningResult(invocation, code) {
+    return planning(invocation.declarativeFingerprint, invocation.definitionWarnings, invocation.outputs.value(), code);
+}
+/** Constructs a pre-settlement execution failure without revising existing output facts. */
+export function executionResult(invocation, code) {
+    return Object.freeze({
+        kind: "execution",
+        declarativeFingerprint: invocation.declarativeFingerprint,
+        definitionWarnings: invocation.definitionWarnings,
+        diagnostic: Object.freeze({ code }),
+        outputs: invocation.outputs.value()
+    });
+}
+//# sourceMappingURL=candidates.mjs.map

package/dist/esm/project-run/invocation/candidates.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/candidates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EACL,QAAQ,EACR,wBAAwB,EAGzB,MAAM,cAAc,CAAC;AAGtB,8EAA8E;AAC9E,MAAM,UAAU,wBAAwB,CACtC,UAAsB,EACtB,KAA8B;IAE9B,UAAU,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC;QACxC,KAAK,EAAE,eAAe;QACtB,IAAI,EAAE,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC;QACxC,OAAO,EAAE,EAAE,KAAK,EAAE;KACnB,CAAC,CAAC;IACH,OAAO,wBAAwB,CAC7B,UAAU,CAAC,sBAAsB,EACjC,UAAU,CAAC,kBAAkB,EAC7B,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAC1B,KAAK,CACN,CAAC;AACJ,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,cAAc,CAC5B,UAAsB,EACtB,IAA0D;IAE1D,OAAO,QAAQ,CACb,UAAU,CAAC,sBAAsB,EACjC,UAAU,CAAC,kBAAkB,EAC7B,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,EAC1B,IAAI,CACL,CAAC;AACJ,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,eAAe,CAC7B,UAAsB,EACtB,IAGC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;QACzD,kBAAkB,EAAE,UAAU,CAAC,kBAAkB;QACjD,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QACnC,OAAO,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE;KACpC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { diagnosticTags } from \"../diagnostic-logging/logger.ts\";\nimport {\n  planning,\n  preExecutionCancellation,\n  type NonConfigurationRunResult,\n  type RunDiagnostic\n} from \"../result.ts\";\nimport type { Invocation } from \"./run.ts\";\n\n/** Records a pre-execution cancellation as the Run-owned candidate result. */\nexport function cancelledBeforeExecution(\n  invocation: Invocation,\n  phase: \"pre-work\" | \"planning\"\n): NonConfigurationRunResult {\n  invocation.diagnosticLogging.core.observe({\n    event: \"run.cancelled\",\n    tags: diagnosticTags(\"RUN\", \"CANCELLED\"),\n    details: { phase }\n  });\n  return preExecutionCancellation(\n    invocation.declarativeFingerprint,\n    invocation.definitionWarnings,\n    invocation.outputs.value(),\n    phase\n  );\n}\n\n/** Constructs the planning failure candidate after the static graph has been rejected. */\nexport function planningResult(\n  invocation: Invocation,\n  code: Extract<RunDiagnostic[\"code\"], \"task-graph-invalid\">\n): NonConfigurationRunResult {\n  return planning(\n    invocation.declarativeFingerprint,\n    invocation.definitionWarnings,\n    invocation.outputs.value(),\n    code\n  );\n}\n\n/** Constructs a pre-settlement execution failure without revising existing output facts. */\nexport function executionResult(\n  invocation: Invocation,\n  code: Extract<\n    RunDiagnostic[\"code\"],\n    \"admission-strategy-preparation-failed\" | \"task-engine-failed\"\n  >\n): NonConfigurationRunResult {\n  return Object.freeze({\n    kind: \"execution\",\n    declarativeFingerprint: invocation.declarativeFingerprint,\n    definitionWarnings: invocation.definitionWarnings,\n    diagnostic: Object.freeze({ code }),\n    outputs: invocation.outputs.value()\n  });\n}\n"]}

package/dist/esm/project-run/invocation/creation.mjs

@@ -0,0 +1,83 @@
+import { randomUUID } from "node:crypto";
+import { createDeclarativeFingerprint } from "../../project-definition/project-definition.mjs";
+import { createDiagnosticLogger, createDiagnosticLoggingRouter } from "../diagnostic-logging/logger.mjs";
+import { createOutputStatuses } from "../outputs/status.mjs";
+import { effectiveOutputs } from "../outputs/configuration.mjs";
+import { resolveInvocationPaths } from "./paths.mjs";
+import { createProgressRendering } from "../progress-rendering/presentation.mjs";
+const SYSTEM_MONOTONIC_CLOCK = Object.freeze({
+    now: () => performance.now()
+});
+/** Creates immutable invocation-owned output state before any planning or execution work. */
+export function createInvocation(input) {
+    const outputConfiguration = effectiveOutputs(input.definition, input.controls);
+    const clock = input.dependencies.clock ?? SYSTEM_MONOTONIC_CLOCK;
+    const diagnosticLoggingEnabled = outputConfiguration.diagnosticLogging.enabled;
+    const startedAtUtc = captureOutputCreationTimestamp(outputConfiguration, input.dependencies);
+    const identity = createInvocationIdentity();
+    const paths = resolveInvocationPaths({
+        checkArtifactBaseDirectory: input.controls.checkArtifactBaseDirectory,
+        checkIds: input.normalized.checks.map((check) => check.definition.checkId),
+        diagnosticLogFileNaming: input.controls.diagnosticLogFileNaming ?? "unique",
+        diagnosticLogSuffix: diagnosticLoggingEnabled
+            ? diagnosticLogSuffix(requireStartedAtUtc(startedAtUtc), identity.uuid)
+            : undefined,
+        outputConfiguration,
+        progressLogFile: input.controls.progressLogFile,
+        projectRoot: input.controls.projectRoot ?? process.cwd()
+    });
+    const outputs = createOutputStatuses(outputConfiguration, paths.diagnosticLoggingReadbackFiles, input.normalized.scheduler.terminalEffects.length > 0);
+    const diagnosticLogging = createDiagnosticLoggingRouter({
+        clock,
+        coreFile: paths.diagnosticLoggingFiles.core,
+        factory: input.dependencies.diagnosticLoggerFactory ?? createDiagnosticLogger,
+        invocationId: identity.id,
+        schedulerFile: paths.diagnosticLoggingFiles.scheduler
+    });
+    return Object.freeze({
+        admissionStrategyProviderFactory: input.dependencies.admissionStrategyProviderFactory,
+        clock,
+        controls: input.controls,
+        declarativeFingerprint: createDeclarativeFingerprint(input.normalized.declarative),
+        definition: input.definition,
+        definitionWarnings: Object.freeze([...input.definitionWarnings]),
+        diagnosticLogging,
+        diagnosticLoggingEnabled,
+        outputConfiguration,
+        outputs,
+        invocationId: identity.id,
+        paths,
+        normalized: input.normalized,
+        progressRendering: createProgressRendering(outputConfiguration.progressRendering, outputs, {
+            clock,
+            ...(input.dependencies.progressRefreshScheduler === undefined
+                ? {}
+                : { refreshScheduler: input.dependencies.progressRefreshScheduler }),
+            ...(input.dependencies.progressWriterFactory === undefined
+                ? {}
+                : { writerFactory: input.dependencies.progressWriterFactory }),
+            file: paths.progressLogFile
+        }),
+        startedAtUtc
+    });
+}
+function captureOutputCreationTimestamp(outputConfiguration, dependencies) {
+    if (!outputConfiguration.diagnosticLogging.enabled &&
+        !outputConfiguration.machinePublication.enabled)
+        return null;
+    return (dependencies.wallClock?.now() ?? new Date()).toISOString();
+}
+function createInvocationIdentity() {
+    const uuid = randomUUID();
+    return Object.freeze({ id: `invocation/v1:${uuid}`, uuid });
+}
+function diagnosticLogSuffix(startedAtUtc, invocationUuid) {
+    const compactUtc = startedAtUtc.replaceAll("-", "").replaceAll(":", "");
+    return `${compactUtc}-${invocationUuid}`;
+}
+function requireStartedAtUtc(startedAtUtc) {
+    if (startedAtUtc === null)
+        throw new Error("Enabled output requires an invocation timestamp");
+    return startedAtUtc;
+}
+//# sourceMappingURL=creation.mjs.map

package/dist/esm/project-run/invocation/creation.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"creation.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/creation.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\n\nimport {\n  createDeclarativeFingerprint,\n  type DefinitionWarning,\n  type NormalizedProjectDefinition,\n  type ProjectDefinition,\n  type ResolvedProjectOutputs\n} from \"../../project-definition/project-definition.ts\";\nimport type { RunControls } from \"../controls/contract.ts\";\nimport {\n  createDiagnosticLogger,\n  createDiagnosticLoggingRouter\n} from \"../diagnostic-logging/logger.ts\";\nimport type { Invocation, RunInvocationDependencies } from \"./run.ts\";\nimport { createOutputStatuses } from \"../outputs/status.ts\";\nimport { effectiveOutputs } from \"../outputs/configuration.ts\";\nimport { resolveInvocationPaths } from \"./paths.ts\";\nimport { createProgressRendering } from \"../progress-rendering/presentation.ts\";\n\nconst SYSTEM_MONOTONIC_CLOCK: Invocation[\"clock\"] = Object.freeze({\n  now: () => performance.now()\n});\n\nexport interface InvocationCreationInput {\n  readonly controls: RunControls;\n  readonly definition: ProjectDefinition;\n  readonly definitionWarnings: readonly DefinitionWarning[];\n  readonly dependencies: RunInvocationDependencies;\n  readonly normalized: NormalizedProjectDefinition;\n}\n\n/** Creates immutable invocation-owned output state before any planning or execution work. */\nexport function createInvocation(input: InvocationCreationInput): Invocation {\n  const outputConfiguration = effectiveOutputs(input.definition, input.controls);\n  const clock = input.dependencies.clock ?? SYSTEM_MONOTONIC_CLOCK;\n  const diagnosticLoggingEnabled = outputConfiguration.diagnosticLogging.enabled;\n  const startedAtUtc = captureOutputCreationTimestamp(outputConfiguration, input.dependencies);\n  const identity = createInvocationIdentity();\n  const paths = resolveInvocationPaths({\n    checkArtifactBaseDirectory: input.controls.checkArtifactBaseDirectory,\n    checkIds: input.normalized.checks.map((check) => check.definition.checkId),\n    diagnosticLogFileNaming: input.controls.diagnosticLogFileNaming ?? \"unique\",\n    diagnosticLogSuffix: diagnosticLoggingEnabled\n      ? diagnosticLogSuffix(requireStartedAtUtc(startedAtUtc), identity.uuid)\n      : undefined,\n    outputConfiguration,\n    progressLogFile: input.controls.progressLogFile,\n    projectRoot: input.controls.projectRoot ?? process.cwd()\n  });\n  const outputs = createOutputStatuses(\n    outputConfiguration,\n    paths.diagnosticLoggingReadbackFiles,\n    input.normalized.scheduler.terminalEffects.length > 0\n  );\n  const diagnosticLogging = createDiagnosticLoggingRouter({\n    clock,\n    coreFile: paths.diagnosticLoggingFiles.core,\n    factory: input.dependencies.diagnosticLoggerFactory ?? createDiagnosticLogger,\n    invocationId: identity.id,\n    schedulerFile: paths.diagnosticLoggingFiles.scheduler\n  });\n\n  return Object.freeze({\n    admissionStrategyProviderFactory: input.dependencies.admissionStrategyProviderFactory,\n    clock,\n    controls: input.controls,\n    declarativeFingerprint: createDeclarativeFingerprint(input.normalized.declarative),\n    definition: input.definition,\n    definitionWarnings: Object.freeze([...input.definitionWarnings]),\n    diagnosticLogging,\n    diagnosticLoggingEnabled,\n    outputConfiguration,\n    outputs,\n    invocationId: identity.id,\n    paths,\n    normalized: input.normalized,\n    progressRendering: createProgressRendering(outputConfiguration.progressRendering, outputs, {\n      clock,\n      ...(input.dependencies.progressRefreshScheduler === undefined\n        ? {}\n        : { refreshScheduler: input.dependencies.progressRefreshScheduler }),\n      ...(input.dependencies.progressWriterFactory === undefined\n        ? {}\n        : { writerFactory: input.dependencies.progressWriterFactory }),\n      file: paths.progressLogFile\n    }),\n    startedAtUtc\n  });\n}\n\nfunction captureOutputCreationTimestamp(\n  outputConfiguration: ResolvedProjectOutputs,\n  dependencies: RunInvocationDependencies\n): string | null {\n  if (\n    !outputConfiguration.diagnosticLogging.enabled &&\n    !outputConfiguration.machinePublication.enabled\n  )\n    return null;\n  return (dependencies.wallClock?.now() ?? new Date()).toISOString();\n}\n\nfunction createInvocationIdentity(): Readonly<{\n  readonly id: string;\n  readonly uuid: string;\n}> {\n  const uuid = randomUUID();\n  return Object.freeze({ id: `invocation/v1:${uuid}`, uuid });\n}\n\nfunction diagnosticLogSuffix(startedAtUtc: string, invocationUuid: string): string {\n  const compactUtc = startedAtUtc.replaceAll(\"-\", \"\").replaceAll(\":\", \"\");\n  return `${compactUtc}-${invocationUuid}`;\n}\n\nfunction requireStartedAtUtc(startedAtUtc: string | null): string {\n  if (startedAtUtc === null) throw new Error(\"Enabled output requires an invocation timestamp\");\n  return startedAtUtc;\n}\n"]}

package/dist/esm/project-run/invocation/execution.mjs

@@ -0,0 +1,98 @@
+import { createAdmissionStrategyProvider } from "../admission-strategy-provider/provider.mjs";
+import { AdmissionStrategyPreparationFailure } from "../admission-strategy-provider/custom-strategy-preparation.mjs";
+import { prepareTaskGraph } from "../task-scheduler/graph.mjs";
+import { planStaticCheckGraph } from "../check-execution/plan.mjs";
+import { prepareProjectChanges } from "../changes/git.mjs";
+import { createProjectContext } from "../project-context.mjs";
+import { isCancelled } from "../result.mjs";
+import { mapResolvedExecutionToRunCandidate } from "./candidate.mjs";
+import { cancelledBeforeExecution, executionResult } from "./candidates.mjs";
+import { executeScheduler } from "./scheduler.mjs";
+const EMPTY_EFFECTIVE_FLAGS = Object.freeze([]);
+/** Executes the post-validation invocation phases, from change preparation through Scheduler completion. */
+export async function executePlannedInvocation(invocation, aggregation) {
+    if (isCancelled(invocation.controls))
+        return cancelledBeforeExecution(invocation, "pre-work");
+    const preparedChanges = invocation.normalized.changes === undefined
+        ? undefined
+        : prepareProjectChanges({
+            callerFlags: invocation.controls.flags ?? [],
+            changes: invocation.normalized.changes,
+            projectRoot: invocation.paths.projectRoot
+        });
+    const effectiveFlags = preparedChanges?.effectiveFlags ?? invocation.controls.flags ?? EMPTY_EFFECTIVE_FLAGS;
+    return executePreparedInvocation(invocation, aggregation, createProjectContext({
+        ...(preparedChanges === undefined ? {} : { changes: preparedChanges.projectChanges }),
+        flags: effectiveFlags,
+        paths: invocation.paths
+    }));
+}
+async function executePreparedInvocation(invocation, aggregation, project) {
+    if (isCancelled(invocation.controls))
+        return cancelledBeforeExecution(invocation, "planning");
+    let preparedStrategy;
+    try {
+        preparedStrategy = await prepareAdmissionStrategy(invocation);
+    }
+    catch (error) {
+        if (error instanceof AdmissionStrategyPreparationFailure) {
+            return executionResult(invocation, "admission-strategy-preparation-failed");
+        }
+        throw error;
+    }
+    if (preparedStrategy.completion.kind === "terminal-effect") {
+        invocation.outputs.enableTerminalEffects();
+    }
+    invocation.progressRendering.prepared(invocation.normalized.checks.length, invocation.normalized.checks.filter((check) => check.omitQuietPassedRow).length);
+    const executionStartedAt = invocation.clock.now();
+    const executed = await executeScheduler({ invocation, preparedStrategy, project });
+    if (isExecutionRunResult(executed))
+        return executed;
+    await completeAdmissionStrategyAfterTerminalMeasurement(preparedStrategy, executed, invocation.outputs);
+    return mapResolvedExecutionToRunCandidate({
+        aggregation,
+        executed,
+        executionStartedAt,
+        invocation
+    });
+}
+/** Composes one invocation-local strategy only after the static Task graph is valid. */
+async function prepareAdmissionStrategy(invocation) {
+    const graph = prepareTaskGraph(planStaticCheckGraph(invocation.normalized.checks, invocation.normalized.declarative.scheduler.resourceCapacities), invocation.normalized.declarative.scheduler.maxParallel);
+    const admissionStrategyProviderFactory = invocation.admissionStrategyProviderFactory ?? createAdmissionStrategyProvider;
+    const provider = admissionStrategyProviderFactory({
+        admissionPolicy: invocation.normalized.scheduler.admissionPolicy,
+        graph: graph.schedulerGraphSnapshot
+    });
+    return provider.prepare();
+}
+/** The prepared provider closes only after Scheduler terminal measurement and Hooks have settled. */
+async function completeAdmissionStrategyAfterTerminalMeasurement(preparedStrategy, executed, outputs) {
+    const terminalMeasurement = executed.terminalSchedulerMeasurement;
+    if (terminalMeasurement === undefined)
+        return;
+    switch (preparedStrategy.completion.kind) {
+        case "none":
+            return;
+        case "internal":
+            try {
+                await preparedStrategy.completion.complete(Object.freeze({ terminalMeasurement }));
+            }
+            catch {
+                // Private learned lifecycle cannot revise sealed execution or public output facts.
+            }
+            return;
+        case "terminal-effect":
+            try {
+                await preparedStrategy.completion.terminalEffect(terminalMeasurement);
+                outputs.succeeded("terminalEffects");
+            }
+            catch {
+                outputs.failed("terminalEffects");
+            }
+    }
+}
+function isExecutionRunResult(value) {
+    return "declarativeFingerprint" in value;
+}
+//# sourceMappingURL=execution.mjs.map

package/dist/esm/project-run/invocation/execution.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/execution.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CheckProjectContext } from \"../../check/check.ts\";\nimport type { CheckAggregation } from \"../controls/contract.ts\";\nimport { createAdmissionStrategyProvider } from \"../admission-strategy-provider/provider.ts\";\nimport { AdmissionStrategyPreparationFailure } from \"../admission-strategy-provider/custom-strategy-preparation.ts\";\nimport type { PreparedAdmissionStrategy } from \"../admission-strategy-provider/prepared-admission-strategy.ts\";\nimport { prepareTaskGraph } from \"../task-scheduler/graph.ts\";\nimport type { ResolvedCheckExecution } from \"../check-execution/resolved-execution-result.ts\";\nimport { planStaticCheckGraph } from \"../check-execution/plan.ts\";\nimport { prepareProjectChanges } from \"../changes/git.ts\";\nimport { createProjectContext } from \"../project-context.ts\";\nimport type { OutputStatuses } from \"../outputs/status.ts\";\nimport { isCancelled, type NonConfigurationRunResult } from \"../result.ts\";\nimport { mapResolvedExecutionToRunCandidate } from \"./candidate.ts\";\nimport { cancelledBeforeExecution, executionResult } from \"./candidates.ts\";\nimport type { Invocation } from \"./run.ts\";\nimport { executeScheduler, type SchedulerExecution } from \"./scheduler.ts\";\n\nconst EMPTY_EFFECTIVE_FLAGS: readonly string[] = Object.freeze([]);\n\n/** Executes the post-validation invocation phases, from change preparation through Scheduler completion. */\nexport async function executePlannedInvocation(\n  invocation: Invocation,\n  aggregation: CheckAggregation | undefined\n): Promise<NonConfigurationRunResult> {\n  if (isCancelled(invocation.controls)) return cancelledBeforeExecution(invocation, \"pre-work\");\n  const preparedChanges =\n    invocation.normalized.changes === undefined\n      ? undefined\n      : prepareProjectChanges({\n          callerFlags: invocation.controls.flags ?? [],\n          changes: invocation.normalized.changes,\n          projectRoot: invocation.paths.projectRoot\n        });\n  const effectiveFlags =\n    preparedChanges?.effectiveFlags ?? invocation.controls.flags ?? EMPTY_EFFECTIVE_FLAGS;\n  return executePreparedInvocation(\n    invocation,\n    aggregation,\n    createProjectContext({\n      ...(preparedChanges === undefined ? {} : { changes: preparedChanges.projectChanges }),\n      flags: effectiveFlags,\n      paths: invocation.paths\n    })\n  );\n}\nasync function executePreparedInvocation(\n  invocation: Invocation,\n  aggregation: CheckAggregation | undefined,\n  project: CheckProjectContext\n): Promise<NonConfigurationRunResult> {\n  if (isCancelled(invocation.controls)) return cancelledBeforeExecution(invocation, \"planning\");\n  let preparedStrategy: PreparedAdmissionStrategy;\n  try {\n    preparedStrategy = await prepareAdmissionStrategy(invocation);\n  } catch (error) {\n    if (error instanceof AdmissionStrategyPreparationFailure) {\n      return executionResult(invocation, \"admission-strategy-preparation-failed\");\n    }\n    throw error;\n  }\n  if (preparedStrategy.completion.kind === \"terminal-effect\") {\n    invocation.outputs.enableTerminalEffects();\n  }\n  invocation.progressRendering.prepared(\n    invocation.normalized.checks.length,\n    invocation.normalized.checks.filter((check) => check.omitQuietPassedRow).length\n  );\n  const executionStartedAt = invocation.clock.now();\n  const executed = await executeScheduler({ invocation, preparedStrategy, project });\n  if (isExecutionRunResult(executed)) return executed;\n  await completeAdmissionStrategyAfterTerminalMeasurement(\n    preparedStrategy,\n    executed,\n    invocation.outputs\n  );\n  return mapResolvedExecutionToRunCandidate({\n    aggregation,\n    executed,\n    executionStartedAt,\n    invocation\n  });\n}\n\n/** Composes one invocation-local strategy only after the static Task graph is valid. */\nasync function prepareAdmissionStrategy(\n  invocation: Invocation\n): Promise<PreparedAdmissionStrategy> {\n  const graph = prepareTaskGraph(\n    planStaticCheckGraph(\n      invocation.normalized.checks,\n      invocation.normalized.declarative.scheduler.resourceCapacities\n    ),\n    invocation.normalized.declarative.scheduler.maxParallel\n  );\n  const admissionStrategyProviderFactory =\n    invocation.admissionStrategyProviderFactory ?? createAdmissionStrategyProvider;\n  const provider = admissionStrategyProviderFactory({\n    admissionPolicy: invocation.normalized.scheduler.admissionPolicy,\n    graph: graph.schedulerGraphSnapshot\n  });\n  return provider.prepare();\n}\n\n/** The prepared provider closes only after Scheduler terminal measurement and Hooks have settled. */\nasync function completeAdmissionStrategyAfterTerminalMeasurement(\n  preparedStrategy: PreparedAdmissionStrategy,\n  executed: ResolvedCheckExecution,\n  outputs: OutputStatuses\n): Promise<void> {\n  const terminalMeasurement = executed.terminalSchedulerMeasurement;\n  if (terminalMeasurement === undefined) return;\n  switch (preparedStrategy.completion.kind) {\n    case \"none\":\n      return;\n    case \"internal\":\n      try {\n        await preparedStrategy.completion.complete(Object.freeze({ terminalMeasurement }));\n      } catch {\n        // Private learned lifecycle cannot revise sealed execution or public output facts.\n      }\n      return;\n    case \"terminal-effect\":\n      try {\n        await preparedStrategy.completion.terminalEffect(terminalMeasurement);\n        outputs.succeeded(\"terminalEffects\");\n      } catch {\n        outputs.failed(\"terminalEffects\");\n      }\n  }\n}\n\nfunction isExecutionRunResult(\n  value: SchedulerExecution\n): value is Extract<NonConfigurationRunResult, { readonly kind: \"execution\" }> {\n  return \"declarativeFingerprint\" in value;\n}\n"]}

package/dist/esm/project-run/invocation/paths.mjs

@@ -0,0 +1,77 @@
+import { createHash } from "node:crypto";
+import { join, relative, resolve } from "node:path";
+/** 在任何 author callback 前恰好一次解析全部 Product-owned invocation target。 */
+export function resolveInvocationPaths(input) {
+    const projectRoot = resolve(input.projectRoot);
+    const checkArtifactBaseDirectory = input.checkArtifactBaseDirectory === undefined
+        ? null
+        : resolve(projectRoot, input.checkArtifactBaseDirectory);
+    const diagnosticDirectory = resolve(projectRoot, input.outputConfiguration.diagnosticLogging.directory);
+    const diagnosticLoggingFiles = diagnosticFilesFor({
+        diagnosticDirectory,
+        diagnosticLogFileNaming: input.diagnosticLogFileNaming,
+        diagnosticLogSuffix: input.diagnosticLogSuffix
+    });
+    const machinePublicationDirectory = resolve(projectRoot, input.outputConfiguration.machinePublication.directory);
+    return Object.freeze({
+        checkArtifactDirectories: resolveCheckArtifactDirectories(checkArtifactBaseDirectory, input.checkIds),
+        checkArtifactBaseDirectory,
+        diagnosticLoggingFiles,
+        diagnosticLoggingReadbackFiles: diagnosticReadbackFiles(projectRoot, diagnosticLoggingFiles),
+        machinePublicationDirectory,
+        progressLogFile: input.progressLogFile === undefined ? null : resolve(projectRoot, input.progressLogFile),
+        projectRoot
+    });
+}
+function diagnosticFilesFor(input) {
+    const file = (channel) => {
+        if (input.diagnosticLogSuffix === undefined)
+            return null;
+        const basename = input.diagnosticLogFileNaming === "channel"
+            ? `${channel}.log`
+            : `${channel}-${input.diagnosticLogSuffix}.log`;
+        return join(input.diagnosticDirectory, basename);
+    };
+    return Object.freeze({
+        core: file("core"),
+        scheduler: file("scheduler")
+    });
+}
+function diagnosticReadbackFiles(projectRoot, files) {
+    const readback = (channel) => {
+        const file = files[channel];
+        return file === null ? null : relative(projectRoot, file);
+    };
+    return Object.freeze({
+        core: readback("core"),
+        scheduler: readback("scheduler")
+    });
+}
+/** 只返回当前 Check-local artifact directory，不向 callback 暴露 sibling directories。 */
+export function artifactDirectoryForCheck(paths, checkId) {
+    return (paths.checkArtifactDirectories.find((entry) => entry.checkId === checkId)?.directory ?? null);
+}
+function resolveCheckArtifactDirectories(checkArtifactBaseDirectory, checkIds) {
+    if (checkArtifactBaseDirectory === null)
+        return Object.freeze([]);
+    const directories = [];
+    const checkIdByEncodedDirectory = new Map();
+    for (const checkId of checkIds) {
+        const encodedDirectory = encodeCheckArtifactDirectory(checkId);
+        const priorCheckId = checkIdByEncodedDirectory.get(encodedDirectory);
+        if (priorCheckId !== undefined && priorCheckId !== checkId) {
+            throw new Error("Distinct Check IDs resolved to one artifact directory");
+        }
+        checkIdByEncodedDirectory.set(encodedDirectory, checkId);
+        directories.push(Object.freeze({ checkId, directory: join(checkArtifactBaseDirectory, encodedDirectory) }));
+    }
+    return Object.freeze(directories);
+}
+/**
+ * SHA-256 base64url component 不包含分隔符或 traversal token，且远低于常规 filesystem component length。
+ * raw Check ID 仍由既有 facts 保存。
+ */
+function encodeCheckArtifactDirectory(checkId) {
+    return `check-${createHash("sha256").update(checkId, "utf8").digest("base64url")}`;
+}
+//# sourceMappingURL=paths.mjs.map

package/dist/esm/project-run/invocation/paths.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.mjs","sourceRoot":"","sources":["../../../../src/project-run/invocation/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpD,qEAAqE;AACrE,MAAM,UAAU,sBAAsB,CACpC,KAQE;IAEF,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAC/C,MAAM,0BAA0B,GAC9B,KAAK,CAAC,0BAA0B,KAAK,SAAS;QAC5C,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAC7D,MAAM,mBAAmB,GAAG,OAAO,CACjC,WAAW,EACX,KAAK,CAAC,mBAAmB,CAAC,iBAAiB,CAAC,SAAS,CACtD,CAAC;IACF,MAAM,sBAAsB,GAAG,kBAAkB,CAAC;QAChD,mBAAmB;QACnB,uBAAuB,EAAE,KAAK,CAAC,uBAAuB;QACtD,mBAAmB,EAAE,KAAK,CAAC,mBAAmB;KAC/C,CAAC,CAAC;IACH,MAAM,2BAA2B,GAAG,OAAO,CACzC,WAAW,EACX,KAAK,CAAC,mBAAmB,CAAC,kBAAkB,CAAC,SAAS,CACvD,CAAC;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,wBAAwB,EAAE,+BAA+B,CACvD,0BAA0B,EAC1B,KAAK,CAAC,QAAQ,CACf;QACD,0BAA0B;QAC1B,sBAAsB;QACtB,8BAA8B,EAAE,uBAAuB,CAAC,WAAW,EAAE,sBAAsB,CAAC;QAC5F,2BAA2B;QAC3B,eAAe,EACb,KAAK,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,CAAC,eAAe,CAAC;QAC1F,WAAW;KACZ,CAAC,CAAC;AACL,CAAC;AAED,SAAS,kBAAkB,CACzB,KAIE;IAEF,MAAM,IAAI,GAAG,CAAC,OAA0B,EAAiB,EAAE;QACzD,IAAI,KAAK,CAAC,mBAAmB,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC;QACzD,MAAM,QAAQ,GACZ,KAAK,CAAC,uBAAuB,KAAK,SAAS;YACzC,CAAC,CAAC,GAAG,OAAO,MAAM;YAClB,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,CAAC,mBAAmB,MAAM,CAAC;QACpD,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;QAClB,SAAS,EAAE,IAAI,CAAC,WAAW,CAAC;KAC7B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,uBAAuB,CAC9B,WAAmB,EACnB,KAAyD;IAEzD,MAAM,QAAQ,GAAG,CAAC,OAA0B,EAAiB,EAAE;QAC7D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC;QAC5B,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC;IACF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC;QACtB,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC;KACjC,CAAC,CAAC;AACL,CAAC;AAOD,+EAA+E;AAC/E,MAAM,UAAU,yBAAyB,CACvC,KAA8B,EAC9B,OAAe;IAEf,OAAO,CACL,KAAK,CAAC,wBAAwB,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,KAAK,OAAO,CAAC,EAAE,SAAS,IAAI,IAAI,CAC7F,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B,CACtC,0BAAyC,EACzC,QAA2B;IAE3B,IAAI,0BAA0B,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAElE,MAAM,WAAW,GAAqC,EAAE,CAAC;IACzD,MAAM,yBAAyB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5D,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,gBAAgB,GAAG,4BAA4B,CAAC,OAAO,CAAC,CAAC;QAC/D,MAAM,YAAY,GAAG,yBAAyB,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QACrE,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,OAAO,EAAE,CAAC;YAC3D,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QACD,yBAAyB,CAAC,GAAG,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;QACzD,WAAW,CAAC,IAAI,CACd,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,CAAC,0BAA0B,EAAE,gBAAgB,CAAC,EAAE,CAAC,CAC1F,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,SAAS,4BAA4B,CAAC,OAAe;IACnD,OAAO,SAAS,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC;AACrF,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { join, relative, resolve } from \"node:path\";\n\nimport type { DiagnosticChannel } from \"../diagnostic-logging/logger.ts\";\nimport type { DiagnosticLogFileNaming } from \"../controls/contract.ts\";\n\nimport type { ProjectOutputs } from \"../../project-definition/project-definition.ts\";\n\n/**\n * Invocation owner 的 absolute paths；刻意排除 caller-owned cross-Run state、cache storage 和\n * external-tool workspace。\n */\nexport type ResolvedInvocationPaths = Readonly<{\n  /** Check-local absolute directories；保持私有，避免披露 sibling capability。 */\n  readonly checkArtifactDirectories: readonly ResolvedCheckArtifactDirectory[];\n  /** caller 选择的 Check-owned invocation artifact absolute base；未配置时为 `null`。 */\n  readonly checkArtifactBaseDirectory: string | null;\n  /** 按 owner channel 分开的 diagnostic absolute targets。 */\n  readonly diagnosticLoggingFiles: Readonly<Record<DiagnosticChannel, string | null>>;\n  /** 按既有 RunResult-relative contract 投影的 diagnostic channel files。 */\n  readonly diagnosticLoggingReadbackFiles: Readonly<Record<DiagnosticChannel, string | null>>;\n  /** 本次 invocation 的 machine publisher absolute target。 */\n  readonly machinePublicationDirectory: string;\n  /** caller 为本 Run 指定的 progress transcript target；不设置则只保留 terminal。 */\n  readonly progressLogFile: string | null;\n  /** 每个 callback 共享的 absolute effective project root。 */\n  readonly projectRoot: string;\n}>;\n\n/** 在任何 author callback 前恰好一次解析全部 Product-owned invocation target。 */\nexport function resolveInvocationPaths(\n  input: Readonly<{\n    readonly checkArtifactBaseDirectory: string | undefined;\n    readonly checkIds: readonly string[];\n    readonly diagnosticLogFileNaming: DiagnosticLogFileNaming;\n    readonly diagnosticLogSuffix: string | undefined;\n    readonly outputConfiguration: ProjectOutputs;\n    readonly progressLogFile: string | undefined;\n    readonly projectRoot: string;\n  }>\n): ResolvedInvocationPaths {\n  const projectRoot = resolve(input.projectRoot);\n  const checkArtifactBaseDirectory =\n    input.checkArtifactBaseDirectory === undefined\n      ? null\n      : resolve(projectRoot, input.checkArtifactBaseDirectory);\n  const diagnosticDirectory = resolve(\n    projectRoot,\n    input.outputConfiguration.diagnosticLogging.directory\n  );\n  const diagnosticLoggingFiles = diagnosticFilesFor({\n    diagnosticDirectory,\n    diagnosticLogFileNaming: input.diagnosticLogFileNaming,\n    diagnosticLogSuffix: input.diagnosticLogSuffix\n  });\n  const machinePublicationDirectory = resolve(\n    projectRoot,\n    input.outputConfiguration.machinePublication.directory\n  );\n\n  return Object.freeze({\n    checkArtifactDirectories: resolveCheckArtifactDirectories(\n      checkArtifactBaseDirectory,\n      input.checkIds\n    ),\n    checkArtifactBaseDirectory,\n    diagnosticLoggingFiles,\n    diagnosticLoggingReadbackFiles: diagnosticReadbackFiles(projectRoot, diagnosticLoggingFiles),\n    machinePublicationDirectory,\n    progressLogFile:\n      input.progressLogFile === undefined ? null : resolve(projectRoot, input.progressLogFile),\n    projectRoot\n  });\n}\n\nfunction diagnosticFilesFor(\n  input: Readonly<{\n    readonly diagnosticDirectory: string;\n    readonly diagnosticLogFileNaming: DiagnosticLogFileNaming;\n    readonly diagnosticLogSuffix: string | undefined;\n  }>\n): Readonly<Record<DiagnosticChannel, string | null>> {\n  const file = (channel: DiagnosticChannel): string | null => {\n    if (input.diagnosticLogSuffix === undefined) return null;\n    const basename =\n      input.diagnosticLogFileNaming === \"channel\"\n        ? `${channel}.log`\n        : `${channel}-${input.diagnosticLogSuffix}.log`;\n    return join(input.diagnosticDirectory, basename);\n  };\n  return Object.freeze({\n    core: file(\"core\"),\n    scheduler: file(\"scheduler\")\n  });\n}\n\nfunction diagnosticReadbackFiles(\n  projectRoot: string,\n  files: Readonly<Record<DiagnosticChannel, string | null>>\n): Readonly<Record<DiagnosticChannel, string | null>> {\n  const readback = (channel: DiagnosticChannel): string | null => {\n    const file = files[channel];\n    return file === null ? null : relative(projectRoot, file);\n  };\n  return Object.freeze({\n    core: readback(\"core\"),\n    scheduler: readback(\"scheduler\")\n  });\n}\n\ntype ResolvedCheckArtifactDirectory = Readonly<{\n  readonly checkId: string;\n  readonly directory: string;\n}>;\n\n/** 只返回当前 Check-local artifact directory，不向 callback 暴露 sibling directories。 */\nexport function artifactDirectoryForCheck(\n  paths: ResolvedInvocationPaths,\n  checkId: string\n): string | null {\n  return (\n    paths.checkArtifactDirectories.find((entry) => entry.checkId === checkId)?.directory ?? null\n  );\n}\n\nfunction resolveCheckArtifactDirectories(\n  checkArtifactBaseDirectory: string | null,\n  checkIds: readonly string[]\n): readonly ResolvedCheckArtifactDirectory[] {\n  if (checkArtifactBaseDirectory === null) return Object.freeze([]);\n\n  const directories: ResolvedCheckArtifactDirectory[] = [];\n  const checkIdByEncodedDirectory = new Map<string, string>();\n  for (const checkId of checkIds) {\n    const encodedDirectory = encodeCheckArtifactDirectory(checkId);\n    const priorCheckId = checkIdByEncodedDirectory.get(encodedDirectory);\n    if (priorCheckId !== undefined && priorCheckId !== checkId) {\n      throw new Error(\"Distinct Check IDs resolved to one artifact directory\");\n    }\n    checkIdByEncodedDirectory.set(encodedDirectory, checkId);\n    directories.push(\n      Object.freeze({ checkId, directory: join(checkArtifactBaseDirectory, encodedDirectory) })\n    );\n  }\n  return Object.freeze(directories);\n}\n\n/**\n * SHA-256 base64url component 不包含分隔符或 traversal token，且远低于常规 filesystem component length。\n * raw Check ID 仍由既有 facts 保存。\n */\nfunction encodeCheckArtifactDirectory(checkId: string): string {\n  return `check-${createHash(\"sha256\").update(checkId, \"utf8\").digest(\"base64url\")}`;\n}\n"]}