forgeos 0.1.0-alpha.7 → 0.1.0-alpha.71

package/examples/agent-fabric-v2/registry.example.json

@@ -0,0 +1,256 @@
+{
+  "populations": {
+    "files@v1": {
+      "members": [],
+      "inventoryRoots": [
+        "src"
+      ],
+      "id": "files",
+      "allowNoWork": false,
+      "exclusions": [],
+      "version": "v1",
+      "evidence": "owner files inventory",
+      "extensions": [
+        ".txt"
+      ],
+      "baselineDigest": "owner-capture"
+    }
+  },
+  "schemas": {
+    "gate@v1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "passed",
+        "gateRef",
+        "candidate"
+      ],
+      "properties": {
+        "gateRef": {
+          "type": "string"
+        },
+        "candidate": {
+          "type": "object"
+        },
+        "passed": {
+          "type": "boolean"
+        }
+      }
+    },
+    "review@v1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "verdict",
+        "findings"
+      ],
+      "properties": {
+        "findings": {
+          "type": "array",
+          "items": {
+            "type": "string"
+          }
+        },
+        "verdict": {
+          "type": "string",
+          "enum": [
+            "approved",
+            "changes_requested",
+            "inconclusive"
+          ]
+        }
+      }
+    },
+    "check@v1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "passed"
+      ],
+      "properties": {
+        "passed": {
+          "type": "boolean"
+        }
+      }
+    },
+    "discovery@v1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "items"
+      ],
+      "properties": {
+        "items": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": [
+              "id",
+              "allowedPaths"
+            ],
+            "properties": {
+              "allowedPaths": {
+                "type": "array",
+                "items": {
+                  "type": "string"
+                }
+              },
+              "id": {
+                "type": "string"
+              }
+            }
+          }
+        }
+      }
+    },
+    "implementation@v1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "summary"
+      ],
+      "properties": {
+        "summary": {
+          "type": "string"
+        }
+      }
+    },
+    "input@v1": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [],
+      "properties": {}
+    }
+  },
+  "policies": {
+    "local@v1": {
+      "maxOutputBytes": 4194304,
+      "maxAttempts": 1000,
+      "version": "v1",
+      "deadlineMs": 120000,
+      "executors": [
+        "discover@v1",
+        "migrate@v1",
+        "review@v1",
+        "check@v1"
+      ],
+      "maxDepth": 8,
+      "writeScope": [
+        "src"
+      ],
+      "allowFencedReplan": false,
+      "id": "local",
+      "allowNetwork": true,
+      "maxOperations": 2000,
+      "concurrency": 4,
+      "maxItems": 100,
+      "allowCooperativeCommands": true
+    }
+  },
+  "executors": {
+    "migrate@v1": {
+      "writeScope": [
+        "src"
+      ],
+      "version": "v1",
+      "effect": "isolated-write",
+      "schema": {
+        "id": "implementation",
+        "version": "v1"
+      },
+      "timeoutMs": 10000,
+      "isolation": "cooperative",
+      "network": "host",
+      "argv": [
+        "node",
+        "workers/migrate.mjs"
+      ],
+      "role": "implementer",
+      "id": "migrate",
+      "cache": "none",
+      "kind": "command",
+      "dependencies": "none"
+    },
+    "review@v1": {
+      "writeScope": [],
+      "version": "v1",
+      "effect": "read",
+      "schema": {
+        "id": "review",
+        "version": "v1"
+      },
+      "timeoutMs": 10000,
+      "isolation": "cooperative",
+      "network": "host",
+      "argv": [
+        "node",
+        "workers/review.mjs"
+      ],
+      "role": "reviewer",
+      "id": "review",
+      "cache": "none",
+      "kind": "command",
+      "dependencies": "none"
+    },
+    "discover@v1": {
+      "writeScope": [],
+      "version": "v1",
+      "effect": "read",
+      "schema": {
+        "id": "discovery",
+        "version": "v1"
+      },
+      "timeoutMs": 10000,
+      "isolation": "cooperative",
+      "network": "host",
+      "argv": [
+        "node",
+        "workers/discover.mjs"
+      ],
+      "role": "investigator",
+      "id": "discover",
+      "cache": "none",
+      "kind": "command",
+      "dependencies": "none"
+    },
+    "check@v1": {
+      "writeScope": [],
+      "version": "v1",
+      "effect": "read",
+      "schema": {
+        "id": "check",
+        "version": "v1"
+      },
+      "timeoutMs": 10000,
+      "isolation": "cooperative",
+      "network": "host",
+      "argv": [
+        "node",
+        "workers/check.mjs"
+      ],
+      "role": "investigator",
+      "id": "check",
+      "cache": "none",
+      "kind": "command",
+      "dependencies": "none"
+    }
+  },
+  "acceptance": {
+    "migration@v1": {
+      "allowNoWork": false,
+      "version": "v1",
+      "requiredChecks": [
+        "check@v1"
+      ],
+      "writeScope": [
+        "src"
+      ],
+      "requireReview": true,
+      "id": "migration",
+      "criteria": [
+        "Every inventoried text file has contents new"
+      ]
+    }
+  }
+}

