@auto-engineer/server-generator-nestjs 1.28.0 → 1.29.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # @auto-engineer/server-generator-nestjs
 
+## 1.29.0
+
+### Minor Changes
+
+- [`2ef9632`](https://github.com/BeOnAuto/auto-engineer/commit/2ef9632a2db081f201981422f2ba26b026fa7277) Thanks [@SamHatoum](https://github.com/SamHatoum)! - ### react-component-implementer
+  - Add staging workflow with `writeStagedStory`, `checkStagedTypes`, and `promoteFromStaging`
+  - Add MCP connection pool and browser pool for resource reuse
+  - Add context filtering and system prompt caching to reduce tokens
+  - Add ts-service for type-aware error feedback with property suggestions
+  - Parallelize type checking and browser validation
+  - Replace score-based visual evaluation with binary ACK/NACK criteria
+  - Enable incremental TypeScript checking in staging
+
+  ### pipeline
+  - Add `.declare().accepts()` builder for AcceptsDescriptor type
+  - Show source commands in pipeline graph
+
+  ### job-graph-processor
+  - Add `hasFailedJobs` utility and discriminate GraphProcessed vs GraphProcessingFailed
+  - Bridge context.emit in command handler for downstream event routing
+
+  ### server-generator-apollo-emmett
+  - Add cleanServerDir to preserve node_modules during regeneration
+  - Accept Model directly instead of modelPath
+
+  ### server-generator-nestjs
+  - Accept Model directly instead of modelPath
+
+  ### generate-react-client
+  - Lock in overwrite behavior for copyStarter
+
+  ### narrative
+  - Remove export-schema command
+
+  ### global
+  - Remove references to information-architect and model-diff packages
+  - Fix biome lint errors for CI compliance
+  - Update examples and configuration files
+
+### Patch Changes
+
+- Updated dependencies [[`2ef9632`](https://github.com/BeOnAuto/auto-engineer/commit/2ef9632a2db081f201981422f2ba26b026fa7277)]:
+  - @auto-engineer/narrative@1.29.0
+
 ## 1.28.0
 
 ### Minor Changes

package/package.json

@@ -40,7 +40,7 @@
     "ts-node": "^10.9.2",
     "type-fest": "^4.41.0",
     "uuid": "^11.0.0",
-    "@auto-engineer/narrative": "1.28.0"
+    "@auto-engineer/narrative": "1.29.0"
   },
   "publishConfig": {
     "access": "public"
@@ -52,9 +52,9 @@
     "tsx": "^4.19.2",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@auto-engineer/cli": "1.28.0"
+    "@auto-engineer/cli": "1.29.0"
   },
-  "version": "1.28.0",
+  "version": "1.29.0",
   "scripts": {
     "generate:server": "tsx src/cli/index.ts",
     "-DISABLE-build": "tsc && tsx ../../scripts/fix-esm-imports.ts && rm -rf dist/src/codegen/templates && mkdir -p dist/src/codegen && cp -r src/codegen/templates dist/src/codegen/templates && cp -r src/shared dist/src",

package/src/codegen/entity-consolidation.ts

@@ -198,8 +198,8 @@ export function consolidateEntityFields(
   const fields = Array.from(fieldMap.values());
   markPrimaryKeyAndIndexes(fields, fieldMap, flow.name);
 
-  const entityName = pascalCase(flow.name) + 'Entity';
-  const tableName = camelCase(flow.name) + 's';
+  const entityName = `${pascalCase(flow.name)}Entity`;
+  const tableName = `${camelCase(flow.name)}s`;
 
   debug('Consolidated entity: %s with %d fields', entityName, fields.length);
   debug('  Enum imports: %o', Array.from(enumsUsed));

package/src/codegen/extract/graphql.ts

@@ -88,7 +88,7 @@ export function parseGraphQlRequest(request: string): ParsedGraphQlQuery {
   }
 
   const baseName = field.name.value;
-  const returnType = pascalCase(baseName) + 'View';
+  const returnType = `${pascalCase(baseName)}View`;
 
   return {
     queryName: baseName,

package/src/codegen/scaffoldFromSchema.ts

@@ -1,11 +1,11 @@
+import fs from 'node:fs/promises';
+import path, { dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import type { Model, Narrative, Slice } from '@auto-engineer/narrative';
 import { camelCase, pascalCase } from 'change-case';
 import createDebug from 'debug';
 import ejs from 'ejs';
-import fs from 'fs/promises';
-import path, { dirname } from 'path';
 import prettier from 'prettier';
-import { fileURLToPath } from 'url';
 import { ensureDirExists, ensureDirPath, toKebabCase } from './utils/path.js';
 
 const debug = createDebug('auto:server-generator-nestjs:scaffold');
@@ -372,7 +372,6 @@ async function generateFilesForSlice(
   flow: Narrative,
   sliceDir: string,
   messages: MessageDefinition[],
-  flows: Narrative[],
   unionToEnumName: Map<string, string>,
   integrations?: Model['integrations'],
 ): Promise<FilePlan[]> {
@@ -519,15 +518,7 @@ export async function generateScaffoldFilePlans(
 
     for (const slice of flow.slices) {
       const sliceDir = ensureDirPath(flowDir, toKebabCase(slice.name));
-      const plans = await generateFilesForSlice(
-        slice,
-        flow,
-        sliceDir,
-        messages ?? [],
-        flows,
-        unionToEnumName,
-        integrations,
-      );
+      const plans = await generateFilesForSlice(slice, flow, sliceDir, messages ?? [], unionToEnumName, integrations);
       allPlans.push(...plans);
     }
 

package/src/codegen/utils/path.ts

@@ -1,6 +1,6 @@
-import { existsSync } from 'fs';
-import { mkdir } from 'fs/promises';
-import path from 'path';
+import { existsSync } from 'node:fs';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
 
 export function toKebabCase(str: string): string {
   return str

package/src/commands/generate-server.ts

@@ -1,18 +1,16 @@
+import { writeFile } from 'node:fs/promises';
+import * as path from 'node:path';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { type Command, defineCommandHandler, type Event } from '@auto-engineer/message-bus';
 import type { Model } from '@auto-engineer/narrative';
 import createDebug from 'debug';
 import { execa } from 'execa';
-import { existsSync } from 'fs';
-import { readFile, writeFile } from 'fs/promises';
 import fs from 'fs-extra';
-import * as path from 'path';
-import { dirname, join, resolve } from 'path';
-import { fileURLToPath } from 'url';
 import { generateScaffoldFilePlans, writeScaffoldFilePlans } from '../codegen/scaffoldFromSchema.js';
 import { ensureDirExists, ensureDirPath, toKebabCase } from '../codegen/utils/path.js';
 
 const debug = createDebug('auto:server-generator-nestjs');
-const debugModel = createDebug('auto:server-generator-nestjs:schema');
 const debugFiles = createDebug('auto:server-generator-nestjs:files');
 const debugDeps = createDebug('auto:server-generator-nestjs:deps');
 const debugScaffold = createDebug('auto:server-generator-nestjs:scaffold');
@@ -23,11 +21,21 @@ const __dirname = dirname(__filename);
 export type GenerateServerCommand = Command<
   'GenerateServer',
   {
-    modelPath: string;
+    model: Model;
     destination: string;
   }
 >;
 
+function deriveModelPath(destination: string): string {
+  return join(resolve(destination), '.context', 'schema.json');
+}
+
+async function writeModelToDisk(model: Model, destination: string): Promise<void> {
+  const modelPath = deriveModelPath(destination);
+  await fs.ensureDir(dirname(modelPath));
+  await writeFile(modelPath, JSON.stringify(model, null, 2), 'utf8');
+}
+
 export type ServerGeneratedEvent = Event<
   'ServerGenerated',
   {
@@ -68,8 +76,8 @@ export const commandHandler = defineCommandHandler({
   icon: 'server',
   events: ['ServerGenerated', 'ServerGenerationFailed', 'SliceGenerated'],
   fields: {
-    modelPath: {
-      description: 'Path to the json model file',
+    model: {
+      description: 'The model object',
       required: true,
     },
     destination: {
@@ -77,7 +85,7 @@ export const commandHandler = defineCommandHandler({
       required: true,
     },
   },
-  examples: ['$ auto generate:server --model-path=.context/model.json --destination=.'],
+  examples: ['$ auto generate:server --destination=.'],
   handle: async (command: Command): Promise<GenerateServerEvents | GenerateServerEvents[]> => {
     const typedCommand = command as GenerateServerCommand;
     const result = await handleGenerateServerCommandInternal(typedCommand);
@@ -93,58 +101,6 @@ export const commandHandler = defineCommandHandler({
   },
 });
 
-async function validateModelFile(
-  absModel: string,
-  command: GenerateServerCommand,
-): Promise<ServerGenerationFailedEvent | null> {
-  if (!existsSync(absModel)) {
-    debug('Model file not found at %s', absModel);
-    return {
-      type: 'ServerGenerationFailed',
-      data: {
-        modelPath: command.data.modelPath,
-        destination: command.data.destination,
-        error: `Model file not found at ${absModel}`,
-      },
-      timestamp: new Date(),
-      requestId: command.requestId,
-      correlationId: command.correlationId,
-    };
-  }
-  return null;
-}
-
-async function readAndParseModel(absModel: string): Promise<Model> {
-  debugModel('Reading model file from %s', absModel);
-  const content = await readFile(absModel, 'utf8');
-
-  debugModel('Model content length: %d bytes', content.length);
-  const spec = JSON.parse(content) as Model;
-
-  debugModel('Parsed model:');
-  debugModel('  Flows: %d', spec.narratives?.length || 0);
-  debugModel('  Messages: %d', spec.messages?.length || 0);
-  debugModel('  Integrations: %d', spec.integrations?.length ?? 0);
-
-  logFlowDetails(spec);
-  return spec;
-}
-
-function logFlowDetails(spec: Model): void {
-  if (spec.narratives !== undefined && spec.narratives.length > 0) {
-    debugModel(
-      'Flow names: %o',
-      spec.narratives.map((f) => f.name),
-    );
-    spec.narratives.forEach((flow) => {
-      debugModel('  Flow "%s" has %d slices', flow.name, flow.slices?.length || 0);
-      flow.slices?.forEach((slice) => {
-        debugModel('    Slice: %s (type: %s)', slice.name, slice.type);
-      });
-    });
-  }
-}
-
 async function cleanStaleCompiledFiles(serverDir: string): Promise<void> {
   const sharedTypesDir = join(serverDir, 'src', 'domain', 'shared');
   debugScaffold('Cleaning stale compiled files from %s', sharedTypesDir);
@@ -233,7 +189,7 @@ function createServerSuccessEvent(
   return {
     type: 'ServerGenerated',
     data: {
-      modelPath: command.data.modelPath,
+      modelPath: deriveModelPath(command.data.destination),
       destination: command.data.destination,
       serverDir,
       contextSchemaGraphQL: join(absDest, '.context', 'schema.graphql'),
@@ -249,7 +205,7 @@ function createServerFailureEvent(command: GenerateServerCommand, error: unknown
   return {
     type: 'ServerGenerationFailed',
     data: {
-      modelPath: command.data.modelPath,
+      modelPath: deriveModelPath(command.data.destination),
       destination: command.data.destination,
       error: error instanceof Error ? error.message : 'Unknown error occurred',
     },
@@ -262,29 +218,24 @@ function createServerFailureEvent(command: GenerateServerCommand, error: unknown
 export async function handleGenerateServerCommandInternal(
   command: GenerateServerCommand,
 ): Promise<GenerateServerEvents[]> {
-  const { modelPath, destination } = command.data;
+  const { model, destination } = command.data;
   const events: GenerateServerEvents[] = [];
 
   debug('Starting server generation');
-  debug('Model path: %s', modelPath);
   debug('Destination: %s', destination);
 
   try {
     const absDest = resolve(destination);
-    const absModel = resolve(modelPath);
 
     debug('Resolved paths:');
     debug('  Absolute destination: %s', absDest);
-    debug('  Absolute model: %s', absModel);
 
-    const validationError = await validateModelFile(absModel, command);
-    if (validationError) return [validationError];
+    const spec = model;
 
-    const spec = await readAndParseModel(absModel);
+    await writeModelToDisk(spec, destination);
 
     const serverDir = join(absDest, 'server');
     debug('Server directory: %s', serverDir);
-    debug('🔄 Generating server... %s', serverDir);
 
     debug('Clearing existing server directory if it exists');
     await fs.remove(serverDir);
@@ -308,7 +259,7 @@ export async function handleGenerateServerCommandInternal(
                 flowName: flow.name,
                 sliceName: slice.name,
                 sliceType: slice.type,
-                schemaPath: command.data.modelPath,
+                schemaPath: deriveModelPath(command.data.destination),
                 slicePath: ensureDirPath('./server/src/domain', toKebabCase(flow.name), toKebabCase(slice.name)),
               },
               timestamp: new Date(),
@@ -342,7 +293,7 @@ async function copyRootFilesFromSrc(from: string, to: string): Promise<void> {
   debugFiles('copyRootFilesFromSrc: from=%s, to=%s', from, to);
 
   const fromStat = await fs.stat(from).catch(() => undefined);
-  if (fromStat !== undefined && fromStat.isFile()) {
+  if (fromStat?.isFile()) {
     debugFiles('  Source is a file, copying directly');
     await fs.ensureDir(to);
     const destFile = path.join(to, path.basename(from));

package/src/shared/mikro-orm.config.ts

@@ -1,6 +1,6 @@
+import { join } from 'node:path';
 import { Migrator } from '@mikro-orm/migrations';
 import { defineConfig } from '@mikro-orm/sqlite';
-import { join } from 'path';
 
 export default defineConfig({
   entities: [],