@x12i/graphenix-trace-format 1.0.0

package/README.md

@@ -0,0 +1,242 @@
+# @x12i/graphenix-trace-format
+
+**GraphExecutionTrace** format — append-only run evidence for a single graph execution.
+
+Covers node traces, execution unit traces, model invocation attempts, fallback events, and final output. Does not depend on authoring graphs.
+
+**Canonical vocabulary:** [GLOSSARY.md](../../GLOSSARY.md) — task run phases map to trace `unit.*` events in plan order.  
+**Finalization brief:** [EXECUTE-TRACE-FORMAT-FINALIZATION.md](../../docs/EXECUTE-TRACE-FORMAT-FINALIZATION.md).
+
+Do not use **“Synthesis PRE”** in trace docs — use PRE-phase utility / `externalPreUtility` with `strategyKey`.
+
+---
+
+## Who should use this
+
+| Role | Use this package? |
+| ---- | ----------------- |
+| Execution engine | **Yes** — create and append events during a run |
+| Run history / observability / analytics | **Yes** — validate and read traces |
+| Graph designer / Studio | **No** (unless displaying run history) |
+
+---
+
+## Lifecycle position
+
+```txt
+ExecutableGraphPlan + GraphRuntimeObject
+        │  engine executes executionUnits[] (prePhase → mainPhase → postPhase)
+        ▼
+GraphExecutionTrace              ← THIS PACKAGE
+```
+
+Reference domain: content pipeline plan (`graph:content-pipeline`) — three parallel tasks with PRE synthesis + MAIN skill, no POST on reference tasks.
+
+---
+
+## Install
+
+```bash
+npm install @x12i/graphenix-trace-format
+```
+
+---
+
+## Trace document shape
+
+```txt
+GraphExecutionTrace
+  ├─ traceId, jobId, status, createdAt, completedAt
+  ├─ source — graphId, graphHash (from plan)
+  ├─ plan — planId, planHash (bind trace to frozen plan)
+  ├─ runtime — mode, environment, inputHash (no credentials)
+  ├─ events[] — append-only, ordered
+  └─ nodeExecutions{} — per-node unit summaries
+```
+
+---
+
+## Examples (JSON)
+
+### Trace header (bound to content pipeline plan)
+
+```json
+{
+  "format": "graphenix.execution-trace/v1",
+  "traceId": "trace:job-001",
+  "jobId": "job-001",
+  "createdAt": "2026-06-06T12:00:00.000Z",
+  "status": "running",
+  "source": {
+    "graphId": "graph:content-pipeline",
+    "graphRevision": "1.0.0",
+    "graphHash": "sha256:…"
+  },
+  "plan": {
+    "planId": "plan:abc123",
+    "planHash": "sha256:…"
+  },
+  "runtime": {
+    "mode": "live",
+    "environment": "prod",
+    "inputHash": "sha256:…"
+  },
+  "events": [],
+  "nodeExecutions": {}
+}
+```
+
+### Unit events for one content-pipeline task (PRE + MAIN)
+
+After `node:audience-insights` runs PRE-phase utility `synthesis` then MAIN skill:
+
+```json
+"events": [
+  {
+    "id": "evt:1",
+    "ts": "2026-06-06T12:00:01.000Z",
+    "level": "info",
+    "type": "node.started",
+    "nodeId": "node:audience-insights"
+  },
+  {
+    "id": "evt:2",
+    "ts": "2026-06-06T12:00:01.100Z",
+    "level": "info",
+    "type": "unit.started",
+    "nodeId": "node:audience-insights",
+    "unitId": "unit:node:audience-insights:pre:0",
+    "unitKind": "externalPreUtility"
+  },
+  {
+    "id": "evt:3",
+    "ts": "2026-06-06T12:00:02.500Z",
+    "level": "info",
+    "type": "model.invocation.completed",
+    "nodeId": "node:audience-insights",
+    "unitId": "unit:node:audience-insights:pre:0",
+    "modelSlot": "preActionModel"
+  },
+  {
+    "id": "evt:4",
+    "ts": "2026-06-06T12:00:02.600Z",
+    "level": "info",
+    "type": "unit.started",
+    "nodeId": "node:audience-insights",
+    "unitId": "unit:node:audience-insights:main:1",
+    "unitKind": "mainSkill"
+  },
+  {
+    "id": "evt:5",
+    "ts": "2026-06-06T12:00:05.000Z",
+    "level": "info",
+    "type": "node.completed",
+    "nodeId": "node:audience-insights"
+  }
+]
+```
+
+Model profiles were resolved at **compile time** — trace records which `modelSlot` was invoked, not a re-selected case.
+
+---
+
+## Example (API)
+
+```ts
+import {
+  createExecutionTrace,
+  appendExecutionEvent,
+  validateExecutionTrace,
+  deriveGraphStatus,
+  summarizeExecutionTrace
+} from "@x12i/graphenix-trace-format";
+
+const trace = createExecutionTrace(plan, runtime);
+
+appendExecutionEvent(trace, {
+  id: "evt:1",
+  ts: new Date().toISOString(),
+  level: "info",
+  type: "graph.started",
+  message: "Graph execution started."
+});
+
+appendExecutionEvent(trace, {
+  id: "evt:2",
+  ts: new Date().toISOString(),
+  level: "info",
+  type: "node.started",
+  nodeId: "node:audience-insights"
+});
+
+const result = validateExecutionTrace(trace, plan.nodePlans);
+const status = deriveGraphStatus(trace);
+const summary = summarizeExecutionTrace(trace);
+```
+
+---
+
+## Key exports
+
+| API | Purpose |
+| --- | ------- |
+| `createExecutionTrace` | Initialize trace bound to a plan + runtime |
+| `appendExecutionEvent` | Append-only event mutation |
+| `validateExecutionTrace` | Validate trace against plan node plans |
+| `deriveGraphStatus` | Overall run status from events |
+| `deriveNodeStatusFromUnits` | Per-node status |
+| `summarizeExecutionTrace` | Compact summary for dashboards |
+
+Trace event types include graph/node lifecycle, execution unit lifecycle (`unit.started` / `unit.completed`), model invocation, fallback applied, validation failures, and warnings.
+
+---
+
+## Validation tier
+
+| When | API |
+| ---- | --- |
+| Run end (engine) | `validateExecutionTrace(trace, plan.nodePlans)` |
+| Index / analytics | `validateExecutionTrace` before storing |
+| Dashboards | `deriveGraphStatus`, `summarizeExecutionTrace` |
+
+Store `planHash` (or full plan snapshot) with each trace for strict replay validation.
+
+---
+
+## Format identifiers
+
+```ts
+EXECUTION_TRACE_FORMAT     // v1 — @x12i/graphenix-executable-contracts
+EXECUTION_TRACE_FORMAT_V2  // v2 — when plan is v2
+```
+
+---
+
+## Dependencies
+
+- `@x12i/graphenix-executable-contracts` ^1.0.0
+
+---
+
+## Related packages
+
+| Package | Role |
+| ------- | ---- |
+| [GLOSSARY.md](../../GLOSSARY.md) | Phase vocabulary for unit events |
+| [`@x12i/graphenix-plan-format`](../plan-format) | Plan shape traces reference |
+| [`@x12i/graphenix-plan-compiler`](../plan-compiler) | Produces the plan a trace is bound to |
+| [EXECUTE-TRACE-FORMAT-FINALIZATION.md](../../docs/EXECUTE-TRACE-FORMAT-FINALIZATION.md) | Execute + trace phase brief |
+| [observability role guide](../../docs/roles/observability.md) | Run history client guide |
+
+---
+
+## README sync policy
+
+When documenting **task run phases** at execution/trace layer, update together:
+
+| Layer | README / doc |
+| ----- | ------------ |
+| Compiled plan units | [plan-format/README.md](../plan-format/README.md) |
+| Trace events | **this file** |
+| Execute + trace brief | [EXECUTE-TRACE-FORMAT-FINALIZATION.md](../../docs/EXECUTE-TRACE-FORMAT-FINALIZATION.md) |
+| Terms of record | [GLOSSARY.md](../../GLOSSARY.md) |

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createExecutionTrace } from "./trace/create-execution-trace.js";
+export { createEmptyExecutionTrace } from "./trace/create-empty-execution-trace.js";
+export { appendExecutionEvent } from "./trace/append-execution-event.js";
+export { appendTraceEvent } from "./trace/append-trace-event.js";
+export { deriveGraphStatus, deriveNodeStatusFromUnits } from "./trace/derive-graph-status.js";
+export { summarizeExecutionTrace } from "./trace/summarize-execution-trace.js";
+export { validateExecutionTrace, assertExecutionTrace } from "./validators/validate-execution-trace.js";
+export { validateExecutionTraceV1 } from "./validators/validate-execution-trace-v1.js";
+export { validateExecutionTraceV2 } from "./validators/validate-execution-trace-v2.js";
+export { validateTraceAgainstPlan } from "./validators/validate-trace-against-plan.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC9F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export { createExecutionTrace } from "./trace/create-execution-trace.js";
+export { createEmptyExecutionTrace } from "./trace/create-empty-execution-trace.js";
+export { appendExecutionEvent } from "./trace/append-execution-event.js";
+export { appendTraceEvent } from "./trace/append-trace-event.js";
+export { deriveGraphStatus, deriveNodeStatusFromUnits } from "./trace/derive-graph-status.js";
+export { summarizeExecutionTrace } from "./trace/summarize-execution-trace.js";
+export { validateExecutionTrace, assertExecutionTrace } from "./validators/validate-execution-trace.js";
+export { validateExecutionTraceV1 } from "./validators/validate-execution-trace-v1.js";
+export { validateExecutionTraceV2 } from "./validators/validate-execution-trace-v2.js";
+export { validateTraceAgainstPlan } from "./validators/validate-trace-against-plan.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AACpF,OAAO,EAAE,oBAAoB,EAAE,MAAM,mCAAmC,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,gCAAgC,CAAC;AAC9F,OAAO,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACrB,MAAM,0CAA0C,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC;AACvF,OAAO,EAAE,wBAAwB,EAAE,MAAM,6CAA6C,CAAC"}

