fix: Change flash-install command to use direct CLI implementation for better reliability

Author: Your Name

CHANGELOG.md

@@ -0,0 +1,21 @@
+# Changelog
+
+## Version 1.8.1 (2024-07-10)
+
+### Breaking Changes
+- Changed the `flash-install` command to use the direct CLI implementation for better reliability and performance
+- Removed the React-based terminal UI to avoid compatibility issues with React versions
+
+### Bug Fixes
+- Fixed critical error when running `flash-install` after downloading
+- Fixed React version compatibility issues by downgrading React from 19.1.0 to 18.3.1
+- Updated the postinstall script to make the direct CLI executable
+
+### Documentation
+- Updated README and documentation to reflect the new command usage
+- Clarified that `flash-install install` is the recommended command
+- Added more examples of command usage
+
+## Version 1.8.0
+
+Initial release with full feature set.

README.md

@@ -333,25 +333,26 @@ Contributions are welcome! Please feel free to submit a Pull Request.
 
 
 
-## Direct CLI Interface
+## CLI Interface
 
-flash-install provides two CLI interfaces:
+The `flash-install` command uses a direct CLI implementation for better reliability and performance. When you run `flash-install`, you're using the direct CLI interface which provides all the core functionality you need.
 
-1. **Main CLI Interface** (`flash-install`): The primary interface with all core commands and features.
-2. **Direct CLI Interface** (`flash-install-direct`): A simplified interface with direct implementations of commands.
+```bash
+# Basic usage
+flash-install install
 
-The direct CLI interface can be accessed by running:
+# Create a snapshot
+flash-install snapshot
 
-```bash
-node dist/cli-direct.js <command>
+# Restore from a snapshot
+flash-install restore
 ```
 
-This interface is useful for:
-- Debugging issues with the main CLI
-- Running commands with minimal overhead
-- Accessing experimental features not yet available in the main CLI
-
-> **Note:** Some commands may behave slightly differently between the two interfaces. The main CLI interface is recommended for most users.
+This implementation:
+- Provides reliable progress reporting
+- Has minimal overhead
+- Works consistently across different environments
+- Avoids compatibility issues with terminal UI libraries
 
 ## Documentation
 

docs/docs/getting-started.md

@@ -26,19 +26,9 @@ npm install -g @flash-install/cli
 
 This will make the `flash-install`, `flash-direct`, and `flash-install-direct` commands available globally on your system.
 
-## CLI Interfaces
+## CLI Interface
 
-flash-install provides two CLI interfaces:
-
-1. **Main CLI Interface** (`flash-install`): The primary interface with all core commands and features.
-2. **Direct CLI Interface** (`flash-direct` or `flash-install-direct`): A simplified interface with direct implementations of commands.
-
-The direct CLI interface is useful for:
-- Debugging issues with the main CLI
-- Running commands with minimal overhead
-- Accessing experimental features not yet available in the main CLI
-
-> **Note:** Some commands may behave slightly differently between the two interfaces. The main CLI interface is recommended for most users.
+The `flash-install` command provides a reliable and efficient interface for all your dependency management needs. It uses a direct implementation that avoids compatibility issues with terminal UI libraries.
 
 ## Basic Usage
 
@@ -48,10 +38,10 @@ Replace your regular `npm install` command with `flash-install`:
 
 ```bash
 # Standard installation
-flash-install
+flash-install install
 
-# Or use direct mode for better progress reporting
-flash-direct
+# Or simply
+flash-install
 ```
 
 flash-install will automatically detect your package manager (npm, yarn, or pnpm) based on the lock files in your project.

docs/index.html

@@ -427,6 +427,9 @@ <h2 class="section-title">Installation</h2>
     <div class="section">
         <h2 class="section-title">Basic Usage</h2>
         <pre><code><span class="code-comment"># Standard installation</span>
+flash-install install
+
+<span class="code-comment"># Or simply</span>
 flash-install
 
 <span class="code-comment"># Create a snapshot</span>

docs/index.md

@@ -105,10 +105,10 @@ Replace your regular `npm install` command with `flash-install`:
 
 ```bash
 # Standard installation
-flash-install
+flash-install install
 
-# Or use direct mode for better progress reporting
-flash-direct
+# Or simply
+flash-install
 ```
 
 [Get Started with flash-install]({{ site.baseurl }}/docs/getting-started){: .btn }

package-lock.json

@@ -1,13 +1,13 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "@flash-install/cli",
-  "version": "1.8.0",
+  "version": "1.8.1",
   "description": "A fast, drop-in replacement for npm install with deterministic caching",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
-    "flash-install": "dist/cli.js",
-    "flash": "dist/cli.js",
+    "flash-install": "dist/cli-direct.js",
+    "flash": "dist/cli-direct.js",
     "flash-direct": "dist/cli-direct.js",
     "flash-install-direct": "dist/cli-direct.js"
   },
@@ -80,8 +80,8 @@
     "js-yaml": "^4.1.0",
     "jsonc-parser": "^3.2.0",
     "lodash": "^4.17.21",
-    "react": "^19.1.0",
-    "react-dom": "^19.1.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
     "readable-stream": "^4.7.0",
     "semver": "^7.5.4",
     "tar-stream": "^3.1.6",
@@ -97,8 +97,8 @@
     "@types/jest": "^29.5.0",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^18.15.11",
-    "@types/react": "^19.1.2",
-    "@types/react-dom": "^19.1.2",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
     "@types/semver": "^7.5.3",
     "@types/tar-stream": "^3.1.3",
     "@typescript-eslint/eslint-plugin": "^5.57.1",

package.json

@@ -9,7 +9,7 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
 // Make the CLI file executable
-const cliPath = path.join(__dirname, '..', 'dist', 'cli.js');
+const cliPath = path.join(__dirname, '..', 'dist', 'cli-direct.js');
 
 try {
   // Check if the file exists