coda-cli 1.0.0

package/LICENSE.md

@@ -0,0 +1,9 @@
+MIT License
+
+Copyright © 2026 Lasncod
+
+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

@@ -0,0 +1,76 @@
+# Code-Agent
+
+一款命令行工具，可以调用本地AI模型的编程助手，通过工程化、智能化集成方案，推动前端项目在架构、性能、安全、体验、效率、质量全面提升。
+
+# 🛠 技术栈
+
+- 核心语言: TypeScript (Target: ES2022, ModuleResolution: NodeNext)
+- 编译与路径处理: tsc + tsc-alias（支持同级目录 src 编译与路径别名 @/\*）
+- 交互与终端UI: inquirer（交互式问答）、ora（加载动画）、chalk（终端色彩）
+- 文件操作: fs-extra、glob
+- 执行模型: 基于生命周期的编排架构
+
+# 🏗 核心架构与生命周期
+
+本项目采用严谨的生命周期驱动模型，每个命令的执行流程均遵循以下阶段：
+
+1. init: 初始化全局状态与基础参数。
+2. prompt: 调动 Inquirer 收集用户交互输入。
+3. default: 核心计算与数据处理流程。
+4. writing: 文件模板生成、写入及配置文件更新。
+5. install: 自动拉取或安装所需依赖库。
+6. end: 执行收尾工作并输出成功或错误日志。
+
+# 📁 目录结构概览
+
+```text
+code-agent/
+├── src/
+│ ├── bin/ # code-agent执行命令的入口文件
+│ ├── cli-core/ # code-agent命令的核心生命周期、基类及状态管理
+│ ├── cli-api/ # code-agent底层工具封装（文件系统、git处理、子进程任务等）
+│ ├── config/ # 命令及全局配置文件
+│ ├── extensions/ # 实际业务命令（通过coda cmd create来生成命令模板并实现具体业务）
+│ ├── generator/ # 命令模板管理器（如 cmd-create生成新的命令模板, cmd-delete删除命令模板）
+│ ├── service/ # 公共服务（语言包、工具函数等）
+│ └── types/ # 公用的类型接口定义文件
+├── tsconfig.json # TypeScript 配置文件
+├── tsc-alias.json # 路径别名重写配置
+└── package.json # 项目配置与依赖管理
+```
+
+# 🚀 快速开始与开发指南
+
+1. 安装依赖
+   确保已安装 Node.js（推荐 22+ 或最新 LTS 版本），然后安装项目依赖：
+
+```
+Bash
+npm install
+```
+
+2. 构建与本地链接本项目支持 TypeScript 源码同级编译（src/ 到 src/），并配置了路径别名映射：
+
+```
+ Bash
+# 编译 TypeScript 并重写路径别名
+  npm run build
+
+# 将 CLI 工具链接到全局以便本地联调 (coda 命令)
+  npm run link
+```
+
+# 🐞 VS Code 调试配置
+
+点击vscode左侧栏“运行和调试”按钮，选中需要调试的命令再点运行即可。
+
+# 📜 可用脚本命令
+
+| 命令                       | 描述                                   |
+| :------------------------- | :------------------------------------- |
+| `npm run build`            | 编译 TypeScript 文件并自动转换路径别名 |
+| `npm run link`             | 构建并注册全局 coda 命令               |
+| `npm run debug_cmd-create` | 调试创建自定义命令流程                 |
+| `npm run debug_cmd-delete` | 调试删除自定义命令流程                 |
+
+📄**License**: [ISC](LICENSE)

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "coda-cli",
+  "version": "1.0.0",
+  "description": "一款命令行工具，可以调用本地AI模型的编程助手，通过工程化、智能化集成方案，推动前端项目在架构、性能、安全、体验、效率、质量全面提升。",
+  "scripts": {
+    "build": "tsc && tsc-alias --dir src",
+    "link": "npm run build && npm link"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Lanscod88/code-agent.git"
+  },
+  "keywords": [
+    "command line tools",
+    "AI agent"
+  ],
+  "author": "Lanscod",
+  "bin": {
+    "coda": "./src/bin/index.js"
+  },
+  "files": [
+    "src"
+  ],
+  "dependencies": {
+    "axios": "^1.7.3",
+    "chalk": "^6.0.1",
+    "del": "^9.0.1",
+    "fs-extra": "^11.4.1",
+    "@types/fs-extra": "^11.0.4",
+    "glob": "^13.0.6",
+    "npm-check-updates": "^23.1.1",
+    "ora": "^9.4.1",
+    "semver": "^7.8.5",
+    "@types/semver": "^7.8.0",
+    "inquirer": "^14.2.3",
+    "@types/inquirer": "^9.0.10"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.5",
+    "cross-env": "^7.0.3",
+    "typescript": "^7.0.2",
+    "tsc-alias": "^1.9.7"
+  }
+}

