popeye-cli 1.10.0 → 2.1.0

package/dist/pipeline/artifact-manager.js

@@ -0,0 +1,251 @@
+/**
+ * Artifact Manager — manages immutable versioned artifacts under /docs/.
+ * Supports both Markdown and JSON content types (P0-C).
+ * Implements version chains via group_id + previous_id (P1-2).
+ */
+import { randomUUID } from 'node:crypto';
+import { createHash } from 'node:crypto';
+import { existsSync, mkdirSync, writeFileSync, readFileSync, readdirSync } from 'node:fs';
+import { join, relative } from 'node:path';
+// ─── Constants ───────────────────────────────────────────
+/** Directory mappings: artifact type -> subdirectory under /docs/ */
+const ARTIFACT_DIRS = {
+    master_plan: 'master-plan',
+    architecture: 'architecture',
+    role_plan: 'role-plans',
+    consensus: 'consensus',
+    arbitration: 'arbitration',
+    audit_report: 'audit',
+    rca_report: 'incidents',
+    production_readiness: 'production',
+    release_notes: 'release',
+    deployment: 'release',
+    rollback: 'release',
+    repo_snapshot: 'snapshots',
+    build_check: 'checks',
+    test_check: 'checks',
+    lint_check: 'checks',
+    typecheck_check: 'checks',
+    placeholder_scan: 'checks',
+    qa_validation: 'role-plans',
+    review_decision: 'consensus',
+    stuck_report: 'incidents',
+    journalist_trace: 'journal',
+    resolved_commands: 'checks',
+    constitution: 'governance',
+    change_request: 'governance',
+};
+/** All required subdirectories under /docs/ */
+const DOCS_SUBDIRS = [
+    'master-plan',
+    'architecture',
+    'role-plans',
+    'consensus',
+    'arbitration',
+    'audit',
+    'incidents',
+    'production',
+    'release',
+    'snapshots',
+    'checks',
+    'journal',
+    'governance',
+];
+// ─── Helper Functions ────────────────────────────────────
+function computeSha256(content) {
+    return createHash('sha256').update(content, 'utf-8').digest('hex');
+}
+function shortId() {
+    return randomUUID().split('-')[0];
+}
+function formatDate() {
+    return new Date().toISOString().split('T')[0];
+}
+function getExtension(contentType) {
+    return contentType === 'json' ? '.json' : '.md';
+}
+export class ArtifactManager {
+    projectDir;
+    docsDir;
+    constructor(options) {
+        this.projectDir = options.projectDir;
+        this.docsDir = join(options.projectDir, 'docs');
+    }
+    /** Ensure all /docs/ subdirectories exist */
+    ensureDocsStructure() {
+        if (!existsSync(this.docsDir)) {
+            mkdirSync(this.docsDir, { recursive: true });
+        }
+        for (const subdir of DOCS_SUBDIRS) {
+            const dirPath = join(this.docsDir, subdir);
+            if (!existsSync(dirPath)) {
+                mkdirSync(dirPath, { recursive: true });
+            }
+        }
+    }
+    /** Create an artifact from Markdown content */
+    createArtifactText(type, markdown, phase, groupId) {
+        return this.createArtifact(type, markdown, phase, 'markdown', groupId);
+    }
+    /** Create an artifact from a JSON-serializable object */
+    createArtifactJson(type, jsonObject, phase, groupId) {
+        const content = JSON.stringify(jsonObject, null, 2);
+        return this.createArtifact(type, content, phase, 'json', groupId);
+    }
+    /** Core artifact creation logic */
+    createArtifact(type, content, phase, contentType, groupId) {
+        this.ensureDocsStructure();
+        const resolvedGroupId = groupId ?? randomUUID();
+        const existingArtifacts = this.listArtifacts(type);
+        const version = this.getNextVersion(resolvedGroupId, existingArtifacts);
+        const previousEntry = this.getLatestInGroup(resolvedGroupId, existingArtifacts);
+        const id = randomUUID();
+        const date = formatDate();
+        const sid = shortId();
+        const ext = getExtension(contentType);
+        const filename = `${type}_${sid}_v${version}_${date}${ext}`;
+        const subdir = ARTIFACT_DIRS[type] ?? 'misc';
+        const dirPath = join(this.docsDir, subdir);
+        if (!existsSync(dirPath)) {
+            mkdirSync(dirPath, { recursive: true });
+        }
+        const filePath = join(dirPath, filename);
+        const sha256 = computeSha256(content);
+        writeFileSync(filePath, content, 'utf-8');
+        const relativePath = relative(this.projectDir, filePath);
+        const entry = {
+            id,
+            type,
+            phase,
+            version,
+            path: relativePath,
+            sha256,
+            timestamp: new Date().toISOString(),
+            immutable: true,
+            content_type: contentType,
+            group_id: resolvedGroupId,
+            previous_id: previousEntry?.id,
+        };
+        return entry;
+    }
+    /** Get the file path for a given artifact type and naming components */
+    getArtifactPath(type, sid, version, date, contentType) {
+        const ext = getExtension(contentType);
+        const subdir = ARTIFACT_DIRS[type] ?? 'misc';
+        return join(this.docsDir, subdir, `${type}_${sid}_v${version}_${date}${ext}`);
+    }
+    /** List all artifacts, optionally filtered by type */
+    listArtifacts(type) {
+        // Scan for artifact JSON metadata files in a .artifacts/ dir
+        const metaDir = join(this.docsDir, '.artifacts');
+        if (!existsSync(metaDir)) {
+            return [];
+        }
+        const entries = [];
+        const files = readdirSync(metaDir).filter((f) => f.endsWith('.json'));
+        for (const file of files) {
+            try {
+                const raw = readFileSync(join(metaDir, file), 'utf-8');
+                const parsed = JSON.parse(raw);
+                if (!type || parsed.type === type) {
+                    entries.push(parsed);
+                }
+            }
+            catch {
+                // Skip malformed metadata files
+            }
+        }
+        return entries.sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+    }
+    /** Verify an artifact's SHA-256 matches its stored content */
+    verifyArtifact(entry) {
+        const fullPath = join(this.projectDir, entry.path);
+        if (!existsSync(fullPath)) {
+            return false;
+        }
+        const content = readFileSync(fullPath, 'utf-8');
+        const currentHash = computeSha256(content);
+        return currentHash === entry.sha256;
+    }
+    /** Get the latest artifact of a given type */
+    getLatestArtifact(type) {
+        const all = this.listArtifacts(type);
+        if (all.length === 0)
+            return null;
+        return all[all.length - 1];
+    }
+    /** Get next version number for a group across existing artifacts */
+    getNextVersion(groupId, existingArtifacts) {
+        const groupArtifacts = existingArtifacts.filter((a) => a.group_id === groupId);
+        if (groupArtifacts.length === 0)
+            return 1;
+        const maxVersion = Math.max(...groupArtifacts.map((a) => a.version));
+        return maxVersion + 1;
+    }
+    /** Convert an ArtifactEntry to an ArtifactRef */
+    toArtifactRef(entry) {
+        return {
+            artifact_id: entry.id,
+            path: entry.path,
+            sha256: entry.sha256,
+            version: entry.version,
+            type: entry.type,
+        };
+    }
+    /** Store artifact metadata for later retrieval */
+    storeArtifactMetadata(entry) {
+        const metaDir = join(this.docsDir, '.artifacts');
+        if (!existsSync(metaDir)) {
+            mkdirSync(metaDir, { recursive: true });
+        }
+        const metaPath = join(metaDir, `${entry.id}.json`);
+        writeFileSync(metaPath, JSON.stringify(entry, null, 2), 'utf-8');
+    }
+    /** Create an artifact and store its metadata in one step */
+    createAndStoreText(type, markdown, phase, groupId) {
+        const entry = this.createArtifactText(type, markdown, phase, groupId);
+        this.storeArtifactMetadata(entry);
+        return entry;
+    }
+    /** Create a JSON artifact and store its metadata in one step */
+    createAndStoreJson(type, jsonObject, phase, groupId) {
+        const entry = this.createArtifactJson(type, jsonObject, phase, groupId);
+        this.storeArtifactMetadata(entry);
+        return entry;
+    }
+    /** Update /docs/INDEX.md with current artifact listing */
+    updateIndex(artifacts) {
+        this.ensureDocsStructure();
+        const lines = [
+            '# Documentation Index',
+            '',
+            `> Auto-generated by Popeye Pipeline — ${new Date().toISOString()}`,
+            '',
+            '## Artifacts',
+            '',
+            '| Type | Version | Path | Phase | Timestamp |',
+            '|------|---------|------|-------|-----------|',
+        ];
+        const sorted = [...artifacts].sort((a, b) => a.timestamp.localeCompare(b.timestamp));
+        for (const a of sorted) {
+            lines.push(`| ${a.type} | v${a.version} | ${a.path} | ${a.phase} | ${a.timestamp} |`);
+        }
+        lines.push('');
+        const indexPath = join(this.docsDir, 'INDEX.md');
+        writeFileSync(indexPath, lines.join('\n'), 'utf-8');
+    }
+    /** Get the latest artifact entry in a specific group */
+    getLatestInGroup(groupId, existingArtifacts) {
+        const groupArtifacts = existingArtifacts
+            .filter((a) => a.group_id === groupId)
+            .sort((a, b) => a.version - b.version);
+        if (groupArtifacts.length === 0)
+            return null;
+        return groupArtifacts[groupArtifacts.length - 1];
+    }
+}
+/** Factory function */
+export function createArtifactManager(projectDir) {
+    return new ArtifactManager({ projectDir });
+}
+//# sourceMappingURL=artifact-manager.js.map

