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

package/examples/go-billing/main.go

@@ -0,0 +1,120 @@
+package main
+
+import (
+	"context"
+	"errors"
+	"flag"
+	"log"
+	"net/http"
+	"os"
+
+	forge "github.com/Stahldavid/forge/adapters/go"
+)
+
+type CreateInvoiceInput struct {
+	Title string `json:"title"`
+}
+
+type Invoice struct {
+	ID       string `json:"id"`
+	Title    string `json:"title,omitempty"`
+	Tenant   string `json:"tenant"`
+	TraceID  string `json:"traceId,omitempty"`
+	AuthKind string `json:"authKind,omitempty"`
+	UserID   string `json:"userId,omitempty"`
+}
+
+func main() {
+	addr := flag.String("addr", "127.0.0.1:8787", "address for the external billing service")
+	baseURL := flag.String("base-url", "", "base URL written into the Forge manifest")
+	manifest := flag.Bool("manifest", false, "write forge.manifest.json to stdout and exit")
+	flag.Parse()
+
+	if *baseURL == "" {
+		*baseURL = "http://" + *addr
+	}
+
+	app := newBillingApp(*baseURL)
+	if *manifest {
+		if err := app.WriteManifest(os.Stdout, *baseURL); err != nil {
+			log.Fatal(err)
+		}
+		return
+	}
+
+	log.Printf("go billing external service listening on http://%s", *addr)
+	if err := http.ListenAndServe(*addr, app.HTTPHandler()); err != nil {
+		log.Fatal(err)
+	}
+}
+
+func newBillingApp(baseURL string) *forge.Registry {
+	app := forge.New("billing",
+		forge.Framework("go/net-http"),
+		forge.BaseURL(baseURL),
+		forge.Health("/health"),
+	)
+
+	app.Command("createInvoice", forge.Handle(createInvoice),
+		forge.Description("Create an invoice in the external Go billing service."),
+		forge.Policy("billing.manage"),
+		forge.TenantScoped(true),
+		forge.TransactionMode(forge.TransactionExternalManaged),
+		forge.EntryRisk(forge.RiskWrite),
+		forge.NeedsApproval(true),
+		forge.Effects("invoice.created"),
+		forge.InputSchema(forge.Object(map[string]any{
+			"title": forge.String(),
+		}, "title")),
+		forge.OutputSchema(invoiceSchema()),
+	)
+
+	app.Query("listInvoices", forge.Handle(listInvoices),
+		forge.Description("List invoices visible to the current tenant."),
+		forge.Policy("billing.manage"),
+		forge.TenantScoped(true),
+		forge.ReadOnly(),
+		forge.OutputSchema(forge.Array(invoiceSchema())),
+	)
+
+	return app
+}
+
+func createInvoice(ctx context.Context, call *forge.Context, input CreateInvoiceInput) (Invoice, error) {
+	if input.Title == "" {
+		return Invoice{}, errors.New("title is required")
+	}
+	if call.Auth.TenantID == "" {
+		return Invoice{}, errors.New("tenant id is required")
+	}
+	return Invoice{
+		ID:       "inv_go_1",
+		Title:    input.Title,
+		Tenant:   call.Auth.TenantID,
+		TraceID:  call.Forge.TraceID,
+		AuthKind: call.Auth.Kind,
+		UserID:   call.Auth.UserID,
+	}, nil
+}
+
+func listInvoices(ctx context.Context, call *forge.Context, input struct{}) ([]Invoice, error) {
+	if call.Auth.TenantID == "" {
+		return nil, errors.New("tenant id is required")
+	}
+	return []Invoice{{
+		ID:     "inv_go_1",
+		Title:  "Go adapter invoice",
+		Tenant: call.Auth.TenantID,
+	}}, nil
+}
+
+func invoiceSchema() forge.Schema {
+	return forge.Object(map[string]any{
+		"id":       forge.String(),
+		"title":    forge.String(),
+		"tenant":   forge.String(),
+		"traceId":  forge.String(),
+		"authKind": forge.String(),
+		"userId":   forge.String(),
+	}, "id", "tenant")
+}

