@evolith/core-domain 1.0.0

package/dist/domain/entities/blueprint.d.ts

@@ -0,0 +1,41 @@
+import { ArtifactState } from '../lifecycle/artifact-state-machine';
+import { VerdictRecord } from '../verdict/verdict';
+export interface BlueprintContent {
+    rulesets: string[];
+    topologyId: string;
+    gateIds: string[];
+    requiredArtifacts: string[];
+    customPolicies?: string[];
+}
+export interface Blueprint {
+    readonly id: string;
+    readonly tenantId: string;
+    readonly topology: string;
+    readonly phase: string;
+    readonly version: string;
+    readonly createdAt: string;
+    state: ArtifactState;
+    readonly content: BlueprintContent;
+    readonly verdictHistory: VerdictRecord[];
+}
+export declare class BlueprintBuilder {
+    private _id;
+    private _tenantId;
+    private _topology;
+    private _phase;
+    private _version;
+    private _rulesets;
+    private _gateIds;
+    private _requiredArtifacts;
+    private _customPolicies?;
+    setId(id: string): this;
+    setTenantId(tenantId: string): this;
+    setTopology(topology: string): this;
+    setPhase(phase: string): this;
+    setVersion(version: string): this;
+    addRuleset(ruleset: string): this;
+    addGate(gateId: string): this;
+    addRequiredArtifact(artifact: string): this;
+    addCustomPolicy(policy: string): this;
+    build(): Blueprint;
+}

package/dist/domain/entities/blueprint.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlueprintBuilder = void 0;
+const artifact_state_machine_1 = require("../lifecycle/artifact-state-machine");
+class BlueprintBuilder {
+    constructor() {
+        this._id = `bp-${Date.now().toString(36)}`;
+        this._tenantId = '';
+        this._topology = '';
+        this._phase = '';
+        this._version = '1.0.0';
+        this._rulesets = [];
+        this._gateIds = [];
+        this._requiredArtifacts = [];
+    }
+    setId(id) {
+        this._id = id;
+        return this;
+    }
+    setTenantId(tenantId) {
+        this._tenantId = tenantId;
+        return this;
+    }
+    setTopology(topology) {
+        this._topology = topology;
+        return this;
+    }
+    setPhase(phase) {
+        this._phase = phase;
+        return this;
+    }
+    setVersion(version) {
+        this._version = version;
+        return this;
+    }
+    addRuleset(ruleset) {
+        this._rulesets.push(ruleset);
+        return this;
+    }
+    addGate(gateId) {
+        this._gateIds.push(gateId);
+        return this;
+    }
+    addRequiredArtifact(artifact) {
+        this._requiredArtifacts.push(artifact);
+        return this;
+    }
+    addCustomPolicy(policy) {
+        if (!this._customPolicies)
+            this._customPolicies = [];
+        this._customPolicies.push(policy);
+        return this;
+    }
+    build() {
+        if (!this._tenantId)
+            throw new Error('BlueprintBuilder: tenantId is required');
+        if (!this._topology)
+            throw new Error('BlueprintBuilder: topology is required');
+        if (!this._phase)
+            throw new Error('BlueprintBuilder: phase is required');
+        const content = {
+            rulesets: [...this._rulesets],
+            topologyId: this._topology,
+            gateIds: [...this._gateIds],
+            requiredArtifacts: [...this._requiredArtifacts],
+            ...(this._customPolicies ? { customPolicies: [...this._customPolicies] } : {}),
+        };
+        return {
+            id: this._id,
+            tenantId: this._tenantId,
+            topology: this._topology,
+            phase: this._phase,
+            version: this._version,
+            createdAt: new Date().toISOString(),
+            state: artifact_state_machine_1.ArtifactState.DRAFT,
+            content,
+            verdictHistory: [],
+        };
+    }
+}
+exports.BlueprintBuilder = BlueprintBuilder;
+//# sourceMappingURL=blueprint.js.map

package/dist/domain/entities/blueprint.js.map

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

package/dist/domain/entities/index.d.ts

