@arcteninc/core 0.0.59 → 0.0.60

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arcteninc/core",
-  "version": "0.0.59",
+  "version": "0.0.60",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.mjs",
@@ -20,13 +20,13 @@
   },
   "sideEffects": false,
   "bin": {
-    "arcten-extract-types": "./scripts/cli-extract-types-auto.js",
-    "arcten-update-core": "./scripts/update-core.js"
+    "arcten": "./scripts/arcten-cli.js"
   },
   "files": [
     "dist",
     "scripts/cli-extract-types-auto.ts",
     "scripts/cli-extract-types-auto.js",
+    "scripts/arcten-cli.js",
     "scripts/postinstall-check-version.js",
     "scripts/update-core.js"
   ],

package/scripts/arcten-cli.js

@@ -0,0 +1,132 @@
+#!/usr/bin/env node
+/**
+ * Arcten CLI - Unified command interface
+ * Usage: arcten <command> [options]
+ * 
+ * Commands:
+ *   extract-types, tools  Extract tool metadata from your project
+ *   update                Update @arcteninc/core to latest version
+ *   help                  Show help message
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const commands = {
+    'extract-types': () => require('./cli-extract-types-auto.js'),
+    'tools': () => require('./cli-extract-types-auto.js'), // Alias
+    'update': () => require('./update-core.js'),
+    'help': showHelp,
+    '--help': showHelp,
+    '-h': showHelp,
+};
+
+function showHelp() {
+    console.log(`
+📦 Arcten CLI
+
+Usage: arcten <command> [options]
+
+Commands:
+  extract-types, tools    Extract tool metadata from your project
+                          Alias: arcten tools
+  
+  update                  Update @arcteninc/core to latest version
+                          Updates package.json and shows next steps
+  
+  help                    Show this help message
+
+Examples:
+  arcten tools            Extract tool types (same as arcten extract-types)
+  arcten update           Update @arcteninc/core to latest version
+  arcten help             Show help
+
+For more information, visit https://github.com/arcteninc/core
+`);
+    process.exit(0);
+}
+
+function main() {
+    const args = process.argv.slice(2);
+
+    if (args.length === 0) {
+        showHelp();
+        return;
+    }
+
+    const command = args[0];
+    const commandArgs = args.slice(1);
+
+    if (!commands[command]) {
+        console.error(`❌ Unknown command: ${command}`);
+        console.error(`\nRun 'arcten help' for available commands`);
+        process.exit(1);
+    }
+
+    try {
+        const commandHandler = commands[command];
+        if (typeof commandHandler === 'function' && commandHandler !== showHelp) {
+            // For commands that are modules, we need to handle them differently
+            // Since they're designed to run as standalone scripts, we'll spawn them
+            let scriptPath;
+            let runner = 'node';
+
+            if (command === 'update') {
+                scriptPath = path.join(__dirname, 'update-core.js');
+            } else {
+                // For extract-types/tools, try .js first, fallback to .ts with bun
+                const jsPath = path.join(__dirname, 'cli-extract-types-auto.js');
+                const tsPath = path.join(__dirname, 'cli-extract-types-auto.ts');
+
+                if (fs.existsSync(jsPath)) {
+                    scriptPath = jsPath;
+                } else if (fs.existsSync(tsPath)) {
+                    scriptPath = tsPath;
+                    runner = 'bun'; // Use bun for TypeScript files
+                } else {
+                    console.error(`❌ Script not found: ${jsPath} or ${tsPath}`);
+                    process.exit(1);
+                }
+            }
+
+            if (!fs.existsSync(scriptPath)) {
+                console.error(`❌ Script not found: ${scriptPath}`);
+                process.exit(1);
+            }
+
+            // Spawn the script with remaining args
+            const child = spawn(runner, [scriptPath, ...commandArgs], {
+                stdio: 'inherit',
+                cwd: process.cwd(),
+                shell: true // Use shell to find bun/node in PATH
+            });
+
+            child.on('error', (error) => {
+                console.error(`❌ Failed to run command:`, error.message);
+                if (runner === 'bun' && error.code === 'ENOENT') {
+                    console.error(`\n💡 Bun not found. Install it: https://bun.sh`);
+                    console.error(`   Or ensure cli-extract-types-auto.js is compiled`);
+                }
+                process.exit(1);
+            });
+
+            child.on('exit', (code) => {
+                process.exit(code || 0);
+            });
+        } else {
+            // For help command
+            commandHandler();
+        }
+    } catch (error) {
+        console.error(`❌ Error running command:`, error.message);
+        process.exit(1);
+    }
+}
+
+if (require.main === module) {
+    main();
+}
+
+module.exports = { main };
+

package/scripts/cli-extract-types-auto.ts

@@ -83,7 +83,6 @@ async function findToolUsageFiles(projectRoot: string): Promise<string[]> {
     ignore: ['**/node_modules/**', '**/dist/**', '**/.next/**', '**/build/**'],
   });
 
-  console.log(`📂 Found ${files.length} TypeScript files to scan`);
   return files;
 }
 
@@ -1382,10 +1381,11 @@ async function extractFunctionMetadata(
  * Main function
  */
 async function autoDiscoverAndExtract(projectRoot: string, outputPath: string) {
-  console.log(`\n🔍 Auto-discovering tools in: ${projectRoot}\n`);
+  console.log(`\n🔍 Discovering tools in your project...\n`);
 
   // Find all TypeScript files
   const files = await findToolUsageFiles(projectRoot);
+  console.log(`📂 Scanning ${files.length} TypeScript file${files.length !== 1 ? 's' : ''}...`);
 
   // Read tsconfig
   const configPath = ts.findConfigFile(projectRoot, ts.sys.fileExists, 'tsconfig.json');
@@ -1420,19 +1420,34 @@ async function autoDiscoverAndExtract(projectRoot: string, outputPath: string) {
     }
   }
 