package/src/bin/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+import('../generator/startup.js');

package/src/bin/index.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../generator/startup.js');

package/src/cli-api/cmd.js

@@ -0,0 +1,86 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.childProcess = void 0;
+const child_process_1 = require("child_process");
+exports.childProcess = {
+    /**
+     * 执行命令
+     * @param cmd 命令
+     * @param dir 运行命令的目录
+     * @param showOutput 是否在控制台打印标准输出
+     */
+    cmdExecute(cmd, dir = process.cwd(), showOutput = false) {
+        (0, child_process_1.spawn)(cmd, {
+            cwd: dir,
+            stdio: showOutput === true ? 'inherit' : 'pipe',
+            shell: true,
+        });
+    },
+    /**
+     * 执行命令并返回异步结果
+     * @param cmd 命令
+     * @param dir 运行命令的目录
+     * @returns Promise 对象
+     */
+    asyncCmdExecuteResult(cmd, dir = process.cwd()) {
+        return new Promise(resolve => {
+            const cp = (0, child_process_1.spawn)(cmd, {
+                cwd: dir,
+                stdio: 'pipe',
+                shell: true,
+            });
+            let dataOk = '';
+            let dataError = '';
+            cp.stdout?.on('data', (data) => {
+                dataOk += data.toString().trim();
+            });
+            cp.stderr?.on('data', (data) => {
+                dataError += data.toString().trim();
+            });
+            cp.on('close', () => {
+                resolve({
+                    status: dataOk.length !== 0 ? 'success' : 'error',
+                    data: dataOk.length !== 0 ? dataOk : dataError,
+                });
+            });
+        });
+    },
+    /**
+     * 执行命令并同步返回结果
+     * @param cmd 命令
+     * @param dir 运行命令的目录
+     * @returns 执行结果字符串
+     */
+    syncCmdExecuteResult(cmd, dir = process.cwd()) {
+        const cp = (0, child_process_1.spawnSync)(cmd, {
+            cwd: dir,
+            stdio: 'pipe',
+            encoding: 'utf-8',
+            shell: true,
+        });
+        // 安全处理标准输出或错误输出，避免空指针异常
+        const message = cp.stdout && cp.stdout.length > 0 ? cp.stdout : cp.stderr || '';
+        return message.toString().trim();
+    },
+    /**
+     * 在新的控制台窗口中执行任务
+     * @param task 命令
+     * @param dir 运行命令的目录
+     * @param autoClose 执行完毕后控制台窗口是否自动关闭
+     */
+    taskInNewWindow(task, dir, autoClose) {
+        let cmd = autoClose ? `cmd /c ${task}` : `cmd /k ${task}`;
+        if (process.platform !== 'win32') {
+            cmd = `gnome-terminal -e 'bash -c "${task}; exec bash"'`;
+        }
+        (0, child_process_1.spawn)(cmd, {
+            cwd: dir,
+            stdio: ['pipe', 'pipe', 'pipe'],
+            shell: true,
+            detached: true,
+            windowsHide: true,
+        });
+        process.exit(0);
+    },
+};
+exports.default = exports.childProcess;

package/src/cli-api/cmd.ts

