xuanwu-cli 1.0.0

package/dist/config/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * xuanwu-cli 类型定义
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * xuanwu-cli 主入口
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,142 @@
+"use strict";
+/**
+ * xuanwu-cli 主入口
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const connect_1 = require("./commands/connect");
+const env_1 = require("./commands/env");
+const deploy_1 = require("./commands/deploy");
+const svc_1 = require("./commands/svc");
+const build_1 = require("./commands/build");
+const scale_1 = require("./commands/scale");
+const logs_1 = require("./commands/logs");
+const pods_1 = require("./commands/pods");
+const program = new commander_1.Command();
+program
+    .name('xuanwu')
+    .description('玄武工厂平台 CLI 工具')
+    .version('1.0.0')
+    .option('-o, --output <format>', 'Output format (human|json)', 'human');
+// 添加子命令
+program.addCommand((0, connect_1.makeConnectCommand)());
+program.addCommand((0, env_1.makeEnvCommand)());
+program.addCommand((0, deploy_1.makeDeployCommand)());
+program.addCommand((0, svc_1.makeSvcCommand)());
+program.addCommand((0, build_1.makeBuildCommand)());
+program.addCommand((0, scale_1.makeScaleCommand)());
+program.addCommand((0, logs_1.makeLogsCommand)());
+program.addCommand((0, pods_1.makePodsCommand)());
+// 快捷命令：直接 deploy 也支持
+program
+    .command('up <namespace> <service-name>')
+    .description('Build and deploy a service')
+    .action(async (namespace, serviceName) => {
+    const { makeBuildCommand } = await Promise.resolve().then(() => __importStar(require('./commands/build')));
+    const buildCmd = makeBuildCommand();
+    // 简化：只调用部署
+    console.log('Use: xuanwu build <namespace> <service-name> && xuanwu deploy <namespace> <service-name>');
+});
+// restart 命令
+program
+    .command('restart <namespace> <service-name>')
+    .description('Restart a service')
+    .action(async (namespace, serviceName) => {
+    console.log('Restarting service... (not implemented)');
+});
+// exec 命令
+program
+    .command('exec <namespace> <service-name>')
+    .description('Execute command in container')
+    .option('-c, --command <cmd>', 'Command to execute', 'ls -la')
+    .option('-p, --pod <pod-name>', 'Specific pod name')
+    .action(async (namespace, serviceName, options) => {
+    const { configStore } = await Promise.resolve().then(() => __importStar(require('./config/store')));
+    const { createClient } = await Promise.resolve().then(() => __importStar(require('./api/client')));
+    const { OutputFormatter } = await Promise.resolve().then(() => __importStar(require('./output/formatter')));
+    const conn = configStore.getDefaultConnection();
+    if (!conn) {
+        OutputFormatter.error('No connection configured');
+        return;
+    }
+    const client = createClient(conn);
+    const result = await client.exec(namespace, serviceName, options.command, options.pod);
+    if (!result.success) {
+        OutputFormatter.error(result.error.message);
+        return;
+    }
+    const data = result.data;
+    if (data.stdout)
+        console.log(data.stdout);
+    if (data.stderr)
+        console.error(data.stderr);
+    if (data.exitCode !== 0) {
+        process.exit(data.exitCode);
+    }
+});
+// top 命令
+program
+    .command('top <namespace> <service-name>')
+    .description('Show resource usage')
+    .option('-p, --pod <pod-name>', 'Specific pod name')
+    .action(async (namespace, serviceName, options) => {
+    const { configStore } = await Promise.resolve().then(() => __importStar(require('./config/store')));
+    const { createClient } = await Promise.resolve().then(() => __importStar(require('./api/client')));
+    const { OutputFormatter } = await Promise.resolve().then(() => __importStar(require('./output/formatter')));
+    const conn = configStore.getDefaultConnection();
+    if (!conn) {
+        OutputFormatter.error('No connection configured');
+        return;
+    }
+    const client = createClient(conn);
+    const result = await client.getMetrics(namespace, serviceName, options.pod);
+    if (!result.success) {
+        OutputFormatter.error(result.error.message);
+        return;
+    }
+    const pods = result.data?.pods || [];
+    if (pods.length === 0) {
+        OutputFormatter.info('No pod metrics found');
+        return;
+    }
+    OutputFormatter.table(['Pod Name', 'CPU', 'Memory'], pods.map((p) => [
+        p.name,
+        p.containers?.[0]?.cpuRaw || 'N/A',
+        p.containers?.[0]?.memoryRaw || 'N/A'
+    ]));
+});
+// 解析参数
+program.parse(process.argv);

package/dist/output/formatter.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 输出格式化
+ */
+import { CLIResult } from '../config/types';
+export type OutputFormat = 'human' | 'json';
+export declare class OutputFormatter {
+    static format<T>(result: CLIResult<T>, format?: OutputFormat): string;
+    private static formatHuman;
+    private static formatItem;
+    private static formatObject;
+    static success(message: string): void;
+    static error(message: string): void;
+    static info(message: string): void;
+    static table(headers: string[], rows: string[][]): void;
+}

