clawflowbang 1.0.0

package/.eslintrc.json

@@ -0,0 +1,38 @@
+{
+  "root": true,
+  "env": {
+    "node": true,
+    "es2021": true
+  },
+  "extends": [
+    "eslint:recommended"
+  ],
+  "parserOptions": {
+    "ecmaVersion": 12
+  },
+  "ignorePatterns": [
+    "node_modules/",
+    "coverage/"
+  ],
+  "rules": {
+    "no-console": "off",
+    "no-unused-vars": [
+      "warn",
+      {
+        "argsIgnorePattern": "^_",
+        "varsIgnorePattern": "^_"
+      }
+    ]
+  },
+  "overrides": [
+    {
+      "files": [
+        "**/*.test.js",
+        "__tests__/**/*.js"
+      ],
+      "env": {
+        "jest": true
+      }
+    }
+  ]
+}

package/README.md

@@ -0,0 +1 @@
+# ClawFlow

package/__tests__/config-manager.test.js

@@ -0,0 +1,52 @@
+const fs = require('fs-extra');
+const os = require('os');
+const path = require('path');
+const ConfigManager = require('../src/core/ConfigManager');
+
+function makeTempDir(prefix) {
+  return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+}
+
+describe('ConfigManager', () => {
+  test('applies path and bin overrides into openclaw config', () => {
+    const configDir = makeTempDir('cfh-config-');
+    const skillsPath = path.join(configDir, 'custom-skills');
+    const cronJobsFile = path.join(configDir, 'custom-cron', 'jobs.json');
+
+    const manager = new ConfigManager(configDir, {
+      skillsPath,
+      cronJobsFile,
+      openclawBin: '/usr/local/bin/openclaw',
+      clawhubBin: '/usr/local/bin/clawhub',
+    });
+
+    const config = manager.getConfig();
+    expect(config.openclaw.skillsPath).toBe(skillsPath);
+    expect(config.openclaw.cronJobsFile).toBe(cronJobsFile);
+    expect(config.openclaw.cliBin).toBe('/usr/local/bin/openclaw');
+    expect(config.openclaw.clawhubBin).toBe('/usr/local/bin/clawhub');
+    expect(manager.getCronJobsFilePath()).toBe(cronJobsFile);
+  });
+
+  test('addCron preserves provided id and updateCron mutates fields', () => {
+    const configDir = makeTempDir('cfh-config-');
+    const manager = new ConfigManager(configDir);
+
+    manager.addCron({
+      id: 'job-123',
+      skill: 'crypto-price',
+      schedule: '*/5 * * * *',
+    });
+
+    const updated = manager.updateCron('job-123', {
+      schedule: '0 * * * *',
+      description: 'hourly',
+    });
+
+    expect(updated).toBeTruthy();
+    expect(updated.id).toBe('job-123');
+    expect(updated.schedule).toBe('0 * * * *');
+    expect(updated.description).toBe('hourly');
+    expect(updated.updatedAt).toBeTruthy();
+  });
+});

package/__tests__/cron-format.test.js

@@ -0,0 +1,26 @@
+const { normalizeCronExpression } = require('../src/core/CronFormat');
+
+describe('CronFormat.normalizeCronExpression', () => {
+  test('accepts valid cron expressions as-is', () => {
+    expect(normalizeCronExpression('*/5 * * * *')).toBe('*/5 * * * *');
+  });
+
+  test('normalizes preset aliases', () => {
+    expect(normalizeCronExpression('@daily')).toBe('0 0 * * *');
+    expect(normalizeCronExpression('@hourly')).toBe('0 * * * *');
+  });
+
+  test('normalizes shorthand durations', () => {
+    expect(normalizeCronExpression('15m')).toBe('*/15 * * * *');
+    expect(normalizeCronExpression('every 2h')).toBe('0 */2 * * *');
+    expect(normalizeCronExpression('1d')).toBe('0 0 */1 * *');
+  });
+
+  test('throws on invalid cron expressions', () => {
+    expect(() => normalizeCronExpression('abc def')).toThrow(/ไม่ถูกต้อง/);
+  });
+
+  test('throws on unsupported duration shorthands', () => {
+    expect(() => normalizeCronExpression('70m')).toThrow(/ไม่รองรับ/);
+  });
+});

package/__tests__/cron-manager.local.test.js

