specweave 0.22.11 → 0.22.13

package/dist/src/cli/helpers/init/initial-increment-generator.js

@@ -0,0 +1,240 @@
+/**
+ * Initial Increment Generator
+ *
+ * Automatically creates increment 0001-project-setup during `specweave init`
+ * so users have a valid starting point to work from.
+ *
+ * Part of: Empty increments folder fix (2025-11-19)
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { IncrementStatus, IncrementType } from '../../../core/types/increment-metadata.js';
+import { MetadataManager } from '../../../core/increment/metadata-manager.js';
+/**
+ * Generate initial increment (0001-project-setup) during init
+ *
+ * Creates:
+ * - .specweave/increments/0001-project-setup/
+ * - spec.md (basic project setup requirements)
+ * - plan.md (placeholder for implementation plan)
+ * - tasks.md (initial setup tasks)
+ * - metadata.json (ACTIVE status)
+ */
+export async function generateInitialIncrement(options) {
+    const { projectPath, projectName, techStack, language = 'en' } = options;
+    const incrementId = '0001-project-setup';
+    const incrementPath = path.join(projectPath, '.specweave', 'increments', incrementId);
+    // Create increment directory
+    fs.ensureDirSync(incrementPath);
+    // Generate spec.md
+    const specContent = generateSpecMd(projectName, techStack);
+    fs.writeFileSync(path.join(incrementPath, 'spec.md'), specContent, 'utf-8');
+    // Generate plan.md
+    const planContent = generatePlanMd(projectName);
+    fs.writeFileSync(path.join(incrementPath, 'plan.md'), planContent, 'utf-8');
+    // Generate tasks.md
+    const tasksContent = generateTasksMd(projectName, techStack);
+    fs.writeFileSync(path.join(incrementPath, 'tasks.md'), tasksContent, 'utf-8');
+    // Generate metadata.json
+    const metadata = {
+        id: incrementId,
+        type: IncrementType.FEATURE,
+        status: IncrementStatus.ACTIVE,
+        created: new Date().toISOString().split('T')[0],
+        lastActivity: new Date().toISOString().split('T')[0],
+        testMode: 'test-after',
+        coverageTarget: 80
+    };
+    MetadataManager.write(incrementId, metadata);
+    return incrementId;
+}
+/**
+ * Generate spec.md content
+ */
+function generateSpecMd(projectName, techStack) {
+    const techStackSection = techStack
+        ? `**Tech Stack**: ${techStack}\n`
+        : '';
+    return `---
+increment: 0001-project-setup
+title: "Project Setup"
+type: feature
+priority: P0
+status: active
+created: ${new Date().toISOString().split('T')[0]}
+epic: SETUP-001
+test_mode: test-after
+coverage_target: 80
+---
+
+# Feature: Project Setup
+
+## Overview
+
+Initialize ${projectName} with SpecWeave framework and establish development workflow.
+
+${techStackSection}
+**Business Impact**: Foundation for spec-driven development process.
+
+---
+
+## User Stories
+
+### US-001: Development Environment
+
+**As a** developer
+**I want** a properly configured development environment
+**So that** I can start building features immediately
+
+**Acceptance Criteria**:
+- [ ] **AC-US1-01**: Project structure created with .specweave/ folder
+  - **Priority**: P0 (Critical)
+  - **Testable**: Yes
+
+- [ ] **AC-US1-02**: Documentation framework initialized
+  - **Priority**: P0 (Critical)
+  - **Testable**: Yes
+
+- [ ] **AC-US1-03**: SpecWeave commands available (/specweave:increment, /specweave:do, etc.)
+  - **Priority**: P0 (Critical)
+  - **Testable**: Yes
+
+---
+
+## Notes
+
+**IMPORTANT**: This is your initial increment created by \`specweave init\`.
+
+**Next steps**:
+1. Review this spec and customize it for your project
+2. Run \`/specweave:plan\` to generate implementation tasks
+3. Run \`/specweave:do\` to start working on tasks
+4. Create your first feature with \`/specweave:increment "your-feature"\`
+
+You can also delete this increment if you prefer to start fresh:
+- Delete \`.specweave/increments/0001-project-setup/\`
+- Create your first real increment with \`/specweave:increment "my-feature"\`
+`;
+}
+/**
+ * Generate plan.md content
+ */
+function generatePlanMd(projectName) {
+    return `---
+increment: 0001-project-setup
+generated: ${new Date().toISOString()}
+---
+
+# Implementation Plan: Project Setup
+
+## Overview
+
+Initial setup for ${projectName} with SpecWeave framework.
+
+---
+
+## Implementation Steps
+
+### Phase 1: Environment Setup ✅
+
+**Status**: COMPLETED (via \`specweave init\`)
+
+Steps completed:
+1. ✅ Created .specweave/ directory structure
+2. ✅ Initialized git repository
+3. ✅ Created CLAUDE.md and AGENTS.md instruction files
+4. ✅ Configured SpecWeave plugins (Claude Code)
+
+### Phase 2: First Feature Planning
+
+**Status**: PENDING (ready when you are!)
+
+Next actions:
+1. Customize this increment spec to match your project goals
+2. OR delete this increment and create your first real feature:
+   \`\`\`
+   /specweave:increment "user-authentication"
+   /specweave:increment "api-endpoints"
+   /specweave:increment "database-schema"
+   \`\`\`
+
+---
+
+## Notes
+
+This is a placeholder plan created by \`specweave init\`.
+
+**Recommended**: Create a new increment for your first real feature instead of using this setup increment.
+`;
+}
+/**
+ * Generate tasks.md content
+ */
+function generateTasksMd(projectName, techStack) {
+    const techStackNote = techStack
+        ? `\n**Tech Stack**: ${techStack}`
+        : '';
+    return `---
+increment: 0001-project-setup
+total_tasks: 1
+completed_tasks: 1
+---
+
+# Tasks: Project Setup${techStackNote}
+
+## User Story: US-001 - Development Environment
+
+**Linked ACs**: AC-US1-01, AC-US1-02, AC-US1-03
+**Tasks**: 1 total, 1 completed
+
+---
+
+### T-001: Initialize SpecWeave Framework
+
+**User Story**: US-001
+**Satisfies ACs**: AC-US1-01, AC-US1-02, AC-US1-03
+**Status**: [x] completed
+**Priority**: P0 (Critical)
+**Estimated Effort**: 0 hours (automated)
+
+**Description**:
+Ran \`specweave init\` to create project structure, install plugins, and configure framework.
+
+**Implementation Steps**:
+1. ✅ Created .specweave/ directory with increments, docs folders
+2. ✅ Generated CLAUDE.md and AGENTS.md instruction files
+3. ✅ Initialized git repository
+4. ✅ Created this initial increment (0001-project-setup)
+
+**Test Plan**:
+- **Manual**: Verify \`/specweave:status\` shows active increment
+- **Manual**: Verify SpecWeave commands available
+
+**Files Affected**:
+- \`.specweave/\` (entire structure)
+- \`CLAUDE.md\`, \`AGENTS.md\`, \`README.md\`
+
+---
+
+## Next Steps
+
+This initial increment is now **COMPLETE**. You have two options:
+
+### Option 1: Start Fresh (Recommended)
+Delete this increment and create your first real feature:
+\`\`\`bash
+rm -rf .specweave/increments/0001-project-setup
+/specweave:increment "your-first-feature"
+\`\`\`
+
+### Option 2: Customize This Increment
+Keep this increment and add your own tasks:
+\`\`\`bash
+/specweave:plan  # Regenerate tasks based on updated spec.md
+/specweave:do    # Start working on tasks
+\`\`\`
+
+**Recommended**: Go with Option 1 and create meaningful increments for your project!
+`;
+}
+//# sourceMappingURL=initial-increment-generator.js.map

