claude-skills-cli 0.0.1

package/dist/commands/validate.js

@@ -0,0 +1,48 @@
+import { basename } from 'path';
+import { SkillValidator } from '../core/validator.js';
+import { info, error, success } from '../utils/output.js';
+export function validate_command(options) {
+    const { skill_path, strict } = options;
+    const skill_name = basename(skill_path);
+    info(`Validating skill: ${skill_name}`);
+    console.log('='.repeat(60));
+    const validator = new SkillValidator(skill_path);
+    const result = validator.validate_all();
+    // Print errors
+    if (result.errors.length > 0) {
+        console.log('\n❌ Errors:');
+        for (const err of result.errors) {
+            console.log(`  ${err}`);
+        }
+    }
+    // Print warnings
+    if (result.warnings.length > 0) {
+        console.log('\n⚠️  Warnings:');
+        for (const warn of result.warnings) {
+            console.log(`  ${warn}`);
+        }
+    }
+    // Print final status
+    if (!result.errors.length && !result.warnings.length) {
+        console.log('');
+        success('Skill is valid!');
+    }
+    else if (!result.errors.length) {
+        console.log('');
+        success('Skill is valid (with warnings)');
+    }
+    else {
+        console.log('');
+        error(`Skill validation failed with ${result.errors.length} error(s)`);
+    }
+    // Handle exit codes
+    if (!result.is_valid) {
+        process.exit(1);
+    }
+    if (strict && result.warnings.length > 0) {
+        console.log('\n❌ Failed in strict mode due to warnings');
+        process.exit(1);
+    }
+    process.exit(0);
+}
+//# sourceMappingURL=validate.js.map

package/dist/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/commands/validate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAW,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAEnE,MAAM,UAAU,gBAAgB,CAAC,OAAwB;IACvD,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;IACvC,MAAM,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAExC,IAAI,CAAC,qBAAqB,UAAU,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAG,IAAI,cAAc,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,YAAY,EAAE,CAAC;IAExC,eAAe;IACf,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,iBAAiB;IACjB,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/B,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YACnC,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAC7B,CAAC;SAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,gCAAgC,CAAC,CAAC;IAC5C,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,KAAK,CAAC,gCAAgC,MAAM,CAAC,MAAM,CAAC,MAAM,WAAW,CAAC,CAAC;IACzE,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,2CAA2C,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC"}

package/dist/core/templates.js

@@ -0,0 +1,90 @@
+export const SKILL_MD_TEMPLATE = (name, description, title) => `---
+name: ${name}
+description: ${description}
+---
+
+# ${title}
+
+## Overview
+
+[Provide a brief overview of what this skill does and when to use it]
+
+## Quick Start
+
+\`\`\`typescript
+// Example code showing basic usage
+\`\`\`
+
+## Core Patterns
+
+### Pattern 1: [Name]
+
+[Describe the pattern]
+
+\`\`\`typescript
+// Code example
+\`\`\`
+
+### Pattern 2: [Name]
+
+[Describe the pattern]
+
+\`\`\`typescript
+// Code example
+\`\`\`
+
+## Advanced Usage
+
+For detailed information, see:
+- [references/detailed-guide.md](references/detailed-guide.md)
+- [references/examples.md](references/examples.md)
+
+## Scripts
+
+- \`scripts/example.py\`: Description of what this script does
+
+## Notes
+
+- Important note 1
+- Important note 2
+`;
+export const REFERENCE_TEMPLATE = (title) => `# ${title} Reference
+
+## Section 1
+
+Content here...
+
+## Section 2
+
+Content here...
+`;
+export const SCRIPT_TEMPLATE = (filename) => `#!/usr/bin/env python3
+"""
+Description of what this script does.
+
+Usage:
+    python ${filename}
+"""
+
+def main():
+    print("Script executed successfully")
+
+if __name__ == "__main__":
+    main()
+`;
+export const README_TEMPLATE = (title, description) => `# ${title}
+
+${description}
+
+## Structure
+
+- \`SKILL.md\` - Main skill instructions
+- \`references/\` - Detailed documentation loaded as needed
+- \`scripts/\` - Executable code for deterministic operations
+- \`assets/\` - Templates, images, or other resources
+
+## Usage
+
+This skill is automatically discovered by Claude when relevant to the task.
+`;
+//# sourceMappingURL=templates.js.map

