forgeos 0.1.0-alpha.2 → 0.1.0-alpha.20

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

@@ -0,0 +1,121 @@
+package dev.forgeos.adapter;
+
+import java.io.IOException;
+import java.io.OutputStream;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+public final class ForgeRegistry {
+  private final Service service;
+  private final Map<String, Object> schemas = new LinkedHashMap<>();
+  private final List<RegisteredEntry> entries = new ArrayList<>();
+  private final Map<String, RegisteredEntry> lookup = new LinkedHashMap<>();
+  private String framework = "java/jdk-http";
+
+  public ForgeRegistry(String serviceName, RegistryOption... options) {
+    this.service = new Service(serviceName, "http", null, null, "/health");
+    for (RegistryOption option : options) {
+      option.apply(this);
+    }
+  }
+
+  public String serviceName() {
+    return service.name();
+  }
+
+  public String baseUrl() {
+    return service.baseUrl();
+  }
+
+  public String healthPath() {
+    return service.health() == null ? "/health" : service.health();
+  }
+
+  public void command(String name, ForgeHandler handler, EntryOption... options) {
+    Entry entry = new Entry();
+    entry.name = name;
+    entry.kind = EntryKind.COMMAND.value();
+    entry.path = "/commands/" + name;
+    entry.method = "POST";
+    entry.transaction = TransactionMode.EXTERNAL_MANAGED.value();
+    entry.risk = Risk.WRITE.value();
+    add(entry, handler, options);
+  }
+
+  public void query(String name, ForgeHandler handler, EntryOption... options) {
+    Entry entry = new Entry();
+    entry.name = name;
+    entry.kind = EntryKind.QUERY.value();
+    entry.path = "/queries/" + name;
+    entry.method = "POST";
+    entry.transaction = TransactionMode.READ_ONLY.value();
+    entry.risk = Risk.READ.value();
+    add(entry, handler, options);
+  }
+
+  public Manifest manifest(String baseUrl) {
+    Service manifestService = service;
+    if (baseUrl != null && !baseUrl.isBlank()) {
+      manifestService = new Service(service.name(), service.transport(), baseUrl, service.command(), service.health());
+    }
+    List<Entry> manifestEntries = entries.stream().map(registered -> registered.entry().copy()).toList();
+    return new Manifest("1.0", "java", framework, manifestService, manifestEntries, schemas.isEmpty() ? null : schemas);
+  }
+
+  public byte[] marshalManifest(String baseUrl) throws IOException {
+    return Json.MAPPER.writerWithDefaultPrettyPrinter().writeValueAsBytes(manifest(baseUrl));
+  }
+
+  public void writeManifest(OutputStream output, String baseUrl) throws IOException {
+    output.write(marshalManifest(baseUrl));
+    output.write('\n');
+  }
+
+  RegisteredEntry lookup(EntryKind kind, String name) {
+    return lookup.get(key(kind, name));
+  }
+
+  void setFramework(String framework) {
+    this.framework = framework;
+  }
+
+  void setBaseUrl(String baseUrl) {
+    this.service.setBaseUrl(baseUrl);
+  }
+
+  void setHealth(String health) {
+    this.service.setHealth(health);
+  }
+
+  void addSchema(String name, Object schema) {
+    this.schemas.put(name, schema);
+  }
+
+  private void add(Entry entry, ForgeHandler handler, EntryOption... options) {
+    for (EntryOption option : options) {
+      option.apply(entry);
+    }
+    RegisteredEntry registered = new RegisteredEntry(entry, handler);
+    entries.add(registered);
+    lookup.put(key(EntryKind.valueOf(entry.kind.toUpperCase()), entry.name), registered);
+  }
+
+  private static String key(EntryKind kind, String name) {
+    return kind.value() + ":" + name;
+  }
+
+  @FunctionalInterface
+  public interface RegistryOption {
+    void apply(ForgeRegistry registry);
+  }
+
+  @FunctionalInterface
+  public interface EntryOption {
+    void apply(Entry entry);
+  }
+
+  record RegisteredEntry(Entry entry, ForgeHandler handler) {
+  }
+}

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

