@zxyycom/vibe-check 0.0.1 → 0.0.2

package/dist/esm/project-run/diagnostic-logging/logger.mjs

@@ -1,22 +1,114 @@
 import { closeSync, mkdirSync, openSync, writeSync } from "node:fs";
 import { dirname } from "node:path";
-import { renderSafeDiagnosticDetail } from "./diagnostic-detail-rendering.mjs";
+import { renderDiagnosticObservation } from "./observation-rendering.mjs";
 export { summarizeDiagnosticValue } from "./diagnostic-detail-rendering.mjs";
+export const DIAGNOSTIC_CHANNELS = ["core", "scheduler"];
+/**
+ * Creates one direct channel writer. The invocation router normally supplies correlation; retaining this
+ * construction function keeps focused writer tests independent of multi-channel invocation wiring.
+ */
 export const createDiagnosticLogger = (input) => {
     if (!input.enabled || input.file === null)
         return disabledLogger();
     return createEnabledLogger({ clock: input.clock, file: input.file });
 };
+/**
+ * Builds the minimal owner-neutral router. It has no subscriber registry: the Product owners are
+ * explicit fields, each writer is isolated, and one shared sequence/clock is assigned before delegation.
+ */
+export function createDiagnosticLoggingRouter(input) {
+    if (input.coreFile === null && input.schedulerFile === null)
+        return disabledDiagnosticLoggingRouter();
+    const startedAt = safeNow(input.clock);
+    let sequence = 0;
+    const route = (file) => {
+        if (file === null)
+            return disabledLogger();
+        return createRoutedLogger({
+            clock: input.clock,
+            factory: input.factory,
+            file,
+            nextCorrelation: () => Object.freeze({
+                elapsedMs: elapsedSince(startedAt, input.clock),
+                invocationId: input.invocationId,
+                sequence: ++sequence
+            })
+        });
+    };
+    const core = route(input.coreFile);
+    const scheduler = route(input.schedulerFile);
+    return Object.freeze({
+        core,
+        scheduler,
+        close: () => Object.freeze({
+            core: core.close(),
+            scheduler: scheduler.close()
+        })
+    });
+}
 /** Builds one immutable set of human-filterable diagnostic labels. */
 export function diagnosticTags(...tags) {
     return Object.freeze([...tags]);
 }
+/** Correlates one channel while containing its factory, write, and close lifecycle. */
+function createRoutedLogger(input) {
+    let delegate;
+    let closed = false;
+    let failed = false;
+    try {
+        delegate = input.factory({ clock: input.clock, enabled: true, file: input.file });
+    }
+    catch {
+        failed = true;
+    }
+    return Object.freeze({
+        close: () => {
+            if (closed)
+                return failed ? "failed" : "succeeded";
+            closed = true;
+            if (delegate === undefined)
+                return "failed";
+            try {
+                const status = delegate.close();
+                failed ||= status === "failed";
+            }
+            catch {
+                failed = true;
+            }
+            return failed ? "failed" : "succeeded";
+        },
+        observe: (observation) => {
+            if (closed)
+                return;
+            const correlation = input.nextCorrelation();
+            if (failed || delegate === undefined)
+                return;
+            try {
+                delegate.observe(Object.freeze({ ...observation, correlation }));
+            }
+            catch {
+                failed = true;
+            }
+        }
+    });
+}
 function disabledLogger() {
     return Object.freeze({
         close: () => "disabled",
         observe: () => undefined
     });
 }
