@hstm-labs/forge-services-generator 0.1.11

package/README.md

@@ -0,0 +1,38 @@
+# @hstm-labs/forge-services-generator
+
+Services layer generation stage for Forge — produces API (delivery), Application (use cases, DTOs), Domain (entities, value objects), and Infrastructure artifacts from architecture output. Emits artifacts under the four-layer pattern: Api/, Application/, Domain/, Infrastructure/.
+
+## Installation
+
+```bash
+npm install @hstm-labs/forge-services-generator
+```
+
+## Public API
+
+### Types
+
+- `ApiArtifact` — complete API layer output
+- `ApiEndpoint` — route definition with method, path, parameters
+- `ApiHandler` — request handler implementation
+- `ApiTypeDefinition` — shared type/interface definitions
+- `ApiContract` — API contract (OpenAPI-style) metadata
+
+### Classes
+
+- `ServicesGenerateStage` — pipeline stage implementing `PipelineStage` interface
+- `ApiOutputValidator` — validates LLM-produced API output
+
+## Usage
+
+```typescript
+import { ServicesGenerateStage } from '@hstm-labs/forge-services-generator';
+
+const stage = new ServicesGenerateStage();
+const result = await stage.execute(input);
+// result.data contains ApiArtifact
+```
+
+## License
+
+[MIT](../../LICENSE)

package/dist/api-generate-stage.d.ts

@@ -0,0 +1,56 @@
+/**
+ * API generation pipeline stage.
+ *
+ * Produces routes/resolvers, handlers, type definitions, and a contract
+ * artifact (OpenAPI/GraphQL schema) from specification, architecture, and
+ * profile. Follows the same stage implementation pattern established by
+ * {@link ArchitectStage} in Task 5.1.
+ *
+ * In API mode, renders prompt templates, calls the LLM via
+ * {@link ApiStageExecutor}, validates the output, unpacks individual
+ * files, and returns the parsed {@link ApiArtifact} in the stage output data.
+ *
+ * In agent mode, the pipeline runner intercepts before calling
+ * `execute()` and exports a prompt via {@link AgentStageExecutor}.
+ */
+import type { StageName } from '@hstm-labs/forge-common';
+import type { PipelineStage, PipelineStageInput, PipelineStageOutput, PipelineContext, AgentPromptContext } from '@hstm-labs/forge-core';
+/**
+ * Pipeline stage that generates the API layer.
+ *
+ * Produces an {@link ApiArtifact} containing endpoint definitions, handler
+ * source files, type definitions, and a contract artifact. Each handler
+ * and type definition is written as a separate file artifact.
+ *
+ * @example
+ * ```ts
+ * const stage = new ApiGenerateStage();
+ * const output = await stage.execute(input, context);
+ * const api = output.data?.api as ApiArtifact;
+ * ```
+ */
+export declare class ApiGenerateStage implements PipelineStage {
+    readonly name: StageName;
+    readonly dependsOn: StageName[];
+    readonly requiresLLM = true;
+    /**
+     * Return rendered agent-mode prompt context using `api-generate-agent.hbs`.
+     *
+     * @param input - Input from prior stages
+     * @param context - Pipeline context with config, workspace, and runId
+     * @returns Agent prompt context with rendered template and output schema
+     */
+    getAgentContext(input: PipelineStageInput, context: PipelineContext): AgentPromptContext;
+    /**
+     * Execute the API generation stage.
+     *
+     * @param input - Input from prior stages (expects validate + architect output)
+     * @param context - Pipeline context with config, workspace, and adapter
+     * @returns Stage output with API artifacts and parsed ApiArtifact in data
+     * @throws {ForgeError} FORGE-PIPE-003 if dependency stage output is missing
+     * @throws {ForgeError} FORGE-PIPE-001 if adapter is missing
+     * @throws {ForgeError} FORGE-GEN-003 if max retries exhausted
+     */
+    execute(input: PipelineStageInput, context: PipelineContext): Promise<PipelineStageOutput>;
+}
+//# sourceMappingURL=api-generate-stage.d.ts.map

package/dist/api-generate-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-generate-stage.d.ts","sourceRoot":"","sources":["../src/api-generate-stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EAEf,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAW/B;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,YAAW,aAAa;IACpD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAkB;IAC1C,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,CAAiB;IAChD,QAAQ,CAAC,WAAW,QAAQ;IAE5B;;;;;;OAMG;IACH,eAAe,CACb,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,eAAe,GACvB,kBAAkB;IA2CrB;;;;;;;;;OASG;IACG,OAAO,CACX,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,mBAAmB,CAAC;CAmKhC"}

package/dist/api-generate-stage.js

