devtopia 1.8.3 → 2.0.0

package/dist/commands/compose.d.ts

@@ -0,0 +1,5 @@
+interface ComposeOptions {
+    uses: string;
+}
+export declare function compose(name: string, options: ComposeOptions): Promise<void>;
+export {};

package/dist/commands/compose.js

@@ -0,0 +1,120 @@
+import { writeFileSync, existsSync } from 'fs';
+import { API_BASE } from '../config.js';
+export async function compose(name, options) {
+    if (!options.uses) {
+        console.log(`\n❌ --uses is required. Specify parent tools to compose.`);
+        console.log(`   Example: devtopia compose my-pipeline --uses json-validate,json-flatten\n`);
+        process.exit(1);
+    }
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        console.log(`\n❌ Tool name must be lowercase, alphanumeric with hyphens.\n`);
+        process.exit(1);
+    }
+    const parentNames = options.uses.split(',').map(s => s.trim()).filter(Boolean);
+    if (parentNames.length === 0) {
+        console.log(`\n❌ No parent tools specified.\n`);
+        process.exit(1);
+    }
+    // Verify each parent tool exists and fetch descriptions
+    console.log(`\n   Verifying parent tools...`);
+    const parents = [];
+    for (const parentName of parentNames) {
+        try {
+            const res = await fetch(`${API_BASE}/api/tools/${parentName}`);
+            if (!res.ok) {
+                console.log(`   ❌ Tool "${parentName}" not found in registry.`);
+                process.exit(1);
+            }
+            const tool = await res.json();
+            parents.push({ name: tool.name, description: tool.description || 'No description' });
+            console.log(`   ✓ ${tool.name} — ${(tool.description || '').slice(0, 50)}`);
+        }
+        catch {
+            console.log(`   ❌ Could not verify "${parentName}" — server unreachable.`);
+            process.exit(1);
+        }
+    }
+    // Generate scaffold JS
+    const stepsCode = parents.map((p, i) => {
+        const varName = p.name.replace(/-/g, '_');
+        return `  // Step ${i + 1}: ${p.description}
+  const ${varName}_result = devtopiaRun('${p.name}', { /* TODO: pass input */ });`;
+    }).join('\n\n');
+    const jsSource = `/**
+ * ${name} - [TODO: describe what this pipeline does]
+ * Builds on: ${parentNames.join(', ')} (via devtopia-runtime)
+ *
+${parents.map(p => ` * Composes ${p.name}: ${p.description}`).join('\n')}
+ *
+ * @param {Object} params
+ * @returns {Object} Pipeline result
+ */
+
+const { devtopiaRun } = require('./devtopia-runtime');
+const input = JSON.parse(process.argv[2] || '{}');
+
+// TODO: validate required input fields
+// if (!input.someField) {
+//   console.log(JSON.stringify({ error: 'Missing required field: someField' }));
+//   process.exit(1);
+// }
+
+try {
+${stepsCode}
+
+  // TODO: combine results and produce final output
+  console.log(JSON.stringify({
+    success: true,
+    // result: ...,
+    steps: ${JSON.stringify(parentNames)},
+  }));
+} catch (error) {
+  console.log(JSON.stringify({ error: error.message }));
+  process.exit(1);
+}
+`;
+    const mdSource = `# ${name}
+
+[TODO: describe what this pipeline does]
+
+## Composes
+
+${parents.map(p => `- \`${p.name}\` — ${p.description}`).join('\n')}
+
+## Usage
+
+\`\`\`bash
+devtopia run ${name} '{"TODO": "add input"}'
+\`\`\`
+
+## Input
+
+[TODO: document input fields]
+
+## Output
+
+\`\`\`json
+{
+  "success": true,
+  "steps": ${JSON.stringify(parentNames)}
+}
+\`\`\`
+`;
+    // Write files
+    const jsPath = `./${name}.js`;
+    const mdPath = `./${name}.md`;
+    if (existsSync(jsPath)) {
+        console.log(`\n⚠️  ${jsPath} already exists. Not overwriting.\n`);
+        process.exit(1);
+    }
+    writeFileSync(jsPath, jsSource);
+    writeFileSync(mdPath, mdSource);
+    console.log(`\n✅ Scaffold generated!`);
+    console.log(`\n   Files created:`);
+    console.log(`   ${jsPath}  — Tool source (edit the TODOs)`);
+    console.log(`   ${mdPath}  — README (edit the TODOs)`);
+    console.log(`\n   Next steps:`);
+    console.log(`   1. Edit ${jsPath} — fill in the TODOs with your logic`);
+    console.log(`   2. Test: devtopia run ${name} '{"test": "input"}'`);
+    console.log(`   3. Submit: devtopia submit ${name} ./${name}.js --builds-on ${parentNames.join(',')}\n`);
+}

package/dist/commands/docs.d.ts

@@ -0,0 +1 @@
+export declare function showDocs(docName?: string): void;