cf-yoyo 1.0.0

package/.eslintrc.json

@@ -0,0 +1,28 @@
+{
+  "root": true,
+  "parser": "@typescript-eslint/parser",
+  "parserOptions": {
+    "ecmaVersion": 2022,
+    "sourceType": "module",
+    "project": "./tsconfig.json"
+  },
+  "plugins": ["@typescript-eslint"],
+  "extends": [
+    "eslint:recommended",
+    "plugin:@typescript-eslint/recommended",
+    "plugin:@typescript-eslint/recommended-requiring-type-checking"
+  ],
+  "rules": {
+    "@typescript-eslint/no-unused-vars": "error",
+    "@typescript-eslint/no-explicit-any": "error",
+    "@typescript-eslint/explicit-function-return-type": "warn",
+    "@typescript-eslint/no-inferrable-types": "off",
+    "@typescript-eslint/no-non-null-assertion": "warn",
+    "prefer-const": "error",
+    "no-var": "error"
+  },
+  "env": {
+    "node": true,
+    "es6": true
+  }
+}

package/.github/workflows/ci.yml

@@ -0,0 +1,96 @@
+# GitHub Actions CI/CD 配置
+# 自動執行測試、類型檢查、建置
+
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  # 建置與測試
+  build-and-test:
+    runs-on: ubuntu-latest
+
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+
+    steps:
+      - name: 檢出代碼
+        uses: actions/checkout@v4
+
+      - name: 設置 Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+
+      - name: 安裝依賴
+        run: npm ci
+
+      - name: 類型檢查
+        run: npm run type-check
+
+      - name: 建置
+        run: npm run build
+
+      - name: 執行測試並生成覆蓋率報告
+        run: npm run test:coverage
+
+      - name: 上傳覆蓋率報告
+        uses: actions/upload-artifact@v4
+        with:
+          name: coverage-report-node-${{ matrix.node-version }}
+          path: coverage/
+          retention-days: 7
+
+  # 代碼品質檢查
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: 檢出代碼
+        uses: actions/checkout@v4
+
+      - name: 設置 Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'npm'
+
+      - name: 安裝依賴
+        run: npm ci
+
+      - name: 執行 ESLint
+        run: npm run lint
+        continue-on-error: true
+
+  # 發布到 npm（僅在 main 分支）
+  publish:
+    needs: [build-and-test, lint]
+    runs-on: ubuntu-latest
+    if: github.ref == 'refs/heads/main' && github.event_name == 'push'
+
+    steps:
+      - name: 檢出代碼
+        uses: actions/checkout@v4
+
+      - name: 設置 Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: 安裝依賴
+        run: npm ci
+
+      - name: 建置
+        run: npm run build
+
+      - name: 發布到 npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.prettierrc.json

@@ -0,0 +1,10 @@
+{
+  "semi": true,
+  "trailingComma": "es5",
+  "singleQuote": true,
+  "printWidth": 100,
+  "tabWidth": 2,
+  "useTabs": false,
+  "arrowParens": "always",
+  "endOfLine": "lf"
+}

package/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2026-04-11
+
+### Added
+
+- 🚀 Initial release of cf-yoyo CLI tool
+- 📝 Interactive project creation with inquirer prompts
+- 📦 Support for multiple project templates:
+  - `worker` - Basic Cloudflare Worker
+  - `hono` - Worker with Hono framework
+  - `pages` - Cloudflare Pages static site
+  - `d1` - Worker with D1 database
+  - `kv` - Worker with KV storage
+  - `r2` - Worker with R2 storage
+- 🔧 Built-in Git operations (init, push, clone)
+- 📋 List command to view available templates
+- 🎨 Template engine with variable substitution
+- ⚙️ Configuration management system
+- 📁 File system utilities
+- 🔍 Comprehensive test suite (186 tests, 83% coverage)
+- 🔄 CI/CD pipeline with GitHub Actions
+
+### Technical Details
+
+- TypeScript strict mode enabled
+- Vitest testing framework
+- ESLint + Prettier code quality tools
+- Node.js 18+ support
+- Commander.js CLI framework
+- execa for process execution
+
+### Test Coverage
+
+| Metric     | Coverage |
+| ---------- | -------- |
+| Statements | 83.58%   |
+| Functions  | 98.03%   |
+| Branches   | 79.05%   |
+| Lines      | 83.48%   |
+
+## [Unreleased]
+
+### Planned
+
+- [ ] Additional project templates (DO, Queue, etc.)
+- [ ] Template customization options
+- [ ] Interactive template preview
+- [ ] Project migration tools
+- [ ] Cloudflare API integration

