@otomus/nerva-cli 0.1.1

package/dist/commands/new.js

@@ -0,0 +1,138 @@
+/**
+ * `nerva new <name>` command.
+ *
+ * Scaffolds a new Nerva project directory with the correct structure
+ * for either Python or TypeScript.
+ */
+import { mkdir, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { serializeNervaConfig } from '../config/nerva-yaml.js';
+/** Directories created for a Python project. */
+const PYTHON_DIRS = ['agents', 'tools', 'memory', 'middleware', 'tests'];
+/** Directories created for a TypeScript project. */
+const TS_DIRS = ['src/agents', 'src/tools', 'src/memory', 'src/middleware', 'tests'];
+/**
+ * Creates a directory and all parents, silently succeeding if it already exists.
+ *
+ * @param dirPath - Absolute path to create
+ */
+async function ensureDir(dirPath) {
+    await mkdir(dirPath, { recursive: true });
+}
+/**
+ * Builds a default NervaConfig for a new project.
+ *
+ * @param name - Project name
+ * @param lang - Project language
+ * @returns Default configuration
+ */
+function buildDefaultConfig(name, lang) {
+    return {
+        name,
+        version: '0.1.0',
+        lang,
+        agents: [],
+        tools: [],
+        middleware: [],
+        routers: [],
+    };
+}
+/**
+ * Scaffolds the Python-specific files in the project directory.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param name - Project name
+ */
+async function scaffoldPython(projectDir, name) {
+    for (const dir of PYTHON_DIRS) {
+        await ensureDir(join(projectDir, dir));
+    }
+    await writeFile(join(projectDir, 'main.py'), `"""${name} — entry point."""\n\nfrom nerva import Runtime\n\n\ndef main() -> None:\n    """Start the Nerva runtime."""\n    runtime = Runtime.from_config("nerva.yaml")\n    runtime.start()\n\n\nif __name__ == "__main__":\n    main()\n`, 'utf-8');
+    await writeFile(join(projectDir, 'requirements.txt'), 'nerva>=0.1.0\n', 'utf-8');
+}
+/**
+ * Scaffolds the TypeScript-specific files in the project directory.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param name - Project name
+ */
+async function scaffoldTypeScript(projectDir, name) {
+    for (const dir of TS_DIRS) {
+        await ensureDir(join(projectDir, dir));
+    }
+    await writeFile(join(projectDir, 'src/index.ts'), `/**\n * ${name} — entry point.\n */\n\nimport { Runtime } from 'nerva';\n\n/** Start the Nerva runtime. */\nasync function main(): Promise<void> {\n  const runtime = await Runtime.fromConfig('nerva.yaml');\n  await runtime.start();\n}\n\nmain();\n`, 'utf-8');
+    await writeFile(join(projectDir, 'package.json'), JSON.stringify({
+        name,
+        version: '0.1.0',
+        type: 'module',
+        scripts: {
+            build: 'tsc',
+            start: 'node dist/index.js',
+            test: 'vitest run',
+        },
+        dependencies: {
+            nerva: '^0.1.0',
+        },
+        devDependencies: {
+            typescript: '^5.4.0',
+            vitest: '^1.6.0',
+            '@types/node': '^20.14.0',
+        },
+    }, null, 2) + '\n', 'utf-8');
+    await writeFile(join(projectDir, 'tsconfig.json'), JSON.stringify({
+        compilerOptions: {
+            strict: true,
+            target: 'ES2022',
+            module: 'ES2022',
+            moduleResolution: 'node16',
+            outDir: 'dist',
+            rootDir: 'src',
+            declaration: true,
+            esModuleInterop: true,
+            skipLibCheck: true,
+        },
+        include: ['src/**/*.ts'],
+        exclude: ['node_modules', 'dist'],
+    }, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Registers the `nerva new` command with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export function registerNewCommand(program) {
+    program
+        .command('new')
+        .description('Create a new Nerva project')
+        .argument('<name>', 'Project name')
+        .option('-l, --lang <language>', 'Project language (python or typescript)', 'python')
+        .action(async (name, options) => {
+        await executeNew(name, options.lang);
+    });
+}
+/**
+ * Executes the project scaffolding logic.
+ *
+ * @param name - Project name (used as directory name)
+ * @param lang - Target language
+ * @throws {Error} If the language is unsupported
+ */
+export async function executeNew(name, lang) {
+    if (lang !== 'python' && lang !== 'typescript') {
+        throw new Error(`Unsupported language: "${lang}". Use "python" or "typescript".`);
+    }
+    const projectDir = join(process.cwd(), name);
+    await ensureDir(projectDir);
+    // Write nerva.yaml
+    const config = buildDefaultConfig(name, lang);
+    await writeFile(join(projectDir, 'nerva.yaml'), serializeNervaConfig(config), 'utf-8');
+    // Scaffold language-specific files
+    if (lang === 'python') {
+        await scaffoldPython(projectDir, name);
+    }
+    else {
+        await scaffoldTypeScript(projectDir, name);
+    }
+    console.log(`Created project "${name}" with ${lang} template at ./${name}`);
+}
+//# sourceMappingURL=new.js.map

package/dist/commands/new.js.map

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

package/dist/commands/plugin.d.ts

@@ -0,0 +1,79 @@
+/**
+ * `nerva plugin` command group.
+ *
+ * Manages template plugins that extend `nerva generate` with custom
+ * component types. Plugins are stored in `.nerva/plugins/` and expose
+ * a `nerva-plugin.json` manifest.
+ */
+import { Command } from 'commander';
+/** A single template entry inside a plugin manifest. */
+export interface PluginTemplate {
+    type: string;
+    files: string[];
+}
+/** Schema of the `nerva-plugin.json` manifest file. */
+export interface PluginManifest {
+    name: string;
+    version: string;
+    templates: PluginTemplate[];
+}
+/** Summary of an installed plugin returned by `listPlugins`. */
+export interface InstalledPlugin {
+    name: string;
+    version: string;
+    types: string[];
+}
+/**
+ * Parses and validates a raw JSON string as a PluginManifest.
+ *
+ * @param raw - Raw JSON string from nerva-plugin.json
+ * @returns Validated manifest
+ * @throws {Error} If the JSON is malformed or required fields are missing
+ */
+export declare function parsePluginManifest(raw: string): PluginManifest;
+/**
+ * Returns the absolute path to the plugins directory for a project.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @returns Absolute path to `.nerva/plugins/`
+ */
+export declare function pluginsDir(projectDir: string): string;
+/**
+ * Installs a plugin from a local path or npm package name.
+ *
+ * For local paths: copies the directory into `.nerva/plugins/<name>`.
+ * For npm packages: runs `npm pack` in a temp dir, extracts, and copies.
+ *
+ * @param source - Local directory path or npm package name
+ * @param projectDir - Absolute path to the project root
+ * @returns The parsed manifest of the installed plugin
+ * @throws {Error} If the source has no valid manifest or the plugin is already installed
+ */
+export declare function installPlugin(source: string, projectDir: string): Promise<PluginManifest>;
+/**
+ * Lists all installed plugins by reading `.nerva/plugins/`.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @returns Array of installed plugin summaries
+ */
+export declare function listPlugins(projectDir: string): Promise<InstalledPlugin[]>;
+/**
+ * Removes an installed plugin by name.
+ *
+ * @param name - Plugin name to remove
+ * @param projectDir - Absolute path to the project root
+ * @throws {Error} If the plugin is not installed
+ */
+export declare function removePlugin(name: string, projectDir: string): Promise<void>;
+/**
+ * Registers the `nerva plugin` command group with the CLI program.
+ *
+ * Sub-commands:
+ * - `nerva plugin install <source>` — install from npm or local path
+ * - `nerva plugin list` — list installed plugins
+ * - `nerva plugin remove <name>` — remove an installed plugin
+ *
+ * @param program - The root commander program
+ */
+export declare function registerPluginCommand(program: Command): void;
+//# sourceMappingURL=plugin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/commands/plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC,wDAAwD;AACxD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,uDAAuD;AACvD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAgBD;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,cAAc,CAiC/D;AA0CD;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAErD;AAiBD;;;;;;;;;;GAUG;AACH,wBAAsB,aAAa,CACjC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,cAAc,CAAC,CAazB;AAsFD;;;;;GAKG;AACH,wBAAsB,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA0BhF;AA2BD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlF;AAMD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA4C5D"}

package/dist/commands/plugin.js

@@ -0,0 +1,319 @@
+/**
+ * `nerva plugin` command group.
+ *
+ * Manages template plugins that extend `nerva generate` with custom
+ * component types. Plugins are stored in `.nerva/plugins/` and expose
+ * a `nerva-plugin.json` manifest.
+ */
+import { mkdir, readFile, readdir, rm, cp } from 'node:fs/promises';
+import { join, resolve } from 'node:path';
+import { existsSync } from 'node:fs';
+import { execSync } from 'node:child_process';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Directory name where plugins are stored, relative to project root. */
+const PLUGINS_DIR = '.nerva/plugins';
+/** Name of the manifest file inside each plugin directory. */
+const MANIFEST_FILENAME = 'nerva-plugin.json';
+// ---------------------------------------------------------------------------
+// Manifest parsing
+// ---------------------------------------------------------------------------
+/**
+ * Parses and validates a raw JSON string as a PluginManifest.
+ *
+ * @param raw - Raw JSON string from nerva-plugin.json
+ * @returns Validated manifest
+ * @throws {Error} If the JSON is malformed or required fields are missing
+ */
+export function parsePluginManifest(raw) {
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        throw new Error('nerva-plugin.json contains invalid JSON');
+    }
+    if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+        throw new Error('nerva-plugin.json must be a JSON object');
+    }
+    const obj = parsed;
+    if (typeof obj['name'] !== 'string' || obj['name'].trim() === '') {
+        throw new Error('nerva-plugin.json: "name" must be a non-empty string');
+    }
+    if (typeof obj['version'] !== 'string' || obj['version'].trim() === '') {
+        throw new Error('nerva-plugin.json: "version" must be a non-empty string');
+    }
+    if (!Array.isArray(obj['templates'])) {
+        throw new Error('nerva-plugin.json: "templates" must be an array');
+    }
+    const templates = validateTemplates(obj['templates']);
+    return {
+        name: obj['name'],
+        version: obj['version'],
+        templates,
+    };
+}
+/**
+ * Validates the templates array from a plugin manifest.
+ *
+ * @param raw - Unvalidated templates array
+ * @returns Validated PluginTemplate array
+ * @throws {Error} If any entry is malformed
+ */
+function validateTemplates(raw) {
+    return raw.map((entry, index) => {
+        if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
+            throw new Error(`nerva-plugin.json: templates[${index}] must be an object`);
+        }
+        const item = entry;
+        if (typeof item['type'] !== 'string' || item['type'].trim() === '') {
+            throw new Error(`nerva-plugin.json: templates[${index}].type must be a non-empty string`);
+        }
+        if (!Array.isArray(item['files']) || item['files'].length === 0) {
+            throw new Error(`nerva-plugin.json: templates[${index}].files must be a non-empty array`);
+        }
+        const files = item['files'].map((f, fi) => {
+            if (typeof f !== 'string' || f.trim() === '') {
+                throw new Error(`nerva-plugin.json: templates[${index}].files[${fi}] must be a non-empty string`);
+            }
+            return f;
+        });
+        return { type: item['type'], files };
+    });
+}
+// ---------------------------------------------------------------------------
+// Plugin directory helpers
+// ---------------------------------------------------------------------------
+/**
+ * Returns the absolute path to the plugins directory for a project.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @returns Absolute path to `.nerva/plugins/`
+ */
+export function pluginsDir(projectDir) {
+    return join(projectDir, PLUGINS_DIR);
+}
+/**
+ * Returns the absolute path to a specific plugin's directory.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @param name - Plugin name
+ * @returns Absolute path to the plugin directory
+ */
+function pluginPath(projectDir, name) {
+    return join(pluginsDir(projectDir), name);
+}
+// ---------------------------------------------------------------------------
+// Install
+// ---------------------------------------------------------------------------
+/**
+ * Installs a plugin from a local path or npm package name.
+ *
+ * For local paths: copies the directory into `.nerva/plugins/<name>`.
+ * For npm packages: runs `npm pack` in a temp dir, extracts, and copies.
+ *
+ * @param source - Local directory path or npm package name
+ * @param projectDir - Absolute path to the project root
+ * @returns The parsed manifest of the installed plugin
+ * @throws {Error} If the source has no valid manifest or the plugin is already installed
+ */
+export async function installPlugin(source, projectDir) {
+    const resolvedSource = resolvePluginSource(source);
+    const manifest = await readManifestFrom(resolvedSource);
+    const dest = pluginPath(projectDir, manifest.name);
+    if (existsSync(dest)) {
+        throw new Error(`Plugin "${manifest.name}" is already installed. Remove it first to reinstall.`);
+    }
+    await mkdir(dest, { recursive: true });
+    await copyPluginFiles(resolvedSource, dest);
+    return manifest;
+}
+/**
+ * Resolves a source argument to an absolute local path.
+ *
+ * If the source looks like a local path (starts with `.`, `/`, or contains
+ * path separators), it is resolved against cwd. Otherwise it is treated as
+ * an npm package name and fetched via `npm pack`.
+ *
+ * @param source - CLI argument for plugin source
+ * @returns Absolute path to the plugin directory
+ */
+function resolvePluginSource(source) {
+    const isLocalPath = source.startsWith('.') || source.startsWith('/') || source.includes('/');
+    if (isLocalPath) {
+        return resolve(source);
+    }
+    return fetchNpmPackage(source);
+}
+/**
+ * Downloads an npm package using `npm pack` and extracts it to a temp directory.
+ *
+ * @param packageName - npm package name
+ * @returns Absolute path to the extracted package directory
+ * @throws {Error} If `npm pack` fails
+ */
+function fetchNpmPackage(packageName) {
+    const tmpDir = join(process.cwd(), '.nerva', '.tmp', `npm-${Date.now()}`);
+    try {
+        execSync(`mkdir -p "${tmpDir}" && cd "${tmpDir}" && npm pack "${packageName}" --silent 2>/dev/null`, {
+            stdio: 'pipe',
+        });
+        // npm pack creates a tarball — extract it
+        const tgzFiles = execSync(`ls "${tmpDir}"/*.tgz 2>/dev/null`, { encoding: 'utf-8' }).trim();
+        if (!tgzFiles) {
+            throw new Error(`Failed to download npm package "${packageName}"`);
+        }
+        const tgzPath = tgzFiles.split('\n')[0];
+        execSync(`cd "${tmpDir}" && tar xzf "${tgzPath}" --strip-components=1`, { stdio: 'pipe' });
+        return tmpDir;
+    }
+    catch (err) {
+        throw new Error(`Failed to install npm package "${packageName}": ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+/**
+ * Reads and parses the manifest from a plugin source directory.
+ *
+ * @param sourceDir - Absolute path to the plugin source
+ * @returns Parsed manifest
+ * @throws {Error} If the manifest file is missing or invalid
+ */
+async function readManifestFrom(sourceDir) {
+    const manifestPath = join(sourceDir, MANIFEST_FILENAME);
+    if (!existsSync(manifestPath)) {
+        throw new Error(`No ${MANIFEST_FILENAME} found in ${sourceDir}`);
+    }
+    const raw = await readFile(manifestPath, 'utf-8');
+    return parsePluginManifest(raw);
+}
+/**
+ * Copies all plugin files from source to destination.
+ *
+ * @param sourceDir - Source directory
+ * @param destDir - Destination directory
+ */
+async function copyPluginFiles(sourceDir, destDir) {
+    await cp(sourceDir, destDir, { recursive: true });
+}
+// ---------------------------------------------------------------------------
+// List
+// ---------------------------------------------------------------------------
+/**
+ * Lists all installed plugins by reading `.nerva/plugins/`.
+ *
+ * @param projectDir - Absolute path to the project root
+ * @returns Array of installed plugin summaries
+ */
+export async function listPlugins(projectDir) {
+    const dir = pluginsDir(projectDir);
+    if (!existsSync(dir)) {
+        return [];
+    }
+    const entries = await readdir(dir, { withFileTypes: true });
+    const plugins = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
+        }
+        const manifest = await readManifestSafe(join(dir, entry.name));
+        if (manifest) {
+            plugins.push({
+                name: manifest.name,
+                version: manifest.version,
+                types: manifest.templates.map((t) => t.type),
+            });
+        }
+    }
+    return plugins;
+}
+/**
+ * Reads a manifest from a plugin directory, returning null on failure.
+ *
+ * @param pluginDir - Absolute path to a plugin directory
+ * @returns Parsed manifest or null if unreadable
+ */
+async function readManifestSafe(pluginDir) {
+    const manifestPath = join(pluginDir, MANIFEST_FILENAME);
+    if (!existsSync(manifestPath)) {
+        return null;
+    }
+    try {
+        const raw = await readFile(manifestPath, 'utf-8');
+        return parsePluginManifest(raw);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Remove
+// ---------------------------------------------------------------------------
+/**
+ * Removes an installed plugin by name.
+ *
+ * @param name - Plugin name to remove
+ * @param projectDir - Absolute path to the project root
+ * @throws {Error} If the plugin is not installed
+ */
+export async function removePlugin(name, projectDir) {
+    const dest = pluginPath(projectDir, name);
+    if (!existsSync(dest)) {
+        throw new Error(`Plugin "${name}" is not installed`);
+    }
+    await rm(dest, { recursive: true, force: true });
+}
+// ---------------------------------------------------------------------------
+// Command registration
+// ---------------------------------------------------------------------------
+/**
+ * Registers the `nerva plugin` command group with the CLI program.
+ *
+ * Sub-commands:
+ * - `nerva plugin install <source>` — install from npm or local path
+ * - `nerva plugin list` — list installed plugins
+ * - `nerva plugin remove <name>` — remove an installed plugin
+ *
+ * @param program - The root commander program
+ */
+export function registerPluginCommand(program) {
+    const pluginCmd = program
+        .command('plugin')
+        .description('Manage template plugins for nerva generate');
+    pluginCmd
+        .command('install')
+        .description('Install a plugin from npm or a local path')
+        .argument('<source>', 'npm package name or local directory path')
+        .action(async (source) => {
+        const manifest = await installPlugin(source, process.cwd());
+        const types = manifest.templates.map((t) => t.type).join(', ');
+        console.log(`Installed plugin "${manifest.name}" v${manifest.version}`);
+        console.log(`Available types: ${types}`);
+    });
+    pluginCmd
+        .command('list')
+        .alias('ls')
+        .description('List installed plugins')
+        .action(async () => {
+        const plugins = await listPlugins(process.cwd());
+        if (plugins.length === 0) {
+            console.log('No plugins installed.');
+            return;
+        }
+        console.log(`\nInstalled plugins:\n`);
+        for (const plugin of plugins) {
+            console.log(`  ${plugin.name} (v${plugin.version})`);
+            console.log(`    types: ${plugin.types.join(', ')}`);
+        }
+        console.log('');
+    });
+    pluginCmd
+        .command('remove')
+        .description('Remove an installed plugin')
+        .argument('<name>', 'Plugin name to remove')
+        .action(async (name) => {
+        await removePlugin(name, process.cwd());
+        console.log(`Removed plugin "${name}"`);
+    });
+}
+//# sourceMappingURL=plugin.js.map

package/dist/commands/plugin.js.map

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

package/dist/commands/test.d.ts

@@ -0,0 +1,52 @@
+/**
+ * `nerva test` command.
+ *
+ * Detects the project language from nerva.yaml and runs the appropriate
+ * test runner (pytest for Python, vitest for TypeScript).
+ */
+import { Command } from 'commander';
+import { type ProjectLang } from '../config/nerva-yaml.js';
+/**
+ * Builds the full argument list for the test runner, including optional coverage flag.
+ *
+ * @param lang - Project language
+ * @param coverage - Whether to enable coverage reporting
+ * @returns Tuple of [command, args]
+ */
+export declare function buildTestCommand(lang: ProjectLang, coverage: boolean): {
+    cmd: string;
+    args: string[];
+};
+/**
+ * Detects the project language from nerva.yaml in the given directory.
+ *
+ * @param projectDir - Absolute path to project root
+ * @returns Detected project language
+ * @throws {Error} If nerva.yaml is missing or invalid
+ */
+export declare function detectLanguage(projectDir: string): Promise<ProjectLang>;
+/**
+ * Runs the test command as a child process and returns its exit code.
+ *
+ * @param projectDir - Working directory for the test runner
+ * @param cmd - Command to execute
+ * @param args - Arguments to pass
+ * @returns Exit code from the test runner (0 = success)
+ */
+export declare function runTestProcess(projectDir: string, cmd: string, args: string[]): Promise<number>;
+/**
+ * Executes the test command: detects language, runs the appropriate test runner,
+ * and prints a trace summary.
+ *
+ * @param projectDir - Absolute path to project root
+ * @param coverage - Whether to enable coverage
+ * @returns Exit code from the test runner
+ */
+export declare function executeTest(projectDir: string, coverage: boolean): Promise<number>;
+/**
+ * Registers the `nerva test` command with the CLI program.
+ *
+ * @param program - The root commander program
+ */
+export declare function registerTestCommand(program: Command): void;
+//# sourceMappingURL=test.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../../src/commands/test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAmB,KAAK,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAa5E;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,WAAW,EACjB,QAAQ,EAAE,OAAO,GAChB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAYjC;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAG7E;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAU1D"}