@@ -0,0 +1,191 @@
+/**
+ * API generation pipeline stage.
+ *
+ * Produces routes/resolvers, handlers, type definitions, and a contract
+ * artifact (OpenAPI/GraphQL schema) from specification, architecture, and
+ * profile. Follows the same stage implementation pattern established by
+ * {@link ArchitectStage} in Task 5.1.
+ *
+ * In API mode, renders prompt templates, calls the LLM via
+ * {@link ApiStageExecutor}, validates the output, unpacks individual
+ * files, and returns the parsed {@link ApiArtifact} in the stage output data.
+ *
+ * In agent mode, the pipeline runner intercepts before calling
+ * `execute()` and exports a prompt via {@link AgentStageExecutor}.
+ */
+import { join } from 'node:path';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { ForgeError, ErrorCodes, hashContent } from '@hstm-labs/forge-common';
+import { ApiStageExecutor } from '@hstm-labs/forge-core';
+import { resolveApiStyle } from '@hstm-labs/forge-architect';
+import { loadProfile } from '@hstm-labs/forge-profiles';
+import { loadTemplate, renderTemplate } from '@hstm-labs/forge-templates';
+import { ApiOutputValidator } from './validator.js';
+/**
+ * Pipeline stage that generates the API layer.
+ *
+ * Produces an {@link ApiArtifact} containing endpoint definitions, handler
+ * source files, type definitions, and a contract artifact. Each handler
+ * and type definition is written as a separate file artifact.
+ *
+ * @example
+ * ```ts
+ * const stage = new ApiGenerateStage();
+ * const output = await stage.execute(input, context);
+ * const api = output.data?.api as ApiArtifact;
+ * ```
+ */
+export class ApiGenerateStage {
+    name = 'api-generate';
+    dependsOn = ['architect'];
+    requiresLLM = true;
+    /**
+     * Return rendered agent-mode prompt context using `api-generate-agent.hbs`.
+     *
+     * @param input - Input from prior stages
+     * @param context - Pipeline context with config, workspace, and runId
+     * @returns Agent prompt context with rendered template and output schema
+     */
+    getAgentContext(input, context) {
+        const parsedSpec = input['validate']?.data?.['parsedSpec'];
+        const architecture = input['architect']?.data?.['architecture'];
+        const profile = loadProfile(context.config.profileName, context.workspace.rootDir);
+        const resolvedApiStyle = parsedSpec
+            ? resolveApiStyle(parsedSpec, profile)
+            : 'graphql';
+        const outputDir = join(context.workspace.forgeDir, 'runs', context.runId, 'stages', 'api-generate', 'artifacts');
+        const agentTemplate = loadTemplate('api-generate-agent', context.workspace.rootDir);
+        const rendered = renderTemplate(agentTemplate, {
+            spec: (parsedSpec ?? {}),
+            profile: profile,
+            architecture: (architecture ?? {}),
+            stage: { resolvedApiStyle, outputDir },
+        });
+        return {
+            prompt: rendered.content,
+            outputSchema: { format: 'json' },
+        };
+    }
+    /**
+     * Execute the API generation stage.
+     *
+     * @param input - Input from prior stages (expects validate + architect output)
+     * @param context - Pipeline context with config, workspace, and adapter
+     * @returns Stage output with API artifacts and parsed ApiArtifact in data
+     * @throws {ForgeError} FORGE-PIPE-003 if dependency stage output is missing
+     * @throws {ForgeError} FORGE-PIPE-001 if adapter is missing
+     * @throws {ForgeError} FORGE-GEN-003 if max retries exhausted
+     */
+    async execute(input, context) {
+        // 1. Get parsed spec from validate stage output
+        const validateOutput = input['validate'];
+        if (validateOutput === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.DEPENDENCY_UNMET, "API generate stage requires 'validate' stage output, but it was not found. " +
+                'Ensure the validate stage runs before the api-generate stage.');
+        }
+        const parsedSpec = validateOutput.data?.['parsedSpec'];
+        if (parsedSpec === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.STAGE_FAILURE, 'Validate stage did not produce a parsed specification in its output data. ' +
+                'Ensure the validate stage includes parsedSpec in its data output.');
+        }
+        // 2. Get architecture from architect stage output
+        const architectOutput = input['architect'];
+        if (architectOutput === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.DEPENDENCY_UNMET, "API generate stage requires 'architect' stage output, but it was not found. " +
+                'Ensure the architect stage runs before the api-generate stage.');
+        }
+        const architecture = architectOutput.data?.['architecture'];
+        if (architecture === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.STAGE_FAILURE, 'Architect stage did not produce an architecture in its output data. ' +
+                'Ensure the architect stage includes architecture in its data output.');
+        }
+        // 3. Load profile, resolve API style
+        const profile = loadProfile(context.config.profileName, context.workspace.rootDir);
+        const resolvedApiStyle = resolveApiStyle(parsedSpec, profile);
+        // 4. Compute output directory
+        const outputDir = join(context.workspace.forgeDir, 'runs', context.runId, 'stages', 'api-generate', 'artifacts');
+        // 5. Load and render templates
+        const systemTemplate = loadTemplate('api-generate-system', context.workspace.rootDir);
+        const userTemplate = loadTemplate('api-generate-user', context.workspace.rootDir);
+        const templateContext = {
+            spec: parsedSpec,
+            profile: profile,
+            architecture: architecture,
+            stage: {
+                resolvedApiStyle,
+                outputDir,
+            },
+        };
+        const systemPrompt = renderTemplate(systemTemplate, templateContext);
+        const userPrompt = renderTemplate(userTemplate, templateContext);
+        // 6. Execute via API mode StageExecutor
+        if (context.adapter === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.STAGE_FAILURE, 'API generate stage requires an LLM adapter in API mode, but none was provided. ' +
+                'Configure an LLM provider in forge.config.json or use agent mode.');
+        }
+        const validator = new ApiOutputValidator(architecture.dataModel);
+        const executor = new ApiStageExecutor({
+            adapter: context.adapter,
+            validator,
+            retryPolicy: {
+                maxRetries: 3,
+                backoffMs: 1000,
+                includeErrorInRetry: true,
+            },
+        });
+        const result = await executor.execute({
+            prompt: userPrompt.content,
+            systemPrompt: systemPrompt.content,
+            stageName: 'api-generate',
+            outputDir,
+            runId: context.runId,
+            mode: 'api',
+            outputSchema: { format: 'json' },
+        });
+        // 7. Parse ApiArtifact from LLM output
+        const rawContent = result.artifacts[0]?.content ?? '';
+        const apiArtifact = JSON.parse(rawContent);
+        // 8. Write individual files to artifacts directory
+        mkdirSync(outputDir, { recursive: true });
+        const artifacts = [];
+        // Write handler files
+        for (const handler of apiArtifact.handlers) {
+            const filePath = handler.fileName;
+            writeFileSync(join(outputDir, filePath), handler.content, 'utf-8');
+            artifacts.push({
+                filePath,
+                content: handler.content,
+                contentHash: hashContent(handler.content),
+                sizeBytes: Buffer.byteLength(handler.content, 'utf-8'),
+            });
+        }
+        // Write type definition files
+        for (const typeDef of apiArtifact.types) {
+            const filePath = typeDef.fileName;
+            writeFileSync(join(outputDir, filePath), typeDef.content, 'utf-8');
+            artifacts.push({
+                filePath,
+                content: typeDef.content,
+                contentHash: hashContent(typeDef.content),
+                sizeBytes: Buffer.byteLength(typeDef.content, 'utf-8'),
+            });
+        }
+        // Write contract artifact
+        const contractPath = apiArtifact.contract.fileName;
+        writeFileSync(join(outputDir, contractPath), apiArtifact.contract.content, 'utf-8');
+        artifacts.push({
+            filePath: contractPath,
+            content: apiArtifact.contract.content,
+            contentHash: hashContent(apiArtifact.contract.content),
+            sizeBytes: Buffer.byteLength(apiArtifact.contract.content, 'utf-8'),
+        });
+        // 9. Return PipelineStageOutput with all artifacts and data
+        return {
+            artifacts,
+            data: {
+                api: apiArtifact,
+            },
+        };
+    }
+}
+//# sourceMappingURL=api-generate-stage.js.map

