xuanwu-cli 1.0.0 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # xuanwu-cli
 
-玄武工厂平台 CLI 工具
+玄武工厂平台 CLI 工具 (v2.0)
 
 ## 快速开始
 
@@ -20,152 +20,202 @@ npm run build
 
 ```bash
 # 添加连接
-node bin/xuanwu connect add prod \
+xw connect add prod \
   --endpoint http://localhost:3000 \
   --token <your-api-token>
 ```
 
-### 4. 运行演示
+## 命令概览
 
-```bash
-./demo.sh
+```
+xw <resource> <action> [args] [flags]
 ```
 
-### 5. 运行验证测试
+### 资源命令
 
-```bash
-./verify.sh
-```
+| 命令 | 说明 |
+|------|------|
+| `xw connect` | 管理连接 |
+| `xw env` | 环境管理 (K8s namespace) |
+| `xw app` | 应用管理 (Application) |
+| `xw svc` | 服务管理 (K8s Deployment/Service) |
+| `xw build` | 构建管理 |
+| `xw deploy` | 部署服务 |
+| `xw scale` | 扩缩容 |
+| `xw logs` | 查看日志 |
+| `xw pods` | Pod 列表 |
 
-## 功能验证
+## 应用命令 (xw app)
 
-运行验证脚本以测试所有已实现的功能：
+使用 `code` 作为唯一标识符管理应用。
 
 ```bash
-./verify.sh
-```
+# 列出应用
+xw app list
+xw app ls
 
-验证内容包括：
-- ✅ 依赖检查（Node.js, jq, curl）
-- ✅ 后端服务连接
-- ✅ CLI 编译和执行
-- ✅ 用户认证（注册、登录）
-- ✅ 环境管理（列出、创建）
-- ✅ 服务管理（列出、查询）
-- ✅ 所有 CLI 命令
+# 查看应用
+xw app get <code>
+xw app describe <code>
 
-## 详细文档
+# 创建应用
+xw app create -n "用户服务" -c user-service --git https://github.com/example/user-service.git
 
-- [API 任务清单](../xuanwu-factory-v2/docs/tasks.md)
-- [功能验证报告](../xuanwu-factory-v2/docs/verification-report.md)
+# 更新应用
+xw app update <code> --name "新名称"
 
-## 当前状态
+# 删除应用
+xw app delete <code>
+xw app rm <code>
 
-**阶段 1 (基础功能)**: ✅ 完成
-- 环境管理 API
-- 服务管理 API
-- K8s 查询 API
-- 扩缩容 API
-- 用户认证 API
+# 触发构建
+xw app build <code> [--branch <name>]
 
-**验证结果**: 19/19 测试通过 ✅
+# 查看构建列表
+xw app builds <code> [--status SUCCESS|FAILED]
+```
 
-## 获取 API Token
+## 服务命令 (xw svc)
 
-### 方法1: Web 界面
+使用 `namespace/name` 格式管理 K8s 服务。
 
-登录平台后，进入 `用户菜单 → API Token` 创建新 Token
+```bash
+# 列出服务
+xw svc list --env <namespace>
+xw svc ls
 
-### 方法2: 命令行
+# 查看服务
+xw svc get <namespace>/<name>
 
-```bash
-# 登录获取 JWT Token
-curl -X POST http://localhost:3000/api/auth/login \
-  -H "Content-Type: application/json" \
-  -d '{"email": "your@email.com", "password": "password"}'
+# 服务状态
+xw svc status <namespace>/<name>
 