@@ -0,0 +1,104 @@
+import {spawn, spawnSync} from 'child_process';
+
+/**
+ * 异步命令执行结果接口
+ */
+export interface CmdResult {
+  status: 'success' | 'error';
+  data: string;
+}
+
+export const childProcess = {
+  /**
+   * 执行命令
+   * @param cmd 命令
+   * @param dir 运行命令的目录
+   * @param showOutput 是否在控制台打印标准输出
+   */
+  cmdExecute(cmd: string, dir: string = process.cwd(), showOutput: boolean = false): void {
+    spawn(cmd, {
+      cwd: dir,
+      stdio: showOutput === true ? 'inherit' : 'pipe',
+      shell: true,
+    });
+  },
+
+  /**
+   * 执行命令并返回异步结果
+   * @param cmd 命令
+   * @param dir 运行命令的目录
+   * @returns Promise 对象
+   */
+  asyncCmdExecuteResult(cmd: string, dir: string = process.cwd()): Promise<CmdResult> {
+    return new Promise(resolve => {
+      const cp = spawn(cmd, {
+        cwd: dir,
+        stdio: 'pipe',
+        shell: true,
+      });
+
+      let dataOk = '';
+      let dataError = '';
+
+      cp.stdout?.on('data', (data: Buffer) => {
+        dataOk += data.toString().trim();
+      });
+
+      cp.stderr?.on('data', (data: Buffer) => {
+        dataError += data.toString().trim();
+      });
+
+      cp.on('close', () => {
+        resolve({
+          status: dataOk.length !== 0 ? 'success' : 'error',
+          data: dataOk.length !== 0 ? dataOk : dataError,
+        });
+      });
+    });
+  },
+
+  /**
+   * 执行命令并同步返回结果
+   * @param cmd 命令
+   * @param dir 运行命令的目录
+   * @returns 执行结果字符串
+   */
+  syncCmdExecuteResult(cmd: string, dir: string = process.cwd()): string {
+    const cp = spawnSync(cmd, {
+      cwd: dir,
+      stdio: 'pipe',
+      encoding: 'utf-8',
+      shell: true,
+    });
+
+    // 安全处理标准输出或错误输出，避免空指针异常
+    const message = cp.stdout && cp.stdout.length > 0 ? cp.stdout : cp.stderr || '';
+    return message.toString().trim();
+  },
+
+  /**
+   * 在新的控制台窗口中执行任务
+   * @param task 命令
+   * @param dir 运行命令的目录
+   * @param autoClose 执行完毕后控制台窗口是否自动关闭
+   */
+  taskInNewWindow(task: string, dir: string, autoClose: boolean): void {
+    let cmd = autoClose ? `cmd /c ${task}` : `cmd /k ${task}`;
+
+    if (process.platform !== 'win32') {
+      cmd = `gnome-terminal -e 'bash -c "${task}; exec bash"'`;
+    }
+
+    spawn(cmd, {
+      cwd: dir,
+      stdio: ['pipe', 'pipe', 'pipe'],
+      shell: true,
+      detached: true,
+      windowsHide: true,
+    });
+
+    process.exit(0);
+  },
+};
+
+export default childProcess;