@@ -0,0 +1,73 @@
+export * from './blueprint';
+import { Runtime, MonorepoOption, ArchitecturePattern, GateCheck } from '../interfaces';
+export declare class Phase {
+    readonly value: string;
+    readonly label: string;
+    readonly description: string;
+    readonly gateChecks: GateCheck[];
+    readonly artifacts: string[];
+    readonly order: number;
+    constructor(value: string, label: string, description: string, gateChecks: GateCheck[], artifacts: string[], order: number);
+    canTransitionTo(other: Phase): boolean;
+    static fromValue(value: string, phases: Phase[]): Phase | undefined;
+    static readonly ORDER: Record<string, number>;
+}
+export declare class Project {
+    readonly id: string;
+    phase: string;
+    readonly createdAt: Date;
+    config: ProjectConfigData;
+    constructor(name: string, runtime: Runtime, monorepo: MonorepoOption, architecture: ArchitecturePattern, phase?: string);
+    private generateId;
+    transitionTo(phase: string): void;
+    setConfig(key: keyof ProjectConfigData, value: unknown): void;
+    getConfig(): Readonly<ProjectConfigData>;
+    isPhase(phase: string): boolean;
+}
+export interface ProjectConfigData {
+    name: string;
+    runtimeId: string;
+    monorepoId: string;
+    architectureId: string;
+    database: string;
+    apiProtocol: string;
+    ciCd: string;
+    observability: string;
+    tools: string[];
+    agents: string[];
+}
+export declare class Tool {
+    readonly id: string;
+    readonly name: string;
+    readonly category: string;
+    readonly phase: string;
+    readonly isRuntimeAware: boolean;
+    readonly commands: string[];
+    readonly platformCheck?: string | undefined;
+    constructor(id: string, name: string, category: string, phase: string, isRuntimeAware: boolean, commands: string[], platformCheck?: string | undefined);
+    requiresPlatformCheck(): boolean;
+}
+export declare class TransitionResult {
+    readonly success: boolean;
+    readonly fromPhase: string;
+    readonly toPhase: string;
+    readonly gateResults: GateResult[];
+    readonly executedTools: string[];
+    readonly warnings: string[];
+    readonly errors: string[];
+    constructor(success: boolean, fromPhase: string, toPhase: string, gateResults: GateResult[], executedTools: string[], warnings: string[], errors: string[]);
+    static success(from: string, to: string, gates: GateResult[], tools: string[]): TransitionResult;
+    static failure(from: string, to: string, gates: GateResult[], errors: string[]): TransitionResult;
+    hasBlockingErrors(): boolean;
+    hasRequiredGateFailures(): boolean;
+}
+export declare class GateResult {
+    readonly id: string;
+    readonly passed: boolean;
+    readonly description: string;
+    readonly required: boolean;
+    readonly error?: string | undefined;
+    constructor(id: string, passed: boolean, description: string, required: boolean, error?: string | undefined);
+    static pass(id: string, description: string, required: boolean): GateResult;
+    static fail(id: string, description: string, required: boolean, error: string): GateResult;
+}

package/dist/domain/entities/index.js

