@principal-ai/principal-view-core 0.28.3 → 0.28.4

package/dist/auxiliary/AuxiliaryManifestValidator.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Auxiliary Manifest Validator
+ *
+ * Own-file checks for `.principal-views/auxiliary.manifest.json`:
+ *   - area names are unique
+ *   - declared paths exist on disk
+ *   - paths don't overlap each other (within or across areas)
+ *
+ * Cross-file overlap with scope paths lives in `validateAreaScopeDisjoint`,
+ * mirroring the way `validateScopeNamespaceNesting` handles cross-canvas
+ * checks for scopes/namespaces.
+ */
+import type { AuxiliaryManifest } from '../types/auxiliary';
+export interface AuxiliaryManifestValidationContext {
+    /** Parsed manifest. When absent, validation is a no-op (manifest is optional). */
+    manifest?: AuxiliaryManifest;
+    /** Path to the manifest file — used in violation messages. */
+    manifestPath?: string;
+    /** Repo root for resolving area paths against the filesystem. */
+    basePath: string;
+}
+export interface AuxiliaryManifestViolation {
+    ruleId: string;
+    severity: 'error' | 'warn';
+    file: string;
+    path?: string;
+    message: string;
+    impact: string;
+    suggestion: string;
+}
+export interface AuxiliaryManifestValidationResult {
+    valid: boolean;
+    violations: AuxiliaryManifestViolation[];
+}
+export declare class AuxiliaryManifestValidator {
+    validate(context: AuxiliaryManifestValidationContext): AuxiliaryManifestValidationResult;
+}
+//# sourceMappingURL=AuxiliaryManifestValidator.d.ts.map

package/dist/auxiliary/AuxiliaryManifestValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AuxiliaryManifestValidator.d.ts","sourceRoot":"","sources":["../../src/auxiliary/AuxiliaryManifestValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAG5D,MAAM,WAAW,kCAAkC;IACjD,kFAAkF;IAClF,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAE7B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,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,iCAAiC;IAChD,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,0BAA0B,EAAE,CAAC;CAC1C;AAID,qBAAa,0BAA0B;IACrC,QAAQ,CAAC,OAAO,EAAE,kCAAkC,GAAG,iCAAiC;CAiFzF"}

package/dist/auxiliary/AuxiliaryManifestValidator.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * Auxiliary Manifest Validator
+ *
+ * Own-file checks for `.principal-views/auxiliary.manifest.json`:
+ *   - area names are unique
+ *   - declared paths exist on disk
+ *   - paths don't overlap each other (within or across areas)
+ *
+ * Cross-file overlap with scope paths lives in `validateAreaScopeDisjoint`,
+ * mirroring the way `validateScopeNamespaceNesting` handles cross-canvas
+ * checks for scopes/namespaces.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuxiliaryManifestValidator = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const path_helpers_1 = require("../events/path-helpers");
+const DEFAULT_MANIFEST_PATH = '.principal-views/auxiliary.manifest.json';
+class AuxiliaryManifestValidator {
+    validate(context) {
+        const violations = [];
+        const { manifest, basePath } = context;
+        const file = context.manifestPath || DEFAULT_MANIFEST_PATH;
+        if (!manifest) {
+            return { valid: true, violations };
+        }
+        const areas = manifest.areas || [];
+        // Unique area names
+        const seenNames = new Map();
+        areas.forEach((area, idx) => {
+            const count = seenNames.get(area.name) ?? 0;
+            seenNames.set(area.name, count + 1);
+            if (count === 1) {
+                violations.push({
+                    ruleId: 'auxiliary-area-name-duplicate',
+                    severity: 'error',
+                    file,
+                    path: `areas[${idx}].name`,
+                    message: `Area name "${area.name}" is declared more than once`,
+                    impact: 'Duplicate names make diagnostics ambiguous — a violation cannot be tied back to a single area',
+                    suggestion: 'Rename one of the areas so names are unique across the manifest.',
+                });
+            }
+        });
+        // Path existence + collect for overlap pass
+        const declaredPaths = [];
+        areas.forEach((area, areaIdx) => {
+            const paths = area.paths || [];
+            paths.forEach((p, pathIdx) => {
+                declaredPaths.push({ areaName: area.name, areaIndex: areaIdx, pathIndex: pathIdx, path: p });
+                const resolved = (0, path_1.resolve)(basePath, p);
+                if (!(0, fs_1.existsSync)(resolved)) {
+                    violations.push({
+                        ruleId: 'auxiliary-area-path-missing',
+                        severity: 'warn',
+                        file,
+                        path: `areas[${areaIdx}].paths[${pathIdx}]`,
+                        message: `Path "${p}" declared by area "${area.name}" does not exist`,
+                        impact: 'The manifest documents a folder that is not present in the repository',
+                        suggestion: 'Verify the path exists relative to the repository root, or remove it from the area declaration.',
+                    });
+                }
+            });
+        });
+        // Path overlap. Unlike scopes, areas have no dotted-name hierarchy, so
+        // parent-child nesting between two areas is just as ambiguous as a flat
+        // overlap — both are flagged.
+        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];
+                const relationship = (0, path_helpers_1.pathsOverlap)(a.path, b.path);
+                if (relationship === 'none')
+                    continue;
+                const sameArea = a.areaName === b.areaName;
+                violations.push({
+                    ruleId: sameArea ? 'auxiliary-area-paths-self-overlap' : 'auxiliary-area-paths-overlap',
+                    severity: 'error',
+                    file,
+                    path: sameArea
+                        ? `areas[${a.areaIndex}].paths`
+                        : undefined,
+                    message: sameArea
+                        ? `Area "${a.areaName}" declares overlapping paths "${a.path}" and "${b.path}"`
+                        : `Paths overlap between areas "${a.areaName}" ("${a.path}") and "${b.areaName}" ("${b.path}")`,
+                    impact: 'Two area declarations covering the same file make ownership ambiguous',
+                    suggestion: 'Make the paths disjoint. If one folder genuinely sits inside another area, drop the redundant entry.',
+                });
+            }
+        }
+        const errors = violations.filter((v) => v.severity === 'error');
+        return { valid: errors.length === 0, violations };
+    }
+}
+exports.AuxiliaryManifestValidator = AuxiliaryManifestValidator;
+//# sourceMappingURL=AuxiliaryManifestValidator.js.map

