clawflowbang 1.0.2 → 1.1.0

package/src/commands/create.js

@@ -0,0 +1,286 @@
+/**
+ * Create command - Generate templates for skills and agents
+ */
+
+const chalk = require("chalk");
+const fs = require("fs-extra");
+const path = require("path");
+const inquirer = require("inquirer");
+const yaml = require("yaml");
+
+module.exports = async function createCommand(type, name, _options) {
+  console.log(chalk.cyan.bold("\n🛠️  ClawFlow Create\n"));
+
+  // 1. Determine Type
+  let targetType = type;
+  if (!targetType || !["skill", "agent"].includes(targetType.toLowerCase())) {
+    const { typeAnswer } = await inquirer.prompt([
+      {
+        type: "list",
+        name: "typeAnswer",
+        message: "What do you want to create?",
+        choices: [
+          { name: "Skill (Executable tool/function)", value: "skill" },
+          { name: "Agent (High-level LLM orchestrator)", value: "agent" },
+        ],
+      },
+    ]);
+    targetType = typeAnswer;
+  } else {
+    targetType = targetType.toLowerCase();
+  }
+
+  // 2. Determine Name
+  let targetName = name;
+  if (!targetName) {
+    const { nameAnswer } = await inquirer.prompt([
+      {
+        type: "input",
+        name: "nameAnswer",
+        message: `Enter ${targetType} name:`,
+        default: `my-cool-${targetType}`,
+        validate: (input) => {
+          if (/^[a-z0-9-_]+$/.test(input)) return true;
+          return "Name must be lowercase and contain only alphanumeric characters, dashes, or underscores.";
+        },
+      },
+    ]);
+    targetName = nameAnswer;
+  }
+
+  const targetDir = path.resolve(process.cwd(), targetName);
+
+  // 3. Check if directory exists
+  if (fs.existsSync(targetDir)) {
+    const { overwrite } = await inquirer.prompt([
+      {
+        type: "confirm",
+        name: "overwrite",
+        message: `Directory ${targetName} already exists. Overwrite?`,
+        default: false,
+      },
+    ]);
+    if (!overwrite) {
+      console.log(chalk.yellow("Aborted."));
+      return;
+    }
+    await fs.remove(targetDir);
+  }
+
+  // 4. Gather Metadata
+  const metadata = await inquirer.prompt([
+    {
+      type: "input",
+      name: "description",
+      message: "Description:",
+      default: `A new ${targetType} created with ClawFlow`,
+    },
+    {
+      type: "input",
+      name: "author",
+      message: "Author:",
+      default: process.env.USER || process.env.USERNAME || "anonymous",
+    },
+    {
+      type: "list",
+      name: "language",
+      message: "Language:",
+      choices: ["TypeScript", "Python"],
+      when: targetType === "skill",
+    },
+    {
+      type: "confirm",
+      name: "gitInit",
+      message: "Initialize a git repository?",
+      default: true,
+    },
+  ]);
+
+  // 5. Generate Files
+  try {
+    if (targetType === "skill") {
+      await generateSkill(targetDir, targetName, metadata);
+    } else {
+      await generateAgent(targetDir, targetName, metadata);
+    }
+
+    // Git Init
+    if (metadata.gitInit) {
+      try {
+        const { execSync } = require("child_process");
+        execSync("git init", { cwd: targetDir, stdio: "ignore" });
+        console.log(chalk.gray("  ✓ Git repository initialized"));
+      } catch (e) {
+        console.log(chalk.yellow("  ⚠️  Failed to initialize git repository"));
+      }
+    }
+
+    console.log(
+      chalk.green(`\n✅ ${targetType} "${targetName}" created successfully!`),
+    );
+    console.log(chalk.gray(`Path: ${targetDir}\n`));
+    console.log(chalk.cyan("Next steps:"));
+    console.log(chalk.white(`  cd ${targetName}`));
+    if (targetType === "skill" && metadata.language === "TypeScript") {
+      console.log(chalk.white("  npm install"));
+    }
+    console.log(
+      chalk.white("  Edit skill.yaml/agent.yaml to define your logic\n"),
+    );
+  } catch (err) {
+    console.error(chalk.red("\n❌ Error generating files:"), err.message);
+  }
+};
+
+async function generateSkill(dir, name, metadata) {
+  const isTS = metadata.language === "TypeScript";
+  const ext = isTS ? "ts" : "py";
+
+  await fs.ensureDir(dir);
+  await fs.ensureDir(path.join(dir, "examples"));
+
+  // skill.yaml
+  const skillYaml = {
+    name: name,
+    version: "1.0.0",
+    description: metadata.description,
+    author: metadata.author,
+    type: "tool",
+    runtime: metadata.language.toLowerCase(),
+    entry: `index.${ext}`,
+    parameters: {
+      type: "object",
+      properties: {
+        input: {
+          type: "string",
+          description: "Input for the skill",
+        },
+      },
+      required: ["input"],
+    },
+  };
+
+  await fs.writeFile(path.join(dir, "skill.yaml"), yaml.stringify(skillYaml));
+
+  // Entry file
+  let content = "";
+  if (isTS) {
+    content = `
+// ${name} - Generated by ClawFlow
+export interface Input {
+  input: string;
+}
+
+export async function run(params: Input) {
+  console.log(\`Running ${name} with input: \${params.input}\`);
+  return {
+    success: true,
+    message: \`Processed: \${params.input}\`,
+    timestamp: new Date().toISOString()
+  };
+}
+`;
+    // package.json for TS
+    const pkgJson = {
+      name: name,
+      version: "1.0.0",
+      description: metadata.description,
+      main: "index.ts",
+      scripts: {
+        test: 'echo "Error: no test specified" && exit 1',
+      },
+      dependencies: {
+        "@types/node": "^20.0.0",
+        typescript: "^5.0.0",
+      },
+    };
+    await fs.writeJson(path.join(dir, "package.json"), pkgJson, { spaces: 2 });
+  } else {
+    content = `
+# ${name} - Generated by ClawFlow
+import sys
+import json
+import datetime
+
+def run(params):
+    input_str = params.get('input', '')
+    print(f"Running ${name} with input: {input_str}")
+    
+    return {
+        "success": True,
+        "message": f"Processed: {input_str}",
+        "timestamp": datetime.datetime.now().isoformat()
+    }
+
+if __name__ == "__main__":
+    # For local testing
+    test_params = {"input": "Hello from ClawFlow"}
+    print(json.dumps(run(test_params), indent=2))
+`;
+    // requirements.txt for Python
+    await fs.writeFile(
+      path.join(dir, "requirements.txt"),
+      "# Add your dependencies here\n",
+    );
+  }
+
+  await fs.writeFile(path.join(dir, `index.${ext}`), content.trim());
+
+  // Example
+  const example = {
+    input: "Hello world",
+  };
+  await fs.writeJson(path.join(dir, "examples", "basic.json"), example, {
+    spaces: 2,
+  });
+
+  // README
+  await fs.writeFile(
+    path.join(dir, "README.md"),
+    `# ${name}\n\n${metadata.description}`,
+  );
+}
+
+async function generateAgent(dir, name, metadata) {
+  await fs.ensureDir(dir);
+  await fs.ensureDir(path.join(dir, "prompts"));
+  await fs.ensureDir(path.join(dir, "tools"));
+
+  // agent.yaml
+  const agentYaml = {
+    name: name,
+    version: "1.0.0",
+    description: metadata.description,
+    author: metadata.author,
+    model: "gpt-4-turbo",
+    prompts: {
+      system: "prompts/system.md",
+      user: "prompts/user.md",
+    },
+    tools: [
+      // 'example-skill'
+    ],
+    config: {
+      temperature: 0.7,
+      max_tokens: 1000,
+    },
+  };
+
+  await fs.writeFile(path.join(dir, "agent.yaml"), yaml.stringify(agentYaml));
+
+  // Prompts
+  await fs.writeFile(
+    path.join(dir, "prompts", "system.md"),
+    `# System Prompt for ${name}\n\nYou are a helpful assistant specialized in...`,
+  );
+  await fs.writeFile(
+    path.join(dir, "prompts", "user.md"),
+    `# User Prompt for ${name}\n\nTask: {{input}}`,
+  );
+
+  // README
+  await fs.writeFile(
+    path.join(dir, "README.md"),
+    `# ${name} (Agent)\n\n${metadata.description}`,
+  );
+}

