@principal-ai/principal-view-core 0.22.0 → 0.22.1

package/dist/index.d.ts

@@ -24,6 +24,8 @@ export { selectScenario, matchesCondition, hasEventMatching, computeAggregates,
 export type { WorkflowTemplate, WorkflowScenario, WorkflowMode, ScenarioCondition, ScenarioTemplate, Assertion, FlowDirective, LogTemplates, FormattingOptions, OtelEvent, OtelSignal, WorkflowContext, WorkflowResult, ScenarioMatchResult, SpanTreeNode, } from './workflow/types';
 export type { OtelExportTraceServiceRequest, OtelResourceSpansData, OtelScopeSpans, OtelSpanData, OtelResourceData, OtelKeyValue, OtelAnyValue, OtelSpanEvent, OtelLink, OtelSpanStatus, OtelInstrumentationScope, TraceInfo, WorkflowMatchInfo, OtelAttributes, OtelAttributeValue, OtelLog, OtelSpan, OtelResource, OtelSeverity, OtelSeverityText, OtelSeverityNumber, } from './types/otel';
 export { getAttributeStringValue, findAttribute, getAttributeValue, flattenResourceAttributes, parseNanoTime, getSpanDuration, isErrorSeverity, isWarnSeverity, } from './types/otel';
+export type { VersionIdentifier, VersionSnapshot, RegisterVersionRequest, GetVersionResponse, VersionRegistry, } from './types/version-registry';
+export { InMemoryVersionRegistry, createInMemoryVersionRegistry } from './registry/VersionRegistry';
 export { groupSpansByTrace } from './utils/traceAggregation';
 export { SpanMatcher } from './matchers/SpanMatcher';
 export type { SpanMatchResult } from './matchers/SpanMatcher';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -22,6 +22,7 @@ export { parseTemplate, ParsedTemplate } from './workflow/template-parser';
 export { selectScenario, matchesCondition, hasEventMatching, computeAggregates, evaluateAssertion, getNestedValue, setNestedValue, } from './workflow/scenario-matcher';
 // Export OTEL helper functions
 export { getAttributeStringValue, findAttribute, getAttributeValue, flattenResourceAttributes, parseNanoTime, getSpanDuration, isErrorSeverity, isWarnSeverity, } from './types/otel';
+export { InMemoryVersionRegistry, createInMemoryVersionRegistry } from './registry/VersionRegistry';
 // Export trace aggregation utilities
 export { groupSpansByTrace } from './utils/traceAggregation';
 // Export span matcher

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH,mFAAmF;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,2CAA2C;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,iDAAiD;AACjD,mEAAmE;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,6BAA6B,CAAC;AA+CrC,+BAA+B;AAC/B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAiB9D,uEAAuE;AACvE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAO9F,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,gEAAgE;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,+CAA+C;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqB9D,uFAAuF;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAehE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,aAAa,GACd,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,4FAA4F;AAC5F,mFAAmF;AACnF,EAAE;AACF,kFAAkF;AAClF,mDAAmD;AACnD,oDAAoD;AACpD,+DAA+D;AAC/D,0FAA0F;AAC1F,uDAAuD;AACvD,8CAA8C;AAC9C,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,wGAAwG;AACxG,sGAAsG;AACtG,sEAAsE;AACtE,uEAAuE"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAkCH,mFAAmF;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAG5D,oCAAoC;AACpC,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAG1D,2CAA2C;AAC3C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,iDAAiD;AACjD,mEAAmE;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE3E,OAAO,EACL,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACd,cAAc,GACf,MAAM,6BAA6B,CAAC;AA+CrC,+BAA+B;AAC/B,OAAO,EACL,uBAAuB,EACvB,aAAa,EACb,iBAAiB,EACjB,yBAAyB,EACzB,aAAa,EACb,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAE,uBAAuB,EAAE,6BAA6B,EAAE,MAAM,4BAA4B,CAAC;AAEpG,qCAAqC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,sBAAsB;AACtB,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAGrD,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAiB9D,uEAAuE;AACvE,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAO9F,gFAAgF;AAChF,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAOvD,gEAAgE;AAChE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,oEAAoE;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAYlD,+CAA+C;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAqB9D,uFAAuF;AACvF,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAI5D,+EAA+E;AAC/E,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAehE,OAAO,EACL,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,EACtB,sBAAsB,EACtB,6BAA6B,EAC7B,aAAa,GACd,MAAM,cAAc,CAAC;AAItB,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAEjF,4FAA4F;AAC5F,mFAAmF;AACnF,EAAE;AACF,kFAAkF;AAClF,mDAAmD;AACnD,oDAAoD;AACpD,+DAA+D;AAC/D,0FAA0F;AAC1F,uDAAuD;AACvD,8CAA8C;AAC9C,qEAAqE;AACrE,gEAAgE;AAChE,EAAE;AACF,wGAAwG;AACxG,sGAAsG;AACtG,sEAAsE;AACtE,uEAAuE"}