package/dist/api-generate-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-generate-stage.js","sourceRoot":"","sources":["../src/api-generate-stage.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export type { ApiArtifact, ApiEndpoint, ApiHandler, ApiTypeDefinition, ApiContract, } from './types.js';
+export { ServicesGenerateStage } from './services-generate-stage.js';
+export { ApiOutputValidator } from './validator.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,iBAAiB,EACjB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// @hstm-labs/forge-services-generator public API
+export { ServicesGenerateStage } from './services-generate-stage.js';
+export { ApiOutputValidator } from './validator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAUjD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/services-generate-stage.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Services generation pipeline stage.
+ *
+ * Produces routes/resolvers, handlers, type definitions, and a contract
+ * artifact (OpenAPI/GraphQL schema) from specification, architecture, and
+ * profile. Emits artifacts under Api/, Application/, Domain/, Infrastructure/
+ * (four-layer pattern). Follows the same stage implementation pattern as
+ * {@link ArchitectStage}.
+ *
+ * In API mode, renders prompt templates, calls the LLM via
+ * {@link ApiStageExecutor}, validates the output, unpacks individual
+ * files, and returns the parsed {@link ApiArtifact} in the stage output data.
+ *
+ * In agent mode, the pipeline runner intercepts before calling
+ * `execute()` and exports a prompt via {@link AgentStageExecutor}.
+ */
+import type { StageName } from '@hstm-labs/forge-common';
+import type { PipelineStage, PipelineStageInput, PipelineStageOutput, PipelineContext, AgentPromptContext } from '@hstm-labs/forge-core';
+/**
+ * Pipeline stage that generates the API layer.
+ *
+ * Produces an {@link ApiArtifact} containing endpoint definitions, handler
+ * source files, type definitions, and a contract artifact. Each handler
+ * and type definition is written as a separate file artifact.
+ *
+ * @example
+ * ```ts
+ * const stage = new ServicesGenerateStage();
+ * const output = await stage.execute(input, context);
+ * const api = output.data?.api as ApiArtifact;
+ * ```
+ */
+export declare class ServicesGenerateStage implements PipelineStage {
+    readonly name: StageName;
+    readonly dependsOn: StageName[];
+    readonly requiresLLM = true;
+    /**
+     * Return rendered agent-mode prompt context using `services-generate-agent.hbs`.
+     *
+     * @param input - Input from prior stages
+     * @param context - Pipeline context with config, workspace, and runId
+     * @returns Agent prompt context with rendered template and output schema
+     */
+    getAgentContext(input: PipelineStageInput, context: PipelineContext): AgentPromptContext;
+    /**
+     * Execute the API generation stage.
+     *
+     * @param input - Input from prior stages (expects validate + architect output)
+     * @param context - Pipeline context with config, workspace, and adapter
+     * @returns Stage output with API artifacts and parsed ApiArtifact in data
+     * @throws {ForgeError} FORGE-PIPE-003 if dependency stage output is missing
+     * @throws {ForgeError} FORGE-PIPE-001 if adapter is missing
+     * @throws {ForgeError} FORGE-GEN-003 if max retries exhausted
+     */
+    execute(input: PipelineStageInput, context: PipelineContext): Promise<PipelineStageOutput>;
+}
+//# sourceMappingURL=services-generate-stage.d.ts.map

