@x12i/graphenix-trace-format 1.1.0 → 1.1.1

package/README.md

@@ -186,9 +186,12 @@ const summary = summarizeExecutionTrace(trace);
 | `deriveGraphStatus` | Overall run status from events |
 | `deriveNodeStatusFromUnits` | Per-node status |
 | `summarizeExecutionTrace` | Compact summary for dashboards |
+| `createContentPipelineReferenceTrace(plan, options?)` | Build completed CP trace for tests and golden fixtures |
 
 Trace event types include graph/node lifecycle, execution unit lifecycle (`unit.started` / `unit.completed`), model invocation, fallback applied, validation failures, and warnings.
 
+**Event catalog (required fields per type):** [execution-logs.md](../../docs/guides/execution-logs.md#event-catalog-v2) · golden trace: `fixtures/content-pipeline.trace.json`
+
 ---
 
 ## Validation tier
@@ -214,7 +217,7 @@ EXECUTION_TRACE_FORMAT_V2  // v2 — when plan is v2
 
 ## Dependencies
 
-- `@x12i/graphenix-executable-contracts` ^1.0.0
+- `@x12i/graphenix-executable-contracts` ^1.1.0
 
 ---
 

package/dist/fixtures/create-content-pipeline-reference-trace.d.ts

@@ -0,0 +1,13 @@
+import type { ExecutableGraphPlanV2, GraphExecutionTraceV2, GraphRuntimeObject } from "@x12i/graphenix-executable-contracts";
+export interface CreateContentPipelineReferenceTraceOptions {
+    traceId?: string;
+    now?: string;
+    runtime?: GraphRuntimeObject;
+}
+/**
+ * Build a completed v2 trace for a content-pipeline plan — all units and nodes
+ * marked completed with synthetic model invocations for AI-backed units.
+ * Used as golden fixture input and lifecycle acceptance tests.
+ */
+export declare function createContentPipelineReferenceTrace(plan: ExecutableGraphPlanV2, options?: CreateContentPipelineReferenceTraceOptions): GraphExecutionTraceV2;
+//# sourceMappingURL=create-content-pipeline-reference-trace.d.ts.map

package/dist/fixtures/create-content-pipeline-reference-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-content-pipeline-reference-trace.d.ts","sourceRoot":"","sources":["../../src/fixtures/create-content-pipeline-reference-trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAI9C,MAAM,WAAW,0CAA0C;IACzD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,IAAI,EAAE,qBAAqB,EAC3B,OAAO,GAAE,0CAA+C,GACvD,qBAAqB,CA+HvB"}

package/dist/fixtures/create-content-pipeline-reference-trace.js

@@ -0,0 +1,121 @@
+import { appendTraceEvent } from "../trace/append-trace-event.js";
+import { createEmptyExecutionTrace } from "../trace/create-empty-execution-trace.js";
+/**
+ * Build a completed v2 trace for a content-pipeline plan — all units and nodes
+ * marked completed with synthetic model invocations for AI-backed units.
+ * Used as golden fixture input and lifecycle acceptance tests.
+ */
+export function createContentPipelineReferenceTrace(plan, options = {}) {
+    const now = options.now ?? "2026-06-07T12:00:01.000Z";
+    const runtime = options.runtime ??
+        {
+            jobId: plan.runtimeBinding.jobId,
+            job: { id: plan.runtimeBinding.jobId, jobId: plan.runtimeBinding.jobId },
+            input: { priority: "normal" },
+            mode: "simulate"
+        };
+    let trace = createEmptyExecutionTrace({
+        traceId: options.traceId ?? `trace:${plan.runtimeBinding.jobId}`,
+        plan,
+        runtime,
+        now: options.now ?? "2026-06-07T12:00:00.000Z"
+    });
+    let seq = 1;
+    const append = (event) => {
+        trace = appendTraceEvent(trace, { ...event, sequence: seq++ });
+    };
+    append({ id: "evt:graph:start", ts: now, level: "info", type: "graph.started" });
+    for (const [unitId, unit] of Object.entries(trace.unitExecutions)) {
+        trace.unitExecutions[unitId] = {
+            ...unit,
+            status: "completed",
+            startedAt: now,
+            completedAt: now,
+            durationMs: 10
+        };
+        append({
+            id: `evt:${unitId}:start`,
+            ts: now,
+            level: "info",
+            type: "unit.started",
+            unitId,
+            nodeId: unit.nodeId,
+            unitKind: unit.unitKind
+        });
+        append({
+            id: `evt:${unitId}:done`,
+            ts: now,
+            level: "info",
+            type: "unit.completed",
+            unitId,
+            nodeId: unit.nodeId,
+            unitKind: unit.unitKind
+        });
+        const aiBacked = unit.unitKind !== "localSkill" &&
+            unit.unitKind !== "mapping" &&
+            unit.unitKind !== "validation" &&
+            unit.modelSlot;
+        if (aiBacked && unit.modelSlot) {
+            const invocationId = `inv:${unitId}:1`;
+            const selection = unit.plannedModelSelection ?? {
+                kind: "profileChoice",
+                key: "vol/default"
+            };
+            trace.modelInvocations[invocationId] = {
+                invocationId,
+                nodeId: unit.nodeId,
+                unitId,
+                slot: unit.modelSlot,
+                attempt: 1,
+                status: "completed",
+                startedAt: now,
+                completedAt: now,
+                durationMs: 5,
+                plannedSelection: selection,
+                resolvedInvocation: {
+                    provider: "openrouter",
+                    modelId: "gpt-4o-mini",
+                    profileChoiceKey: selection.kind === "profileChoice" ? selection.key : undefined,
+                    registryVersion: plan.profileRegistry.version,
+                    registryHash: plan.profileRegistry.registryHash,
+                    resolutionSource: "profileRegistry"
+                },
+                usage: { inputTokens: 100, outputTokens: 50, totalTokens: 150 },
+                cost: { costUsd: 0.001, costStatus: "known" }
+            };
+            trace.unitExecutions[unitId].modelInvocationIds = [invocationId];
+        }
+        trace.graphExecution.startedUnitIds.push(unitId);
+        trace.graphExecution.completedUnitIds.push(unitId);
+    }
+    for (const nodeId of Object.keys(trace.nodeExecutions)) {
+        trace.nodeExecutions[nodeId] = {
+            ...trace.nodeExecutions[nodeId],
+            status: "completed",
+            startedAt: now,
+            completedAt: now,
+            durationMs: 20
+        };
+        trace.graphExecution.startedNodeIds.push(nodeId);
+        trace.graphExecution.completedNodeIds.push(nodeId);
+        append({
+            id: `evt:${nodeId}:done`,
+            ts: now,
+            level: "info",
+            type: "node.completed",
+            nodeId
+        });
+    }
+    trace.finalOutput = {
+        producedByNodeId: plan.topology.finalizerNodeIds[0],
+        valueHash: "sha256:cp-reference-output",
+        responseShapePath: plan.contracts.response.responseShapePath,
+        schemaValidation: { valid: true }
+    };
+    trace.completedAt = now;
+    trace.startedAt = now;
+    append({ id: "evt:graph:done", ts: now, level: "info", type: "graph.completed" });
+    trace.status = "completed";
+    return trace;
+}
+//# sourceMappingURL=create-content-pipeline-reference-trace.js.map

package/dist/fixtures/create-content-pipeline-reference-trace.js.map

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

package/dist/index.d.ts

@@ -8,4 +8,5 @@ export { validateExecutionTrace, assertExecutionTrace } from "./validators/valid
 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";
+export { createContentPipelineReferenceTrace, type CreateContentPipelineReferenceTraceOptions } from "./fixtures/create-content-pipeline-reference-trace.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +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"}
+{"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;AAEvF,OAAO,EACL,mCAAmC,EACnC,KAAK,0CAA0C,EAChD,MAAM,uDAAuD,CAAC"}

