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

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

@@ -1,11 +1,11 @@
-package dev.forgeos.examples.billing;
-
-public record Invoice(
-    String id,
-    String title,
-    String tenant,
-    String traceId,
-    String authKind,
-    String userId
-) {
-}
+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

@@ -1,127 +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 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "forgeos",
-  "version": "0.1.0-alpha.65",
+  "version": "0.1.0-alpha.67",
   "description": "Agent-native application framework and compiler for building Forge apps without a mandatory dashboard.",
   "type": "module",
   "license": "MIT",
@@ -105,6 +105,7 @@
     "@ai-sdk/anthropic": "^3.0.84",
     "@ai-sdk/openai": "^3.0.71",
     "@electric-sql/pglite": "^0.2.17",
+    "@openai/codex-sdk": "0.160.0",
     "@types/react": "^19.2.17",
     "ai": "^6.0.205",
     "jose": "^6.2.3",
@@ -118,8 +119,8 @@
     "zod": "^3.25.76"
   },
   "devDependencies": {
-    "@changesets/changelog-github": "^0.7.0",
-    "@changesets/cli": "^2.31.0",
+    "@changesets/changelog-github": "^1.0.1",
+    "@changesets/cli": "^3.0.3",
     "@types/bun": "1.3.14",
     "@types/node": "^24.0.0",
     "@types/react-test-renderer": "^19.1.0",
@@ -130,4 +131,4 @@
   "overrides": {
     "read-yaml-file": "^3.0.0"
   }
-}
+}

package/packages/eslint-plugin-forge/index.ts

@@ -1,15 +1,15 @@
-export {
-  loadForgeGuardArtifacts,
-  type ForgeGuardArtifacts,
-} from "./src/load-artifacts.ts";
-export {
-  checkSourceForgeGuards,
-  type ForgeGuardSourceViolation,
-} from "./src/check-source.ts";
-export {
-  runForgeGuardRule,
-  forgeGuardRuleDefinition,
-  formatViolationMessage,
-  type ForgeEslintContext,
-  type ForgeEslintSettings,
-} from "./src/rule-no-forge-guard-violation.ts";
+export {
+  loadForgeGuardArtifacts,
+  type ForgeGuardArtifacts,
+} from "./src/load-artifacts.ts";
+export {
+  checkSourceForgeGuards,
+  type ForgeGuardSourceViolation,
+} from "./src/check-source.ts";
+export {
+  runForgeGuardRule,
+  forgeGuardRuleDefinition,
+  formatViolationMessage,
+  type ForgeEslintContext,
+  type ForgeEslintSettings,
+} from "./src/rule-no-forge-guard-violation.ts";

package/packages/eslint-plugin-forge/package.json

@@ -1,10 +1,10 @@
-{
-  "name": "eslint-plugin-forge",
-  "version": "0.0.0",
-  "private": true,
-  "type": "module",
-  "main": "./index.ts",
-  "exports": {
-    ".": "./index.ts"
-  }
-}
+{
+  "name": "eslint-plugin-forge",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "main": "./index.ts",
+  "exports": {
+    ".": "./index.ts"
+  }
+}

package/packages/eslint-plugin-forge/src/check-source.ts