@@ -0,0 +1,134 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GateResult = exports.TransitionResult = exports.Tool = exports.Project = exports.Phase = void 0;
+__exportStar(require("./blueprint"), exports);
+class Phase {
+    constructor(value, label, description, gateChecks, artifacts, order) {
+        this.value = value;
+        this.label = label;
+        this.description = description;
+        this.gateChecks = gateChecks;
+        this.artifacts = artifacts;
+        this.order = order;
+    }
+    canTransitionTo(other) {
+        return other.order === this.order + 1;
+    }
+    static fromValue(value, phases) {
+        return phases.find(p => p.value === value);
+    }
+}
+exports.Phase = Phase;
+Phase.ORDER = {
+    'phase-0': 0,
+    'phase-1': 1,
+    'phase-2': 2,
+    'phase-3': 3,
+    'phase-4': 4,
+    'phase-5': 5,
+};
+class Project {
+    constructor(name, runtime, monorepo, architecture, phase = 'phase-0') {
+        this.id = this.generateId(name);
+        this.phase = phase;
+        this.createdAt = new Date();
+        this.config = {
+            name,
+            runtimeId: runtime.id,
+            monorepoId: monorepo.id,
+            architectureId: architecture.id,
+            database: 'postgresql',
+            apiProtocol: 'rest',
+            ciCd: 'github',
+            observability: 'otel',
+            tools: [],
+            agents: [],
+        };
+    }
+    generateId(name) {
+        return `${name}-${Date.now().toString(36)}`;
+    }
+    transitionTo(phase) {
+        this.phase = phase;
+    }
+    setConfig(key, value) {
+        this.config[key] = value;
+    }
+    getConfig() {
+        return { ...this.config };
+    }
+    isPhase(phase) {
+        return this.phase === phase;
+    }
+}
+exports.Project = Project;
+class Tool {
+    constructor(id, name, category, phase, isRuntimeAware, commands, platformCheck) {
+        this.id = id;
+        this.name = name;
+        this.category = category;
+        this.phase = phase;
+        this.isRuntimeAware = isRuntimeAware;
+        this.commands = commands;
+        this.platformCheck = platformCheck;
+    }
+    requiresPlatformCheck() {
+        return !!this.platformCheck;
+    }
+}
+exports.Tool = Tool;
+class TransitionResult {
+    constructor(success, fromPhase, toPhase, gateResults, executedTools, warnings, errors) {
+        this.success = success;
+        this.fromPhase = fromPhase;
+        this.toPhase = toPhase;
+        this.gateResults = gateResults;
+        this.executedTools = executedTools;
+        this.warnings = warnings;
+        this.errors = errors;
+    }
+    static success(from, to, gates, tools) {
+        return new TransitionResult(true, from, to, gates, tools, [], []);
+    }
+    static failure(from, to, gates, errors) {
+        return new TransitionResult(false, from, to, gates, [], [], errors);
+    }
+    hasBlockingErrors() {
+        return this.errors.length > 0;
+    }
+    hasRequiredGateFailures() {
+        return this.gateResults.some(g => !g.passed && g.required);
+    }
+}
+exports.TransitionResult = TransitionResult;
+class GateResult {
+    constructor(id, passed, description, required, error) {
+        this.id = id;
+        this.passed = passed;
+        this.description = description;
+        this.required = required;
+        this.error = error;
+    }
+    static pass(id, description, required) {
+        return new GateResult(id, true, description, required);
+    }
+    static fail(id, description, required, error) {
+        return new GateResult(id, false, description, required, error);
+    }
+}
+exports.GateResult = GateResult;
+//# sourceMappingURL=index.js.map

package/dist/domain/entities/index.js.map

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

package/dist/domain/errors/gate-authorization.error.d.ts

@@ -0,0 +1,9 @@
+import { Role } from '../rbac/role';
+import { EvolithError } from './index';
+export declare class GateAuthorizationError extends EvolithError {
+    readonly gateId: string;
+    readonly action: 'approve' | 'waive';
+    readonly required: Role;
+    readonly actual: Role[];
+    constructor(gateId: string, action: 'approve' | 'waive', required: Role, actual: Role[]);
+}

package/dist/domain/errors/gate-authorization.error.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GateAuthorizationError = void 0;
+const index_1 = require("./index");
+class GateAuthorizationError extends index_1.EvolithError {
+    constructor(gateId, action, required, actual) {
+        super(`Actor is not authorized to ${action} gate "${gateId}": ` +
+            `required role "${required}", actor holds [${actual.join(', ') || 'none'}]`, 'GATE_AUTHORIZATION_ERROR', { gateId, action, required, actual });
+        this.gateId = gateId;
+        this.action = action;
+        this.required = required;
+        this.actual = actual;
+        this.name = 'GateAuthorizationError';
+    }
+}
+exports.GateAuthorizationError = GateAuthorizationError;
+//# sourceMappingURL=gate-authorization.error.js.map

