maestro-flow 0.1.0

package/dist/tools/spec-init.js

@@ -0,0 +1,215 @@
+/**
+ * Spec Init
+ *
+ * Initialize .workflow/specs/ directory with frontmatter-enabled seed documents.
+ * Idempotent: skips existing files, only creates missing ones.
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// Seed Documents
+// ============================================================================
+const SEED_DOCS = [
+    {
+        filename: 'coding-conventions.md',
+        frontmatter: {
+            title: 'Coding Conventions',
+            readMode: 'required',
+            priority: 'high',
+            category: 'execution',
+            keywords: ['style', 'naming', 'import', 'pattern', 'convention', 'formatting'],
+        },
+        body: `# Coding Conventions
+
+## Formatting
+
+## Naming
+
+## Imports
+
+## Patterns
+
+## Manual Additions
+
+`,
+    },
+    {
+        filename: 'architecture-constraints.md',
+        frontmatter: {
+            title: 'Architecture Constraints',
+            readMode: 'required',
+            priority: 'high',
+            category: 'planning',
+            keywords: ['architecture', 'module', 'layer', 'boundary', 'dependency', 'structure'],
+        },
+        body: `# Architecture Constraints
+
+## Module Structure
+
+## Layer Boundaries
+
+## Dependency Rules
+
+## Technology Constraints
+
+## Manual Additions
+
+`,
+    },
+    {
+        filename: 'quality-rules.md',
+        frontmatter: {
+            title: 'Quality Rules',
+            readMode: 'required',
+            priority: 'medium',
+            category: 'execution',
+            keywords: ['quality', 'test', 'coverage', 'lint', 'rule', 'validation'],
+        },
+        body: `# Quality Rules
+
+## Rules
+
+## Manual
+
+`,
+    },
+    {
+        filename: 'learnings.md',
+        frontmatter: {
+            title: 'Learnings',
+            readMode: 'optional',
+            priority: 'medium',
+            category: 'general',
+            keywords: ['bug', 'lesson', 'gotcha', 'learning'],
+        },
+        body: `# Learnings
+
+## Entries
+
+`,
+    },
+    {
+        filename: 'debug-notes.md',
+        frontmatter: {
+            title: 'Debug Notes',
+            readMode: 'optional',
+            priority: 'medium',
+            category: 'debug',
+            keywords: ['debug', 'issue', 'workaround', 'root-cause', 'gotcha'],
+        },
+        body: `# Debug Notes
+
+Known issues, debugging tips, and root cause records.
+Add entries with: \`/spec-add debug <description>\`
+
+## Entries
+
+`,
+    },
+    {
+        filename: 'test-conventions.md',
+        frontmatter: {
+            title: 'Test Conventions',
+            readMode: 'required',
+            priority: 'high',
+            category: 'test',
+            keywords: ['test', 'coverage', 'mock', 'fixture', 'assertion', 'framework'],
+        },
+        body: `# Test Conventions
+
+## Framework
+
+## Directory Structure
+
+## Naming Conventions
+
+## Patterns
+
+## Manual Additions
+
+`,
+    },
+    {
+        filename: 'review-standards.md',
+        frontmatter: {
+            title: 'Review Standards',
+            readMode: 'required',
+            priority: 'medium',
+            category: 'review',
+            keywords: ['review', 'checklist', 'gate', 'approval', 'standard'],
+        },
+        body: `# Review Standards
+
+## Review Checklist
+
+## Quality Gates
+
+## Manual Additions
+
+`,
+    },
+    {
+        filename: 'validation-rules.md',
+        frontmatter: {
+            title: 'Validation Rules',
+            readMode: 'required',
+            priority: 'high',
+            category: 'validation',
+            keywords: ['validation', 'verification', 'acceptance', 'criteria', 'check'],
+        },
+        body: `# Validation Rules
+
+## Verification Criteria
+
+## Acceptance Standards
+
+## Manual Additions
+
+`,
+    },
+];
+// ============================================================================
+// Helpers
+// ============================================================================
+function formatFrontmatter(fm) {
+    const keywordsYaml = fm.keywords.map(k => `  - ${k}`).join('\n');
+    return [
+        '---',
+        `title: "${fm.title}"`,
+        `readMode: ${fm.readMode}`,
+        `priority: ${fm.priority}`,
+        `category: ${fm.category}`,
+        'keywords:',
+        keywordsYaml,
+        '---',
+    ].join('\n');
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Initialize the spec system directory structure and seed documents.
+ * Idempotent: creates directories if missing, writes seed files only when absent.
+ */
+export function initSpecSystem(projectPath) {
+    const result = { created: [], skipped: [], directories: [] };
+    const specsDir = join(projectPath, '.workflow', 'specs');
+    // Create directory
+    if (!existsSync(specsDir)) {
+        mkdirSync(specsDir, { recursive: true });
+        result.directories.push(specsDir);
+    }
+    // Write seed documents
+    for (const doc of SEED_DOCS) {
+        const filePath = join(specsDir, doc.filename);
+        if (existsSync(filePath)) {
+            result.skipped.push(filePath);
+            continue;
+        }
+        const content = formatFrontmatter(doc.frontmatter) + '\n\n' + doc.body;
+        writeFileSync(filePath, content, 'utf-8');
+        result.created.push(filePath);
+    }
+    return result;
+}
+//# sourceMappingURL=spec-init.js.map