@@ -1,95 +1,95 @@
-import { lookupMatrixEntry } from "../../../src/forge/compiler/classifier/runtime-matrix.ts";
-import type { ImportGuardsArtifact } from "../../../src/forge/compiler/types/import-guards.ts";
-import type { RuntimeContext } from "../../../src/forge/compiler/types/runtime.ts";
-import type { RuntimeMatrix } from "../../../src/forge/compiler/types/runtime-matrix.ts";
-import { parsePackageSpecifier } from "../../../src/forge/compiler/app-graph/module-graph.ts";
-
-export interface ForgeGuardSourceViolation {
-  packageName: string;
-  context: RuntimeContext;
-  rationale: string;
-  line: number;
-  column: number;
-  endColumn: number;
-}
-
-const IMPORT_PATTERN =
-  /(?:import\s+(?:type\s+)?(?:[\w*{}\s,]+from\s+)?|export\s+(?:type\s+)?(?:[\w*{}\s,]+from\s+)?)['"]([^'"]+)['"]|require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
-
-function lineColumnAtOffset(
-  source: string,
-  offset: number,
-): { line: number; column: number } {
-  const before = source.slice(0, offset);
-  const lines = before.split("\n");
-  return {
-    line: lines.length,
-    column: (lines.at(-1)?.length ?? 0) + 1,
-  };
-}
-
-function effectiveContextsForFile(
-  file: string,
-  guards: ImportGuardsArtifact,
-): RuntimeContext[] {
-  const normalized = file.replace(/\\/g, "/");
-  const entry = guards.moduleContexts.find(
-    (module) =>
-      module.file === normalized ||
-      normalized.endsWith(`/${module.file}`) ||
-      module.file.endsWith(normalized),
-  );
-  return entry?.effectiveContexts ?? [];
-}
-
-export function checkSourceForgeGuards(
-  filePath: string,
-  source: string,
-  importGuards: ImportGuardsArtifact,
-  runtimeMatrix: RuntimeMatrix,
-): ForgeGuardSourceViolation[] {
-  const effectiveContexts = effectiveContextsForFile(filePath, importGuards);
-  if (effectiveContexts.length === 0) {
-    return [];
-  }
-
-  const violations: ForgeGuardSourceViolation[] = [];
-
-  for (const match of source.matchAll(IMPORT_PATTERN)) {
-    const specifier = match[1] ?? match[2];
-    if (!specifier) {
-      continue;
-    }
-
-    const parsed = parsePackageSpecifier(specifier);
-    if (!parsed) {
-      continue;
-    }
-
-    const matrixEntry = lookupMatrixEntry(runtimeMatrix, parsed.packageName);
-    if (matrixEntry == null) {
-      continue;
-    }
-
-    const offset = match.index ?? 0;
-    const start = lineColumnAtOffset(source, offset);
-    const endColumn = start.column + match[0].length;
-
-    for (const context of effectiveContexts) {
-      if (!matrixEntry.compatible.includes(context)) {
-        violations.push({
-          packageName: parsed.packageName,
-          context,
-          rationale:
-            matrixEntry.rationale[context] ??
-            "package is incompatible with this runtime context",
-          line: start.line,
-          column: start.column,
-          endColumn,
-        });
-      }
-    }
-  }
-
-  return violations;
-}
+import { lookupMatrixEntry } from "../../../src/forge/compiler/classifier/runtime-matrix.ts";
+import type { ImportGuardsArtifact } from "../../../src/forge/compiler/types/import-guards.ts";
+import type { RuntimeContext } from "../../../src/forge/compiler/types/runtime.ts";
+import type { RuntimeMatrix } from "../../../src/forge/compiler/types/runtime-matrix.ts";
+import { parsePackageSpecifier } from "../../../src/forge/compiler/app-graph/module-graph.ts";
+
+export interface ForgeGuardSourceViolation {
+  packageName: string;
+  context: RuntimeContext;
+  rationale: string;
+  line: number;
+  column: number;
+  endColumn: number;
+}
+
+const IMPORT_PATTERN =
+  /(?:import\s+(?:type\s+)?(?:[\w*{}\s,]+from\s+)?|export\s+(?:type\s+)?(?:[\w*{}\s,]+from\s+)?)['"]([^'"]+)['"]|require\s*\(\s*['"]([^'"]+)['"]\s*\)/g;
+
+function lineColumnAtOffset(
+  source: string,
+  offset: number,
+): { line: number; column: number } {
+  const before = source.slice(0, offset);
+  const lines = before.split("\n");
+  return {
+    line: lines.length,
+    column: (lines.at(-1)?.length ?? 0) + 1,
+  };
+}
+
+function effectiveContextsForFile(
+  file: string,
+  guards: ImportGuardsArtifact,
+): RuntimeContext[] {
+  const normalized = file.replace(/\\/g, "/");
+  const entry = guards.moduleContexts.find(
+    (module) =>
+      module.file === normalized ||
+      normalized.endsWith(`/${module.file}`) ||
+      module.file.endsWith(normalized),
+  );
+  return entry?.effectiveContexts ?? [];
+}
+
+export function checkSourceForgeGuards(
+  filePath: string,
+  source: string,
+  importGuards: ImportGuardsArtifact,
+  runtimeMatrix: RuntimeMatrix,
+): ForgeGuardSourceViolation[] {
+  const effectiveContexts = effectiveContextsForFile(filePath, importGuards);
+  if (effectiveContexts.length === 0) {
+    return [];
+  }
+
+  const violations: ForgeGuardSourceViolation[] = [];
+
+  for (const match of source.matchAll(IMPORT_PATTERN)) {
+    const specifier = match[1] ?? match[2];
+    if (!specifier) {
+      continue;
+    }
+
+    const parsed = parsePackageSpecifier(specifier);
+    if (!parsed) {
+      continue;
+    }
+
+    const matrixEntry = lookupMatrixEntry(runtimeMatrix, parsed.packageName);
+    if (matrixEntry == null) {
+      continue;
+    }
+
+    const offset = match.index ?? 0;
+    const start = lineColumnAtOffset(source, offset);
+    const endColumn = start.column + match[0].length;
+
+    for (const context of effectiveContexts) {
+      if (!matrixEntry.compatible.includes(context)) {
+        violations.push({
+          packageName: parsed.packageName,
+          context,
+          rationale:
+            matrixEntry.rationale[context] ??
+            "package is incompatible with this runtime context",
+          line: start.line,
+          column: start.column,
+          endColumn,
+        });
+      }
+    }
+  }
+
+  return violations;
+}

