@danielszlaski/envguard 0.1.0 → 0.1.2

package/dist/utils/logger.js

@@ -0,0 +1,136 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+/**
+ * Minimalist red-themed logger inspired by Serverless Framework v4
+ * Uses minimal colors and simple symbols for a clean, professional look
+ */
+class Logger {
+    /**
+     * Start an animated spinner with a message
+     */
+    static startSpinner(message) {
+        this.spinnerMessage = message;
+        this.currentFrame = 0;
+        if (this.spinnerInterval) {
+            this.stopSpinner();
+        }
+        process.stdout.write('\n');
+        this.spinnerInterval = setInterval(() => {
+            const frame = this.spinnerFrames[this.currentFrame];
+            process.stdout.write(`\r${chalk_1.default.dim(frame)} ${this.spinnerMessage}`);
+            this.currentFrame = (this.currentFrame + 1) % this.spinnerFrames.length;
+        }, 80);
+    }
+    /**
+     * Stop the spinner and clear the line
+     */
+    static stopSpinner(finalMessage) {
+        if (this.spinnerInterval) {
+            clearInterval(this.spinnerInterval);
+            this.spinnerInterval = null;
+        }
+        if (finalMessage) {
+            process.stdout.write(`\r${finalMessage}\n`);
+        }
+        else {
+            process.stdout.write('\r\x1b[K'); // Clear line
+        }
+    }
+    /**
+     * Log a header/section message (minimalist, no icons)
+     */
+    static header(message) {
+        console.log(chalk_1.default.dim(message));
+    }
+    /**
+     * Log a success message with checkmark
+     */
+    static success(message, indent = false) {
+        const prefix = indent ? '   ' : '';
+        console.log(`${prefix}${chalk_1.default.dim('✔')} ${message}`);
+    }
+    /**
+     * Log an error message (red themed)
+     */
+    static error(message, indent = false) {
+        const prefix = indent ? '   ' : '';
+        console.log(`${prefix}${chalk_1.default.red('✖')} ${chalk_1.default.red(message)}`);
+    }
+    /**
+     * Log a warning message (yellow/amber)
+     */
+    static warning(message, indent = false) {
+        const prefix = indent ? '   ' : '';
+        console.log(`${prefix}${chalk_1.default.hex('#FFA500')('⚠')} ${chalk_1.default.hex('#FFA500')(message)}`);
+    }
+    /**
+     * Log an info message (very minimal)
+     */
+    static info(message, indent = false) {
+        const prefix = indent ? '   ' : '';
+        console.log(`${prefix}${chalk_1.default.dim(message)}`);
+    }
+    /**
+     * Log a list item (error themed in red)
+     */
+    static errorItem(message, indent = 1) {
+        const prefix = '   '.repeat(indent);
+        console.log(`${prefix}${chalk_1.default.red('•')} ${chalk_1.default.red(message)}`);
+    }
+    /**
+     * Log a list item (warning themed, yellow/amber)
+     */
+    static warningItem(message, indent = 1) {
+        const prefix = '   '.repeat(indent);
+        console.log(`${prefix}${chalk_1.default.hex('#FFA500')('•')} ${chalk_1.default.hex('#FFA500')(message)}`);
+    }
+    /**
+     * Log a list item (info themed, very dim)
+     */
+    static infoItem(message, indent = 1) {
+        const prefix = '   '.repeat(indent);
+        console.log(`${prefix}${chalk_1.default.dim('•')} ${chalk_1.default.dim(message)}`);
+    }
+    /**
+     * Log a divider
+     */
+    static divider() {
+        console.log(chalk_1.default.dim('─'.repeat(50)));
+    }
+    /**
+     * Log a blank line
+     */
+    static blank() {
+        console.log();
+    }
+    /**
+     * Log a final summary message (Serverless-style)
+     */
+    static summary(message) {
+        console.log(`\n${chalk_1.default.dim('✔')} ${message}\n`);
+    }
+    /**
+     * Log a path/file reference (dimmed)
+     */
+    static path(message, indent = false) {
+        const prefix = indent ? '   ' : '';
+        console.log(`${prefix}${chalk_1.default.dim(message)}`);
+    }
+    /**
+     * Log deployment-style message (like "Deploying to stage dev")
+     */
+    static deployment(message) {
+        console.log(`\n${message}\n`);
+    }
+}
+exports.Logger = Logger;
+Logger.spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+Logger.spinnerInterval = null;
+Logger.currentFrame = 0;
+Logger.spinnerMessage = '';
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@danielszlaski/envguard",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "CLI tool to keep environment variables in sync with your codebase",
   "main": "dist/index.js",
   "bin": {

package/src/cli.ts

@@ -4,6 +4,7 @@ import { Command } from 'commander';
 import { scanCommand } from './commands/scan';
 import { fixCommand } from './commands/fix';
 import { checkCommand } from './commands/check';
+import { Logger } from './utils/logger';
 
 const program = new Command();
 
@@ -21,7 +22,7 @@ program
     try {
       await scanCommand(options);
     } catch (error) {
-      console.error('Error:', error);
+      Logger.error(`${error}`);
       process.exit(1);
     }
   });
