@fractary/faber 0.1.1

package/dist/core/contexts/loader.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Context loader and resolver
+ */
+import { Context, ContextCategory, Role, Config } from '../../types';
+export declare class ContextLoader {
+    /**
+     * Load a single context file
+     */
+    loadContext(filePath: string, category: ContextCategory): Promise<Context>;
+    /**
+     * Load all contexts in a category
+     */
+    loadCategoryContexts(categoryPath: string, category: ContextCategory): Promise<Context[]>;
+    /**
+     * Load all contexts for a role
+     */
+    loadRoleContexts(rolePath: string): Promise<Map<string, Context>>;
+    /**
+     * Load platform context for a role
+     */
+    loadPlatformContext(role: Role, platform: string): Promise<Context | null>;
+    /**
+     * Load specialist context on demand
+     */
+    loadSpecialistContext(role: Role, specialistName: string): Promise<Context | null>;
+    /**
+     * Parse frontmatter from markdown content
+     */
+    private parseFrontmatter;
+}
+/**
+ * Context resolver for determining which contexts to load
+ */
+export declare class ContextResolver {
+    private loader;
+    constructor();
+    /**
+     * Resolve all contexts for a role (base + overlays)
+     */
+    resolveContexts(role: Role, config: Config, overlayPath?: string): Promise<Context[]>;
+    /**
+     * Detect platform from config
+     */
+    private detectPlatform;
+    /**
+     * Load contexts from a category
+     */
+    private loadCategoryContexts;
+    /**
+     * Load organization-level overlay contexts
+     */
+    private loadOrganizationOverlays;
+    /**
+     * Load platform-specific overlay contexts
+     */
+    private loadPlatformOverlays;
+    /**
+     * Load role-specific overlay contexts
+     */
+    private loadRoleOverlays;
+    /**
+     * Analyze user request to determine specialist contexts needed
+     */
+    analyzeRequestForSpecialists(request: string): string[];
+}
+//# sourceMappingURL=loader.d.ts.map

package/dist/core/contexts/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/core/contexts/loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EACL,OAAO,EACP,eAAe,EACf,IAAI,EACJ,MAAM,EACP,MAAM,aAAa,CAAC;AAErB,qBAAa,aAAa;IACxB;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,CAAC;IAcnB;;OAEG;IACG,oBAAoB,CACxB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,eAAe,GACxB,OAAO,CAAC,OAAO,EAAE,CAAC;IAmBrB;;OAEG;IACG,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAkBvE;;OAEG;IACG,mBAAmB,CACvB,IAAI,EAAE,IAAI,EACV,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAK1B;;OAEG;IACG,qBAAqB,CACzB,IAAI,EAAE,IAAI,EACV,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAK1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAkBzB;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAgB;;IAM9B;;OAEG;IACG,eAAe,CACnB,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,EAAE,CAAC;IAqCrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAUtB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;YACW,wBAAwB;IAuBtC;;OAEG;YACW,oBAAoB;IAmBlC;;OAEG;YACW,gBAAgB;IAmB9B;;OAEG;IACH,4BAA4B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE;CAwBxD"}

package/dist/core/contexts/loader.js