package/packages/eslint-plugin-forge/src/load-artifacts.ts

@@ -1,24 +1,24 @@
-import { readFileSync } from "node:fs";
-import { stripDeterministicHeader } from "../../../src/forge/compiler/primitives/header.ts";
-import type { ImportGuardsArtifact } from "../../../src/forge/compiler/types/import-guards.ts";
-import type { RuntimeMatrix } from "../../../src/forge/compiler/types/runtime-matrix.ts";
-
-export interface ForgeGuardArtifacts {
-  importGuards: ImportGuardsArtifact;
-  runtimeMatrix: RuntimeMatrix;
-}
-
-function parseGeneratedJson<T>(path: string): T {
-  const raw = stripDeterministicHeader(readFileSync(path, "utf8"));
-  return JSON.parse(raw) as T;
-}
-
-export function loadForgeGuardArtifacts(
-  importGuardsPath: string,
-  runtimeMatrixPath: string,
-): ForgeGuardArtifacts {
-  const importGuards = parseGeneratedJson<ImportGuardsArtifact>(importGuardsPath);
-  const runtimeMatrix = parseGeneratedJson<RuntimeMatrix>(runtimeMatrixPath);
-
-  return { importGuards, runtimeMatrix };
-}
+import { readFileSync } from "node:fs";
+import { stripDeterministicHeader } from "../../../src/forge/compiler/primitives/header.ts";
+import type { ImportGuardsArtifact } from "../../../src/forge/compiler/types/import-guards.ts";
+import type { RuntimeMatrix } from "../../../src/forge/compiler/types/runtime-matrix.ts";
+
+export interface ForgeGuardArtifacts {
+  importGuards: ImportGuardsArtifact;
+  runtimeMatrix: RuntimeMatrix;
+}
+
+function parseGeneratedJson<T>(path: string): T {
+  const raw = stripDeterministicHeader(readFileSync(path, "utf8"));
+  return JSON.parse(raw) as T;
+}
+
+export function loadForgeGuardArtifacts(
+  importGuardsPath: string,
+  runtimeMatrixPath: string,
+): ForgeGuardArtifacts {
+  const importGuards = parseGeneratedJson<ImportGuardsArtifact>(importGuardsPath);
+  const runtimeMatrix = parseGeneratedJson<RuntimeMatrix>(runtimeMatrixPath);
+
+  return { importGuards, runtimeMatrix };
+}