forgeos 0.1.0-alpha.13 → 0.1.0-alpha.15

package/src/forge/brownfield-import/types.ts

@@ -0,0 +1,127 @@
+export type BrownfieldImportSubcommand = "analyze" | "inspect";
+
+export interface BrownfieldImportCommandOptions {
+  subcommand: BrownfieldImportSubcommand;
+  json: boolean;
+  dryRun: boolean;
+  workspaceRoot: string;
+  entry?: string;
+  target?: string;
+}
+
+export type ImportedAssurance = "static-scan";
+export type ImportedReviewStatus = "needs-review" | "approved" | "rejected";
+export type ImportedEntryKind = "command" | "query" | "unknown";
+export type ImportedRouteSource = "next-app-router" | "next-pages-api" | "express" | "nest" | "unknown";
+
+export interface ImportedDependencyInventory {
+  dependencies: string[];
+  devDependencies: string[];
+  scripts: string[];
+  frameworks: string[];
+  dataPackages: string[];
+  externalPackages: string[];
+}
+
+export interface ImportedInventory {
+  schemaVersion: "0.1.0";
+  origin: "imported";
+  assurance: ImportedAssurance;
+  workspaceRoot: string;
+  generatedAt: string;
+  packageName?: string;
+  dependencies: ImportedDependencyInventory;
+  filesScanned: number;
+  sourceFiles: string[];
+  env: {
+    processEnv: string[];
+    envFiles: string[];
+  };
+}
+
+export interface ImportedRoute {
+  id: string;
+  method: string;
+  path: string;
+  file: string;
+  source: ImportedRouteSource;
+  handler?: string;
+  confidence: number;
+}
+
+export interface ImportedFrontendCall {
+  id: string;
+  file: string;
+  client: "fetch" | "axios";
+  method: string;
+  url: string;
+  routeId?: string;
+  confidence: number;
+}
+
+export interface ImportedCandidateEntry {
+  id: string;
+  name: string;
+  kind: ImportedEntryKind;
+  method: string;
+  path: string;
+  routeId: string;
+  file: string;
+  origin: "imported";
+  assurance: ImportedAssurance;
+  reviewStatus: ImportedReviewStatus;
+  visibleToAgent: boolean;
+  needsApproval: boolean;
+  confidence: number;
+  risks: string[];
+  evidence: string[];
+}
+
+export interface ImportedRiskFinding {
+  code: string;
+  severity: "info" | "warning" | "error";
+  file?: string;
+  routeId?: string;
+  message: string;
+}
+
+export interface ImportedRiskReport {
+  schemaVersion: "0.1.0";
+  summary: {
+    routeCount: number;
+    frontendCallCount: number;
+    candidateCount: number;
+    commandCount: number;
+    queryCount: number;
+    hiddenFromAgents: number;
+    needsApproval: number;
+  };
+  findings: ImportedRiskFinding[];
+}
+
+export interface BrownfieldImportArtifacts {
+  inventory: string;
+  routes: string;
+  frontendCalls: string;
+  candidateEntries: string;
+  riskReport: string;
+  migrationPlan: string;
+  importedAgentContract: string;
+}
+
+export interface BrownfieldImportResult {
+  schemaVersion: "0.1.0";
+  feature: "H49";
+  subcommand: BrownfieldImportSubcommand;
+  workspaceRoot: string;
+  wroteArtifacts: boolean;
+  artifacts: BrownfieldImportArtifacts;
+  inventory: ImportedInventory | null;
+  routes: ImportedRoute[];
+  frontendCalls: ImportedFrontendCall[];
+  candidateEntries: ImportedCandidateEntry[];
+  riskReport: ImportedRiskReport | null;
+  migrationPlan: string | null;
+  exitCode: 0 | 1;
+  failureKind?: string;
+}

package/src/forge/cli/commands.ts

@@ -160,6 +160,12 @@ import {
   formatForgeDoJson,
   runForgeDoCommand,
 } from "../intent/index.ts";
+import {
+  formatBrownfieldImportHuman,
+  formatBrownfieldImportJson,
+  inspectBrownfieldImport,
+  runBrownfieldImportCommand,
+} from "../brownfield-import/index.ts";
 import {
   formatAgentHuman,
   formatAgentJson,
@@ -518,6 +524,18 @@ export async function runInspectCommand(
     };
   }
 
