@blxzer/pactile 0.5.0 → 0.6.0-beta.2

package/dist/core/pactile/trace-runtime/index.js

@@ -0,0 +1,292 @@
+import fs from "node:fs";
+import path from "node:path";
+import { randomUUID } from "node:crypto";
+import { DEFAULT_CANONICAL_PATHS_V1 } from "../runtime.js";
+import { parseCompositionTraceEventV1 } from "../trace.js";
+import { canonicalizePactileJsonV1, fingerprintPactileContractV1, PACTILE_FINGERPRINT_PATTERN, isPlainRecordV1, } from "../validation.js";
+/** Messages are symbolic: rejected input is never echoed into diagnostics. */
+export class TraceError extends Error {
+    code;
+    line;
+    constructor(code, line = null) {
+        super(`PACTILE_TRACE_${code.replaceAll("-", "_").toUpperCase()}`);
+        this.code = code;
+        this.line = line;
+        this.name = "TraceError";
+    }
+}
+/** Never attach the original error/cause: Node I/O errors include caller paths. */
+function traceIoBoundary(action) {
+    try {
+        return action();
+    }
+    catch (error) {
+        if (error instanceof TraceError)
+            throw error;
+        throw new TraceError("io-failure");
+    }
+}
+const EMPTY_HEAD = { sequence: 0, fingerprint: null };
+const MAX_EVENT_BYTES = 64 * 1024;
+/** Reject accessors/non-JSON objects before the v1 decoder can read them. */
+function assertData(value, ancestors = new Set(), depth = 0) {
+    if (depth > 16)
+        throw new TraceError("invalid-event");
+    if (value === null || typeof value !== "object") {
+        if (typeof value === "string" && (/(?:sk-(?:proj-|svcacct-)?[a-z0-9_-]{12,}|gh[pousr]_[a-z0-9]{12,}|xox[baprs]-[a-z0-9-]{10,})/i.test(value) ||
+            /(?:^|[._:/-])(?:prompt|reasoning|scratchpad|secret|password|credential|credentials|token|chain-of-thought)(?:$|[._:/-])/i.test(value)))
+            throw new TraceError("invalid-event");
+        return;
+    }
+    if (ancestors.has(value) || (!Array.isArray(value) && !isPlainRecordV1(value))) {
+        throw new TraceError("invalid-event");
+    }
+    ancestors.add(value);
+    for (const [key, descriptor] of Object.entries(Object.getOwnPropertyDescriptors(value))) {
+        if (Array.isArray(value) && key === "length")
+            continue;
+        if (descriptor.get || descriptor.set || !descriptor.enumerable)
+            throw new TraceError("invalid-event");
+        assertData(descriptor.value, ancestors, depth + 1);
+    }
+    if (Object.getOwnPropertySymbols(value).length > 0)
+        throw new TraceError("invalid-event");
+    ancestors.delete(value);
+}
+/** Strict M0 allowlist, canonical JSON, no envelope or arbitrary metadata. */
+export function serializeTraceEvent(input) {
+    try {
+        assertData(input);
+        const raw = canonicalizePactileJsonV1(input);
+        if (Buffer.byteLength(raw) > MAX_EVENT_BYTES)
+            throw new TraceError("invalid-event");
+        const parsed = parseCompositionTraceEventV1(JSON.parse(raw));
+        if (!parsed.success)
+            throw new TraceError("invalid-event");
+        return { event: parsed.data, json: canonicalizePactileJsonV1(parsed.data), fingerprint: parsed.fingerprint };
+    }
+    catch {
+        throw new TraceError("invalid-event");
+    }
+}
+/** An external trusted head detects complete suffix deletion, including an empty file. */
+export function verifyTrace(text, traceId, expectedHead) {
+    const events = [];
+    const ids = new Set();
+    let head = EMPTY_HEAD;
+    if (text !== "" && !text.endsWith("\n"))
+        throw new TraceError("uncommitted", text.split("\n").length);
+    const lines = text === "" ? [] : text.slice(0, -1).split("\n");
+    for (const [index, line] of lines.entries()) {
+        let serialized;
+        try {
+            if (Buffer.byteLength(line) > MAX_EVENT_BYTES)
+                throw new TraceError("malformed");
+            serialized = serializeTraceEvent(JSON.parse(line));
+        }
+        catch {
+            throw new TraceError("malformed", index + 1);
+        }
+        const event = serialized.event;
+        if (event.traceId !== traceId || event.sequence !== head.sequence + 1)
+            throw new TraceError("sequence-mismatch", index + 1);
+        if (event.previousEventFingerprint !== head.fingerprint)
+            throw new TraceError("chain-mismatch", index + 1);
+        if (ids.has(event.eventId))
+            throw new TraceError("duplicate-event", index + 1);
+        ids.add(event.eventId);
+        events.push(event);
+        head = { sequence: event.sequence, fingerprint: serialized.fingerprint };
+    }
+    if (expectedHead && !sameHead(head, expectedHead))
+        throw new TraceError("checkpoint-mismatch", head.sequence + 1);
+    return { events, head };
+}
+function sameHead(a, b) {
+    return a.sequence === b.sequence && a.fingerprint === b.fingerprint;
+}
+function assertSafePath(target) {
+    let current = path.resolve(target);
+    while (true) {
+        try {
+            const stat = fs.lstatSync(current);
+            if (stat.isSymbolicLink() || (stat.isFile() && stat.nlink !== 1))
+                throw new TraceError("unsafe-path");
+        }
+        catch (error) {
+            if (error.code !== "ENOENT")
+                throw error;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+}
+function assertNoCaseAlias(root, relativePath) {
+    let parent = root;
+    for (const segment of relativePath.split(path.sep)) {
+        if (!fs.existsSync(parent))
+            return;
+        for (const entry of fs.readdirSync(parent)) {
+            if (entry.normalize("NFC").toLowerCase() === segment.normalize("NFC").toLowerCase() && entry !== segment) {
+                throw new TraceError("unsafe-path");
+            }
+        }
+        parent = path.join(parent, segment);
+    }
+}
+function traceFiles(projectRoot, traceId) {
+    // Portable filename subset of LogicalIdV1; Windows device names are forbidden.
+    if (!/^[a-z][a-z0-9]*(?:[._-][a-z0-9]+)*$/.test(traceId) || traceId.length > 128 ||
+        /^(?:con|prn|aux|nul|com[0-9]|lpt[0-9])(?:\.|$)/i.test(traceId))
+        throw new TraceError("unsafe-path");
+    const root = path.resolve(projectRoot);
+    assertSafePath(root);
+    const dir = path.join(root, path.dirname(DEFAULT_CANONICAL_PATHS_V1.installStatePath), "traces");
+    const log = path.join(dir, `${traceId}.jsonl`);
+    const checkpoint = `${log}.head.json`;
+    const lock = `${log}.lock`;
+    for (const file of [log, checkpoint, lock]) {
+        assertSafePath(file);
+        assertNoCaseAlias(root, path.relative(root, file));
+    }
+    return { log, checkpoint, lock };
+}
+function readOptional(file) {
+    try {
+        return fs.readFileSync(file, "utf8");
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return null;
+        throw error;
+    }
+}
+function parseHead(raw) {
+    try {
+        const value = JSON.parse(raw);
+        if (!isPlainRecordV1(value) || Object.keys(value).sort().join(",") !== "fingerprint,sequence" ||
+            !Number.isSafeInteger(value.sequence) || value.sequence < 0 ||
+            (value.sequence === 0 ? value.fingerprint !== null : typeof value.fingerprint !== "string" || !PACTILE_FINGERPRINT_PATTERN.test(value.fingerprint))) {
+            throw new TraceError("malformed");
+        }
+        return { sequence: value.sequence, fingerprint: value.fingerprint };
+    }
+    catch {
+        throw new TraceError("malformed");
+    }
+}
+/** Read-only; an interrupted writer or stale lock is reported, never stolen/repaired. */
+export function readTrace(projectRoot, traceId, expectedHead) {
+    return traceIoBoundary(() => {
+        const files = traceFiles(projectRoot, traceId);
+        if (fs.existsSync(files.lock))
+            throw new TraceError("locked");
+        const result = readTraceUnlocked(files, traceId, expectedHead);
+        // A concurrent append may have started while the reader inspected the files.
+        if (fs.existsSync(files.lock))
+            throw new TraceError("locked");
+        return result;
+    });
+}
+function readTraceUnlocked(files, traceId, expectedHead) {
+    const rawHead = readOptional(files.checkpoint);
+    const rawLog = readOptional(files.log);
+    if (rawHead === null) {
+        if (rawLog !== null)
+            throw new TraceError("uncommitted");
+        return verifyTrace("", traceId, expectedHead);
+    }
+    const head = parseHead(rawHead);
+    const result = verifyTrace(rawLog ?? "", traceId, head);
+    if (expectedHead && !sameHead(result.head, expectedHead))
+        throw new TraceError("checkpoint-mismatch");
+    return result;
+}
+function writeHead(file, head) {
+    const temp = `${file}.${randomUUID()}.tmp`;
+    const fd = fs.openSync(temp, "wx", 0o600);
+    try {
+        try {
+            assertExclusiveFile(fd, temp);
+            fs.writeFileSync(fd, `${canonicalizePactileJsonV1(head)}\n`);
+            fs.fsyncSync(fd);
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        assertSafePath(file);
+        fs.renameSync(temp, file); // Never fall back to a non-atomic overwrite.
+    }
+    finally {
+        if (fs.existsSync(temp))
+            fs.unlinkSync(temp);
+    }
+}
+function assertExclusiveFile(fd, file) {
+    assertSafePath(file);
+    const opened = fs.fstatSync(fd);
+    const named = fs.lstatSync(file);
+    if (!opened.isFile() || opened.nlink !== 1 || opened.dev !== named.dev || opened.ino !== named.ino) {
+        throw new TraceError("unsafe-path");
+    }
+}
+/**
+ * Append under an exclusive process lock and optimistic head CAS. Event bytes
+ * are fsynced before advancing the atomic checkpoint. A crash between these
+ * steps is observable as checkpoint-mismatch; no history is auto-truncated.
+ * Keep returned heads outside this directory when malicious whole-store
+ * rollback must be detected. A hash chain is integrity evidence, not a signature.
+ */
+export function appendTrace(projectRoot, input, expectedHead) {
+    return traceIoBoundary(() => {
+        const serialized = serializeTraceEvent(input);
+        const files = traceFiles(projectRoot, serialized.event.traceId);
+        fs.mkdirSync(path.dirname(files.log), { recursive: true });
+        for (const file of [files.log, files.checkpoint, files.lock])
+            assertSafePath(file);
+        let lockFd;
+        try {
+            lockFd = fs.openSync(files.lock, "wx", 0o600);
+        }
+        catch (error) {
+            if (error.code === "EEXIST")
+                throw new TraceError("locked");
+            throw error;
+        }
+        try {
+            assertExclusiveFile(lockFd, files.lock);
+            const current = readTraceUnlocked(files, serialized.event.traceId);
+            if (!sameHead(current.head, expectedHead))
+                throw new TraceError("cas-mismatch");
+            if (serialized.event.sequence !== current.head.sequence + 1)
+                throw new TraceError("sequence-mismatch");
+            if (serialized.event.previousEventFingerprint !== current.head.fingerprint)
+                throw new TraceError("chain-mismatch");
+            if (current.events.some((event) => event.eventId === serialized.event.eventId))
+                throw new TraceError("duplicate-event");
+            if (readOptional(files.checkpoint) === null)
+                writeHead(files.checkpoint, EMPTY_HEAD);
+            const fd = fs.openSync(files.log, fs.constants.O_WRONLY | fs.constants.O_APPEND | fs.constants.O_CREAT | (fs.constants.O_NOFOLLOW ?? 0), 0o600);
+            try {
+                assertExclusiveFile(fd, files.log);
+                fs.writeFileSync(fd, `${serialized.json}\n`);
+                fs.fsyncSync(fd);
+            }
+            finally {
+                fs.closeSync(fd);
+            }
+            const head = { sequence: serialized.event.sequence, fingerprint: serialized.fingerprint };
+            writeHead(files.checkpoint, head);
+            return head;
+        }
+        finally {
+            fs.closeSync(lockFd);
+            fs.unlinkSync(files.lock);
+        }
+    });
+}
+/** Stable identifier for an observable resolution/validation fact kept elsewhere. */
+export const traceFactFingerprint = fingerprintPactileContractV1;
+//# sourceMappingURL=index.js.map

package/dist/core/pactile/trace-runtime/index.js.map

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

package/dist/core/pactile/trace.d.ts

@@ -0,0 +1,42 @@
+import { type AssuranceLevelV1, type PactileIntentV1, type ProviderOriginV1 } from "./provider.js";
+import { PACTILE_CONTRACT_SCHEMA_VERSION, type PactileContractParseResultV1 } from "./validation.js";
+export declare const COMPOSITION_TRACE_EVENTS_V1: readonly ["tile.discovered", "tile.eligible", "tile.selected", "tile.ordered", "tile.invoked", "tile.completed", "tile.failed", "tile.skipped", "tile.fallback", "provider.resolved", "evidence.recorded"];
+export type CompositionTraceEventKindV1 = (typeof COMPOSITION_TRACE_EVENTS_V1)[number];
+export declare const COMPOSITION_TRACE_OUTCOMES_V1: readonly ["observed", "accepted", "started", "succeeded", "failed", "degraded", "skipped", "unsupported"];
+export type CompositionTraceOutcomeV1 = (typeof COMPOSITION_TRACE_OUTCOMES_V1)[number];
+export interface CompositionTraceProviderRefV1 {
+    readonly id: string | null;
+    readonly origin: ProviderOriginV1;
+    readonly assurance: AssuranceLevelV1 | null;
+    readonly resolutionFingerprint: string;
+}
+/**
+ * One append-only, observable composition fact.
+ *
+ * Deliberately has no prompt, rationale, reasoning, scratchpad, or arbitrary
+ * metadata field. Callers link artifacts and Evidence instead of serializing
+ * hidden model reasoning.
+ */
+export interface CompositionTraceEventV1 {
+    readonly schemaVersion: typeof PACTILE_CONTRACT_SCHEMA_VERSION;
+    readonly traceId: string;
+    readonly eventId: string;
+    readonly sequence: number;
+    readonly previousEventFingerprint: string | null;
+    readonly at: string;
+    readonly event: CompositionTraceEventKindV1;
+    readonly outcome: CompositionTraceOutcomeV1;
+    readonly taskId: string | null;
+    readonly tileId: string | null;
+    readonly relatedTileId: string | null;
+    readonly intent: PactileIntentV1 | null;
+    readonly provider: CompositionTraceProviderRefV1 | null;
+    readonly position: number | null;
+    readonly durationMs: number | null;
+    readonly errorCode: string | null;
+    readonly artifactRefs: readonly string[];
+    readonly evidenceRefs: readonly string[];
+}
+export declare const compositionTraceEventV1Schema: import("./validation.js").PactileContractSchemaV1<CompositionTraceEventV1>;
+export declare function parseCompositionTraceEventV1(input: unknown): PactileContractParseResultV1<CompositionTraceEventV1>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/core/pactile/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/core/pactile/trace.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACtB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,+BAA+B,EAE/B,KAAK,4BAA4B,EASlC,MAAM,iBAAiB,CAAC;AAEzB,eAAO,MAAM,2BAA2B,4MAY9B,CAAC;AACX,MAAM,MAAM,2BAA2B,GACrC,CAAC,OAAO,2BAA2B,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/C,eAAO,MAAM,6BAA6B,2GAShC,CAAC;AACX,MAAM,MAAM,yBAAyB,GACnC,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC5C,QAAQ,CAAC,qBAAqB,EAAE,MAAM,CAAC;CACxC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,aAAa,EAAE,OAAO,+BAA+B,CAAC;IAC/D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,2BAA2B,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,yBAAyB,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACxD,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C;AAsZD,eAAO,MAAM,6BAA6B,4EAGzC,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,KAAK,EAAE,OAAO,GACb,4BAA4B,CAAC,uBAAuB,CAAC,CAEvD"}

package/dist/core/pactile/trace.js

@@ -0,0 +1,221 @@
+import { ASSURANCE_LEVELS_V1, PACTILE_INTENTS_V1, PROVIDER_ORIGINS_V1, } from "./provider.js";
+import { childPathV1, decodeFingerprintV1, decodeLogicalIdV1, decodeNullableFingerprintV1, decodeOpaqueReferenceV1, decodeSchemaVersionV1, decodeTimestampV1, definePactileContractSchemaV1, } from "./validation.js";
+export const COMPOSITION_TRACE_EVENTS_V1 = [
+    "tile.discovered",
+    "tile.eligible",
+    "tile.selected",
+    "tile.ordered",
+    "tile.invoked",
+    "tile.completed",
+    "tile.failed",
+    "tile.skipped",
+    "tile.fallback",
+    "provider.resolved",
+    "evidence.recorded",
+];
+export const COMPOSITION_TRACE_OUTCOMES_V1 = [
+    "observed",
+    "accepted",
+    "started",
+    "succeeded",
+    "failed",
+    "degraded",
+    "skipped",
+    "unsupported",
+];
+const PACTILE_TRACE_ERROR_CODE_PATTERN = /^PACTILE_[A-Z0-9]+(?:_[A-Z0-9]+)*$/;
+function decodeNullableLogicalIdV1(value, decoder, path) {
+    if (value === null)
+        return null;
+    return decodeLogicalIdV1(value, decoder, path);
+}
+function decodeNullableIntentV1(value, decoder, path) {
+    if (value === null)
+        return null;
+    return decoder.enumValue(value, PACTILE_INTENTS_V1, path);
+}
+function decodeNullableIntegerV1(value, decoder, path, min) {
+    if (value === null)
+        return null;
+    return decoder.integer(value, path, { min });
+}
+function decodeNullableTraceErrorCodeV1(value, decoder, path) {
+    if (value === null)
+        return null;
+    const errorCode = decoder.string(value, path, {
+        nonEmpty: true,
+        pattern: PACTILE_TRACE_ERROR_CODE_PATTERN,
+        patternDescription: "a symbolic PACTILE_<CODE> value, not prose or sensitive content",
+    });
+    if (errorCode.length > 96) {
+        decoder.issue("invalid-value", path, "symbolic Trace error codes must be at most 96 characters");
+    }
+    return errorCode;
+}
+function decodeTraceReferencesV1(value, decoder, path, scheme) {
+    const references = decoder.array(value, path, (item, itemPath) => decodeOpaqueReferenceV1(item, decoder, itemPath, [scheme]));
+    decoder.unique(references, (reference) => reference, path, `${scheme} reference`);
+    return references;
+}
+function decodeTraceProviderRefV1(value, decoder, path) {
+    const record = decoder.object(value, path, [
+        "id",
+        "origin",
+        "assurance",
+        "resolutionFingerprint",
+    ]);
+    const origin = decoder.enumValue(decoder.required(record, "origin", path), PROVIDER_ORIGINS_V1, childPathV1(path, "origin"));
+    const id = decodeNullableLogicalIdV1(decoder.required(record, "id", path), decoder, childPathV1(path, "id"));
+    const assuranceValue = decoder.required(record, "assurance", path);
+    const assurance = assuranceValue === null
+        ? null
+        : decoder.enumValue(assuranceValue, ASSURANCE_LEVELS_V1, childPathV1(path, "assurance"));
+    if (origin === "unsupported" && (id !== null || assurance !== null)) {
+        decoder.issue("conflict", path, "unsupported Provider trace references cannot claim an id or assurance");
+    }
+    if (origin !== "unsupported" && (id === null || assurance === null)) {
+        decoder.issue("required", path, "supported Provider trace references require id and assurance");
+    }
+    return {
+        id,
+        origin,
+        assurance,
+        resolutionFingerprint: decodeFingerprintV1(decoder.required(record, "resolutionFingerprint", path), decoder, childPathV1(path, "resolutionFingerprint")),
+    };
+}
+function decodeCompositionTraceEventV1(value, decoder, path) {
+    const record = decoder.object(value, path, [
+        "schemaVersion",
+        "traceId",
+        "eventId",
+        "sequence",
+        "previousEventFingerprint",
+        "at",
+        "event",
+        "outcome",
+        "taskId",
+        "tileId",
+        "relatedTileId",
+        "intent",
+        "provider",
+        "position",
+        "durationMs",
+        "errorCode",
+        "artifactRefs",
+        "evidenceRefs",
+    ]);
+    const sequence = decoder.integer(decoder.required(record, "sequence", path), childPathV1(path, "sequence"), { min: 1 });
+    const previousEventFingerprint = decodeNullableFingerprintV1(decoder.required(record, "previousEventFingerprint", path), decoder, childPathV1(path, "previousEventFingerprint"));
+    if (sequence === 1 && previousEventFingerprint !== null) {
+        decoder.issue("conflict", childPathV1(path, "previousEventFingerprint"), "the first event must not claim a previous event");
+    }
+    if (sequence > 1 && previousEventFingerprint === null) {
+        decoder.issue("required", childPathV1(path, "previousEventFingerprint"), "is required after the first append-only event");
+    }
+    const event = decoder.enumValue(decoder.required(record, "event", path), COMPOSITION_TRACE_EVENTS_V1, childPathV1(path, "event"));
+    const outcome = decoder.enumValue(decoder.required(record, "outcome", path), COMPOSITION_TRACE_OUTCOMES_V1, childPathV1(path, "outcome"));
+    const tileId = decodeNullableLogicalIdV1(decoder.required(record, "tileId", path), decoder, childPathV1(path, "tileId"));
+    const relatedTileId = decodeNullableLogicalIdV1(decoder.required(record, "relatedTileId", path), decoder, childPathV1(path, "relatedTileId"));
+    const intent = decodeNullableIntentV1(decoder.required(record, "intent", path), decoder, childPathV1(path, "intent"));
+    const providerValue = decoder.required(record, "provider", path);
+    const provider = providerValue === null
+        ? null
+        : decodeTraceProviderRefV1(providerValue, decoder, childPathV1(path, "provider"));
+    const position = decodeNullableIntegerV1(decoder.required(record, "position", path), decoder, childPathV1(path, "position"), 0);
+    const durationMs = decodeNullableIntegerV1(decoder.required(record, "durationMs", path), decoder, childPathV1(path, "durationMs"), 0);
+    const errorCode = decodeNullableTraceErrorCodeV1(decoder.required(record, "errorCode", path), decoder, childPathV1(path, "errorCode"));
+    const artifactRefs = decodeTraceReferencesV1(decoder.required(record, "artifactRefs", path), decoder, childPathV1(path, "artifactRefs"), "artifact");
+    const evidenceRefs = decodeTraceReferencesV1(decoder.required(record, "evidenceRefs", path), decoder, childPathV1(path, "evidenceRefs"), "evidence");
+    if (event.startsWith("tile.") && tileId === null) {
+        decoder.issue("required", childPathV1(path, "tileId"), "is required for Tile events");
+    }
+    const allowedOutcomes = {
+        "tile.discovered": ["observed"],
+        "tile.eligible": ["observed", "accepted"],
+        "tile.selected": ["accepted"],
+        "tile.ordered": ["accepted"],
+        "tile.invoked": ["started"],
+        "tile.completed": ["succeeded", "degraded"],
+        "tile.failed": ["failed"],
+        "tile.skipped": ["skipped"],
+        "tile.fallback": ["accepted", "degraded"],
+        "provider.resolved": ["accepted", "degraded", "unsupported"],
+        "evidence.recorded": ["observed", "succeeded"],
+    };
+    if (!allowedOutcomes[event].includes(outcome)) {
+        decoder.issue("conflict", childPathV1(path, "outcome"), `outcome '${outcome}' is not valid for event '${event}'`);
+    }
+    if (event === "tile.fallback") {
+        if (relatedTileId === null) {
+            decoder.issue("required", childPathV1(path, "relatedTileId"), "is required for fallback events");
+        }
+        else if (relatedTileId === tileId) {
+            decoder.issue("conflict", childPathV1(path, "relatedTileId"), "fallback target must differ from the original Tile");
+        }
+    }
+    else if (relatedTileId !== null) {
+        decoder.issue("conflict", childPathV1(path, "relatedTileId"), "is only valid for tile.fallback");
+    }
+    if (event === "provider.resolved" && (provider === null || intent === null)) {
+        decoder.issue("required", path, "provider.resolved requires Provider and intent references");
+    }
+    if (event === "provider.resolved" &&
+        provider?.origin === "unsupported" &&
+        outcome !== "unsupported") {
+        decoder.issue("conflict", childPathV1(path, "outcome"), "unsupported Provider resolution must use outcome 'unsupported'");
+    }
+    if (event === "provider.resolved" &&
+        provider !== null &&
+        provider.origin !== "unsupported" &&
+        outcome === "unsupported") {
+        decoder.issue("conflict", childPathV1(path, "outcome"), "supported Provider resolution cannot use outcome 'unsupported'");
+    }
+    if (event !== "provider.resolved" && provider !== null) {
+        decoder.issue("conflict", childPathV1(path, "provider"), "is only valid for provider.resolved events");
+    }
+    if (event === "tile.ordered" && position === null) {
+        decoder.issue("required", childPathV1(path, "position"), "is required for tile.ordered");
+    }
+    if (event !== "tile.ordered" && position !== null) {
+        decoder.issue("conflict", childPathV1(path, "position"), "is only valid for tile.ordered");
+    }
+    if (event !== "tile.completed" &&
+        event !== "tile.failed" &&
+        durationMs !== null) {
+        decoder.issue("conflict", childPathV1(path, "durationMs"), "is only valid for completed or failed Tile invocations");
+    }
+    if (event === "tile.failed" && errorCode === null) {
+        decoder.issue("required", childPathV1(path, "errorCode"), "is required for tile.failed");
+    }
+    if (event !== "tile.failed" && errorCode !== null) {
+        decoder.issue("conflict", childPathV1(path, "errorCode"), "is only valid for tile.failed");
+    }
+    if (event === "evidence.recorded" && evidenceRefs.length === 0) {
+        decoder.issue("required", childPathV1(path, "evidenceRefs"), "must contain at least one Evidence reference");
+    }
+    return {
+        schemaVersion: decodeSchemaVersionV1(record, decoder, path),
+        traceId: decodeLogicalIdV1(decoder.required(record, "traceId", path), decoder, childPathV1(path, "traceId")),
+        eventId: decodeLogicalIdV1(decoder.required(record, "eventId", path), decoder, childPathV1(path, "eventId")),
+        sequence,
+        previousEventFingerprint,
+        at: decodeTimestampV1(decoder.required(record, "at", path), decoder, childPathV1(path, "at")),
+        event,
+        outcome,
+        taskId: decodeNullableLogicalIdV1(decoder.required(record, "taskId", path), decoder, childPathV1(path, "taskId")),
+        tileId,
+        relatedTileId,
+        intent,
+        provider,
+        position,
+        durationMs,
+        errorCode,
+        artifactRefs,
+        evidenceRefs,
+    };
+}
+export const compositionTraceEventV1Schema = definePactileContractSchemaV1("CompositionTraceEventV1", decodeCompositionTraceEventV1);
+export function parseCompositionTraceEventV1(input) {
+    return compositionTraceEventV1Schema.parse(input);
+}
+//# sourceMappingURL=trace.js.map

package/dist/core/pactile/trace.js.map

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