@@ -33,7 +34,7 @@ program
     try {
       await fixCommand();
     } catch (error) {
-      console.error('Error:', error);
+      Logger.error(`${error}`);
       process.exit(1);
     }
   });
@@ -46,7 +47,7 @@ program
     try {
       await scanCommand({ ci: true, strict: options.strict });
     } catch (error) {
-      console.error('Error:', error);
+      Logger.error(`${error}`);
       process.exit(1);
     }
   });

package/src/commands/fix.ts

@@ -1,25 +1,29 @@
 import * as path from 'path';
 import * as fs from 'fs';
-import chalk from 'chalk';
 import { CodeScanner } from '../scanner/codeScanner';
 import { EnvParser } from '../parser/envParser';
 import { EnvAnalyzer } from '../analyzer/envAnalyzer';
+import { Logger } from '../utils/logger';
 
 export async function fixCommand() {
   const rootDir = process.cwd();
 
-  console.log(chalk.blue('🔧 Generating .env.example files...\n'));
+  Logger.startSpinner('Generating .env.example files...');
 
   // Step 1: Find all .env files
   const scanner = new CodeScanner(rootDir);
   const envFiles = await scanner.findEnvFiles();
 
+  Logger.stopSpinner();
+
   if (envFiles.length === 0) {
-    console.log(chalk.yellow('⚠️  No .env files found in the project\n'));
+    Logger.warning('No .env files found in the project');
+    Logger.blank();
     return { success: false };
   }
 
-  console.log(chalk.green(`✓ Found ${envFiles.length} .env file(s)\n`));
+  Logger.success(`Found ${envFiles.length} .env file(s)`);
+  Logger.blank();
 
   const parser = new EnvParser();
   const analyzer = new EnvAnalyzer();
@@ -31,17 +35,19 @@ export async function fixCommand() {
     const relativePath = path.relative(rootDir, envDir);
     const displayPath = relativePath || '.';
 
-    console.log(chalk.cyan(`📂 Processing ${displayPath}/`));
+    Logger.path(`Processing ${displayPath}/`);
 
     // Step 3: Scan code files in this directory and subdirectories
     const usedVars = await scanDirectoryForVars(rootDir, envDir, scanner);
 
     if (usedVars.size === 0) {
-      console.log(chalk.gray(`   No environment variables found in code\n`));
+      Logger.info('No environment variables found in code', true);
+      Logger.blank();
       continue;
     }
 
-    console.log(chalk.green(`   ✓ Found ${usedVars.size} variable(s) used in this directory\n`));
+    Logger.success(`Found ${usedVars.size} variable(s) used in this directory`, true);
+    Logger.blank();
 
     // Step 4: Parse existing .env.example to preserve comments
     const examplePath = path.join(envDir, '.env.example');
@@ -53,7 +59,8 @@ export async function fixCommand() {
     // Step 6: Write to .env.example
     fs.writeFileSync(examplePath, newContent, 'utf-8');
 
-    console.log(chalk.green(`   ✅ Generated ${path.relative(rootDir, examplePath)}\n`));
+    Logger.success(`Generated ${path.relative(rootDir, examplePath)}`, true);
+    Logger.blank();
 
     totalVars += usedVars.size;
 
@@ -62,11 +69,12 @@ export async function fixCommand() {
     const missingFromEnv = Array.from(usedVars.keys()).filter(v => !definedVars.has(v));
 
     if (missingFromEnv.length > 0) {
-      console.log(chalk.yellow(`   ⚠️  Missing from .env: ${missingFromEnv.join(', ')}\n`));
+      Logger.warning(`Missing from .env: ${missingFromEnv.join(', ')}`, true);
+      Logger.blank();
     }
   }
 
-  console.log(chalk.green(`🎉 Done! Generated ${envFiles.length} .env.example file(s) with ${totalVars} total variables\n`));
+  Logger.summary(`Generated ${envFiles.length} .env.example file(s) with ${totalVars} total variables`);
 
   return { success: true };
 }

package/src/commands/scan.ts

@@ -1,6 +1,5 @@
 import * as path from 'path';
 import * as fs from 'fs';
-import chalk from 'chalk';
 import { glob } from 'glob';
 import { CodeScanner } from '../scanner/codeScanner';
 import { EnvParser, EnvEntry } from '../parser/envParser';
@@ -9,6 +8,7 @@ import { EnvAnalyzer } from '../analyzer/envAnalyzer';
 import { Issue } from '../types';
 import { isKnownRuntimeVar, getRuntimeVarCategory } from '../constants/knownEnvVars';
 import { ConfigLoader } from '../config/configLoader';
+import { Logger } from '../utils/logger';
 
 export async function scanCommand(options: { ci?: boolean; strict?: boolean }) {
   const rootDir = process.cwd();
@@ -19,19 +19,23 @@ export async function scanCommand(options: { ci?: boolean; strict?: boolean }) {
   // CLI options override config file
   const strictMode = options.strict !== undefined ? options.strict : config.strict;
 
-  console.log(chalk.blue('🔍 Scanning codebase for environment variables...\n'));
+  Logger.startSpinner('Scanning codebase for environment variables...');
 
   // Step 1: Find all .env files and serverless.yml files
   const scanner = new CodeScanner(rootDir);
   const envFiles = await scanner.findEnvFiles();
   const serverlessFiles = await scanner.findServerlessFiles();
 
+  Logger.stopSpinner();
+
   if (envFiles.length === 0 && serverlessFiles.length === 0) {
-    console.log(chalk.yellow('⚠️  No .env or serverless.yml files found in the project\n'));
+    Logger.warning('No .env or serverless.yml files found in the project');
+    Logger.blank();
     return { success: false, issues: [] };
   }
 
-  console.log(chalk.green(`✓ Found ${envFiles.length} .env file(s) and ${serverlessFiles.length} serverless.yml file(s)\n`));
+  Logger.success(`Found ${envFiles.length} .env file(s) and ${serverlessFiles.length} serverless.yml file(s)`);
+  Logger.blank();
 
   const parser = new EnvParser();
   const serverlessParser = new ServerlessParser();
@@ -43,15 +47,17 @@ export async function scanCommand(options: { ci?: boolean; strict?: boolean }) {
     const serverlessDir = path.dirname(serverlessFilePath);
     const relativePath = path.relative(rootDir, serverlessFilePath);
 
-    console.log(chalk.cyan(`📂 Checking ${relativePath}\n`));
+    Logger.path(`Checking ${relativePath}`);
+    Logger.blank();
 
     // Parse serverless.yml
     const serverlessVars = serverlessParser.parse(serverlessFilePath);
-    console.log(chalk.gray(`   Found ${serverlessVars.size} variable(s) in serverless.yml`));
+    Logger.info(`Found ${serverlessVars.size} variable(s) in serverless.yml`, true);
 
     // Scan code files in this directory to see what's actually used
     const usedVars = await scanDirectoryForCodeVars(rootDir, serverlessDir, scanner);
-    console.log(chalk.gray(`   Found ${usedVars.size} variable(s) used in code\n`));
+    Logger.info(`Found ${usedVars.size} variable(s) used in code`, true);
+    Logger.blank();
 
     // Check for unused variables in serverless.yml
     const unusedServerlessVars: string[] = [];
@@ -87,24 +93,24 @@ export async function scanCommand(options: { ci?: boolean; strict?: boolean }) {
     }
 
     if (unusedServerlessVars.length > 0) {
-      console.log(chalk.yellow.bold('   ⚠️  Unused variables in serverless.yml:'));
-      unusedServerlessVars.forEach((varName, index) => {
-        console.log(chalk.yellow(`      ${index + 1}. ${varName}`));
+      Logger.warning('Unused variables in serverless.yml:', true);
+      unusedServerlessVars.forEach((varName) => {
+        Logger.warningItem(varName, 2);
         allIssues.push({
           type: 'unused',
           varName,
           details: `Defined in serverless.yml but never used in code`,
         });
       });
-      console.log();
+      Logger.blank();
     }
 
     if (missingFromServerless.length > 0) {
-      console.log(chalk.red.bold('   🚨 Missing from serverless.yml:'));
-      missingFromServerless.forEach((item, index) => {
-        console.log(chalk.red(`      ${index + 1}. ${item.varName}`));
+      Logger.error('Missing from serverless.yml:', true);
+      missingFromServerless.forEach((item) => {
+        Logger.errorItem(item.varName, 2);
         if (item.locations && item.locations.length > 0) {
-          console.log(chalk.gray(`         Used in: ${item.locations.slice(0, 2).join(', ')}`));
+          Logger.info(`Used in: ${item.locations.slice(0, 2).join(', ')}`, true);
         }
         allIssues.push({
           type: 'missing',
@@ -113,16 +119,17 @@ export async function scanCommand(options: { ci?: boolean; strict?: boolean }) {
           locations: item.locations,
         });
       });
-      console.log();
+      Logger.blank();
     }
 
     if (unusedServerlessVars.length === 0 && missingFromServerless.length === 0) {
-      console.log(chalk.green('   ✅ No issues in this serverless.yml\n'));
+      Logger.success('No issues in this serverless.yml', true);
+      Logger.blank();
     }
 
     // Show skipped runtime variables in non-strict mode
     if (!strictMode && skippedRuntimeVars.length > 0) {
-      console.log(chalk.gray('   ℹ️  Skipped known runtime variables (use --strict to show):'));
+      Logger.info('Skipped known runtime variables (use --strict to show):', true);
       // Group by category
       const grouped = new Map<string, string[]>();
       for (const { varName, category } of skippedRuntimeVars) {
@@ -132,9 +139,9 @@ export async function scanCommand(options: { ci?: boolean; strict?: boolean }) {
         grouped.get(category)!.push(varName);
       }
       for (const [category, vars] of grouped.entries()) {
-        console.log(chalk.gray(`      ${category}: ${vars.join(', ')}`));
+        Logger.info(`${category}: ${vars.join(', ')}`, true);
       }
-      console.log();
+      Logger.blank();
     }
   }
 
@@ -144,21 +151,23 @@ export async function scanCommand(options: { ci?: boolean; strict?: boolean }) {
     const relativePath = path.relative(rootDir, envDir);
     const displayPath = relativePath || '.';
 
-    console.log(chalk.cyan(`📂 Checking ${displayPath}/\n`));
+    Logger.path(`Checking ${displayPath}/`);
+    Logger.blank();
 
     // Step 3: Scan code files in this directory and subdirectories
     const usedVars = await scanDirectoryForVars(rootDir, envDir, scanner);
 
-    console.log(chalk.gray(`   Found ${usedVars.size} variable(s) used in this scope`));
+    Logger.info(`Found ${usedVars.size} variable(s) used in this scope`, true);
 
     // Step 4: Parse .env file
     const definedVars = parser.parse(envFilePath);
-    console.log(chalk.gray(`   Found ${definedVars.size} variable(s) in .env`));
+    Logger.info(`Found ${definedVars.size} variable(s) in .env`, true);
 
     // Step 5: Parse .env.example
     const examplePath = path.join(envDir, '.env.example');
     const exampleVars = parser.parseExample(examplePath);
-    console.log(chalk.gray(`   Found ${exampleVars.size} variable(s) in .env.example\n`));
+    Logger.info(`Found ${exampleVars.size} variable(s) in .env.example`, true);
+    Logger.blank();
 
     // Step 6: Analyze and find issues
     const result = analyzer.analyze(usedVars, definedVars, exampleVars);
@@ -170,55 +179,60 @@ export async function scanCommand(options: { ci?: boolean; strict?: boolean }) {
       const undocumentedIssues = result.issues.filter(i => i.type === 'undocumented');
 
       if (missingIssues.length > 0) {
-        console.log(chalk.red.bold('   🚨 Missing from .env:'));
-        missingIssues.forEach((issue, index) => {
-          console.log(chalk.red(`      ${index + 1}. ${issue.varName}`));
+        Logger.error('Missing from .env:', true);
+        missingIssues.forEach((issue) => {
+          Logger.errorItem(issue.varName, 2);
           if (issue.locations && issue.locations.length > 0) {
-            console.log(chalk.gray(`         Used in: ${issue.locations.slice(0, 2).join(', ')}`));
+            Logger.info(`Used in: ${issue.locations.slice(0, 2).join(', ')}`, true);
           }
         });
-        console.log();
+        Logger.blank();
       }
 
       if (unusedIssues.length > 0) {
-        console.log(chalk.yellow.bold('   ⚠️  Unused variables:'));
-        unusedIssues.forEach((issue, index) => {
-          console.log(chalk.yellow(`      ${index + 1}. ${issue.varName}`));
+        Logger.warning('Unused variables:', true);
+        unusedIssues.forEach((issue) => {
+          Logger.warningItem(issue.varName, 2);
         });
-        console.log();
+        Logger.blank();
       }
 
       if (undocumentedIssues.length > 0) {
-        console.log(chalk.blue.bold('   📝 Missing from .env.example:'));
-        undocumentedIssues.forEach((issue, index) => {
-          console.log(chalk.blue(`      ${index + 1}. ${issue.varName}`));
+        Logger.info('Missing from .env.example:', true);
+        undocumentedIssues.forEach((issue) => {
+          Logger.infoItem(issue.varName, 2);
         });
-        console.log();
+        Logger.blank();
       }
 
       allIssues.push(...result.issues);
     } else {
-      console.log(chalk.green('   ✅ No issues in this directory\n'));
+      Logger.success('No issues in this directory', true);
+      Logger.blank();
     }
   }
 
   // Display summary
-  console.log(chalk.bold('─'.repeat(50)));
+  Logger.divider();
   if (allIssues.length === 0) {
-    console.log(chalk.green('\n✅ No issues found! All environment variables are in sync.\n'));
+    Logger.summary('No issues found! All environment variables are in sync.');
     return { success: true, issues: [] };
   }
 
-  console.log(chalk.yellow(`\n⚠️  Total: ${allIssues.length} issue(s) across ${envFiles.length} location(s)\n`));
+  Logger.blank();
+  Logger.warning(`Total: ${allIssues.length} issue(s) across ${envFiles.length} location(s)`);
+  Logger.blank();
 
   // Suggest fix
   if (!options.ci) {
-    console.log(chalk.cyan('💡 Run `envguard fix` to auto-generate .env.example files\n'));
+    Logger.info('Run `envguard fix` to auto-generate .env.example files');
+    Logger.blank();
   }
 
   // Exit with error code in CI mode
   if (options.ci) {
-    console.log(chalk.red('❌ Issues found. Exiting with error code 1.\n'));
+    Logger.error('Issues found. Exiting with error code 1.');
+    Logger.blank();
     process.exit(1);
   }
 

package/src/utils/logger.ts

@@ -0,0 +1,146 @@
+import chalk from 'chalk';
+
+/**
+ * Minimalist red-themed logger inspired by Serverless Framework v4
+ * Uses minimal colors and simple symbols for a clean, professional look
+ */
+export class Logger {
+  private static spinnerFrames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+  private static spinnerInterval: NodeJS.Timeout | null = null;
+  private static currentFrame = 0;
+  private static spinnerMessage = '';
+
+  /**
+   * Start an animated spinner with a message
+   */
+  static startSpinner(message: string) {
+    this.spinnerMessage = message;
+    this.currentFrame = 0;
+
+    if (this.spinnerInterval) {
+      this.stopSpinner();
+    }
+
+    process.stdout.write('\n');
+    this.spinnerInterval = setInterval(() => {
+      const frame = this.spinnerFrames[this.currentFrame];
+      process.stdout.write(`\r${chalk.dim(frame)} ${this.spinnerMessage}`);
+      this.currentFrame = (this.currentFrame + 1) % this.spinnerFrames.length;
+    }, 80);
+  }
+
+  /**
+   * Stop the spinner and clear the line
+   */
+  static stopSpinner(finalMessage?: string) {
+    if (this.spinnerInterval) {
+      clearInterval(this.spinnerInterval);
+      this.spinnerInterval = null;
+    }
+
+    if (finalMessage) {
+      process.stdout.write(`\r${finalMessage}\n`);
+    } else {
+      process.stdout.write('\r\x1b[K'); // Clear line
+    }
+  }
+
+  /**
+   * Log a header/section message (minimalist, no icons)
+   */
+  static header(message: string) {
+    console.log(chalk.dim(message));
+  }
+
+  /**
+   * Log a success message with checkmark
+   */
+  static success(message: string, indent = false) {
+    const prefix = indent ? '   ' : '';
+    console.log(`${prefix}${chalk.dim('✔')} ${message}`);
+  }
+
+  /**
+   * Log an error message (red themed)
+   */
+  static error(message: string, indent = false) {
+    const prefix = indent ? '   ' : '';
+    console.log(`${prefix}${chalk.red('✖')} ${chalk.red(message)}`);
+  }
+
+  /**
+   * Log a warning message (yellow/amber)
+   */
+  static warning(message: string, indent = false) {
+    const prefix = indent ? '   ' : '';
+    console.log(`${prefix}${chalk.hex('#FFA500')('⚠')} ${chalk.hex('#FFA500')(message)}`);
+  }
+
+  /**
+   * Log an info message (very minimal)
+   */
+  static info(message: string, indent = false) {
+    const prefix = indent ? '   ' : '';
+    console.log(`${prefix}${chalk.dim(message)}`);
+  }
+
+  /**
+   * Log a list item (error themed in red)
+   */
+  static errorItem(message: string, indent = 1) {
+    const prefix = '   '.repeat(indent);
+    console.log(`${prefix}${chalk.red('•')} ${chalk.red(message)}`);
+  }
+
+  /**
+   * Log a list item (warning themed, yellow/amber)
+   */
+  static warningItem(message: string, indent = 1) {
+    const prefix = '   '.repeat(indent);
+    console.log(`${prefix}${chalk.hex('#FFA500')('•')} ${chalk.hex('#FFA500')(message)}`);
+  }
+
+  /**
+   * Log a list item (info themed, very dim)
+   */
+  static infoItem(message: string, indent = 1) {
+    const prefix = '   '.repeat(indent);
+    console.log(`${prefix}${chalk.dim('•')} ${chalk.dim(message)}`);
+  }
+
+  /**
+   * Log a divider
+   */
+  static divider() {
+    console.log(chalk.dim('─'.repeat(50)));
+  }
+
+  /**
+   * Log a blank line
+   */
+  static blank() {
+    console.log();
+  }
+
+  /**
+   * Log a final summary message (Serverless-style)
+   */
+  static summary(message: string) {
+    console.log(`\n${chalk.dim('✔')} ${message}\n`);
+  }
+
+  /**
+   * Log a path/file reference (dimmed)
+   */
+  static path(message: string, indent = false) {
+    const prefix = indent ? '   ' : '';
+    console.log(`${prefix}${chalk.dim(message)}`);
+  }
+
+  /**
+   * Log deployment-style message (like "Deploying to stage dev")
+   */
+  static deployment(message: string) {
+    console.log(`\n${message}\n`);
+  }
+}

package/test-project/src/lambda1/.env.example

@@ -1,11 +1,11 @@
 # Auto-generated by envguard
 # Do not put actual secrets in this file - use .env instead
 
-# Used in: test-project/src/lambda1/handler.js
+# Used in: src/lambda1/handler.js
 # Format: your-secret-here
 CUSTOM_KEY=
 
-# Used in: test-project/src/lambda1/handler.js
+# Used in: src/lambda1/handler.js
 # Format: your-secret-here
 STRIPE_SECRET_KEY=