package/dist/registry/VersionRegistry.d.ts

@@ -0,0 +1,51 @@
+/**
+ * In-Memory Version Registry Implementation
+ *
+ * This is a simple in-memory implementation of the VersionRegistry interface,
+ * useful for testing and development. For production use, implement a persistent
+ * backend (database, S3, etc.).
+ */
+import type { VersionRegistry, RegisterVersionRequest, GetVersionResponse, VersionIdentifier } from '../types/version-registry';
+/**
+ * In-memory version registry for testing and development
+ */
+export declare class InMemoryVersionRegistry implements VersionRegistry {
+    private versions;
+    /**
+     * Create a unique key for a version
+     */
+    private getKey;
+    /**
+     * Register a new version snapshot
+     */
+    register(request: RegisterVersionRequest): Promise<void>;
+    /**
+     * Get a version snapshot by repository URL and commit SHA
+     */
+    get(repositoryUrl: string, commitSha: string): Promise<GetVersionResponse>;
+    /**
+     * Check if a version exists in the registry
+     */
+    exists(repositoryUrl: string, commitSha: string): Promise<boolean>;
+    /**
+     * Delete a version from the registry
+     */
+    delete(repositoryUrl: string, commitSha: string): Promise<void>;
+    /**
+     * List all versions for a repository
+     */
+    listVersions(repositoryUrl: string): Promise<VersionIdentifier[]>;
+    /**
+     * Clear all versions (for testing)
+     */
+    clear(): void;
+    /**
+     * Get the number of versions in the registry (for testing)
+     */
+    get size(): number;
+}
+/**
+ * Create a new in-memory version registry
+ */
+export declare function createInMemoryVersionRegistry(): InMemoryVersionRegistry;
+//# sourceMappingURL=VersionRegistry.d.ts.map

package/dist/registry/VersionRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/VersionRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,eAAe,EAEf,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAEnC;;GAEG;AACH,qBAAa,uBAAwB,YAAW,eAAe;IAC7D,OAAO,CAAC,QAAQ,CAA2C;IAE3D;;OAEG;IACH,OAAO,CAAC,MAAM;IAId;;OAEG;IACG,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAc9D;;OAEG;IACG,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAiBhF;;OAEG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAKxE;;OAEG;IACG,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKrE;;OAEG;IACG,YAAY,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAevE;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;CACF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,uBAAuB,CAEvE"}

package/dist/registry/VersionRegistry.js