package/dist/domain/errors/gate-authorization.error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-authorization.error.js","sourceRoot":"","sources":["../../../src/domain/errors/gate-authorization.error.ts"],"names":[],"mappings":";;;AACA,mCAAuC;AAMvC,MAAa,sBAAuB,SAAQ,oBAAY;IACtD,YACkB,MAAc,EACd,MAA2B,EAC3B,QAAc,EACd,MAAc;QAE9B,KAAK,CACH,8BAA8B,MAAM,UAAU,MAAM,KAAK;YACvD,kBAAkB,QAAQ,mBAAmB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,EAC7E,0BAA0B,EAC1B,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CACrC,CAAC;QAVc,WAAM,GAAN,MAAM,CAAQ;QACd,WAAM,GAAN,MAAM,CAAqB;QAC3B,aAAQ,GAAR,QAAQ,CAAM;QACd,WAAM,GAAN,MAAM,CAAQ;QAQ9B,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAfD,wDAeC"}

package/dist/domain/errors/index.d.ts

@@ -0,0 +1,29 @@
+export declare class EvolithError extends Error {
+    code: string;
+    context?: Record<string, unknown> | undefined;
+    constructor(message: string, code: string, context?: Record<string, unknown> | undefined);
+}
+export declare class PlatformNotFoundError extends EvolithError {
+    constructor(platform: string, hint?: string);
+}
+export declare class PhaseTransitionError extends EvolithError {
+    constructor(from: string, to: string, reason: string);
+}
+export declare class CatalogLoadError extends EvolithError {
+    constructor(catalog: string, cause: string);
+}
+export declare class ToolValidationError extends EvolithError {
+    constructor(tool: string, reason: string);
+}
+export declare class CommandExecutionError extends EvolithError {
+    constructor(command: string, exitCode: number, stderr: string);
+}
+export declare class ValidationError extends EvolithError {
+    constructor(errors: string[]);
+}
+export declare class UserCancelledError extends EvolithError {
+    constructor(message?: string);
+}
+export declare function isEvolithError(error: unknown): error is EvolithError;
+export declare function getErrorCode(error: unknown): string;
+export declare function getErrorContext(error: unknown): Record<string, unknown> | undefined;

package/dist/domain/errors/index.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserCancelledError = exports.ValidationError = exports.CommandExecutionError = exports.ToolValidationError = exports.CatalogLoadError = exports.PhaseTransitionError = exports.PlatformNotFoundError = exports.EvolithError = void 0;
+exports.isEvolithError = isEvolithError;
+exports.getErrorCode = getErrorCode;
+exports.getErrorContext = getErrorContext;
+class EvolithError extends Error {
+    constructor(message, code, context) {
+        super(message);
+        this.code = code;
+        this.context = context;
+        this.name = 'EvolithError';
+    }
+}
+exports.EvolithError = EvolithError;
+class PlatformNotFoundError extends EvolithError {
+    constructor(platform, hint) {
+        super(`${platform} not found in PATH`, 'PLATFORM_NOT_FOUND', { platform, hint });
+    }
+}
+exports.PlatformNotFoundError = PlatformNotFoundError;
+class PhaseTransitionError extends EvolithError {
+    constructor(from, to, reason) {
+        super(`Cannot transition from ${from} to ${to}: ${reason}`, 'PHASE_TRANSITION_ERROR', { from, to, reason });
+    }
+}
+exports.PhaseTransitionError = PhaseTransitionError;
+class CatalogLoadError extends EvolithError {
+    constructor(catalog, cause) {
+        super(`Failed to load catalog ${catalog}: ${cause}`, 'CATALOG_LOAD_ERROR', { catalog });
+    }
+}
+exports.CatalogLoadError = CatalogLoadError;
+class ToolValidationError extends EvolithError {
+    constructor(tool, reason) {
+        super(`Tool ${tool} validation failed: ${reason}`, 'TOOL_VALIDATION_ERROR', { tool });
+    }
+}
+exports.ToolValidationError = ToolValidationError;
+class CommandExecutionError extends EvolithError {
+    constructor(command, exitCode, stderr) {
+        super(`Command "${command}" failed with exit code ${exitCode}: ${stderr}`, 'COMMAND_EXECUTION_ERROR', { command, exitCode, stderr });
+    }
+}
+exports.CommandExecutionError = CommandExecutionError;
+class ValidationError extends EvolithError {
+    constructor(errors) {
+        super(`Validation failed: ${errors.join(', ')}`, 'VALIDATION_ERROR', { errors });
+    }
+}
+exports.ValidationError = ValidationError;
+class UserCancelledError extends EvolithError {
+    constructor(message = 'User cancelled the operation') {
+        super(message, 'USER_CANCELLED');
+    }
+}
+exports.UserCancelledError = UserCancelledError;
+function isEvolithError(error) {
+    return error instanceof EvolithError;
+}
+function getErrorCode(error) {
+    if (isEvolithError(error)) {
+        return error.code;
+    }
+    return 'UNKNOWN_ERROR';
+}
+function getErrorContext(error) {
+    if (isEvolithError(error)) {
+        return error.context;
+    }
+    return undefined;
+}
+//# sourceMappingURL=index.js.map