package/dist/core/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/core/templates.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAY,EACZ,WAAmB,EACnB,KAAa,EACb,EAAE,CAAC;QACG,IAAI;eACG,WAAW;;;IAGtB,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CR,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,KAAK,KAAK;;;;;;;;;CAS9D,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,QAAgB,EAAE,EAAE,CAAC;;;;;aAKxC,QAAQ;;;;;;;;CAQpB,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,KAAa,EACb,WAAmB,EACnB,EAAE,CAAC,KAAK,KAAK;;EAEb,WAAW;;;;;;;;;;;;CAYZ,CAAC"}

package/dist/core/validator.js

@@ -0,0 +1,185 @@
+import { readFileSync, existsSync, statSync, readdirSync } from 'fs';
+import { join } from 'path';
+export class SkillValidator {
+    skill_path;
+    errors = [];
+    warnings = [];
+    constructor(skill_path) {
+        this.skill_path = skill_path;
+    }
+    error(msg) {
+        this.errors.push(`❌ ${msg}`);
+    }
+    warning(msg) {
+        this.warnings.push(`⚠️  ${msg}`);
+    }
+    validate_directory() {
+        if (!existsSync(this.skill_path)) {
+            this.error(`Skill directory does not exist: ${this.skill_path}`);
+            return false;
+        }
+        const stats = statSync(this.skill_path);
+        if (!stats.isDirectory()) {
+            this.error(`Path is not a directory: ${this.skill_path}`);
+            return false;
+        }
+        return true;
+    }
+    validate_skill_md() {
+        const skill_md_path = join(this.skill_path, 'SKILL.md');
+        if (!existsSync(skill_md_path)) {
+            this.error('SKILL.md file not found');
+            return false;
+        }
+        const content = readFileSync(skill_md_path, 'utf-8');
+        // Check for YAML frontmatter
+        if (!content.startsWith('---\n')) {
+            this.error('SKILL.md must start with YAML frontmatter (---)');
+            return false;
+        }
+        // Extract frontmatter
+        const parts = content.split('---\n');
+        if (parts.length < 3) {
+            this.error('SKILL.md has malformed YAML frontmatter');
+            return false;
+        }
+        const frontmatter = parts[1];
+        const body = parts.slice(2).join('---\n');
+        // Validate required fields
+        if (!frontmatter.includes('name:')) {
+            this.error("SKILL.md frontmatter missing 'name' field");
+            return false;
+        }
+        if (!frontmatter.includes('description:')) {
+            this.error("SKILL.md frontmatter missing 'description' field");
+            return false;
+        }
+        // Extract name
+        const name_match = frontmatter.match(/name:\s*(.+)/);
+        if (name_match) {
+            const name = name_match[1].trim();
+            // Validate name format
+            if (!/^[a-z0-9-]+$/.test(name)) {
+                this.error(`Skill name must be lowercase kebab-case: '${name}'`);
+            }
+            // Check name matches directory
+            const dir_name = this.skill_path.split('/').pop() || '';
+            if (name !== dir_name) {
+                this.warning(`Skill name '${name}' doesn't match directory name '${dir_name}'`);
+            }
+            // Check name length
+            if (name.length > 64) {
+                this.error(`Skill name too long (max 64 chars): ${name.length}`);
+            }
+        }
+        // Extract description
+        const desc_match = frontmatter.match(/description:\s*(.+?)(?=\n[a-z]+:|$)/s);
+        if (desc_match) {
+            const description = desc_match[1].trim();
+            // Check description length
+            if (description.length > 1024) {
+                this.error(`Description too long (max 1024 chars): ${description.length}`);
+            }
+            if (description.length < 20) {
+                this.warning('Description is very short (consider adding more detail)');
+            }
+            // Check for "when to use" guidance
+            const lower_desc = description.toLowerCase();
+            if (!lower_desc.includes('when') && !lower_desc.includes('use')) {
+                this.warning("Consider adding 'when to use' guidance to description");
+            }
+        }
+        // Check body content
+        if (body.trim().length < 100) {
+            this.warning('SKILL.md body is very short');
+        }
+        // Check for TODO placeholders
+        if (body.includes('TODO') ||
+            body.includes('[Add your') ||
+            body.includes('[Provide')) {
+            this.warning('SKILL.md contains TODO placeholders');
+        }
+        return true;
+    }
+    validate_references() {
+        const references_dir = join(this.skill_path, 'references');
+        if (existsSync(references_dir)) {
+            const files = readdirSync(references_dir);
+            const md_files = files.filter((f) => f.endsWith('.md'));
+            if (md_files.length === 0) {
+                this.warning('references/ directory exists but is empty');
+            }
+            // Check for references in SKILL.md
+            const skill_md_path = join(this.skill_path, 'SKILL.md');
+            if (existsSync(skill_md_path)) {
+                const skill_content = readFileSync(skill_md_path, 'utf-8');
+                for (const md_file of md_files) {
+                    if (!skill_content.includes(md_file)) {
+                        this.warning(`Reference file '${md_file}' not mentioned in SKILL.md`);
+                    }
+                }
+            }
+        }
+        return true;
+    }
+    validate_scripts() {
+        const scripts_dir = join(this.skill_path, 'scripts');
+        if (existsSync(scripts_dir)) {
+            const files = readdirSync(scripts_dir);
+            const script_files = files.filter((f) => f.endsWith('.py') || f.endsWith('.sh'));
+            if (script_files.length === 0) {
+                this.warning('scripts/ directory exists but is empty');
+            }
+            for (const script_file of script_files) {
+                const script_path = join(scripts_dir, script_file);
+                const stats = statSync(script_path);
+                // Check if executable (0o111 = --x--x--x)
+                if ((stats.mode & 0o111) === 0) {
+                    this.warning(`Script is not executable: ${script_file}`);
+                }
+                // Check for shebang
+                const content = readFileSync(script_path, 'utf-8');
+                const first_line = content.split('\n')[0];
+                if (!first_line.startsWith('#!')) {
+                    this.warning(`Script missing shebang: ${script_file}`);
+                }
+            }
+        }
+        return true;
+    }
+    validate_assets() {
+        const assets_dir = join(this.skill_path, 'assets');
+        if (existsSync(assets_dir)) {
+            const files = readdirSync(assets_dir);
+            if (files.length === 0) {
+                this.warning('assets/ directory exists but is empty');
+            }
+        }
+        return true;
+    }
+    validate_all() {
+        if (!this.validate_directory()) {
+            return {
+                errors: this.errors,
+                warnings: this.warnings,
+                is_valid: false,
+            };
+        }
+        this.validate_skill_md();
+        this.validate_references();
+        this.validate_scripts();
+        this.validate_assets();
+        return {
+            errors: this.errors,
+            warnings: this.warnings,
+            is_valid: this.errors.length === 0,
+        };
+    }
+    get_errors() {
+        return this.errors;
+    }
+    get_warnings() {
+        return this.warnings;
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/core/validator.js.map

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

package/dist/index.js

@@ -0,0 +1,115 @@
+#!/usr/bin/env node
+import { init_command } from './commands/init.js';
+import { validate_command } from './commands/validate.js';
+import { package_command } from './commands/package.js';
+const args = process.argv.slice(2);
+const command = args[0];
+function show_help() {
+    console.log('claude-skills - CLI toolkit for creating Claude Agent Skills\n');
+    console.log('Usage:');
+    console.log('  claude-skills <command> [options]\n');
+    console.log('Commands:');
+    console.log('  init        Create a new skill');
+    console.log('  validate    Validate a skill');
+    console.log('  package     Package a skill to zip\n');
+    console.log('Options:');
+    console.log('  --help, -h     Show help');
+    console.log('  --version, -v  Show version\n');
+    console.log('Examples:');
+    console.log('  claude-skills init --name my-skill --description "Description"');
+    console.log('  claude-skills validate .claude/skills/my-skill');
+    console.log('  claude-skills package .claude/skills/my-skill');
+}
+function parse_args(args) {
+    const parsed = {};
+    const positional = [];
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const key = arg.substring(2);
+            const next = args[i + 1];
+            if (next && !next.startsWith('--')) {
+                parsed[key] = next;
+                i++;
+            }
+            else {
+                parsed[key] = true;
+            }
+        }
+        else if (arg.startsWith('-') && arg.length === 2) {
+            const key = arg.substring(1);
+            const next = args[i + 1];
+            if (next && !next.startsWith('-')) {
+                parsed[key] = next;
+                i++;
+            }
+            else {
+                parsed[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    if (positional.length > 0) {
+        parsed._positional = positional.join(' ');
+    }
+    return parsed;
+}
+async function main() {
+    if (!command || command === '--help' || command === '-h') {
+        show_help();
+        process.exit(0);
+    }
+    if (command === '--version' || command === '-v') {
+        console.log('claude-skills v0.0.1');
+        process.exit(0);
+    }
+    const parsed = parse_args(args.slice(1));
+    switch (command) {
+        case 'init':
+            init_command({
+                name: parsed.name,
+                description: parsed.description,
+                path: parsed.path,
+            });
+            break;
+        case 'validate': {
+            const skill_path = parsed._positional;
+            if (!skill_path) {
+                console.error('Error: skill path required');
+                console.log('\nUsage: claude-skills validate <skill_path>');
+                process.exit(1);
+            }
+            validate_command({
+                skill_path,
+                strict: parsed.strict === true,
+            });
+            break;
+        }
+        case 'package': {
+            const skill_path = parsed._positional;
+            if (!skill_path) {
+                console.error('Error: skill path required');
+                console.log('\nUsage: claude-skills package <skill_path>');
+                process.exit(1);
+            }
+            await package_command({
+                skill_path,
+                output: parsed.output,
+                skip_validation: parsed['skip-validation'] === true,
+            });
+            break;
+        }
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.log('');
+            show_help();
+            process.exit(1);
+    }
+}
+main().catch((err) => {
+    console.error('Error:', err.message);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/utils/fs.js

@@ -0,0 +1,25 @@
+import { mkdirSync, writeFileSync, chmodSync } from 'fs';
+import { dirname } from 'path';
+export function ensure_dir(path) {
+    mkdirSync(path, { recursive: true });
+}
+export function write_file(path, content) {
+    ensure_dir(dirname(path));
+    writeFileSync(path, content, 'utf-8');
+}
+export function make_executable(path) {
+    chmodSync(path, 0o755);
+}
+export function to_title_case(kebab_case) {
+    return kebab_case
+        .split('-')
+        .map((word) => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+export function is_kebab_case(str) {
+    return /^[a-z0-9-]+$/.test(str);
+}
+export function is_lowercase(str) {
+    return str === str.toLowerCase();
+}
+//# sourceMappingURL=fs.js.map

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,IAAI,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAE/B,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe;IACtD,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1B,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,OAAO,UAAU;SACd,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACvC,OAAO,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,KAAK,GAAG,CAAC,WAAW,EAAE,CAAC;AACnC,CAAC"}

package/dist/utils/output.js

@@ -0,0 +1,9 @@
+export const success = (msg) => console.log(`✅ ${msg}`);
+export const error = (msg) => console.log(`❌ ${msg}`);
+export const warning = (msg) => console.log(`⚠️  ${msg}`);
+export const info = (msg) => console.log(`📋 ${msg}`);
+export const step = (msg) => console.log(`  ${msg}`);
+export const package_ = (msg) => console.log(`📦 ${msg}`);
+export const upload = (msg) => console.log(`📤 ${msg}`);
+export const search = (msg) => console.log(`🔍 ${msg}`);
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAClE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;AAChE,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC"}