@@ -0,0 +1,14 @@
+package dev.forgeos.adapter;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+public final class Json {
+  public static final ObjectMapper MAPPER = new ObjectMapper()
+      .setSerializationInclusion(JsonInclude.Include.NON_NULL)
+      .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
+
+  private Json() {
+  }
+}

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

@@ -0,0 +1,14 @@
+package dev.forgeos.adapter;
+
+import java.util.List;
+import java.util.Map;
+
+public record Manifest(
+    String forgeProtocol,
+    String language,
+    String framework,
+    Service service,
+    List<Entry> entries,
+    Map<String, Object> schemas
+) {
+}

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

@@ -0,0 +1,6 @@
+package dev.forgeos.adapter;
+
+import com.fasterxml.jackson.databind.JsonNode;
+
+public record RequestEnvelope(JsonNode args, Auth auth, ForgeCall forge) {
+}

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

@@ -0,0 +1,25 @@
+package dev.forgeos.adapter;
+
+import java.util.List;
+
+public record ResponseEnvelope(
+    boolean ok,
+    Object result,
+    List<Diagnostic> diagnostics,
+    ErrorInfo error,
+    String traceId
+) {
+  public static ResponseEnvelope ok(Object result, String traceId) {
+    return new ResponseEnvelope(true, result, null, null, traceId);
+  }
+
+  public static ResponseEnvelope error(String code, String message, String traceId) {
+    return new ResponseEnvelope(
+        false,
+        null,
+        List.of(Diagnostic.error(code, message == null || message.isBlank() ? code : message)),
+        new ErrorInfo(code, message == null || message.isBlank() ? code : message),
+        traceId
+    );
+  }
+}

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

@@ -0,0 +1,18 @@
+package dev.forgeos.adapter;
+
+public enum Risk {
+  READ("read"),
+  WRITE("write"),
+  DESTRUCTIVE("destructive"),
+  EXTERNAL("external");
+
+  private final String value;
+
+  Risk(String value) {
+    this.value = value;
+  }
+
+  public String value() {
+    return value;
+  }
+}

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

@@ -0,0 +1,36 @@
+package dev.forgeos.adapter;
+
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+public final class Schemas {
+  private Schemas() {
+  }
+
+  public static Map<String, Object> object(Map<String, Object> properties, String... required) {
+    Map<String, Object> schema = new LinkedHashMap<>();
+    schema.put("type", "object");
+    schema.put("properties", properties);
+    if (required.length > 0) {
+      schema.put("required", List.of(required));
+    }
+    return schema;
+  }
+
+  public static Map<String, Object> string() {
+    return Map.of("type", "string");
+  }
+
+  public static Map<String, Object> bool() {
+    return Map.of("type", "boolean");
+  }
+
+  public static Map<String, Object> number() {
+    return Map.of("type", "number");
+  }
+
+  public static Map<String, Object> array(Object items) {
+    return Map.of("type", "array", "items", items);
+  }
+}

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

