cadr-cli 0.0.1 → 1.9.2

package/dist/adr.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ADR File Management Module
+ *
+ * Handles creation and management of Architectural Decision Record files.
+ * Follows MADR (Markdown Architectural Decision Records) format.
+ */
+/**
+ * Default ADR directory relative to project root
+ */
+export declare const DEFAULT_ADR_DIR = "docs/adr";
+/**
+ * Convert a title to a filename-safe slug
+ * Example: "Use PostgreSQL for Storage" -> "use-postgresql-for-storage"
+ */
+export declare function titleToSlug(title: string): string;
+/**
+ * Get the next ADR number by scanning existing ADR files
+ *
+ * @param adrDir - Directory containing ADR files
+ * @returns Next available ADR number (e.g., 1, 2, 3...)
+ */
+export declare function getNextADRNumber(adrDir: string): number;
+/**
+ * Ensure ADR directory exists, create if it doesn't
+ *
+ * @param adrDir - Directory path to ensure exists
+ */
+export declare function ensureADRDirectory(adrDir: string): void;
+/**
+ * Generate ADR filename from number and title
+ *
+ * @param number - ADR number (will be zero-padded to 4 digits)
+ * @param title - ADR title (will be converted to slug)
+ * @returns Filename like "0001-use-postgresql-for-storage.md"
+ */
+export declare function generateADRFilename(number: number, title: string): string;
+/**
+ * Save ADR content to file
+ *
+ * @param content - Full markdown content of the ADR
+ * @param title - Title extracted from ADR content
+ * @param adrDir - Directory to save ADR in (defaults to docs/adr)
+ * @returns Object with success status, file path, and any error
+ */
+export declare function saveADR(content: string, title: string, adrDir?: string): {
+    success: boolean;
+    filePath?: string;
+    error?: string;
+};
+//# sourceMappingURL=adr.d.ts.map

package/dist/adr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.d.ts","sourceRoot":"","sources":["../src/adr.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;GAEG;AACH,eAAO,MAAM,eAAe,aAAa,CAAC;AAE1C;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAKjD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA2BvD;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKvD;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIzE;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CACrB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,MAAwB,GAC/B;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAmCzD"}