package/examples/agent-fabric-v2/run-ui-fixture.ts

@@ -0,0 +1,48 @@
+import { mkdtemp, mkdir, writeFile, readFile, rm } from "node:fs/promises";
+import { spawnSync } from "node:child_process";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { ProgramRunService } from "../../src/forge/agent-fabric/program-service.ts";
+import { programDigest, type ProgramRegistry, type ProgramRunV2 } from "../../src/forge/agent-fabric/program-contract.ts";
+import { lowerWorkflowSource, schemaRef } from "../../src/forge/agent-fabric/program-dsl.ts";
+
+export async function runUiFixture(count = 20, defects = [2, 9, 17], browserPath?: string) {
+  const root = await mkdtemp(join(tmpdir(), "forge-ui-fixture-"));
+  let service: ProgramRunService | undefined;
+  const startedAt = performance.now();
+  try {
+    await mkdir(join(root, "src")); await mkdir(join(root, ".forge"));
+    for (let index = 0; index < count; index++) await writeFile(join(root, "src", `ui-${String(index).padStart(2, "0")}.html`), `<!doctype html><html><title>UI ${index}</title><body data-fixture="${defects.includes(index) ? "bad" : "good"}"><h1>Local fixture ${index}</h1></body></html>`);
+    for (const args of [["init", "--quiet"], ["add", "src"], ["-c", "user.name=Fixture", "-c", "user.email=fixture@example.invalid", "commit", "--quiet", "-m", "UI fixture baseline"]]) {
+      const result = spawnSync("git", args, { cwd: root, encoding: "utf8", windowsHide: true }); if (result.status) throw new Error(result.stderr);
+    }
+    const registry: ProgramRegistry = { schemas: { "any@v2": {} }, executors: {}, policies: {}, acceptance: {}, populations: {} };
+    const worker = fileURLToPath(new URL("./ui-fixture-worker.cjs", import.meta.url));
+    for (const id of ["discover", "capture", "implement", "review", "local-check", "global-check"]) registry.executors[`${id}@v2`] = {
+      id, version: "v2", kind: "command", effect: id === "implement" ? "isolated-write" : "read", role: id === "implement" ? "implementer" : id === "review" ? "reviewer" : "investigator",
+      argv: [process.execPath, worker, id, ...(id === "capture" && browserPath ? [browserPath] : [])], timeoutMs: id === "capture" && browserPath ? 120000 : 10000, writeScope: id === "implement" ? ["src"] : [], network: "host", isolation: "cooperative", schema: schemaRef("any", "v2")
+    };
+    registry.policies["local@v2"] = { id: "local", version: "v2", concurrency: 4, maxItems: 100, maxAttempts: 500, maxOperations: 2000, maxDepth: 12, deadlineMs: 240000, maxOutputBytes: 4 * 1024 * 1024, writeScope: ["src"], executors: Object.keys(registry.executors), allowNetwork: true, allowCooperativeCommands: true };
+    registry.acceptance["ui@v2"] = { id: "ui", version: "v2", criteria: ["Known fixture attributes are correct"], requireReview: true, allowNoWork: false, writeScope: ["src"], requiredChecks: [],
+      requiredChecksByScope: { item: ["local-check@v2"], final: ["global-check@v2"] }, assessmentBindings: { page: "item", final: "final" },
+      obligations: [{ id: "layout", scope: "item", criteria: ["known fixture constraint"], requiredEvidence: ["capture"] }, { id: "integration", scope: "final", criteria: ["all pages correct together"] }] };
+    registry.populations["pages@v2"] = { id: "pages", version: "v2", members: [], baselineDigest: "owner-capture", inventoryRoots: ["src"], extensions: [".html"], exclusions: [], allowNoWork: false, evidence: "owner filesystem inventory" };
+    await writeFile(join(root, ".forge/fabric-programs.json"), JSON.stringify(registry));
+    const source = await readFile(new URL("./ui-audit.workflow.ts", import.meta.url), "utf8"), program = lowerWorkflowSource(source);
+    service = await ProgramRunService.open(root);
+    const initial = await service.execute("program-start", { requestId: "ui-fixture", program, input: {} }) as ProgramRunV2;
+    let run: ProgramRunV2;
+    do { await new Promise(resolve => setTimeout(resolve, 20)); run = (await service.store.read(initial.runId))!; } while (run.status === "executing");
+    if (run.status !== "acceptance-ready") throw new Error(`UI fixture failed: ${run.status}: ${run.reason}`);
+    const assessment = Object.values(run.assessments).find(receipt => receipt.phase === "final")!;
+    const implementations = Object.values(run.attempts).filter(attempt => attempt.operationId.endsWith("/implement"));
+    const beforeApply = await readFile(join(root, "src", `ui-${String(defects[0] ?? 0).padStart(2, "0")}.html`), "utf8");
+    const report = { datasetDigest: programDigest({ count, defects }), pages: count, knownDefects: defects.length, implementations: implementations.length, attempts: run.totalAttempts,
+      captures: Object.keys(run.artifactRecords ?? {}).length, finalObligations: assessment.satisfiedObligationIds?.length, finalCaptures: assessment.evidenceRefs?.length,
+      destinationPreserved: beforeApply.includes(`data-fixture="${defects.length ? "bad" : "good"}"`), llmCalls: 0, elapsedMs: Math.round(performance.now() - startedAt), storage: service.store.metrics,
+      captureMode: browserPath ? "local-headless-browser" : "png-fixture", limitations: [browserPath ? "Local browser rendering; no visual model evaluation" : "PNG fixtures; no browser rendering or visual model evaluation", "Cooperative command isolation", "No automatic apply; no Claude benchmark"] };
+    return report;
+  } finally { await service?.close(); await rm(root, { recursive: true, force: true }); }
+}
+if (import.meta.main) { process.env.FORGE_FABRIC_TEST_MODE = "1"; console.log(JSON.stringify(await runUiFixture(), null, 2)); }

