devtopia 2.0.0 → 2.0.1

package/dist/commands/create.js

@@ -0,0 +1,302 @@
+import { writeFileSync, existsSync } from 'fs';
+import { createInterface } from 'readline';
+function validateName(name) {
+    if (!/^[a-z][a-z0-9-]*$/.test(name)) {
+        console.log(`\n❌ Tool name must be lowercase, alphanumeric with hyphens.\n`);
+        process.exit(1);
+    }
+}
+export async function create(name, options) {
+    if (!options.intent) {
+        console.log(`\n❌ --intent is required.\n   Example: devtopia create summarize-article --intent "Summarize a URL"\n`);
+        process.exit(1);
+    }
+    validateName(name);
+    const language = (options.language || 'javascript').toLowerCase();
+    const extensions = {
+        javascript: '.js',
+        typescript: '.ts',
+        python: '.py',
+        bash: '.sh',
+        ruby: '.rb',
+        php: '.php',
+        shebang: '.tool',
+    };
+    if (!extensions[language]) {
+        console.log(`\n❌ Unsupported language: ${language}`);
+        console.log(`   Supported: javascript, typescript, python, bash, ruby, php, shebang\n`);
+        process.exit(1);
+    }
+    const toolPath = `./${name}${extensions[language]}`;
+    const mdPath = `./${name}.md`;
+    if (existsSync(toolPath) || existsSync(mdPath)) {
+        console.log(`\n⚠️  ${toolPath} or ${mdPath} already exists. Not overwriting.\n`);
+        process.exit(1);
+    }
+    const intent = options.intent.trim();
+    let gap = (options.gap || '').trim();
+    if (!gap) {
+        const rl = createInterface({ input: process.stdin, output: process.stdout });
+        gap = await new Promise((resolve) => {
+            rl.question('\nWhy does this tool need to exist (gap justification)? ', (answer) => {
+                rl.close();
+                resolve(String(answer || '').trim());
+            });
+        });
+    }
+    if (!gap) {
+        console.log(`\n❌ Gap justification is required to create a new primitive.\n`);
+        process.exit(1);
+    }
+    const jsSource = `/**
+ * ${name} - ${intent}
+ *
+ * Intent:
+ * ${intent}
+ *
+ * Gap Justification:
+ * ${gap}
+ *
+ * @param {Object} params
+ * @returns {Object}
+ */
+
+const input = JSON.parse(process.argv[2] || '{}');
+
+// TODO: validate required fields from input
+// if (!input.someField) {
+//   console.log(JSON.stringify({ ok: false, error: 'Missing required field: someField' }));
+//   process.exit(1);
+// }
+
+try {
+  // TODO: implement your logic here
+  console.log(JSON.stringify({ ok: false, error: 'TODO: implement ${name}' }));
+  process.exit(1);
+} catch (error) {
+  console.log(JSON.stringify({ ok: false, error: error.message }));
+  process.exit(1);
+}
+`;
+    const tsSource = `/**
+ * ${name} - ${intent}
+ *
+ * Intent:
+ * ${intent}
+ *
+ * Gap Justification:
+ * ${gap}
+ */
+
+type Input = Record<string, unknown>;
+const input: Input = JSON.parse(process.argv[2] || '{}');
+
+// TODO: validate required fields from input
+// if (!input.someField) {
+//   console.log(JSON.stringify({ ok: false, error: 'Missing required field: someField' }));
+//   process.exit(1);
+// }
+
+try {
+  // TODO: implement your logic here
+  console.log(JSON.stringify({ ok: false, error: 'TODO: implement ${name}' }));
+  process.exit(1);
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.log(JSON.stringify({ ok: false, error: message }));
+  process.exit(1);
+}
+`;
+    const pySource = `#!/usr/bin/env python3
+# ${name} - ${intent}
+#
+# Intent:
+# ${intent}
+#
+# Gap Justification:
+# ${gap}
+
+import json
+import sys
+
+input_data = json.loads(sys.argv[1] if len(sys.argv) > 1 else '{}')
+
+# TODO: validate required fields
+# if 'someField' not in input_data:
+#     print(json.dumps({ 'ok': False, 'error': 'Missing required field: someField' }))
+#     sys.exit(1)
+
+try:
+    # TODO: implement your logic here
+    print(json.dumps({ 'ok': False, 'error': 'TODO: implement ${name}' }))
+    sys.exit(1)
+except Exception as error:
+    print(json.dumps({ 'ok': False, 'error': str(error) }))
+    sys.exit(1)
+`;
+    const bashSource = `#!/usr/bin/env bash
+# ${name} - ${intent}
+#
+# Intent:
+# ${intent}
+#
+# Gap Justification:
+# ${gap}
+
+set -euo pipefail
+
+INPUT="\${1:-{}}"
+
+# TODO: parse fields from JSON input using node (available with Devtopia CLI)
+# Example:
+# TEXT=$(node -e "const i=JSON.parse(process.argv[1]||'{}'); console.log(i.text||'');" "$INPUT")
+# if [ -z "$TEXT" ]; then
+#   echo '{"ok":false,"error":"Missing required field: text"}'
+#   exit 1
+# fi
+
+# TODO: implement your logic here
+echo '{"ok":false,"error":"TODO: implement ${name}"}'
+exit 1
+`;
+    const rubySource = `#!/usr/bin/env ruby
+# ${name} - ${intent}
+#
+# Intent:
+# ${intent}
+#
+# Gap Justification:
+# ${gap}
+
+require 'json'
+
+input = JSON.parse(ARGV[0] || '{}')
+
+# TODO: validate required fields
+# unless input['someField']
+#   puts JSON.generate({ ok: false, error: 'Missing required field: someField' })
+#   exit 1
+# end
+
+begin
+  # TODO: implement your logic here
+  puts JSON.generate({ ok: false, error: 'TODO: implement ${name}' })
+  exit 1
+rescue => e
+  puts JSON.generate({ ok: false, error: e.message })
+  exit 1
+end
+`;
+    const phpSource = `#!/usr/bin/env php
+<?php
+// ${name} - ${intent}
+//
+// Intent:
+// ${intent}
+//
+// Gap Justification:
+// ${gap}
+
+$input = json_decode($argv[1] ?? '{}', true);
+if ($input === null && json_last_error() !== JSON_ERROR_NONE) {
+    echo json_encode([\"ok\" => false, \"error\" => \"Invalid JSON input\"]);
+    exit(1);
+}
+
+// TODO: validate required fields
+// if (!isset($input['someField'])) {
+//     echo json_encode([\"ok\" => false, \"error\" => \"Missing required field: someField\"]);
+//     exit(1);
+// }
+
+try {
+    // TODO: implement your logic here
+    echo json_encode([\"ok\" => false, \"error\" => \"TODO: implement ${name}\"]);
+    exit(1);
+} catch (Throwable $e) {
+    echo json_encode([\"ok\" => false, \"error\" => $e->getMessage()]);
+    exit(1);
+}
+?>`;
+    const shebangSource = `#!/usr/bin/env bash
+# ${name} - ${intent}
+#
+# Intent:
+# ${intent}
+#
+# Gap Justification:
+# ${gap}
+#
+# Replace "bash" above with the interpreter you want (python3, ruby, php, etc).
+
+set -euo pipefail
+
+INPUT="\${1:-{}}"
+
+# TODO: parse fields from JSON input
+# Example using node:
+# FIELD=$(node -e "const i=JSON.parse(process.argv[1]||'{}'); console.log(i.field||'');" "$INPUT")
+
+# TODO: implement your logic here
+echo '{"ok":false,"error":"TODO: implement ${name}"}'
+exit 1
+`;
+    const mdSource = `# ${name}
+
+${intent}
+
+## Intent
+
+${intent}
+
+## Gap Justification
+
+${gap}
+
+## External Systems (if any)
+
+<!-- Required for gravity tools. Examples: github, slack, openai, postgres, s3, filesystem -->
+
+## Usage
+
+\`\`\`bash
+devtopia run ${name} --json --quiet '{ "TODO": "add input" }'
+\`\`\`
+
+## Input
+
+\`\`\`json
+{
+  "TODO": "document required fields"
+}
+\`\`\`
+
+## Output
+
+\`\`\`json
+{
+  "ok": true,
+  "result": "..."
+}
+\`\`\`
+`;
+    const sources = {
+        javascript: jsSource,
+        typescript: tsSource,
+        python: pySource,
+        bash: bashSource,
+        ruby: rubySource,
+        php: phpSource,
+        shebang: shebangSource,
+    };
+    writeFileSync(toolPath, sources[language]);
+    writeFileSync(mdPath, mdSource);
+    console.log(`\n✅ Scaffold generated!`);
+    console.log(`\n   Files created:`);
+    console.log(`   ${toolPath}  — Tool source (edit the TODOs)`);
+    console.log(`   ${mdPath}  — README (edit the TODOs)`);
+    console.log(`\n   Next steps:`);
+    console.log(`   1. Edit ${toolPath} — implement your logic`);
+    console.log(`   2. Test: devtopia run ${name} --json --quiet '{...}'`);
+    console.log(`   3. Submit: devtopia submit ${name} ${toolPath}\n`);
+}