package/dist/auxiliary/AuxiliaryManifestValidator.js.map

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

package/dist/auxiliary/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Auxiliary module
+ *
+ * Validation for `auxiliary.manifest.json` — the catalog of project regions
+ * that sit outside the OTEL telemetry surface (docs, .github, etc.).
+ */
+export { AuxiliaryManifestValidator, type AuxiliaryManifestValidationContext, type AuxiliaryManifestValidationResult, type AuxiliaryManifestViolation, } from './AuxiliaryManifestValidator';
+export { validateAreaScopeDisjoint, type ValidateAreaScopeDisjointInput, } from './validateAreaScopeDisjoint';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/auxiliary/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,0BAA0B,EAC1B,KAAK,kCAAkC,EACvC,KAAK,iCAAiC,EACtC,KAAK,0BAA0B,GAChC,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,yBAAyB,EACzB,KAAK,8BAA8B,GACpC,MAAM,6BAA6B,CAAC"}

package/dist/auxiliary/index.js

@@ -0,0 +1,14 @@
+"use strict";
+/**
+ * Auxiliary module
+ *
+ * Validation for `auxiliary.manifest.json` — the catalog of project regions
+ * that sit outside the OTEL telemetry surface (docs, .github, etc.).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAreaScopeDisjoint = exports.AuxiliaryManifestValidator = void 0;
+var AuxiliaryManifestValidator_1 = require("./AuxiliaryManifestValidator");
+Object.defineProperty(exports, "AuxiliaryManifestValidator", { enumerable: true, get: function () { return AuxiliaryManifestValidator_1.AuxiliaryManifestValidator; } });
+var validateAreaScopeDisjoint_1 = require("./validateAreaScopeDisjoint");
+Object.defineProperty(exports, "validateAreaScopeDisjoint", { enumerable: true, get: function () { return validateAreaScopeDisjoint_1.validateAreaScopeDisjoint; } });
+//# sourceMappingURL=index.js.map

package/dist/auxiliary/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/auxiliary/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,2EAKsC;AAJpC,wIAAA,0BAA0B,OAAA;AAM5B,yEAGqC;AAFnC,sIAAA,yBAAyB,OAAA"}

package/dist/auxiliary/validateAreaScopeDisjoint.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Area / Scope Disjointness Validator
+ *
+ * Cross-file check: project-area paths declared in
+ * `auxiliary.manifest.json` must be disjoint from every scope path declared
+ * in `architecture.scopes.canvas`. Areas and scopes carve up the repo into
+ * non-overlapping regions — any overlap (parent-child or otherwise) means a
+ * file is claimed by both an OTEL scope and an auxiliary area, which makes
+ * ownership ambiguous.
+ *
+ * Mirrors `validateScopeNamespaceNesting`'s cross-canvas pattern: takes both
+ * inputs, returns violations.
+ */
+import type { AuxiliaryManifest } from '../types/auxiliary';
+import type { ExtendedCanvas } from '../types/canvas';
+import type { AuxiliaryManifestViolation } from './AuxiliaryManifestValidator';
+export interface ValidateAreaScopeDisjointInput {
+    manifest: AuxiliaryManifest;
+    manifestPath?: string;
+    scopesCanvas?: ExtendedCanvas;
+    scopesCanvasPath?: string;
+}
+export declare function validateAreaScopeDisjoint(input: ValidateAreaScopeDisjointInput): AuxiliaryManifestViolation[];
+//# sourceMappingURL=validateAreaScopeDisjoint.d.ts.map

package/dist/auxiliary/validateAreaScopeDisjoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAreaScopeDisjoint.d.ts","sourceRoot":"","sources":["../../src/auxiliary/validateAreaScopeDisjoint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAGtD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAE/E,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,cAAc,CAAC;IAC9B,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAID,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,8BAA8B,GACpC,0BAA0B,EAAE,CAwC9B"}

package/dist/auxiliary/validateAreaScopeDisjoint.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Area / Scope Disjointness Validator
+ *
+ * Cross-file check: project-area paths declared in
+ * `auxiliary.manifest.json` must be disjoint from every scope path declared
+ * in `architecture.scopes.canvas`. Areas and scopes carve up the repo into
+ * non-overlapping regions — any overlap (parent-child or otherwise) means a
+ * file is claimed by both an OTEL scope and an auxiliary area, which makes
+ * ownership ambiguous.
+ *
+ * Mirrors `validateScopeNamespaceNesting`'s cross-canvas pattern: takes both
+ * inputs, returns violations.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateAreaScopeDisjoint = void 0;
+const canvas_1 = require("../types/canvas");
+const path_helpers_1 = require("../events/path-helpers");
+const DEFAULT_MANIFEST_PATH = '.principal-views/auxiliary.manifest.json';
+function validateAreaScopeDisjoint(input) {
+    const { manifest, scopesCanvas } = input;
+    const manifestFile = input.manifestPath || DEFAULT_MANIFEST_PATH;
+    if (!scopesCanvas)
+        return [];
+    const scopePaths = [];
+    for (const node of scopesCanvas.nodes || []) {
+        if (!(0, canvas_1.isOtelScopeNode)(node))
+            continue;
+        const scope = node.otel?.scope;
+        const paths = node.paths;
+        if (!scope || !paths || paths.length === 0)
+            continue;
+        for (const p of paths)
+            scopePaths.push({ scope, path: p });
+    }
+    if (scopePaths.length === 0)
+        return [];
+    const violations = [];
+    const areas = manifest.areas || [];
+    areas.forEach((area, areaIdx) => {
+        (area.paths || []).forEach((areaPath, pathIdx) => {
+            for (const sp of scopePaths) {
+                const relationship = (0, path_helpers_1.pathsOverlap)(areaPath, sp.path);
+                if (relationship === 'none')
+                    continue;
+                violations.push({
+                    ruleId: 'auxiliary-area-scope-overlap',
+                    severity: 'error',
+                    file: manifestFile,
+                    path: `areas[${areaIdx}].paths[${pathIdx}]`,
+                    message: `Area "${area.name}" path "${areaPath}" overlaps scope "${sp.scope}" path "${sp.path}"`,
+                    impact: 'A file claimed by both an OTEL scope and an auxiliary area has ambiguous ownership — the manifest is meant to catalog regions outside the telemetry surface',
+                    suggestion: 'Make the area path disjoint from every scope path. If the folder is genuinely runtime code, drop it from the manifest; if it is auxiliary, narrow the scope path or move the folder.',
+                });
+            }
+        });
+    });
+    return violations;
+}
+exports.validateAreaScopeDisjoint = validateAreaScopeDisjoint;
+//# sourceMappingURL=validateAreaScopeDisjoint.js.map