package/examples/agent-fabric-v2/ui-audit.workflow.ts

@@ -0,0 +1,28 @@
+import { defineWorkflow, schemaRef, executorRef, policyRef, acceptanceRef, populationRef, recipeRef, agent, map, repair, compose, gate, field, item, output, population, coverageFor, candidateFromBaseline, acceptedCandidates, outputCandidate, acceptedCandidate, coverageReceipt, type WorkflowOptions } from "forgeos/agent-fabric/workflows";
+
+const repairPolicy = {
+  recipe: recipeRef("repair", "v2"), implement: executorRef("implement", "v2"), review: executorRef("review", "v2"), evidence: [executorRef("capture", "v2")],
+  entryMode: "assess-first", maxRepairRounds: 3, maxAssessmentAttempts: 6, maxInfrastructureAttempts: 2,
+  progressPolicy: { unchangedCandidateRounds: 2, repeatedFindingsRounds: 2 }
+} as const;
+const itemRepair = {
+  ...repairPolicy, evidence: [executorRef("capture", "v2")], assessmentScope: "item", checks: ["local-check@v2"], initialCandidate: candidateFromBaseline(item()), writeScope: field(item(), "allowedPaths")
+} satisfies WorkflowOptions["repair"];
+
+export default defineWorkflow({
+  id: "ui-audit", version: 1, operatorVersion: 2, mode: "candidate", inputSchema: schemaRef("any", "v2"), outputSchema: schemaRef("any", "v2"),
+  policy: policyRef("local", "v2"), acceptance: acceptanceRef("ui", "v2"), population: populationRef("pages", "v2"),
+  steps: [
+    agent("discover", { executor: executorRef("discover", "v2"), input: {} }),
+    map("pages", {
+      items: field(output("discover"), "items"), key: field(item(), "id"), coverage: coverageFor(population(), output("discover")), completion: "all-required", concurrency: 4,
+      body: repair("page", itemRepair)
+    }),
+    compose("integrated", { candidates: acceptedCandidates("pages"), onConflict: "needs-resolution" }),
+    repair("final", {
+      ...repairPolicy, evidence: [executorRef("capture", "v2")], assessmentScope: "final", checks: ["global-check@v2"],
+      initialCandidate: outputCandidate("integrated"), writeScope: ["src"]
+    }),
+    gate("ready", { candidate: acceptedCandidate("final"), coverage: coverageReceipt("pages") })
+  ], result: output("ready")
+});

