mycontext-cli 2.0.28 → 2.0.30

package/dist/services/ContextValidator.js

@@ -0,0 +1,433 @@
+"use strict";
+/**
+ * Context Validator Service
+ *
+ * Detects gaps in context files and tracks auto-generated features
+ * to ensure user approval before proceeding with generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ContextValidator = void 0;
+class ContextValidator {
+    constructor() {
+        this.gaps = [];
+        this.autoGeneratedFeatures = [];
+    }
+    /**
+     * Validate context files for completeness and detect gaps
+     */
+    async validateContext(contextFiles) {
+        this.gaps = [];
+        this.autoGeneratedFeatures = [];
+        // Analyze PRD for gaps
+        if (contextFiles.prd) {
+            this.analyzePRDGaps(contextFiles.prd);
+        }
+        // Analyze description for gaps
+        if (contextFiles.description) {
+            this.analyzeDescriptionGaps(contextFiles.description);
+        }
+        // Analyze tech stack for gaps
+        if (contextFiles.techStack) {
+            this.analyzeTechStackGaps(contextFiles.techStack);
+        }
+        // Deduplicate gaps by ID
+        this.gaps = this.deduplicateGaps(this.gaps);
+        // Deduplicate features by ID
+        this.autoGeneratedFeatures = this.deduplicateFeatures(this.autoGeneratedFeatures);
+        const hasCriticalGaps = this.gaps.some((gap) => gap.category === "critical");
+        const canProceed = !hasCriticalGaps;
+        return {
+            gaps: this.gaps,
+            autoGeneratedFeatures: this.autoGeneratedFeatures,
+            hasCriticalGaps,
+            canProceed,
+        };
+    }
+    /**
+     * Deduplicate gaps by ID
+     */
+    deduplicateGaps(gaps) {
+        const seen = new Set();
+        return gaps.filter((gap) => {
+            if (seen.has(gap.id))
+                return false;
+            seen.add(gap.id);
+            return true;
+        });
+    }
+    /**
+     * Deduplicate features by ID
+     */
+    deduplicateFeatures(features) {
+        const seen = new Set();
+        return features.filter((feature) => {
+            if (seen.has(feature.id))
+                return false;
+            seen.add(feature.id);
+            return true;
+        });
+    }
+    /**
+     * Analyze PRD for missing critical information
+     */
+    analyzePRDGaps(prd) {
+        const prdLower = prd.toLowerCase();
+        // Check for game-related gaps
+        if (this.containsGameKeywords(prdLower)) {
+            this.checkGameGaps(prdLower, "prd");
+        }
+        // Check for user authentication gaps
+        if (this.mentionsUsers(prdLower) && !this.mentionsAuth(prdLower)) {
+            this.gaps.push({
+                id: "auth-method",
+                category: "critical",
+                question: "How should users authenticate?",
+                context: "prd",
+                suggestedAnswers: [
+                    "Email/password",
+                    "Social login (Google, GitHub)",
+                    "Magic link",
+                    "No authentication needed",
+                ],
+                reasoning: "PRD mentions users but no authentication method specified",
+            });
+        }
+        // Check for database gaps
+        if (this.mentionsDataPersistence(prdLower) &&
+            !this.mentionsDatabase(prdLower)) {
+            this.gaps.push({
+                id: "database-choice",
+                category: "critical",
+                question: "What database should be used?",
+                context: "prd",
+                suggestedAnswers: [
+                    "InstantDB (recommended)",
+                    "PostgreSQL",
+                    "MongoDB",
+                    "SQLite",
+                    "No database needed",
+                ],
+                reasoning: "PRD mentions data persistence but no database specified",
+            });
+        }
+        // Check for payment gaps
+        if (this.mentionsPayments(prdLower)) {
+            this.gaps.push({
+                id: "payment-method",
+                category: "critical",
+                question: "What payment method should be integrated?",
+                context: "prd",
+                suggestedAnswers: [
+                    "Stripe",
+                    "PayPal",
+                    "Apple Pay",
+                    "Google Pay",
+                    "Other",
+                ],
+                reasoning: "PRD mentions payments but no payment method specified",
+            });
+        }
+    }
+    /**
+     * Analyze initial description for gaps
+     */
+    analyzeDescriptionGaps(description) {
+        const descLower = description.toLowerCase();
+        // Check for vague game descriptions
+        if (this.isVagueGameDescription(descLower)) {
+            this.checkGameGaps(descLower, "description");
+        }
+        // Check for vague app descriptions
+        if (this.isVagueAppDescription(descLower)) {
+            this.gaps.push({
+                id: "app-purpose",
+                category: "critical",
+                question: "What is the main purpose of this app?",
+                context: "description",
+                suggestedAnswers: [
+                    "Productivity tool",
+                    "Social platform",
+                    "E-commerce store",
+                    "Educational platform",
+                    "Entertainment app",
+                    "Other",
+                ],
+                reasoning: "Description is too vague to determine app purpose",
+            });
+        }
+        // Check for missing target audience
+        if (this.mentionsUsers(descLower) &&
+            !this.mentionsTargetAudience(descLower)) {
+            this.gaps.push({
+                id: "target-audience",
+                category: "important",
+                question: "Who is the target audience?",
+                context: "description",
+                suggestedAnswers: [
+                    "General public",
+                    "Business professionals",
+                    "Students",
+                    "Developers",
+                    "Specific industry",
+                    "Other",
+                ],
+                reasoning: "App mentions users but target audience is unclear",
+            });
+        }
+    }
+    /**
+     * Analyze tech stack for gaps
+     */
+    analyzeTechStackGaps(techStack) {
+        const techLower = techStack.toLowerCase();
+        // Check for missing deployment strategy
+        if (!this.mentionsDeployment(techLower)) {
+            this.gaps.push({
+                id: "deployment-strategy",
+                category: "important",
+                question: "How should the app be deployed?",
+                context: "tech-stack",
+                suggestedAnswers: [
+                    "Vercel (recommended for Next.js)",
+                    "Netlify",
+                    "AWS",
+                    "Railway",
+                    "Self-hosted",
+                    "Other",
+                ],
+                reasoning: "Tech stack specified but no deployment strategy mentioned",
+            });
+        }
+        // Check for missing environment configuration
+        if (!this.mentionsEnvironmentConfig(techLower)) {
+            this.gaps.push({
+                id: "environment-config",
+                category: "optional",
+                question: "What environment variables are needed?",
+                context: "tech-stack",
+                reasoning: "Consider adding environment configuration for API keys and secrets",
+            });
+        }
+    }
+    /**
+     * Check for game-specific gaps
+     */
+    checkGameGaps(text, context) {
+        // Game type gap
+        this.gaps.push({
+            id: "game-type",
+            category: "critical",
+            question: "What type of game is this?",
+            context: context,
+            suggestedAnswers: [
+                "Turn-based (Tic-tac-toe, Chess)",
+                "Real-time (Racing, Shooting)",
+                "Puzzle (Matching, Strategy)",
+                "Card game",
+                "Board game",
+                "Other",
+            ],
+            reasoning: "Game mentioned but type not specified",
+        });
+        // Game rules gap
+        this.gaps.push({
+            id: "game-rules",
+            category: "critical",
+            question: "What are the core game rules?",
+            context: context,
+            reasoning: "Game rules need to be defined for proper implementation",
+        });
+        // Multiplayer gap
+        if (this.mentionsMultiplayer(text)) {
+            this.autoGeneratedFeatures.push({
+                id: "realtime-multiplayer",
+                feature: "Real-time multiplayer with Socket.io",
+                reasoning: "User mentioned playing against each other",
+                confidence: "medium",
+                contextSource: "description",
+            });
+        }
+    }
+    /**
+     * Helper methods for text analysis
+     */
+    containsGameKeywords(text) {
+        const gameKeywords = [
+            "game",
+            "play",
+            "player",
+            "score",
+            "win",
+            "lose",
+            "match",
+            "tournament",
+        ];
+        return gameKeywords.some((keyword) => text.includes(keyword));
+    }
+    mentionsUsers(text) {
+        const userKeywords = [
+            "user",
+            "users",
+            "player",
+            "players",
+            "member",
+            "members",
+            "account",
+            "accounts",
+        ];
+        return userKeywords.some((keyword) => text.includes(keyword));
+    }
+    mentionsAuth(text) {
+        const authKeywords = [
+            "login",
+            "signin",
+            "signup",
+            "register",
+            "authentication",
+            "auth",
+            "password",
+            "oauth",
+        ];
+        return authKeywords.some((keyword) => text.includes(keyword));
+    }
+    mentionsDataPersistence(text) {
+        const dataKeywords = [
+            "save",
+            "store",
+            "data",
+            "database",
+            "persist",
+            "memory",
+            "history",
+            "record",
+        ];
+        return dataKeywords.some((keyword) => text.includes(keyword));
+    }
+    mentionsDatabase(text) {
+        const dbKeywords = [
+            "database",
+            "db",
+            "postgres",
+            "mysql",
+            "mongodb",
+            "sqlite",
+            "instantdb",
+            "supabase",
+        ];
+        return dbKeywords.some((keyword) => text.includes(keyword));
+    }
+    mentionsPayments(text) {
+        const paymentKeywords = [
+            "payment",
+            "pay",
+            "buy",
+            "purchase",
+            "subscription",
+            "billing",
+            "stripe",
+            "paypal",
+        ];
+        return paymentKeywords.some((keyword) => text.includes(keyword));
+    }
+    isVagueGameDescription(text) {
+        const vaguePatterns = [
+            "fun game",
+            "simple game",
+            "game where",
+            "play against",
+            "multiplayer game",
+        ];
+        return vaguePatterns.some((pattern) => text.includes(pattern));
+    }
+    isVagueAppDescription(text) {
+        const vaguePatterns = [
+            "simple app",
+            "basic app",
+            "useful app",
+            "helpful app",
+            "cool app",
+        ];
+        return vaguePatterns.some((pattern) => text.includes(pattern));
+    }
+    mentionsTargetAudience(text) {
+        const audienceKeywords = [
+            "for",
+            "target",
+            "audience",
+            "users",
+            "people",
+            "business",
+            "students",
+            "developers",
+        ];
+        return audienceKeywords.some((keyword) => text.includes(keyword));
+    }
+    mentionsMultiplayer(text) {
+        const multiplayerKeywords = [
+            "against each other",
+            "multiplayer",
+            "together",
+            "compete",
+            "versus",
+            "vs",
+        ];
+        return multiplayerKeywords.some((keyword) => text.includes(keyword));
+    }
+    mentionsDeployment(text) {
+        const deploymentKeywords = [
+            "deploy",
+            "hosting",
+            "vercel",
+            "netlify",
+            "aws",
+            "railway",
+            "production",
+        ];
+        return deploymentKeywords.some((keyword) => text.includes(keyword));
+    }
+    mentionsEnvironmentConfig(text) {
+        const envKeywords = [
+            "environment",
+            "env",
+            "config",
+            "variables",
+            "secrets",
+            "api key",
+        ];
+        return envKeywords.some((keyword) => text.includes(keyword));
+    }
+    /**
+     * Get gaps by category
+     */
+    getGapsByCategory(category) {
+        return this.gaps.filter((gap) => gap.category === category);
+    }
+    /**
+     * Get auto-generated features by confidence
+     */
+    getFeaturesByConfidence(confidence) {
+        return this.autoGeneratedFeatures.filter((feature) => feature.confidence === confidence);
+    }
+    /**
+     * Add auto-generated feature
+     */
+    addAutoGeneratedFeature(feature) {
+        const id = this.generateFeatureId(feature.feature);
+        this.autoGeneratedFeatures.push({
+            id,
+            ...feature,
+        });
+    }
+    /**
+     * Generate unique ID for feature
+     */
+    generateFeatureId(feature) {
+        return feature
+            .toLowerCase()
+            .replace(/[^a-z0-9\s]/g, "")
+            .replace(/\s+/g, "-")
+            .substring(0, 50);
+    }
+}
+exports.ContextValidator = ContextValidator;
+//# sourceMappingURL=ContextValidator.js.map

