mycontext-cli 2.0.27 → 2.0.29

package/dist/services/TriggerLogger.d.ts

@@ -0,0 +1,101 @@
+export interface TriggerEvent {
+    id: string;
+    type: "context-change" | "schema-change" | "component-refinement" | "approval-change";
+    timestamp: string;
+    description: string;
+    affectedComponents: string[];
+    userAction: string;
+    metadata?: Record<string, any>;
+}
+export interface TriggerLog {
+    events: TriggerEvent[];
+    lastUpdated: string;
+    version: string;
+}
+export declare class TriggerLogger {
+    private logPath;
+    /**
+     * Log a trigger event
+     */
+    logTrigger(type: TriggerEvent["type"], description: string, affectedComponents: string[], userAction: string, metadata?: Record<string, any>): Promise<void>;
+    /**
+     * Log context file changes
+     */
+    logContextChange(changedFiles: string[], userAction?: string): Promise<void>;
+    /**
+     * Log schema changes
+     */
+    logSchemaChange(userAction?: string): Promise<void>;
+    /**
+     * Log component refinement
+     */
+    logComponentRefinement(componentName: string, refinementType: "in-place" | "context-update", userAction?: string): Promise<void>;
+    /**
+     * Log approval changes
+     */
+    logApprovalChange(featureId: string, oldApproval: boolean | null, newApproval: boolean | null, userAction?: string): Promise<void>;
+    /**
+     * Get recent trigger events
+     */
+    getRecentEvents(limit?: number): Promise<TriggerEvent[]>;
+    /**
+     * Get events by type
+     */
+    getEventsByType(type: TriggerEvent["type"]): Promise<TriggerEvent[]>;
+    /**
+     * Get events affecting a specific component
+     */
+    getEventsForComponent(componentName: string): Promise<TriggerEvent[]>;
+    /**
+     * Check if component needs regeneration based on triggers
+     */
+    needsRegeneration(componentName: string): Promise<boolean>;
+    /**
+     * Get regeneration recommendations
+     */
+    getRegenerationRecommendations(): Promise<{
+        shouldRegenerate: string[];
+        reason: string;
+    }>;
+    /**
+     * Clear old events (keep last 50)
+     */
+    cleanupOldEvents(): Promise<void>;
+    /**
+     * Load trigger log from file
+     */
+    private loadLog;
+    /**
+     * Save trigger log to file
+     */
+    private saveLog;
+    /**
+     * Generate unique event ID
+     */
+    private generateEventId;
+    /**
+     * Get affected components from context file changes
+     */
+    private getAffectedComponentsFromContext;
+    /**
+     * Get affected components from schema changes
+     */
+    private getAffectedComponentsFromSchema;
+    /**
+     * Get affected components from feature approval changes
+     */
+    private getAffectedComponentsFromFeature;
+    /**
+     * Get all component names from component list
+     */
+    private getAllComponentNames;
+    /**
+     * Display trigger log summary
+     */
+    displaySummary(): Promise<void>;
+    /**
+     * Get human-readable time ago
+     */
+    private getTimeAgo;
+}
+//# sourceMappingURL=TriggerLogger.d.ts.map

package/dist/services/TriggerLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TriggerLogger.d.ts","sourceRoot":"","sources":["../../src/services/TriggerLogger.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EACA,gBAAgB,GAChB,eAAe,GACf,sBAAsB,GACtB,iBAAiB,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAiC;IAEhD;;OAEG;IACG,UAAU,CACd,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAC1B,WAAW,EAAE,MAAM,EACnB,kBAAkB,EAAE,MAAM,EAAE,EAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC7B,OAAO,CAAC,IAAI,CAAC;IAkBhB;;OAEG;IACG,gBAAgB,CACpB,YAAY,EAAE,MAAM,EAAE,EACtB,UAAU,GAAE,MAAgC,GAC3C,OAAO,CAAC,IAAI,CAAC;IAchB;;OAEG;IACG,eAAe,CAAC,UAAU,GAAE,MAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3E;;OAEG;IACG,sBAAsB,CAC1B,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,UAAU,GAAG,gBAAgB,EAC7C,UAAU,GAAE,MAA4B,GACvC,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,iBAAiB,CACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,OAAO,GAAG,IAAI,EAC3B,WAAW,EAAE,OAAO,GAAG,IAAI,EAC3B,UAAU,GAAE,MAAmC,GAC9C,OAAO,CAAC,IAAI,CAAC;IAchB;;OAEG;IACG,eAAe,CAAC,KAAK,GAAE,MAAW,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAUlE;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAK1E;;OAEG;IACG,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAO3E;;OAEG;IACG,iBAAiB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAahE;;OAEG;IACG,8BAA8B,IAAI,OAAO,CAAC;QAC9C,gBAAgB,EAAE,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAkBF;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAYvC;;OAEG;YACW,OAAO;IAkBrB;;OAEG;YACW,OAAO;IAMrB;;OAEG;IACH,OAAO,CAAC,eAAe;IAIvB;;OAEG;YACW,gCAAgC;IAsB9C;;OAEG;YACW,+BAA+B;IAK7C;;OAEG;YACW,gCAAgC;IAS9C;;OAEG;YACW,oBAAoB;IA8BlC;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAmCrC;;OAEG;IACH,OAAO,CAAC,UAAU;CAanB"}