package/dist/src/cli/helpers/init/initial-increment-generator.js.map

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

package/dist/src/generators/spec/spec-parser.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Spec Parser - Extract User Stories and Acceptance Criteria from spec.md
+ *
+ * Parses increment spec.md files to extract:
+ * - User Story IDs (US-001, US-002, etc.)
+ * - Acceptance Criteria IDs (AC-US1-01, AC-US1-02, etc.)
+ * - User Story titles and metadata
+ *
+ * Used by AC coverage validator to cross-reference tasks with requirements.
+ */
+/**
+ * User Story metadata
+ */
+export interface UserStory {
+    /** User Story ID (e.g., "US-001") */
+    id: string;
+    /** User Story title */
+    title: string;
+    /** Priority (P0, P1, P2, P3) */
+    priority?: string;
+    /** Acceptance Criteria IDs for this US */
+    acceptanceCriteria: string[];
+    /** Full text of the user story */
+    description?: string;
+    /** Line number in spec.md */
+    lineNumber?: number;
+}
+/**
+ * Spec metadata
+ */
+export interface SpecMetadata {
+    /** Increment ID */
+    incrementId: string;
+    /** Increment title */
+    title: string;
+    /** All User Stories */
+    userStories: UserStory[];
+    /** All AC-IDs (flattened from all user stories) */
+    allACIds: string[];
+}
+/**
+ * Parse spec.md to extract User Stories and Acceptance Criteria
+ *
+ * @param specPath - Path to spec.md file
+ * @returns Spec metadata with User Stories and AC-IDs
+ * @throws Error if spec.md cannot be read or is malformed
+ */
+export declare function parseSpecMd(specPath: string): SpecMetadata;
+/**
+ * Get all User Story IDs from spec
+ *
+ * @param specPath - Path to spec.md
+ * @returns Array of US-IDs (e.g., ["US-001", "US-002"])
+ */
+export declare function getAllUSIds(specPath: string): string[];
+/**
+ * Get all AC-IDs from spec
+ *
+ * @param specPath - Path to spec.md
+ * @returns Array of AC-IDs (e.g., ["AC-US1-01", "AC-US1-02"])
+ */
+export declare function getAllACIds(specPath: string): string[];
+/**
+ * Get AC-IDs for a specific User Story
+ *
+ * @param specPath - Path to spec.md
+ * @param usId - User Story ID (e.g., "US-001")
+ * @returns Array of AC-IDs for that US
+ */
+export declare function getACsForUS(specPath: string, usId: string): string[];
+/**
+ * Validate that an AC-ID belongs to the correct User Story
+ *
+ * @param acId - AC-ID to validate (e.g., "AC-US1-01")
+ * @param usId - Expected User Story ID (e.g., "US-001")
+ * @returns True if AC belongs to US, false otherwise
+ */
+export declare function validateACBelongsToUS(acId: string, usId: string): boolean;
+//# sourceMappingURL=spec-parser.d.ts.map