@@ -0,0 +1,100 @@
+/**
+ * In-Memory Version Registry Implementation
+ *
+ * This is a simple in-memory implementation of the VersionRegistry interface,
+ * useful for testing and development. For production use, implement a persistent
+ * backend (database, S3, etc.).
+ */
+/**
+ * In-memory version registry for testing and development
+ */
+export class InMemoryVersionRegistry {
+    constructor() {
+        this.versions = new Map();
+    }
+    /**
+     * Create a unique key for a version
+     */
+    getKey(repositoryUrl, commitSha) {
+        return `${repositoryUrl}@${commitSha}`;
+    }
+    /**
+     * Register a new version snapshot
+     */
+    async register(request) {
+        const key = this.getKey(request.repositoryUrl, request.commitSha);
+        const snapshot = {
+            repositoryUrl: request.repositoryUrl,
+            commitSha: request.commitSha,
+            storyboards: request.storyboards,
+            registeredAt: new Date().toISOString(),
+            metadata: request.metadata,
+        };
+        this.versions.set(key, snapshot);
+    }
+    /**
+     * Get a version snapshot by repository URL and commit SHA
+     */
+    async get(repositoryUrl, commitSha) {
+        const key = this.getKey(repositoryUrl, commitSha);
+        const snapshot = this.versions.get(key);
+        if (!snapshot) {
+            return {
+                found: false,
+                error: `Version not found: ${repositoryUrl}@${commitSha}`,
+            };
+        }
+        return {
+            found: true,
+            snapshot,
+        };
+    }
+    /**
+     * Check if a version exists in the registry
+     */
+    async exists(repositoryUrl, commitSha) {
+        const key = this.getKey(repositoryUrl, commitSha);
+        return this.versions.has(key);
+    }
+    /**
+     * Delete a version from the registry
+     */
+    async delete(repositoryUrl, commitSha) {
+        const key = this.getKey(repositoryUrl, commitSha);
+        this.versions.delete(key);
+    }
+    /**
+     * List all versions for a repository
+     */
+    async listVersions(repositoryUrl) {
+        const versions = [];
+        for (const [key, snapshot] of this.versions.entries()) {
+            if (snapshot.repositoryUrl === repositoryUrl) {
+                versions.push({
+                    repositoryUrl: snapshot.repositoryUrl,
+                    commitSha: snapshot.commitSha,
+                });
+            }
+        }
+        return versions.sort((a, b) => a.commitSha.localeCompare(b.commitSha));
+    }
+    /**
+     * Clear all versions (for testing)
+     */
+    clear() {
+        this.versions.clear();
+    }
+    /**
+     * Get the number of versions in the registry (for testing)
+     */
+    get size() {
+        return this.versions.size;
+    }
+}
+/**
+ * Create a new in-memory version registry
+ */
+export function createInMemoryVersionRegistry() {
+    return new InMemoryVersionRegistry();
+}
+//# sourceMappingURL=VersionRegistry.js.map

package/dist/registry/VersionRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VersionRegistry.js","sourceRoot":"","sources":["../../src/registry/VersionRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH;;GAEG;AACH,MAAM,OAAO,uBAAuB;IAApC;QACU,aAAQ,GAAiC,IAAI,GAAG,EAAE,CAAC;IA6F7D,CAAC;IA3FC;;OAEG;IACK,MAAM,CAAC,aAAqB,EAAE,SAAiB;QACrD,OAAO,GAAG,aAAa,IAAI,SAAS,EAAE,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,QAAQ,CAAC,OAA+B;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QAElE,MAAM,QAAQ,GAAoB;YAChC,aAAa,EAAE,OAAO,CAAC,aAAa;YACpC,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,WAAW,EAAE,OAAO,CAAC,WAAW;YAChC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,GAAG,CAAC,aAAqB,EAAE,SAAiB;QAChD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAExC,IAAI,CAAC,QAAQ,EAAE;YACb,OAAO;gBACL,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,sBAAsB,aAAa,IAAI,SAAS,EAAE;aAC1D,CAAC;SACH;QAED,OAAO;YACL,KAAK,EAAE,IAAI;YACX,QAAQ;SACT,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,aAAqB,EAAE,SAAiB;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM,CAAC,aAAqB,EAAE,SAAiB;QACnD,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,SAAS,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC5B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,aAAqB;QACtC,MAAM,QAAQ,GAAwB,EAAE,CAAC;QAEzC,KAAK,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE;YACrD,IAAI,QAAQ,CAAC,aAAa,KAAK,aAAa,EAAE;gBAC5C,QAAQ,CAAC,IAAI,CAAC;oBACZ,aAAa,EAAE,QAAQ,CAAC,aAAa;oBACrC,SAAS,EAAE,QAAQ,CAAC,SAAS;iBAC9B,CAAC,CAAC;aACJ;SACF;QAED,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;IACzE,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IACxB,CAAC;IAED;;OAEG;IACH,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;IAC5B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,6BAA6B;IAC3C,OAAO,IAAI,uBAAuB,EAAE,CAAC;AACvC,CAAC"}

