clawflowbang 1.0.0 → 1.0.2

package/.env.example

@@ -0,0 +1,14 @@
+# ClawFlow local environment
+DEBUG=
+TZ=Asia/Bangkok
+OPENCLAW_URL=http://localhost:18789
+
+# Optional skill credentials
+BINANCE_API_KEY=
+BINANCE_SECRET_KEY=
+FB_ACCESS_TOKEN=
+TWITTER_API_KEY=
+TWITTER_API_SECRET=
+DISCORD_WEBHOOK=
+GOOGLE_CREDENTIALS=
+NOTION_TOKEN=

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,35 @@
+---
+name: Bug report
+about: Report a reproducible problem
+title: "[bug] "
+labels: bug
+assignees: ''
+---
+
+## Summary
+
+Describe the problem clearly.
+
+## Environment
+
+- OS:
+- Node.js version:
+- CLI version (`clawflow --version`):
+
+## Steps to Reproduce
+
+1.
+2.
+3.
+
+## Expected Behavior
+
+What should happen.
+
+## Actual Behavior
+
+What actually happened.
+
+## Logs / Output
+
+Paste full command and error output.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,23 @@
+---
+name: Feature request
+about: Suggest an improvement
+title: "[feature] "
+labels: enhancement
+assignees: ''
+---
+
+## Problem
+
+What problem are you trying to solve?
+
+## Proposed Solution
+
+Describe the behavior you want.
+
+## Alternatives Considered
+
+Other options you evaluated.
+
+## Additional Context
+
+Any examples, links, or screenshots.

package/.github/pull_request_template.md

@@ -0,0 +1,19 @@
+## Summary
+
+Explain what changed and why.
+
+## Changes
+
+- 
+
+## Validation
+
+- [ ] `npm run lint`
+- [ ] `npm test -- --runInBand`
+- [ ] Manual test performed (if applicable)
+
+## Checklist
+
+- [ ] Backward compatibility considered
+- [ ] Docs updated (README/CHANGELOG) if needed
+- [ ] No secrets or local machine data committed

package/.github/workflows/publish.yml

@@ -0,0 +1,46 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+  release:
+    types: [published]
+
+permissions:
+  contents: read
+  packages: write
+  id-token: write
+
+jobs:
+  publish:
+    name: Publish package
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Publish to npm (using NPM_TOKEN)
+        if: secrets.NPM_TOKEN != ''
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: |
+          echo "Publishing with NPM_TOKEN..."
+          npm publish --access public
+
+      - name: Publish to npm (OIDC / Trusted Publisher)
+        if: secrets.NPM_TOKEN == ''
+        run: |
+          echo "No NPM_TOKEN found. To publish without a stored token, set up a Trusted Publisher in npm and enable OIDC."
+          echo "See README or npm docs for steps to configure Trusted Publisher."
+          exit 1

package/.github/workflows/test.yml