package/dist/auxiliary/validateAreaScopeDisjoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateAreaScopeDisjoint.js","sourceRoot":"","sources":["../../src/auxiliary/validateAreaScopeDisjoint.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;;;AAIH,4CAAkD;AAClD,yDAAsD;AAUtD,MAAM,qBAAqB,GAAG,0CAA0C,CAAC;AAEzE,SAAgB,yBAAyB,CACvC,KAAqC;IAErC,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,KAAK,CAAC;IACzC,MAAM,YAAY,GAAG,KAAK,CAAC,YAAY,IAAI,qBAAqB,CAAC;IAEjE,IAAI,CAAC,YAAY;QAAE,OAAO,EAAE,CAAC;IAE7B,MAAM,UAAU,GAA2C,EAAE,CAAC;IAC9D,KAAK,MAAM,IAAI,IAAI,YAAY,CAAC,KAAK,IAAI,EAAE,EAAE;QAC3C,IAAI,CAAC,IAAA,wBAAe,EAAC,IAAI,CAAC;YAAE,SAAS;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;QACzB,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACrD,KAAK,MAAM,CAAC,IAAI,KAAK;YAAE,UAAU,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;KAC5D;IAED,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEvC,MAAM,UAAU,GAAiC,EAAE,CAAC;IACpD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC;IAEnC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;QAC9B,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,EAAE;YAC/C,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE;gBAC3B,MAAM,YAAY,GAAG,IAAA,2BAAY,EAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;gBACrD,IAAI,YAAY,KAAK,MAAM;oBAAE,SAAS;gBAEtC,UAAU,CAAC,IAAI,CAAC;oBACd,MAAM,EAAE,8BAA8B;oBACtC,QAAQ,EAAE,OAAO;oBACjB,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,SAAS,OAAO,WAAW,OAAO,GAAG;oBAC3C,OAAO,EAAE,SAAS,IAAI,CAAC,IAAI,WAAW,QAAQ,qBAAqB,EAAE,CAAC,KAAK,WAAW,EAAE,CAAC,IAAI,GAAG;oBAChG,MAAM,EAAE,6JAA6J;oBACrK,UAAU,EAAE,sLAAsL;iBACnM,CAAC,CAAC;aACJ;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,UAAU,CAAC;AACpB,CAAC;AA1CD,8DA0CC"}

package/dist/node.d.ts

@@ -59,6 +59,8 @@ export { ExecutionLoader, createExecutionLoader } from './execution/ExecutionLoa
 export type { ExecutionFile, ExecutionLoadResult, } from './execution/ExecutionLoader';
 export { ScopesCanvasValidator, ScopePathIndex, validateScopeNamespaceNesting, DEFAULT_SCOPE_COLOR, DRAFT_NODE_COLOR, getScopeNames, getScopeDefinition, getScopeColor, normalizeScopes, buildScopeColorMap, getAllScopeNames, } from './scopes';
 export type { ScopesCanvasValidationContext, ScopesCanvasValidationResult, ScopesCanvasViolation, ScopePathEntry, ScopePathMatch, ScopeEventsCanvasPair, ValidateScopeNamespaceNestingInput, NormalizedScope, } from './scopes';
+export { AuxiliaryManifestValidator, validateAreaScopeDisjoint, } from './auxiliary';
+export type { AuxiliaryManifestValidationContext, AuxiliaryManifestValidationResult, AuxiliaryManifestViolation, ValidateAreaScopeDisjointInput, } from './auxiliary';
 export { EventsCanvasValidator, ScopeEventsValidator, NamespacePathIndex, OtelEventPathsValidator, } from './events';
 export type { EventsCanvasValidationContext, EventsCanvasValidationResult, EventsCanvasViolation, ScopeEventsValidationContext, ScopeEventsValidationResult, ScopeEventsViolation, NamespacePathEntry, NamespacePathMatch, EventsCanvasInput, OtelCanvasInput, OtelEventPathsValidationContext, OtelEventPathsValidationResult, OtelEventPathsViolation, OtelEventPathsRuleId, } from './events';
 //# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,YAAY,EACV,4BAA4B,EAC5B,6BAA6B,GAC9B,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAC;AAGlF,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAGxD,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG5E,OAAO,EAAE,cAAc,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAC3G,YAAY,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAGpE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACjG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAG7F,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACzE,YAAY,EACV,SAAS,EACT,WAAW,EACX,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EACV,aAAa,EACb,aAAa,EACb,eAAe,EACf,YAAY,EACZ,oBAAoB,EACpB,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EACjB,UAAU,EACV,eAAe,EACf,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,eAAe,EACf,eAAe,EACf,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,eAAe,EACf,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AACtF,YAAY,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAGhD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAG5D,YAAY,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,yBAAyB,EAAE,MAAM,sCAAsC,CAAC;AAGjF,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,cAAc,EACd,aAAa,EACb,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,SAAS,EACT,UAAU,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,YAAY,EACZ,yBAAyB,EACzB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EACV,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,2BAA2B,EAC3B,8BAA8B,EAC9B,gCAAgC,GACjC,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC9F,YAAY,EACV,aAAa,EACb,eAAe,EACf,yBAAyB,GAC1B,MAAM,gCAAgC,CAAC;AAGxC,OAAO,EAAE,kBAAkB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EACV,wBAAwB,EACxB,yBAAyB,EACzB,0BAA0B,GAC3B,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AACrF,YAAY,EACV,aAAa,EACb,mBAAmB,GACpB,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,6BAA6B,EAC7B,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,aAAa,EACb,eAAe,EACf,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,cAAc,EACd,cAAc,EACd,qBAAqB,EACrB,kCAAkC,EAClC,eAAe,GAChB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,6BAA6B,EAC7B,4BAA4B,EAC5B,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,+BAA+B,EAC/B,8BAA8B,EAC9B,uBAAuB,EACvB,oBAAoB,GACrB,MAAM,UAAU,CAAC"}
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}

