forgeos 0.1.0-alpha.0 → 0.1.0-alpha.2

package/src/forge/compiler/types/package-graph.ts

@@ -1,80 +1,125 @@
-import type { CapabilitySet } from "./capability.ts";
-import type { RuntimeExportShape } from "./sandbox.ts";
-import type {
-  PackageManager,
-  ResolutionMode,
-  RuntimeContext,
-  SandboxBackend,
-} from "./runtime.ts";
-
-export interface JsDoc {
-  summary: string;
-  tags: { tag: string; text: string }[];
-}
-
-export interface ExportClassification {
-  alias: string;
-  packageName: string;
-  entrypoint: string;
-  exportName: string;
-  compatible: RuntimeContext[];
-  incompatible: RuntimeContext[];
-  capabilities: CapabilitySet;
-}
-
-export type ExportKind =
-  | "function"
-  | "class"
-  | "const"
-  | "type"
-  | "interface"
-  | "namespace";
-
-export interface ExportSignature {
-  name: string;
-  kind: ExportKind;
-  signature: string;
-  overloads?: string[];
-  declarations?: string[];
-  classification: ExportClassification;
-  jsdoc: JsDoc | null;
-  examples: string[];
-}
-
-export interface Entrypoint {
-  subpath: string;
-  conditions: string[];
-  patternBacked: boolean;
-  dtsPath: string | null;
-  exports: ExportSignature[];
-}
-
-export interface PackageApi {
-  name: string;
-  version: string;
-  packageManager: PackageManager;
-  resolutionMode: ResolutionMode;
-  entrypoints: Entrypoint[];
-  source: "static" | "static+runtime";
-  runtimeShape?: RuntimeExportShape;
-  contentChecksum: string;
-}
-
-export interface PackageGraph {
-  schemaVersion: string;
-  generatorVersion: string;
-  analyzerVersion: string;
-  packages: PackageApi[];
-}
-
-export interface Dependency {
-  name: string;
-  version: string;
-  packageManager: PackageManager;
-  packageIntegrity?: string;
-  installPath: string;
-}
-
+import type { CapabilitySet } from "./capability.ts";
+import type { RuntimeExportKind, RuntimeExportShape } from "./sandbox.ts";
+import type {
+  PackageManager,
+  ResolutionMode,
+  RuntimeContext,
+  SandboxBackend,
+} from "./runtime.ts";
+
+export interface JsDoc {
+  summary: string;
+  tags: { tag: string; text: string }[];
+}
+
+export interface ExportClassification {
+  alias: string;
+  packageName: string;
+  entrypoint: string;
+  exportName: string;
+  compatible: RuntimeContext[];
+  incompatible: RuntimeContext[];
+  capabilities: CapabilitySet;
+}
+
+export type ExportKind =
+  | "function"
+  | "class"
+  | "const"
+  | "type"
+  | "interface"
+  | "namespace";
+
+export interface ExportSignature {
+  name: string;
+  kind: ExportKind;
+  signature: string;
+  overloads?: string[];
+  declarations?: string[];
+  classification: ExportClassification;
+  jsdoc: JsDoc | null;
+  examples: string[];
+}
+
+export interface ResolutionTraceStep {
+  step: string;
+  status: "ok" | "miss" | "fallback" | "warning";
+  detail: string;
+}
+
+export interface RuntimeTypeMismatch {
+  entrypoint: string;
+  exportName: string;
+  kind: "types-only" | "runtime-only" | "kind-mismatch";
+  typesKind?: ExportKind;
+  runtimeKind?: RuntimeExportKind;
+}
+
+export type RuntimeCompatibilityStatus = "compatible" | "risky" | "unknown";
+
+export interface PackageRuntimeCompatibility {
+  node: RuntimeCompatibilityStatus;
+  bun: RuntimeCompatibilityStatus;
+  browser: RuntimeCompatibilityStatus;
+  edge: RuntimeCompatibilityStatus;
+  reasons: string[];
+  risks: string[];
+}
+
+export interface PackageMetadata {
+  type?: "module" | "commonjs";
+  engines: Record<string, string>;
+  entryFields: {
+    main?: string;
+    module?: string;
+    browser?: string | boolean;
+    types?: string;
+  };
+  peerDependencies: string[];
+  optionalPeerDependencies: string[];
+  hasInstallScripts: boolean;
+  hasNativeBindings: boolean;
+  exportSubpathCount: number;
+}
+
+export interface Entrypoint {
+  subpath: string;
+  conditions: string[];
+  patternBacked: boolean;
+  dtsPath: string | null;
+  resolutionTrace?: ResolutionTraceStep[];
+  exports: ExportSignature[];
+}
+
+export interface PackageApi {
+  name: string;
+  version: string;
+  packageManager: PackageManager;
+  resolutionMode: ResolutionMode;
+  entrypoints: Entrypoint[];
+  source: "static" | "static+runtime";
+  runtimeShape?: RuntimeExportShape;
+  runtimeTypeMismatches?: RuntimeTypeMismatch[];
+  runtimeCompatibility?: PackageRuntimeCompatibility;
+  metadata?: PackageMetadata;
+  contentChecksum: string;
+}
+
+export interface PackageGraph {
+  schemaVersion: string;
+  generatorVersion: string;
+  analyzerVersion: string;
+  packages: PackageApi[];
+}
+
+export interface Dependency {
+  name: string;
+  version: string;
+  packageManager: PackageManager;
+  packageIntegrity?: string;
+  installPath: string;
+}
+
 export interface AnalyzeOptions {
   runtimeInspect: boolean;
   sandboxBackend?: SandboxBackend;

package/src/forge/compiler/types/runtime-matrix.ts

@@ -1,16 +1,16 @@
-import type { ExportClassification } from "./package-graph.ts";
-import type { RuntimeContext } from "./runtime.ts";
-
-export interface RuntimeMatrixEntry {
-  alias: string;
-  packageName: string;
-  compatible: RuntimeContext[];
-  incompatible: RuntimeContext[];
-  rationale: Record<RuntimeContext, string>;
-  perEntrypoint: ExportClassification[];
-}
-
-export interface RuntimeMatrix {
-  schemaVersion: string;
-  entries: RuntimeMatrixEntry[];
-}
+import type { ExportClassification } from "./package-graph.ts";
+import type { RuntimeContext } from "./runtime.ts";
+
+export interface RuntimeMatrixEntry {
+  alias: string;
+  packageName: string;
+  compatible: RuntimeContext[];
+  incompatible: RuntimeContext[];
+  rationale: Record<RuntimeContext, string>;
+  perEntrypoint: ExportClassification[];
+}
+
+export interface RuntimeMatrix {
+  schemaVersion: string;
+  entries: RuntimeMatrixEntry[];
+}

package/src/forge/compiler/types/runtime.ts

@@ -1,30 +1,30 @@
-export const RUNTIME_CONTEXTS = [
-  "shared",
-  "client",
-  "server",
-  "query",
-  "liveQuery",
-  "command",
-  "action",
-  "workflow",
-  "endpoint",
-  "edge",
-  "test",
-  "build",
-] as const;
-
-export type RuntimeContext = (typeof RUNTIME_CONTEXTS)[number];
-
-export const DETERMINISTIC_CONTEXTS = [
-  "command",
-  "query",
-  "liveQuery",
-] as const satisfies readonly RuntimeContext[];
-
-export type DeterministicContext = (typeof DETERMINISTIC_CONTEXTS)[number];
-
-export type PackageManager = "bun" | "npm" | "pnpm" | "yarn";
-
-export type ResolutionMode = "nodenext" | "bundler";
-
-export type SandboxBackend = "none" | "child" | "docker";
+export const RUNTIME_CONTEXTS = [
+  "shared",
+  "client",
+  "server",
+  "query",
+  "liveQuery",
+  "command",
+  "action",
+  "workflow",
+  "endpoint",
+  "edge",
+  "test",
+  "build",
+] as const;
+
+export type RuntimeContext = (typeof RUNTIME_CONTEXTS)[number];
+
+export const DETERMINISTIC_CONTEXTS = [
+  "command",
+  "query",
+  "liveQuery",
+] as const satisfies readonly RuntimeContext[];
+
+export type DeterministicContext = (typeof DETERMINISTIC_CONTEXTS)[number];
+
+export type PackageManager = "bun" | "npm" | "pnpm" | "yarn";
+
+export type ResolutionMode = "nodenext" | "bundler";
+
+export type SandboxBackend = "none" | "child" | "docker";

package/src/forge/compiler/types/sandbox.ts

@@ -1,24 +1,24 @@
-export type RuntimeExportKind =
-  | "function"
-  | "class"
-  | "const"
-  | "object"
-  | "unknown";
-
-export interface RuntimeExportEntry {
-  name: string;
-  kind: RuntimeExportKind;
-}
-
-export interface RuntimeEntrypointShape {
-  subpath: string;
-  exports: RuntimeExportEntry[];
-}
-
-export interface RuntimeExportShape {
-  entrypoints: RuntimeEntrypointShape[];
-}
-
-export function emptyRuntimeExportShape(): RuntimeExportShape {
-  return { entrypoints: [] };
-}
+export type RuntimeExportKind =
+  | "function"
+  | "class"
+  | "const"
+  | "object"
+  | "unknown";
+
+export interface RuntimeExportEntry {
+  name: string;
+  kind: RuntimeExportKind;
+}
+
+export interface RuntimeEntrypointShape {
+  subpath: string;
+  exports: RuntimeExportEntry[];
+}
+
+export interface RuntimeExportShape {
+  entrypoints: RuntimeEntrypointShape[];
+}
+
+export function emptyRuntimeExportShape(): RuntimeExportShape {
+  return { entrypoints: [] };
+}

package/src/forge/dev/server.ts

@@ -114,7 +114,7 @@ async function nodeRequestToFetch(
   return new Request(url, init);
 }
 
-async function writeFetchResponse(
+export async function writeFetchResponse(
   response: ServerResponse,
   fetchResponse: Response,
 ): Promise<void> {
@@ -128,7 +128,21 @@ async function writeFetchResponse(
     return;
   }
 
-  response.end(Buffer.from(await fetchResponse.arrayBuffer()));
+  const reader = fetchResponse.body.getReader();
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) {
+        break;
+      }
+      response.write(Buffer.from(value));
+    }
+    response.end();
+  } catch (error) {
+    response.destroy(error instanceof Error ? error : undefined);
+  } finally {
+    reader.releaseLock();
+  }
 }
 
 async function createNodeFetchServer(

package/src/forge/refactor/index.ts

@@ -30,6 +30,9 @@ import {
   pushUnique,
   wordReplace,
 } from "./text-utils.ts";
+import {
+  buildRenameRuntimeEntryPlan,
+} from "./runtime-rename.ts";
 
 const REFACTOR_DIR = ".forge/refactors";
 
@@ -1589,8 +1592,13 @@ function planParts(workspaceRoot: string, intent: RefactorIntent): {
     return { patches: result.patches, filesToCreate: [], filesToDelete: [], diagnostics: result.diagnostics };
   }
   if (intent.kind === "renameRuntimeEntry") {
-    const result = buildStringRenamePlan(workspaceRoot, intent.from, intent.to, `Rename ${intent.entryKind} ${intent.from} to ${intent.to}`);
-    return { patches: result.patches, filesToCreate: [], filesToDelete: [], diagnostics: result.diagnostics };
+    const result = buildRenameRuntimeEntryPlan(workspaceRoot, intent);
+    return {
+      patches: result.patches,
+      filesToCreate: result.filesToCreate,
+      filesToDelete: result.filesToDelete,
+      diagnostics: result.diagnostics,
+    };
   }
   if (intent.kind === "moveComponent") {
     const result = buildMoveComponentPlan(workspaceRoot, intent);