package/dist/output/formatter.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * 输出格式化
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OutputFormatter = void 0;
+class OutputFormatter {
+    static format(result, format = 'human') {
+        if (format === 'json') {
+            return JSON.stringify(result, null, 2);
+        }
+        return this.formatHuman(result);
+    }
+    static formatHuman(result) {
+        if (!result.success) {
+            const error = result.error;
+            return `✗ Error: ${error.message}`;
+        }
+        const data = result.data;
+        // 数组列表
+        if (Array.isArray(data)) {
+            if (data.length === 0) {
+                return '(empty)';
+            }
+            return data.map(item => this.formatItem(item)).join('\n');
+        }
+        // 对象详情
+        if (typeof data === 'object' && data !== null) {
+            return this.formatObject(data);
+        }
+        return String(data);
+    }
+    static formatItem(item) {
+        if (item.name) {
+            return `${item.name}`;
+        }
+        return JSON.stringify(item);
+    }
+    static formatObject(obj) {
+        const lines = [];
+        // Namespace 列表
+        if (obj.identifier !== undefined || obj.name !== undefined) {
+            lines.push(`Name: ${obj.identifier || obj.name}`);
+            if (obj.status)
+                lines.push(`Status: ${obj.status}`);
+            if (obj.environment)
+                lines.push(`Environment: ${obj.environment}`);
+            return lines.join('\n');
+        }
+        // Service 列表
+        if (Array.isArray(obj)) {
+            return obj.map((s) => {
+                let line = [
+                    s.name,
+                    s.type ? `(${s.type})` : '',
+                    s.status ? `→ ${s.status}` : ''
+                ].filter(Boolean).join(' ');
+                if (s.endpoint)
+                    line += `\n  ${s.endpoint}`;
+                return line;
+            }).join('\n\n');
+        }
+        // 单个对象
+        for (const [key, value] of Object.entries(obj)) {
+            if (value !== undefined && value !== null) {
+                lines.push(`${key}: ${JSON.stringify(value)}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    // 打印成功消息
+    static success(message) {
+        console.log(`✓ ${message}`);
+    }
+    // 打印错误消息
+    static error(message) {
+        console.error(`✗ ${message}`);
+    }
+    // 打印信息
+    static info(message) {
+        console.log(message);
+    }
+    // 打印表格
+    static table(headers, rows) {
+        const colWidths = headers.map((h, i) => Math.max(h.length, ...rows.map(r => String(r[i] || '').length)));
+        // Header
+        console.log(headers.map((h, i) => h.padEnd(colWidths[i])).join('  '));
+        console.log(colWidths.map(w => '-'.repeat(w)).join('  '));
+        // Rows
+        for (const row of rows) {
+            console.log(row.map((c, i) => String(c || '').padEnd(colWidths[i])).join('  '));
+        }
+    }
+}
+exports.OutputFormatter = OutputFormatter;

package/docs/DESIGN.md

@@ -0,0 +1,363 @@
+# xuanwu-cli 设计文档
+
+## 一、概述
+
+xuanwu-cli 是玄武工厂平台的命令行工具，用于通过命令行快速管理 K8s 环境和服务。支持环境创建、服务部署（应用/数据库/镜像）、构建、调试等操作。
+
+### 设计原则
+
+- **平台转发**: CLI 通过玄武工厂平台 API 转发请求，不直接连接 K8s
+- **K8s 优先**: 状态实时查询 K8s，无缓存
+- **最小配置**: 本地只保存连接信息
+- **权限由平台控制**: 用户可访问的空间由平台 RBAC 配置决定
+
+---
+
+## 二、架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      xuanwu-cli                           │
+│                          │                                 │
+│           ┌─────────────┴─────────────┐                   │
+│           │   玄武工厂平台 API         │                   │
+│           │   (endpoint + token)      │                   │
+│           └─────────────┬─────────────┘                   │
+│                       │                                    │
+│           ┌─────────────┴─────────────┐                   │
+│           │   K8s (平台已配置)         │                   │
+│           │   权限由平台 RBAC 控制     │                   │
+│           └───────────────────────────┘                   │
+└─────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 三、安装与配置
+
+### 安装
+
+```bash
+npm install -g xuanwu-cli
+```
+
+### 连接配置
+
+```bash
+# 配置平台连接
+xuanwu connect add <name> --endpoint <url> --token <api-token>
+
+# 示例
+xuanwu connect add prod --endpoint https://xuanwu.company.com --token sk-xxxxx
+
+# 列出连接
+xuanwu connect ls
+
+# 使用连接
+xuanwu connect use prod
+
+# 删除连接
+xuanwu connect rm prod
+```
+
+### 配置文件
+
+存储位置: `~/.xuanwu/config.json`
+
+```json
+{
+  "version": "1.0",
+  "connections": [
+    {
+      "name": "prod",
+      "endpoint": "https://xuanwu.company.com",
+      "token": "sk-xxxxx",
+      "isDefault": true
+    }
+  ]
+}
+```
+
+---
+
+## 四、命令参考
+
+### 1. 环境管理 (env)
+
+```bash
+# 列出可访问的环境
+xuanwu env ls
+
+# 创建环境（K8s namespace）
+xuanwu env create <namespace>
+
+# 查看环境详情
+xuanwu env info <namespace>
+
+# 删除环境
+xuanwu env rm <namespace>
+```
+
+### 2. 服务部署 (deploy)
+
+```bash
+# 部署应用（源码构建）
+xuanwu deploy <namespace> <service-name> \
+  --type application \
+  --git <repo-url> \
+  --git-branch <branch> \
+  --build-type template \
+  --language <java-springboot|nodejs|python|golang>
+
+# 部署应用（Dockerfile）
+xuanwu deploy <namespace> <service-name> \
+  --type application \
+  --git <repo-url> \
+  --build-type dockerfile \
+  --dockerfile-path <path>
+
+# 部署数据库
+xuanwu deploy <namespace> <service-name> \
+  --type database \
+  --db-type <mysql|redis|postgres|elasticsearch> \
+  --db-version <version>
+
+# 部署镜像
+xuanwu deploy <namespace> <service-name> \
+  --type image \
+  --image <image:tag>
+
+# 通用参数
+--port <port>              # 端口
+--replicas <num>          # 副本数
+--cpu <value>             # CPU 限制
+--memory <value>          # 内存限制
+--domain <prefix>         # 域名前缀
+--env KEY=VALUE           # 环境变量
+--volume <path:size>      # 持久化卷
+```
+
+### 3. 服务管理 (svc)
+
+```bash
+# 列出服务
+xuanwu svc ls <namespace>
+
+# 服务状态
+xuanwu svc status <namespace> <service-name>
+
+# 服务详情
+xuanwu svc describe <namespace> <service-name>
+
+# 删除服务
+xuanwu svc rm <namespace> <service-name>
+```
+
+### 4. 构建 (build)
+
+```bash
+# 构建服务
+xuanwu build <namespace> <service-name>
+
+# 构建状态
+xuanwu build status <namespace> <service-name>
+```
+
+### 5. 服务控制
+
+```bash
+# 扩缩容
+xuanwu scale <namespace> <service-name> -r <num>
+
+# 重启
+xuanwu restart <namespace> <service-name>
+
+# 启动
+xuanwu start <namespace> <service-name>
+
+# 停止
+xuanwu stop <namespace> <service-name>
+```
+
+### 6. 调试 (logs/exec)
+
+```bash
+# 查看日志
+xuanwu logs <namespace> <service-name>
+xuanwu logs <namespace> <service-name> -f      # 实时
+xuanwu logs <namespace> <service-name> -n 100  # 最近100行
+
+# 执行命令
+xuanwu exec <namespace> <service-name>
+xuanwu exec <namespace> <service-name> -- <command>
+
+# Pod 列表
+xuanwu pods <namespace> <service-name>
+
+# 资源使用
+xuanwu top <namespace> <service-name>
+```
+
+---
+
+## 五、使用示例
+
+### 示例1: 部署 MySQL
+
+```bash
+# 1. 配置连接
+xuanwu connect add dev --endpoint http://localhost:3000 --token dev-token
+
+# 2. 创建环境
+xuanwu env create shop-dev
+
+# 3. 部署 MySQL
+xuanwu deploy shop-dev mysql \
+  --type database \
+  --db-type mysql \
+  --db-version 8.0 \
+  --root-password mysecret
+
+# 4. 查看状态
+xuanwu svc status shop-dev mysql
+```
+
+### 示例2: 部署 Spring Boot 应用
+
+```bash
+# 1. 部署应用（源码构建）
+xuanwu deploy shop-dev api \
+  --type application \
+  --git https://gitlab.com/user/shop-api.git \
+  --git-branch main \
+  --build-type template \
+  --language java-springboot \
+  --env DB_HOST=mysql \
+  --env DB_PASSWORD=mysecret
+
+# 2. 构建
+xuanwu build shop-dev api
+
+# 3. 部署
+xuanwu deploy shop-dev api
+
+# 4. 查看状态
+xuanwu svc status shop-dev api
+```
+
+### 示例3: 部署 Nginx
+
+```bash
+xuanwu deploy shop-dev nginx \
+  --type image \
+  --image nginx:latest \
+  --port 80 \
+  --domain web
+```
+
+---
+
+## 六、输出格式
+
+### 人类可读（默认）
+
+```
+✓ Service deployed successfully
+  Namespace: shop-dev
+  Service: api
+  Type: application
+  Status: Running
+  Replicas: 2/2
+  Endpoint: https://api.shop-dev.dev.aimstek.cn
+```
+
+### JSON 模式 (-o json)
+
+```json
+{
+  "success": true,
+  "namespace": "shop-dev",
+  "service": "api",
+  "type": "application",
+  "status": "Running",
+  "replicas": "2/2",
+  "image": "registry.com/api:v1.0.0",
+  "endpoint": "https://api.shop-dev.dev.aimstek.cn",
+  "updatedAt": "2026-03-09T10:30:00Z"
+}
+```
+
+---
+
+## 七、API 映射
+
+| CLI 命令 | 平台 API | 说明 |
+|----------|----------|------|
+| `env ls` | `GET /api/deploy-spaces` | 列出空间 |
+| `env create` | `POST /api/deploy-spaces` | 创建空间 |
+| `env rm` | `DELETE /api/deploy-spaces/{id}` | 删除空间 |
+| `deploy` | `POST /api/services` + 部署 | 创建并部署服务 |
+| `svc ls` | `GET /api/k8s/deployments` | 列出服务 |
+| `svc status` | `GET /api/k8s/deployments/{name}` | 服务状态 |
+| `svc rm` | `DELETE /api/services/{id}` | 删除服务 |
+| `build` | `POST /api/applications/{id}/build` | 构建 |
+| `scale` | `POST /api/service-deploy-configs/{id}/scale` | 扩缩容 |
+| `logs` | `GET /api/k8s/logs` | 日志 |
+| `exec` | `POST /api/debug/pod-exec` | 容器执行 |
+| `pods` | `GET /api/k8s/pods` | Pod 列表 |
+
+---
+
+## 八、错误处理
+
+```json
+{
+  "success": false,
+  "error": {
+    "code": "UNAUTHORIZED",
+    "message": "Invalid or expired token",
+    "details": "Please run 'xuanwu connect use <name>' to set a valid connection"
+  }
+}
+```
+
+---
+
+## 九、环境变量
+
+| 变量 | 说明 |
+|------|------|
+| `XUANWU_ENDPOINT` | 平台 API 地址 |
+| `XUANWU_TOKEN` | API Token |
+| `XUANWU_OUTPUT` | 输出格式 (human/json) |
+
+---
+
+## 十、文件结构
+
+```
+xuanwu-cli/
+├── bin/
+│   └── xuanwu              # 入口脚本
+├── src/
+│   ├── index.ts            # 主入口
+│   ├── commands/
+│   │   ├── connect.ts      # 连接管理
+│   │   ├── env.ts          # 环境管理
+│   │   ├── deploy.ts       # 部署
+│   │   ├── svc.ts          # 服务管理
+│   │   ├── build.ts        # 构建
+│   │   ├── scale.ts        # 扩缩容
+│   │   ├── logs.ts         # 日志
+│   │   └── exec.ts         # 执行
+│   ├── api/
+│   │   └── client.ts       # HTTP 客户端
+│   ├── config/
+│   │   ├── store.ts        # 配置存储
+│   │   └── types.ts        # 类型定义
+│   └── output/
+│       └── formatter.ts    # 输出格式化
+├── package.json
+├── tsconfig.json
+└── README.md
+```