@@ -0,0 +1,65 @@
+const fs = require('fs-extra');
+const os = require('os');
+const path = require('path');
+const ConfigManager = require('../src/core/ConfigManager');
+const CronManager = require('../src/core/CronManager');
+
+function makeTempDir(prefix) {
+  return fs.mkdtempSync(path.join(os.tmpdir(), prefix));
+}
+
+describe('CronManager local mode', () => {
+  test('add/edit/list/remove lifecycle works with normalized schedules', async () => {
+    const root = makeTempDir('cfh-cron-');
+    const configPath = path.join(root, 'config');
+    const cronJobsFile = path.join(root, 'cron', 'jobs.json');
+
+    const configManager = new ConfigManager(configPath, {
+      cronJobsFile,
+      openclawBin: 'notfound-openclaw',
+    });
+    const cronManager = new CronManager(configManager);
+
+    expect(cronManager.useOpenClawCron).toBe(false);
+
+    const added = await cronManager.add('smoke-skill', 'every 15m', { foo: 'bar' }, 'demo');
+    expect(added.id).toBeTruthy();
+    expect(added.schedule).toBe('*/15 * * * *');
+
+    const listed = cronManager.list();
+    expect(listed).toHaveLength(1);
+    expect(listed[0].schedule).toBe('*/15 * * * *');
+
+    const edited = await cronManager.edit(added.id, {
+      schedule: '@daily',
+      description: 'daily run',
+      params: { foo: 'baz' },
+    });
+    expect(edited.schedule).toBe('0 0 * * *');
+    expect(edited.description).toBe('daily run');
+    expect(edited.params).toEqual({ foo: 'baz' });
+
+    const listedAfterEdit = cronManager.list();
+    expect(listedAfterEdit).toHaveLength(1);
+    expect(listedAfterEdit[0].schedule).toBe('0 0 * * *');
+
+    await cronManager.remove(added.id);
+    expect(cronManager.list()).toEqual([]);
+
+    cronManager.stopAll();
+  });
+
+  test('rejects invalid schedules', async () => {
+    const root = makeTempDir('cfh-cron-');
+    const configPath = path.join(root, 'config');
+    const cronJobsFile = path.join(root, 'cron', 'jobs.json');
+
+    const configManager = new ConfigManager(configPath, {
+      cronJobsFile,
+      openclawBin: 'notfound-openclaw',
+    });
+    const cronManager = new CronManager(configManager);
+
+    await expect(cronManager.add('smoke-skill', 'wrong schedule', {})).rejects.toThrow(/ไม่ถูกต้อง/);
+  });
+});

package/__tests__/openclaw-cli.test.js

@@ -0,0 +1,51 @@
+const OpenClawCLI = require('../src/core/OpenClawCLI');
+
+function createCli() {
+  return new OpenClawCLI({
+    getConfig() {
+      return {
+        openclaw: {
+          cliBin: 'openclaw',
+          clawhubBin: 'clawhub',
+        },
+      };
+    },
+  });
+}
+
+describe('OpenClawCLI git fallback helpers', () => {
+  test('resolveGitRepository from explicit fields', () => {
+    const cli = createCli();
+    expect(
+      cli.resolveGitRepository({
+        name: 'crypto-price',
+        repository: 'https://github.com/acme/crypto-price.git',
+      }),
+    ).toBe('https://github.com/acme/crypto-price.git');
+  });
+
+  test('resolveGitRepository from github source + owner/repo name', () => {
+    const cli = createCli();
+    expect(
+      cli.resolveGitRepository({
+        source: 'github',
+        name: 'acme/my-skill',
+      }),
+    ).toBe('https://github.com/acme/my-skill.git');
+  });
+
+  test('resolveSkillDirName from url and scoped names', () => {
+    const cli = createCli();
+    expect(
+      cli.resolveSkillDirName({
+        name: 'https://github.com/acme/skill-x.git',
+      }),
+    ).toBe('skill-x');
+
+    expect(
+      cli.resolveSkillDirName({
+        name: 'acme/skill-y',
+      }),
+    ).toBe('skill-y');
+  });
+});