@@ -0,0 +1,31 @@
+name: Test
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    name: Run tests
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '18'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Run linter
+        run: npm run lint

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,29 @@
+# Code of Conduct
+
+This project follows the Contributor Covenant.
+
+## Our Pledge
+
+We aim to provide a respectful, harassment-free experience for everyone.
+
+## Expected Behavior
+
+- Be respectful and constructive.
+- Assume good intent.
+- Focus on technical discussion and collaboration.
+
+## Unacceptable Behavior
+
+- Harassment, abuse, discrimination, or hate speech.
+- Personal attacks or threats.
+- Sharing private information without consent.
+
+## Enforcement
+
+Maintainers may edit/remove content and restrict participation for violations.
+
+Report issues to: `maintainers@clawflow.dev`
+
+## Attribution
+
+Adapted from Contributor Covenant: https://www.contributor-covenant.org

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ClawFlow Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1 +1,151 @@
-# ClawFlow
+# ClawFlow
+
+`ClawFlow` is a CLI wrapper for OpenClaw that installs skill bundles and wires cron jobs in one flow.
+
+Published package: `clawflowbang`  
+Primary command: `clawflow` (alias: `cfh`)
+
+## What It Does
+
+- Install package presets (skills + cron jobs) with one command.
+- Install skills from ClawHub first, then fallback to Git clone if not found.
+- Manage cron jobs through `openclaw cron` (add/edit/remove/list).
+- Validate and normalize cron expressions before save.
+
+## Requirements
+
+- Node.js `>=16`
+- OpenClaw CLI (`openclaw`)
+- ClawHub CLI (`clawhub`) for registry skill install
+- Git (used for fallback clone)
+
+## Install
+
+```bash
+npm i -g clawflowbang
+```
+
+Check:
+
+```bash
+clawflow --version
+```
+
+## Quick Start
+
+Initialize local config:
+
+```bash
+clawflow init
+```
+
+Install a package preset:
+
+```bash
+clawflow install trading-kit
+```
+
+Check status:
+
+```bash
+clawflow status
+```
+
+## Main Commands
+
+```bash
+clawflow install <package>
+clawflow list [--available] [--npm]
+clawflow search <query> [--no-npm]
+clawflow remove <package>
+
+clawflow cron-list
+clawflow cron-add <skill> --schedule "*/5 * * * *"
+clawflow cron-edit <id> --every 15m --description "updated job"
+clawflow cron-remove <id>
+```
+
+## Cron Input Formats
+
+Supported formats:
+
+- Raw cron: `*/5 * * * *`
+- Preset: `@hourly`, `@daily`, `@weekly`, `@monthly`
+- Shorthand: `5m`, `every 15m`, `1h`, `2d`
+
+Examples:
+
+```bash
+clawflow cron-add crypto-price --every 15m
+clawflow cron-edit <job-id> --schedule "@daily"
+clawflow cron-edit <job-id> --params '{"symbols":["BTC","ETH"]}'
+clawflow cron-remove <job-id>
+```
+
+## Skill Install Fallback (ClawHub -> Git)
+
+When installing package skills:
+
+1. Try `clawhub install`
+2. If failed, try `git clone` when skill metadata provides repository info
+3. Validate cloned skill by checking `SKILL.md`
+
+Skill metadata fields for git fallback:
+
+- `repository` or `repo` or `git`
+- optional `branch` / `tag` / `ref`
+
+## Paths Used by Default
+
+- Skills path: `~/.openclaw/workspace/skills`
+- Cron jobs file: `~/.openclaw/cron/jobs.json`
+
+Override during install:
+
+```bash
+clawflow install <package> \
+  --skills-path "<path-to-skills>" \
+  --cron-jobs "<path-to-jobs.json>"
+```
+
+## NPM Package Preset Format
+
+`clawflow` can read package metadata from npm packages.  
+Use `clawflow` field in package.json:
+
+```json
+{
+  "name": "my-kit",
+  "version": "1.0.0",
+  "keywords": ["clawflow"],
+  "clawflow": {
+    "skills": [
+      {
+        "name": "crypto-price",
+        "version": "^1.0.0",
+        "source": "openclaw",
+        "repository": "https://github.com/owner/crypto-price-skill.git"
+      }
+    ],
+    "crons": [
+      {
+        "skill": "crypto-price",
+        "schedule": "*/5 * * * *",
+        "params": { "symbols": ["BTC", "ETH"] }
+      }
+    ]
+  }
+}
+```
+
+## Development
+
+```bash
+npm install
+npm run lint
+npm test -- --runInBand
+```
+
+## License
+
+MIT

package/SECURITY.md

@@ -0,0 +1,20 @@
+# Security Policy
+
+## Supported Versions
+
+The latest published version is supported for security fixes.
+
+## Reporting a Vulnerability
+
+Please do not open a public issue for security vulnerabilities.
+
+Report privately to: `maintainers@clawflow.dev`
+
+Include:
+
+- Affected version
+- Steps to reproduce
+- Impact
+- Suggested mitigation (if any)
+
+We will acknowledge receipt and follow up as quickly as possible.

package/SUPPORT.md

@@ -0,0 +1,21 @@
+# Support
+
+## Questions and Usage Help
+
+- Open a GitHub Discussion (recommended for how-to questions)
+- Open a GitHub Issue for bugs and feature requests
+
+## Before Opening an Issue
+
+- Confirm CLI version with `clawflow --version`
+- Run `clawflow status`
+- Include command used and full error output
+- Include OS + Node.js version
+
+## Scope
+
+This project focuses on:
+
+- OpenClaw skill installation orchestration
+- Cron setup/management integration
+- Package preset workflow

package/bin/clawflowhub.js

@@ -1,8 +1,12 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
+
+require('dotenv').config();
+
+const { program } = require('commander');
+const pkg = require('../package.json');
 
-const { program } = require('commander');
-const chalk = require('chalk');
-const pkg = require('../package.json');
+// Import TUI
+const TUI = require('../src/core/TerminalUI');
 
 // Import commands
 const installCommand = require('../src/commands/install');
@@ -13,109 +17,101 @@ 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', 'แสดงเวอร์ชัน');
+// Print new TUI banner
+TUI.printBanner(pkg.version);
+
+program
+  .name('clawflow')
+  .description('Install OpenClaw skills and set up cronjobs')
+  .version(pkg.version, '-v, --version', 'Show 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', 'แสดงว่าจะทำอะไรบ้างโดยไม่ติดตั้งจริง')
+  .description('Install a package including skills and cronjobs')
+  .option('-g, --global', 'Install globally')
+  .option('-c, --config <path>', 'Specify config file path')
+  .option('--skills-path <path>', 'Specify OpenClaw workspace skills path')
+  .option('--cron-jobs <path>', 'Specify OpenClaw cron jobs.json path')
+  .option('--openclaw-bin <path>', 'Path to openclaw CLI binary')
+  .option('--clawhub-bin <path>', 'Path to clawhub CLI binary')
+  .option('--no-cron', 'Install skills without creating cronjobs')
+  .option('--dry-run', 'Show what would be done without installing')
   .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)')