package/dist/types/version-registry.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Version Registry Types
+ *
+ * Defines the data structures for storing and retrieving versioned storyboard snapshots.
+ * The version registry indexes storyboards by repository URL and commit SHA, allowing
+ * traces to reference the exact workflow definitions that were active at the time of execution.
+ */
+import type { DiscoveredStoryboard } from '../discovery/types';
+/**
+ * Version identifier combining repository URL and commit SHA
+ */
+export interface VersionIdentifier {
+    /** Git repository URL (e.g., "https://github.com/org/repo") */
+    repositoryUrl: string;
+    /** Git commit SHA (full 40-character hash) */
+    commitSha: string;
+}
+/**
+ * Complete snapshot of storyboards at a specific version
+ *
+ * This should be stored in the version registry when a version is built/deployed,
+ * and retrieved when processing traces that reference this version.
+ */
+export interface VersionSnapshot extends VersionIdentifier {
+    /**
+     * Complete storyboard definitions as discovered from the codebase at this version.
+     * Includes all metadata: canvas info, workflow paths, package names, etc.
+     */
+    storyboards: DiscoveredStoryboard[];
+    /** When this version was registered */
+    registeredAt?: string;
+    /** Optional metadata about the build/deployment */
+    metadata?: {
+        /** Build/deployment environment (e.g., "production", "staging") */
+        environment?: string;
+        /** Branch name */
+        branch?: string;
+        /** Git tag if applicable */
+        tag?: string;
+        /** Additional custom metadata */
+        [key: string]: unknown;
+    };
+}
+/**
+ * Request to register a new version in the registry
+ */
+export interface RegisterVersionRequest {
+    /** Repository URL */
+    repositoryUrl: string;
+    /** Commit SHA */
+    commitSha: string;
+    /** Discovered storyboards from this version */
+    storyboards: DiscoveredStoryboard[];
+    /** Optional metadata */
+    metadata?: VersionSnapshot['metadata'];
+}
+/**
+ * Response from querying the version registry
+ */
+export interface GetVersionResponse {
+    /** Whether the version was found */
+    found: boolean;
+    /** Version snapshot if found */
+    snapshot?: VersionSnapshot;
+    /** Error message if not found or error occurred */
+    error?: string;
+}
+/**
+ * Version registry interface
+ *
+ * Implementations might use:
+ * - A database (PostgreSQL, MongoDB, etc.)
+ * - A key-value store (Redis, DynamoDB)
+ * - A file-based registry (S3, local filesystem)
+ * - An in-memory cache for testing
+ */
+export interface VersionRegistry {
+    /**
+     * Register a new version snapshot
+     * @param request - Version registration request
+     * @returns Promise that resolves when registered
+     */
+    register(request: RegisterVersionRequest): Promise<void>;
+    /**
+     * Get a version snapshot by repository URL and commit SHA
+     * @param repositoryUrl - Repository URL
+     * @param commitSha - Commit SHA
+     * @returns Promise with version snapshot if found
+     */
+    get(repositoryUrl: string, commitSha: string): Promise<GetVersionResponse>;
+    /**
+     * Check if a version exists in the registry
+     * @param repositoryUrl - Repository URL
+     * @param commitSha - Commit SHA
+     * @returns Promise with boolean indicating if version exists
+     */
+    exists(repositoryUrl: string, commitSha: string): Promise<boolean>;
+    /**
+     * Delete a version from the registry (for cleanup)
+     * @param repositoryUrl - Repository URL
+     * @param commitSha - Commit SHA
+     * @returns Promise that resolves when deleted
+     */
+    delete?(repositoryUrl: string, commitSha: string): Promise<void>;
+    /**
+     * List all versions for a repository (optional, for debugging/admin)
+     * @param repositoryUrl - Repository URL
+     * @returns Promise with array of version identifiers
+     */
+    listVersions?(repositoryUrl: string): Promise<VersionIdentifier[]>;
+}
+//# sourceMappingURL=version-registry.d.ts.map