package/dist/internal/trace-v2-utils.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutableGraphPlanV2 } from "@x12i/graphenix-executable-contracts";
+import type { TracePlanRef } from "@x12i/graphenix-executable-contracts";
+export declare function buildTracePlanRef(plan: ExecutableGraphPlanV2): TracePlanRef;
+export declare function collectAllPlanUnitIds(plan: ExecutableGraphPlanV2): string[];
+export declare function collectAllPlanNodeIds(plan: ExecutableGraphPlanV2): string[];
+export declare function collectDeferredGateIds(plan: ExecutableGraphPlanV2): string[];
+export declare function isTerminalNodeStatus(status: string): status is "completed" | "failed" | "skipped";
+export declare function isTerminalUnitStatus(status: string): status is "completed" | "failed" | "skipped";
+export declare function isAiBackedUnit(unitKind: string, executionClass: string): boolean;
+//# sourceMappingURL=trace-v2-utils.d.ts.map

package/dist/internal/trace-v2-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-v2-utils.d.ts","sourceRoot":"","sources":["../../src/internal/trace-v2-utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAIzE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,qBAAqB,GAAG,YAAY,CAY3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAa3E;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAM3E;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,qBAAqB,GAAG,MAAM,EAAE,CAY5E;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,GACb,MAAM,IAAI,WAAW,GAAG,QAAQ,GAAG,SAAS,CAE9C;AAED,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,GACb,MAAM,IAAI,WAAW,GAAG,QAAQ,GAAG,SAAS,CAE9C;AAED,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAST"}