+  if (target === "imported") {
+    const result = inspectBrownfieldImport(workspaceRoot);
+    return {
+      target,
+      data: formatBrownfieldImportJson(result),
+      warnings: [],
+      errors: [],
+      exitCode: result.exitCode,
+      failureKind: result.failureKind,
+    };
+  }
+
   if (target === "all") {
     const aggregatePaths: Array<[string, string]> = [
       ["app", `${GENERATED_DIR}/appGraph.json`],
@@ -973,6 +991,15 @@ export async function executeCommand(command: ForgeCommand): Promise<number> {
       }
       return result.exitCode;
     }
+    case "import": {
+      const result = runBrownfieldImportCommand(command.options);
+      if (command.options.json) {
+        process.stdout.write(formatJsonResult(formatBrownfieldImportJson(result)));
+      } else {
+        process.stdout.write(formatBrownfieldImportHuman(result));
+      }
+      return result.exitCode;
+    }
     case "inspect": {
       const result = await runInspectCommand(
         command.target,

package/src/forge/cli/parse.ts

@@ -48,6 +48,7 @@ import type {
 } from "../ui/types.ts";
 import type { ForgeDoOptions } from "../intent/types.ts";
 import type { BenchCommandOptions, BenchSubcommand } from "../bench.ts";
+import type { BrownfieldImportCommandOptions } from "../brownfield-import/types.ts";
 
 export type ForgeCommand =
   | { kind: "version"; json: boolean }
@@ -168,6 +169,7 @@ export type ForgeCommand =
   | { kind: "review"; options: ReviewCommandOptions }
   | { kind: "ui"; options: UiCommandOptions }
   | { kind: "manifest"; subcommand: "validate" | "import"; path: string; json: boolean; workspaceRoot: string }
+  | { kind: "import"; options: BrownfieldImportCommandOptions }
   | { kind: "delta"; subcommand: "status"; json: boolean; workspaceRoot: string }
   | { kind: "timeline"; target?: string; kindFilter?: string; sessionId?: string; limit?: number; json: boolean; rebuild: boolean; forAgent: boolean; workspaceRoot: string }
   | { kind: "explain"; thing: string; json: boolean; workspaceRoot: string }
@@ -360,6 +362,7 @@ export const TOP_LEVEL_COMMANDS = [
   "timeline",
   "explain",
   "manifest",
+  "import",
   "generate",
   "add",
   "inspect",
@@ -416,6 +419,7 @@ export const INSPECT_TARGETS: InspectTarget[] = [
   "agent-adapters",
   "capability-map",
   "framework",
+  "imported",
   "ui",
   "ui-scenarios",
   "ui-routes",
@@ -1266,7 +1270,7 @@ export function parseCli(argv: string[]): ParsedCli {
             event: parseOptionValue(argv, "--event"),
             trigger: parseOptionValue(argv, "--trigger"),
             component: parseOptionValue(argv, "--component"),
-            framework: parseOptionValue(argv, "--framework") as "vite" | "next" | undefined,
+            framework: parseOptionValue(argv, "--framework") as "vite" | "next" | "nuxt" | undefined,
             withAi: parseFlag(argv, "--with-ai"),
             withCrud: parseFlag(argv, "--with-crud"),
             withLiveQuery: parseFlag(argv, "--with-livequery"),
@@ -1711,6 +1715,28 @@ export function parseCli(argv: string[]): ParsedCli {
         errors,
       };
     }
+    case "import": {
+      const subcommand = rest[0];
+      if (subcommand !== "analyze" && subcommand !== "inspect") {
+        errors.push("forge import requires subcommand analyze or inspect");
+        return { command: null, workspaceRoot, errors };
+      }
+      return {
+        command: {
+          kind: "import",
+          options: {
+            subcommand,
+            json: parseFlag(argv, "--json"),
+            dryRun: parseFlag(argv, "--dry-run"),
+            workspaceRoot,
+            entry: parseOptionValue(argv, "--entry"),
+            target: parseOptionValue(argv, "--target"),
+          },
+        },
+        workspaceRoot,
+        errors,
+      };
+    }
     case "add": {
       const alias = rest[0];
       if (!alias) {

package/src/forge/cli/verify.ts

@@ -350,6 +350,7 @@ const STRICT_TEST_FALLBACK_MS_BY_PATH: Array<{ pattern: RegExp; estimatedMs: num
   { pattern: /^tests\/external-manifest\/external-runtime-cli\.test\.ts$/, estimatedMs: 6_000 },
   { pattern: /^tests\/external-manifest\/external-runtime-node-cli\.test\.ts$/, estimatedMs: 12_000 },
   { pattern: /^tests\/external-manifest\/go-adapter-conformance\.test\.ts$/, estimatedMs: 5_000 },
+  { pattern: /^tests\/external-manifest\/java-adapter-conformance\.test\.ts$/, estimatedMs: 20_000 },
   { pattern: /^tests\/impact\/h28-impact\.test\.ts$/, estimatedMs: 8_000 },
   { pattern: /^tests\/impact\/h28-impact-runner\.test\.ts$/, estimatedMs: 7_000 },
   { pattern: /^tests\/impact\/h28-impact-runner-diagnostics\.test\.ts$/, estimatedMs: 3_000 },
@@ -378,6 +379,7 @@ const STRICT_ISOLATED_TEST_PATTERNS = [
   /^tests\/dev\//,
   /^tests\/external-manifest\/external-manifest\.test\.ts$/,
   /^tests\/external-manifest\/go-adapter-conformance\.test\.ts$/,
+  /^tests\/external-manifest\/java-adapter-conformance\.test\.ts$/,
   /^tests\/external-manifest\/external-runtime-bridge\.test\.ts$/,
   /^tests\/external-manifest\/external-runtime-node-cli\.test\.ts$/,
   /^tests\/impact\/h28-impact\.test\.ts$/,

package/src/forge/compiler/agent-contract/build.ts

@@ -453,17 +453,17 @@ function playbooks(): AgentPlaybook[] {
         "Run forge dev --once --json for a one-shot diagnostic cycle.",
         "Use --api-only, --web-only, --no-watch, or --no-worker only when narrowing the loop intentionally.",
         "When a web app exists, forge dev starts the API runtime and the web dev server together and prints both URLs.",
-        "Use generated client and React hooks through web/lib/forge.ts.",
+        "Use generated client bindings through web/lib/forge.ts, web/src/lib/forge.ts, or Nuxt web/composables/forge.ts.",
       ],
     },
     {
       title: "Add or update frontend",
       steps: [
-        "Run forge make ui --framework vite --dry-run --json when the app does not have a web root.",
+        "Run forge make ui --framework vite --dry-run --json or forge make ui --framework nuxt --dry-run --json when the app does not have a web root.",
         "Run forge make ai-chat support --dry-run --json to add a chat surface backed by /ai/agents/chat streaming and /ai/agents/run JSON automation.",
-        "Use web/lib/forge.ts as the generated client bridge.",
-        "Mount ForgeProvider once in the web app provider/layout layer; use devAuth for local development.",
-        "Use useQuery, useCommand, and useLiveQuery instead of raw /commands or /queries fetches.",
+        "Use web/lib/forge.ts, web/src/lib/forge.ts, or web/composables/forge.ts as the generated client bridge.",
+        "Mount ForgeProvider or install the Nuxt Forge plugin once in the web app provider/layout layer; use devAuth for local development.",
+        "Use useQuery/useCommand/useLiveQuery or useForgeQuery/useForgeCommand/useForgeLiveQuery instead of raw /commands or /queries fetches.",
         "Run forge generate so frontendGraph and agentContract include routes and bindings.",
         "Run forge inspect capabilities --json to confirm UI actions map to runtime capabilities.",
         "Run forge dev --once --json and forge doctor --json.",
@@ -1502,9 +1502,9 @@ ${contract.frontend.dev ? `- Web URL: ${contract.frontend.dev.url}
 
 Rules:
 
-- Use the local \`web/**/lib/forge.ts\` bridge to generated hooks.
-- Mount \`<ForgeProvider devAuth>\` in local development.
-- Use \`useQuery\`, \`useCommand\`, and \`useLiveQuery\` instead of raw Forge endpoint fetches in React components.
+- Use the local \`web/**/lib/forge.ts\` or Nuxt \`web/composables/forge.ts\` bridge to generated bindings.
+- Mount \`<ForgeProvider devAuth>\` or install the Nuxt Forge plugin in local development.
+- Use \`useQuery\`/\`useCommand\`/\`useLiveQuery\` or \`useForgeQuery\`/\`useForgeCommand\`/\`useForgeLiveQuery\` instead of raw Forge endpoint fetches in components.
 - Keep frontend routes reflected in \`src/forge/_generated/frontendGraph.json\`.
 
 ## Common tasks
@@ -1537,6 +1537,7 @@ Use:
 forge make resource <name> --fields title:text,status:enum(open,closed) --dry-run --json
 forge make resource <name> --fields title:text,status:enum(open,closed) --with-ui --yes
 forge make ui --framework vite --dry-run --json
+forge make ui --framework nuxt --dry-run --json
 forge make ai-chat support --dry-run --json
 \`\`\`
 
@@ -1553,7 +1554,7 @@ forge inspect frontend --json
 forge inspect capabilities --json
 \`\`\`
 
-\`forge dev\` starts the API runtime and web app together when \`web/\` exists. \`forge dev --once --json\` reports routes, components, \`ForgeProvider\`, bridge files, generated client bindings, direct runtime fetch warnings, capability-map parity warnings, and fix hints.
+\`forge dev\` starts the API runtime and web app together when \`web/\` exists. \`forge dev --once --json\` reports routes, components, providers/plugins, bridge files, generated client bindings, direct runtime fetch warnings, capability-map parity warnings, and fix hints.
 
 ### Apply a feature blueprint
 

package/src/forge/compiler/client-sdk/build-manifest.ts

@@ -23,6 +23,10 @@ export interface ClientManifest {
     entrypoint: string;
     hooks: string[];
   };
+  vue: {
+    entrypoint: string;
+    composables: string[];
+  };
   excluded: {
     actions: string[];
     workflows: string[];
@@ -43,6 +47,18 @@ export interface ReactManifest {
   clientSafe: true;
 }
 
+export interface VueManifest {
+  schemaVersion: string;
+  generatorVersion: string;
+  inputHash: string;
+  entrypoint: string;
+  composables: string[];
+  queries: string[];
+  commands: string[];
+  liveQueries: string[];
+  clientSafe: true;
+}
+
 const SERVER_ADAPTER_SUFFIX = ".server.ts";
 
 function collectServerAdapters(classified: ClassifiedPackage[]): string[] {
@@ -117,6 +133,17 @@ export function buildClientManifest(
         "useLiveQuery",
       ],
     },
+    vue: {
+      entrypoint: "src/forge/_generated/vue.ts",
+      composables: [
+        "provideForge",
+        "useForgeClient",
+        "useForgeAuth",
+        "useForgeQuery",
+        "useForgeCommand",
+        "useForgeLiveQuery",
+      ],
+    },
     excluded: {
       actions,
       workflows,
@@ -153,3 +180,31 @@ export function buildReactManifest(clientManifest: ClientManifest): ReactManifes
     clientSafe: true,
   };
 }
+
+export function buildVueManifest(clientManifest: ClientManifest): VueManifest {
+  const composables = [
+    "provideForge",
+    "useForgeClient",
+    "useForgeAuth",
+    "useForgeQuery",
+    "useForgeCommand",
+    "useForgeLiveQuery",
+  ];
+
+  return {
+    schemaVersion: "1.0.0",
+    generatorVersion: GENERATOR_VERSION,
+    inputHash: hashStable(
+      canonicalJson({
+        clientInputHash: clientManifest.inputHash,
+        composables,
+      }),
+    ),
+    entrypoint: "src/forge/_generated/vue.ts",
+    composables,
+    queries: clientManifest.queries,
+    commands: clientManifest.commands,
+    liveQueries: clientManifest.liveQueries,
+    clientSafe: true,
+  };
+}

package/src/forge/compiler/client-sdk/render-client.ts

@@ -1,4 +1,4 @@
-import type { ClientManifest, ReactManifest } from "./build-manifest.ts";
+import type { ClientManifest, ReactManifest, VueManifest } from "./build-manifest.ts";
 
 export function renderClientTypesTs(): string {
   return `export type ForgeStaticAuth = {
@@ -535,3 +535,68 @@ export declare const useLiveQuery: import("forge/react").ForgeReactBindings["use
 export function renderReactManifestTs(manifest: ReactManifest): string {
   return `export const reactManifest = ${JSON.stringify(manifest, null, 2)} as const;\n`;
 }
+
+export function renderVueTs(): string {
+  return `import { createForgeVueBindings } from "forge/vue";
+import { createForgeClient } from "./client.ts";
+
+export type {
+  ForgeDevAuthConfig,
+  ForgeVueAuth,
+  ForgeVueAuthProvider,
+  ForgeVueBindings,
+  ForgeVueClient,
+  ForgeVueClientConfig,
+  ForgeVueError,
+  ForgeVuePluginOptions,
+  UseForgeCommandOptions,
+  UseForgeCommandResult,
+  UseForgeLiveQueryOptions,
+  UseForgeLiveQueryResult,
+  UseForgeQueryOptions,
+  UseForgeQueryResult,
+} from "forge/vue";
+
+const forgeVue = createForgeVueBindings(createForgeClient);
+
+export const ForgeVuePlugin = forgeVue.ForgeVuePlugin;
+export const provideForge = forgeVue.provideForge;
+export const useForgeClient = forgeVue.useForgeClient;
+export const useForgeAuth = forgeVue.useForgeAuth;
+export const useForgeQuery = forgeVue.useForgeQuery;
+export const useForgeCommand = forgeVue.useForgeCommand;
+export const useForgeLiveQuery = forgeVue.useForgeLiveQuery;
+`;
+}
+
+export function renderVueDts(): string {
+  return `export type {
+  ForgeDevAuthConfig,
+  ForgeVueAuth,
+  ForgeVueAuthProvider,
+  ForgeVueBindings,
+  ForgeVueClient,
+  ForgeVueClientConfig,
+  ForgeVueError,
+  ForgeVuePluginOptions,
+  UseForgeCommandOptions,
+  UseForgeCommandResult,
+  UseForgeLiveQueryOptions,
+  UseForgeLiveQueryResult,
+  UseForgeQueryOptions,
+  UseForgeQueryResult,
+} from "forge/vue";
+
+export declare const ForgeVuePlugin: import("forge/vue").ForgeVueBindings["ForgeVuePlugin"];
+export declare const provideForge: import("forge/vue").ForgeVueBindings["provideForge"];
+export declare const useForgeClient: import("forge/vue").ForgeVueBindings["useForgeClient"];
+export declare const useForgeAuth: import("forge/vue").ForgeVueBindings["useForgeAuth"];
+export declare const useForgeQuery: import("forge/vue").ForgeVueBindings["useForgeQuery"];
+export declare const useForgeCommand: import("forge/vue").ForgeVueBindings["useForgeCommand"];
+export declare const useForgeLiveQuery: import("forge/vue").ForgeVueBindings["useForgeLiveQuery"];
+`;
+}
+
+export function renderVueManifestTs(manifest: VueManifest): string {
+  return `export const vueManifest = ${JSON.stringify(manifest, null, 2)} as const;\n`;
+}

package/src/forge/compiler/diagnostics/create.ts

@@ -106,7 +106,12 @@ function defaultGuidanceForCode(code: string): DiagnosticGuidance | null {
   if (code.startsWith("FORGE_FRONTEND_")) {
     return {
       fixHint: "Use the generated frontend bridge and inspect src/forge/_generated/frontendGraph.json before editing UI wiring.",
-      suggestedCommands: ["forge inspect frontend --json", "forge make ui --framework vite --dry-run --json", "forge generate"],
+      suggestedCommands: [
+        "forge inspect frontend --json",
+        "forge make ui --framework vite --dry-run --json",
+        "forge make ui --framework nuxt --dry-run --json",
+        "forge generate",
+      ],
       docs: ["src/forge/_generated/frontendGraph.json", "AGENTS.md"],
     };
   }

package/src/forge/compiler/emitter/barrel.ts

@@ -33,6 +33,9 @@ export function buildBarrelIndexBody(exportFilePaths: string[]): string {
 
   const lines = unique.map((path) => {
     const exportPath = toBarrelExportPath(path);
+    if (exportPath === "./vue") {
+      return `export * as vue from "${exportPath}";`;
+    }
     return `export * from "${exportPath}";`;
   });