package/dist/types/version-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-registry.d.ts","sourceRoot":"","sources":["../../src/types/version-registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD;;;OAGG;IACH,WAAW,EAAE,oBAAoB,EAAE,CAAC;IAEpC,uCAAuC;IACvC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,mDAAmD;IACnD,QAAQ,CAAC,EAAE;QACT,mEAAmE;QACnE,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,4BAA4B;QAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,iCAAiC;QACjC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,wBAAwB;IACxB,QAAQ,CAAC,EAAE,eAAe,CAAC,UAAU,CAAC,CAAC;CACxC;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,oCAAoC;IACpC,KAAK,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,mDAAmD;IACnD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzD;;;;;OAKG;IACH,GAAG,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAE3E;;;;;OAKG;IACH,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEnE;;;;;OAKG;IACH,MAAM,CAAC,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjE;;;;OAIG;IACH,YAAY,CAAC,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAAC;CACpE"}

package/dist/types/version-registry.js

@@ -0,0 +1,9 @@
+/**
+ * Version Registry Types
+ *
+ * Defines the data structures for storing and retrieving versioned storyboard snapshots.
+ * The version registry indexes storyboards by repository URL and commit SHA, allowing
+ * traces to reference the exact workflow definitions that were active at the time of execution.
+ */
+export {};
+//# sourceMappingURL=version-registry.js.map

package/dist/types/version-registry.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/principal-view-core",
-  "version": "0.22.0",
+  "version": "0.22.1",
   "description": "Core logic and types for graph-based principal view framework",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -42,6 +42,7 @@
     "@opentelemetry/sdk-trace-base": "2.2.0",
     "@opentelemetry/semantic-conventions": "1.38.0",
     "@principal-ai/codebase-composition": "^0.2.43",
+    "@principal-ai/principal-view-core": "^0.22.0",
     "@principal-ai/repository-abstraction": "^0.5.3",
     "date-fns": "3.0.0",
     "handlebars": "^4.7.8",

package/src/index.ts

@@ -126,6 +126,16 @@ export {
   isWarnSeverity,
 } from './types/otel';
 
+// Export version registry types and implementation
+export type {
+  VersionIdentifier,
+  VersionSnapshot,
+  RegisterVersionRequest,
+  GetVersionResponse,
+  VersionRegistry,
+} from './types/version-registry';
+export { InMemoryVersionRegistry, createInMemoryVersionRegistry } from './registry/VersionRegistry';
+
 // Export trace aggregation utilities
 export { groupSpansByTrace } from './utils/traceAggregation';
 

package/src/registry/VersionRegistry.test.ts