package/dist/internal/trace-v2-utils.js

@@ -0,0 +1,65 @@
+import { EXECUTABLE_PLAN_FORMAT_V2 } from "@x12i/graphenix-executable-contracts";
+import { defaultHashFunction } from "@x12i/graphenix-executable-contracts";
+export function buildTracePlanRef(plan) {
+    const hash = defaultHashFunction;
+    return {
+        planId: plan.planId,
+        planFormat: EXECUTABLE_PLAN_FORMAT_V2,
+        planHash: hash(plan),
+        normalizedGraphHash: plan.normalizedGraph.graphHash,
+        schedulingPolicyHash: hash(plan.schedulingPolicy),
+        topologyHash: hash(plan.topology),
+        deferredGatesHash: hash(plan.deferredGates),
+        nodePlansHash: hash(plan.nodePlans)
+    };
+}
+export function collectAllPlanUnitIds(plan) {
+    const unitIds = [];
+    for (const nodePlan of Object.values(plan.nodePlans)) {
+        for (const unit of nodePlan.executionUnits) {
+            unitIds.push(unit.unitId);
+        }
+    }
+    for (const finalizerPlan of Object.values(plan.finalizerPlans)) {
+        for (const unit of finalizerPlan.executionUnits) {
+            unitIds.push(unit.unitId);
+        }
+    }
+    return unitIds;
+}
+export function collectAllPlanNodeIds(plan) {
+    const nodeIds = new Set();
+    for (const nodeRef of plan.topology.nodes) {
+        nodeIds.add(nodeRef.nodeId);
+    }
+    return [...nodeIds];
+}
+export function collectDeferredGateIds(plan) {
+    const gateIds = [];
+    for (const gate of plan.deferredGates.entryGates ?? []) {
+        gateIds.push(gate.gateId);
+    }
+    for (const gate of Object.values(plan.deferredGates.nodeGates)) {
+        gateIds.push(gate.gateId);
+    }
+    for (const gate of Object.values(plan.deferredGates.edgeGates)) {
+        gateIds.push(gate.gateId);
+    }
+    return gateIds;
+}
+export function isTerminalNodeStatus(status) {
+    return status === "completed" || status === "failed" || status === "skipped";
+}
+export function isTerminalUnitStatus(status) {
+    return status === "completed" || status === "failed" || status === "skipped";
+}
+export function isAiBackedUnit(unitKind, executionClass) {
+    if (executionClass === "localTask")
+        return false;
+    return (unitKind === "externalPreUtility" ||
+        unitKind === "mainSkill" ||
+        unitKind === "pipelinePhase" ||
+        unitKind === "externalPostUtility" ||
+        unitKind === "finalizer");
+}
+//# sourceMappingURL=trace-v2-utils.js.map