@@ -0,0 +1,65 @@
+package dev.forgeos.adapter;
+
+public final class Service {
+  private final String name;
+  private final String transport;
+  private String baseUrl;
+  private String command;
+  private String health;
+
+  public Service(String name, String transport, String baseUrl, String command, String health) {
+    this.name = name;
+    this.transport = transport;
+    this.baseUrl = baseUrl;
+    this.command = command;
+    this.health = health;
+  }
+
+  public String name() {
+    return name;
+  }
+
+  public String getName() {
+    return name;
+  }
+
+  public String transport() {
+    return transport;
+  }
+
+  public String getTransport() {
+    return transport;
+  }
+
+  public String baseUrl() {
+    return baseUrl;
+  }
+
+  public String getBaseUrl() {
+    return baseUrl;
+  }
+
+  public String command() {
+    return command;
+  }
+
+  public String getCommand() {
+    return command;
+  }
+
+  public String health() {
+    return health;
+  }
+
+  public String getHealth() {
+    return health;
+  }
+
+  void setBaseUrl(String baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+
+  void setHealth(String health) {
+    this.health = health;
+  }
+}

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

@@ -0,0 +1,18 @@
+package dev.forgeos.adapter;
+
+public enum TransactionMode {
+  READ_ONLY("read-only"),
+  EXTERNAL_MANAGED("external-managed"),
+  FORGE_MANAGED("forge-managed"),
+  SAGA("saga");
+
+  private final String value;
+
+  TransactionMode(String value) {
+    this.value = value;
+  }
+
+  public String value() {
+    return value;
+  }
+}

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

@@ -0,0 +1,6 @@
+package dev.forgeos.adapter;
+
+@FunctionalInterface
+public interface TypedForgeHandler<In, Out> {
+  Out handle(ForgeContext context, In input) throws Exception;
+}

package/adapters/java/target/maven-archiver/pom.properties

@@ -0,0 +1,3 @@
+artifactId=forge-java-adapter
+groupId=dev.forgeos
+version=0.1.0-alpha.11

package/adapters/java/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst

@@ -0,0 +1,23 @@
+dev/forgeos/adapter/TypedForgeHandler.class
+dev/forgeos/adapter/Forge.class
+dev/forgeos/adapter/Diagnostic.class
+dev/forgeos/adapter/ForgeHttpHandler.class
+dev/forgeos/adapter/Service.class
+dev/forgeos/adapter/Schemas.class
+dev/forgeos/adapter/ForgeCall.class
+dev/forgeos/adapter/Risk.class
+dev/forgeos/adapter/ForgeHandler.class
+dev/forgeos/adapter/Entry.class
+dev/forgeos/adapter/TransactionMode.class
+dev/forgeos/adapter/ResponseEnvelope.class
+dev/forgeos/adapter/RequestEnvelope.class
+dev/forgeos/adapter/ForgeRegistry$RegistryOption.class
+dev/forgeos/adapter/Auth.class
+dev/forgeos/adapter/Manifest.class
+dev/forgeos/adapter/ForgeContext.class
+dev/forgeos/adapter/ForgeRegistry$RegisteredEntry.class
+dev/forgeos/adapter/ForgeRegistry$EntryOption.class
+dev/forgeos/adapter/EntryKind.class
+dev/forgeos/adapter/ForgeRegistry.class
+dev/forgeos/adapter/ErrorInfo.class
+dev/forgeos/adapter/Json.class

package/adapters/java/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst

@@ -0,0 +1,20 @@
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Auth.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Diagnostic.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Entry.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/EntryKind.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ErrorInfo.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Forge.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeCall.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeContext.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHandler.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHttpHandler.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeRegistry.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Json.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Manifest.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/RequestEnvelope.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ResponseEnvelope.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Risk.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Schemas.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Service.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/TransactionMode.java
+/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/TypedForgeHandler.java

package/adapters/java-spring-boot-starter/README.md

@@ -0,0 +1,32 @@
+# Forge Java Spring Boot Starter
+
+`adapters/java-spring-boot-starter` is the first Spring integration layer for
+Forge external runtimes. It discovers a bean annotated with
+`@ForgeExternalService`, registers methods annotated with `@ForgeCommand` and
+`@ForgeQuery`, and exposes a `ForgeRegistry` bean.
+
+```java
+@Service
+@ForgeExternalService(name = "billing", baseUrl = "http://127.0.0.1:8080")
+public class BillingService {
+  @ForgeCommand(
+      name = "createInvoice",
+      policy = "billing.manage",
+      tenantScoped = true,
+      needsApproval = true,
+      effects = {"invoice.created"})
+  public Invoice createInvoice(ForgeContext context, CreateInvoiceInput input) {
+    return new Invoice("inv_java_1", input.title(), context.auth().tenantId());
+  }
+
+  @ForgeQuery(name = "listInvoices", policy = "billing.manage", tenantScoped = true)
+  public List<Invoice> listInvoices(ForgeContext context) {
+    return List.of(new Invoice("inv_java_1", "Spring invoice", context.auth().tenantId()));
+  }
+}
+```
+
+The starter intentionally keeps HTTP endpoint wiring thin in this first version.
+Applications can inject the generated `ForgeRegistry` and serve it with the core
+adapter, or add their own Spring MVC bridge. Full MVC/Actuator auto-endpoints
+are a follow-up layer.

package/adapters/java-spring-boot-starter/pom.xml

@@ -0,0 +1,36 @@
+<?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-spring-boot-starter</artifactId>
+  <version>0.1.0-alpha.11</version>
+  <name>Forge Java Spring Boot Starter</name>
+  <description>Spring Boot integration for Forge external runtimes.</description>
+
+  <properties>
+    <maven.compiler.release>17</maven.compiler.release>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+    <spring.boot.version>3.3.5</spring.boot.version>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>dev.forgeos</groupId>
+      <artifactId>forge-java-adapter</artifactId>
+      <version>0.1.0-alpha.11</version>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework.boot</groupId>
+      <artifactId>spring-boot-autoconfigure</artifactId>
+      <version>${spring.boot.version}</version>
+    </dependency>
+    <dependency>
+      <groupId>org.springframework</groupId>
+      <artifactId>spring-context</artifactId>
+      <version>6.1.14</version>
+    </dependency>
+  </dependencies>
+</project>

package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeCommand.java

@@ -0,0 +1,22 @@
+package dev.forgeos.adapter.spring;
+
+import dev.forgeos.adapter.Risk;
+import dev.forgeos.adapter.TransactionMode;
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ForgeCommand {
+  String name();
+  String description() default "";
+  String path() default "";
+  String policy() default "";
+  boolean tenantScoped() default false;
+  TransactionMode transaction() default TransactionMode.EXTERNAL_MANAGED;
+  Risk risk() default Risk.WRITE;
+  boolean needsApproval() default false;
+  String[] effects() default {};
+}

package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeExternalService.java

@@ -0,0 +1,15 @@
+package dev.forgeos.adapter.spring;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.TYPE)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ForgeExternalService {
+  String name();
+  String baseUrl() default "";
+  String framework() default "spring-boot";
+  String health() default "/health";
+}