package/dist/node.js

@@ -26,7 +26,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DRAFT_NODE_COLOR = exports.DEFAULT_SCOPE_COLOR = exports.validateScopeNamespaceNesting = exports.ScopePathIndex = exports.ScopesCanvasValidator = exports.createExecutionLoader = exports.ExecutionLoader = exports.createDashboardValidator = exports.DashboardValidator = exports.createExecutionValidator = exports.ExecutionValidator = exports.LibraryDiscovery = exports.CanvasDiscovery = exports.WorkflowValidator = exports.createWorkflowValidator = exports.setNestedValue = exports.getNestedValue = exports.computeAggregates = exports.hasEventMatching = exports.getRequiredEvents = exports.selectScenario = exports.ParsedTemplate = exports.parseTemplate = exports.renderWorkflow = exports.InMemoryFileSystemAdapter = exports.EventRegistry = exports.LibraryLoader = exports.getConfigNameFromFilename = exports.isYamlFile = exports.parseYaml = exports.ConfigurationLoader = exports.EventRecorderService = exports.SessionManager = exports.traceToCanvasJson = exports.traceToCanvas = exports.generatorRegistry = exports.TypeScriptGenerator = exports.generateTypes = exports.analyzeCoverage = exports.EventValidationError = exports.createValidatedEmitter = exports.EventValidator = exports.CanvasConverter = exports.GraphConverter = exports.PathMatcher = exports.PathBasedEventProcessor = exports.GraphInstrumentationHelper = exports.ConfigurationValidator = exports.ValidationEngine = exports.EventProcessor = void 0;
-exports.OtelEventPathsValidator = exports.NamespacePathIndex = exports.ScopeEventsValidator = exports.EventsCanvasValidator = exports.getAllScopeNames = exports.buildScopeColorMap = exports.normalizeScopes = exports.getScopeColor = exports.getScopeDefinition = exports.getScopeNames = void 0;
+exports.OtelEventPathsValidator = exports.NamespacePathIndex = exports.ScopeEventsValidator = exports.EventsCanvasValidator = exports.validateAreaScopeDisjoint = exports.AuxiliaryManifestValidator = exports.getAllScopeNames = exports.buildScopeColorMap = exports.normalizeScopes = exports.getScopeColor = exports.getScopeDefinition = exports.getScopeNames = void 0;
 // Export all types (safe in all environments)
 __exportStar(require("./types"), exports);
 // Export core classes (Node.js processing)
