forgeos 0.1.0-alpha.65 → 0.1.0-alpha.67

package/adapters/java/README.md

@@ -1,68 +1,68 @@
-# Forge Java Adapter
-
-`adapters/java` is the minimal Java SDK for external Forge runtimes. It mirrors
-the Go adapter: register commands and queries, emit a `forge.manifest.json`, and
-serve Forge-compatible HTTP envelopes.
-
-```java
-ForgeRegistry app = Forge.service("billing",
-    Forge.framework("java/jdk-http"),
-    Forge.baseUrl("http://127.0.0.1:8788"));
-
-app.command("createInvoice",
-    Forge.handle(CreateInvoiceInput.class, Billing::createInvoice),
-    Forge.policy("billing.manage"),
-    Forge.tenantScoped(true),
-    Forge.needsApproval(true),
-    Forge.inputSchema(Schemas.object(Map.of("title", Schemas.string()), "title")));
-
-app.query("listInvoices",
-    Forge.handle(EmptyInput.class, Billing::listInvoices),
-    Forge.policy("billing.manage"),
-    Forge.tenantScoped(true),
-    Forge.readOnly());
-
-ForgeHttpHandler.listen(app, "127.0.0.1", 8788);
-```
-
-The HTTP handler exposes:
-
-```text
-GET  /health
-GET  /manifest?baseUrl=http://127.0.0.1:8788
-POST /commands/:name
-POST /queries/:name
-```
-
-The handler accepts Forge runtime envelopes and returns Forge response
-envelopes:
-
-```json
-{
-  "args": { "title": "Invoice" },
-  "auth": { "kind": "user", "userId": "u1", "tenantId": "t1", "role": "admin" },
-  "forge": { "service": "billing", "entry": "createInvoice", "kind": "command", "traceId": "trace_..." }
-}
-```
-
-Build locally:
-
-```bash
-mvn -f adapters/java/pom.xml install
-mvn -f examples/java-billing/pom.xml package
-```
-
-Emit and import a manifest:
-
-```bash
-java -jar examples/java-billing/target/java-billing-0.1.0-alpha.11-all.jar --manifest --base-url http://127.0.0.1:8788 > java-billing.manifest.json
-forge manifest import java-billing.manifest.json --json
-forge generate
-```
-
-Invoke through Forge:
-
-```bash
-forge run billing.createInvoice --args '{"title":"Invoice"}' --role admin --tenant-id tenant-a
-forge query billing.listInvoices --args '{}' --role admin --tenant-id tenant-a
-```
+# Forge Java Adapter
+
+`adapters/java` is the minimal Java SDK for external Forge runtimes. It mirrors
+the Go adapter: register commands and queries, emit a `forge.manifest.json`, and
+serve Forge-compatible HTTP envelopes.
+
+```java
+ForgeRegistry app = Forge.service("billing",
+    Forge.framework("java/jdk-http"),
+    Forge.baseUrl("http://127.0.0.1:8788"));
+
+app.command("createInvoice",
+    Forge.handle(CreateInvoiceInput.class, Billing::createInvoice),
+    Forge.policy("billing.manage"),
+    Forge.tenantScoped(true),
+    Forge.needsApproval(true),
+    Forge.inputSchema(Schemas.object(Map.of("title", Schemas.string()), "title")));
+
+app.query("listInvoices",
+    Forge.handle(EmptyInput.class, Billing::listInvoices),
+    Forge.policy("billing.manage"),
+    Forge.tenantScoped(true),
+    Forge.readOnly());
+
+ForgeHttpHandler.listen(app, "127.0.0.1", 8788);
+```
+
+The HTTP handler exposes:
+
+```text
+GET  /health
+GET  /manifest?baseUrl=http://127.0.0.1:8788
+POST /commands/:name
+POST /queries/:name
+```
+
+The handler accepts Forge runtime envelopes and returns Forge response
+envelopes:
+
+```json
+{
+  "args": { "title": "Invoice" },
+  "auth": { "kind": "user", "userId": "u1", "tenantId": "t1", "role": "admin" },
+  "forge": { "service": "billing", "entry": "createInvoice", "kind": "command", "traceId": "trace_..." }
+}
+```
+
+Build locally:
+
+```bash
+mvn -f adapters/java/pom.xml install
+mvn -f examples/java-billing/pom.xml package
+```
+
+Emit and import a manifest:
+
+```bash
+java -jar examples/java-billing/target/java-billing-0.1.0-alpha.11-all.jar --manifest --base-url http://127.0.0.1:8788 > java-billing.manifest.json
+forge manifest import java-billing.manifest.json --json
+forge generate
+```
+
+Invoke through Forge:
+
+```bash
+forge run billing.createInvoice --args '{"title":"Invoice"}' --role admin --tenant-id tenant-a
+forge query billing.listInvoices --args '{}' --role admin --tenant-id tenant-a
+```