package/dist/internal/trace-v2-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-v2-utils.js","sourceRoot":"","sources":["../../src/internal/trace-v2-utils.ts"],"names":[],"mappings":"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"}

package/dist/trace/append-execution-event.d.ts

@@ -0,0 +1,5 @@
+import type { GraphExecutionEvent, GraphExecutionTrace } from "@x12i/graphenix-executable-contracts";
+export declare function appendExecutionEvent(trace: GraphExecutionTrace, event: GraphExecutionEvent, options?: {
+    mutate?: boolean;
+}): GraphExecutionTrace;
+//# sourceMappingURL=append-execution-event.d.ts.map

package/dist/trace/append-execution-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-execution-event.d.ts","sourceRoot":"","sources":["../../src/trace/append-execution-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,sCAAsC,CAAC;AAE9C,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,mBAAmB,EAC1B,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,mBAAmB,CAIrB"}

package/dist/trace/append-execution-event.js

@@ -0,0 +1,6 @@
+export function appendExecutionEvent(trace, event, options = {}) {
+    const target = options.mutate ? trace : structuredClone(trace);
+    target.events = [...target.events, event];
+    return target;
+}
+//# sourceMappingURL=append-execution-event.js.map

package/dist/trace/append-execution-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-execution-event.js","sourceRoot":"","sources":["../../src/trace/append-execution-event.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,oBAAoB,CAClC,KAA0B,EAC1B,KAA0B,EAC1B,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC/D,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/trace/append-trace-event.d.ts

@@ -0,0 +1,5 @@
+import type { GraphExecutionTraceV2, TraceEvent } from "@x12i/graphenix-executable-contracts";
+export declare function appendTraceEvent(trace: GraphExecutionTraceV2, event: TraceEvent, options?: {
+    mutate?: boolean;
+}): GraphExecutionTraceV2;
+//# sourceMappingURL=append-trace-event.d.ts.map