package/dist/tools/spec-init.js.map

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

package/dist/tools/spec-keyword-extractor.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Spec Keyword Extractor
+ *
+ * Extracts keywords from user prompt text for matching against
+ * spec document YAML frontmatter keywords.
+ *
+ * Supports English word tokenization and CJK character extraction.
+ */
+export declare const STOP_WORDS: Set<string>;
+/**
+ * Extract keywords from prompt text.
+ * English: tokenize, lowercase, remove stop words.
+ * CJK: extract contiguous segments + 2-char bigrams.
+ */
+export declare function extractKeywords(text: string): string[];
+/**
+ * Check if a keyword matches any entry in a keyword list.
+ */
+export declare function keywordMatches(keyword: string, targets: string[]): boolean;
+/**
+ * Calculate match score between extracted and spec keywords.
+ */
+export declare function calculateMatchScore(extracted: string[], specKeywords: string[]): number;
+//# sourceMappingURL=spec-keyword-extractor.d.ts.map

package/dist/tools/spec-keyword-extractor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-keyword-extractor.d.ts","sourceRoot":"","sources":["../../src/tools/spec-keyword-extractor.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,UAAU,aAerB,CAAC;AAMH;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CA6BtD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAM1E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,CAOvF"}

package/dist/tools/spec-keyword-extractor.js