@@ -135,6 +135,10 @@ Object.defineProperty(exports, "getScopeColor", { enumerable: true, get: functio
 Object.defineProperty(exports, "normalizeScopes", { enumerable: true, get: function () { return scopes_1.normalizeScopes; } });
 Object.defineProperty(exports, "buildScopeColorMap", { enumerable: true, get: function () { return scopes_1.buildScopeColorMap; } });
 Object.defineProperty(exports, "getAllScopeNames", { enumerable: true, get: function () { return scopes_1.getAllScopeNames; } });
+// Export auxiliary module (manifest validation for non-OTEL project regions)
+var auxiliary_1 = require("./auxiliary");
+Object.defineProperty(exports, "AuxiliaryManifestValidator", { enumerable: true, get: function () { return auxiliary_1.AuxiliaryManifestValidator; } });
+Object.defineProperty(exports, "validateAreaScopeDisjoint", { enumerable: true, get: function () { return auxiliary_1.validateAreaScopeDisjoint; } });
 // Export events module (canvas validation)
 var events_1 = require("./events");
 Object.defineProperty(exports, "EventsCanvasValidator", { enumerable: true, get: function () { return events_1.EventsCanvasValidator; } });

package/dist/node.js.map

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

package/dist/types/auxiliary.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Auxiliary Manifest Types
+ *
+ * The auxiliary manifest catalogs project regions that are *not* OTEL scopes —
+ * folders like `docs/` or `.github/` that support the project but don't emit
+ * telemetry. Scope paths and area paths together form a partition of the
+ * accounted-for filesystem.
+ *
+ * The manifest is open-ended: `areas` is the first section, but the top-level
+ * shape leaves room for future sibling sections (e.g. external integrations)
+ * without breaking the format.
+ */
+/**
+ * One project area — a folder (or file) that supports the project outside the
+ * OTEL telemetry surface.
+ */
+export interface ProjectArea {
+    /**
+     * Display name. Must be unique across all areas in the manifest — used as
+     * the area's identifier in diagnostics.
+     */
+    name: string;
+    /**
+     * One or more repo-relative paths owned by this area. Each entry may be a
+     * folder (covers all descendants) or a specific file. Paths must not
+     * overlap other areas, and must not overlap any scope path declared in a
+     * `.scopes.canvas`.
+     */
+    paths: string[];
+    /**
+     * Free-text purpose. The "light documentation" — a sentence about why this
+     * folder exists.
+     */
+    description: string;
+}
+/**
+ * The full manifest document. Persisted at
+ * `.principal-views/auxiliary.manifest.json`.
+ */
+export interface AuxiliaryManifest {
+    /**
+     * Optional pointer to the JSON Schema that describes this file. Lets editors
+     * give autocomplete and validation when the field is set.
+     */
+    $schema?: string;
+    /** Project areas declared in this manifest. */
+    areas: ProjectArea[];
+}
+/**
+ * Type guard: true when the value plausibly conforms to `AuxiliaryManifest`.
+ * Shallow check — full validation lives in `AuxiliaryManifestValidator`.
+ */
+export declare function isAuxiliaryManifest(value: unknown): value is AuxiliaryManifest;
+//# sourceMappingURL=auxiliary.d.ts.map

package/dist/types/auxiliary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary.d.ts","sourceRoot":"","sources":["../../src/types/auxiliary.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,KAAK,EAAE,MAAM,EAAE,CAAC;IAEhB;;;OAGG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,+CAA+C;IAC/C,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,iBAAiB,CAI9E"}

package/dist/types/auxiliary.js

@@ -0,0 +1,27 @@
+"use strict";
+/**
+ * Auxiliary Manifest Types
+ *
+ * The auxiliary manifest catalogs project regions that are *not* OTEL scopes —
+ * folders like `docs/` or `.github/` that support the project but don't emit
+ * telemetry. Scope paths and area paths together form a partition of the
+ * accounted-for filesystem.
+ *
+ * The manifest is open-ended: `areas` is the first section, but the top-level
+ * shape leaves room for future sibling sections (e.g. external integrations)
+ * without breaking the format.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isAuxiliaryManifest = void 0;
+/**
+ * Type guard: true when the value plausibly conforms to `AuxiliaryManifest`.
+ * Shallow check — full validation lives in `AuxiliaryManifestValidator`.
+ */
+function isAuxiliaryManifest(value) {
+    if (!value || typeof value !== 'object')
+        return false;
+    const v = value;
+    return Array.isArray(v.areas);
+}
+exports.isAuxiliaryManifest = isAuxiliaryManifest;
+//# sourceMappingURL=auxiliary.js.map

package/dist/types/auxiliary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auxiliary.js","sourceRoot":"","sources":["../../src/types/auxiliary.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;AA2CH;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IACtD,MAAM,CAAC,GAAG,KAA4B,CAAC;IACvC,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAJD,kDAIC"}

package/dist/types/index.d.ts

@@ -347,4 +347,5 @@ export * from './resource-match';
 export * from './canvas-scope';
 export * from './audit';
 export * from './dashboard';
+export * from './auxiliary';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -34,4 +34,5 @@ __exportStar(require("./resource-match"), exports);
 __exportStar(require("./canvas-scope"), exports);
 __exportStar(require("./audit"), exports);
 __exportStar(require("./dashboard"), exports);
+__exportStar(require("./auxiliary"), exports);
 //# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAkbH,+EAA+E;AAC/E,mDAAmD;AACnD,+EAA+E;AAE/E,sDAAoC;AAEpC,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,4CAA0B;AAE1B,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,yCAAuB;AACvB,mDAAiC;AACjC,iDAA+B;AAC/B,0CAAwB;AACxB,8CAA4B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;AAkbH,+EAA+E;AAC/E,mDAAmD;AACnD,+EAA+E;AAE/E,sDAAoC;AAEpC,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E,4CAA0B;AAE1B,+EAA+E;AAC/E,4CAA4C;AAC5C,+EAA+E;AAE/E,yCAAuB;AACvB,mDAAiC;AACjC,iDAA+B;AAC/B,0CAAwB;AACxB,8CAA4B;AAC5B,8CAA4B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principal-ai/principal-view-core",
-  "version": "0.28.3",
+  "version": "0.28.4",
   "description": "Core logic and types for graph-based principal view framework",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -21,6 +21,7 @@
   "files": [
     "dist",
     "src",
+    "schemas",
     "README.md"
   ],
   "scripts": {

package/schemas/auxiliary.manifest.schema.json

@@ -0,0 +1,48 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://principal-ai.dev/schemas/auxiliary.manifest.schema.json",
+  "title": "Auxiliary Manifest",
+  "description": "Catalogs project regions outside the OTEL telemetry surface (docs, .github, etc.). Lives at .principal-views/auxiliary.manifest.json.",
+  "type": "object",
+  "required": ["areas"],
+  "additionalProperties": false,
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Pointer to this schema for editor autocomplete."
+    },
+    "areas": {
+      "type": "array",
+      "description": "Project areas — folders or files that support the project but don't emit OTEL telemetry.",
+      "items": { "$ref": "#/definitions/projectArea" }
+    }
+  },
+  "definitions": {
+    "projectArea": {
+      "type": "object",
+      "required": ["name", "paths", "description"],
+      "additionalProperties": false,
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Display name. Must be unique across all areas in the manifest."
+        },
+        "paths": {
+          "type": "array",
+          "minItems": 1,
+          "description": "Repo-relative paths owned by this area. Folder or file. Must not overlap other areas or any scope path.",
+          "items": {
+            "type": "string",
+            "minLength": 1
+          }
+        },
+        "description": {
+          "type": "string",
+          "minLength": 1,
+          "description": "Free-text purpose — a sentence about why this folder exists."
+        }
+      }
+    }
+  }
+}

package/src/auxiliary/AuxiliaryManifestValidator.test.ts