package/dist/services/ContextValidator.js.map

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

package/dist/services/MutationLogger.d.ts

@@ -0,0 +1,54 @@
+export interface ComponentMutation {
+    id: string;
+    componentPath: string;
+    timestamp: string;
+    actor: "human" | "ai" | "system";
+    before: string;
+    after: string;
+    diff: string;
+    patch: string;
+    chainOfThought?: string;
+    confidence?: number;
+    riskFlags: string[];
+    tests: {
+        unit: string[];
+        lint: string[];
+        typecheck: string[];
+        results: {
+            unit: {
+                passed: number;
+                failed: number;
+                details: string[];
+            };
+            lint: {
+                passed: boolean;
+                details: string[];
+            };
+            typecheck: {
+                passed: boolean;
+                details: string[];
+            };
+        };
+    };
+    status: "proposed" | "applied" | "rejected";
+    appliedAt?: string;
+    rejectedAt?: string;
+    rejectionReason?: string;
+}
+export declare class MutationLogger {
+    private mutationsDir;
+    constructor(contextDir: string);
+    private ensureMutationsDir;
+    private getComponentMutationsDir;
+    private generateMutationId;
+    logMutation(mutation: Omit<ComponentMutation, "id" | "timestamp">): Promise<string>;
+    getMutationHistory(componentPath: string): Promise<ComponentMutation[]>;
+    getLastApprovedVersion(componentPath: string): Promise<ComponentMutation | null>;
+    getLastProposedVersion(componentPath: string): Promise<ComponentMutation | null>;
+    updateMutationStatus(mutationId: string, status: "applied" | "rejected", reason?: string): Promise<void>;
+    private getAllMutations;
+    createMutationFromRefinement(componentPath: string, before: string, after: string, chainOfThought: string, confidence: number, riskFlags?: string[]): Promise<string>;
+    getMutationById(mutationId: string): Promise<ComponentMutation | null>;
+    deleteMutation(mutationId: string): Promise<void>;
+}
+//# sourceMappingURL=MutationLogger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MutationLogger.d.ts","sourceRoot":"","sources":["../../src/services/MutationLogger.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,OAAO,GAAG,IAAI,GAAG,QAAQ,CAAC;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,IAAI,EAAE,MAAM,EAAE,CAAC;QACf,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,OAAO,EAAE;YACP,IAAI,EAAE;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;YAC5D,IAAI,EAAE;gBAAE,MAAM,EAAE,OAAO,CAAC;gBAAC,OAAO,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;YAC7C,SAAS,EAAE;gBAAE,MAAM,EAAE,OAAO,CAAC;gBAAC,OAAO,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC;SACnD,CAAC;KACH,CAAC;IACF,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,UAAU,CAAC;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,YAAY,CAAS;gBAEjB,UAAU,EAAE,MAAM;IAK9B,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,wBAAwB;IAQhC,OAAO,CAAC,kBAAkB;IAMpB,WAAW,CACf,QAAQ,EAAE,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,WAAW,CAAC,GACpD,OAAO,CAAC,MAAM,CAAC;IAmBZ,kBAAkB,CACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,EAAE,CAAC;IA6BzB,sBAAsB,CAC1B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAc9B,sBAAsB,CAC1B,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAc9B,oBAAoB,CACxB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,SAAS,GAAG,UAAU,EAC9B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,IAAI,CAAC;YA2BF,eAAe;IAmBvB,4BAA4B,CAChC,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,MAAM,EACtB,UAAU,EAAE,MAAM,EAClB,SAAS,GAAE,MAAM,EAAO,GACvB,OAAO,CAAC,MAAM,CAAC;IA6BZ,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAKtE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAgBxD"}

