From 5bf641838afb90a5d1562775b97bd17c9a142d9f Mon Sep 17 00:00:00 2001 From: zhengwr Date: Wed, 17 Jun 2026 07:47:22 +0800 Subject: [PATCH] feat: add EIP4 agent CLI and skills plan --- README.md | 5 + docs/AI_AGENT_AUTO_DEVELOPMENT.md | 21 ++ docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md | 167 +++++++++ docs/skills/README.md | 20 ++ docs/skills/eip4-ai-feature-development.md | 66 ++++ docs/skills/eip4-env-manage.md | 34 ++ docs/skills/eip4-release-manage.md | 39 +++ docs/架构设计.md | 1 + platform-cli/pom.xml | 56 +++ .../java/com/eip4/platform/cli/Eip4Cli.java | 328 ++++++++++++++++++ .../com/eip4/platform/cli/Eip4HttpClient.java | 10 + .../eip4/platform/cli/Eip4HttpResponse.java | 7 + .../eip4/platform/cli/JdkEip4HttpClient.java | 39 +++ .../com/eip4/platform/cli/Eip4CliTest.java | 136 ++++++++ pom.xml | 6 + 15 files changed, 935 insertions(+) create mode 100644 docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md create mode 100644 docs/skills/README.md create mode 100644 docs/skills/eip4-ai-feature-development.md create mode 100644 docs/skills/eip4-env-manage.md create mode 100644 docs/skills/eip4-release-manage.md create mode 100644 platform-cli/pom.xml create mode 100644 platform-cli/src/main/java/com/eip4/platform/cli/Eip4Cli.java create mode 100644 platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpClient.java create mode 100644 platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpResponse.java create mode 100644 platform-cli/src/main/java/com/eip4/platform/cli/JdkEip4HttpClient.java create mode 100644 platform-cli/src/test/java/com/eip4/platform/cli/Eip4CliTest.java diff --git a/README.md b/README.md index 9049822..aa4b8e4 100644 --- a/README.md +++ b/README.md @@ -13,6 +13,7 @@ EIP4 平台正式工程(路线 A'):双层制模块化单体——**保真层供 | platform-converter | 模板转换器(P4) | 可独立 CLI 跑批 | | platform-flow-gateway | P3 占位:Flowable 网关 | | | platform-ai | P5 AI Agent 开发底座:草稿/变更包/本地门禁/自动修复/人工部署包 | Agent 不直连线上执行生产变更 | +| platform-cli | EIP4 Agent 受控命令入口:环境探测、AI 自动开发、后续发布编排 | Agent 优先通过 CLI/API 操作 | | platform-parity | C1 对拍框架:录制/重放/RowDiff/自对拍 CLI | P1 一级交付物 | | platform-app | Boot 启动器,组装全部模块 | ArchUnit 规则在此模块测试里 | @@ -75,6 +76,10 @@ java -cp "$CP" com.eip4.platform.parity.selfcheck.ParityCli --privilege # C # 指向 eip4dev 自对拍: mvn -pl platform-parity exec:java -Dexec.mainClass="com.eip4.platform.parity.selfcheck.ParityCli" \ "-Dexec.args=--discover --jdbc=jdbc:postgresql://localhost:5433/eip4dev?currentSchema=eip3 --engine=http://localhost:8093 --out=parity-reports/eip4dev" + +# EIP4 Agent CLI +mvn -pl platform-cli package +java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --base-url http://localhost:8084 ``` ## tools/ diff --git a/docs/AI_AGENT_AUTO_DEVELOPMENT.md b/docs/AI_AGENT_AUTO_DEVELOPMENT.md index 54b7dd7..4fa8717 100644 --- a/docs/AI_AGENT_AUTO_DEVELOPMENT.md +++ b/docs/AI_AGENT_AUTO_DEVELOPMENT.md @@ -36,6 +36,27 @@ JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTe ## 请求示例 +推荐优先使用 `platform-cli`,让 Agent 通过稳定命令入口操作自动开发链路: + +```bash +mvn -pl platform-cli package +java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \ + --base-url http://localhost:8093 \ + --objective "新增客户等级维护功能" \ + --feature-name "客户等级维护" \ + --table-name EIP4AI_CUSTOMER_LEVEL \ + --entity-name "客户等级" \ + --template-id eip4ai-customer-level \ + --menu-name "客户等级维护" \ + --field NAME:名称:string:100:true \ + --field CODE:编码:string:64:true \ + --field ENABLED:启用:boolean::false \ + --max-repair-attempts 2 \ + --output target/ai-runs/customer-level.json +``` + +底层 REST API 仍可直接调用: + ```bash curl -X POST http://localhost:8093/api/ai/features/auto-develop \ -H 'Content-Type: application/json' \ diff --git a/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md b/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md new file mode 100644 index 0000000..40f1776 --- /dev/null +++ b/docs/AI_AGENT_Nocobase_ADOPTION_PLAN.md @@ -0,0 +1,167 @@ +# AI Agent 借鉴 NocoBase 的落地路线 + +日期:2026-06-17 + +本文记录 EIP4 对 NocoBase AI + no-code 体系的可借鉴点和落地顺序。目标不是照搬 NocoBase 的 TypeScript 插件运行时,而是吸收它的工程边界:核心平台稳定、业务能力包化、AI 通过受控 CLI/API 操作、所有变更可审计、可验证、可回滚。 + +参考: + +- NocoBase README: https://github.com/nocobase/nocobase +- NocoBase Plugin Development: https://docs.nocobase.com/plugin-development/ +- NocoBase Project Structure: https://docs.nocobase.com/plugin-development/project-structure +- NocoBase AI Builder: https://docs.nocobase.com/ai-builder/ +- NocoBase AI Plugin Development: https://docs.nocobase.com/ai-dev/ +- NocoBase CLI: https://docs.nocobase.com/api/cli/ +- NocoBase Skills: https://github.com/nocobase/skills + +## 一、判断 + +NocoBase 最核心的启发是:AI 不应该默认直接写一堆业务代码,而是基于平台已有的可配置能力工作。AI 负责把自然语言需求转换为数据模型、页面配置、工作流、权限和发布包,人负责审核关键边界。 + +EIP4 当前已经有实体、页面 schema、服务流、菜单、smoke、部署包这些受控对象,因此更适合走“AI 操作元数据和发布包”的路线,而不是引入一套新的插件运行时。 + +## 二、可借鉴点 + +| NocoBase 做法 | EIP4 对应落点 | 处理方式 | +|---|---|---| +| AI 基于 no-code 基础设施工作 | `platform-ai` 生成实体/页面/服务流/菜单草稿 | 已落地,继续收敛到受控接口 | +| CLI 作为 Agent 操作入口 | `platform-cli` | P1 建立,后续扩展环境/发布/回滚 | +| Skills 让 Agent 理解平台 | `docs/skills/` | P1 建立规范骨架 | +| 插件生命周期 | EIP4 `FeaturePackage` 生命周期 | P2 设计和持久化 | +| 版本控制/里程碑回滚 | `SYS_AI_REVISION` / release evidence | P2-P3 | +| FlowEngine 的可配置模型 | EIP4 typed page schema + component registry | P4 借鉴思想,不照搬实现 | + +## 三、落地顺序 + +### P0:全自动开发主链路 + +状态:已完成。 + +完成内容: + +- `POST /api/ai/features/auto-develop` +- 草稿生成、变更包、release plan、本地 apply、smoke、自动修复、人工部署包 +- JDBC 审计和运行证据 +- 本地 jar 验证通过 + +验收标准: + +- 本地可从一段功能需求生成可审核部署包 +- 线上执行仍停在人审边界 + +### P1:受控入口和 Agent 知识包 + +状态:第一版完成。 + +目标: + +- 建立 `platform-cli`,让 Agent 通过命令调用 EIP4,而不是直接猜 HTTP 接口或直连数据库。 +- 建立 `docs/skills/`,把 EIP4 的环境管理、自动开发、发布管理写成 Agent 可复用的操作规程。 + +本阶段交付: + +- `eip4 env status` +- `eip4 ai auto-develop` +- `docs/skills/eip4-env-manage.md` +- `docs/skills/eip4-ai-feature-development.md` +- `docs/skills/eip4-release-manage.md` + +验收标准: + +- CLI 单测覆盖命令解析和请求组装 +- README 和自动开发文档给出 CLI 用法 +- Agent 后续操作优先引用 Skills 和 CLI + +### P2:FeaturePackage 和里程碑版本 + +目标: + +- 把 AI 生成结果从松散的 draft/change-set 升级为稳定的 `FeaturePackage`。 +- 保存里程碑版本,支持本地回滚和线上部署前差异确认。 + +建议对象: + +- `FeaturePackage`: manifest、entity、serviceflow、page schema、menu、acl、sql、rollback、smoke、evidence +- `SYS_AI_FEATURE_PACKAGE` +- `SYS_AI_REVISION` + +验收标准: + +- 一个功能包可以导出、导入、重复校验 +- 每个通过 smoke 的里程碑都能追溯输入、输出、测试证据和回滚脚本 + +### P3:发布、回滚和环境治理 + +目标: + +- CLI 扩展为环境管理和发布编排入口。 +- 建立本地、测试、生产环境的只读探测、部署前检查和人工批准边界。 + +建议命令: + +- `eip4 env list/use/status` +- `eip4 release package` +- `eip4 release verify` +- `eip4 release apply --require-approval` +- `eip4 release rollback --package-id` + +验收标准: + +- 默认不能连接线上执行写操作 +- 生产写操作必须有显式环境、审批标记和部署包 +- 发布失败能用结构化 evidence 回到本地修复链路 + +### P4:Typed Page Schema 和组件注册表 + +目标: + +- 借鉴 NocoBase FlowEngine 的“可配置模型”思想,把页面 block、field、action、linkage 抽象为 typed schema。 +- 让 AI 和人工设计器操作同一份 schema。 + +验收标准: + +- 页面 schema 有版本、类型、组件能力表和校验器 +- AI 只能选择注册过的组件和动作 +- 设计器变更和 AI 变更能互相接续 + +### P5:多 Agent 协作和 AI 员工 + +目标: + +- 在平台内提供面向业务用户的 AI 助手能力,而不只是在开发侧使用 Agent。 + +建议方向: + +- 数据分析 Agent +- 表单配置 Agent +- 服务流诊断 Agent +- 权限风险审查 Agent +- 发布审计 Agent + +验收标准: + +- 每个 Agent 有独立权限、审计、工具白名单 +- 业务侧操作和开发侧操作共用平台审计模型 + +## 四、不照搬的部分 + +NocoBase 是 TypeScript/Yarn workspace/插件包体系。EIP4 是 Java/Spring/Maven,并且必须兼容 EIP3 的实体、服务流和 XML 模板迁移路径。直接照搬 NocoBase 插件运行时会引入过高迁移成本。 + +EIP4 应该借鉴的是边界和流程: + +1. 稳定核心能力。 +2. 业务功能包化。 +3. Agent 通过 CLI/API 操作。 +4. 人审控制生产变更。 +5. 每一步有 evidence、版本和回滚。 + +## 五、当前推进状态 + +| 阶段 | 状态 | 说明 | +|---|---|---| +| P0 | 完成 | `platform-ai` 主链路已提交 | +| P1 | 第一版完成 | 已新增 `platform-cli` 和 Skills 规范骨架 | +| P2 | 待开始 | 依赖 P1 的 CLI 和规范稳定 | +| P3 | 待开始 | 依赖 P2 的功能包和版本模型 | +| P4 | 待开始 | 依赖页面 schema 现状清理 | +| P5 | 待开始 | 依赖权限、审计、工具白名单成熟 | diff --git a/docs/skills/README.md b/docs/skills/README.md new file mode 100644 index 0000000..381deb5 --- /dev/null +++ b/docs/skills/README.md @@ -0,0 +1,20 @@ +# EIP4 Agent Skills + +本目录是 EIP4 给 AI Agent 使用的领域操作规程。目标是让 Codex、Claude Code、Cursor、OpenCode 等 Agent 都按同一套规则操作 EIP4,而不是临时猜接口、猜表结构或直连线上库。 + +## Skills + +| Skill | 用途 | +|---|---| +| `eip4-env-manage` | 环境探测、启动检查、端口和 profile 边界 | +| `eip4-ai-feature-development` | 从自然语言需求生成实体、服务流、页面、菜单和本地 smoke | +| `eip4-release-manage` | 部署包、人审、发布前校验和回滚边界 | + +## 通用原则 + +1. 优先使用 `platform-cli`,其次使用公开 REST API,最后才考虑人工 SQL。 +2. 默认只允许本地开发和测试环境自动执行写操作。 +3. 线上环境只能生成部署包和校验证据,不能由 Agent 默认直接写入。 +4. 每次自动开发必须保留 request、draft、change-set、apply、smoke、repair、deployment package evidence。 +5. 任何失败先回到本地复现和修复,再重新生成部署包。 + diff --git a/docs/skills/eip4-ai-feature-development.md b/docs/skills/eip4-ai-feature-development.md new file mode 100644 index 0000000..bad8dd5 --- /dev/null +++ b/docs/skills/eip4-ai-feature-development.md @@ -0,0 +1,66 @@ +# Skill: eip4-ai-feature-development + +## 触发场景 + +- 用户描述一个新功能,希望 AI 自动生成。 +- 用户要求从 EIP3 模板、实体、服务流或页面定义生成 EIP4 功能。 +- 用户要求本地自动开发、自动修复和 smoke。 + +## 输入要求 + +最小需求应包含: + +- 功能目标 +- 功能名称 +- 业务表名 +- 实体名称 +- 页面 templateId +- 菜单名称 +- 字段列表 + +字段格式: + +```text +column:label:type[:length][:required] +``` + +示例: + +```text +NAME:名称:string:100:true +CODE:编码:string:64:true +ENABLED:启用:boolean::false +``` + +## 推荐命令 + +```bash +java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar ai auto-develop \ + --base-url http://localhost:8084 \ + --objective "新增客户等级维护功能" \ + --feature-name "客户等级维护" \ + --table-name EIP4AI_CUSTOMER_LEVEL \ + --entity-name "客户等级" \ + --template-id eip4ai-customer-level \ + --menu-name "客户等级维护" \ + --field NAME:名称:string:100:true \ + --field CODE:编码:string:64:true \ + --field ENABLED:启用:boolean::false \ + --max-repair-attempts 2 \ + --output target/ai-runs/customer-level.json +``` + +## 通过标准 + +- `applyStatus` 为 `PASSED`。 +- `smokeStatus` 为 `PASSED`。 +- 最终状态为 `READY_FOR_HUMAN_REVIEW`。 +- 部署包存在且 `requiresHumanApproval=true`。 + +## 失败处理 + +1. 查看输出 JSON 中的 apply/smoke/repair evidence。 +2. 如果自动修复已尝试但失败,基于 evidence 修改本地代码或元数据生成逻辑。 +3. 重新运行本地 auto-develop。 +4. 不直接连接线上库修复。 + diff --git a/docs/skills/eip4-env-manage.md b/docs/skills/eip4-env-manage.md new file mode 100644 index 0000000..252aee9 --- /dev/null +++ b/docs/skills/eip4-env-manage.md @@ -0,0 +1,34 @@ +# Skill: eip4-env-manage + +## 触发场景 + +- 用户要求启动、检查或切换 EIP4 环境。 +- 用户要求 Agent 在本地验证功能。 +- 用户要求确认当前服务是否可被 AI 自动开发链路使用。 + +## 操作规则 + +1. 确认当前目录是否是独立 worktree,避免污染用户正在做的任务。 +2. 使用 JDK 21,不能使用 JDK 26。 +3. 默认本地 profile: + - `local`: `http://localhost:8084` + - `dev`: `http://localhost:8093` +4. 使用 CLI 探测环境: + +```bash +java -jar platform-cli/target/platform-cli-0.1.0-SNAPSHOT.jar env status --base-url http://localhost:8084 +``` + +5. 如果服务未启动,优先使用重新打包后的 jar: + +```bash +JAVA_HOME=/opt/homebrew/opt/openjdk@21 mvn -pl platform-app -am install -DskipTests +/opt/homebrew/opt/openjdk@21/bin/java -jar platform-app/target/platform-app-0.1.0-SNAPSHOT.jar --spring.profiles.active=local +``` + +## 禁止事项 + +- 不在用户原始任务目录中直接改动或启动长时间任务,除非用户明确要求。 +- 不把线上环境设置为默认写入目标。 +- 不跳过 JDK 版本检查。 + diff --git a/docs/skills/eip4-release-manage.md b/docs/skills/eip4-release-manage.md new file mode 100644 index 0000000..98e4f11 --- /dev/null +++ b/docs/skills/eip4-release-manage.md @@ -0,0 +1,39 @@ +# Skill: eip4-release-manage + +## 触发场景 + +- 用户要求生成部署包。 +- 用户要求发布 AI 生成的功能。 +- 用户要求线上 bug 修复或回滚。 + +## 当前边界 + +当前 `platform-ai` 只生成线上人工部署包,不自动连接线上环境执行写操作。这是设计边界,不是功能缺失。 + +## 发布前检查 + +1. 确认本地 auto-develop 已通过。 +2. 确认部署包包含: + - manifest + - SQL 草案 + - rollback SQL + - 本地 apply evidence + - smoke evidence + - repair evidence +3. 确认部署包需要人工审批。 +4. 如果包含 `${parentMenuId}` 等占位符,必须人工替换并复核。 + +## 线上 bug 修复路径 + +1. 收集线上错误日志、请求样本或人工复现步骤。 +2. 在本地创建新的 AI 修复任务。 +3. 本地执行 apply/smoke/repair。 +4. 生成新的部署包。 +5. 人工审核后走现有上线流程。 + +## 禁止事项 + +- 不让 Agent 默认直接写线上数据库。 +- 不绕过部署包和人审。 +- 不把 smoke 失败的变更包交给发布流程。 + diff --git a/docs/架构设计.md b/docs/架构设计.md index fd75ffe..19ebd59 100644 --- a/docs/架构设计.md +++ b/docs/架构设计.md @@ -19,6 +19,7 @@ eip4-platform(Maven 多模块单体) ├── platform-flow-gateway Flowable REST 客户端、待办聚合、3 个 handler bean ├── platform-converter 模板转换器 + S3 脚本改写器(可独立 CLI 跑批) ├── platform-ai AI Agent 开发底座、schema 双闸校验、自动修复、本地门禁和人工部署包 +├── platform-cli EIP4 Agent 受控命令入口:环境探测、AI 自动开发、后续发布编排 ├── platform-parity C1 逐行对拍框架:录制/重放/逐行 diff(P1 一级交付物,可独立 CLI 跑批) └── platform-app Spring Boot 启动器,组装上述模块 ``` diff --git a/platform-cli/pom.xml b/platform-cli/pom.xml new file mode 100644 index 0000000..653ebd3 --- /dev/null +++ b/platform-cli/pom.xml @@ -0,0 +1,56 @@ + + + 4.0.0 + + com.eip4 + eip4-platform + 0.1.0-SNAPSHOT + + platform-cli + platform-cli + EIP4 Agent 受控命令入口:环境探测、AI 自动开发、发布前门禁编排 + + + + com.fasterxml.jackson.core + jackson-databind + + + org.junit.jupiter + junit-jupiter + test + + + + + + + org.apache.maven.plugins + maven-assembly-plugin + 3.7.1 + + + + com.eip4.platform.cli.Eip4Cli + + + + jar-with-dependencies + + false + + + + make-assembly + package + + single + + + + + + + diff --git a/platform-cli/src/main/java/com/eip4/platform/cli/Eip4Cli.java b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4Cli.java new file mode 100644 index 0000000..bf4ca56 --- /dev/null +++ b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4Cli.java @@ -0,0 +1,328 @@ +package com.eip4.platform.cli; + +import java.io.IOException; +import java.io.PrintStream; +import java.net.URI; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; +import java.util.ArrayList; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Locale; +import java.util.Map; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.node.ArrayNode; +import com.fasterxml.jackson.databind.node.ObjectNode; + +public final class Eip4Cli { + + private static final String DEFAULT_BASE_URL = "http://localhost:8084"; + + private final ObjectMapper objectMapper; + private final Eip4HttpClient httpClient; + + public Eip4Cli(Eip4HttpClient httpClient) { + this.objectMapper = new ObjectMapper(); + this.httpClient = httpClient; + } + + public static void main(String[] args) { + ObjectMapper objectMapper = new ObjectMapper(); + int code = new Eip4Cli(new JdkEip4HttpClient(objectMapper)).run(args, System.out, System.err); + if (code != 0) { + System.exit(code); + } + } + + int run(String[] args, PrintStream out, PrintStream err) { + try { + if (args.length == 0 || isHelp(args[0])) { + printHelp(out); + return 0; + } + return switch (args[0]) { + case "env" -> runEnv(args, out, err); + case "ai" -> runAi(args, out, err); + default -> fail(err, "Unknown command: " + args[0]); + }; + } catch (IllegalArgumentException ex) { + return fail(err, ex.getMessage()); + } catch (IOException ex) { + return fail(err, "I/O failed: " + ex.getMessage()); + } catch (InterruptedException ex) { + Thread.currentThread().interrupt(); + return fail(err, "Interrupted"); + } + } + + private int runEnv(String[] args, PrintStream out, PrintStream err) throws IOException, InterruptedException { + if (args.length < 2 || isHelp(args[1])) { + printEnvHelp(out); + return 0; + } + if (!"status".equals(args[1])) { + return fail(err, "Unknown env command: " + args[1]); + } + Options options = Options.parse(args, 2); + String baseUrl = baseUrl(options); + URI uri = endpoint(baseUrl, "/v3/api-docs"); + Eip4HttpResponse response = httpClient.send("GET", uri, null); + if (!response.successful()) { + err.println("EIP4 env NOT_READY"); + err.println("baseUrl: " + baseUrl); + err.println("status: " + response.statusCode()); + return 2; + } + out.println("EIP4 env READY"); + out.println("baseUrl: " + baseUrl); + out.println("apiDocs: " + uri); + return 0; + } + + private int runAi(String[] args, PrintStream out, PrintStream err) throws IOException, InterruptedException { + if (args.length < 2 || isHelp(args[1])) { + printAiHelp(out); + return 0; + } + if (!"auto-develop".equals(args[1])) { + return fail(err, "Unknown ai command: " + args[1]); + } + Options options = Options.parse(args, 2); + ObjectNode request = buildAutoDevelopRequest(options); + String baseUrl = baseUrl(options); + Eip4HttpResponse response = httpClient.send( + "POST", + endpoint(baseUrl, "/api/ai/features/auto-develop"), + request); + if (!response.successful()) { + err.println("AI auto-develop failed"); + err.println("status: " + response.statusCode()); + err.println(response.body()); + return 2; + } + JsonNode body = response.body().isBlank() + ? objectMapper.createObjectNode() + : objectMapper.readTree(response.body()); + String formatted = objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(body); + String output = options.single("output"); + if (output == null) { + out.println(formatted); + } else { + Path outputPath = Path.of(output); + if (outputPath.getParent() != null) { + Files.createDirectories(outputPath.getParent()); + } + Files.writeString(outputPath, formatted + System.lineSeparator(), StandardCharsets.UTF_8); + out.println("Wrote run result: " + outputPath.toAbsolutePath()); + printAutoDevelopSummary(body, out); + } + return 0; + } + + private ObjectNode buildAutoDevelopRequest(Options options) { + ObjectNode root = objectMapper.createObjectNode(); + String baseUrl = baseUrl(options); + root.put("baseUrl", baseUrl); + root.put("generateDeploymentPackage", !options.has("no-deployment-package")); + String maxRepairAttempts = options.single("max-repair-attempts"); + if (maxRepairAttempts != null) { + root.put("maxRepairAttempts", parseInt(maxRepairAttempts, "max-repair-attempts")); + } + + ObjectNode feature = root.putObject("feature"); + putRequired(feature, "objective", options, "objective"); + putRequired(feature, "featureName", options, "feature-name"); + putRequired(feature, "tableName", options, "table-name"); + putRequired(feature, "entityName", options, "entity-name"); + putRequired(feature, "templateId", options, "template-id"); + putRequired(feature, "menuName", options, "menu-name"); + + List fields = options.values("field"); + if (fields.isEmpty()) { + throw new IllegalArgumentException("Missing required option: --field"); + } + ArrayNode fieldNodes = feature.putArray("fields"); + for (String field : fields) { + fieldNodes.add(parseField(field)); + } + return root; + } + + private ObjectNode parseField(String spec) { + String[] parts = spec.split(":", -1); + if (parts.length < 3 || parts.length > 5) { + throw new IllegalArgumentException("Invalid --field, expected column:label:type[:length][:required]"); + } + ObjectNode node = objectMapper.createObjectNode(); + node.put("column", requiredPart(parts[0], "field column")); + node.put("label", requiredPart(parts[1], "field label")); + node.put("type", requiredPart(parts[2], "field type").toLowerCase(Locale.ROOT)); + if (parts.length >= 4 && !parts[3].isBlank()) { + node.put("length", parseInt(parts[3], "field length")); + } + if (parts.length >= 5 && !parts[4].isBlank()) { + node.put("required", Boolean.parseBoolean(parts[4])); + } else { + node.put("required", false); + } + return node; + } + + private void putRequired(ObjectNode node, String jsonName, Options options, String optionName) { + node.put(jsonName, requiredPart(options.single(optionName), optionName)); + } + + private String baseUrl(Options options) { + String value = options.single("base-url"); + if (value == null || value.isBlank()) { + value = System.getenv("EIP4_BASE_URL"); + } + if (value == null || value.isBlank()) { + value = DEFAULT_BASE_URL; + } + while (value.endsWith("/")) { + value = value.substring(0, value.length() - 1); + } + return value; + } + + private URI endpoint(String baseUrl, String path) { + return URI.create(baseUrl + path); + } + + private void printAutoDevelopSummary(JsonNode body, PrintStream out) { + out.println("status: " + text(body, "status")); + out.println("taskId: " + text(body, "taskId")); + out.println("changeSetId: " + text(body, "changeSetId")); + JsonNode apply = body.path("applyRun"); + if (!apply.isMissingNode()) { + out.println("applyStatus: " + text(apply, "status")); + } + JsonNode smoke = body.path("smokeRun"); + if (!smoke.isMissingNode()) { + out.println("smokeStatus: " + text(smoke, "status")); + } + } + + private String text(JsonNode node, String field) { + JsonNode value = node.path(field); + return value.isMissingNode() || value.isNull() ? "" : value.asText(); + } + + private int parseInt(String value, String name) { + try { + return Integer.parseInt(value); + } catch (NumberFormatException ex) { + throw new IllegalArgumentException("Invalid integer for " + name + ": " + value); + } + } + + private String requiredPart(String value, String name) { + if (value == null || value.isBlank()) { + throw new IllegalArgumentException("Missing required value: " + name); + } + return value; + } + + private boolean isHelp(String arg) { + return "--help".equals(arg) || "-h".equals(arg) || "help".equals(arg); + } + + private int fail(PrintStream err, String message) { + err.println(message); + err.println("Run `eip4 --help` for usage."); + return 1; + } + + private void printHelp(PrintStream out) { + out.println(""" + EIP4 CLI + + Usage: + eip4 env status [--base-url URL] + eip4 ai auto-develop --objective TEXT --feature-name NAME --table-name TABLE --entity-name NAME --template-id ID --menu-name NAME --field column:label:type[:length][:required] + + Environment: + EIP4_BASE_URL defaults the target service URL when --base-url is omitted. + """); + } + + private void printEnvHelp(PrintStream out) { + out.println(""" + Usage: + eip4 env status [--base-url URL] + """); + } + + private void printAiHelp(PrintStream out) { + out.println(""" + Usage: + eip4 ai auto-develop [options] + + Required: + --objective TEXT + --feature-name NAME + --table-name TABLE + --entity-name NAME + --template-id ID + --menu-name NAME + --field column:label:type[:length][:required] + + Optional: + --base-url URL + --max-repair-attempts N + --no-deployment-package + --output FILE + """); + } + + private static final class Options { + private final Map> values = new LinkedHashMap<>(); + + static Options parse(String[] args, int from) { + Options options = new Options(); + for (int i = from; i < args.length; i++) { + String arg = args[i]; + if (!arg.startsWith("--")) { + throw new IllegalArgumentException("Unexpected argument: " + arg); + } + String name = arg.substring(2); + if (name.isBlank()) { + throw new IllegalArgumentException("Invalid option: " + arg); + } + if ("no-deployment-package".equals(name)) { + options.add(name, "true"); + continue; + } + if (i + 1 >= args.length || args[i + 1].startsWith("--")) { + throw new IllegalArgumentException("Missing value for option: " + arg); + } + options.add(name, args[++i]); + } + return options; + } + + boolean has(String name) { + return values.containsKey(name); + } + + String single(String name) { + List list = values.get(name); + if (list == null || list.isEmpty()) { + return null; + } + return list.get(list.size() - 1); + } + + List values(String name) { + return values.getOrDefault(name, List.of()); + } + + private void add(String name, String value) { + values.computeIfAbsent(name, ignored -> new ArrayList<>()).add(value); + } + } +} diff --git a/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpClient.java b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpClient.java new file mode 100644 index 0000000..d59b411 --- /dev/null +++ b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpClient.java @@ -0,0 +1,10 @@ +package com.eip4.platform.cli; + +import java.io.IOException; +import java.net.URI; + +import com.fasterxml.jackson.databind.JsonNode; + +interface Eip4HttpClient { + Eip4HttpResponse send(String method, URI uri, JsonNode body) throws IOException, InterruptedException; +} diff --git a/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpResponse.java b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpResponse.java new file mode 100644 index 0000000..53dd188 --- /dev/null +++ b/platform-cli/src/main/java/com/eip4/platform/cli/Eip4HttpResponse.java @@ -0,0 +1,7 @@ +package com.eip4.platform.cli; + +record Eip4HttpResponse(int statusCode, String body) { + boolean successful() { + return statusCode >= 200 && statusCode < 300; + } +} diff --git a/platform-cli/src/main/java/com/eip4/platform/cli/JdkEip4HttpClient.java b/platform-cli/src/main/java/com/eip4/platform/cli/JdkEip4HttpClient.java new file mode 100644 index 0000000..b024461 --- /dev/null +++ b/platform-cli/src/main/java/com/eip4/platform/cli/JdkEip4HttpClient.java @@ -0,0 +1,39 @@ +package com.eip4.platform.cli; + +import java.io.IOException; +import java.net.URI; +import java.net.http.HttpClient; +import java.net.http.HttpRequest; +import java.net.http.HttpResponse; +import java.time.Duration; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +final class JdkEip4HttpClient implements Eip4HttpClient { + + private static final Duration TIMEOUT = Duration.ofSeconds(30); + + private final HttpClient client; + private final ObjectMapper objectMapper; + + JdkEip4HttpClient(ObjectMapper objectMapper) { + this.client = HttpClient.newBuilder().connectTimeout(TIMEOUT).build(); + this.objectMapper = objectMapper; + } + + @Override + public Eip4HttpResponse send(String method, URI uri, JsonNode body) throws IOException, InterruptedException { + HttpRequest.BodyPublisher publisher = body == null + ? HttpRequest.BodyPublishers.noBody() + : HttpRequest.BodyPublishers.ofString(objectMapper.writeValueAsString(body)); + HttpRequest request = HttpRequest.newBuilder(uri) + .timeout(TIMEOUT) + .header("Accept", "application/json") + .header("Content-Type", "application/json") + .method(method, publisher) + .build(); + HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString()); + return new Eip4HttpResponse(response.statusCode(), response.body()); + } +} diff --git a/platform-cli/src/test/java/com/eip4/platform/cli/Eip4CliTest.java b/platform-cli/src/test/java/com/eip4/platform/cli/Eip4CliTest.java new file mode 100644 index 0000000..50ac686 --- /dev/null +++ b/platform-cli/src/test/java/com/eip4/platform/cli/Eip4CliTest.java @@ -0,0 +1,136 @@ +package com.eip4.platform.cli; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertFalse; +import static org.junit.jupiter.api.Assertions.assertTrue; + +import java.io.ByteArrayOutputStream; +import java.io.PrintStream; +import java.net.URI; +import java.nio.charset.StandardCharsets; +import java.nio.file.Files; +import java.nio.file.Path; + +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.io.TempDir; + +import com.fasterxml.jackson.databind.JsonNode; +import com.fasterxml.jackson.databind.ObjectMapper; + +class Eip4CliTest { + + private final ObjectMapper objectMapper = new ObjectMapper(); + + @TempDir + Path tempDir; + + @Test + void envStatusChecksOpenApiEndpoint() { + CapturingClient client = new CapturingClient(new Eip4HttpResponse(200, "{}")); + CliResult result = run(client, "env", "status", "--base-url", "http://localhost:8084/"); + + assertEquals(0, result.code()); + assertEquals("GET", client.method); + assertEquals(URI.create("http://localhost:8084/v3/api-docs"), client.uri); + assertTrue(result.out().contains("EIP4 env READY")); + } + + @Test + void autoDevelopBuildsRequestAndWritesResponse() throws Exception { + String response = """ + { + "status": "READY_FOR_HUMAN_REVIEW", + "taskId": "task-1", + "changeSetId": "cs-1", + "applyRun": {"status": "PASSED"}, + "smokeRun": {"status": "PASSED"} + } + """; + CapturingClient client = new CapturingClient(new Eip4HttpResponse(200, response)); + Path output = tempDir.resolve("run.json"); + + CliResult result = run(client, + "ai", "auto-develop", + "--base-url", "http://localhost:8084", + "--objective", "新增客户等级维护", + "--feature-name", "客户等级维护", + "--table-name", "EIP4AI_CUSTOMER_LEVEL", + "--entity-name", "客户等级", + "--template-id", "eip4ai-customer-level", + "--menu-name", "客户等级维护", + "--field", "NAME:名称:string:100:true", + "--field", "ENABLED:启用:boolean::false", + "--max-repair-attempts", "3", + "--no-deployment-package", + "--output", output.toString()); + + assertEquals(0, result.code()); + assertEquals("POST", client.method); + assertEquals(URI.create("http://localhost:8084/api/ai/features/auto-develop"), client.uri); + assertFalse(client.body.path("generateDeploymentPackage").asBoolean()); + assertEquals(3, client.body.path("maxRepairAttempts").asInt()); + JsonNode feature = client.body.path("feature"); + assertEquals("EIP4AI_CUSTOMER_LEVEL", feature.path("tableName").asText()); + assertEquals(2, feature.path("fields").size()); + assertEquals("NAME", feature.path("fields").get(0).path("column").asText()); + assertEquals(100, feature.path("fields").get(0).path("length").asInt()); + assertTrue(feature.path("fields").get(0).path("required").asBoolean()); + assertTrue(Files.readString(output, StandardCharsets.UTF_8).contains("READY_FOR_HUMAN_REVIEW")); + assertTrue(result.out().contains("applyStatus: PASSED")); + } + + @Test + void autoDevelopRequiresAtLeastOneField() { + CapturingClient client = new CapturingClient(new Eip4HttpResponse(200, "{}")); + + CliResult result = run(client, + "ai", "auto-develop", + "--objective", "新增客户等级维护", + "--feature-name", "客户等级维护", + "--table-name", "EIP4AI_CUSTOMER_LEVEL", + "--entity-name", "客户等级", + "--template-id", "eip4ai-customer-level", + "--menu-name", "客户等级维护"); + + assertEquals(1, result.code()); + assertTrue(result.err().contains("Missing required option: --field")); + assertEquals(0, client.calls); + } + + private CliResult run(CapturingClient client, String... args) { + ByteArrayOutputStream out = new ByteArrayOutputStream(); + ByteArrayOutputStream err = new ByteArrayOutputStream(); + int code = new Eip4Cli(client).run( + args, + new PrintStream(out, true, StandardCharsets.UTF_8), + new PrintStream(err, true, StandardCharsets.UTF_8)); + return new CliResult( + code, + out.toString(StandardCharsets.UTF_8), + err.toString(StandardCharsets.UTF_8)); + } + + private final class CapturingClient implements Eip4HttpClient { + private final Eip4HttpResponse response; + private int calls; + private String method; + private URI uri; + private JsonNode body = objectMapper.createObjectNode(); + + private CapturingClient(Eip4HttpResponse response) { + this.response = response; + } + + @Override + public Eip4HttpResponse send(String method, URI uri, JsonNode body) { + this.calls++; + this.method = method; + this.uri = uri; + this.body = body == null ? objectMapper.createObjectNode() : body; + return response; + } + } + + private record CliResult(int code, String out, String err) { + } +} diff --git a/pom.xml b/pom.xml index f724489..b8f7daa 100644 --- a/pom.xml +++ b/pom.xml @@ -25,6 +25,7 @@ platform-flow-gateway platform-converter platform-ai + platform-cli platform-parity platform-app @@ -70,6 +71,11 @@ platform-ai ${project.version} + + com.eip4 + platform-cli + ${project.version} + com.eip4 platform-parity