@llm-dev-ops/agentics-cli 1.4.27 → 1.4.32

package/dist/pipeline/phase4/types.d.ts

@@ -0,0 +1,269 @@
+/**
+ * Phase 4 Pipeline Type Definitions
+ *
+ * Complete type system for the Phase 4 pipeline: Phase 3 artifact validation,
+ * ERP target resolution, schema generation, infrastructure adapter generation,
+ * HTTP server generation, ERP client generation, deployment generation,
+ * metadata augmentation, and manifest writing.
+ *
+ * All types are designed for strict TypeScript (strict: true, ES2022 target,
+ * NodeNext modules). Interfaces use readonly fields throughout.
+ */
+import type { Phase2SPARCOutput, Phase2ADRRecord, Phase2DomainModel, TDDPlan, TelemetrySpan, Phase2Manifest } from '../phase2/types.js';
+import type { Phase3Manifest, ImplementationLanguage, Phase2Artifacts } from '../phase3/types.js';
+import type { ERPSystem, DatabaseEngine, SQLDialect } from '../../deps/erp-database-map.js';
+export type { Phase2SPARCOutput, Phase2ADRRecord, Phase2DomainModel, TDDPlan, TelemetrySpan, Phase2Manifest, Phase3Manifest, ImplementationLanguage, Phase2Artifacts, ERPSystem, DatabaseEngine, SQLDialect, };
+/**
+ * Aggregated set of Phase 3 artifacts consumed by the Phase 4 pipeline.
+ * Each field corresponds to a JSON file written by Phase 3.
+ */
+export interface Phase3Artifacts {
+    /** The Phase 3 manifest loaded from phase3-manifest.json. */
+    readonly manifest: Phase3Manifest;
+    /** The resolved implementation language for the project. */
+    readonly implementationLanguage: ImplementationLanguage;
+    /** Absolute path to the Phase 3 project output directory. */
+    readonly projectDir: string;
+    /** The Phase 2 artifacts that were consumed by Phase 3. */
+    readonly phase2Artifacts: Phase2Artifacts;
+}
+/**
+ * The resolved ERP system and associated database details for Phase 4.
+ * Aggregates all detection signals into a final integration decision.
+ */
+export interface ERPResolution {
+    /** The detected ERP system. */
+    readonly erpSystem: ERPSystem;
+    /** The primary database engine associated with the ERP system, or null for API-only ERPs. */
+    readonly databaseEngine: DatabaseEngine | null;
+    /** The SQL dialect associated with the database engine, or null for API-only ERPs. */
+    readonly sqlDialect: SQLDialect | null;
+    /** Whether the ERP system is accessed via API only (no direct database access). */
+    readonly apiOnly: boolean;
+    /** The source pipeline artifact that provided the strongest detection signal. */
+    readonly detectionSource: 'scenario-query' | 'sparc-services' | 'dossier-items' | 'adr-context';
+    /** Confidence in the ERP resolution (0.0 - 1.0). */
+    readonly confidence: number;
+    /** Named integration points between the project and the ERP system. */
+    readonly integrationPoints: string[];
+    /** Constraints imposed by the ERP system on the integration design. */
+    readonly constraints: string[];
+}
+/**
+ * A single file produced by a Phase 4 generation stage.
+ */
+export interface GeneratedFile {
+    /** Path relative to the Phase 4 output directory. */
+    readonly relativePath: string;
+    /** The full text content of the generated file. */
+    readonly content: string;
+    /** The category or purpose of this file (e.g. 'schema', 'adapter', 'server'). */
+    readonly kind: string;
+}
+/**
+ * A generated database schema file for a specific SQL dialect and bounded context.
+ */
+export interface SchemaFile extends GeneratedFile {
+    /** The SQL dialect this schema is written in. */
+    readonly dialect: SQLDialect;
+    /** The DDD bounded context this schema covers. */
+    readonly boundedContext: string;
+    /** The number of tables defined in this schema file. */
+    readonly tableCount: number;
+}
+/**
+ * A generated infrastructure adapter file bridging a DDD port to an ERP system.
+ */
+export interface AdapterFile extends GeneratedFile {
+    /** The DDD bounded context this adapter belongs to. */
+    readonly boundedContext: string;
+    /** The port interface this adapter implements. */
+    readonly portInterface: string;
+}
+/**
+ * A generated HTTP server file (routes, handlers, middleware).
+ */
+export interface ServerFile extends GeneratedFile {
+}
+/**
+ * A generated ERP API client file.
+ */
+export interface ClientFile extends GeneratedFile {
+}
+/**
+ * A generated deployment configuration file (Cloud Run, Dockerfile, etc.).
+ */
+export interface DeploymentFile extends GeneratedFile {
+}
+/**
+ * Output of the schema generation stage.
+ */
+export interface SchemaGenOutput {
+    /** The SQL dialect used for schema generation, or null if skipped. */
+    readonly dialect: SQLDialect | null;
+    /** All generated schema files. */
+    readonly files: SchemaFile[];
+    /** Total number of tables across all schema files. */
+    readonly tableCount: number;
+    /** Whether schema generation was skipped (e.g. API-only ERP). */
+    readonly skipped: boolean;
+    /** Human-readable reason why schema generation was skipped, if applicable. */
+    readonly skipReason?: string;
+}
+/**
+ * Output of the infrastructure adapter generation stage.
+ */
+export interface InfraAdapterOutput {
+    /** All generated adapter files. */
+    readonly adapters: AdapterFile[];
+    /** Total number of adapters generated. */
+    readonly totalAdapters: number;
+    /** Serialised connection pool configuration used across all adapters. */
+    readonly connectionPoolConfig: string;
+}
+/**
+ * Output of the HTTP server generation stage.
+ */
+export interface HttpServerOutput {
+    /** The HTTP framework used for code generation. */
+    readonly framework: 'hono' | 'axum';
+    /** All generated server files. */
+    readonly files: ServerFile[];
+    /** Total number of routes registered across all server files. */
+    readonly routeCount: number;
+}
+/**
+ * Output of the ERP client generation stage.
+ */
+export interface ERPClientOutput {
+    /** All generated ERP client files. */
+    readonly files: ClientFile[];
+    /** Total number of ERP API endpoints covered by the generated clients. */
+    readonly endpointCount: number;
+}
+/**
+ * Output of the deployment configuration generation stage.
+ */
+export interface DeploymentOutput {
+    /** All generated deployment files. */
+    readonly files: DeploymentFile[];
+    /** Name of the Cloud Run service defined in the generated configuration. */
+    readonly cloudRunService: string;
+}
+/**
+ * A runtime Architecture Decision Record created during the metadata
+ * augmentation stage to document Phase 4 integration decisions.
+ */
+export interface RuntimeDecision {
+    /** Unique identifier for this runtime decision. */
+    readonly id: string;
+    /** Short descriptive title. */
+    readonly title: string;
+    /** Background and forces that led to this decision. */
+    readonly context: string;
+    /** The decision that was made. */
+    readonly decision: string;
+    /** Explanation of why this decision was chosen over alternatives. */
+    readonly rationale: string;
+}
+/**
+ * Output of the metadata augmentation stage.
+ */
+export interface MetadataAugmentOutput {
+    /** Number of existing Phase 2/3 ADRs augmented with Phase 4 context. */
+    readonly augmentedADRCount: number;
+    /** New runtime decisions recorded during Phase 4 execution. */
+    readonly runtimeDecisions: RuntimeDecision[];
+}
+/** The stages that the Phase 4 pipeline executes in order. */
+export type Phase4Stage = 'phase3-validation' | 'erp-target-resolution' | 'schema-generation' | 'infra-adapter-generation' | 'http-server-generation' | 'erp-client-generation' | 'deployment-generation' | 'metadata-augmentation' | 'manifest-writing';
+/** Output produced by a single Phase 4 pipeline stage. */
+export interface Phase4StageOutput {
+    /** The stage that produced this output. */
+    readonly stage: Phase4Stage;
+    /** Whether the stage completed successfully or failed. */
+    readonly status: 'completed' | 'failed';
+    /** Stage-specific output data. */
+    readonly data: unknown;
+    /** Paths to artifacts written by this stage. */
+    readonly artifacts: string[];
+    /** Wall-clock time in milliseconds for this stage. */
+    readonly timing: number;
+    /** Human-readable summary of what the stage accomplished. */
+    readonly summary: string;
+}
+/**
+ * Mutable pipeline context threaded through all Phase 4 stages.
+ * Accumulates stage outputs and telemetry as the pipeline progresses.
+ */
+export interface Phase4Context {
+    /** Unique trace identifier for this pipeline run. */
+    readonly traceId: string;
+    /** Absolute path to the Phase 2 output directory. */
+    readonly phase2Dir: string;
+    /** Absolute path to the Phase 3 output directory. */
+    readonly phase3Dir: string;
+    /** Absolute path to the Phase 4 output directory. */
+    readonly phase4Dir: string;
+    /** The original scenario query driving this pipeline run. */
+    readonly scenarioQuery: string;
+    /** Phase 3 artifacts loaded from disk. */
+    readonly phase3Artifacts: Phase3Artifacts;
+    /** Absolute paths to platform repository roots, keyed by repository name. */
+    readonly platformRepoPaths: Record<string, string>;
+    /** Accumulated stage outputs keyed by stage name. */
+    readonly stageOutputs: Map<Phase4Stage, Phase4StageOutput>;
+    /** Telemetry spans collected during pipeline execution. */
+    readonly telemetrySpans: TelemetrySpan[];
+}
+/** A hashed artifact reference in the Phase 4 manifest. */
+export interface Phase4ManifestArtifact {
+    /** Relative path to the artifact file. */
+    readonly path: string;
+    /** SHA-256 hash of the artifact contents. */
+    readonly sha256: string;
+    /** Size of the artifact file in bytes. */
+    readonly size_bytes: number;
+}
+/**
+ * The Phase 4 manifest written to disk at the end of a successful run.
+ * Provides a complete record of the ERP target, database engine, all
+ * artifacts, and total timing.
+ */
+export interface Phase4Manifest {
+    /** Schema version for this manifest format. */
+    readonly schema_version: '4.0.0';
+    /** Unique trace identifier for this pipeline run. */
+    readonly trace_id: string;
+    /** The resolved implementation language. */
+    readonly implementation_language: ImplementationLanguage;
+    /** The resolved ERP system identifier. */
+    readonly erp_system: string;
+    /** The resolved database engine identifier, or null for API-only ERPs. */
+    readonly database_engine: string | null;
+    /** Whether the ERP system is accessed via API only. */
+    readonly api_only: boolean;
+    /** All artifacts produced by the pipeline. */
+    readonly artifacts: Phase4ManifestArtifact[];
+    /** Total wall-clock time in milliseconds for the entire pipeline. */
+    readonly total_timing_ms: number;
+    /** Whether the pipeline completed successfully. */
+    readonly success: boolean;
+}
+/**
+ * The final result returned by the Phase 4 pipeline after all stages
+ * have completed (or the first stage has failed).
+ */
+export interface Phase4PipelineResult {
+    /** Unique trace identifier for this pipeline run. */
+    readonly traceId: string;
+    /** Absolute path to the Phase 4 output directory. */
+    readonly phase4Dir: string;
+    /** The manifest written at the end of the pipeline. */
+    readonly manifest: Phase4Manifest;
+    /** Ordered list of stage outputs from the pipeline run. */
+    readonly stageResults: Phase4StageOutput[];
+    /** Total wall-clock time in milliseconds for the entire pipeline. */
+    readonly totalTiming: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/pipeline/phase4/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase4/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,aAAa,EACb,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EACV,cAAc,EACd,sBAAsB,EACtB,eAAe,EAChB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EACV,SAAS,EACT,cAAc,EACd,UAAU,EACX,MAAM,gCAAgC,CAAC;AAExC,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,OAAO,EACP,aAAa,EACb,cAAc,EACd,cAAc,EACd,sBAAsB,EACtB,eAAe,EACf,SAAS,EACT,cAAc,EACd,UAAU,GACX,CAAC;AAMF;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,4DAA4D;IAC5D,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB,CAAC;IACxD,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,2DAA2D;IAC3D,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;CAC3C;AAMD;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,+BAA+B;IAC/B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,6FAA6F;IAC7F,QAAQ,CAAC,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IAC/C,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IACvC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,iFAAiF;IACjF,QAAQ,CAAC,eAAe,EAAE,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,GAAG,aAAa,CAAC;IAChG,oDAAoD;IACpD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uEAAuE;IACvE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC;CAChC;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,aAAa;IAC/C,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,kDAAkD;IAClD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,wDAAwD;IACxD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,aAAa;IAChD,uDAAuD;IACvD,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,kDAAkD;IAClD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,aAAa;CAAG;AAEpD;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,aAAa;CAAG;AAEpD;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,aAAa;CAAG;AAMxD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,iEAAiE;IACjE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mCAAmC;IACnC,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC;IACjC,0CAA0C;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,yEAAyE;IACzE,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAAC;IACpC,kCAAkC;IAClC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAC7B,iEAAiE;IACjE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,UAAU,EAAE,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,sCAAsC;IACtC,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAC;IACjC,4EAA4E;IAC5E,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,mDAAmD;IACnD,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,+DAA+D;IAC/D,QAAQ,CAAC,gBAAgB,EAAE,eAAe,EAAE,CAAC;CAC9C;AAMD,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GACnB,mBAAmB,GACnB,uBAAuB,GACvB,mBAAmB,GACnB,0BAA0B,GAC1B,wBAAwB,GACxB,uBAAuB,GACvB,uBAAuB,GACvB,uBAAuB,GACvB,kBAAkB,CAAC;AAEvB,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IACxC,kCAAkC;IAClC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,6DAA6D;IAC7D,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,0CAA0C;IAC1C,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAC;IAC1C,6EAA6E;IAC7E,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,qDAAqD;IACrD,QAAQ,CAAC,YAAY,EAAE,GAAG,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC;IAC3D,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,EAAE,aAAa,EAAE,CAAC;CAC1C;AAMD,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,+CAA+C;IAC/C,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,4CAA4C;IAC5C,QAAQ,CAAC,uBAAuB,EAAE,sBAAsB,CAAC;IACzD,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,8CAA8C;IAC9C,QAAQ,CAAC,SAAS,EAAE,sBAAsB,EAAE,CAAC;IAC7C,qEAAqE;IACrE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,mDAAmD;IACnD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAMD;;;GAGG;AACH,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAC3C,qEAAqE;IACrE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/pipeline/phase4/types.js

@@ -0,0 +1,13 @@
+/**
+ * Phase 4 Pipeline Type Definitions
+ *
+ * Complete type system for the Phase 4 pipeline: Phase 3 artifact validation,
+ * ERP target resolution, schema generation, infrastructure adapter generation,
+ * HTTP server generation, ERP client generation, deployment generation,
+ * metadata augmentation, and manifest writing.
+ *
+ * All types are designed for strict TypeScript (strict: true, ES2022 target,
+ * NodeNext modules). Interfaces use readonly fields throughout.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/pipeline/phase4/types.js.map

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

package/dist/pipeline/phase4-adrs/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Phase 4 Pipeline — Public API (ADRs + DDDs)
+ *
+ * Generates Architecture Decision Records and Domain-Driven Design models
+ * from Phase 2 research dossier and Phase 3 SPARC + TDD output.
+ *
+ * Usage:
+ *   import { executePhase4ADRPipeline } from './pipeline/phase4-adrs/index.js';
+ *   const result = await executePhase4ADRPipeline(context);
+ */
+export { executePhase4ADRPipeline } from './phase4-adrs-coordinator.js';
+export type { Phase4ADRContext, Phase4ADRPipelineResult, Phase4ADRStage, Phase4ADRManifest, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/pipeline/phase4-adrs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase4-adrs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC;AAExE,YAAY,EACV,gBAAgB,EAChB,uBAAuB,EACvB,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/pipeline/phase4-adrs/index.js

@@ -0,0 +1,12 @@
+/**
+ * Phase 4 Pipeline — Public API (ADRs + DDDs)
+ *
+ * Generates Architecture Decision Records and Domain-Driven Design models
+ * from Phase 2 research dossier and Phase 3 SPARC + TDD output.
+ *
+ * Usage:
+ *   import { executePhase4ADRPipeline } from './pipeline/phase4-adrs/index.js';
+ *   const result = await executePhase4ADRPipeline(context);
+ */
+export { executePhase4ADRPipeline } from './phase4-adrs-coordinator.js';
+//# sourceMappingURL=index.js.map

package/dist/pipeline/phase4-adrs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/pipeline/phase4-adrs/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/pipeline/phase4-adrs/manifest-writer.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Phase 4 ADR Manifest Writer
+ *
+ * Walks the phase4/ directory tree, computes SHA-256 checksums for every file,
+ * and writes phase4-manifest.json with full artifact inventory.
+ *
+ * Follows the atomic write + checksum pattern from the Phase 3 manifest writer,
+ * adapted for Phase 4 fields:
+ *   - schema_version: '4.0.0'
+ *   - success (derived from stage results)
+ *
+ * Exports:
+ *   - writePhase4ADRManifest() — builds and writes the manifest
+ */
+import type { Phase4ADRManifest } from './types.js';
+import type { Phase2StageOutput } from '../phase2/types.js';
+/**
+ * Build and write the Phase 4 manifest to `phase4-manifest.json`.
+ *
+ * Walks the Phase 4 output directory, checksums every artifact, and produces
+ * a manifest with full provenance (trace id, stage results, timing, and
+ * per-file SHA-256 hashes).
+ *
+ * @param phase4Dir    - Root output directory for Phase 4 artifacts
+ * @param traceId      - Trace identifier linking pipeline phases
+ * @param stages       - Outputs from each completed Phase 4 stage
+ * @param totalTimingMs - Wall-clock milliseconds for the entire Phase 4 run
+ * @returns The fully-populated manifest object
+ */
+export declare function writePhase4ADRManifest(phase4Dir: string, traceId: string, stages: Phase2StageOutput[], totalTimingMs: number): Phase4ADRManifest;
+//# sourceMappingURL=manifest-writer.d.ts.map

package/dist/pipeline/phase4-adrs/manifest-writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest-writer.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase4-adrs/manifest-writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAA6C,MAAM,YAAY,CAAC;AAC/F,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AA6D5D;;;;;;;;;;;;GAYG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,iBAAiB,EAAE,EAC3B,aAAa,EAAE,MAAM,GACpB,iBAAiB,CAuBnB"}

package/dist/pipeline/phase4-adrs/manifest-writer.js

@@ -0,0 +1,105 @@
+/**
+ * Phase 4 ADR Manifest Writer
+ *
+ * Walks the phase4/ directory tree, computes SHA-256 checksums for every file,
+ * and writes phase4-manifest.json with full artifact inventory.
+ *
+ * Follows the atomic write + checksum pattern from the Phase 3 manifest writer,
+ * adapted for Phase 4 fields:
+ *   - schema_version: '4.0.0'
+ *   - success (derived from stage results)
+ *
+ * Exports:
+ *   - writePhase4ADRManifest() — builds and writes the manifest
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as crypto from 'node:crypto';
+// ============================================================================
+// Constants
+// ============================================================================
+const FILE_MODE = 0o600;
+const MANIFEST_FILENAME = 'phase4-manifest.json';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Compute a SHA-256 hex digest of a file on disk.
+ *
+ * @param filePath - Absolute path to the file
+ * @returns Lowercase hex SHA-256 checksum
+ */
+function computeChecksum(filePath) {
+    const content = fs.readFileSync(filePath);
+    return crypto.createHash('sha256').update(content).digest('hex');
+}
+/**
+ * Recursively collect all files under `dir`, computing a checksum and size
+ * for each. Paths are stored relative to `baseDir`. The manifest file itself
+ * is excluded since it is written after collection.
+ *
+ * @param dir  - Directory to walk
+ * @param base - Root directory for computing relative paths
+ * @returns Array of artifact entries
+ */
+function walkDir(dir, base) {
+    const results = [];
+    if (!fs.existsSync(dir))
+        return results;
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results.push(...walkDir(fullPath, base));
+        }
+        else if (entry.isFile() && entry.name !== MANIFEST_FILENAME) {
+            const stat = fs.statSync(fullPath);
+            results.push({
+                path: path.relative(base, fullPath),
+                sha256: computeChecksum(fullPath),
+                size_bytes: stat.size,
+            });
+        }
+    }
+    // Sort by path for deterministic output
+    results.sort((a, b) => a.path.localeCompare(b.path));
+    return results;
+}
+// ============================================================================
+// Main
+// ============================================================================
+/**
+ * Build and write the Phase 4 manifest to `phase4-manifest.json`.
+ *
+ * Walks the Phase 4 output directory, checksums every artifact, and produces
+ * a manifest with full provenance (trace id, stage results, timing, and
+ * per-file SHA-256 hashes).
+ *
+ * @param phase4Dir    - Root output directory for Phase 4 artifacts
+ * @param traceId      - Trace identifier linking pipeline phases
+ * @param stages       - Outputs from each completed Phase 4 stage
+ * @param totalTimingMs - Wall-clock milliseconds for the entire Phase 4 run
+ * @returns The fully-populated manifest object
+ */
+export function writePhase4ADRManifest(phase4Dir, traceId, stages, totalTimingMs) {
+    const artifacts = walkDir(phase4Dir, phase4Dir);
+    const manifest = {
+        schema_version: '4.0.0',
+        trace_id: traceId,
+        generated_at: new Date().toISOString(),
+        pipeline_version: '1.0.0',
+        stages: stages.map(s => ({
+            stage: s.stage,
+            status: s.status,
+            timing_ms: s.timing,
+            artifact_count: s.artifacts.length,
+        })),
+        artifacts,
+        total_timing_ms: totalTimingMs,
+        success: stages.every(s => s.status === 'completed'),
+    };
+    const manifestPath = path.join(phase4Dir, MANIFEST_FILENAME);
+    fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), { encoding: 'utf-8', mode: FILE_MODE });
+    return manifest;
+}
+//# sourceMappingURL=manifest-writer.js.map

