@airmcp-dev/cli 0.1.0

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.
+
+   Copyright 2026 CodePedia Labs (labs@codepedia.kr)

package/dist/commands/add.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const addCommand: Command;
+//# sourceMappingURL=add.d.ts.map

package/dist/commands/add.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"add.d.ts","sourceRoot":"","sources":["../../src/commands/add.ts"],"names":[],"mappings":"AAcA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAuKpC,eAAO,MAAM,UAAU,SAyCnB,CAAC"}

package/dist/commands/add.js

@@ -0,0 +1,192 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — commands/add.ts
+//
+// air add <type> <name>
+//
+// 현재 프로젝트의 src/index.ts에 도구/리소스/프롬프트 scaffold를 추가한다.
+// VS Code 스니펫과 달리 에디터에 종속되지 않는다.
+//
+// @example
+//   air add tool search
+//   air add tool search --params "query:string,limit:number"
+//   air add resource config
+//   air add prompt summarize
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { readFile, writeFile } from 'node:fs/promises';
+import { printer } from '../utils/printer.js';
+/** 도구 scaffold 생성 */
+function toolScaffold(name, paramsStr) {
+    let paramsBlock = `      // TODO: 파라미터를 정의하세요\n      input: { type: 'string', description: '입력값' },`;
+    let destructure = 'input';
+    if (paramsStr) {
+        const pairs = paramsStr.split(',').map((p) => p.trim());
+        const lines = [];
+        const names = [];
+        for (const pair of pairs) {
+            const [pName, pType = 'string'] = pair.split(':').map((s) => s.trim());
+            lines.push(`      ${pName}: { type: '${pType}', description: '${pName}' },`);
+            names.push(pName);
+        }
+        paramsBlock = lines.join('\n');
+        destructure = names.join(', ');
+    }
+    return `
+    defineTool('${name}', {
+      description: '${name} 도구',
+      params: {
+${paramsBlock}
+      },
+      handler: async ({ ${destructure} }) => {
+        // TODO: 구현하세요
+        return \`${name} 결과: \${${destructure.split(',')[0].trim()}}\`;
+      },
+    }),`;
+}
+/** 리소스 scaffold 생성 */
+function resourceScaffold(name) {
+    return `
+    defineResource({
+      name: '${name}',
+      uri: 'file:///${name}',
+      description: '${name} 리소스',
+      handler: async (uri, ctx) => {
+        // TODO: 구현하세요
+        return '${name} 데이터';
+      },
+    }),`;
+}
+/** 프롬프트 scaffold 생성 */
+function promptScaffold(name) {
+    return `
+    definePrompt({
+      name: '${name}',
+      description: '${name} 프롬프트',
+      args: [
+        { name: 'input', description: '입력 텍스트' },
+      ],
+      handler: async ({ input }) => [
+        { role: 'user', content: \`\${input}\` },
+      ],
+    }),`;
+}
+/** src/index.ts에서 tools/resources/prompts 배열 끝에 삽입 */
+async function insertIntoSource(cwd, type, scaffold) {
+    const srcPath = resolve(cwd, 'src/index.ts');
+    let src;
+    try {
+        src = await readFile(srcPath, 'utf-8');
+    }
+    catch {
+        printer.error('src/index.ts not found. Run this command in an air project directory.');
+        return false;
+    }
+    // 삽입 위치: tools: [...], resources: [...], prompts: [...]
+    const sectionMap = {
+        tool: 'tools',
+        resource: 'resources',
+        prompt: 'prompts',
+    };
+    const section = sectionMap[type];
+    // import 추가 (필요한 경우)
+    const importMap = {
+        tool: 'defineTool',
+        resource: 'defineResource',
+        prompt: 'definePrompt',
+    };
+    const importName = importMap[type];
+    if (!src.includes(importName)) {
+        // 기존 import에 추가
+        src = src.replace(/import\s*{([^}]+)}\s*from\s*'@air\/core'/, (match, imports) => {
+            const existing = imports.trim();
+            return `import { ${existing}, ${importName} } from '@airmcp-dev/core'`;
+        });
+    }
+    // 섹션이 있으면 마지막 요소 뒤에 삽입
+    const sectionRegex = new RegExp(`${section}:\\s*\\[`);
+    if (sectionRegex.test(src)) {
+        // 마지막 ],  앞에 삽입
+        // 해당 배열의 마지막 닫는 ] 를 찾아서 그 앞에 삽입
+        const idx = src.indexOf(`${section}: [`);
+        if (idx === -1) {
+            printer.error(`Could not find "${section}: [" in src/index.ts.`);
+            return false;
+        }
+        // 배열 끝 찾기 — 간단하게 마지막 ], 앞에 삽입
+        let bracketCount = 0;
+        let insertPos = -1;
+        for (let i = idx + section.length + 3; i < src.length; i++) {
+            if (src[i] === '[')
+                bracketCount++;
+            if (src[i] === ']') {
+                if (bracketCount === 0) {
+                    insertPos = i;
+                    break;
+                }
+                bracketCount--;
+            }
+        }
+        if (insertPos === -1) {
+            printer.error(`Could not find closing bracket for "${section}" array.`);
+            return false;
+        }
+        src = src.slice(0, insertPos) + scaffold + '\n  ' + src.slice(insertPos);
+    }
+    else {
+        // 섹션이 없으면 tools 뒤에 새 섹션 추가
+        const toolsEnd = src.indexOf('tools: [');
+        if (toolsEnd === -1) {
+            printer.error('Could not find "tools: [" in src/index.ts. Is this an air project?');
+            return false;
+        }
+        // defineServer 닫는 }) 앞에 새 섹션 추가
+        const closingIdx = src.lastIndexOf('});');
+        if (closingIdx === -1) {
+            printer.error('Could not find defineServer closing bracket.');
+            return false;
+        }
+        const newSection = `\n  ${section}: [${scaffold}\n  ],\n`;
+        src = src.slice(0, closingIdx) + newSection + src.slice(closingIdx);
+    }
+    await writeFile(srcPath, src, 'utf-8');
+    return true;
+}
+export const addCommand = new Command('add')
+    .description('Add a tool, resource, or prompt scaffold to the project')
+    .argument('<type>', 'What to add: tool | resource | prompt')
+    .argument('<name>', 'Name of the tool/resource/prompt')
+    .option('--params <params>', 'Parameters for tool (e.g. "query:string,limit:number")')
+    .action(async (type, name, opts) => {
+    const validTypes = ['tool', 'resource', 'prompt'];
+    if (!validTypes.includes(type)) {
+        printer.error(`Invalid type "${type}". Use: ${validTypes.join(', ')}`);
+        process.exit(1);
+    }
+    const cwd = process.cwd();
+    let scaffold;
+    switch (type) {
+        case 'tool':
+            scaffold = toolScaffold(name, opts.params);
+            break;
+        case 'resource':
+            scaffold = resourceScaffold(name);
+            break;
+        case 'prompt':
+            scaffold = promptScaffold(name);
+            break;
+        default:
+            process.exit(1);
+    }
+    printer.blank();
+    printer.step(1, 2, `Generating ${type} scaffold: "${name}"...`);
+    const success = await insertIntoSource(cwd, type, scaffold);
+    if (!success)
+        process.exit(1);
+    printer.step(2, 2, 'Done!');
+    printer.blank();
+    printer.success(`Added ${type} "${name}" to src/index.ts`);
+    printer.blank();
+    printer.info('Open src/index.ts and fill in the handler logic.');
+    printer.blank();
+});
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/check.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const checkCommand: Command;
+//# sourceMappingURL=check.d.ts.map