package/dist/domain/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/errors/index.ts"],"names":[],"mappings":";;;AA6EA,wCAEC;AAED,oCAKC;AAED,0CAKC;AA7FD,MAAa,YAAa,SAAQ,KAAK;IACrC,YACE,OAAe,EACR,IAAY,EACZ,OAAiC;QAExC,KAAK,CAAC,OAAO,CAAC,CAAC;QAHR,SAAI,GAAJ,IAAI,CAAQ;QACZ,YAAO,GAAP,OAAO,CAA0B;QAGxC,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AATD,oCASC;AAED,MAAa,qBAAsB,SAAQ,YAAY;IACrD,YAAY,QAAgB,EAAE,IAAa;QACzC,KAAK,CACH,GAAG,QAAQ,oBAAoB,EAC/B,oBAAoB,EACpB,EAAE,QAAQ,EAAE,IAAI,EAAE,CACnB,CAAC;IACJ,CAAC;CACF;AARD,sDAQC;AAED,MAAa,oBAAqB,SAAQ,YAAY;IACpD,YAAY,IAAY,EAAE,EAAU,EAAE,MAAc;QAClD,KAAK,CACH,0BAA0B,IAAI,OAAO,EAAE,KAAK,MAAM,EAAE,EACpD,wBAAwB,EACxB,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CACrB,CAAC;IACJ,CAAC;CACF;AARD,oDAQC;AAED,MAAa,gBAAiB,SAAQ,YAAY;IAChD,YAAY,OAAe,EAAE,KAAa;QACxC,KAAK,CACH,0BAA0B,OAAO,KAAK,KAAK,EAAE,EAC7C,oBAAoB,EACpB,EAAE,OAAO,EAAE,CACZ,CAAC;IACJ,CAAC;CACF;AARD,4CAQC;AAED,MAAa,mBAAoB,SAAQ,YAAY;IACnD,YAAY,IAAY,EAAE,MAAc;QACtC,KAAK,CACH,QAAQ,IAAI,uBAAuB,MAAM,EAAE,EAC3C,uBAAuB,EACvB,EAAE,IAAI,EAAE,CACT,CAAC;IACJ,CAAC;CACF;AARD,kDAQC;AAED,MAAa,qBAAsB,SAAQ,YAAY;IACrD,YAAY,OAAe,EAAE,QAAgB,EAAE,MAAc;QAC3D,KAAK,CACH,YAAY,OAAO,2BAA2B,QAAQ,KAAK,MAAM,EAAE,EACnE,yBAAyB,EACzB,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAC9B,CAAC;IACJ,CAAC;CACF;AARD,sDAQC;AAED,MAAa,eAAgB,SAAQ,YAAY;IAC/C,YAAY,MAAgB;QAC1B,KAAK,CACH,sBAAsB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EACzC,kBAAkB,EAClB,EAAE,MAAM,EAAE,CACX,CAAC;IACJ,CAAC;CACF;AARD,0CAQC;AAED,MAAa,kBAAmB,SAAQ,YAAY;IAClD,YAAY,UAAkB,8BAA8B;QAC1D,KAAK,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAC;IACnC,CAAC;CACF;AAJD,gDAIC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED,SAAgB,YAAY,CAAC,KAAc;IACzC,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,IAAI,CAAC;IACpB,CAAC;IACD,OAAO,eAAe,CAAC;AACzB,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC5C,IAAI,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,OAAO,CAAC;IACvB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/domain/events/domain-event.d.ts