package/examples/agent-fabric-v2/ui-fixture-worker.cjs

@@ -0,0 +1,36 @@
+// Deterministic fixture worker. Does not call an LLM or make network requests.
+const fs = require('node:fs');
+const path = require('node:path');
+const { spawnSync } = require('node:child_process');
+const { pathToFileURL } = require('node:url');
+const role = process.argv[2];
+const data = JSON.parse(fs.readFileSync(process.env.FORGE_PROGRAM_INPUT_PATH, 'utf8'));
+const context = data.assessmentContext;
+const inventory = () => fs.readdirSync('src').filter(name => name.endsWith('.html')).sort().map(name => ({ id: 'src/' + name, allowedPaths: ['src/' + name] }));
+const items = data.workItem ? [data.workItem] : inventory();
+const invalid = () => items.filter(item => !fs.readFileSync(item.id, 'utf8').includes('data-fixture="good"'));
+let result;
+if (role === 'discover') result = { items: inventory() };
+else if (role === 'implement') {
+  for (const item of invalid()) fs.writeFileSync(item.id, fs.readFileSync(item.id, 'utf8').replace('data-fixture="bad"', 'data-fixture="good"'));
+  result = { summary: 'Repaired known fixture attributes' };
+} else if (role === 'review') {
+  const findings = invalid().map(item => ({ itemKey: item.id, reason: 'Known deterministic fixture defect' }));
+  result = { verdict: findings.length ? 'changes_requested' : 'approved', findings, coveredObligationIds: context.obligationIds };
+} else if (role === 'local-check' || role === 'global-check') result = { passed: invalid().length === 0 };
+else if (role === 'capture') {
+  // A valid PNG fixture proves artifact transport/binding, not browser rendering.
+  const bytes = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAQAAAC1HAwCAAAAC0lEQVR42mP8/x8AAwMCAO+aGfoAAAAASUVORK5CYII=', 'base64');
+  result = { evidenceArtifacts: items.map((item, index) => {
+    const name = 'capture-' + index + '.png', file = path.join(process.env.FORGE_PROGRAM_SCRATCH_DIRECTORY, name);
+    const browser = process.argv[3];
+    if (browser) {
+      const profile = path.join(process.env.FORGE_PROGRAM_SCRATCH_DIRECTORY, 'profile-' + index);
+      const rendered = spawnSync(browser, ['--headless', '--disable-gpu', '--disable-extensions', '--disable-background-networking', '--no-first-run', '--no-default-browser-check', '--hide-scrollbars', '--window-size=800,600', '--user-data-dir=' + profile, '--screenshot=' + file, pathToFileURL(path.resolve(item.id)).href], { windowsHide: true, timeout: 15000, stdio: 'pipe' });
+      if (rendered.error || rendered.status !== 0 || !fs.existsSync(file)) throw new Error('Headless browser capture failed');
+    } else fs.writeFileSync(file, bytes);
+    const image = fs.readFileSync(file), width = image.readUInt32BE(16), height = image.readUInt32BE(20);
+    return { path: name, itemKey: item.id, buildDigest: data.candidateDigest, environmentRef: context.environmentRef, mime: 'image/png', width, height, route: '/' + item.id, viewport: width + 'x' + height, state: browser ? 'local-browser-render' : 'deterministic-fixture' };
+  }) };
+} else throw new Error('Unknown fixture role');
+console.log(JSON.stringify(result));