package/dist/adr.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * ADR File Management Module
+ *
+ * Handles creation and management of Architectural Decision Record files.
+ * Follows MADR (Markdown Architectural Decision Records) format.
+ */
+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.DEFAULT_ADR_DIR = void 0;
+exports.titleToSlug = titleToSlug;
+exports.getNextADRNumber = getNextADRNumber;
+exports.ensureADRDirectory = ensureADRDirectory;
+exports.generateADRFilename = generateADRFilename;
+exports.saveADR = saveADR;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const logger_1 = require("./logger");
+/**
+ * Default ADR directory relative to project root
+ */
+exports.DEFAULT_ADR_DIR = 'docs/adr';
+/**
+ * Convert a title to a filename-safe slug
+ * Example: "Use PostgreSQL for Storage" -> "use-postgresql-for-storage"
+ */
+function titleToSlug(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-') // Replace non-alphanumeric with hyphens
+        .replace(/^-+|-+$/g, ''); // Remove leading/trailing hyphens
+}
+/**
+ * Get the next ADR number by scanning existing ADR files
+ *
+ * @param adrDir - Directory containing ADR files
+ * @returns Next available ADR number (e.g., 1, 2, 3...)
+ */
+function getNextADRNumber(adrDir) {
+    try {
+        if (!fs.existsSync(adrDir)) {
+            return 1; // First ADR
+        }
+        const files = fs.readdirSync(adrDir);
+        const adrNumbers = [];
+        // Extract numbers from existing ADR files (format: 0001-title.md)
+        for (const file of files) {
+            const match = file.match(/^(\d{4})-/);
+            if (match) {
+                adrNumbers.push(parseInt(match[1], 10));
+            }
+        }
+        if (adrNumbers.length === 0) {
+            return 1;
+        }
+        // Return next number after the highest existing number
+        return Math.max(...adrNumbers) + 1;
+    }
+    catch (error) {
+        logger_1.loggerInstance.warn('Failed to scan existing ADRs, defaulting to 1', { error, adrDir });
+        return 1;
+    }
+}
+/**
+ * Ensure ADR directory exists, create if it doesn't
+ *
+ * @param adrDir - Directory path to ensure exists
+ */
+function ensureADRDirectory(adrDir) {
+    if (!fs.existsSync(adrDir)) {
+        logger_1.loggerInstance.info('Creating ADR directory', { adrDir });
+        fs.mkdirSync(adrDir, { recursive: true });
+    }
+}
+/**
+ * Generate ADR filename from number and title
+ *
+ * @param number - ADR number (will be zero-padded to 4 digits)
+ * @param title - ADR title (will be converted to slug)
+ * @returns Filename like "0001-use-postgresql-for-storage.md"
+ */
+function generateADRFilename(number, title) {
+    const paddedNumber = String(number).padStart(4, '0');
+    const slug = titleToSlug(title);
+    return `${paddedNumber}-${slug}.md`;
+}
+/**
+ * Save ADR content to file
+ *
+ * @param content - Full markdown content of the ADR
+ * @param title - Title extracted from ADR content
+ * @param adrDir - Directory to save ADR in (defaults to docs/adr)
+ * @returns Object with success status, file path, and any error
+ */
+function saveADR(content, title, adrDir = exports.DEFAULT_ADR_DIR) {
+    try {
+        // Ensure directory exists
+        ensureADRDirectory(adrDir);
+        // Get next ADR number
+        const adrNumber = getNextADRNumber(adrDir);
+        // Generate filename
+        const filename = generateADRFilename(adrNumber, title);
+        const filePath = path.join(adrDir, filename);
+        // Check if file already exists (shouldn't happen, but safety check)
+        if (fs.existsSync(filePath)) {
+            logger_1.loggerInstance.warn('ADR file already exists, using alternative name', { filePath });
+            const alternativeFilename = generateADRFilename(adrNumber + 1, title);
+            const alternativeFilePath = path.join(adrDir, alternativeFilename);
+            fs.writeFileSync(alternativeFilePath, content, 'utf-8');
+            logger_1.loggerInstance.info('ADR saved successfully', { filePath: alternativeFilePath });
+            return { success: true, filePath: alternativeFilePath };
+        }
+        // Write ADR content to file
+        fs.writeFileSync(filePath, content, 'utf-8');
+        logger_1.loggerInstance.info('ADR saved successfully', { filePath, adrNumber });
+        return { success: true, filePath };
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+        logger_1.loggerInstance.error('Failed to save ADR', { error, adrDir });
+        return { success: false, error: errorMessage };
+    }
+}
+//# sourceMappingURL=adr.js.map

package/dist/adr.js.map

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

package/dist/adr.test.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ADR File Management Module Tests
+ *
+ * Tests for ADR file creation, numbering, and management.
+ * Following TDD: These tests are written BEFORE implementation.
+ */
+export {};
+//# sourceMappingURL=adr.test.d.ts.map

package/dist/adr.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.test.d.ts","sourceRoot":"","sources":["../src/adr.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/adr.test.js