package/adapters/java/pom.xml

@@ -1,47 +1,47 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<project xmlns="http://maven.apache.org/POM/4.0.0"
-         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
-         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
-  <modelVersion>4.0.0</modelVersion>
-
-  <groupId>dev.forgeos</groupId>
-  <artifactId>forge-java-adapter</artifactId>
-  <version>0.1.0-alpha.11</version>
-  <name>Forge Java Adapter</name>
-  <description>Minimal Java SDK for Forge external runtimes.</description>
-  <url>https://forgeos.dev</url>
-
-  <licenses>
-    <license>
-      <name>Apache License, Version 2.0</name>
-      <url>https://www.apache.org/licenses/LICENSE-2.0.txt</url>
-    </license>
-  </licenses>
-
-  <properties>
-    <maven.compiler.release>17</maven.compiler.release>
-    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
-    <jackson.version>2.17.2</jackson.version>
-  </properties>
-
-  <dependencies>
-    <dependency>
-      <groupId>com.fasterxml.jackson.core</groupId>
-      <artifactId>jackson-databind</artifactId>
-      <version>${jackson.version}</version>
-    </dependency>
-  </dependencies>
-
-  <build>
-    <plugins>
-      <plugin>
-        <groupId>org.apache.maven.plugins</groupId>
-        <artifactId>maven-compiler-plugin</artifactId>
-        <version>3.13.0</version>
-        <configuration>
-          <release>${maven.compiler.release}</release>
-        </configuration>
-      </plugin>
-    </plugins>
-  </build>
-</project>
+<?xml version="1.0" encoding="UTF-8"?>
+<project xmlns="http://maven.apache.org/POM/4.0.0"
+         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+  <modelVersion>4.0.0</modelVersion>
+
+  <groupId>dev.forgeos</groupId>
+  <artifactId>forge-java-adapter</artifactId>
+  <version>0.1.0-alpha.11</version>
+  <name>Forge Java Adapter</name>
+  <description>Minimal Java SDK for Forge external runtimes.</description>
+  <url>https://forgeos.dev</url>
+
+  <licenses>
+    <license>
+      <name>Apache License, Version 2.0</name>
+      <url>https://www.apache.org/licenses/LICENSE-2.0.txt</url>
+    </license>
+  </licenses>
+
+  <properties>
+    <maven.compiler.release>17</maven.compiler.release>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <jackson.version>2.17.2</jackson.version>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>com.fasterxml.jackson.core</groupId>
+      <artifactId>jackson-databind</artifactId>
+      <version>${jackson.version}</version>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-compiler-plugin</artifactId>
+        <version>3.13.0</version>
+        <configuration>
+          <release>${maven.compiler.release}</release>
+        </configuration>
+      </plugin>
+    </plugins>
+  </build>
+</project>

package/adapters/java/src/main/java/dev/forgeos/adapter/Auth.java