-  console.log(`✓ Found ${allToolUsages.length} usage site(s) with ${allToolNames.size} unique tool(s)`);
-  allToolUsages.forEach(usage => {
-    console.log(`  - ${usage.component} in ${path.relative(projectRoot, usage.file)}`);
-    console.log(`    Tools: ${Array.from(usage.toolNames).join(', ')}`);
+  if (allToolUsages.length === 0) {
+    console.log(`\n⚠️  No tool usages found in ArctenAgent or useAgent components`);
+    console.log(`\n💡 Make sure you're using tools like this:`);
+    console.log(`   <ArctenAgent safeTools={[getLocation, resetPassword]} />`);
+    console.log(`   or`);
+    console.log(`   useAgent({ safeTools: [getLocation, resetPassword] })\n`);
+    return;
+  }
+
+  console.log(`\n✨ Found ${allToolUsages.length} usage site${allToolUsages.length !== 1 ? 's' : ''} with ${allToolNames.size} unique tool${allToolNames.size !== 1 ? 's' : ''}:`);
+  allToolUsages.forEach((usage, idx) => {
+    const relativePath = path.relative(projectRoot, usage.file);
+    const tools = Array.from(usage.toolNames);
+    console.log(`\n   ${idx + 1}. ${usage.component} in ${relativePath}`);
+    console.log(`      Tools: ${tools.map(t => `\x1b[36m${t}\x1b[0m`).join(', ')}`);
   });
 
   // Extract metadata for discovered tools
-  console.log(`\n📝 Extracting types for discovered tools...\n`);
+  console.log(`\n📝 Extracting type metadata...\n`);
 
   const functionsMap: Record<string, FunctionMetadata> = {};
   const discoveredFrom: string[] = [];
 
-  for (const toolName of allToolNames) {
+  const toolNamesArray = Array.from(allToolNames);
+  let successCount = 0;
+  let warningCount = 0;
+
+  for (const toolName of toolNamesArray) {
     let found = false;
 
     // Search in all files for the definition
@@ -1445,8 +1460,10 @@ async function autoDiscoverAndExtract(projectRoot: string, outputPath: string) {
           if (metadata) {
             functionsMap[toolName] = metadata;
             discoveredFrom.push(path.relative(projectRoot, result.sourceFile.fileName));
-            console.log(`  ✓ ${toolName} (from ${path.relative(projectRoot, result.sourceFile.fileName)})`);
+            const relativePath = path.relative(projectRoot, result.sourceFile.fileName);
+            console.log(`   ✓ \x1b[32m${toolName}\x1b[0m \x1b[90m(${relativePath})\x1b[0m`);
             found = true;
+            successCount++;
             break;
           }
         }
@@ -1454,7 +1471,8 @@ async function autoDiscoverAndExtract(projectRoot: string, outputPath: string) {
     }
 
     if (!found) {
-      console.log(`  ⚠ ${toolName} (definition not found)`);
+      console.log(`   ⚠ \x1b[33m${toolName}\x1b[0m \x1b[90m(definition not found)\x1b[0m`);
+      warningCount++;
     }
   }
 
@@ -1505,11 +1523,24 @@ export const toolMetadata = ${JSON.stringify(output, null, 2)} as const;
 `;
 
   fs.writeFileSync(outputPath, tsContent);
-  console.log(`\n✅ Generated metadata for ${Object.keys(functionsMap).length} tool(s)`);
-  console.log(`📁 Output: ${outputPath}`);
-  console.log(`\n💡 Usage in your component:`);
-  console.log(`   import { toolMetadata } from './.arcten/tool-metadata';`);
-  console.log(`   useAgent({ tools: [...], toolMetadata: toolMetadata.functions })\n`);
+  
+  const relativeOutput = path.relative(projectRoot, outputPath);
+  
+  console.log(`\n${'='.repeat(60)}`);
+  if (successCount > 0) {
+    console.log(`✅ Successfully extracted ${successCount} tool${successCount !== 1 ? 's' : ''}`);
+  }
+  if (warningCount > 0) {
+    console.log(`⚠️  ${warningCount} tool${warningCount !== 1 ? 's' : ''} not found (check function names)`);
+  }
+  console.log(`📁 Output: \x1b[36m${relativeOutput}\x1b[0m`);
+  console.log(`${'='.repeat(60)}\n`);
+  
+  if (successCount > 0) {
+    console.log(`💡 Usage in your component:`);
+    console.log(`   import { toolMetadata } from './.arcten/tool-metadata';`);
+    console.log(`   useAgent({ tools: [...], toolMetadata: toolMetadata.functions })\n`);
+  }
 }
 
 // CLI

package/scripts/postinstall-check-version.js

@@ -137,7 +137,7 @@ function main() {
       console.log(`   Consider updating to '^${latestVersion}' in package.json`);
       console.log(`   Then run 'npm install' to get the latest version`);
     }
-    console.log(`   Or use: npx arcten-update-core`);
+    console.log(`   Or use: \x1b[36mnpx arcten update\x1b[0m`);
   }
   
   // Restore original directory

package/scripts/update-core.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 /**
  * Manual update command for @arcteninc/core
- * Usage: npx arcten-update-core
+ * Usage: arcten update
  * 
  * This allows users to explicitly update their package.json
  */
@@ -64,8 +64,7 @@ function updateVersion(packageJsonPath, packageJson, latestVersion) {
   
   if (updated) {
     fs.writeFileSync(packageJsonPath, JSON.stringify(packageJson, null, 2) + '\n');
-    console.log(`✅ Updated @arcteninc/core to ^${latestVersion} in package.json`);
-    console.log(`   Run 'npm install' to install the latest version`);
+    console.log(`✅ Updated to \x1b[32m^${latestVersion}\x1b[0m in package.json\n`);
     return true;
   }
   
@@ -102,18 +101,18 @@ function main() {
   const current = currentVersionMatch[1];
   
   if (current === latestVersion) {
-    console.log(`✅ Already on latest version: ${latestVersion}`);
+    console.log(`\n✅ Already on latest version: \x1b[32m${latestVersion}\x1b[0m\n`);
     return;
   }
   
-  console.log(`📦 Updating @arcteninc/core:`);
-  console.log(`   Current: ${current}`);
-  console.log(`   Latest:  ${latestVersion}`);
+  console.log(`\n📦 Updating @arcteninc/core\n`);
+  console.log(`   Current: \x1b[33m${current}\x1b[0m`);
+  console.log(`   Latest:  \x1b[32m${latestVersion}\x1b[0m\n`);
   
   if (updateVersion(packageJsonPath, packageJson, latestVersion)) {
-    console.log(`\n💡 Next steps:`);
+    console.log(`💡 Next steps:`);
     console.log(`   1. Review the changes in package.json`);
-    console.log(`   2. Run 'npm install' to install the update`);
+    console.log(`   2. Run \x1b[36mnpm install\x1b[0m to install the update\n`);
   }
 }