pipework 0.7.26 → 0.8.0

package/dist/trace/partition/startup-hook.d.ts

@@ -0,0 +1,6 @@
+import type { DB } from '../../data/db/index.js';
+import type { StartupHook } from '../../core/lifecycle/types.js';
+import type { TracePartitionConfig } from './plan.js';
+export declare const TRACE_PARTITION_HOOK_NAME = "trace-partition-maintenance";
+export declare function createTracePartitionStartupHook(db: DB, config: TracePartitionConfig): StartupHook;
+//# sourceMappingURL=startup-hook.d.ts.map

package/dist/trace/partition/startup-hook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-hook.d.ts","sourceRoot":"","sources":["../../../src/trace/partition/startup-hook.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAA;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAA;AAEhE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAErD,eAAO,MAAM,yBAAyB,gCAAgC,CAAA;AAEtE,wBAAgB,+BAA+B,CAAC,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,oBAAoB,GAAG,WAAW,CAOjG"}

package/dist/trace/partition/startup-hook.js

@@ -0,0 +1,15 @@
+// Partition maintenance as a startup hook. Running it at boot guarantees the
+// near-term partitions exist before the app takes its first request — a fresh
+// deploy on a new day must not write a trace into a partition that doesn't
+// exist yet. The cron schedule keeps it current after that.
+import { syncTracePartitions } from './sync.js';
+export const TRACE_PARTITION_HOOK_NAME = 'trace-partition-maintenance';
+export function createTracePartitionStartupHook(db, config) {
+    return {
+        name: TRACE_PARTITION_HOOK_NAME,
+        async execute() {
+            await syncTracePartitions(db, config);
+        },
+    };
+}
+//# sourceMappingURL=startup-hook.js.map