package/examples/java-billing/pom.xml

@@ -0,0 +1,52 @@
+<?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.examples</groupId>
+  <artifactId>java-billing</artifactId>
+  <version>0.1.0-alpha.11</version>
+  <name>Forge Java Billing Example</name>
+
+  <properties>
+    <maven.compiler.release>17</maven.compiler.release>
+    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+  </properties>
+
+  <dependencies>
+    <dependency>
+      <groupId>dev.forgeos</groupId>
+      <artifactId>forge-java-adapter</artifactId>
+      <version>0.1.0-alpha.11</version>
+    </dependency>
+  </dependencies>
+
+  <build>
+    <plugins>
+      <plugin>
+        <groupId>org.apache.maven.plugins</groupId>
+        <artifactId>maven-shade-plugin</artifactId>
+        <version>3.6.0</version>
+        <executions>
+          <execution>
+            <phase>package</phase>
+            <goals>
+              <goal>shade</goal>
+            </goals>
+            <configuration>
+              <createDependencyReducedPom>false</createDependencyReducedPom>
+              <shadedArtifactAttached>true</shadedArtifactAttached>
+              <shadedClassifierName>all</shadedClassifierName>
+              <transformers>
+                <transformer implementation="org.apache.maven.plugins.shade.resource.ManifestResourceTransformer">
+                  <mainClass>dev.forgeos.examples.billing.Main</mainClass>
+                </transformer>
+              </transformers>
+            </configuration>
+          </execution>
+        </executions>
+      </plugin>
+    </plugins>
+  </build>
+</project>

package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/CreateInvoiceInput.java

@@ -0,0 +1,4 @@
+package dev.forgeos.examples.billing;
+
+public record CreateInvoiceInput(String title) {
+}

package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Invoice.java

@@ -0,0 +1,11 @@
+package dev.forgeos.examples.billing;
+
+public record Invoice(
+    String id,
+    String title,
+    String tenant,
+    String traceId,
+    String authKind,
+    String userId
+) {
+}

package/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Main.java

