@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

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

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