+  .description('Show installed packages and skills')
+  .option('-a, --available', 'Show packages available for install')
+  .option('-i, --installed', 'Show installed packages (default)')
+  .option('--npm', 'Include packages from npm registry (with --available)')
   .action(listCommand);
 
 // Search command
 program
   .command('search <query>')
   .alias('find')
-  .description('ค้นหา packages ใน registry')
-  .option('--no-npm', 'ไม่รวมผลลัพธ์จาก npm registry')
+  .description('Search packages in the registry')
+  .option('--no-npm', 'Exclude results from npm registry')
   .action(searchCommand);
 
 // Remove command
 program
   .command('remove <package>')
   .alias('rm')
-  .description('ถอนการติดตั้ง package')
-  .option('-g, --global', 'ถอนการติดตั้งแบบ global')
-  .option('--keep-config', 'เก็บ config file ไว้')
+  .description('Uninstall a package')
+  .option('-g, --global', 'Uninstall globally')
+  .option('--keep-config', 'Keep package config files')
   .action(removeCommand);
 
 // Cron command group
 program
   .command('cron-list')
-  .description('แสดงรายการ cronjobs ทั้งหมด')
+  .description('List all 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);
+program
+  .command('cron-add <skill>')
+  .description('Add a cronjob for a skill')
+  .option('-s, --schedule <expression>', 'cron schedule expression', '*/5 * * * *')
+  .option('-e, --every <duration>', 'Shorthand like 5m, 1h, 2d')
+  .option('-d, --description <text>', 'Cronjob description')
+  .option('-p, --params <json>', 'Parameters for the skill')
+  .action(cronCommand.add);
+
+program
+  .command('cron-edit <id>')
+  .description('Edit a cronjob')
+  .option('-s, --schedule <expression>', 'New cron schedule expression')
+  .option('-e, --every <duration>', 'Shorthand like 5m, 1h, 2d')
+  .option('-d, --description <text>', 'New description')
+  .option('-p, --params <json>', 'New parameters for the skill')
+  .action(cronCommand.edit);
+
+program
+  .command('cron-remove <id>')
+  .description('Remove a cronjob')
+  .action(cronCommand.remove);
 
 // Status command
 program
   .command('status')
-  .description('แสดงสถานะระบบ')
+  .description('Show system status')
   .action(statusCommand);
 
 // Init command
 program
   .command('init')
-  .description('เริ่มต้นใช้งาน ClawFlow ในตำแหน่งปัจจุบัน')
-  .option('-f, --force', 'เขียนทับ config เดิม')
+  .description('Initialize ClawFlow in the current directory')
+  .option('-f, --force', 'Overwrite existing config')
   .action(initCommand);
 
 // Global error handler
 process.on('unhandledRejection', (err) => {
-  console.error(chalk.red('\n❌ เกิดข้อผิดพลาด:'), err.message);
+  TUI.printError('เกิดข้อผิดพลาด: ' + err.message);
   if (process.env.DEBUG) {
     console.error(err.stack);
   }

package/package.json

@@ -1,13 +1,12 @@
 {
-  "name": "clawflowbang",
-  "version": "1.0.0",
-  "description": "Skill + Cron Installer for OpenClaw - ติดตั้ง skill พร้อมตั้งค่าใช้งานทันที",
+  "name": "clawflowbang",
+  "version": "1.0.2",
+  "description": "Skill + Cron Installer for OpenClaw - Install skills and configure them for immediate use",
   "main": "src/index.js",
-  "bin": {
-    "clawflow": "bin/clawflowhub.js",
-    "clawflowhub": "bin/clawflowhub.js",
-    "cfh": "bin/clawflowhub.js"
-  },
+  "bin": {
+    "clawflow": "bin/clawflowhub.js",
+    "cfh": "bin/clawflowhub.js"
+  },
   "scripts": {
     "start": "node bin/clawflowhub.js",
     "test": "jest",
@@ -25,19 +24,22 @@
   "author": "ClawFlow Team",
   "license": "MIT",
   "dependencies": {
-    "commander": "^11.0.0",
+    "axios": "^1.5.0",
+    "boxen": "^8.0.1",
     "chalk": "^4.1.2",
-    "ora": "^5.4.1",
-    "inquirer": "^8.2.6",
+    "commander": "^11.0.0",
+    "dotenv": "^16.6.1",
     "fs-extra": "^11.1.1",
+    "gradient-string": "^3.0.0",
+    "inquirer": "^8.2.6",
     "node-cron": "^3.0.3",
-    "axios": "^1.5.0",
-    "yaml": "^2.3.2",
-    "semver": "^7.5.4"
+    "ora": "^5.4.1",
+    "semver": "^7.5.4",
+    "yaml": "^2.3.2"
   },
   "devDependencies": {
-    "jest": "^29.6.4",
-    "eslint": "^8.47.0"
+    "eslint": "^8.47.0",
+    "jest": "^29.6.4"
   },
   "engines": {
     "node": ">=16.0.0"