devtopia 1.7.0 → 1.8.2

package/README.md

@@ -182,9 +182,9 @@ When submitting, tools are auto-categorized or you can specify:
 
 ## Links
 
-- **Registry:** https://aiq.up.railway.app
-- **API Docs:** https://aiq.up.railway.app/docs
-- **All Tools:** https://aiq.up.railway.app/tools
+- **Registry:** https://devtopia.net
+- **API Docs:** https://devtopia.net/docs
+- **All Tools:** https://devtopia.net/tools
 
 ---
 

package/dist/commands/lineage.d.ts

@@ -0,0 +1 @@
+export declare function updateLineage(toolName: string, buildsOn?: string): Promise<void>;

package/dist/commands/lineage.js

@@ -0,0 +1,47 @@
+import { API_BASE } from '../config.js';
+import { loadIdentity, hasIdentity } from '../identity.js';
+export async function updateLineage(toolName, buildsOn) {
+    if (!hasIdentity()) {
+        console.log(`\n❌ Not registered yet.`);
+        console.log(`   Run: devtopia register -n YOUR_NAME\n`);
+        process.exit(1);
+    }
+    const identity = loadIdentity();
+    if (!identity) {
+        console.log(`\n❌ Could not read identity.\n`);
+        process.exit(1);
+    }
+    // Parse builds_on
+    const buildsOnArray = buildsOn
+        ? buildsOn.split(',').map(t => t.trim()).filter(Boolean)
+        : [];
+    try {
+        const res = await fetch(`${API_BASE}/api/tools/${toolName}/lineage`, {
+            method: 'PATCH',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                builds_on: buildsOnArray.length > 0 ? buildsOnArray : null,
+                tripcode: identity.tripcode,
+            }),
+        });
+        const data = await res.json();
+        if (!res.ok) {
+            console.log(`\n❌ ${data.error}\n`);
+            process.exit(1);
+        }
+        console.log(`\n✅ Lineage updated successfully!`);
+        console.log(`\n   Tool:     /${toolName}`);
+        if (buildsOnArray.length > 0) {
+            console.log(`   Builds on: ${buildsOnArray.join(', ')}`);
+        }
+        else {
+            console.log(`   Builds on: (none - lineage cleared)`);
+        }
+        console.log(`\n   View lineage:`);
+        console.log(`   $ devtopia cat ${toolName}\n`);
+    }
+    catch (err) {
+        console.log(`\n❌ Could not connect to server at ${API_BASE}\n`);
+        process.exit(1);
+    }
+}

package/dist/commands/submit.js

@@ -1,5 +1,6 @@
 import { readFileSync, existsSync } from 'fs';
 import { extname, resolve, dirname, join } from 'path';
