@evolith/core-domain 1.0.0

package/dist/domain/interfaces.d.ts

@@ -0,0 +1,301 @@
+export interface FileExistsOptions {
+    cwd?: string;
+}
+export interface FileReadOptions {
+    encoding?: BufferEncoding;
+    cwd?: string;
+}
+export interface FileWriteOptions {
+    encoding?: BufferEncoding;
+    cwd?: string;
+}
+export interface DirEntry {
+    name: string;
+    isDirectory: () => boolean;
+    isFile: () => boolean;
+}
+export interface IConfigParser {
+    parse(content: string): unknown;
+    stringify(data: unknown): string;
+}
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+export interface LogEntry {
+    level: LogLevel;
+    message: string;
+    context?: string;
+    timestamp: string;
+}
+export interface ILoggerProvider {
+    createLogger(context: string): ILogger;
+}
+export interface IConfigParserProvider {
+    createConfigParser(format: string): IConfigParser;
+}
+export declare const SUPPORTED_FORMATS: readonly ["yaml", "json"];
+export type SupportedFormat = typeof SUPPORTED_FORMATS[number];
+export interface CommandResult {
+    success: boolean;
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface PlatformCheck {
+    name: string;
+    command: string;
+    available: boolean;
+    version?: string;
+    installHint?: string;
+}
+export interface ICommandExecutor {
+    execute(command: string, cwd?: string): Promise<CommandResult>;
+    executeOrThrow(command: string, cwd?: string): Promise<string>;
+    checkTool(name: string, versionCommand: string): Promise<PlatformCheck>;
+}
+export interface ICatalogLoader {
+    loadRuntimeCatalog(): Runtime[];
+    loadToolCatalog(): ToolCatalog;
+    loadCommandsMatrix(): CommandsMatrix;
+    getMonorepoOptions(): MonorepoOption[];
+    getArchitecturePatterns(): ArchitecturePattern[];
+    getDefaultDatabase(runtimeId: string): string;
+    getApiProtocols(): Array<{
+        id: string;
+        name: string;
+        description: string;
+    }>;
+}
+export interface Runtime {
+    id: string;
+    name: string;
+    versions: string[];
+    defaultVersion: string;
+    language: string;
+    typeSystem: string;
+    frameworks: Framework[];
+    databases: Database[];
+    buildTools: string[];
+    testFrameworks: string[];
+    packageManager: string;
+}
+export interface Framework {
+    id: string;
+    name: string;
+    version: string;
+}
+export interface Database {
+    id: string;
+    name: string;
+    orm?: string;
+    type?: string;
+}
+export interface MonorepoOption {
+    id: string;
+    name: string;
+    description: string;
+    defaults: {
+        structure: string;
+        ciStrategy: string;
+        libraryStructure?: string;
+        policyEnforcement?: boolean;
+    };
+}
+export interface ArchitecturePattern {
+    id: string;
+    name: string;
+    description: string;
+    layers: string[];
+    dddConcepts?: string[];
+}
+export interface ToolGroup {
+    question: string;
+    defaultOption: string;
+    options?: ToolOption[];
+    tools: string[];
+}
+export interface ToolOption {
+    value: string;
+    label: string;
+    description: string;
+    hint?: string;
+}
+export interface PhaseDefinition {
+    value: string;
+    label: string;
+    description: string;
+    gateChecks: GateCheck[];
+    artifacts: string[];
+    toolGroups: Record<string, ToolGroup>;
+    defaultTools: string[];
+}
+export interface GateCheck {
+    id: string;
+    description: string;
+    required: boolean;
+}
+export interface PlatformCheck {
+    name: string;
+    command: string;
+    available: boolean;
+    version?: string;
+    installHint?: string;
+}
+export interface ProjectConfig {
+    name: string;
+    runtime: Runtime;
+    monorepo: MonorepoOption;
+    architecture: ArchitecturePattern;
+    database: string;
+    apiProtocol: string;
+    ciCd: string;
+    observability: string;
+}
+export interface PhaseTransition {
+    fromPhase: string;
+    toPhase: string;
+    tools: string[];
+    validated: boolean;
+    timestamp: string;
+}
+export interface ICommandExecutor {
+    execute(command: string, cwd?: string): Promise<CommandResult>;
+    executeOrThrow(command: string, cwd?: string): Promise<string>;
+    checkTool(name: string, versionCommand: string): Promise<PlatformCheck>;
+}
+export interface ICatalogLoader {
+    loadRuntimeCatalog(): Runtime[];
+    loadToolCatalog(): ToolCatalog;
+    loadCommandsMatrix(): CommandsMatrix;
+    getMonorepoOptions(): MonorepoOption[];
+    getArchitecturePatterns(): ArchitecturePattern[];
+    getDefaultDatabase(runtimeId: string): string;
+    getApiProtocols(): Array<{
+        id: string;
+        name: string;
+        description: string;
+    }>;
+}
+export interface ToolCatalog {
+    phases: Record<string, PhaseDefinition>;
+    toolMetadata: Record<string, ToolMetadata>;
+}
+export interface ToolMetadata {
+    description: string;
+    runtimeAgnostic: boolean;
+    runtimeAware?: boolean;
+    phase: string;
+    commands?: string[];
+    platformCheck?: string;
+}
+export interface CommandsMatrix {
+    runtimes: Record<string, RuntimeCommands>;
+    monorepos: Record<string, MonorepoCommands>;
+    container: ContainerCommands;
+    observability: ObservabilityCommands;
+}
+export interface RuntimeCommands {
+    native: string[];
+    scaffold: string[];
+    delegated: string[];
+    unsupported: string[];
+}
+export interface MonorepoCommands {
+    native: string[];
+    delegated: string[];
+}
+export interface ContainerCommands {
+    delegated: string[];
+    unsupported: string[];
+}
+export interface ObservabilityCommands {
+    scaffold: string[];
+    delegated: string[];
+}
+export interface IFileSystem {
+    readFile(path: string): Promise<string>;
+    readFileBuffer(path: string): Promise<Buffer>;
+    writeFile(path: string, content: string): Promise<void>;
+    exists(path: string): Promise<boolean>;
+    existsSync(path: string): boolean;
+    readJson<T = unknown>(path: string): Promise<T>;
+    writeJson(path: string, content: unknown): Promise<void>;
+    mkdir(path: string): Promise<void>;
+    readdir(path: string): Promise<DirEntry[]>;
+    readdirNames(path: string): Promise<string[]>;
+    copy(src: string, dest: string): Promise<void>;
+    ensureDir(path: string): Promise<void>;
+    ensureFile(path: string): Promise<void>;
+    stat(path: string): Promise<{
+        isDirectory: () => boolean;
+        isFile: () => boolean;
+    }>;
+    remove(path: string): Promise<void>;
+}
+export interface IConfigParser {
+    parse<T = unknown>(content: string): T;
+    stringify(data: unknown): string;
+}
+export interface ILogger {
+    info(message: string, context?: unknown): void;
+    warn(message: string, context?: unknown): void;
+    error(message: string, context?: unknown): void;
+    debug(message: string, context?: unknown): void;
+}
+export interface IProjectInitializer {
+    initialize(config: ProjectConfig, cwd: string): Promise<InitResult>;
+    scaffoldRuntime(config: ProjectConfig, fs: IFileSystem, projectDir: string): Promise<void>;
+}
+export interface InitResult {
+    success: boolean;
+    artifacts: string[];
+    warnings: string[];
+    errors: string[];
+}
+export interface IPhaseGates {
+    validate(phase: string, cwd: string): Promise<GateResult[]>;
+    canTransition(from: string, to: string): boolean;
+}
+export interface GateResult {
+    id: string;
+    passed: boolean;
+    description: string;
+    error?: string;
+}
+export interface IToolExecutor {
+    execute(tool: string, context: ToolContext): Promise<ToolResult>;
+    detectPlatform(tool: string): Promise<PlatformCheck>;
+}
+export interface ToolContext {
+    phase: string;
+    projectDir: string;
+    runtime?: string;
+}
+export interface ToolResult {
+    success: boolean;
+    command?: string;
+    output?: string;
+    error?: string;
+}
+export interface IToolSelector {
+    getToolsForPhase(phase: string): ToolGroup[];
+    getDefaultTools(phase: string): string[];
+    validateToolSelection(phase: string, tools: string[]): ValidationResult;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+export interface FileExistsOptions {
+    checkType?: 'file' | 'directory';
+}
+export interface FileReadOptions {
+    encoding?: BufferEncoding;
+    flag?: string;
+}
+export interface FileWriteOptions {
+    encoding?: BufferEncoding;
+    mode?: number;
+    flag?: string;
+}
+export interface IFileSystemProvider extends IFileSystem {
+}

package/dist/domain/interfaces.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SUPPORTED_FORMATS = void 0;
+exports.SUPPORTED_FORMATS = ['yaml', 'json'];
+//# sourceMappingURL=interfaces.js.map

package/dist/domain/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../src/domain/interfaces.ts"],"names":[],"mappings":";;;AAgDa,QAAA,iBAAiB,GAAG,CAAC,MAAM,EAAE,MAAM,CAAU,CAAC"}

package/dist/domain/lifecycle/artifact-state-machine.d.ts

@@ -0,0 +1,23 @@
+import type { IDomainEventBus } from '../../application/ports/event-bus.port';
+export declare enum ArtifactState {
+    DRAFT = "DRAFT",
+    SUBMITTED = "SUBMITTED",
+    VALIDATING = "VALIDATING",
+    VALIDATED = "VALIDATED",
+    REJECTED = "REJECTED",
+    ARCHIVED = "ARCHIVED"
+}
+export declare const ARTIFACT_TRANSITIONS: Readonly<Record<ArtifactState, readonly ArtifactState[]>>;
+export interface ArtifactTransitionContext {
+    artifactPath: string;
+    artifactType?: string;
+    projectId: string;
+    correlationId?: string;
+}
+export declare class ArtifactStateMachine {
+    private readonly eventBus?;
+    constructor(eventBus?: IDomainEventBus | undefined);
+    transition(from: ArtifactState, to: ArtifactState, ctx?: ArtifactTransitionContext): true;
+    canTransition(from: ArtifactState, to: ArtifactState): boolean;
+    allowedTransitions(from: ArtifactState): readonly ArtifactState[];
+}

package/dist/domain/lifecycle/artifact-state-machine.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ArtifactStateMachine = exports.ARTIFACT_TRANSITIONS = exports.ArtifactState = void 0;
+const domain_events_1 = require("../events/domain-events");
+var ArtifactState;
+(function (ArtifactState) {
+    ArtifactState["DRAFT"] = "DRAFT";
+    ArtifactState["SUBMITTED"] = "SUBMITTED";
+    ArtifactState["VALIDATING"] = "VALIDATING";
+    ArtifactState["VALIDATED"] = "VALIDATED";
+    ArtifactState["REJECTED"] = "REJECTED";
+    ArtifactState["ARCHIVED"] = "ARCHIVED";
+})(ArtifactState || (exports.ArtifactState = ArtifactState = {}));
+exports.ARTIFACT_TRANSITIONS = {
+    [ArtifactState.DRAFT]: [ArtifactState.SUBMITTED, ArtifactState.ARCHIVED],
+    [ArtifactState.SUBMITTED]: [ArtifactState.VALIDATING, ArtifactState.DRAFT, ArtifactState.ARCHIVED],
+    [ArtifactState.VALIDATING]: [ArtifactState.VALIDATED, ArtifactState.REJECTED],
+    [ArtifactState.VALIDATED]: [ArtifactState.ARCHIVED],
+    [ArtifactState.REJECTED]: [ArtifactState.DRAFT, ArtifactState.ARCHIVED],
+    [ArtifactState.ARCHIVED]: [],
+};
+class ArtifactStateMachine {
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+    }
+    transition(from, to, ctx) {
+        const allowed = exports.ARTIFACT_TRANSITIONS[from];
+        if (!allowed.includes(to)) {
+            throw new Error(`Invalid artifact transition: ${from} → ${to}. ` +
+                `Allowed targets from ${from}: [${allowed.join(', ') || 'none'}]`);
+        }
+        if (this.eventBus && ctx) {
+            const event = domain_events_1.DomainEvents.artifactUpdated({
+                projectId: ctx.projectId,
+                artifactPath: ctx.artifactPath,
+                artifactType: ctx.artifactType,
+            }, ctx.correlationId);
+            void this.eventBus.publish(event);
+        }
+        return true;
+    }
+    canTransition(from, to) {
+        return exports.ARTIFACT_TRANSITIONS[from].includes(to);
+    }
+    allowedTransitions(from) {
+        return exports.ARTIFACT_TRANSITIONS[from];
+    }
+}
+exports.ArtifactStateMachine = ArtifactStateMachine;
+//# sourceMappingURL=artifact-state-machine.js.map

package/dist/domain/lifecycle/artifact-state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-state-machine.js","sourceRoot":"","sources":["../../../src/domain/lifecycle/artifact-state-machine.ts"],"names":[],"mappings":";;;AASA,2DAAuD;AAMvD,IAAY,aAaX;AAbD,WAAY,aAAa;IAEvB,gCAAe,CAAA;IAEf,wCAAuB,CAAA;IAEvB,0CAAyB,CAAA;IAEzB,wCAAuB,CAAA;IAEvB,sCAAqB,CAAA;IAErB,sCAAqB,CAAA;AACvB,CAAC,EAbW,aAAa,6BAAb,aAAa,QAaxB;AAUY,QAAA,oBAAoB,GAA8D;IAC7F,CAAC,aAAa,CAAC,KAAK,CAAC,EAAO,CAAC,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC;IAC7E,CAAC,aAAa,CAAC,SAAS,CAAC,EAAG,CAAC,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC;IACnG,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,aAAa,CAAC,QAAQ,CAAC;IAC7E,CAAC,aAAa,CAAC,SAAS,CAAC,EAAG,CAAC,aAAa,CAAC,QAAQ,CAAC;IACpD,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAI,CAAC,aAAa,CAAC,KAAK,EAAE,aAAa,CAAC,QAAQ,CAAC;IACzE,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAI,EAAE;CAC/B,CAAC;AAeF,MAAa,oBAAoB;IAC/B,YAA6B,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAQ3D,UAAU,CACR,IAAmB,EACnB,EAAiB,EACjB,GAA+B;QAE/B,MAAM,OAAO,GAAG,4BAAoB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,gCAAgC,IAAI,MAAM,EAAE,IAAI;gBAChD,wBAAwB,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAClE,CAAC;QACJ,CAAC;QAGD,IAAI,IAAI,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,4BAAY,CAAC,eAAe,CACxC;gBACE,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,YAAY,EAAE,GAAG,CAAC,YAAY;gBAC9B,YAAY,EAAE,GAAG,CAAC,YAAY;aAC/B,EACD,GAAG,CAAC,aAAa,CAClB,CAAC;YAEF,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,aAAa,CAAC,IAAmB,EAAE,EAAiB;QAClD,OAAO,4BAAoB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACjD,CAAC;IAKD,kBAAkB,CAAC,IAAmB;QACpC,OAAO,4BAAoB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AApDD,oDAoDC"}

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

@@ -0,0 +1,2 @@
+export * from './artifact-state-machine';
+export * from './phase-state-machine';

package/dist/domain/lifecycle/index.js

@@ -0,0 +1,19 @@
+"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 });
+__exportStar(require("./artifact-state-machine"), exports);
+__exportStar(require("./phase-state-machine"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/domain/lifecycle/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,wDAAsC"}

package/dist/domain/lifecycle/phase-state-machine.d.ts

@@ -0,0 +1,24 @@
+import type { IDomainEventBus } from '../../application/ports/event-bus.port';
+import type { GatePhase } from '../gate-evidence';
+export declare enum PhaseState {
+    PENDING = "PENDING",
+    IN_PROGRESS = "IN_PROGRESS",
+    GATE_PENDING = "GATE_PENDING",
+    APPROVED = "APPROVED",
+    REJECTED = "REJECTED",
+    ARCHIVED = "ARCHIVED"
+}
+export declare const PHASE_TRANSITIONS: Readonly<Record<PhaseState, readonly PhaseState[]>>;
+export interface PhaseTransitionContext {
+    projectId: string;
+    phase: GatePhase;
+    startedBy?: string;
+    correlationId?: string;
+}
+export declare class PhaseStateMachine {
+    private readonly eventBus?;
+    constructor(eventBus?: IDomainEventBus | undefined);
+    transition(from: PhaseState, to: PhaseState, ctx?: PhaseTransitionContext): true;
+    canTransition(from: PhaseState, to: PhaseState): boolean;
+    allowedTransitions(from: PhaseState): readonly PhaseState[];
+}

package/dist/domain/lifecycle/phase-state-machine.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PhaseStateMachine = exports.PHASE_TRANSITIONS = exports.PhaseState = void 0;
+const domain_events_1 = require("../events/domain-events");
+var PhaseState;
+(function (PhaseState) {
+    PhaseState["PENDING"] = "PENDING";
+    PhaseState["IN_PROGRESS"] = "IN_PROGRESS";
+    PhaseState["GATE_PENDING"] = "GATE_PENDING";
+    PhaseState["APPROVED"] = "APPROVED";
+    PhaseState["REJECTED"] = "REJECTED";
+    PhaseState["ARCHIVED"] = "ARCHIVED";
+})(PhaseState || (exports.PhaseState = PhaseState = {}));
+exports.PHASE_TRANSITIONS = {
+    [PhaseState.PENDING]: [PhaseState.IN_PROGRESS, PhaseState.ARCHIVED],
+    [PhaseState.IN_PROGRESS]: [PhaseState.GATE_PENDING, PhaseState.PENDING, PhaseState.ARCHIVED],
+    [PhaseState.GATE_PENDING]: [PhaseState.APPROVED, PhaseState.REJECTED],
+    [PhaseState.APPROVED]: [PhaseState.ARCHIVED],
+    [PhaseState.REJECTED]: [PhaseState.IN_PROGRESS, PhaseState.ARCHIVED],
+    [PhaseState.ARCHIVED]: [],
+};
+class PhaseStateMachine {
+    constructor(eventBus) {
+        this.eventBus = eventBus;
+    }
+    transition(from, to, ctx) {
+        const allowed = exports.PHASE_TRANSITIONS[from];
+        if (!allowed.includes(to)) {
+            throw new Error(`Invalid phase transition: ${from} → ${to}. ` +
+                `Allowed targets from ${from}: [${allowed.join(', ') || 'none'}]`);
+        }
+        if (this.eventBus && ctx) {
+            if (to === PhaseState.IN_PROGRESS) {
+                void this.eventBus.publish(domain_events_1.DomainEvents.phaseStarted({ projectId: ctx.projectId, phase: ctx.phase, startedBy: ctx.startedBy }, ctx.correlationId));
+            }
+            else if (to === PhaseState.APPROVED) {
+                void this.eventBus.publish(domain_events_1.DomainEvents.phaseCompleted({ projectId: ctx.projectId, phase: ctx.phase, completedAt: new Date().toISOString() }, ctx.correlationId));
+            }
+        }
+        return true;
+    }
+    canTransition(from, to) {
+        return exports.PHASE_TRANSITIONS[from].includes(to);
+    }
+    allowedTransitions(from) {
+        return exports.PHASE_TRANSITIONS[from];
+    }
+}
+exports.PhaseStateMachine = PhaseStateMachine;
+//# sourceMappingURL=phase-state-machine.js.map

package/dist/domain/lifecycle/phase-state-machine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-state-machine.js","sourceRoot":"","sources":["../../../src/domain/lifecycle/phase-state-machine.ts"],"names":[],"mappings":";;;AASA,2DAAuD;AAOvD,IAAY,UAaX;AAbD,WAAY,UAAU;IAEpB,iCAAmB,CAAA;IAEnB,yCAA2B,CAAA;IAE3B,2CAA6B,CAAA;IAE7B,mCAAqB,CAAA;IAErB,mCAAqB,CAAA;IAErB,mCAAqB,CAAA;AACvB,CAAC,EAbW,UAAU,0BAAV,UAAU,QAarB;AAMY,QAAA,iBAAiB,GAAwD;IACpF,CAAC,UAAU,CAAC,OAAO,CAAC,EAAO,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC;IACxE,CAAC,UAAU,CAAC,WAAW,CAAC,EAAG,CAAC,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,QAAQ,CAAC;IAC7F,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC;IACrE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;IAChD,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAM,CAAC,UAAU,CAAC,WAAW,EAAE,UAAU,CAAC,QAAQ,CAAC;IACxE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAM,EAAE;CAC9B,CAAC;AAcF,MAAa,iBAAiB;IAC5B,YAA6B,QAA0B;QAA1B,aAAQ,GAAR,QAAQ,CAAkB;IAAG,CAAC;IAW3D,UAAU,CACR,IAAgB,EAChB,EAAc,EACd,GAA4B;QAE5B,MAAM,OAAO,GAAG,yBAAiB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;YAC1B,MAAM,IAAI,KAAK,CACb,6BAA6B,IAAI,MAAM,EAAE,IAAI;gBAC7C,wBAAwB,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,GAAG,CAClE,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,IAAI,GAAG,EAAE,CAAC;YACzB,IAAI,EAAE,KAAK,UAAU,CAAC,WAAW,EAAE,CAAC;gBAClC,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CACxB,4BAAY,CAAC,YAAY,CACvB,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,EACxE,GAAG,CAAC,aAAa,CAClB,CACF,CAAC;YACJ,CAAC;iBAAM,IAAI,EAAE,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC;gBACtC,KAAK,IAAI,CAAC,QAAQ,CAAC,OAAO,CACxB,4BAAY,CAAC,cAAc,CACzB,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,EACrF,GAAG,CAAC,aAAa,CAClB,CACF,CAAC;YACJ,CAAC;QACH,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAKD,aAAa,CAAC,IAAgB,EAAE,EAAc;QAC5C,OAAO,yBAAiB,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC9C,CAAC;IAKD,kBAAkB,CAAC,IAAgB;QACjC,OAAO,yBAAiB,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;CACF;AA3DD,8CA2DC"}

package/dist/domain/metrics/dora-calculator.d.ts

@@ -0,0 +1,18 @@
+import type { GitCommit } from './git-log-reader';
+export type DoraRating = 'elite' | 'high' | 'medium' | 'low' | 'unknown';
+export interface DoraMetric {
+    value: number;
+    label: string;
+    rating: DoraRating;
+    unit: string;
+}
+export interface DoraMetrics {
+    deploymentFrequency: DoraMetric;
+    leadTimeForChanges: DoraMetric;
+    changeFailureRate: DoraMetric;
+    timeToRestore: DoraMetric;
+    analyzedDays: number;
+    totalCommits: number;
+    available: boolean;
+}
+export declare function calculateDora(commits: GitCommit[], sinceDays: number): DoraMetrics;

package/dist/domain/metrics/dora-calculator.js

@@ -0,0 +1,146 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateDora = calculateDora;
+function rateDeployFreq(perWeek) {
+    if (perWeek > 7)
+        return 'elite';
+    if (perWeek >= 1)
+        return 'high';
+    if (perWeek >= 0.25)
+        return 'medium';
+    return 'low';
+}
+function rateLeadTime(hours) {
+    if (hours < 1)
+        return 'elite';
+    if (hours < 168)
+        return 'high';
+    if (hours < 720)
+        return 'medium';
+    return 'low';
+}
+function rateFailureRate(pct) {
+    if (pct <= 5)
+        return 'elite';
+    if (pct <= 10)
+        return 'high';
+    if (pct <= 15)
+        return 'medium';
+    return 'low';
+}
+function rateMttr(hours) {
+    if (hours < 1)
+        return 'elite';
+    if (hours < 24)
+        return 'high';
+    if (hours < 168)
+        return 'medium';
+    return 'low';
+}
+function median(values) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const mid = Math.floor(sorted.length / 2);
+    return sorted.length % 2 === 0
+        ? (sorted[mid - 1] + sorted[mid]) / 2
+        : sorted[mid];
+}
+function hoursLabel(hours) {
+    if (hours < 1)
+        return `${Math.round(hours * 60)} min`;
+    if (hours < 24)
+        return `${hours.toFixed(1)} h`;
+    return `${(hours / 24).toFixed(1)} days`;
+}
+const FIX_RE = /^(fix|hotfix|revert|rollback|bugfix|patch)[\s!(:]/i;
+function calculateDora(commits, sinceDays) {
+    if (commits.length === 0) {
+        return emptyMetrics(sinceDays);
+    }
+    const weeks = sinceDays / 7;
+    const deploys = commits.filter(c => c.isMerge);
+    const deployCount = deploys.length > 0 ? deploys.length : commits.length;
+    const deploysPerWeek = deployCount / weeks;
+    const deployFreq = {
+        value: deploysPerWeek,
+        label: deploysPerWeek >= 1
+            ? `${deploysPerWeek.toFixed(1)}/week`
+            : `${(deploysPerWeek * 4).toFixed(1)}/month`,
+        rating: rateDeployFreq(deploysPerWeek),
+        unit: 'deployments/week',
+    };
+    const commitDateMs = new Map();
+    for (const c of commits) {
+        commitDateMs.set(c.hash, new Date(c.date).getTime());
+    }
+    const leadTimesHours = [];
+    for (const merge of deploys) {
+        const mergeMs = commitDateMs.get(merge.hash) ?? 0;
+        const featureHash = merge.parents[1];
+        const featureMs = featureHash ? (commitDateMs.get(featureHash) ?? mergeMs) : mergeMs;
+        const diffHours = (mergeMs - featureMs) / 3_600_000;
+        if (diffHours > 0 && diffHours < 24 * 30) {
+            leadTimesHours.push(diffHours);
+        }
+    }
+    const medianLeadHours = leadTimesHours.length > 0 ? median(leadTimesHours) : 0;
+    const leadTime = {
+        value: medianLeadHours,
+        label: leadTimesHours.length > 0 ? hoursLabel(medianLeadHours) : 'n/a (no merges)',
+        rating: leadTimesHours.length > 0 ? rateLeadTime(medianLeadHours) : 'unknown',
+        unit: 'hours (median)',
+    };
+    const fixCommits = commits.filter(c => FIX_RE.test(c.subject));
+    const cfr = (fixCommits.length / commits.length) * 100;
+    const changeFailureRate = {
+        value: cfr,
+        label: `${cfr.toFixed(1)}%`,
+        rating: rateFailureRate(cfr),
+        unit: '% fix/revert commits',
+    };
+    const sorted = [...commits].sort((a, b) => new Date(a.date).getTime() - new Date(b.date).getTime());
+    const restoreTimesHours = [];
+    for (let i = 0; i < sorted.length; i++) {
+        if (!FIX_RE.test(sorted[i].subject))
+            continue;
+        for (let j = i - 1; j >= 0; j--) {
+            if (!FIX_RE.test(sorted[j].subject)) {
+                const diffH = (new Date(sorted[i].date).getTime() - new Date(sorted[j].date).getTime()) / 3_600_000;
+                if (diffH > 0 && diffH < 24 * 14) {
+                    restoreTimesHours.push(diffH);
+                }
+                break;
+            }
+        }
+    }
+    const medianRestoreHours = restoreTimesHours.length > 0 ? median(restoreTimesHours) : 0;
+    const timeToRestore = {
+        value: medianRestoreHours,
+        label: restoreTimesHours.length > 0 ? hoursLabel(medianRestoreHours) : 'n/a (no fix commits)',
+        rating: restoreTimesHours.length > 0 ? rateMttr(medianRestoreHours) : 'unknown',
+        unit: 'hours (median)',
+    };
+    return {
+        deploymentFrequency: deployFreq,
+        leadTimeForChanges: leadTime,
+        changeFailureRate,
+        timeToRestore,
+        analyzedDays: sinceDays,
+        totalCommits: commits.length,
+        available: true,
+    };
+}
+function emptyMetrics(sinceDays) {
+    const none = { value: 0, label: 'n/a', rating: 'unknown', unit: '' };
+    return {
+        deploymentFrequency: none,
+        leadTimeForChanges: none,
+        changeFailureRate: none,
+        timeToRestore: none,
+        analyzedDays: sinceDays,
+        totalCommits: 0,
+        available: false,
+    };
+}
+//# sourceMappingURL=dora-calculator.js.map

package/dist/domain/metrics/dora-calculator.js.map

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

package/dist/domain/metrics/dora-calculator.spec.d.ts

@@ -0,0 +1 @@
+export {};