forgeos 0.1.0-alpha.26 → 0.1.0-alpha.27

package/.npmignore

@@ -5,6 +5,12 @@ node_modules/
 .forge/
 tests/
 examples/
+adapters/**/target/
+examples/**/target/
+*.class
+*.jar
+**/*.class
+**/*.jar
 src/forge/_generated/**
 !src/forge/_generated/
 !src/forge/_generated/releaseManifest.json

package/AGENTS.md

@@ -1,4 +1,4 @@
-// @forge-generated generator=0.1.0-alpha.26 input=23c00c5407aab4088b55b49905f2b195667a75b8544fa180786ac637ee67e1e5 content=0d493cf0e41b71cb652d5e0e1b0c1f83d2a1281b748321f0b00f0773ba93074e
+// @forge-generated generator=0.1.0-alpha.27 input=6c5ffcc15b409d33158dc8e5a5c4684c2d59b0e31e7c9064bdb6dacbe95ac874 content=0d493cf0e41b71cb652d5e0e1b0c1f83d2a1281b748321f0b00f0773ba93074e
 # AGENTS.md
 
 <!-- forge-generated:start -->

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # forgeos
 
+## 0.1.0-alpha.27
+
+### Patch Changes
+
+- Stabilize `forge add convex` and generated integration artifacts.
+
+  - Re-emit integration adapters, docs, and testkits from the main generator so `forge generate --check` and `forge verify --smoke` stay clean after `forge add`.
+  - Keep partial `forge add` plans from deleting unrelated generated files before the full generator can reconcile the workspace.
+  - Include changed package-manager files such as `package.json` and lockfiles in `forge add --json` handoffs.
+  - Replace stale fast-check manifest hashes instead of merging them, and invalidate old manifest schemas to avoid phantom generated drift.
+  - Skip Bun module mock registration when the active Bun runtime does not expose `Bun.mock.module`, while still applying mock secret env vars.
+  - Filter generated and operational filesystem noise from `forge changed --authored` in non-git workspaces.
+  - Keep Java build outputs such as `target/`, `.class`, and `.jar` files out of the published npm tarball.
+
 ## 0.1.0-alpha.26
 
 ### Patch Changes

package/docs/changelog.md

@@ -6,6 +6,19 @@ The canonical source file in the repository is `CHANGELOG.md`.
 
 ## Unreleased
 
+## 0.1.0-alpha.27
+
+- Stabilized the `forge add convex` loop: integration docs/testkits are now
+  re-emitted by the main generator, partial `forge add` plans no longer remove
+  unrelated generated files, stale fast-check manifest hashes are pruned instead
+  of merged, and `forge add --json` includes changed package-manager files.
+- Made runtime mock mode tolerate Bun builds without `Bun.mock.module` while
+  still applying mock secret environment variables.
+- Filtered generated and operational filesystem noise from
+  `forge changed --authored` in non-git workspaces.
+- Excluded Java build outputs such as `target/`, `.class`, and `.jar` files
+  from the published npm tarball.
+
 ## 0.1.0-alpha.26
 
 - Hardened the field-demo loop after the Team Onboarding app exercise:

package/package.json

@@ -1,16 +1,22 @@
 {
   "name": "forgeos",
-  "version": "0.1.0-alpha.26",
+  "version": "0.1.0-alpha.27",
   "description": "Agent-native application framework and compiler for building Forge apps without a mandatory dashboard.",
   "type": "module",
   "license": "MIT",
   "files": [
     "adapters/",
+    "!adapters/**/target/**",
+    "!adapters/**/*.class",
+    "!adapters/**/*.jar",
     "bin/",
     "docs/cair-protocol.md",
     "docs/forge-protocol.md",
     "examples/go-billing/",
     "examples/java-billing/",
+    "!examples/**/target/**",
+    "!examples/**/*.class",
+    "!examples/**/*.jar",
     "packages/eslint-plugin-forge/",
     "schemas/",
     "src/",

package/src/forge/_generated/releaseManifest.json