@@ -1,20 +1,20 @@
-package dev.forgeos.adapter;
-
-import java.util.List;
-import java.util.Map;
-
-public record Auth(
-    String kind,
-    String userId,
-    String tenantId,
-    String role,
-    List<String> roles,
-    List<String> permissions,
-    String email,
-    String name,
-    Map<String, Object> claims
-) {
-  public static Auth anonymous() {
-    return new Auth("anonymous", null, null, null, null, null, null, null, null);
-  }
-}
+package dev.forgeos.adapter;
+
+import java.util.List;
+import java.util.Map;
+
+public record Auth(
+    String kind,
+    String userId,
+    String tenantId,
+    String role,
+    List<String> roles,
+    List<String> permissions,
+    String email,
+    String name,
+    Map<String, Object> claims
+) {
+  public static Auth anonymous() {
+    return new Auth("anonymous", null, null, null, null, null, null, null, null);
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Diagnostic.java

@@ -1,16 +1,16 @@
-package dev.forgeos.adapter;
-
-import java.util.List;
-
-public record Diagnostic(
-    String severity,
-    String code,
-    String message,
-    String file,
-    String fixHint,
-    List<String> docs
-) {
-  public static Diagnostic error(String code, String message) {
-    return new Diagnostic("error", code, message, null, null, List.of("docs/forge-protocol.md"));
-  }
-}
+package dev.forgeos.adapter;
+
+import java.util.List;
+
+public record Diagnostic(
+    String severity,
+    String code,
+    String message,
+    String file,
+    String fixHint,
+    List<String> docs
+) {
+  public static Diagnostic error(String code, String message) {
+    return new Diagnostic("error", code, message, null, null, List.of("docs/forge-protocol.md"));
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Entry.java

@@ -1,38 +1,38 @@
-package dev.forgeos.adapter;
-
-import java.util.ArrayList;
-import java.util.List;
-
-public final class Entry {
-  public String name;
-  public String kind;
-  public String description;
-  public String path;
-  public String method;
-  public Object inputSchema;
-  public Object outputSchema;
-  public String policy;
-  public Boolean tenantScoped;
-  public String transaction;
-  public String risk;
-  public Boolean needsApproval;
-  public List<String> effects;
-
-  public Entry copy() {
-    Entry copy = new Entry();
-    copy.name = name;
-    copy.kind = kind;
-    copy.description = description;
-    copy.path = path;
-    copy.method = method;
-    copy.inputSchema = inputSchema;
-    copy.outputSchema = outputSchema;
-    copy.policy = policy;
-    copy.tenantScoped = tenantScoped;
-    copy.transaction = transaction;
-    copy.risk = risk;
-    copy.needsApproval = needsApproval;
-    copy.effects = effects == null ? null : new ArrayList<>(effects);
-    return copy;
-  }
-}
+package dev.forgeos.adapter;
+
+import java.util.ArrayList;
+import java.util.List;
+
+public final class Entry {
+  public String name;
+  public String kind;
+  public String description;
+  public String path;
+  public String method;
+  public Object inputSchema;
+  public Object outputSchema;
+  public String policy;
+  public Boolean tenantScoped;
+  public String transaction;
+  public String risk;
+  public Boolean needsApproval;
+  public List<String> effects;
+
+  public Entry copy() {
+    Entry copy = new Entry();
+    copy.name = name;
+    copy.kind = kind;
+    copy.description = description;
+    copy.path = path;
+    copy.method = method;
+    copy.inputSchema = inputSchema;
+    copy.outputSchema = outputSchema;
+    copy.policy = policy;
+    copy.tenantScoped = tenantScoped;
+    copy.transaction = transaction;
+    copy.risk = risk;
+    copy.needsApproval = needsApproval;
+    copy.effects = effects == null ? null : new ArrayList<>(effects);
+    return copy;
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/EntryKind.java

@@ -1,16 +1,16 @@
-package dev.forgeos.adapter;
-
-public enum EntryKind {
-  COMMAND("command"),
-  QUERY("query");
-
-  private final String value;
-
-  EntryKind(String value) {
-    this.value = value;
-  }
-
-  public String value() {
-    return value;
-  }
-}
+package dev.forgeos.adapter;
+
+public enum EntryKind {
+  COMMAND("command"),
+  QUERY("query");
+
+  private final String value;
+
+  EntryKind(String value) {
+    this.value = value;
+  }
+
+  public String value() {
+    return value;
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ErrorInfo.java

@@ -1,4 +1,4 @@
-package dev.forgeos.adapter;
-
-public record ErrorInfo(String code, String message) {
-}
+package dev.forgeos.adapter;
+
+public record ErrorInfo(String code, String message) {
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Forge.java

@@ -1,94 +1,94 @@
-package dev.forgeos.adapter;
-
-import com.fasterxml.jackson.databind.JsonNode;
-import java.util.Arrays;
-import java.util.List;
-
-public final class Forge {
-  private Forge() {
-  }
-
-  public static ForgeRegistry service(String serviceName, ForgeRegistry.RegistryOption... options) {
-    return new ForgeRegistry(serviceName, options);
-  }
-
-  public static ForgeRegistry.RegistryOption framework(String value) {
-    return registry -> registry.setFramework(value);
-  }
-
-  public static ForgeRegistry.RegistryOption baseUrl(String value) {
-    return registry -> registry.setBaseUrl(value);
-  }
-
-  public static ForgeRegistry.RegistryOption health(String path) {
-    return registry -> registry.setHealth(path);
-  }
-
-  public static ForgeRegistry.RegistryOption schemaRef(String name, Object schema) {
-    return registry -> registry.addSchema(name, schema);
-  }
-
-  public static ForgeRegistry.EntryOption description(String value) {
-    return entry -> entry.description = value;
-  }
-
-  public static ForgeRegistry.EntryOption path(String value) {
-    return entry -> entry.path = value;
-  }
-
-  public static ForgeRegistry.EntryOption method(String value) {
-    return entry -> entry.method = value;
-  }
-
-  public static ForgeRegistry.EntryOption inputSchema(Object schema) {
-    return entry -> entry.inputSchema = schema;
-  }
-
-  public static ForgeRegistry.EntryOption outputSchema(Object schema) {
-    return entry -> entry.outputSchema = schema;
-  }
-
-  public static ForgeRegistry.EntryOption policy(String value) {
-    return entry -> entry.policy = value;
-  }
-
-  public static ForgeRegistry.EntryOption tenantScoped(boolean value) {
-    return entry -> entry.tenantScoped = value;
-  }
-
-  public static ForgeRegistry.EntryOption transaction(TransactionMode value) {
-    return entry -> entry.transaction = value.value();
-  }
-
-  public static ForgeRegistry.EntryOption risk(Risk value) {
-    return entry -> entry.risk = value.value();
-  }
-
-  public static ForgeRegistry.EntryOption needsApproval(boolean value) {
-    return entry -> entry.needsApproval = value;
-  }
-
-  public static ForgeRegistry.EntryOption effects(String... values) {
-    return entry -> entry.effects = List.copyOf(Arrays.asList(values));
-  }
-
-  public static ForgeRegistry.EntryOption readOnly() {
-    return entry -> {
-      entry.transaction = TransactionMode.READ_ONLY.value();
-      entry.risk = Risk.READ.value();
-    };
-  }
-
-  public static <In, Out> ForgeHandler handle(
-      Class<In> inputClass,
-      TypedForgeHandler<In, Out> handler
-  ) {
-    return (context, rawArgs) -> {
-      JsonNode args = rawArgs == null || rawArgs.isNull()
-          ? Json.MAPPER.createObjectNode()
-          : rawArgs;
-      In input = Json.MAPPER.treeToValue(args, inputClass);
-      return handler.handle(context, input);
-    };
-  }
-}
+package dev.forgeos.adapter;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import java.util.Arrays;
+import java.util.List;
+
+public final class Forge {
+  private Forge() {
+  }
+
+  public static ForgeRegistry service(String serviceName, ForgeRegistry.RegistryOption... options) {
+    return new ForgeRegistry(serviceName, options);
+  }
+
+  public static ForgeRegistry.RegistryOption framework(String value) {
+    return registry -> registry.setFramework(value);
+  }
+
+  public static ForgeRegistry.RegistryOption baseUrl(String value) {
+    return registry -> registry.setBaseUrl(value);
+  }
+
+  public static ForgeRegistry.RegistryOption health(String path) {
+    return registry -> registry.setHealth(path);
+  }
+
+  public static ForgeRegistry.RegistryOption schemaRef(String name, Object schema) {
+    return registry -> registry.addSchema(name, schema);
+  }
+
+  public static ForgeRegistry.EntryOption description(String value) {
+    return entry -> entry.description = value;
+  }
+
+  public static ForgeRegistry.EntryOption path(String value) {
+    return entry -> entry.path = value;
+  }
+
+  public static ForgeRegistry.EntryOption method(String value) {
+    return entry -> entry.method = value;
+  }
+
+  public static ForgeRegistry.EntryOption inputSchema(Object schema) {
+    return entry -> entry.inputSchema = schema;
+  }
+
+  public static ForgeRegistry.EntryOption outputSchema(Object schema) {
+    return entry -> entry.outputSchema = schema;
+  }
+
+  public static ForgeRegistry.EntryOption policy(String value) {
+    return entry -> entry.policy = value;
+  }
+
+  public static ForgeRegistry.EntryOption tenantScoped(boolean value) {
+    return entry -> entry.tenantScoped = value;
+  }
+
+  public static ForgeRegistry.EntryOption transaction(TransactionMode value) {
+    return entry -> entry.transaction = value.value();
+  }
+
+  public static ForgeRegistry.EntryOption risk(Risk value) {
+    return entry -> entry.risk = value.value();
+  }
+
+  public static ForgeRegistry.EntryOption needsApproval(boolean value) {
+    return entry -> entry.needsApproval = value;
+  }
+
+  public static ForgeRegistry.EntryOption effects(String... values) {
+    return entry -> entry.effects = List.copyOf(Arrays.asList(values));
+  }
+
+  public static ForgeRegistry.EntryOption readOnly() {
+    return entry -> {
+      entry.transaction = TransactionMode.READ_ONLY.value();
+      entry.risk = Risk.READ.value();
+    };
+  }
+
+  public static <In, Out> ForgeHandler handle(
+      Class<In> inputClass,
+      TypedForgeHandler<In, Out> handler
+  ) {
+    return (context, rawArgs) -> {
+      JsonNode args = rawArgs == null || rawArgs.isNull()
+          ? Json.MAPPER.createObjectNode()
+          : rawArgs;
+      In input = Json.MAPPER.treeToValue(args, inputClass);
+      return handler.handle(context, input);
+    };
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeCall.java

@@ -1,12 +1,12 @@
-package dev.forgeos.adapter;
-
-public record ForgeCall(String service, String entry, String kind, String traceId) {
-  public ForgeCall withDefaults(String serviceName, String entryName, String entryKind, String fallbackTraceId) {
-    return new ForgeCall(
-        service == null || service.isBlank() ? serviceName : service,
-        entry == null || entry.isBlank() ? entryName : entry,
-        kind == null || kind.isBlank() ? entryKind : kind,
-        traceId == null || traceId.isBlank() ? fallbackTraceId : traceId
-    );
-  }
-}
+package dev.forgeos.adapter;
+
+public record ForgeCall(String service, String entry, String kind, String traceId) {
+  public ForgeCall withDefaults(String serviceName, String entryName, String entryKind, String fallbackTraceId) {
+    return new ForgeCall(
+        service == null || service.isBlank() ? serviceName : service,
+        entry == null || entry.isBlank() ? entryName : entry,
+        kind == null || kind.isBlank() ? entryKind : kind,
+        traceId == null || traceId.isBlank() ? fallbackTraceId : traceId
+    );
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeContext.java

@@ -1,11 +1,11 @@
-package dev.forgeos.adapter;
-
-import java.util.List;
-import java.util.Map;
-
-public record ForgeContext(
-    Auth auth,
-    ForgeCall forge,
-    Map<String, List<String>> headers
-) {
-}
+package dev.forgeos.adapter;
+
+import java.util.List;
+import java.util.Map;
+
+public record ForgeContext(
+    Auth auth,
+    ForgeCall forge,
+    Map<String, List<String>> headers
+) {
+}