@cleocode/core 2026.3.76 → 2026.4.0

package/dist/orchestration/protocol-validators.js

@@ -0,0 +1,524 @@
+/**
+ * Protocol validators for all 9 CLEO protocols.
+ * Validates manifest entries and outputs against protocol requirements.
+ *
+ * @task T4499
+ * @epic T4498
+ */
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+/** All supported protocol types. */
+export const PROTOCOL_TYPES = [
+    'research',
+    'consensus',
+    'specification',
+    'decomposition',
+    'implementation',
+    'contribution',
+    'release',
+    'artifact-publish',
+    'provenance',
+];
+/** Map protocol types to exit codes. */
+export const PROTOCOL_EXIT_CODES = {
+    research: ExitCode.PROTOCOL_MISSING, // 60
+    consensus: ExitCode.INVALID_RETURN_MESSAGE, // 61
+    specification: ExitCode.MANIFEST_ENTRY_MISSING, // 62
+    decomposition: ExitCode.SPAWN_VALIDATION_FAILED, // 63
+    implementation: ExitCode.AUTONOMOUS_BOUNDARY, // 64
+    contribution: ExitCode.HANDOFF_REQUIRED, // 65
+    release: ExitCode.RESUME_FAILED, // 66
+    'artifact-publish': ExitCode.CONCURRENT_SESSION, // 67
+    provenance: ExitCode.CONCURRENT_SESSION, // 67 (shared with artifact-publish)
+};
+// ============================================================
+// Common validation helpers
+// ============================================================
+function checkRequiredField(entry, field) {
+    const value = entry[field];
+    if (value === undefined || value === null)
+        return false;
+    if (typeof value === 'string' && value.trim().length === 0)
+        return false;
+    return true;
+}
+function checkArrayMinLength(entry, field, min) {
+    const value = entry[field];
+    if (!Array.isArray(value))
+        return false;
+    return value.length >= min;
+}
+function checkAgentType(entry, expected) {
+    return entry.agent_type === expected;
+}
+// ============================================================
+// Research Protocol (RSCH-*)
+// ============================================================
+/** @task T4499 */
+export function validateResearchProtocol(entry, options = {}) {
+    const violations = [];
+    let score = 100;
+    // RSCH-001: MUST NOT implement code
+    if (options.hasCodeChanges) {
+        violations.push({
+            requirement: 'RSCH-001',
+            severity: 'error',
+            message: 'Research task modified code',
+            fix: 'Revert code changes, research is read-only',
+        });
+        score -= 30;
+    }
+    // RSCH-006: MUST include 3-7 key findings
+    const findings = entry.key_findings ?? [];
+    if (findings.length < 3 || findings.length > 7) {
+        violations.push({
+            requirement: 'RSCH-006',
+            severity: 'error',
+            message: `Key findings must be 3-7, got ${findings.length}`,
+            fix: 'Add/remove findings in manifest entry',
+        });
+        score -= 20;
+    }
+    // RSCH-007: MUST set agent_type: research
+    if (!checkAgentType(entry, 'research')) {
+        violations.push({
+            requirement: 'RSCH-007',
+            severity: 'error',
+            message: `agent_type must be research, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    // RSCH-002: SHOULD document sources (warning)
+    if (options.strict && !checkArrayMinLength(entry, 'sources', 1)) {
+        violations.push({
+            requirement: 'RSCH-002',
+            severity: 'warning',
+            message: 'Sources field missing',
+            fix: 'Add sources array to manifest',
+        });
+        score -= 10;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'research', violations, score: Math.max(0, score) };
+}
+/** @task T4499 */
+export function validateConsensusProtocol(entry, votingMatrix = { options: [] }) {
+    const violations = [];
+    let score = 100;
+    // CONS-001: MUST have voting matrix with >= 2 options
+    if (votingMatrix.options.length < 2) {
+        violations.push({
+            requirement: 'CONS-001',
+            severity: 'error',
+            message: `Voting matrix must have >= 2 options, got ${votingMatrix.options.length}`,
+            fix: 'Add more options to voting matrix',
+        });
+        score -= 25;
+    }
+    // CONS-003: MUST have confidence scores (0.0-1.0)
+    const invalidConfidence = votingMatrix.options.filter((o) => o.confidence < 0.0 || o.confidence > 1.0);
+    if (invalidConfidence.length > 0) {
+        violations.push({
+            requirement: 'CONS-003',
+            severity: 'error',
+            message: 'Confidence scores must be 0.0-1.0',
+            fix: 'Fix confidence values in voting matrix',
+        });
+        score -= 20;
+    }
+    // CONS-004: MUST meet threshold (50% by default)
+    const threshold = votingMatrix.threshold ?? 0.5;
+    const topConfidence = votingMatrix.options.length > 0
+        ? Math.max(...votingMatrix.options.map((o) => o.confidence))
+        : 0;
+    if (topConfidence < threshold) {
+        violations.push({
+            requirement: 'CONS-004',
+            severity: 'error',
+            message: `Threshold not met (${threshold * 100}% required, got ${topConfidence * 100}%)`,
+            fix: 'Increase confidence or add more supporting rationale',
+        });
+        score -= 30;
+    }
+    // CONS-007: MUST set agent_type: analysis
+    if (!checkAgentType(entry, 'analysis')) {
+        violations.push({
+            requirement: 'CONS-007',
+            severity: 'error',
+            message: `agent_type must be analysis, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'consensus', violations, score: Math.max(0, score) };
+}
+// ============================================================
+// Specification Protocol (SPEC-*)
+// ============================================================
+/** @task T4499 */
+export function validateSpecificationProtocol(entry, specContent) {
+    const violations = [];
+    let score = 100;
+    // SPEC-001: MUST contain RFC 2119 keywords
+    if (specContent) {
+        const rfc2119Keywords = [
+            'MUST',
+            'MUST NOT',
+            'SHALL',
+            'SHALL NOT',
+            'SHOULD',
+            'SHOULD NOT',
+            'MAY',
+            'REQUIRED',
+            'OPTIONAL',
+        ];
+        const hasRfc = rfc2119Keywords.some((kw) => specContent.includes(kw));
+        if (!hasRfc) {
+            violations.push({
+                requirement: 'SPEC-001',
+                severity: 'error',
+                message: 'Specification must contain RFC 2119 keywords',
+                fix: 'Add MUST, SHOULD, MAY keywords to requirements',
+            });
+            score -= 25;
+        }
+    }
+    // SPEC-002: MUST include version
+    if (!checkRequiredField(entry, 'id')) {
+        violations.push({
+            requirement: 'SPEC-002',
+            severity: 'error',
+            message: 'Specification must have an identifier',
+            fix: 'Add version/id to specification metadata',
+        });
+        score -= 15;
+    }
+    // SPEC-007: MUST set agent_type: specification
+    if (!checkAgentType(entry, 'specification')) {
+        violations.push({
+            requirement: 'SPEC-007',
+            severity: 'error',
+            message: `agent_type must be specification, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    // SPEC-003: MUST have output file
+    if (!checkRequiredField(entry, 'file')) {
+        violations.push({
+            requirement: 'SPEC-003',
+            severity: 'error',
+            message: 'Specification must produce an output file',
+            fix: 'Write specification document to file',
+        });
+        score -= 20;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'specification', violations, score: Math.max(0, score) };
+}
+// ============================================================
+// Decomposition Protocol (DCOMP-*)
+// ============================================================
+/** @task T4499 */
+export function validateDecompositionProtocol(entry, options = {}) {
+    const violations = [];
+    let score = 100;
+    // DCOMP-001: Siblings must respect hierarchy.maxSiblings policy (0 = unlimited)
+    const maxSiblings = options.maxSiblings ?? 0;
+    if (options.siblingCount !== undefined && maxSiblings > 0 && options.siblingCount > maxSiblings) {
+        violations.push({
+            requirement: 'DCOMP-001',
+            severity: 'error',
+            message: `Too many siblings: ${options.siblingCount} (max ${maxSiblings})`,
+            fix: 'Split into sub-epics or reduce task count',
+        });
+        score -= 25;
+    }
+    // DCOMP-002: Each task must have clear description
+    if (options.descriptionClarity === false) {
+        violations.push({
+            requirement: 'DCOMP-002',
+            severity: 'error',
+            message: 'Task descriptions must be clear and actionable',
+            fix: 'Rewrite descriptions with specific acceptance criteria',
+        });
+        score -= 20;
+    }
+    // DCOMP-007: MUST set agent_type: decomposition
+    if (!checkAgentType(entry, 'decomposition')) {
+        violations.push({
+            requirement: 'DCOMP-007',
+            severity: 'error',
+            message: `agent_type must be decomposition, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'decomposition', violations, score: Math.max(0, score) };
+}
+// ============================================================
+// Implementation Protocol (IMPL-*)
+// ============================================================
+/** @task T4499 */
+export function validateImplementationProtocol(entry, options = {}) {
+    const violations = [];
+    let score = 100;
+    // IMPL-001: MUST include @task tags on new functions
+    if (options.hasTaskTags === false) {
+        violations.push({
+            requirement: 'IMPL-001',
+            severity: 'error',
+            message: 'Missing @task tags on new functions',
+            fix: 'Add @task T#### tags to all new function docstrings',
+        });
+        score -= 20;
+    }
+    // IMPL-003: MUST have output file
+    if (!checkRequiredField(entry, 'file')) {
+        violations.push({
+            requirement: 'IMPL-003',
+            severity: 'error',
+            message: 'Implementation must produce an output file',
+            fix: 'Write implementation output to file',
+        });
+        score -= 20;
+    }
+    // IMPL-007: MUST set agent_type: implementation
+    if (!checkAgentType(entry, 'implementation')) {
+        violations.push({
+            requirement: 'IMPL-007',
+            severity: 'error',
+            message: `agent_type must be implementation, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    // IMPL-004: MUST have linked tasks
+    if (!checkArrayMinLength(entry, 'linked_tasks', 1)) {
+        violations.push({
+            requirement: 'IMPL-004',
+            severity: 'error',
+            message: 'Implementation must link to at least one task',
+            fix: 'Add linked_tasks array with task IDs',
+        });
+        score -= 15;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'implementation', violations, score: Math.max(0, score) };
+}
+// ============================================================
+// Contribution Protocol (CONT-*)
+// ============================================================
+/** @task T4499 */
+export function validateContributionProtocol(entry, options = {}) {
+    const violations = [];
+    let score = 100;
+    // CONT-001: MUST include @contribution tags
+    if (options.hasContributionTags === false) {
+        violations.push({
+            requirement: 'CONT-001',
+            severity: 'error',
+            message: 'Missing @task/@contribution tags',
+            fix: 'Add @contribution tags to contributed code',
+        });
+        score -= 20;
+    }
+    // CONT-007: MUST set agent_type: contribution
+    if (!checkAgentType(entry, 'contribution')) {
+        violations.push({
+            requirement: 'CONT-007',
+            severity: 'error',
+            message: `agent_type must be contribution, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    // CONT-003: MUST have linked tasks
+    if (!checkArrayMinLength(entry, 'linked_tasks', 1)) {
+        violations.push({
+            requirement: 'CONT-003',
+            severity: 'error',
+            message: 'Contribution must link to at least one task',
+            fix: 'Add linked_tasks array with task IDs',
+        });
+        score -= 15;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'contribution', violations, score: Math.max(0, score) };
+}
+// ============================================================
+// Release Protocol (REL-*)
+// ============================================================
+/** @task T4499 */
+export function validateReleaseProtocol(entry, options = {}) {
+    const violations = [];
+    let score = 100;
+    // REL-001: MUST have valid version format (X.Y.Z or YYYY.M.patch)
+    if (options.version) {
+        if (!/^\d+\.\d+\.\d+(-[a-zA-Z0-9.]+)?(\+[a-zA-Z0-9.]+)?$/.test(options.version)) {
+            violations.push({
+                requirement: 'REL-001',
+                severity: 'error',
+                message: `Invalid version format: ${options.version}`,
+                fix: 'Use valid version format: X.Y.Z or YYYY.M.patch (CalVer)',
+            });
+            score -= 30;
+        }
+    }
+    // REL-002: MUST have changelog
+    if (options.hasChangelog === false) {
+        violations.push({
+            requirement: 'REL-002',
+            severity: 'error',
+            message: 'Release must include changelog',
+            fix: 'Generate changelog before shipping',
+        });
+        score -= 20;
+    }
+    // REL-007: MUST set agent_type: release
+    if (!checkAgentType(entry, 'release')) {
+        violations.push({
+            requirement: 'REL-007',
+            severity: 'error',
+            message: `agent_type must be release, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'release', violations, score: Math.max(0, score) };
+}
+// ============================================================
+// Artifact Publish Protocol (ARTF-*)
+// ============================================================
+/** @task T4499 */
+export function validateArtifactPublishProtocol(entry, options = {}) {
+    const violations = [];
+    let score = 100;
+    // ARTF-001: MUST specify artifact type
+    if (!options.artifactType) {
+        violations.push({
+            requirement: 'ARTF-001',
+            severity: 'error',
+            message: 'Artifact type must be specified',
+            fix: 'Set artifact type (npm, docker, binary, etc.)',
+        });
+        score -= 25;
+    }
+    // ARTF-002: Build MUST pass
+    if (options.buildPassed === false) {
+        violations.push({
+            requirement: 'ARTF-002',
+            severity: 'error',
+            message: 'Build must pass before publishing',
+            fix: 'Fix build errors and retry',
+        });
+        score -= 30;
+    }
+    // ARTF-007: MUST set agent_type: artifact-publish
+    if (!checkAgentType(entry, 'artifact-publish')) {
+        violations.push({
+            requirement: 'ARTF-007',
+            severity: 'error',
+            message: `agent_type must be artifact-publish, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'artifact-publish', violations, score: Math.max(0, score) };
+}
+// ============================================================
+// Provenance Protocol (PROV-*)
+// ============================================================
+/** @task T4499 */
+export function validateProvenanceProtocol(entry, options = {}) {
+    const violations = [];
+    let score = 100;
+    // PROV-001: MUST have attestation
+    if (options.hasAttestation === false) {
+        violations.push({
+            requirement: 'PROV-001',
+            severity: 'error',
+            message: 'Provenance attestation is required',
+            fix: 'Generate SLSA provenance attestation',
+        });
+        score -= 30;
+    }
+    // PROV-002: SHOULD have SBOM
+    if (options.hasSbom === false) {
+        violations.push({
+            requirement: 'PROV-002',
+            severity: 'warning',
+            message: 'SBOM is recommended for provenance',
+            fix: 'Generate Software Bill of Materials',
+        });
+        score -= 10;
+    }
+    // PROV-007: MUST set agent_type: provenance
+    if (!checkAgentType(entry, 'provenance')) {
+        violations.push({
+            requirement: 'PROV-007',
+            severity: 'error',
+            message: `agent_type must be provenance, got ${entry.agent_type ?? 'undefined'}`,
+            fix: 'Update manifest entry agent_type field',
+        });
+        score -= 15;
+    }
+    const hasErrors = violations.some((v) => v.severity === 'error');
+    return { valid: !hasErrors, protocol: 'provenance', violations, score: Math.max(0, score) };
+}
+// ============================================================
+// Unified Dispatcher
+// ============================================================
+/**
+ * Validate a manifest entry against a specific protocol.
+ * Throws CleoError with appropriate exit code on strict failure.
+ * @task T4499
+ */
+export function validateProtocol(protocol, entry, options = {}, strict = false) {
+    let result;
+    switch (protocol) {
+        case 'research':
+            result = validateResearchProtocol(entry, options);
+            break;
+        case 'consensus':
+            result = validateConsensusProtocol(entry, options.votingMatrix);
+            break;
+        case 'specification':
+            result = validateSpecificationProtocol(entry, options.specContent);
+            break;
+        case 'decomposition':
+            result = validateDecompositionProtocol(entry, options);
+            break;
+        case 'implementation':
+            result = validateImplementationProtocol(entry, options);
+            break;
+        case 'contribution':
+            result = validateContributionProtocol(entry, options);
+            break;
+        case 'release':
+            result = validateReleaseProtocol(entry, options);
+            break;
+        case 'artifact-publish':
+            result = validateArtifactPublishProtocol(entry, options);
+            break;
+        case 'provenance':
+            result = validateProvenanceProtocol(entry, options);
+            break;
+        default:
+            throw new CleoError(ExitCode.CONCURRENT_SESSION, `Unknown protocol: ${protocol}`);
+    }
+    if (!result.valid && strict) {
+        const exitCode = PROTOCOL_EXIT_CODES[protocol];
+        throw new CleoError(exitCode, `Protocol validation failed for ${protocol}: ${result.violations
+            .filter((v) => v.severity === 'error')
+            .map((v) => v.message)
+            .join('; ')}`);
+    }
+    return result;
+}
+//# sourceMappingURL=protocol-validators.js.map

package/dist/orchestration/protocol-validators.js.map

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

package/dist/orchestration/skill-ops.js

@@ -0,0 +1,98 @@
+/**
+ * Skill listing and injection operations.
+ * @task T4784
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { getCanonicalSkillsDir } from '@cleocode/caamp';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError } from '../errors.js';
+/** List available skills from canonical and project-local directories. */
+export function listSkills(projectRoot) {
+    const seen = new Set();
+    const allSkills = [];
+    // Scan a skills directory and collect entries
+    function scanSkillsDir(dir) {
+        if (!existsSync(dir))
+            return;
+        try {
+            const entries = readdirSync(dir, { withFileTypes: true });
+            for (const d of entries) {
+                if (!d.isDirectory() || d.name.startsWith('_') || seen.has(d.name))
+                    continue;
+                seen.add(d.name);
+                const skillPath = join(dir, d.name, 'SKILL.md');
+                let description = '';
+                if (existsSync(skillPath)) {
+                    try {
+                        const content = readFileSync(skillPath, 'utf-8');
+                        const descMatch = content.match(/description:\s*[|>]?\s*\n?\s*(.+)/);
+                        if (descMatch) {
+                            description = descMatch[1].trim();
+                        }
+                    }
+                    catch {
+                        // ignore
+                    }
+                }
+                allSkills.push({
+                    name: d.name,
+                    path: join(dir, d.name),
+                    hasSkillFile: existsSync(skillPath),
+                    description,
+                });
+            }
+        }
+        catch {
+            // ignore unreadable directories
+        }
+    }
+    // 1. Scan project-local skills (higher priority, listed first)
+    scanSkillsDir(join(projectRoot, '.cleo', 'skills'));
+    // 2. Scan canonical (global) skills
+    scanSkillsDir(getCanonicalSkillsDir());
+    return { skills: allSkills, total: allSkills.length };
+}
+/** Read skill content for injection into agent context. Checks project-local skills first. */
+export function getSkillContent(skillName, projectRoot) {
+    if (!skillName) {
+        throw new CleoError(ExitCode.INVALID_INPUT, 'skill name is required');
+    }
+    // Check project-local skills first, then canonical
+    const projectSkillDir = join(projectRoot, '.cleo', 'skills', skillName);
+    const canonicalSkillDir = join(getCanonicalSkillsDir(), skillName);
+    const skillDir = existsSync(projectSkillDir) ? projectSkillDir : canonicalSkillDir;
+    if (!existsSync(skillDir)) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Skill '${skillName}' not found at ${canonicalSkillDir} or ${projectSkillDir}`);
+    }
+    const skillFilePath = join(skillDir, 'SKILL.md');
+    if (!existsSync(skillFilePath)) {
+        throw new CleoError(ExitCode.NOT_FOUND, `Skill file not found: ${skillFilePath}`);
+    }
+    const content = readFileSync(skillFilePath, 'utf-8');
+    // Check for reference files
+    const refsDir = join(skillDir, 'references');
+    let references = [];
+    if (existsSync(refsDir)) {
+        try {
+            references = readdirSync(refsDir)
+                .filter((f) => f.endsWith('.md') || f.endsWith('.txt'))
+                .map((f) => ({
+                name: f,
+                path: join(skillDir, 'references', f),
+            }));
+        }
+        catch {
+            // ignore
+        }
+    }
+    return {
+        skill: skillName,
+        content,
+        contentLength: content.length,
+        estimatedTokens: Math.ceil(content.length / 4),
+        references,
+        path: skillFilePath,
+    };
+}
+//# sourceMappingURL=skill-ops.js.map

package/dist/orchestration/skill-ops.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-ops.js","sourceRoot":"","sources":["../../src/orchestration/skill-ops.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAChE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAkBzC,0EAA0E;AAC1E,MAAM,UAAU,UAAU,CAAC,WAAmB;IAC5C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,SAAS,GAAiB,EAAE,CAAC;IAEnC,8CAA8C;IAC9C,SAAS,aAAa,CAAC,GAAW;QAChC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO;QAC7B,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;gBACxB,IAAI,CAAC,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC7E,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBAEjB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAChD,IAAI,WAAW,GAAG,EAAE,CAAC;gBAErB,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;oBAC1B,IAAI,CAAC;wBACH,MAAM,OAAO,GAAG,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;wBACjD,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;wBACrE,IAAI,SAAS,EAAE,CAAC;4BACd,WAAW,GAAG,SAAS,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;wBACrC,CAAC;oBACH,CAAC;oBAAC,MAAM,CAAC;wBACP,SAAS;oBACX,CAAC;gBACH,CAAC;gBAED,SAAS,CAAC,IAAI,CAAC;oBACb,IAAI,EAAE,CAAC,CAAC,IAAI;oBACZ,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC;oBACvB,YAAY,EAAE,UAAU,CAAC,SAAS,CAAC;oBACnC,WAAW;iBACZ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IAED,+DAA+D;IAC/D,aAAa,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAEpD,oCAAoC;IACpC,aAAa,CAAC,qBAAqB,EAAE,CAAC,CAAC;IAEvC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;AACxD,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,eAAe,CAAC,SAAiB,EAAE,WAAmB;IACpE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAC;IACxE,CAAC;IAED,mDAAmD;IACnD,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACxE,MAAM,iBAAiB,GAAG,IAAI,CAAC,qBAAqB,EAAE,EAAE,SAAS,CAAC,CAAC;IACnE,MAAM,QAAQ,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,iBAAiB,CAAC;IAEnF,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CACjB,QAAQ,CAAC,SAAS,EAClB,UAAU,SAAS,kBAAkB,iBAAiB,OAAO,eAAe,EAAE,CAC/E,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACjD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,yBAAyB,aAAa,EAAE,CAAC,CAAC;IACpF,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAErD,4BAA4B;IAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAC7C,IAAI,UAAU,GAA0C,EAAE,CAAC;IAC3D,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,UAAU,GAAG,WAAW,CAAC,OAAO,CAAC;iBAC9B,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;iBACtD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;gBACX,IAAI,EAAE,CAAC;gBACP,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;aACtC,CAAC,CAAC,CAAC;QACR,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,SAAS;QAChB,OAAO;QACP,aAAa,EAAE,OAAO,CAAC,MAAM;QAC7B,eAAe,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;QAC9C,UAAU;QACV,IAAI,EAAE,aAAa;KACpB,CAAC;AACJ,CAAC"}