@dollhousemcp/mcp-server 1.3.0

package/dist/test/test/__tests__/security/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Security Testing Infrastructure for DollhouseMCP
+ *
+ * Provides comprehensive security testing to prevent vulnerabilities
+ * and ensure rapid validation of security patches.
+ */
+export { SecurityTestFramework, SecurityTestOptions, SecurityTestSuite } from './framework/SecurityTestFramework.js';
+export { RapidSecurityTesting, SecurityTestResult, preCommitSecurityCheck } from './framework/RapidSecurityTesting.js';
+/**
+ * Security Test Categories
+ *
+ * CRITICAL: Must pass before any release
+ * - Command injection
+ * - Path traversal
+ * - YAML deserialization
+ * - Authentication bypass
+ *
+ * HIGH: Should pass before release
+ * - Input validation
+ * - Token security
+ * - Rate limiting
+ * - SSRF protection
+ *
+ * MEDIUM: Good to have
+ * - Error handling
+ * - Logging security
+ * - Session management
+ */
+export declare const SECURITY_TEST_CATEGORIES: {
+    CRITICAL: string[];
+    HIGH: string[];
+    MEDIUM: string[];
+};
+/**
+ * Run all security tests
+ */
+export declare function runAllSecurityTests(): Promise<{
+    passed: boolean;
+    report: string;
+    duration: number;
+}>;
+/**
+ * Run rapid security check for CI/CD
+ */
+export declare function runRapidSecurityCheck(): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

package/dist/test/test/__tests__/security/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../test/__tests__/security/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AACrH,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAEvH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,wBAAwB;;;;CAkBpC,CAAC;AAEF;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC;IACnD,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC,CAgCD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,OAAO,CAAC,CAgB9D"}

package/dist/test/test/__tests__/security/index.js