package/src/commands/cron.js

@@ -2,23 +2,24 @@
  * Cron commands - จัดการ cronjobs
  */
 
-const chalk = require('chalk');
-const ClawFlow = require('../index');
-const { normalizeCronExpression } = require('../core/CronFormat');
-const YAML = require('yaml');
+const chalk = require("chalk");
+const ClawFlow = require("../index");
+const { normalizeCronExpression } = require("../core/CronFormat");
+const YAML = require("yaml");
 
 function parseJsonParams(params) {
-  if (params === undefined || params === null || params === '') {
+  if (params === undefined || params === null || params === "") {
     return {};
   }
 
-  if (typeof params === 'object') {
+  if (typeof params === "object") {
     return params;
   }
 
   const raw = String(params).trim();
   const unquoted =
-    (raw.startsWith("'") && raw.endsWith("'")) || (raw.startsWith('"') && raw.endsWith('"'))
+    (raw.startsWith("'") && raw.endsWith("'")) ||
+    (raw.startsWith('"') && raw.endsWith('"'))
       ? raw.slice(1, -1).trim()
       : raw;
 
@@ -28,7 +29,7 @@ function parseJsonParams(params) {
     if (!candidate) continue;
     try {
       const parsed = JSON.parse(candidate);
-      if (parsed && typeof parsed === 'object') {
+      if (parsed && typeof parsed === "object") {
         return parsed;
       }
     } catch (_error) {
@@ -40,7 +41,7 @@ function parseJsonParams(params) {
     if (!candidate) continue;
     try {
       const parsed = YAML.parse(candidate);
-      if (parsed && typeof parsed === 'object') {
+      if (parsed && typeof parsed === "object") {
         return parsed;
       }
     } catch (_error) {
@@ -58,7 +59,7 @@ function resolveScheduleInput(options) {
     return normalizeCronExpression(`every ${options.every}`);
   }
 
-  return normalizeCronExpression(options.schedule || '*/5 * * * *');
+  return normalizeCronExpression(options.schedule || "*/5 * * * *");
 }
 
 module.exports = {
@@ -66,18 +67,21 @@ module.exports = {
     const hub = new ClawFlow();
 
     try {
-      console.log(chalk.cyan.bold('\n⏰ Configured Cronjobs:\n'));
+      console.log(chalk.cyan.bold("\n⏰ Configured Cronjobs:\n"));
 
       const crons = await hub.listCrons();
 
       if (crons.length === 0) {
-        console.log(chalk.gray('  No cronjobs configured'));
+        console.log(chalk.gray("  No cronjobs configured"));
       } else {
         crons.forEach((job) => {
-          const status = job.enabled !== false ? chalk.green('●') : chalk.gray('○');
+          const status =
+            job.enabled !== false ? chalk.green("●") : chalk.gray("○");
           console.log(`  ${status} ${chalk.bold(job.skill || job.name)}`);
-          console.log(`    ${chalk.blue('Schedule:')} ${job.schedule}`);
-          console.log(`    ${chalk.blue('Description:')} ${job.description || '-'}`);
+          console.log(`    ${chalk.blue("Schedule:")} ${job.schedule}`);
+          console.log(
+            `    ${chalk.blue("Description:")} ${job.description || "-"}`,
+          );
           console.log();
         });
       }
@@ -88,7 +92,7 @@ module.exports = {
   },
 
   async add(skillName, options) {
-    const { params = '{}', description = '' } = options;
+    const { params = "{}", description = "" } = options;
 
     const hub = new ClawFlow();
 
@@ -96,9 +100,26 @@ module.exports = {
       const parsedParams = parseJsonParams(params);
       const schedule = resolveScheduleInput(options);
 
-      console.log(chalk.cyan(`\n➕ Adding cronjob for ${chalk.bold(skillName)}...\n`));
+      if (options.dryRun) {
+        console.log(chalk.yellow("\n📋 Cronjob Preview (Dry Run):\n"));
+        console.log(`  Skill: ${chalk.bold(skillName)}`);
+        console.log(`  Schedule: ${schedule}`);
+        console.log(`  Description: ${description || "-"}`);
+        console.log(`  Params: ${JSON.stringify(parsedParams)}`);
+        console.log(chalk.gray("\n(Nothing was added)"));
+        return;
+      }
+
+      console.log(
+        chalk.cyan(`\n➕ Adding cronjob for ${chalk.bold(skillName)}...\n`),
+      );
 
-      const job = await hub.cronManager.add(skillName, schedule, parsedParams, description);
+      const job = await hub.cronManager.add(
+        skillName,
+        schedule,
+        parsedParams,
+        description,
+      );
 
       console.log(chalk.green(`\n✓ Cronjob added successfully`));
       console.log(`  ID: ${job.id}`);
@@ -113,7 +134,9 @@ module.exports = {
     const hub = new ClawFlow();
 
     try {
-      console.log(chalk.cyan(`\n🗑️  Removing cronjob ${chalk.bold(jobId)}...\n`));
+      console.log(
+        chalk.cyan(`\n🗑️  Removing cronjob ${chalk.bold(jobId)}...\n`),
+      );
 
       await hub.cronManager.remove(jobId);
 
@@ -132,7 +155,7 @@ module.exports = {
       if (options.schedule || options.every) {
         updates.schedule = resolveScheduleInput(options);
       }
-      if (typeof options.description === 'string') {
+      if (typeof options.description === "string") {
         updates.description = options.description;
       }
       if (options.params !== undefined) {
@@ -140,7 +163,9 @@ module.exports = {
       }
 
       if (Object.keys(updates).length === 0) {
-        throw new Error('No update data provided (use --schedule/--every/--description/--params)');
+        throw new Error(
+          "No update data provided (use --schedule/--every/--description/--params)",
+        );
       }
 
       const updated = await hub.cronManager.edit(jobId, updates);

package/src/commands/doctor.js

@@ -0,0 +1,146 @@
+/**
+ * Doctor command - Check system compatibility and configuration
+ */
+
+const chalk = require("chalk");
+const fs = require("fs-extra");
+const path = require("path");
+const { execSync } = require("child_process");
+
+module.exports = async function doctorCommand() {
+  console.log(chalk.cyan.bold("\n🩺 ClawFlow Doctor - System Diagnostic\n"));
+
+  const checks = [
+    { name: "Node.js version", check: checkNode },
+    { name: "OpenClaw CLI", check: checkOpenClaw },
+    { name: "ClawHub CLI", check: checkClawHub },
+    { name: "Git CLI", check: checkGit },
+    { name: "Configuration", check: checkConfig },
+    { name: "Skills Path", check: checkSkillsPath },
+  ];
+
+  let errors = 0;
+  let warnings = 0;
+
+  for (const item of checks) {
+    process.stdout.write(chalk.white(`  Checking ${item.name}... `));
+    try {
+      const result = await item.check();
+      if (result.status === "ok") {
+        process.stdout.write(chalk.green("✓\n"));
+        if (result.message) console.log(chalk.gray(`     ${result.message}`));
+      } else if (result.status === "warn") {
+        process.stdout.write(chalk.yellow("⚠️\n"));
+        console.log(chalk.yellow(`     ${result.message}`));
+        warnings++;
+      } else {
+        process.stdout.write(chalk.red("✗\n"));
+        console.log(chalk.red(`     ${result.message}`));
+        errors++;
+      }
+    } catch (err) {
+      process.stdout.write(chalk.red("✗\n"));
+      console.log(chalk.red(`     Error: ${err.message}`));
+      errors++;
+    }
+  }
+
+  console.log("\n" + "─".repeat(50));
+  if (errors === 0 && warnings === 0) {
+    console.log(
+      chalk.green.bold("✨ Everything looks great! You are ready to go."),
+    );
+  } else if (errors === 0) {
+    console.log(
+      chalk.yellow.bold(`⚠️  System ready but with ${warnings} warning(s).`),
+    );
+  } else {
+    console.log(
+      chalk.red.bold(`❌ Found ${errors} error(s) and ${warnings} warning(s).`),
+    );
+    console.log(
+      chalk.gray("   Please fix the errors above before continuing."),
+    );
+  }
+  console.log();
+};
+
+async function checkNode() {
+  const version = process.version;
+  const major = parseInt(version.slice(1).split(".")[0], 10);
+  if (major < 16) {
+    return {
+      status: "error",
+      message: `Node.js ${version} is too old. Please use v16 or newer.`,
+    };
+  }
+  return { status: "ok", message: version };
+}
+
+async function checkOpenClaw() {
+  try {
+    const out = execSync("openclaw --version", { stdio: "pipe" })
+      .toString()
+      .trim();
+    return { status: "ok", message: out };
+  } catch (e) {
+    return {
+      status: "warn",
+      message: "OpenClaw CLI not found in PATH. Make sure it is installed.",
+    };
+  }
+}
+
+async function checkClawHub() {
+  try {
+    const out = execSync("clawhub --version", { stdio: "pipe" })
+      .toString()
+      .trim();
+    return { status: "ok", message: out };
+  } catch (e) {
+    return {
+      status: "warn",
+      message: "ClawHub CLI not found. Registry installs might fail.",
+    };
+  }
+}
+
+async function checkGit() {
+  try {
+    const out = execSync("git --version", { stdio: "pipe" }).toString().trim();
+    return { status: "ok", message: out };
+  } catch (e) {
+    return {
+      status: "error",
+      message: "Git is required for many ClawFlow features.",
+    };
+  }
+}
+
+async function checkConfig() {
+  const configFile = path.join(process.cwd(), ".clawflowhub", "config.json");
+  if (fs.existsSync(configFile)) {
+    return { status: "ok", message: "Local configuration found." };
+  }
+  return {
+    status: "warn",
+    message: 'No local .clawflowhub folder. Run "clawflow init".',
+  };
+}
+
+async function checkSkillsPath() {
+  const configFile = path.join(process.cwd(), ".clawflowhub", "config.json");
+  if (!fs.existsSync(configFile))
+    return { status: "warn", message: "Unknown skills path." };
+
+  try {
+    const config = fs.readJsonSync(configFile);
+    const skillsPath = config.openclaw?.skillsPath;
+    if (skillsPath && fs.existsSync(skillsPath)) {
+      return { status: "ok", message: skillsPath };
+    }
+    return { status: "error", message: `Skills path not found: ${skillsPath}` };
+  } catch (e) {
+    return { status: "error", message: "Failed to read config.json" };
+  }
+}

package/src/commands/explore.js

@@ -0,0 +1,49 @@
+/**
+ * Explore command - Discover new skills
+ */
+
+const chalk = require("chalk");
+const boxen = require("boxen");
+
+module.exports = async function exploreCommand() {
+  console.log(chalk.magenta.bold("\n✨ Explore ClawHub Ecosystem\n"));
+
+  const featured = [
+    {
+      name: "ClawGraph-Visualizer",
+      desc: "Visualize your agent node relations",
+      author: "clawflow-team",
+    },
+    {
+      name: "Crypto-Whale-Watcher",
+      desc: "Monitor large transactions on-chain",
+      author: "crypto-dev",
+    },
+    {
+      name: "Research-Pro-Agent",
+      desc: "Multi-step research orchestrator",
+      author: "openkrab",
+    },
+  ];
+
+  console.log(chalk.white("Featured Skills & Agents:"));
+
+  featured.forEach((item) => {
+    const content = `${chalk.bold.cyan(item.name)}\n${chalk.gray(item.desc)}\n${chalk.yellow("By: " + item.author)}`;
+    console.log(
+      boxen(content, {
+        padding: 1,
+        margin: { top: 1, bottom: 0 },
+        borderStyle: "round",
+        borderColor: "magenta",
+      }),
+    );
+  });
+
+  console.log(
+    chalk.gray('\nRun "clawflow search <query>" to find more packages!'),
+  );
+  console.log(
+    chalk.gray("Or visit https://hub.clawflow.dev for the full registry.\n"),
+  );
+};