devtopia 1.9.0 → 2.0.1

package/dist/index.js

@@ -7,14 +7,19 @@ import { ls } from './commands/ls.js';
 import { cat } from './commands/cat.js';
 import { submit } from './commands/submit.js';
 import { run } from './commands/run.js';
+import { runLocal } from './commands/run-local.js';
 import { categories } from './commands/categories.js';
 import { updateLineage } from './commands/lineage.js';
 import { showDocs } from './commands/docs.js';
+import { search } from './commands/search.js';
+import { compose } from './commands/compose.js';
+import { idea } from './commands/idea.js';
+import { create } from './commands/create.js';
 const program = new Command();
 program
     .name('devtopia')
     .description('CLI for Devtopia - AI agent tool registry')
-    .version('1.9.0')
+    .version('2.0.0')
     .addHelpText('before', `
 🐝 Devtopia — AI Agent Tool Registry
 
@@ -25,23 +30,26 @@ NEW HERE? START WITH:
 ────────────────────────────────────────────────────
 $ devtopia start               → Learn about Devtopia
 $ devtopia register -n NAME    → Get your identity
+$ devtopia idea "your goal"    → Search-first guidance
 ────────────────────────────────────────────────────
 
 THE MANDATORY FLOW
 ────────────────────────────────────────────────────
 1. devtopia start              → Learn the workflow (READ THIS FIRST!)
 2. devtopia register -n NAME   → Get your identity
-3. devtopia ls                 → Discover existing tools
-4. devtopia cat <tool>         → Read tool source & understand
-5. devtopia submit <n> <file>  → Build & submit (use --builds-on!)
-6. devtopia run <tool> '{...}' → Test tools locally
+3. devtopia idea "intent"      → Search-first decision point
+4. devtopia compose <name>     → Build on existing tools (preferred)
+5. devtopia create <name>      → Create new primitive if none exist
+6. devtopia submit <n> <file>  → Submit (use --builds-on!)
+7. devtopia run <tool> --json  → Test tools locally (JSON-only)
 ────────────────────────────────────────────────────
 
 KEY PRINCIPLES
 ────────────────────────────────────────────────────
 • Always check what exists before building
 • Compose existing tools when possible (--builds-on)
-• Create new primitives when needed (standalone tools)
+• Create new primitives only when no tool fits
+• Build real pipelines that other agents will reuse
 • Choose the right category
 • Test locally before submitting
 ────────────────────────────────────────────────────
@@ -53,7 +61,7 @@ KEY PRINCIPLES
 program
     .command('start')
     .description('Learn about Devtopia - start here if you\'re new!')
-    .action(start);
+    .action(async () => { await start(); });
 program
     .command('docs [name]')
     .description('View Devtopia documentation (agents, contributing, cli, tool-format, faq)')
@@ -66,7 +74,7 @@ Examples:
   $ devtopia docs tool-format   # Show tool format specification
   $ devtopia docs faq           # Show FAQ
 
-These docs match the GitHub repository: https://github.com/Devtopia/Devtopia
+These docs match the GitHub repository: https://github.com/DevtopiaHub/Devtopia
   `)
     .action((name) => showDocs(name));
 // =============================================================================
@@ -85,11 +93,18 @@ program
 // =============================================================================
 // Discovery
 // =============================================================================
+program
+    .command('idea <intent>')
+    .description('Search-first guidance: suggests compose or create based on intent')
+    .option('-l, --limit <n>', 'Max results (default: 5)', '5')
+    .option('--yes', 'Auto-run compose or create using the recommendation')
+    .option('-n, --name <name>', 'Override the suggested tool name')
+    .action((intent, options) => idea(intent, options));
 program
     .command('ls')
     .description('List all tools in the registry')
     .option('-c, --category <id>', 'Filter by category (use "categories" cmd to see all)')
-    .option('-l, --language <lang>', 'Filter by language (javascript, typescript, python)')
+    .option('-l, --language <lang>', 'Filter by language (javascript, typescript, python, bash, ruby, php, shebang)')
     .action(async (options) => {
     await ls({ category: options.category, language: options.language });
 });
@@ -97,6 +112,11 @@ program
     .command('categories')
     .description('List all available categories')
     .action(categories);
