@hstm-labs/forge-deliverer 0.1.11

package/README.md

@@ -0,0 +1,44 @@
+# @hstm-labs/forge-deliverer
+
+Output packaging and delivery for Forge — merges artifacts from all generation stages, validates self-containment, creates compressed archives, and writes deliverables to configurable targets.
+
+## Installation
+
+```bash
+npm install @hstm-labs/forge-deliverer
+```
+
+## Public API
+
+### Types
+
+- `DeliveryResult` — complete delivery output with manifest and archive path
+- `DeliveryManifest`, `DeliveryStageEntry` — manifest tracking all delivered files
+- `SelfContainmentResult`, `SelfContainmentCheck` — self-containment validation
+- `DeliveryOptions` — delivery configuration
+
+### Classes
+
+- `DeliverStage` — pipeline stage implementing `PipelineStage` interface
+
+### Functions
+
+- `mergeArtifacts(stageOutputs)` — merge artifacts from all pipeline stages
+- `validateSelfContainment(outputDir)` — verify no dangling imports/references
+- `createArchive(outputDir, archivePath)` — create .tgz archive
+- `deliverToTarget(archive, target)` — write to configured delivery target
+- `formatDeliveryResult()`, `deliveryResultToJson()` — output formatters
+
+## Usage
+
+```typescript
+import { DeliverStage } from '@hstm-labs/forge-deliverer';
+
+const stage = new DeliverStage();
+const result = await stage.execute(input);
+console.log(`Delivered to: ${result.data.archivePath}`);
+```
+
+## License
+
+[MIT](../../LICENSE)

package/dist/archiver.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Archive creation for the Forge delivery stage.
+ *
+ * Creates a tgz or zip archive from the staging directory,
+ * excluding `.git`, `node_modules`, and `.DS_Store`.
+ */
+/**
+ * Create an archive from the staging directory.
+ *
+ * Uses the system `tar` command for tgz archives. Falls back
+ * gracefully with a warning if archive creation fails.
+ *
+ * @param stagingDir - Source directory to archive
+ * @param outputPath - Full path for the output archive file
+ * @param format - Archive format: 'tgz' or 'zip'
+ * @returns Archive path and size in bytes
+ * @throws {ForgeError} FORGE-DLVR-001 if archive creation fails
+ */
+export declare function createArchive(stagingDir: string, outputPath: string, format: 'tgz' | 'zip'): Promise<{
+    archivePath: string;
+    sizeBytes: number;
+}>;
+//# sourceMappingURL=archiver.d.ts.map

package/dist/archiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archiver.d.ts","sourceRoot":"","sources":["../src/archiver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH;;;;;;;;;;;GAWG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,KAAK,GAAG,KAAK,GACpB,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CA0BrD"}

package/dist/archiver.js

@@ -0,0 +1,43 @@
+/**
+ * Archive creation for the Forge delivery stage.
+ *
+ * Creates a tgz or zip archive from the staging directory,
+ * excluding `.git`, `node_modules`, and `.DS_Store`.
+ */
+import { execSync } from 'node:child_process';
+import { statSync } from 'node:fs';
+import { ForgeError, ErrorCodes } from '@hstm-labs/forge-common';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Create an archive from the staging directory.
+ *
+ * Uses the system `tar` command for tgz archives. Falls back
+ * gracefully with a warning if archive creation fails.
+ *
+ * @param stagingDir - Source directory to archive
+ * @param outputPath - Full path for the output archive file
+ * @param format - Archive format: 'tgz' or 'zip'
+ * @returns Archive path and size in bytes
+ * @throws {ForgeError} FORGE-DLVR-001 if archive creation fails
+ */
+export async function createArchive(stagingDir, outputPath, format) {
+    try {
+        if (format === 'tgz') {
+            execSync(`tar -czf "${outputPath}" --exclude='.git' --exclude='node_modules' --exclude='.DS_Store' -C "${stagingDir}" .`, { stdio: 'pipe' });
+        }
+        else {
+            execSync(`zip -r "${outputPath}" . -x '.git/*' -x 'node_modules/*' -x '.DS_Store'`, { cwd: stagingDir, stdio: 'pipe' });
+        }
+        const stat = statSync(outputPath);
+        return { archivePath: outputPath, sizeBytes: stat.size };
+    }
+    catch (error) {
+        const cause = error instanceof Error ? error : undefined;
+        throw new ForgeError(ErrorCodes.DLVR.PACKAGING_FAILURE, `Failed to create ${format} archive at '${outputPath}'. ` +
+            'Ensure tar/zip is available on your system. ' +
+            `Error: ${cause?.message ?? 'Unknown error'}`, cause !== undefined ? { cause } : undefined);
+    }
+}
+//# sourceMappingURL=archiver.js.map