package/src/cli-api/data.js

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Data = void 0;
+exports.Data = {
+    /**
+     * 将数组转换为 Set
+     * @param arr 任意数组
+     * @returns Set 对象
+     */
+    arrayToSet(arr) {
+        return new Set(arr);
+    },
+    /**
+     * 将 Set 转换为数组
+     * @param set Set 对象
+     * @returns 数组对象
+     */
+    setToArray(set) {
+        return Array.from(set);
+    },
+    /**
+     * 获取两个数组的差集 (arrA 中有但 arrB 中没有的元素)
+     * @param arrA 数组 A
+     * @param arrB 数组 B
+     * @returns 差集数组
+     */
+    getDifferenceSet(arrA, arrB) {
+        const setA = new Set(arrA);
+        const setB = new Set(arrB);
+        const difference = new Set([...setA].filter(e => !setB.has(e)));
+        return Array.from(difference);
+    },
+    /**
+     * 获取两个数组的交集
+     * @param arrA 数组 A
+     * @param arrB 数组 B
+     * @returns 交集数组
+     */
+    getIntersectionSet(arrA, arrB) {
+        const setA = new Set(arrA);
+        const setB = new Set(arrB);
+        const intersection = new Set([...setA].filter(e => setB.has(e)));
+        return Array.from(intersection);
+    },
+    /**
+     * 获取两个数组的并集（合并并去重）
+     * @param arrA 数组 A
+     * @param arrB 数组 B
+     * @returns 并集数组
+     */
+    getUnionSet(arrA, arrB) {
+        const set = new Set([...arrA, ...arrB]);
+        return Array.from(set);
+    },
+    /**
+     * 获取数据的真实类型
+     * @param data 任意数据
+     * @returns 类型字符串 (如 String, Number, Boolean, Object 等)
+     */
+    getType(data) {
+        const temp = Object.prototype.toString.call(data);
+        return temp.substring(8, temp.length - 1);
+    },
+    /**
+     * 验证元素是否存在于数组中
+     * @param element 目标元素
+     * @param source 源数组
+     * @returns 是否存在
+     */
+    hasElement(element, source) {
+        let exist = false;
+        for (const e in source) {
+            if (source[e] === element) {
+                exist = true;
+                break;
+            }
+        }
+        return exist;
+    },
+    /**
+     * 向数组中添加元素（若不存在则添加）
+     * @param element 目标元素
+     * @param source 源数组
+     * @returns 更新后的数组
+     */
+    addElement(element, source) {
+        const newArr = source;
+        if (newArr.indexOf(element) === -1) {
+            newArr.push(element);
+        }
+        return newArr;
+    },
+    /**
+     * 数组排序（支持基础类型，或对象按指定唯一属性排序）
+     * @param array 源数组
+     * @param uniqueProp 对象用于排序的唯一属性名
+     * @returns 排序后的数组
+     */
+    arraySort(array, uniqueProp) {
+        const res = [];
+        const map = new Map();
+        array.forEach(item => {
+            const type = exports.Data.getType(item);
+            if (type === 'Object' && uniqueProp !== undefined) {
+                map.set(item[uniqueProp], item);
+            }
+            else {
+                res.push(item);
+                res.sort();
+            }
+        });
+        if (map.size !== 0 && uniqueProp !== undefined) {
+            const keys = [];
+            for (const key of map.keys()) {
+                keys.push(key);
+            }
+            keys.sort();
+            const newCmds = [];
+            keys.forEach(key => {
+                for (const index in array) {
+                    const uniquePropVal = array[index][uniqueProp];
+                    if (uniquePropVal === key) {
+                        newCmds.push(array[index]);
+                        break;
+                    }
+                }
+            });
+            return newCmds;
+        }
+        else {
+            return res;
+        }
+    },
+};
+exports.default = exports.Data;

package/src/cli-api/data.ts

@@ -0,0 +1,146 @@
+export const Data = {
+  /**
+   * 将数组转换为 Set
+   * @param arr 任意数组
+   * @returns Set 对象
+   */
+  arrayToSet<T>(arr: T[]): Set<T> {
+    return new Set(arr);
+  },
+
+  /**
+   * 将 Set 转换为数组
+   * @param set Set 对象
+   * @returns 数组对象
+   */
+  setToArray<T>(set: Set<T>): T[] {
+    return Array.from(set);
+  },
+
+  /**
+   * 获取两个数组的差集 (arrA 中有但 arrB 中没有的元素)
+   * @param arrA 数组 A
+   * @param arrB 数组 B
+   * @returns 差集数组
+   */
+  getDifferenceSet<T>(arrA: T[], arrB: T[]): T[] {
+    const setA = new Set(arrA);
+    const setB = new Set(arrB);
+    const difference = new Set([...setA].filter(e => !setB.has(e)));
+
+    return Array.from(difference);
+  },
+
+  /**
+   * 获取两个数组的交集
+   * @param arrA 数组 A
+   * @param arrB 数组 B
+   * @returns 交集数组
+   */
+  getIntersectionSet<T>(arrA: T[], arrB: T[]): T[] {
+    const setA = new Set(arrA);
+    const setB = new Set(arrB);
+    const intersection = new Set([...setA].filter(e => setB.has(e)));
+
+    return Array.from(intersection);
+  },
+
+  /**
+   * 获取两个数组的并集（合并并去重）
+   * @param arrA 数组 A
+   * @param arrB 数组 B
+   * @returns 并集数组
+   */
+  getUnionSet<T>(arrA: T[], arrB: T[]): T[] {
+    const set = new Set([...arrA, ...arrB]);
+    return Array.from(set);
+  },
+
+  /**
+   * 获取数据的真实类型
+   * @param data 任意数据
+   * @returns 类型字符串 (如 String, Number, Boolean, Object 等)
+   */
+  getType(data: unknown): string {
+    const temp = Object.prototype.toString.call(data);
+    return temp.substring(8, temp.length - 1);
+  },
+
+  /**
+   * 验证元素是否存在于数组中
+   * @param element 目标元素
+   * @param source 源数组
+   * @returns 是否存在
+   */
+  hasElement<T>(element: T, source: T[]): boolean {
+    let exist = false;
+
+    for (const e in source) {
+      if (source[e as unknown as keyof T[]] === element) {
+        exist = true;
+        break;
+      }
+    }
+
+    return exist;
+  },
+
+  /**
+   * 向数组中添加元素（若不存在则添加）
+   * @param element 目标元素
+   * @param source 源数组
+   * @returns 更新后的数组
+   */
+  addElement<T>(element: T, source: T[]): T[] {
+    const newArr = source;
+    if (newArr.indexOf(element) === -1) {
+      newArr.push(element);
+    }
+
+    return newArr;
+  },
+
+  /**
+   * 数组排序（支持基础类型，或对象按指定唯一属性排序）
+   * @param array 源数组
+   * @param uniqueProp 对象用于排序的唯一属性名
+   * @returns 排序后的数组
+   */
+  arraySort<T>(array: T[], uniqueProp?: keyof T): T[] {
+    const res: T[] = [];
+    const map = new Map<any, T>();
+
+    array.forEach(item => {
+      const type = Data.getType(item);
+      if (type === 'Object' && uniqueProp !== undefined) {
+        map.set(item[uniqueProp], item);
+      } else {
+        res.push(item);
+        res.sort();
+      }
+    });
+
+    if (map.size !== 0 && uniqueProp !== undefined) {
+      const keys: any[] = [];
+      for (const key of map.keys()) {
+        keys.push(key);
+      }
+      keys.sort();
+      const newCmds: T[] = [];
+      keys.forEach(key => {
+        for (const index in array) {
+          const uniquePropVal = array[index][uniqueProp];
+          if (uniquePropVal === key) {
+            newCmds.push(array[index]);
+            break;
+          }
+        }
+      });
+      return newCmds;
+    } else {
+      return res;
+    }
+  },
+};
+
+export default Data;

