@solid-stack/mason 1.0.24 → 1.0.25

package/dist/index.js

@@ -1,7 +1,7 @@
 import fs4 from 'fs';
 import path2 from 'path';
-import * as p14 from '@clack/prompts';
-import pc14 from 'picocolors';
+import * as p15 from '@clack/prompts';
+import pc15 from 'picocolors';
 import { fileURLToPath } from 'url';
 import { execSync } from 'child_process';
 import { createHash } from 'crypto';
@@ -112,17 +112,17 @@ function writeFileSafely(absolutePath, content, options = {}) {
 function printGeneratedFiles(files, isDryRun = false) {
   console.log("");
   if (isDryRun) {
-    p14.log.warn(pc14.yellow(pc14.bold("[DRY RUN PREVIEW] No files were written to disk.")));
+    p15.log.warn(pc15.yellow(pc15.bold("[DRY RUN PREVIEW] No files were written to disk.")));
   }
   for (const f of files) {
     if (f.action === "created") {
-      p14.log.success(`${pc14.bold(f.relativePath)} ${pc14.dim("(created)")}`);
+      p15.log.success(`${pc15.bold(f.relativePath)} ${pc15.dim("(created)")}`);
     } else if (f.action === "overwritten") {
-      p14.log.warn(`${pc14.bold(f.relativePath)} ${pc14.dim("(overwritten)")}`);
+      p15.log.warn(`${pc15.bold(f.relativePath)} ${pc15.dim("(overwritten)")}`);
     } else if (f.action === "skipped") {
-      p14.log.info(`${pc14.dim(f.relativePath)} ${pc14.dim("(skipped - already exists, pass -o to overwrite)")}`);
+      p15.log.info(`${pc15.dim(f.relativePath)} ${pc15.dim("(skipped - already exists, pass -o to overwrite)")}`);
     } else {
-      p14.log.info(`${pc14.bold(f.relativePath)} ${pc14.dim("(preview)")}`);
+      p15.log.info(`${pc15.bold(f.relativePath)} ${pc15.dim("(preview)")}`);
     }
   }
 }
@@ -324,23 +324,23 @@ var PromptCancelledError = class extends Error {
   }
 };
 function handleCancel(result) {
-  if (p14.isCancel(result)) {
-    p14.cancel("Operation cancelled.");
+  if (p15.isCancel(result)) {
+    p15.cancel("Operation cancelled.");
     throw new PromptCancelledError();
   }
   return result;
 }
 function printBanner() {
   console.log("");
-  p14.intro(pc14.bgCyan(pc14.black(" @solid-stack/mason ")));
+  p15.intro(pc15.bgCyan(pc15.black(" @solid-stack/mason ")));
 }
 async function promptProperties(options = {}) {
   const properties = options.defaults ? [...options.defaults] : [];
   if (properties.length > 0) {
-    const summary = properties.map((p16) => `${p16.name}: ${p16.type}${p16.optional ? "?" : ""}`).join(", ");
-    p14.log.info(pc14.dim(`Pre-configured fields: ${summary}`));
+    const summary = properties.map((p18) => `${p18.name}: ${p18.type}${p18.optional ? "?" : ""}`).join(", ");
+    p15.log.info(pc15.dim(`Pre-configured fields: ${summary}`));
     const addMore = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Would you like to add custom fields/properties?",
         initialValue: false
       })
@@ -349,10 +349,10 @@ async function promptProperties(options = {}) {
       return properties;
     }
   }
-  p14.log.info(pc14.cyan("Enter properties (leave name blank when finished):"));
+  p15.log.info(pc15.cyan("Enter properties (leave name blank when finished):"));
   while (true) {
     const name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Property name (or press Enter to finish):",
         placeholder: "e.g. title, email, status"
       })