-# 使用 JWT Token 创建 API Token
-curl -X POST http://localhost:3000/api/users/api-tokens \
-  -H "Authorization: Bearer <jwt-token>" \
-  -H "Content-Type: application/json" \
-  -d '{"name": "cli-token"}'
-```
+# 查看日志
+xw svc logs <namespace>/<name> [-f] [--tail 100]
 
-## 快速开始
+# 重启服务
+xw svc restart <namespace>/<name>
+
+# 扩缩容
+xw svc scale <namespace>/<name> --replicas 3
 
-### 1. 配置连接
+# 进入容器
+xw svc exec <namespace>/<name> -it -- bash
+
+# 列出 Pods
+xw svc pods <namespace>/<name>
+
+# 删除服务
+xw svc delete <namespace>/<name>
+```
+
+## 构建命令 (xw build)
 
 ```bash
-xuanwu connect add prod --endpoint https://xuanwu.company.com --token your-token
+# 列出构建
+xw build list --app <code>
+xw build ls
+
+# 查看构建
+xw build get <id>
+
+# 取消构建
+xw build cancel <id>
 ```
 
-### 2. 环境管理
+## 环境命令 (xw env)
 
 ```bash
 # 列出环境
-xuanwu env ls
+xw env ls
 
 # 创建环境
-xuanwu env create shop-dev
+xw env create <namespace>
+
+# 删除环境
+xw env rm <namespace>
+
+# 环境详情
+xw env info <namespace>
 ```
 
-### 3. 部署服务
+## 部署命令 (xw deploy)
 
 ```bash
 # 部署镜像
-xuanwu deploy shop-dev nginx --type image --image nginx:latest
+xw deploy <namespace> <service> --type image --image nginx:latest
 
 # 部署数据库
-xuanwu deploy shop-dev mysql --type database --db-type mysql --db-version 8.0
+xw deploy <namespace> <service> --type database --db-type mysql
 
-# 部署应用（源码构建）
-xuanwu deploy shop --type application \
-  --git https-dev api://gitlab.com/user/repo.git \
-  --git-branch main \
-  --build-type template \
-  --language java-springboot
+# 部署应用
+xw deploy <namespace> <service> --type application --git https://...
 ```
 
-### 4. 查看服务
+## 获取 API Token
 
-```bash
-# 列出服务
-xuanwu svc ls shop-dev
+### 方法1: 注册新用户
 
-# 服务状态
-xuanwu svc status shop-dev nginx
+```bash
+curl -X POST http://localhost:3000/api/auth/register \
+  -H "Content-Type: application/json" \
+  -d '{"email": "your@email.com", "password": "password", "name": "Your Name"}'
 ```
 
-### 5. 调试
+### 方法2: 登录
 
 ```bash
-# 查看日志
-xuanwu logs shop-dev nginx -n 100
+curl -X POST http://localhost:3000/api/auth/login \
+  -H "Content-Type: application/json" \
+  -d '{"email": "your@email.com", "password": "password"}'
+```
+
+## 集成测试
 
-# 实时日志
-xuanwu logs shop-dev nginx -f
+运行集成测试验证 API 功能：
 
-# Pod 列表
-xuanwu pods shop-dev nginx
+```bash
+# 设置环境变量
+export XW_TOKEN="your-jwt-token"
+export XW_ENDPOINT="http://localhost:3000"
+
+# 运行测试
+node test/integration.js
 ```
 
-## 命令参考
+### 测试结果
 
-| 命令 | 说明 |
-|------|------|
-| `connect` | 管理连接 |
-| `env` | 环境管理 |
-| `deploy` | 部署服务 |
-| `svc` | 服务管理 |
-| `build` | 构建应用 |
-| `scale` | 扩缩容 |
-| `logs` | 查看日志 |
-| `pods` | Pod 列表 |
+```
+============================================================
+📊 测试报告 - CLI API v2.0
+============================================================
+总测试数: 17
+通过: 17 ✅
+失败: 0 ❌
+通过率: 100.0%
+============================================================
+```
 
 ## 输出格式
 
-默认输出人类可读格式，使用 `-o json` 切换到 JSON 格式：
+默认输出人类可读格式：
 
 ```bash
