@principal-ai/subsystems-core 0.29.0

package/dist/registry/LocalRegistry.js

@@ -0,0 +1,335 @@
+"use strict";
+/**
+ * LocalRegistry - Browser-safe registry for local workspaces
+ *
+ * Features:
+ * - Uses FileTree abstraction (browser-safe)
+ * - No version registry lookups (uses FileTree directly)
+ * - Cache invalidation via external triggers
+ * - Supports multiple registered workspaces
+ * - Auto-discovers scope names from library.yaml resources
+ *
+ * Note: File watching must be handled externally by calling invalidateCache()
+ * when .principal-views files change.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalRegistry = void 0;
+const CanvasDiscovery_1 = require("../discovery/CanvasDiscovery");
+const LibraryDiscovery_1 = require("../discovery/LibraryDiscovery");
+/**
+ * Local registry for development mode
+ */
+class LocalRegistry {
+    constructor(fileReader, fsAdapter) {
+        this.fileReader = fileReader;
+        this.cache = new Map();
+        this.workspaces = new Map(); // workspaceId → registration
+        this.scopeToWorkspaceId = new Map(); // scopeName → workspaceId
+        this.libraryDiscovery = null;
+        this.discovery = new CanvasDiscovery_1.CanvasDiscovery();
+        if (fsAdapter) {
+            this.libraryDiscovery = new LibraryDiscovery_1.LibraryDiscovery(fsAdapter);
+        }
+    }
+    /**
+     * Register a local workspace
+     *
+     * Auto-discovers service names and owned scopes from library.yaml resources section.
+     * Each service in resources with a service.name becomes a registered scope.
+     * Additionally, owned-scopes from each service are mapped to their owning service.
+     *
+     * File watching should be handled externally. When .principal-views files change,
+     * call invalidateCache(scopeName) to rebuild the snapshot.
+     *
+     * @param fileTree - FileTree for the workspace
+     * @returns Array of all registered scope names (services + owned scopes)
+     */
+    async registerWorkspace(fileTree) {
+        // Use stable identifier: rootPath (repository path) or sha (content hash)
+        // Note: metadata.id includes a timestamp suffix making it unique per build,
+        // which would cause duplicate registrations on every file tree update
+        const workspaceId = fileTree.metadata.sourceInfo?.rootPath || fileTree.sha || fileTree.metadata.id;
+        // Check if already registered
+        if (this.workspaces.has(workspaceId)) {
+            const existing = this.workspaces.get(workspaceId);
+            const currentSha = fileTree.sha || '';
+            // Check if fileTree content changed (different SHA)
+            if (existing.fileTreeSha !== currentSha) {
+                console.log('[LocalRegistry] Workspace content changed, re-discovering scopes:', {
+                    workspaceId,
+                    oldSha: existing.fileTreeSha,
+                    newSha: currentSha,
+                });
+                // Re-discover scope names from updated library.yaml
+                const { serviceNames, ownedScopes, scopeToServiceMap } = await this.discoverScopesInfo(fileTree);
+                // Clear old scope mappings
+                for (const scopeName of [...existing.serviceNames, ...existing.ownedScopes]) {
+                    this.scopeToWorkspaceId.delete(scopeName);
+                }
+                // Update registration with new scope info
+                existing.fileTree = fileTree;
+                existing.fileTreeSha = currentSha;
+                existing.serviceNames = serviceNames;
+                existing.ownedScopes = ownedScopes;
+                // Update scope-to-workspace mapping with new scopes
+                for (const [scopeName] of scopeToServiceMap) {
+                    this.scopeToWorkspaceId.set(scopeName, workspaceId);
+                }
+                console.log('[LocalRegistry] Updated workspace registration:', {
+                    workspaceId,
+                    serviceNames,
+                    ownedScopes,
+                    fileTreeSha: currentSha,
+                });
+                return [...new Set([...serviceNames, ...ownedScopes])];
+            }
+            console.log('[LocalRegistry] Workspace already registered (no changes):', workspaceId);
+            // Update the fileTree reference to the latest version
+            existing.fileTree = fileTree;
+            return [...new Set([...existing.serviceNames, ...existing.ownedScopes])];
+        }
+        // Auto-discover service names and owned scopes from library.yaml
+        const { serviceNames, ownedScopes, scopeToServiceMap } = await this.discoverScopesInfo(fileTree);
+        if (serviceNames.length === 0) {
+            console.warn('[LocalRegistry] No service names discovered for workspace:', workspaceId);
+            console.warn('[LocalRegistry] Make sure library.yaml has a resources section with service.name attributes');
+        }
+        // Register workspace
+        this.workspaces.set(workspaceId, {
+            workspaceId,
+            fileTree,
+            fileTreeSha: fileTree.sha || '',
+            serviceNames,
+            ownedScopes,
+        });
+        // Map all scope names (services + owned scopes) to this workspace
+        for (const [scopeName] of scopeToServiceMap) {
+            this.scopeToWorkspaceId.set(scopeName, workspaceId);
+        }
+        console.log('[LocalRegistry] Registered workspace:', {
+            workspaceId,
+            serviceNames,
+            ownedScopes,
+            fileTreeSha: fileTree.sha,
+        });
+        return [...new Set([...serviceNames, ...ownedScopes])];
+    }
+    /**
+     * Unregister a workspace (cleanup)
+     * @param workspaceId - Workspace ID (rootPath, sha, or metadata.id)
+     */
+    unregisterWorkspace(workspaceId) {
+        const workspace = this.workspaces.get(workspaceId);
+        if (!workspace) {
+            return;
+        }
+        // Clear cache for all scope names (services + owned scopes)
+        const allScopes = [...workspace.serviceNames, ...workspace.ownedScopes];
+        for (const scopeName of allScopes) {
+            this.cache.delete(scopeName);
+            this.scopeToWorkspaceId.delete(scopeName);
+        }
+        // Remove registration
+        this.workspaces.delete(workspaceId);
+        console.log('[LocalRegistry] Unregistered workspace:', {
+            workspaceId,
+            serviceNames: workspace.serviceNames,
+            ownedScopes: workspace.ownedScopes,
+        });
+    }
+    async lookupByScope(scope, _resource) {
+        // Map scope name to workspace ID
+        const workspaceId = this.scopeToWorkspaceId.get(scope.name);
+        if (!workspaceId) {
+            console.log('[LocalRegistry] No workspace registered for scope:', scope.name);
+            return { found: false, reason: 'scope_not_owned', scopeName: scope.name };
+        }
+        const workspace = this.workspaces.get(workspaceId);
+        if (!workspace) {
+            console.error('[LocalRegistry] Workspace not found:', workspaceId);
+            return { found: false, reason: 'scope_not_owned', scopeName: scope.name };
+        }
+        // Check cache first (cache by scope name for granularity)
+        const cacheKey = scope.name;
+        if (this.cache.has(cacheKey)) {
+            const cachedSnapshot = this.cache.get(cacheKey);
+            if (cachedSnapshot.storyboards.length === 0) {
+                return { found: false, reason: 'no_storyboards', scopeName: scope.name };
+            }
+            return { found: true, snapshot: cachedSnapshot };
+        }
+        // Build VersionSnapshot from FileTree
+        const snapshot = await this.buildFromFileTree(workspace.fileTree);
+        // Cache it
+        this.cache.set(cacheKey, snapshot);
+        // Check if storyboards were found
+        if (snapshot.storyboards.length === 0) {
+            return { found: false, reason: 'no_storyboards', scopeName: scope.name };
+        }
+        return { found: true, snapshot };
+    }
+    /**
+     * Auto-discover service names and owned scopes from library.yaml files
+     *
+     * Uses LibraryDiscovery to find all library.yaml files across packages
+     * and extract service.name and owned-scopes from their resources sections.
+     *
+     * @param fileTree - FileTree to discover scopes from
+     * @returns Object with serviceNames, ownedScopes, and scopeToServiceMap
+     */
+    async discoverScopesInfo(fileTree) {
+        if (!this.libraryDiscovery) {
+            console.warn('[LocalRegistry] No LibraryDiscovery available - provide FileSystemAdapter to constructor');
+            return { serviceNames: [], ownedScopes: [], scopeToServiceMap: new Map() };
+        }
+        try {
+            const result = await this.libraryDiscovery.discover(fileTree, {
+                fileReader: this.fileReader,
+            });
+            if (result.errors.length > 0) {
+                console.warn('[LocalRegistry] Errors during library discovery:', result.errors);
+            }
+            // Collect all owned scopes across all services (deduplicated)
+            const ownedScopesSet = new Set();
+            for (const lib of result.libraries) {
+                for (const service of lib.servicesWithScopes) {
+                    for (const scope of service.ownedScopes) {
+                        ownedScopesSet.add(scope);
+                    }
+                }
+            }
+            const ownedScopes = [...ownedScopesSet];
+            console.log('[LocalRegistry] Discovered services and scopes:', {
+                serviceNames: result.allServiceNames,
+                ownedScopes,
+                scopeToServiceMapSize: result.scopeToServiceMap.size,
+            });
+            return {
+                serviceNames: result.allServiceNames,
+                ownedScopes,
+                scopeToServiceMap: result.scopeToServiceMap,
+            };
+        }
+        catch (error) {
+            console.error('[LocalRegistry] Failed to discover scopes:', error);
+            return { serviceNames: [], ownedScopes: [], scopeToServiceMap: new Map() };
+        }
+    }
+    /**
+     * Build VersionSnapshot from FileTree using CanvasDiscovery
+     */
+    async buildFromFileTree(fileTree) {
+        // Use CanvasDiscovery to find all storyboards
+        const discoveryResult = await this.discovery.discover(fileTree, {
+            fileReader: this.fileReader,
+            includeContent: true,
+        });
+        const snapshot = {
+            repositoryUrl: 'local',
+            commitSha: fileTree.sha || 'dev',
+            storyboards: discoveryResult.storyboards,
+            registeredAt: new Date().toISOString(),
+            metadata: {
+                environment: 'development',
+                isLocal: true,
+            },
+        };
+        // Log errors if any
+        if (discoveryResult.errors.length > 0) {
+            console.warn('[LocalRegistry] Discovery errors:', discoveryResult.errors);
+        }
+        return snapshot;
+    }
+    /**
+     * Invalidate cache for a scope
+     *
+     * Call this when .principal-views files change to trigger rebuild on next lookup.
+     * Debouncing should be handled by external file watcher if needed.
+     */
+    invalidateCache(scopeName) {
+        this.cache.delete(scopeName);
+        console.log('[LocalRegistry] Cache invalidated:', scopeName);
+    }
+    async listScopes() {
+        const scopes = [];
+        for (const workspace of this.workspaces.values()) {
+            // Include service names and owned scopes
+            const allScopes = [...workspace.serviceNames, ...workspace.ownedScopes];
+            for (const scopeName of allScopes) {
+                scopes.push({
+                    name: scopeName,
+                    versions: ['dev'], // Local workspaces always use 'dev' version
+                });
+            }
+        }
+        return scopes;
+    }
+    supportsHotReload() {
+        return true;
+    }
+    /**
+     * Get list of registered workspaces
+     */
+    getRegisteredWorkspaces() {
+        const workspaces = [];
+        for (const workspace of this.workspaces.values()) {
+            // Include service names and owned scopes
+            const allScopes = [...workspace.serviceNames, ...workspace.ownedScopes];
+            for (const scopeName of allScopes) {
+                workspaces.push({
+                    scopeName,
+                    fileTreeSha: workspace.fileTree.sha || 'unknown',
+                });
+            }
+        }
+        return workspaces;
+    }
+    /**
+     * Get all cached VersionSnapshots
+     *
+     * Returns snapshots that have been built and cached via lookupByScope().
+     * Note: This only returns snapshots that have been looked up at least once.
+     * Call lookupByScope() for each scope to ensure all snapshots are cached.
+     */
+    getAllSnapshots() {
+        return Array.from(this.cache.values());
+    }
+    /**
+     * Get all snapshots for all registered scopes
+     *
+     * Unlike getAllSnapshots(), this method ensures all registered scopes
+     * have their snapshots built and cached before returning.
+     * Note: Returns one snapshot per workspace (not per scope).
+     */
+    async getAllSnapshotsForRegisteredScopes() {
+        const snapshots = [];
+        const seenWorkspaceIds = new Set();
+        for (const workspace of this.workspaces.values()) {
+            // Only build one snapshot per workspace
+            if (seenWorkspaceIds.has(workspace.workspaceId))
+                continue;
+            seenWorkspaceIds.add(workspace.workspaceId);
+            // Use first service name to trigger snapshot build
+            const firstServiceName = workspace.serviceNames[0];
+            if (firstServiceName) {
+                const result = await this.lookupByScope({ name: firstServiceName, version: 'dev' }, {});
+                if (result.found) {
+                    snapshots.push(result.snapshot);
+                }
+            }
+        }
+        return snapshots;
+    }
+    /**
+     * Cleanup: clear all state
+     */
+    destroy() {
+        console.log('[LocalRegistry] Destroying and clearing state...');
+        // Clear state
+        this.workspaces.clear();
+        this.cache.clear();
+        this.discovery.clearCache();
+    }
+}
+exports.LocalRegistry = LocalRegistry;
+//# sourceMappingURL=LocalRegistry.js.map