package/dist/src/generators/spec/spec-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spec-parser.d.ts","sourceRoot":"","sources":["../../../../src/generators/spec/spec-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,uBAAuB;IACvB,KAAK,EAAE,MAAM,CAAC;IAEd,gCAAgC;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,0CAA0C;IAC1C,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAE7B,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;IAEpB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,uBAAuB;IACvB,WAAW,EAAE,SAAS,EAAE,CAAC;IAEzB,mDAAmD;IACnD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuB1D;AA8GD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAGtD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAIpE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAczE"}

package/dist/src/generators/spec/spec-parser.js

@@ -0,0 +1,185 @@
+/**
+ * Spec Parser - Extract User Stories and Acceptance Criteria from spec.md
+ *
+ * Parses increment spec.md files to extract:
+ * - User Story IDs (US-001, US-002, etc.)
+ * - Acceptance Criteria IDs (AC-US1-01, AC-US1-02, etc.)
+ * - User Story titles and metadata
+ *
+ * Used by AC coverage validator to cross-reference tasks with requirements.
+ */
+import { readFileSync } from 'fs';
+/**
+ * Parse spec.md to extract User Stories and Acceptance Criteria
+ *
+ * @param specPath - Path to spec.md file
+ * @returns Spec metadata with User Stories and AC-IDs
+ * @throws Error if spec.md cannot be read or is malformed
+ */
+export function parseSpecMd(specPath) {
+    try {
+        const content = readFileSync(specPath, 'utf-8');
+        const lines = content.split('\n');
+        // Extract increment ID and title from frontmatter
+        const { incrementId, title } = parseFrontmatter(lines);
+        // Extract User Stories
+        const userStories = extractUserStories(lines);
+        // Flatten all AC-IDs
+        const allACIds = userStories.flatMap(us => us.acceptanceCriteria);
+        return {
+            incrementId,
+            title,
+            userStories,
+            allACIds
+        };
+    }
+    catch (error) {
+        throw new Error(`Failed to parse spec.md at ${specPath}: ${error}`);
+    }
+}
+/**
+ * Parse YAML frontmatter to extract increment ID and title
+ */
+function parseFrontmatter(lines) {
+    let incrementId = '';
+    let title = '';
+    let inFrontmatter = false;
+    for (const line of lines) {
+        if (line.trim() === '---') {
+            if (!inFrontmatter) {
+                inFrontmatter = true;
+                continue;
+            }
+            else {
+                break; // End of frontmatter
+            }
+        }
+        if (inFrontmatter) {
+            const incrementMatch = line.match(/^increment:\s*(.+)$/);
+            if (incrementMatch) {
+                incrementId = incrementMatch[1].trim();
+            }
+            const titleMatch = line.match(/^title:\s*["']?(.+?)["']?$/);
+            if (titleMatch) {
+                title = titleMatch[1].trim();
+            }
+        }
+    }
+    return { incrementId, title };
+}
+/**
+ * Extract User Stories and their Acceptance Criteria
+ */
+function extractUserStories(lines) {
+    const userStories = [];
+    let currentUS = null;
+    let inACSection = false;
+    // Regex patterns
+    const usHeaderRegex = /^###?\s+(US-\d{3}):\s*(.+)$/; // ### US-001: Title or ## US-001: Title
+    const acRegex = /^-\s*\[[x ]\]\s*\*\*(AC-US\d+-\d{2})\*\*/; // - [ ] **AC-US1-01**
+    const priorityRegex = /\*\*Priority\*\*:\s*(P[0-3])/;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const lineNumber = i + 1;
+        // Check for User Story header
+        const usMatch = line.match(usHeaderRegex);
+        if (usMatch) {
+            // Save previous US if exists
+            if (currentUS) {
+                userStories.push(currentUS);
+            }
+            // Start new US
+            currentUS = {
+                id: usMatch[1],
+                title: usMatch[2],
+                acceptanceCriteria: [],
+                lineNumber
+            };
+            inACSection = false;
+            continue;
+        }
+        // Skip if no current US
+        if (!currentUS)
+            continue;
+        // Check for Acceptance Criteria section
+        if (line.includes('**Acceptance Criteria**:') || line.includes('Acceptance Criteria')) {
+            inACSection = true;
+            continue;
+        }
+        // Check for end of AC section (next major section)
+        if (line.startsWith('##') && !line.match(usHeaderRegex)) {
+            inACSection = false;
+        }
+        // Extract AC-IDs if in AC section
+        if (inACSection) {
+            const acMatch = line.match(acRegex);
+            if (acMatch) {
+                const acId = acMatch[1];
+                currentUS.acceptanceCriteria.push(acId);
+            }
+        }
+        // Extract priority if present
+        const priorityMatch = line.match(priorityRegex);
+        if (priorityMatch && !currentUS.priority) {
+            currentUS.priority = priorityMatch[1];
+        }
+    }
+    // Save last US
+    if (currentUS) {
+        userStories.push(currentUS);
+    }
+    return userStories;
+}
+/**
+ * Get all User Story IDs from spec
+ *
+ * @param specPath - Path to spec.md
+ * @returns Array of US-IDs (e.g., ["US-001", "US-002"])
+ */
+export function getAllUSIds(specPath) {
+    const spec = parseSpecMd(specPath);
+    return spec.userStories.map(us => us.id);
+}
+/**
+ * Get all AC-IDs from spec
+ *
+ * @param specPath - Path to spec.md
+ * @returns Array of AC-IDs (e.g., ["AC-US1-01", "AC-US1-02"])
+ */
+export function getAllACIds(specPath) {
+    const spec = parseSpecMd(specPath);
+    return spec.allACIds;
+}
+/**
+ * Get AC-IDs for a specific User Story
+ *
+ * @param specPath - Path to spec.md
+ * @param usId - User Story ID (e.g., "US-001")
+ * @returns Array of AC-IDs for that US
+ */
+export function getACsForUS(specPath, usId) {
+    const spec = parseSpecMd(specPath);
+    const us = spec.userStories.find(story => story.id === usId);
+    return us ? us.acceptanceCriteria : [];
+}
+/**
+ * Validate that an AC-ID belongs to the correct User Story
+ *
+ * @param acId - AC-ID to validate (e.g., "AC-US1-01")
+ * @param usId - Expected User Story ID (e.g., "US-001")
+ * @returns True if AC belongs to US, false otherwise
+ */
+export function validateACBelongsToUS(acId, usId) {
+    // Extract US number from AC-ID: AC-US1-01 → 1
+    const acMatch = acId.match(/^AC-US(\d+)-\d{2}$/);
+    if (!acMatch)
+        return false;
+    const acUSNumber = parseInt(acMatch[1], 10);
+    // Extract US number from US-ID: US-001 → 1
+    const usMatch = usId.match(/^US-(\d{3})$/);
+    if (!usMatch)
+        return false;
+    const usNumber = parseInt(usMatch[1], 10);
+    return acUSNumber === usNumber;
+}
+//# sourceMappingURL=spec-parser.js.map

package/dist/src/generators/spec/spec-parser.js.map

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

package/dist/src/generators/spec/task-parser.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Task Parser with US-Task Linkage Support
+ *
+ * Parses tasks.md files to extract task metadata including new US linkage fields:
+ * - userStory: US-ID this task implements (e.g., "US-001")
+ * - satisfiesACs: List of AC-IDs this task satisfies (e.g., ["AC-US1-01", "AC-US1-02"])
+ *
+ * Supports hierarchical task structure grouped by User Story.
+ */
+/**
+ * Task metadata extracted from tasks.md
+ */
+export interface Task {
+    /** Task ID (e.g., "T-001") */
+    id: string;
+    /** Task title */
+    title: string;
+    /** User Story this task implements (optional for backward compatibility) */
+    userStory?: string;
+    /** Acceptance Criteria IDs this task satisfies (optional) */
+    satisfiesACs?: string[];
+    /** Task completion status */
+    status: TaskStatus;
+    /** Priority level (P0, P1, P2, P3) */
+    priority?: string;
+    /** Estimated effort (e.g., "4 hours", "2 days") */
+    estimatedEffort?: string;
+    /** Task dependencies (task IDs this depends on) */
+    dependencies?: string[];
+    /** Full task description */
+    description?: string;
+    /** Files affected by this task */
+    filesAffected?: string[];
+    /** Line number in tasks.md (for error reporting) */
+    lineNumber?: number;
+}
+/**
+ * Task completion status
+ */
+export type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'transferred' | 'canceled';
+/**
+ * Tasks grouped by User Story
+ */
+export interface TasksByUserStory {
+    [usId: string]: Task[];
+}
+/**
+ * Validation error for task linkage
+ */
+export interface TaskLinkageError {
+    taskId: string;
+    field: 'userStory' | 'satisfiesACs';
+    value: string;
+    message: string;
+    suggestedFix?: string;
+}
+/**
+ * Parse tasks.md and extract all tasks with US linkage
+ *
+ * @param tasksPath - Path to tasks.md file
+ * @returns Map of User Story ID → Tasks
+ * @throws Error if tasks.md cannot be read or is malformed
+ */
+export declare function parseTasksWithUSLinks(tasksPath: string): TasksByUserStory;
+/**
+ * Validate task US and AC linkage
+ *
+ * @param task - Task to validate
+ * @param validUSIds - List of valid US-IDs from spec.md
+ * @param validACIds - List of valid AC-IDs from spec.md
+ * @returns Array of validation errors (empty if valid)
+ */
+export declare function validateTaskLinkage(task: Task, validUSIds: string[], validACIds: string[]): TaskLinkageError[];
+/**
+ * Get all tasks (flattened, not grouped by US)
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Array of all tasks
+ */
+export declare function getAllTasks(tasksByUS: TasksByUserStory): Task[];
+/**
+ * Count tasks by status
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Map of status → count
+ */
+export declare function countTasksByStatus(tasksByUS: TasksByUserStory): Record<TaskStatus, number>;
+/**
+ * Calculate completion percentage
+ *
+ * @param tasksByUS - Tasks grouped by User Story
+ * @returns Completion percentage (0-100)
+ */
+export declare function calculateCompletionPercentage(tasksByUS: TasksByUserStory): number;
+//# sourceMappingURL=task-parser.d.ts.map

package/dist/src/generators/spec/task-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../../../../src/generators/spec/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,8BAA8B;IAC9B,EAAE,EAAE,MAAM,CAAC;IAEX,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IAEd,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,6DAA6D;IAC7D,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,6BAA6B;IAC7B,MAAM,EAAE,UAAU,CAAC;IAEnB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,mDAAmD;IACnD,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAExB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kCAAkC;IAClC,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAE9F;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,WAAW,GAAG,cAAc,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB,CAoJzE;AAoBD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,UAAU,EAAE,MAAM,EAAE,EACpB,UAAU,EAAE,MAAM,EAAE,GACnB,gBAAgB,EAAE,CAyEpB;AAkBD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,gBAAgB,GAAG,IAAI,EAAE,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,CAe1F;AAED;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAMjF"}