@@ -0,0 +1,9 @@
+export interface DomainEvent<T = unknown> {
+    readonly eventId: string;
+    readonly eventType: string;
+    readonly version: number;
+    readonly occurredAt: string;
+    readonly correlationId?: string;
+    readonly payload: T;
+}
+export declare function createEvent<T>(eventType: string, version: number, payload: T, correlationId?: string): DomainEvent<T>;

package/dist/domain/events/domain-event.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createEvent = createEvent;
+function createEvent(eventType, version, payload, correlationId) {
+    return {
+        eventId: crypto.randomUUID(),
+        eventType,
+        version,
+        occurredAt: new Date().toISOString(),
+        correlationId,
+        payload,
+    };
+}
+//# sourceMappingURL=domain-event.js.map

package/dist/domain/events/domain-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-event.js","sourceRoot":"","sources":["../../../src/domain/events/domain-event.ts"],"names":[],"mappings":";;AA0BA,kCAcC;AAdD,SAAgB,WAAW,CACzB,SAAiB,EACjB,OAAe,EACf,OAAU,EACV,aAAsB;IAEtB,OAAO;QACL,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE;QAC5B,SAAS;QACT,OAAO;QACP,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,aAAa;QACb,OAAO;KACR,CAAC;AACJ,CAAC"}

package/dist/domain/events/domain-events.d.ts

@@ -0,0 +1,99 @@
+import { DomainEvent } from './domain-event';
+import type { GatePhase, EvaluatorKind } from '../gate-evidence';
+export declare const EVENT_TYPES: {
+    readonly PHASE_STARTED: "phase.started";
+    readonly PHASE_COMPLETED: "phase.completed";
+    readonly GATE_APPROVED: "gate.approved";
+    readonly GATE_REJECTED: "gate.rejected";
+    readonly ARTIFACT_CREATED: "artifact.created";
+    readonly ARTIFACT_UPDATED: "artifact.updated";
+    readonly ARTIFACT_VALIDATED: "artifact.validated";
+    readonly BLUEPRINT_GENERATED: "blueprint.generated";
+    readonly BLUEPRINT_VALIDATED: "blueprint.validated";
+    readonly WORKFLOW_UPDATED: "workflow.updated";
+};
+export type EventType = (typeof EVENT_TYPES)[keyof typeof EVENT_TYPES];
+export interface PhaseStartedPayload {
+    projectId: string;
+    phase: GatePhase;
+    startedBy?: string;
+}
+export interface PhaseCompletedPayload {
+    projectId: string;
+    phase: GatePhase;
+    completedAt: string;
+}
+export interface GateApprovedPayload {
+    projectId: string;
+    phase: GatePhase;
+    gateId: string;
+    rulesetRef: string;
+    rulesetVersion?: string;
+    evaluatedBy: EvaluatorKind;
+    evaluatedAt: string;
+}
+export interface GateRejectedPayload {
+    projectId: string;
+    phase: GatePhase;
+    gateId: string;
+    rulesetRef: string;
+    rulesetVersion?: string;
+    evaluatedBy: EvaluatorKind;
+    evaluatedAt: string;
+    violationCount: number;
+}
+export interface ArtifactCreatedPayload {
+    projectId: string;
+    artifactPath: string;
+    artifactType?: string;
+}
+export interface ArtifactUpdatedPayload {
+    projectId: string;
+    artifactPath: string;
+    artifactType?: string;
+}
+export interface ArtifactValidatedPayload {
+    projectId: string;
+    artifactPath: string;
+    passed: boolean;
+    validatedAt: string;
+}
+export interface BlueprintGeneratedPayload {
+    projectId: string;
+    blueprintId: string;
+    generatedAt: string;
+}
+export interface BlueprintValidatedPayload {
+    projectId: string;
+    blueprintId: string;
+    passed: boolean;
+    validatedAt: string;
+}
+export interface WorkflowUpdatedPayload {
+    projectId: string;
+    workflowId: string;
+    updatedAt: string;
+    changedFields?: string[];
+}
+export type PhaseStartedEvent = DomainEvent<PhaseStartedPayload>;
+export type PhaseCompletedEvent = DomainEvent<PhaseCompletedPayload>;
+export type GateApprovedEvent = DomainEvent<GateApprovedPayload>;
+export type GateRejectedEvent = DomainEvent<GateRejectedPayload>;
+export type ArtifactCreatedEvent = DomainEvent<ArtifactCreatedPayload>;
+export type ArtifactUpdatedEvent = DomainEvent<ArtifactUpdatedPayload>;
+export type ArtifactValidatedEvent = DomainEvent<ArtifactValidatedPayload>;
+export type BlueprintGeneratedEvent = DomainEvent<BlueprintGeneratedPayload>;
+export type BlueprintValidatedEvent = DomainEvent<BlueprintValidatedPayload>;
+export type WorkflowUpdatedEvent = DomainEvent<WorkflowUpdatedPayload>;
+export declare const DomainEvents: {
+    readonly phaseStarted: (payload: PhaseStartedPayload, correlationId?: string) => PhaseStartedEvent;
+    readonly phaseCompleted: (payload: PhaseCompletedPayload, correlationId?: string) => PhaseCompletedEvent;
+    readonly gateApproved: (payload: GateApprovedPayload, correlationId?: string) => GateApprovedEvent;
+    readonly gateRejected: (payload: GateRejectedPayload, correlationId?: string) => GateRejectedEvent;
+    readonly artifactCreated: (payload: ArtifactCreatedPayload, correlationId?: string) => ArtifactCreatedEvent;
+    readonly artifactUpdated: (payload: ArtifactUpdatedPayload, correlationId?: string) => ArtifactUpdatedEvent;
+    readonly artifactValidated: (payload: ArtifactValidatedPayload, correlationId?: string) => ArtifactValidatedEvent;
+    readonly blueprintGenerated: (payload: BlueprintGeneratedPayload, correlationId?: string) => BlueprintGeneratedEvent;
+    readonly blueprintValidated: (payload: BlueprintValidatedPayload, correlationId?: string) => BlueprintValidatedEvent;
+    readonly workflowUpdated: (payload: WorkflowUpdatedPayload, correlationId?: string) => WorkflowUpdatedEvent;
+};

