@shapeshift-labs/frontier-swarm 0.5.9 → 0.5.11

package/dist/queue-types.d.ts

@@ -0,0 +1,194 @@
+import type { JsonObject } from '@shapeshift-labs/frontier';
+import type { FRONTIER_SWARM_ARTIFACT_INDEX_KIND, FRONTIER_SWARM_ARTIFACT_INDEX_VERSION, FRONTIER_SWARM_MERGE_PLAN_KIND, FRONTIER_SWARM_MERGE_PLAN_VERSION, FRONTIER_SWARM_QUEUE_SNAPSHOT_KIND, FRONTIER_SWARM_QUEUE_SNAPSHOT_VERSION, FRONTIER_SWARM_REVIEW_PLAN_KIND, FRONTIER_SWARM_REVIEW_PLAN_VERSION, FRONTIER_SWARM_RUN_CHECKPOINT_KIND, FRONTIER_SWARM_RUN_CHECKPOINT_VERSION } from './constants.js';
+import type { FrontierSwarmLease, FrontierSwarmLeaseInput, FrontierSwarmLeaseRenewalInput } from './leases.js';
+import type { FrontierSwarmCommandInput } from './manifest-types.js';
+import type { FrontierSwarmPlan } from './plan.js';
+import type { FrontierSwarmJobResultInput } from './result-types.js';
+import type { FrontierSwarmEventInput, FrontierSwarmRun } from './run-types.js';
+import type { FrontierSwarmJobStatus } from './status-types.js';
+export type FrontierSwarmQueueJobStatus = 'ready' | 'leased' | 'running' | 'completed' | 'failed' | 'blocked' | 'retrying' | 'dead-letter' | string;
+export interface FrontierSwarmQueueJobInput {
+    jobId: string;
+    taskId?: string;
+    runId?: string;
+    status?: FrontierSwarmQueueJobStatus;
+    lane?: string;
+    compute?: string;
+    concurrencyKey?: string;
+    priority?: number;
+    attempts?: number;
+    maxAttempts?: number;
+    availableAt?: number;
+    lease?: FrontierSwarmLease;
+    lastError?: string;
+    metadata?: unknown;
+}
+export interface FrontierSwarmQueueJob {
+    jobId: string;
+    taskId?: string;
+    runId?: string;
+    status: FrontierSwarmQueueJobStatus;
+    lane?: string;
+    compute?: string;
+    concurrencyKey?: string;
+    priority: number;
+    attempts: number;
+    maxAttempts: number;
+    availableAt?: number;
+    lease?: FrontierSwarmLease;
+    lastError?: string;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmQueueSnapshotInput {
+    id?: string;
+    plan: FrontierSwarmPlan;
+    run?: FrontierSwarmRun;
+    jobs?: readonly FrontierSwarmQueueJobInput[];
+    leases?: readonly FrontierSwarmLease[];
+    generatedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmQueueSnapshot {
+    kind: typeof FRONTIER_SWARM_QUEUE_SNAPSHOT_KIND;
+    version: typeof FRONTIER_SWARM_QUEUE_SNAPSHOT_VERSION;
+    id: string;
+    planId: string;
+    runId: string;
+    generatedAt: number;
+    jobs: FrontierSwarmQueueJob[];
+    byStatus: Record<string, string[]>;
+    byLane: Record<string, string[]>;
+    leases: FrontierSwarmLease[];
+    metadata?: JsonObject;
+    summary: {
+        jobCount: number;
+        leaseCount: number;
+        readyCount: number;
+        leasedCount: number;
+        completedCount: number;
+        failedCount: number;
+        deadLetterCount: number;
+    };
+}
+export interface FrontierSwarmQueueAdapter {
+    snapshot(): FrontierSwarmQueueSnapshot | Promise<FrontierSwarmQueueSnapshot>;
+    enqueue?(snapshot: FrontierSwarmQueueSnapshot): FrontierSwarmQueueSnapshot | Promise<FrontierSwarmQueueSnapshot>;
+    lease?(input: FrontierSwarmLeaseInput): readonly FrontierSwarmLease[] | Promise<readonly FrontierSwarmLease[]>;
+    renew?(input: FrontierSwarmLeaseRenewalInput): FrontierSwarmLease | Promise<FrontierSwarmLease>;
+    complete?(result: FrontierSwarmJobResultInput): FrontierSwarmQueueSnapshot | Promise<FrontierSwarmQueueSnapshot>;
+}
+export interface FrontierSwarmRunCheckpointInput {
+    run: FrontierSwarmRun;
+    sequence?: number;
+    savedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmRunCheckpoint {
+    kind: typeof FRONTIER_SWARM_RUN_CHECKPOINT_KIND;
+    version: typeof FRONTIER_SWARM_RUN_CHECKPOINT_VERSION;
+    id: string;
+    runId: string;
+    planId: string;
+    sequence: number;
+    savedAt: number;
+    status: FrontierSwarmJobStatus;
+    eventCount: number;
+    resultCount: number;
+    hash: string;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmRunStoreAdapter {
+    loadRun(runId: string): FrontierSwarmRun | undefined | Promise<FrontierSwarmRun | undefined>;
+    saveRun(run: FrontierSwarmRun, checkpoint?: FrontierSwarmRunCheckpoint): void | Promise<void>;
+    appendEvents?(runId: string, events: readonly FrontierSwarmEventInput[]): void | Promise<void>;
+    appendResults?(runId: string, results: readonly FrontierSwarmJobResultInput[]): void | Promise<void>;
+    checkpoint?(run: FrontierSwarmRun): FrontierSwarmRunCheckpoint | Promise<FrontierSwarmRunCheckpoint>;
+}
+export interface FrontierSwarmArtifactInput {
+    jobId: string;
+    path: string;
+    kind?: string;
+    bytes?: number;
+    hash?: string;
+    producedAt?: number;
+    metadata?: unknown;
+}
+export interface FrontierSwarmArtifact {
+    jobId: string;
+    path: string;
+    kind: string;
+    bytes?: number;
+    hash?: string;
+    producedAt?: number;
+    metadata?: JsonObject;
+}
+export interface FrontierSwarmArtifactIndex {
+    kind: typeof FRONTIER_SWARM_ARTIFACT_INDEX_KIND;
+    version: typeof FRONTIER_SWARM_ARTIFACT_INDEX_VERSION;
+    id: string;
+    generatedAt: number;
+    artifacts: FrontierSwarmArtifact[];
+    byJobId: Record<string, FrontierSwarmArtifact[]>;
+    byKind: Record<string, FrontierSwarmArtifact[]>;
+    summary: {
+        artifactCount: number;
+        jobCount: number;
+        kindCount: number;
+        totalBytes: number;
+    };
+}
+export interface FrontierSwarmReviewPlan {
+    kind: typeof FRONTIER_SWARM_REVIEW_PLAN_KIND;
+    version: typeof FRONTIER_SWARM_REVIEW_PLAN_VERSION;
+    id: string;
+    planId: string;
+    generatedAt: number;
+    assignments: FrontierSwarmReviewAssignment[];
+    summary: {
+        assignmentCount: number;
+        requiredCount: number;
+        sampledCount: number;
+    };
+}
+export interface FrontierSwarmReviewAssignment {
+    jobId: string;
+    taskId: string;
+    reviewers: string[];
+    required: boolean;
+    reason: 'always-review' | 'sampled' | 'violations' | 'failed' | 'budget';
+}
+export interface FrontierSwarmMergePlan {
+    kind: typeof FRONTIER_SWARM_MERGE_PLAN_KIND;
+    version: typeof FRONTIER_SWARM_MERGE_PLAN_VERSION;
+    id: string;
+    planId: string;
+    generatedAt: number;
+    ready: string[];
+    blocked: FrontierSwarmMergeBlocker[];
+    groups: FrontierSwarmMergeGroup[];
+    summary: {
+        readyCount: number;
+        blockedCount: number;
+        groupCount: number;
+    };
+}
+export interface FrontierSwarmMergeBlocker {
+    jobId: string;
+    reasons: string[];
+    conflictingJobIds: string[];
+}
+export interface FrontierSwarmMergeGroup {
+    id: string;
+    jobIds: string[];
+    changedPaths: string[];
+}
+export interface FrontierSwarmDecomposeInput {
+    featureId: string;
+    objective: string;
+    lanes: readonly string[];
+    files?: readonly string[];
+    checks?: readonly (string | FrontierSwarmCommandInput)[];
+    reviewers?: readonly string[];
+    metadata?: unknown;
+}
+//# sourceMappingURL=queue-types.d.ts.map

package/dist/queue-types.d.ts.map

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

package/dist/queue-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=queue-types.js.map

package/dist/queue-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-types.js","sourceRoot":"","sources":["../src/queue-types.ts"],"names":[],"mappings":""}

package/dist/rebase-report.d.ts

@@ -0,0 +1,3 @@
+import type { FrontierSwarmRebaseReport, FrontierSwarmRebaseReportInput } from './types.js';
+export declare function createSwarmRebaseReport(input?: FrontierSwarmRebaseReportInput): FrontierSwarmRebaseReport;
+//# sourceMappingURL=rebase-report.d.ts.map

package/dist/rebase-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rebase-report.d.ts","sourceRoot":"","sources":["../src/rebase-report.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAE5F,wBAAgB,uBAAuB,CAAC,KAAK,GAAE,8BAAmC,GAAG,yBAAyB,CAmC7G"}

package/dist/rebase-report.js

@@ -0,0 +1,52 @@
+import { FRONTIER_SWARM_REBASE_REPORT_KIND, FRONTIER_SWARM_REBASE_REPORT_VERSION } from './constants.js';
+import { stableHash, toJsonObject, uniqueStrings } from './internal.js';
+export function createSwarmRebaseReport(input = {}) {
+    const generatedAt = input.generatedAt ?? Date.now();
+    const fromIndex = input.mergeIndex?.entries.map((entry) => ({
+        jobId: entry.jobId,
+        status: entry.staleAgainstHead ? 'stale-evidence' : entry.conflictingJobIds.length ? 'semantic-overlap' : 'clean-apply',
+        reasons: uniqueStrings([...entry.reasons, ...entry.conflictKeys])
+    })) ?? [];
+    const fromBundles = !input.mergeIndex && input.bundles ? input.bundles.map((bundle) => ({
+        jobId: bundle.jobId,
+        status: bundle.staleAgainstHead ? 'stale-evidence' : 'clean-apply',
+        reasons: [...bundle.reasons]
+    })) : [];
+    const entries = [...fromIndex, ...fromBundles, ...(input.entries ?? [])].map((entry) => ({
+        jobId: entry.jobId,
+        status: entry.status ?? 'clean-apply',
+        reasons: uniqueStrings(entry.reasons ?? []),
+        ...('metadata' in entry && toJsonObject(entry.metadata) ? { metadata: toJsonObject(entry.metadata) } : {})
+    }));
+    const byStatus = groupIds(entries, (entry) => entry.status);
+    return {
+        kind: FRONTIER_SWARM_REBASE_REPORT_KIND,
+        version: FRONTIER_SWARM_REBASE_REPORT_VERSION,
+        id: input.id ?? 'swarm-rebase-report:' + stableHash([input.currentHead, entries, generatedAt]),
+        ...(input.currentHead ? { currentHead: input.currentHead } : {}),
+        generatedAt,
+        entries,
+        byStatus,
+        summary: {
+            entryCount: entries.length,
+            cleanCount: byStatus['clean-apply']?.length ?? 0,
+            conflictCount: (byStatus['textual-conflict']?.length ?? 0) + (byStatus['semantic-overlap']?.length ?? 0),
+            staleCount: byStatus['stale-evidence']?.length ?? 0
+        },
+        ...(toJsonObject(input.metadata) ? { metadata: toJsonObject(input.metadata) } : {})
+    };
+}
+function groupIds(items, key) {
+    const out = {};
+    for (const item of items) {
+        const group = key(item);
+        const id = item.jobId ?? item.id;
+        if (!id)
+            continue;
+        out[group] = [...(out[group] ?? []), id];
+    }
+    for (const ids of Object.values(out))
+        ids.sort();
+    return out;
+}
+//# sourceMappingURL=rebase-report.js.map

package/dist/rebase-report.js.map

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

package/dist/record-helpers.d.ts

@@ -0,0 +1,15 @@
+import type { JsonValue } from '@shapeshift-labs/frontier';
+import type { FrontierSwarmCommand, FrontierSwarmCommandInput, FrontierSwarmNamedRef, FrontierSwarmNamedRefInput } from './index.js';
+export declare function groupObjects<T>(items: readonly T[], key: (item: T) => string): Record<string, T[]>;
+export declare function groupIds<T extends {
+    jobId?: string;
+    id?: string;
+}>(items: readonly T[], key: (item: T) => string): Record<string, string[]>;
+export declare function normalizeCommand(input: string | FrontierSwarmCommandInput): FrontierSwarmCommand;
+export declare function normalizeCommands(input: readonly (string | FrontierSwarmCommandInput)[]): FrontierSwarmCommand[];
+export declare function normalizeNamedRef(input: string | number | FrontierSwarmNamedRefInput, fallbackKind: string): FrontierSwarmNamedRef;
+export declare function normalizeNamedRefs(input: readonly (string | FrontierSwarmNamedRefInput)[], fallbackKind: string): FrontierSwarmNamedRef[];
+export declare function normalizeId(value: string, label: string): string;
+export declare function titleFromId(id: string): string;
+export declare function toJsonValue(value: unknown): JsonValue;
+//# sourceMappingURL=record-helpers.d.ts.map

package/dist/record-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-helpers.d.ts","sourceRoot":"","sources":["../src/record-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAErI,wBAAgB,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAOlG;AAED,wBAAgB,QAAQ,CAAC,CAAC,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAU3I;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,yBAAyB,GAAG,oBAAoB,CAEhG;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,yBAAyB,CAAC,EAAE,GAAG,oBAAoB,EAAE,CAchH;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,0BAA0B,EAAE,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAkBlI;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,0BAA0B,CAAC,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,qBAAqB,EAAE,CAEzI;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIhE;AAED,wBAAgB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,CAGrD"}

package/dist/record-helpers.js

@@ -0,0 +1,78 @@
+import { cloneJsonValue, positiveNumber, stableHash, toJsonObject, uniqueStrings } from './internal.js';
+export function groupObjects(items, key) {
+    const out = {};
+    for (const item of items) {
+        const group = key(item);
+        out[group] = [...(out[group] ?? []), item];
+    }
+    return out;
+}
+export function groupIds(items, key) {
+    const out = {};
+    for (const item of items) {
+        const group = key(item);
+        const id = item.jobId ?? item.id;
+        if (!id)
+            continue;
+        out[group] = [...(out[group] ?? []), id];
+    }
+    for (const ids of Object.values(out))
+        ids.sort();
+    return out;
+}
+export function normalizeCommand(input) {
+    return normalizeCommands([input])[0];
+}
+export function normalizeCommands(input) {
+    return input.map((entry) => {
+        if (typeof entry === 'string') {
+            return { name: entry, command: entry, args: [], required: true };
+        }
+        return {
+            name: entry.name ?? [entry.command, ...(entry.args ?? [])].join(' '),
+            command: entry.command,
+            args: [...(entry.args ?? [])],
+            required: entry.required ?? true,
+            ...(entry.cwd ? { cwd: entry.cwd } : {}),
+            ...(toJsonObject(entry.metadata) ? { metadata: toJsonObject(entry.metadata) } : {})
+        };
+    });
+}
+export function normalizeNamedRef(input, fallbackKind) {
+    if (typeof input === 'string' || typeof input === 'number') {
+        const value = String(input);
+        return { id: value, kind: fallbackKind, path: value, tags: [] };
+    }
+    const path = input.path ?? input.uri;
+    const id = input.id ?? path ?? stableHash(input);
+    return {
+        id,
+        kind: input.kind ?? fallbackKind,
+        ...(input.path ? { path: input.path } : {}),
+        ...(input.uri ? { uri: input.uri } : {}),
+        ...(input.role ? { role: input.role } : {}),
+        ...(input.hash ? { hash: input.hash } : {}),
+        ...(positiveNumber(input.bytes) ? { bytes: Math.floor(input.bytes) } : {}),
+        tags: uniqueStrings(input.tags ?? []),
+        ...(toJsonObject(input.metadata) ? { metadata: toJsonObject(input.metadata) } : {})
+    };
+}
+export function normalizeNamedRefs(input, fallbackKind) {
+    return input.map((entry) => normalizeNamedRef(entry, fallbackKind)).sort((left, right) => left.id.localeCompare(right.id));
+}
+export function normalizeId(value, label) {
+    const id = String(value || '').trim();
+    if (!id)
+        throw new Error(`Missing ${label}`);
+    return id;
+}
+export function titleFromId(id) {
+    const parts = String(id).split(/[.:/_-]+/).filter(Boolean);
+    return parts.length ? parts.map((part) => part[0]?.toUpperCase() + part.slice(1)).join(' ') : String(id);
+}
+export function toJsonValue(value) {
+    if (value === undefined)
+        return null;
+    return cloneJsonValue(value);
+}
+//# sourceMappingURL=record-helpers.js.map

package/dist/record-helpers.js.map

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

package/dist/reference-oracle-runtime.d.ts

@@ -0,0 +1,4 @@
+import type { FrontierSwarmReferenceOraclePlan, FrontierSwarmReferenceOraclePlanInput, FrontierSwarmReferenceOracleResponse, FrontierSwarmReferenceOracleResponseInput } from './types.js';
+export declare function createSwarmReferenceOraclePlan(input?: FrontierSwarmReferenceOraclePlanInput): FrontierSwarmReferenceOraclePlan;
+export declare function createSwarmReferenceOracleResponse(input?: FrontierSwarmReferenceOracleResponseInput): FrontierSwarmReferenceOracleResponse;
+//# sourceMappingURL=reference-oracle-runtime.d.ts.map

package/dist/reference-oracle-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reference-oracle-runtime.d.ts","sourceRoot":"","sources":["../src/reference-oracle-runtime.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAsG,gCAAgC,EAAE,qCAAqC,EAAE,oCAAoC,EAAE,yCAAyC,EAAE,MAAM,YAAY,CAAC;AAE/R,wBAAgB,8BAA8B,CAAC,KAAK,GAAE,qCAA0C,GAAG,gCAAgC,CAsBlI;AACD,wBAAgB,kCAAkC,CAAC,KAAK,GAAE,yCAA8C,GAAG,oCAAoC,CAmB9I"}

package/dist/reference-oracle-runtime.js

@@ -0,0 +1,89 @@
+import { createSwarmDivergenceReport } from './trace-runtime.js';
+import { FRONTIER_SWARM_REFERENCE_ORACLE_PLAN_KIND, FRONTIER_SWARM_REFERENCE_ORACLE_PLAN_VERSION, FRONTIER_SWARM_REFERENCE_ORACLE_RESPONSE_KIND, FRONTIER_SWARM_REFERENCE_ORACLE_RESPONSE_VERSION } from './constants.js';
+import { normalizeReferenceWindow } from './evidence-index-helpers.js';
+import { normalizeWatchpoint } from './oracle-helpers.js';
+import { positiveNumber, stableHash, toJsonObject, uniqueStrings } from './internal.js';
+export function createSwarmReferenceOraclePlan(input = {}) {
+    const generatedAt = input.generatedAt ?? Date.now();
+    const targets = (input.targets ?? []).map((target) => ({
+        id: target.id,
+        role: target.role ?? 'candidate',
+        ...(target.command ? { command: normalizeCommand(target.command) } : {}),
+        ...(toJsonObject(target.metadata) ? { metadata: toJsonObject(target.metadata) } : {})
+    }));
+    return {
+        kind: FRONTIER_SWARM_REFERENCE_ORACLE_PLAN_KIND,
+        version: FRONTIER_SWARM_REFERENCE_ORACLE_PLAN_VERSION,
+        id: input.id ?? 'swarm-reference-oracle-plan:' + stableHash([input.serviceId, input.subject, input.fixtureId, targets, input.window, generatedAt]),
+        ...(input.serviceId ? { serviceId: input.serviceId } : {}),
+        ...(input.subject ? { subject: input.subject } : {}),
+        ...(input.fixtureId ? { fixtureId: input.fixtureId } : {}),
+        generatedAt,
+        targets,
+        ...(input.window ? { window: normalizeReferenceWindow(input.window) } : {}),
+        watchpoints: (input.watchpoints ?? []).map(normalizeWatchpoint),
+        artifactKinds: uniqueStrings(input.artifactKinds ?? []),
+        ...(toJsonObject(input.metadata) ? { metadata: toJsonObject(input.metadata) } : {})
+    };
+}
+export function createSwarmReferenceOracleResponse(input = {}) {
+    const generatedAt = input.generatedAt ?? Date.now();
+    return {
+        kind: FRONTIER_SWARM_REFERENCE_ORACLE_RESPONSE_KIND,
+        version: FRONTIER_SWARM_REFERENCE_ORACLE_RESPONSE_VERSION,
+        id: input.id ?? 'swarm-reference-oracle-response:' + stableHash([input.planId, input.status, input.targetResults, input.divergence, generatedAt]),
+        ...(input.planId ? { planId: input.planId } : {}),
+        status: input.status ?? (input.divergence ? 'failed' : 'pending'),
+        ...(input.subject ? { subject: input.subject } : {}),
+        generatedAt,
+        targetResults: (input.targetResults ?? []).map((target) => ({
+            targetId: target.targetId,
+            status: target.status ?? 'pending',
+            artifacts: normalizeNamedRefs(target.artifacts ?? [], 'reference-oracle-artifact'),
+            ...(toJsonObject(target.metadata) ? { metadata: toJsonObject(target.metadata) } : {})
+        })),
+        ...(input.divergence ? { divergence: createSwarmDivergenceReport(input.divergence) } : {}),
+        ...(toJsonObject(input.metadata) ? { metadata: toJsonObject(input.metadata) } : {})
+    };
+}
+function normalizeCommand(input) {
+    return normalizeCommands([input])[0];
+}
+function normalizeNamedRefs(input, fallbackKind) {
+    return input.map((entry) => normalizeNamedRef(entry, fallbackKind)).sort((left, right) => left.id.localeCompare(right.id));
+}
+function normalizeCommands(input) {
+    return input.map((entry) => {
+        if (typeof entry === 'string') {
+            return { name: entry, command: entry, args: [], required: true };
+        }
+        return {
+            name: entry.name ?? [entry.command, ...(entry.args ?? [])].join(' '),
+            command: entry.command,
+            args: [...(entry.args ?? [])],
+            required: entry.required ?? true,
+            ...(entry.cwd ? { cwd: entry.cwd } : {}),
+            ...(toJsonObject(entry.metadata) ? { metadata: toJsonObject(entry.metadata) } : {})
+        };
+    });
+}
+function normalizeNamedRef(input, fallbackKind) {
+    if (typeof input === 'string' || typeof input === 'number') {
+        const value = String(input);
+        return { id: value, kind: fallbackKind, path: value, tags: [] };
+    }
+    const path = input.path ?? input.uri;
+    const id = input.id ?? path ?? stableHash(input);
+    return {
+        id,
+        kind: input.kind ?? fallbackKind,
+        ...(input.path ? { path: input.path } : {}),
+        ...(input.uri ? { uri: input.uri } : {}),
+        ...(input.role ? { role: input.role } : {}),
+        ...(input.hash ? { hash: input.hash } : {}),
+        ...(positiveNumber(input.bytes) ? { bytes: Math.floor(input.bytes) } : {}),
+        tags: uniqueStrings(input.tags ?? []),
+        ...(toJsonObject(input.metadata) ? { metadata: toJsonObject(input.metadata) } : {})
+    };
+}
+//# sourceMappingURL=reference-oracle-runtime.js.map

package/dist/reference-oracle-runtime.js.map

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