@@ -0,0 +1,223 @@
+/**
+ * Tests for InMemoryVersionRegistry
+ */
+
+import { describe, it, expect, beforeEach } from 'vitest';
+import { InMemoryVersionRegistry, createInMemoryVersionRegistry } from './VersionRegistry';
+import type { RegisterVersionRequest } from '../types/version-registry';
+
+describe('InMemoryVersionRegistry', () => {
+  let registry: InMemoryVersionRegistry;
+
+  beforeEach(() => {
+    registry = createInMemoryVersionRegistry();
+  });
+
+  describe('register', () => {
+    it('should register a new version', async () => {
+      const request: RegisterVersionRequest = {
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'abc123',
+        storyboards: [
+          {
+            id: 'test-storyboard',
+            name: 'Test Storyboard',
+            path: '.principal-views/test.otel.canvas',
+            basename: 'test',
+            scope: 'root',
+            canvas: {
+              id: 'test',
+              name: 'Test',
+              path: '.principal-views/test.otel.canvas',
+              basename: 'test',
+              type: 'otel',
+              scope: 'root',
+            },
+            workflows: [],
+          },
+        ],
+      };
+
+      await registry.register(request);
+
+      const response = await registry.get('https://github.com/test/repo', 'abc123');
+      expect(response.found).toBe(true);
+      expect(response.snapshot).toBeDefined();
+      expect(response.snapshot?.repositoryUrl).toBe('https://github.com/test/repo');
+      expect(response.snapshot?.commitSha).toBe('abc123');
+      expect(response.snapshot?.storyboards).toHaveLength(1);
+      expect(response.snapshot?.registeredAt).toBeDefined();
+    });
+
+    it('should overwrite existing version with same repository and commit', async () => {
+      const request1: RegisterVersionRequest = {
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'abc123',
+        storyboards: [],
+      };
+
+      const request2: RegisterVersionRequest = {
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'abc123',
+        storyboards: [
+          {
+            id: 'new-storyboard',
+            name: 'New Storyboard',
+            path: '.principal-views/new.otel.canvas',
+            basename: 'new',
+            scope: 'root',
+            canvas: {
+              id: 'new',
+              name: 'New',
+              path: '.principal-views/new.otel.canvas',
+              basename: 'new',
+              type: 'otel',
+              scope: 'root',
+            },
+            workflows: [],
+          },
+        ],
+      };
+
+      await registry.register(request1);
+      await registry.register(request2);
+
+      const response = await registry.get('https://github.com/test/repo', 'abc123');
+      expect(response.found).toBe(true);
+      expect(response.snapshot?.storyboards).toHaveLength(1);
+      expect(response.snapshot?.storyboards[0].id).toBe('new-storyboard');
+    });
+  });
+
+  describe('get', () => {
+    it('should return found=false when version does not exist', async () => {
+      const response = await registry.get('https://github.com/test/repo', 'nonexistent');
+      expect(response.found).toBe(false);
+      expect(response.snapshot).toBeUndefined();
+      expect(response.error).toBeDefined();
+    });
+
+    it('should return found=true when version exists', async () => {
+      const request: RegisterVersionRequest = {
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'abc123',
+        storyboards: [],
+      };
+
+      await registry.register(request);
+
+      const response = await registry.get('https://github.com/test/repo', 'abc123');
+      expect(response.found).toBe(true);
+      expect(response.snapshot).toBeDefined();
+    });
+  });
+
+  describe('exists', () => {
+    it('should return false when version does not exist', async () => {
+      const exists = await registry.exists('https://github.com/test/repo', 'nonexistent');
+      expect(exists).toBe(false);
+    });
+
+    it('should return true when version exists', async () => {
+      const request: RegisterVersionRequest = {
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'abc123',
+        storyboards: [],
+      };
+
+      await registry.register(request);
+
+      const exists = await registry.exists('https://github.com/test/repo', 'abc123');
+      expect(exists).toBe(true);
+    });
+  });
+
+  describe('delete', () => {
+    it('should delete a version', async () => {
+      const request: RegisterVersionRequest = {
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'abc123',
+        storyboards: [],
+      };
+
+      await registry.register(request);
+      expect(await registry.exists('https://github.com/test/repo', 'abc123')).toBe(true);
+
+      await registry.delete('https://github.com/test/repo', 'abc123');
+      expect(await registry.exists('https://github.com/test/repo', 'abc123')).toBe(false);
+    });
+
+    it('should not throw when deleting non-existent version', async () => {
+      await expect(
+        registry.delete('https://github.com/test/repo', 'nonexistent')
+      ).resolves.toBeUndefined();
+    });
+  });
+
+  describe('listVersions', () => {
+    it('should return empty array when no versions exist', async () => {
+      const versions = await registry.listVersions('https://github.com/test/repo');
+      expect(versions).toEqual([]);
+    });
+
+    it('should return all versions for a repository', async () => {
+      await registry.register({
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'abc123',
+        storyboards: [],
+      });
+
+      await registry.register({
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'def456',
+        storyboards: [],
+      });
+
+      await registry.register({
+        repositoryUrl: 'https://github.com/other/repo',
+        commitSha: 'xyz789',
+        storyboards: [],
+      });
+
+      const versions = await registry.listVersions('https://github.com/test/repo');
+      expect(versions).toHaveLength(2);
+      expect(versions[0].commitSha).toBe('abc123');
+      expect(versions[1].commitSha).toBe('def456');
+    });
+
+    it('should return sorted versions', async () => {
+      await registry.register({
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'zzz',
+        storyboards: [],
+      });
+
+      await registry.register({
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'aaa',
+        storyboards: [],
+      });
+
+      const versions = await registry.listVersions('https://github.com/test/repo');
+      expect(versions[0].commitSha).toBe('aaa');
+      expect(versions[1].commitSha).toBe('zzz');
+    });
+  });
+
+  describe('clear', () => {
+    it('should clear all versions', async () => {
+      await registry.register({
+        repositoryUrl: 'https://github.com/test/repo',
+        commitSha: 'abc123',
+        storyboards: [],
+      });
+
+      expect(registry.size).toBe(1);
+
+      registry.clear();
+
+      expect(registry.size).toBe(0);
+      expect(await registry.exists('https://github.com/test/repo', 'abc123')).toBe(false);
+    });
+  });
+});