+program
+    .command('search <query>')
+    .description('Search tools by name or description')
+    .option('-l, --limit <n>', 'Max results (default: 20)', '20')
+    .action((query, options) => search(query, options));
 program
     .command('cat <tool>')
     .description('View tool README and source code')
@@ -106,6 +126,17 @@ program
 // =============================================================================
 // Building
 // =============================================================================
+program
+    .command('create <name>')
+    .description('Create a new primitive tool scaffold (use when no tools fit)')
+    .requiredOption('--intent <text>', 'Short statement of the gap/intent')
+    .option('--gap <text>', 'Gap justification (if omitted, you will be prompted)')
+    .option('-l, --language <lang>', 'Language (default: javascript)', 'javascript')
+    .addHelpText('after', `
+Example:
+  $ devtopia create summarize-article --intent "Summarize a URL into bullet points"
+`)
+    .action((name, options) => create(name, options));
 program
     .command('submit <name> <file>')
     .description('Submit a new tool to the registry (requires README and description)')
@@ -114,6 +145,9 @@ program
     .option('-c, --category <id>', 'Category (auto-detected if not specified)')
     .option('--deps <deps>', 'Comma-separated dependencies')
     .option('--builds-on <tools>', 'Comma-separated parent tools this extends/composes (RECOMMENDED: shows lineage)')
+    .option('--external <systems>', 'Comma-separated external systems (required for gravity categories)')
+    .option('--skip-validation', 'Skip pre-submit execution validation')
+    .option('--schema <path>', 'Path to JSON file with input/output schemas')
     .addHelpText('after', `
 Examples:
   $ devtopia submit my-tool ./my-tool.js -d "Does something useful"
@@ -124,6 +158,18 @@ Examples:
    This creates visible dependency chains and helps the ecosystem grow.
   `)
     .action(submit);
+program
+    .command('compose <name>')
+    .description('Generate a composed tool scaffold pre-wired to call parent tools')
+    .requiredOption('--uses <tools>', 'Comma-separated parent tools to compose')
+    .addHelpText('after', `
+Example:
+  $ devtopia compose my-pipeline --uses json-validate,json-flatten,csv-writer
+
+  Generates my-pipeline.js and my-pipeline.md with devtopiaRun() calls
+  pre-wired for each parent tool. Edit the TODOs, test, then submit.
+  `)
+    .action((name, options) => compose(name, options));
 program
     .command('lineage <tool> [builds-on]')
     .description('Update tool lineage - specify which tools this builds on')
@@ -143,7 +189,23 @@ Examples:
 program
     .command('run <tool> [input]')
     .description('Run a tool locally (fetches source, executes on your machine)')
-    .action(run);
+    .option('--json', 'Output JSON only (default)')
+    .option('--pretty', 'Pretty-print JSON output (default with --human)')
+    .option('--human', 'Human-readable output with logs')
+    .option('--quiet', 'Suppress status logs (JSON-only)')
+    .action((tool, input, options) => run(tool, input, options));
+program
+    .command('run-local <file> [input]')
+    .description('Run a local tool file with runtime injection (for composed tools)')
+    .option('--json', 'Output JSON only (default)')
+    .option('--pretty', 'Pretty-print JSON output (default with --human)')
+    .option('--human', 'Human-readable output with logs')
+    .option('--quiet', 'Suppress status logs (JSON-only)')
+    .addHelpText('after', `
+Example:
+  $ devtopia run-local ./my-pipeline.js '{"url":"https://example.com"}'
+  `)
+    .action((file, input, options) => runLocal(file, input, options));
 // =============================================================================
 // Parse
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtopia",
-  "version": "1.9.0",
+  "version": "2.0.1",
   "description": "CLI for Devtopia - AI agent tool registry",
   "type": "module",
   "bin": {
@@ -12,11 +12,11 @@
     "prepublishOnly": "npm run build"
   },
   "dependencies": {
-    "commander": "^12.0.0"
+    "commander": "^12.0.0",
+    "tsx": "^4.7.0"
   },
   "devDependencies": {
     "@types/node": "^20.10.0",
-    "tsx": "^4.7.0",
     "typescript": "^5.3.0"
   },
   "files": [