@@ -0,0 +1,256 @@
+"use strict";
+/**
+ * ADR File Management Module Tests
+ *
+ * Tests for ADR file creation, numbering, and management.
+ * Following TDD: These tests are written BEFORE implementation.
+ */
+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 });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const adr_1 = require("./adr");
+describe('ADR Module', () => {
+    const testDir = path.join(__dirname, '../test-adrs');
+    beforeEach(() => {
+        // Clean up test directory before each test
+        if (fs.existsSync(testDir)) {
+            fs.rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    afterEach(() => {
+        // Clean up test directory after each test
+        if (fs.existsSync(testDir)) {
+            fs.rmSync(testDir, { recursive: true, force: true });
+        }
+    });
+    describe('titleToSlug', () => {
+        it('converts title to lowercase slug', () => {
+            expect((0, adr_1.titleToSlug)('Use PostgreSQL for Storage')).toBe('use-postgresql-for-storage');
+        });
+        it('replaces spaces with hyphens', () => {
+            expect((0, adr_1.titleToSlug)('My Great Decision')).toBe('my-great-decision');
+        });
+        it('handles special characters', () => {
+            expect((0, adr_1.titleToSlug)('API v2.0: New Endpoints!')).toBe('api-v2-0-new-endpoints');
+        });
+        it('removes leading and trailing hyphens', () => {
+            expect((0, adr_1.titleToSlug)('---Test Title---')).toBe('test-title');
+        });
+        it('handles multiple consecutive spaces', () => {
+            expect((0, adr_1.titleToSlug)('Too    Many    Spaces')).toBe('too-many-spaces');
+        });
+        it('handles empty string', () => {
+            expect((0, adr_1.titleToSlug)('')).toBe('');
+        });
+        it('handles only special characters', () => {
+            expect((0, adr_1.titleToSlug)('!!!')).toBe('');
+        });
+    });
+    describe('generateADRFilename', () => {
+        it('generates properly formatted filename', () => {
+            expect((0, adr_1.generateADRFilename)(1, 'Use PostgreSQL')).toBe('0001-use-postgresql.md');
+        });
+        it('pads numbers with zeros to 4 digits', () => {
+            expect((0, adr_1.generateADRFilename)(42, 'Test Decision')).toBe('0042-test-decision.md');
+        });
+        it('handles three-digit numbers', () => {
+            expect((0, adr_1.generateADRFilename)(123, 'Another Decision')).toBe('0123-another-decision.md');
+        });
+        it('handles four-digit numbers', () => {
+            expect((0, adr_1.generateADRFilename)(9999, 'Max Decision')).toBe('9999-max-decision.md');
+        });
+        it('handles titles with special characters', () => {
+            expect((0, adr_1.generateADRFilename)(5, 'Switch to React v18!')).toBe('0005-switch-to-react-v18.md');
+        });
+    });
+    describe('getNextADRNumber', () => {
+        it('returns 1 for non-existent directory', () => {
+            expect((0, adr_1.getNextADRNumber)(testDir)).toBe(1);
+        });
+        it('returns 1 for empty directory', () => {
+            fs.mkdirSync(testDir, { recursive: true });
+            expect((0, adr_1.getNextADRNumber)(testDir)).toBe(1);
+        });
+        it('returns next number after existing ADRs', () => {
+            fs.mkdirSync(testDir, { recursive: true });
+            fs.writeFileSync(path.join(testDir, '0001-first.md'), '# First');
+            fs.writeFileSync(path.join(testDir, '0002-second.md'), '# Second');
+            expect((0, adr_1.getNextADRNumber)(testDir)).toBe(3);
+        });
+        it('handles non-sequential numbers correctly', () => {
+            fs.mkdirSync(testDir, { recursive: true });
+            fs.writeFileSync(path.join(testDir, '0001-first.md'), '# First');
+            fs.writeFileSync(path.join(testDir, '0005-fifth.md'), '# Fifth');
+            expect((0, adr_1.getNextADRNumber)(testDir)).toBe(6);
+        });
+        it('ignores files without number prefix', () => {
+            fs.mkdirSync(testDir, { recursive: true });
+            fs.writeFileSync(path.join(testDir, '0001-first.md'), '# First');
+            fs.writeFileSync(path.join(testDir, 'README.md'), '# README');
+            fs.writeFileSync(path.join(testDir, 'template.md'), '# Template');
+            expect((0, adr_1.getNextADRNumber)(testDir)).toBe(2);
+        });
+        it('ignores files with incorrect number format', () => {
+            fs.mkdirSync(testDir, { recursive: true });
+            fs.writeFileSync(path.join(testDir, '0001-first.md'), '# First');
+            fs.writeFileSync(path.join(testDir, '1-wrong.md'), '# Wrong');
+            fs.writeFileSync(path.join(testDir, '00002-also-wrong.md'), '# Also Wrong');
+            expect((0, adr_1.getNextADRNumber)(testDir)).toBe(2);
+        });
+        it('handles directory with only non-ADR files', () => {
+            fs.mkdirSync(testDir, { recursive: true });
+            fs.writeFileSync(path.join(testDir, 'README.md'), '# README');
+            expect((0, adr_1.getNextADRNumber)(testDir)).toBe(1);
+        });
+    });
+    describe('ensureADRDirectory', () => {
+        it('creates directory if it does not exist', () => {
+            (0, adr_1.ensureADRDirectory)(testDir);
+            expect(fs.existsSync(testDir)).toBe(true);
+            expect(fs.statSync(testDir).isDirectory()).toBe(true);
+        });
+        it('creates nested directories recursively', () => {
+            const nestedDir = path.join(testDir, 'nested', 'path');
+            (0, adr_1.ensureADRDirectory)(nestedDir);
+            expect(fs.existsSync(nestedDir)).toBe(true);
+            expect(fs.statSync(nestedDir).isDirectory()).toBe(true);
+        });
+        it('does not error if directory already exists', () => {
+            fs.mkdirSync(testDir, { recursive: true });
+            expect(() => (0, adr_1.ensureADRDirectory)(testDir)).not.toThrow();
+            expect(fs.existsSync(testDir)).toBe(true);
+        });
+        it('can be called multiple times safely', () => {
+            (0, adr_1.ensureADRDirectory)(testDir);
+            (0, adr_1.ensureADRDirectory)(testDir);
+            (0, adr_1.ensureADRDirectory)(testDir);
+            expect(fs.existsSync(testDir)).toBe(true);
+        });
+    });
+    describe('saveADR', () => {
+        it('saves ADR with correct filename in specified directory', () => {
+            const content = '# Use PostgreSQL\n\n* Status: accepted\n\nContent here';
+            const result = (0, adr_1.saveADR)(content, 'Use PostgreSQL', testDir);
+            expect(result.success).toBe(true);
+            expect(result.filePath).toBe(path.join(testDir, '0001-use-postgresql.md'));
+            expect(result.error).toBeUndefined();
+            expect(fs.existsSync(result.filePath)).toBe(true);
+        });
+        it('creates directory automatically if it does not exist', () => {
+            const content = '# Test ADR\n\nContent';
+            const result = (0, adr_1.saveADR)(content, 'Test ADR', testDir);
+            expect(fs.existsSync(testDir)).toBe(true);
+            expect(result.success).toBe(true);
+        });
+        it('increments number for multiple ADRs', () => {
+            const result1 = (0, adr_1.saveADR)('# First\n\nFirst ADR', 'First', testDir);
+            const result2 = (0, adr_1.saveADR)('# Second\n\nSecond ADR', 'Second', testDir);
+            const result3 = (0, adr_1.saveADR)('# Third\n\nThird ADR', 'Third', testDir);
+            expect(result1.filePath).toContain('0001-first.md');
+            expect(result2.filePath).toContain('0002-second.md');
+            expect(result3.filePath).toContain('0003-third.md');
+            expect(fs.existsSync(result1.filePath)).toBe(true);
+            expect(fs.existsSync(result2.filePath)).toBe(true);
+            expect(fs.existsSync(result3.filePath)).toBe(true);
+        });
+        it('saves correct content to file', () => {
+            const content = '# My Decision\n\n* Status: accepted\n* Date: 2025-10-21\n\n## Context\n\nSome context here.';
+            const result = (0, adr_1.saveADR)(content, 'My Decision', testDir);
+            const savedContent = fs.readFileSync(result.filePath, 'utf-8');
+            expect(savedContent).toBe(content);
+        });
+        it('uses default directory when not specified', () => {
+            // Clean up default directory
+            const defaultPath = path.join(process.cwd(), adr_1.DEFAULT_ADR_DIR);
+            if (fs.existsSync(defaultPath)) {
+                fs.rmSync(defaultPath, { recursive: true, force: true });
+            }
+            const content = '# Default Location\n\nContent';
+            const result = (0, adr_1.saveADR)(content, 'Default Location');
+            expect(result.success).toBe(true);
+            expect(result.filePath).toContain(adr_1.DEFAULT_ADR_DIR);
+            // Cleanup
+            if (fs.existsSync(defaultPath)) {
+                fs.rmSync(defaultPath, { recursive: true, force: true });
+            }
+        });
+        it('handles file write errors gracefully', () => {
+            // Create a read-only directory to trigger write error
+            fs.mkdirSync(testDir, { recursive: true });
+            // Make directory read-only (if not Windows)
+            if (process.platform !== 'win32') {
+                fs.chmodSync(testDir, 0o444);
+                const content = '# Test\n\nContent';
+                const result = (0, adr_1.saveADR)(content, 'Test', testDir);
+                expect(result.success).toBe(false);
+                expect(result.error).toBeDefined();
+                expect(result.filePath).toBeUndefined();
+                // Restore permissions for cleanup
+                fs.chmodSync(testDir, 0o755);
+            }
+            else {
+                // On Windows, just verify error handling structure exists
+                // Skip actual permission test as Windows permissions work differently
+                const content = '# Test\n\nContent';
+                const result = (0, adr_1.saveADR)(content, 'Test', testDir);
+                // Should succeed on Windows since we can't easily simulate permission errors
+                expect(result).toHaveProperty('success');
+                expect(typeof result.success).toBe('boolean');
+            }
+        });
+        it('handles long titles correctly', () => {
+            const longTitle = 'This is a very long title that should still work correctly when converted to a filename slug';
+            const content = `# ${longTitle}\n\nContent`;
+            const result = (0, adr_1.saveADR)(content, longTitle, testDir);
+            expect(result.success).toBe(true);
+            expect(result.filePath).toContain('0001-this-is-a-very-long-title');
+        });
+        it('handles titles with unicode characters', () => {
+            const content = '# Decision with émojis 🚀\n\nContent';
+            const result = (0, adr_1.saveADR)(content, 'Decision with émojis 🚀', testDir);
+            expect(result.success).toBe(true);
+            // Should strip unicode to safe characters
+            expect(result.filePath).toMatch(/0001-.+\.md$/);
+        });
+    });
+    describe('DEFAULT_ADR_DIR constant', () => {
+        it('is defined and has expected value', () => {
+            expect(adr_1.DEFAULT_ADR_DIR).toBeDefined();
+            expect(adr_1.DEFAULT_ADR_DIR).toBe('docs/adr');
+        });
+    });
+});
+//# sourceMappingURL=adr.test.js.map

package/dist/adr.test.js.map

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

package/dist/analysis.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Analysis Orchestration Module
+ *
+ * Coordinates the complete analysis flow: config loading, git operations,
+ * prompt formatting, LLM analysis, and result display.
+ * Implements fail-open principle per constitution requirements.
+ */
+import { DiffOptions } from './git';
+/**
+ * Run complete analysis workflow
+ *
+ * This function orchestrates the entire analysis process:
+ * 1. Load configuration
+ * 2. Get changed files and diff based on options
+ * 3. Format LLM prompt
+ * 4. Call LLM for analysis
+ * 5. Display results
+ *
+ * Follows fail-open principle: always exits cleanly, never throws.
+ *
+ * @param diffOptions - Options specifying which changes to analyze (defaults to all uncommitted)
+ */
+export declare function runAnalysis(diffOptions?: DiffOptions): Promise<void>;
+//# sourceMappingURL=analysis.d.ts.map

package/dist/analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analysis.d.ts","sourceRoot":"","sources":["../src/analysis.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAA4B,WAAW,EAAY,MAAM,OAAO,CAAC;AAOxE;;;;;;;;;;;;;GAaG;AACH,wBAAsB,WAAW,CAAC,WAAW,GAAE,WAA6B,GAAG,OAAO,CAAC,IAAI,CAAC,CAsO3F"}