package/dist/services/MutationLogger.js

@@ -0,0 +1,164 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MutationLogger = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const diff_1 = require("diff");
+const chalk_1 = __importDefault(require("chalk"));
+class MutationLogger {
+    constructor(contextDir) {
+        this.mutationsDir = path_1.default.join(contextDir, ".mycontext", "mutations");
+        this.ensureMutationsDir();
+    }
+    ensureMutationsDir() {
+        if (!fs_1.default.existsSync(this.mutationsDir)) {
+            fs_1.default.mkdirSync(this.mutationsDir, { recursive: true });
+        }
+    }
+    getComponentMutationsDir(componentName) {
+        const componentDir = path_1.default.join(this.mutationsDir, componentName);
+        if (!fs_1.default.existsSync(componentDir)) {
+            fs_1.default.mkdirSync(componentDir, { recursive: true });
+        }
+        return componentDir;
+    }
+    generateMutationId() {
+        const timestamp = Date.now();
+        const random = Math.random().toString(36).substring(2, 8);
+        return `mutation-${timestamp}-${random}`;
+    }
+    async logMutation(mutation) {
+        const id = this.generateMutationId();
+        const timestamp = new Date().toISOString();
+        const fullMutation = {
+            ...mutation,
+            id,
+            timestamp,
+        };
+        const componentDir = this.getComponentMutationsDir(mutation.componentPath);
+        const mutationFile = path_1.default.join(componentDir, `${id}.json`);
+        fs_1.default.writeFileSync(mutationFile, JSON.stringify(fullMutation, null, 2));
+        console.log(chalk_1.default.green(`✅ Mutation logged: ${id}`));
+        return id;
+    }
+    async getMutationHistory(componentPath) {
+        const componentDir = this.getComponentMutationsDir(componentPath);
+        if (!fs_1.default.existsSync(componentDir)) {
+            return [];
+        }
+        const files = fs_1.default
+            .readdirSync(componentDir)
+            .filter((file) => file.endsWith(".json"))
+            .sort();
+        const mutations = [];
+        for (const file of files) {
+            try {
+                const content = fs_1.default.readFileSync(path_1.default.join(componentDir, file), "utf8");
+                const mutation = JSON.parse(content);
+                mutations.push(mutation);
+            }
+            catch (error) {
+                console.warn(chalk_1.default.yellow(`⚠️  Failed to parse mutation file: ${file}`));
+            }
+        }
+        return mutations;
+    }
+    async getLastApprovedVersion(componentPath) {
+        const mutations = await this.getMutationHistory(componentPath);
+        // Find the most recent applied mutation
+        const appliedMutations = mutations
+            .filter((m) => m.status === "applied")
+            .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        return appliedMutations[0] || null;
+    }
+    async getLastProposedVersion(componentPath) {
+        const mutations = await this.getMutationHistory(componentPath);
+        // Find the most recent proposed mutation
+        const proposedMutations = mutations
+            .filter((m) => m.status === "proposed")
+            .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+        return proposedMutations[0] || null;
+    }
+    async updateMutationStatus(mutationId, status, reason) {
+        const mutations = await this.getAllMutations();
+        const mutation = mutations.find((m) => m.id === mutationId);
+        if (!mutation) {
+            throw new Error(`Mutation ${mutationId} not found`);
+        }
+        mutation.status = status;
+        if (status === "applied") {
+            mutation.appliedAt = new Date().toISOString();
+        }
+        else if (status === "rejected") {
+            mutation.rejectedAt = new Date().toISOString();
+            mutation.rejectionReason = reason;
+        }
+        const componentDir = this.getComponentMutationsDir(mutation.componentPath);
+        const mutationFile = path_1.default.join(componentDir, `${mutationId}.json`);
+        fs_1.default.writeFileSync(mutationFile, JSON.stringify(mutation, null, 2));
+        console.log(chalk_1.default.green(`✅ Mutation ${mutationId} status updated to: ${status}`));
+    }
+    async getAllMutations() {
+        if (!fs_1.default.existsSync(this.mutationsDir)) {
+            return [];
+        }
+        const allMutations = [];
+        const componentDirs = fs_1.default.readdirSync(this.mutationsDir);
+        for (const componentDir of componentDirs) {
+            const componentPath = path_1.default.join(this.mutationsDir, componentDir);
+            if (fs_1.default.statSync(componentPath).isDirectory()) {
+                const mutations = await this.getMutationHistory(componentDir);
+                allMutations.push(...mutations);
+            }
+        }
+        return allMutations;
+    }
+    async createMutationFromRefinement(componentPath, before, after, chainOfThought, confidence, riskFlags = []) {
+        const diff = (0, diff_1.createPatch)(componentPath, before, after);
+        const mutation = {
+            componentPath,
+            actor: "ai",
+            before,
+            after,
+            diff,
+            patch: diff,
+            chainOfThought,
+            confidence,
+            riskFlags,
+            tests: {
+                unit: [],
+                lint: [],
+                typecheck: [],
+                results: {
+                    unit: { passed: 0, failed: 0, details: [] },
+                    lint: { passed: false, details: [] },
+                    typecheck: { passed: false, details: [] },
+                },
+            },
+            status: "proposed",
+        };
+        return await this.logMutation(mutation);
+    }
+    async getMutationById(mutationId) {
+        const mutations = await this.getAllMutations();
+        return mutations.find((m) => m.id === mutationId) || null;
+    }
+    async deleteMutation(mutationId) {
+        const mutations = await this.getAllMutations();
+        const mutation = mutations.find((m) => m.id === mutationId);
+        if (!mutation) {
+            throw new Error(`Mutation ${mutationId} not found`);
+        }
+        const componentDir = this.getComponentMutationsDir(mutation.componentPath);
+        const mutationFile = path_1.default.join(componentDir, `${mutationId}.json`);
+        if (fs_1.default.existsSync(mutationFile)) {
+            fs_1.default.unlinkSync(mutationFile);
+            console.log(chalk_1.default.green(`✅ Mutation ${mutationId} deleted`));
+        }
+    }
+}
+exports.MutationLogger = MutationLogger;
+//# sourceMappingURL=MutationLogger.js.map