package/dist/archiver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"archiver.js","sourceRoot":"","sources":["../src/archiver.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAEjE,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,UAAkB,EAClB,UAAkB,EAClB,MAAqB;IAErB,IAAI,CAAC;QACH,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;YACrB,QAAQ,CACN,aAAa,UAAU,yEAAyE,UAAU,KAAK,EAC/G,EAAE,KAAK,EAAE,MAAM,EAAE,CAClB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,QAAQ,CACN,WAAW,UAAU,oDAAoD,EACzE,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,EAAE,CACnC,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QAClC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;IAC3D,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;QACzD,MAAM,IAAI,UAAU,CAClB,UAAU,CAAC,IAAI,CAAC,iBAAiB,EACjC,oBAAoB,MAAM,gBAAgB,UAAU,KAAK;YACvD,8CAA8C;YAC9C,UAAU,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,EAC/C,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAC5C,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/artifact-merger.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Artifact merger for the Forge delivery stage.
+ *
+ * Merges generated artifacts from all pipeline stages into a cohesive
+ * project structure in a target directory (staging or project root).
+ * For layouts like scalable-monorepo, service grouping (e.g. services/identity/...)
+ * is achieved by generator-emitted artifact paths under the stage's target base.
+ */
+import type { StageName, Workspace, RunStore } from '@hstm-labs/forge-common';
+import type { DeliveryStageEntry } from './types.js';
+/**
+ * Merge artifacts from all pipeline stages into a target directory.
+ *
+ * Reads artifact files from their on-disk locations and copies them
+ * into a project-like directory structure using the layout's stage mapping.
+ *
+ * @param workspace - Resolved workspace paths
+ * @param runId - Run ID to merge artifacts for
+ * @param store - RunStore for artifact metadata
+ * @param stageMapping - Maps stage name to target directory (from project layout)
+ * @param targetDir - Directory to merge into (e.g. staging dir or project root)
+ * @returns Stage entries for the manifest
+ */
+export declare function mergeArtifacts(workspace: Workspace, runId: string, store: RunStore, stageMapping: Partial<Record<StageName, string>>, targetDir: string): {
+    stageEntries: DeliveryStageEntry[];
+};
+//# sourceMappingURL=artifact-merger.d.ts.map

package/dist/artifact-merger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-merger.d.ts","sourceRoot":"","sources":["../src/artifact-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAMrD;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,QAAQ,EACf,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC,EAChD,SAAS,EAAE,MAAM,GAChB;IAAE,YAAY,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAsDxC"}

package/dist/artifact-merger.js

@@ -0,0 +1,64 @@
+/**
+ * Artifact merger for the Forge delivery stage.
+ *
+ * Merges generated artifacts from all pipeline stages into a cohesive
+ * project structure in a target directory (staging or project root).
+ * For layouts like scalable-monorepo, service grouping (e.g. services/identity/...)
+ * is achieved by generator-emitted artifact paths under the stage's target base.
+ */
+import { join } from 'node:path';
+import { mkdirSync, readFileSync, writeFileSync, existsSync } from 'node:fs';
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Merge artifacts from all pipeline stages into a target directory.
+ *
+ * Reads artifact files from their on-disk locations and copies them
+ * into a project-like directory structure using the layout's stage mapping.
+ *
+ * @param workspace - Resolved workspace paths
+ * @param runId - Run ID to merge artifacts for
+ * @param store - RunStore for artifact metadata
+ * @param stageMapping - Maps stage name to target directory (from project layout)
+ * @param targetDir - Directory to merge into (e.g. staging dir or project root)
+ * @returns Stage entries for the manifest
+ */
+export function mergeArtifacts(workspace, runId, store, stageMapping, targetDir) {
+    mkdirSync(targetDir, { recursive: true });
+    const stageEntries = [];
+    const stages = store.getStages(runId);
+    for (const stage of stages) {
+        if (stage.status !== 'COMPLETED')
+            continue;
+        const artifacts = store.getArtifacts(runId, stage.stageName);
+        if (artifacts.length === 0)
+            continue;
+        const stageTargetDir = stageMapping[stage.stageName];
+        if (stageTargetDir === undefined)
+            continue;
+        const files = [];
+        for (const artifact of artifacts) {
+            const sourcePath = join(workspace.forgeDir, 'runs', runId, 'stages', artifact.stageName, 'artifacts', artifact.filePath);
+            // Determine target file path within target directory
+            const relativeTarget = stageTargetDir === '.'
+                ? artifact.filePath
+                : join(stageTargetDir, artifact.filePath);
+            const destPath = join(targetDir, relativeTarget);
+            const destDir = join(destPath, '..');
+            mkdirSync(destDir, { recursive: true });
+            if (existsSync(sourcePath)) {
+                const content = readFileSync(sourcePath);
+                writeFileSync(destPath, content);
+            }
+            files.push(relativeTarget);
+        }
+        stageEntries.push({
+            stageName: stage.stageName,
+            artifactCount: files.length,
+            files,
+        });
+    }
+    return { stageEntries };
+}
+//# sourceMappingURL=artifact-merger.js.map

package/dist/artifact-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-merger.js","sourceRoot":"","sources":["../src/artifact-merger.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAI7E,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAoB,EACpB,KAAa,EACb,KAAe,EACf,YAAgD,EAChD,SAAiB;IAEjB,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE1C,MAAM,YAAY,GAAyB,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAEtC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,MAAM,KAAK,WAAW;YAAE,SAAS;QAE3C,MAAM,SAAS,GAAG,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QAC7D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QAErC,MAAM,cAAc,GAAG,YAAY,CAAC,KAAK,CAAC,SAAsB,CAAC,CAAC;QAClE,IAAI,cAAc,KAAK,SAAS;YAAE,SAAS;QAE3C,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,MAAM,UAAU,GAAG,IAAI,CACrB,SAAS,CAAC,QAAQ,EAClB,MAAM,EACN,KAAK,EACL,QAAQ,EACR,QAAQ,CAAC,SAAS,EAClB,WAAW,EACX,QAAQ,CAAC,QAAQ,CAClB,CAAC;YAEF,qDAAqD;YACrD,MAAM,cAAc,GAClB,cAAc,KAAK,GAAG;gBACpB,CAAC,CAAC,QAAQ,CAAC,QAAQ;gBACnB,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;YAE9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,cAAc,CAAC,CAAC;YACjD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YACrC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAExC,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC3B,MAAM,OAAO,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;gBACzC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnC,CAAC;YAED,KAAK,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC7B,CAAC;QAED,YAAY,CAAC,IAAI,CAAC;YAChB,SAAS,EAAE,KAAK,CAAC,SAAS;YAC1B,aAAa,EAAE,KAAK,CAAC,MAAM;YAC3B,KAAK;SACN,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,YAAY,EAAE,CAAC;AAC1B,CAAC"}

package/dist/deliver-stage.d.ts

@@ -0,0 +1,44 @@
+/**
+ * DeliverStage — final pipeline stage that packages and delivers
+ * all generated artifacts.
+ *
+ * Merges artifacts from all completed stages into a cohesive project
+ * structure, validates self-containment, creates an archive, and
+ * delivers to a target directory.
+ */
+import type { StageName } from '@hstm-labs/forge-common';
+import type { PipelineStage, PipelineStageInput, PipelineStageOutput, PipelineContext } from '@hstm-labs/forge-core';
+/**
+ * Pipeline stage that packages and delivers all generated artifacts.
+ *
+ * This is the final stage in the Forge pipeline. It:
+ * 1. Merges artifacts from all completed stages into a project structure
+ * 2. Generates minimal package.json and README.md if missing
+ * 3. Validates self-containment
+ * 4. Delivers to a target directory
+ * 5. Creates an archive (tgz)
+ * 6. Writes a delivery manifest
+ *
+ * @example
+ * ```ts
+ * const stage = new DeliverStage();
+ * const output = await stage.execute(input, context);
+ * const result = output.data?.delivery as DeliveryResult;
+ * ```
+ */
+export declare class DeliverStage implements PipelineStage {
+    readonly name: StageName;
+    readonly dependsOn: StageName[];
+    readonly requiresLLM = false;
+    /**
+     * Execute the delivery stage.
+     *
+     * @param _input - Pipeline stage input (not used — reads from disk)
+     * @param context - Pipeline context with config, workspace, and store
+     * @returns Stage output with delivery manifest and DeliveryResult in data
+     * @throws {ForgeError} FORGE-PIPE-001 if store is missing
+     * @throws {ForgeError} FORGE-DLVR-001 if archive creation fails
+     */
+    execute(_input: PipelineStageInput, context: PipelineContext): Promise<PipelineStageOutput>;
+}
+//# sourceMappingURL=deliver-stage.d.ts.map

package/dist/deliver-stage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deliver-stage.d.ts","sourceRoot":"","sources":["../src/deliver-stage.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAOzD,OAAO,KAAK,EACV,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,eAAe,EAChB,MAAM,uBAAuB,CAAC;AAmG/B;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,YAAa,YAAW,aAAa;IAChD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAa;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,EAAE,CAAc;IAC7C,QAAQ,CAAC,WAAW,SAAS;IAE7B;;;;;;;;OAQG;IACG,OAAO,CACX,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,mBAAmB,CAAC;CA+GhC"}

package/dist/deliver-stage.js

@@ -0,0 +1,191 @@
+/**
+ * DeliverStage — final pipeline stage that packages and delivers
+ * all generated artifacts.
+ *
+ * Merges artifacts from all completed stages into a cohesive project
+ * structure, validates self-containment, creates an archive, and
+ * delivers to a target directory.
+ */
+import { join } from 'node:path';
+import { existsSync, writeFileSync } from 'node:fs';
+import { ForgeError, ErrorCodes, hashContent, getLayout, } from '@hstm-labs/forge-common';
+import { mergeArtifacts } from './artifact-merger.js';
+import { validateSelfContainment } from './self-containment.js';
+import { createArchive } from './archiver.js';
+import { deliverToTarget } from './delivery-writer.js';
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+/** Forge version placeholder — replaced by semantic-release in CI. */
+const FORGE_VERSION = '0.0.0';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Generate a minimal package.json for the delivered project.
+ *
+ * @param stagingDir - Staging directory to write to
+ */
+function generateMinimalPackageJson(stagingDir) {
+    const pkg = {
+        name: 'forge-generated-project',
+        version: '1.0.0',
+        private: true,
+        scripts: {
+            build: 'echo "Add your build command here"',
+            start: 'echo "Add your start command here"',
+            test: 'echo "Add your test command here"',
+        },
+    };
+    writeFileSync(join(stagingDir, 'package.json'), JSON.stringify(pkg, null, 2) + '\n', 'utf-8');
+}
+/**
+ * Generate a minimal README.md for the delivered project.
+ *
+ * @param stagingDir - Staging directory to write to
+ * @param runId - Run ID for reference
+ */
+function generateMinimalReadme(stagingDir, runId) {
+    const content = [
+        '# Generated Project',
+        '',
+        `This project was generated by [Forge](https://github.com/hstm-labs/forge) (run: \`${runId}\`).`,
+        '',
+        '## Setup',
+        '',
+        '1. Install dependencies:',
+        '   ```bash',
+        '   npm install',
+        '   ```',
+        '',
+        '2. Build the project:',
+        '   ```bash',
+        '   npm run build',
+        '   ```',
+        '',
+        '3. Start the application:',
+        '   ```bash',
+        '   npm start',
+        '   ```',
+        '',
+        '## Project Structure',
+        '',
+        '- `src/api/` — API routes and handlers',
+        '- `src/ui/` — UI pages and components',
+        '- `src/security/` — Security middleware and configuration',
+        '- `data/` — Seed data and migrations',
+        '- `tests/` — Generated test suites',
+        '- `docs/` — Architecture and compliance reports',
+        '',
+        '## Documentation',
+        '',
+        'See the `docs/` directory for architecture decisions and compliance reports.',
+        '',
+    ].join('\n');
+    writeFileSync(join(stagingDir, 'README.md'), content, 'utf-8');
+}
+// ---------------------------------------------------------------------------
+// Stage
+// ---------------------------------------------------------------------------
+/**
+ * Pipeline stage that packages and delivers all generated artifacts.
+ *
+ * This is the final stage in the Forge pipeline. It:
+ * 1. Merges artifacts from all completed stages into a project structure
+ * 2. Generates minimal package.json and README.md if missing
+ * 3. Validates self-containment
+ * 4. Delivers to a target directory
+ * 5. Creates an archive (tgz)
+ * 6. Writes a delivery manifest
+ *
+ * @example
+ * ```ts
+ * const stage = new DeliverStage();
+ * const output = await stage.execute(input, context);
+ * const result = output.data?.delivery as DeliveryResult;
+ * ```
+ */
+export class DeliverStage {
+    name = 'deliver';
+    dependsOn = ['verify'];
+    requiresLLM = false;
+    /**
+     * Execute the delivery stage.
+     *
+     * @param _input - Pipeline stage input (not used — reads from disk)
+     * @param context - Pipeline context with config, workspace, and store
+     * @returns Stage output with delivery manifest and DeliveryResult in data
+     * @throws {ForgeError} FORGE-PIPE-001 if store is missing
+     * @throws {ForgeError} FORGE-DLVR-001 if archive creation fails
+     */
+    async execute(_input, context) {
+        // 1. Validate store is available
+        if (context.store === undefined) {
+            throw new ForgeError(ErrorCodes.PIPE.STAGE_FAILURE, 'Deliver stage requires a RunStore, but none was provided.');
+        }
+        // 2. Resolve layout and merge artifacts into staging directory
+        const layoutName = context.config.layout ?? 'standard';
+        const layout = getLayout(layoutName);
+        const stagingDir = join(context.workspace.forgeDir, 'runs', context.runId, 'staging');
+        const { stageEntries } = mergeArtifacts(context.workspace, context.runId, context.store, layout.stageMapping, stagingDir);
+        // 3. Generate minimal package.json and README.md if not present
+        if (!existsSync(join(stagingDir, 'package.json'))) {
+            generateMinimalPackageJson(stagingDir);
+        }
+        if (!existsSync(join(stagingDir, 'README.md'))) {
+            generateMinimalReadme(stagingDir, context.runId);
+        }
+        // 4. Deliver to project root (layout-aware target)
+        const targetPath = context.workspace.rootDir;
+        const { fileCount, totalSizeBytes } = deliverToTarget(stagingDir, targetPath);
+        // 5. Validate self-containment on project root
+        const selfContainment = validateSelfContainment(targetPath);
+        // 6. Create archive from staging (clean tree, not project root)
+        let archivePath;
+        try {
+            const archiveOutputPath = join(context.workspace.forgeDir, 'runs', context.runId, 'project.tgz');
+            const archiveResult = await createArchive(stagingDir, archiveOutputPath, 'tgz');
+            archivePath = archiveResult.archivePath;
+        }
+        catch {
+            // Archive creation failure is non-fatal
+        }
+        // 7. Build manifest
+        const manifest = {
+            runId: context.runId,
+            deliveredAt: new Date().toISOString(),
+            fileCount,
+            totalSizeBytes,
+            stages: stageEntries,
+            forgeVersion: FORGE_VERSION,
+        };
+        // 8. Write delivery.json to .forge/runs/{id}/ (Forge metadata, not project root)
+        const runsDir = join(context.workspace.forgeDir, 'runs', context.runId);
+        const manifestJson = JSON.stringify(manifest, null, 2);
+        writeFileSync(join(runsDir, 'delivery.json'), manifestJson, 'utf-8');
+        // 9. Build DeliveryResult
+        const deliveryResult = {
+            runId: context.runId,
+            targetPath,
+            archivePath,
+            manifest,
+            selfContainment,
+        };
+        // 10. Return pipeline output
+        const manifestContent = JSON.stringify(deliveryResult, null, 2);
+        return {
+            artifacts: [
+                {
+                    filePath: 'delivery.json',
+                    content: manifestContent,
+                    contentHash: hashContent(manifestContent),
+                    sizeBytes: Buffer.byteLength(manifestContent, 'utf-8'),
+                },
+            ],
+            data: {
+                delivery: deliveryResult,
+            },
+        };
+    }
+}
+//# sourceMappingURL=deliver-stage.js.map

package/dist/deliver-stage.js.map

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

package/dist/delivery-writer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Delivery writer for the Forge delivery stage.
+ *
+ * Copies staged artifacts to the target delivery directory,
+ * preserving directory structure.
+ */
+/**
+ * Deliver staged artifacts to the target directory.
+ *
+ * Copies all files from the staging directory to the target,
+ * preserving the directory structure.
+ *
+ * @param stagingDir - Source staging directory with merged artifacts
+ * @param targetPath - Target delivery directory
+ * @returns File count and total size in bytes
+ */
+export declare function deliverToTarget(stagingDir: string, targetPath: string): {
+    fileCount: number;
+    totalSizeBytes: number;
+};
+//# sourceMappingURL=delivery-writer.d.ts.map

package/dist/delivery-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-writer.d.ts","sourceRoot":"","sources":["../src/delivery-writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuDH;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAE/C"}

package/dist/delivery-writer.js

@@ -0,0 +1,58 @@
+/**
+ * Delivery writer for the Forge delivery stage.
+ *
+ * Copies staged artifacts to the target delivery directory,
+ * preserving directory structure.
+ */
+import { join } from 'node:path';
+import { mkdirSync, readFileSync, writeFileSync, readdirSync, statSync, } from 'node:fs';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Recursively copy a directory, preserving structure.
+ *
+ * @param src - Source directory
+ * @param dest - Destination directory
+ * @returns File count and total size in bytes
+ */
+function copyDirRecursive(src, dest) {
+    mkdirSync(dest, { recursive: true });
+    let fileCount = 0;
+    let totalSizeBytes = 0;
+    const entries = readdirSync(src, { withFileTypes: true });
+    for (const entry of entries) {
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            const sub = copyDirRecursive(srcPath, destPath);
+            fileCount += sub.fileCount;
+            totalSizeBytes += sub.totalSizeBytes;
+        }
+        else {
+            const content = readFileSync(srcPath);
+            writeFileSync(destPath, content);
+            const stat = statSync(srcPath);
+            fileCount++;
+            totalSizeBytes += stat.size;
+        }
+    }
+    return { fileCount, totalSizeBytes };
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Deliver staged artifacts to the target directory.
+ *
+ * Copies all files from the staging directory to the target,
+ * preserving the directory structure.
+ *
+ * @param stagingDir - Source staging directory with merged artifacts
+ * @param targetPath - Target delivery directory
+ * @returns File count and total size in bytes
+ */
+export function deliverToTarget(stagingDir, targetPath) {
+    return copyDirRecursive(stagingDir, targetPath);
+}
+//# sourceMappingURL=delivery-writer.js.map

package/dist/delivery-writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-writer.js","sourceRoot":"","sources":["../src/delivery-writer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,EACb,WAAW,EACX,QAAQ,GACT,MAAM,SAAS,CAAC;AAEjB,8EAA8E;AAC9E,UAAU;AACV,8EAA8E;AAE9E;;;;;;GAMG;AACH,SAAS,gBAAgB,CACvB,GAAW,EACX,IAAY;IAEZ,SAAS,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrC,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAExC,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,gBAAgB,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAChD,SAAS,IAAI,GAAG,CAAC,SAAS,CAAC;YAC3B,cAAc,IAAI,GAAG,CAAC,cAAc,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;YACtC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACjC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC;YAC/B,SAAS,EAAE,CAAC;YACZ,cAAc,IAAI,IAAI,CAAC,IAAI,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC;AACvC,CAAC;AAED,8EAA8E;AAC9E,aAAa;AACb,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,UAAkB;IAElB,OAAO,gBAAgB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC"}

package/dist/formatters.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Delivery result formatters for the Forge CLI.
+ *
+ * Produces human-readable console output and JSON representations
+ * of the delivery result.
+ */
+import type { DeliveryResult } from './types.js';
+/**
+ * Format a delivery result into human-readable console output.
+ *
+ * @param result - The delivery result to format
+ * @returns Multi-line formatted string
+ */
+export declare function formatDeliveryResult(result: DeliveryResult): string;
+/**
+ * Convert a delivery result to a JSON-serializable object.
+ *
+ * @param result - The delivery result
+ * @returns Plain object suitable for JSON output
+ */
+export declare function deliveryResultToJson(result: DeliveryResult): Record<string, unknown>;
+//# sourceMappingURL=formatters.d.ts.map

package/dist/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../src/formatters.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAoCjD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAyDnE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,cAAc,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAQzB"}

package/dist/formatters.js

@@ -0,0 +1,101 @@
+/**
+ * Delivery result formatters for the Forge CLI.
+ *
+ * Produces human-readable console output and JSON representations
+ * of the delivery result.
+ */
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Format byte size into a human-readable string.
+ *
+ * @param bytes - Size in bytes
+ * @returns Human-readable size string (e.g., "245 KB")
+ */
+function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${String(bytes)} B`;
+    const kb = bytes / 1024;
+    if (kb < 1024)
+        return `${kb.toFixed(1)} KB`;
+    const mb = kb / 1024;
+    return `${mb.toFixed(1)} MB`;
+}
+/**
+ * Pad or truncate a string to a fixed width.
+ *
+ * @param str - Input string
+ * @param width - Target width
+ * @returns Padded string
+ */
+function pad(str, width) {
+    if (str.length >= width)
+        return str.slice(0, width);
+    return str + ' '.repeat(width - str.length);
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Format a delivery result into human-readable console output.
+ *
+ * @param result - The delivery result to format
+ * @returns Multi-line formatted string
+ */
+export function formatDeliveryResult(result) {
+    const lines = [];
+    // Header box
+    lines.push('\u2554' + '\u2550'.repeat(44) + '\u2557');
+    lines.push('\u2551' + pad('          Delivery Complete', 44) + '\u2551');
+    lines.push('\u2560' + '\u2550'.repeat(44) + '\u2563');
+    lines.push('\u2551' + pad(`  Run: ${result.runId}`, 44) + '\u2551');
+    lines.push('\u2551' +
+        pad(`  Target: ${result.targetPath}`, 44) +
+        '\u2551');
+    lines.push('\u2551' +
+        pad(`  Files: ${String(result.manifest.fileCount)}`, 44) +
+        '\u2551');
+    lines.push('\u2551' +
+        pad(`  Size: ${formatSize(result.manifest.totalSizeBytes)}`, 44) +
+        '\u2551');
+    if (result.archivePath !== undefined) {
+        lines.push('\u2551' +
+            pad(`  Archive: ${result.archivePath}`, 44) +
+            '\u2551');
+    }
+    lines.push('\u255A' + '\u2550'.repeat(44) + '\u255D');
+    // Self-containment checks
+    lines.push('');
+    lines.push('Self-Containment:');
+    for (const check of result.selfContainment.checks) {
+        const symbol = check.passed ? '\u2713' : '\u2717';
+        lines.push(`  ${symbol} ${check.name}`);
+    }
+    // Stages included
+    lines.push('');
+    lines.push('Stages Included:');
+    for (const stage of result.manifest.stages) {
+        const count = stage.artifactCount === 1
+            ? '1 file'
+            : `${String(stage.artifactCount)} files`;
+        lines.push(`  ${pad(stage.stageName, 18)} ${count}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Convert a delivery result to a JSON-serializable object.
+ *
+ * @param result - The delivery result
+ * @returns Plain object suitable for JSON output
+ */
+export function deliveryResultToJson(result) {
+    return {
+        runId: result.runId,
+        targetPath: result.targetPath,
+        archivePath: result.archivePath,
+        manifest: result.manifest,
+        selfContainment: result.selfContainment,
+    };
+}
+//# sourceMappingURL=formatters.js.map

package/dist/formatters.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @hstm-labs/forge-deliverer — Output packaging and delivery for Forge.
+ *
+ * Provides the {@link DeliverStage} pipeline stage, artifact merging,
+ * self-containment validation, archiving, delivery writing, and
+ * result formatting.
+ *
+ * @packageDocumentation
+ */
+export type { DeliveryResult, DeliveryManifest, DeliveryStageEntry, SelfContainmentResult, SelfContainmentCheck, DeliveryOptions, } from './types.js';
+export { DeliverStage } from './deliver-stage.js';
+export { mergeArtifacts } from './artifact-merger.js';
+export { validateSelfContainment } from './self-containment.js';
+export { createArchive } from './archiver.js';
+export { deliverToTarget } from './delivery-writer.js';
+export { formatDeliveryResult, deliveryResultToJson } from './formatters.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":"AAAA;;;;;;;;GAQG;AAEH,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @hstm-labs/forge-deliverer — Output packaging and delivery for Forge.
+ *
+ * Provides the {@link DeliverStage} pipeline stage, artifact merging,
+ * self-containment validation, archiving, delivery writing, and
+ * result formatting.
+ *
+ * @packageDocumentation
+ */
+export { DeliverStage } from './deliver-stage.js';
+export { mergeArtifacts } from './artifact-merger.js';
+export { validateSelfContainment } from './self-containment.js';
+export { createArchive } from './archiver.js';
+export { deliverToTarget } from './delivery-writer.js';
+export { formatDeliveryResult, deliveryResultToJson } from './formatters.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;;;;;;;;GAQG;AAUH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/self-containment.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Self-containment validator for the Forge delivery stage.
+ *
+ * Checks whether the staged project output is self-contained,
+ * including presence of package.json, build scripts, README,
+ * and absence of hardcoded Forge paths.
+ */
+import type { SelfContainmentResult } from './types.js';
+/**
+ * Validate that a staged project directory is self-contained.
+ *
+ * Performs the following checks (non-blocking — warnings only):
+ * 1. `package.json` exists
+ * 2. Build scripts are defined in `package.json`
+ * 3. `README.md` exists
+ * 4. No hardcoded `.forge/` paths in generated code
+ *
+ * @param stagingDir - Path to the staging directory
+ * @returns Self-containment validation result
+ */
+export declare function validateSelfContainment(stagingDir: string): SelfContainmentResult;
+//# sourceMappingURL=self-containment.d.ts.map

package/dist/self-containment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"self-containment.d.ts","sourceRoot":"","sources":["../src/self-containment.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,qBAAqB,EAAwB,MAAM,YAAY,CAAC;AAiC9E;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,GACjB,qBAAqB,CA0FvB"}

package/dist/self-containment.js

@@ -0,0 +1,134 @@
+/**
+ * Self-containment validator for the Forge delivery stage.
+ *
+ * Checks whether the staged project output is self-contained,
+ * including presence of package.json, build scripts, README,
+ * and absence of hardcoded Forge paths.
+ */
+import { join } from 'node:path';
+import { existsSync, readFileSync, readdirSync } from 'node:fs';
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+/**
+ * Recursively collect all file paths under a directory.
+ *
+ * @param dir - Directory to scan
+ * @param base - Base path for relative paths
+ * @returns Array of relative file paths
+ */
+function collectFiles(dir, base = dir) {
+    const results = [];
+    if (!existsSync(dir))
+        return results;
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...collectFiles(fullPath, base));
+        }
+        else {
+            results.push(fullPath.slice(base.length + 1));
+        }
+    }
+    return results;
+}
+// ---------------------------------------------------------------------------
+// Public API
+// ---------------------------------------------------------------------------
+/**
+ * Validate that a staged project directory is self-contained.
+ *
+ * Performs the following checks (non-blocking — warnings only):
+ * 1. `package.json` exists
+ * 2. Build scripts are defined in `package.json`
+ * 3. `README.md` exists
+ * 4. No hardcoded `.forge/` paths in generated code
+ *
+ * @param stagingDir - Path to the staging directory
+ * @returns Self-containment validation result
+ */
+export function validateSelfContainment(stagingDir) {
+    const checks = [];
+    // 1. package.json exists
+    const pkgJsonPath = join(stagingDir, 'package.json');
+    const hasPkgJson = existsSync(pkgJsonPath);
+    checks.push({
+        name: 'package.json present',
+        passed: hasPkgJson,
+        description: hasPkgJson
+            ? 'package.json found in project root'
+            : 'package.json not found — project may not be installable',
+    });
+    // 2. Build scripts defined
+    let hasBuildScripts = false;
+    if (hasPkgJson) {
+        try {
+            const pkgContent = readFileSync(pkgJsonPath, 'utf-8');
+            const pkg = JSON.parse(pkgContent);
+            if (typeof pkg === 'object' &&
+                pkg !== null &&
+                'scripts' in pkg &&
+                typeof pkg['scripts'] === 'object') {
+                const scripts = pkg['scripts'];
+                hasBuildScripts =
+                    'build' in scripts || 'start' in scripts || 'dev' in scripts;
+            }
+        }
+        catch {
+            // Malformed package.json — treat as no build scripts
+        }
+    }
+    checks.push({
+        name: 'Build scripts defined',
+        passed: hasBuildScripts,
+        description: hasBuildScripts
+            ? 'Build/start scripts found in package.json'
+            : 'No build or start scripts found in package.json',
+    });
+    // 3. README.md exists
+    const readmePath = join(stagingDir, 'README.md');
+    const hasReadme = existsSync(readmePath);
+    checks.push({
+        name: 'README.md present',
+        passed: hasReadme,
+        description: hasReadme
+            ? 'README.md found in project root'
+            : 'README.md not found — project lacks documentation',
+    });
+    // 4. No hardcoded Forge paths
+    let forgePathFound = false;
+    const files = collectFiles(stagingDir);
+    for (const filePath of files) {
+        // Only scan text-like files
+        if (filePath.endsWith('.ts') ||
+            filePath.endsWith('.js') ||
+            filePath.endsWith('.json') ||
+            filePath.endsWith('.md') ||
+            filePath.endsWith('.yml') ||
+            filePath.endsWith('.yaml')) {
+            try {
+                const content = readFileSync(join(stagingDir, filePath), 'utf-8');
+                if (content.includes('.forge/')) {
+                    forgePathFound = true;
+                    break;
+                }
+            }
+            catch {
+                // Skip unreadable files
+            }
+        }
+    }
+    checks.push({
+        name: 'No hardcoded Forge paths',
+        passed: !forgePathFound,
+        description: forgePathFound
+            ? 'References to .forge/ found in generated code'
+            : 'No hardcoded .forge/ paths detected',
+    });
+    // Self-containment is valid if core checks pass (package.json + README)
+    // Build scripts and forge paths are advisory
+    const valid = checks.every((c) => c.passed);
+    return { valid, checks };
+}
+//# sourceMappingURL=self-containment.js.map