@@ -0,0 +1,127 @@
+package dev.forgeos.examples.billing;
+
+import com.sun.net.httpserver.HttpServer;
+import dev.forgeos.adapter.Forge;
+import dev.forgeos.adapter.ForgeContext;
+import dev.forgeos.adapter.ForgeHttpHandler;
+import dev.forgeos.adapter.ForgeRegistry;
+import dev.forgeos.adapter.Risk;
+import dev.forgeos.adapter.Schemas;
+import dev.forgeos.adapter.TransactionMode;
+import java.util.Map;
+
+public final class Main {
+  private Main() {
+  }
+
+  public static void main(String[] args) throws Exception {
+    Options options = Options.parse(args);
+    ForgeRegistry app = newBillingApp(options.baseUrl());
+
+    if (options.manifest()) {
+      app.writeManifest(System.out, options.baseUrl());
+      return;
+    }
+
+    String[] addressParts = options.addr().split(":", 2);
+    String host = addressParts[0];
+    int port = Integer.parseInt(addressParts.length > 1 ? addressParts[1] : "8788");
+    HttpServer server = ForgeHttpHandler.listen(app, host, port);
+    System.err.printf("java billing external service listening on http://%s%n", options.addr());
+    Runtime.getRuntime().addShutdownHook(new Thread(() -> server.stop(0)));
+  }
+
+  static ForgeRegistry newBillingApp(String baseUrl) {
+    ForgeRegistry app = Forge.service("billing",
+        Forge.framework("java/jdk-http"),
+        Forge.baseUrl(baseUrl),
+        Forge.health("/health")
+    );
+
+    app.command("createInvoice", Forge.handle(CreateInvoiceInput.class, Main::createInvoice),
+        Forge.description("Create an invoice in the external Java billing service."),
+        Forge.policy("billing.manage"),
+        Forge.tenantScoped(true),
+        Forge.transaction(TransactionMode.EXTERNAL_MANAGED),
+        Forge.risk(Risk.WRITE),
+        Forge.needsApproval(true),
+        Forge.effects("invoice.created"),
+        Forge.inputSchema(Schemas.object(Map.of("title", Schemas.string()), "title")),
+        Forge.outputSchema(invoiceSchema())
+    );
+
+    app.query("listInvoices", Forge.handle(EmptyInput.class, Main::listInvoices),
+        Forge.description("List invoices visible to the current tenant."),
+        Forge.policy("billing.manage"),
+        Forge.tenantScoped(true),
+        Forge.readOnly(),
+        Forge.outputSchema(Schemas.array(invoiceSchema()))
+    );
+
+    return app;
+  }
+
+  static Invoice createInvoice(ForgeContext context, CreateInvoiceInput input) {
+    if (input.title() == null || input.title().isBlank()) {
+      throw new IllegalArgumentException("title is required");
+    }
+    if (context.auth().tenantId() == null || context.auth().tenantId().isBlank()) {
+      throw new IllegalArgumentException("tenant id is required");
+    }
+    return new Invoice(
+        "inv_java_1",
+        input.title(),
+        context.auth().tenantId(),
+        context.forge().traceId(),
+        context.auth().kind(),
+        context.auth().userId()
+    );
+  }
+
+  static Invoice[] listInvoices(ForgeContext context, EmptyInput input) {
+    if (context.auth().tenantId() == null || context.auth().tenantId().isBlank()) {
+      throw new IllegalArgumentException("tenant id is required");
+    }
+    return new Invoice[] {
+        new Invoice("inv_java_1", "Java adapter invoice", context.auth().tenantId(), null, null, null)
+    };
+  }
+
+  static Map<String, Object> invoiceSchema() {
+    return Schemas.object(Map.of(
+        "id", Schemas.string(),
+        "title", Schemas.string(),
+        "tenant", Schemas.string(),
+        "traceId", Schemas.string(),
+        "authKind", Schemas.string(),
+        "userId", Schemas.string()
+    ), "id", "tenant");
+  }
+
+  record EmptyInput() {
+  }
+
+  record Options(String addr, String baseUrl, boolean manifest) {
+    static Options parse(String[] args) {
+      String addr = "127.0.0.1:8788";
+      String baseUrl = null;
+      boolean manifest = false;
+
+      for (int index = 0; index < args.length; index += 1) {
+        String arg = args[index];
+        if ("--manifest".equals(arg)) {
+          manifest = true;
+        } else if ("--addr".equals(arg) && index + 1 < args.length) {
+          addr = args[++index];
+        } else if ("--base-url".equals(arg) && index + 1 < args.length) {
+          baseUrl = args[++index];
+        }
+      }
+
+      if (baseUrl == null || baseUrl.isBlank()) {
+        baseUrl = "http://" + addr;
+      }
+      return new Options(addr, baseUrl, manifest);
+    }
+  }
+}

package/examples/java-billing/target/maven-archiver/pom.properties

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

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

@@ -0,0 +1,5 @@
+dev/forgeos/examples/billing/Main.class
+dev/forgeos/examples/billing/Invoice.class
+dev/forgeos/examples/billing/Main$EmptyInput.class
+dev/forgeos/examples/billing/Main$Options.class
+dev/forgeos/examples/billing/CreateInvoiceInput.class

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

@@ -0,0 +1,3 @@
+/home/runner/work/forge/forge/examples/java-billing/src/main/java/dev/forgeos/examples/billing/CreateInvoiceInput.java
+/home/runner/work/forge/forge/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Invoice.java
+/home/runner/work/forge/forge/examples/java-billing/src/main/java/dev/forgeos/examples/billing/Main.java

package/package.json