package/src/registry/VersionRegistry.ts

@@ -0,0 +1,121 @@
+/**
+ * In-Memory Version Registry Implementation
+ *
+ * This is a simple in-memory implementation of the VersionRegistry interface,
+ * useful for testing and development. For production use, implement a persistent
+ * backend (database, S3, etc.).
+ */
+
+import type {
+  VersionRegistry,
+  VersionSnapshot,
+  RegisterVersionRequest,
+  GetVersionResponse,
+  VersionIdentifier,
+} from '../types/version-registry';
+
+/**
+ * In-memory version registry for testing and development
+ */
+export class InMemoryVersionRegistry implements VersionRegistry {
+  private versions: Map<string, VersionSnapshot> = new Map();
+
+  /**
+   * Create a unique key for a version
+   */
+  private getKey(repositoryUrl: string, commitSha: string): string {
+    return `${repositoryUrl}@${commitSha}`;
+  }
+
+  /**
+   * Register a new version snapshot
+   */
+  async register(request: RegisterVersionRequest): Promise<void> {
+    const key = this.getKey(request.repositoryUrl, request.commitSha);
+
+    const snapshot: VersionSnapshot = {
+      repositoryUrl: request.repositoryUrl,
+      commitSha: request.commitSha,
+      storyboards: request.storyboards,
+      registeredAt: new Date().toISOString(),
+      metadata: request.metadata,
+    };
+
+    this.versions.set(key, snapshot);
+  }
+
+  /**
+   * Get a version snapshot by repository URL and commit SHA
+   */
+  async get(repositoryUrl: string, commitSha: string): Promise<GetVersionResponse> {
+    const key = this.getKey(repositoryUrl, commitSha);
+    const snapshot = this.versions.get(key);
+
+    if (!snapshot) {
+      return {
+        found: false,
+        error: `Version not found: ${repositoryUrl}@${commitSha}`,
+      };
+    }
+
+    return {
+      found: true,
+      snapshot,
+    };
+  }
+
+  /**
+   * Check if a version exists in the registry
+   */
+  async exists(repositoryUrl: string, commitSha: string): Promise<boolean> {
+    const key = this.getKey(repositoryUrl, commitSha);
+    return this.versions.has(key);
+  }
+
+  /**
+   * Delete a version from the registry
+   */
+  async delete(repositoryUrl: string, commitSha: string): Promise<void> {
+    const key = this.getKey(repositoryUrl, commitSha);
+    this.versions.delete(key);
+  }
+
+  /**
+   * List all versions for a repository
+   */
+  async listVersions(repositoryUrl: string): Promise<VersionIdentifier[]> {
+    const versions: VersionIdentifier[] = [];
+
+    for (const [key, snapshot] of this.versions.entries()) {
+      if (snapshot.repositoryUrl === repositoryUrl) {
+        versions.push({
+          repositoryUrl: snapshot.repositoryUrl,
+          commitSha: snapshot.commitSha,
+        });
+      }
+    }
+
+    return versions.sort((a, b) => a.commitSha.localeCompare(b.commitSha));
+  }
+
+  /**
+   * Clear all versions (for testing)
+   */
+  clear(): void {
+    this.versions.clear();
+  }
+
+  /**
+   * Get the number of versions in the registry (for testing)
+   */
+  get size(): number {
+    return this.versions.size;
+  }
+}
+
+/**
+ * Create a new in-memory version registry
+ */
+export function createInMemoryVersionRegistry(): InMemoryVersionRegistry {
+  return new InMemoryVersionRegistry();
+}

