@trikhub/cli 0.5.0 → 0.7.0

package/dist/commands/init.js

@@ -11,7 +11,6 @@ import ora from 'ora';
 import { input, select, confirm } from '@inquirer/prompts';
 import { loadDefaults, saveDefaults } from '../lib/storage.js';
 import { generateTypescriptProject } from '../templates/typescript.js';
-import { generatePythonProject } from '../templates/python.js';
 const CATEGORIES = [
     { value: 'utilities', label: 'Utilities' },
     { value: 'productivity', label: 'Productivity' },
@@ -108,6 +107,58 @@ export async function initCommand(languageArg) {
             message: 'Enable configuration (env vars)?',
             default: false,
         });
+        // v2 agent prompts
+        const agentMode = await select({
+            message: 'Agent mode:',
+            choices: [
+                { value: 'conversational', name: 'Conversational (multi-turn ReAct agent)' },
+                { value: 'tool', name: 'Tool (export native tools to main agent)' },
+            ],
+            default: 'conversational',
+        });
+        // Handoff description only for conversational mode
+        let handoffDescription = '';
+        if (agentMode === 'conversational') {
+            handoffDescription = await input({
+                message: 'Handoff description (how should the main agent describe this trik?):',
+                validate: (value) => {
+                    if (value.length < 10)
+                        return 'Description must be at least 10 characters';
+                    if (value.length > 500)
+                        return 'Description must be at most 500 characters';
+                    return true;
+                },
+            });
+        }
+        // Tool names for tool mode
+        let toolNames = [];
+        if (agentMode === 'tool') {
+            const toolNamesRaw = await input({
+                message: 'Tool names (comma-separated, camelCase, e.g. "getWeather, getForecast"):',
+                validate: (value) => {
+                    const names = value.split(',').map((t) => t.trim()).filter(Boolean);
+                    if (names.length === 0)
+                        return 'At least one tool name is required';
+                    for (const n of names) {
+                        if (!/^[a-z][a-zA-Z0-9]*$/.test(n)) {
+                            return `Invalid tool name "${n}": must be camelCase starting with a lowercase letter`;
+                        }
+                    }
+                    return true;
+                },
+            });
+            toolNames = toolNamesRaw.split(',').map((t) => t.trim()).filter(Boolean);
+        }
+        const domainTagsRaw = await input({
+            message: 'Domain tags (comma-separated, e.g. "content curation, article writing"):',
+            validate: (value) => {
+                const tags = value.split(',').map((t) => t.trim()).filter(Boolean);
+                if (tags.length === 0)
+                    return 'At least one domain tag is required';
+                return true;
+            },
+        });
+        const domainTags = domainTagsRaw.split(',').map((t) => t.trim()).filter(Boolean);
         // Path selection
         const pathChoice = await select({
             message: 'Where to create the trik?',
@@ -135,7 +186,7 @@ export async function initCommand(languageArg) {
         }
         console.log();
         spinner.start('Creating trik...');
-        // Generate files
+        // Build full config
         const config = {
             name,
             displayName,
@@ -145,39 +196,65 @@ export async function initCommand(languageArg) {
             category,
             enableStorage,
             enableConfig,
+            agentMode,
+            handoffDescription,
+            domainTags,
+            toolNames,
         };
-        const files = language === 'ts'
-            ? generateTypescriptProject(config)
-            : generatePythonProject(config);
-        // Write files
-        for (const file of files) {
-            const filePath = join(targetDir, file.path);
-            const dir = join(filePath, '..');
-            await mkdir(dir, { recursive: true });
-            await writeFile(filePath, file.content, 'utf-8');
+        // Only TypeScript is supported for now
+        if (language === 'py') {
+            spinner.stop();
+            console.log(chalk.yellow('\n  Python trik init is not yet supported. Use TypeScript for now.\n'));
+            return;
         }
-        // Save author defaults for next time
-        if (authorName || authorGithub) {
-            saveDefaults({
-                authorName: authorName || defaults.authorName,
-                authorGithub: authorGithub || defaults.authorGithub,
-            });
+        // Generate project files
+        const files = generateTypescriptProject(config);
+        // Create target directory and write all files
+        await mkdir(targetDir, { recursive: true });
+        for (const [relativePath, content] of Object.entries(files)) {
+            const filePath = join(targetDir, relativePath);
+            const fileDir = join(filePath, '..');
+            await mkdir(fileDir, { recursive: true });
+            await writeFile(filePath, content, 'utf-8');
+        }
+        spinner.succeed('Trik created');
+        // Install dependencies
+        const { execSync } = await import('node:child_process');
+        let packageManager = 'npm';
+        try {
+            execSync('pnpm --version', { stdio: 'ignore' });
+            packageManager = 'pnpm';
+        }
+        catch {
+            // pnpm not available, use npm
+        }
+        spinner.start(`Installing dependencies with ${packageManager}...`);
+        try {
+            execSync(`${packageManager} install`, { cwd: targetDir, stdio: 'ignore' });
+            spinner.succeed('Dependencies installed');
+        }
+        catch {
+            spinner.warn(`Failed to install dependencies. Run \`${packageManager} install\` manually.`);
         }
-        spinner.succeed(`Created trik: ${chalk.green(name)}`);
-        // Print next steps
+        // Save author defaults for reuse
+        saveDefaults({ authorName, authorGithub });
+        // Show success message
         console.log();
-        console.log(chalk.bold('  Next steps:'));
+        console.log(chalk.green.bold('  Your trik is ready!'));
         console.log();
-        console.log(chalk.dim(`  cd ${name}`));
-        if (language === 'ts') {
-            console.log(chalk.dim('  npm install'));
-            console.log(chalk.dim('  npm run build'));
-            console.log(chalk.dim('  npm test              # Test your trik locally'));
+        console.log(chalk.dim('  Next steps:'));
+        console.log(`    cd ${name}`);
+        if (agentMode === 'tool') {
+            console.log('    Edit src/agent.ts to implement your tool handlers');
         }
         else {
-            console.log(chalk.dim('  python test.py        # Test your trik locally'));
+            console.log('    Edit src/agent.ts to implement your agent logic');
+            console.log('    Add tools in src/tools/');
+            console.log('    Customize src/prompts/system.md');
         }
-        console.log(chalk.dim('  trik publish          # When ready to publish'));
+        console.log(`    ${packageManager === 'pnpm' ? 'pnpm' : 'npm run'} build`);
+        console.log('    trik lint .');
+        console.log('    trik publish');
         console.log();
     }
     catch (error) {

package/dist/commands/init.js.map

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

package/dist/commands/install.d.ts

@@ -4,11 +4,12 @@
  * Installs a trik and registers it in .trikhub/config.json.
  *
  * Workflow:
- * 1. Detect project type (node or python)
- * 2. Fetch trik info from TrikHub registry to get runtime
- * 3. If same runtime: use native package manager (npm/pip)
- * 4. If cross-language: download to .trikhub/triks/ directory
- * 5. Update .trikhub/config.json with the trik
+ * 1. Check TrikHub registry first (primary source)
+ * 2. If found on TrikHub:
+ *    - Same runtime: add git URL to package.json + npm install (stays in node_modules)
+ *    - Cross-language: download to .trikhub/triks/
+ * 3. If not on TrikHub: try npm as fallback for third-party packages
+ * 4. Update .trikhub/config.json with the trik
  */
 interface InstallOptions {
     version?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAiCH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA2gBD,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CA6If"}
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AA4DH,UAAU,cAAc;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AA0iBD,wBAAsB,cAAc,CAClC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAiJf"}

package/dist/commands/install.js

@@ -4,13 +4,14 @@
  * Installs a trik and registers it in .trikhub/config.json.
  *
  * Workflow:
- * 1. Detect project type (node or python)
- * 2. Fetch trik info from TrikHub registry to get runtime
- * 3. If same runtime: use native package manager (npm/pip)
- * 4. If cross-language: download to .trikhub/triks/ directory
- * 5. Update .trikhub/config.json with the trik
+ * 1. Check TrikHub registry first (primary source)
+ * 2. If found on TrikHub:
+ *    - Same runtime: add git URL to package.json + npm install (stays in node_modules)
+ *    - Cross-language: download to .trikhub/triks/
+ * 3. If not on TrikHub: try npm as fallback for third-party packages
+ * 4. Update .trikhub/config.json with the trik
  */
-import { existsSync, mkdirSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync } from 'node:fs';
 import { readFile, writeFile, mkdir } from 'node:fs/promises';
 import { join, dirname } from 'node:path';
 import { spawn } from 'node:child_process';
@@ -19,6 +20,32 @@ import ora from 'ora';
 import * as semver from 'semver';
 import { validateManifest } from '@trikhub/manifest';
 import { registry } from '../lib/registry.js';
+/**
+ * Get mock repo path for E2E testing.
+ * When TRIKHUB_MOCK_REPOS_FILE is set, looks up the local bare repo path.
+ */
+function getMockRepoPath(githubRepo) {
+    const mockReposFile = process.env.TRIKHUB_MOCK_REPOS_FILE;
+    if (!mockReposFile)
+        return null;
+    try {
+        const mapping = JSON.parse(readFileSync(mockReposFile, 'utf-8'));
+        return mapping[githubRepo] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get the clone URL for a repo - uses mock path in E2E tests
+ */
+function getCloneUrl(githubRepo) {
+    const mockPath = getMockRepoPath(githubRepo);
+    if (mockPath) {
+        return mockPath;
+    }
+    return `https://github.com/${githubRepo}.git`;
+}
 /**
  * Detect whether this is a Node.js or Python project
  */
@@ -158,8 +185,13 @@ async function addTrikToConfig(packageName, baseDir, trikhubVersion, runtime) {
 }
 /**
  * Verify that a GitHub tag points to the expected commit SHA
+ * Can be skipped with TRIKHUB_SKIP_TAG_CHECK=true (for E2E testing with mock repos)
  */
 async function verifyGitHubTagSha(githubRepo, gitTag, expectedSha) {
+    // Skip verification in test mode
+    if (process.env.TRIKHUB_SKIP_TAG_CHECK === 'true') {
+        return { valid: true };
+    }
     try {
         // Use GitHub API to get the tag reference
         const response = await fetch(`https://api.github.com/repos/${githubRepo}/git/refs/tags/${gitTag}`);
@@ -203,6 +235,16 @@ async function addToPackageJson(packageName, githubRepo, gitTag, baseDir) {
     pkg.dependencies[packageName] = `github:${githubRepo}#${gitTag}`;
     await writeFile(packageJsonPath, JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
 }
+/**
+ * Remove a package from node_modules to force fresh install
+ */
+async function removeFromNodeModules(packageName, baseDir) {
+    const packagePath = join(baseDir, 'node_modules', ...packageName.split('/'));
+    if (existsSync(packagePath)) {
+        const { rm } = await import('node:fs/promises');
+        await rm(packagePath, { recursive: true, force: true });
+    }
+}
 /**
  * Try to install from npm registry
  */
@@ -237,7 +279,8 @@ async function downloadToTriksDirectory(packageName, githubRepo, gitTag, baseDir
     }
     // Clone the repository at the specific tag
     spinner.text = `Downloading ${chalk.cyan(packageName)}...`;
-    const cloneResult = await runCommand('git', ['clone', '--depth', '1', '--branch', gitTag, `https://github.com/${githubRepo}.git`, trikDir], baseDir, { silent: true });
+    const cloneUrl = getCloneUrl(githubRepo);
+    const cloneResult = await runCommand('git', ['clone', '--depth', '1', '--branch', gitTag, cloneUrl, trikDir], baseDir, { silent: true });
     if (cloneResult.code !== 0) {
         return { success: false, trikPath: trikDir };
     }
@@ -246,7 +289,8 @@ async function downloadToTriksDirectory(packageName, githubRepo, gitTag, baseDir
     return { success: true, trikPath: trikDir };
 }
 /**
- * Install from TrikHub registry using git URLs
+ * Install a JS trik from TrikHub registry using git URLs in package.json.
+ * This keeps JS triks in node_modules where they belong.
  */
 async function installFromTrikhub(packageName, requestedVersion, baseDir, pm, spinner) {
     // Fetch trik info from TrikHub registry
@@ -298,13 +342,31 @@ async function installFromTrikhub(packageName, requestedVersion, baseDir, pm, sp
         console.log(chalk.red('\nThis could indicate tampering. Aborting installation.'));
         return { success: false };
     }
-    // Add to package.json using git URL format
-    spinner.text = `Adding ${chalk.cyan(packageName)}@${versionToInstall} to package.json...`;
-    await addToPackageJson(packageName, trikInfo.githubRepo, versionInfo.gitTag, baseDir);
-    // Run package manager install
-    // Use --prefix to explicitly set install directory (npm can ignore cwd in some contexts)
+    // IMPORTANT: Remove existing package from node_modules to force fresh install
+    // This fixes the issue where npm caches git dependencies
+    spinner.text = `Removing existing ${chalk.cyan(packageName)} from node_modules...`;
+    await removeFromNodeModules(packageName, baseDir);
+    // Install directly using the git URL to bypass npm cache
+    // This is more reliable than updating package.json + npm install
+    // Check for mock repo path (E2E testing) or use GitHub URL
+    const mockPath = getMockRepoPath(trikInfo.githubRepo);
+    const gitUrl = mockPath
+        ? `git+file://${mockPath}#${versionInfo.gitTag}`
+        : `github:${trikInfo.githubRepo}#${versionInfo.gitTag}`;
     spinner.text = `Installing ${chalk.cyan(packageName)}@${versionToInstall}...`;
-    const installArgs = pm === 'npm' ? ['install', '--prefix', baseDir] : ['install'];
+    let installArgs;
+    if (pm === 'npm') {
+        // npm install <package-name>@<git-url> --prefix <dir>
+        installArgs = ['install', '--prefix', baseDir, `${packageName}@${gitUrl}`];
+    }
+    else if (pm === 'pnpm') {
+        // pnpm add <package-name>@<git-url>
+        installArgs = ['add', `${packageName}@${gitUrl}`];
+    }
+    else {
+        // yarn add <package-name>@<git-url>
+        installArgs = ['add', `${packageName}@${gitUrl}`];
+    }
     const installResult = await runCommand(pm, installArgs, baseDir, { silent: true });
     if (installResult.code !== 0) {
         spinner.fail(`Failed to install ${packageName}`);
@@ -317,9 +379,9 @@ async function installFromTrikhub(packageName, requestedVersion, baseDir, pm, sp
 }
 /**
  * Install a cross-language trik from TrikHub registry.
- * Downloads to .trikhub/triks/ instead of using npm.
+ * Downloads to .trikhub/triks/ directory for non-JS triks in JS projects.
  */
-async function installCrossLanguageFromTrikhub(packageName, requestedVersion, baseDir, spinner) {
+async function installFromTrikhubRegistry(packageName, requestedVersion, baseDir, spinner) {
     // Fetch trik info from TrikHub registry
     spinner.text = `Fetching ${chalk.cyan(packageName)} from TrikHub registry...`;
     const trikInfo = await registry.getTrik(packageName);
@@ -433,45 +495,66 @@ export async function installCommand(trikInput, options) {
         let packageName = trikInput;
         let versionSpec = options.version;
         // Handle @scope/name@version format
+        // For scoped packages (@scope/name@version), the version @ comes after the /
         const atIndex = trikInput.lastIndexOf('@');
-        if (atIndex > 0 && !trikInput.startsWith('@', atIndex)) {
+        const slashIndex = trikInput.indexOf('/');
+        const isVersionSuffix = atIndex > 0 && (!trikInput.startsWith('@') || atIndex > slashIndex);
+        if (isVersionSuffix) {
             packageName = trikInput.substring(0, atIndex);
             versionSpec = versionSpec ?? trikInput.substring(atIndex + 1);
         }
-        // First, check TrikHub registry to get runtime info
+        // First, check TrikHub registry - this is the primary source for triks
         spinner.start(`Checking ${chalk.cyan(packageName)} on TrikHub registry...`);
         const trikInfo = await registry.getTrik(packageName);
-        // Get runtime from latest version if available
-        let trikRuntime = 'node'; // default
-        if (trikInfo && trikInfo.versions.length > 0) {
+        if (trikInfo) {
+            // Found on TrikHub registry
+            let trikRuntime = 'node';
             const latestVersion = trikInfo.versions.find(v => v.version === trikInfo.latestVersion);
             if (latestVersion?.runtime) {
                 trikRuntime = latestVersion.runtime;
             }
-        }
-        const isCrossLanguage = projectType !== trikRuntime;
-        if (isCrossLanguage && trikInfo) {
-            // Cross-language installation: download to .trikhub/triks/
-            spinner.info(`Cross-language trik detected: ${chalk.cyan(trikRuntime)} trik in ${chalk.cyan(projectType)} project`);
-            spinner.start(`Installing ${chalk.cyan(packageName)} to .trikhub/triks/...`);
-            const crossResult = await installCrossLanguageFromTrikhub(packageName, versionSpec, baseDir, spinner);
-            if (crossResult.success) {
-                // Add to config with runtime for cross-language uninstall
-                await addTrikToConfig(packageName, baseDir, crossResult.version, trikRuntime);
-                spinner.succeed(`Installed ${chalk.green(packageName)}@${crossResult.version} (${trikRuntime} runtime)`);
-                console.log();
-                console.log(chalk.dim(`  Downloaded to: .trikhub/triks/${packageName}`));
-                console.log(chalk.dim(`  Registered in: .trikhub/config.json`));
-                console.log();
-                console.log(chalk.dim('The trik will be available via the cross-language worker.'));
+            const isCrossLanguage = projectType !== trikRuntime;
+            if (isCrossLanguage) {
+                // Cross-language: download to .trikhub/triks/
+                spinner.info(`Cross-language trik: ${chalk.cyan(trikRuntime)} trik in ${chalk.cyan(projectType)} project`);
+                spinner.start(`Installing ${chalk.cyan(packageName)} to .trikhub/triks/...`);
+                const trikhubResult = await installFromTrikhubRegistry(packageName, versionSpec, baseDir, spinner);
+                if (trikhubResult.success) {
+                    await addTrikToConfig(packageName, baseDir, trikhubResult.version, trikRuntime);
+                    spinner.succeed(`Installed ${chalk.green(packageName)}@${trikhubResult.version} from TrikHub`);
+                    console.log();
+                    console.log(chalk.dim(`  Downloaded to: .trikhub/triks/${packageName}`));
+                    console.log(chalk.dim(`  Registered in: .trikhub/config.json`));
+                    console.log();
+                    console.log(chalk.dim('The trik will run via the cross-language worker.'));
+                }
+                else {
+                    spinner.fail(`Failed to install ${chalk.red(packageName)}`);
+                    process.exit(1);
+                }
             }
             else {
-                spinner.fail(`Failed to install ${chalk.red(packageName)}`);
-                process.exit(1);
+                // Same language (JS trik in JS project): use git URL in package.json
+                spinner.info(`Found ${chalk.cyan(packageName)} on TrikHub registry`);
+                const pm = detectPackageManager(baseDir);
+                const trikhubResult = await installFromTrikhub(packageName, versionSpec, baseDir, pm, spinner);
+                if (trikhubResult.success) {
+                    await addTrikToConfig(packageName, baseDir, trikhubResult.version);
+                    spinner.succeed(`Installed ${chalk.green(packageName)}@${trikhubResult.version} from TrikHub`);
+                    console.log();
+                    console.log(chalk.dim(`  Added to: package.json`));
+                    console.log(chalk.dim(`  Registered in: .trikhub/config.json`));
+                    console.log();
+                    console.log(chalk.dim('The trik will be available to your AI agent.'));
+                }
+                else {
+                    spinner.fail(`Failed to install ${chalk.red(packageName)}`);
+                    process.exit(1);
+                }
             }
         }
         else {
-            // Same-language installation: use native package manager
+            // Not on TrikHub registry - try npm as fallback for third-party packages
             if (projectType === 'node') {
                 // Ensure node_modules exists
                 const nodeModulesPath = join(baseDir, 'node_modules');
@@ -480,53 +563,35 @@ export async function installCommand(trikInput, options) {
                 }
                 // Detect package manager
                 const pm = detectPackageManager(baseDir);
+                spinner.info(`Not found on TrikHub, trying npm...`);
                 spinner.info(`Using ${chalk.cyan(pm)} as package manager`);
                 const packageSpec = versionSpec ? `${packageName}@${versionSpec}` : packageName;
-                // First, try npm registry
+                // Try npm registry
                 spinner.start(`Looking for ${chalk.cyan(packageSpec)} on npm...`);
                 const npmResult = await tryNpmInstall(pm, packageSpec, baseDir);
-                let installed = false;
-                let installedVersion;
                 if (npmResult.success) {
                     spinner.succeed(`Installed ${chalk.green(packageName)} from npm`);
-                    installed = true;
-                }
-                else if (npmResult.notFound) {
-                    // Not on npm, try TrikHub registry
-                    spinner.text = `Not found on npm, checking TrikHub registry...`;
-                    const trikhubResult = await installFromTrikhub(packageName, versionSpec, baseDir, pm, spinner);
-                    if (trikhubResult.success) {
-                        spinner.succeed(`Installed ${chalk.green(packageName)}@${trikhubResult.version} from TrikHub`);
-                        installed = true;
-                        installedVersion = trikhubResult.version;
+                    // Check if the installed package is a trik and register it
+                    spinner.start('Checking if package is a trik...');
+                    const packagePath = join(baseDir, 'node_modules', ...packageName.split('/'));
+                    if (await isTrikPackage(packagePath)) {
+                        await addTrikToConfig(packageName, baseDir);
+                        spinner.succeed(`Registered ${chalk.green(packageName)} as a trik`);
+                        console.log();
+                        console.log(chalk.dim(`  Added to: package.json`));
+                        console.log(chalk.dim(`  Registered in: .trikhub/config.json`));
+                        console.log();
+                        console.log(chalk.dim('The trik will be available to your AI agent.'));
                     }
                     else {
-                        spinner.fail(`${chalk.red(packageName)} not found on npm or TrikHub registry`);
-                        process.exit(1);
+                        spinner.info(`${chalk.yellow(packageName)} installed but is not a trik (no manifest.json)`);
+                        console.log(chalk.dim('\nThe package was added to your dependencies.'));
                     }
                 }
                 else {
-                    // npm failed for other reasons
-                    spinner.fail(`Failed to install ${chalk.red(packageName)}`);
+                    spinner.fail(`${chalk.red(packageName)} not found on TrikHub or npm`);
                     process.exit(1);
                 }
-                // Check if the installed package is a trik and register it
-                spinner.start('Checking if package is a trik...');
-                const packagePath = join(baseDir, 'node_modules', ...packageName.split('/'));
-                if (await isTrikPackage(packagePath)) {
-                    // Pass version for TrikHub packages (for sync/upgrade tracking)
-                    await addTrikToConfig(packageName, baseDir, installedVersion);
-                    spinner.succeed(`Registered ${chalk.green(packageName)} as a trik`);
-                    console.log();
-                    console.log(chalk.dim(`  Added to: package.json`));
-                    console.log(chalk.dim(`  Registered in: .trikhub/config.json`));
-                    console.log();
-                    console.log(chalk.dim('The trik will be available to your AI agent.'));
-                }
-                else {
-                    spinner.info(`${chalk.yellow(packageName)} installed but is not a trik (no manifest.json)`);
-                    console.log(chalk.dim('\nThe package was added to your dependencies.'));
-                }
             }
             else {
                 // Python project - not yet implemented