@@ -361,7 +361,7 @@ async function promptProperties(options = {}) {
       break;
     }
     const type = handleCancel(
-      await p14.select({
+      await p15.select({
         message: `Type for property "${name.trim()}":`,
         options: [
           { value: "string", label: "string" },
@@ -378,7 +378,7 @@ async function promptProperties(options = {}) {
     let finalType = type;
     if (type === "custom") {
       finalType = handleCancel(
-        await p14.text({
+        await p15.text({
           message: `Enter custom type for "${name.trim()}":`,
           placeholder: "e.g. UserRole, string | null",
           validate: (val) => val && val.trim() ? void 0 : "Type cannot be empty"
@@ -386,7 +386,7 @@ async function promptProperties(options = {}) {
       );
     }
     const optional = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: `Is "${name.trim()}" optional?`,
         initialValue: false
       })
@@ -396,8 +396,8 @@ async function promptProperties(options = {}) {
       type: finalType.trim(),
       optional
     });
-    p14.log.success(
-      pc14.green(`Added: ${name.trim()}${optional ? "?" : ""}: ${finalType.trim()}`)
+    p15.log.success(
+      pc15.green(`Added: ${name.trim()}${optional ? "?" : ""}: ${finalType.trim()}`)
     );
   }
   return properties;
@@ -605,8 +605,8 @@ function getMissingNpmPackages(projectRoot, requiredPackages) {
       ...Object.keys(pkg.devDependencies || {}),
       ...Object.keys(pkg.peerDependencies || {})
     ]);
-    return requiredPackages.filter((p16) => {
-      const nameOnly = p16.startsWith("@") ? `@${p16.slice(1).split("@")[0] || ""}` : p16.split("@")[0] || p16;
+    return requiredPackages.filter((p18) => {
+      const nameOnly = p18.startsWith("@") ? `@${p18.slice(1).split("@")[0] || ""}` : p18.split("@")[0] || p18;
       return !installed.has(nameOnly);
     });
   } catch {
@@ -631,7 +631,7 @@ function installNpmPackages(projectRoot, packages, pm) {
       installCmd = `npm install ${packages.join(" ")}`;
       break;
   }
-  p14.log.info(`Installing missing dependencies with ${manager}: ${pc14.cyan(packages.join(", "))}`);
+  p15.log.info(`Installing missing dependencies with ${manager}: ${pc15.cyan(packages.join(", "))}`);
   execSync(installCmd, {
     cwd: projectRoot,
     stdio: "inherit"
@@ -833,7 +833,7 @@ function generateInterfaceCode(ifaceName, kind = "abstractClass", entityName, me
   const idKey = `${entityKey}Id`;
   const listKey = `${entityKey}s`;
   const formattedCustomMethods = customMethods.map((m) => {
-    const params = m.params && m.params.length > 0 ? m.params.map((p16) => `${p16.name}: ${p16.type}`).join("; ") : "";
+    const params = m.params && m.params.length > 0 ? m.params.map((p18) => `${p18.name}: ${p18.type}`).join("; ") : "";
     const returnType = m.returnType ? `Promise<${m.returnType}>` : "Promise<void>";
     return {
       name: m.name,
@@ -1414,22 +1414,22 @@ function generateUseCaseCode(useCaseName, dependencies = [], inputProps = [], ou
     from: /^I[A-Z]/.test(dep) ? `../domain/${dep}.js` : `./${dep}.js`
   }));
   const domainTypesToImport = new Set(domainImports);
-  for (const p16 of [...inputProps, ...outputProps]) {
-    const rawType = p16.type.trim();
+  for (const p18 of [...inputProps, ...outputProps]) {
+    const rawType = p18.type.trim();
     const baseType = rawType.replace(/\[\]$/, "").trim();
     if (!primitiveTypes.has(baseType) && /^[A-Z][A-Za-z0-9_]*$/.test(baseType) && !dependencies.includes(baseType)) {
       domainTypesToImport.add(baseType);
     }
   }
-  const formattedInputProps = inputProps.map((p16) => ({
-    name: p16.name,
-    optional: p16.optional,
-    type: p16.optional && !p16.type.includes("undefined") ? `${p16.type} | undefined` : p16.type
+  const formattedInputProps = inputProps.map((p18) => ({
+    name: p18.name,
+    optional: p18.optional,
+    type: p18.optional && !p18.type.includes("undefined") ? `${p18.type} | undefined` : p18.type
   }));
-  const formattedOutputProps = outputProps.map((p16) => ({
-    name: p16.name,
-    optional: p16.optional,
-    type: p16.optional && !p16.type.includes("undefined") ? `${p16.type} | undefined` : p16.type
+  const formattedOutputProps = outputProps.map((p18) => ({
+    name: p18.name,
+    optional: p18.optional,
+    type: p18.optional && !p18.type.includes("undefined") ? `${p18.type} | undefined` : p18.type
   }));
   const formattedDeps = dependencies.map((dep) => ({
     key: toCamelCase(dep),
@@ -2104,7 +2104,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
   }
   if (!name) {
     name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "What is the feature name?",
         placeholder: "e.g. users, auth, orders, billing",
         validate: (val) => {
@@ -2120,7 +2120,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
   let targetDirRel = defaultDir;
   if (!flags.yes && !flags.target && !flags.dest) {
     targetDirRel = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Target directory for the feature:",
         initialValue: defaultDir,
         defaultValue: defaultDir
@@ -2142,14 +2142,14 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
   const customUseCases = [];
   if (!flags.yes) {
     includeExpress = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Include Express Presentation layer (pxExpress routes & handlers)?",
         initialValue: true
       })
     );
     if (includeExpress) {
       routePath = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Express route prefix:",
           initialValue: `/${normalizedName}`,
           defaultValue: `/${normalizedName}`
@@ -2157,14 +2157,14 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
       ).trim();
     }
     includeDomain = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Include Domain Entity/Entities?",
         initialValue: true
       })
     );
     if (includeDomain) {
       const domainInput = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Domain entity name(s) (comma-separated):",
           initialValue: defaultEntity,
           defaultValue: defaultEntity,
@@ -2183,21 +2183,21 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
       entityNames = [defaultEntity];
     }
     includeInterface = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: `Include Domain Repository interface(s) for ${entityNames.join(", ")}?`,
         initialValue: true
       })
     );
     if (includeInterface) {
       includeInfra = handleCancel(
-        await p14.confirm({
+        await p15.confirm({
           message: `Include Infrastructure Stub implementation(s) for ${entityNames.join(", ")}?`,
           initialValue: true
         })
       );
     }
     includeUseCase = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Include Domain Use Cases?",
         initialValue: true
       })
@@ -2211,7 +2211,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
         { value: "delete", label: "Delete (Delete<Entity>)", hint: "DELETE /:id" }
       ];
       crudOperations = handleCancel(
-        await p14.multiselect({
+        await p15.multiselect({
           message: "Select standard CRUD use cases to generate:",
           options: crudChoices,
           initialValues: ["create", "read", "list", "update", "delete"],
@@ -2219,13 +2219,13 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
         })
       );
       includeTests = handleCancel(
-        await p14.confirm({
+        await p15.confirm({
           message: "Generate Vitest unit tests for use cases?",
           initialValue: true
         })
       );
       const wantCustom = handleCancel(
-        await p14.confirm({
+        await p15.confirm({
           message: "Do you want to add any custom use cases to this feature?",
           initialValue: false
         })
@@ -2235,7 +2235,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
         const availableIfaces = entityNames.map((e) => `I${e}Repository`);
         while (addMore) {
           const customName = handleCancel(
-            await p14.text({
+            await p15.text({
               message: "Custom Use Case name:",
               placeholder: "e.g. ResetPassword, VerifyEmail, AssignRole",
               validate: (v) => v && v.trim() ? void 0 : "Use Case name cannot be empty"
@@ -2245,7 +2245,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
           let selectedDeps = [];
           if (availableIfaces.length > 0) {
             selectedDeps = handleCancel(
-              await p14.multiselect({
+              await p15.multiselect({
                 message: `Select domain interfaces to inject into ${customUcName}:`,
                 options: availableIfaces.map((i) => ({ value: i, label: i })),
                 required: false
@@ -2254,7 +2254,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
           }
           let customInputProps = [];
           const hasInput = handleCancel(
-            await p14.confirm({
+            await p15.confirm({
               message: `Does ${customUcName} accept input arguments?`,
               initialValue: true
             })
@@ -2265,7 +2265,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
           }
           let customOutputProps = [];
           const hasCustomOutput = handleCancel(
-            await p14.confirm({
+            await p15.confirm({
               message: `Does ${customUcName} return custom output data?`,
               initialValue: false
             })
@@ -2275,7 +2275,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
               });
           }
           const customIncludeTest = handleCancel(
-            await p14.confirm({
+            await p15.confirm({
               message: `Generate Vitest unit test for ${customUcName}?`,
               initialValue: true
             })
@@ -2285,14 +2285,14 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
           let customHttpPath = `/${toKebabCase(customUcName)}`;
           if (includeExpress) {
             customCreateHttp = handleCancel(
-              await p14.confirm({
+              await p15.confirm({
                 message: `Generate a matching ExpressRoute HTTP handler for ${customUcName}?`,
                 initialValue: true
               })
             );
             if (customCreateHttp) {
               customHttpMethod = handleCancel(
-                await p14.select({
+                await p15.select({
                   message: "HTTP method for route:",
                   options: [
                     { value: "post", label: "POST" },
@@ -2305,7 +2305,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
                 })
               );
               customHttpPath = handleCancel(
-                await p14.text({
+                await p15.text({
                   message: "Route subpath (relative to feature prefix):",
                   initialValue: `/${toKebabCase(customUcName)}`,
                   defaultValue: `/${toKebabCase(customUcName)}`
@@ -2326,7 +2326,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
             validationFields: customInputProps
           });
           addMore = handleCancel(
-            await p14.confirm({
+            await p15.confirm({
               message: "Add another custom use case?",
               initialValue: false
             })
@@ -2335,7 +2335,7 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
       }
     }
     includeDiProvider = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Generate / update feature DI provider (diProvider.ts)?",
         initialValue: true
       })
@@ -2347,8 +2347,8 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
       entityNames = [defaultEntity];
     }
   }
-  const s = p14.spinner();
-  s.start(`Generating feature '${pc14.cyan(normalizedName)}'...`);
+  const s = p15.spinner();
+  s.start(`Generating feature '${pc15.cyan(normalizedName)}'...`);
   const options = {
     name: normalizedName,
     projectRoot,
@@ -2394,8 +2394,8 @@ async function runFeatureCommand(featureNameArg, flags = {}) {
   }
   s.stop("Feature scaffolded successfully!");
   printGeneratedFiles(files, options.dryRun);
-  p14.outro(
-    pc14.green(
+  p15.outro(
+    pc15.green(
       `\u2713 Feature '${normalizedName}' initialized in ${path2.relative(projectRoot, targetDir)} (uncommitted, unregistered)`
     )
   );
@@ -2509,7 +2509,7 @@ async function runSharedCommand(sharedNameArg, flags = {}) {
   }
   if (!name) {
     name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "What is the shared module name?",
         placeholder: "e.g. hasher, time, uuid, cache, logger",
         validate: (val) => {
@@ -2525,7 +2525,7 @@ async function runSharedCommand(sharedNameArg, flags = {}) {
   let targetDirRel = defaultDir;
   if (!flags.yes && !flags.target && !flags.dest) {
     targetDirRel = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Target directory for the shared module:",
         initialValue: defaultDir,
         defaultValue: defaultDir
@@ -2537,21 +2537,21 @@ async function runSharedCommand(sharedNameArg, flags = {}) {
   let includeStub = true;
   if (!flags.yes) {
     description = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Module description (optional):",
         placeholder: "e.g. In-memory caching and Redis port abstraction",
         initialValue: ""
       })
     ).trim();
     includeStub = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Include stub implementation in infrastructure/?",
         initialValue: true
       })
     );
   }
-  const s = p14.spinner();
-  s.start(`Generating shared module '${pc14.cyan(normalizedName)}'...`);
+  const s = p15.spinner();
+  s.start(`Generating shared module '${pc15.cyan(normalizedName)}'...`);
   const files = generateShared({
     name: normalizedName,
     description,
@@ -2564,8 +2564,8 @@ async function runSharedCommand(sharedNameArg, flags = {}) {
   });
   s.stop("Shared module generated successfully!");
   printGeneratedFiles(files, Boolean(flags.dryRun));
-  p14.outro(
-    pc14.green(
+  p15.outro(
+    pc15.green(
       `\u2713 Shared module '${normalizedName}' initialized in ${path2.relative(projectRoot, targetDir)} (uncommitted, unregistered)`
     )
   );
@@ -2579,14 +2579,14 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
       const featureOptions = existingFeatures.map((f) => ({ value: f, label: f }));
       featureOptions.push({ value: "__custom__", label: "\u270F\uFE0F  Enter custom feature name..." });
       const selected = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Select target feature:",
           options: featureOptions
         })
       );
       if (selected === "__custom__") {
         feature = handleCancel(
-          await p14.text({
+          await p15.text({
             message: "Enter feature name:",
             validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
           })
@@ -2596,7 +2596,7 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
       }
     } else {
       feature = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Enter target feature name:",
           validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
         })
@@ -2607,7 +2607,7 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
   let name = useCaseNameArg?.trim();
   if (!name) {
     name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Use Case name:",
         placeholder: "e.g. CreateUser, GetUser, CancelOrder",
         validate: (v) => v && v.trim() ? void 0 : "Use Case name cannot be empty"
@@ -2623,7 +2623,7 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
       label: i.name
     }));
     selectedDeps = handleCancel(
-      await p14.multiselect({
+      await p15.multiselect({
         message: "Select domain interfaces to inject into use case:",
         options: multiOptions,
         required: false
@@ -2638,7 +2638,7 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
   let httpPath = "/";
   if (!flags.yes) {
     const hasInput = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Does this use case accept input arguments?",
         initialValue: true
       })
@@ -2648,7 +2648,7 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
         });
     }
     const hasCustomOutput = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Does this use case return custom output data?",
         initialValue: false
       })
@@ -2658,20 +2658,20 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
         });
     }
     includeTest = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Generate Vitest unit test skeleton (.test.ts)?",
         initialValue: true
       })
     );
     createHttp = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Generate a matching ExpressRoute HTTP handler?",
         initialValue: false
       })
     );
     if (createHttp) {
       httpMethod = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "HTTP method for route:",
           options: [
             { value: "post", label: "POST" },
@@ -2684,7 +2684,7 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
         })
       );
       httpPath = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Route subpath (relative to feature prefix):",
           initialValue: "/",
           defaultValue: "/"
@@ -2692,8 +2692,8 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
       ).trim();
     }
   }
-  const s = p14.spinner();
-  s.start(`Generating use case '${pc14.cyan(ucName)}'...`);
+  const s = p15.spinner();
+  s.start(`Generating use case '${pc15.cyan(ucName)}'...`);
   const options = {
     name: ucName,
     feature,
@@ -2725,7 +2725,7 @@ async function runUseCaseCommand(useCaseNameArg, flags = {}) {
   }
   s.stop("Use case generated successfully!");
   printGeneratedFiles(files, options.dryRun);
-  p14.outro(pc14.green(`Use case '${ucName}' created in feature '${feature}'!`));
+  p15.outro(pc15.green(`Use case '${ucName}' created in feature '${feature}'!`));
 }
 async function runDomainCommand(domainNameArg, flags = {}) {
   const projectRoot = findProjectRoot();
@@ -2736,14 +2736,14 @@ async function runDomainCommand(domainNameArg, flags = {}) {
       const featureOptions = existingFeatures.map((f) => ({ value: f, label: f }));
       featureOptions.push({ value: "__custom__", label: "\u270F\uFE0F  Enter custom feature name..." });
       const selected = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Select target feature:",
           options: featureOptions
         })
       );
       if (selected === "__custom__") {
         feature = handleCancel(
-          await p14.text({
+          await p15.text({
             message: "Enter feature name:",
             validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
           })
@@ -2753,7 +2753,7 @@ async function runDomainCommand(domainNameArg, flags = {}) {
       }
     } else {
       feature = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Enter target feature name:",
           validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
         })
@@ -2764,7 +2764,7 @@ async function runDomainCommand(domainNameArg, flags = {}) {
   let name = domainNameArg?.trim();
   if (!name) {
     name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Domain model / entity name:",
         placeholder: "e.g. User, Order, Product, Address",
         validate: (v) => v && v.trim() ? void 0 : "Domain name cannot be empty"
@@ -2776,7 +2776,7 @@ async function runDomainCommand(domainNameArg, flags = {}) {
   let properties = [];
   if (!flags.yes) {
     kind = handleCancel(
-      await p14.select({
+      await p15.select({
         message: "Select domain model type:",
         options: [
           { value: "interface", label: "TypeScript Interface (pure data structure)" },
@@ -2795,8 +2795,8 @@ async function runDomainCommand(domainNameArg, flags = {}) {
       defaults: kind === "valueObject" ? [{ name: "value", type: "string" }] : defaultProps
     });
   }
-  const s = p14.spinner();
-  s.start(`Generating domain model '${pc14.cyan(entityName)}'...`);
+  const s = p15.spinner();
+  s.start(`Generating domain model '${pc15.cyan(entityName)}'...`);
   const options = {
     name: entityName,
     feature,
@@ -2809,7 +2809,7 @@ async function runDomainCommand(domainNameArg, flags = {}) {
   const file = generateDomain(options);
   s.stop("Domain model generated successfully!");
   printGeneratedFiles([file], options.dryRun);
-  p14.outro(pc14.green(`Domain model '${entityName}' created in feature '${feature}'!`));
+  p15.outro(pc15.green(`Domain model '${entityName}' created in feature '${feature}'!`));
 }
 async function runInfrastructureCommand(classNameArg, flags = {}) {
   const projectRoot = findProjectRoot();
@@ -2818,7 +2818,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
   let feature = flags.feature?.trim();
   if (!flags.yes && !flags.global && !flags.feature) {
     scope = handleCancel(
-      await p14.select({
+      await p15.select({
         message: "Where should this infrastructure implementation be placed?",
         options: [
           { value: "feature", label: "Feature-level (features/<feature>/infrastructure)" },
@@ -2833,14 +2833,14 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
       const featureOptions = existingFeatures.map((f) => ({ value: f, label: f }));
       featureOptions.push({ value: "__custom__", label: "\u270F\uFE0F  Enter custom feature name..." });
       const selected = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Select target feature:",
           options: featureOptions
         })
       );
       if (selected === "__custom__") {
         feature = handleCancel(
-          await p14.text({
+          await p15.text({
             message: "Enter feature name:",
             validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
           })
@@ -2850,7 +2850,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
       }
     } else {
       feature = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Enter target feature name:",
           validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
         })
@@ -2863,7 +2863,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
   let name = classNameArg?.trim();
   if (!name) {
     name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Infrastructure class name:",
         placeholder: "e.g. StubUserRepository, PostgresUserRepository, S3FileStorage",
         validate: (v) => v && v.trim() ? void 0 : "Class name cannot be empty"
@@ -2882,7 +2882,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
           (i) => className.toLowerCase().includes(removeInterfacePrefix(i.name).toLowerCase())
         );
         const ifaceChoice = handleCancel(
-          await p14.select({
+          await p15.select({
             message: "Does this class implement a domain interface or abstract class?",
             options: [
               ...interfaces.map((i) => ({ value: i.name, label: i.name })),
@@ -2894,7 +2894,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
         );
         if (ifaceChoice === "__custom__") {
           implementsInterface = handleCancel(
-            await p14.text({
+            await p15.text({
               message: "Enter interface or abstract class name:",
               placeholder: "e.g. IUserRepository, BaseStorageAdapter",
               validate: (v) => v && v.trim() ? void 0 : "Name cannot be empty"
@@ -2905,14 +2905,14 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
         }
       } else {
         const wantImpl = handleCancel(
-          await p14.confirm({
+          await p15.confirm({
             message: "Does this class implement a domain interface or abstract class?",
             initialValue: false
           })
         );
         if (wantImpl) {
           implementsInterface = handleCancel(
-            await p14.text({
+            await p15.text({
               message: "Enter interface or abstract class name:",
               placeholder: "e.g. IUserRepository, BaseStorageAdapter",
               validate: (v) => v && v.trim() ? void 0 : "Name cannot be empty"
@@ -2932,7 +2932,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
     const allInterfaces = listDomainInterfaces(projectRoot);
     if (allInterfaces.length > 0) {
       const ifaceChoice = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Does this class implement an interface or abstract class?",
           options: [
             ...allInterfaces.map((i) => ({ value: i.name, label: `${i.name} (${i.feature})` })),
@@ -2944,7 +2944,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
       );
       if (ifaceChoice === "__custom__") {
         implementsInterface = handleCancel(
-          await p14.text({
+          await p15.text({
             message: "Enter interface or abstract class name:",
             placeholder: "e.g. IAuthRepository",
             validate: (v) => v && v.trim() ? void 0 : "Name cannot be empty"
@@ -2957,7 +2957,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
   }
   if (!flags.yes && !flags.kind) {
     kind = handleCancel(
-      await p14.select({
+      await p15.select({
         message: "Select implementation kind:",
         options: [
           { value: "stub", label: "In-Memory Stub (with in-memory store and test helper methods)" },
@@ -2968,7 +2968,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
     );
     if (scope === "feature" && feature && implementsInterface) {
       registerInProvider = handleCancel(
-        await p14.confirm({
+        await p15.confirm({
           message: "Register this implementation in feature diProvider.ts?",
           initialValue: true
         })
@@ -2977,8 +2977,8 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
   } else if (flags.yes && scope === "feature" && feature && implementsInterface) {
     registerInProvider = !flags.noProvider;
   }
-  const s = p14.spinner();
-  s.start(`Generating infrastructure class '${pc14.cyan(className)}'...`);
+  const s = p15.spinner();
+  s.start(`Generating infrastructure class '${pc15.cyan(className)}'...`);
   const files = [];
   const options = {
     name: className,
@@ -3013,7 +3013,7 @@ async function runInfrastructureCommand(classNameArg, flags = {}) {
   }
   s.stop("Infrastructure class generated successfully!");
   printGeneratedFiles(files, options.dryRun);
-  p14.outro(pc14.green(`Infrastructure class '${className}' created!`));
+  p15.outro(pc15.green(`Infrastructure class '${className}' created!`));
 }
 async function runInterfaceCommand(interfaceNameArg, flags = {}) {
   const projectRoot = findProjectRoot();
@@ -3024,14 +3024,14 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
       const featureOptions = existingFeatures.map((f) => ({ value: f, label: f }));
       featureOptions.push({ value: "__custom__", label: "\u270F\uFE0F  Enter custom feature name..." });
       const selected = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Select target feature:",
           options: featureOptions
         })
       );
       if (selected === "__custom__") {
         feature = handleCancel(
-          await p14.text({
+          await p15.text({
             message: "Enter feature name:",
             validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
           })
@@ -3041,7 +3041,7 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
       }
     } else {
       feature = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Enter target feature name:",
           validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
         })
@@ -3052,7 +3052,7 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
   let name = interfaceNameArg?.trim();
   if (!name) {
     name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Domain interface name:",
         placeholder: "e.g. IUserRepository, IPaymentService",
         validate: (v) => v && v.trim() ? void 0 : "Interface name cannot be empty"
@@ -3070,7 +3070,7 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
   if (!flags.yes) {
     if (existingEntities.length > 0) {
       const selectedEntity = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Select domain entity associated with this interface:",
           options: [
             ...existingEntities.map((e) => ({ value: e.name, label: e.name })),
@@ -3081,7 +3081,7 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
       );
       if (selectedEntity === "__custom__") {
         entityName = handleCancel(
-          await p14.text({
+          await p15.text({
             message: "Enter entity name:",
             defaultValue: removeInterfacePrefix(ifaceName).replace(/Repository$|Service$/, "")
           })
@@ -3091,7 +3091,7 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
       }
     }
     kind = handleCancel(
-      await p14.select({
+      await p15.select({
         message: "Interface definition style:",
         options: [
           { value: "abstractClass", label: "Abstract Class (Recommended - acts as DI token & type)" },
@@ -3101,7 +3101,7 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
       })
     );
     methodsPreset = handleCancel(
-      await p14.select({
+      await p15.select({
         message: "Method signature preset:",
         options: [
           { value: "crud", label: "Standard CRUD (GetById, List, Create, Update, Delete)" },
@@ -3111,22 +3111,22 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
       })
     );
     generateStub = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Auto-generate Infrastructure Stub implementation?",
         initialValue: true
       })
     );
     if (generateStub) {
       registerInProvider = handleCancel(
-        await p14.confirm({
+        await p15.confirm({
           message: "Auto-register interface & stub in feature diProvider.ts?",
           initialValue: true
         })
       );
     }
   }
-  const s = p14.spinner();
-  s.start(`Generating interface '${pc14.cyan(ifaceName)}'...`);
+  const s = p15.spinner();
+  s.start(`Generating interface '${pc15.cyan(ifaceName)}'...`);
   const files = [];
   const options = {
     name: ifaceName,
@@ -3175,7 +3175,7 @@ async function runInterfaceCommand(interfaceNameArg, flags = {}) {
   }
   s.stop("Interface generated successfully!");
   printGeneratedFiles(files, options.dryRun);
-  p14.outro(pc14.green(`Interface '${ifaceName}' created in feature '${feature}'!`));
+  p15.outro(pc15.green(`Interface '${ifaceName}' created in feature '${feature}'!`));
 }
 async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
   const projectRoot = findProjectRoot();
@@ -3186,14 +3186,14 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
       const featureOptions = existingFeatures.map((f) => ({ value: f, label: f }));
       featureOptions.push({ value: "__custom__", label: "\u270F\uFE0F  Enter custom feature name..." });
       const selected = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Select target feature:",
           options: featureOptions
         })
       );
       if (selected === "__custom__") {
         feature = handleCancel(
-          await p14.text({
+          await p15.text({
             message: "Enter feature name:",
             validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
           })
@@ -3203,7 +3203,7 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
       }
     } else {
       feature = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Enter target feature name:",
           validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
         })
@@ -3214,7 +3214,7 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
   let name = handlerNameArg?.trim();
   if (!name) {
     name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "HTTP Route Handler class name:",
         placeholder: "e.g. CreateUserHttp, GetUserHttp, HealthHttp",
         validate: (v) => v && v.trim() ? void 0 : "Handler name cannot be empty"
@@ -3233,7 +3233,7 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
   let validationFields = [];
   if (!flags.yes) {
     method = handleCancel(
-      await p14.select({
+      await p15.select({
         message: "HTTP Method:",
         options: [
           { value: "get", label: "GET" },
@@ -3247,7 +3247,7 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
     );
     const defaultPath = method === "get" ? "/" : "/";
     subPath = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Route subpath (relative to feature prefix):",
         initialValue: defaultPath,
         defaultValue: defaultPath
@@ -3258,7 +3258,7 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
       const ucOptions = useCases.map((u) => ({ value: u.name, label: u.name }));
       ucOptions.push({ value: "__none__", label: "None / Standalone Handler" });
       const chosenUc = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Connect this handler to a domain Use Case?",
           options: ucOptions,
           initialValue: ucOptions[0]?.value
@@ -3269,7 +3269,7 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
       }
     }
     includeValidation = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: "Include Zod inbound request validation?",
         initialValue: method !== "delete"
       })
@@ -3277,7 +3277,7 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
     if (includeValidation) {
       const defaultSource = method === "get" ? "query" : "body";
       validationSource = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "Validation data source:",
           options: [
             { value: "body", label: "req.body (for POST / PUT / PATCH payloads)" },
@@ -3291,8 +3291,8 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
         });
     }
   }
-  const s = p14.spinner();
-  s.start(`Generating HTTP handler '${pc14.cyan(className)}'...`);
+  const s = p15.spinner();
+  s.start(`Generating HTTP handler '${pc15.cyan(className)}'...`);
   const options = {
     name: className,
     feature,
@@ -3310,7 +3310,7 @@ async function runHttpHandlerCommand(handlerNameArg, flags = {}) {
   const files = generateHttpHandler(options);
   s.stop("HTTP handler generated successfully!");
   printGeneratedFiles(files, options.dryRun);
-  p14.outro(pc14.green(`HTTP handler '${className}' created in feature '${feature}'!`));
+  p15.outro(pc15.green(`HTTP handler '${className}' created in feature '${feature}'!`));
 }
 function generateInjectableCode(className, dependencies = [], methods = [], implementsInterface) {
   const formattedDeps = dependencies.map((dep) => ({
@@ -3320,7 +3320,7 @@ function generateInjectableCode(className, dependencies = [], methods = [], impl
   const formattedMethods = methods.map((m) => {
     const isAsync = m.async !== false;
     const retType = m.returnType ? isAsync ? `Promise<${m.returnType}>` : m.returnType : isAsync ? "Promise<void>" : "void";
-    const params = m.params && m.params.length > 0 ? m.params.map((p16) => `${p16.name}: ${p16.type}`).join(", ") : "";
+    const params = m.params && m.params.length > 0 ? m.params.map((p18) => `${p18.name}: ${p18.type}`).join(", ") : "";
     return {
       name: m.name,
       isAsync,
@@ -3390,7 +3390,7 @@ async function runInjectableCommand(classNameArg, flags = {}) {
   let name = classNameArg?.trim();
   if (!name) {
     name = handleCancel(
-      await p14.text({
+      await p15.text({
         message: "Injectable class name:",
         placeholder: "e.g. PasswordHasher, TokenService, UserTransformer",
         validate: (v) => v && v.trim() ? void 0 : "Class name cannot be empty"
@@ -3403,7 +3403,7 @@ async function runInjectableCommand(classNameArg, flags = {}) {
   let customPath;
   if (!flags.yes) {
     location = handleCancel(
-      await p14.select({
+      await p15.select({
         message: "Select target architectural location:",
         options: [
           { value: "feature-service", label: "Feature Service (features/<feature>/services/)" },
@@ -3421,14 +3421,14 @@ async function runInjectableCommand(classNameArg, flags = {}) {
           const featureOptions = existingFeatures.map((f) => ({ value: f, label: f }));
           featureOptions.push({ value: "__custom__", label: "\u270F\uFE0F  Enter custom feature name..." });
           const selected = handleCancel(
-            await p14.select({
+            await p15.select({
               message: "Select target feature:",
               options: featureOptions
             })
           );
           if (selected === "__custom__") {
             feature = handleCancel(
-              await p14.text({
+              await p15.text({
                 message: "Enter feature name:",
                 validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
               })
@@ -3438,7 +3438,7 @@ async function runInjectableCommand(classNameArg, flags = {}) {
           }
         } else {
           feature = handleCancel(
-            await p14.text({
+            await p15.text({
               message: "Enter target feature name:",
               validate: (v) => v && v.trim() ? void 0 : "Feature name cannot be empty"
             })
@@ -3448,7 +3448,7 @@ async function runInjectableCommand(classNameArg, flags = {}) {
       feature = toCamelCase(feature);
     } else if (location === "custom") {
       customPath = handleCancel(
-        await p14.text({
+        await p15.text({
           message: "Enter destination directory path:",
           placeholder: "e.g. src/services or lib/utils",
           validate: (v) => v && v.trim() ? void 0 : "Path cannot be empty"
@@ -3459,14 +3459,14 @@ async function runInjectableCommand(classNameArg, flags = {}) {
   let generateInterface2 = false;
   if (!flags.yes) {
     generateInterface2 = handleCancel(
-      await p14.confirm({
+      await p15.confirm({
         message: `Generate abstract class interface (I${className}) as runtime DI token?`,
         initialValue: false
       })
     );
   }
-  const s = p14.spinner();
-  s.start(`Generating injectable '${pc14.cyan(className)}'...`);
+  const s = p15.spinner();
+  s.start(`Generating injectable '${pc15.cyan(className)}'...`);
   const options = {
     name: className,
     feature,
@@ -3480,12 +3480,44 @@ async function runInjectableCommand(classNameArg, flags = {}) {
   const files = generateInjectable(options);
   s.stop("Injectable class generated successfully!");
   printGeneratedFiles(files, options.dryRun);
-  p14.outro(pc14.green(`Injectable '${className}' created successfully!`));
+  p15.outro(pc15.green(`Injectable '${className}' created successfully!`));
 }
+async function runEnvCommand(flags = {}) {
+  const projectRoot = flags.cwd || flags.targetDir || findProjectRoot();
+  const s = p15.spinner();
+  s.start("Scanning for .example environment files...");
+  const files = fs4.readdirSync(projectRoot);
+  const exampleFiles = files.filter((file) => file.startsWith(".env") && file.endsWith(".example")).sort();
+  if (exampleFiles.length === 0) {
+    s.stop("No .example files found.");
+    p15.log.info(pc15.yellow(`No files matching '.env*.example' were found in ${projectRoot}`));
+    return [];
+  }
+  s.message(`Found ${exampleFiles.length} template(s). Generating...`);
+  const generatedFiles = [];
+  for (const exampleFile of exampleFiles) {
+    const sourcePath = path2.join(projectRoot, exampleFile);
+    const targetFile = exampleFile.replace(/\.example$/, "");
+    const targetPath = path2.join(projectRoot, targetFile);
+    const content = fs4.readFileSync(sourcePath, "utf-8");
+    const genFile = writeFileSafely(targetPath, content, {
+      projectRoot,
+      dryRun: Boolean(flags.dryRun),
+      overwrite: Boolean(flags.overwrite)
+    });
+    generatedFiles.push(genFile);
+  }
+  s.stop("Environment files processed!");
+  printGeneratedFiles(generatedFiles, Boolean(flags.dryRun));
+  p15.outro(pc15.green("\u2713 Local environment files are ready!"));
+  return generatedFiles;
+}
+
+// src/commands/menu.ts
 async function runInteractiveMenu(flags = {}) {
   printBanner();
   const choice = handleCancel(
-    await p14.select({
+    await p15.select({
       message: "What would you like to create in your architecture?",
       options: [
         {
@@ -3527,6 +3559,11 @@ async function runInteractiveMenu(flags = {}) {
           value: "injectable",
           label: "Injectable Service",
           hint: "Generic @MakeInjectable class for services, transformers, or modules"
+        },
+        {
+          value: "env",
+          label: "Generate Env Files",
+          hint: "Clone .env*.example files to local .env equivalents"
         }
       ]
     })
@@ -3556,6 +3593,9 @@ async function runInteractiveMenu(flags = {}) {
     case "injectable":
       await runInjectableCommand(void 0, flags);
       break;
+    case "env":
+      await runEnvCommand(flags);
+      break;
   }
 }
 
@@ -3593,8 +3633,8 @@ async function handleCreate(type, name, flags = {}) {
       await runInjectableCommand(name, flags);
       break;
     default:
-      p14.log.error(
-        pc14.red(
+      p15.log.error(
+        pc15.red(
           `Unknown component type: "${type}". Allowed types: feature, shared, usecase, domain, infrastructure, interface, httpHandler, injectable.`
         )
       );
@@ -3602,9 +3642,9 @@ async function handleCreate(type, name, flags = {}) {
   }
 }
 var importPrompts = {
-  select: p14.select,
-  text: p14.text,
-  confirm: p14.confirm
+  select: p15.select,
+  text: p15.text,
+  confirm: p15.confirm
 };
 function isTestFile(filePath) {
   const normalized = filePath.replace(/\\/g, "/");
@@ -3714,19 +3754,19 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     );
   }
   if (type !== "shared" && type !== "feature") {
-    p14.log.error(pc14.red(`Invalid module type: "${typeArg}". Must be "shared" or "feature".`));
+    p15.log.error(pc15.red(`Invalid module type: "${typeArg}". Must be "shared" or "feature".`));
     process.exit(1);
   }
   const registryBase = getRegistryBase(projectRoot, flags.registry);
-  const s = p14.spinner();
-  s.start(`Connecting to registry at ${pc14.dim(registryBase)}...`);
+  const s = p15.spinner();
+  s.start(`Connecting to registry at ${pc15.dim(registryBase)}...`);
   let index;
   try {
     index = await fetchRegistryIndex(registryBase);
     s.stop("Registry index loaded.");
   } catch (err) {
-    s.stop(pc14.red("Failed to load registry index."));
-    p14.log.error(pc14.red(err.message || String(err)));
+    s.stop(pc15.red("Failed to load registry index."));
+    p15.log.error(pc15.red(err.message || String(err)));
     process.exit(1);
   }
   const availableList = type === "shared" ? index.shared : index.features;
@@ -3734,7 +3774,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
   let name = nameArg?.trim();
   if (!name) {
     if (availableList.length === 0) {
-      p14.log.warn(`No ${type} modules available in the registry.`);
+      p15.log.warn(`No ${type} modules available in the registry.`);
       return;
     }
     name = handleCancel(
@@ -3750,9 +3790,9 @@ async function handleImport(typeArg, nameArg, flags = {}) {
   }
   if (!candidateNames.includes(name)) {
     const closest = findClosestMatch(name, candidateNames);
-    p14.log.error(pc14.red(`\u274C Module '${name}' not found in the ${type} registry.`));
+    p15.log.error(pc15.red(`\u274C Module '${name}' not found in the ${type} registry.`));
     if (closest) {
-      p14.log.info(pc14.yellow(`Did you mean '${pc14.cyan(closest)}'?`));
+      p15.log.info(pc15.yellow(`Did you mean '${pc15.cyan(closest)}'?`));
     }
     process.exit(1);
   }
@@ -3764,7 +3804,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     try {
       manifest = await fetchModuleManifest(registryBase, modType, modName);
     } catch (err) {
-      p14.log.error(pc14.red(`Failed to fetch manifest for ${modType} '${modName}': ${err.message}`));
+      p15.log.error(pc15.red(`Failed to fetch manifest for ${modType} '${modName}': ${err.message}`));
       process.exit(1);
     }
     nodes.set(key, {
@@ -3804,7 +3844,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
   buildTopologicalOrder(rootKey);
   const resolutions = /* @__PURE__ */ new Map();
   const globalAliasMap = /* @__PURE__ */ new Map();
-  p14.log.step(`Importing ${type}: ${pc14.cyan(name)}...`);
+  p15.log.step(`Importing ${type}: ${pc15.cyan(name)}...`);
   for (const key of orderedKeys) {
     const node = nodes.get(key);
     const { type: modType, name: registryName, manifest } = node;
@@ -3836,8 +3876,8 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     const programmaticPointTo = pointToMap[registryName] || pointToMap[`${modType}/${registryName}`];
     if (programmaticPointTo) {
       if (!checkModuleExists(projectRoot, modType, programmaticPointTo)) {
-        p14.log.error(
-          pc14.red(
+        p15.log.error(
+          pc15.red(
             `Module '${programmaticPointTo}' specified in --point-to does not exist in ${folder}.`
           )
         );
@@ -3845,7 +3885,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       }
       globalAliasMap.set(`@/${folder}/${registryName}/`, `@/${folder}/${programmaticPointTo}/`);
       globalAliasMap.set(`@/${folder}/${registryName}`, `@/${folder}/${programmaticPointTo}`);
-      p14.log.step(`Pointing '${modType}/${registryName}' to existing '${folder}/${programmaticPointTo}'`);
+      p15.log.step(`Pointing '${modType}/${registryName}' to existing '${folder}/${programmaticPointTo}'`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -3861,7 +3901,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       globalAliasMap.set(`@/${folder}/${registryName}`, `@/${folder}/${programmaticAlias}`);
       const baseDir = getModuleBaseDir(projectRoot, modType);
       const displayDest = path2.relative(projectRoot, path2.join(baseDir, programmaticAlias));
-      p14.log.step(`Importing '${registryName}' into '${displayDest}'...`);
+      p15.log.step(`Importing '${registryName}' into '${displayDest}'...`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -3873,7 +3913,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     }
     const existingDir = getExistingModuleDir(projectRoot, modType, registryName);
     if (!existingDir) {
-      p14.log.info(`  \u21B3 Resolving required ${modType} dependency: ${pc14.cyan(registryName)}`);
+      p15.log.info(`  \u21B3 Resolving required ${modType} dependency: ${pc15.cyan(registryName)}`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -3889,7 +3929,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     const remoteIntegrity = manifest.integrity || entry?.integrity;
     const localHash = computeDirectoryHash(existingDir);
     if (remoteIntegrity && localHash === remoteIntegrity) {
-      p14.log.step(`\u2713 ${modType}/${registryName} is up to date (reusing existing)`);
+      p15.log.step(`\u2713 ${modType}/${registryName} is up to date (reusing existing)`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -3900,7 +3940,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       continue;
     }
     if (flags.overwrite) {
-      p14.log.step(`Overwriting '${modType}/${registryName}' with registry version (--overwrite)...`);
+      p15.log.step(`Overwriting '${modType}/${registryName}' with registry version (--overwrite)...`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -3911,7 +3951,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       continue;
     }
     if (flags.yes) {
-      p14.log.info(`Using existing '${modType}/${registryName}'`);
+      p15.log.info(`Using existing '${modType}/${registryName}'`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -3945,7 +3985,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       })
     );
     if (choice === "keep_existing" || choice === "use_existing") {
-      p14.log.step(`Skipping '${modType}/${registryName}' (keeping existing)`);
+      p15.log.step(`Skipping '${modType}/${registryName}' (keeping existing)`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -4017,7 +4057,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       chosenName = chosenName.replace(/^@\/(shared|features)\//, "").replace(/^(src\/)?(shared|features)\//, "").replace(/^\/+|\/+$/g, "").trim();
       globalAliasMap.set(`@/${folder}/${registryName}/`, `@/${folder}/${chosenName}/`);
       globalAliasMap.set(`@/${folder}/${registryName}`, `@/${folder}/${chosenName}`);
-      p14.log.step(`Pointing '${modType}/${registryName}' to existing '${folder}/${chosenName}'`);
+      p15.log.step(`Pointing '${modType}/${registryName}' to existing '${folder}/${chosenName}'`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -4049,7 +4089,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       globalAliasMap.set(`@/${folder}/${registryName}`, `@/${folder}/${newName}`);
       const baseDir = getModuleBaseDir(projectRoot, modType);
       const displayDest = path2.relative(projectRoot, path2.join(baseDir, newName));
-      p14.log.step(`Importing '${registryName}' into '${displayDest}'...`);
+      p15.log.step(`Importing '${registryName}' into '${displayDest}'...`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -4060,7 +4100,7 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       continue;
     }
     if (choice === "overwrite") {
-      p14.log.step(`Overwriting '${modType}/${registryName}' with registry version...`);
+      p15.log.step(`Overwriting '${modType}/${registryName}' with registry version...`);
       resolutions.set(key, {
         type: modType,
         registryName,
@@ -4103,8 +4143,8 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     const targetDir = path2.join(getModuleBaseDir(projectRoot, res.type), res.targetName);
     const isOverwrite = Boolean(flags.overwrite || res.action === "overwrite");
     if (key !== rootKey) {
-      p14.log.step(
-        `Importing ${res.type}: ${pc14.cyan(res.targetName)}${res.targetName !== res.registryName ? pc14.dim(` (from ${res.registryName})`) : ""}...`
+      p15.log.step(
+        `Importing ${res.type}: ${pc15.cyan(res.targetName)}${res.targetName !== res.registryName ? pc15.dim(` (from ${res.registryName})`) : ""}...`
       );
     }
     if (res.action === "overwrite" && !flags.dryRun) {
@@ -4122,8 +4162,8 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       const remoteFilePath = `${folder}/${res.registryName}/${file}`;
       const localFilePath = path2.join(targetDir, file);
       if (fs4.existsSync(localFilePath) && !isOverwrite) {
-        p14.log.warn(
-          `  \u21B3 Skipping existing file: ${pc14.dim(path2.relative(projectRoot, localFilePath))} (use --overwrite to replace)`
+        p15.log.warn(
+          `  \u21B3 Skipping existing file: ${pc15.dim(path2.relative(projectRoot, localFilePath))} (use --overwrite to replace)`
         );
         continue;
       }
@@ -4135,18 +4175,18 @@ async function handleImport(typeArg, nameArg, flags = {}) {
       }
       const displayPath = path2.relative(projectRoot, localFilePath);
       totalWrittenFiles.push(displayPath);
-      p14.log.message(`  ${pc14.green("+")} ${displayPath}`);
+      p15.log.message(`  ${pc15.green("+")} ${displayPath}`);
     }
   }
   const missingNpm = getMissingNpmPackages(projectRoot, Array.from(requiredNpmPackages));
   if (missingNpm.length > 0) {
     if (flags.skipInstall || flags.dryRun) {
-      p14.log.info(`Required npm dependencies to install: ${pc14.cyan(missingNpm.join(", "))}`);
+      p15.log.info(`Required npm dependencies to install: ${pc15.cyan(missingNpm.join(", "))}`);
     } else {
       try {
         installNpmPackages(projectRoot, missingNpm);
       } catch (err) {
-        p14.log.warn(
+        p15.log.warn(
           `Could not automatically install packages (${err.message}). Please run: npm install ${missingNpm.join(
             " "
           )}`
@@ -4155,13 +4195,13 @@ async function handleImport(typeArg, nameArg, flags = {}) {
     }
   }
   if (flags.dryRun) {
-    p14.log.info(pc14.yellow("Dry run complete: No files were written to disk."));
+    p15.log.info(pc15.yellow("Dry run complete: No files were written to disk."));
   } else {
     const rootRes = resolutions.get(rootKey);
     const baseDir = getModuleBaseDir(projectRoot, type);
     const displayTarget = path2.relative(projectRoot, path2.join(baseDir, rootRes.targetName));
-    p14.log.success(
-      pc14.green(
+    p15.log.success(
+      pc15.green(
         `Successfully imported ${type} '${name}' (${totalWrittenFiles.length} file${totalWrittenFiles.length === 1 ? "" : "s"} placed in ${displayTarget})`
       )
     );
@@ -4384,10 +4424,10 @@ var FeatureDependencyGraph = class {
             if (cycle) return cycle;
           } else if (inStack.has(next)) {
             const cycle = [next];
-            let p16 = curr;
-            while (p16 !== next) {
-              cycle.push(p16);
-              p16 = parent.get(p16) || next;
+            let p18 = curr;
+            while (p18 !== next) {
+              cycle.push(p18);
+              p18 = parent.get(p18) || next;
             }
             cycle.push(next);
             cycle.reverse();
@@ -5289,15 +5329,15 @@ ${compiledDetails}
 // src/commands/lint.ts
 function formatViolation(v) {
   const lines = [];
-  lines.push(pc14.underline(pc14.cyan(v.relativePath)) + pc14.dim(":") + pc14.yellow(String(v.line)));
+  lines.push(pc15.underline(pc15.cyan(v.relativePath)) + pc15.dim(":") + pc15.yellow(String(v.line)));
   const gutter = `${String(v.line).padStart(4, " ")} | `;
-  lines.push(pc14.dim(gutter) + v.code);
+  lines.push(pc15.dim(gutter) + v.code);
   const categoryShort = v.category.replace(" Violation", "");
   lines.push(
-    "       " + pc14.red(pc14.bold("\u2716")) + " " + pc14.red(`[${categoryShort}]`) + " " + v.advice
+    "       " + pc15.red(pc15.bold("\u2716")) + " " + pc15.red(`[${categoryShort}]`) + " " + v.advice
   );
   if (v.fixExample?.good) {
-    lines.push("       " + pc14.dim("\u2192") + " " + pc14.dim(v.fixExample.good));
+    lines.push("       " + pc15.dim("\u2192") + " " + pc15.dim(v.fixExample.good));
   }
   return lines.join("\n");
 }
@@ -5322,7 +5362,7 @@ async function handleLint(flags = {}) {
           console.log("");
         }
         console.log(
-          pc14.red(
+          pc15.red(
             `\u2716 Dependency rules check failed with ${summary.totalViolations} error${summary.totalViolations > 1 ? "s" : ""} across ${summary.violatedFeatures} feature${summary.violatedFeatures > 1 ? "s" : ""} (${summary.totalFeatures} features scanned).`
           )
         );
@@ -5341,7 +5381,7 @@ ${compiledDetails}
     }
     if (!quiet) {
       console.log(
-        pc14.green(
+        pc15.green(
           `\u2714 Dependency rules verified across ${summary.totalFeatures} feature${summary.totalFeatures === 1 ? "" : "s"}.`
         )
       );
@@ -5356,21 +5396,55 @@ ${compiledDetails}
           console.log(formatViolation(v));
           console.log("");
         }
-        console.log(pc14.red(`\u2716 Dependency rules check failed (1 error).`));
+        console.log(pc15.red(`\u2716 Dependency rules check failed (1 error).`));
         console.log("");
       }
     }
     throw err;
   }
 }
+async function handleInit(type, flags = {}) {
+  if (!type) {
+    const choice = handleCancel(
+      await p15.select({
+        message: "What would you like to initialize?",
+        options: [
+          {
+            value: "env",
+            label: "Environment Files",
+            hint: "Generate local .env files from .env*.example templates"
+          }
+        ]
+      })
+    );
+    if (choice === "env") {
+      await runEnvCommand(flags);
+    }
+    return;
+  }
+  const normalized = type.trim().toLowerCase();
+  if (normalized === "env") {
+    await runEnvCommand(flags);
+  } else {
+    p15.log.error(
+      pc15.red(
+        `Unknown init target: "${type}". Allowed targets: env.`
+      )
+    );
+    if (process.env.VITEST) {
+      throw new Error(`Unknown init target: "${type}". Allowed targets: env.`);
+    }
+    process.exit(1);
+  }
+}
 
 // src/cli.ts
 function createCli() {
   const cli = cac("mason");
   cli.command("[...args]", "Interactive scaffolding and import wizard").option("-d, --dry-run", "Preview changes without writing to disk").option("-o, --overwrite", "Overwrite existing files").option("-y, --yes", "Accept defaults and skip interactive prompts").option("--registry", "Run in registry mode").option("--point-to <mapping>", "Point a dependency to an existing local module (e.g. --point-to time:mytime)").option("--alias <mapping>", "Import a dependency fresh under an alias name (e.g. --alias time:time-mason)").option("--tests", "Include test files (use --no-tests to exclude)").action(async (args, flags) => {
     if (args && args.length > 0) {
-      p14.log.error(
-        pc14.red(
+      p15.log.error(
+        pc15.red(
           `Unknown command: "${args.join(" ")}". Use --help to list available commands.`
         )
       );
@@ -5381,7 +5455,7 @@ function createCli() {
       const mode = getEffectiveMode(projectRoot, flags);
       if (mode === "registry") {
         const choice2 = handleCancel(
-          await p14.select({
+          await p15.select({
             message: "\u{1F3DB}\uFE0F  Mason (Registry Mode): What would you like to scaffold?",
             options: [
               {
@@ -5424,7 +5498,7 @@ function createCli() {
         return;
       }
       const choice = handleCancel(
-        await p14.select({
+        await p15.select({
           message: "\u{1F9F1} Mason: What would you like to do?",
           options: [
             {
@@ -5441,6 +5515,11 @@ function createCli() {
               value: "lint",
               label: "Lint dependency rules",
               hint: "Scan codebase and verify Clean Architecture dependency rules"
+            },
+            {
+              value: "init",
+              label: "Initialize environment",
+              hint: "Generate local .env files from .env*.example templates"
             }
           ]
         })
@@ -5451,6 +5530,8 @@ function createCli() {
         await handleImport(void 0, void 0, flags);
       } else if (choice === "lint") {
         await handleLint(flags);
+      } else if (choice === "init") {
+        await handleInit("env", flags);
       }
     } catch (err) {
       handleCliError(err);
@@ -5498,6 +5579,16 @@ function createCli() {
       handleCliError(err);
     }
   });
+  cli.command(
+    "init [type]",
+    "Initialize project configurations and resources (e.g. 'mason init env')"
+  ).option("-d, --dry-run", "Preview changes without writing to disk").option("-o, --overwrite", "Overwrite existing .env files").example("mason init env").example("mason init env --overwrite").example("mason init env --dry-run").action(async (type, flags = {}) => {
+    try {
+      await handleInit(type, flags);
+    } catch (err) {
+      handleCliError(err);
+    }
+  });
   const createSubtypes = [
     "feature",
     "shared",
@@ -5529,7 +5620,7 @@ function handleCliError(err) {
     process.exit(0);
   }
   const message = err instanceof Error ? err.message : String(err);
-  p14.log.error(pc14.red(`Error: ${message}`));
+  p15.log.error(pc15.red(`Error: ${message}`));
   if (process.env.VITEST) {
     throw err;
   }
@@ -5540,6 +5631,6 @@ async function runCli(argv = process.argv) {
   cli.parse(argv, { run: true });
 }
 
-export { DEFAULT_REGISTRY_BASE, DependencyRuleError, FeatureDependencyGraph, PromptCancelledError, computeDirectoryHash, concreteInfraTemplate, createCli, detectPackageManager, diProviderTemplate, domainClassTemplate, domainInterfaceTemplate, domainValueObjectTemplate, ensureInterfacePrefix, expressIndexTemplate, fetchModuleManifest, fetchRegistryFile, fetchRegistryIndex, findClosestMatch, findInterfaceFile, findLocalRegistry, findProjectRoot, generateConcreteInfraCode, generateDomain, generateDomainEntityCode, generateFeature, generateHttpHandler, generateHttpHandlerCode, generateInfrastructure, generateInjectable, generateInjectableCode, generateInterface, generateInterfaceCode, generateShared, generateStubCode, generateUseCase, generateUseCaseCode, generateUseCaseTestCode, getAllFiles, getConfiguredFeaturesDir, getConfiguredSharedDir, getEffectiveMode, getMissingNpmPackages, getRegistryBase, getTemplatesDir, handleCancel, handleCreate, handleImport, handleLint, hbs, httpHandlerTemplate, injectableInterfaceTemplate, injectableTemplate, installNpmPackages, interfaceTemplate, isValidIdentifier, levenshteinDistance, lintCodebase, listDomainEntities, listDomainInterfaces, listExistingFeatures, listExistingShared, listUseCases, loadInterfaceHierarchy, loadMasonConfig, loadTemplate, normalizeRegistryUrl, parseInterfaceMethodsAndImports, printBanner, printGeneratedFiles, promptProperties, removeInterfacePrefix, renderTemplate, renderTemplateFile, resolveFeaturesDir, resolveSharedDir, runCli, runSharedCommand, stubInfraTemplate, synthesizeCrudMethods, toCamelCase, toKebabCase, toPascalCase, toPlural, toSingular, toStubName, updateOrGenerateDiProvider, useCaseTemplate, useCaseTestTemplate, writeFileSafely };
+export { DEFAULT_REGISTRY_BASE, DependencyRuleError, FeatureDependencyGraph, PromptCancelledError, computeDirectoryHash, concreteInfraTemplate, createCli, detectPackageManager, diProviderTemplate, domainClassTemplate, domainInterfaceTemplate, domainValueObjectTemplate, ensureInterfacePrefix, expressIndexTemplate, fetchModuleManifest, fetchRegistryFile, fetchRegistryIndex, findClosestMatch, findInterfaceFile, findLocalRegistry, findProjectRoot, generateConcreteInfraCode, generateDomain, generateDomainEntityCode, generateFeature, generateHttpHandler, generateHttpHandlerCode, generateInfrastructure, generateInjectable, generateInjectableCode, generateInterface, generateInterfaceCode, generateShared, generateStubCode, generateUseCase, generateUseCaseCode, generateUseCaseTestCode, getAllFiles, getConfiguredFeaturesDir, getConfiguredSharedDir, getEffectiveMode, getMissingNpmPackages, getRegistryBase, getTemplatesDir, handleCancel, handleCreate, handleImport, handleInit, handleLint, hbs, httpHandlerTemplate, injectableInterfaceTemplate, injectableTemplate, installNpmPackages, interfaceTemplate, isValidIdentifier, levenshteinDistance, lintCodebase, listDomainEntities, listDomainInterfaces, listExistingFeatures, listExistingShared, listUseCases, loadInterfaceHierarchy, loadMasonConfig, loadTemplate, normalizeRegistryUrl, parseInterfaceMethodsAndImports, printBanner, printGeneratedFiles, promptProperties, removeInterfacePrefix, renderTemplate, renderTemplateFile, resolveFeaturesDir, resolveSharedDir, runCli, runEnvCommand, runSharedCommand, stubInfraTemplate, synthesizeCrudMethods, toCamelCase, toKebabCase, toPascalCase, toPlural, toSingular, toStubName, updateOrGenerateDiProvider, useCaseTemplate, useCaseTestTemplate, writeFileSafely };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map