package/src/types/version-registry.ts

@@ -0,0 +1,123 @@
+/**
+ * Version Registry Types
+ *
+ * Defines the data structures for storing and retrieving versioned storyboard snapshots.
+ * The version registry indexes storyboards by repository URL and commit SHA, allowing
+ * traces to reference the exact workflow definitions that were active at the time of execution.
+ */
+
+import type { DiscoveredStoryboard } from '../discovery/types';
+
+/**
+ * Version identifier combining repository URL and commit SHA
+ */
+export interface VersionIdentifier {
+  /** Git repository URL (e.g., "https://github.com/org/repo") */
+  repositoryUrl: string;
+  /** Git commit SHA (full 40-character hash) */
+  commitSha: string;
+}
+
+/**
+ * Complete snapshot of storyboards at a specific version
+ *
+ * This should be stored in the version registry when a version is built/deployed,
+ * and retrieved when processing traces that reference this version.
+ */
+export interface VersionSnapshot extends VersionIdentifier {
+  /**
+   * Complete storyboard definitions as discovered from the codebase at this version.
+   * Includes all metadata: canvas info, workflow paths, package names, etc.
+   */
+  storyboards: DiscoveredStoryboard[];
+
+  /** When this version was registered */
+  registeredAt?: string;
+
+  /** Optional metadata about the build/deployment */
+  metadata?: {
+    /** Build/deployment environment (e.g., "production", "staging") */
+    environment?: string;
+    /** Branch name */
+    branch?: string;
+    /** Git tag if applicable */
+    tag?: string;
+    /** Additional custom metadata */
+    [key: string]: unknown;
+  };
+}
+
+/**
+ * Request to register a new version in the registry
+ */
+export interface RegisterVersionRequest {
+  /** Repository URL */
+  repositoryUrl: string;
+  /** Commit SHA */
+  commitSha: string;
+  /** Discovered storyboards from this version */
+  storyboards: DiscoveredStoryboard[];
+  /** Optional metadata */
+  metadata?: VersionSnapshot['metadata'];
+}
+
+/**
+ * Response from querying the version registry
+ */
+export interface GetVersionResponse {
+  /** Whether the version was found */
+  found: boolean;
+  /** Version snapshot if found */
+  snapshot?: VersionSnapshot;
+  /** Error message if not found or error occurred */
+  error?: string;
+}
+
+/**
+ * Version registry interface
+ *
+ * Implementations might use:
+ * - A database (PostgreSQL, MongoDB, etc.)
+ * - A key-value store (Redis, DynamoDB)
+ * - A file-based registry (S3, local filesystem)
+ * - An in-memory cache for testing
+ */
+export interface VersionRegistry {
+  /**
+   * Register a new version snapshot
+   * @param request - Version registration request
+   * @returns Promise that resolves when registered
+   */
+  register(request: RegisterVersionRequest): Promise<void>;
+
+  /**
+   * Get a version snapshot by repository URL and commit SHA
+   * @param repositoryUrl - Repository URL
+   * @param commitSha - Commit SHA
+   * @returns Promise with version snapshot if found
+   */
+  get(repositoryUrl: string, commitSha: string): Promise<GetVersionResponse>;
+
+  /**
+   * Check if a version exists in the registry
+   * @param repositoryUrl - Repository URL
+   * @param commitSha - Commit SHA
+   * @returns Promise with boolean indicating if version exists
+   */
+  exists(repositoryUrl: string, commitSha: string): Promise<boolean>;
+
+  /**
+   * Delete a version from the registry (for cleanup)
+   * @param repositoryUrl - Repository URL
+   * @param commitSha - Commit SHA
+   * @returns Promise that resolves when deleted
+   */
+  delete?(repositoryUrl: string, commitSha: string): Promise<void>;
+
+  /**
+   * List all versions for a repository (optional, for debugging/admin)
+   * @param repositoryUrl - Repository URL
+   * @returns Promise with array of version identifiers
+   */
+  listVersions?(repositoryUrl: string): Promise<VersionIdentifier[]>;
+}