package/dist/registry/LocalRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalRegistry.js","sourceRoot":"","sources":["../../src/registry/LocalRegistry.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAKH,kEAA+D;AAC/D,oEAAiE;AAkBjE;;GAEG;AACH,MAAa,aAAa;IAOxB,YACU,UAAsB,EAC9B,SAA6B;QADrB,eAAU,GAAV,UAAU,CAAY;QAPxB,UAAK,GAAG,IAAI,GAAG,EAA2B,CAAC;QAC3C,eAAU,GAAG,IAAI,GAAG,EAAiC,CAAC,CAAC,6BAA6B;QACpF,uBAAkB,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,0BAA0B;QAE1E,qBAAgB,GAA4B,IAAI,CAAC;QAMvD,IAAI,CAAC,SAAS,GAAG,IAAI,iCAAe,EAAE,CAAC;QACvC,IAAI,SAAS,EAAE;YACb,IAAI,CAAC,gBAAgB,GAAG,IAAI,mCAAgB,CAAC,SAAS,CAAC,CAAC;SACzD;IACH,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,KAAK,CAAC,iBAAiB,CAAC,QAAkB;QACxC,0EAA0E;QAC1E,4EAA4E;QAC5E,sEAAsE;QACtE,MAAM,WAAW,GACd,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAmB,IAAI,QAAQ,CAAC,GAAG,IAAI,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAE7F,8BAA8B;QAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;YACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAE,CAAC;YACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,IAAI,EAAE,CAAC;YAEtC,oDAAoD;YACpD,IAAI,QAAQ,CAAC,WAAW,KAAK,UAAU,EAAE;gBACvC,OAAO,CAAC,GAAG,CAAC,mEAAmE,EAAE;oBAC/E,WAAW;oBACX,MAAM,EAAE,QAAQ,CAAC,WAAW;oBAC5B,MAAM,EAAE,UAAU;iBACnB,CAAC,CAAC;gBAEH,oDAAoD;gBACpD,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;gBAEjG,2BAA2B;gBAC3B,KAAK,MAAM,SAAS,IAAI,CAAC,GAAG,QAAQ,CAAC,YAAY,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC,EAAE;oBAC3E,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;iBAC3C;gBAED,0CAA0C;gBAC1C,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;gBAC7B,QAAQ,CAAC,WAAW,GAAG,UAAU,CAAC;gBAClC,QAAQ,CAAC,YAAY,GAAG,YAAY,CAAC;gBACrC,QAAQ,CAAC,WAAW,GAAG,WAAW,CAAC;gBAEnC,oDAAoD;gBACpD,KAAK,MAAM,CAAC,SAAS,CAAC,IAAI,iBAAiB,EAAE;oBAC3C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;iBACrD;gBAED,OAAO,CAAC,GAAG,CAAC,iDAAiD,EAAE;oBAC7D,WAAW;oBACX,YAAY;oBACZ,WAAW;oBACX,WAAW,EAAE,UAAU;iBACxB,CAAC,CAAC;gBAEH,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;aACxD;YAED,OAAO,CAAC,GAAG,CAAC,4DAA4D,EAAE,WAAW,CAAC,CAAC;YACvF,sDAAsD;YACtD,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC;YAC7B,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,YAAY,EAAE,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;SAC1E;QAED,iEAAiE;QACjE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,iBAAiB,EAAE,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAEjG,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE;YAC7B,OAAO,CAAC,IAAI,CAAC,4DAA4D,EAAE,WAAW,CAAC,CAAC;YACxF,OAAO,CAAC,IAAI,CAAC,6FAA6F,CAAC,CAAC;SAC7G;QAED,qBAAqB;QACrB,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,EAAE;YAC/B,WAAW;YACX,QAAQ;YACR,WAAW,EAAE,QAAQ,CAAC,GAAG,IAAI,EAAE;YAC/B,YAAY;YACZ,WAAW;SACZ,CAAC,CAAC;QAEH,kEAAkE;QAClE,KAAK,MAAM,CAAC,SAAS,CAAC,IAAI,iBAAiB,EAAE;YAC3C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;SACrD;QAED,OAAO,CAAC,GAAG,CAAC,uCAAuC,EAAE;YACnD,WAAW;YACX,YAAY;YACZ,WAAW;YACX,WAAW,EAAE,QAAQ,CAAC,GAAG;SAC1B,CAAC,CAAC;QAEH,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,YAAY,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;;OAGG;IACH,mBAAmB,CAAC,WAAmB;QACrC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,EAAE;YACd,OAAO;SACR;QAED,4DAA4D;QAC5D,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,YAAY,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACxE,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC7B,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;SAC3C;QAED,sBAAsB;QACtB,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAEpC,OAAO,CAAC,GAAG,CAAC,yCAAyC,EAAE;YACrD,WAAW;YACX,YAAY,EAAE,SAAS,CAAC,YAAY;YACpC,WAAW,EAAE,SAAS,CAAC,WAAW;SACnC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,aAAa,CACjB,KAAwC,EACxC,SAAmD;QAEnD,iCAAiC;QACjC,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,WAAW,EAAE;YAChB,OAAO,CAAC,GAAG,CAAC,oDAAoD,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9E,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC3E;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,EAAE;YACd,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,WAAW,CAAC,CAAC;YACnE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC3E;QAED,0DAA0D;QAC1D,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC;QAC5B,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;YAC5B,MAAM,cAAc,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAE,CAAC;YACjD,IAAI,cAAc,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;gBAC3C,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;aAC1E;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC;SAClD;QAED,sCAAsC;QACtC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,iBAAiB,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAElE,WAAW;QACX,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAEnC,kCAAkC;QAClC,IAAI,QAAQ,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE;YACrC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC1E;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACnC,CAAC;IAED;;;;;;;;OAQG;IACK,KAAK,CAAC,kBAAkB,CAAC,QAAkB;QAKjD,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC1B,OAAO,CAAC,IAAI,CAAC,0FAA0F,CAAC,CAAC;YACzG,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;SAC5E;QAED,IAAI;YACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE;gBAC5D,UAAU,EAAE,IAAI,CAAC,UAAU;aAC5B,CAAC,CAAC;YAEH,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;gBAC5B,OAAO,CAAC,IAAI,CAAC,kDAAkD,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;aACjF;YAED,8DAA8D;YAC9D,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;YACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE;gBAClC,KAAK,MAAM,OAAO,IAAI,GAAG,CAAC,kBAAkB,EAAE;oBAC5C,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,WAAW,EAAE;wBACvC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;qBAC3B;iBACF;aACF;YACD,MAAM,WAAW,GAAG,CAAC,GAAG,cAAc,CAAC,CAAC;YAExC,OAAO,CAAC,GAAG,CAAC,iDAAiD,EAAE;gBAC7D,YAAY,EAAE,MAAM,CAAC,eAAe;gBACpC,WAAW;gBACX,qBAAqB,EAAE,MAAM,CAAC,iBAAiB,CAAC,IAAI;aACrD,CAAC,CAAC;YAEH,OAAO;gBACL,YAAY,EAAE,MAAM,CAAC,eAAe;gBACpC,WAAW;gBACX,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;aAC5C,CAAC;SACH;QAAC,OAAO,KAAK,EAAE;YACd,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,KAAK,CAAC,CAAC;YACnE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,iBAAiB,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;SAC5E;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,iBAAiB,CAAC,QAAkB;QAChD,8CAA8C;QAC9C,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE;YAC9D,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,cAAc,EAAE,IAAI;SACrB,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAoB;YAChC,aAAa,EAAE,OAAO;YACtB,SAAS,EAAE,QAAQ,CAAC,GAAG,IAAI,KAAK;YAChC,WAAW,EAAE,eAAe,CAAC,WAAW;YACxC,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACtC,QAAQ,EAAE;gBACR,WAAW,EAAE,aAAa;gBAC1B,OAAO,EAAE,IAAI;aACd;SACF,CAAC;QAEF,oBAAoB;QACpB,IAAI,eAAe,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE;YACrC,OAAO,CAAC,IAAI,CAAC,mCAAmC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;SAC3E;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,eAAe,CAAC,SAAiB;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,MAAM,GAAgD,EAAE,CAAC;QAE/D,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YAChD,yCAAyC;YACzC,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,YAAY,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YACxE,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE;gBACjC,MAAM,CAAC,IAAI,CAAC;oBACV,IAAI,EAAE,SAAS;oBACf,QAAQ,EAAE,CAAC,KAAK,CAAC,EAAE,4CAA4C;iBAChE,CAAC,CAAC;aACJ;SACF;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,iBAAiB;QACf,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,uBAAuB;QACrB,MAAM,UAAU,GAAsD,EAAE,CAAC;QAEzE,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YAChD,yCAAyC;YACzC,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,YAAY,EAAE,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;YACxE,KAAK,MAAM,SAAS,IAAI,SAAS,EAAE;gBACjC,UAAU,CAAC,IAAI,CAAC;oBACd,SAAS;oBACT,WAAW,EAAE,SAAS,CAAC,QAAQ,CAAC,GAAG,IAAI,SAAS;iBACjD,CAAC,CAAC;aACJ;SACF;QAED,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;;;;;OAMG;IACH,eAAe;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,kCAAkC;QACtC,MAAM,SAAS,GAAsB,EAAE,CAAC;QACxC,MAAM,gBAAgB,GAAG,IAAI,GAAG,EAAU,CAAC;QAE3C,KAAK,MAAM,SAAS,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,EAAE;YAChD,wCAAwC;YACxC,IAAI,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC;gBAAE,SAAS;YAC1D,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;YAE5C,mDAAmD;YACnD,MAAM,gBAAgB,GAAG,SAAS,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;YACnD,IAAI,gBAAgB,EAAE;gBACpB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,aAAa,CACrC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,KAAK,EAAE,EAC1C,EAAE,CACH,CAAC;gBACF,IAAI,MAAM,CAAC,KAAK,EAAE;oBAChB,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;iBACjC;aACF;SACF;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,OAAO;QACL,OAAO,CAAC,GAAG,CAAC,kDAAkD,CAAC,CAAC;QAEhE,cAAc;QACd,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACxB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,CAAC;IAC9B,CAAC;CACF;AAxXD,sCAwXC"}