@@ -1 +1 @@
-{"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.26","releaseId":"forgeos@0.1.0-alpha.26+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.27","releaseId":"forgeos@0.1.0-alpha.27+unknown","schemaVersion":"0.1.0"}

package/src/forge/_generated/releaseManifest.ts

@@ -1,4 +1,4 @@
-// @forge-generated generator=0.1.0-alpha.26 input=23c00c5407aab4088b55b49905f2b195667a75b8544fa180786ac637ee67e1e5 content=967d4e05aa540b3e3d843fa6ed4516658ab4c364c1d8c42a14f36c57b75dff71
+// @forge-generated generator=0.1.0-alpha.27 input=6c5ffcc15b409d33158dc8e5a5c4684c2d59b0e31e7c9064bdb6dacbe95ac874 content=3a34de2474ecf200ab734c0a01f9dd2c6a780af76bd650d3238c8b46313542b3
 export const releaseManifest = {
   "defaultProvider": "local",
   "diagnostics": [],
@@ -19,7 +19,7 @@ export const releaseManifest = {
     "custom"
   ],
   "packageName": "forgeos",
-  "packageVersion": "0.1.0-alpha.26",
-  "releaseId": "forgeos@0.1.0-alpha.26+unknown",
+  "packageVersion": "0.1.0-alpha.27",
+  "releaseId": "forgeos@0.1.0-alpha.27+unknown",
   "schemaVersion": "0.1.0"
 } as const;

package/src/forge/cli/changed.ts

@@ -1,5 +1,9 @@
 import type { CategorizedFileSummary, DiffPlan } from "../workspace/change-summary.ts";