package/README.md

@@ -0,0 +1,138 @@
+# cf-yoyo
+
+[![CI](https://github.com/your-username/cf-yoyo/actions/workflows/ci.yml/badge.svg)](https://github.com/your-username/cf-yoyo/actions/workflows/ci.yml)
+[![npm version](https://badge.fury.io/js/cf-yoyo.svg)](https://badge.fury.io/js/cf-yoyo)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Test Coverage](https://img.shields.io/badge/coverage-83%25-brightgreen)](./coverage/)
+
+Cloudflare 專案腳手架 CLI 工具 - 快速建立 Cloudflare Workers、Pages 等專案
+
+## 功能特色
+
+- 🚀 快速建立 Cloudflare 專案
+- 📝 互動式問答流程
+- 📦 支援多種專案模板
+- ⚡ 支援 Workers、Pages、D1、KV、R2 等服務
+- 🔧 內建 Git 操作功能
+
+## 安裝使用
+
+### 全域安裝
+
+```bash
+npm install -g cf-yoyo
+```
+
+### 使用 npx（推薦）
+
+```bash
+npx cf-yoyo create my-project
+```
+
+## 快速開始
+
+### 建立新專案
+
+```bash
+# 互動式建立
+npx cf-yoyo create
+
+# 指定專案名稱
+npx cf-yoyo create my-worker
+
+# 使用特定模板
+npx cf-yoyo create my-app --template pages
+```
+
+### Git 相關操作
+
+```bash
+# 初始化 Git 倉庫
+npx cf-yoyo git init
+
+# 推送到遠端倉庫
+npx cf-yoyo git push
+
+# 克隆遠端倉庫
+npx cf-yoyo git clone <repository-url>
+```
+
+### 查看可用模板
+
+```bash
+npx cf-yoyo list
+```
+
+## 可用模板
+
+- `worker` - 基礎 Cloudflare Worker
+- `hono` - 使用 Hono 框架的 Worker
+- `pages` - Cloudflare Pages 靜態網站
+- `d1` - 包含 D1 資料庫的 Worker
+- `kv` - 包含 KV 存儲的 Worker
+- `r2` - 包含 R2 存儲的 Worker
+
+## 開發
+
+### 前置需求
+
+- Node.js >= 18.0.0
+- npm
+- Git（用於 Git 相關功能）
+
+### 設置開發環境
+
+```bash
+# 安裝依賴
+npm install
+
+# 開發模式
+npm run dev
+
+# 建置專案
+npm run build
+
+# 執行類型檢查
+npm run type-check
+
+# 格式化代碼
+npm run format
+
+# 執行 Lint
+npm run lint
+```
+
+### 專案結構
+
+```
+src/
+├── index.ts # CLI 入口
+├── commands/ # 命令模組
+│   ├── create.ts # create 命令
+│   ├── list.ts # list 命令
+│   └── git.ts # git 命令組
+├── core/ # 核心功能
+│   ├── config.ts # 配置管理
+│   ├── filesystem.ts # 檔案系統操作
+│   ├── git.ts # Git 操作
+│   ├── prompt.ts # 互動問答
+│   ├── template-engine.ts # 模板引擎
+│   └── template-manager.ts # 模板管理
+├── utils/ # 工具函式
+│   └── logger.ts # 日誌工具
+└── types/ # TypeScript 類型
+    └── index.ts # 類型定義
+```
+
+## 技術棧
+
+- [Commander.js](https://github.com/tj/commander.js) - CLI 框架
+- [Inquirer.js](https://github.com/SBoudrias/Inquirer.js) - 互動式問答
+- [TypeScript](https://www.typescriptlang.org/) - 型別系統
+- [ESLint](https://eslint.org/) - 代碼檢查
+- [Prettier](https://prettier.io/) - 代碼格式化
+- [execa](https://github.com/sindresorhus/execa) - 進程執行
+
+## 授權
+
+MIT License

package/__tests__/cli-e2e.test.ts

@@ -0,0 +1,145 @@
+/**
+ * CLI E2E 整合測試
+ * 測試 CLI 命令行執行的完整流程
+ */
+
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import { execa } from 'execa';
+import { existsSync, rmSync, mkdirSync, readFileSync } from 'fs';
+import { join, resolve } from 'path';
+
+// 測試用的臨時目錄
+const TEST_DIR = resolve(__dirname, '__e2e_test_temp__');
+const CLI_PATH = resolve(__dirname, '../dist/index.js');
+
+/**
+ * 執行 CLI 命令
+ */
+async function runCLI(args: string[], options: { cwd?: string; input?: string } = {}) {
+  try {
+    const result = await execa('node', [CLI_PATH, ...args], {
+      cwd: options.cwd || process.cwd(),
+      input: options.input,
+      timeout: 10000,
+    });
+    return { success: true, stdout: result.stdout, stderr: result.stderr };
+  } catch (error: unknown) {
+    const err = error as { stdout?: string; stderr?: string; message?: string };
+    return {
+      success: false,
+      stdout: err.stdout || '',
+      stderr: err.stderr || err.message || '',
+    };
+  }
+}
+
+describe('CLI E2E Tests', () => {
+  beforeAll(() => {
+    // 確保 CLI 已建置
+    if (!existsSync(CLI_PATH)) {
+      throw new Error('CLI 尚未建置，請先執行 npm run build');
+    }
+
+    // 創建測試目錄
+    if (!existsSync(TEST_DIR)) {
+      mkdirSync(TEST_DIR, { recursive: true });
+    }
+  });
+
+  afterAll(() => {
+    // 清理測試目錄
+    if (existsSync(TEST_DIR)) {
+      rmSync(TEST_DIR, { recursive: true, force: true });
+    }
+  });
+
+  describe('CLI 基本命令', () => {
+    it('應該顯示版本信息', async () => {
+      const result = await runCLI(['--version']);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toMatch(/\d+\.\d+\.\d+/);
+    });
+
+    it('應該顯示幫助信息', async () => {
+      const result = await runCLI(['--help']);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toContain('cf-yoyo');
+      expect(result.stdout).toContain('Cloudflare');
+    });
+
+    it('應該在無參數時顯示幫助', async () => {
+      const result = await runCLI([]);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toContain('使用範例');
+    });
+  });
+
+  describe('list 命令', () => {
+    it('應該列出所有可用模板', async () => {
+      const result = await runCLI(['list']);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toContain('可用的專案模板');
+      expect(result.stdout).toContain('Worker');
+      expect(result.stdout).toContain('Pages');
+    });
+
+    it('應該根據類型過濾模板', async () => {
+      const result = await runCLI(['list', '--type', 'worker']);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toContain('Worker');
+    });
+
+    it('應該處理無效的類型過濾', async () => {
+      const result = await runCLI(['list', '--type', 'invalid-type']);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toContain('找不到符合類型');
+    });
+  });
+
+  describe('create 命令', () => {
+    it('應該顯示 create 幫助信息', async () => {
+      const result = await runCLI(['create', '--help']);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toContain('建立新的 Cloudflare 專案');
+    });
+
+    // 注意：完整 create 流程需要互動式輸入，此處僅測試命令行選項解析
+    it('應該接受 create 命令的選項', async () => {
+      const result = await runCLI(['create', '--help']);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toContain('--template');
+      expect(result.stdout).toContain('--type');
+    });
+  });
+
+  describe('git 命令', () => {
+    it('應該顯示 git 幫助信息', async () => {
+      const result = await runCLI(['git', '--help']);
+      expect(result.success).toBe(true);
+      expect(result.stdout).toContain('Git 相關操作');
+    });
+  });
+});
+
+describe('CLI 錯誤處理', () => {
+  it('應該處理不存在的命令', async () => {
+    const result = await runCLI(['nonexistent-command']);
+    expect(result.success).toBe(false);
+    expect(result.stderr).toContain('error');
+  });
+});
+
+describe('CLI 整合流程', () => {
+  it('應該正確初始化 CLI 程序', async () => {
+    // 測試 CLI 入口是否正確導入所有模組
+    const result = await runCLI(['--version']);
+    expect(result.success).toBe(true);
+    expect(result.stderr).toBe('');
+  });
+
+  it('應該支援完整的命令行參數解析', async () => {
+    const result = await runCLI(['list', '--type', 'pages']);
+    expect(result.success).toBe(true);
+    expect(result.stdout).toContain('Pages');
+  });
+});