feat: add feature package export preview

This commit is contained in:
2026-06-17 08:30:20 +08:00
parent 5f7e226fa0
commit ade5e91ac1
6 changed files with 251 additions and 23 deletions

View File

@@ -6,7 +6,10 @@ import java.net.URI;
import java.nio.charset.StandardCharsets;
import java.nio.file.Files;
import java.nio.file.Path;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.ArrayList;
import java.util.HexFormat;
import java.util.LinkedHashMap;
import java.util.List;
import java.util.Locale;
@@ -20,6 +23,9 @@ import com.fasterxml.jackson.databind.node.ObjectNode;
public final class Eip4Cli {
private static final String DEFAULT_BASE_URL = "http://localhost:8084";
private static final String PACKAGE_FORMAT = "EIP4_FEATURE_PACKAGE";
private static final int PACKAGE_FORMAT_VERSION = 1;
private static final String PACKAGE_CHECKSUM_ALGORITHM = "SHA-256";
private final ObjectMapper objectMapper;
private final Eip4HttpClient httpClient;
@@ -88,19 +94,118 @@ public final class Eip4Cli {
return 0;
}
return switch (args[1]) {
case "export" -> runReleaseExport(args, out);
case "import-preview" -> runReleaseImportPreview(args, out, err);
case "verify" -> runReleaseVerify(args, out, err);
default -> fail(err, "Unknown release command: " + args[1]);
};
}
private int runReleaseExport(String[] args, PrintStream out) throws IOException {
Options options = Options.parse(args, 2);
Path packageFile = Path.of(requiredPart(options.single("package-file"), "package-file"));
Path output = Path.of(requiredPart(options.single("output"), "output"));
JsonNode raw = objectMapper.readTree(Files.readString(packageFile, StandardCharsets.UTF_8));
JsonNode payload = packagePayload(raw);
ObjectNode envelope = objectMapper.createObjectNode();
envelope.put("format", PACKAGE_FORMAT);
envelope.put("formatVersion", PACKAGE_FORMAT_VERSION);
envelope.put("exportedAt", System.currentTimeMillis());
envelope.put("checksumAlgorithm", PACKAGE_CHECKSUM_ALGORITHM);
envelope.set("payload", payload);
envelope.put("checksum", checksum(payload));
if (output.getParent() != null) {
Files.createDirectories(output.getParent());
}
Files.writeString(output,
objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(envelope) + System.lineSeparator(),
StandardCharsets.UTF_8);
out.println("Exported feature package: " + output.toAbsolutePath());
out.println("packageId: " + packageId(payload, deploymentPackage(payload)));
out.println("checksum: " + envelope.path("checksum").asText());
return 0;
}
private int runReleaseImportPreview(String[] args, PrintStream out, PrintStream err) throws IOException {
Options options = Options.parse(args, 2);
Path packageFile = Path.of(requiredPart(options.single("package-file"), "package-file"));
JsonNode raw = objectMapper.readTree(Files.readString(packageFile, StandardCharsets.UTF_8));
ReleaseValidation validation = validateReleasePackage(raw, true);
return printReleaseValidation(validation, options, out, err, "Import preview");
}
private int runReleaseVerify(String[] args, PrintStream out, PrintStream err) throws IOException {
Options options = Options.parse(args, 2);
Path packageFile = Path.of(requiredPart(options.single("package-file"), "package-file"));
JsonNode root = objectMapper.readTree(Files.readString(packageFile, StandardCharsets.UTF_8));
JsonNode deploymentPackage = root.has("deploymentPackage") ? root.path("deploymentPackage") : root;
ReleaseValidation validation = validateReleasePackage(root, false);
return printReleaseValidation(validation, options, out, err, "Release package");
}
private ReleaseValidation validateReleasePackage(JsonNode root, boolean requireEnvelope) throws IOException {
List<String> blockers = new ArrayList<>();
List<String> warnings = new ArrayList<>();
validateEnvelope(root, blockers, requireEnvelope);
JsonNode payload = packagePayload(root);
JsonNode deploymentPackage = deploymentPackage(payload);
if (payload.isMissingNode() || payload.isNull() || !payload.isObject()) {
blockers.add("payload 必须是功能包 JSON object");
}
validateDeploymentPackage(deploymentPackage, blockers, warnings);
ObjectNode report = objectMapper.createObjectNode();
report.put("status", blockers.isEmpty() ? "PASSED" : "FAILED");
report.put("format", root.path("format").asText(""));
report.put("formatVersion", root.path("formatVersion").asInt(0));
report.put("checksum", root.path("checksum").asText(""));
report.put("packageId", packageId(payload, deploymentPackage));
report.put("taskId", text(deploymentPackage, "taskId"));
report.put("changeSetId", text(deploymentPackage, "changeSetId"));
ArrayNode blockerNodes = report.putArray("blockers");
blockers.forEach(blockerNodes::add);
ArrayNode warningNodes = report.putArray("warnings");
warnings.forEach(warningNodes::add);
return new ReleaseValidation(report, List.copyOf(blockers), List.copyOf(warnings));
}
private void validateEnvelope(JsonNode root, List<String> blockers, boolean requireEnvelope) throws IOException {
if (!root.has("format")) {
if (requireEnvelope) {
blockers.add("导入预览要求 .eip4pkg.json 信封,缺少 format");
}
return;
}
if (!PACKAGE_FORMAT.equals(root.path("format").asText())) {
blockers.add("format 必须是 " + PACKAGE_FORMAT);
}
if (root.path("formatVersion").asInt(0) != PACKAGE_FORMAT_VERSION) {
blockers.add("formatVersion 必须是 " + PACKAGE_FORMAT_VERSION);
}
if (!PACKAGE_CHECKSUM_ALGORITHM.equals(root.path("checksumAlgorithm").asText())) {
blockers.add("checksumAlgorithm 必须是 " + PACKAGE_CHECKSUM_ALGORITHM);
}
JsonNode payload = root.path("payload");
if (!payload.isObject()) {
blockers.add("payload 必须是 JSON object");
return;
}
String expected = root.path("checksum").asText("");
if (expected.isBlank()) {
blockers.add("checksum 不能为空");
return;
}
String actual = checksum(payload);
if (!expected.equals(actual)) {
blockers.add("checksum 不匹配,expected=" + expected + ", actual=" + actual);
}
}
private void validateDeploymentPackage(JsonNode deploymentPackage, List<String> blockers,
List<String> warnings) {
if (!deploymentPackage.isObject()) {
blockers.add("deploymentPackage 必须是 JSON object");
}
if (!"READY_FOR_HUMAN_REVIEW".equals(text(deploymentPackage, "status"))) {
blockers.add("deploymentPackage.status 必须是 READY_FOR_HUMAN_REVIEW");
}
@@ -123,31 +228,41 @@ public final class Eip4Cli {
blockers.add("sqlStatements 仍包含 ${...} 占位符,必须人工替换后再发布");
}
deploymentPackage.path("warnings").forEach(warning -> warnings.add(warning.asText()));
}
ObjectNode report = objectMapper.createObjectNode();
report.put("status", blockers.isEmpty() ? "PASSED" : "FAILED");
report.put("packageId", packageId(root, deploymentPackage));
report.put("taskId", text(deploymentPackage, "taskId"));
report.put("changeSetId", text(deploymentPackage, "changeSetId"));
ArrayNode blockerNodes = report.putArray("blockers");
blockers.forEach(blockerNodes::add);
ArrayNode warningNodes = report.putArray("warnings");
warnings.forEach(warningNodes::add);
private JsonNode packagePayload(JsonNode root) {
if (root != null && PACKAGE_FORMAT.equals(root.path("format").asText()) && root.has("payload")) {
return root.path("payload");
}
return root;
}
private JsonNode deploymentPackage(JsonNode payload) {
if (payload != null && payload.has("deploymentPackage")) {
return payload.path("deploymentPackage");
}
return payload;
}
private int printReleaseValidation(ReleaseValidation validation, Options options, PrintStream out,
PrintStream err, String label) throws IOException {
if (options.has("json-output")) {
out.println(objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(report));
} else if (blockers.isEmpty()) {
out.println("Release package PASSED");
out.println("packageId: " + packageId(root, deploymentPackage));
if (!warnings.isEmpty()) {
out.println(objectMapper.writerWithDefaultPrettyPrinter().writeValueAsString(validation.report()));
} else if (validation.blockers().isEmpty()) {
out.println(label + " PASSED");
out.println("packageId: " + validation.report().path("packageId").asText());
if (!validation.report().path("checksum").asText("").isBlank()) {
out.println("checksum: " + validation.report().path("checksum").asText());
}
if (!validation.warnings().isEmpty()) {
out.println("warnings:");
warnings.forEach(warning -> out.println("- " + warning));
validation.warnings().forEach(warning -> out.println("- " + warning));
}
} else {
err.println("Release package FAILED");
blockers.forEach(blocker -> err.println("- " + blocker));
err.println(label + " FAILED");
validation.blockers().forEach(blocker -> err.println("- " + blocker));
}
return blockers.isEmpty() ? 0 : 2;
return validation.blockers().isEmpty() ? 0 : 2;
}
private int runEnvAdd(String[] args, PrintStream out) throws IOException {
@@ -504,6 +619,16 @@ public final class Eip4Cli {
return manifestId == null ? "" : manifestId;
}
private String checksum(JsonNode payload) throws IOException {
try {
MessageDigest digest = MessageDigest.getInstance(PACKAGE_CHECKSUM_ALGORITHM);
byte[] hash = digest.digest(objectMapper.writeValueAsBytes(payload));
return "sha256:" + HexFormat.of().formatHex(hash);
} catch (NoSuchAlgorithmException ex) {
throw new IllegalStateException("Missing checksum algorithm: " + PACKAGE_CHECKSUM_ALGORITHM, ex);
}
}
private int parseInt(String value, String name) {
try {
return Integer.parseInt(value);
@@ -540,6 +665,8 @@ public final class Eip4Cli {
eip4 env current
eip4 env status [--env NAME|--base-url URL|--all]
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]
eip4 release export --package-file FILE --output FILE
eip4 release import-preview --package-file FILE
eip4 release verify --package-file FILE
Environment:
@@ -551,6 +678,8 @@ public final class Eip4Cli {
private void printReleaseHelp(PrintStream out) {
out.println("""
Usage:
eip4 release export --package-file FILE --output FILE
eip4 release import-preview --package-file FILE [--json-output]
eip4 release verify --package-file FILE [--json-output]
""");
}
@@ -603,6 +732,9 @@ public final class Eip4Cli {
private record CliTarget(String envName, String baseUrl) {
}
private record ReleaseValidation(ObjectNode report, List<String> blockers, List<String> warnings) {
}
private static final class Options {
private final Map<String, List<String>> values = new LinkedHashMap<>();
private static final List<String> BOOLEAN_OPTIONS = List.of(