@technicalshree/auto-fix 1.2.0 → 1.2.2

package/README.md

@@ -11,6 +11,10 @@
 - Supports gated destructive cleanup (`--deep`, `--approve`)
 - Writes run reports and snapshot metadata for rollback
 - Supports best-effort `undo` for snapshotted changes
+- Syncs `.env` files from `.env.example` templates (v1.2)
+- Detects Node/Python runtime version drift (v1.2)
+- Auto-configures VS Code Python interpreter path (v1.2)
+- Provides actionable guidance for EPERM/EBUSY file lock errors (v1.2)
 
 ## Requirements
 
@@ -162,6 +166,56 @@ auto-fix clear-yarn-cache
 auto-fix clear-pnpm-cache
 ```
 
+## v1.2 Features
+
+### Environment Variable Synchronization
+
+`auto-fix` detects `.env.example` files and helps keep your local `.env` in sync:
+
+- **Missing `.env`**: If `.env.example` exists but `.env` does not, auto-fix will copy it automatically.
+- **Missing keys**: If both files exist, auto-fix compares the keys and appends any missing keys from `.env.example` to your `.env` with empty values.
+- Changes to `.env` are snapshotted for undo coverage.
+
+```bash
+# See env sync in action
+auto-fix plan
+# Output: ● Copy .env.example to .env
+# Output: ● Append 2 missing key(s) to .env
+```
+
+### Runtime Engine Version Checks
+
+`auto-fix` validates that your local Node.js and Python versions match what the project expects:
+
+- **Node**: Reads `.nvmrc` or `.node-version` and compares the major version against `process.version`. Emits a warning with suggested action (`nvm use`).
+- **Python**: Reads `.python-version` and flags a version drift warning.
+- These checks run **before** dependency installations to catch mismatches early.
+- Engine checks fire based on version file existence alone — no `package.json` or `pyproject.toml` required.
+
+```bash
+auto-fix plan
+# Output: ● Node version drift detected: expected ~18, running v22.x — Run nvm use
+# Output: ● Python version drift: project expects 3.11
+```
+
+### VS Code Python Integration
+
+When a Python virtual environment (`.venv`) exists or is being created, `auto-fix` automatically configures VS Code to use it:
+
+- Sets `python.defaultInterpreterPath` in `.vscode/settings.json`
+- Prevents false-positive Pylance/Pyright linting errors for new developers
+- The change is snapshotted for undo coverage
+
+### EPERM/EBUSY Error Guidance
+
+When `node_modules` cleanup or dependency installation fails due to file locks (common on Windows and macOS), `auto-fix` now provides specific, actionable error messages:
+
+```
+✖ Permission/lock error (EPERM/EBUSY). Close your IDE, dev servers, or file watchers and retry.
+```
+
+This replaces the previous generic "One or more commands failed" message.
+
 ## Commands
 
 `auto-fix [command] [flags]`
@@ -381,9 +435,14 @@ npm run build
 - `src/config/`: defaults and config loading
 - `src/report/`: summary and report writing
 - `src/subsystems/`: subsystem-specific checks/fixes
+  - `environment.ts`: `.env` sync logic (v1.2)
+  - `engines.ts`: runtime version checks (v1.2)
 - `src/ui/`: terminal renderer and progress hooks
 - `dist/`: compiled JavaScript output
 - `docs/`: product requirement docs and notes
+- `test/`: test suites
+  - `smoke.test.mjs`: CLI smoke tests
+  - `v1.2.test.mjs`: v1.2 feature unit tests
 
 ## Troubleshooting
 
@@ -403,6 +462,25 @@ Non-interactive environments behave conservatively:
 
 - In polyglot projects (Node + Python + Docker), non-interactive mode without `--approve` may limit execution to a safe subset
 
+## Changelog
+
+### v1.2.0
+
+- **Environment sync**: Auto-copy `.env.example` → `.env`; detect and append missing keys
+- **Engine version checks**: Validate Node (`.nvmrc`) and Python (`.python-version`) versions before dependency install
+- **VS Code integration**: Auto-configure `python.defaultInterpreterPath` when `.venv` exists
+- **EPERM handling**: Actionable error messages for file lock failures in node steps
+- **Snapshot improvements**: Non-destructive steps with declared snapshot paths are now backed up
+- **Undo fix**: Nested file paths (e.g., `.vscode/settings.json`) are now restored correctly
+- **Test coverage**: Added 8 unit tests for v1.2 features
+
+### v1.1.x
+
+- Initial release with Node, Python, Docker detection and safe fix execution
+- Polyglot project support with interactive confirmation
+- Run reports, snapshots, and best-effort undo
+- CLI help, version banner, and configurable `.autofix.yml`
+
 ## License
 
 ISC

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@technicalshree/auto-fix",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Detect, diagnose, and safely fix common local dev environment issues",
   "main": "dist/cli.js",
   "repository": {