-xuanwu env ls -o json
+xw app list
 ```
+
+JSON 格式（需要程序化处理时使用）：
+
+```bash
+xw app list -o json
+```
+
+## 版本历史
+
+- **v2.0** - 基于新的 API v2.0 重构
+  - 使用 `code` 作为应用唯一标识
+  - 服务操作使用 `namespace/name` 格式
+  - 新增 `xw app` 命令
+  - 17/17 集成测试通过
+
+- **v1.0** - 初始版本

package/dist/api/client.d.ts

@@ -1,7 +1,7 @@
 /**
  * API 客户端
  */
-import { Connection, CLIResult, ServiceInfo, NamespaceInfo, DeployOptions } from '../config/types';
+import { Connection, CLIResult, ServiceInfo, NamespaceInfo, DeployOptions, Application, Build, CreateApplicationDto, UpdateApplicationDto, TriggerBuildOptions } from '../config/types';
 export declare class APIClient {
     private client;
     constructor(connection: Connection);
@@ -11,6 +11,8 @@ export declare class APIClient {
     deleteNamespace(id: string): Promise<CLIResult<void>>;
     getNamespaceInfo(identifier: string): Promise<CLIResult<any>>;
     getProjects(): Promise<CLIResult<any[]>>;
+    createProject(name: string, description?: string): Promise<CLIResult<any>>;
+    deleteProject(projectId: string): Promise<CLIResult<void>>;
     createNamespaceWithProject(name: string, projectId: string, environment?: string): Promise<CLIResult<any>>;
     listServices(namespace: string): Promise<CLIResult<ServiceInfo[]>>;
     getServiceStatus(namespace: string, name: string): Promise<CLIResult<any>>;
@@ -26,5 +28,27 @@ export declare class APIClient {
     listPods(namespace: string, serviceName: string): Promise<CLIResult<any>>;
     getMetrics(namespace: string, serviceName: string, podName?: string): Promise<CLIResult<any>>;
     exec(namespace: string, serviceName: string, command: string, podName?: string): Promise<CLIResult<any>>;
+    listApplications(): Promise<CLIResult<Application[]>>;
+    getApplication(code: string): Promise<CLIResult<Application>>;
+    createApplication(dto: CreateApplicationDto): Promise<CLIResult<Application>>;
+    updateApplication(code: string, dto: UpdateApplicationDto): Promise<CLIResult<Application>>;
+    deleteApplication(code: string): Promise<CLIResult<void>>;
+    triggerApplicationBuild(code: string, options?: TriggerBuildOptions): Promise<CLIResult<Build>>;
+    listApplicationBuilds(code: string): Promise<CLIResult<Build[]>>;
+    listK8sServices(namespace?: string): Promise<CLIResult<any>>;
+    getK8sService(namespace: string, name: string): Promise<CLIResult<any>>;
+    getK8sServiceStatus(namespace: string, name: string): Promise<CLIResult<any>>;
+    getK8sServiceLogs(namespace: string, name: string, lines?: number, follow?: boolean): Promise<CLIResult<any>>;
+    restartK8sService(namespace: string, name: string): Promise<CLIResult<any>>;
+    scaleK8sService(namespace: string, name: string, replicas: number): Promise<CLIResult<any>>;
+    execK8sService(namespace: string, name: string, command: string, podName?: string): Promise<CLIResult<any>>;
+    listK8sServicePods(namespace: string, name: string): Promise<CLIResult<any>>;
+    deleteK8sService(namespace: string, name: string): Promise<CLIResult<void>>;
+    listBuilds(options?: {
+        appCode?: string;
+        status?: string;
+    }): Promise<CLIResult<Build[]>>;
+    getBuild(id: string): Promise<CLIResult<Build>>;
+    cancelBuild(id: string): Promise<CLIResult<void>>;
 }
 export declare function createClient(connection: Connection): APIClient;

package/dist/api/client.js

@@ -79,6 +79,15 @@ class APIClient {
     async getProjects() {
         return this.request('GET', '/api/projects');
     }
+    async createProject(name, description) {
+        return this.request('POST', '/api/projects', {
+            name,
+            description: description || ''
+        });
+    }
+    async deleteProject(projectId) {
+        return this.request('DELETE', `/api/projects/${projectId}`);
+    }
     async createNamespaceWithProject(name, projectId, environment = 'development') {
         return this.request('POST', '/api/deploy-spaces', {
             name,
@@ -325,6 +334,89 @@ class APIClient {
             command
         });
     }
+    // ===================
+    // Application (CLI API - using code)
+    // ===================
+    async listApplications() {
+        return this.request('GET', '/api/cli/apps');
+    }
+    async getApplication(code) {
+        return this.request('GET', `/api/cli/apps/${code}`);
+    }
+    async createApplication(dto) {
+        return this.request('POST', '/api/applications', dto);
+    }
+    async updateApplication(code, dto) {
+        return this.request('PUT', `/api/cli/apps/${code}`, dto);
+    }
+    async deleteApplication(code) {
+        return this.request('DELETE', `/api/cli/apps/${code}`);
+    }
+    async triggerApplicationBuild(code, options) {
+        return this.request('POST', `/api/cli/apps/${code}/build`, options);
+    }
+    async listApplicationBuilds(code) {
+        return this.request('GET', `/api/cli/apps/${code}/builds`);
+    }
+    // ===================
+    // Service (CLI API - using ns/name)
+    // ===================
+    async listK8sServices(namespace) {
+        const url = namespace ? `/api/cli/services?namespace=${namespace}` : '/api/cli/services';
+        return this.request('GET', url);
+    }
+    async getK8sService(namespace, name) {
+        return this.request('GET', `/api/cli/services/${namespace}/${name}`);
+    }
+    async getK8sServiceStatus(namespace, name) {
+        return this.request('GET', `/api/cli/services/${namespace}/${name}/status`);
+    }
+    async getK8sServiceLogs(namespace, name, lines, follow) {
+        let url = `/api/cli/services/${namespace}/${name}/logs`;
+        const params = [];
+        if (lines)
+            params.push(`lines=${lines}`);
+        if (follow)
+            params.push(`follow=true`);
+        if (params.length > 0)
+            url += '?' + params.join('&');
+        return this.request('GET', url);
+    }
+    async restartK8sService(namespace, name) {
+        return this.request('POST', `/api/cli/services/${namespace}/${name}/restart`);
+    }
+    async scaleK8sService(namespace, name, replicas) {
+        return this.request('POST', `/api/cli/services/${namespace}/${name}/scale`, { replicas });
+    }
+    async execK8sService(namespace, name, command, podName) {
+        return this.request('POST', `/api/cli/services/${namespace}/${name}/exec`, { command, podName });
+    }
+    async listK8sServicePods(namespace, name) {
+        return this.request('GET', `/api/cli/services/${namespace}/${name}/pods`);
+    }
+    async deleteK8sService(namespace, name) {
+        return this.request('DELETE', `/api/cli/services/${namespace}/${name}`);
+    }
+    // ===================
+    // Build (CLI API)
+    // ===================
+    async listBuilds(options) {
+        let url = '/api/cli/builds';
+        const params = [];
+        if (options?.appCode)
+            params.push(`appCode=${options.appCode}`);
+        if (options?.status)
+            params.push(`status=${options.status}`);
+        if (params.length > 0)
+            url += '?' + params.join('&');
+        return this.request('GET', url);
+    }
+    async getBuild(id) {
+        return this.request('GET', `/api/cli/builds/${id}`);
+    }
+    async cancelBuild(id) {
+        return this.request('POST', `/api/cli/builds/${id}/cancel`);
+    }
 }
 exports.APIClient = APIClient;
 function createClient(connection) {

package/dist/commands/app.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 应用管理命令
+ */
+import { Command } from 'commander';
+export declare function makeAppCommand(): Command;