package/dist/pipeline/artifact-manager.js.map

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

package/dist/pipeline/artifact-validators.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Artifact Completeness Validators — deterministic structural checks.
+ * Runs BEFORE LLM review in consensus phases to catch obvious issues.
+ * Each validator checks for required sections, minimum content length,
+ * and structural integrity specific to its artifact type.
+ */
+import type { ArtifactType } from './types.js';
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Validate artifact content completeness based on type-specific rules.
+ * Returns a ValidationResult with errors (blocking) and warnings (non-blocking).
+ *
+ * Args:
+ *   type: The artifact type to validate against.
+ *   content: The artifact content string.
+ *
+ * Returns:
+ *   ValidationResult with valid flag, errors, and warnings.
+ */
+export declare function validateArtifactCompleteness(type: ArtifactType, content: string): ValidationResult;
+/**
+ * Get all artifact types that have validators.
+ */
+export declare function getValidatableArtifactTypes(): ArtifactType[];
+//# sourceMappingURL=artifact-validators.d.ts.map

package/dist/pipeline/artifact-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-validators.d.ts","sourceRoot":"","sources":["../../src/pipeline/artifact-validators.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA2KD;;;;;;;;;;GAUG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,GACd,gBAAgB,CAgBlB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,YAAY,EAAE,CAE5D"}