@@ -0,0 +1,92 @@
+import { describe, expect, test } from 'bun:test';
+import { mkdtempSync, mkdirSync, writeFileSync } from 'fs';
+import { tmpdir } from 'os';
+import { join } from 'path';
+import { AuxiliaryManifestValidator } from './AuxiliaryManifestValidator';
+import type { AuxiliaryManifest } from '../types/auxiliary';
+
+function makeRepo(layout: string[]): string {
+  const root = mkdtempSync(join(tmpdir(), 'aux-manifest-'));
+  for (const rel of layout) {
+    const full = join(root, rel);
+    mkdirSync(full.substring(0, full.lastIndexOf('/')) || full, { recursive: true });
+    if (!rel.endsWith('/')) writeFileSync(full, '');
+  }
+  return root;
+}
+
+describe('AuxiliaryManifestValidator', () => {
+  const validator = new AuxiliaryManifestValidator();
+
+  test('no manifest is a no-op', () => {
+    const result = validator.validate({ basePath: '/tmp' });
+    expect(result.valid).toBe(true);
+    expect(result.violations).toHaveLength(0);
+  });
+
+  test('passes for a clean manifest', () => {
+    const root = makeRepo(['docs/README.md', '.github/workflows/ci.yml']);
+    const manifest: AuxiliaryManifest = {
+      areas: [
+        { name: 'Documentation', paths: ['docs'], description: 'design docs' },
+        { name: 'GitHub', paths: ['.github'], description: 'CI config' },
+      ],
+    };
+    const result = validator.validate({ manifest, basePath: root });
+    expect(result.valid).toBe(true);
+    expect(result.violations).toHaveLength(0);
+  });
+
+  test('flags duplicate area names', () => {
+    const root = makeRepo(['docs/README.md', 'misc/note.txt']);
+    const manifest: AuxiliaryManifest = {
+      areas: [
+        { name: 'Docs', paths: ['docs'], description: 'a' },
+        { name: 'Docs', paths: ['misc'], description: 'b' },
+      ],
+    };
+    const result = validator.validate({ manifest, basePath: root });
+    const dup = result.violations.find((v) => v.ruleId === 'auxiliary-area-name-duplicate');
+    expect(dup).toBeDefined();
+    expect(dup!.severity).toBe('error');
+    expect(result.valid).toBe(false);
+  });
+
+  test('warns when a declared path does not exist', () => {
+    const root = makeRepo(['docs/README.md']);
+    const manifest: AuxiliaryManifest = {
+      areas: [{ name: 'Ghost', paths: ['nope'], description: 'missing' }],
+    };
+    const result = validator.validate({ manifest, basePath: root });
+    const missing = result.violations.find((v) => v.ruleId === 'auxiliary-area-path-missing');
+    expect(missing).toBeDefined();
+    expect(missing!.severity).toBe('warn');
+    // Warnings alone don't invalidate the manifest
+    expect(result.valid).toBe(true);
+  });
+
+  test('flags overlap between two areas', () => {
+    const root = makeRepo(['docs/sub/file.md']);
+    const manifest: AuxiliaryManifest = {
+      areas: [
+        { name: 'A', paths: ['docs'], description: 'a' },
+        { name: 'B', paths: ['docs/sub'], description: 'b' },
+      ],
+    };
+    const result = validator.validate({ manifest, basePath: root });
+    const overlap = result.violations.find((v) => v.ruleId === 'auxiliary-area-paths-overlap');
+    expect(overlap).toBeDefined();
+    expect(overlap!.severity).toBe('error');
+    expect(result.valid).toBe(false);
+  });
+
+  test('flags duplicate paths within a single area as self-overlap', () => {
+    const root = makeRepo(['docs/file.md']);
+    const manifest: AuxiliaryManifest = {
+      areas: [{ name: 'A', paths: ['docs', 'docs'], description: 'a' }],
+    };
+    const result = validator.validate({ manifest, basePath: root });
+    const self = result.violations.find((v) => v.ruleId === 'auxiliary-area-paths-self-overlap');
+    expect(self).toBeDefined();
+  });
+});

package/src/auxiliary/AuxiliaryManifestValidator.ts

@@ -0,0 +1,129 @@
+/**
+ * Auxiliary Manifest Validator
+ *
+ * Own-file checks for `.principal-views/auxiliary.manifest.json`:
+ *   - area names are unique
+ *   - declared paths exist on disk
+ *   - paths don't overlap each other (within or across areas)
+ *
+ * Cross-file overlap with scope paths lives in `validateAreaScopeDisjoint`,
+ * mirroring the way `validateScopeNamespaceNesting` handles cross-canvas
+ * checks for scopes/namespaces.
+ */
+
+import { existsSync } from 'fs';
+import { resolve } from 'path';
+import type { AuxiliaryManifest } from '../types/auxiliary';
+import { pathsOverlap } from '../events/path-helpers';
+
+export interface AuxiliaryManifestValidationContext {
+  /** Parsed manifest. When absent, validation is a no-op (manifest is optional). */
+  manifest?: AuxiliaryManifest;
+
+  /** Path to the manifest file — used in violation messages. */
+  manifestPath?: string;
+
+  /** Repo root for resolving area paths against the filesystem. */
+  basePath: string;
+}
+
+export interface AuxiliaryManifestViolation {
+  ruleId: string;
+  severity: 'error' | 'warn';
+  file: string;
+  path?: string;
+  message: string;
+  impact: string;
+  suggestion: string;
+}
+
+export interface AuxiliaryManifestValidationResult {
+  valid: boolean;
+  violations: AuxiliaryManifestViolation[];
+}
+
+const DEFAULT_MANIFEST_PATH = '.principal-views/auxiliary.manifest.json';
+
+export class AuxiliaryManifestValidator {
+  validate(context: AuxiliaryManifestValidationContext): AuxiliaryManifestValidationResult {
+    const violations: AuxiliaryManifestViolation[] = [];
+    const { manifest, basePath } = context;
+    const file = context.manifestPath || DEFAULT_MANIFEST_PATH;
+
+    if (!manifest) {
+      return { valid: true, violations };
+    }
+
+    const areas = manifest.areas || [];
+
+    // Unique area names
+    const seenNames = new Map<string, number>();
+    areas.forEach((area, idx) => {
+      const count = seenNames.get(area.name) ?? 0;
+      seenNames.set(area.name, count + 1);
+      if (count === 1) {
+        violations.push({
+          ruleId: 'auxiliary-area-name-duplicate',
+          severity: 'error',
+          file,
+          path: `areas[${idx}].name`,
+          message: `Area name "${area.name}" is declared more than once`,
+          impact: 'Duplicate names make diagnostics ambiguous — a violation cannot be tied back to a single area',
+          suggestion: 'Rename one of the areas so names are unique across the manifest.',
+        });
+      }
+    });
+
+    // Path existence + collect for overlap pass
+    const declaredPaths: Array<{ areaName: string; areaIndex: number; pathIndex: number; path: string }> = [];
+    areas.forEach((area, areaIdx) => {
+      const paths = area.paths || [];
+      paths.forEach((p, pathIdx) => {
+        declaredPaths.push({ areaName: area.name, areaIndex: areaIdx, pathIndex: pathIdx, path: p });
+
+        const resolved = resolve(basePath, p);
+        if (!existsSync(resolved)) {
+          violations.push({
+            ruleId: 'auxiliary-area-path-missing',
+            severity: 'warn',
+            file,
+            path: `areas[${areaIdx}].paths[${pathIdx}]`,
+            message: `Path "${p}" declared by area "${area.name}" does not exist`,
+            impact: 'The manifest documents a folder that is not present in the repository',
+            suggestion: 'Verify the path exists relative to the repository root, or remove it from the area declaration.',
+          });
+        }
+      });
+    });
+
+    // Path overlap. Unlike scopes, areas have no dotted-name hierarchy, so
+    // parent-child nesting between two areas is just as ambiguous as a flat
+    // overlap — both are flagged.
+    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];
+        const relationship = pathsOverlap(a.path, b.path);
+        if (relationship === 'none') continue;
+
+        const sameArea = a.areaName === b.areaName;
+        violations.push({
+          ruleId: sameArea ? 'auxiliary-area-paths-self-overlap' : 'auxiliary-area-paths-overlap',
+          severity: 'error',
+          file,
+          path: sameArea
+            ? `areas[${a.areaIndex}].paths`
+            : undefined,
+          message: sameArea
+            ? `Area "${a.areaName}" declares overlapping paths "${a.path}" and "${b.path}"`
+            : `Paths overlap between areas "${a.areaName}" ("${a.path}") and "${b.areaName}" ("${b.path}")`,
+          impact: 'Two area declarations covering the same file make ownership ambiguous',
+          suggestion: 'Make the paths disjoint. If one folder genuinely sits inside another area, drop the redundant entry.',
+        });
+      }
+    }
+
+    const errors = violations.filter((v) => v.severity === 'error');
+    return { valid: errors.length === 0, violations };
+  }
+}