@@ -1,12 +1,20 @@
 {
   "name": "forgeos",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.20",
   "description": "Agent-native application framework and compiler for building Forge apps without a mandatory dashboard.",
   "type": "module",
   "files": [
+    "adapters/",
     "bin/",
+    "docs/forge-protocol.md",
+    "examples/go-billing/",
+    "examples/java-billing/",
     "packages/eslint-plugin-forge/",
+    "schemas/",
     "src/",
+    "!src/forge/_generated/**",
+    "src/forge/_generated/releaseManifest.json",
+    "src/forge/_generated/releaseManifest.ts",
     "templates/",
     "README.md",
     "CHANGELOG.md",
@@ -19,11 +27,16 @@
       "src"
     ]
   },
+  "workspaces": [
+    ".",
+    "packages/*"
+  ],
   "bin": {
     "forge": "bin/forge.mjs"
   },
   "exports": {
     "./react": "./src/forge/react/index.ts",
+    "./vue": "./src/forge/vue/index.ts",
     "./server": "./src/forge/server.ts",
     "./policy": "./src/forge/policy.ts"
   },
@@ -32,10 +45,15 @@
     "build": "tsc --noEmit",
     "typecheck": "tsc --noEmit",
     "changeset": "changeset",
-    "version-packages": "changeset version",
-    "release": "changeset publish --tag alpha",
+    "version-packages": "node scripts/version-packages.mjs",
+    "release": "changeset publish",
     "release:pack": "npm pack --dry-run",
     "release:smoke": "node scripts/smoke-packed-package.mjs",
+    "release:evidence": "node scripts/write-release-evidence.mjs",
+    "release:verify-public-alpha": "node scripts/verify-public-alpha.mjs",
+    "security:evidence": "node scripts/write-security-evidence.mjs",
+    "security:deps": "node scripts/write-dependency-audit-evidence.mjs",
+    "release:publish-alpha": "node scripts/publish-trusted-alpha.mjs",
     "release:publish-local-alpha": "node scripts/publish-local-alpha.mjs",
     "field:test": "node scripts/field-test-forgeos.mjs",
     "forge": "node ./bin/forge.mjs",
@@ -59,7 +77,7 @@
     "type": "git",
     "url": "git+https://github.com/Stahldavid/forge.git"
   },
-  "homepage": "https://github.com/Stahldavid/forge#readme",
+  "homepage": "https://forgeos.readthedocs.io/",
   "bugs": {
     "url": "https://github.com/Stahldavid/forge/issues"
   },
@@ -72,10 +90,10 @@
     "cli"
   ],
   "dependencies": {
-    "@ai-sdk/anthropic": "^2.0.0",
-    "@ai-sdk/openai": "^2.0.0",
+    "@ai-sdk/anthropic": "^3.0.84",
+    "@ai-sdk/openai": "^3.0.71",
     "@electric-sql/pglite": "^0.2.17",
-    "ai": "^5.0.0",
+    "ai": "^6.0.205",
     "jose": "^6.2.3",
     "postgres": "^3.4.5",
     "react": "^19.2.7",
@@ -83,6 +101,7 @@
     "tree-sitter-typescript": "^0.23.2",
     "tsx": "^4.20.6",
     "typescript": "^5.7.3",
+    "vue": "^3.5.38",
     "zod": "^3.25.76"
   },
   "devDependencies": {
@@ -94,5 +113,8 @@
     "@types/react-test-renderer": "^19.1.0",
     "fast-check": "^3.23.2",
     "react-test-renderer": "^19.2.7"
+  },
+  "overrides": {
+    "read-yaml-file": "^3.0.0"
   }
 }