+function disabledDiagnosticLoggingRouter() {
+    const disabled = disabledLogger();
+    return Object.freeze({
+        core: disabled,
+        scheduler: disabled,
+        close: () => Object.freeze({
+            core: "disabled",
+            scheduler: "disabled"
+        })
+    });
+}
 function createEnabledLogger(input) {
     let descriptor;
     let failed = false;
@@ -46,12 +138,15 @@ function createEnabledLogger(input) {
             if (failed || descriptor === undefined)
                 return;
             try {
-                const buffer = renderObservation({
-                    elapsedMs: elapsedSince(startedAt, input.clock),
+                const correlation = observation.correlation;
+                const buffer = renderDiagnosticObservation({
+                    elapsedMs: correlation?.elapsedMs ?? elapsedSince(startedAt, input.clock),
+                    invocationId: correlation?.invocationId,
                     observation,
-                    sequence: sequence + 1
+                    sequence: correlation?.sequence ?? sequence + 1
                 });
-                sequence += 1;
+                if (correlation === undefined)
+                    sequence += 1;
                 writeBuffer(descriptor, buffer);
             }
             catch {
@@ -70,162 +165,6 @@ function writeBuffer(descriptor, buffer) {
         offset += written;
     }
 }
-function renderObservation(input) {
-    const tags = input.observation.tags.map((tag) => `[${escapeLogHeaderField(tag)}]`).join(" ");
-    const header = `#${String(input.sequence).padStart(6, "0")} +${formatElapsed(input.elapsedMs)} ${tags} ${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")) {
-        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")}`;
-}
 function safeNow(clock) {
     try {
         const now = clock.now();

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

@@ -1 +1 @@
-{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["../../../../src/project-run/diagnostic-logging/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { closeSync, mkdirSync, openSync, writeSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nimport type { CheckExecutionClock } from \"../check-execution/resolved-checks.ts\";\nimport { renderSafeDiagnosticDetail } from \"./diagnostic-detail-rendering.ts\";\nexport { summarizeDiagnosticValue } from \"./diagnostic-detail-rendering.ts\";\n\n/** Product-private observation written synchronously at the fact owner. */\nexport interface DiagnosticObservation {\n  readonly details?: unknown;\n  readonly event: string;\n  readonly tags: readonly string[];\n}\n\n/** Product-private invocation logger; its failures never escape lifecycle owners. */\nexport interface DiagnosticLogger {\n  close(): \"disabled\" | \"failed\" | \"succeeded\";\n  observe(observation: DiagnosticObservation): void;\n}\n\n/** A bounded, descriptor-safe description for normal diagnostic payloads. */\nexport type DiagnosticValueSummary =\n  | Readonly<{\n      readonly availability: \"available\";\n      readonly bytes: number;\n      readonly items?: number;\n      readonly keys?: number;\n      readonly shape: \"array\" | \"boolean\" | \"null\" | \"number\" | \"object\" | \"string\";\n    }>\n  | Readonly<{ readonly availability: \"unavailable\"; readonly reason: string }>;\n\n/** Test-only construction seam; Product invocation owns its lifecycle and output mapping. */\nexport type DiagnosticLoggerFactory = (\n  input: Readonly<{\n    readonly clock: CheckExecutionClock;\n    readonly enabled: boolean;\n    readonly file: string | null;\n  }>\n) => DiagnosticLogger;\n\nexport const createDiagnosticLogger: DiagnosticLoggerFactory = (input) => {\n  if (!input.enabled || input.file === null) return disabledLogger();\n  return createEnabledLogger({ clock: input.clock, file: input.file });\n};\n\n/** Builds one immutable set of human-filterable diagnostic labels. */\nexport function diagnosticTags(...tags: readonly string[]): readonly string[] {\n  return Object.freeze([...tags]);\n}\n\nfunction disabledLogger(): DiagnosticLogger {\n  return Object.freeze({\n    close: () => \"disabled\" as const,\n    observe: () => undefined\n  });\n}\n\nfunction createEnabledLogger(\n  input: Readonly<{\n    readonly clock: CheckExecutionClock;\n    readonly file: string;\n  }>\n): DiagnosticLogger {\n  let descriptor: number | undefined;\n  let failed = false;\n  let sequence = 0;\n  const startedAt = safeNow(input.clock);\n\n  try {\n    mkdirSync(dirname(input.file), { recursive: true });\n    descriptor = openSync(input.file, \"wx\");\n  } catch {\n    failed = true;\n  }\n\n  return Object.freeze({\n    close: () => {\n      if (descriptor !== undefined) {\n        try {\n          closeSync(descriptor);\n        } catch {\n          failed = true;\n        }\n        descriptor = undefined;\n      }\n      return failed ? \"failed\" : \"succeeded\";\n    },\n    observe: (observation: DiagnosticObservation) => {\n      if (failed || descriptor === undefined) return;\n      try {\n        const buffer = renderObservation({\n          elapsedMs: elapsedSince(startedAt, input.clock),\n          observation,\n          sequence: sequence + 1\n        });\n        sequence += 1;\n        writeBuffer(descriptor, buffer);\n      } catch {\n        failed = true;\n      }\n    }\n  });\n}\n\nfunction writeBuffer(descriptor: number, buffer: string): void {\n  const bytes = Buffer.from(buffer, \"utf8\");\n  let offset = 0;\n  while (offset < bytes.length) {\n    const written = writeSync(descriptor, bytes, offset, bytes.length - offset, null);\n    if (written <= 0) throw new Error(\"Diagnostic log append made no progress\");\n    offset += written;\n  }\n}\n\nfunction renderObservation(\n  input: Readonly<{\n    readonly elapsedMs: number;\n    readonly observation: DiagnosticObservation;\n    readonly sequence: number;\n  }>\n): string {\n  const tags = input.observation.tags.map((tag) => `[${escapeLogHeaderField(tag)}]`).join(\" \");\n  const header = `#${String(input.sequence).padStart(6, \"0\")} +${formatElapsed(input.elapsedMs)} ${tags} ${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\")) {\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\nfunction safeNow(clock: CheckExecutionClock): number {\n  try {\n    const now = clock.now();\n    return Number.isFinite(now) ? now : 0;\n  } catch {\n    return 0;\n  }\n}\n\nfunction elapsedSince(startedAt: number, clock: CheckExecutionClock): number {\n  const elapsed = safeNow(clock) - startedAt;\n  return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;\n}\n"]}
+{"version":3,"file":"logger.mjs","sourceRoot":"","sources":["../../../../src/project-run/diagnostic-logging/logger.ts"],"names":[],"mappings":"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","sourcesContent":["import { closeSync, mkdirSync, openSync, writeSync } from \"node:fs\";\nimport { dirname } from \"node:path\";\n\nimport type { CheckExecutionClock } from \"../check-execution/resolved-checks.ts\";\nimport { renderDiagnosticObservation } from \"./observation-rendering.ts\";\nexport { summarizeDiagnosticValue } from \"./diagnostic-detail-rendering.ts\";\n\nexport const DIAGNOSTIC_CHANNELS = [\"core\", \"scheduler\"] as const;\nexport type DiagnosticChannel = (typeof DIAGNOSTIC_CHANNELS)[number];\nexport type DiagnosticChannelStatus = \"disabled\" | \"failed\" | \"succeeded\";\n\n/** Product-private observation written synchronously at its output owner. */\nexport interface DiagnosticObservation {\n  /** Router-owned correlation, added before any channel write and never authored by Check code. */\n  readonly correlation?: Readonly<{\n    readonly elapsedMs: number;\n    readonly invocationId: string;\n    readonly sequence: number;\n  }>;\n  readonly details?: unknown;\n  readonly event: string;\n  readonly tags: readonly string[];\n}\n\n/** One channel writer. Its failures never escape the lifecycle owner that emits an observation. */\nexport interface DiagnosticLogger {\n  close(): DiagnosticChannelStatus;\n  observe(observation: DiagnosticObservation): void;\n}\n\n/** The invocation-local router is the sole Product correlation and channel-routing owner. */\nexport interface DiagnosticLoggingRouter {\n  readonly core: DiagnosticLogger;\n  readonly scheduler: DiagnosticLogger;\n  close(): Readonly<Record<DiagnosticChannel, DiagnosticChannelStatus>>;\n}\n\n/** A bounded, descriptor-safe description for normal diagnostic payloads. */\nexport type DiagnosticValueSummary =\n  | Readonly<{\n      readonly availability: \"available\";\n      readonly bytes: number;\n      readonly items?: number;\n      readonly keys?: number;\n      readonly shape: \"array\" | \"boolean\" | \"null\" | \"number\" | \"object\" | \"string\";\n    }>\n  | Readonly<{ readonly availability: \"unavailable\"; readonly reason: string }>;\n\n/** Test-only construction seam; invocation construction owns all three channel lifecycles. */\nexport type DiagnosticLoggerFactory = (\n  input: Readonly<{\n    readonly clock: CheckExecutionClock;\n    readonly enabled: boolean;\n    readonly file: string | null;\n  }>\n) => DiagnosticLogger;\n\n/**\n * Creates one direct channel writer. The invocation router normally supplies correlation; retaining this\n * construction function keeps focused writer tests independent of multi-channel invocation wiring.\n */\nexport const createDiagnosticLogger: DiagnosticLoggerFactory = (input) => {\n  if (!input.enabled || input.file === null) return disabledLogger();\n  return createEnabledLogger({ clock: input.clock, file: input.file });\n};\n\n/**\n * Builds the minimal owner-neutral router. It has no subscriber registry: the Product owners are\n * explicit fields, each writer is isolated, and one shared sequence/clock is assigned before delegation.\n */\nexport function createDiagnosticLoggingRouter(\n  input: Readonly<{\n    readonly clock: CheckExecutionClock;\n    readonly coreFile: string | null;\n    readonly factory: DiagnosticLoggerFactory;\n    readonly invocationId: string;\n    readonly schedulerFile: string | null;\n  }>\n): DiagnosticLoggingRouter {\n  if (input.coreFile === null && input.schedulerFile === null)\n    return disabledDiagnosticLoggingRouter();\n  const startedAt = safeNow(input.clock);\n  let sequence = 0;\n  const route = (file: string | null): DiagnosticLogger => {\n    if (file === null) return disabledLogger();\n    return createRoutedLogger({\n      clock: input.clock,\n      factory: input.factory,\n      file,\n      nextCorrelation: () =>\n        Object.freeze({\n          elapsedMs: elapsedSince(startedAt, input.clock),\n          invocationId: input.invocationId,\n          sequence: ++sequence\n        })\n    });\n  };\n  const core = route(input.coreFile);\n  const scheduler = route(input.schedulerFile);\n  return Object.freeze({\n    core,\n    scheduler,\n    close: () =>\n      Object.freeze({\n        core: core.close(),\n        scheduler: scheduler.close()\n      })\n  });\n}\n\n/** Builds one immutable set of human-filterable diagnostic labels. */\nexport function diagnosticTags(...tags: readonly string[]): readonly string[] {\n  return Object.freeze([...tags]);\n}\n\n/** Correlates one channel while containing its factory, write, and close lifecycle. */\nfunction createRoutedLogger(\n  input: Readonly<{\n    readonly clock: CheckExecutionClock;\n    readonly factory: DiagnosticLoggerFactory;\n    readonly file: string;\n    readonly nextCorrelation: () => NonNullable<DiagnosticObservation[\"correlation\"]>;\n  }>\n): DiagnosticLogger {\n  let delegate: DiagnosticLogger | undefined;\n  let closed = false;\n  let failed = false;\n  try {\n    delegate = input.factory({ clock: input.clock, enabled: true, file: input.file });\n  } catch {\n    failed = true;\n  }\n  return Object.freeze({\n    close: (): DiagnosticChannelStatus => {\n      if (closed) return failed ? \"failed\" : \"succeeded\";\n      closed = true;\n      if (delegate === undefined) return \"failed\";\n      try {\n        const status = delegate.close();\n        failed ||= status === \"failed\";\n      } catch {\n        failed = true;\n      }\n      return failed ? \"failed\" : \"succeeded\";\n    },\n    observe: (observation: DiagnosticObservation): void => {\n      if (closed) return;\n      const correlation = input.nextCorrelation();\n      if (failed || delegate === undefined) return;\n      try {\n        delegate.observe(Object.freeze({ ...observation, correlation }));\n      } catch {\n        failed = true;\n      }\n    }\n  });\n}\n\nfunction disabledLogger(): DiagnosticLogger {\n  return Object.freeze({\n    close: () => \"disabled\" as const,\n    observe: () => undefined\n  });\n}\n\nfunction disabledDiagnosticLoggingRouter(): DiagnosticLoggingRouter {\n  const disabled = disabledLogger();\n  return Object.freeze({\n    core: disabled,\n    scheduler: disabled,\n    close: () =>\n      Object.freeze({\n        core: \"disabled\" as const,\n        scheduler: \"disabled\" as const\n      })\n  });\n}\n\nfunction createEnabledLogger(\n  input: Readonly<{\n    readonly clock: CheckExecutionClock;\n    readonly file: string;\n  }>\n): DiagnosticLogger {\n  let descriptor: number | undefined;\n  let failed = false;\n  let sequence = 0;\n  const startedAt = safeNow(input.clock);\n\n  try {\n    mkdirSync(dirname(input.file), { recursive: true });\n    descriptor = openSync(input.file, \"wx\");\n  } catch {\n    failed = true;\n  }\n\n  return Object.freeze({\n    close: () => {\n      if (descriptor !== undefined) {\n        try {\n          closeSync(descriptor);\n        } catch {\n          failed = true;\n        }\n        descriptor = undefined;\n      }\n      return failed ? \"failed\" : \"succeeded\";\n    },\n    observe: (observation: DiagnosticObservation) => {\n      if (failed || descriptor === undefined) return;\n      try {\n        const correlation = observation.correlation;\n        const buffer = renderDiagnosticObservation({\n          elapsedMs: correlation?.elapsedMs ?? elapsedSince(startedAt, input.clock),\n          invocationId: correlation?.invocationId,\n          observation,\n          sequence: correlation?.sequence ?? sequence + 1\n        });\n        if (correlation === undefined) sequence += 1;\n        writeBuffer(descriptor, buffer);\n      } catch {\n        failed = true;\n      }\n    }\n  });\n}\n\nfunction writeBuffer(descriptor: number, buffer: string): void {\n  const bytes = Buffer.from(buffer, \"utf8\");\n  let offset = 0;\n  while (offset < bytes.length) {\n    const written = writeSync(descriptor, bytes, offset, bytes.length - offset, null);\n    if (written <= 0) throw new Error(\"Diagnostic log append made no progress\");\n    offset += written;\n  }\n}\n\nfunction safeNow(clock: CheckExecutionClock): number {\n  try {\n    const now = clock.now();\n    return Number.isFinite(now) ? now : 0;\n  } catch {\n    return 0;\n  }\n}\n\nfunction elapsedSince(startedAt: number, clock: CheckExecutionClock): number {\n  const elapsed = safeNow(clock) - startedAt;\n  return Number.isFinite(elapsed) && elapsed >= 0 ? elapsed : 0;\n}\n"]}

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")) {
+        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\")) {\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,61 @@
+import { aggregateCheckOutcomes } 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);
+    invocation.progressRendering.final({
+        counts: outcomeCounts(executed.snapshot),
+        elapsedMs: elapsedSince(input.executionStartedAt, invocation.clock),
+        execution: executed.kind
+    });
+    if (executed.kind === "cancelled")
+        return cancelledExecutionCandidate(invocation, executed);
+    return completedExecutionCandidate(invocation, input.aggregation, executed);
+}
+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) {
+    const aggregate = aggregation === undefined
+        ? null
+        : aggregateCheckOutcomes(executed.snapshot, aggregation, executed.effectiveCheckIds);
+    invocation.diagnosticLogging.core.observe({
+        event: "run.aggregation.completed",
+        tags: diagnosticTags("RUN", "AGGREGATION", "COMPLETED"),
+        details: { aggregate, selection: aggregation ?? null }
+    });
+    const core = Object.freeze({
+        aggregate,
+        checkDurations: executed.checkDurations,
+        checkMessages: executed.checkMessages,
+        snapshot: executed.snapshot
+    });
+    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 { aggregateCheckOutcomes } 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  invocation.progressRendering.final({\n    counts: outcomeCounts(executed.snapshot),\n    elapsedMs: elapsedSince(input.executionStartedAt, invocation.clock),\n    execution: executed.kind\n  });\n\n  if (executed.kind === \"cancelled\") return cancelledExecutionCandidate(invocation, executed);\n  return completedExecutionCandidate(invocation, input.aggregation, executed);\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): NonConfigurationRunResult {\n  const aggregate =\n    aggregation === undefined\n      ? null\n      : aggregateCheckOutcomes(executed.snapshot, aggregation, executed.effectiveCheckIds);\n  invocation.diagnosticLogging.core.observe({\n    event: \"run.aggregation.completed\",\n    tags: diagnosticTags(\"RUN\", \"AGGREGATION\", \"COMPLETED\"),\n    details: { aggregate, selection: aggregation ?? null }\n  });\n  const core: CoreExecution = Object.freeze({\n    aggregate,\n    checkDurations: executed.checkDurations,\n    checkMessages: executed.checkMessages,\n    snapshot: executed.snapshot\n  });\n  return completeInvocation(invocation, core);\n}\n"]}