@nahisaho/musubix-workflow-engine 2.4.2

package/dist/application/QualityGateRunner.js

@@ -0,0 +1,234 @@
+/**
+ * QualityGateRunner - Application Service
+ *
+ * Runs quality gates and validates phase completion
+ *
+ * @see TSK-WORKFLOW-003 - QualityGateRunner
+ * @see REQ-ORCH-003 - Quality Gate Integration
+ * @see DES-ORCH-003 - QualityGateRunner Component
+ */
+import { createQualityGate, executeQualityGate, aggregateGateResults, } from '../domain/index.js';
+/**
+ * Quality Gate Runner
+ *
+ * Executes quality gates for phase transitions
+ */
+export class QualityGateRunner {
+    gates = new Map();
+    config;
+    constructor(config = {}) {
+        this.config = {
+            gateTimeout: 30000,
+            continueOnFailure: true,
+            ...config,
+        };
+        // Register default gates
+        this.registerDefaultGates();
+    }
+    /**
+     * Register a quality gate
+     *
+     * @param gate - Quality gate to register
+     */
+    registerGate(gate) {
+        const phaseGates = this.gates.get(gate.phase) ?? [];
+        phaseGates.push(gate);
+        this.gates.set(gate.phase, phaseGates);
+    }
+    /**
+     * Run all gates for a phase
+     *
+     * @param phase - Phase type
+     * @returns Gate run result
+     */
+    async runGates(phase) {
+        const startTime = Date.now();
+        const phaseGates = this.gates.get(phase) ?? [];
+        const results = [];
+        for (const gate of phaseGates) {
+            try {
+                const result = await this.executeWithTimeout(gate);
+                results.push(result);
+                if (!result.passed && !this.config.continueOnFailure) {
+                    break;
+                }
+            }
+            catch (error) {
+                const errorResult = {
+                    gateId: gate.id,
+                    gateName: gate.name,
+                    results: [{
+                            passed: false,
+                            message: `Timeout or error: ${error instanceof Error ? error.message : String(error)}`,
+                            severity: 'error',
+                        }],
+                    passed: false,
+                    executedAt: new Date(),
+                    duration: 0,
+                };
+                results.push(errorResult);
+            }
+        }
+        const aggregated = aggregateGateResults(results);
+        const duration = Date.now() - startTime;
+        return {
+            phase,
+            results,
+            allPassed: aggregated.allPassed,
+            mandatoryPassed: aggregated.mandatoryPassed,
+            summary: aggregated.summary,
+            duration,
+        };
+    }
+    /**
+     * Execute gate with timeout
+     *
+     * @param gate - Gate to execute
+     * @returns Gate result
+     */
+    async executeWithTimeout(gate) {
+        const timeout = this.config.gateTimeout;
+        return Promise.race([
+            executeQualityGate(gate),
+            new Promise((_, reject) => setTimeout(() => reject(new Error(`Gate timeout: ${gate.name}`)), timeout)),
+        ]);
+    }
+    /**
+     * Register default quality gates
+     */
+    registerDefaultGates() {
+        // Requirements phase gates
+        this.registerGate(createQualityGate({
+            id: 'QG-REQ-001',
+            name: 'EARS形式の検証',
+            phase: 'requirements',
+            description: 'EARS形式に準拠しているか検証',
+            check: async () => this.createPassingResult('EARS形式の検証'),
+        }));
+        this.registerGate(createQualityGate({
+            id: 'QG-REQ-002',
+            name: '優先度設定の確認',
+            phase: 'requirements',
+            description: '全ての要件に優先度が設定されているか確認',
+            check: async () => this.createPassingResult('優先度設定の確認'),
+        }));
+        // Design phase gates
+        this.registerGate(createQualityGate({
+            id: 'QG-DES-001',
+            name: 'トレーサビリティ (REQ → DES)',
+            phase: 'design',
+            description: '要件から設計への追跡性を検証',
+            check: async () => this.createPassingResult('トレーサビリティ (REQ → DES)'),
+        }));
+        this.registerGate(createQualityGate({
+            id: 'QG-DES-002',
+            name: '設計パターン適用',
+            phase: 'design',
+            description: '適切な設計パターンが適用されているか検証',
+            check: async () => this.createPassingResult('設計パターン適用'),
+        }));
+        // Task breakdown phase gates
+        this.registerGate(createQualityGate({
+            id: 'QG-TSK-001',
+            name: 'トレーサビリティ (DES → TSK)',
+            phase: 'task-breakdown',
+            description: '設計からタスクへの追跡性を検証',
+            check: async () => this.createPassingResult('トレーサビリティ (DES → TSK)'),
+        }));
+        this.registerGate(createQualityGate({
+            id: 'QG-TSK-002',
+            name: 'タスクサイズの適切性',
+            phase: 'task-breakdown',
+            description: 'タスクが適切なサイズに分割されているか検証',
+            check: async () => this.createPassingResult('タスクサイズの適切性'),
+        }));
+        // Implementation phase gates
+        this.registerGate(createQualityGate({
+            id: 'QG-IMP-001',
+            name: 'ユニットテスト合格',
+            phase: 'implementation',
+            description: 'ユニットテストが全て合格しているか検証',
+            check: async () => this.createPassingResult('ユニットテスト合格'),
+        }));
+        this.registerGate(createQualityGate({
+            id: 'QG-IMP-002',
+            name: '型チェック合格',
+            phase: 'implementation',
+            description: 'TypeScript型チェックが通るか検証',
+            check: async () => this.createPassingResult('型チェック合格'),
+        }));
+        // Completion phase gates
+        this.registerGate(createQualityGate({
+            id: 'QG-CMP-001',
+            name: 'CHANGELOG更新',
+            phase: 'completion',
+            description: 'CHANGELOGが更新されているか検証',
+            check: async () => this.createPassingResult('CHANGELOG更新'),
+        }));
+    }
+    /**
+     * Create a passing result (placeholder for actual implementation)
+     *
+     * @param name - Check name
+     * @returns Passing check result
+     */
+    createPassingResult(name) {
+        return {
+            passed: true,
+            message: `${name}: OK`,
+            severity: 'info',
+        };
+    }
+    /**
+     * Format gate results for display
+     *
+     * @param result - Gate run result
+     * @returns Formatted string
+     */
+    formatResults(result) {
+        const lines = [
+            `🔍 **Quality Gate Results**: ${result.phase}`,
+            '',
+            `- Status: ${result.allPassed ? '✅ All Passed' : '❌ Some Failed'}`,
+            `- Summary: ${result.summary}`,
+            `- Duration: ${result.duration}ms`,
+            '',
+            '**Individual Gates:**',
+        ];
+        for (const gateResult of result.results) {
+            const emoji = gateResult.passed ? '✅' : '❌';
+            lines.push(`- ${emoji} ${gateResult.gateName} (${gateResult.duration}ms)`);
+            for (const check of gateResult.results) {
+                const severityEmoji = check.severity === 'error' ? '🔴' :
+                    check.severity === 'warning' ? '🟡' : '🟢';
+                lines.push(`  ${severityEmoji} ${check.message}`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get registered gates for a phase
+     *
+     * @param phase - Phase type
+     * @returns Quality gates
+     */
+    getGatesForPhase(phase) {
+        return this.gates.get(phase) ?? [];
+    }
+    /**
+     * Clear all gates
+     */
+    clearGates() {
+        this.gates.clear();
+    }
+}
+/**
+ * Create a quality gate runner instance
+ *
+ * @param config - Configuration
+ * @returns QualityGateRunner instance
+ */
+export function createQualityGateRunner(config) {
+    return new QualityGateRunner(config);
+}
+//# sourceMappingURL=QualityGateRunner.js.map

package/dist/application/QualityGateRunner.js.map

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

package/dist/application/StateTracker.d.ts

@@ -0,0 +1,119 @@
+/**
+ * StateTracker - Application Service
+ *
+ * Tracks and persists workflow state
+ *
+ * @see TSK-WORKFLOW-002 - StateTracker
+ * @see REQ-ORCH-002 - State Tracking
+ * @see DES-ORCH-002 - StateTracker Component
+ */
+import type { Workflow, WorkflowStatus, PhaseType } from '../domain/index.js';
+/**
+ * State snapshot
+ */
+export interface StateSnapshot {
+    readonly workflowId: string;
+    readonly status: WorkflowStatus;
+    readonly currentPhase: PhaseType | null;
+    readonly progress: number;
+    readonly phaseStatuses: Record<PhaseType, string>;
+    readonly timestamp: Date;
+}
+/**
+ * State change event
+ */
+export interface StateChangeEvent {
+    readonly type: 'state-change';
+    readonly workflowId: string;
+    readonly previousState: StateSnapshot;
+    readonly currentState: StateSnapshot;
+    readonly timestamp: Date;
+}
+/**
+ * State listener function
+ */
+export type StateListener = (event: StateChangeEvent) => void;
+/**
+ * State Tracker
+ *
+ * Tracks workflow state and emits change events
+ */
+export declare class StateTracker {
+    private snapshots;
+    private listeners;
+    /**
+     * Take a snapshot of workflow state
+     *
+     * @param workflow - Workflow to snapshot
+     * @returns State snapshot
+     */
+    snapshot(workflow: Workflow): StateSnapshot;
+    /**
+     * Get latest snapshot for a workflow
+     *
+     * @param workflowId - Workflow ID
+     * @returns Latest snapshot or undefined
+     */
+    getLatestSnapshot(workflowId: string): StateSnapshot | undefined;
+    /**
+     * Get snapshot history for a workflow
+     *
+     * @param workflowId - Workflow ID
+     * @returns Snapshot history
+     */
+    getHistory(workflowId: string): readonly StateSnapshot[];
+    /**
+     * Subscribe to state changes
+     *
+     * @param listener - State listener
+     * @returns Unsubscribe function
+     */
+    subscribe(listener: StateListener): () => void;
+    /**
+     * Check if state has changed
+     *
+     * @param previous - Previous snapshot
+     * @param current - Current snapshot
+     * @returns true if changed
+     */
+    private hasStateChanged;
+    /**
+     * Emit state change event
+     *
+     * @param workflowId - Workflow ID
+     * @param previous - Previous state
+     * @param current - Current state
+     */
+    private emitStateChange;
+    /**
+     * Format state as display string
+     *
+     * @param snapshot - State snapshot
+     * @returns Formatted string
+     */
+    formatState(snapshot: StateSnapshot): string;
+    /**
+     * Get emoji for status
+     *
+     * @param status - Phase status
+     * @returns Emoji
+     */
+    private getStatusEmoji;
+    /**
+     * Clear history for a workflow
+     *
+     * @param workflowId - Workflow ID
+     */
+    clearHistory(workflowId: string): void;
+    /**
+     * Clear all tracking data
+     */
+    clearAll(): void;
+}
+/**
+ * Create a state tracker instance
+ *
+ * @returns StateTracker instance
+ */
+export declare function createStateTracker(): StateTracker;
+//# sourceMappingURL=StateTracker.d.ts.map

package/dist/application/StateTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StateTracker.d.ts","sourceRoot":"","sources":["../../src/application/StateTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,QAAQ,EACR,cAAc,EACd,SAAS,EACV,MAAM,oBAAoB,CAAC;AAG5B;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,SAAS,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,YAAY,EAAE,aAAa,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE9D;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,SAAS,CAA2C;IAC5D,OAAO,CAAC,SAAS,CAAiC;IAElD;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa;IA+B3C;;;;;OAKG;IACH,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAKhE;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,aAAa,EAAE;IAIxD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM,IAAI;IAK9C;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAcvB;;;;;;OAMG;IACH,OAAO,CAAC,eAAe;IAsBvB;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,MAAM;IA4B5C;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IAUtB;;;;OAIG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,QAAQ,IAAI,IAAI;CAIjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,YAAY,CAEjD"}

package/dist/application/StateTracker.js

@@ -0,0 +1,192 @@
+/**
+ * StateTracker - Application Service
+ *
+ * Tracks and persists workflow state
+ *
+ * @see TSK-WORKFLOW-002 - StateTracker
+ * @see REQ-ORCH-002 - State Tracking
+ * @see DES-ORCH-002 - StateTracker Component
+ */
+import { getWorkflowProgress } from '../domain/entities/Workflow.js';
+/**
+ * State Tracker
+ *
+ * Tracks workflow state and emits change events
+ */
+export class StateTracker {
+    snapshots = new Map();
+    listeners = new Set();
+    /**
+     * Take a snapshot of workflow state
+     *
+     * @param workflow - Workflow to snapshot
+     * @returns State snapshot
+     */
+    snapshot(workflow) {
+        const phaseStatuses = {};
+        for (const [phaseType, phase] of workflow.phases) {
+            phaseStatuses[phaseType] = phase.status;
+        }
+        const snapshot = Object.freeze({
+            workflowId: workflow.id,
+            status: workflow.status,
+            currentPhase: workflow.currentPhase,
+            progress: getWorkflowProgress(workflow),
+            phaseStatuses,
+            timestamp: new Date(),
+        });
+        // Store snapshot
+        const history = this.snapshots.get(workflow.id) ?? [];
+        // Check for state change
+        const lastSnapshot = history[history.length - 1];
+        if (lastSnapshot && this.hasStateChanged(lastSnapshot, snapshot)) {
+            this.emitStateChange(workflow.id, lastSnapshot, snapshot);
+        }
+        history.push(snapshot);
+        this.snapshots.set(workflow.id, history);
+        return snapshot;
+    }
+    /**
+     * Get latest snapshot for a workflow
+     *
+     * @param workflowId - Workflow ID
+     * @returns Latest snapshot or undefined
+     */
+    getLatestSnapshot(workflowId) {
+        const history = this.snapshots.get(workflowId);
+        return history?.[history.length - 1];
+    }
+    /**
+     * Get snapshot history for a workflow
+     *
+     * @param workflowId - Workflow ID
+     * @returns Snapshot history
+     */
+    getHistory(workflowId) {
+        return this.snapshots.get(workflowId) ?? [];
+    }
+    /**
+     * Subscribe to state changes
+     *
+     * @param listener - State listener
+     * @returns Unsubscribe function
+     */
+    subscribe(listener) {
+        this.listeners.add(listener);
+        return () => this.listeners.delete(listener);
+    }
+    /**
+     * Check if state has changed
+     *
+     * @param previous - Previous snapshot
+     * @param current - Current snapshot
+     * @returns true if changed
+     */
+    hasStateChanged(previous, current) {
+        if (previous.status !== current.status)
+            return true;
+        if (previous.currentPhase !== current.currentPhase)
+            return true;
+        if (previous.progress !== current.progress)
+            return true;
+        for (const phase of Object.keys(previous.phaseStatuses)) {
+            if (previous.phaseStatuses[phase] !== current.phaseStatuses[phase]) {
+                return true;
+            }
+        }
+        return false;
+    }
+    /**
+     * Emit state change event
+     *
+     * @param workflowId - Workflow ID
+     * @param previous - Previous state
+     * @param current - Current state
+     */
+    emitStateChange(workflowId, previous, current) {
+        const event = {
+            type: 'state-change',
+            workflowId,
+            previousState: previous,
+            currentState: current,
+            timestamp: new Date(),
+        };
+        for (const listener of this.listeners) {
+            try {
+                listener(event);
+            }
+            catch (error) {
+                console.error('State listener error:', error);
+            }
+        }
+    }
+    /**
+     * Format state as display string
+     *
+     * @param snapshot - State snapshot
+     * @returns Formatted string
+     */
+    formatState(snapshot) {
+        const lines = [
+            `📊 **Workflow State**: ${snapshot.workflowId}`,
+            '',
+            `- Status: ${snapshot.status}`,
+            `- Current Phase: ${snapshot.currentPhase ?? 'N/A'}`,
+            `- Progress: ${snapshot.progress}%`,
+            '',
+            '**Phase Status:**',
+        ];
+        const phaseOrder = [
+            'requirements',
+            'design',
+            'task-breakdown',
+            'implementation',
+            'completion',
+        ];
+        for (const phase of phaseOrder) {
+            const status = snapshot.phaseStatuses[phase];
+            const emoji = this.getStatusEmoji(status);
+            lines.push(`- ${phase}: ${emoji} ${status}`);
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get emoji for status
+     *
+     * @param status - Phase status
+     * @returns Emoji
+     */
+    getStatusEmoji(status) {
+        switch (status) {
+            case 'pending': return '⬜';
+            case 'in-progress': return '🔄';
+            case 'completed': return '✅';
+            case 'approved': return '✅✅';
+            default: return '❓';
+        }
+    }
+    /**
+     * Clear history for a workflow
+     *
+     * @param workflowId - Workflow ID
+     */
+    clearHistory(workflowId) {
+        this.snapshots.delete(workflowId);
+    }
+    /**
+     * Clear all tracking data
+     */
+    clearAll() {
+        this.snapshots.clear();
+        this.listeners.clear();
+    }
+}
+/**
+ * Create a state tracker instance
+ *
+ * @returns StateTracker instance
+ */
+export function createStateTracker() {
+    return new StateTracker();
+}
+//# sourceMappingURL=StateTracker.js.map

package/dist/application/StateTracker.js.map

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

package/dist/application/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Application Layer barrel export
+ *
+ * @see TSK-WORKFLOW-001 - PhaseController
+ * @see TSK-WORKFLOW-002 - StateTracker
+ * @see TSK-WORKFLOW-003 - QualityGateRunner
+ */
+export { type PhaseControllerConfig, type PhaseControllerResult, PhaseController, createPhaseController, } from './PhaseController.js';
+export { type StateSnapshot, type StateChangeEvent, type StateListener, StateTracker, createStateTracker, } from './StateTracker.js';
+export { type QualityGateRunnerConfig, type GateRunResult, QualityGateRunner, createQualityGateRunner, } from './QualityGateRunner.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/application/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,qBAAqB,EAC1B,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,YAAY,EACZ,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,aAAa,EAClB,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}

package/dist/application/index.js

@@ -0,0 +1,11 @@
+/**
+ * Application Layer barrel export
+ *
+ * @see TSK-WORKFLOW-001 - PhaseController
+ * @see TSK-WORKFLOW-002 - StateTracker
+ * @see TSK-WORKFLOW-003 - QualityGateRunner
+ */
+export { PhaseController, createPhaseController, } from './PhaseController.js';
+export { StateTracker, createStateTracker, } from './StateTracker.js';
+export { QualityGateRunner, createQualityGateRunner, } from './QualityGateRunner.js';
+//# sourceMappingURL=index.js.map

package/dist/application/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAGL,eAAe,EACf,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAIL,YAAY,EACZ,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAGL,iBAAiB,EACjB,uBAAuB,GACxB,MAAM,wBAAwB,CAAC"}