package/schemas/forge-manifest.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://forgeos.dev/schemas/forge-manifest.schema.json",
+  "title": "Forge external runtime manifest",
+  "type": "object",
+  "required": ["forgeProtocol", "language", "service", "entries"],
+  "properties": {
+    "forgeProtocol": { "const": "1.0" },
+    "language": { "type": "string", "minLength": 1 },
+    "framework": { "type": "string", "minLength": 1 },
+    "service": {
+      "type": "object",
+      "required": ["name", "transport"],
+      "properties": {
+        "name": { "type": "string", "minLength": 1 },
+        "transport": { "enum": ["http", "grpc", "stdio"] },
+        "baseUrl": { "type": "string", "minLength": 1 },
+        "command": { "type": "string", "minLength": 1 },
+        "health": { "type": "string", "minLength": 1 }
+      },
+      "additionalProperties": false
+    },
+    "entries": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["name", "kind"],
+        "properties": {
+          "name": { "type": "string", "minLength": 1 },
+          "kind": { "enum": ["command", "query"] },
+          "description": { "type": "string" },
+          "path": { "type": "string", "minLength": 1 },
+          "method": { "enum": ["GET", "POST"] },
+          "inputSchema": {},
+          "outputSchema": {},
+          "policy": { "type": "string", "minLength": 1 },
+          "tenantScoped": { "type": "boolean" },
+          "transaction": {
+            "enum": ["read-only", "external-managed", "forge-managed", "saga"]
+          },
+          "risk": { "enum": ["read", "write", "destructive", "external"] },
+          "needsApproval": { "type": "boolean" },
+          "effects": {
+            "type": "array",
+            "items": { "type": "string" }
+          }
+        },
+        "additionalProperties": false
+      }
+    },
+    "schemas": {
+      "type": "object",
+      "additionalProperties": true
+    }
+  },
+  "additionalProperties": false
+}

package/src/forge/_generated/releaseManifest.json

@@ -1,2 +1 @@
-// @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=4abdc70cbe084603a32bbefe6d4aedac5b4ada168f20c9bed329e03b1530ccfd
-{"defaultProvider":"local","diagnostics":[],"env":{"deployEnv":"FORGE_DEPLOY_ENV","deployId":"FORGE_DEPLOY_ID","publicReleaseId":"NEXT_PUBLIC_FORGE_RELEASE_ID","releaseId":"FORGE_RELEASE_ID"},"gitSha":"unknown","optionalProviders":["local","sentry-compatible","sentry","glitchtip","bugsink","otel","custom"],"packageName":"forgeos","packageVersion":"0.1.0-alpha.2","releaseId":"forgeos@0.1.0-alpha.2+unknown","schemaVersion":"0.1.0"}
+{"defaultProvider":"local","diagnostics":[],"env":{"deployEnv":"FORGE_DEPLOY_ENV","deployId":"FORGE_DEPLOY_ID","publicReleaseId":"NEXT_PUBLIC_FORGE_RELEASE_ID","releaseId":"FORGE_RELEASE_ID"},"gitSha":"unknown","optionalProviders":["local","sentry-compatible","sentry","glitchtip","bugsink","otel","custom"],"packageName":"forgeos","packageVersion":"0.1.0-alpha.20","releaseId":"forgeos@0.1.0-alpha.20+unknown","schemaVersion":"0.1.0"}

package/src/forge/_generated/releaseManifest.ts

@@ -1,4 +1,4 @@
-// @forge-generated generator=0.1.0-alpha.2 input=2ce189e4d3555acfca07eb3bb3d103b22a8da52f3c26f9ac2197254f0563234f content=658a3c071d656b63fcef215407fc33ca760dbc0269a5823a2b516d8d00f69062
+// @forge-generated generator=0.1.0-alpha.20 input=a0a760df40f02ebbcf3138bab4133a51f5a69548cba44b7ee4ec711ce57af5c6 content=3c1af03eecebf9f9b009d8a4a2e08079c9853fca2c742eed3ea3d5b8b68a57b7
 export const releaseManifest = {
   "defaultProvider": "local",
   "diagnostics": [],
@@ -19,7 +19,7 @@ export const releaseManifest = {
     "custom"
   ],
   "packageName": "forgeos",
-  "packageVersion": "0.1.0-alpha.2",
-  "releaseId": "forgeos@0.1.0-alpha.2+unknown",
+  "packageVersion": "0.1.0-alpha.20",
+  "releaseId": "forgeos@0.1.0-alpha.20+unknown",
   "schemaVersion": "0.1.0"
 } as const;