package/dist/services-generate-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services-generate-stage.d.ts","sourceRoot":"","sources":["../src/services-generate-stage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EAEf,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAW/B;;;;;;;;;;;;;GAaG;AACH,qBAAa,qBAAsB,YAAW,aAAa;IACzD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAuB;IAC/C,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,CAAiB;IAChD,QAAQ,CAAC,WAAW,QAAQ;IAE5B;;;;;;OAMG;IACH,eAAe,CACb,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,eAAe,GACvB,kBAAkB;IA2CrB;;;;;;;;;OASG;IACG,OAAO,CACX,KAAK,EAAE,kBAAkB,EACzB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,mBAAmB,CAAC;CAmKhC"}

package/dist/services-generate-stage.js

@@ -0,0 +1,192 @@
+/**
+ * Services generation pipeline stage.
+ *
+ * Produces routes/resolvers, handlers, type definitions, and a contract
+ * artifact (OpenAPI/GraphQL schema) from specification, architecture, and
+ * profile. Emits artifacts under Api/, Application/, Domain/, Infrastructure/
+ * (four-layer pattern). Follows the same stage implementation pattern as
+ * {@link ArchitectStage}.
+ *
+ * In API mode, renders prompt templates, calls the LLM via
+ * {@link ApiStageExecutor}, validates the output, unpacks individual
+ * files, and returns the parsed {@link ApiArtifact} in the stage output data.
+ *
+ * In agent mode, the pipeline runner intercepts before calling
+ * `execute()` and exports a prompt via {@link AgentStageExecutor}.
+ */
+import { join } from 'node:path';
+import { writeFileSync, mkdirSync } from 'node:fs';
+import { ForgeError, ErrorCodes, hashContent } from '@hstm-labs/forge-common';
+import { ApiStageExecutor } from '@hstm-labs/forge-core';
+import { resolveApiStyle } from '@hstm-labs/forge-architect';
+import { loadProfile } from '@hstm-labs/forge-profiles';
+import { loadTemplate, renderTemplate } from '@hstm-labs/forge-templates';
+import { ApiOutputValidator } from './validator.js';
+/**
+ * Pipeline stage that generates the API layer.
+ *
+ * Produces an {@link ApiArtifact} containing endpoint definitions, handler
+ * source files, type definitions, and a contract artifact. Each handler
+ * and type definition is written as a separate file artifact.
+ *
+ * @example
+ * ```ts
+ * const stage = new ServicesGenerateStage();
+ * const output = await stage.execute(input, context);
+ * const api = output.data?.api as ApiArtifact;
+ * ```
+ */
+export class ServicesGenerateStage {
+    name = 'services-generate';
+    dependsOn = ['architect'];
+    requiresLLM = true;
+    /**
+     * Return rendered agent-mode prompt context using `services-generate-agent.hbs`.
+     *
+     * @param input - Input from prior stages
+     * @param context - Pipeline context with config, workspace, and runId
+     * @returns Agent prompt context with rendered template and output schema
+     */
+    getAgentContext(input, context) {
+        const parsedSpec = input['validate']?.data?.['parsedSpec'];
+        const architecture = input['architect']?.data?.['architecture'];
+        const profile = loadProfile(context.config.profileName, context.workspace.rootDir);
+        const resolvedApiStyle = parsedSpec
+            ? resolveApiStyle(parsedSpec, profile)
+            : 'graphql';
+        const outputDir = join(context.workspace.forgeDir, 'runs', context.runId, 'stages', 'services-generate', 'artifacts');
+        const agentTemplate = loadTemplate('services-generate-agent', context.workspace.rootDir);
+        const rendered = renderTemplate(agentTemplate, {
+            spec: (parsedSpec ?? {}),
+            profile: profile,
+            architecture: (architecture ?? {}),
+            stage: { resolvedApiStyle, outputDir },
+        });
+        return {
+            prompt: rendered.content,
+            outputSchema: { format: 'json' },
+        };
+    }
+    /**
+     * Execute the API generation stage.
+     *
+     * @param input - Input from prior stages (expects validate + architect output)
+     * @param context - Pipeline context with config, workspace, and adapter
+     * @returns Stage output with API artifacts and parsed ApiArtifact in data
+     * @throws {ForgeError} FORGE-PIPE-003 if dependency stage output is missing
+     * @throws {ForgeError} FORGE-PIPE-001 if adapter is missing
+     * @throws {ForgeError} FORGE-GEN-003 if max retries exhausted
+     */
+    async execute(input, context) {
+        // 1. Get parsed spec from validate stage output
+        const validateOutput = input['validate'];
+        if (validateOutput === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.DEPENDENCY_UNMET, "Services generate stage requires 'validate' stage output, but it was not found. " +
+                'Ensure the validate stage runs before the services-generate stage.');
+        }
+        const parsedSpec = validateOutput.data?.['parsedSpec'];
+        if (parsedSpec === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.STAGE_FAILURE, 'Validate stage did not produce a parsed specification in its output data. ' +
+                'Ensure the validate stage includes parsedSpec in its data output.');
+        }
+        // 2. Get architecture from architect stage output
+        const architectOutput = input['architect'];
+        if (architectOutput === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.DEPENDENCY_UNMET, "Services generate stage requires 'architect' stage output, but it was not found. " +
+                'Ensure the architect stage runs before the services-generate stage.');
+        }
+        const architecture = architectOutput.data?.['architecture'];
+        if (architecture === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.STAGE_FAILURE, 'Architect stage did not produce an architecture in its output data. ' +
+                'Ensure the architect stage includes architecture in its data output.');
+        }
+        // 3. Load profile, resolve API style
+        const profile = loadProfile(context.config.profileName, context.workspace.rootDir);
+        const resolvedApiStyle = resolveApiStyle(parsedSpec, profile);
+        // 4. Compute output directory
+        const outputDir = join(context.workspace.forgeDir, 'runs', context.runId, 'stages', 'services-generate', 'artifacts');
+        // 5. Load and render templates
+        const systemTemplate = loadTemplate('services-generate-system', context.workspace.rootDir);
+        const userTemplate = loadTemplate('services-generate-user', context.workspace.rootDir);
+        const templateContext = {
+            spec: parsedSpec,
+            profile: profile,
+            architecture: architecture,
+            stage: {
+                resolvedApiStyle,
+                outputDir,
+            },
+        };
+        const systemPrompt = renderTemplate(systemTemplate, templateContext);
+        const userPrompt = renderTemplate(userTemplate, templateContext);
+        // 6. Execute via API mode StageExecutor
+        if (context.adapter === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.STAGE_FAILURE, 'Services generate stage requires an LLM adapter in API mode, but none was provided. ' +
+                'Configure an LLM provider in forge.config.json or use agent mode.');
+        }
+        const validator = new ApiOutputValidator(architecture.dataModel);
+        const executor = new ApiStageExecutor({
+            adapter: context.adapter,
+            validator,
+            retryPolicy: {
+                maxRetries: 3,
+                backoffMs: 1000,
+                includeErrorInRetry: true,
+            },
+        });
+        const result = await executor.execute({
+            prompt: userPrompt.content,
+            systemPrompt: systemPrompt.content,
+            stageName: 'services-generate',
+            outputDir,
+            runId: context.runId,
+            mode: 'api',
+            outputSchema: { format: 'json' },
+        });
+        // 7. Parse ApiArtifact from LLM output
+        const rawContent = result.artifacts[0]?.content ?? '';
+        const apiArtifact = JSON.parse(rawContent);
+        // 8. Write individual files to artifacts directory
+        mkdirSync(outputDir, { recursive: true });
+        const artifacts = [];
+        // Write handler files
+        for (const handler of apiArtifact.handlers) {
+            const filePath = handler.fileName;
+            writeFileSync(join(outputDir, filePath), handler.content, 'utf-8');
+            artifacts.push({
+                filePath,
+                content: handler.content,
+                contentHash: hashContent(handler.content),
+                sizeBytes: Buffer.byteLength(handler.content, 'utf-8'),
+            });
+        }
+        // Write type definition files
+        for (const typeDef of apiArtifact.types) {
+            const filePath = typeDef.fileName;
+            writeFileSync(join(outputDir, filePath), typeDef.content, 'utf-8');
+            artifacts.push({
+                filePath,
+                content: typeDef.content,
+                contentHash: hashContent(typeDef.content),
+                sizeBytes: Buffer.byteLength(typeDef.content, 'utf-8'),
+            });
+        }
+        // Write contract artifact
+        const contractPath = apiArtifact.contract.fileName;
+        writeFileSync(join(outputDir, contractPath), apiArtifact.contract.content, 'utf-8');
+        artifacts.push({
+            filePath: contractPath,
+            content: apiArtifact.contract.content,
+            contentHash: hashContent(apiArtifact.contract.content),
+            sizeBytes: Buffer.byteLength(apiArtifact.contract.content, 'utf-8'),
+        });
+        // 9. Return PipelineStageOutput with all artifacts and data
+        return {
+            artifacts,
+            data: {
+                api: apiArtifact,
+            },
+        };
+    }
+}
+//# sourceMappingURL=services-generate-stage.js.map