package/src/auxiliary/index.ts

@@ -0,0 +1,18 @@
+/**
+ * Auxiliary module
+ *
+ * Validation for `auxiliary.manifest.json` — the catalog of project regions
+ * that sit outside the OTEL telemetry surface (docs, .github, etc.).
+ */
+
+export {
+  AuxiliaryManifestValidator,
+  type AuxiliaryManifestValidationContext,
+  type AuxiliaryManifestValidationResult,
+  type AuxiliaryManifestViolation,
+} from './AuxiliaryManifestValidator';
+
+export {
+  validateAreaScopeDisjoint,
+  type ValidateAreaScopeDisjointInput,
+} from './validateAreaScopeDisjoint';

package/src/auxiliary/validateAreaScopeDisjoint.test.ts

@@ -0,0 +1,85 @@
+import { describe, expect, test } from 'bun:test';
+import { validateAreaScopeDisjoint } from './validateAreaScopeDisjoint';
+import type { AuxiliaryManifest } from '../types/auxiliary';
+import type { ExtendedCanvas } from '../types/canvas';
+
+function scopesCanvas(nodes: Array<{ scope: string; paths?: string[] }>): ExtendedCanvas {
+  return {
+    nodes: nodes.map((n, i) => ({
+      id: `s${i}`,
+      type: 'otel-scope',
+      description: `${n.scope} scope`,
+      ...(n.paths !== undefined ? { paths: n.paths } : {}),
+      otel: { scope: n.scope },
+      x: 0, y: 0, width: 100, height: 50,
+    })),
+    edges: [],
+  } as ExtendedCanvas;
+}
+
+describe('validateAreaScopeDisjoint', () => {
+  test('returns no violations when areas and scopes are disjoint', () => {
+    const manifest: AuxiliaryManifest = {
+      areas: [{ name: 'Docs', paths: ['docs'], description: 'd' }],
+    };
+    const violations = validateAreaScopeDisjoint({
+      manifest,
+      scopesCanvas: scopesCanvas([{ scope: 'core', paths: ['packages/core/src'] }]),
+    });
+    expect(violations).toHaveLength(0);
+  });
+
+  test('flags exact overlap with a scope path', () => {
+    const manifest: AuxiliaryManifest = {
+      areas: [{ name: 'Core', paths: ['packages/core/src'], description: 'd' }],
+    };
+    const violations = validateAreaScopeDisjoint({
+      manifest,
+      scopesCanvas: scopesCanvas([{ scope: 'core', paths: ['packages/core/src'] }]),
+    });
+    expect(violations).toHaveLength(1);
+    expect(violations[0].ruleId).toBe('auxiliary-area-scope-overlap');
+  });
+
+  test('flags parent-child overlap (area covering a scope path)', () => {
+    const manifest: AuxiliaryManifest = {
+      areas: [{ name: 'All', paths: ['packages'], description: 'd' }],
+    };
+    const violations = validateAreaScopeDisjoint({
+      manifest,
+      scopesCanvas: scopesCanvas([{ scope: 'core', paths: ['packages/core/src'] }]),
+    });
+    expect(violations).toHaveLength(1);
+    expect(violations[0].ruleId).toBe('auxiliary-area-scope-overlap');
+  });
+
+  test('flags parent-child overlap (scope path covering an area)', () => {
+    const manifest: AuxiliaryManifest = {
+      areas: [{ name: 'Inner', paths: ['packages/core/src/docs'], description: 'd' }],
+    };
+    const violations = validateAreaScopeDisjoint({
+      manifest,
+      scopesCanvas: scopesCanvas([{ scope: 'core', paths: ['packages/core/src'] }]),
+    });
+    expect(violations).toHaveLength(1);
+  });
+
+  test('no scopes canvas means no cross-check', () => {
+    const manifest: AuxiliaryManifest = {
+      areas: [{ name: 'Docs', paths: ['docs'], description: 'd' }],
+    };
+    const violations = validateAreaScopeDisjoint({ manifest });
+    expect(violations).toHaveLength(0);
+  });
+
+  test('scopes without paths impose no constraint', () => {
+    const manifest: AuxiliaryManifest = {
+      areas: [{ name: 'Docs', paths: ['docs'], description: 'd' }],
+    };
+    const violations = validateAreaScopeDisjoint({
+      manifest,
+      scopesCanvas: scopesCanvas([{ scope: 'core' }]),
+    });
+    expect(violations).toHaveLength(0);
+  });
+});

package/src/auxiliary/validateAreaScopeDisjoint.ts