package/bin/clawflowhub.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const pkg = require('../package.json');
+
+// Import commands
+const installCommand = require('../src/commands/install');
+const listCommand = require('../src/commands/list');
+const removeCommand = require('../src/commands/remove');
+const cronCommand = require('../src/commands/cron');
+const statusCommand = require('../src/commands/status');
+const initCommand = require('../src/commands/init');
+const searchCommand = require('../src/commands/search');
+
+// Banner
+console.log(chalk.cyan.bold(`
+╔══════════════════════════════════════════════════════════╗
+║                                                          ║
+║   🐾 ${chalk.white.bold('ClawFlow')} - Skill & Cron Installer for OpenClaw   ║
+║                                                          ║
+║   ${chalk.gray('ติดตั้ง skill พร้อมตั้งค่าใช้งานทันที')}                      ║
+║                                                          ║
+╚══════════════════════════════════════════════════════════╝
+`));
+
+program
+  .name('clawflow')
+  .description('ติดตั้ง OpenClaw skills พร้อม cronjob ให้พร้อมใช้งาน')
+  .version(pkg.version, '-v, --version', 'แสดงเวอร์ชัน');
+
+// Install command
+program
+  .command('install <package>')
+  .alias('i')
+  .description('ติดตั้ง package พร้อม skills และ cronjobs')
+  .option('-g, --global', 'ติดตั้งแบบ global')
+  .option('-c, --config <path>', 'ระบุ path ของ config file')
+  .option('--skills-path <path>', 'ระบุ path ของ OpenClaw workspace skills')
+  .option('--cron-jobs <path>', 'ระบุ path ของ OpenClaw cron jobs.json')
+  .option('--openclaw-bin <path>', 'ระบุ binary ของ openclaw CLI')
+  .option('--clawhub-bin <path>', 'ระบุ binary ของ clawhub CLI')
+  .option('--no-cron', 'ติดตั้ง skill โดยไม่ตั้ง cronjob')
+  .option('--dry-run', 'แสดงว่าจะทำอะไรบ้างโดยไม่ติดตั้งจริง')
+  .action(installCommand);
+
+// List command
+program
+  .command('list')
+  .alias('ls')
+  .description('แสดงรายการ packages และ skills ที่ติดตั้ง')
+  .option('-a, --available', 'แสดง packages ที่สามารถติดตั้งได้')
+  .option('-i, --installed', 'แสดง packages ที่ติดตั้งแล้ว (default)')
+  .option('--npm', 'รวม packages จาก npm registry (ใช้กับ --available)')
+  .action(listCommand);
+
+// Search command
+program
+  .command('search <query>')
+  .alias('find')
+  .description('ค้นหา packages ใน registry')
+  .option('--no-npm', 'ไม่รวมผลลัพธ์จาก npm registry')
+  .action(searchCommand);
+
+// Remove command
+program
+  .command('remove <package>')
+  .alias('rm')
+  .description('ถอนการติดตั้ง package')
+  .option('-g, --global', 'ถอนการติดตั้งแบบ global')
+  .option('--keep-config', 'เก็บ config file ไว้')
+  .action(removeCommand);
+
+// Cron command group
+program
+  .command('cron-list')
+  .description('แสดงรายการ cronjobs ทั้งหมด')
+  .action(cronCommand.list);
+
+program
+  .command('cron-add <skill>')
+  .description('เพิ่ม cronjob สำหรับ skill')
+  .option('-s, --schedule <expression>', 'cron schedule expression', '*/5 * * * *')
+  .option('-e, --every <duration>', 'รูปแบบย่อ เช่น 5m, 1h, 2d')
+  .option('-d, --description <text>', 'คำอธิบาย cronjob')
+  .option('-p, --params <json>', 'parameters สำหรับ skill')
+  .action(cronCommand.add);
+
+program
+  .command('cron-edit <id>')
+  .description('แก้ไข cronjob')
+  .option('-s, --schedule <expression>', 'cron schedule expression ใหม่')
+  .option('-e, --every <duration>', 'รูปแบบย่อ เช่น 5m, 1h, 2d')
+  .option('-d, --description <text>', 'คำอธิบายใหม่')
+  .option('-p, --params <json>', 'parameters ใหม่ของ skill')
+  .action(cronCommand.edit);
+
+program
+  .command('cron-remove <id>')
+  .description('ลบ cronjob')
+  .action(cronCommand.remove);
+
+// Status command
+program
+  .command('status')
+  .description('แสดงสถานะระบบ')
+  .action(statusCommand);
+
+// Init command
+program
+  .command('init')
+  .description('เริ่มต้นใช้งาน ClawFlow ในตำแหน่งปัจจุบัน')
+  .option('-f, --force', 'เขียนทับ config เดิม')
+  .action(initCommand);
+
+// Global error handler
+process.on('unhandledRejection', (err) => {
+  console.error(chalk.red('\n❌ เกิดข้อผิดพลาด:'), err.message);
+  if (process.env.DEBUG) {
+    console.error(err.stack);
+  }
+  process.exit(1);
+});
+
+program.parse();