package/dist/trace/append-trace-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-trace-event.d.ts","sourceRoot":"","sources":["../../src/trace/append-trace-event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,UAAU,EACX,MAAM,sCAAsC,CAAC;AAE9C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,qBAAqB,EAC5B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAA;CAAO,GACjC,qBAAqB,CAIvB"}

package/dist/trace/append-trace-event.js

@@ -0,0 +1,6 @@
+export function appendTraceEvent(trace, event, options = {}) {
+    const target = options.mutate ? trace : structuredClone(trace);
+    target.events = [...target.events, event];
+    return target;
+}
+//# sourceMappingURL=append-trace-event.js.map

package/dist/trace/append-trace-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"append-trace-event.js","sourceRoot":"","sources":["../../src/trace/append-trace-event.ts"],"names":[],"mappings":"AAKA,MAAM,UAAU,gBAAgB,CAC9B,KAA4B,EAC5B,KAAiB,EACjB,UAAgC,EAAE;IAElC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;IAC/D,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC1C,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/trace/create-empty-execution-trace.d.ts

@@ -0,0 +1,10 @@
+import type { ExecutableGraphPlanV2 } from "@x12i/graphenix-executable-contracts";
+import type { GraphExecutionTraceV2 } from "@x12i/graphenix-executable-contracts";
+import type { GraphRuntimeObject } from "@x12i/graphenix-executable-contracts";
+export declare function createEmptyExecutionTrace(args: {
+    traceId: string;
+    plan: ExecutableGraphPlanV2;
+    runtime: GraphRuntimeObject;
+    now?: string;
+}): GraphExecutionTraceV2;
+//# sourceMappingURL=create-empty-execution-trace.d.ts.map

package/dist/trace/create-empty-execution-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-empty-execution-trace.d.ts","sourceRoot":"","sources":["../../src/trace/create-empty-execution-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAEV,qBAAqB,EAEtB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AA+D/E,wBAAgB,yBAAyB,CAAC,IAAI,EAAE;IAC9C,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,qBAAqB,CAAC;IAC5B,OAAO,EAAE,kBAAkB,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,GAAG,qBAAqB,CAwFxB"}

package/dist/trace/create-empty-execution-trace.js