package/dist/registry/RemoteRegistry.d.ts

@@ -0,0 +1,122 @@
+/**
+ * RemoteRegistry - Calls web-ade API for published libraries
+ *
+ * Features:
+ * - HTTP caching (immutable schematics)
+ * - Handles PURL lookups (published libraries)
+ * - Handles customerId + serviceName lookups (services)
+ * - Version → commit hash resolution
+ */
+import type { StoryboardRegistryInterface, ScopeLookupResult } from '../types/registered-trace';
+import type { VersionSnapshot } from '../types/version-registry';
+/**
+ * Remote registry implementation
+ */
+export declare class RemoteRegistry implements StoryboardRegistryInterface {
+    private apiBaseUrl;
+    private cache;
+    private scopeToSnapshotKey;
+    private cacheTTL;
+    constructor(apiBaseUrl: string, cacheTTL?: number);
+    lookupByScope(scope: {
+        name: string;
+        version: string;
+    }, resource: {
+        attributes?: Record<string, unknown>;
+    }): Promise<ScopeLookupResult>;
+    /**
+     * Lookup published library by PURL
+     */
+    private lookupLibrary;
+    /**
+     * Lookup service by customerId + serviceName
+     */
+    private lookupService;
+    /**
+     * Lookup version mapping (version string → commit hash)
+     */
+    private lookupVersionMapping;
+    /**
+     * Fetch schematic by repository URL and commit SHA
+     */
+    private fetchSchematic;
+    /**
+     * Parse PURL string into components
+     *
+     * Format: pkg:ecosystem/namespace/name
+     * Examples:
+     *   pkg:npm/@acme/auth-library
+     *   pkg:pypi/acme-auth-library
+     *   pkg:maven/com.acme/auth-library
+     *   pkg:golang/github.com/acme/auth-lib
+     */
+    private parsePURL;
+    /**
+     * Get repository URL from package registry metadata
+     *
+     * This queries the package registry (npm, pypi, etc.) to get the repository URL.
+     */
+    private getPackageRepository;
+    /**
+     * Get repository URL from npm registry
+     */
+    private getNpmRepository;
+    /**
+     * Get repository URL from PyPI
+     */
+    private getPypiRepository;
+    listScopes(): Promise<Array<{
+        name: string;
+        versions: string[];
+    }>>;
+    supportsHotReload(): boolean;
+    /**
+     * Register a schematic directly (for preloading)
+     *
+     * This is similar to LocalRegistry's registerWorkspace() - it allows you to
+     * preload schematics before traces arrive, so the owned-scopes mapping is
+     * already populated when lookupByScope is called.
+     *
+     * @param snapshot - The VersionSnapshot to register
+     * @returns Array of registered scope names (from owned-scopes)
+     *
+     * @example
+     * ```typescript
+     * // Fetch schematic from your API
+     * const response = await fetch('/api/schematics/my-panel');
+     * const snapshot = await response.json();
+     *
+     * // Register it with RemoteRegistry
+     * const scopes = registry.registerSchematic(snapshot);
+     * console.log('Registered scopes:', scopes);
+     * // Now traces with these scopes will match this schematic's storyboards
+     * ```
+     */
+    registerSchematic(snapshot: VersionSnapshot): string[];
+    /**
+     * Register owned scopes from a schematic's resources
+     *
+     * This builds a mapping from instrumentation scope names to their owning
+     * schematic cache key. When a trace comes in with a scope listed in
+     * `owned-scopes`, we can route it to the correct storyboards without
+     * needing a separate lookup.
+     */
+    private registerOwnedScopes;
+    /**
+     * Extract all owned scopes from resources (for logging)
+     */
+    private getOwnedScopesFromResources;
+    /**
+     * Clear the cache (useful for testing)
+     */
+    clearCache(): void;
+    /**
+     * Get cache statistics
+     */
+    getCacheStats(): {
+        size: number;
+        ttl: number;
+        ownedScopesCount: number;
+    };
+}
+//# sourceMappingURL=RemoteRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RemoteRegistry.d.ts","sourceRoot":"","sources":["../../src/registry/RemoteRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAChG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAsCjE;;GAEG;AACH,qBAAa,cAAe,YAAW,2BAA2B;IAM9D,OAAO,CAAC,UAAU;IALpB,OAAO,CAAC,KAAK,CAAiC;IAC9C,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAS;gBAGf,UAAU,EAAE,MAAM,EAC1B,QAAQ,GAAE,MAAuB;IAK7B,aAAa,CACjB,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EACxC,QAAQ,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GACjD,OAAO,CAAC,iBAAiB,CAAC;IAmD7B;;OAEG;YACW,aAAa;IA8B3B;;OAEG;YACW,aAAa;IAkC3B;;OAEG;YACW,oBAAoB;IAkClC;;OAEG;YACW,cAAc;IAoD5B;;;;;;;;;OASG;IACH,OAAO,CAAC,SAAS;IA2BjB;;;;OAIG;YACW,oBAAoB;IAiBlC;;OAEG;YACW,gBAAgB;IAuB9B;;OAEG;YACW,iBAAiB;IAazB,UAAU,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAKxE,iBAAiB,IAAI,OAAO;IAI5B;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,EAAE;IA8BtD;;;;;;;OAOG;IACH,OAAO,CAAC,mBAAmB;IAgB3B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;OAEG;IACH,UAAU,IAAI,IAAI;IAKlB;;OAEG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE;CAOzE"}