@@ -0,0 +1,261 @@
+"use strict";
+/**
+ * Context loader and resolver
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextResolver = exports.ContextLoader = void 0;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const yaml = __importStar(require("js-yaml"));
+const types_1 = require("../../types");
+class ContextLoader {
+    /**
+     * Load a single context file
+     */
+    async loadContext(filePath, category) {
+        const content = await fs.readFile(filePath, 'utf-8');
+        const name = path.basename(filePath, '.md');
+        const { metadata, body } = this.parseFrontmatter(content);
+        return {
+            category,
+            name,
+            content: body,
+            metadata: metadata,
+            path: filePath
+        };
+    }
+    /**
+     * Load all contexts in a category
+     */
+    async loadCategoryContexts(categoryPath, category) {
+        const contexts = [];
+        try {
+            const files = await fs.readdir(categoryPath);
+            const mdFiles = files.filter(f => f.endsWith('.md'));
+            for (const file of mdFiles) {
+                const filePath = path.join(categoryPath, file);
+                const context = await this.loadContext(filePath, category);
+                contexts.push(context);
+            }
+        }
+        catch {
+            // Category directory doesn't exist
+        }
+        return contexts;
+    }
+    /**
+     * Load all contexts for a role
+     */
+    async loadRoleContexts(rolePath) {
+        const contexts = new Map();
+        const contextsDir = path.join(rolePath, 'contexts');
+        const categories = Object.values(types_1.ContextCategory);
+        for (const category of categories) {
+            const categoryPath = path.join(contextsDir, category);
+            const categoryContexts = await this.loadCategoryContexts(categoryPath, category);
+            for (const context of categoryContexts) {
+                const key = `${category}/${context.name}`;
+                contexts.set(key, context);
+            }
+        }
+        return contexts;
+    }
+    /**
+     * Load platform context for a role
+     */
+    async loadPlatformContext(role, platform) {
+        const platformKey = `${types_1.ContextCategory.PLATFORM}/platform-${platform}`;
+        return role.contexts.get(platformKey) || null;
+    }
+    /**
+     * Load specialist context on demand
+     */
+    async loadSpecialistContext(role, specialistName) {
+        const specialistKey = `${types_1.ContextCategory.SPECIALIST}/specialist-${specialistName}`;
+        return role.contexts.get(specialistKey) || null;
+    }
+    /**
+     * Parse frontmatter from markdown content
+     */
+    parseFrontmatter(content) {
+        const frontmatterRegex = /^---\n([\s\S]*?)\n---\n([\s\S]*)$/;
+        const match = content.match(frontmatterRegex);
+        if (match) {
+            try {
+                const metadata = yaml.load(match[1]);
+                return { metadata, body: match[2] };
+            }
+            catch {
+                return { body: content };
+            }
+        }
+        return { body: content };
+    }
+}
+exports.ContextLoader = ContextLoader;
+/**
+ * Context resolver for determining which contexts to load
+ */
+class ContextResolver {
+    constructor() {
+        this.loader = new ContextLoader();
+    }
+    /**
+     * Resolve all contexts for a role (base + overlays)
+     */
+    async resolveContexts(role, config, overlayPath) {
+        const contexts = [];
+        // 1. Load platform context based on config
+        const platform = this.detectPlatform(role, config);
+        if (platform) {
+            const platformContext = await this.loader.loadPlatformContext(role, platform);
+            if (platformContext) {
+                contexts.push(platformContext);
+            }
+        }
+        // 2. Load organization overlays (if overlay path provided)
+        if (overlayPath) {
+            const orgContexts = await this.loadOrganizationOverlays(overlayPath);
+            contexts.push(...orgContexts);
+        }
+        // 3. Load platform overlays
+        if (overlayPath && platform) {
+            const platformOverlays = await this.loadPlatformOverlays(overlayPath, platform);
+            contexts.push(...platformOverlays);
+        }
+        // 4. Load base standards
+        const standards = this.loadCategoryContexts(role, types_1.ContextCategory.STANDARD);
+        contexts.push(...standards);
+        // 5. Load role overlays
+        if (overlayPath) {
+            const roleOverlays = await this.loadRoleOverlays(overlayPath, role.metadata.name);
+            contexts.push(...roleOverlays);
+        }
+        return contexts;
+    }
+    /**
+     * Detect platform from config
+     */
+    detectPlatform(role, config) {
+        // Check config for role-specific platform
+        if (config.platforms && role.metadata.platform_config_key) {
+            return config.platforms[role.metadata.platform_config_key] || null;
+        }
+        // Fall back to default platform
+        return role.metadata.default_platform || null;
+    }
+    /**
+     * Load contexts from a category
+     */
+    loadCategoryContexts(role, category) {
+        const contexts = [];
+        const prefix = `${category}/`;
+        for (const [key, context] of role.contexts) {
+            if (key.startsWith(prefix)) {
+                contexts.push(context);
+            }
+        }
+        return contexts;
+    }
+    /**
+     * Load organization-level overlay contexts
+     */
+    async loadOrganizationOverlays(overlayPath) {
+        const orgPath = path.join(overlayPath, 'organization', 'contexts');
+        const contexts = [];
+        // Load standards
+        const standardsPath = path.join(orgPath, 'standards');
+        const standards = await this.loader.loadCategoryContexts(standardsPath, types_1.ContextCategory.STANDARD);
+        contexts.push(...standards);
+        // Load references
+        const referencesPath = path.join(orgPath, 'references');
+        const references = await this.loader.loadCategoryContexts(referencesPath, types_1.ContextCategory.REFERENCE);
+        contexts.push(...references);
+        return contexts;
+    }
+    /**
+     * Load platform-specific overlay contexts
+     */
+    async loadPlatformOverlays(overlayPath, platform) {
+        const platformPath = path.join(overlayPath, 'platforms', platform, 'contexts');
+        const contexts = [];
+        for (const category of Object.values(types_1.ContextCategory)) {
+            const categoryPath = path.join(platformPath, category);
+            const categoryContexts = await this.loader.loadCategoryContexts(categoryPath, category);
+            contexts.push(...categoryContexts);
+        }
+        return contexts;
+    }
+    /**
+     * Load role-specific overlay contexts
+     */
+    async loadRoleOverlays(overlayPath, roleName) {
+        const rolePath = path.join(overlayPath, 'roles', roleName, 'contexts');
+        const contexts = [];
+        for (const category of Object.values(types_1.ContextCategory)) {
+            const categoryPath = path.join(rolePath, category);
+            const categoryContexts = await this.loader.loadCategoryContexts(categoryPath, category);
+            contexts.push(...categoryContexts);
+        }
+        return contexts;
+    }
+    /**
+     * Analyze user request to determine specialist contexts needed
+     */
+    analyzeRequestForSpecialists(request) {
+        const specialists = [];
+        const keywords = request.toLowerCase();
+        // Define keyword mappings to specialists
+        const specialistMappings = [
+            { keywords: ['sprint', 'iteration', 'planning'], specialist: 'sprint-planning' },
+            { keywords: ['security', 'vulnerability', 'audit'], specialist: 'security' },
+            { keywords: ['performance', 'optimization', 'latency'], specialist: 'performance' },
+            { keywords: ['monorepo', 'multi-package'], specialist: 'monorepo' },
+            { keywords: ['microservice', 'micro-service'], specialist: 'microservices' },
+            { keywords: ['docker', 'container', 'kubernetes'], specialist: 'containers' },
+            { keywords: ['ci', 'cd', 'pipeline', 'deployment'], specialist: 'cicd' },
+            { keywords: ['test', 'testing', 'tdd', 'bdd'], specialist: 'testing' }
+        ];
+        for (const mapping of specialistMappings) {
+            if (mapping.keywords.some(keyword => keywords.includes(keyword))) {
+                specialists.push(mapping.specialist);
+            }
+        }
+        return [...new Set(specialists)]; // Remove duplicates
+    }
+}
+exports.ContextResolver = ContextResolver;
+//# sourceMappingURL=loader.js.map