package/dist/index.js

@@ -8,4 +8,5 @@ export { validateExecutionTrace, assertExecutionTrace } from "./validators/valid
 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";
+export { createContentPipelineReferenceTrace } from "./fixtures/create-content-pipeline-reference-trace.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +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"}
+{"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;AAEvF,OAAO,EACL,mCAAmC,EAEpC,MAAM,uDAAuD,CAAC"}

package/dist/test/golden-fixtures.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=golden-fixtures.test.d.ts.map

package/dist/test/golden-fixtures.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-fixtures.test.d.ts","sourceRoot":"","sources":["../../src/test/golden-fixtures.test.ts"],"names":[],"mappings":""}

package/dist/test/golden-fixtures.test.js

@@ -0,0 +1,34 @@
+import assert from "node:assert/strict";
+import { readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { describe, it } from "node:test";
+import { createContentPipelineReferenceTrace } from "../fixtures/create-content-pipeline-reference-trace.js";
+import { validateTraceAgainstPlan } from "../validators/validate-trace-against-plan.js";
+const TEST_DIR = dirname(fileURLToPath(import.meta.url));
+const TRACE_FIXTURE = join(TEST_DIR, "../../fixtures/content-pipeline.trace.json");
+const PLAN_FIXTURE = join(TEST_DIR, "../../../plan-format/fixtures/content-pipeline.plan.json");
+describe("trace-format golden fixtures", () => {
+    it("content-pipeline.trace.json validates against golden plan", () => {
+        const plan = JSON.parse(readFileSync(PLAN_FIXTURE, "utf8"));
+        const golden = JSON.parse(readFileSync(TRACE_FIXTURE, "utf8"));
+        assert.equal(validateTraceAgainstPlan(golden, plan).valid, true);
+        assert.equal(golden.status, "completed");
+    });
+    it("createContentPipelineReferenceTrace is deterministic for golden plan", () => {
+        const plan = JSON.parse(readFileSync(PLAN_FIXTURE, "utf8"));
+        const opts = {
+            traceId: "trace:job-content-pipeline-reference",
+            now: "2026-06-07T12:00:01.000Z"
+        };
+        const a = createContentPipelineReferenceTrace(plan, opts);
+        const b = createContentPipelineReferenceTrace(plan, opts);
+        const golden = JSON.parse(readFileSync(TRACE_FIXTURE, "utf8"));
+        assert.equal(validateTraceAgainstPlan(a, plan).valid, true);
+        assert.deepEqual(a.plan, b.plan);
+        assert.equal(golden.traceId, a.traceId);
+        assert.equal(golden.events.length, a.events.length);
+        assert.equal(golden.status, a.status);
+    });
+});
+//# sourceMappingURL=golden-fixtures.test.js.map

package/dist/test/golden-fixtures.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden-fixtures.test.js","sourceRoot":"","sources":["../../src/test/golden-fixtures.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEzC,OAAO,EAAE,mCAAmC,EAAE,MAAM,wDAAwD,CAAC;AAC7G,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAExF,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACzD,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,4CAA4C,CAAC,CAAC;AACnF,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,EAAE,0DAA0D,CAAC,CAAC;AAEhG,QAAQ,CAAC,8BAA8B,EAAE,GAAG,EAAE;IAC5C,EAAE,CAAC,2DAA2D,EAAE,GAAG,EAAE;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAA0B,CAAC;QACrF,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;QAC/D,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QACjE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sEAAsE,EAAE,GAAG,EAAE;QAC9E,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAA0B,CAAC;QACrF,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,sCAAsC;YAC/C,GAAG,EAAE,0BAA0B;SAChC,CAAC;QACF,MAAM,CAAC,GAAG,mCAAmC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,mCAAmC,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC;QAE/D,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC5D,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC;IACxC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/reference-fixtures.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=reference-fixtures.test.d.ts.map

package/dist/test/reference-fixtures.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-fixtures.test.d.ts","sourceRoot":"","sources":["../../src/test/reference-fixtures.test.ts"],"names":[],"mappings":""}

package/dist/test/reference-fixtures.test.js

@@ -0,0 +1,30 @@
+import assert from "node:assert/strict";
+import { describe, it } from "node:test";
+import { createContentPipelineReferencePlan } from "@x12i/graphenix-plan-compiler";
+import { createContentPipelineReferenceTrace } from "../fixtures/create-content-pipeline-reference-trace.js";
+import { validateTraceAgainstPlan } from "../validators/validate-trace-against-plan.js";
+const PROFILE_REGISTRY = {
+    version: "3.2.0",
+    registryHash: "sha256:profiles-content-pipeline-reference"
+};
+describe("trace-format reference fixtures", () => {
+    it("createContentPipelineReferenceTrace validates against CP plan", () => {
+        const plan = createContentPipelineReferencePlan({
+            jobId: "job-content-pipeline-reference",
+            profileRegistry: PROFILE_REGISTRY
+        });
+        const trace = createContentPipelineReferenceTrace(plan);
+        assert.equal(trace.status, "completed");
+        assert.equal(trace.format, "graphenix.execution-trace/v2");
+        assert.ok(Object.keys(trace.nodeExecutions).length >= 3);
+        assert.equal(validateTraceAgainstPlan(trace, plan).valid, true);
+    });
+    it("CP trace includes model invocations for AI-backed units", () => {
+        const plan = createContentPipelineReferencePlan({
+            profileRegistry: PROFILE_REGISTRY
+        });
+        const trace = createContentPipelineReferenceTrace(plan);
+        assert.ok(Object.keys(trace.modelInvocations).length >= 3);
+    });
+});
+//# sourceMappingURL=reference-fixtures.test.js.map

package/dist/test/reference-fixtures.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-fixtures.test.js","sourceRoot":"","sources":["../../src/test/reference-fixtures.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,kCAAkC,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,EAAE,mCAAmC,EAAE,MAAM,wDAAwD,CAAC;AAC7G,OAAO,EAAE,wBAAwB,EAAE,MAAM,8CAA8C,CAAC;AAExF,MAAM,gBAAgB,GAAG;IACvB,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE,4CAA4C;CAC3D,CAAC;AAEF,QAAQ,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC/C,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,IAAI,GAAG,kCAAkC,CAAC;YAC9C,KAAK,EAAE,gCAAgC;YACvC,eAAe,EAAE,gBAAgB;SAClC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,CAAC;QAExD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;QACxC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,8BAA8B,CAAC,CAAC;QAC3D,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;QACzD,MAAM,CAAC,KAAK,CAAC,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAClE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,IAAI,GAAG,kCAAkC,CAAC;YAC9C,eAAe,EAAE,gBAAgB;SAClC,CAAC,CAAC;QACH,MAAM,KAAK,GAAG,mCAAmC,CAAC,IAAI,CAAC,CAAC;QACxD,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC;IAC7D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/fixtures/content-pipeline.trace.json

@@ -0,0 +1,779 @@
+{
+  "format": "graphenix.execution-trace/v2",
+  "traceId": "trace:job-content-pipeline-reference",
+  "jobId": "job-content-pipeline-reference",
+  "createdAt": "2026-06-07T12:00:01.000Z",
+  "status": "completed",
+  "source": {
+    "graphId": "graph:content-pipeline",
+    "graphRevision": "1.0.0",
+    "graphHash": "sha256:9efc44d3e758f84cf8297e18a0a33316a7e0a0b9c82a962acc6c9153fb334149",
+    "authoringFormatVersion": "2.0.0"
+  },
+  "plan": {
+    "planId": "plan:content-pipeline:job-content-pipeline-reference",
+    "planFormat": "graphenix.executable-plan/v2",
+    "planHash": "sha256:28c75c7688fb5541416bdcc61edceb6204eee96f455f85d56940cd059fe1642a",
+    "normalizedGraphHash": "sha256:e8d59f85d015ba9cb2ce67b934caa21157939caaf08ee045c65d739f82a324c4",
+    "schedulingPolicyHash": "sha256:2f68aea898f10ab48851b6890fd9ad03202c555a4617e38cfb17a332ac6065ec",
+    "topologyHash": "sha256:35b4314fd54a6ddc6e23a87ff50a0595223e61cf128540629033d3f41e6ccf2c",
+    "deferredGatesHash": "sha256:fbeb1be60839d552b55cdc08eaeb4f4c6740e60abed55f09446c22a0bd08e4f7",
+    "nodePlansHash": "sha256:28548ceff2edc788135bad9ee6d53ff3ff72c1f239878b2ca1e6a2fb3b550f9d"
+  },
+  "runtime": {
+    "jobId": "job-content-pipeline-reference",
+    "mode": "simulate",
+    "inputHash": "sha256:64b22edb276304aee419e0837dff25ed0bc307e664edbf362ca0062129387343",
+    "contextHash": "sha256:ce8d4c0a1d149f7f4da8ae9da3e22d02071343dd647edde27f00b12931eed820"
+  },
+  "profileRegistry": {
+    "package": "@x12i/ai-profiles",
+    "version": "3.2.0",
+    "registryHash": "sha256:profiles-content-pipeline-reference"
+  },
+  "events": [
+    {
+      "id": "evt:trace:job-content-pipeline-reference:created",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "sequence": 0,
+      "level": "info",
+      "type": "graph.created",
+      "message": "Execution trace created."
+    },
+    {
+      "id": "evt:graph:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "graph.started",
+      "sequence": 1
+    },
+    {
+      "id": "evt:unit:node:audience-insights:pre:0:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:audience-insights:pre:0",
+      "nodeId": "node:audience-insights",
+      "unitKind": "externalPreUtility",
+      "sequence": 2
+    },
+    {
+      "id": "evt:unit:node:audience-insights:pre:0:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:audience-insights:pre:0",
+      "nodeId": "node:audience-insights",
+      "unitKind": "externalPreUtility",
+      "sequence": 3
+    },
+    {
+      "id": "evt:unit:node:audience-insights:main:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:audience-insights:main",
+      "nodeId": "node:audience-insights",
+      "unitKind": "mainSkill",
+      "sequence": 4
+    },
+    {
+      "id": "evt:unit:node:audience-insights:main:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:audience-insights:main",
+      "nodeId": "node:audience-insights",
+      "unitKind": "mainSkill",
+      "sequence": 5
+    },
+    {
+      "id": "evt:unit:node:audience-insights:mapping:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:audience-insights:mapping",
+      "nodeId": "node:audience-insights",
+      "unitKind": "mapping",
+      "sequence": 6
+    },
+    {
+      "id": "evt:unit:node:audience-insights:mapping:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:audience-insights:mapping",
+      "nodeId": "node:audience-insights",
+      "unitKind": "mapping",
+      "sequence": 7
+    },
+    {
+      "id": "evt:unit:node:competitor-angles:pre:0:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:competitor-angles:pre:0",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "externalPreUtility",
+      "sequence": 8
+    },
+    {
+      "id": "evt:unit:node:competitor-angles:pre:0:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:competitor-angles:pre:0",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "externalPreUtility",
+      "sequence": 9
+    },
+    {
+      "id": "evt:unit:node:competitor-angles:main:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:competitor-angles:main",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "mainSkill",
+      "sequence": 10
+    },
+    {
+      "id": "evt:unit:node:competitor-angles:main:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:competitor-angles:main",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "mainSkill",
+      "sequence": 11
+    },
+    {
+      "id": "evt:unit:node:competitor-angles:mapping:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:competitor-angles:mapping",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "mapping",
+      "sequence": 12
+    },
+    {
+      "id": "evt:unit:node:competitor-angles:mapping:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:competitor-angles:mapping",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "mapping",
+      "sequence": 13
+    },
+    {
+      "id": "evt:unit:node:seo-keywords:pre:0:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:seo-keywords:pre:0",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "externalPreUtility",
+      "sequence": 14
+    },
+    {
+      "id": "evt:unit:node:seo-keywords:pre:0:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:seo-keywords:pre:0",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "externalPreUtility",
+      "sequence": 15
+    },
+    {
+      "id": "evt:unit:node:seo-keywords:main:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:seo-keywords:main",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "mainSkill",
+      "sequence": 16
+    },
+    {
+      "id": "evt:unit:node:seo-keywords:main:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:seo-keywords:main",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "mainSkill",
+      "sequence": 17
+    },
+    {
+      "id": "evt:unit:node:seo-keywords:mapping:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:seo-keywords:mapping",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "mapping",
+      "sequence": 18
+    },
+    {
+      "id": "evt:unit:node:seo-keywords:mapping:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:seo-keywords:mapping",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "mapping",
+      "sequence": 19
+    },
+    {
+      "id": "evt:unit:node:finalizer:package:finalizer:start",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.started",
+      "unitId": "unit:node:finalizer:package:finalizer",
+      "nodeId": "node:finalizer:package",
+      "unitKind": "finalizer",
+      "sequence": 20
+    },
+    {
+      "id": "evt:unit:node:finalizer:package:finalizer:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "unit.completed",
+      "unitId": "unit:node:finalizer:package:finalizer",
+      "nodeId": "node:finalizer:package",
+      "unitKind": "finalizer",
+      "sequence": 21
+    },
+    {
+      "id": "evt:node:audience-insights:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "node.completed",
+      "nodeId": "node:audience-insights",
+      "sequence": 22
+    },
+    {
+      "id": "evt:node:competitor-angles:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "node.completed",
+      "nodeId": "node:competitor-angles",
+      "sequence": 23
+    },
+    {
+      "id": "evt:node:seo-keywords:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "node.completed",
+      "nodeId": "node:seo-keywords",
+      "sequence": 24
+    },
+    {
+      "id": "evt:node:finalizer:package:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "node.completed",
+      "nodeId": "node:finalizer:package",
+      "sequence": 25
+    },
+    {
+      "id": "evt:graph:done",
+      "ts": "2026-06-07T12:00:01.000Z",
+      "level": "info",
+      "type": "graph.completed",
+      "sequence": 26
+    }
+  ],
+  "graphExecution": {
+    "startedNodeIds": [
+      "node:audience-insights",
+      "node:competitor-angles",
+      "node:seo-keywords",
+      "node:finalizer:package"
+    ],
+    "completedNodeIds": [
+      "node:audience-insights",
+      "node:competitor-angles",
+      "node:seo-keywords",
+      "node:finalizer:package"
+    ],
+    "failedNodeIds": [],
+    "skippedNodeIds": [],
+    "startedUnitIds": [
+      "unit:node:audience-insights:pre:0",
+      "unit:node:audience-insights:main",
+      "unit:node:audience-insights:mapping",
+      "unit:node:competitor-angles:pre:0",
+      "unit:node:competitor-angles:main",
+      "unit:node:competitor-angles:mapping",
+      "unit:node:seo-keywords:pre:0",
+      "unit:node:seo-keywords:main",
+      "unit:node:seo-keywords:mapping",
+      "unit:node:finalizer:package:finalizer"
+    ],
+    "completedUnitIds": [
+      "unit:node:audience-insights:pre:0",
+      "unit:node:audience-insights:main",
+      "unit:node:audience-insights:mapping",
+      "unit:node:competitor-angles:pre:0",
+      "unit:node:competitor-angles:main",
+      "unit:node:competitor-angles:mapping",
+      "unit:node:seo-keywords:pre:0",
+      "unit:node:seo-keywords:main",
+      "unit:node:seo-keywords:mapping",
+      "unit:node:finalizer:package:finalizer"
+    ],
+    "failedUnitIds": [],
+    "skippedUnitIds": [],
+    "finalizerNodeIds": [
+      "node:finalizer:package"
+    ]
+  },
+  "gateEvaluations": {},
+  "nodeExecutions": {
+    "node:audience-insights": {
+      "nodeId": "node:audience-insights",
+      "nodeType": "task",
+      "executionClass": "aiTask",
+      "status": "completed",
+      "selectedCases": {
+        "graphModelCaseId": "default"
+      },
+      "unitIds": [
+        "unit:node:audience-insights:pre:0",
+        "unit:node:audience-insights:main",
+        "unit:node:audience-insights:mapping"
+      ],
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 20
+    },
+    "node:competitor-angles": {
+      "nodeId": "node:competitor-angles",
+      "nodeType": "task",
+      "executionClass": "aiTask",
+      "status": "completed",
+      "selectedCases": {
+        "graphModelCaseId": "default"
+      },
+      "unitIds": [
+        "unit:node:competitor-angles:pre:0",
+        "unit:node:competitor-angles:main",
+        "unit:node:competitor-angles:mapping"
+      ],
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 20
+    },
+    "node:seo-keywords": {
+      "nodeId": "node:seo-keywords",
+      "nodeType": "task",
+      "executionClass": "aiTask",
+      "status": "completed",
+      "selectedCases": {
+        "graphModelCaseId": "default"
+      },
+      "unitIds": [
+        "unit:node:seo-keywords:pre:0",
+        "unit:node:seo-keywords:main",
+        "unit:node:seo-keywords:mapping"
+      ],
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 20
+    },
+    "node:finalizer:package": {
+      "nodeId": "node:finalizer:package",
+      "nodeType": "finalizer",
+      "executionClass": "finalizer",
+      "status": "completed",
+      "unitIds": [
+        "unit:node:finalizer:package:finalizer"
+      ],
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 20
+    }
+  },
+  "unitExecutions": {
+    "unit:node:audience-insights:pre:0": {
+      "unitId": "unit:node:audience-insights:pre:0",
+      "nodeId": "node:audience-insights",
+      "unitKind": "externalPreUtility",
+      "invokeMode": "externalRunTask",
+      "order": 0,
+      "status": "completed",
+      "plannedModelSelection": {
+        "kind": "profileChoice",
+        "key": "cheap/default"
+      },
+      "modelSlot": "preActionModel",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10,
+      "modelInvocationIds": [
+        "inv:unit:node:audience-insights:pre:0:1"
+      ]
+    },
+    "unit:node:audience-insights:main": {
+      "unitId": "unit:node:audience-insights:main",
+      "nodeId": "node:audience-insights",
+      "unitKind": "mainSkill",
+      "invokeMode": "mainRunTask",
+      "order": 1,
+      "status": "completed",
+      "plannedModelSelection": {
+        "kind": "profileChoice",
+        "key": "vol/default"
+      },
+      "modelSlot": "skillModel",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10,
+      "modelInvocationIds": [
+        "inv:unit:node:audience-insights:main:1"
+      ]
+    },
+    "unit:node:audience-insights:mapping": {
+      "unitId": "unit:node:audience-insights:mapping",
+      "nodeId": "node:audience-insights",
+      "unitKind": "mapping",
+      "invokeMode": "none",
+      "order": 2,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10
+    },
+    "unit:node:competitor-angles:pre:0": {
+      "unitId": "unit:node:competitor-angles:pre:0",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "externalPreUtility",
+      "invokeMode": "externalRunTask",
+      "order": 0,
+      "status": "completed",
+      "plannedModelSelection": {
+        "kind": "profileChoice",
+        "key": "cheap/default"
+      },
+      "modelSlot": "preActionModel",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10,
+      "modelInvocationIds": [
+        "inv:unit:node:competitor-angles:pre:0:1"
+      ]
+    },
+    "unit:node:competitor-angles:main": {
+      "unitId": "unit:node:competitor-angles:main",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "mainSkill",
+      "invokeMode": "mainRunTask",
+      "order": 1,
+      "status": "completed",
+      "plannedModelSelection": {
+        "kind": "profileChoice",
+        "key": "vol/default"
+      },
+      "modelSlot": "skillModel",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10,
+      "modelInvocationIds": [
+        "inv:unit:node:competitor-angles:main:1"
+      ]
+    },
+    "unit:node:competitor-angles:mapping": {
+      "unitId": "unit:node:competitor-angles:mapping",
+      "nodeId": "node:competitor-angles",
+      "unitKind": "mapping",
+      "invokeMode": "none",
+      "order": 2,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10
+    },
+    "unit:node:seo-keywords:pre:0": {
+      "unitId": "unit:node:seo-keywords:pre:0",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "externalPreUtility",
+      "invokeMode": "externalRunTask",
+      "order": 0,
+      "status": "completed",
+      "plannedModelSelection": {
+        "kind": "profileChoice",
+        "key": "cheap/default"
+      },
+      "modelSlot": "preActionModel",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10,
+      "modelInvocationIds": [
+        "inv:unit:node:seo-keywords:pre:0:1"
+      ]
+    },
+    "unit:node:seo-keywords:main": {
+      "unitId": "unit:node:seo-keywords:main",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "mainSkill",
+      "invokeMode": "mainRunTask",
+      "order": 1,
+      "status": "completed",
+      "plannedModelSelection": {
+        "kind": "profileChoice",
+        "key": "vol/default"
+      },
+      "modelSlot": "skillModel",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10,
+      "modelInvocationIds": [
+        "inv:unit:node:seo-keywords:main:1"
+      ]
+    },
+    "unit:node:seo-keywords:mapping": {
+      "unitId": "unit:node:seo-keywords:mapping",
+      "nodeId": "node:seo-keywords",
+      "unitKind": "mapping",
+      "invokeMode": "none",
+      "order": 2,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10
+    },
+    "unit:node:finalizer:package:finalizer": {
+      "unitId": "unit:node:finalizer:package:finalizer",
+      "nodeId": "node:finalizer:package",
+      "unitKind": "finalizer",
+      "invokeMode": "finalizer",
+      "order": 0,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 10
+    }
+  },
+  "modelInvocations": {
+    "inv:unit:node:audience-insights:pre:0:1": {
+      "invocationId": "inv:unit:node:audience-insights:pre:0:1",
+      "nodeId": "node:audience-insights",
+      "unitId": "unit:node:audience-insights:pre:0",
+      "slot": "preActionModel",
+      "attempt": 1,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 5,
+      "plannedSelection": {
+        "kind": "profileChoice",
+        "key": "cheap/default"
+      },
+      "resolvedInvocation": {
+        "provider": "openrouter",
+        "modelId": "gpt-4o-mini",
+        "profileChoiceKey": "cheap/default",
+        "registryVersion": "3.2.0",
+        "registryHash": "sha256:profiles-content-pipeline-reference",
+        "resolutionSource": "profileRegistry"
+      },
+      "usage": {
+        "inputTokens": 100,
+        "outputTokens": 50,
+        "totalTokens": 150
+      },
+      "cost": {
+        "costUsd": 0.001,
+        "costStatus": "known"
+      }
+    },
+    "inv:unit:node:audience-insights:main:1": {
+      "invocationId": "inv:unit:node:audience-insights:main:1",
+      "nodeId": "node:audience-insights",
+      "unitId": "unit:node:audience-insights:main",
+      "slot": "skillModel",
+      "attempt": 1,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 5,
+      "plannedSelection": {
+        "kind": "profileChoice",
+        "key": "vol/default"
+      },
+      "resolvedInvocation": {
+        "provider": "openrouter",
+        "modelId": "gpt-4o-mini",
+        "profileChoiceKey": "vol/default",
+        "registryVersion": "3.2.0",
+        "registryHash": "sha256:profiles-content-pipeline-reference",
+        "resolutionSource": "profileRegistry"
+      },
+      "usage": {
+        "inputTokens": 100,
+        "outputTokens": 50,
+        "totalTokens": 150
+      },
+      "cost": {
+        "costUsd": 0.001,
+        "costStatus": "known"
+      }
+    },
+    "inv:unit:node:competitor-angles:pre:0:1": {
+      "invocationId": "inv:unit:node:competitor-angles:pre:0:1",
+      "nodeId": "node:competitor-angles",
+      "unitId": "unit:node:competitor-angles:pre:0",
+      "slot": "preActionModel",
+      "attempt": 1,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 5,
+      "plannedSelection": {
+        "kind": "profileChoice",
+        "key": "cheap/default"
+      },
+      "resolvedInvocation": {
+        "provider": "openrouter",
+        "modelId": "gpt-4o-mini",
+        "profileChoiceKey": "cheap/default",
+        "registryVersion": "3.2.0",
+        "registryHash": "sha256:profiles-content-pipeline-reference",
+        "resolutionSource": "profileRegistry"
+      },
+      "usage": {
+        "inputTokens": 100,
+        "outputTokens": 50,
+        "totalTokens": 150
+      },
+      "cost": {
+        "costUsd": 0.001,
+        "costStatus": "known"
+      }
+    },
+    "inv:unit:node:competitor-angles:main:1": {
+      "invocationId": "inv:unit:node:competitor-angles:main:1",
+      "nodeId": "node:competitor-angles",
+      "unitId": "unit:node:competitor-angles:main",
+      "slot": "skillModel",
+      "attempt": 1,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 5,
+      "plannedSelection": {
+        "kind": "profileChoice",
+        "key": "vol/default"
+      },
+      "resolvedInvocation": {
+        "provider": "openrouter",
+        "modelId": "gpt-4o-mini",
+        "profileChoiceKey": "vol/default",
+        "registryVersion": "3.2.0",
+        "registryHash": "sha256:profiles-content-pipeline-reference",
+        "resolutionSource": "profileRegistry"
+      },
+      "usage": {
+        "inputTokens": 100,
+        "outputTokens": 50,
+        "totalTokens": 150
+      },
+      "cost": {
+        "costUsd": 0.001,
+        "costStatus": "known"
+      }
+    },
+    "inv:unit:node:seo-keywords:pre:0:1": {
+      "invocationId": "inv:unit:node:seo-keywords:pre:0:1",
+      "nodeId": "node:seo-keywords",
+      "unitId": "unit:node:seo-keywords:pre:0",
+      "slot": "preActionModel",
+      "attempt": 1,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 5,
+      "plannedSelection": {
+        "kind": "profileChoice",
+        "key": "cheap/default"
+      },
+      "resolvedInvocation": {
+        "provider": "openrouter",
+        "modelId": "gpt-4o-mini",
+        "profileChoiceKey": "cheap/default",
+        "registryVersion": "3.2.0",
+        "registryHash": "sha256:profiles-content-pipeline-reference",
+        "resolutionSource": "profileRegistry"
+      },
+      "usage": {
+        "inputTokens": 100,
+        "outputTokens": 50,
+        "totalTokens": 150
+      },
+      "cost": {
+        "costUsd": 0.001,
+        "costStatus": "known"
+      }
+    },
+    "inv:unit:node:seo-keywords:main:1": {
+      "invocationId": "inv:unit:node:seo-keywords:main:1",
+      "nodeId": "node:seo-keywords",
+      "unitId": "unit:node:seo-keywords:main",
+      "slot": "skillModel",
+      "attempt": 1,
+      "status": "completed",
+      "startedAt": "2026-06-07T12:00:01.000Z",
+      "completedAt": "2026-06-07T12:00:01.000Z",
+      "durationMs": 5,
+      "plannedSelection": {
+        "kind": "profileChoice",
+        "key": "vol/default"
+      },
+      "resolvedInvocation": {
+        "provider": "openrouter",
+        "modelId": "gpt-4o-mini",
+        "profileChoiceKey": "vol/default",
+        "registryVersion": "3.2.0",
+        "registryHash": "sha256:profiles-content-pipeline-reference",
+        "resolutionSource": "profileRegistry"
+      },
+      "usage": {
+        "inputTokens": 100,
+        "outputTokens": 50,
+        "totalTokens": 150
+      },
+      "cost": {
+        "costUsd": 0.001,
+        "costStatus": "known"
+      }
+    }
+  },
+  "memory": {
+    "reads": [],
+    "writes": []
+  },
+  "diagnostics": {
+    "dataPolicy": {
+      "storeFullInputs": false,
+      "storeFullOutputs": false,
+      "storePrompts": false,
+      "storeProviderResponses": false,
+      "maxPreviewChars": 512,
+      "requireDataRefsForLargeValues": true
+    }
+  },
+  "finalOutput": {
+    "producedByNodeId": "node:finalizer:package",
+    "valueHash": "sha256:cp-reference-output",
+    "responseShapePath": "/graph/metadata/graphResponse",
+    "schemaValidation": {
+      "valid": true
+    }
+  },
+  "completedAt": "2026-06-07T12:00:01.000Z",
+  "startedAt": "2026-06-07T12:00:01.000Z"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@x12i/graphenix-trace-format",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "GraphExecutionTrace format: append-only events, validation, and trace helpers.",
   "license": "MIT",
   "type": "module",
@@ -15,10 +15,12 @@
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "clean": "rimraf dist"
+    "clean": "rimraf dist",
+    "test": "npm run build && node --test dist/test/*.test.js"
   },
   "files": [
     "dist",
+    "fixtures",
     "README.md"
   ],
   "keywords": [
@@ -45,6 +47,7 @@
   },
   "devDependencies": {
     "@types/node": "^22.10.1",
+    "@x12i/graphenix-plan-compiler": "^1.1.1",
     "rimraf": "^6.0.1",
     "typescript": "^5.6.3"
   }