package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeQuery.java

@@ -0,0 +1,16 @@
+package dev.forgeos.adapter.spring;
+
+import java.lang.annotation.ElementType;
+import java.lang.annotation.Retention;
+import java.lang.annotation.RetentionPolicy;
+import java.lang.annotation.Target;
+
+@Target(ElementType.METHOD)
+@Retention(RetentionPolicy.RUNTIME)
+public @interface ForgeQuery {
+  String name();
+  String description() default "";
+  String path() default "";
+  String policy() default "";
+  boolean tenantScoped() default false;
+}

package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeServiceBeanCondition.java

@@ -0,0 +1,18 @@
+package dev.forgeos.adapter.spring;
+
+import org.springframework.beans.factory.BeanFactory;
+import org.springframework.beans.factory.ListableBeanFactory;
+import org.springframework.context.annotation.Condition;
+import org.springframework.context.annotation.ConditionContext;
+import org.springframework.core.type.AnnotatedTypeMetadata;
+
+public final class ForgeServiceBeanCondition implements Condition {
+  @Override
+  public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
+    BeanFactory beanFactory = context.getBeanFactory();
+    if (!(beanFactory instanceof ListableBeanFactory listable)) {
+      return false;
+    }
+    return !listable.getBeansWithAnnotation(ForgeExternalService.class).isEmpty();
+  }
+}

package/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringAutoConfiguration.java

@@ -0,0 +1,16 @@
+package dev.forgeos.adapter.spring;
+
+import dev.forgeos.adapter.ForgeRegistry;
+import org.springframework.boot.autoconfigure.AutoConfiguration;
+import org.springframework.context.ApplicationContext;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Conditional;
+
+@AutoConfiguration
+public class ForgeSpringAutoConfiguration {
+  @Bean
+  @Conditional(ForgeServiceBeanCondition.class)
+  public ForgeRegistry forgeRegistry(ApplicationContext context) {
+    return ForgeSpringRuntime.buildRegistry(context);
+  }
+}