@@ -0,0 +1,133 @@
+import { EXECUTION_TRACE_FORMAT_V2 } from "@x12i/graphenix-executable-contracts";
+import { buildTracePlanRef, collectAllPlanNodeIds } from "../internal/trace-v2-utils.js";
+function buildUnitTrace(unit) {
+    return {
+        unitId: unit.unitId,
+        nodeId: unit.nodeId,
+        unitKind: unit.unitKind,
+        invokeMode: unit.invokeMode,
+        order: unit.order,
+        status: "pending",
+        plannedModelSelection: unit.modelSelection,
+        modelSlot: unit.modelSlot
+    };
+}
+function buildNodeTrace(plan, nodeId) {
+    const nodeRef = plan.topology.nodes.find((n) => n.nodeId === nodeId);
+    const nodePlan = plan.nodePlans[nodeId];
+    const finalizerPlan = plan.finalizerPlans[nodeId];
+    if (nodePlan) {
+        const unitIds = nodePlan.executionUnits.map((u) => u.unitId);
+        return {
+            nodeId,
+            nodeType: nodePlan.nodeType,
+            executionClass: nodePlan.executionClass,
+            status: "pending",
+            selectedCases: nodePlan.selectedCases,
+            gateEvaluationIds: nodePlan.deferredGateIds,
+            unitIds
+        };
+    }
+    if (finalizerPlan) {
+        const unitIds = finalizerPlan.executionUnits.map((u) => u.unitId);
+        return {
+            nodeId,
+            nodeType: "finalizer",
+            executionClass: "finalizer",
+            status: "pending",
+            unitIds
+        };
+    }
+    return {
+        nodeId,
+        nodeType: nodeRef?.nodeType ?? "special",
+        executionClass: nodeRef?.executionClass ?? "special",
+        status: "pending",
+        unitIds: []
+    };
+}
+export function createEmptyExecutionTrace(args) {
+    const now = args.now ?? new Date().toISOString();
+    const plan = args.plan;
+    const runtime = args.runtime;
+    const nodeExecutions = {};
+    const unitExecutions = {};
+    for (const nodeId of collectAllPlanNodeIds(plan)) {
+        nodeExecutions[nodeId] = buildNodeTrace(plan, nodeId);
+    }
+    for (const nodePlan of Object.values(plan.nodePlans)) {
+        for (const unit of nodePlan.executionUnits) {
+            unitExecutions[unit.unitId] = buildUnitTrace(unit);
+        }
+    }
+    for (const finalizerPlan of Object.values(plan.finalizerPlans)) {
+        for (const unit of finalizerPlan.executionUnits) {
+            unitExecutions[unit.unitId] = buildUnitTrace(unit);
+        }
+    }
+    return {
+        format: EXECUTION_TRACE_FORMAT_V2,
+        traceId: args.traceId,
+        jobId: runtime.jobId,
+        createdAt: now,
+        status: "created",
+        source: {
+            graphId: plan.source.graphId,
+            graphRevision: plan.source.graphRevision,
+            graphHash: plan.source.graphHash,
+            authoringFormatVersion: plan.source.formatVersion
+        },
+        plan: buildTracePlanRef(plan),
+        runtime: {
+            jobId: runtime.jobId,
+            mode: runtime.mode,
+            environment: plan.runtimeBinding.environment,
+            inputHash: plan.runtimeBinding.inputHash,
+            contextHash: plan.runtimeBinding.contextHash,
+            variablesHash: plan.runtimeBinding.variablesHash,
+            agentId: runtime.job?.agentId,
+            jobTypeId: runtime.job?.jobTypeId
+        },
+        profileRegistry: plan.profileRegistry,
+        events: [
+            {
+                id: `evt:${args.traceId}:created`,
+                ts: now,
+                sequence: 0,
+                level: "info",
+                type: "graph.created",
+                message: "Execution trace created."
+            }
+        ],
+        graphExecution: {
+            startedNodeIds: [],
+            completedNodeIds: [],
+            failedNodeIds: [],
+            skippedNodeIds: [],
+            startedUnitIds: [],
+            completedUnitIds: [],
+            failedUnitIds: [],
+            skippedUnitIds: [],
+            finalizerNodeIds: plan.topology.finalizerNodeIds
+        },
+        gateEvaluations: {},
+        nodeExecutions,
+        unitExecutions,
+        modelInvocations: {},
+        memory: {
+            reads: [],
+            writes: []
+        },
+        diagnostics: {
+            dataPolicy: {
+                storeFullInputs: false,
+                storeFullOutputs: false,
+                storePrompts: false,
+                storeProviderResponses: false,
+                maxPreviewChars: 512,
+                requireDataRefsForLargeValues: true
+            }
+        }
+    };
+}
+//# sourceMappingURL=create-empty-execution-trace.js.map

package/dist/trace/create-empty-execution-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-empty-execution-trace.js","sourceRoot":"","sources":["../../src/trace/create-empty-execution-trace.ts"],"names":[],"mappings":"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"}

package/dist/trace/create-execution-trace.d.ts

@@ -0,0 +1,5 @@
+import type { ExecutableGraphPlan } from "@x12i/graphenix-executable-contracts";
+import type { GraphExecutionTrace } from "@x12i/graphenix-executable-contracts";
+import type { GraphRuntimeObject } from "@x12i/graphenix-executable-contracts";
+export declare function createExecutionTrace(plan: ExecutableGraphPlan, runtime: GraphRuntimeObject): GraphExecutionTrace;
+//# sourceMappingURL=create-execution-trace.d.ts.map

package/dist/trace/create-execution-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-execution-trace.d.ts","sourceRoot":"","sources":["../../src/trace/create-execution-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAChF,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AA4B/E,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,mBAAmB,EACzB,OAAO,EAAE,kBAAkB,GAC1B,mBAAmB,CAgCrB"}

package/dist/trace/create-execution-trace.js