package/dist/commands/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAyCpC,eAAO,MAAM,YAAY,SAmJrB,CAAC"}

package/dist/commands/check.js

@@ -0,0 +1,218 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — commands/check.ts
+//
+// air check
+//
+// 프로젝트 상태를 종합 진단한다.
+// - 환경: Node.js, TypeScript, pnpm 버전
+// - 의존성: @airmcp-dev/* 패키지 설치 상태
+// - 빌드: tsc 타입체크 통과 여부
+// - 테스트: vitest 실행 결과
+// - 설정: shield, meter 활성화 상태
+// - 도구: 등록된 도구 수
+//
+// @example
+//   air check
+//   air check --fix    (향후: 자동 수정)
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { readFile, access } from 'node:fs/promises';
+import { execSync } from 'node:child_process';
+import { printer } from '../utils/printer.js';
+/** 명령어 실행 헬퍼 (실패 시 null) */
+function run(cmd, cwd) {
+    try {
+        return execSync(cmd, { cwd, encoding: 'utf-8', timeout: 30_000, stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** package.json 읽기 */
+async function readPkg(cwd) {
+    try {
+        const raw = await readFile(resolve(cwd, 'package.json'), 'utf-8');
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+/** 파일 존재 여부 */
+async function exists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export const checkCommand = new Command('check')
+    .description('Diagnose project health — environment, build, tests, config')
+    .action(async () => {
+    const cwd = process.cwd();
+    const results = [];
+    printer.blank();
+    printer.heading('air check');
+    // ── 1. 환경 ──
+    const nodeVersion = run('node --version', cwd);
+    if (nodeVersion) {
+        const major = parseInt(nodeVersion.replace('v', ''));
+        results.push({
+            name: 'Node.js',
+            status: major >= 18 ? 'pass' : 'fail',
+            message: `${nodeVersion}${major < 18 ? ' (requires >= 18)' : ''}`,
+        });
+    }
+    else {
+        results.push({ name: 'Node.js', status: 'fail', message: 'not found' });
+    }
+    const tsVersion = run('npx tsc --version', cwd);
+    results.push({
+        name: 'TypeScript',
+        status: tsVersion ? 'pass' : 'warn',
+        message: tsVersion || 'not installed',
+    });
+    // ── 2. package.json ──
+    const pkg = await readPkg(cwd);
+    if (!pkg) {
+        results.push({ name: 'package.json', status: 'fail', message: 'not found' });
+        printResults(results);
+        return;
+    }
+    results.push({ name: 'package.json', status: 'pass', message: `${pkg.name}@${pkg.version || '0.0.0'}` });
+    // ── 3. 의존성 체크 ──
+    const deps = { ...pkg.dependencies, ...pkg.devDependencies };
+    const airPackages = ['@airmcp-dev/core', '@airmcp-dev/shield', '@airmcp-dev/meter', '@airmcp-dev/logger', '@airmcp-dev/gateway', '@airmcp-dev/hive'];
+    for (const airPkg of airPackages) {
+        if (deps[airPkg]) {
+            results.push({ name: airPkg, status: 'pass', message: deps[airPkg] });
+        }
+        // 없는 패키지는 건너뜀 (필수가 아님)
+    }
+    if (!deps['@airmcp-dev/core']) {
+        results.push({ name: '@airmcp-dev/core', status: 'fail', message: 'not in dependencies — required' });
+    }
+    // ── 4. 소스 파일 체크 ──
+    const hasSrc = await exists(resolve(cwd, 'src/index.ts')) || await exists(resolve(cwd, 'src/index.js'));
+    results.push({
+        name: 'Source',
+        status: hasSrc ? 'pass' : 'fail',
+        message: hasSrc ? 'src/index.ts found' : 'src/index.ts not found',
+    });
+    // ── 5. 빌드 (타입체크) ──
+    const hasTsConfig = await exists(resolve(cwd, 'tsconfig.json'));
+    if (hasTsConfig && hasSrc) {
+        const tscResult = run('npx tsc --noEmit 2>&1', cwd);
+        if (tscResult === null || tscResult === '') {
+            results.push({ name: 'Type Check', status: 'pass', message: 'no errors' });
+        }
+        else {
+            const errorCount = (tscResult.match(/error TS/g) || []).length;
+            results.push({
+                name: 'Type Check',
+                status: 'fail',
+                message: `${errorCount} error(s)`,
+            });
+        }
+    }
+    else {
+        results.push({ name: 'Type Check', status: 'skip', message: 'no tsconfig.json' });
+    }
+    // ── 6. 빌드 결과물 ──
+    const hasDist = await exists(resolve(cwd, 'dist/index.js')) || await exists(resolve(cwd, 'build/index.js'));
+    results.push({
+        name: 'Build',
+        status: hasDist ? 'pass' : 'warn',
+        message: hasDist ? 'dist/ found' : 'not built yet (run: npm run build)',
+    });
+    // ── 7. 테스트 ──
+    const hasTestDir = await exists(resolve(cwd, '__tests__')) || await exists(resolve(cwd, 'test')) || await exists(resolve(cwd, 'tests'));
+    const hasVitest = deps['vitest'] || await exists(resolve(cwd, 'vitest.config.ts'));
+    if (hasTestDir || hasVitest) {
+        const testResult = run('npx vitest run 2>&1', cwd);
+        if (testResult && testResult.includes('passed')) {
+            const match = testResult.match(/Tests\s+(\d+)\s+passed/);
+            const count = match ? match[1] : '?';
+            results.push({ name: 'Tests', status: 'pass', message: `${count} passed` });
+        }
+        else if (testResult && testResult.includes('failed')) {
+            const match = testResult.match(/(\d+)\s+failed/);
+            const failCount = match ? match[1] : '?';
+            results.push({ name: 'Tests', status: 'fail', message: `${failCount} failed` });
+        }
+        else {
+            results.push({ name: 'Tests', status: 'skip', message: 'no tests found' });
+        }
+    }
+    else {
+        results.push({ name: 'Tests', status: 'skip', message: 'no test directory' });
+    }
+    // ── 8. air 설정 분석 (소스에서 shield/meter 사용 여부) ──
+    if (hasSrc) {
+        try {
+            const srcPath = resolve(cwd, 'src/index.ts');
+            const srcContent = await readFile(srcPath, 'utf-8');
+            // shield 설정 감지
+            if (srcContent.includes('shield:') || srcContent.includes('shield :')) {
+                const shieldEnabled = srcContent.includes('enabled: true') || srcContent.includes('enabled:true');
+                results.push({
+                    name: 'Shield',
+                    status: shieldEnabled ? 'pass' : 'warn',
+                    message: shieldEnabled ? 'enabled' : 'configured but not enabled',
+                });
+            }
+            else {
+                results.push({ name: 'Shield', status: 'warn', message: 'not configured' });
+            }
+            // meter 설정 감지
+            if (srcContent.includes('meter:') || srcContent.includes('meter :')) {
+                results.push({ name: 'Meter', status: 'pass', message: 'enabled' });
+            }
+            else {
+                results.push({ name: 'Meter', status: 'warn', message: 'not configured' });
+            }
+            // 도구 수 감지
+            const toolCount = (srcContent.match(/defineTool\(/g) || []).length;
+            results.push({
+                name: 'Tools',
+                status: toolCount > 0 ? 'pass' : 'warn',
+                message: `${toolCount} tool(s) defined`,
+            });
+        }
+        catch {
+            // 읽기 실패 시 스킵
+        }
+    }
+    // ── 결과 출력 ──
+    printResults(results);
+});
+function printResults(results) {
+    printer.blank();
+    let passCount = 0;
+    let failCount = 0;
+    let warnCount = 0;
+    for (const r of results) {
+        const icon = r.status === 'pass' ? '✔' : r.status === 'fail' ? '✖' : r.status === 'warn' ? '⚠' : '–';
+        const color = r.status === 'pass' ? '\x1b[32m' : r.status === 'fail' ? '\x1b[31m' : r.status === 'warn' ? '\x1b[33m' : '\x1b[90m';
+        const reset = '\x1b[0m';
+        const name = r.name.padEnd(16);
+        console.log(`  ${color}${icon}${reset} ${name} ${r.message}`);
+        if (r.status === 'pass')
+            passCount++;
+        else if (r.status === 'fail')
+            failCount++;
+        else if (r.status === 'warn')
+            warnCount++;
+    }
+    printer.blank();
+    if (failCount === 0) {
+        console.log(`  \x1b[32m✅ All checks passed!${warnCount > 0 ? ` (${warnCount} warning${warnCount > 1 ? 's' : ''})` : ''}\x1b[0m`);
+    }
+    else {
+        console.log(`  \x1b[31m❌ ${failCount} check(s) failed, ${passCount} passed, ${warnCount} warning(s)\x1b[0m`);
+    }
+    printer.blank();
+}
+//# sourceMappingURL=check.js.map

package/dist/commands/check.js.map

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

package/dist/commands/connect.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const connectCommand: Command;
+//# sourceMappingURL=connect.d.ts.map

package/dist/commands/connect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../src/commands/connect.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAwDpC,eAAO,MAAM,cAAc,SAqFvB,CAAC"}

package/dist/commands/connect.js

@@ -0,0 +1,135 @@
+// Copyright 2026 CodePedia Labs. Licensed under Apache-2.0.
+// air CLI — commands/connect.ts
+//
+// air connect <client> [--name <name>] [--transport stdio|http|sse] [--port <port>]
+//
+// MCP 클라이언트의 설정 파일에 현재 서버를 자동 등록한다.
+// path-resolver로 OS별 경로를 해석하고, json-editor로 안전하게 수정.
+//
+// @example
+//   air connect claude-desktop
+//   air connect cursor --name my-db-tool
+//   air connect vscode --transport http --port 3100
+import { Command } from 'commander';
+import { resolve } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { printer } from '../utils/printer.js';
+import { resolveClientConfig, listClients } from '../utils/path-resolver.js';
+import { JsonEditor } from '../utils/json-editor.js';
+/** package.json에서 서버 정보를 읽는다 */
+async function readPkg(cwd) {
+    try {
+        const raw = await readFile(resolve(cwd, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(raw);
+        return { name: pkg.name || 'air-server', version: pkg.version || '0.0.0' };
+    }
+    catch {
+        return { name: 'air-server', version: '0.0.0' };
+    }
+}
+/** MCP 서버 등록 엔트리 생성 */
+function buildServerEntry(cwd, transport, port, opts) {
+    const host = opts.host || 'localhost';
+    if (transport === 'stdio') {
+        return {
+            command: 'npx',
+            args: ['tsx', `${cwd}/src/index.ts`],
+        };
+    }
+    if (transport === 'sse') {
+        // mcp-proxy가 있으면 프록시 경유, 없으면 직접 연결
+        if (opts.proxyPath) {
+            return {
+                command: 'node',
+                args: [opts.proxyPath, `http://${host}:${port}`],
+            };
+        }
+        // 직접 SSE 연결 (클라이언트가 SSE를 지원하는 경우)
+        return {
+            url: `http://${host}:${port}/sse`,
+            transport: 'sse',
+        };
+    }
+    // http (Streamable HTTP)
+    return {
+        url: `http://${host}:${port}`,
+        transport: 'http',
+    };
+}
+export const connectCommand = new Command('connect')
+    .description('Register this MCP server with a client')
+    .argument('<client>', 'Client to connect: claude-desktop, cursor, vscode, ...')
+    .option('-n, --name <n>', 'Server name in client config (default: from package.json)')
+    .option('-t, --transport <type>', 'Transport: stdio | http | sse', 'stdio')
+    .option('-p, --port <port>', 'Port for http/sse transport', '3000')
+    .option('-H, --host <host>', 'Host for remote server (default: localhost)')
+    .option('--proxy <path>', 'Path to mcp-proxy.js for SSE via stdio-to-SSE proxy')
+    .action(async (client, opts) => {
+    const cwd = process.cwd();
+    // ── 1. 클라이언트 경로 해석 ──
+    let clientInfo;
+    try {
+        clientInfo = resolveClientConfig(client);
+    }
+    catch (err) {
+        printer.error(err.message);
+        printer.blank();
+        printer.info('Available clients:');
+        printer.blank();
+        printer.list(listClients().map((c) => ({ name: c.id, description: c.name })));
+        printer.blank();
+        process.exit(1);
+    }
+    // custom 클라이언트는 경로 직접 지정 필요
+    if (client === 'custom') {
+        printer.error('Custom client requires manual config. See docs for details.');
+        process.exit(1);
+    }
+    // ── 2. 서버 이름 결정 ──
+    const pkg = await readPkg(cwd);
+    const serverName = opts.name || pkg.name;
+    // ── 3. 설정 파일 로드 ──
+    printer.blank();
+    printer.step(1, 3, `Loading ${clientInfo.displayName} config...`);
+    const editor = await JsonEditor.load(clientInfo.configPath);
+    // ── 4. 서버 엔트리 등록 ──
+    printer.step(2, 3, `Registering "${serverName}"...`);
+    const entryPath = `${clientInfo.mcpKey}.${serverName}`;
+    const entry = buildServerEntry(cwd, opts.transport, opts.port, {
+        host: opts.host,
+        proxyPath: opts.proxy,
+    });
+    // 이미 등록되어 있으면 덮어쓰기 경고
+    if (editor.has(entryPath)) {
+        printer.warn(`"${serverName}" already registered — overwriting.`);
+    }
+    editor.set(entryPath, entry);
+    // ── 5. 저장 ──
+    printer.step(3, 3, 'Saving config...');
+    await editor.save();
+    printer.blank();
+    printer.success(`Connected "${serverName}" to ${clientInfo.displayName}`);
+    printer.kv('config', clientInfo.configPath);
+    printer.kv('transport', opts.transport);
+    if (opts.transport !== 'stdio') {
+        printer.kv('host', opts.host || 'localhost');
+        printer.kv('port', opts.port);
+    }
+    if (opts.proxy) {
+        printer.kv('proxy', opts.proxy);
+    }
+    printer.blank();
+    if (opts.transport === 'stdio') {
+        printer.info('The client will start the server automatically via stdio.');
+    }
+    else if (opts.proxy) {
+        printer.info('The proxy will bridge stdio (client) ↔ SSE (server).');
+        printer.info(`Make sure the server is running: air start --transport sse --port ${opts.port}`);
+    }
+    else {
+        printer.info(`Make sure the server is running: air start --transport ${opts.transport} --port ${opts.port}`);
+    }
+    printer.blank();
+});
+;
+//# sourceMappingURL=connect.js.map

package/dist/commands/connect.js.map

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

package/dist/commands/create.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare const createCommand: Command;
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAqEpC,eAAO,MAAM,aAAa,SAoFtB,CAAC"}