@mr.dj2u/cli 0.1.0

package/dist/commands/dev-tools.js

@@ -0,0 +1,283 @@
+import { execFile } from 'node:child_process';
+import { rm, readFile } from 'node:fs/promises';
+import path from 'node:path';
+import { promisify } from 'node:util';
+import chalk from 'chalk';
+const execFileAsync = promisify(execFile);
+export async function runKillPortCommand(argv) {
+    const ports = normalizePorts([...(argv.ports ?? []), ...(argv.port ?? [])], [8081]);
+    const killed = await killPorts(ports);
+    console.log(chalk.bold('mds free-port'));
+    for (const port of ports) {
+        const entries = killed.get(port) ?? [];
+        if (entries.length === 0) {
+            console.log(chalk.gray(`port ${port}: no listening process found`));
+        }
+        else {
+            console.log(chalk.green(`port ${port}: killed ${formatKilledEntries(entries)}`));
+        }
+    }
+}
+export async function runClearExpoStartCommand(argv) {
+    const projectPath = path.resolve(argv.path ?? '.');
+    const autoPorts = await shouldIncludeServerPort(projectPath) ? [8081, 3000] : [8081];
+    const ports = normalizePorts(argv.ports ? argv.ports.split(',') : [], autoPorts);
+    console.log(chalk.bold('mds clear-expo-start'));
+    console.log(chalk.dim(projectPath));
+    console.log();
+    const killed = await killPorts(ports);
+    for (const port of ports) {
+        const entries = killed.get(port) ?? [];
+        console.log(entries.length > 0
+            ? chalk.green(`port ${port}: killed ${formatKilledEntries(entries)}`)
+            : chalk.gray(`port ${port}: no listening process found`));
+    }
+    await clearExpoCaches(projectPath);
+    console.log(chalk.green('Expo/Metro project caches cleared.'));
+    if (argv.start === false) {
+        console.log(chalk.gray('Skipping Expo start because --no-start was passed.'));
+        return;
+    }
+    const command = buildExpoStartCommand(await detectPackageManager(projectPath));
+    console.log(chalk.cyan(`Starting: ${command}`));
+    await runInheritedShellCommand(command, projectPath);
+}
+async function killPorts(ports) {
+    const results = new Map();
+    for (const port of ports) {
+        const pids = await findPidsForPort(port);
+        const killed = [];
+        for (const pid of pids) {
+            const name = await getProcessName(pid);
+            if (await killPid(pid)) {
+                killed.push({ pid, name });
+            }
+        }
+        results.set(port, killed);
+    }
+    return results;
+}
+function formatKilledEntries(entries) {
+    return entries.map(({ pid, name }) => (name ? `${pid} (${name})` : String(pid))).join(', ');
+}
+function normalizePorts(values, fallback) {
+    const ports = values
+        .flatMap((value) => String(value).split(','))
+        .map((value) => Number.parseInt(value.trim(), 10))
+        .filter((value) => Number.isInteger(value) && value > 0 && value < 65536);
+    return Array.from(new Set(ports.length > 0 ? ports : fallback));
+}
+async function findPidsForPort(port) {
+    if (process.platform === 'win32') {
+        return findWindowsPidsForPort(port);
+    }
+    try {
+        const { stdout } = await execFileAsync('lsof', ['-ti', `tcp:${port}`], {
+            windowsHide: true,
+        });
+        return stdout
+            .split(/\r?\n/)
+            .map((line) => Number.parseInt(line.trim(), 10))
+            .filter((pid) => Number.isInteger(pid) && pid > 0);
+    }
+    catch {
+        return [];
+    }
+}
+async function findWindowsPidsForPort(port) {
+    const powershellPids = await findWindowsPidsForPortWithPowerShell(port);
+    if (powershellPids.length > 0) {
+        return powershellPids;
+    }
+    try {
+        const { stdout } = await execFileAsync('netstat', ['-ano', '-p', 'tcp'], {
+            windowsHide: true,
+        });
+        return parseWindowsNetstatPids(stdout, port);
+    }
+    catch {
+        return [];
+    }
+}
+async function findWindowsPidsForPortWithPowerShell(port) {
+    try {
+        const script = [
+            '$ErrorActionPreference = "SilentlyContinue"',
+            `Get-NetTCPConnection -LocalPort ${port}`,
+            '  | Where-Object { $_.State -eq "Listen" -and $_.OwningProcess -gt 0 }',
+            '  | Select-Object -ExpandProperty OwningProcess -Unique',
+        ].join(' ');
+        const { stdout } = await execFileAsync('powershell.exe', ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-Command', script], { windowsHide: true });
+        return parsePidLines(stdout);
+    }
+    catch {
+        return [];
+    }
+}
+export function parseWindowsNetstatPids(stdout, port) {
+    const pids = new Set();
+    for (const line of stdout.split(/\r?\n/)) {
+        const normalized = line.trim().replace(/\s+/g, ' ');
+        const parts = normalized.split(' ');
+        if (parts.length < 5 || parts[0] !== 'TCP') {
+            continue;
+        }
+        const localAddress = parts[1] ?? '';
+        const state = parts[3] ?? '';
+        const pid = Number.parseInt(parts[4] ?? '', 10);
+        if (state === 'LISTENING' && localAddress.endsWith(`:${port}`) && Number.isInteger(pid) && pid > 0) {
+            pids.add(pid);
+        }
+    }
+    return [...pids];
+}
+export function parsePidLines(stdout) {
+    return Array.from(new Set(stdout
+        .split(/\r?\n/)
+        .map((line) => Number.parseInt(line.trim(), 10))
+        .filter((pid) => Number.isInteger(pid) && pid > 0)));
+}
+async function getProcessName(pid) {
+    try {
+        if (process.platform === 'win32') {
+            const { stdout } = await execFileAsync('tasklist', ['/FI', `PID eq ${pid}`, '/FO', 'CSV', '/NH'], {
+                windowsHide: true,
+            });
+            const match = stdout.match(/^"([^"]+)"/);
+            return match?.[1];
+        }
+        const { stdout } = await execFileAsync('ps', ['-p', String(pid), '-o', 'comm='], {
+            windowsHide: true,
+        });
+        const trimmed = stdout.trim();
+        return trimmed || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+async function killPid(pid) {
+    try {
+        if (process.platform === 'win32') {
+            await execFileAsync('taskkill', ['/PID', String(pid), '/F'], { windowsHide: true });
+        }
+        else {
+            process.kill(pid, 'SIGKILL');
+        }
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function clearExpoCaches(projectPath) {
+    const projectCachePaths = [
+        '.expo',
+        '.cache',
+        path.join('node_modules', '.cache', 'metro'),
+        path.join('node_modules', '.cache', 'babel-loader'),
+    ].map((p) => path.join(projectPath, p));
+    // Windows system-level Metro cache (mirrors core-monorepo clear-metro-cache.cjs)
+    const systemCachePaths = [];
+    if (process.platform === 'win32' && process.env.LOCALAPPDATA) {
+        systemCachePaths.push(path.join(process.env.LOCALAPPDATA, 'Temp', 'metro-cache'));
+    }
+    await Promise.all([...projectCachePaths, ...systemCachePaths].map((p) => rm(p, { recursive: true, force: true })));
+}
+async function shouldIncludeServerPort(projectPath) {
+    const packageJson = await readJson(path.join(projectPath, 'package.json'));
+    const scripts = isRecord(packageJson?.scripts) ? packageJson.scripts : {};
+    const hasServerScript = Object.keys(scripts).some((name) => ['server', 'serve', 'web:server', 'dev:server', 'api'].includes(name));
+    if (hasServerScript) {
+        return true;
+    }
+    const appJson = await readJson(path.join(projectPath, 'app.json'));
+    const output = readNestedString(appJson, ['expo', 'web', 'output']);
+    return output === 'server';
+}
+async function detectPackageManager(projectPath) {
+    const packageJson = await readJson(path.join(projectPath, 'package.json'));
+    const declared = readString(packageJson?.packageManager);
+    if (declared?.startsWith('pnpm@'))
+        return 'pnpm';
+    if (declared?.startsWith('yarn@'))
+        return 'yarn';
+    if (declared?.startsWith('bun@'))
+        return 'bun';
+    if (await fileExists(path.join(projectPath, 'pnpm-lock.yaml')))
+        return 'pnpm';
+    if (await fileExists(path.join(projectPath, 'yarn.lock')))
+        return 'yarn';
+    if (await fileExists(path.join(projectPath, 'bun.lockb')) || await fileExists(path.join(projectPath, 'bun.lock'))) {
+        return 'bun';
+    }
+    return 'npm';
+}
+function buildExpoStartCommand(packageManager) {
+    switch (packageManager) {
+        case 'pnpm':
+            return 'pnpm exec expo start --clear';
+        case 'yarn':
+            return 'yarn expo start --clear';
+        case 'bun':
+            return 'bunx expo start --clear';
+        case 'npm':
+            return 'npx expo start --clear';
+    }
+}
+async function runInheritedShellCommand(command, cwd) {
+    const { spawn } = await import('node:child_process');
+    await new Promise((resolve, reject) => {
+        const child = spawn(command, {
+            cwd,
+            shell: true,
+            stdio: 'inherit',
+            windowsHide: true,
+        });
+        child.on('error', reject);
+        child.on('close', (code) => {
+            if (code === 0) {
+                resolve();
+            }
+            else {
+                reject(new Error(`${command} exited with code ${code ?? 'unknown'}.`));
+            }
+        });
+    });
+}
+async function readJson(filePath) {
+    try {
+        const raw = await readFile(filePath, 'utf8');
+        const parsed = JSON.parse(raw);
+        return isRecord(parsed) ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function fileExists(filePath) {
+    try {
+        await readFile(filePath, 'utf8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function readNestedString(value, keys) {
+    let current = value;
+    for (const key of keys) {
+        if (!isRecord(current)) {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return readString(current);
+}
+function readString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=dev-tools.js.map

package/dist/commands/dev-tools.js.map

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

package/dist/commands/explain.d.ts

@@ -0,0 +1,29 @@
+export interface ExplainArgv {
+    topic?: string;
+    json?: boolean;
+}
+export type ExplainMatch = {
+    type: 'doctor';
+    id: string;
+    name: string;
+    description: string;
+    nextStep: string;
+    relatedResources: string[];
+} | {
+    type: 'knowledge';
+    id: string;
+    name: string;
+    description: string;
+    uri: string;
+    kind: string;
+    keywords: string[];
+    excerpt: string;
+};
+export interface ExplainResult {
+    query: string;
+    status: 'found' | 'ambiguous' | 'not-found';
+    matches: ExplainMatch[];
+}
+export declare function runExplainCommand(argv: ExplainArgv): Promise<void>;
+export declare function explainTopic(topic: string): Promise<ExplainResult>;
+//# sourceMappingURL=explain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../src/commands/explain.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,MAAM,YAAY,GACpB;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,EAAE,CAAC;CAC5B,GACD;IACE,IAAI,EAAE,WAAW,CAAC;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;IAC5C,OAAO,EAAE,YAAY,EAAE,CAAC;CACzB;AAsFD,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBxE;AAED,wBAAsB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CA2CxE"}

package/dist/commands/explain.js

@@ -0,0 +1,216 @@
+import chalk from 'chalk';
+import { listKnowledgeResources, readKnowledgeResource } from '@mr.dj2u/knowledge';
+const DOCTOR_TOPICS = [
+    {
+        id: 'project docs',
+        name: 'Project Docs',
+        description: 'Checks that project/info.md, project/todo.md, project/style.md, and project/guidelines.md exist.',
+        nextStep: 'Create or normalize the project memory files so agents have a stable source of truth.',
+        relatedResources: ['project-documentation-org', 'post-create-onboarding'],
+        aliases: ['project-docs', 'project memory', 'docs'],
+    },
+    {
+        id: 'todo-for-context markers',
+        name: 'TodoForContext Markers',
+        description: 'Blocks unresolved optional intake markers from surviving into phase work or CI.',
+        nextStep: 'Fill the section under each marker, or delete the marker line to acknowledge that no extra context is needed.',
+        relatedResources: ['post-create-onboarding'],
+        aliases: ['todoforcontext', 'todo for context', 'markers'],
+    },
+    {
+        id: 'gitignore env',
+        name: 'Gitignore Env',
+        description: 'Checks that local environment files are ignored before secrets land in git.',
+        nextStep: 'Make sure .env, .env.local, and similar files are ignored while safe examples remain tracked.',
+        relatedResources: ['env-hygiene', 'deployment-environment-config'],
+        aliases: ['env gitignore', '.env', 'gitignore'],
+    },
+    {
+        id: 'package scripts',
+        name: 'Package Scripts',
+        description: 'Checks whether the project exposes useful local scripts for linting, testing, building, and Doctor.',
+        nextStep: 'Add missing scripts only when the package manager and framework support them.',
+        relatedResources: ['deployment-ci-cd-patterns'],
+        aliases: ['scripts', 'npm scripts'],
+    },
+    {
+        id: 'styling stack',
+        name: 'Styling Stack',
+        description: 'Checks for the expected Uniwind/Tailwind styling setup and conflicting NativeWind artifacts.',
+        nextStep: 'Prefer Uniwind plus Tailwind v4 for new MDS app scaffolds.',
+        relatedResources: ['styling-uniwind-setup', 'uniwind-theming'],
+        aliases: ['styling', 'uniwind', 'tailwind'],
+    },
+    {
+        id: 'expo config',
+        name: 'Expo Config',
+        description: 'Checks that Expo configuration is present and compatible with selected platforms and web output.',
+        nextStep: 'Inspect app.json or app.config.* and align platforms, web output, and EAS expectations.',
+        relatedResources: ['project-configuration-patterns', 'deployment-build-configuration'],
+        aliases: ['expo configuration', 'app.json', 'app config'],
+    },
+    {
+        id: 'env hygiene',
+        name: 'Env Hygiene',
+        description: 'Checks for secret-looking values exposed through EXPO_PUBLIC variables or client code.',
+        nextStep: 'Move private keys server-side and keep client env vars publishable only.',
+        relatedResources: ['env-hygiene', 'env-vars'],
+        aliases: ['environment hygiene', 'secrets', 'expo public'],
+    },
+    {
+        id: 'app architecture',
+        name: 'App Architecture',
+        description: 'Checks Expo Router route files for oversized screens and business/data logic in app/.',
+        nextStep: 'Move real UI into feature screens and keep route files focused on routing and layout.',
+        relatedResources: ['app-folder-architecture', 'expo-router-architecture', 'routing-file-based-routing'],
+        aliases: ['app folder', 'route architecture', 'routes'],
+    },
+    {
+        id: 'seo metadata',
+        name: 'SEO Metadata',
+        description: 'Checks web-facing metadata basics such as title, description, and indexing strategy.',
+        nextStep: 'Define route-level metadata and canonical/indexing expectations for production web output.',
+        relatedResources: ['seo-metadata'],
+        aliases: ['seo', 'metadata'],
+    },
+    {
+        id: 'script checks',
+        name: 'Script Checks',
+        description: 'Runs lint, typecheck, tests, Expo Doctor, and build scripts when the selected Doctor mode asks for them.',
+        nextStep: 'Fix the failing script locally, rerun mds doctor, then push only after the CI-equivalent profile passes.',
+        relatedResources: ['deployment-ci-cd-patterns', 'deployment'],
+        aliases: ['eslint', 'typescript', 'typecheck', 'expo doctor', 'build checks', 'ci'],
+    },
+];
+export async function runExplainCommand(argv) {
+    if (!argv.topic) {
+        throw new Error('mds explain requires a topic.');
+    }
+    const result = await explainTopic(argv.topic);
+    if (argv.json) {
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        printExplainResult(result);
+    }
+    if (result.status !== 'found') {
+        process.exitCode = 1;
+    }
+}
+export async function explainTopic(topic) {
+    const query = topic.trim();
+    const normalized = normalize(query);
+    const exactDoctorMatches = DOCTOR_TOPICS.filter((candidate) => [candidate.id, candidate.name, ...candidate.aliases].map(normalize).includes(normalized)).map(doctorMatchFromTopic);
+    if (exactDoctorMatches.length === 1) {
+        return { query, status: 'found', matches: exactDoctorMatches };
+    }
+    const resources = listKnowledgeResources();
+    const exactResourceMatches = await Promise.all(resources
+        .filter((resource) => resource.uri === query ||
+        [resource.id, resource.name].map(normalize).includes(normalized))
+        .map(async (resource) => knowledgeMatchFromResource(resource)));
+    if (exactResourceMatches.length === 1) {
+        return { query, status: 'found', matches: exactResourceMatches };
+    }
+    const doctorMatches = DOCTOR_TOPICS.filter((candidate) => [candidate.id, candidate.name, candidate.description, ...candidate.aliases]
+        .map(normalize)
+        .some((value) => value.includes(normalized) || normalized.includes(value))).map(doctorMatchFromTopic);
+    const knowledgeMatches = await Promise.all(resources
+        .filter((resource) => resourceMatches(resource, normalized))
+        .map(async (resource) => knowledgeMatchFromResource(resource)));
+    const matches = [...doctorMatches, ...knowledgeMatches];
+    if (matches.length === 1) {
+        return { query, status: 'found', matches };
+    }
+    if (matches.length > 1) {
+        return { query, status: 'ambiguous', matches };
+    }
+    return { query, status: 'not-found', matches: [] };
+}
+function doctorMatchFromTopic(candidate) {
+    return {
+        type: 'doctor',
+        id: candidate.id,
+        name: candidate.name,
+        description: candidate.description,
+        nextStep: candidate.nextStep,
+        relatedResources: [...candidate.relatedResources],
+    };
+}
+function printExplainResult(result) {
+    if (result.status === 'not-found') {
+        console.log(chalk.red(`No MDS explanation matched "${result.query}".`));
+        console.log(chalk.gray('Try a Doctor check name like env hygiene, app architecture, or seo metadata.'));
+        return;
+    }
+    if (result.status === 'ambiguous') {
+        console.log(chalk.yellow(`"${result.query}" matched multiple topics:`));
+        for (const match of result.matches.slice(0, 10)) {
+            console.log(`  ${match.id} - ${match.name}`);
+        }
+        console.log(chalk.gray('Run `mds explain <exact id>` for one of these topics.'));
+        return;
+    }
+    const match = result.matches[0];
+    if (!match) {
+        console.log(chalk.red(`No MDS explanation matched "${result.query}".`));
+        return;
+    }
+    console.log(chalk.bold(match.name));
+    console.log(chalk.dim(`${match.type}: ${match.id}`));
+    console.log();
+    console.log(match.description);
+    console.log();
+    if (match.type === 'doctor') {
+        console.log(chalk.bold('Next Step'));
+        console.log(match.nextStep);
+        if (match.relatedResources.length > 0) {
+            console.log();
+            console.log(chalk.bold('Related Resources'));
+            for (const resource of match.relatedResources) {
+                console.log(`- ${resource}`);
+            }
+        }
+        return;
+    }
+    console.log(chalk.bold('Resource'));
+    console.log(`${match.kind} ${match.uri}`);
+    if (match.excerpt) {
+        console.log();
+        console.log(chalk.bold('Excerpt'));
+        console.log(match.excerpt);
+    }
+}
+async function knowledgeMatchFromResource(resource) {
+    const content = await readKnowledgeResource(resource.uri);
+    return {
+        type: 'knowledge',
+        id: resource.id,
+        name: resource.name,
+        description: resource.description,
+        uri: resource.uri,
+        kind: resource.kind,
+        keywords: resource.keywords,
+        excerpt: summarizeContent(content),
+    };
+}
+function summarizeContent(resource) {
+    if (!resource) {
+        return '';
+    }
+    return resource.content
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter((line) => line && !line.startsWith('#'))
+        .slice(0, 3)
+        .join('\n');
+}
+function resourceMatches(resource, normalizedQuery) {
+    return [resource.id, resource.uri, resource.name, resource.description, ...resource.keywords]
+        .map(normalize)
+        .some((value) => value.includes(normalizedQuery) || normalizedQuery.includes(value));
+}
+function normalize(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+}
+//# sourceMappingURL=explain.js.map

package/dist/commands/explain.js.map

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

package/dist/commands/mcp-install.d.ts

@@ -0,0 +1,28 @@
+export type McpClient = 'claude' | 'codex' | 'cursor' | 'vscode';
+export type McpScope = 'user' | 'project';
+export interface McpInstallArgv {
+    client?: McpClient;
+    scope?: McpScope;
+    target?: string;
+    serverPath?: string;
+    command?: string;
+    dryRun?: boolean;
+}
+export interface ResolvedServer {
+    command: string;
+    args: string[];
+}
+export declare const SERVER_KEY = "mds-dev-suite";
+export declare const VSCODE_SERVER_KEY = "mdsDevSuite";
+export declare function runMcpInstallCommand(argv: McpInstallArgv): Promise<void>;
+export declare function resolveServerInvocation(argv: McpInstallArgv): ResolvedServer;
+export declare function writeMcpJsonToProject(targetDir: string): Promise<void>;
+export declare function writeJsonMcpConfig(filePath: string, server: ResolvedServer, dryRun: boolean): Promise<void>;
+export declare function writeCodexConfig(filePath: string, server: ResolvedServer, dryRun: boolean): Promise<void>;
+export declare function renderCodexBlock(key: string, server: ResolvedServer): string;
+export declare function writeVscodeMcpConfig(filePath: string, server: ResolvedServer, dryRun: boolean): Promise<void>;
+export declare function installVscodeUserMcp(server: ResolvedServer, dryRun: boolean): Promise<void>;
+export declare function buildVscodeAddMcpPayload(server: ResolvedServer): Record<string, unknown>;
+export declare function renderVscodeAddMcpCommand(payload: Record<string, unknown>): string;
+export declare function stripExistingCodexBlock(content: string, key: string): string;
+//# sourceMappingURL=mcp-install.d.ts.map

package/dist/commands/mcp-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-install.d.ts","sourceRoot":"","sources":["../../src/commands/mcp-install.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACjE,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;AAE1C,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAC1C,eAAO,MAAM,iBAAiB,gBAAgB,CAAC;AAE/C,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoB9E;AAkDD,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,cAAc,GAAG,cAAc,CAe5E;AAWD,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAW5E;AAED,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,MAAM,CAG5E;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAsBf;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMxF;AAED,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAElF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAa5E"}