package/dist/self-containment.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Type definitions for the Forge delivery stage.
+ *
+ * Defines the output structures for artifact packaging, self-containment
+ * validation, delivery manifests, and delivery options.
+ */
+/** Complete delivery result returned by the deliver stage. */
+export interface DeliveryResult {
+    /** Run ID. */
+    runId: string;
+    /** Target delivery path. */
+    targetPath: string;
+    /** Archive file path (if created). */
+    archivePath?: string | undefined;
+    /** Delivery manifest. */
+    manifest: DeliveryManifest;
+    /** Self-containment validation result. */
+    selfContainment: SelfContainmentResult;
+}
+/** Delivery manifest written as delivery.json. */
+export interface DeliveryManifest {
+    /** Run ID. */
+    runId: string;
+    /** ISO timestamp. */
+    deliveredAt: string;
+    /** Total files delivered. */
+    fileCount: number;
+    /** Total size in bytes. */
+    totalSizeBytes: number;
+    /** Stage artifacts included. */
+    stages: DeliveryStageEntry[];
+    /** Forge version. */
+    forgeVersion: string;
+}
+/** Entry for a single stage in the delivery manifest. */
+export interface DeliveryStageEntry {
+    /** Stage name. */
+    stageName: string;
+    /** Number of artifacts from this stage. */
+    artifactCount: number;
+    /** Artifact file paths (relative). */
+    files: string[];
+}
+/** Result of self-containment validation checks. */
+export interface SelfContainmentResult {
+    /** Whether the project passes self-containment checks. */
+    valid: boolean;
+    /** Checks performed. */
+    checks: SelfContainmentCheck[];
+}
+/** A single self-containment check result. */
+export interface SelfContainmentCheck {
+    /** Check name. */
+    name: string;
+    /** Whether this check passed. */
+    passed: boolean;
+    /** Description of what was checked. */
+    description: string;
+}
+/** Options controlling delivery behavior. */
+export interface DeliveryOptions {
+    /** Target directory for delivery (overrides config). */
+    target?: string | undefined;
+    /** Skip verification check. */
+    skipVerify?: boolean | undefined;
+    /** Create archive (tgz). */
+    archive?: boolean | undefined;
+    /** Archive format. */
+    archiveFormat?: 'tgz' | 'zip' | undefined;
+}
+//# 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;;;;;GAKG;AAMH,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,4BAA4B;IAC5B,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,yBAAyB;IACzB,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,0CAA0C;IAC1C,eAAe,EAAE,qBAAqB,CAAC;CACxC;AAMD,kDAAkD;AAClD,MAAM,WAAW,gBAAgB;IAC/B,cAAc;IACd,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,2BAA2B;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,gCAAgC;IAChC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,qBAAqB;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,yDAAyD;AACzD,MAAM,WAAW,kBAAkB;IACjC,kBAAkB;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,sCAAsC;IACtC,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAMD,oDAAoD;AACpD,MAAM,WAAW,qBAAqB;IACpC,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,wBAAwB;IACxB,MAAM,EAAE,oBAAoB,EAAE,CAAC;CAChC;AAED,8CAA8C;AAC9C,MAAM,WAAW,oBAAoB;IACnC,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,iCAAiC;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,+BAA+B;IAC/B,UAAU,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IACjC,4BAA4B;IAC5B,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,sBAAsB;IACtB,aAAa,CAAC,EAAE,KAAK,GAAG,KAAK,GAAG,SAAS,CAAC;CAC3C"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for the Forge delivery stage.
+ *
+ * Defines the output structures for artifact packaging, self-containment
+ * validation, delivery manifests, and delivery options.
+ */
+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;;;;;GAKG"}

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@hstm-labs/forge-deliverer",
+  "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"
+  }
+}