package/dist/core/contexts/loader.js.map

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

package/dist/core/overlays/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Overlay system exports
+ */
+export { OverlayResolver, Overlays, OverlayContent } from './resolver';
+import { Context } from '../../types';
+import { Overlays } from './resolver';
+/**
+ * Overlay utilities
+ */
+export declare class OverlayUtils {
+    /**
+     * Check if overlays are enabled
+     */
+    static hasOverlays(overlays: Overlays): boolean;
+    /**
+     * Count total overlay contexts
+     */
+    static countContexts(overlays: Overlays): number;
+    /**
+     * Find conflicts between base and overlay contexts
+     */
+    static findConflicts(baseContexts: Context[], overlayContexts: Context[]): Array<{
+        base: Context;
+        overlay: Context;
+    }>;
+    /**
+     * Apply merge strategy to conflicting contexts
+     */
+    static mergeConflicts(base: Context, overlay: Context, strategy?: 'override' | 'merge' | 'append'): Context;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/core/overlays/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/overlays/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEvE,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC;;GAEG;AACH,qBAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAU/C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM;IAsBhD;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,YAAY,EAAE,OAAO,EAAE,EACvB,eAAe,EAAE,OAAO,EAAE,GACzB,KAAK,CAAC;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAgB7C;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,OAAO,EAChB,QAAQ,GAAE,UAAU,GAAG,OAAO,GAAG,QAAqB,GACrD,OAAO;CAyBX"}

package/dist/core/overlays/index.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * Overlay system exports
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OverlayUtils = exports.OverlayResolver = void 0;
+var resolver_1 = require("./resolver");
+Object.defineProperty(exports, "OverlayResolver", { enumerable: true, get: function () { return resolver_1.OverlayResolver; } });
+/**
+ * Overlay utilities
+ */
+class OverlayUtils {
+    /**
+     * Check if overlays are enabled
+     */
+    static hasOverlays(overlays) {
+        return (overlays.organization.contexts.length > 0 ||
+            Object.keys(overlays.platforms).length > 0 ||
+            Object.keys(overlays.roles).length > 0 ||
+            Object.keys(overlays.teams).length > 0 ||
+            Object.keys(overlays.workflows).length > 0);
+    }
+    /**
+     * Count total overlay contexts
+     */
+    static countContexts(overlays) {
+        let count = overlays.organization.contexts.length;
+        for (const platform of Object.values(overlays.platforms)) {
+            count += platform.contexts.length;
+        }
+        for (const role of Object.values(overlays.roles)) {
+            count += role.contexts.length;
+        }
+        for (const team of Object.values(overlays.teams)) {
+            count += team.contexts.length;
+        }
+        for (const workflow of Object.values(overlays.workflows)) {
+            count += workflow.contexts.length;
+        }
+        return count;
+    }
+    /**
+     * Find conflicts between base and overlay contexts
+     */
+    static findConflicts(baseContexts, overlayContexts) {
+        const conflicts = [];
+        for (const overlay of overlayContexts) {
+            const base = baseContexts.find(b => b.category === overlay.category && b.name === overlay.name);
+            if (base) {
+                conflicts.push({ base, overlay });
+            }
+        }
+        return conflicts;
+    }
+    /**
+     * Apply merge strategy to conflicting contexts
+     */
+    static mergeConflicts(base, overlay, strategy = 'override') {
+        switch (strategy) {
+            case 'override':
+                // Overlay completely replaces base
+                return overlay;
+            case 'merge':
+                // Merge contents (overlay adds to base)
+                return {
+                    ...base,
+                    content: `${base.content}\n\n## Overlay Additions\n\n${overlay.content}`,
+                    metadata: { ...base.metadata, ...overlay.metadata }
+                };
+            case 'append':
+                // Append overlay requirements to base
+                return {
+                    ...base,
+                    content: `${base.content}\n\n## Additional Requirements (from overlay)\n\n${overlay.content}`
+                };
+            default:
+                return overlay;
+        }
+    }
+}
+exports.OverlayUtils = OverlayUtils;
+//# sourceMappingURL=index.js.map

package/dist/core/overlays/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/overlays/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,uCAAuE;AAA9D,2GAAA,eAAe,OAAA;AAKxB;;GAEG;AACH,MAAa,YAAY;IACvB;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAkB;QACnC,OAAO,CACL,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YACzC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC;YAC1C,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC;YACtC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAC3C,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAkB;QACrC,IAAI,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;QAElD,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpC,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChC,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACjD,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QAChC,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,KAAK,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;QACpC,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa,CAClB,YAAuB,EACvB,eAA0B;QAE1B,MAAM,SAAS,GAA+C,EAAE,CAAC;QAEjE,KAAK,MAAM,OAAO,IAAI,eAAe,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,CAC5B,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,IAAI,CAChE,CAAC;YAEF,IAAI,IAAI,EAAE,CAAC;gBACT,SAAS,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,cAAc,CACnB,IAAa,EACb,OAAgB,EAChB,WAA4C,UAAU;QAEtD,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,UAAU;gBACb,mCAAmC;gBACnC,OAAO,OAAO,CAAC;YAEjB,KAAK,OAAO;gBACV,wCAAwC;gBACxC,OAAO;oBACL,GAAG,IAAI;oBACP,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,+BAA+B,OAAO,CAAC,OAAO,EAAE;oBACxE,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE;iBACpD,CAAC;YAEJ,KAAK,QAAQ;gBACX,sCAAsC;gBACtC,OAAO;oBACL,GAAG,IAAI;oBACP,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,oDAAoD,OAAO,CAAC,OAAO,EAAE;iBAC9F,CAAC;YAEJ;gBACE,OAAO,OAAO,CAAC;QACnB,CAAC;IACH,CAAC;CACF;AA7FD,oCA6FC"}

package/dist/core/overlays/resolver.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Overlay system for customization without forking
+ */
+import { Context } from '../../types';
+export interface Overlays {
+    organization: OverlayContent;
+    platforms: Record<string, OverlayContent>;
+    roles: Record<string, OverlayContent>;
+    teams: Record<string, OverlayContent>;
+    workflows: Record<string, OverlayContent>;
+}
+export interface OverlayContent {
+    contexts: Context[];
+    config?: Record<string, unknown>;
+}
+export declare class OverlayResolver {
+    private contextLoader;
+    private overlayPath;
+    constructor(overlayPath?: string);
+    /**
+     * Resolve all overlays for a concept
+     */
+    resolveOverlays(conceptType: string, conceptName: string, platform?: string): Promise<Overlays>;
+    /**
+     * Load organization-level overlays
+     */
+    private loadOrganizationOverlays;
+    /**
+     * Load platform-specific overlays
+     */
+    private loadPlatformOverlays;
+    /**
+     * Load role-specific overlays
+     */
+    private loadRoleOverlays;
+    /**
+     * Load team-specific overlays
+     */
+    private loadTeamOverlays;
+    /**
+     * Load workflow-specific overlays
+     */
+    private loadWorkflowOverlays;
+    /**
+     * Load overlay content from a directory
+     */
+    private loadOverlayContent;
+    /**
+     * Load all contexts from overlay directory
+     */
+    private loadOverlayContexts;
+    /**
+     * Merge overlay configurations with precedence
+     */
+    mergeConfigurations(base: Record<string, unknown>, overlays: Overlays): Record<string, unknown>;
+    /**
+     * Deep merge two objects
+     */
+    private deepMerge;
+    /**
+     * Collect all contexts from overlays in precedence order
+     */
+    collectContexts(overlays: Overlays): Context[];
+}
+//# sourceMappingURL=resolver.d.ts.map

package/dist/core/overlays/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../../src/core/overlays/resolver.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,EAAE,OAAO,EAAmB,MAAM,aAAa,CAAC;AAGvD,MAAM,WAAW,QAAQ;IACvB,YAAY,EAAE,cAAc,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,GAAE,MAA0B;IAKnD;;OAEG;IACG,eAAe,CACnB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,QAAQ,CAAC;IA8BpB;;OAEG;YACW,wBAAwB;IAKtC;;OAEG;YACW,oBAAoB;IAKlC;;OAEG;YACW,gBAAgB;IAK9B;;OAEG;YACW,gBAAgB;IAK9B;;OAEG;YACW,oBAAoB;IAKlC;;OAEG;YACW,kBAAkB;IA6BhC;;OAEG;YACW,mBAAmB;IAsBjC;;OAEG;IACH,mBAAmB,CACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,QAAQ,GACjB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAwC1B;;OAEG;IACH,OAAO,CAAC,SAAS;IAkCjB;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,EAAE;CAwB/C"}