@@ -0,0 +1,84 @@
+/**
+ * Spec Keyword Extractor
+ *
+ * Extracts keywords from user prompt text for matching against
+ * spec document YAML frontmatter keywords.
+ *
+ * Supports English word tokenization and CJK character extraction.
+ */
+export const STOP_WORDS = new Set([
+    'a', 'an', 'the', 'i', 'me', 'my', 'we', 'our', 'you', 'your', 'he', 'she', 'it', 'they', 'them',
+    'this', 'that', 'these', 'those', 'what', 'which', 'who', 'whom',
+    'in', 'on', 'at', 'to', 'for', 'of', 'with', 'by', 'from', 'as', 'into',
+    'about', 'between', 'through', 'after', 'before', 'above', 'below',
+    'and', 'or', 'but', 'if', 'then', 'else', 'when', 'while', 'so', 'because',
+    'is', 'am', 'are', 'was', 'were', 'be', 'been', 'being',
+    'has', 'have', 'had', 'do', 'does', 'did',
+    'will', 'would', 'shall', 'should', 'may', 'might', 'can', 'could', 'must',
+    'get', 'got', 'make', 'made', 'let', 'go', 'going', 'come', 'take', 'give',
+    'not', 'no', 'yes', 'also', 'just', 'only', 'very', 'too', 'now', 'here',
+    'there', 'how', 'why', 'where', 'all', 'each', 'every', 'both', 'some',
+    'any', 'most', 'more', 'less', 'much', 'many', 'few', 'other', 'such',
+    'please', 'need', 'want', 'like', 'know', 'think', 'see', 'use', 'using',
+    'way', 'thing', 'something', 'anything', 'nothing',
+]);
+const CJK_REGEX = /[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff]/;
+const CJK_SEGMENT_REGEX = /[\u4e00-\u9fff\u3400-\u4dbf\uf900-\ufaff]+/g;
+const WORD_SPLIT_REGEX = /[\s,;:!?.()\[\]{}<>"'`~@#$%^&*+=|\\/_\-\u3001\u3002\uff0c\uff1b\uff1a\uff01\uff1f]+/;
+/**
+ * Extract keywords from prompt text.
+ * English: tokenize, lowercase, remove stop words.
+ * CJK: extract contiguous segments + 2-char bigrams.
+ */
+export function extractKeywords(text) {
+    if (!text || typeof text !== 'string')
+        return [];
+    const keywords = new Set();
+    // English keywords
+    const cleaned = text.replace(CJK_SEGMENT_REGEX, ' ');
+    const tokens = cleaned
+        .split(WORD_SPLIT_REGEX)
+        .map(t => t.toLowerCase().trim())
+        .filter(t => t.length >= 2 && !STOP_WORDS.has(t) && !/^\d+$/.test(t));
+    for (const t of tokens)
+        keywords.add(t);
+    // CJK keywords
+    if (CJK_REGEX.test(text)) {
+        const segments = text.match(CJK_SEGMENT_REGEX);
+        if (segments) {
+            for (const seg of segments) {
+                keywords.add(seg);
+                if (seg.length > 2) {
+                    for (let i = 0; i <= seg.length - 2; i++) {
+                        keywords.add(seg.substring(i, i + 2));
+                    }
+                }
+            }
+        }
+    }
+    return Array.from(keywords);
+}
+/**
+ * Check if a keyword matches any entry in a keyword list.
+ */
+export function keywordMatches(keyword, targets) {
+    const lower = keyword.toLowerCase();
+    return targets.some(t => {
+        const lt = t.toLowerCase();
+        return lower === lt || lt.includes(lower) || lower.includes(lt);
+    });
+}
+/**
+ * Calculate match score between extracted and spec keywords.
+ */
+export function calculateMatchScore(extracted, specKeywords) {
+    if (!extracted.length || !specKeywords.length)
+        return 0;
+    let score = 0;
+    for (const kw of extracted) {
+        if (keywordMatches(kw, specKeywords))
+            score++;
+    }
+    return score;
+}
+//# sourceMappingURL=spec-keyword-extractor.js.map

package/dist/tools/spec-keyword-extractor.js.map

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

package/dist/tools/spec-keyword-extractor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=spec-keyword-extractor.test.d.ts.map

package/dist/tools/spec-keyword-extractor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-keyword-extractor.test.d.ts","sourceRoot":"","sources":["../../src/tools/spec-keyword-extractor.test.ts"],"names":[],"mappings":""}

package/dist/tools/spec-keyword-extractor.test.js

@@ -0,0 +1,99 @@
+import { describe, it, expect } from 'vitest';
+import { extractKeywords, keywordMatches, calculateMatchScore, STOP_WORDS, } from './spec-keyword-extractor.js';
+describe('STOP_WORDS', () => {
+    it('contains common English stop words', () => {
+        expect(STOP_WORDS.has('the')).toBe(true);
+        expect(STOP_WORDS.has('is')).toBe(true);
+        expect(STOP_WORDS.has('and')).toBe(true);
+    });
+    it('does not contain technical terms', () => {
+        expect(STOP_WORDS.has('api')).toBe(false);
+        expect(STOP_WORDS.has('database')).toBe(false);
+    });
+});
+describe('extractKeywords', () => {
+    it('returns empty array for empty input', () => {
+        expect(extractKeywords('')).toEqual([]);
+    });
+    it('returns empty array for null-ish input', () => {
+        expect(extractKeywords(null)).toEqual([]);
+        expect(extractKeywords(undefined)).toEqual([]);
+    });
+    it('extracts English words and lowercases them', () => {
+        const keywords = extractKeywords('User Authentication Module');
+        expect(keywords).toContain('user');
+        expect(keywords).toContain('authentication');
+        expect(keywords).toContain('module');
+    });
+    it('removes stop words', () => {
+        const keywords = extractKeywords('The user is in the system');
+        expect(keywords).not.toContain('the');
+        expect(keywords).not.toContain('is');
+        expect(keywords).not.toContain('in');
+        expect(keywords).toContain('user');
+        expect(keywords).toContain('system');
+    });
+    it('filters out single characters', () => {
+        const keywords = extractKeywords('a b c hello');
+        expect(keywords).not.toContain('a');
+        expect(keywords).not.toContain('b');
+        expect(keywords).not.toContain('c');
+    });
+    it('filters out pure numbers', () => {
+        const keywords = extractKeywords('version 123 release');
+        expect(keywords).not.toContain('123');
+        expect(keywords).toContain('version');
+        expect(keywords).toContain('release');
+    });
+    it('extracts CJK characters as segments', () => {
+        const keywords = extractKeywords('用户认证模块');
+        expect(keywords).toContain('用户认证模块');
+    });
+    it('generates CJK bigrams for segments > 2 chars', () => {
+        const keywords = extractKeywords('用户认证');
+        expect(keywords).toContain('用户认证');
+        expect(keywords).toContain('用户');
+        expect(keywords).toContain('户认');
+        expect(keywords).toContain('认证');
+    });
+    it('handles mixed English and CJK', () => {
+        const keywords = extractKeywords('API 用户认证 module');
+        expect(keywords).toContain('api');
+        expect(keywords).toContain('module');
+        expect(keywords).toContain('用户认证');
+    });
+    it('returns unique keywords', () => {
+        const keywords = extractKeywords('test test test');
+        const unique = new Set(keywords);
+        expect(keywords.length).toBe(unique.size);
+    });
+});
+describe('keywordMatches', () => {
+    it('matches exact (case insensitive)', () => {
+        expect(keywordMatches('auth', ['Auth', 'Login'])).toBe(true);
+    });
+    it('matches when keyword contains target', () => {
+        expect(keywordMatches('authentication', ['auth'])).toBe(true);
+    });
+    it('matches when target contains keyword', () => {
+        expect(keywordMatches('auth', ['authentication'])).toBe(true);
+    });
+    it('returns false when no match', () => {
+        expect(keywordMatches('database', ['auth', 'login'])).toBe(false);
+    });
+});
+describe('calculateMatchScore', () => {
+    it('returns 0 for empty extracted list', () => {
+        expect(calculateMatchScore([], ['auth'])).toBe(0);
+    });
+    it('returns 0 for empty spec keywords', () => {
+        expect(calculateMatchScore(['auth'], [])).toBe(0);
+    });
+    it('counts matching keywords', () => {
+        expect(calculateMatchScore(['auth', 'login', 'database'], ['authentication', 'user'])).toBe(1); // 'auth' matches 'authentication'
+    });
+    it('returns correct score for full matches', () => {
+        expect(calculateMatchScore(['auth', 'login'], ['auth', 'login'])).toBe(2);
+    });
+});
+//# sourceMappingURL=spec-keyword-extractor.test.js.map

package/dist/tools/spec-keyword-extractor.test.js.map

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

package/dist/tools/spec-loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Spec Loader (simplified)
+ *
+ * Filename-based category routing. No frontmatter dependency.
+ * Reads .workflow/specs/*.md, filters by category via static mapping,
+ * returns concatenated content.
+ */
+export type SpecCategory = 'general' | 'exploration' | 'planning' | 'execution' | 'debug' | 'test' | 'review' | 'validation';
+export interface SpecLoadResult {
+    content: string;
+    matchedSpecs: string[];
+    totalLoaded: number;
+}
+export declare function loadSpecs(projectPath: string, category?: SpecCategory): SpecLoadResult;
+//# sourceMappingURL=spec-loader.d.ts.map

package/dist/tools/spec-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-loader.d.ts","sourceRoot":"","sources":["../../src/tools/spec-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,aAAa,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,QAAQ,GAAG,YAAY,CAAC;AAE7H,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;CACrB;AA0BD,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,cAAc,CA0CtF"}

package/dist/tools/spec-loader.js

@@ -0,0 +1,93 @@
+/**
+ * Spec Loader (simplified)
+ *
+ * Filename-based category routing. No frontmatter dependency.
+ * Reads .workflow/specs/*.md, filters by category via static mapping,
+ * returns concatenated content.
+ */
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+// ============================================================================
+// Filename → Category mapping (single source of truth)
+// ============================================================================
+const CATEGORY_MAP = {
+    'coding-conventions.md': ['execution'],
+    'architecture-constraints.md': ['execution', 'planning'],
+    'quality-rules.md': ['execution'],
+    'debug-notes.md': ['debug'],
+    'test-conventions.md': ['test'],
+    'review-standards.md': ['review'],
+    'validation-rules.md': ['validation'],
+    'learnings.md': ['general'],
+};
+// learnings.md is always included regardless of category filter
+const ALWAYS_INCLUDE = 'learnings.md';
+const SPECS_DIR = '.workflow/specs';
+// ============================================================================
+// Public API
+// ============================================================================
+export function loadSpecs(projectPath, category) {
+    const specsDir = join(projectPath, SPECS_DIR);
+    if (!existsSync(specsDir)) {
+        return { content: '', matchedSpecs: [], totalLoaded: 0 };
+    }
+    let files;
+    try {
+        files = readdirSync(specsDir).filter(f => f.endsWith('.md'));
+    }
+    catch {
+        return { content: '', matchedSpecs: [], totalLoaded: 0 };
+    }
+    const sections = [];
+    const matched = [];
+    for (const file of files) {
+        if (!shouldInclude(file, category))
+            continue;
+        const filePath = join(specsDir, file);
+        let raw;
+        try {
+            raw = readFileSync(filePath, 'utf-8');
+        }
+        catch {
+            continue;
+        }
+        const body = stripFrontmatter(raw).trim();
+        if (!body)
+            continue;
+        sections.push(body);
+        matched.push(file);
+    }
+    return {
+        content: sections.length > 0
+            ? `# Project Specs (${matched.length} loaded)\n\n${sections.join('\n\n---\n\n')}`
+            : '',
+        matchedSpecs: matched,
+        totalLoaded: matched.length,
+    };
+}
+// ============================================================================
+// Internal
+// ============================================================================
+function shouldInclude(filename, category) {
+    // No category filter → load all
+    if (!category)
+        return true;
+    // Always include learnings
+    if (filename === ALWAYS_INCLUDE)
+        return true;
+    const cats = CATEGORY_MAP[filename];
+    if (cats)
+        return cats.includes(category);
+    // Unknown files: include only when no category filter or category is 'general'
+    return category === 'general';
+}
+function stripFrontmatter(raw) {
+    const trimmed = raw.trimStart();
+    if (!trimmed.startsWith('---'))
+        return raw;
+    const endIdx = trimmed.indexOf('\n---', 3);
+    if (endIdx === -1)
+        return raw;
+    return trimmed.substring(endIdx + 4).trim();
+}
+//# sourceMappingURL=spec-loader.js.map

package/dist/tools/spec-loader.js.map

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

package/dist/tools/team-msg.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Team Message Bus - JSONL-based persistent message log for Agent Teams
+ *
+ * Operations:
+ * - log:       Append a message (to defaults to "coordinator", summary auto-generated if omitted)
+ * - read:      Read message(s) by ID
+ * - list:      List recent messages with optional filters (from/to/type/last N)
+ * - status:    Summarize team member activity from message history
+ * - delete:    Delete a specific message by ID
+ * - clear:     Clear all messages for a team
+ * - broadcast: Log a message with to="all"
+ * - get_state: Read role state from meta.json
+ */
+import type { ToolSchema, CcwToolResult } from '../types/tool-schema.js';
+export interface TeamMeta {
+    status: 'active' | 'completed' | 'archived';
+    created_at: string;
+    updated_at: string;
+    archived_at?: string;
+    pipeline_mode?: string;
+    pipeline_stages?: string[];
+    team_name?: string;
+    task_description?: string;
+    roles?: string[];
+    role_state?: Record<string, Record<string, unknown>>;
+}
+export declare function getMetaPath(team: string): string;
+export declare function readTeamMeta(team: string): TeamMeta | null;
+export declare function writeTeamMeta(team: string, meta: TeamMeta): void;
+export declare function inferTeamStatus(team: string): TeamMeta['status'];
+export declare function getEffectiveTeamMeta(team: string): TeamMeta;
+export interface TeamMessage {
+    id: string;
+    ts: string;
+    from: string;
+    to: string;
+    type: string;
+    summary: string;
+    data?: Record<string, unknown>;
+}
+export interface StatusEntry {
+    member: string;
+    lastSeen: string;
+    lastAction: string;
+    messageCount: number;
+}
+export declare const schema: ToolSchema;
+export declare function getLogDir(sessionId: string): string;
+export declare function getLogDirWithFallback(sessionId: string): string;
+export declare function readAllMessages(teamId: string): TeamMessage[];
+export declare function handler(params: Record<string, unknown>): Promise<CcwToolResult>;
+//# sourceMappingURL=team-msg.d.ts.map

package/dist/tools/team-msg.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"team-msg.d.ts","sourceRoot":"","sources":["../../src/tools/team-msg.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAOzE,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,CAAC;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACtD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEhD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAQ1D;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,CAMhE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAKhE;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CA4C3D;AA+CD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AA4BD,eAAO,MAAM,MAAM,EAAE,UAmEpB,CAAC;AAIF,wBAAgB,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAO/D;AAkBD,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAc7D;AAoMD,wBAAsB,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAyBrF"}