chore: bump version to 0.1.9, resolve version dynamically, and document new features in README

Author: avenolazo

CHANGELOG.md

@@ -5,7 +5,7 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [0.1.8] - 2026-07-13
+## [0.1.9] - 2026-07-13
 
 ### Added
 
@@ -14,6 +14,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - Added `init` command to bootstrap `.env.example` templates by parsing an active `.env` file, preserving formatting/comments, and stripping variable values.
 - Configured continuous integration automation in `.github/workflows/ci.yml` verifying builds, tests, lints, and format rules.
 - Created `SECURITY.md` defining supported versions and secure vulnerability disclosure channels.
+- Updated CLI entry to dynamically resolve program version from `package.json` at runtime, preventing manual synchronization overhead.
+- Expanded `README.md` to document the new `init` command, the `--mode` flag, and multi-environment cascading rules.
 
 ### Fixed
 

README.md

@@ -44,6 +44,7 @@
 - [Comparison](#comparison)
 - [Command Reference](#command-reference)
 - [Options](#options)
+- [Multi-Environment Support](#multi-environment-support)
 - [CI/CD Integration](#cicd-integration)
 - [Contributing](#contributing)
 - [License](#license)
@@ -289,12 +290,34 @@ envrepair check
 
 Runs validation without interactive prompts, outputs differences in JSON, and exits with status 1 if variables are missing. Designed for CI/CD scripting.
 
+### init
+
+```bash
+envrepair init
+```
+
+Bootstraps a `.env.example` template by parsing an active `.env` file, preserving all spacing, comments, and structure while stripping the values of all variables.
+
 ## Options
 
-- `-e, --env <path>`: Path to the active env file (defaults to `.env`).
+- `-e, --env <path>`: Path to the active env file.
 - `-x, --example <path>`: Path to the template example file (defaults to `.env.example`).
+- `-m, --mode <name>`: Specifies environment mode (e.g. `development`, `production`). Resolves cascading files matching the mode.
 - `-h, --help`: Displays help information.
 
+## Multi-Environment Support
+
+`envrepair` automatically supports multi-environment configurations using priority-based cascading resolution, mirroring standard frameworks (such as Next.js and Vite).
+
+When you run `envrepair` without file path overrides, it scans and merges variables from existing active files in the following priority order (from lowest to highest):
+
+1. `.env` (lowest priority)
+2. `.env.${mode}` (if `--mode` is specified)
+3. `.env.local` (local overrides; skipped if `--mode test` is used)
+4. `.env.${mode}.local` (highest priority; if `--mode` is specified)
+
+Any missing variables identified will be appended to the highest priority existing override file on disk (defaulting to `.env` or `.env.${mode}`).
+
 ## CI/CD Integration
 
 In headless environments, `envrepair` skips prompts and exits with status 1 if variables are missing:

package.json

@@ -1,6 +1,6 @@
 {
   "name": "envrepair",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Self-healing environment configuration manager for local development",
   "type": "module",
   "main": "./dist/index.js",

src/cli/index.ts

@@ -1,5 +1,7 @@
 import { Command } from "commander"
 import path from "node:path"
+import { readFileSync } from "node:fs"
+import { fileURLToPath } from "node:url"
 import { findEnvFiles, fileExists } from "../utils/env-files.js"
 import { compareEnvs } from "../core/differ.js"
 import { appendVariables } from "../core/writer.js"
@@ -9,12 +11,15 @@ import { launchProcess } from "../runner/proxy.js"
 import { isCI } from "../utils/ci.js"
 import { log } from "../utils/logger.js"
 
+const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../package.json")
+const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"))
+
 const program = new Command()
 
 program
   .name("envrepair")
   .description("Self-healing environment configuration manager for local development")
-  .version("0.1.8")
+  .version(pkg.version)
   .option("-e, --env <path>", "Path to the environment file")
   .option("-x, --example <path>", "Path to the example template file")
   .option("-m, --mode <name>", "Environment mode (e.g. development, production, test)")