@principal-ai/principal-view-core 0.27.2 → 0.28.0

package/dist/events/EventsCanvasValidator.d.ts

@@ -14,6 +14,19 @@ export interface EventNamespaceNode {
     namespace: {
         name: string;
         description: string;
+        /**
+         * Optional source paths that define this component's code location.
+         * Each entry may be a folder (covers all descendants) or a specific file.
+         * When present, events in this namespace may only be emitted from files
+         * covered by one of these paths. Namespaces without `paths` remain
+         * unenforced — enforcement is opt-in per namespace.
+         *
+         * Multiple entries are valid for cases like generated code, platform-split
+         * implementations, or migration periods. The validator warns when
+         * `paths.length > 1` to prompt authors to confirm the multi-location
+         * is intentional.
+         */
+        paths?: string[];
         events: Array<{
             name: string;
             severity?: 'INFO' | 'WARN' | 'ERROR';

package/dist/events/EventsCanvasValidator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EventsCanvasValidator.d.ts","sourceRoot":"","sources":["../../src/events/EventsCanvasValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;YACrC,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;gBAC1B,IAAI,EAAE,MAAM,CAAC;gBACb,QAAQ,CAAC,EAAE,OAAO,CAAC;gBACnB,WAAW,CAAC,EAAE,MAAM,CAAC;aACtB,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC;IAEF,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,mCAAmC;IACnC,YAAY,CAAC,EAAE,cAAc,CAAC;IAE9B,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf,qBAAqB;IACrB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAE3B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAEhB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAC;IAEf,+BAA+B;IAC/B,UAAU,EAAE,qBAAqB,EAAE,CAAC;IAEpC,uBAAuB;IACvB,OAAO,EAAE;QACP,oCAAoC;QACpC,eAAe,EAAE,MAAM,CAAC;QACxB,4BAA4B;QAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,+BAA+B;QAC/B,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,yCAAyC;QACzC,WAAW,EAAE,MAAM,CAAC;QACpB,oDAAoD;QACpD,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,uCAAuC;QACvC,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC;CA0JzC"}
+{"version":3,"file":"EventsCanvasValidator.d.ts","sourceRoot":"","sources":["../../src/events/EventsCanvasValidator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAsB,MAAM,iBAAiB,CAAC;AAK1E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB;;;;;;;;;;;WAWG;QACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,EAAE,KAAK,CAAC;YACZ,IAAI,EAAE,MAAM,CAAC;YACb,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;YACrC,WAAW,CAAC,EAAE,MAAM,CAAC;YACrB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;gBAC1B,IAAI,EAAE,MAAM,CAAC;gBACb,QAAQ,CAAC,EAAE,OAAO,CAAC;gBACnB,WAAW,CAAC,EAAE,MAAM,CAAC;aACtB,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC;IAEF,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,mCAAmC;IACnC,YAAY,CAAC,EAAE,cAAc,CAAC;IAE9B,qCAAqC;IACrC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,CAAC;IAEjB,mDAAmD;IACnD,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,EAAE,CAAC;KAClB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf,qBAAqB;IACrB,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAE3B,yCAAyC;IACzC,IAAI,EAAE,MAAM,CAAC;IAEb,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAEhB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,oBAAoB;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAC;IAEf,+BAA+B;IAC/B,UAAU,EAAE,qBAAqB,EAAE,CAAC;IAEpC,uBAAuB;IACvB,OAAO,EAAE;QACP,oCAAoC;QACpC,eAAe,EAAE,MAAM,CAAC;QACxB,4BAA4B;QAC5B,oBAAoB,EAAE,MAAM,EAAE,CAAC;QAC/B,+BAA+B;QAC/B,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,yCAAyC;QACzC,WAAW,EAAE,MAAM,CAAC;QACpB,oDAAoD;QACpD,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,uCAAuC;QACvC,kBAAkB,EAAE,MAAM,EAAE,CAAC;KAC9B,CAAC;CACH;AAED;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAQxB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAsB/B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAe9B;;OAEG;IACG,QAAQ,CACZ,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,4BAA4B,CAAC;CAgOzC"}

package/dist/events/EventsCanvasValidator.js

@@ -7,6 +7,9 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventsCanvasValidator = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const path_helpers_1 = require("./path-helpers");
 /**
  * Validates events canvas files
  */
@@ -197,6 +200,73 @@ class EventsCanvasValidator {
                 }
             }
         }
+        // Validate namespace paths (optional field — enforcement is opt-in per namespace).
+        // Collects declared paths across namespaces to check for cross-namespace overlap.
+        const declaredPaths = [];
+        for (const node of eventsCanvas.nodes || []) {
+            if (!this.isEventNamespaceNode(node))
+                continue;
+            const namespaceNode = node;
+            const paths = namespaceNode.namespace.paths;
+            if (!paths || paths.length === 0)
+                continue;
+            // Warn when a namespace declares more than one path — prompt author to
+            // confirm the multi-location is intentional (generated code, platform
+            // splits, migration) rather than an accidental sprawl.
+            if (paths.length > 1) {
+                violations.push({
+                    ruleId: 'events-namespace-multiple-paths',
+                    severity: 'warn',
+                    file: eventsCanvasPath || '.principal-views/cli.events.canvas',
+                    path: `nodes[id="${namespaceNode.id}"].namespace.paths`,
+                    message: `Namespace "${namespaceNode.namespace.name}" declares ${paths.length} paths`,
+                    impact: 'Multiple paths can indicate legitimate cases (generated code, platform splits, migration) but often signal that the namespace should be split',
+                    suggestion: 'Confirm the multi-location is intentional. Otherwise consider splitting the namespace or grouping the code under a single parent folder.',
+                });
+            }
+            for (const p of paths) {
+                declaredPaths.push({
+                    namespace: namespaceNode.namespace.name,
+                    nodeId: namespaceNode.id,
+                    path: p,
+                });
+                // Warn when a declared path does not exist relative to the repo root.
+                const resolved = (0, path_1.resolve)(basePath, p);
+                if (!(0, fs_1.existsSync)(resolved)) {
+                    violations.push({
+                        ruleId: 'events-namespace-paths-missing',
+                        severity: 'warn',
+                        file: eventsCanvasPath || '.principal-views/cli.events.canvas',
+                        path: `nodes[id="${namespaceNode.id}"].namespace.paths`,
+                        message: `Path "${p}" declared by namespace "${namespaceNode.namespace.name}" does not exist`,
+                        impact: 'Events emitted under this namespace cannot be validated against a real code location',
+                        suggestion: 'Verify the path exists relative to the repository root, or remove it from the namespace declaration.',
+                    });
+                }
+            }
+        }
+        // Cross-namespace overlap check. Parent-child nesting is a valid partition
+        // (longest-prefix wins at runtime); any other overlap makes namespace
+        // ownership of a file ambiguous.
+        for (let i = 0; i < declaredPaths.length; i++) {
+            for (let j = i + 1; j < declaredPaths.length; j++) {
+                const a = declaredPaths[i];
+                const b = declaredPaths[j];
+                if (a.namespace === b.namespace)
+                    continue;
+                const relationship = (0, path_helpers_1.pathsOverlap)(a.path, b.path);
+                if (relationship === 'conflict') {
+                    violations.push({
+                        ruleId: 'events-namespace-paths-overlap',
+                        severity: 'error',
+                        file: eventsCanvasPath || '.principal-views/cli.events.canvas',
+                        message: `Paths overlap between namespaces "${a.namespace}" ("${a.path}") and "${b.namespace}" ("${b.path}")`,
+                        impact: 'A file covered by two namespaces makes namespace ownership ambiguous',
+                        suggestion: 'Separate the paths so they are disjoint, or restructure as parent/child namespaces (e.g., "workflow" covering "src/workflow" and "workflow.scenarios" covering "src/workflow/scenarios").',
+                    });
+                }
+            }
+        }
         metrics.totalNamespaces = extractedNamespaces.size;
         const errors = violations.filter(v => v.severity === 'error');
         return {

package/dist/events/EventsCanvasValidator.js.map

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

package/dist/events/NamespacePathIndex.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Namespace Path Index
+ *
+ * Maps (scope, filepath) to the event-namespace that owns the file, using the
+ * `paths` field declared on `event-namespace` nodes.
+ *
+ * Resolution uses the longest-prefix partitioning rule: when multiple
+ * namespaces within a scope have paths that cover the same file, the one
+ * whose matched path is the most specific (longest after normalization) wins.
+ * This naturally supports nested namespaces such as `workflow` and
+ * `workflow.scenarios`, where the child claims its subtree without stealing
+ * the parent's.
+ *
+ * Pure/browser-safe — no filesystem access, just string comparison.
+ */
+/**
+ * One declared namespace/paths tuple, tagged with the scope it belongs to.
+ * Multiple entries may share the same scope (different namespaces in the
+ * same events canvas) or the same namespace across scopes (no cross-scope
+ * conflict — resolution is scoped).
+ */
+export interface NamespacePathEntry {
+    scope: string;
+    namespace: string;
+    paths: string[];
+    /** Optional — useful for surfacing where a match came from in diagnostics. */
+    sourceCanvasPath?: string;
+}
+/**
+ * Result of resolving a file against the index.
+ */
+export interface NamespacePathMatch {
+    /** The winning entry (by longest-prefix). */
+    entry: NamespacePathEntry;
+    /** Which of the entry's paths covered the file — the one that won. */
+    matchedPath: string;
+}
+export declare class NamespacePathIndex {
+    private entries;
+    /** Register a single namespace/paths entry. */
+    add(entry: NamespacePathEntry): void;
+    /** Register many entries at once. */
+    addAll(entries: readonly NamespacePathEntry[]): void;
+    /**
+     * Resolve a filepath to its owning namespace within a scope.
+     * Returns null if no entry in that scope has a path covering the file.
+     */
+    resolve(scope: string, filepath: string): NamespacePathMatch | null;
+    /** All entries registered under the given scope (for diagnostics). */
+    getScopeEntries(scope: string): readonly NamespacePathEntry[];
+    /**
+     * Look up the entry for a specific (scope, namespace) pair. Returns null
+     * when the namespace isn't registered — either because its events-canvas
+     * node omits `paths` (opt-out of enforcement) or because no such namespace
+     * is declared at all.
+     */
+    getEntry(scope: string, namespace: string): NamespacePathEntry | null;
+    /** All scopes present in the index. */
+    getScopes(): readonly string[];
+}
+//# sourceMappingURL=NamespacePathIndex.d.ts.map

package/dist/events/NamespacePathIndex.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamespacePathIndex.d.ts","sourceRoot":"","sources":["../../src/events/NamespacePathIndex.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,6CAA6C;IAC7C,KAAK,EAAE,kBAAkB,CAAC;IAC1B,sEAAsE;IACtE,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAA4B;IAE3C,+CAA+C;IAC/C,GAAG,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI;IAIpC,qCAAqC;IACrC,MAAM,CAAC,OAAO,EAAE,SAAS,kBAAkB,EAAE,GAAG,IAAI;IAIpD;;;OAGG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAmBnE,sEAAsE;IACtE,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,kBAAkB,EAAE;IAI7D;;;;;OAKG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI;IAMrE,uCAAuC;IACvC,SAAS,IAAI,SAAS,MAAM,EAAE;CAG/B"}

package/dist/events/NamespacePathIndex.js

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Namespace Path Index
+ *
+ * Maps (scope, filepath) to the event-namespace that owns the file, using the
+ * `paths` field declared on `event-namespace` nodes.
+ *
+ * Resolution uses the longest-prefix partitioning rule: when multiple
+ * namespaces within a scope have paths that cover the same file, the one
+ * whose matched path is the most specific (longest after normalization) wins.
+ * This naturally supports nested namespaces such as `workflow` and
+ * `workflow.scenarios`, where the child claims its subtree without stealing
+ * the parent's.
+ *
+ * Pure/browser-safe — no filesystem access, just string comparison.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NamespacePathIndex = void 0;
+const path_helpers_1 = require("./path-helpers");
+class NamespacePathIndex {
+    constructor() {
+        this.entries = [];
+    }
+    /** Register a single namespace/paths entry. */
+    add(entry) {
+        this.entries.push(entry);
+    }
+    /** Register many entries at once. */
+    addAll(entries) {
+        for (const e of entries)
+            this.add(e);
+    }
+    /**
+     * Resolve a filepath to its owning namespace within a scope.
+     * Returns null if no entry in that scope has a path covering the file.
+     */
+    resolve(scope, filepath) {
+        const normalizedFile = (0, path_helpers_1.normalizePath)(filepath);
+        let best = null;
+        for (const entry of this.entries) {
+            if (entry.scope !== scope)
+                continue;
+            for (const declared of entry.paths) {
+                if (!(0, path_helpers_1.pathCovers)(declared, normalizedFile))
+                    continue;
+                const normalizedDeclared = (0, path_helpers_1.normalizePath)(declared);
+                const length = normalizedDeclared.length;
+                if (best === null || length > best.length) {
+                    best = { entry, matchedPath: declared, length };
+                }
+            }
+        }
+        return best ? { entry: best.entry, matchedPath: best.matchedPath } : null;
+    }
+    /** All entries registered under the given scope (for diagnostics). */
+    getScopeEntries(scope) {
+        return this.entries.filter((e) => e.scope === scope);
+    }
+    /**
+     * Look up the entry for a specific (scope, namespace) pair. Returns null
+     * when the namespace isn't registered — either because its events-canvas
+     * node omits `paths` (opt-out of enforcement) or because no such namespace
+     * is declared at all.
+     */
+    getEntry(scope, namespace) {
+        return this.entries.find((e) => e.scope === scope && e.namespace === namespace) ?? null;
+    }
+    /** All scopes present in the index. */
+    getScopes() {
+        return Array.from(new Set(this.entries.map((e) => e.scope)));
+    }
+}
+exports.NamespacePathIndex = NamespacePathIndex;
+//# sourceMappingURL=NamespacePathIndex.js.map

package/dist/events/NamespacePathIndex.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"NamespacePathIndex.js","sourceRoot":"","sources":["../../src/events/NamespacePathIndex.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;GAcG;;;AAEH,iDAA2D;AA0B3D,MAAa,kBAAkB;IAA/B;QACU,YAAO,GAAyB,EAAE,CAAC;IAwD7C,CAAC;IAtDC,+CAA+C;IAC/C,GAAG,CAAC,KAAyB;QAC3B,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED,qCAAqC;IACrC,MAAM,CAAC,OAAsC;QAC3C,KAAK,MAAM,CAAC,IAAI,OAAO;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;IACvC,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,KAAa,EAAE,QAAgB;QACrC,MAAM,cAAc,GAAG,IAAA,4BAAa,EAAC,QAAQ,CAAC,CAAC;QAC/C,IAAI,IAAI,GAA8E,IAAI,CAAC;QAE3F,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE;YAChC,IAAI,KAAK,CAAC,KAAK,KAAK,KAAK;gBAAE,SAAS;YACpC,KAAK,MAAM,QAAQ,IAAI,KAAK,CAAC,KAAK,EAAE;gBAClC,IAAI,CAAC,IAAA,yBAAU,EAAC,QAAQ,EAAE,cAAc,CAAC;oBAAE,SAAS;gBACpD,MAAM,kBAAkB,GAAG,IAAA,4BAAa,EAAC,QAAQ,CAAC,CAAC;gBACnD,MAAM,MAAM,GAAG,kBAAkB,CAAC,MAAM,CAAC;gBACzC,IAAI,IAAI,KAAK,IAAI,IAAI,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE;oBACzC,IAAI,GAAG,EAAE,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;iBACjD;aACF;SACF;QAED,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC5E,CAAC;IAED,sEAAsE;IACtE,eAAe,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAC,CAAC;IACvD,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,KAAa,EAAE,SAAiB;QACvC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CACtB,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,IAAI,CAAC,CAAC,SAAS,KAAK,SAAS,CACtD,IAAI,IAAI,CAAC;IACZ,CAAC;IAED,uCAAuC;IACvC,SAAS;QACP,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC/D,CAAC;CACF;AAzDD,gDAyDC"}

package/dist/events/OtelEventPathsValidator.d.ts

@@ -0,0 +1,75 @@
+/**
+ * OTEL Event Paths Validator (Phase 2)
+ *
+ * Cross-canvas static check. For every `otel-event` node in an OTEL canvas,
+ * cross-reference each entry in `otel.files` against the `paths` declared on
+ * the event's namespace in the corresponding events canvas.
+ *
+ * Enforcement is opt-in per namespace: a namespace without `paths` (or a
+ * namespace not declared at all) produces no violations for its events.
+ *
+ * Pure/browser-safe — no filesystem access.
+ */
+import type { ExtendedCanvas } from '../types/canvas';
+/**
+ * One events canvas, pre-paired with the scope it owns. Scope pairing is
+ * typically derived via the existing scope → filename convention
+ * (e.g., scope `principal-view.cli` owns `principal-view-cli.events.canvas`).
+ */
+export interface EventsCanvasInput {
+    canvas: ExtendedCanvas;
+    canvasPath: string;
+    scope: string;
+}
+/**
+ * One OTEL canvas whose `otel-event` nodes we want to cross-check.
+ */
+export interface OtelCanvasInput {
+    canvas: ExtendedCanvas;
+    canvasPath: string;
+}
+export interface OtelEventPathsValidationContext {
+    eventsCanvases: EventsCanvasInput[];
+    otelCanvases: OtelCanvasInput[];
+}
+export type OtelEventPathsRuleId = 'events-otel-files-wrong-namespace' | 'events-otel-files-orphan';
+export interface OtelEventPathsViolation {
+    ruleId: OtelEventPathsRuleId;
+    severity: 'error' | 'warn';
+    file: string;
+    path?: string;
+    message: string;
+    impact: string;
+    suggestion: string;
+}
+export interface OtelEventPathsValidationResult {
+    valid: boolean;
+    violations: OtelEventPathsViolation[];
+    metrics: {
+        /** Events whose files were cross-checked against namespace paths. */
+        eventsChecked: number;
+        /** Total files examined across all checked events. */
+        filesChecked: number;
+        /**
+         * Events skipped because the event's namespace has no `paths` declared
+         * (or is not declared at all) — enforcement is opt-in per namespace.
+         */
+        eventsSkippedNoPaths: number;
+        /**
+         * Events skipped because the `otel-event` node declares no `otel.files`.
+         * These events have no claimed implementation location to cross-check.
+         */
+        eventsSkippedNoFiles: number;
+    };
+}
+export declare class OtelEventPathsValidator {
+    /**
+     * Build a path index from the events canvases, keyed by scope.
+     * Only namespaces that declare `paths` contribute entries.
+     */
+    private buildIndex;
+    /** Extract the namespace from an event name (all segments except the last). */
+    private extractNamespace;
+    validate(context: OtelEventPathsValidationContext): OtelEventPathsValidationResult;
+}
+//# sourceMappingURL=OtelEventPathsValidator.d.ts.map

package/dist/events/OtelEventPathsValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"OtelEventPathsValidator.d.ts","sourceRoot":"","sources":["../../src/events/OtelEventPathsValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,iBAAiB,CAAC;AAIrE;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,cAAc,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,+BAA+B;IAC9C,cAAc,EAAE,iBAAiB,EAAE,CAAC;IACpC,YAAY,EAAE,eAAe,EAAE,CAAC;CACjC;AAED,MAAM,MAAM,oBAAoB,GAC5B,mCAAmC,GACnC,0BAA0B,CAAC;AAE/B,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,QAAQ,EAAE,OAAO,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,uBAAuB,EAAE,CAAC;IACtC,OAAO,EAAE;QACP,qEAAqE;QACrE,aAAa,EAAE,MAAM,CAAC;QACtB,sDAAsD;QACtD,YAAY,EAAE,MAAM,CAAC;QACrB;;;WAGG;QACH,oBAAoB,EAAE,MAAM,CAAC;QAC7B;;;WAGG;QACH,oBAAoB,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH;AAED,qBAAa,uBAAuB;IAClC;;;OAGG;IACH,OAAO,CAAC,UAAU;IAqBlB,+EAA+E;IAC/E,OAAO,CAAC,gBAAgB;IAMxB,QAAQ,CAAC,OAAO,EAAE,+BAA+B,GAAG,8BAA8B;CAiFnF"}

package/dist/events/OtelEventPathsValidator.js

@@ -0,0 +1,126 @@
+"use strict";
+/**
+ * OTEL Event Paths Validator (Phase 2)
+ *
+ * Cross-canvas static check. For every `otel-event` node in an OTEL canvas,
+ * cross-reference each entry in `otel.files` against the `paths` declared on
+ * the event's namespace in the corresponding events canvas.
+ *
+ * Enforcement is opt-in per namespace: a namespace without `paths` (or a
+ * namespace not declared at all) produces no violations for its events.
+ *
+ * Pure/browser-safe — no filesystem access.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OtelEventPathsValidator = void 0;
+const canvas_1 = require("../types/canvas");
+const NamespacePathIndex_1 = require("./NamespacePathIndex");
+class OtelEventPathsValidator {
+    /**
+     * Build a path index from the events canvases, keyed by scope.
+     * Only namespaces that declare `paths` contribute entries.
+     */
+    buildIndex(eventsCanvases) {
+        const index = new NamespacePathIndex_1.NamespacePathIndex();
+        for (const ec of eventsCanvases) {
+            for (const node of ec.canvas.nodes || []) {
+                if (node?.type !== 'event-namespace')
+                    continue;
+                const ns = node.namespace;
+                if (!ns || typeof ns.name !== 'string')
+                    continue;
+                if (!Array.isArray(ns.paths) || ns.paths.length === 0)
+                    continue;
+                const entry = {
+                    scope: ec.scope,
+                    namespace: ns.name,
+                    paths: ns.paths,
+                    sourceCanvasPath: ec.canvasPath,
+                };
+                index.add(entry);
+            }
+        }
+        return index;
+    }
+    /** Extract the namespace from an event name (all segments except the last). */
+    extractNamespace(eventName) {
+        const segments = eventName.split('.');
+        if (segments.length < 2)
+            return null;
+        return segments.slice(0, -1).join('.');
+    }
+    validate(context) {
+        const violations = [];
+        const metrics = {
+            eventsChecked: 0,
+            filesChecked: 0,
+            eventsSkippedNoPaths: 0,
+            eventsSkippedNoFiles: 0,
+        };
+        const index = this.buildIndex(context.eventsCanvases);
+        for (const oc of context.otelCanvases) {
+            for (const node of oc.canvas.nodes || []) {
+                if (!(0, canvas_1.isOtelEventNode)(node))
+                    continue;
+                const eventNode = node;
+                const eventName = eventNode.event?.name;
+                const scope = eventNode.otel?.scope;
+                const files = eventNode.otel?.files;
+                if (!eventName || !scope)
+                    continue; // malformed — other validators catch this
+                const namespace = this.extractNamespace(eventName);
+                if (!namespace)
+                    continue; // invalid event name — caught by other validators
+                if (!files || files.length === 0) {
+                    metrics.eventsSkippedNoFiles++;
+                    continue;
+                }
+                // Enforcement is opt-in: if the event's namespace has no declared
+                // paths (or isn't declared at all), we don't check its files.
+                const eventEntry = index.getEntry(scope, namespace);
+                if (!eventEntry) {
+                    metrics.eventsSkippedNoPaths++;
+                    continue;
+                }
+                metrics.eventsChecked++;
+                for (const file of files) {
+                    metrics.filesChecked++;
+                    const match = index.resolve(scope, file);
+                    if (match === null) {
+                        violations.push({
+                            ruleId: 'events-otel-files-orphan',
+                            severity: 'warn',
+                            file: oc.canvasPath,
+                            path: `nodes[id="${eventNode.id}"].otel.files["${file}"]`,
+                            message: `Event "${eventName}" declares file "${file}" which is not covered by any namespace's paths in scope "${scope}"`,
+                            impact: 'The file emits an event but has no declared component home, so its location cannot be validated against namespace conventions.',
+                            suggestion: `Either add "${file}" (or an ancestor folder) to the "paths" of the "${namespace}" namespace in the events canvas, or move the implementation into one of the namespace's declared paths: ${eventEntry.paths.map((p) => `"${p}"`).join(', ')}.`,
+                        });
+                        continue;
+                    }
+                    if (match.entry.namespace === namespace) {
+                        // File belongs to the event's namespace (longest-prefix match).
+                        continue;
+                    }
+                    violations.push({
+                        ruleId: 'events-otel-files-wrong-namespace',
+                        severity: 'error',
+                        file: oc.canvasPath,
+                        path: `nodes[id="${eventNode.id}"].otel.files["${file}"]`,
+                        message: `Event "${eventName}" declares file "${file}", but namespace "${match.entry.namespace}" (path "${match.matchedPath}") owns that location — not "${namespace}"`,
+                        impact: 'Event identity disagrees with code location. Consumers discovering the event by name will land in a folder that belongs to a different namespace.',
+                        suggestion: `Either rename the event to start with "${match.entry.namespace}." (if the code placement is correct), or move the implementation into one of the "${namespace}" namespace's declared paths (${eventEntry.paths.map((p) => `"${p}"`).join(', ')}).`,
+                    });
+                }
+            }
+        }
+        const errors = violations.filter((v) => v.severity === 'error');
+        return {
+            valid: errors.length === 0,
+            violations,
+            metrics,
+        };
+    }
+}
+exports.OtelEventPathsValidator = OtelEventPathsValidator;
+//# sourceMappingURL=OtelEventPathsValidator.js.map

package/dist/events/OtelEventPathsValidator.js.map

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

package/dist/events/index.d.ts

@@ -2,4 +2,8 @@ export { EventsCanvasValidator } from './EventsCanvasValidator';
 export type { EventNamespaceNode, EventsCanvasValidationContext, EventsCanvasViolation, EventsCanvasValidationResult, } from './EventsCanvasValidator';
 export { ScopeEventsValidator } from './ScopeEventsValidator';
 export type { ScopeEventsValidationContext, ScopeEventsViolation, ScopeEventsValidationResult, } from './ScopeEventsValidator';
+export { NamespacePathIndex } from './NamespacePathIndex';
+export type { NamespacePathEntry, NamespacePathMatch } from './NamespacePathIndex';
+export { OtelEventPathsValidator } from './OtelEventPathsValidator';
+export type { OtelEventPathsValidationContext, OtelEventPathsValidationResult, OtelEventPathsViolation, OtelEventPathsRuleId, EventsCanvasInput, OtelCanvasInput, } from './OtelEventPathsValidator';
 //# sourceMappingURL=index.d.ts.map

package/dist/events/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,kBAAkB,EAClB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EACV,kBAAkB,EAClB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,yBAAyB,CAAC;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,4BAA4B,EAC5B,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEnF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EACV,+BAA+B,EAC/B,8BAA8B,EAC9B,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,GAChB,MAAM,2BAA2B,CAAC"}

package/dist/events/index.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ScopeEventsValidator = exports.EventsCanvasValidator = void 0;
+exports.OtelEventPathsValidator = exports.NamespacePathIndex = exports.ScopeEventsValidator = exports.EventsCanvasValidator = void 0;
 var EventsCanvasValidator_1 = require("./EventsCanvasValidator");
 Object.defineProperty(exports, "EventsCanvasValidator", { enumerable: true, get: function () { return EventsCanvasValidator_1.EventsCanvasValidator; } });
 var ScopeEventsValidator_1 = require("./ScopeEventsValidator");
 Object.defineProperty(exports, "ScopeEventsValidator", { enumerable: true, get: function () { return ScopeEventsValidator_1.ScopeEventsValidator; } });
+var NamespacePathIndex_1 = require("./NamespacePathIndex");
+Object.defineProperty(exports, "NamespacePathIndex", { enumerable: true, get: function () { return NamespacePathIndex_1.NamespacePathIndex; } });
+var OtelEventPathsValidator_1 = require("./OtelEventPathsValidator");
+Object.defineProperty(exports, "OtelEventPathsValidator", { enumerable: true, get: function () { return OtelEventPathsValidator_1.OtelEventPathsValidator; } });
 //# sourceMappingURL=index.js.map

package/dist/events/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAQ9B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/events/index.ts"],"names":[],"mappings":";;;AAAA,iEAAgE;AAAvD,8HAAA,qBAAqB,OAAA;AAQ9B,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA;AAO7B,2DAA0D;AAAjD,wHAAA,kBAAkB,OAAA;AAG3B,qEAAoE;AAA3D,kIAAA,uBAAuB,OAAA"}

package/dist/events/path-helpers.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Path helpers shared across events-canvas validators.
+ *
+ * Paths declared in canvases (namespace `paths`, `otel.files`, etc.) are
+ * always repo-relative. These helpers give a consistent notion of
+ * canonicalization and prefix-based containment so that separate validators
+ * don't drift.
+ */
+/**
+ * Canonicalize a declared path for comparison.
+ * Strips leading `./`, trailing slashes, and collapses duplicate slashes.
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * True when `child` is strictly nested under `parent` (not equal).
+ * Both inputs should already be normalized.
+ */
+export declare function isPathDescendant(child: string, parent: string): boolean;
+/**
+ * True when `filepath` is covered by `declaredPath` — either equal to it
+ * (file match) or nested under it (folder match). Inputs are normalized
+ * internally so callers can pass raw canvas values.
+ */
+export declare function pathCovers(declaredPath: string, filepath: string): boolean;
+/**
+ * Classify the relationship between two declared paths.
+ * - 'none':      disjoint — no overlap
+ * - 'partition': one is strictly a parent of the other — valid nested-namespace case
+ *                (longest-prefix wins at runtime, parent/child partition the tree)
+ * - 'conflict':  identical, or overlap that isn't a clean parent-child partition
+ */
+export declare function pathsOverlap(a: string, b: string): 'none' | 'partition' | 'conflict';
+//# sourceMappingURL=path-helpers.d.ts.map

package/dist/events/path-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-helpers.d.ts","sourceRoot":"","sources":["../../src/events/path-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAI1E;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAMpF"}