@@ -0,0 +1,53 @@
+import { EXECUTION_TRACE_FORMAT } from "@x12i/graphenix-executable-contracts";
+import { defaultHashFunction } from "@x12i/graphenix-executable-contracts";
+function buildNodeExecutionTrace(nodePlan) {
+    const units = {};
+    for (const unit of nodePlan.executionUnits) {
+        units[unit.unitId] = {
+            unitId: unit.unitId,
+            nodeId: unit.nodeId,
+            unitKind: unit.unitKind,
+            status: "pending",
+            plannedModelSelection: unit.modelSelection
+        };
+    }
+    return {
+        nodeId: nodePlan.nodeId,
+        nodeType: nodePlan.nodeType,
+        status: "pending",
+        selectedCases: nodePlan.selectedCases,
+        units
+    };
+}
+export function createExecutionTrace(plan, runtime) {
+    const now = new Date().toISOString();
+    const planHash = defaultHashFunction(plan);
+    const nodeExecutions = {};
+    for (const nodePlan of Object.values(plan.nodePlans)) {
+        nodeExecutions[nodePlan.nodeId] = buildNodeExecutionTrace(nodePlan);
+    }
+    return {
+        format: EXECUTION_TRACE_FORMAT,
+        traceId: `trace:${runtime.jobId}`,
+        jobId: runtime.jobId,
+        createdAt: now,
+        status: "queued",
+        source: {
+            graphId: plan.source.graphId,
+            graphRevision: plan.source.graphRevision,
+            graphHash: plan.source.graphHash
+        },
+        plan: {
+            planId: plan.planId,
+            planHash
+        },
+        runtime: {
+            mode: runtime.mode,
+            environment: plan.runtimeBinding.environment,
+            inputHash: plan.runtimeBinding.inputHash
+        },
+        events: [],
+        nodeExecutions
+    };
+}
+//# sourceMappingURL=create-execution-trace.js.map

package/dist/trace/create-execution-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-execution-trace.js","sourceRoot":"","sources":["../../src/trace/create-execution-trace.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAE3E,SAAS,uBAAuB,CAC9B,QAAkD;IAElD,MAAM,KAAK,GAAuC,EAAE,CAAC;IAErD,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,cAAc,EAAE,CAAC;QAC3C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,MAAM,EAAE,SAAS;YACjB,qBAAqB,EAAE,IAAI,CAAC,cAAc;SAC3C,CAAC;IACJ,CAAC;IAED,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM;QACvB,QAAQ,EAAE,QAAQ,CAAC,QAAQ;QAC3B,MAAM,EAAE,SAAS;QACjB,aAAa,EAAE,QAAQ,CAAC,aAAa;QACrC,KAAK;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,IAAyB,EACzB,OAA2B;IAE3B,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC3C,MAAM,cAAc,GAAuC,EAAE,CAAC;IAE9D,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACrD,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACtE,CAAC;IAED,OAAO;QACL,MAAM,EAAE,sBAAsB;QAC9B,OAAO,EAAE,SAAS,OAAO,CAAC,KAAK,EAAE;QACjC,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,GAAG;QACd,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE;YACN,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;YAC5B,aAAa,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa;YACxC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;SACjC;QACD,IAAI,EAAE;YACJ,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ;SACT;QACD,OAAO,EAAE;YACP,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,WAAW,EAAE,IAAI,CAAC,cAAc,CAAC,WAAW;YAC5C,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,SAAS;SACzC;QACD,MAAM,EAAE,EAAE;QACV,cAAc;KACf,CAAC;AACJ,CAAC"}

package/dist/trace/derive-graph-status.d.ts

@@ -0,0 +1,4 @@
+import type { ExecutionStatus, GraphExecutionTraceV2 } from "@x12i/graphenix-executable-contracts";
+export declare function deriveGraphStatus(trace: GraphExecutionTraceV2): ExecutionStatus;
+export declare function deriveNodeStatusFromUnits(trace: GraphExecutionTraceV2, nodeId: string): "pending" | "running" | "completed" | "failed" | "skipped";
+//# sourceMappingURL=derive-graph-status.d.ts.map

package/dist/trace/derive-graph-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"derive-graph-status.d.ts","sourceRoot":"","sources":["../../src/trace/derive-graph-status.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,qBAAqB,EACtB,MAAM,sCAAsC,CAAC;AAM9C,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,qBAAqB,GAAG,eAAe,CAsC/E;AAED,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,MAAM,GACb,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CA+B5D"}