package/dist/services-generate-stage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"services-generate-stage.js","sourceRoot":"","sources":["../src/services-generate-stage.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,61 @@
+/**
+ * API artifact type definitions for the Forge API generation stage.
+ *
+ * Defines the output schema produced by the API generation stage,
+ * including endpoints, handlers, type definitions, and the contract
+ * artifact (OpenAPI or GraphQL schema).
+ */
+/** Complete API layer output produced by the services-generate stage. */
+export interface ApiArtifact {
+    /** Resolved API style for this generation. */
+    apiStyle: 'rest' | 'graphql' | 'grpc';
+    /** Generated route/resolver definitions. */
+    endpoints: ApiEndpoint[];
+    /** Generated handler implementations (source code). */
+    handlers: ApiHandler[];
+    /** Type/schema definitions. */
+    types: ApiTypeDefinition[];
+    /** Contract artifact content. */
+    contract: ApiContract;
+}
+/** A single API endpoint or resolver definition. */
+export interface ApiEndpoint {
+    /** Entity or resource this endpoint covers. */
+    entity: string;
+    /** HTTP method (REST) or operation type (GraphQL: query/mutation). */
+    method: string;
+    /** Route path (REST: /api/pets) or field name (GraphQL: pets). */
+    path: string;
+    /** Handler function name. */
+    handler: string;
+    /** Description. */
+    description: string;
+}
+/** A generated handler source file. */
+export interface ApiHandler {
+    /** File name (e.g., "pet-router.ts", "pet-resolver.ts"). */
+    fileName: string;
+    /** File content (source code). */
+    content: string;
+    /** Entity this handler covers. */
+    entity: string;
+}
+/** A generated TypeScript type/interface definition file. */
+export interface ApiTypeDefinition {
+    /** Type name. */
+    name: string;
+    /** File name. */
+    fileName: string;
+    /** File content. */
+    content: string;
+}
+/** The API contract artifact (OpenAPI spec or GraphQL schema). */
+export interface ApiContract {
+    /** Contract format. */
+    format: 'openapi' | 'graphql';
+    /** File name (openapi.json or schema.graphql). */
+    fileName: string;
+    /** Contract content (JSON string or GraphQL SDL). */
+    content: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,yEAAyE;AACzE,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAAC;IACtC,4CAA4C;IAC5C,SAAS,EAAE,WAAW,EAAE,CAAC;IACzB,uDAAuD;IACvD,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,+BAA+B;IAC/B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,iCAAiC;IACjC,QAAQ,EAAE,WAAW,CAAC;CACvB;AAMD,oDAAoD;AACpD,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,mBAAmB;IACnB,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,uCAAuC;AACvC,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,QAAQ,EAAE,MAAM,CAAC;IACjB,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB;AAMD,6DAA6D;AAC7D,MAAM,WAAW,iBAAiB;IAChC,iBAAiB;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,oBAAoB;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,MAAM,EAAE,SAAS,GAAG,SAAS,CAAC;IAC9B,kDAAkD;IAClD,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;CACjB"}

package/dist/types.js

@@ -0,0 +1,9 @@
+/**
+ * API artifact type definitions for the Forge API generation stage.
+ *
+ * Defines the output schema produced by the API generation stage,
+ * including endpoints, handlers, type definitions, and the contract
+ * artifact (OpenAPI or GraphQL schema).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/validator.d.ts

@@ -0,0 +1,42 @@
+/**
+ * API output validator for the Forge API generation stage.
+ *
+ * Validates LLM-generated API output against the
+ * {@link ApiArtifact} schema with structural and semantic checks.
+ */
+import type { OutputValidator, OutputSchema, ValidationResult } from '@hstm-labs/forge-core';
+import type { DataModelEntity } from '@hstm-labs/forge-architect';
+/**
+ * Validator for API generation stage output.
+ *
+ * Performs the following checks:
+ * 1. JSON parse validation
+ * 2. Required top-level keys
+ * 3. Non-empty endpoints with required fields
+ * 4. Entity coverage (every data model entity has endpoints)
+ * 5. Contract presence with valid format, fileName, and content
+ * 6. Contract format matches apiStyle
+ * 7. Non-empty handlers with fileName and content
+ *
+ * @example
+ * ```ts
+ * const validator = new ApiOutputValidator(dataModelEntities);
+ * const result = validator.validate(llmOutput, { format: 'json' });
+ * ```
+ */
+export declare class ApiOutputValidator implements OutputValidator {
+    private readonly dataModelEntities;
+    /**
+     * @param dataModelEntities - Data model entities to verify endpoint coverage
+     */
+    constructor(dataModelEntities: DataModelEntity[]);
+    /**
+     * Validate API output against the ApiArtifact schema.
+     *
+     * @param output - Raw LLM output text
+     * @param _schema - Output schema (format expected to be 'json')
+     * @returns Validation result with descriptive errors
+     */
+    validate(output: string, _schema: OutputSchema): ValidationResult;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,gBAAgB,EAEjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAuBlE;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IACxD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoB;IAEtD;;OAEG;gBACS,iBAAiB,EAAE,eAAe,EAAE;IAIhD;;;;;;OAMG;IAEH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,gBAAgB;CAiMlE"}

package/dist/validator.js

@@ -0,0 +1,236 @@
+/**
+ * API output validator for the Forge API generation stage.
+ *
+ * Validates LLM-generated API output against the
+ * {@link ApiArtifact} schema with structural and semantic checks.
+ */
+// ---------------------------------------------------------------------------
+// Contract format mapping
+// ---------------------------------------------------------------------------
+const API_STYLE_TO_CONTRACT_FORMAT = {
+    rest: 'openapi',
+    graphql: 'graphql',
+};
+const REQUIRED_TOP_LEVEL_KEYS = [
+    'apiStyle',
+    'endpoints',
+    'handlers',
+    'types',
+    'contract',
+];
+// ---------------------------------------------------------------------------
+// Implementation
+// ---------------------------------------------------------------------------
+/**
+ * Validator for API generation stage output.
+ *
+ * Performs the following checks:
+ * 1. JSON parse validation
+ * 2. Required top-level keys
+ * 3. Non-empty endpoints with required fields
+ * 4. Entity coverage (every data model entity has endpoints)
+ * 5. Contract presence with valid format, fileName, and content
+ * 6. Contract format matches apiStyle
+ * 7. Non-empty handlers with fileName and content
+ *
+ * @example
+ * ```ts
+ * const validator = new ApiOutputValidator(dataModelEntities);
+ * const result = validator.validate(llmOutput, { format: 'json' });
+ * ```
+ */
+export class ApiOutputValidator {
+    dataModelEntities;
+    /**
+     * @param dataModelEntities - Data model entities to verify endpoint coverage
+     */
+    constructor(dataModelEntities) {
+        this.dataModelEntities = dataModelEntities;
+    }
+    /**
+     * Validate API output against the ApiArtifact schema.
+     *
+     * @param output - Raw LLM output text
+     * @param _schema - Output schema (format expected to be 'json')
+     * @returns Validation result with descriptive errors
+     */
+    // eslint-disable-next-line @typescript-eslint/no-unused-vars
+    validate(output, _schema) {
+        const errors = [];
+        // 1. Parse as JSON
+        let parsed;
+        try {
+            parsed = JSON.parse(output);
+        }
+        catch {
+            errors.push({
+                message: 'API output is not valid JSON. Ensure the LLM produces only raw JSON without markdown fences or explanatory text.',
+                severity: 'error',
+            });
+            return { valid: false, errors };
+        }
+        if (typeof parsed !== 'object' || parsed === null || Array.isArray(parsed)) {
+            errors.push({
+                message: 'API output must be a JSON object, not an array or primitive.',
+                severity: 'error',
+            });
+            return { valid: false, errors };
+        }
+        const obj = parsed;
+        // 2. Verify required top-level keys
+        for (const key of REQUIRED_TOP_LEVEL_KEYS) {
+            if (!(key in obj)) {
+                errors.push({
+                    message: `Missing required top-level key: '${key}'.`,
+                    path: key,
+                    severity: 'error',
+                });
+            }
+        }
+        if (errors.length > 0) {
+            return { valid: false, errors };
+        }
+        // 3. Verify endpoints is non-empty array with required fields
+        const endpoints = obj['endpoints'];
+        if (!Array.isArray(endpoints) || endpoints.length === 0) {
+            errors.push({
+                message: "Key 'endpoints' must be a non-empty array of endpoint definitions.",
+                path: 'endpoints',
+                severity: 'error',
+            });
+        }
+        else {
+            for (let i = 0; i < endpoints.length; i++) {
+                const ep = endpoints[i];
+                if (ep === undefined || typeof ep !== 'object' || ep === null) {
+                    errors.push({
+                        message: `endpoints[${String(i)}] is not a valid object.`,
+                        path: `endpoints[${String(i)}]`,
+                        severity: 'error',
+                    });
+                    continue;
+                }
+                if (typeof ep['entity'] !== 'string' || ep['entity'].length === 0) {
+                    errors.push({
+                        message: `endpoints[${String(i)}] is missing required field 'entity'.`,
+                        path: `endpoints[${String(i)}].entity`,
+                        severity: 'error',
+                    });
+                }
+                if (typeof ep['method'] !== 'string' || ep['method'].length === 0) {
+                    errors.push({
+                        message: `endpoints[${String(i)}] is missing required field 'method'.`,
+                        path: `endpoints[${String(i)}].method`,
+                        severity: 'error',
+                    });
+                }
+                if (typeof ep['path'] !== 'string' || ep['path'].length === 0) {
+                    errors.push({
+                        message: `endpoints[${String(i)}] is missing required field 'path'.`,
+                        path: `endpoints[${String(i)}].path`,
+                        severity: 'error',
+                    });
+                }
+            }
+        }
+        // 4. Entity coverage — every data model entity has at least one endpoint
+        if (Array.isArray(endpoints) && endpoints.length > 0) {
+            const endpointEntities = new Set(endpoints
+                .filter((ep) => typeof ep['entity'] === 'string')
+                .map((ep) => ep['entity'].toLowerCase()));
+            for (const entity of this.dataModelEntities) {
+                if (!endpointEntities.has(entity.name.toLowerCase())) {
+                    errors.push({
+                        message: `Data model entity '${entity.name}' has no corresponding endpoints. Every entity must have API coverage.`,
+                        path: 'endpoints',
+                        severity: 'error',
+                    });
+                }
+            }
+        }
+        // 5. Verify contract has valid format, fileName, and non-empty content
+        const contract = obj['contract'];
+        if (typeof contract !== 'object' || contract === null || Array.isArray(contract)) {
+            errors.push({
+                message: "Key 'contract' must be an object with format, fileName, and content.",
+                path: 'contract',
+                severity: 'error',
+            });
+        }
+        else {
+            const c = contract;
+            if (typeof c['format'] !== 'string' || c['format'].length === 0) {
+                errors.push({
+                    message: "Contract is missing required field 'format'.",
+                    path: 'contract.format',
+                    severity: 'error',
+                });
+            }
+            if (typeof c['fileName'] !== 'string' || c['fileName'].length === 0) {
+                errors.push({
+                    message: "Contract is missing required field 'fileName'.",
+                    path: 'contract.fileName',
+                    severity: 'error',
+                });
+            }
+            if (typeof c['content'] !== 'string' || c['content'].length === 0) {
+                errors.push({
+                    message: "Contract is missing required field 'content' (must be non-empty).",
+                    path: 'contract.content',
+                    severity: 'error',
+                });
+            }
+            // 6. Verify contract format matches apiStyle
+            const apiStyle = obj['apiStyle'];
+            if (typeof apiStyle === 'string' &&
+                typeof c['format'] === 'string') {
+                const expectedFormat = API_STYLE_TO_CONTRACT_FORMAT[apiStyle];
+                if (expectedFormat !== undefined && c['format'] !== expectedFormat) {
+                    errors.push({
+                        message: `Contract format '${c['format']}' does not match API style '${apiStyle}'. Expected '${expectedFormat}'.`,
+                        path: 'contract.format',
+                        severity: 'error',
+                    });
+                }
+            }
+        }
+        // 7. Verify handlers is non-empty array with fileName and content
+        const handlers = obj['handlers'];
+        if (!Array.isArray(handlers) || handlers.length === 0) {
+            errors.push({
+                message: "Key 'handlers' must be a non-empty array of handler definitions.",
+                path: 'handlers',
+                severity: 'error',
+            });
+        }
+        else {
+            for (let i = 0; i < handlers.length; i++) {
+                const h = handlers[i];
+                if (h === undefined || typeof h !== 'object' || h === null) {
+                    errors.push({
+                        message: `handlers[${String(i)}] is not a valid object.`,
+                        path: `handlers[${String(i)}]`,
+                        severity: 'error',
+                    });
+                    continue;
+                }
+                if (typeof h['fileName'] !== 'string' || h['fileName'].length === 0) {
+                    errors.push({
+                        message: `handlers[${String(i)}] is missing required field 'fileName'.`,
+                        path: `handlers[${String(i)}].fileName`,
+                        severity: 'error',
+                    });
+                }
+                if (typeof h['content'] !== 'string' || h['content'].length === 0) {
+                    errors.push({
+                        message: `handlers[${String(i)}] is missing required field 'content'.`,
+                        path: `handlers[${String(i)}].content`,
+                        severity: 'error',
+                    });
+                }
+            }
+        }
+        return { valid: errors.length === 0, errors };
+    }
+}
+//# sourceMappingURL=validator.js.map

package/dist/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@hstm-labs/forge-services-generator",
+  "version": "0.1.11",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@hstm-labs/forge-common": "0.1.11",
+    "@hstm-labs/forge-core": "0.1.11",
+    "@hstm-labs/forge-architect": "0.1.11",
+    "@hstm-labs/forge-spec-parser": "0.1.11",
+    "@hstm-labs/forge-profiles": "0.1.11",
+    "@hstm-labs/forge-templates": "0.1.11"
+  }
+}