package/examples/agent-fabric-v2/visual-population.json

@@ -0,0 +1,13 @@
+{
+  "id": "checkout-cases",
+  "version": "v2",
+  "members": ["checkout-desktop-ready", "checkout-mobile-error"],
+  "exclusions": [],
+  "baselineDigest": "OWNER_MUST_SUPPLY_CAPTURED_BASELINE_DIGEST",
+  "evidence": "Owner catalog of required checkout scenarios; extend explicitly for every route, viewport and state",
+  "allowNoWork": false,
+  "visualCases": [
+    { "itemKey": "checkout-desktop-ready", "route": "/checkout", "viewport": "desktop", "state": "ready", "width": 1440, "height": 900 },
+    { "itemKey": "checkout-mobile-error", "route": "/checkout", "viewport": "mobile", "state": "error", "width": 390, "height": 844 }
+  ]
+}

package/examples/agent-fabric-v2/workers/check.mjs

@@ -0,0 +1,2 @@
+import { migrated } from "./common.mjs";
+console.log(JSON.stringify({ passed: migrated() }));

package/examples/agent-fabric-v2/workers/common.mjs

@@ -0,0 +1,7 @@
+import { readFileSync, readdirSync } from "node:fs";
+export const input = JSON.parse(readFileSync(process.env.FORGE_PROGRAM_INPUT_PATH, "utf8"));
+export function files(directory = "src") {
+  return readdirSync(directory, { withFileTypes: true }).flatMap(entry => entry.isDirectory() ? files(`${directory}/${entry.name}`) : entry.isFile() && entry.name.endsWith(".txt") ? [`${directory}/${entry.name}`] : []).sort();
+}
+export const selected = () => input.workItem ? [input.workItem.id] : files();
+export const migrated = () => selected().every(path => readFileSync(path, "utf8") === "new");

package/examples/agent-fabric-v2/workers/discover.mjs

@@ -0,0 +1,2 @@
+import { files } from "./common.mjs";
+console.log(JSON.stringify({ items: files().map(id => ({ id, allowedPaths: [id] })) }));

package/examples/agent-fabric-v2/workers/migrate.mjs

@@ -0,0 +1,4 @@
+import { writeFileSync } from "node:fs";
+import { selected } from "./common.mjs";
+for (const path of selected()) writeFileSync(path, "new");
+console.log(JSON.stringify({ summary: "Converted selected text files to new" }));

package/examples/agent-fabric-v2/workers/review.mjs

@@ -0,0 +1,3 @@
+import { migrated } from "./common.mjs";
+const approved = migrated();
+console.log(JSON.stringify({ verdict: approved ? "approved" : "changes_requested", findings: approved ? [] : ["Selected files are not migrated"] }));

package/examples/go-billing/go.mod

@@ -0,0 +1,7 @@
+module github.com/Stahldavid/forge/examples/go-billing
+
+go 1.22
+
+require github.com/Stahldavid/forge/adapters/go v0.0.0
+
+replace github.com/Stahldavid/forge/adapters/go => ../../adapters/go

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,60 @@
+<?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-compiler-plugin</artifactId>
+        <version>3.13.0</version>
+        <configuration>
+          <release>${maven.compiler.release}</release>
+        </configuration>
+      </plugin>
+      <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
+) {
+}