package/docs/clawhub-package-format.md

@@ -0,0 +1,179 @@
+# ClawFlow Package Format
+
+Packages สำหรับ ClawFlow สามารถ publish ขึ้น npm registry ได้โดยมีรูปแบบดังนี้:
+
+## 1. การระบุว่าเป็น ClawFlow Package
+
+มี 3 วิธี:
+
+### วิธีที่ 1: ใช้ Scope `@clawflow/`
+```json
+{
+  "name": "@clawflow/trading-kit"
+}
+```
+
+### วิธีที่ 2: ใช้ Keyword
+```json
+{
+  "name": "my-awesome-kit",
+  "keywords": ["clawflow", "trading", "crypto"]
+}
+```
+
+### วิธีที่ 3: ใช้ Field `clawflow` ใน package.json
+```json
+{
+  "name": "my-awesome-kit",
+  "clawflow": {
+    "skills": [...],
+    "crons": [...]
+  }
+}
+```
+
+## 2. Package Structure
+
+```
+my-package/
+├── package.json          # ต้องมี keyword "clawflow" หรือ field clawflow
+├── clawflow.json         # (optional) แยก config ออกมา
+├── README.md
+└── (other files)
+```
+
+## 3. clawflow.json Format
+
+```json
+{
+  "$schema": "https://clawflowhub.dev/schema/v1.json",
+  "skills": [
+    {
+      "name": "binance-pro",
+      "version": "^1.0.0",
+      "source": "openclaw",
+      "repository": "https://github.com/owner/binance-pro-skill.git",
+      "description": "Binance trading skill"
+    }
+  ],
+  "crons": [
+    {
+      "skill": "crypto-price",
+      "schedule": "*/5 * * * *",
+      "params": {
+        "symbols": ["BTC", "ETH", "SOL"]
+      },
+      "description": "เช็คราคาคริปโตทุก 5 นาที",
+      "enabled": true
+    }
+  ],
+  "config": {
+    "binance-pro": {
+      "apiKey": {
+        "env": "BINANCE_API_KEY",
+        "required": true,
+        "description": "Binance API Key"
+      },
+      "secretKey": {
+        "env": "BINANCE_SECRET_KEY",
+        "required": true,
+        "description": "Binance Secret Key"
+      }
+    }
+  },
+  "postInstall": "กรุณาตั้งค่า BINANCE_API_KEY และ BINANCE_SECRET_KEY ใน environment variables"
+}
+```
+
+## 4. Field Descriptions
+
+### skills
+รายการ skills ที่จะติดตั้ง
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | string | Yes | ชื่อ skill |
+| `version` | string | No | เวอร์ชัน (semver) |
+| `source` | string | No | แหล่งที่มา (openclaw, npm, github) |
+| `repository`/`repo`/`git` | string | No | Git URL สำหรับ fallback เมื่อหา skill ใน clawhub ไม่เจอ |
+| `branch`/`tag`/`ref` | string | No | branch/tag/ref สำหรับ git clone |
+| `description` | string | No | คำอธิบาย |
+
+### crons
+รายการ cronjobs ที่จะสร้าง
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `skill` | string | Yes | ชื่อ skill ที่จะรัน |
+| `schedule` | string | Yes | Cron expression |
+| `params` | object | No | Parameters ที่ส่งให้ skill |
+| `description` | string | No | คำอธิบาย |
+| `enabled` | boolean | No | เปิดใช้งานหรือไม่ (default: true) |
+
+### config
+Schema สำหรับการตั้งค่า package
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `env` | string | No | ชื่อ environment variable |
+| `required` | boolean | No | บังคับต้องมีหรือไม่ |
+| `default` | any | No | ค่า default |
+| `description` | string | No | คำอธิบาย |
+| `type` | string | No | ประเภท (string, number, array, object) |
+
+## 5. ตัวอย่าง package.json สมบูรณ์
+
+```json
+{
+  "name": "@clawflowhub/trading-kit",
+  "version": "1.0.0",
+  "description": "ชุดเครื่องมือสำหรับเทรดคริปโต",
+  "keywords": ["clawflowhub", "trading", "crypto", "binance"],
+  "author": "Your Name",
+  "license": "MIT",
+  "clawflowhub": {
+    "skills": [
+      { "name": "binance-pro", "version": "^1.0.0", "source": "openclaw" },
+      { "name": "crypto-price", "version": "^1.0.0", "source": "openclaw" }
+    ],
+    "crons": [
+      {
+        "skill": "crypto-price",
+        "schedule": "*/5 * * * *",
+        "params": { "symbols": ["BTC", "ETH"] },
+        "description": "เช็คราคาทุก 5 นาที"
+      }
+    ],
+    "config": {
+      "binance-pro": {
+        "apiKey": { "env": "BINANCE_API_KEY", "required": true }
+      }
+    }
+  }
+}
+```
+
+## 6. Publishing
+
+```bash
+# Publish ขึ้น npm
+npm publish --access public
+
+# ถ้าเป็น scoped package (@clawflowhub/xxx)
+npm publish --access public
+```
+
+## 7. การติดตั้ง
+
+หลังจาก publish แล้ว ผู้ใช้สามารถติดตั้งได้โดย:
+
+```bash
+# ติดตั้งจาก npm
+clawflowhub install @clawflowhub/trading-kit
+
+# หรือ
+clawflowhub install my-awesome-kit
+
+# ติดตั้งเวอร์ชันเฉพาะ
+clawflowhub install @clawflowhub/trading-kit@1.0.0
+```