package/src/cli-api/date.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BDate = void 0;
+/**
+ * 日期工具类
+ */
+exports.BDate = {
+    /**
+     * 获取格式化后的日期字符串
+     * @param date Date 对象
+     * @returns 格式化后的日期字符串 (YYYY-MM-DD HH:mm:ss)
+     */
+    getFormatDate(date) {
+        const year = date.getFullYear();
+        const month = date.getMonth() >= 9 ? date.getMonth() + 1 : `0${date.getMonth() + 1}`;
+        const day = date.getDate() > 9 ? date.getDate() : `0${date.getDate()}`;
+        const hour = date.getHours() > 9 ? date.getHours() : `0${date.getHours()}`;
+        const minute = date.getMinutes() > 9 ? date.getMinutes() : `0${date.getMinutes()}`;
+        const second = date.getSeconds() > 9 ? date.getSeconds() : `0${date.getSeconds()}`;
+        return `${year}-${month}-${day} ${hour}:${minute}:${second}`;
+    },
+};
+exports.default = exports.BDate;

package/src/cli-api/date.ts

@@ -0,0 +1,22 @@
+/**
+ * 日期工具类
+ */
+export const BDate = {
+  /**
+   * 获取格式化后的日期字符串
+   * @param date Date 对象
+   * @returns 格式化后的日期字符串 (YYYY-MM-DD HH:mm:ss)
+   */
+  getFormatDate(date: Date): string {
+    const year = date.getFullYear();
+    const month = date.getMonth() >= 9 ? date.getMonth() + 1 : `0${date.getMonth() + 1}`;
+    const day = date.getDate() > 9 ? date.getDate() : `0${date.getDate()}`;
+    const hour = date.getHours() > 9 ? date.getHours() : `0${date.getHours()}`;
+    const minute = date.getMinutes() > 9 ? date.getMinutes() : `0${date.getMinutes()}`;
+    const second = date.getSeconds() > 9 ? date.getSeconds() : `0${date.getSeconds()}`;
+
+    return `${year}-${month}-${day} ${hour}:${minute}:${second}`;
+  },
+};
+
+export default BDate;

package/src/cli-api/event.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const events_1 = require("events");
+// 获取 EventEmitter 的原型对象
+const event = events_1.EventEmitter.prototype;
+exports.default = event;

package/src/cli-api/event.ts

@@ -0,0 +1,6 @@
+import {EventEmitter} from 'events';
+
+// 获取 EventEmitter 的原型对象
+const event = EventEmitter.prototype;
+
+export default event;