@zxyycom/vibe-check 0.0.1 → 0.0.2

package/dist/esm/project-run/progress-rendering/renderer-lifecycle.mjs

@@ -1,17 +1,20 @@
-import { formatFinalSummary, formatRunningRow, formatSettledBlock, shouldPresentSettledFeedback } from "./renderer-formatting.mjs";
+import { formatFlagConditionNotMatchedBlock, formatFinalSummary, formatRunningRow, formatSettledBlock, isFlagConditionNotMatchedFeedback, shouldPresentSettledFeedback } from "./renderer-formatting.mjs";
 /** Maintains the mutable lifecycle state and the TTY-only running terminal region. */
 export class ProgressRendererController {
     refreshesRunningRegion;
     clock;
     writer;
     completedCount = 0;
+    flagConditionNotMatchedDisplayNames = [];
     preparedTotal;
     renderedRunningRows = 0;
     running = [];
     usesColor;
-    constructor(writer, clock) {
+    progressRendering;
+    constructor(writer, clock, progressRendering) {
         this.writer = writer;
         this.clock = clock;
+        this.progressRendering = progressRendering;
         this.refreshesRunningRegion = writer.isTTY && writer.term?.toLowerCase() !== "dumb";
         this.usesColor = this.refreshesRunningRegion && writer.color;
     }
@@ -28,6 +31,9 @@ export class ProgressRendererController {
             case "prepared":
                 this.prepare(feedback.totalChecks);
                 return;
+            case "flag-control-completed":
+                this.completeFlagControl();
+                return;
             case "started":
                 this.start(feedback);
                 return;
@@ -63,15 +69,20 @@ export class ProgressRendererController {
             this.eraseRunningRegion();
         this.completedCount += 1;
         this.removeRunningCheck(feedback.checkId);
-        if (shouldPresentSettledFeedback(feedback)) {
+        if (isFlagConditionNotMatchedFeedback(feedback)) {
+            this.flagConditionNotMatchedDisplayNames.push(feedback.displayName);
+        }
+        else if (shouldPresentSettledFeedback(feedback)) {
             this.writer.write(formatSettledBlock({
                 completionOrdinal: this.completedCount,
                 displayName: feedback.displayName,
                 durationMs: feedback.durationMs,
                 messages: feedback.messages,
                 outcome: feedback.outcome,
+                records: feedback.records,
                 totalChecks,
-                usesColor: this.usesColor
+                usesColor: this.usesColor,
+                progressRendering: this.progressRendering
             }));
         }
         if (this.refreshesRunningRegion)
@@ -82,8 +93,23 @@ export class ProgressRendererController {
         if (this.running.length > 0) {
             throw new Error("Progress feedback finalized while Checks are still running");
         }
+        this.flushFlagConditionNotMatchedChecks();
         this.writer.write(formatFinalSummary(feedback));
     }
+    completeFlagControl() {
+        this.requirePrepared();
+        this.flushFlagConditionNotMatchedChecks();
+    }
+    flushFlagConditionNotMatchedChecks() {
+        const firstDisplayName = this.flagConditionNotMatchedDisplayNames[0];
+        if (firstDisplayName === undefined)
+            return;
+        this.writer.write(formatFlagConditionNotMatchedBlock([
+            firstDisplayName,
+            ...this.flagConditionNotMatchedDisplayNames.slice(1)
+        ]));
+        this.flagConditionNotMatchedDisplayNames.length = 0;
+    }
     eraseRunningRegion() {
         for (let index = 0; index < this.renderedRunningRows; index += 1) {
             this.writer.write("\u001B[1A\u001B[2K");

package/dist/esm/project-run/progress-rendering/renderer-lifecycle.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"renderer-lifecycle.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ProgressClock,\n  ProgressFeedback,\n  ProgressRenderer,\n  ProgressWriter\n} from \"./renderer.ts\";\nimport {\n  formatFinalSummary,\n  formatRunningRow,\n  formatSettledBlock,\n  shouldPresentSettledFeedback\n} from \"./renderer-formatting.ts\";\n\ninterface RunningCheck {\n  readonly checkId: string;\n  readonly displayName: string;\n  readonly startedAtMs: number;\n  elapsedMs: number | null;\n}\n\n/** Maintains the mutable lifecycle state and the TTY-only running terminal region. */\nexport class ProgressRendererController implements ProgressRenderer {\n  readonly refreshesRunningRegion: boolean;\n\n  private readonly clock: ProgressClock;\n  private readonly writer: ProgressWriter;\n  private completedCount = 0;\n  private preparedTotal: number | undefined;\n  private renderedRunningRows = 0;\n  private readonly running: RunningCheck[] = [];\n  private readonly usesColor: boolean;\n\n  constructor(writer: ProgressWriter, clock: ProgressClock) {\n    this.writer = writer;\n    this.clock = clock;\n    this.refreshesRunningRegion = writer.isTTY && writer.term?.toLowerCase() !== \"dumb\";\n    this.usesColor = this.refreshesRunningRegion && writer.color;\n  }\n\n  refresh(): void {\n    if (!this.refreshesRunningRegion || this.running.length === 0) return;\n    this.requirePrepared();\n    this.eraseRunningRegion();\n    this.updateRunningDurations(this.clock.now());\n    this.redrawRunningRegion();\n  }\n\n  render(feedback: ProgressFeedback): void {\n    switch (feedback.kind) {\n      case \"prepared\":\n        this.prepare(feedback.totalChecks);\n        return;\n      case \"started\":\n        this.start(feedback);\n        return;\n      case \"settled\":\n        this.settle(feedback);\n        return;\n      case \"final\":\n        this.finish(feedback);\n    }\n  }\n\n  private prepare(totalChecks: number): void {\n    if (this.preparedTotal !== undefined) throw new Error(\"Progress feedback was prepared twice\");\n    this.preparedTotal = totalChecks;\n    this.writer.write(`Vibe Check\\ntotal ${totalChecks} checks\\n\\nChecks:\\n`);\n  }\n\n  private start(feedback: Extract<ProgressFeedback, { readonly kind: \"started\" }>): void {\n    if (!this.refreshesRunningRegion) return;\n    this.requirePrepared();\n    this.eraseRunningRegion();\n    this.running.push({\n      checkId: feedback.checkId,\n      displayName: feedback.displayName,\n      elapsedMs: null,\n      startedAtMs: this.clock.now()\n    });\n    this.redrawRunningRegion();\n  }\n\n  private settle(feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>): void {\n    const totalChecks = this.requirePrepared();\n    if (this.refreshesRunningRegion) this.eraseRunningRegion();\n    this.completedCount += 1;\n    this.removeRunningCheck(feedback.checkId);\n    if (shouldPresentSettledFeedback(feedback)) {\n      this.writer.write(\n        formatSettledBlock({\n          completionOrdinal: this.completedCount,\n          displayName: feedback.displayName,\n          durationMs: feedback.durationMs,\n          messages: feedback.messages,\n          outcome: feedback.outcome,\n          totalChecks,\n          usesColor: this.usesColor\n        })\n      );\n    }\n    if (this.refreshesRunningRegion) this.redrawRunningRegion();\n  }\n\n  private finish(feedback: Extract<ProgressFeedback, { readonly kind: \"final\" }>): void {\n    this.requirePrepared();\n    if (this.running.length > 0) {\n      throw new Error(\"Progress feedback finalized while Checks are still running\");\n    }\n    this.writer.write(formatFinalSummary(feedback));\n  }\n\n  private eraseRunningRegion(): void {\n    for (let index = 0; index < this.renderedRunningRows; index += 1) {\n      this.writer.write(\"\\u001B[1A\\u001B[2K\");\n    }\n    this.renderedRunningRows = 0;\n  }\n\n  private redrawRunningRegion(): void {\n    const totalChecks = this.requirePrepared();\n    for (const [index, check] of this.running.entries()) {\n      this.writer.write(\n        formatRunningRow({\n          displayIndex: this.completedCount + index + 1,\n          displayName: check.displayName,\n          elapsedMs: check.elapsedMs,\n          totalChecks\n        })\n      );\n    }\n    this.renderedRunningRows = this.running.length;\n  }\n\n  private removeRunningCheck(checkId: string): void {\n    const index = this.running.findIndex((check) => check.checkId === checkId);\n    if (index >= 0) this.running.splice(index, 1);\n  }\n\n  private updateRunningDurations(refreshedAtMs: number): void {\n    for (const check of this.running) {\n      const elapsedMs = refreshedAtMs - check.startedAtMs;\n      check.elapsedMs = Number.isFinite(elapsedMs) && elapsedMs >= 0 ? elapsedMs : 0;\n    }\n  }\n\n  private requirePrepared(): number {\n    if (this.preparedTotal === undefined) {\n      throw new Error(\"Progress feedback arrived before preparation\");\n    }\n    return this.preparedTotal;\n  }\n}\n"]}
+{"version":3,"file":"renderer-lifecycle.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer-lifecycle.ts"],"names":[],"mappings":"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","sourcesContent":["import type {\n  ProgressClock,\n  ProgressFeedback,\n  ProgressRenderer,\n  ProgressWriter\n} from \"./renderer.ts\";\nimport type { ResolvedProgressRenderingOutput } from \"../../project-definition/project-definition.ts\";\nimport {\n  formatFlagConditionNotMatchedBlock,\n  formatFinalSummary,\n  formatRunningRow,\n  formatSettledBlock,\n  isFlagConditionNotMatchedFeedback,\n  shouldPresentSettledFeedback\n} from \"./renderer-formatting.ts\";\n\ninterface RunningCheck {\n  readonly checkId: string;\n  readonly displayName: string;\n  readonly startedAtMs: number;\n  elapsedMs: number | null;\n}\n\n/** Maintains the mutable lifecycle state and the TTY-only running terminal region. */\nexport class ProgressRendererController implements ProgressRenderer {\n  readonly refreshesRunningRegion: boolean;\n\n  private readonly clock: ProgressClock;\n  private readonly writer: ProgressWriter;\n  private completedCount = 0;\n  private readonly flagConditionNotMatchedDisplayNames: string[] = [];\n  private preparedTotal: number | undefined;\n  private renderedRunningRows = 0;\n  private readonly running: RunningCheck[] = [];\n  private readonly usesColor: boolean;\n  private readonly progressRendering: ResolvedProgressRenderingOutput;\n\n  constructor(\n    writer: ProgressWriter,\n    clock: ProgressClock,\n    progressRendering: ResolvedProgressRenderingOutput\n  ) {\n    this.writer = writer;\n    this.clock = clock;\n    this.progressRendering = progressRendering;\n    this.refreshesRunningRegion = writer.isTTY && writer.term?.toLowerCase() !== \"dumb\";\n    this.usesColor = this.refreshesRunningRegion && writer.color;\n  }\n\n  refresh(): void {\n    if (!this.refreshesRunningRegion || this.running.length === 0) return;\n    this.requirePrepared();\n    this.eraseRunningRegion();\n    this.updateRunningDurations(this.clock.now());\n    this.redrawRunningRegion();\n  }\n\n  render(feedback: ProgressFeedback): void {\n    switch (feedback.kind) {\n      case \"prepared\":\n        this.prepare(feedback.totalChecks);\n        return;\n      case \"flag-control-completed\":\n        this.completeFlagControl();\n        return;\n      case \"started\":\n        this.start(feedback);\n        return;\n      case \"settled\":\n        this.settle(feedback);\n        return;\n      case \"final\":\n        this.finish(feedback);\n    }\n  }\n\n  private prepare(totalChecks: number): void {\n    if (this.preparedTotal !== undefined) throw new Error(\"Progress feedback was prepared twice\");\n    this.preparedTotal = totalChecks;\n    this.writer.write(`Vibe Check\\ntotal ${totalChecks} checks\\n\\nChecks:\\n`);\n  }\n\n  private start(feedback: Extract<ProgressFeedback, { readonly kind: \"started\" }>): void {\n    if (!this.refreshesRunningRegion) return;\n    this.requirePrepared();\n    this.eraseRunningRegion();\n    this.running.push({\n      checkId: feedback.checkId,\n      displayName: feedback.displayName,\n      elapsedMs: null,\n      startedAtMs: this.clock.now()\n    });\n    this.redrawRunningRegion();\n  }\n\n  private settle(feedback: Extract<ProgressFeedback, { readonly kind: \"settled\" }>): void {\n    const totalChecks = this.requirePrepared();\n    if (this.refreshesRunningRegion) this.eraseRunningRegion();\n    this.completedCount += 1;\n    this.removeRunningCheck(feedback.checkId);\n    if (isFlagConditionNotMatchedFeedback(feedback)) {\n      this.flagConditionNotMatchedDisplayNames.push(feedback.displayName);\n    } else if (shouldPresentSettledFeedback(feedback)) {\n      this.writer.write(\n        formatSettledBlock({\n          completionOrdinal: this.completedCount,\n          displayName: feedback.displayName,\n          durationMs: feedback.durationMs,\n          messages: feedback.messages,\n          outcome: feedback.outcome,\n          records: feedback.records,\n          totalChecks,\n          usesColor: this.usesColor,\n          progressRendering: this.progressRendering\n        })\n      );\n    }\n    if (this.refreshesRunningRegion) this.redrawRunningRegion();\n  }\n\n  private finish(feedback: Extract<ProgressFeedback, { readonly kind: \"final\" }>): void {\n    this.requirePrepared();\n    if (this.running.length > 0) {\n      throw new Error(\"Progress feedback finalized while Checks are still running\");\n    }\n    this.flushFlagConditionNotMatchedChecks();\n    this.writer.write(formatFinalSummary(feedback));\n  }\n\n  private completeFlagControl(): void {\n    this.requirePrepared();\n    this.flushFlagConditionNotMatchedChecks();\n  }\n\n  private flushFlagConditionNotMatchedChecks(): void {\n    const firstDisplayName = this.flagConditionNotMatchedDisplayNames[0];\n    if (firstDisplayName === undefined) return;\n    this.writer.write(\n      formatFlagConditionNotMatchedBlock([\n        firstDisplayName,\n        ...this.flagConditionNotMatchedDisplayNames.slice(1)\n      ])\n    );\n    this.flagConditionNotMatchedDisplayNames.length = 0;\n  }\n\n  private eraseRunningRegion(): void {\n    for (let index = 0; index < this.renderedRunningRows; index += 1) {\n      this.writer.write(\"\\u001B[1A\\u001B[2K\");\n    }\n    this.renderedRunningRows = 0;\n  }\n\n  private redrawRunningRegion(): void {\n    const totalChecks = this.requirePrepared();\n    for (const [index, check] of this.running.entries()) {\n      this.writer.write(\n        formatRunningRow({\n          displayIndex: this.completedCount + index + 1,\n          displayName: check.displayName,\n          elapsedMs: check.elapsedMs,\n          totalChecks\n        })\n      );\n    }\n    this.renderedRunningRows = this.running.length;\n  }\n\n  private removeRunningCheck(checkId: string): void {\n    const index = this.running.findIndex((check) => check.checkId === checkId);\n    if (index >= 0) this.running.splice(index, 1);\n  }\n\n  private updateRunningDurations(refreshedAtMs: number): void {\n    for (const check of this.running) {\n      const elapsedMs = refreshedAtMs - check.startedAtMs;\n      check.elapsedMs = Number.isFinite(elapsedMs) && elapsedMs >= 0 ? elapsedMs : 0;\n    }\n  }\n\n  private requirePrepared(): number {\n    if (this.preparedTotal === undefined) {\n      throw new Error(\"Progress feedback arrived before preparation\");\n    }\n    return this.preparedTotal;\n  }\n}\n"]}

package/dist/esm/project-run/progress-rendering/renderer.mjs

@@ -1,8 +1,11 @@
+import { resolveProgressRenderingOutput } from "../../project-definition/output-defaults.mjs";
 import { ProgressRendererController } from "./renderer-lifecycle.mjs";
 const SYSTEM_PROGRESS_CLOCK = Object.freeze({ now: () => performance.now() });
 /** Product-private lifecycle presentation with one owner for feedback and its writer. */
-export function createProgressRenderer(writer, clock = SYSTEM_PROGRESS_CLOCK) {
-    const controller = new ProgressRendererController(writer, clock);
+export function createProgressRenderer(writer, clock = SYSTEM_PROGRESS_CLOCK, progressRendering = resolveProgressRenderingOutput({
+    enabled: true
+})) {
+    const controller = new ProgressRendererController(writer, clock, progressRendering);
     return Object.freeze({
         refreshesRunningRegion: controller.refreshesRunningRegion,
         refresh: () => controller.refresh(),

package/dist/esm/project-run/progress-rendering/renderer.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"renderer.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAqDrE,MAAM,qBAAqB,GAAkB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAE7F,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CACpC,MAAsB,EACtB,KAAK,GAAkB,qBAAqB;IAE5C,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;QACzD,OAAO,EAAE,GAAS,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE;QACzC,MAAM,EAAE,CAAC,QAA0B,EAAQ,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC1E,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage, CheckOutcome, CheckVisibility } from \"../../check/check.ts\";\nimport { ProgressRendererController } from \"./renderer-lifecycle.ts\";\n\nexport interface ProgressWriter {\n  readonly color: boolean;\n  readonly isTTY: boolean;\n  readonly term: string | undefined;\n  write(content: string): void;\n}\n\nexport type ProgressFeedback = Readonly<\n  | {\n      readonly kind: \"prepared\";\n      readonly totalChecks: number;\n    }\n  | {\n      readonly kind: \"started\";\n      readonly checkId: string;\n      readonly displayName: string;\n    }\n  | {\n      readonly kind: \"settled\";\n      readonly checkId: string;\n      readonly displayName: string;\n      readonly outcome: CheckOutcome;\n      readonly durationMs: number | null;\n      readonly visibility: CheckVisibility;\n      readonly messages: readonly CheckMessage[];\n    }\n  | {\n      readonly kind: \"final\";\n      readonly execution: \"cancelled\" | \"completed\";\n      readonly counts: ProgressOutcomeCounts;\n      readonly elapsedMs: number;\n    }\n>;\n\nexport interface ProgressOutcomeCounts {\n  readonly failed: number;\n  readonly notApplicable: number;\n  readonly passed: number;\n  readonly unavailable: number;\n}\n\nexport interface ProgressRenderer {\n  refresh(): void;\n  readonly refreshesRunningRegion: boolean;\n  render(feedback: ProgressFeedback): void;\n}\n\nexport interface ProgressClock {\n  now(): number;\n}\n\nconst SYSTEM_PROGRESS_CLOCK: ProgressClock = Object.freeze({ now: () => performance.now() });\n\n/** Product-private lifecycle presentation with one owner for feedback and its writer. */\nexport function createProgressRenderer(\n  writer: ProgressWriter,\n  clock: ProgressClock = SYSTEM_PROGRESS_CLOCK\n): ProgressRenderer {\n  const controller = new ProgressRendererController(writer, clock);\n  return Object.freeze({\n    refreshesRunningRegion: controller.refreshesRunningRegion,\n    refresh: (): void => controller.refresh(),\n    render: (feedback: ProgressFeedback): void => controller.render(feedback)\n  });\n}\n"]}
+{"version":3,"file":"renderer.mjs","sourceRoot":"","sources":["../../../../src/project-run/progress-rendering/renderer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,8BAA8B,EAAE,MAAM,6CAA6C,CAAC;AAC7F,OAAO,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AA0DrE,MAAM,qBAAqB,GAAkB,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;AAE7F,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CACpC,MAAsB,EACtB,KAAK,GAAkB,qBAAqB,EAC5C,iBAAiB,GAAoC,8BAA8B,CAAC;IAClF,OAAO,EAAE,IAAI;CACd,CAAC;IAEF,MAAM,UAAU,GAAG,IAAI,0BAA0B,CAAC,MAAM,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;IACpF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,sBAAsB,EAAE,UAAU,CAAC,sBAAsB;QACzD,OAAO,EAAE,GAAS,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE;QACzC,MAAM,EAAE,CAAC,QAA0B,EAAQ,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC;KAC1E,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckMessage, CheckOutcome, CheckVisibility } from \"../../check/check.ts\";\nimport type { CoreRecord } from \"../../check-settlement/facts.ts\";\nimport type { ResolvedProgressRenderingOutput } from \"../../project-definition/project-definition.ts\";\nimport { resolveProgressRenderingOutput } from \"../../project-definition/output-defaults.ts\";\nimport { ProgressRendererController } from \"./renderer-lifecycle.ts\";\n\nexport interface ProgressWriter {\n  readonly color: boolean;\n  readonly isTTY: boolean;\n  readonly term: string | undefined;\n  close?(): void;\n  write(content: string): void;\n}\n\nexport type ProgressFeedback = Readonly<\n  | {\n      readonly kind: \"prepared\";\n      readonly totalChecks: number;\n    }\n  | {\n      readonly kind: \"flag-control-completed\";\n    }\n  | {\n      readonly kind: \"started\";\n      readonly checkId: string;\n      readonly displayName: string;\n    }\n  | {\n      readonly kind: \"settled\";\n      readonly checkId: string;\n      readonly displayName: string;\n      readonly outcome: CheckOutcome;\n      readonly durationMs: number | null;\n      readonly visibility: CheckVisibility;\n      readonly messages: readonly CheckMessage[];\n      readonly records: readonly CoreRecord[];\n    }\n  | {\n      readonly kind: \"final\";\n      readonly execution: \"cancelled\" | \"completed\";\n      readonly counts: ProgressOutcomeCounts;\n      readonly elapsedMs: number;\n    }\n>;\n\nexport interface ProgressOutcomeCounts {\n  readonly failed: number;\n  readonly notApplicable: number;\n  readonly passed: number;\n  readonly unavailable: number;\n}\n\nexport interface ProgressRenderer {\n  refresh(): void;\n  readonly refreshesRunningRegion: boolean;\n  render(feedback: ProgressFeedback): void;\n}\n\nexport interface ProgressClock {\n  now(): number;\n}\n\nconst SYSTEM_PROGRESS_CLOCK: ProgressClock = Object.freeze({ now: () => performance.now() });\n\n/** Product-private lifecycle presentation with one owner for feedback and its writer. */\nexport function createProgressRenderer(\n  writer: ProgressWriter,\n  clock: ProgressClock = SYSTEM_PROGRESS_CLOCK,\n  progressRendering: ResolvedProgressRenderingOutput = resolveProgressRenderingOutput({\n    enabled: true\n  })\n): ProgressRenderer {\n  const controller = new ProgressRendererController(writer, clock, progressRendering);\n  return Object.freeze({\n    refreshesRunningRegion: controller.refreshesRunningRegion,\n    refresh: (): void => controller.refresh(),\n    render: (feedback: ProgressFeedback): void => controller.render(feedback)\n  });\n}\n"]}

package/dist/esm/project-run/project-context.mjs

@@ -2,7 +2,7 @@
 export function createProjectContext(input) {
     return Object.freeze({
         flags: Object.freeze([...(input.controls.flags ?? [])]),
-        root: input.root
+        root: input.paths.projectRoot
     });
 }
 //# sourceMappingURL=project-context.mjs.map

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

@@ -1 +1 @@
-{"version":3,"file":"project-context.mjs","sourceRoot":"","sources":["../../../src/project-run/project-context.ts"],"names":[],"mappings":"AAEA,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAClC,KAA0E;IAE1E,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,EAAE,KAAK,CAAC,IAAI;KACjB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckProjectContext } from \"../check/check.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\n/** Materializes only invocation-wide callback input; Check-local options own domain configuration. */\nexport function createProjectContext(\n  input: Readonly<{ readonly controls: RunControls; readonly root: string }>\n): CheckProjectContext {\n  return Object.freeze({\n    flags: Object.freeze([...(input.controls.flags ?? [])]),\n    root: input.root\n  });\n}\n"]}
+{"version":3,"file":"project-context.mjs","sourceRoot":"","sources":["../../../src/project-run/project-context.ts"],"names":[],"mappings":"AAGA,sGAAsG;AACtG,MAAM,UAAU,oBAAoB,CAClC,KAA4F;IAE5F,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACvD,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,WAAW;KAC9B,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type { CheckProjectContext } from \"../check/check.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\nimport type { ResolvedInvocationPaths } from \"./invocation/paths.ts\";\n/** Materializes only invocation-wide callback input; Check-local options own domain configuration. */\nexport function createProjectContext(\n  input: Readonly<{ readonly controls: RunControls; readonly paths: ResolvedInvocationPaths }>\n): CheckProjectContext {\n  return Object.freeze({\n    flags: Object.freeze([...(input.controls.flags ?? [])]),\n    root: input.paths.projectRoot\n  });\n}\n"]}

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

@@ -16,6 +16,8 @@ function outputDiagnosticCode(output) {
             return "progress-rendering-failed";
         case "diagnosticLogging":
             return "diagnostic-logging-failed";
+        case "measurementHooks":
+            return "scheduler-measurement-hooks-failed";
     }
 }
 export function isCancelled(controls) {

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

@@ -1 +1 @@
-{"version":3,"file":"result.mjs","sourceRoot":"","sources":["../../../src/project-run/result.ts"],"names":[],"mappings":"AA2FA,MAAM,UAAU,aAAa,CAC3B,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,MAA+B,EAC/B,KAAqB;IAErB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,sBAAsB;QACtB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO;QACP,GAAG,KAAK;KACT,CAAC,CAAC;AACL,CAAC;AACD,SAAS,oBAAoB,CAC3B,MAA+B;IAE/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,oBAAoB;YACvB,OAAO,4BAA4B,CAAC;QACtC,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;IACvC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAqB;IAC/C,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAC3C,CAAC;AACD,MAAM,UAAU,QAAQ,CACtB,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,IAA0D;IAE1D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,UAAU;QAChB,sBAAsB;QACtB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QACnC,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,wBAAwB,CACtC,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,KAA8B;IAK9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB;QACtB,kBAAkB;QAClB,OAAO;QACP,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,qBAAqB,CACnC,KAOE;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,WAAW;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  DefinitionWarning,\n  ProjectDefinitionDiagnostic\n} from \"../project-definition/project-definition.ts\";\nimport type { RunControlDiagnostic } from \"./controls/validation-result.ts\";\nimport type { CheckAggregate, RunControls } from \"./controls/contract.ts\";\nimport type { CheckMessageLevel } from \"../check/check.ts\";\nimport type { CoreSnapshot } from \"../check-settlement/facts.ts\";\nimport type { RunOutputStatuses } from \"./output-status.ts\";\nexport type RunDiagnostic = Readonly<{\n  readonly code: \"task-graph-invalid\" | \"task-engine-failed\" | \"publication-model-failed\";\n}>;\nexport type CheckDuration = Readonly<{\n  readonly checkId: string;\n  readonly durationMs: number | null;\n}>;\nexport interface CheckRunMessage {\n  readonly checkId: string;\n  readonly level: CheckMessageLevel;\n  readonly code: string;\n  readonly message: string;\n}\nexport interface RunResultFacts {\n  readonly aggregate: CheckAggregate | null;\n  readonly checkDurations: readonly CheckDuration[];\n  readonly checkMessages: readonly CheckRunMessage[];\n  readonly snapshot: CoreSnapshot;\n}\n/** 一次 Project Run 的可判别结果；output failure 保留已结算 facts。 */\nexport type RunResult = Readonly<\n  | {\n      readonly kind: \"configuration\";\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly diagnostic: ProjectDefinitionDiagnostic | RunControlDiagnostic;\n    }\n  | {\n      readonly kind: \"planning\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly diagnostic: RunDiagnostic;\n      readonly outputs: RunOutputStatuses;\n    }\n  | {\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      readonly phase: \"pre-work\" | \"planning\";\n    }\n  | {\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      readonly phase: \"execution\";\n      readonly checkDurations: readonly CheckDuration[];\n      readonly checkMessages: readonly CheckRunMessage[];\n      readonly snapshot: CoreSnapshot;\n    }\n  | ({\n      readonly kind: \"completed\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n  | {\n      readonly kind: \"execution\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly diagnostic: RunDiagnostic;\n      readonly outputs: RunOutputStatuses;\n    }\n  | ({\n      readonly kind: \"output\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly diagnostic: Readonly<{\n        readonly code:\n          | \"machine-publication-failed\"\n          | \"progress-rendering-failed\"\n          | \"diagnostic-logging-failed\";\n      }>;\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n>;\n\n/** Any Run result produced after controls and Definition validation have completed. */\nexport type NonConfigurationRunResult = Exclude<RunResult, { readonly kind: \"configuration\" }>;\n\ntype OutputRunResult = Extract<RunResult, { readonly kind: \"output\" }>;\n\nexport function outputFailure(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  output: keyof RunOutputStatuses,\n  facts: RunResultFacts\n): OutputRunResult {\n  return Object.freeze({\n    kind: \"output\",\n    declarativeFingerprint,\n    definitionWarnings,\n    diagnostic: Object.freeze({ code: outputDiagnosticCode(output) }),\n    outputs,\n    ...facts\n  });\n}\nfunction outputDiagnosticCode(\n  output: keyof RunOutputStatuses\n): Extract<RunResult, { readonly kind: \"output\" }>[\"diagnostic\"][\"code\"] {\n  switch (output) {\n    case \"machinePublication\":\n      return \"machine-publication-failed\";\n    case \"progressRendering\":\n      return \"progress-rendering-failed\";\n    case \"diagnosticLogging\":\n      return \"diagnostic-logging-failed\";\n  }\n}\n\nexport function isCancelled(controls: RunControls): boolean {\n  return controls.signal?.aborted === true;\n}\nexport function planning(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  code: Extract<RunDiagnostic[\"code\"], \"task-graph-invalid\">\n): Extract<NonConfigurationRunResult, { readonly kind: \"planning\" }> {\n  return Object.freeze({\n    kind: \"planning\",\n    declarativeFingerprint,\n    definitionWarnings,\n    diagnostic: Object.freeze({ code }),\n    outputs\n  });\n}\nexport function preExecutionCancellation(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  phase: \"pre-work\" | \"planning\"\n): Extract<\n  NonConfigurationRunResult,\n  { readonly kind: \"cancelled\"; readonly phase: \"pre-work\" | \"planning\" }\n> {\n  return Object.freeze({\n    kind: \"cancelled\",\n    declarativeFingerprint,\n    definitionWarnings,\n    outputs,\n    phase\n  });\n}\nexport function executionCancellation(\n  input: Readonly<{\n    readonly checkDurations: readonly CheckDuration[];\n    readonly checkMessages: readonly CheckRunMessage[];\n    readonly declarativeFingerprint: string;\n    readonly definitionWarnings: readonly DefinitionWarning[];\n    readonly outputs: RunOutputStatuses;\n    readonly snapshot: CoreSnapshot;\n  }>\n): Extract<NonConfigurationRunResult, { readonly kind: \"cancelled\"; readonly phase: \"execution\" }> {\n  return Object.freeze({\n    kind: \"cancelled\",\n    declarativeFingerprint: input.declarativeFingerprint,\n    definitionWarnings: input.definitionWarnings,\n    outputs: input.outputs,\n    phase: \"execution\",\n    checkDurations: input.checkDurations,\n    checkMessages: input.checkMessages,\n    snapshot: input.snapshot\n  });\n}\n"]}
+{"version":3,"file":"result.mjs","sourceRoot":"","sources":["../../../src/project-run/result.ts"],"names":[],"mappings":"AAuIA,MAAM,UAAU,aAAa,CAC3B,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,MAA+B,EAC/B,KAAqB;IAErB,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,QAAQ;QACd,sBAAsB;QACtB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QACjE,OAAO;QACP,GAAG,KAAK;KACT,CAAC,CAAC;AACL,CAAC;AACD,SAAS,oBAAoB,CAC3B,MAA+B;IAE/B,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,oBAAoB;YACvB,OAAO,4BAA4B,CAAC;QACtC,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,mBAAmB;YACtB,OAAO,2BAA2B,CAAC;QACrC,KAAK,kBAAkB;YACrB,OAAO,oCAAoC,CAAC;IAChD,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,QAAqB;IAC/C,OAAO,QAAQ,CAAC,MAAM,EAAE,OAAO,KAAK,IAAI,CAAC;AAC3C,CAAC;AACD,MAAM,UAAU,QAAQ,CACtB,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,IAA0D;IAE1D,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,UAAU;QAChB,sBAAsB;QACtB,kBAAkB;QAClB,UAAU,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QACnC,OAAO;KACR,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,wBAAwB,CACtC,sBAA8B,EAC9B,kBAAgD,EAChD,OAA0B,EAC1B,KAA8B;IAK9B,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB;QACtB,kBAAkB;QAClB,OAAO;QACP,KAAK;KACN,CAAC,CAAC;AACL,CAAC;AACD,MAAM,UAAU,qBAAqB,CACnC,KAOE;IAEF,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,IAAI,EAAE,WAAW;QACjB,sBAAsB,EAAE,KAAK,CAAC,sBAAsB;QACpD,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,KAAK,EAAE,WAAW;QAClB,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,QAAQ,EAAE,KAAK,CAAC,QAAQ;KACzB,CAAC,CAAC;AACL,CAAC","sourcesContent":["import type {\n  DefinitionWarning,\n  ProjectDefinitionDiagnostic\n} from \"../project-definition/project-definition.ts\";\nimport type { RunControlDiagnostic } from \"./controls/validation-result.ts\";\nimport type { CheckAggregate, RunControls } from \"./controls/contract.ts\";\nimport type { CheckMessageLevel } from \"../check/check.ts\";\nimport type { CoreSnapshot } from \"../check-settlement/facts.ts\";\nimport type { RunOutputStatuses } from \"./outputs/status.ts\";\n\n/** Product 不能形成正常 Run 结果时的稳定 invocation diagnostic。 */\nexport type RunDiagnostic = Readonly<{\n  /** 失败的 Run-owned execution 或 planning boundary；它不是任何 Check 的 terminal status。 */\n  readonly code:\n    | \"admission-policy-failed\"\n    | \"admission-strategy-preparation-failed\"\n    | \"task-graph-invalid\"\n    | \"task-engine-failed\"\n    | \"publication-model-failed\";\n}>;\n\n/** 一项 executable Check 的最终 duration readback。 */\nexport type CheckDuration = Readonly<{\n  /** 与 snapshot 中 Check facts 相同的 stable Check identity。 */\n  readonly checkId: string;\n  /** 已测量的 execution duration；未进入 execution 的 Check 为 `null`，不是零时长。 */\n  readonly durationMs: number | null;\n}>;\n\n/** Run 在 Check terminal lifecycle 中接受的人读 message。 */\nexport interface CheckRunMessage {\n  /** 产生 message 的 stable Check identity。 */\n  readonly checkId: string;\n  /** author message 或已捕获 console output 的 presentation severity。 */\n  readonly level: CheckMessageLevel;\n  /** owning Check 或 Product capture 使用的稳定 message code。 */\n  readonly code: string;\n  /** 人读正文；不能代替 snapshot 中的 terminal outcome。 */\n  readonly message: string;\n}\n\n/** 只有已形成 terminal Check facts 的 Run branch 才具备的完整结果 readback。 */\nexport interface RunResultFacts {\n  /** 调用方未配置 aggregation 时为 `null`；否则是选中 Check statuses 的 invocation-level conclusion。 */\n  readonly aggregate: CheckAggregate | null;\n  /** 按 canonical Check order 的 duration facts；未执行 Check 仍以 `null` 保留。 */\n  readonly checkDurations: readonly CheckDuration[];\n  /** 已接受的 author 与 console-capture messages，不决定 Check outcome。 */\n  readonly checkMessages: readonly CheckRunMessage[];\n  /** 已结算的完整 Check 与 supplemental Record facts。 */\n  readonly snapshot: CoreSnapshot;\n}\n/** 一次 Project Run 的可判别结果；output failure 保留已结算 facts。 */\nexport type RunResult = Readonly<\n  | {\n      /** Definition、RunControls 或 aggregation selection 无效；没有执行任何 Check author callback。 */\n      readonly kind: \"configuration\";\n      /** Definition normalization 时仍可报告、但不单独阻止本 branch 的 warning。 */\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 指向被拒绝 Definition 或 RunControls value 的 closed diagnostic。 */\n      readonly diagnostic: ProjectDefinitionDiagnostic | RunControlDiagnostic;\n    }\n  | {\n      /** 配置有效，但 static Check graph 不能进入 execution planning。 */\n      readonly kind: \"planning\";\n      /** normalized declarative Definition 的 matching signal；不包含 RunControls 或 outcome。 */\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 这次 planning 失败的 Product diagnostic。 */\n      readonly diagnostic: RunDiagnostic;\n      /** 配置有效后各 terminal output participant 的独立状态。 */\n      readonly outputs: RunOutputStatuses;\n    }\n  | {\n      /** invocation 在 Check work 开始前或 planning 中响应 caller cancellation。 */\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      /** 取消发生在尚未形成 terminal Check facts 的阶段。 */\n      readonly phase: \"pre-work\" | \"planning\";\n    }\n  | {\n      /** invocation 在至少可能已开始 Check work 的 execution 阶段响应 caller cancellation。 */\n      readonly kind: \"cancelled\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n      /** 此 branch 总在 terminal Check facts 形成后的 execution cancellation 返回。 */\n      readonly phase: \"execution\";\n      /** 按 canonical Check order 的 duration facts；未执行 Check 为 `null`。 */\n      readonly checkDurations: readonly CheckDuration[];\n      /** cancellation 前已接受的 author 与 console-capture messages。 */\n      readonly checkMessages: readonly CheckRunMessage[];\n      /** cancellation 时已结算的完整 Check 与 supplemental Record facts。 */\n      readonly snapshot: CoreSnapshot;\n    }\n  | ({\n      /** 所有 Check 已完成 terminal settlement；不表示每项 Check 都 `passed`。 */\n      readonly kind: \"completed\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n  | {\n      /** Product execution/settlement infrastructure 失败；不把它误表示为 Check `failed`。 */\n      readonly kind: \"execution\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 停止正常 execution 的 Product diagnostic；本 branch 不提供 partial snapshot。 */\n      readonly diagnostic: RunDiagnostic;\n      readonly outputs: RunOutputStatuses;\n    }\n  | ({\n      /** Check facts 已完整结算，但至少一个 terminal output participant 失败。 */\n      readonly kind: \"output\";\n      readonly declarativeFingerprint: string;\n      readonly definitionWarnings: readonly DefinitionWarning[];\n      /** 失败的 machine、progress、diagnostic 或 scheduler-measurement output 类别。 */\n      readonly diagnostic: Readonly<{\n        readonly code:\n          | \"machine-publication-failed\"\n          | \"progress-rendering-failed\"\n          | \"diagnostic-logging-failed\"\n          | \"scheduler-measurement-hooks-failed\";\n      }>;\n      readonly outputs: RunOutputStatuses;\n    } & RunResultFacts)\n>;\n\n/** Any Run result produced after controls and Definition validation have completed. */\nexport type NonConfigurationRunResult = Exclude<RunResult, { readonly kind: \"configuration\" }>;\n\ntype OutputRunResult = Extract<RunResult, { readonly kind: \"output\" }>;\n\nexport function outputFailure(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  output: keyof RunOutputStatuses,\n  facts: RunResultFacts\n): OutputRunResult {\n  return Object.freeze({\n    kind: \"output\",\n    declarativeFingerprint,\n    definitionWarnings,\n    diagnostic: Object.freeze({ code: outputDiagnosticCode(output) }),\n    outputs,\n    ...facts\n  });\n}\nfunction outputDiagnosticCode(\n  output: keyof RunOutputStatuses\n): Extract<RunResult, { readonly kind: \"output\" }>[\"diagnostic\"][\"code\"] {\n  switch (output) {\n    case \"machinePublication\":\n      return \"machine-publication-failed\";\n    case \"progressRendering\":\n      return \"progress-rendering-failed\";\n    case \"diagnosticLogging\":\n      return \"diagnostic-logging-failed\";\n    case \"measurementHooks\":\n      return \"scheduler-measurement-hooks-failed\";\n  }\n}\n\nexport function isCancelled(controls: RunControls): boolean {\n  return controls.signal?.aborted === true;\n}\nexport function planning(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  code: Extract<RunDiagnostic[\"code\"], \"task-graph-invalid\">\n): Extract<NonConfigurationRunResult, { readonly kind: \"planning\" }> {\n  return Object.freeze({\n    kind: \"planning\",\n    declarativeFingerprint,\n    definitionWarnings,\n    diagnostic: Object.freeze({ code }),\n    outputs\n  });\n}\nexport function preExecutionCancellation(\n  declarativeFingerprint: string,\n  definitionWarnings: readonly DefinitionWarning[],\n  outputs: RunOutputStatuses,\n  phase: \"pre-work\" | \"planning\"\n): Extract<\n  NonConfigurationRunResult,\n  { readonly kind: \"cancelled\"; readonly phase: \"pre-work\" | \"planning\" }\n> {\n  return Object.freeze({\n    kind: \"cancelled\",\n    declarativeFingerprint,\n    definitionWarnings,\n    outputs,\n    phase\n  });\n}\nexport function executionCancellation(\n  input: Readonly<{\n    readonly checkDurations: readonly CheckDuration[];\n    readonly checkMessages: readonly CheckRunMessage[];\n    readonly declarativeFingerprint: string;\n    readonly definitionWarnings: readonly DefinitionWarning[];\n    readonly outputs: RunOutputStatuses;\n    readonly snapshot: CoreSnapshot;\n  }>\n): Extract<NonConfigurationRunResult, { readonly kind: \"cancelled\"; readonly phase: \"execution\" }> {\n  return Object.freeze({\n    kind: \"cancelled\",\n    declarativeFingerprint: input.declarativeFingerprint,\n    definitionWarnings: input.definitionWarnings,\n    outputs: input.outputs,\n    phase: \"execution\",\n    checkDurations: input.checkDurations,\n    checkMessages: input.checkMessages,\n    snapshot: input.snapshot\n  });\n}\n"]}

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

@@ -1,6 +1,6 @@
 import { validateProjectDefinition } from "../project-definition/project-definition-validation.mjs";
 import { validateRunControls } from "./controls/validation.mjs";
-import { executeValidatedRun } from "./invocation.mjs";
+import { executeValidatedRun } from "./invocation/run.mjs";
 export async function run(definition, controls = {}) {
     const validatedDefinition = validateProjectDefinition(definition);
     if (!validatedDefinition.ok) {

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

@@ -1 +1 @@
-{"version":3,"file":"run.mjs","sourceRoot":"","sources":["../../../src/project-run/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAsBtD,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,UAAmB,EAAE,QAAQ,GAAY,EAAE;IACnE,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,UAAU,EAAE,mBAAmB,CAAC,KAAK;SACtC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,UAAU,EAAE,iBAAiB,CAAC,KAAK;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,mBAAmB,CACxB,mBAAmB,CAAC,KAAK,EACzB,iBAAiB,CAAC,KAAK,EACvB,mBAAmB,CAAC,QAAQ,CAC7B,CAAC;AACJ,CAAC","sourcesContent":["import type { ProjectDefinition } from \"../project-definition/project-definition.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\nimport { validateProjectDefinition } from \"../project-definition/project-definition-validation.ts\";\nimport { validateRunControls } from \"./controls/validation.ts\";\nimport { executeValidatedRun } from \"./invocation.ts\";\nimport type { RunResult } from \"./result.ts\";\n\nexport type { RunOutputStatus, RunOutputStatuses } from \"./output-status.ts\";\nexport type { RunDiagnostic, RunResult } from \"./result.ts\";\n\n/**\n * 在调用方的 Bun runtime 中执行一个由项目拥有的 Project Definition。\n *\n * @param definition - Project Definition input；{@link defineConfig} 补齐 defaults，run 在 invocation 前验证。\n * @param controls - 本次 invocation context 与 outputs 使用的闭合控制值。\n * @returns ordinary configuration、planning、execution、cancellation 与 output failures 通过 `RunResult`\n * 返回；调用方先按 `kind` narrow。\n * @remarks Definition validation 关闭 authoring grammar；可选 Check preflight 组成 invocation execution barrier，\n * 并在 execution callback、dependency resolver 或 scanner 前完成。`output` branch 同时提供完整 final\n * snapshot 与 output failure diagnostic。\n */\nexport async function run(\n  definition: ProjectDefinition,\n  controls?: RunControls\n): Promise<RunResult>;\nexport async function run(definition: unknown, controls?: unknown): Promise<RunResult>;\nexport async function run(definition: unknown, controls: unknown = {}): Promise<RunResult> {\n  const validatedDefinition = validateProjectDefinition(definition);\n  if (!validatedDefinition.ok) {\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([]),\n      diagnostic: validatedDefinition.error\n    });\n  }\n  const validatedControls = validateRunControls(controls);\n  if (!validatedControls.ok) {\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([]),\n      diagnostic: validatedControls.error\n    });\n  }\n\n  return executeValidatedRun(\n    validatedDefinition.value,\n    validatedControls.value,\n    validatedDefinition.warnings\n  );\n}\n"]}
+{"version":3,"file":"run.mjs","sourceRoot":"","sources":["../../../src/project-run/run.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,yBAAyB,EAAE,MAAM,wDAAwD,CAAC;AACnG,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAuB1D,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,UAAmB,EAAE,QAAQ,GAAY,EAAE;IACnE,MAAM,mBAAmB,GAAG,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAClE,IAAI,CAAC,mBAAmB,CAAC,EAAE,EAAE,CAAC;QAC5B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,UAAU,EAAE,mBAAmB,CAAC,KAAK;SACtC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,iBAAiB,GAAG,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IACxD,IAAI,CAAC,iBAAiB,CAAC,EAAE,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,MAAM,CAAC;YACnB,IAAI,EAAE,eAAe;YACrB,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACrC,UAAU,EAAE,iBAAiB,CAAC,KAAK;SACpC,CAAC,CAAC;IACL,CAAC;IAED,OAAO,mBAAmB,CACxB,mBAAmB,CAAC,KAAK,EACzB,iBAAiB,CAAC,KAAK,EACvB,mBAAmB,CAAC,QAAQ,CAC7B,CAAC;AACJ,CAAC","sourcesContent":["import type { ProjectDefinition } from \"../project-definition/project-definition.ts\";\nimport type { RunControls } from \"./controls/contract.ts\";\nimport { validateProjectDefinition } from \"../project-definition/project-definition-validation.ts\";\nimport { validateRunControls } from \"./controls/validation.ts\";\nimport { executeValidatedRun } from \"./invocation/run.ts\";\nimport type { RunResult } from \"./result.ts\";\n\nexport type { RunOutputStatus, RunOutputStatuses } from \"./outputs/status.ts\";\nexport type { RunDiagnostic, RunResult } from \"./result.ts\";\n\n/**\n * 在调用方的 Node runtime 中执行一个由项目拥有的 Project Definition。\n *\n * @param definition - Project Definition input；{@link defineConfig} 补齐 defaults，run 在 invocation 前验证。\n * @param controls - 本次 invocation context 与 outputs 使用的闭合控制值。\n * @returns ordinary configuration、planning、execution、cancellation 与 output failures 通过 `RunResult`\n * 返回；调用方先按 `kind` narrow。\n * @remarks Definition validation 关闭 authoring grammar；可选 Check preflight 在其 Task 通过直接 relation\n * readiness 后被 Scheduler admission 时运行，并先于该 Check 自己的 execution callback。它受该 Task 的\n * mutex、capacity、priority 与 cancellation 约束，而不是 invocation-wide barrier。`output` branch 同时提供\n * 完整 final snapshot 与 output failure diagnostic。\n */\nexport async function run(\n  definition: ProjectDefinition,\n  controls?: RunControls\n): Promise<RunResult>;\nexport async function run(definition: unknown, controls?: unknown): Promise<RunResult>;\nexport async function run(definition: unknown, controls: unknown = {}): Promise<RunResult> {\n  const validatedDefinition = validateProjectDefinition(definition);\n  if (!validatedDefinition.ok) {\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([]),\n      diagnostic: validatedDefinition.error\n    });\n  }\n  const validatedControls = validateRunControls(controls);\n  if (!validatedControls.ok) {\n    return Object.freeze({\n      kind: \"configuration\",\n      definitionWarnings: Object.freeze([]),\n      diagnostic: validatedControls.error\n    });\n  }\n\n  return executeValidatedRun(\n    validatedDefinition.value,\n    validatedControls.value,\n    validatedDefinition.warnings\n  );\n}\n"]}

package/dist/esm/project-run/task-scheduler/admission-core/compiled-graph.mjs

@@ -0,0 +1,166 @@
+/** Compiles a Scheduler-owned normalized graph once for an actual scheduler invocation. */
+export function compilePreparedAdmissionGraph(graph, maxParallel) {
+    assertMaxParallel(maxParallel);
+    const catalog = compileGraphSlotCatalog(graph);
+    const mutexIndexes = compileMutexStaticIndexes(graph);
+    const relationIndexes = compileRelationStaticIndexes(graph, catalog.taskSlotsById);
+    const resourceIndexes = compileResourceStaticIndexes(graph);
+    const scopeIndexes = compileScopeStaticIndexes(graph, catalog);
+    const publicTaskOrder = compilePublicTaskOrder(graph, catalog.taskSlotsById);
+    return assembleCompiledAdmissionGraph({
+        catalog,
+        graph,
+        maxParallel,
+        mutexIndexes,
+        publicTaskOrder,
+        relationIndexes,
+        resourceIndexes,
+        scopeIndexes
+    });
+}
+function compileResourceStaticIndexes(graph) {
+    const resourceSlotById = new Map(graph.resourceCapacities.map(({ resourceId }, slot) => [resourceId, slot]));
+    const resourceCapacityBySlot = Object.freeze(graph.resourceCapacities.map(({ units }) => units));
+    const taskResourceClaims = Object.freeze(graph.tasks.map((task) => Object.freeze(task.resourceClaims.map(({ resourceId, units }) => {
+        const resourceSlot = resourceSlotById.get(resourceId);
+        if (resourceSlot === undefined) {
+            throw new Error(`admission core resource is unknown: ${resourceId}`);
+        }
+        return Object.freeze({ resourceSlot, units });
+    }))));
+    return { resourceCapacityBySlot, resourceSlotById, taskResourceClaims };
+}
+function assertMaxParallel(maxParallel) {
+    if (!Number.isSafeInteger(maxParallel) || maxParallel <= 0) {
+        throw new TypeError("task engine maxParallel must be a positive safe integer");
+    }
+}
+/** Creates declaration-slot catalogs without materializing another prepared graph. */
+function compileGraphSlotCatalog(graph) {
+    return {
+        taskSlotsById: new Map(graph.tasks.map((task, slot) => [task.id, slot])),
+        taskById: new Map(graph.tasks.map((task) => [task.id, task])),
+        scopeSlotById: new Map(graph.scopes.map((scope, slot) => [scope.id, slot])),
+        scopesById: new Map(graph.scopes.map((scope) => [scope.id, scope]))
+    };
+}
+/** Allocates mutex slots by first declaration occurrence, then records every task occurrence. */
+function compileMutexStaticIndexes(graph) {
+    const mutexSlotById = new Map();
+    const taskMutexSlots = graph.tasks.map((task) => mutexSlotsForTask(task, mutexSlotById));
+    const reverseMutexOccurrences = Array.from({ length: mutexSlotById.size }, () => []);
+    for (const [taskSlot, mutexSlots] of taskMutexSlots.entries()) {
+        for (const mutexSlot of mutexSlots)
+            reverseMutexOccurrences[mutexSlot]?.push(taskSlot);
+    }
+    return {
+        mutexSlotById,
+        reverseMutexOccurrences: freezeSlotLists(reverseMutexOccurrences),
+        taskMutexSlots: freezeSlotLists(taskMutexSlots)
+    };
+}
+function mutexSlotsForTask(task, mutexSlotById) {
+    return task.mutex.map((mutexId) => mutexSlotFor(mutexSlotById, mutexId));
+}
+function mutexSlotFor(mutexSlotById, mutexId) {
+    const existingSlot = mutexSlotById.get(mutexId);
+    if (existingSlot !== undefined)
+        return existingSlot;
+    const nextSlot = mutexSlotById.size;
+    mutexSlotById.set(mutexId, nextSlot);
+    return nextSlot;
+}
+/** Reverses relation occurrences while retaining the declared occurrence order for core transitions. */
+function compileRelationStaticIndexes(graph, taskSlotsById) {
+    const reverseDependencies = emptyTaskSlotLists(graph);
+    const reverseObservations = emptyTaskSlotLists(graph);
+    for (const [taskSlot, task] of graph.tasks.entries()) {
+        appendReverseRelationOccurrences(task.dependsOn, taskSlot, taskSlotsById, reverseDependencies, "dependency");
+        appendReverseRelationOccurrences(task.observes, taskSlot, taskSlotsById, reverseObservations, "observation");
+    }
+    return {
+        reverseDependencies: freezeSlotLists(reverseDependencies),
+        reverseObservations: freezeSlotLists(reverseObservations)
+    };
+}
+function appendReverseRelationOccurrences(sourceTaskIds, targetTaskSlot, taskSlotsById, reverseSlotsBySourceTask, relationName) {
+    for (const sourceTaskId of sourceTaskIds) {
+        const sourceTaskSlot = taskSlotsById.get(sourceTaskId);
+        if (sourceTaskSlot === undefined) {
+            throw new Error(`admission core ${relationName} is unknown: ${sourceTaskId}`);
+        }
+        reverseSlotsBySourceTask[sourceTaskSlot]?.push(targetTaskSlot);
+    }
+}
+/** Associates scope terminals and activation candidates with the existing task slots. */
+function compileScopeStaticIndexes(graph, catalog) {
+    const scopeSlotsByTerminalTaskSlot = emptyTaskSlotLists(graph);
+    for (const [scopeSlot, scope] of graph.scopes.entries()) {
+        const terminalTaskSlot = catalog.taskSlotsById.get(scope.terminalTaskId);
+        if (terminalTaskSlot === undefined) {
+            throw new Error(`admission core scope terminal is unknown: ${scope.terminalTaskId}`);
+        }
+        scopeSlotsByTerminalTaskSlot[terminalTaskSlot]?.push(scopeSlot);
+    }
+    const taskActivatesScope = graph.tasks.map((task) => {
+        const scopeSlot = task.scopeId === undefined ? undefined : catalog.scopeSlotById.get(task.scopeId);
+        return (scopeSlot !== undefined &&
+            graph.scopes[scopeSlot]?.activationTaskIds.includes(task.id) === true);
+    });
+    const taskScopeSlots = graph.tasks.map((task) => task.scopeId === undefined ? undefined : catalog.scopeSlotById.get(task.scopeId));
+    return {
+        scopeSlotsByTerminalTaskSlot: freezeSlotLists(scopeSlotsByTerminalTaskSlot),
+        taskActivatesScope: Object.freeze(taskActivatesScope),
+        taskScopeSlots: Object.freeze(taskScopeSlots)
+    };
+}
+/** Materializes only the lexical catalog projection; declaration slots remain unchanged. */
+function compilePublicTaskOrder(graph, taskSlotsById) {
+    return {
+        taskIdsInPublicOrder: Object.freeze(graph.tasks.map((task) => task.id).sort(compareText)),
+        taskSlotsInPublicOrder: Object.freeze(graph.tasks
+            .map((task) => taskSlotsById.get(task.id))
+            .sort((left, right) => compareText(graph.tasks[left].id, graph.tasks[right].id)))
+    };
+}
+/** Freezes the one compiled graph object after every static compiler stage has completed. */
+function assembleCompiledAdmissionGraph(parts) {
+    const { catalog, graph, maxParallel, mutexIndexes, publicTaskOrder, relationIndexes, resourceIndexes, scopeIndexes } = parts;
+    return Object.freeze({
+        graph,
+        maxParallel,
+        mutexSlotById: mutexIndexes.mutexSlotById,
+        resourceCapacityBySlot: resourceIndexes.resourceCapacityBySlot,
+        resourceSlotById: resourceIndexes.resourceSlotById,
+        relationIndexes: Object.freeze({
+            reverseDependencies: relationIndexes.reverseDependencies,
+            reverseMutexOccurrences: mutexIndexes.reverseMutexOccurrences,
+            reverseObservations: relationIndexes.reverseObservations
+        }),
+        scopesById: catalog.scopesById,
+        scopeSlotById: catalog.scopeSlotById,
+        scopeSlotsByTerminalTaskSlot: scopeIndexes.scopeSlotsByTerminalTaskSlot,
+        taskById: catalog.taskById,
+        taskIdsInPublicOrder: publicTaskOrder.taskIdsInPublicOrder,
+        taskMutexSlots: mutexIndexes.taskMutexSlots,
+        taskResourceClaims: resourceIndexes.taskResourceClaims,
+        taskActivatesScope: scopeIndexes.taskActivatesScope,
+        taskScopeSlots: scopeIndexes.taskScopeSlots,
+        taskSlotsById: catalog.taskSlotsById,
+        taskSlotsInPublicOrder: publicTaskOrder.taskSlotsInPublicOrder
+    });
+}
+function emptyTaskSlotLists(graph) {
+    return graph.tasks.map(() => []);
+}
+function freezeSlotLists(slotLists) {
+    return Object.freeze(slotLists.map((slots) => Object.freeze(slots)));
+}
+function compareText(left, right) {
+    if (left < right)
+        return -1;
+    if (left > right)
+        return 1;
+    return 0;
+}
+//# sourceMappingURL=compiled-graph.mjs.map

package/dist/esm/project-run/task-scheduler/admission-core/compiled-graph.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiled-graph.mjs","sourceRoot":"","sources":["../../../../../src/project-run/task-scheduler/admission-core/compiled-graph.ts"],"names":[],"mappings":"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","sourcesContent":["import type { PlannedTask, PlannedTaskGraph } from \"../graph.ts\";\n\ninterface RelationStaticIndexes {\n  readonly reverseDependencies: readonly (readonly number[])[];\n  readonly reverseMutexOccurrences: readonly (readonly number[])[];\n  readonly reverseObservations: readonly (readonly number[])[];\n}\n\ninterface ReverseRelationIndexes {\n  readonly reverseDependencies: readonly (readonly number[])[];\n  readonly reverseObservations: readonly (readonly number[])[];\n}\n\nexport interface CompiledAdmissionGraph {\n  readonly graph: PlannedTaskGraph;\n  readonly maxParallel: number;\n  readonly mutexSlotById: ReadonlyMap<string, number>;\n  readonly resourceCapacityBySlot: readonly number[];\n  readonly resourceSlotById: ReadonlyMap<string, number>;\n  readonly scopesById: ReadonlyMap<string, PlannedTaskGraph[\"scopes\"][number]>;\n  readonly scopeSlotById: ReadonlyMap<string, number>;\n  readonly scopeSlotsByTerminalTaskSlot: readonly (readonly number[])[];\n  readonly taskById: ReadonlyMap<string, PlannedTask>;\n  readonly taskMutexSlots: readonly (readonly number[])[];\n  readonly taskResourceClaims: readonly (readonly Readonly<{\n    readonly resourceSlot: number;\n    readonly units: number;\n  }>[])[];\n  readonly taskActivatesScope: readonly boolean[];\n  readonly taskScopeSlots: readonly (number | undefined)[];\n  readonly taskSlotsById: ReadonlyMap<string, number>;\n  readonly taskIdsInPublicOrder: readonly string[];\n  readonly taskSlotsInPublicOrder: readonly number[];\n  readonly relationIndexes: RelationStaticIndexes;\n}\n\ninterface GraphSlotCatalog {\n  readonly scopesById: ReadonlyMap<string, PlannedTaskGraph[\"scopes\"][number]>;\n  readonly scopeSlotById: ReadonlyMap<string, number>;\n  readonly taskById: ReadonlyMap<string, PlannedTask>;\n  readonly taskSlotsById: ReadonlyMap<string, number>;\n}\n\ninterface MutexStaticIndexes {\n  readonly mutexSlotById: ReadonlyMap<string, number>;\n  readonly reverseMutexOccurrences: readonly (readonly number[])[];\n  readonly taskMutexSlots: readonly (readonly number[])[];\n}\n\ninterface ResourceStaticIndexes {\n  readonly resourceCapacityBySlot: readonly number[];\n  readonly resourceSlotById: ReadonlyMap<string, number>;\n  readonly taskResourceClaims: CompiledAdmissionGraph[\"taskResourceClaims\"];\n}\n\ninterface ScopeStaticIndexes {\n  readonly scopeSlotsByTerminalTaskSlot: readonly (readonly number[])[];\n  readonly taskActivatesScope: readonly boolean[];\n  readonly taskScopeSlots: readonly (number | undefined)[];\n}\n\ninterface PublicTaskOrder {\n  readonly taskIdsInPublicOrder: readonly string[];\n  readonly taskSlotsInPublicOrder: readonly number[];\n}\n\ninterface CompiledAdmissionGraphParts {\n  readonly catalog: GraphSlotCatalog;\n  readonly graph: PlannedTaskGraph;\n  readonly maxParallel: number;\n  readonly mutexIndexes: MutexStaticIndexes;\n  readonly publicTaskOrder: PublicTaskOrder;\n  readonly relationIndexes: ReverseRelationIndexes;\n  readonly resourceIndexes: ResourceStaticIndexes;\n  readonly scopeIndexes: ScopeStaticIndexes;\n}\n\n/** Compiles a Scheduler-owned normalized graph once for an actual scheduler invocation. */\nexport function compilePreparedAdmissionGraph(\n  graph: PlannedTaskGraph,\n  maxParallel: number\n): CompiledAdmissionGraph {\n  assertMaxParallel(maxParallel);\n  const catalog = compileGraphSlotCatalog(graph);\n  const mutexIndexes = compileMutexStaticIndexes(graph);\n  const relationIndexes = compileRelationStaticIndexes(graph, catalog.taskSlotsById);\n  const resourceIndexes = compileResourceStaticIndexes(graph);\n  const scopeIndexes = compileScopeStaticIndexes(graph, catalog);\n  const publicTaskOrder = compilePublicTaskOrder(graph, catalog.taskSlotsById);\n\n  return assembleCompiledAdmissionGraph({\n    catalog,\n    graph,\n    maxParallel,\n    mutexIndexes,\n    publicTaskOrder,\n    relationIndexes,\n    resourceIndexes,\n    scopeIndexes\n  });\n}\n\nfunction compileResourceStaticIndexes(graph: PlannedTaskGraph): ResourceStaticIndexes {\n  const resourceSlotById = new Map(\n    graph.resourceCapacities.map(({ resourceId }, slot) => [resourceId, slot] as const)\n  );\n  const resourceCapacityBySlot = Object.freeze(graph.resourceCapacities.map(({ units }) => units));\n  const taskResourceClaims = Object.freeze(\n    graph.tasks.map((task) =>\n      Object.freeze(\n        task.resourceClaims.map(({ resourceId, units }) => {\n          const resourceSlot = resourceSlotById.get(resourceId);\n          if (resourceSlot === undefined) {\n            throw new Error(`admission core resource is unknown: ${resourceId}`);\n          }\n          return Object.freeze({ resourceSlot, units });\n        })\n      )\n    )\n  );\n  return { resourceCapacityBySlot, resourceSlotById, taskResourceClaims };\n}\n\nfunction assertMaxParallel(maxParallel: number): void {\n  if (!Number.isSafeInteger(maxParallel) || maxParallel <= 0) {\n    throw new TypeError(\"task engine maxParallel must be a positive safe integer\");\n  }\n}\n\n/** Creates declaration-slot catalogs without materializing another prepared graph. */\nfunction compileGraphSlotCatalog(graph: PlannedTaskGraph): GraphSlotCatalog {\n  return {\n    taskSlotsById: new Map(graph.tasks.map((task, slot) => [task.id, slot] as const)),\n    taskById: new Map(graph.tasks.map((task) => [task.id, task] as const)),\n    scopeSlotById: new Map(graph.scopes.map((scope, slot) => [scope.id, slot] as const)),\n    scopesById: new Map(graph.scopes.map((scope) => [scope.id, scope] as const))\n  };\n}\n\n/** Allocates mutex slots by first declaration occurrence, then records every task occurrence. */\nfunction compileMutexStaticIndexes(graph: PlannedTaskGraph): MutexStaticIndexes {\n  const mutexSlotById = new Map<string, number>();\n  const taskMutexSlots = graph.tasks.map((task) => mutexSlotsForTask(task, mutexSlotById));\n  const reverseMutexOccurrences = Array.from({ length: mutexSlotById.size }, () => [] as number[]);\n\n  for (const [taskSlot, mutexSlots] of taskMutexSlots.entries()) {\n    for (const mutexSlot of mutexSlots) reverseMutexOccurrences[mutexSlot]?.push(taskSlot);\n  }\n\n  return {\n    mutexSlotById,\n    reverseMutexOccurrences: freezeSlotLists(reverseMutexOccurrences),\n    taskMutexSlots: freezeSlotLists(taskMutexSlots)\n  };\n}\n\nfunction mutexSlotsForTask(task: PlannedTask, mutexSlotById: Map<string, number>): number[] {\n  return task.mutex.map((mutexId) => mutexSlotFor(mutexSlotById, mutexId));\n}\n\nfunction mutexSlotFor(mutexSlotById: Map<string, number>, mutexId: string): number {\n  const existingSlot = mutexSlotById.get(mutexId);\n  if (existingSlot !== undefined) return existingSlot;\n\n  const nextSlot = mutexSlotById.size;\n  mutexSlotById.set(mutexId, nextSlot);\n  return nextSlot;\n}\n\n/** Reverses relation occurrences while retaining the declared occurrence order for core transitions. */\nfunction compileRelationStaticIndexes(\n  graph: PlannedTaskGraph,\n  taskSlotsById: ReadonlyMap<string, number>\n): ReverseRelationIndexes {\n  const reverseDependencies = emptyTaskSlotLists(graph);\n  const reverseObservations = emptyTaskSlotLists(graph);\n\n  for (const [taskSlot, task] of graph.tasks.entries()) {\n    appendReverseRelationOccurrences(\n      task.dependsOn,\n      taskSlot,\n      taskSlotsById,\n      reverseDependencies,\n      \"dependency\"\n    );\n    appendReverseRelationOccurrences(\n      task.observes,\n      taskSlot,\n      taskSlotsById,\n      reverseObservations,\n      \"observation\"\n    );\n  }\n\n  return {\n    reverseDependencies: freezeSlotLists(reverseDependencies),\n    reverseObservations: freezeSlotLists(reverseObservations)\n  };\n}\n\nfunction appendReverseRelationOccurrences(\n  sourceTaskIds: readonly string[],\n  targetTaskSlot: number,\n  taskSlotsById: ReadonlyMap<string, number>,\n  reverseSlotsBySourceTask: number[][],\n  relationName: \"dependency\" | \"observation\"\n): void {\n  for (const sourceTaskId of sourceTaskIds) {\n    const sourceTaskSlot = taskSlotsById.get(sourceTaskId);\n    if (sourceTaskSlot === undefined) {\n      throw new Error(`admission core ${relationName} is unknown: ${sourceTaskId}`);\n    }\n    reverseSlotsBySourceTask[sourceTaskSlot]?.push(targetTaskSlot);\n  }\n}\n\n/** Associates scope terminals and activation candidates with the existing task slots. */\nfunction compileScopeStaticIndexes(\n  graph: PlannedTaskGraph,\n  catalog: GraphSlotCatalog\n): ScopeStaticIndexes {\n  const scopeSlotsByTerminalTaskSlot = emptyTaskSlotLists(graph);\n\n  for (const [scopeSlot, scope] of graph.scopes.entries()) {\n    const terminalTaskSlot = catalog.taskSlotsById.get(scope.terminalTaskId);\n    if (terminalTaskSlot === undefined) {\n      throw new Error(`admission core scope terminal is unknown: ${scope.terminalTaskId}`);\n    }\n    scopeSlotsByTerminalTaskSlot[terminalTaskSlot]?.push(scopeSlot);\n  }\n  const taskActivatesScope = graph.tasks.map((task) => {\n    const scopeSlot =\n      task.scopeId === undefined ? undefined : catalog.scopeSlotById.get(task.scopeId);\n    return (\n      scopeSlot !== undefined &&\n      graph.scopes[scopeSlot]?.activationTaskIds.includes(task.id) === true\n    );\n  });\n  const taskScopeSlots = graph.tasks.map((task) =>\n    task.scopeId === undefined ? undefined : catalog.scopeSlotById.get(task.scopeId)\n  );\n\n  return {\n    scopeSlotsByTerminalTaskSlot: freezeSlotLists(scopeSlotsByTerminalTaskSlot),\n    taskActivatesScope: Object.freeze(taskActivatesScope),\n    taskScopeSlots: Object.freeze(taskScopeSlots)\n  };\n}\n\n/** Materializes only the lexical catalog projection; declaration slots remain unchanged. */\nfunction compilePublicTaskOrder(\n  graph: PlannedTaskGraph,\n  taskSlotsById: ReadonlyMap<string, number>\n): PublicTaskOrder {\n  return {\n    taskIdsInPublicOrder: Object.freeze(graph.tasks.map((task) => task.id).sort(compareText)),\n    taskSlotsInPublicOrder: Object.freeze(\n      graph.tasks\n        .map((task) => taskSlotsById.get(task.id)!)\n        .sort((left, right) => compareText(graph.tasks[left].id, graph.tasks[right].id))\n    )\n  };\n}\n\n/** Freezes the one compiled graph object after every static compiler stage has completed. */\nfunction assembleCompiledAdmissionGraph(\n  parts: CompiledAdmissionGraphParts\n): CompiledAdmissionGraph {\n  const {\n    catalog,\n    graph,\n    maxParallel,\n    mutexIndexes,\n    publicTaskOrder,\n    relationIndexes,\n    resourceIndexes,\n    scopeIndexes\n  } = parts;\n  return Object.freeze({\n    graph,\n    maxParallel,\n    mutexSlotById: mutexIndexes.mutexSlotById,\n    resourceCapacityBySlot: resourceIndexes.resourceCapacityBySlot,\n    resourceSlotById: resourceIndexes.resourceSlotById,\n    relationIndexes: Object.freeze({\n      reverseDependencies: relationIndexes.reverseDependencies,\n      reverseMutexOccurrences: mutexIndexes.reverseMutexOccurrences,\n      reverseObservations: relationIndexes.reverseObservations\n    }),\n    scopesById: catalog.scopesById,\n    scopeSlotById: catalog.scopeSlotById,\n    scopeSlotsByTerminalTaskSlot: scopeIndexes.scopeSlotsByTerminalTaskSlot,\n    taskById: catalog.taskById,\n    taskIdsInPublicOrder: publicTaskOrder.taskIdsInPublicOrder,\n    taskMutexSlots: mutexIndexes.taskMutexSlots,\n    taskResourceClaims: resourceIndexes.taskResourceClaims,\n    taskActivatesScope: scopeIndexes.taskActivatesScope,\n    taskScopeSlots: scopeIndexes.taskScopeSlots,\n    taskSlotsById: catalog.taskSlotsById,\n    taskSlotsInPublicOrder: publicTaskOrder.taskSlotsInPublicOrder\n  });\n}\n\nfunction emptyTaskSlotLists(graph: PlannedTaskGraph): number[][] {\n  return graph.tasks.map(() => []);\n}\n\nfunction freezeSlotLists(slotLists: number[][]): readonly (readonly number[])[] {\n  return Object.freeze(slotLists.map((slots) => Object.freeze(slots)));\n}\n\nfunction compareText(left: string, right: string): number {\n  if (left < right) return -1;\n  if (left > right) return 1;\n  return 0;\n}\n"]}