package/dist/pipeline/phase4-adrs/manifest-writer.js.map

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

package/dist/pipeline/phase4-adrs/phase4-adrs-coordinator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Phase 4 Pipeline Coordinator (ADRs + DDDs)
+ *
+ * Orchestrates the 3-stage Phase 4 pipeline:
+ *   1. Prior Phase Loading — Load research dossier + SPARC + TDD from disk
+ *   2. ADR Generation — Architecture Decision Records citing SPARC + dossier
+ *   3. DDD Model Generation — Bounded contexts, aggregates, ubiquitous language
+ *
+ * Reuses the existing ADR and DDD generators from the Phase 2 pipeline by
+ * constructing a Phase2Context with phase2Dir pointing to the phase4/ output
+ * directory and pre-populating stageOutputs with data loaded from prior phases.
+ */
+import type { Phase4ADRContext, Phase4ADRPipelineResult } from './types.js';
+/**
+ * Execute the Phase 4 ADR + DDD pipeline.
+ *
+ * Loads prior-phase artifacts from disk, then delegates to the existing
+ * ADR and DDD generators from the Phase 2 pipeline. All output is written
+ * to the phase4/ directory.
+ *
+ * @param context - Phase 4 pipeline context with directory paths and trace ID
+ * @returns Pipeline result with manifest, stage outputs, and timing
+ */
+export declare function executePhase4ADRPipeline(context: Phase4ADRContext): Promise<Phase4ADRPipelineResult>;
+//# sourceMappingURL=phase4-adrs-coordinator.d.ts.map

package/dist/pipeline/phase4-adrs/phase4-adrs-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase4-adrs-coordinator.d.ts","sourceRoot":"","sources":["../../../src/pipeline/phase4-adrs/phase4-adrs-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAkB,MAAM,YAAY,CAAC;AAiE5F;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,gBAAgB,GACxB,OAAO,CAAC,uBAAuB,CAAC,CAiPlC"}