package/dist/domain/events/domain-events.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainEvents = exports.EVENT_TYPES = void 0;
+const domain_event_1 = require("./domain-event");
+exports.EVENT_TYPES = {
+    PHASE_STARTED: 'phase.started',
+    PHASE_COMPLETED: 'phase.completed',
+    GATE_APPROVED: 'gate.approved',
+    GATE_REJECTED: 'gate.rejected',
+    ARTIFACT_CREATED: 'artifact.created',
+    ARTIFACT_UPDATED: 'artifact.updated',
+    ARTIFACT_VALIDATED: 'artifact.validated',
+    BLUEPRINT_GENERATED: 'blueprint.generated',
+    BLUEPRINT_VALIDATED: 'blueprint.validated',
+    WORKFLOW_UPDATED: 'workflow.updated',
+};
+exports.DomainEvents = {
+    phaseStarted(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.PHASE_STARTED, 1, payload, correlationId);
+    },
+    phaseCompleted(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.PHASE_COMPLETED, 1, payload, correlationId);
+    },
+    gateApproved(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.GATE_APPROVED, 1, payload, correlationId);
+    },
+    gateRejected(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.GATE_REJECTED, 1, payload, correlationId);
+    },
+    artifactCreated(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.ARTIFACT_CREATED, 1, payload, correlationId);
+    },
+    artifactUpdated(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.ARTIFACT_UPDATED, 1, payload, correlationId);
+    },
+    artifactValidated(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.ARTIFACT_VALIDATED, 1, payload, correlationId);
+    },
+    blueprintGenerated(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.BLUEPRINT_GENERATED, 1, payload, correlationId);
+    },
+    blueprintValidated(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.BLUEPRINT_VALIDATED, 1, payload, correlationId);
+    },
+    workflowUpdated(payload, correlationId) {
+        return (0, domain_event_1.createEvent)(exports.EVENT_TYPES.WORKFLOW_UPDATED, 1, payload, correlationId);
+    },
+};
+//# sourceMappingURL=domain-events.js.map