package/dist/trace/partition/startup-hook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"startup-hook.js","sourceRoot":"","sources":["../../../src/trace/partition/startup-hook.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,8EAA8E;AAC9E,2EAA2E;AAC3E,4DAA4D;AAI5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAG/C,MAAM,CAAC,MAAM,yBAAyB,GAAG,6BAA6B,CAAA;AAEtE,MAAM,UAAU,+BAA+B,CAAC,EAAM,EAAE,MAA4B;IAClF,OAAO;QACL,IAAI,EAAE,yBAAyB;QAC/B,KAAK,CAAC,OAAO;YACX,MAAM,mBAAmB,CAAC,EAAE,EAAE,MAAM,CAAC,CAAA;QACvC,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/trace/partition/sync.d.ts

@@ -0,0 +1,14 @@
+import type { DB } from '../../data/db/index.js';
+import { type TracePartitionConfig } from './plan.js';
+export interface PartitionSyncSummary {
+    readonly created: readonly string[];
+    readonly dropped: readonly string[];
+}
+/**
+ * Reconcile the trace tables' day partitions with the retention policy.
+ *
+ * `now` is injectable so the maintenance window is testable without mocking the
+ * clock. Returns the names created and dropped so a job runner can record them.
+ */
+export declare function syncTracePartitions(db: DB, config: TracePartitionConfig, now?: Date): Promise<PartitionSyncSummary>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/trace/partition/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/trace/partition/sync.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAA;AAIhD,OAAO,EAAkB,KAAK,oBAAoB,EAAE,MAAM,WAAW,CAAA;AAGrE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;IACnC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CACpC;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,EAAE,EACN,MAAM,EAAE,oBAAoB,EAC5B,GAAG,GAAE,IAAiB,GACrB,OAAO,CAAC,oBAAoB,CAAC,CAiC/B"}

package/dist/trace/partition/sync.js

@@ -0,0 +1,62 @@
+// The impure half of partition maintenance: read the catalog for partitions
+// that exist, ask the planner what should exist, and apply the difference.
+// Creating and dropping day partitions is idempotent — `IF NOT EXISTS` /
+// `IF EXISTS` make a re-run after a crash a no-op — so this is safe to run on
+// every boot and on a cron without coordination.
+import { sql } from '../../data/db/sql.js';
+import { quoteIdentifier } from '../../data/db/identifiers.js';
+import { getBaseLogger } from '../../core/logging/index.js';
+import { PARTITIONED_TRACE_TABLES } from './tables.js';
+import { planPartitions } from './plan.js';
+import { addDays } from './day.js';
+/**
+ * Reconcile the trace tables' day partitions with the retention policy.
+ *
+ * `now` is injectable so the maintenance window is testable without mocking the
+ * clock. Returns the names created and dropped so a job runner can record them.
+ */
+export async function syncTracePartitions(db, config, now = new Date()) {
+    const existing = await readExistingPartitions(db);
+    const plan = planPartitions({ now, config, existing });
+    for (const partition of plan.create) {
+        const child = quoteIdentifier(partition.name, 'trace partition');
+        const parent = quoteIdentifier(partition.parent, 'trace table');
+        // addDays re-validates the day; the bound is a generated YYYY-MM-DD literal.
+        const upper = addDays(partition.day, 1);
+        await db.execute(sql.raw(`CREATE TABLE IF NOT EXISTS ${child} PARTITION OF ${parent} ` +
+            `FOR VALUES FROM ('${partition.day}') TO ('${upper}')`));
+    }
+    for (const partition of plan.drop) {
+        const child = quoteIdentifier(partition.name, 'trace partition');
+        await db.execute(sql.raw(`DROP TABLE IF EXISTS ${child}`));
+    }
+    const summary = {
+        created: plan.create.map(p => p.name),
+        dropped: plan.drop.map(p => p.name),
+    };
+    if (summary.created.length > 0 || summary.dropped.length > 0) {
+        getBaseLogger().info({ created: summary.created, dropped: summary.dropped }, 'Trace partition maintenance applied');
+    }
+    return summary;
+}
+async function readExistingPartitions(db) {
+    const parents = PARTITIONED_TRACE_TABLES.map(t => t.parent);
+    const parentList = sql.join(parents.map(p => sql `${p}`), sql `, `);
+    const rows = await db.execute(sql `
+    SELECT p.relname AS parent, c.relname AS child
+    FROM pg_inherits i
+    JOIN pg_class c ON c.oid = i.inhrelid
+    JOIN pg_class p ON p.oid = i.inhparent
+    WHERE p.relname IN (${parentList})
+  `);
+    const byParent = new Map();
+    for (const parent of parents)
+        byParent.set(parent, new Set());
+    for (const row of rows) {
+        const parent = row['parent'];
+        const child = row['child'];
+        byParent.get(parent)?.add(child);
+    }
+    return byParent;
+}
+//# sourceMappingURL=sync.js.map

package/dist/trace/partition/sync.js.map

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

package/dist/trace/partition/tables.d.ts

@@ -0,0 +1,8 @@
+export type RetentionClass = 'hot' | 'cold';
+export interface PartitionedTraceTable {
+    /** The parent table's wire name — partitions are children of this. */
+    readonly parent: string;
+    readonly retention: RetentionClass;
+}
+export declare const PARTITIONED_TRACE_TABLES: readonly PartitionedTraceTable[];
+//# sourceMappingURL=tables.d.ts.map

package/dist/trace/partition/tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.d.ts","sourceRoot":"","sources":["../../../src/trace/partition/tables.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,CAAA;AAE3C,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAA;CACnC;AAED,eAAO,MAAM,wBAAwB,EAAE,SAAS,qBAAqB,EAKpE,CAAA"}

package/dist/trace/partition/tables.js

@@ -0,0 +1,16 @@
+// The four partitioned trace tables and the retention window each one obeys.
+// Hot tables (`trace`, `trace_step`) keep `hotRetentionDays` of partitions;
+// cold tables (`trace_retained`, `trace_step_retained`) keep
+// `errorRetentionDays`. Partition creation uses the same lead window for all
+// four — copy-on-error can land a cold row on any day a hot row exists.
+import { trace } from '../schema/trace.js';
+import { traceStep } from '../schema/trace-step.js';
+import { traceRetained } from '../schema/trace-retained.js';
+import { traceStepRetained } from '../schema/trace-step-retained.js';
+export const PARTITIONED_TRACE_TABLES = [
+    { parent: trace.$name, retention: 'hot' },
+    { parent: traceStep.$name, retention: 'hot' },
+    { parent: traceRetained.$name, retention: 'cold' },
+    { parent: traceStepRetained.$name, retention: 'cold' },
+];
+//# sourceMappingURL=tables.js.map

package/dist/trace/partition/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","sourceRoot":"","sources":["../../../src/trace/partition/tables.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,4EAA4E;AAC5E,6DAA6D;AAC7D,6EAA6E;AAC7E,wEAAwE;AAExE,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAA;AAUpE,MAAM,CAAC,MAAM,wBAAwB,GAAqC;IACxE,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;IACzC,EAAE,MAAM,EAAE,SAAS,CAAC,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE;IAC7C,EAAE,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE;IAClD,EAAE,MAAM,EAAE,iBAAiB,CAAC,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE;CACvD,CAAA"}

package/dist/trace/retain/copy-on-error.d.ts

@@ -0,0 +1,18 @@
+import type { DB } from '../../data/db/index.js';
+export interface CopyOnErrorResult {
+    /** Rows newly inserted into `trace_retained` (rows already retained excluded). */
+    readonly traces: number;
+    /** Rows newly inserted into `trace_step_retained`. */
+    readonly steps: number;
+}
+/**
+ * Copy an errored trace and its parent spine into the cold retained tables.
+ *
+ * `traceId` is the trace that ended badly. Its ancestry is walked through
+ * `parent_id` to the root; every trace on that spine, plus all of their steps,
+ * is inserted into `trace_retained` / `trace_step_retained`. Returns the count
+ * of rows actually inserted — zero for both when everything was already
+ * retained, or when `traceId` does not exist.
+ */
+export declare function copyTraceOnError(db: DB, traceId: string): Promise<CopyOnErrorResult>;
+//# sourceMappingURL=copy-on-error.d.ts.map

package/dist/trace/retain/copy-on-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-on-error.d.ts","sourceRoot":"","sources":["../../../src/trace/retain/copy-on-error.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,wBAAwB,CAAA;AAMhD,MAAM,WAAW,iBAAiB;IAChC,kFAAkF;IAClF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,sDAAsD;IACtD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAUD;;;;;;;;GAQG;AACH,wBAAsB,gBAAgB,CAAC,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2B1F"}

package/dist/trace/retain/copy-on-error.js

@@ -0,0 +1,62 @@
+// Copy-on-error: when a trace ends badly (error / truncated / expired), the hot
+// `trace` / `trace_step` partitions it lives in will be dropped on the normal
+// `hotRetentionDays` schedule. Before that happens the errored trace — and its
+// ancestry spine up to the root — is copied into the cold `trace_retained` /
+// `trace_step_retained` tables, which keep the longer `errorRetentionDays`
+// window.
+//
+// Only the parent chain is followed (`parent_id`): not siblings, not the step
+// tree (`parent_step_id`). The spine is what you need to read an errored trace
+// in context. Each copied trace brings all of its own steps.
+//
+// The copy is idempotent — `ON CONFLICT DO NOTHING` against each cold table's
+// composite primary key — so re-running after a crash, or copying a trace whose
+// ancestor was already retained by an earlier error, is a no-op.
+import { sql } from '../../data/db/sql.js';
+import { quoteIdentifier } from '../../data/db/identifiers.js';
+import { camelToSnake } from '../../data/domain/naming.js';
+import { traceFields } from '../schema/trace-fields.js';
+import { traceStepFields } from '../schema/trace-step-fields.js';
+function columnList(keys, label, prefix = '') {
+    return keys.map(k => `${prefix}${quoteIdentifier(camelToSnake(k), label)}`).join(', ');
+}
+const TRACE_COLUMNS = columnList(Object.keys(traceFields), 'trace column');
+const TRACE_STEP_COLUMNS = columnList(Object.keys(traceStepFields), 'trace step column');
+const TRACE_STEP_COLUMNS_FROM_STEP = columnList(Object.keys(traceStepFields), 'trace step column', 's.');
+/**
+ * Copy an errored trace and its parent spine into the cold retained tables.
+ *
+ * `traceId` is the trace that ended badly. Its ancestry is walked through
+ * `parent_id` to the root; every trace on that spine, plus all of their steps,
+ * is inserted into `trace_retained` / `trace_step_retained`. Returns the count
+ * of rows actually inserted — zero for both when everything was already
+ * retained, or when `traceId` does not exist.
+ */
+export async function copyTraceOnError(db, traceId) {
+    const rows = await db.execute(sql `
+    WITH RECURSIVE spine AS (
+      SELECT * FROM "trace" WHERE "id" = ${traceId}
+      UNION
+      SELECT t.* FROM "trace" t JOIN spine ON t."id" = spine."parent_id"
+    ),
+    copied_traces AS (
+      INSERT INTO "trace_retained" (${sql.raw(TRACE_COLUMNS)})
+      SELECT ${sql.raw(TRACE_COLUMNS)} FROM spine
+      ON CONFLICT ("id", "opened_day") DO NOTHING
+      RETURNING "id"
+    ),
+    copied_steps AS (
+      INSERT INTO "trace_step_retained" (${sql.raw(TRACE_STEP_COLUMNS)})
+      SELECT ${sql.raw(TRACE_STEP_COLUMNS_FROM_STEP)}
+      FROM "trace_step" s JOIN spine ON s."trace_id" = spine."id"
+      ON CONFLICT ("id", "trace_day") DO NOTHING
+      RETURNING "id"
+    )
+    SELECT
+      (SELECT count(*) FROM copied_traces)::int AS traces,
+      (SELECT count(*) FROM copied_steps)::int AS steps
+  `);
+    const row = rows[0];
+    return { traces: row['traces'], steps: row['steps'] };
+}
+//# sourceMappingURL=copy-on-error.js.map

package/dist/trace/retain/copy-on-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"copy-on-error.js","sourceRoot":"","sources":["../../../src/trace/retain/copy-on-error.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,8EAA8E;AAC9E,+EAA+E;AAC/E,6EAA6E;AAC7E,2EAA2E;AAC3E,UAAU;AACV,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,6DAA6D;AAC7D,EAAE;AACF,8EAA8E;AAC9E,gFAAgF;AAChF,iEAAiE;AAEjE,OAAO,EAAE,GAAG,EAAE,MAAM,sBAAsB,CAAA;AAE1C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAShE,SAAS,UAAU,CAAC,IAAc,EAAE,KAAa,EAAE,MAAM,GAAG,EAAE;IAC5D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,MAAM,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACxF,CAAC;AAED,MAAM,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,cAAc,CAAC,CAAA;AAC1E,MAAM,kBAAkB,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,mBAAmB,CAAC,CAAA;AACxF,MAAM,4BAA4B,GAAG,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,mBAAmB,EAAE,IAAI,CAAC,CAAA;AAExG;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,EAAM,EAAE,OAAe;IAC5D,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAA;;2CAEQ,OAAO;;;;;sCAKZ,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC;eAC7C,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC;;;;;2CAKM,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC;eACvD,GAAG,CAAC,GAAG,CAAC,4BAA4B,CAAC;;;;;;;;GAQjD,CAAC,CAAA;IAEF,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAE,CAAA;IACpB,OAAO,EAAE,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAW,EAAE,KAAK,EAAE,GAAG,CAAC,OAAO,CAAW,EAAE,CAAA;AAC3E,CAAC"}

package/dist/trace/schema/trace-fields.d.ts

@@ -0,0 +1,18 @@
+export declare const traceFields: {
+    id: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    openedDay: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    rootId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    parentId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId"> | null>;
+    parentStepId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null>;
+    entryKind: import("../../data/domain/types.js").FieldDescriptor<"test" | "http" | "job" | "cron"> & import("../../data/domain/field.js").FieldModifiers<"test" | "http" | "job" | "cron">;
+    status: import("../../data/domain/types.js").FieldDescriptor<"error" | "open" | "closed" | "truncated" | "expired"> & import("../../data/domain/field.js").FieldModifiers<"error" | "open" | "closed" | "truncated" | "expired">;
+    tenantId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    requestId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    sessionId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    userId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    openedAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    closedAt: import("../../data/domain/types.js").FieldDescriptor<Date | null> & import("../../data/domain/field.js").FieldModifiers<Date | null>;
+    expiresAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    truncatedAtSeq: import("../../data/domain/types.js").FieldDescriptor<number | null> & import("../../data/domain/field.js").FieldModifiers<number | null>;
+};
+//# sourceMappingURL=trace-fields.d.ts.map

package/dist/trace/schema/trace-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-fields.d.ts","sourceRoot":"","sources":["../../../src/trace/schema/trace-fields.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;CAwBvB,CAAA"}

package/dist/trace/schema/trace-fields.js

@@ -0,0 +1,34 @@
+// The column shape shared by the hot `trace` table and the cold
+// `trace_retained` table. A trace is one execution rooted at an entry point
+// (HTTP request, job, cron tick, test); its steps live in `trace_step`.
+//
+// Field descriptors are immutable, so the same record is handed to both
+// `define()` calls — the hot and retained tables are structurally identical
+// and differ only in retention policy.
+import { field } from '../../data/domain/index.js';
+export const traceFields = {
+    id: field.uuid().brand('TraceId').defaultRandom(),
+    // Partition key — the calendar day the trace opened. Retention drops whole
+    // day-partitions, so every row carries the day it belongs to.
+    openedDay: field.date(),
+    // The root of the trace tree. Equals `id` for a root trace. No DB foreign
+    // key: retention must be free to drop ancestor partitions out from under it.
+    rootId: field.uuid().brand('TraceId'),
+    parentId: field.uuid().brand('TraceId').nullable(),
+    parentStepId: field.uuid().brand('TraceStepId').nullable(),
+    entryKind: field.enum(['http', 'job', 'cron', 'test']),
+    status: field.enum(['open', 'closed', 'error', 'truncated', 'expired']),
+    tenantId: field.uuid().tenant().nullable(),
+    requestId: field.text().nullable(),
+    sessionId: field.text().nullable(),
+    userId: field.text().nullable(),
+    openedAt: field.timestamp(),
+    closedAt: field.timestamp().nullable(),
+    // Force-close deadline: openedAt + hotRetentionDays. A trace must not outlive
+    // its own oldest day-partition.
+    expiresAt: field.timestamp(),
+    // Set when the step cap is hit and the trace is truncated — the seq at which
+    // capture stopped.
+    truncatedAtSeq: field.integer().nullable(),
+};
+//# sourceMappingURL=trace-fields.js.map

package/dist/trace/schema/trace-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-fields.js","sourceRoot":"","sources":["../../../src/trace/schema/trace-fields.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,4EAA4E;AAC5E,wEAAwE;AACxE,EAAE;AACF,wEAAwE;AACxE,4EAA4E;AAC5E,uCAAuC;AAEvC,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAElD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE;IACjD,2EAA2E;IAC3E,8DAA8D;IAC9D,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE;IACvB,0EAA0E;IAC1E,6EAA6E;IAC7E,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACrC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;IAClD,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IAC1D,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACtD,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;IACvE,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1C,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE;IAC3B,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE;IACtC,8EAA8E;IAC9E,gCAAgC;IAChC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;IAC5B,6EAA6E;IAC7E,mBAAmB;IACnB,cAAc,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC3C,CAAA"}

package/dist/trace/schema/trace-retained.d.ts

@@ -0,0 +1,18 @@
+export declare const traceRetained: import("../../data/domain/types.js").DefinedTable<{
+    id: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    openedDay: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    rootId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    parentId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId"> | null>;
+    parentStepId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null>;
+    entryKind: import("../../data/domain/types.js").FieldDescriptor<"test" | "http" | "job" | "cron"> & import("../../data/domain/field.js").FieldModifiers<"test" | "http" | "job" | "cron">;
+    status: import("../../data/domain/types.js").FieldDescriptor<"error" | "open" | "closed" | "truncated" | "expired"> & import("../../data/domain/field.js").FieldModifiers<"error" | "open" | "closed" | "truncated" | "expired">;
+    tenantId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    requestId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    sessionId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    userId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    openedAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    closedAt: import("../../data/domain/types.js").FieldDescriptor<Date | null> & import("../../data/domain/field.js").FieldModifiers<Date | null>;
+    expiresAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    truncatedAtSeq: import("../../data/domain/types.js").FieldDescriptor<number | null> & import("../../data/domain/field.js").FieldModifiers<number | null>;
+}>;
+//# sourceMappingURL=trace-retained.d.ts.map

package/dist/trace/schema/trace-retained.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-retained.d.ts","sourceRoot":"","sources":["../../../src/trace/schema/trace-retained.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;EAGxB,CAAA"}

package/dist/trace/schema/trace-retained.js

@@ -0,0 +1,11 @@
+// The cold `trace_retained` table — structurally identical to `trace`, but
+// holds traces copied out on error so they survive past `hotRetentionDays`.
+// RANGE-partitioned the same way; retention drops day-partitions older than
+// `errorRetentionDays`.
+import { define } from '../../data/domain/index.js';
+import { traceFields } from './trace-fields.js';
+export const traceRetained = define('trace_retained', traceFields, {
+    primaryKey: ['id', 'openedDay'],
+    partitionBy: { strategy: 'range', column: 'openedDay' },
+});
+//# sourceMappingURL=trace-retained.js.map

package/dist/trace/schema/trace-retained.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-retained.js","sourceRoot":"","sources":["../../../src/trace/schema/trace-retained.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,4EAA4E;AAC5E,4EAA4E;AAC5E,wBAAwB;AAExB,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,gBAAgB,EAAE,WAAW,EAAE;IACjE,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC;IAC/B,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE;CACxD,CAAC,CAAA"}

package/dist/trace/schema/trace-step-fields.d.ts

@@ -0,0 +1,15 @@
+export declare const traceStepFields: {
+    id: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId">>;
+    traceDay: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    traceId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    seq: import("../../data/domain/types.js").FieldDescriptor<number> & import("../../data/domain/field.js").FieldModifiers<number>;
+    parentStepId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null>;
+    flowStepRef: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    status: import("../../data/domain/types.js").FieldDescriptor<"error" | "ok"> & import("../../data/domain/field.js").FieldModifiers<"error" | "ok">;
+    startedAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    completedAt: import("../../data/domain/types.js").FieldDescriptor<Date | null> & import("../../data/domain/field.js").FieldModifiers<Date | null>;
+    durationMicros: import("../../data/domain/types.js").FieldDescriptor<bigint | null> & import("../../data/domain/field.js").FieldModifiers<bigint | null>;
+    capturedInputs: import("../../data/domain/types.js").FieldDescriptor<import("zod/v4").JSONType> & import("../../data/domain/field.js").FieldModifiers<import("zod/v4").JSONType>;
+    error: import("../../data/domain/types.js").FieldDescriptor<import("zod/v4").JSONType> & import("../../data/domain/field.js").FieldModifiers<import("zod/v4").JSONType>;
+};
+//# sourceMappingURL=trace-step-fields.d.ts.map

package/dist/trace/schema/trace-step-fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-step-fields.d.ts","sourceRoot":"","sources":["../../../src/trace/schema/trace-step-fields.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,eAAe;;;;;;;;;;;;;CAqB3B,CAAA"}

package/dist/trace/schema/trace-step-fields.js

@@ -0,0 +1,31 @@
+// The column shape shared by the hot `trace_step` table and the cold
+// `trace_step_retained` table. One row per flow step that executed under an
+// active Flow.
+//
+// Field descriptors are immutable, so the same record is handed to both
+// `define()` calls.
+import { field } from '../../data/domain/index.js';
+import { schema } from '../../data/schema/namespace.js';
+export const traceStepFields = {
+    id: field.uuid().brand('TraceStepId').defaultRandom(),
+    // Partition key — the parent trace's `openedDay`, NOT the step's own
+    // timestamp. This keeps the foreign key into `trace` partition-local: a
+    // step and its trace always sit in the same day-partition, so the two
+    // tables' partitions retire together.
+    traceDay: field.date(),
+    traceId: field.uuid().brand('TraceId'),
+    // Spawn order within the trace. Branch vs step is an edge property, not a
+    // node property — `seq` only records sequencing.
+    seq: field.integer(),
+    parentStepId: field.uuid().brand('TraceStepId').nullable(),
+    // The `path:symbol` identity of the flow step, matching the annotation's
+    // upstream/downstream targets.
+    flowStepRef: field.text(),
+    status: field.enum(['ok', 'error']),
+    startedAt: field.timestamp(),
+    completedAt: field.timestamp().nullable(),
+    durationMicros: field.bigint().nullable(),
+    capturedInputs: field.jsonb(schema.check.json()).nullable(),
+    error: field.jsonb(schema.check.json()).nullable(),
+};
+//# sourceMappingURL=trace-step-fields.js.map

package/dist/trace/schema/trace-step-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-step-fields.js","sourceRoot":"","sources":["../../../src/trace/schema/trace-step-fields.ts"],"names":[],"mappings":"AAAA,qEAAqE;AACrE,4EAA4E;AAC5E,eAAe;AACf,EAAE;AACF,wEAAwE;AACxE,oBAAoB;AAEpB,OAAO,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAA;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,gCAAgC,CAAA;AAEvD,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,EAAE,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,aAAa,EAAE;IACrD,qEAAqE;IACrE,wEAAwE;IACxE,sEAAsE;IACtE,sCAAsC;IACtC,QAAQ,EAAE,KAAK,CAAC,IAAI,EAAE;IACtB,OAAO,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC;IACtC,0EAA0E;IAC1E,iDAAiD;IACjD,GAAG,EAAE,KAAK,CAAC,OAAO,EAAE;IACpB,YAAY,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,QAAQ,EAAE;IAC1D,yEAAyE;IACzE,+BAA+B;IAC/B,WAAW,EAAE,KAAK,CAAC,IAAI,EAAE;IACzB,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE;IAC5B,WAAW,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,QAAQ,EAAE;IACzC,cAAc,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,cAAc,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3D,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;CACnD,CAAA"}

package/dist/trace/schema/trace-step-retained.d.ts

@@ -0,0 +1,15 @@
+export declare const traceStepRetained: import("../../data/domain/types.js").DefinedTable<{
+    id: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId">>;
+    traceDay: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    traceId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    seq: import("../../data/domain/types.js").FieldDescriptor<number> & import("../../data/domain/field.js").FieldModifiers<number>;
+    parentStepId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null>;
+    flowStepRef: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    status: import("../../data/domain/types.js").FieldDescriptor<"error" | "ok"> & import("../../data/domain/field.js").FieldModifiers<"error" | "ok">;
+    startedAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    completedAt: import("../../data/domain/types.js").FieldDescriptor<Date | null> & import("../../data/domain/field.js").FieldModifiers<Date | null>;
+    durationMicros: import("../../data/domain/types.js").FieldDescriptor<bigint | null> & import("../../data/domain/field.js").FieldModifiers<bigint | null>;
+    capturedInputs: import("../../data/domain/types.js").FieldDescriptor<import("zod/v4").JSONType> & import("../../data/domain/field.js").FieldModifiers<import("zod/v4").JSONType>;
+    error: import("../../data/domain/types.js").FieldDescriptor<import("zod/v4").JSONType> & import("../../data/domain/field.js").FieldModifiers<import("zod/v4").JSONType>;
+}>;
+//# sourceMappingURL=trace-step-retained.d.ts.map

package/dist/trace/schema/trace-step-retained.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-step-retained.d.ts","sourceRoot":"","sources":["../../../src/trace/schema/trace-step-retained.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;EAQ5B,CAAA"}

package/dist/trace/schema/trace-step-retained.js

@@ -0,0 +1,18 @@
+// The cold `trace_step_retained` table — structurally identical to
+// `trace_step`, holding steps copied out on error. Its foreign key targets
+// `trace_retained`: copy-on-error writes the trace and its steps together, so
+// referential integrity holds in the cold tables exactly as it does in the hot
+// ones.
+import { define } from '../../data/domain/index.js';
+import { traceStepFields } from './trace-step-fields.js';
+import { traceRetained } from './trace-retained.js';
+export const traceStepRetained = define('trace_step_retained', traceStepFields, {
+    primaryKey: ['id', 'traceDay'],
+    partitionBy: { strategy: 'range', column: 'traceDay' },
+    foreignKeys: [{
+            columns: ['traceId', 'traceDay'],
+            references: { definition: traceRetained, columns: ['id', 'openedDay'] },
+            onDelete: 'cascade',
+        }],
+});
+//# sourceMappingURL=trace-step-retained.js.map

package/dist/trace/schema/trace-step-retained.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-step-retained.js","sourceRoot":"","sources":["../../../src/trace/schema/trace-step-retained.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,2EAA2E;AAC3E,8EAA8E;AAC9E,+EAA+E;AAC/E,QAAQ;AAER,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAEnD,MAAM,CAAC,MAAM,iBAAiB,GAAG,MAAM,CAAC,qBAAqB,EAAE,eAAe,EAAE;IAC9E,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;IAC9B,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE;IACtD,WAAW,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;YAChC,UAAU,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE;YACvE,QAAQ,EAAE,SAAS;SACpB,CAAC;CACH,CAAC,CAAA"}

package/dist/trace/schema/trace-step.d.ts

@@ -0,0 +1,15 @@
+export declare const traceStep: import("../../data/domain/types.js").DefinedTable<{
+    id: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId">>;
+    traceDay: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    traceId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    seq: import("../../data/domain/types.js").FieldDescriptor<number> & import("../../data/domain/field.js").FieldModifiers<number>;
+    parentStepId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null>;
+    flowStepRef: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    status: import("../../data/domain/types.js").FieldDescriptor<"error" | "ok"> & import("../../data/domain/field.js").FieldModifiers<"error" | "ok">;
+    startedAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    completedAt: import("../../data/domain/types.js").FieldDescriptor<Date | null> & import("../../data/domain/field.js").FieldModifiers<Date | null>;
+    durationMicros: import("../../data/domain/types.js").FieldDescriptor<bigint | null> & import("../../data/domain/field.js").FieldModifiers<bigint | null>;
+    capturedInputs: import("../../data/domain/types.js").FieldDescriptor<import("zod/v4").JSONType> & import("../../data/domain/field.js").FieldModifiers<import("zod/v4").JSONType>;
+    error: import("../../data/domain/types.js").FieldDescriptor<import("zod/v4").JSONType> & import("../../data/domain/field.js").FieldModifiers<import("zod/v4").JSONType>;
+}>;
+//# sourceMappingURL=trace-step.d.ts.map

package/dist/trace/schema/trace-step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-step.d.ts","sourceRoot":"","sources":["../../../src/trace/schema/trace-step.ts"],"names":[],"mappings":"AASA,eAAO,MAAM,SAAS;;;;;;;;;;;;;EAQpB,CAAA"}

package/dist/trace/schema/trace-step.js

@@ -0,0 +1,17 @@
+// The hot `trace_step` table — one row per flow step executed under a Flow.
+// Partitioned by `traceDay` (the parent trace's `openedDay`), so the foreign
+// key into `trace` is partition-local and both tables' partitions retire
+// together.
+import { define } from '../../data/domain/index.js';
+import { traceStepFields } from './trace-step-fields.js';
+import { trace } from './trace.js';
+export const traceStep = define('trace_step', traceStepFields, {
+    primaryKey: ['id', 'traceDay'],
+    partitionBy: { strategy: 'range', column: 'traceDay' },
+    foreignKeys: [{
+            columns: ['traceId', 'traceDay'],
+            references: { definition: trace, columns: ['id', 'openedDay'] },
+            onDelete: 'cascade',
+        }],
+});
+//# sourceMappingURL=trace-step.js.map

package/dist/trace/schema/trace-step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-step.js","sourceRoot":"","sources":["../../../src/trace/schema/trace-step.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,6EAA6E;AAC7E,yEAAyE;AACzE,YAAY;AAEZ,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM,CAAC,YAAY,EAAE,eAAe,EAAE;IAC7D,UAAU,EAAE,CAAC,IAAI,EAAE,UAAU,CAAC;IAC9B,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE;IACtD,WAAW,EAAE,CAAC;YACZ,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC;YAChC,UAAU,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC,EAAE;YAC/D,QAAQ,EAAE,SAAS;SACpB,CAAC;CACH,CAAC,CAAA"}

package/dist/trace/schema/trace.d.ts

@@ -0,0 +1,18 @@
+export declare const trace: import("../../data/domain/types.js").DefinedTable<{
+    id: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    openedDay: import("../../data/domain/types.js").FieldDescriptor<string> & import("../../data/domain/field.js").FieldModifiers<string>;
+    rootId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId">> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId">>;
+    parentId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceId"> | null>;
+    parentStepId: import("../../data/domain/types.js").FieldDescriptor<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null> & import("../../data/domain/field.js").FieldModifiers<import("../../data/domain/brand.js").Branded<string, "TraceStepId"> | null>;
+    entryKind: import("../../data/domain/types.js").FieldDescriptor<"test" | "http" | "job" | "cron"> & import("../../data/domain/field.js").FieldModifiers<"test" | "http" | "job" | "cron">;
+    status: import("../../data/domain/types.js").FieldDescriptor<"error" | "open" | "closed" | "truncated" | "expired"> & import("../../data/domain/field.js").FieldModifiers<"error" | "open" | "closed" | "truncated" | "expired">;
+    tenantId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    requestId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    sessionId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    userId: import("../../data/domain/types.js").FieldDescriptor<string | null> & import("../../data/domain/field.js").FieldModifiers<string | null>;
+    openedAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    closedAt: import("../../data/domain/types.js").FieldDescriptor<Date | null> & import("../../data/domain/field.js").FieldModifiers<Date | null>;
+    expiresAt: import("../../data/domain/types.js").FieldDescriptor<Date> & import("../../data/domain/field.js").FieldModifiers<Date>;
+    truncatedAtSeq: import("../../data/domain/types.js").FieldDescriptor<number | null> & import("../../data/domain/field.js").FieldModifiers<number | null>;
+}>;
+//# sourceMappingURL=trace.d.ts.map

package/dist/trace/schema/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/trace/schema/trace.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,KAAK;;;;;;;;;;;;;;;;EAGhB,CAAA"}

package/dist/trace/schema/trace.js

@@ -0,0 +1,11 @@
+// The hot `trace` table — one row per execution, rooted at an entry point.
+// RANGE-partitioned by `openedDay`; retention drops day-partitions older than
+// `hotRetentionDays`. Errored traces are copied to `trace_retained` before
+// their partition is dropped.
+import { define } from '../../data/domain/index.js';
+import { traceFields } from './trace-fields.js';
+export const trace = define('trace', traceFields, {
+    primaryKey: ['id', 'openedDay'],
+    partitionBy: { strategy: 'range', column: 'openedDay' },
+});
+//# sourceMappingURL=trace.js.map

package/dist/trace/schema/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../../../src/trace/schema/trace.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,8EAA8E;AAC9E,2EAA2E;AAC3E,8BAA8B;AAE9B,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAA;AACnD,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE;IAChD,UAAU,EAAE,CAAC,IAAI,EAAE,WAAW,CAAC;IAC/B,WAAW,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE;CACxD,CAAC,CAAA"}

package/dist/workspace/changed-files.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"changed-files.d.ts","sourceRoot":"","sources":["../../src/workspace/changed-files.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,QAAQ,CAAA;AAE/C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAalE;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAoBhD"}
+{"version":3,"file":"changed-files.d.ts","sourceRoot":"","sources":["../../src/workspace/changed-files.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,QAAQ,GAAG,aAAa,GAAG,QAAQ,CAAA;AAE/C,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,MAAM,EAAE,CAalE;AAED,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,EAAE,SAAS,MAAM,EAAE,GAC7B;IAAE,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAAC,WAAW,EAAE,OAAO,CAAA;CAAE,CAwBhD"}

package/dist/workspace/changed-files.js

@@ -20,7 +20,11 @@ export function filesToModules(files, modulePaths) {
     for (const file of files) {
         let matched = false;
         for (const modPath of sorted) {
-            if (file === modPath || file.startsWith(modPath + '/')) {
+            // '.' is the synthesized implicit module for a single-package repo — it
+            // is the repo root, so it contains every file. git diff paths are
+            // repo-relative without a leading './', so the prefix check below can
+            // never match '.' on its own.
+            if (modPath === '.' || file === modPath || file.startsWith(modPath + '/')) {
                 modules.add(modPath);
                 matched = true;
                 break;