package/dist/services/TriggerLogger.js

@@ -0,0 +1,263 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TriggerLogger = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+class TriggerLogger {
+    constructor() {
+        this.logPath = ".mycontext/trigger-log.json";
+    }
+    /**
+     * Log a trigger event
+     */
+    async logTrigger(type, description, affectedComponents, userAction, metadata) {
+        const event = {
+            id: this.generateEventId(),
+            type,
+            timestamp: new Date().toISOString(),
+            description,
+            affectedComponents,
+            userAction,
+            metadata,
+        };
+        const log = await this.loadLog();
+        log.events.push(event);
+        log.lastUpdated = new Date().toISOString();
+        await this.saveLog(log);
+    }
+    /**
+     * Log context file changes
+     */
+    async logContextChange(changedFiles, userAction = "Context files updated") {
+        const affectedComponents = await this.getAffectedComponentsFromContext(changedFiles);
+        await this.logTrigger("context-change", `Context files changed: ${changedFiles.join(", ")}`, affectedComponents, userAction, { changedFiles });
+    }
+    /**
+     * Log schema changes
+     */
+    async logSchemaChange(userAction = "Schema updated") {
+        const affectedComponents = await this.getAffectedComponentsFromSchema();
+        await this.logTrigger("schema-change", "InstantDB schema modified", affectedComponents, userAction, { schemaChanged: true });
+    }
+    /**
+     * Log component refinement
+     */
+    async logComponentRefinement(componentName, refinementType, userAction = "Component refined") {
+        await this.logTrigger("component-refinement", `Component ${componentName} refined via ${refinementType}`, [componentName], userAction, { refinementType, componentName });
+    }
+    /**
+     * Log approval changes
+     */
+    async logApprovalChange(featureId, oldApproval, newApproval, userAction = "Feature approval changed") {
+        const affectedComponents = await this.getAffectedComponentsFromFeature(featureId);
+        await this.logTrigger("approval-change", `Feature ${featureId} approval changed from ${oldApproval} to ${newApproval}`, affectedComponents, userAction, { featureId, oldApproval, newApproval });
+    }
+    /**
+     * Get recent trigger events
+     */
+    async getRecentEvents(limit = 10) {
+        const log = await this.loadLog();
+        return log.events
+            .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime())
+            .slice(0, limit);
+    }
+    /**
+     * Get events by type
+     */
+    async getEventsByType(type) {
+        const log = await this.loadLog();
+        return log.events.filter((event) => event.type === type);
+    }
+    /**
+     * Get events affecting a specific component
+     */
+    async getEventsForComponent(componentName) {
+        const log = await this.loadLog();
+        return log.events.filter((event) => event.affectedComponents.includes(componentName));
+    }
+    /**
+     * Check if component needs regeneration based on triggers
+     */
+    async needsRegeneration(componentName) {
+        const events = await this.getEventsForComponent(componentName);
+        // Check if there are any recent trigger events
+        const recentEvents = events.filter((event) => {
+            const eventTime = new Date(event.timestamp).getTime();
+            const oneHourAgo = Date.now() - 60 * 60 * 1000;
+            return eventTime > oneHourAgo;
+        });
+        return recentEvents.length > 0;
+    }
+    /**
+     * Get regeneration recommendations
+     */
+    async getRegenerationRecommendations() {
+        const recentEvents = await this.getRecentEvents(5);
+        const shouldRegenerate = [];
+        let reason = "";
+        for (const event of recentEvents) {
+            if (event.type === "context-change" || event.type === "schema-change") {
+                shouldRegenerate.push(...event.affectedComponents);
+                reason = `Recent ${event.type} detected`;
+            }
+        }
+        return {
+            shouldRegenerate: [...new Set(shouldRegenerate)], // Remove duplicates
+            reason,
+        };
+    }
+    /**
+     * Clear old events (keep last 50)
+     */
+    async cleanupOldEvents() {
+        const log = await this.loadLog();
+        log.events = log.events
+            .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime())
+            .slice(0, 50);
+        await this.saveLog(log);
+    }
+    /**
+     * Load trigger log from file
+     */
+    async loadLog() {
+        try {
+            const fs = require("fs-extra");
+            if (await fs.pathExists(this.logPath)) {
+                const content = await fs.readFile(this.logPath, "utf8");
+                return JSON.parse(content);
+            }
+        }
+        catch (error) {
+            // If file doesn't exist or is corrupted, return empty log
+        }
+        return {
+            events: [],
+            lastUpdated: new Date().toISOString(),
+            version: "1.0",
+        };
+    }
+    /**
+     * Save trigger log to file
+     */
+    async saveLog(log) {
+        const fs = require("fs-extra");
+        await fs.ensureDir(".mycontext");
+        await fs.writeFile(this.logPath, JSON.stringify(log, null, 2));
+    }
+    /**
+     * Generate unique event ID
+     */
+    generateEventId() {
+        return `event_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    }
+    /**
+     * Get affected components from context file changes
+     */
+    async getAffectedComponentsFromContext(changedFiles) {
+        // This would analyze which components are affected by context changes
+        // For now, return all components if PRD or features files changed
+        const criticalFiles = [
+            "01a-features.md",
+            "01b-user-flows.md",
+            "01c-edge-cases.md",
+        ];
+        const hasCriticalChange = changedFiles.some((file) => criticalFiles.some((critical) => file.includes(critical)));
+        if (hasCriticalChange) {
+            // Return all components - this is a conservative approach
+            return await this.getAllComponentNames();
+        }
+        return [];
+    }
+    /**
+     * Get affected components from schema changes
+     */
+    async getAffectedComponentsFromSchema() {
+        // Schema changes typically affect all components that use data
+        return await this.getAllComponentNames();
+    }
+    /**
+     * Get affected components from feature approval changes
+     */
+    async getAffectedComponentsFromFeature(featureId) {
+        // Map feature ID to component name
+        return [
+            featureId.replace(/-/g, " ").replace(/\b\w/g, (l) => l.toUpperCase()),
+        ];
+    }
+    /**
+     * Get all component names from component list
+     */
+    async getAllComponentNames() {
+        try {
+            const fs = require("fs-extra");
+            const componentListPath = ".mycontext/component-list.json";
+            if (await fs.pathExists(componentListPath)) {
+                const content = await fs.readFile(componentListPath, "utf8");
+                const componentList = JSON.parse(content);
+                // Extract component names from hierarchical structure
+                const names = [];
+                const extractNames = (item) => {
+                    if (item.components) {
+                        item.components.forEach((comp) => names.push(comp.name));
+                    }
+                    if (item.children) {
+                        item.children.forEach(extractNames);
+                    }
+                };
+                extractNames(componentList);
+                return names;
+            }
+        }
+        catch (error) {
+            // Return empty array if component list not found
+        }
+        return [];
+    }
+    /**
+     * Display trigger log summary
+     */
+    async displaySummary() {
+        const recentEvents = await this.getRecentEvents(5);
+        const recommendations = await this.getRegenerationRecommendations();
+        console.log(chalk_1.default.blue("\n📋 Trigger Log Summary"));
+        console.log(chalk_1.default.gray("Recent events affecting your components:"));
+        if (recentEvents.length === 0) {
+            console.log(chalk_1.default.green("   ✅ No recent trigger events"));
+            return;
+        }
+        recentEvents.forEach((event, index) => {
+            const timeAgo = this.getTimeAgo(event.timestamp);
+            console.log(chalk_1.default.yellow(`   ${index + 1}. ${event.description}`));
+            console.log(chalk_1.default.gray(`      ${timeAgo} - ${event.userAction}`));
+            if (event.affectedComponents.length > 0) {
+                console.log(chalk_1.default.gray(`      Affects: ${event.affectedComponents.join(", ")}`));
+            }
+        });
+        if (recommendations.shouldRegenerate.length > 0) {
+            console.log(chalk_1.default.yellow(`\n⚠️  ${recommendations.reason}`));
+            console.log(chalk_1.default.blue(`   Consider regenerating: ${recommendations.shouldRegenerate.join(", ")}`));
+        }
+    }
+    /**
+     * Get human-readable time ago
+     */
+    getTimeAgo(timestamp) {
+        const now = new Date().getTime();
+        const eventTime = new Date(timestamp).getTime();
+        const diffMs = now - eventTime;
+        const diffMins = Math.floor(diffMs / (1000 * 60));
+        const diffHours = Math.floor(diffMs / (1000 * 60 * 60));
+        const diffDays = Math.floor(diffMs / (1000 * 60 * 60 * 24));
+        if (diffMins < 1)
+            return "just now";
+        if (diffMins < 60)
+            return `${diffMins}m ago`;
+        if (diffHours < 24)
+            return `${diffHours}h ago`;
+        return `${diffDays}d ago`;
+    }
+}
+exports.TriggerLogger = TriggerLogger;
+//# sourceMappingURL=TriggerLogger.js.map

package/dist/services/TriggerLogger.js.map

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

package/dist/types/design-pipeline.d.ts

@@ -0,0 +1,300 @@
+/**
+ * Design Pipeline Types
+ *
+ * Defines interfaces for all 8 phases of the design reasoning pipeline
+ * that replicates an internal design process for rich, contextual component generation.
+ */
+export interface FunctionalSummary {
+    app_name: string;
+    core_purpose: string;
+    key_features: string[];
+    primary_user_actions: string[];
+    platform: string;
+    technical_requirements: string[];
+    complexity_level: "low" | "medium" | "high";
+    user_personas?: string[];
+    business_goals?: string[];
+    success_metrics?: string[];
+}
+export interface ProjectScope {
+    build_scope: "single_component" | "ui_page" | "full_app";
+    reason: string;
+    expected_outputs: string[];
+    estimated_screens?: number;
+    estimated_components?: number;
+    development_phases?: string[];
+    technical_complexity?: "simple" | "moderate" | "complex";
+}
+export interface ContextGaps {
+    missing: string[];
+    recommended_next_action: string;
+    visual_direction_needed?: boolean;
+    tone_guidance_needed?: boolean;
+    accessibility_requirements?: string[];
+    interaction_patterns?: string[];
+    brand_consistency?: string[];
+}
+export interface InspirationSource {
+    name: string;
+    style: string;
+    url?: string;
+    reasoning?: string;
+}
+export interface DesignBrief {
+    theme: "dark" | "light" | "mixed";
+    inspiration_sources: InspirationSource[];
+    blended_style: string;
+    primary_color: string;
+    support_colors: string[];
+    typography: {
+        heading: string;
+        body: string;
+        mono?: string;
+    };
+    ui_principles: string[];
+    motion_style: string;
+    personality_keywords: string[];
+    emotional_tone: string;
+    target_audience: string;
+    accessibility_focus?: string[];
+}
+export interface ColorPalette {
+    primary: string;
+    secondary?: string;
+    accent?: string;
+    background: string;
+    surface: string;
+    text: string;
+    text_muted: string;
+    border?: string;
+    success?: string;
+    warning?: string;
+    error?: string;
+    info?: string;
+}
+export interface TypographyScale {
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    "2xl": string;
+    "3xl": string;
+    "4xl": string;
+}
+export interface SpacingScale {
+    xs: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    "2xl": string;
+    "3xl": string;
+    "4xl": string;
+}
+export interface BorderRadius {
+    none: string;
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    full: string;
+}
+export interface ShadowSystem {
+    sm: string;
+    md: string;
+    lg: string;
+    xl: string;
+    inner?: string;
+}
+export interface MotionTokens {
+    duration: {
+        fast: string;
+        normal: string;
+        slow: string;
+    };
+    easing: {
+        linear: string;
+        ease_in: string;
+        ease_out: string;
+        ease_in_out: string;
+    };
+}
+export interface VisualSystem {
+    colors: ColorPalette;
+    typography: {
+        font_families: {
+            heading: string;
+            body: string;
+            mono: string;
+        };
+        scale: TypographyScale;
+        weights: {
+            normal: string;
+            medium: string;
+            semibold: string;
+            bold: string;
+        };
+    };
+    spacing: SpacingScale;
+    radii: BorderRadius;
+    shadows: ShadowSystem;
+    motion: MotionTokens;
+    breakpoints: {
+        sm: string;
+        md: string;
+        lg: string;
+        xl: string;
+    };
+}
+export interface ComponentProps {
+    name: string;
+    type: string;
+    required: boolean;
+    description: string;
+    default_value?: any;
+}
+export interface ComponentDefinition {
+    name: string;
+    description: string;
+    type: "layout" | "form" | "display" | "navigation" | "feedback" | "overlay";
+    props: ComponentProps[];
+    interactions: string[];
+    states: string[];
+    accessibility_requirements: string[];
+    responsive_behavior: string;
+    related_components: string[];
+}
+export interface ScreenDefinition {
+    name: string;
+    description: string;
+    purpose: string;
+    components: string[];
+    layout_type: "single_column" | "multi_column" | "grid" | "dashboard" | "modal";
+    navigation_flow: string[];
+    user_journey_position: "entry" | "main" | "secondary" | "exit";
+}
+export interface ComponentHierarchy {
+    screens: ScreenDefinition[];
+    components: ComponentDefinition[];
+    design_patterns: string[];
+    interaction_flows: string[];
+    state_management: string[];
+    data_flow: string[];
+}
+export interface ImplementationPlan {
+    framework: string;
+    pages: string[];
+    state_management: string;
+    build_requirements: string[];
+    data_persistence: string;
+    notifications?: string;
+    authentication?: string;
+    api_integration?: string;
+    deployment_strategy?: string;
+    performance_optimizations: string[];
+    accessibility_implementation: string[];
+    testing_strategy: string[];
+    monitoring_analytics?: string[];
+}
+export interface DesignIntent {
+    visual_philosophy: string;
+    design_anchors: string[];
+    user_experience_goals: string[];
+    brand_alignment: string;
+    technical_constraints: string[];
+    scalability_considerations: string[];
+    maintenance_guidelines: string[];
+    success_criteria: string[];
+}
+export interface DesignManifest {
+    version: string;
+    generated_at: string;
+    project_name: string;
+    phases: {
+        functional_summary: FunctionalSummary;
+        project_scope: ProjectScope;
+        context_gaps: ContextGaps;
+        design_brief: DesignBrief;
+        visual_system: VisualSystem;
+        component_hierarchy: ComponentHierarchy;
+        implementation_plan: ImplementationPlan;
+        design_intent: DesignIntent;
+        intent_validation?: {
+            validation_report: import("./intent-dictionary").IntentValidationReport;
+            enriched_intents: import("./intent-dictionary").EnrichedComponentSpec[];
+            clarifications: import("./intent-dictionary").ClarificationResponse[];
+        };
+    };
+    metadata: {
+        ai_model_used?: string;
+        confidence_scores: Record<string, number>;
+        fallbacks_used: string[];
+        generation_time_ms: number;
+    };
+}
+export interface DesignPipelineInput {
+    prd: string;
+    types?: string;
+    branding?: string;
+    component_list?: string;
+    project_path: string;
+    force_regenerate?: boolean;
+    target_phases?: string[];
+}
+export interface DesignPipelineOutput {
+    manifest: DesignManifest;
+    success: boolean;
+    warnings: string[];
+    errors: string[];
+    fallbacks_used: string[];
+}
+export interface DesignTemplate {
+    name: string;
+    description: string;
+    category: "dashboard" | "ecommerce" | "saas" | "mobile" | "content" | "custom";
+    phases: Partial<DesignManifest["phases"]>;
+    use_cases: string[];
+    complexity: "low" | "medium" | "high";
+}
+export interface FallbackResult {
+    success: boolean;
+    data: any;
+    confidence: number;
+    method: "ai_generation" | "rule_based" | "template_based" | "default";
+    warnings: string[];
+}
+export interface EnrichedContext {
+    project_summary: FunctionalSummary;
+    design_system: VisualSystem;
+    design_intent: DesignIntent;
+    component_architecture: ComponentHierarchy;
+    technical_context: {
+        prd: string;
+        types: string;
+        brand: string;
+    };
+    implementation_guidelines: ImplementationPlan;
+    design_principles: string[];
+    visual_tokens: Record<string, any>;
+    interaction_patterns: string[];
+    accessibility_requirements: string[];
+    enriched_intents?: import("./intent-dictionary").EnrichedComponentSpec[];
+    intent_validation_report?: import("./intent-dictionary").IntentValidationReport;
+    intent_clarifications?: import("./intent-dictionary").ClarificationResponse[];
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    suggestions: string[];
+    confidence_score: number;
+}
+export interface PhaseValidation {
+    phase_name: string;
+    result: ValidationResult;
+    required_fields: string[];
+    missing_fields: string[];
+    quality_indicators: Record<string, any>;
+}
+//# sourceMappingURL=design-pipeline.d.ts.map