package/dist/pipeline/artifact-validators.js

@@ -0,0 +1,173 @@
+/**
+ * Artifact Completeness Validators — deterministic structural checks.
+ * Runs BEFORE LLM review in consensus phases to catch obvious issues.
+ * Each validator checks for required sections, minimum content length,
+ * and structural integrity specific to its artifact type.
+ */
+// ─── Section Patterns ────────────────────────────────────
+/** Regex patterns for detecting markdown sections (case-insensitive) */
+function hasSection(content, patterns) {
+    return patterns.some((p) => p.test(content));
+}
+function findMissingSections(content, required) {
+    const missing = [];
+    for (const { name, patterns } of required) {
+        if (!hasSection(content, patterns)) {
+            missing.push(name);
+        }
+    }
+    return missing;
+}
+// ─── Per-Type Validators ─────────────────────────────────
+function validateMasterPlan(content) {
+    const errors = [];
+    const warnings = [];
+    if (content.length < 200) {
+        errors.push('Master plan is too short (min 200 characters)');
+    }
+    const missing = findMissingSections(content, [
+        { name: 'Goals/Objectives', patterns: [/#+\s*(goals?|objectives?)/i, /\bgoals?\b.*:/i] },
+        { name: 'Milestones', patterns: [/#+\s*milestones?/i, /\bmilestone\s+\d/i] },
+        { name: 'Success Criteria', patterns: [/#+\s*success\s+criteria/i, /\bsuccess\s+criteria\b/i, /#+\s*acceptance\s+criteria/i] },
+    ]);
+    for (const section of missing) {
+        errors.push(`Missing required section: ${section}`);
+    }
+    // Check for empty sections (heading followed by another heading or end)
+    const emptyHeadings = content.match(/^(#+\s+.+)\n(?=#+\s+|\s*$)/gm);
+    if (emptyHeadings && emptyHeadings.length > 2) {
+        warnings.push(`${emptyHeadings.length} potentially empty sections detected`);
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateArchitecture(content) {
+    const errors = [];
+    const warnings = [];
+    if (content.length < 200) {
+        errors.push('Architecture document is too short (min 200 characters)');
+    }
+    const missing = findMissingSections(content, [
+        { name: 'Components/Modules', patterns: [/#+\s*(components?|modules?|services?)/i, /\bcomponent\b/i] },
+        { name: 'Data Flow/Contracts', patterns: [/#+\s*(data\s+flow|contracts?|api|interfaces?)/i, /\bcontract\b/i, /\bdata\s+flow\b/i] },
+        { name: 'Tech Stack', patterns: [/#+\s*(tech\s+stack|technology|stack)/i, /\btech\s+stack\b/i] },
+    ]);
+    for (const section of missing) {
+        errors.push(`Missing required section: ${section}`);
+    }
+    // Must reference at least one file path
+    const hasFilePath = /(?:src\/|app\/|pages\/|lib\/|\.ts|\.js|\.py|\.go)/.test(content);
+    if (!hasFilePath) {
+        warnings.push('Architecture should reference at least one file path');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateRolePlan(content) {
+    const errors = [];
+    const warnings = [];
+    if (content.length < 100) {
+        errors.push('Role plan is too short (min 100 characters)');
+    }
+    const missing = findMissingSections(content, [
+        { name: 'Tasks/Responsibilities', patterns: [/#+\s*(tasks?|responsibilities?|work\s+items?)/i, /\btask\b/i] },
+        { name: 'Dependencies', patterns: [/#+\s*(dependenc|prerequisites?|requires?)/i, /\bdepend/i] },
+        { name: 'Acceptance Criteria', patterns: [/#+\s*(acceptance|done\s+when|completion)/i, /\bacceptance\b/i, /\bdone\s+when\b/i] },
+    ]);
+    for (const section of missing) {
+        errors.push(`Missing required section: ${section}`);
+    }
+    // Should reference a role name
+    const rolePatterns = /\b(DISPATCHER|ARCHITECT|DB_EXPERT|BACKEND|FRONTEND|WEBSITE|QA_TESTER|REVIEWER|AUDITOR|JOURNALIST)\b/i;
+    if (!rolePatterns.test(content)) {
+        warnings.push('Role plan should reference the role name');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateQaValidation(content) {
+    const errors = [];
+    const warnings = [];
+    const missing = findMissingSections(content, [
+        { name: 'Test Results', patterns: [/#+\s*(test\s+results?|results?)/i, /\btest\s+results?\b/i, /\bpass(?:ed|ing)?\b/i] },
+        { name: 'Coverage', patterns: [/#+\s*coverage/i, /\bcoverage\b/i, /\d+\s*%/] },
+    ]);
+    for (const section of missing) {
+        errors.push(`Missing required section: ${section}`);
+    }
+    // Should contain pass/fail counts
+    const hasPassFail = /\b\d+\s*(pass|fail|error|skip)/i.test(content);
+    if (!hasPassFail) {
+        warnings.push('QA validation should include pass/fail counts');
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+function validateAuditReport(content) {
+    const errors = [];
+    const warnings = [];
+    // Try JSON parsing
+    try {
+        const parsed = JSON.parse(content);
+        if (!Array.isArray(parsed.findings)) {
+            errors.push('Audit report must have a "findings" array');
+        }
+        if (typeof parsed.overall_status !== 'string') {
+            errors.push('Audit report must have "overall_status"');
+        }
+        if (typeof parsed.system_risk_score !== 'number') {
+            errors.push('Audit report must have "system_risk_score"');
+        }
+    }
+    catch {
+        // Not JSON — check for markdown-style audit
+        if (!content.includes('findings') && !content.includes('finding')) {
+            errors.push('Audit report must contain findings');
+        }
+        if (!content.includes('status') && !content.includes('PASS') && !content.includes('FAIL')) {
+            errors.push('Audit report must contain overall status');
+        }
+        if (!content.includes('risk') && !content.includes('score')) {
+            warnings.push('Audit report should include risk score');
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+// ─── Validator Registry ──────────────────────────────────
+const VALIDATORS = {
+    master_plan: validateMasterPlan,
+    architecture: validateArchitecture,
+    role_plan: validateRolePlan,
+    qa_validation: validateQaValidation,
+    audit_report: validateAuditReport,
+};
+// ─── Public API ──────────────────────────────────────────
+/**
+ * Validate artifact content completeness based on type-specific rules.
+ * Returns a ValidationResult with errors (blocking) and warnings (non-blocking).
+ *
+ * Args:
+ *   type: The artifact type to validate against.
+ *   content: The artifact content string.
+ *
+ * Returns:
+ *   ValidationResult with valid flag, errors, and warnings.
+ */
+export function validateArtifactCompleteness(type, content) {
+    const validator = VALIDATORS[type];
+    if (!validator) {
+        // No validator for this type — pass by default
+        return { valid: true, errors: [], warnings: [] };
+    }
+    if (!content || content.trim().length === 0) {
+        return {
+            valid: false,
+            errors: [`${type} artifact has empty content`],
+            warnings: [],
+        };
+    }
+    return validator(content);
+}
+/**
+ * Get all artifact types that have validators.
+ */
+export function getValidatableArtifactTypes() {
+    return Object.keys(VALIDATORS);
+}
+//# sourceMappingURL=artifact-validators.js.map

package/dist/pipeline/artifact-validators.js.map

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

package/dist/pipeline/bridges/review-bridge.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Review Bridge — connects /review (rich audit-mode scanner) to the pipeline
+ * artifact + CR system when a project is pipeline-managed.
+ *
+ * When pipeline state exists, /review produces pipeline-native audit_report
+ * artifacts and Change Requests instead of injecting recovery milestones
+ * into state.json. This keeps the pipeline as the single source of truth.
+ */
+import type { ProjectState } from '../../types/workflow.js';
+import type { PipelineState, ArtifactRef } from '../types.js';
+import type { AuditFinding as WorkflowAuditFinding, AuditCategory as WorkflowCategory, AuditSeverity as WorkflowSeverity } from '../../types/audit.js';
+import type { AuditFinding as PipelineAuditFinding, AuditSeverity as PipelineSeverity } from '../type-defs/audit.js';
+import type { ChangeRequest } from '../types.js';
+export interface ReviewBridgeOptions {
+    projectDir: string;
+    depth?: number;
+    strict?: boolean;
+    onProgress?: (stage: string, message: string) => void;
+}
+export interface ReviewBridgeResult {
+    success: boolean;
+    findingsCount: number;
+    changeRequestCount: number;
+    overallScore: number;
+    recommendation: string;
+    artifactsCreated: number;
+    error?: string;
+}
+/**
+ * Check if a project is pipeline-managed.
+ * A project is pipeline-managed if its state has a pipeline object
+ * with a pipelinePhase field.
+ *
+ * @param state - The project state to check
+ * @returns True if pipeline-managed
+ */
+export declare function isPipelineManaged(state: ProjectState): boolean;
+/**
+ * Extract pipeline state from project state.
+ *
+ * @param state - The project state
+ * @returns Pipeline state or undefined
+ */
+export declare function extractPipelineState(state: ProjectState): PipelineState | undefined;
+export declare function mapSeverity(severity: WorkflowSeverity): PipelineSeverity;
+/** Map workflow audit categories to pipeline audit categories */
+type PipelineCategory = 'integration' | 'config' | 'tests' | 'schema' | 'security' | 'deployment';
+export declare function mapCategory(category: WorkflowCategory): PipelineCategory;
+export declare function categoryToChangeType(category: PipelineCategory): ChangeRequest['change_type'];
+/**
+ * Convert a workflow AuditFinding to a pipeline AuditFinding.
+ *
+ * @param finding - Workflow finding
+ * @param snapshotRef - Pipeline artifact ref for the repo snapshot
+ * @returns Pipeline-native audit finding
+ */
+export declare function convertFinding(finding: WorkflowAuditFinding, snapshotRef: ArtifactRef): PipelineAuditFinding;
+/**
+ * Run /review through the pipeline bridge.
+ * Uses the rich audit-mode scanner but writes results as pipeline artifacts
+ * and creates Change Requests for blocking findings.
+ *
+ * Does NOT inject recovery milestones — the pipeline RECOVERY_LOOP handles fixes.
+ *
+ * @param options - Bridge options
+ * @returns Bridge result with counts and score
+ */
+export declare function runReviewBridge(options: ReviewBridgeOptions): Promise<ReviewBridgeResult>;
+export {};
+//# sourceMappingURL=review-bridge.d.ts.map

package/dist/pipeline/bridges/review-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-bridge.d.ts","sourceRoot":"","sources":["../../../src/pipeline/bridges/review-bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,KAAK,EACV,aAAa,EAGb,WAAW,EACZ,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,IAAI,oBAAoB,EAAE,aAAa,IAAI,gBAAgB,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACvJ,OAAO,KAAK,EAAE,YAAY,IAAI,oBAAoB,EAAE,aAAa,IAAI,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACrH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAWjD,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACvD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAG9D;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,YAAY,GAAG,aAAa,GAAG,SAAS,CAEnF;AAYD,wBAAgB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CAExE;AAID,iEAAiE;AACjE,KAAK,gBAAgB,GAAG,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,CAAC;AAalG,wBAAgB,WAAW,CAAC,QAAQ,EAAE,gBAAgB,GAAG,gBAAgB,CAExE;AAcD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,aAAa,CAAC,aAAa,CAAC,CAE7F;AAID;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,oBAAoB,EAC7B,WAAW,EAAE,WAAW,GACvB,oBAAoB,CAatB;AAID;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAkK/F"}