-import { buildDiffPlanFromChangeSummary, summarizeChangeTypes } from "../workspace/change-summary.ts";
+import {
+  buildDiffPlanFromChangeSummary,
+  filterCategorizedSummary,
+  summarizeChangeTypes,
+} from "../workspace/change-summary.ts";
 import { buildWorkspaceGitSummary, type WorkspaceGitSummary } from "../workspace/git-summary.ts";
 
 export interface ChangedCommandResult {
@@ -39,6 +43,8 @@ interface GeneratedChangeExplanation {
   summary: string;
 }
 
+const AUTHORED_CHANGE_TYPES = ["source", "tests", "docs", "config", "assets", "other"] as const;
+
 function emptyCategory(summary: CategorizedFileSummary, category: keyof CategorizedFileSummary["byType"]): boolean {
   return summary.byType[category].count === 0;
 }
@@ -183,23 +189,22 @@ export function runChangedCommand(workspaceRoot: string, options: { authoredOnly
   const changed = git.changeSummary.changed;
   const humanChanges = selectHumanChangeSummary(changed);
   const derivedChanges = selectDerivedChangeSummary(changed);
-  const authoredChanged: CategorizedFileSummary = {
-    ...changed,
-    total: { ...changed.total, count: humanChanges.total },
-    byType: {
-      ...changed.byType,
-      generated: { count: 0, sample: [], hidden: 0 },
-    },
-    primaryTypes: changed.primaryTypes.filter((type) => type !== "generated"),
-  };
+  const authoredChanged = filterCategorizedSummary(changed, [...AUTHORED_CHANGE_TYPES]);
+  const authoredStaged = filterCategorizedSummary(git.changeSummary.staged, [...AUTHORED_CHANGE_TYPES]);
+  const authoredUnstaged = filterCategorizedSummary(git.changeSummary.unstaged, [...AUTHORED_CHANGE_TYPES]);
+  const authoredUntracked = filterCategorizedSummary(git.changeSummary.untracked, [...AUTHORED_CHANGE_TYPES]);
+  const viewHumanChanges = options.authoredOnly ? selectHumanChangeSummary(authoredChanged) : humanChanges;
   const viewChanged = options.authoredOnly ? authoredChanged : changed;
+  const viewStaged = options.authoredOnly ? authoredStaged : git.changeSummary.staged;
+  const viewUnstaged = options.authoredOnly ? authoredUnstaged : git.changeSummary.unstaged;
+  const viewUntracked = options.authoredOnly ? authoredUntracked : git.changeSummary.untracked;
   const viewDerivedChanges: DerivedChangeSummary = options.authoredOnly
     ? { total: 0, generated: { count: 0, sample: [], hidden: 0 } }
     : derivedChanges;
   const risks = buildRisks(git);
   const recommendedCommands = buildRecommendedCommands(git);
-  const reviewFocus = buildReviewFocus(humanChanges, viewDerivedChanges);
-  const generatedExplanation = buildGeneratedChangeExplanation(humanChanges, viewDerivedChanges);
+  const reviewFocus = buildReviewFocus(viewHumanChanges, viewDerivedChanges);
+  const generatedExplanation = buildGeneratedChangeExplanation(viewHumanChanges, viewDerivedChanges);
   const diffPlan: DiffPlan = buildDiffPlanFromChangeSummary(viewChanged);
   const ok = git.available || git.source === "filesystem";
 
@@ -213,11 +218,11 @@ export function runChangedCommand(workspaceRoot: string, options: { authoredOnly
         commit: git.commit,
         view: options.authoredOnly ? "authored" : "all",
         changedFiles: viewChanged.total.count,
-        humanFiles: humanChanges.total,
+        humanFiles: viewHumanChanges.total,
         generatedFiles: viewDerivedChanges.total,
-        stagedFiles: git.staged.count,
-        unstagedFiles: git.unstaged.count,
-        untrackedFiles: git.untracked.count,
+        stagedFiles: viewStaged.total.count,
+        unstagedFiles: viewUnstaged.total.count,
+        untrackedFiles: viewUntracked.total.count,
         primaryTypes: viewChanged.primaryTypes,
         changeTypes: summarizeChangeTypes(viewChanged),
       },
@@ -228,11 +233,11 @@ export function runChangedCommand(workspaceRoot: string, options: { authoredOnly
         branch: git.branch,
         commit: git.commit,
         changed: viewChanged,
-        staged: git.changeSummary.staged,
-        unstaged: git.changeSummary.unstaged,
-        untracked: git.changeSummary.untracked,
+        staged: viewStaged,
+        unstaged: viewUnstaged,
+        untracked: viewUntracked,
       },
-      humanChanges,
+      humanChanges: viewHumanChanges,
       derivedChanges: viewDerivedChanges,
       reviewFocus,
       generatedExplanation,

package/src/forge/cli/output.ts

@@ -157,11 +157,11 @@ export function buildAddJson(result: ForgeAddResult): Record<string, unknown> {
   const integrationNextActions =
     result.exitCode === 0 && result.mode === "integration" && result.targetKind === "forge-integration"
       ? [
+          "forge generate",
           ...(result.recipePackages ?? []).map((pkg) => `forge deps inspect ${pkg} --json`),
           ...((result.requiredSecrets?.length ?? 0) > 0 || (result.optionalSecrets?.length ?? 0) > 0
             ? ["forge secrets check --json", "forge inspect secrets --json"]
             : []),
-          "forge generate",
           "forge check --json",
           "forge verify --smoke",
         ]

package/src/forge/compiler/integration/add.ts

@@ -344,6 +344,39 @@ function dependencyFromInstall(
   };
 }
 
+function fileHashOrNull(path: string): string | null {
+  if (!nodeFileSystem.exists(path)) {
+    return null;
+  }
+  return hashStable(nodeFileSystem.readText(path) ?? "");
+}
+
+function snapshotPackageManagerFiles(
+  workspaceRoot: string,
+  pm: PackageManagerAdapter,
+): Map<string, string | null> {
+  const paths = ["package.json", pm.lockfile];
+  return new Map(
+    paths.map((path) => [
+      path,
+      fileHashOrNull(join(workspaceRoot, path)),
+    ]),
+  );
+}
+
+function changedPackageManagerFiles(
+  workspaceRoot: string,
+  before: Map<string, string | null>,
+): string[] {
+  const changed: string[] = [];
+  for (const [path, previousHash] of before) {
+    if (fileHashOrNull(join(workspaceRoot, path)) !== previousHash) {
+      changed.push(path);
+    }
+  }
+  return changed.sort();
+}
+
 async function analyzeRecipePackages(
   recipe: NonNullable<ReturnType<typeof resolveRecipe>>,
   ctx: ReturnType<typeof discover>,
@@ -635,6 +668,7 @@ export async function forgeAdd(
   const snapshot = snapshotVersionControlled(options.workspaceRoot);
 
   try {
+    const packageManagerBefore = snapshotPackageManagerFiles(options.workspaceRoot, pm);
     for (const pkg of recipe.packages) {
       await pm.add(pkg.packageName, {
         cwd: options.workspaceRoot,
@@ -735,7 +769,10 @@ export async function forgeAdd(
       alias: normalized,
       mode: "integration",
       ...recipeResultMetadata(recipe),
-      changed: emitResult.changed,
+      changed: [
+        ...changedPackageManagerFiles(options.workspaceRoot, packageManagerBefore),
+        ...emitResult.changed,
+      ],
       unchanged: emitResult.unchanged,
       warnings: warningsCombined,
       errors: [],

package/src/forge/compiler/integration/plan.ts

@@ -20,7 +20,6 @@ import { PACKAGE_ANALYZER_VERSION } from "../package-graph/constants.ts";
 import { RECIPE_SCHEMA_VERSION } from "../recipes/definitions.ts";
 import { hashStable } from "../primitives/hash.ts";
 import { stableSortEmitFiles, stableSortStrings } from "../primitives/index.ts";
-import { detectOrphanedGeneratedFiles } from "../orchestrator/orphans.ts";
 import type { DiscoverContext } from "../orchestrator/types.ts";
 import {
   createRenderContext,
@@ -254,17 +253,9 @@ export function buildIntegrationEmitPlan(input: IntegrationPlanInput): EmitPlan
   const lockEntry = buildLockEntry(recipe, classified, generatedFiles);
   const lock = mergeLockPackages(input.existingLock, lockEntry, ctx);
 
-  const sortedFiles = stableSortEmitFiles(files);
-  const plannedPathSet = new Set(sortedFiles.map((file) => file.path));
-  const orphanedFiles = detectOrphanedGeneratedFiles(
-    ctx.workspaceRoot,
-    ctx.generatedDir,
-    plannedPathSet,
-  );
-
   return {
-    files: sortedFiles,
-    orphanedFiles,
+    files: stableSortEmitFiles(files),
+    orphanedFiles: [],
     lock,
   };
 }

package/src/forge/compiler/orchestrator/fast-check.ts

@@ -8,6 +8,7 @@ import type { GenerateResult } from "../types/cli.ts";
 import type { Diagnostic } from "../types/diagnostic.ts";
 import { discover } from "./discover.ts";
 import { loadManifest } from "./manifest.ts";
+import { ORCHESTRATOR_MANIFEST_VERSION } from "./types.ts";
 
 export type FastGenerateCheckResult =
   | {
@@ -55,6 +56,9 @@ export function runFastGenerateCheck(workspaceRootInput: string): FastGenerateCh
   const manifest = loadManifest(cacheDir);
   const trackedFiles = Object.keys(manifest.fileHashes).sort();
 
+  if (manifest.schemaVersion !== ORCHESTRATOR_MANIFEST_VERSION) {
+    return { kind: "miss", reason: "manifest schema version changed" };
+  }
   if (!manifest.inputFingerprint || trackedFiles.length === 0) {
     return { kind: "miss", reason: "manifest missing input fingerprint or file hashes" };
   }

package/src/forge/compiler/orchestrator/manifest.ts

@@ -83,7 +83,7 @@ export function updateManifestAfterWrite(
 ): OrchestratorManifest {
   return {
     ...manifest,
-    fileHashes: { ...manifest.fileHashes, ...fileHashes },
+    fileHashes,
     priorAppGraph,
     inputFingerprint,
     ...(sourceFileIndex !== undefined ? { sourceFileIndex } : {}),

package/src/forge/compiler/orchestrator/plan.ts

@@ -94,6 +94,8 @@ import { detectCapabilities } from "../classifier/capabilities.ts";
 import { detectSecrets } from "../classifier/secrets.ts";
 import { resolveByPackageName } from "../recipes/registry.ts";
 import { RECIPE_SCHEMA_VERSION } from "../recipes/definitions.ts";
+import type { IntegrationRecipe } from "../types/integration.ts";
+import type { RuntimeContext } from "../types/runtime.ts";
 import {
   FORGE_LOCK_SCHEMA_VERSION,
   GENERATED_DIR,
@@ -104,6 +106,14 @@ import { hashStable } from "../primitives/hash.ts";
 import { stableSortEmitFiles } from "../primitives/sort.ts";
 import { detectOrphanedGeneratedFiles } from "./orphans.ts";
 import type { DiscoverContext } from "./types.ts";
+import {
+  createRenderContext,
+  parseAdapterContext,
+  renderAdapterModule,
+  renderIntegrationDoc,
+  renderIntegrationModule,
+  renderTestkitModule,
+} from "../integration/render.ts";
 import {
   serializeAppGraphJson,
   serializeDataGraphJson,
@@ -233,6 +243,156 @@ function makeEmitFile(path: string, content: string): EmitFile {
   };
 }
 
+function primaryPackageName(recipe: IntegrationRecipe): string {
+  return recipe.packages[0]?.packageName ?? recipe.alias;
+}
+
+function packageNamesForRecipe(recipe: IntegrationRecipe): string[] {
+  return recipe.packages.map((pkg) => pkg.packageName);
+}
+
+function compatibleContextsForRecipe(pkg: ClassifiedPackage): RuntimeContext[] {
+  const recipe = pkg.recipe ?? resolveByPackageName(pkg.api.name);
+  if (!recipe) {
+    return [...pkg.classification.compatible];
+  }
+
+  const contexts = new Set<RuntimeContext>(recipe.contexts.allowed);
+  for (const recipePackage of recipe.packages) {
+    for (const ctx of recipePackage.contexts?.allowed ?? []) {
+      contexts.add(ctx);
+    }
+  }
+  for (const ctx of pkg.classification.compatible) {
+    contexts.add(ctx);
+  }
+  return [...contexts];
+}
+
+function shouldEmitAdapter(
+  adapterFilename: string,
+  compatible: RuntimeContext[],
+): boolean {
+  const context = parseAdapterContext(adapterFilename);
+  return context === null || compatible.includes(context);
+}
+
+function buildRecipeGeneratedFiles(pkg: ClassifiedPackage): string[] {
+  const recipe = pkg.recipe ?? resolveByPackageName(pkg.api.name);
+  if (!recipe) {
+    return [];
+  }
+
+  const compatible = compatibleContextsForRecipe(pkg);
+  const paths: string[] = [];
+
+  for (const adapter of recipe.adapters) {
+    if (shouldEmitAdapter(adapter, compatible)) {
+      paths.push(`${GENERATED_DIR}/packages/${adapter}`);
+    }
+  }
+  for (const integration of recipe.integrations ?? []) {
+    paths.push(`${GENERATED_DIR}/integrations/${integration}`);
+  }
+  for (const testkit of recipe.testkits) {
+    paths.push(`${GENERATED_DIR}/testkits/${testkit}`);
+  }
+  for (const doc of recipe.docs) {
+    paths.push(`${GENERATED_DIR}/docs/${doc}`);
+  }
+
+  paths.push(
+    `${GENERATED_DIR}/runtimeMatrix.ts`,
+    `${GENERATED_DIR}/runtimeMatrix.json`,
+    `${GENERATED_DIR}/importGuards.ts`,
+    `${GENERATED_DIR}/importGuards.json`,
+  );
+
+  return paths.sort();
+}
+
+function buildIntegrationArtifactFiles(pkg: ClassifiedPackage): EmitFile[] {
+  const recipe = pkg.recipe ?? resolveByPackageName(pkg.api.name);
+  if (!recipe) {
+    return [];
+  }
+
+  const compatible = compatibleContextsForRecipe(pkg);
+  const incompatible = [...pkg.classification.incompatible];
+  const secrets = detectSecrets(pkg.api, recipe);
+  const packageNames = packageNamesForRecipe(recipe);
+  const packageName = primaryPackageName(recipe);
+  const templateCtx = createRenderContext({
+    alias: recipe.alias,
+    recipe,
+    context: "server",
+    packageName,
+    packageNames,
+    secrets,
+    compatible,
+    incompatible,
+  });
+  const files: EmitFile[] = [];
+
+  for (const adapter of recipe.adapters) {
+    if (!shouldEmitAdapter(adapter, compatible)) {
+      continue;
+    }
+    const context = parseAdapterContext(adapter) ?? "server";
+    files.push(
+      makeEmitFile(
+        `${GENERATED_DIR}/packages/${adapter}`,
+        renderAdapterModule({
+          alias: recipe.alias,
+          recipe,
+          context,
+          packageName,
+          packageNames,
+          secrets,
+          compatible,
+          incompatible,
+        }),
+      ),
+    );
+  }
+
+  for (const integration of recipe.integrations ?? []) {
+    files.push(
+      makeEmitFile(
+        `${GENERATED_DIR}/integrations/${integration}`,
+        renderIntegrationModule(integration, templateCtx),
+      ),
+    );
+  }
+
+  for (const testkit of recipe.testkits) {
+    files.push(
+      makeEmitFile(
+        `${GENERATED_DIR}/testkits/${testkit}`,
+        renderTestkitModule(recipe.alias, packageName, templateCtx),
+      ),
+    );
+  }
+
+  for (const doc of recipe.docs) {
+    files.push(
+      makeEmitFile(
+        `${GENERATED_DIR}/docs/${doc}`,
+        renderIntegrationDoc({
+          alias: recipe.alias,
+          recipe,
+          packageNames,
+          secrets,
+          compatible,
+          incompatible,
+        }),
+      ),
+    );
+  }
+
+  return files;
+}
+
 function buildLockEntry(pkg: ClassifiedPackage): ForgeLockEntry {
   const recipe = pkg.recipe ?? resolveByPackageName(pkg.api.name);
   const secrets = detectSecrets(pkg.api, recipe ?? undefined);
@@ -250,7 +410,7 @@ function buildLockEntry(pkg: ClassifiedPackage): ForgeLockEntry {
       secrets,
     },
     secrets,
-    generatedFiles: [],
+    generatedFiles: buildRecipeGeneratedFiles(pkg),
     contentChecksum: pkg.api.contentChecksum,
   };
 }
@@ -412,6 +572,7 @@ export function plan(input: PlanInput): EmitPlan {
     apiSurface,
     sources: input.ctx.sources,
   });
+  const integrationArtifactFiles = input.classified.flatMap(buildIntegrationArtifactFiles);
   const supportArtifactsMs = performance.now() - checkpoint;
   checkpoint = performance.now();
 
@@ -517,6 +678,7 @@ export function plan(input: PlanInput): EmitPlan {
       `${GENERATED_DIR}/importGuards.json`,
       serializeImportGuardsJson(matrix, input.appGraph.moduleGraph),
     ),
+    ...integrationArtifactFiles,
     makeEmitFile(
       `${GENERATED_DIR}/dataGraph.ts`,
       serializeDataGraphTs(dataGraph),

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

@@ -3,7 +3,7 @@ import type { Dependency } from "../types/package-graph.ts";
 import type { PackageManager } from "../types/runtime.ts";
 import type { SourceFileIndex } from "./workspace-index.ts";
 
-export const ORCHESTRATOR_MANIFEST_VERSION = "1";
+export const ORCHESTRATOR_MANIFEST_VERSION = "2";
 
 export interface DiscoverContext {
   workspaceRoot: string;

package/src/forge/runtime/executor.ts

@@ -213,6 +213,23 @@ function capitalizeSegment(value: string): string {
 }
 
 async function applyMocks(workspaceRoot: string, lock: ForgeLock | null): Promise<void> {
+  if (lock) {
+    for (const pkg of lock.packages) {
+      for (const secret of pkg.secrets) {
+        if (!process.env[secret.envVar]) {
+          process.env[secret.envVar] = `sk_forge_mock_${secret.envVar.toLowerCase()}`;
+        }
+      }
+    }
+  }
+
+  const bunMock = (globalThis as typeof globalThis & {
+    Bun?: { mock?: { module?: (specifier: string, factory: () => unknown) => void } };
+  }).Bun?.mock;
+  if (typeof bunMock?.module !== "function") {
+    return;
+  }
+
   const mockMap = loadMockMap(workspaceRoot);
 
   for (const [packageName, relativePath] of Object.entries(mockMap).sort()) {
@@ -225,11 +242,7 @@ async function applyMocks(workspaceRoot: string, lock: ForgeLock | null): Promis
     const factoryName = `create${capitalizeSegment(packageName)}Mock`;
     const factory = mod[factoryName];
 
-    const bunMock = Bun as typeof Bun & {
-      mock: { module: (specifier: string, factory: () => unknown) => void };
-    };
-
-    bunMock.mock.module(packageName, () => {
+    bunMock.module(packageName, () => {
       if (typeof factory === "function") {
         const mockValue = (factory as () => unknown)();
         if (typeof mockValue === "function") {
@@ -243,16 +256,6 @@ async function applyMocks(workspaceRoot: string, lock: ForgeLock | null): Promis
       return mod;
     });
   }
-
-  if (lock) {
-    for (const pkg of lock.packages) {
-      for (const secret of pkg.secrets) {
-        if (!process.env[secret.envVar]) {
-          process.env[secret.envVar] = `sk_forge_mock_${secret.envVar.toLowerCase()}`;
-        }
-      }
-    }
-  }
 }
 
 let activeDbAdapter: DbAdapter | null = null;

package/src/forge/version.ts

@@ -1,3 +1,3 @@
-export const FORGEOS_VERSION = "0.1.0-alpha.26";
+export const FORGEOS_VERSION = "0.1.0-alpha.27";
 export const GENERATOR_VERSION = FORGEOS_VERSION;
 export const CLI_VERSION = FORGEOS_VERSION;

package/src/forge/workspace/change-summary.ts

@@ -183,6 +183,40 @@ export function categorizeFiles(
   };
 }
 
+export function filterCategorizedSummary(
+  summary: CategorizedFileSummary,
+  includeTypes: ChangeType[],
+  sampleSize = 8,
+): CategorizedFileSummary {
+  const include = new Set(includeTypes);
+  const byType = Object.fromEntries(
+    CHANGE_TYPES.map((type) => {
+      const current = summary.byType[type];
+      return [
+        type,
+        include.has(type) ? current : { count: 0, sample: [], hidden: 0 },
+      ];
+    }),
+  ) as Record<ChangeType, FileListSummary>;
+  const totalCount = includeTypes.reduce((count, type) => count + summary.byType[type].count, 0);
+  const totalSample = includeTypes
+    .flatMap((type) => summary.byType[type].sample)
+    .sort()
+    .slice(0, sampleSize);
+  const primaryTypes = CHANGE_TYPES
+    .filter((type) => byType[type].count > 0)
+    .sort((left, right) => byType[right].count - byType[left].count);
+  return {
+    total: {
+      count: totalCount,
+      sample: totalSample,
+      hidden: Math.max(0, totalCount - totalSample.length),
+    },
+    byType,
+    primaryTypes,
+  };
+}
+
 export function summarizeChangeTypes(summary: CategorizedFileSummary): string {
   return summary.primaryTypes
     .slice(0, 5)

package/adapters/java/target/maven-archiver/pom.properties

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

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

@@ -1,23 +0,0 @@
-dev/forgeos/adapter/TypedForgeHandler.class
-dev/forgeos/adapter/Forge.class
-dev/forgeos/adapter/Diagnostic.class
-dev/forgeos/adapter/ForgeHttpHandler.class
-dev/forgeos/adapter/Service.class
-dev/forgeos/adapter/Schemas.class
-dev/forgeos/adapter/ForgeCall.class
-dev/forgeos/adapter/Risk.class
-dev/forgeos/adapter/ForgeHandler.class
-dev/forgeos/adapter/Entry.class
-dev/forgeos/adapter/TransactionMode.class
-dev/forgeos/adapter/ResponseEnvelope.class
-dev/forgeos/adapter/RequestEnvelope.class
-dev/forgeos/adapter/ForgeRegistry$RegistryOption.class
-dev/forgeos/adapter/Auth.class
-dev/forgeos/adapter/Manifest.class
-dev/forgeos/adapter/ForgeContext.class
-dev/forgeos/adapter/ForgeRegistry$RegisteredEntry.class
-dev/forgeos/adapter/ForgeRegistry$EntryOption.class
-dev/forgeos/adapter/EntryKind.class
-dev/forgeos/adapter/ForgeRegistry.class
-dev/forgeos/adapter/ErrorInfo.class
-dev/forgeos/adapter/Json.class

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

@@ -1,20 +0,0 @@
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Auth.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Diagnostic.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Entry.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/EntryKind.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ErrorInfo.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Forge.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeCall.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeContext.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHandler.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHttpHandler.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ForgeRegistry.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Json.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Manifest.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/RequestEnvelope.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/ResponseEnvelope.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Risk.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Schemas.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/Service.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/TransactionMode.java
-/home/runner/work/forge/forge/adapters/java/src/main/java/dev/forgeos/adapter/TypedForgeHandler.java

package/adapters/java-spring-boot-starter/target/classes/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

@@ -1 +0,0 @@
-dev.forgeos.adapter.spring.ForgeSpringAutoConfiguration

package/adapters/java-spring-boot-starter/target/maven-archiver/pom.properties

@@ -1,3 +0,0 @@
-artifactId=forge-java-spring-boot-starter
-groupId=dev.forgeos
-version=0.1.0-alpha.11

package/adapters/java-spring-boot-starter/target/maven-status/maven-compiler-plugin/compile/default-compile/createdFiles.lst

@@ -1,6 +0,0 @@
-dev/forgeos/adapter/spring/ForgeServiceBeanCondition.class
-dev/forgeos/adapter/spring/ForgeSpringRuntime.class
-dev/forgeos/adapter/spring/ForgeExternalService.class
-dev/forgeos/adapter/spring/ForgeSpringAutoConfiguration.class
-dev/forgeos/adapter/spring/ForgeQuery.class
-dev/forgeos/adapter/spring/ForgeCommand.class

package/adapters/java-spring-boot-starter/target/maven-status/maven-compiler-plugin/compile/default-compile/inputFiles.lst

@@ -1,6 +0,0 @@
-/home/runner/work/forge/forge/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeCommand.java
-/home/runner/work/forge/forge/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeExternalService.java
-/home/runner/work/forge/forge/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeQuery.java
-/home/runner/work/forge/forge/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeServiceBeanCondition.java
-/home/runner/work/forge/forge/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringAutoConfiguration.java
-/home/runner/work/forge/forge/adapters/java-spring-boot-starter/src/main/java/dev/forgeos/adapter/spring/ForgeSpringRuntime.java

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

@@ -1,3 +0,0 @@
-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

@@ -1,5 +0,0 @@
-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

@@ -1,3 +0,0 @@
-/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