+import { createInterface } from 'readline';
 import { API_BASE } from '../config.js';
 import { loadIdentity, hasIdentity } from '../identity.js';
 const LANG_MAP = {
@@ -362,9 +363,54 @@ export async function submit(name, file, options) {
         console.log();
         process.exit(1);
     }
+    // Auto-detect if not provided
     if (!category) {
         category = detectCategory(description, source);
     }
+    // Prompt for category confirmation/selection if not provided via CLI
+    if (!options.category && process.stdin.isTTY) {
+        const rl = createInterface({
+            input: process.stdin,
+            output: process.stdout
+        });
+        const detectedCat = CATEGORIES.find(c => c.id === category);
+        console.log(`\n📁 Category Selection`);
+        console.log(`   Auto-detected: ${detectedCat?.name || category} (${category})`);
+        console.log(`\n   Common categories:`);
+        // Show most common/relevant categories
+        const commonCategories = [
+            'api', 'json', 'data', 'text', 'web', 'crypto', 'file',
+            'array', 'validate', 'util', 'other'
+        ];
+        for (const catId of commonCategories) {
+            const cat = CATEGORIES.find(c => c.id === catId);
+            if (cat) {
+                const marker = cat.id === category ? ' ← detected' : '';
+                console.log(`   ${cat.id.padEnd(12)} ${cat.name}${marker}`);
+            }
+        }
+        console.log(`\n   (Use 'devtopia categories' to see all categories)`);
+        console.log(`\n   Press Enter to use detected category, or type a category ID:`);
+        const answer = await new Promise((resolve) => {
+            rl.question(`   Category [${category}]: `, (ans) => {
+                rl.close();
+                resolve(ans.trim());
+            });
+        });
+        if (answer) {
+            const selectedCat = CATEGORIES.find(c => c.id === answer.toLowerCase());
+            if (selectedCat) {
+                category = selectedCat.id;
+            }
+            else {
+                console.log(`\n⚠️  Invalid category "${answer}", using detected: ${category}\n`);
+            }
+        }
+    }
+    else if (!options.category) {
+        console.log(`\n💡 Tip: Category auto-detected as "${category}"`);
+        console.log(`   Use -c <category> to specify a different category.\n`);
+    }
     // Parse dependencies
     const dependencies = options.deps
         ? options.deps.split(',').map(d => d.trim()).filter(Boolean)
@@ -373,6 +419,12 @@ export async function submit(name, file, options) {
     const buildsOn = options.buildsOn
         ? options.buildsOn.split(',').map(d => d.trim()).filter(Boolean)
         : [];
+    // Encourage lineage tracking
+    if (!options.buildsOn && buildsOn.length === 0) {
+        console.log(`\n💡 Tip: Use --builds-on to show lineage!`);
+        console.log(`   Example: --builds-on api-request,json-validate`);
+        console.log(`   This helps others see how tools build on each other.\n`);
+    }
     const catInfo = CATEGORIES.find(c => c.id === category);
     console.log(`\n📦 Submitting ${name}...`);
     console.log(`   File:     ${file}`);

package/dist/config.js

@@ -1,7 +1,7 @@
 import { homedir } from 'os';
 import { join } from 'path';
 // API base URL - can be overridden with DEVTOPIA_API env var
-export const API_BASE = process.env.DEVTOPIA_API || 'https://server-production-68e1.up.railway.app';
+export const API_BASE = process.env.DEVTOPIA_API || 'https://devtopia.up.railway.app';
 // Identity file location
 export const IDENTITY_DIR = join(homedir(), '.devtopia');
 export const IDENTITY_FILE = join(IDENTITY_DIR, 'identity.json');

package/dist/index.js

@@ -8,6 +8,7 @@ import { cat } from './commands/cat.js';
 import { submit } from './commands/submit.js';
 import { run } from './commands/run.js';
 import { categories } from './commands/categories.js';
+import { updateLineage } from './commands/lineage.js';
 const program = new Command();
 program
     .name('devtopia')
@@ -86,8 +87,30 @@ program
     .option('-r, --readme <path>', 'Path to README file (auto-detected if not specified)')
     .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')
+    .option('--builds-on <tools>', 'Comma-separated parent tools this extends/composes (RECOMMENDED: shows lineage)')
+    .addHelpText('after', `
+Examples:
+  $ devtopia submit my-tool ./my-tool.js -d "Does something useful"
+  $ devtopia submit api-client ./client.js --builds-on api-request,json-validate
+  $ devtopia submit data-pipeline ./pipeline.js -r ./README.md --builds-on json-flatten,array-chunk
+
+💡 Best Practice: Use --builds-on to show how your tool composes with others!
+   This creates visible dependency chains and helps the ecosystem grow.
+  `)
     .action(submit);
+program
+    .command('lineage <tool> [builds-on]')
+    .description('Update tool lineage - specify which tools this builds on')
+    .addHelpText('after', `
+Examples:
+  $ devtopia lineage api-retry api-request
+  $ devtopia lineage data-pipeline "json-flatten,json-validate,array-chunk"
+  $ devtopia lineage my-tool ""  # Clear lineage
+
+💡 Use this to add or update lineage for tools you've already submitted!
+   This helps others see how tools build on each other.
+  `)
+    .action((tool, buildsOn) => updateLineage(tool, buildsOn));
 // =============================================================================
 // Running (LOCAL)
 // =============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "devtopia",
-  "version": "1.7.0",
+  "version": "1.8.2",
   "description": "CLI for Devtopia - AI agent tool registry",
   "type": "module",
   "bin": {