@@ -0,0 +1,98 @@
+/**
+ * Security Testing Infrastructure for DollhouseMCP
+ *
+ * Provides comprehensive security testing to prevent vulnerabilities
+ * and ensure rapid validation of security patches.
+ */
+export { SecurityTestFramework } from './framework/SecurityTestFramework.js';
+export { RapidSecurityTesting, preCommitSecurityCheck } from './framework/RapidSecurityTesting.js';
+/**
+ * Security Test Categories
+ *
+ * CRITICAL: Must pass before any release
+ * - Command injection
+ * - Path traversal
+ * - YAML deserialization
+ * - Authentication bypass
+ *
+ * HIGH: Should pass before release
+ * - Input validation
+ * - Token security
+ * - Rate limiting
+ * - SSRF protection
+ *
+ * MEDIUM: Good to have
+ * - Error handling
+ * - Logging security
+ * - Session management
+ */
+export const SECURITY_TEST_CATEGORIES = {
+    CRITICAL: [
+        'Command Injection Prevention',
+        'Path Traversal Prevention',
+        'YAML Deserialization Safety',
+        'Authentication and Authorization'
+    ],
+    HIGH: [
+        'Input Validation',
+        'Token Security',
+        'Rate Limiting',
+        'SSRF Prevention'
+    ],
+    MEDIUM: [
+        'Error Message Security',
+        'Logging Security',
+        'Session Management'
+    ]
+};
+/**
+ * Run all security tests
+ */
+export async function runAllSecurityTests() {
+    const { SecurityTestFramework } = await import('./framework/SecurityTestFramework.js');
+    const start = Date.now();
+    const result = await SecurityTestFramework.runSecuritySuite({
+        category: 'all',
+        parallel: true
+    });
+    const duration = Date.now() - start;
+    const passed = result.failed === 0;
+    const report = `
+# Security Test Report
+
+## Summary
+- Total Tests: ${result.passed + result.failed}
+- Passed: ${result.passed}
+- Failed: ${result.failed}
+- Duration: ${duration}ms
+- Status: ${passed ? '✅ SECURE' : '❌ VULNERABLE'}
+
+## Categories Tested
+- CRITICAL: Command Injection, Path Traversal, YAML Safety
+- HIGH: Input Validation, Token Security, Rate Limiting
+- MEDIUM: Error Handling, Logging Security
+
+## Recommendation
+${passed ? 'System is secure and ready for deployment.' : 'Security vulnerabilities detected. Fix before deployment.'}
+`;
+    return { passed, report, duration };
+}
+/**
+ * Run rapid security check for CI/CD
+ */
+export async function runRapidSecurityCheck() {
+    const { RapidSecurityTesting } = await import('./framework/RapidSecurityTesting.js');
+    const tester = new RapidSecurityTesting();
+    const results = await tester.runCriticalTests();
+    const failed = results.filter(r => !r.passed);
+    if (failed.length > 0) {
+        console.error('❌ Critical security issues found:');
+        failed.forEach(r => {
+            console.error(`  - ${r.test}: ${r.error}`);
+        });
+        return false;
+    }
+    console.log('✅ All critical security tests passed');
+    return true;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi90ZXN0L19fdGVzdHNfXy9zZWN1cml0eS9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7R0FLRztBQUVILE9BQU8sRUFBRSxxQkFBcUIsRUFBMEMsTUFBTSxzQ0FBc0MsQ0FBQztBQUNySCxPQUFPLEVBQUUsb0JBQW9CLEVBQXNCLHNCQUFzQixFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFFdkg7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0FtQkc7QUFDSCxNQUFNLENBQUMsTUFBTSx3QkFBd0IsR0FBRztJQUN0QyxRQUFRLEVBQUU7UUFDUiw4QkFBOEI7UUFDOUIsMkJBQTJCO1FBQzNCLDZCQUE2QjtRQUM3QixrQ0FBa0M7S0FDbkM7SUFDRCxJQUFJLEVBQUU7UUFDSixrQkFBa0I7UUFDbEIsZ0JBQWdCO1FBQ2hCLGVBQWU7UUFDZixpQkFBaUI7S0FDbEI7SUFDRCxNQUFNLEVBQUU7UUFDTix3QkFBd0I7UUFDeEIsa0JBQWtCO1FBQ2xCLG9CQUFvQjtLQUNyQjtDQUNGLENBQUM7QUFFRjs7R0FFRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUsbUJBQW1CO0lBS3ZDLE1BQU0sRUFBRSxxQkFBcUIsRUFBRSxHQUFHLE1BQU0sTUFBTSxDQUFDLHNDQUFzQyxDQUFDLENBQUM7SUFDdkYsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO0lBRXpCLE1BQU0sTUFBTSxHQUFHLE1BQU0scUJBQXFCLENBQUMsZ0JBQWdCLENBQUM7UUFDMUQsUUFBUSxFQUFFLEtBQUs7UUFDZixRQUFRLEVBQUUsSUFBSTtLQUNmLENBQUMsQ0FBQztJQUVILE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxHQUFHLEVBQUUsR0FBRyxLQUFLLENBQUM7SUFDcEMsTUFBTSxNQUFNLEdBQUcsTUFBTSxDQUFDLE1BQU0sS0FBSyxDQUFDLENBQUM7SUFFbkMsTUFBTSxNQUFNLEdBQUc7Ozs7aUJBSUEsTUFBTSxDQUFDLE1BQU0sR0FBRyxNQUFNLENBQUMsTUFBTTtZQUNsQyxNQUFNLENBQUMsTUFBTTtZQUNiLE1BQU0sQ0FBQyxNQUFNO2NBQ1gsUUFBUTtZQUNWLE1BQU0sQ0FBQyxDQUFDLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQyxjQUFjOzs7Ozs7OztFQVE5QyxNQUFNLENBQUMsQ0FBQyxDQUFDLDRDQUE0QyxDQUFDLENBQUMsQ0FBQywyREFBMkQ7Q0FDcEgsQ0FBQztJQUVBLE9BQU8sRUFBRSxNQUFNLEVBQUUsTUFBTSxFQUFFLFFBQVEsRUFBRSxDQUFDO0FBQ3RDLENBQUM7QUFFRDs7R0FFRztBQUNILE1BQU0sQ0FBQyxLQUFLLFVBQVUscUJBQXFCO0lBQ3pDLE1BQU0sRUFBRSxvQkFBb0IsRUFBRSxHQUFHLE1BQU0sTUFBTSxDQUFDLHFDQUFxQyxDQUFDLENBQUM7SUFDckYsTUFBTSxNQUFNLEdBQUcsSUFBSSxvQkFBb0IsRUFBRSxDQUFDO0lBQzFDLE1BQU0sT0FBTyxHQUFHLE1BQU0sTUFBTSxDQUFDLGdCQUFnQixFQUFFLENBQUM7SUFFaEQsTUFBTSxNQUFNLEdBQUcsT0FBTyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBRSxDQUFDLENBQUMsQ0FBQyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQzlDLElBQUksTUFBTSxDQUFDLE1BQU0sR0FBRyxDQUFDLEVBQUUsQ0FBQztRQUN0QixPQUFPLENBQUMsS0FBSyxDQUFDLG1DQUFtQyxDQUFDLENBQUM7UUFDbkQsTUFBTSxDQUFDLE9BQU8sQ0FBQyxDQUFDLENBQUMsRUFBRTtZQUNqQixPQUFPLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDLElBQUksS0FBSyxDQUFDLENBQUMsS0FBSyxFQUFFLENBQUMsQ0FBQztRQUM3QyxDQUFDLENBQUMsQ0FBQztRQUNILE9BQU8sS0FBSyxDQUFDO0lBQ2YsQ0FBQztJQUVELE9BQU8sQ0FBQyxHQUFHLENBQUMsc0NBQXNDLENBQUMsQ0FBQztJQUNwRCxPQUFPLElBQUksQ0FBQztBQUNkLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIFNlY3VyaXR5IFRlc3RpbmcgSW5mcmFzdHJ1Y3R1cmUgZm9yIERvbGxob3VzZU1DUFxuICogXG4gKiBQcm92aWRlcyBjb21wcmVoZW5zaXZlIHNlY3VyaXR5IHRlc3RpbmcgdG8gcHJldmVudCB2dWxuZXJhYmlsaXRpZXNcbiAqIGFuZCBlbnN1cmUgcmFwaWQgdmFsaWRhdGlvbiBvZiBzZWN1cml0eSBwYXRjaGVzLlxuICovXG5cbmV4cG9ydCB7IFNlY3VyaXR5VGVzdEZyYW1ld29yaywgU2VjdXJpdHlUZXN0T3B0aW9ucywgU2VjdXJpdHlUZXN0U3VpdGUgfSBmcm9tICcuL2ZyYW1ld29yay9TZWN1cml0eVRlc3RGcmFtZXdvcmsuanMnO1xuZXhwb3J0IHsgUmFwaWRTZWN1cml0eVRlc3RpbmcsIFNlY3VyaXR5VGVzdFJlc3VsdCwgcHJlQ29tbWl0U2VjdXJpdHlDaGVjayB9IGZyb20gJy4vZnJhbWV3b3JrL1JhcGlkU2VjdXJpdHlUZXN0aW5nLmpzJztcblxuLyoqXG4gKiBTZWN1cml0eSBUZXN0IENhdGVnb3JpZXNcbiAqIFxuICogQ1JJVElDQUw6IE11c3QgcGFzcyBiZWZvcmUgYW55IHJlbGVhc2VcbiAqIC0gQ29tbWFuZCBpbmplY3Rpb25cbiAqIC0gUGF0aCB0cmF2ZXJzYWxcbiAqIC0gWUFNTCBkZXNlcmlhbGl6YXRpb25cbiAqIC0gQXV0aGVudGljYXRpb24gYnlwYXNzXG4gKiBcbiAqIEhJR0g6IFNob3VsZCBwYXNzIGJlZm9yZSByZWxlYXNlXG4gKiAtIElucHV0IHZhbGlkYXRpb25cbiAqIC0gVG9rZW4gc2VjdXJpdHlcbiAqIC0gUmF0ZSBsaW1pdGluZ1xuICogLSBTU1JGIHByb3RlY3Rpb25cbiAqIFxuICogTUVESVVNOiBHb29kIHRvIGhhdmVcbiAqIC0gRXJyb3IgaGFuZGxpbmdcbiAqIC0gTG9nZ2luZyBzZWN1cml0eVxuICogLSBTZXNzaW9uIG1hbmFnZW1lbnRcbiAqL1xuZXhwb3J0IGNvbnN0IFNFQ1VSSVRZX1RFU1RfQ0FURUdPUklFUyA9IHtcbiAgQ1JJVElDQUw6IFtcbiAgICAnQ29tbWFuZCBJbmplY3Rpb24gUHJldmVudGlvbicsXG4gICAgJ1BhdGggVHJhdmVyc2FsIFByZXZlbnRpb24nLFxuICAgICdZQU1MIERlc2VyaWFsaXphdGlvbiBTYWZldHknLFxuICAgICdBdXRoZW50aWNhdGlvbiBhbmQgQXV0aG9yaXphdGlvbidcbiAgXSxcbiAgSElHSDogW1xuICAgICdJbnB1dCBWYWxpZGF0aW9uJyxcbiAgICAnVG9rZW4gU2VjdXJpdHknLFxuICAgICdSYXRlIExpbWl0aW5nJyxcbiAgICAnU1NSRiBQcmV2ZW50aW9uJ1xuICBdLFxuICBNRURJVU06IFtcbiAgICAnRXJyb3IgTWVzc2FnZSBTZWN1cml0eScsXG4gICAgJ0xvZ2dpbmcgU2VjdXJpdHknLFxuICAgICdTZXNzaW9uIE1hbmFnZW1lbnQnXG4gIF1cbn07XG5cbi8qKlxuICogUnVuIGFsbCBzZWN1cml0eSB0ZXN0c1xuICovXG5leHBvcnQgYXN5bmMgZnVuY3Rpb24gcnVuQWxsU2VjdXJpdHlUZXN0cygpOiBQcm9taXNlPHtcbiAgcGFzc2VkOiBib29sZWFuO1xuICByZXBvcnQ6IHN0cmluZztcbiAgZHVyYXRpb246IG51bWJlcjtcbn0+IHtcbiAgY29uc3QgeyBTZWN1cml0eVRlc3RGcmFtZXdvcmsgfSA9IGF3YWl0IGltcG9ydCgnLi9mcmFtZXdvcmsvU2VjdXJpdHlUZXN0RnJhbWV3b3JrLmpzJyk7XG4gIGNvbnN0IHN0YXJ0ID0gRGF0ZS5ub3coKTtcbiAgXG4gIGNvbnN0IHJlc3VsdCA9IGF3YWl0IFNlY3VyaXR5VGVzdEZyYW1ld29yay5ydW5TZWN1cml0eVN1aXRlKHtcbiAgICBjYXRlZ29yeTogJ2FsbCcsXG4gICAgcGFyYWxsZWw6IHRydWVcbiAgfSk7XG4gIFxuICBjb25zdCBkdXJhdGlvbiA9IERhdGUubm93KCkgLSBzdGFydDtcbiAgY29uc3QgcGFzc2VkID0gcmVzdWx0LmZhaWxlZCA9PT0gMDtcbiAgXG4gIGNvbnN0IHJlcG9ydCA9IGBcbiMgU2VjdXJpdHkgVGVzdCBSZXBvcnRcblxuIyMgU3VtbWFyeVxuLSBUb3RhbCBUZXN0czogJHtyZXN1bHQucGFzc2VkICsgcmVzdWx0LmZhaWxlZH1cbi0gUGFzc2VkOiAke3Jlc3VsdC5wYXNzZWR9XG4tIEZhaWxlZDogJHtyZXN1bHQuZmFpbGVkfVxuLSBEdXJhdGlvbjogJHtkdXJhdGlvbn1tc1xuLSBTdGF0dXM6ICR7cGFzc2VkID8gJ+KchSBTRUNVUkUnIDogJ+KdjCBWVUxORVJBQkxFJ31cblxuIyMgQ2F0ZWdvcmllcyBUZXN0ZWRcbi0gQ1JJVElDQUw6IENvbW1hbmQgSW5qZWN0aW9uLCBQYXRoIFRyYXZlcnNhbCwgWUFNTCBTYWZldHlcbi0gSElHSDogSW5wdXQgVmFsaWRhdGlvbiwgVG9rZW4gU2VjdXJpdHksIFJhdGUgTGltaXRpbmdcbi0gTUVESVVNOiBFcnJvciBIYW5kbGluZywgTG9nZ2luZyBTZWN1cml0eVxuXG4jIyBSZWNvbW1lbmRhdGlvblxuJHtwYXNzZWQgPyAnU3lzdGVtIGlzIHNlY3VyZSBhbmQgcmVhZHkgZm9yIGRlcGxveW1lbnQuJyA6ICdTZWN1cml0eSB2dWxuZXJhYmlsaXRpZXMgZGV0ZWN0ZWQuIEZpeCBiZWZvcmUgZGVwbG95bWVudC4nfVxuYDtcbiAgXG4gIHJldHVybiB7IHBhc3NlZCwgcmVwb3J0LCBkdXJhdGlvbiB9O1xufVxuXG4vKipcbiAqIFJ1biByYXBpZCBzZWN1cml0eSBjaGVjayBmb3IgQ0kvQ0RcbiAqL1xuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIHJ1blJhcGlkU2VjdXJpdHlDaGVjaygpOiBQcm9taXNlPGJvb2xlYW4+IHtcbiAgY29uc3QgeyBSYXBpZFNlY3VyaXR5VGVzdGluZyB9ID0gYXdhaXQgaW1wb3J0KCcuL2ZyYW1ld29yay9SYXBpZFNlY3VyaXR5VGVzdGluZy5qcycpO1xuICBjb25zdCB0ZXN0ZXIgPSBuZXcgUmFwaWRTZWN1cml0eVRlc3RpbmcoKTtcbiAgY29uc3QgcmVzdWx0cyA9IGF3YWl0IHRlc3Rlci5ydW5Dcml0aWNhbFRlc3RzKCk7XG4gIFxuICBjb25zdCBmYWlsZWQgPSByZXN1bHRzLmZpbHRlcihyID0+ICFyLnBhc3NlZCk7XG4gIGlmIChmYWlsZWQubGVuZ3RoID4gMCkge1xuICAgIGNvbnNvbGUuZXJyb3IoJ+KdjCBDcml0aWNhbCBzZWN1cml0eSBpc3N1ZXMgZm91bmQ6Jyk7XG4gICAgZmFpbGVkLmZvckVhY2gociA9PiB7XG4gICAgICBjb25zb2xlLmVycm9yKGAgIC0gJHtyLnRlc3R9OiAke3IuZXJyb3J9YCk7XG4gICAgfSk7XG4gICAgcmV0dXJuIGZhbHNlO1xuICB9XG4gIFxuICBjb25zb2xlLmxvZygn4pyFIEFsbCBjcml0aWNhbCBzZWN1cml0eSB0ZXN0cyBwYXNzZWQnKTtcbiAgcmV0dXJuIHRydWU7XG59Il19

package/dist/test/test/__tests__/security/setup.d.ts

@@ -0,0 +1,3 @@
+export { SecurityTestFramework } from './framework/SecurityTestFramework.js';
+export { RapidSecurityTesting } from './framework/RapidSecurityTesting.js';
+//# sourceMappingURL=setup.d.ts.map

package/dist/test/test/__tests__/security/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../../../test/__tests__/security/setup.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAC7E,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/test/test/__tests__/security/setup.js

@@ -0,0 +1,23 @@
+import { jest } from '@jest/globals';
+// Security test timeouts
+jest.setTimeout(30000); // 30 seconds max per test
+// Mock dangerous operations during tests
+global.console.warn = jest.fn();
+global.console.error = jest.fn();
+// Ensure tests run in isolated environment
+process.env.NODE_ENV = 'test';
+process.env.SECURITY_TEST = 'true';
+// Mock file system for security tests
+jest.mock('fs/promises', () => {
+    const actual = jest.requireActual('fs/promises');
+    return {
+        ...actual,
+        unlink: jest.fn(),
+        rmdir: jest.fn(),
+        rm: jest.fn()
+    };
+});
+// Export test utilities
+export { SecurityTestFramework } from './framework/SecurityTestFramework.js';
+export { RapidSecurityTesting } from './framework/RapidSecurityTesting.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2V0dXAuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi8uLi90ZXN0L19fdGVzdHNfXy9zZWN1cml0eS9zZXR1cC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsSUFBSSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBRXJDLHlCQUF5QjtBQUN6QixJQUFJLENBQUMsVUFBVSxDQUFDLEtBQUssQ0FBQyxDQUFDLENBQUMsMEJBQTBCO0FBRWxELHlDQUF5QztBQUN6QyxNQUFNLENBQUMsT0FBTyxDQUFDLElBQUksR0FBRyxJQUFJLENBQUMsRUFBRSxFQUFFLENBQUM7QUFDaEMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxLQUFLLEdBQUcsSUFBSSxDQUFDLEVBQUUsRUFBRSxDQUFDO0FBRWpDLDJDQUEyQztBQUMzQyxPQUFPLENBQUMsR0FBRyxDQUFDLFFBQVEsR0FBRyxNQUFNLENBQUM7QUFDOUIsT0FBTyxDQUFDLEdBQUcsQ0FBQyxhQUFhLEdBQUcsTUFBTSxDQUFDO0FBRW5DLHNDQUFzQztBQUN0QyxJQUFJLENBQUMsSUFBSSxDQUFDLGFBQWEsRUFBRSxHQUFHLEVBQUU7SUFDNUIsTUFBTSxNQUFNLEdBQUcsSUFBSSxDQUFDLGFBQWEsQ0FBQyxhQUFhLENBQVEsQ0FBQztJQUN4RCxPQUFPO1FBQ0wsR0FBRyxNQUFNO1FBQ1QsTUFBTSxFQUFFLElBQUksQ0FBQyxFQUFFLEVBQUU7UUFDakIsS0FBSyxFQUFFLElBQUksQ0FBQyxFQUFFLEVBQUU7UUFDaEIsRUFBRSxFQUFFLElBQUksQ0FBQyxFQUFFLEVBQUU7S0FDZCxDQUFDO0FBQ0osQ0FBQyxDQUFDLENBQUM7QUFFSCx3QkFBd0I7QUFDeEIsT0FBTyxFQUFFLHFCQUFxQixFQUFFLE1BQU0sc0NBQXNDLENBQUM7QUFDN0UsT0FBTyxFQUFFLG9CQUFvQixFQUFFLE1BQU0scUNBQXFDLENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgeyBqZXN0IH0gZnJvbSAnQGplc3QvZ2xvYmFscyc7XG5cbi8vIFNlY3VyaXR5IHRlc3QgdGltZW91dHNcbmplc3Quc2V0VGltZW91dCgzMDAwMCk7IC8vIDMwIHNlY29uZHMgbWF4IHBlciB0ZXN0XG5cbi8vIE1vY2sgZGFuZ2Vyb3VzIG9wZXJhdGlvbnMgZHVyaW5nIHRlc3RzXG5nbG9iYWwuY29uc29sZS53YXJuID0gamVzdC5mbigpO1xuZ2xvYmFsLmNvbnNvbGUuZXJyb3IgPSBqZXN0LmZuKCk7XG5cbi8vIEVuc3VyZSB0ZXN0cyBydW4gaW4gaXNvbGF0ZWQgZW52aXJvbm1lbnRcbnByb2Nlc3MuZW52Lk5PREVfRU5WID0gJ3Rlc3QnO1xucHJvY2Vzcy5lbnYuU0VDVVJJVFlfVEVTVCA9ICd0cnVlJztcblxuLy8gTW9jayBmaWxlIHN5c3RlbSBmb3Igc2VjdXJpdHkgdGVzdHNcbmplc3QubW9jaygnZnMvcHJvbWlzZXMnLCAoKSA9PiB7XG4gIGNvbnN0IGFjdHVhbCA9IGplc3QucmVxdWlyZUFjdHVhbCgnZnMvcHJvbWlzZXMnKSBhcyBhbnk7XG4gIHJldHVybiB7XG4gICAgLi4uYWN0dWFsLFxuICAgIHVubGluazogamVzdC5mbigpLFxuICAgIHJtZGlyOiBqZXN0LmZuKCksXG4gICAgcm06IGplc3QuZm4oKVxuICB9O1xufSk7XG5cbi8vIEV4cG9ydCB0ZXN0IHV0aWxpdGllc1xuZXhwb3J0IHsgU2VjdXJpdHlUZXN0RnJhbWV3b3JrIH0gZnJvbSAnLi9mcmFtZXdvcmsvU2VjdXJpdHlUZXN0RnJhbWV3b3JrLmpzJztcbmV4cG9ydCB7IFJhcGlkU2VjdXJpdHlUZXN0aW5nIH0gZnJvbSAnLi9mcmFtZXdvcmsvUmFwaWRTZWN1cml0eVRlc3RpbmcuanMnOyJdfQ==

package/dist/tools/debug.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Debug tools for retrieving server logs
+ */
+export interface GetLogsArgs {
+    count?: number;
+    level?: 'debug' | 'info' | 'warn' | 'error';
+}
+export declare function getServerLogs(args: GetLogsArgs): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+export declare function clearServerLogs(): Promise<{
+    content: {
+        type: string;
+        text: string;
+    }[];
+}>;
+//# sourceMappingURL=debug.d.ts.map

package/dist/tools/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../../src/tools/debug.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC7C;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,WAAW;;;;;GAwBpD;AAED,wBAAsB,eAAe;;;;;GAWpC"}

package/dist/tools/debug.js

@@ -0,0 +1,37 @@
+/**
+ * Debug tools for retrieving server logs
+ */
+import { logger } from '../utils/logger.js';
+export async function getServerLogs(args) {
+    const { count = 100, level } = args;
+    const logs = logger.getLogs(count, level);
+    // Format logs for display
+    const formattedLogs = logs.map(log => {
+        const timestamp = log.timestamp.toISOString();
+        const logLevel = log.level.toUpperCase().padEnd(5);
+        const message = log.data
+            ? `${log.message} ${JSON.stringify(log.data, null, 2)}`
+            : log.message;
+        return `[${timestamp}] [${logLevel}] ${message}`;
+    }).join('\n');
+    return {
+        content: [
+            {
+                type: "text",
+                text: formattedLogs || "No logs found matching the criteria",
+            },
+        ],
+    };
+}
+export async function clearServerLogs() {
+    logger.clearLogs();
+    return {
+        content: [
+            {
+                type: "text",
+                text: "Server logs cleared successfully",
+            },
+        ],
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVidWcuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdG9vbHMvZGVidWcudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUc7QUFFSCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sb0JBQW9CLENBQUM7QUFPNUMsTUFBTSxDQUFDLEtBQUssVUFBVSxhQUFhLENBQUMsSUFBaUI7SUFDbkQsTUFBTSxFQUFFLEtBQUssR0FBRyxHQUFHLEVBQUUsS0FBSyxFQUFFLEdBQUcsSUFBSSxDQUFDO0lBRXBDLE1BQU0sSUFBSSxHQUFHLE1BQU0sQ0FBQyxPQUFPLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxDQUFDO0lBRTFDLDBCQUEwQjtJQUMxQixNQUFNLGFBQWEsR0FBRyxJQUFJLENBQUMsR0FBRyxDQUFDLEdBQUcsQ0FBQyxFQUFFO1FBQ25DLE1BQU0sU0FBUyxHQUFHLEdBQUcsQ0FBQyxTQUFTLENBQUMsV0FBVyxFQUFFLENBQUM7UUFDOUMsTUFBTSxRQUFRLEdBQUcsR0FBRyxDQUFDLEtBQUssQ0FBQyxXQUFXLEVBQUUsQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDLENBQUM7UUFDbkQsTUFBTSxPQUFPLEdBQUcsR0FBRyxDQUFDLElBQUk7WUFDdEIsQ0FBQyxDQUFDLEdBQUcsR0FBRyxDQUFDLE9BQU8sSUFBSSxJQUFJLENBQUMsU0FBUyxDQUFDLEdBQUcsQ0FBQyxJQUFJLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQyxFQUFFO1lBQ3ZELENBQUMsQ0FBQyxHQUFHLENBQUMsT0FBTyxDQUFDO1FBRWhCLE9BQU8sSUFBSSxTQUFTLE1BQU0sUUFBUSxLQUFLLE9BQU8sRUFBRSxDQUFDO0lBQ25ELENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUVkLE9BQU87UUFDTCxPQUFPLEVBQUU7WUFDUDtnQkFDRSxJQUFJLEVBQUUsTUFBTTtnQkFDWixJQUFJLEVBQUUsYUFBYSxJQUFJLHFDQUFxQzthQUM3RDtTQUNGO0tBQ0YsQ0FBQztBQUNKLENBQUM7QUFFRCxNQUFNLENBQUMsS0FBSyxVQUFVLGVBQWU7SUFDbkMsTUFBTSxDQUFDLFNBQVMsRUFBRSxDQUFDO0lBRW5CLE9BQU87UUFDTCxPQUFPLEVBQUU7WUFDUDtnQkFDRSxJQUFJLEVBQUUsTUFBTTtnQkFDWixJQUFJLEVBQUUsa0NBQWtDO2FBQ3pDO1NBQ0Y7S0FDRixDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogRGVidWcgdG9vbHMgZm9yIHJldHJpZXZpbmcgc2VydmVyIGxvZ3NcbiAqL1xuXG5pbXBvcnQgeyBsb2dnZXIgfSBmcm9tICcuLi91dGlscy9sb2dnZXIuanMnO1xuXG5leHBvcnQgaW50ZXJmYWNlIEdldExvZ3NBcmdzIHtcbiAgY291bnQ/OiBudW1iZXI7XG4gIGxldmVsPzogJ2RlYnVnJyB8ICdpbmZvJyB8ICd3YXJuJyB8ICdlcnJvcic7XG59XG5cbmV4cG9ydCBhc3luYyBmdW5jdGlvbiBnZXRTZXJ2ZXJMb2dzKGFyZ3M6IEdldExvZ3NBcmdzKSB7XG4gIGNvbnN0IHsgY291bnQgPSAxMDAsIGxldmVsIH0gPSBhcmdzO1xuICBcbiAgY29uc3QgbG9ncyA9IGxvZ2dlci5nZXRMb2dzKGNvdW50LCBsZXZlbCk7XG4gIFxuICAvLyBGb3JtYXQgbG9ncyBmb3IgZGlzcGxheVxuICBjb25zdCBmb3JtYXR0ZWRMb2dzID0gbG9ncy5tYXAobG9nID0+IHtcbiAgICBjb25zdCB0aW1lc3RhbXAgPSBsb2cudGltZXN0YW1wLnRvSVNPU3RyaW5nKCk7XG4gICAgY29uc3QgbG9nTGV2ZWwgPSBsb2cubGV2ZWwudG9VcHBlckNhc2UoKS5wYWRFbmQoNSk7XG4gICAgY29uc3QgbWVzc2FnZSA9IGxvZy5kYXRhIFxuICAgICAgPyBgJHtsb2cubWVzc2FnZX0gJHtKU09OLnN0cmluZ2lmeShsb2cuZGF0YSwgbnVsbCwgMil9YFxuICAgICAgOiBsb2cubWVzc2FnZTtcbiAgICBcbiAgICByZXR1cm4gYFske3RpbWVzdGFtcH1dIFske2xvZ0xldmVsfV0gJHttZXNzYWdlfWA7XG4gIH0pLmpvaW4oJ1xcbicpO1xuICBcbiAgcmV0dXJuIHtcbiAgICBjb250ZW50OiBbXG4gICAgICB7XG4gICAgICAgIHR5cGU6IFwidGV4dFwiLFxuICAgICAgICB0ZXh0OiBmb3JtYXR0ZWRMb2dzIHx8IFwiTm8gbG9ncyBmb3VuZCBtYXRjaGluZyB0aGUgY3JpdGVyaWFcIixcbiAgICAgIH0sXG4gICAgXSxcbiAgfTtcbn1cblxuZXhwb3J0IGFzeW5jIGZ1bmN0aW9uIGNsZWFyU2VydmVyTG9ncygpIHtcbiAgbG9nZ2VyLmNsZWFyTG9ncygpO1xuICBcbiAgcmV0dXJuIHtcbiAgICBjb250ZW50OiBbXG4gICAgICB7XG4gICAgICAgIHR5cGU6IFwidGV4dFwiLFxuICAgICAgICB0ZXh0OiBcIlNlcnZlciBsb2dzIGNsZWFyZWQgc3VjY2Vzc2Z1bGx5XCIsXG4gICAgICB9LFxuICAgIF0sXG4gIH07XG59Il19

package/dist/types/cache.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for caching system
+ */
+export interface CacheEntry {
+    data: any;
+    timestamp: number;
+}
+//# sourceMappingURL=cache.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/types/cache.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,GAAG,CAAC;IACV,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/cache.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for caching system
+ */
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2FjaGUuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMvY2FjaGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7O0dBRUciLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIFR5cGUgZGVmaW5pdGlvbnMgZm9yIGNhY2hpbmcgc3lzdGVtXG4gKi9cblxuZXhwb3J0IGludGVyZmFjZSBDYWNoZUVudHJ5IHtcbiAgZGF0YTogYW55O1xuICB0aW1lc3RhbXA6IG51bWJlcjtcbn0iXX0=

package/dist/types/collection.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Type definitions for collection functionality
+ */
+export interface CollectionContent {
+    name: string;
+    path: string;
+    sha: string;
+    size: number;
+    download_url: string;
+    html_url: string;
+}
+export interface CollectionSearchResult {
+    path: string;
+    html_url: string;
+    repository: {
+        full_name: string;
+    };
+    text_matches?: Array<{
+        fragment: string;
+        property: string;
+    }>;
+}
+//# sourceMappingURL=collection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"collection.d.ts","sourceRoot":"","sources":["../../src/types/collection.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,YAAY,CAAC,EAAE,KAAK,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;CACJ"}

package/dist/types/collection.js

@@ -0,0 +1,5 @@
+/**
+ * Type definitions for collection functionality
+ */
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY29sbGVjdGlvbi5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eXBlcy9jb2xsZWN0aW9uLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBUeXBlIGRlZmluaXRpb25zIGZvciBjb2xsZWN0aW9uIGZ1bmN0aW9uYWxpdHlcbiAqL1xuXG5leHBvcnQgaW50ZXJmYWNlIENvbGxlY3Rpb25Db250ZW50IHtcbiAgbmFtZTogc3RyaW5nO1xuICBwYXRoOiBzdHJpbmc7XG4gIHNoYTogc3RyaW5nO1xuICBzaXplOiBudW1iZXI7XG4gIGRvd25sb2FkX3VybDogc3RyaW5nO1xuICBodG1sX3VybDogc3RyaW5nO1xufVxuXG5leHBvcnQgaW50ZXJmYWNlIENvbGxlY3Rpb25TZWFyY2hSZXN1bHQge1xuICBwYXRoOiBzdHJpbmc7XG4gIGh0bWxfdXJsOiBzdHJpbmc7XG4gIHJlcG9zaXRvcnk6IHtcbiAgICBmdWxsX25hbWU6IHN0cmluZztcbiAgfTtcbiAgdGV4dF9tYXRjaGVzPzogQXJyYXk8e1xuICAgIGZyYWdtZW50OiBzdHJpbmc7XG4gICAgcHJvcGVydHk6IHN0cmluZztcbiAgfT47XG59Il19

package/dist/types/elements/IElement.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Core element interface that all element types must implement.
+ * This provides the foundation for the portfolio system with support for:
+ * - Identity and versioning
+ * - References to external/internal resources
+ * - Extensibility for future features
+ * - Ratings and feedback mechanisms
+ * - Lifecycle management
+ */
+import { ElementType } from '../../portfolio/types.js';
+export interface IElement {
+    id: string;
+    type: ElementType;
+    version: string;
+    metadata: IElementMetadata;
+    references?: Reference[];
+    extensions?: Record<string, any>;
+    ratings?: ElementRatings;
+    validate(): ElementValidationResult;
+    serialize(): string;
+    deserialize(data: string): void;
+    receiveFeedback?(feedback: string, context?: FeedbackContext): void;
+    beforeActivate?(): Promise<void>;
+    activate?(): Promise<void>;
+    afterActivate?(): Promise<void>;
+    deactivate?(): Promise<void>;
+    getStatus(): ElementStatus;
+}
+export interface IElementMetadata {
+    name: string;
+    description: string;
+    author?: string;
+    version?: string;
+    created?: string;
+    modified?: string;
+    tags?: string[];
+    dependencies?: ElementDependency[];
+    custom?: Record<string, any>;
+}
+export interface Reference {
+    type: ReferenceType;
+    uri: string;
+    title: string;
+    description?: string;
+    required?: boolean;
+    ragEnabled?: boolean;
+    cacheable?: boolean;
+    refreshInterval?: number;
+}
+export declare enum ReferenceType {
+    INTERNAL = "internal",// Reference to another element
+    EXTERNAL = "external",// Web URL
+    DOCUMENT = "document",// Local or RAG document
+    REPOSITORY = "repository",// Git repository
+    API = "api",// API endpoint
+    PORTFOLIO = "portfolio"
+}
+export interface ElementDependency {
+    elementId: string;
+    elementType: ElementType;
+    versionConstraint?: string;
+    optional?: boolean;
+}
+export interface ElementValidationResult {
+    valid: boolean;
+    errors?: ValidationError[];
+    warnings?: ValidationWarning[];
+    suggestions?: string[];
+}
+export interface ValidationError {
+    field: string;
+    message: string;
+    code?: string;
+}
+export interface ValidationWarning {
+    field: string;
+    message: string;
+    severity?: 'low' | 'medium' | 'high';
+}
+export declare enum ElementStatus {
+    INACTIVE = "inactive",
+    ACTIVATING = "activating",
+    ACTIVE = "active",
+    DEACTIVATING = "deactivating",
+    ERROR = "error",
+    SUSPENDED = "suspended"
+}
+export interface ElementRatings {
+    aiRating: number;
+    userRating?: number;
+    ratingCount: number;
+    lastEvaluated: Date;
+    confidence: number;
+    breakdown?: RatingBreakdown;
+    ratingDelta?: number;
+    trend: 'improving' | 'declining' | 'stable';
+    feedbackHistory?: UserFeedback[];
+}
+export interface RatingBreakdown {
+    effectiveness: number;
+    reliability: number;
+    usability: number;
+    [key: string]: number;
+}
+export interface UserFeedback {
+    timestamp: Date;
+    feedback: string;
+    sentiment: 'positive' | 'negative' | 'neutral';
+    inferredRating?: number;
+    context?: FeedbackContext;
+    elementVersion?: string;
+}
+export interface FeedbackContext {
+    task?: string;
+    relatedElements?: string[];
+    sessionId?: string;
+    environmentData?: Record<string, any>;
+}
+export interface ISchemaVersion {
+    schemaVersion?: string;
+    migrate?(fromVersion: string): void;
+}
+//# sourceMappingURL=IElement.d.ts.map

package/dist/types/elements/IElement.d.ts.map

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

package/dist/types/elements/IElement.js

@@ -0,0 +1,30 @@
+/**
+ * Core element interface that all element types must implement.
+ * This provides the foundation for the portfolio system with support for:
+ * - Identity and versioning
+ * - References to external/internal resources
+ * - Extensibility for future features
+ * - Ratings and feedback mechanisms
+ * - Lifecycle management
+ */
+// Types of references supported
+export var ReferenceType;
+(function (ReferenceType) {
+    ReferenceType["INTERNAL"] = "internal";
+    ReferenceType["EXTERNAL"] = "external";
+    ReferenceType["DOCUMENT"] = "document";
+    ReferenceType["REPOSITORY"] = "repository";
+    ReferenceType["API"] = "api";
+    ReferenceType["PORTFOLIO"] = "portfolio"; // Reference within portfolio
+})(ReferenceType || (ReferenceType = {}));
+// Element status tracking
+export var ElementStatus;
+(function (ElementStatus) {
+    ElementStatus["INACTIVE"] = "inactive";
+    ElementStatus["ACTIVATING"] = "activating";
+    ElementStatus["ACTIVE"] = "active";
+    ElementStatus["DEACTIVATING"] = "deactivating";
+    ElementStatus["ERROR"] = "error";
+    ElementStatus["SUSPENDED"] = "suspended";
+})(ElementStatus || (ElementStatus = {}));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSUVsZW1lbnQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvdHlwZXMvZWxlbWVudHMvSUVsZW1lbnQudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUE4REgsZ0NBQWdDO0FBQ2hDLE1BQU0sQ0FBTixJQUFZLGFBT1g7QUFQRCxXQUFZLGFBQWE7SUFDdkIsc0NBQXFCLENBQUE7SUFDckIsc0NBQXFCLENBQUE7SUFDckIsc0NBQXFCLENBQUE7SUFDckIsMENBQXlCLENBQUE7SUFDekIsNEJBQVcsQ0FBQTtJQUNYLHdDQUF1QixDQUFBLENBQUssNkJBQTZCO0FBQzNELENBQUMsRUFQVyxhQUFhLEtBQWIsYUFBYSxRQU94QjtBQThCRCwwQkFBMEI7QUFDMUIsTUFBTSxDQUFOLElBQVksYUFPWDtBQVBELFdBQVksYUFBYTtJQUN2QixzQ0FBcUIsQ0FBQTtJQUNyQiwwQ0FBeUIsQ0FBQTtJQUN6QixrQ0FBaUIsQ0FBQTtJQUNqQiw4Q0FBNkIsQ0FBQTtJQUM3QixnQ0FBZSxDQUFBO0lBQ2Ysd0NBQXVCLENBQUE7QUFDekIsQ0FBQyxFQVBXLGFBQWEsS0FBYixhQUFhLFFBT3hCIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBDb3JlIGVsZW1lbnQgaW50ZXJmYWNlIHRoYXQgYWxsIGVsZW1lbnQgdHlwZXMgbXVzdCBpbXBsZW1lbnQuXG4gKiBUaGlzIHByb3ZpZGVzIHRoZSBmb3VuZGF0aW9uIGZvciB0aGUgcG9ydGZvbGlvIHN5c3RlbSB3aXRoIHN1cHBvcnQgZm9yOlxuICogLSBJZGVudGl0eSBhbmQgdmVyc2lvbmluZ1xuICogLSBSZWZlcmVuY2VzIHRvIGV4dGVybmFsL2ludGVybmFsIHJlc291cmNlc1xuICogLSBFeHRlbnNpYmlsaXR5IGZvciBmdXR1cmUgZmVhdHVyZXNcbiAqIC0gUmF0aW5ncyBhbmQgZmVlZGJhY2sgbWVjaGFuaXNtc1xuICogLSBMaWZlY3ljbGUgbWFuYWdlbWVudFxuICovXG5cbmltcG9ydCB7IEVsZW1lbnRUeXBlIH0gZnJvbSAnLi4vLi4vcG9ydGZvbGlvL3R5cGVzLmpzJztcblxuLy8gQ29yZSBpZGVudGl0eSBhbmQgbWV0YWRhdGFcbmV4cG9ydCBpbnRlcmZhY2UgSUVsZW1lbnQge1xuICAvLyBJZGVudGl0eVxuICBpZDogc3RyaW5nO1xuICB0eXBlOiBFbGVtZW50VHlwZTtcbiAgdmVyc2lvbjogc3RyaW5nO1xuICBcbiAgLy8gTWV0YWRhdGFcbiAgbWV0YWRhdGE6IElFbGVtZW50TWV0YWRhdGE7XG4gIFxuICAvLyBGZWF0dXJlc1xuICByZWZlcmVuY2VzPzogUmVmZXJlbmNlW107XG4gIGV4dGVuc2lvbnM/OiBSZWNvcmQ8c3RyaW5nLCBhbnk+O1xuICByYXRpbmdzPzogRWxlbWVudFJhdGluZ3M7XG4gIFxuICAvLyBDb3JlIG9wZXJhdGlvbnNcbiAgdmFsaWRhdGUoKTogRWxlbWVudFZhbGlkYXRpb25SZXN1bHQ7XG4gIHNlcmlhbGl6ZSgpOiBzdHJpbmc7XG4gIGRlc2VyaWFsaXplKGRhdGE6IHN0cmluZyk6IHZvaWQ7XG4gIHJlY2VpdmVGZWVkYmFjaz8oZmVlZGJhY2s6IHN0cmluZywgY29udGV4dD86IEZlZWRiYWNrQ29udGV4dCk6IHZvaWQ7XG4gIFxuICAvLyBMaWZlY3ljbGUgKG9wdGlvbmFsKVxuICBiZWZvcmVBY3RpdmF0ZT8oKTogUHJvbWlzZTx2b2lkPjtcbiAgYWN0aXZhdGU/KCk6IFByb21pc2U8dm9pZD47XG4gIGFmdGVyQWN0aXZhdGU/KCk6IFByb21pc2U8dm9pZD47XG4gIGRlYWN0aXZhdGU/KCk6IFByb21pc2U8dm9pZD47XG4gIGdldFN0YXR1cygpOiBFbGVtZW50U3RhdHVzO1xufVxuXG4vLyBFbGVtZW50IG1ldGFkYXRhIGNvbW1vbiB0byBhbGwgdHlwZXNcbmV4cG9ydCBpbnRlcmZhY2UgSUVsZW1lbnRNZXRhZGF0YSB7XG4gIG5hbWU6IHN0cmluZztcbiAgZGVzY3JpcHRpb246IHN0cmluZztcbiAgYXV0aG9yPzogc3RyaW5nO1xuICB2ZXJzaW9uPzogc3RyaW5nO1xuICBjcmVhdGVkPzogc3RyaW5nO1xuICBtb2RpZmllZD86IHN0cmluZztcbiAgdGFncz86IHN0cmluZ1tdO1xuICBcbiAgLy8gUmVmZXJlbmNlcyBzdXBwb3J0XG4gIGRlcGVuZGVuY2llcz86IEVsZW1lbnREZXBlbmRlbmN5W107XG4gIFxuICAvLyBFeHRlbnNpYmlsaXR5XG4gIGN1c3RvbT86IFJlY29yZDxzdHJpbmcsIGFueT47XG59XG5cbi8vIFJlZmVyZW5jZSB0byBleHRlcm5hbCBvciBpbnRlcm5hbCByZXNvdXJjZXNcbmV4cG9ydCBpbnRlcmZhY2UgUmVmZXJlbmNlIHtcbiAgdHlwZTogUmVmZXJlbmNlVHlwZTtcbiAgdXJpOiBzdHJpbmc7ICAgICAgICAgICAgICAvLyBVUkwsIGZpbGUgcGF0aCwgZG9jdW1lbnQgSUQsIHBvcnRmb2xpbyByZWZlcmVuY2VcbiAgdGl0bGU6IHN0cmluZzsgICAgICAgICAgICAvLyBIdW1hbi1yZWFkYWJsZSBuYW1lXG4gIGRlc2NyaXB0aW9uPzogc3RyaW5nOyAgICAgLy8gV2hhdCB0aGlzIHJlZmVyZW5jZSBwcm92aWRlc1xuICByZXF1aXJlZD86IGJvb2xlYW47ICAgICAgIC8vIElzIHRoaXMgcmVmZXJlbmNlIGVzc2VudGlhbD9cbiAgcmFnRW5hYmxlZD86IGJvb2xlYW47ICAgICAvLyBTaG91bGQgdGhpcyBiZSBsb2FkZWQgZm9yIFJBRz9cbiAgY2FjaGVhYmxlPzogYm9vbGVhbjsgICAgICAvLyBDYW4gdGhpcyBiZSBjYWNoZWQgbG9jYWxseT9cbiAgcmVmcmVzaEludGVydmFsPzogbnVtYmVyOyAvLyBIb3cgb2Z0ZW4gdG8gcmVmcmVzaCAoaW4gaG91cnMpXG59XG5cbi8vIFR5cGVzIG9mIHJlZmVyZW5jZXMgc3VwcG9ydGVkXG5leHBvcnQgZW51bSBSZWZlcmVuY2VUeXBlIHtcbiAgSU5URVJOQUwgPSAnaW50ZXJuYWwnLCAgICAgIC8vIFJlZmVyZW5jZSB0byBhbm90aGVyIGVsZW1lbnRcbiAgRVhURVJOQUwgPSAnZXh0ZXJuYWwnLCAgICAgIC8vIFdlYiBVUkxcbiAgRE9DVU1FTlQgPSAnZG9jdW1lbnQnLCAgICAgIC8vIExvY2FsIG9yIFJBRyBkb2N1bWVudFxuICBSRVBPU0lUT1JZID0gJ3JlcG9zaXRvcnknLCAgLy8gR2l0IHJlcG9zaXRvcnlcbiAgQVBJID0gJ2FwaScsICAgICAgICAgICAgICAgLy8gQVBJIGVuZHBvaW50XG4gIFBPUlRGT0xJTyA9ICdwb3J0Zm9saW8nICAgICAvLyBSZWZlcmVuY2Ugd2l0aGluIHBvcnRmb2xpb1xufVxuXG4vLyBFbGVtZW50IGRlcGVuZGVuY3kgc3BlY2lmaWNhdGlvblxuZXhwb3J0IGludGVyZmFjZSBFbGVtZW50RGVwZW5kZW5jeSB7XG4gIGVsZW1lbnRJZDogc3RyaW5nO1xuICBlbGVtZW50VHlwZTogRWxlbWVudFR5cGU7XG4gIHZlcnNpb25Db25zdHJhaW50Pzogc3RyaW5nOyAgLy8gZS5nLiwgXCJeMS4wLjBcIiwgXCI+PTIuMC4wXCJcbiAgb3B0aW9uYWw/OiBib29sZWFuO1xufVxuXG4vLyBWYWxpZGF0aW9uIHJlc3VsdCBmb3IgZWxlbWVudHNcbmV4cG9ydCBpbnRlcmZhY2UgRWxlbWVudFZhbGlkYXRpb25SZXN1bHQge1xuICB2YWxpZDogYm9vbGVhbjtcbiAgZXJyb3JzPzogVmFsaWRhdGlvbkVycm9yW107XG4gIHdhcm5pbmdzPzogVmFsaWRhdGlvbldhcm5pbmdbXTtcbiAgc3VnZ2VzdGlvbnM/OiBzdHJpbmdbXTtcbn1cblxuZXhwb3J0IGludGVyZmFjZSBWYWxpZGF0aW9uRXJyb3Ige1xuICBmaWVsZDogc3RyaW5nO1xuICBtZXNzYWdlOiBzdHJpbmc7XG4gIGNvZGU/OiBzdHJpbmc7XG59XG5cbmV4cG9ydCBpbnRlcmZhY2UgVmFsaWRhdGlvbldhcm5pbmcge1xuICBmaWVsZDogc3RyaW5nO1xuICBtZXNzYWdlOiBzdHJpbmc7XG4gIHNldmVyaXR5PzogJ2xvdycgfCAnbWVkaXVtJyB8ICdoaWdoJztcbn1cblxuLy8gRWxlbWVudCBzdGF0dXMgdHJhY2tpbmdcbmV4cG9ydCBlbnVtIEVsZW1lbnRTdGF0dXMge1xuICBJTkFDVElWRSA9ICdpbmFjdGl2ZScsXG4gIEFDVElWQVRJTkcgPSAnYWN0aXZhdGluZycsXG4gIEFDVElWRSA9ICdhY3RpdmUnLFxuICBERUFDVElWQVRJTkcgPSAnZGVhY3RpdmF0aW5nJyxcbiAgRVJST1IgPSAnZXJyb3InLFxuICBTVVNQRU5ERUQgPSAnc3VzcGVuZGVkJ1xufVxuXG4vLyBSYXRpbmcgc3lzdGVtIGZvciBjb250aW51b3VzIGltcHJvdmVtZW50XG5leHBvcnQgaW50ZXJmYWNlIEVsZW1lbnRSYXRpbmdzIHtcbiAgYWlSYXRpbmc6IG51bWJlcjsgICAgICAgICAgICAgIC8vIDAtNSBzdGFycyAoQUkgZXZhbHVhdGlvbilcbiAgdXNlclJhdGluZz86IG51bWJlcjsgICAgICAgICAgIC8vIDAtNSBzdGFycyAodXNlciBmZWVkYmFjaylcbiAgcmF0aW5nQ291bnQ6IG51bWJlcjsgICAgICAgICAgIC8vIE51bWJlciBvZiByYXRpbmdzXG4gIGxhc3RFdmFsdWF0ZWQ6IERhdGU7ICAgICAgICAgIC8vIFdoZW4gbGFzdCBldmFsdWF0ZWRcbiAgY29uZmlkZW5jZTogbnVtYmVyOyAgICAgICAgICAgIC8vIDAtMSBjb25maWRlbmNlIGluIHJhdGluZ1xuICBcbiAgLy8gRGV0YWlsZWQgYnJlYWtkb3ducyAoY3VzdG9taXphYmxlIHBlciBlbGVtZW50IHR5cGUpXG4gIGJyZWFrZG93bj86IFJhdGluZ0JyZWFrZG93bjtcbiAgXG4gIC8vIERlbHRhIHRyYWNraW5nXG4gIHJhdGluZ0RlbHRhPzogbnVtYmVyOyAgICAgICAgIC8vIERpZmZlcmVuY2UgYmV0d2VlbiBBSSBhbmQgdXNlciByYXRpbmdcbiAgdHJlbmQ6ICdpbXByb3ZpbmcnIHwgJ2RlY2xpbmluZycgfCAnc3RhYmxlJztcbiAgXG4gIC8vIEZlZWRiYWNrIGhpc3RvcnlcbiAgZmVlZGJhY2tIaXN0b3J5PzogVXNlckZlZWRiYWNrW107XG59XG5cbi8vIEJhc2UgcmF0aW5nIGJyZWFrZG93biAtIGVsZW1lbnQgdHlwZXMgY2FuIGV4dGVuZCB0aGlzXG5leHBvcnQgaW50ZXJmYWNlIFJhdGluZ0JyZWFrZG93biB7XG4gIC8vIEJhc2UgbWV0cmljcyBhbGwgZWxlbWVudHMgc2hhcmVcbiAgZWZmZWN0aXZlbmVzczogbnVtYmVyOyAgICAgICAgIC8vIEhvdyB3ZWxsIGl0IGFjaGlldmVzIGl0cyBwdXJwb3NlXG4gIHJlbGlhYmlsaXR5OiBudW1iZXI7ICAgICAgICAgIC8vIEhvdyBjb25zaXN0ZW50IGl0IGlzXG4gIHVzYWJpbGl0eTogbnVtYmVyOyAgICAgICAgICAgLy8gSG93IGVhc3kgdG8gd29yayB3aXRoXG4gIFxuICAvLyBFbGVtZW50LXNwZWNpZmljIG1ldHJpY3MgKHZpYSBpbmRleCBzaWduYXR1cmUpXG4gIFtrZXk6IHN0cmluZ106IG51bWJlcjtcbn1cblxuLy8gVXNlciBmZWVkYmFjayB0cmFja2luZ1xuZXhwb3J0IGludGVyZmFjZSBVc2VyRmVlZGJhY2sge1xuICB0aW1lc3RhbXA6IERhdGU7XG4gIGZlZWRiYWNrOiBzdHJpbmc7ICAgICAgICAgICAgIC8vIE5hdHVyYWwgbGFuZ3VhZ2UgZmVlZGJhY2tcbiAgc2VudGltZW50OiAncG9zaXRpdmUnIHwgJ25lZ2F0aXZlJyB8ICduZXV0cmFsJztcbiAgaW5mZXJyZWRSYXRpbmc/OiBudW1iZXI7ICAgICAgLy8gUmF0aW5nIGluZmVycmVkIGZyb20gZmVlZGJhY2tcbiAgY29udGV4dD86IEZlZWRiYWNrQ29udGV4dDsgICAgLy8gV2hhdCB3YXMgaGFwcGVuaW5nXG4gIGVsZW1lbnRWZXJzaW9uPzogc3RyaW5nOyAgICAgIC8vIFZlcnNpb24gYXQgdGltZSBvZiBmZWVkYmFja1xufVxuXG4vLyBDb250ZXh0IGZvciBmZWVkYmFja1xuZXhwb3J0IGludGVyZmFjZSBGZWVkYmFja0NvbnRleHQge1xuICB0YXNrPzogc3RyaW5nOyAgICAgICAgICAgICAgICAvLyBXaGF0IHRhc2sgd2FzIGJlaW5nIHBlcmZvcm1lZFxuICByZWxhdGVkRWxlbWVudHM/OiBzdHJpbmdbXTsgICAvLyBPdGhlciBhY3RpdmUgZWxlbWVudHNcbiAgc2Vzc2lvbklkPzogc3RyaW5nOyAgICAgICAgICAvLyBGb3IgZ3JvdXBpbmcgcmVsYXRlZCBmZWVkYmFja1xuICBlbnZpcm9ubWVudERhdGE/OiBSZWNvcmQ8c3RyaW5nLCBhbnk+O1xufVxuXG4vLyBTY2hlbWEgdmVyc2lvbmluZyBzdXBwb3J0XG5leHBvcnQgaW50ZXJmYWNlIElTY2hlbWFWZXJzaW9uIHtcbiAgc2NoZW1hVmVyc2lvbj86IHN0cmluZzsgICAgICAgLy8gVHJhY2sgaW50ZXJmYWNlIHZlcnNpb25cbiAgbWlncmF0ZT8oZnJvbVZlcnNpb246IHN0cmluZyk6IHZvaWQ7ICAvLyBNaWdyYXRpb24gc3VwcG9ydFxufSJdfQ==

package/dist/types/elements/IElementManager.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Element manager interface for handling element operations.
+ * Each element type should have a corresponding manager implementation.
+ */
+import { IElement, ElementValidationResult } from './IElement.js';
+import { ElementType } from '../../portfolio/types.js';
+export interface IElementManager<T extends IElement> {
+    load(path: string): Promise<T>;
+    save(element: T, path: string): Promise<void>;
+    delete(path: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    list(): Promise<T[]>;
+    find(predicate: (element: T) => boolean): Promise<T | undefined>;
+    findMany(predicate: (element: T) => boolean): Promise<T[]>;
+    validate(element: T): ElementValidationResult;
+    validatePath(path: string): boolean;
+    getElementType(): ElementType;
+    getFileExtension(): string;
+    importElement(data: string, format?: 'json' | 'yaml' | 'markdown'): Promise<T>;
+    exportElement(element: T, format?: 'json' | 'yaml' | 'markdown'): Promise<string>;
+}
+export interface IElementFactory<T extends IElement> {
+    create(metadata: Partial<T['metadata']>): T;
+    createFromTemplate(templateId: string, overrides?: Partial<T>): Promise<T>;
+    getDefaultMetadata(): T['metadata'];
+}
+export interface IElementLifecycleManager<T extends IElement> {
+    activate(element: T): Promise<void>;
+    deactivate(element: T): Promise<void>;
+    isActive(element: T): boolean;
+    getActiveElements(): T[];
+    suspend(element: T): Promise<void>;
+    resume(element: T): Promise<void>;
+    onActivate(handler: (element: T) => void): void;
+    onDeactivate(handler: (element: T) => void): void;
+    onStatusChange(handler: (element: T, oldStatus: string, newStatus: string) => void): void;
+}
+export interface IBatchOperations<T extends IElement> {
+    loadMany(paths: string[]): Promise<T[]>;
+    saveMany(elements: Map<string, T>): Promise<void>;
+    deleteMany(paths: string[]): Promise<void>;
+    validateMany(elements: T[]): Map<T, ElementValidationResult>;
+}
+export interface IElementSearch<T extends IElement> {
+    search(query: string): Promise<T[]>;
+    searchByTag(tag: string): Promise<T[]>;
+    searchByAuthor(author: string): Promise<T[]>;
+    filter(criteria: FilterCriteria<T>): Promise<T[]>;
+}
+export interface FilterCriteria<T extends IElement> {
+    type?: ElementType;
+    tags?: string[];
+    author?: string;
+    minRating?: number;
+    maxRating?: number;
+    hasReferences?: boolean;
+    custom?: (element: T) => boolean;
+}
+export interface IElementVersioning<T extends IElement> {
+    getVersion(element: T): string;
+    incrementVersion(element: T, type: 'major' | 'minor' | 'patch'): T;
+    compareVersions(v1: string, v2: string): -1 | 0 | 1;
+    isCompatible(element: T, constraint: string): boolean;
+}
+//# sourceMappingURL=IElementManager.d.ts.map

package/dist/types/elements/IElementManager.d.ts.map

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

package/dist/types/elements/IElementManager.js

@@ -0,0 +1,6 @@
+/**
+ * Element manager interface for handling element operations.
+ * Each element type should have a corresponding manager implementation.
+ */
+export {};
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiSUVsZW1lbnRNYW5hZ2VyLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vc3JjL3R5cGVzL2VsZW1lbnRzL0lFbGVtZW50TWFuYWdlci50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7O0dBR0ciLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEVsZW1lbnQgbWFuYWdlciBpbnRlcmZhY2UgZm9yIGhhbmRsaW5nIGVsZW1lbnQgb3BlcmF0aW9ucy5cbiAqIEVhY2ggZWxlbWVudCB0eXBlIHNob3VsZCBoYXZlIGEgY29ycmVzcG9uZGluZyBtYW5hZ2VyIGltcGxlbWVudGF0aW9uLlxuICovXG5cbmltcG9ydCB7IElFbGVtZW50LCBFbGVtZW50VmFsaWRhdGlvblJlc3VsdCB9IGZyb20gJy4vSUVsZW1lbnQuanMnO1xuaW1wb3J0IHsgRWxlbWVudFR5cGUgfSBmcm9tICcuLi8uLi9wb3J0Zm9saW8vdHlwZXMuanMnO1xuXG4vLyBHZW5lcmljIGVsZW1lbnQgbWFuYWdlciBpbnRlcmZhY2VcbmV4cG9ydCBpbnRlcmZhY2UgSUVsZW1lbnRNYW5hZ2VyPFQgZXh0ZW5kcyBJRWxlbWVudD4ge1xuICAvLyBDUlVEIG9wZXJhdGlvbnNcbiAgbG9hZChwYXRoOiBzdHJpbmcpOiBQcm9taXNlPFQ+O1xuICBzYXZlKGVsZW1lbnQ6IFQsIHBhdGg6IHN0cmluZyk6IFByb21pc2U8dm9pZD47XG4gIGRlbGV0ZShwYXRoOiBzdHJpbmcpOiBQcm9taXNlPHZvaWQ+O1xuICBleGlzdHMocGF0aDogc3RyaW5nKTogUHJvbWlzZTxib29sZWFuPjtcbiAgXG4gIC8vIENvbGxlY3Rpb24gb3BlcmF0aW9uc1xuICBsaXN0KCk6IFByb21pc2U8VFtdPjtcbiAgZmluZChwcmVkaWNhdGU6IChlbGVtZW50OiBUKSA9PiBib29sZWFuKTogUHJvbWlzZTxUIHwgdW5kZWZpbmVkPjtcbiAgZmluZE1hbnkocHJlZGljYXRlOiAoZWxlbWVudDogVCkgPT4gYm9vbGVhbik6IFByb21pc2U8VFtdPjtcbiAgXG4gIC8vIFZhbGlkYXRpb25cbiAgdmFsaWRhdGUoZWxlbWVudDogVCk6IEVsZW1lbnRWYWxpZGF0aW9uUmVzdWx0O1xuICB2YWxpZGF0ZVBhdGgocGF0aDogc3RyaW5nKTogYm9vbGVhbjtcbiAgXG4gIC8vIEVsZW1lbnQgdHlwZSBpbmZvXG4gIGdldEVsZW1lbnRUeXBlKCk6IEVsZW1lbnRUeXBlO1xuICBnZXRGaWxlRXh0ZW5zaW9uKCk6IHN0cmluZztcbiAgXG4gIC8vIEltcG9ydC9FeHBvcnRcbiAgaW1wb3J0RWxlbWVudChkYXRhOiBzdHJpbmcsIGZvcm1hdD86ICdqc29uJyB8ICd5YW1sJyB8ICdtYXJrZG93bicpOiBQcm9taXNlPFQ+O1xuICBleHBvcnRFbGVtZW50KGVsZW1lbnQ6IFQsIGZvcm1hdD86ICdqc29uJyB8ICd5YW1sJyB8ICdtYXJrZG93bicpOiBQcm9taXNlPHN0cmluZz47XG59XG5cbi8vIEVsZW1lbnQgZmFjdG9yeSBmb3IgY3JlYXRpbmcgbmV3IGluc3RhbmNlc1xuZXhwb3J0IGludGVyZmFjZSBJRWxlbWVudEZhY3Rvcnk8VCBleHRlbmRzIElFbGVtZW50PiB7XG4gIGNyZWF0ZShtZXRhZGF0YTogUGFydGlhbDxUWydtZXRhZGF0YSddPik6IFQ7XG4gIGNyZWF0ZUZyb21UZW1wbGF0ZSh0ZW1wbGF0ZUlkOiBzdHJpbmcsIG92ZXJyaWRlcz86IFBhcnRpYWw8VD4pOiBQcm9taXNlPFQ+O1xuICBnZXREZWZhdWx0TWV0YWRhdGEoKTogVFsnbWV0YWRhdGEnXTtcbn1cblxuLy8gRWxlbWVudCBsaWZlY3ljbGUgbWFuYWdlclxuZXhwb3J0IGludGVyZmFjZSBJRWxlbWVudExpZmVjeWNsZU1hbmFnZXI8VCBleHRlbmRzIElFbGVtZW50PiB7XG4gIC8vIEFjdGl2YXRpb25cbiAgYWN0aXZhdGUoZWxlbWVudDogVCk6IFByb21pc2U8dm9pZD47XG4gIGRlYWN0aXZhdGUoZWxlbWVudDogVCk6IFByb21pc2U8dm9pZD47XG4gIGlzQWN0aXZlKGVsZW1lbnQ6IFQpOiBib29sZWFuO1xuICBnZXRBY3RpdmVFbGVtZW50cygpOiBUW107XG4gIFxuICAvLyBTdGF0ZSBtYW5hZ2VtZW50XG4gIHN1c3BlbmQoZWxlbWVudDogVCk6IFByb21pc2U8dm9pZD47XG4gIHJlc3VtZShlbGVtZW50OiBUKTogUHJvbWlzZTx2b2lkPjtcbiAgXG4gIC8vIEV2ZW50c1xuICBvbkFjdGl2YXRlKGhhbmRsZXI6IChlbGVtZW50OiBUKSA9PiB2b2lkKTogdm9pZDtcbiAgb25EZWFjdGl2YXRlKGhhbmRsZXI6IChlbGVtZW50OiBUKSA9PiB2b2lkKTogdm9pZDtcbiAgb25TdGF0dXNDaGFuZ2UoaGFuZGxlcjogKGVsZW1lbnQ6IFQsIG9sZFN0YXR1czogc3RyaW5nLCBuZXdTdGF0dXM6IHN0cmluZykgPT4gdm9pZCk6IHZvaWQ7XG59XG5cbi8vIEJhdGNoIG9wZXJhdGlvbnMgaW50ZXJmYWNlXG5leHBvcnQgaW50ZXJmYWNlIElCYXRjaE9wZXJhdGlvbnM8VCBleHRlbmRzIElFbGVtZW50PiB7XG4gIGxvYWRNYW55KHBhdGhzOiBzdHJpbmdbXSk6IFByb21pc2U8VFtdPjtcbiAgc2F2ZU1hbnkoZWxlbWVudHM6IE1hcDxzdHJpbmcsIFQ+KTogUHJvbWlzZTx2b2lkPjtcbiAgZGVsZXRlTWFueShwYXRoczogc3RyaW5nW10pOiBQcm9taXNlPHZvaWQ+O1xuICB2YWxpZGF0ZU1hbnkoZWxlbWVudHM6IFRbXSk6IE1hcDxULCBFbGVtZW50VmFsaWRhdGlvblJlc3VsdD47XG59XG5cbi8vIFNlYXJjaCBhbmQgZmlsdGVyIGludGVyZmFjZVxuZXhwb3J0IGludGVyZmFjZSBJRWxlbWVudFNlYXJjaDxUIGV4dGVuZHMgSUVsZW1lbnQ+IHtcbiAgc2VhcmNoKHF1ZXJ5OiBzdHJpbmcpOiBQcm9taXNlPFRbXT47XG4gIHNlYXJjaEJ5VGFnKHRhZzogc3RyaW5nKTogUHJvbWlzZTxUW10+O1xuICBzZWFyY2hCeUF1dGhvcihhdXRob3I6IHN0cmluZyk6IFByb21pc2U8VFtdPjtcbiAgZmlsdGVyKGNyaXRlcmlhOiBGaWx0ZXJDcml0ZXJpYTxUPik6IFByb21pc2U8VFtdPjtcbn1cblxuLy8gRmlsdGVyIGNyaXRlcmlhIGZvciBlbGVtZW50c1xuZXhwb3J0IGludGVyZmFjZSBGaWx0ZXJDcml0ZXJpYTxUIGV4dGVuZHMgSUVsZW1lbnQ+IHtcbiAgdHlwZT86IEVsZW1lbnRUeXBlO1xuICB0YWdzPzogc3RyaW5nW107XG4gIGF1dGhvcj86IHN0cmluZztcbiAgbWluUmF0aW5nPzogbnVtYmVyO1xuICBtYXhSYXRpbmc/OiBudW1iZXI7XG4gIGhhc1JlZmVyZW5jZXM/OiBib29sZWFuO1xuICBjdXN0b20/OiAoZWxlbWVudDogVCkgPT4gYm9vbGVhbjtcbn1cblxuLy8gRWxlbWVudCB2ZXJzaW9uaW5nIGludGVyZmFjZVxuZXhwb3J0IGludGVyZmFjZSBJRWxlbWVudFZlcnNpb25pbmc8VCBleHRlbmRzIElFbGVtZW50PiB7XG4gIGdldFZlcnNpb24oZWxlbWVudDogVCk6IHN0cmluZztcbiAgaW5jcmVtZW50VmVyc2lvbihlbGVtZW50OiBULCB0eXBlOiAnbWFqb3InIHwgJ21pbm9yJyB8ICdwYXRjaCcpOiBUO1xuICBjb21wYXJlVmVyc2lvbnModjE6IHN0cmluZywgdjI6IHN0cmluZyk6IC0xIHwgMCB8IDE7XG4gIGlzQ29tcGF0aWJsZShlbGVtZW50OiBULCBjb25zdHJhaW50OiBzdHJpbmcpOiBib29sZWFuO1xufSJdfQ==