package/examples/npm-package-example/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@clawflow/example-kit",
+  "version": "1.0.0",
+  "description": "ตัวอย่าง ClawFlow Package สำหรับ npm registry",
+  "keywords": [
+    "clawflow",
+    "example",
+    "demo"
+  ],
+  "author": "ClawFlow Team",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/clawflow/example-kit.git"
+  },
+  "clawflow": {
+    "skills": [
+      {
+        "name": "hello-world",
+        "version": "^1.0.0",
+        "source": "openclaw",
+        "description": "พูดว่า Hello World"
+      },
+      {
+        "name": "time-logger",
+        "version": "^1.0.0",
+        "source": "openclaw",
+        "description": "บันทึกเวลาปัจจุบัน"
+      }
+    ],
+    "crons": [
+      {
+        "skill": "time-logger",
+        "schedule": "0 * * * *",
+        "params": {
+          "format": "ISO"
+        },
+        "description": "บันทึกเวลาทุกชั่วโมง",
+        "enabled": true
+      }
+    ],
+    "config": {
+      "time-logger": {
+        "timezone": {
+          "default": "Asia/Bangkok",
+          "type": "string",
+          "description": "Timezone สำหรับการบันทึกเวลา"
+        }
+      }
+    },
+    "postInstall": "ตัวอย่าง Package ติดตั้งสำเร็จแล้ว! ลองตั้งค่า timezone ได้ใน config"
+  }
+}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "clawflowbang",
+  "version": "1.0.0",
+  "description": "Skill + Cron Installer for OpenClaw - ติดตั้ง skill พร้อมตั้งค่าใช้งานทันที",
+  "main": "src/index.js",
+  "bin": {
+    "clawflow": "bin/clawflowhub.js",
+    "clawflowhub": "bin/clawflowhub.js",
+    "cfh": "bin/clawflowhub.js"
+  },
+  "scripts": {
+    "start": "node bin/clawflowhub.js",
+    "test": "jest",
+    "lint": "eslint src/ bin/"
+  },
+  "keywords": [
+    "openclaw",
+    "skill",
+    "cron",
+    "installer",
+    "automation",
+    "clawhub",
+    "clawflow"
+  ],
+  "author": "ClawFlow Team",
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^11.0.0",
+    "chalk": "^4.1.2",
+    "ora": "^5.4.1",
+    "inquirer": "^8.2.6",
+    "fs-extra": "^11.1.1",
+    "node-cron": "^3.0.3",
+    "axios": "^1.5.0",
+    "yaml": "^2.3.2",
+    "semver": "^7.5.4"
+  },
+  "devDependencies": {
+    "jest": "^29.6.4",
+    "eslint": "^8.47.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}