@@ -0,0 +1,72 @@
+/**
+ * Area / Scope Disjointness Validator
+ *
+ * Cross-file check: project-area paths declared in
+ * `auxiliary.manifest.json` must be disjoint from every scope path declared
+ * in `architecture.scopes.canvas`. Areas and scopes carve up the repo into
+ * non-overlapping regions — any overlap (parent-child or otherwise) means a
+ * file is claimed by both an OTEL scope and an auxiliary area, which makes
+ * ownership ambiguous.
+ *
+ * Mirrors `validateScopeNamespaceNesting`'s cross-canvas pattern: takes both
+ * inputs, returns violations.
+ */
+
+import type { AuxiliaryManifest } from '../types/auxiliary';
+import type { ExtendedCanvas } from '../types/canvas';
+import { isOtelScopeNode } from '../types/canvas';
+import { pathsOverlap } from '../events/path-helpers';
+import type { AuxiliaryManifestViolation } from './AuxiliaryManifestValidator';
+
+export interface ValidateAreaScopeDisjointInput {
+  manifest: AuxiliaryManifest;
+  manifestPath?: string;
+  scopesCanvas?: ExtendedCanvas;
+  scopesCanvasPath?: string;
+}
+
+const DEFAULT_MANIFEST_PATH = '.principal-views/auxiliary.manifest.json';
+
+export function validateAreaScopeDisjoint(
+  input: ValidateAreaScopeDisjointInput,
+): AuxiliaryManifestViolation[] {
+  const { manifest, scopesCanvas } = input;
+  const manifestFile = input.manifestPath || DEFAULT_MANIFEST_PATH;
+
+  if (!scopesCanvas) return [];
+
+  const scopePaths: Array<{ scope: string; path: string }> = [];
+  for (const node of scopesCanvas.nodes || []) {
+    if (!isOtelScopeNode(node)) continue;
+    const scope = node.otel?.scope;
+    const paths = node.paths;
+    if (!scope || !paths || paths.length === 0) continue;
+    for (const p of paths) scopePaths.push({ scope, path: p });
+  }
+
+  if (scopePaths.length === 0) return [];
+
+  const violations: AuxiliaryManifestViolation[] = [];
+  const areas = manifest.areas || [];
+
+  areas.forEach((area, areaIdx) => {
+    (area.paths || []).forEach((areaPath, pathIdx) => {
+      for (const sp of scopePaths) {
+        const relationship = pathsOverlap(areaPath, sp.path);
+        if (relationship === 'none') continue;
+
+        violations.push({
+          ruleId: 'auxiliary-area-scope-overlap',
+          severity: 'error',
+          file: manifestFile,
+          path: `areas[${areaIdx}].paths[${pathIdx}]`,
+          message: `Area "${area.name}" path "${areaPath}" overlaps scope "${sp.scope}" path "${sp.path}"`,
+          impact: 'A file claimed by both an OTEL scope and an auxiliary area has ambiguous ownership — the manifest is meant to catalog regions outside the telemetry surface',
+          suggestion: 'Make the area path disjoint from every scope path. If the folder is genuinely runtime code, drop it from the manifest; if it is auxiliary, narrow the scope path or move the folder.',
+        });
+      }
+    });
+  });
+
+  return violations;
+}

package/src/node.ts

@@ -224,6 +224,18 @@ export type {
   NormalizedScope,
 } from './scopes';
 
+// Export auxiliary module (manifest validation for non-OTEL project regions)
+export {
+  AuxiliaryManifestValidator,
+  validateAreaScopeDisjoint,
+} from './auxiliary';
+export type {
+  AuxiliaryManifestValidationContext,
+  AuxiliaryManifestValidationResult,
+  AuxiliaryManifestViolation,
+  ValidateAreaScopeDisjointInput,
+} from './auxiliary';
+
 // Export events module (canvas validation)
 export {
   EventsCanvasValidator,

package/src/types/auxiliary.ts

@@ -0,0 +1,63 @@
+/**
+ * Auxiliary Manifest Types
+ *
+ * The auxiliary manifest catalogs project regions that are *not* OTEL scopes —
+ * folders like `docs/` or `.github/` that support the project but don't emit
+ * telemetry. Scope paths and area paths together form a partition of the
+ * accounted-for filesystem.
+ *
+ * The manifest is open-ended: `areas` is the first section, but the top-level
+ * shape leaves room for future sibling sections (e.g. external integrations)
+ * without breaking the format.
+ */
+
+/**
+ * One project area — a folder (or file) that supports the project outside the
+ * OTEL telemetry surface.
+ */
+export interface ProjectArea {
+  /**
+   * Display name. Must be unique across all areas in the manifest — used as
+   * the area's identifier in diagnostics.
+   */
+  name: string;
+
+  /**
+   * One or more repo-relative paths owned by this area. Each entry may be a
+   * folder (covers all descendants) or a specific file. Paths must not
+   * overlap other areas, and must not overlap any scope path declared in a
+   * `.scopes.canvas`.
+   */
+  paths: string[];
+
+  /**
+   * Free-text purpose. The "light documentation" — a sentence about why this
+   * folder exists.
+   */
+  description: string;
+}
+
+/**
+ * The full manifest document. Persisted at
+ * `.principal-views/auxiliary.manifest.json`.
+ */
+export interface AuxiliaryManifest {
+  /**
+   * Optional pointer to the JSON Schema that describes this file. Lets editors
+   * give autocomplete and validation when the field is set.
+   */
+  $schema?: string;
+
+  /** Project areas declared in this manifest. */
+  areas: ProjectArea[];
+}
+
+/**
+ * Type guard: true when the value plausibly conforms to `AuxiliaryManifest`.
+ * Shallow check — full validation lives in `AuxiliaryManifestValidator`.
+ */
+export function isAuxiliaryManifest(value: unknown): value is AuxiliaryManifest {
+  if (!value || typeof value !== 'object') return false;
+  const v = value as { areas?: unknown };
+  return Array.isArray(v.areas);
+}

package/src/types/index.ts

@@ -456,3 +456,4 @@ export * from './resource-match';
 export * from './canvas-scope';
 export * from './audit';
 export * from './dashboard';
+export * from './auxiliary';