@shenvy/cli 0.1.8 → 0.1.9

package/Formula/shenvy.rb

@@ -5,20 +5,20 @@
 class Shenvy < Formula
   desc "Securely manage environment variables with E2EE."
   homepage "https://shenvy.dev"
-  version "0.1.7"
+  version "0.1.8"
 
   on_macos do
     if Hardware::CPU.intel?
-      url "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.7/shenvy_darwin_amd64.tar.gz"
-      sha256 "ee1e6c19ad873bdd734d198ef0eebca4888713fe8b3c84a6c374bce17962a3f4"
+      url "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.8/shenvy_darwin_amd64.tar.gz"
+      sha256 "a5c65110cd0a4acbb9b9038242f8e798c82b78d9155611a5964c9ec435dbbb8a"
 
       define_method(:install) do
         bin.install "shenvy"
       end
     end
     if Hardware::CPU.arm?
-      url "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.7/shenvy_darwin_arm64.tar.gz"
-      sha256 "fed746ba5b3dc583813e3723878567fb65f82f5e0f5e62c5fe880ab19263ef74"
+      url "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.8/shenvy_darwin_arm64.tar.gz"
+      sha256 "0ce6d67606c51707cc2434b4730e42046b9a703a9f378e69593fe0e81ce4c008"
 
       define_method(:install) do
         bin.install "shenvy"
@@ -28,15 +28,15 @@ class Shenvy < Formula
 
   on_linux do
     if Hardware::CPU.intel? && Hardware::CPU.is_64_bit?
-      url "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.7/shenvy_linux_amd64.tar.gz"
-      sha256 "7bafe1011b8a6cbf819251f8be90dd16a6786b84f07a0b7bcc5dbd8100209cca"
+      url "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.8/shenvy_linux_amd64.tar.gz"
+      sha256 "adace922b5f8b4218cfb1da4fd0c49ffa060e44f54497370992a934599490624"
       define_method(:install) do
         bin.install "shenvy"
       end
     end
     if Hardware::CPU.arm? && Hardware::CPU.is_64_bit?
-      url "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.7/shenvy_linux_arm64.tar.gz"
-      sha256 "315503c0f9d62637b2dd405a25fa85d19647b86e0a159d91c570029b6295279f"
+      url "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.8/shenvy_linux_arm64.tar.gz"
+      sha256 "e9200f38e0d0e4e770a53d58403518efdaacd10a64f8190023e5216276b9b8a8"
       define_method(:install) do
         bin.install "shenvy"
       end

package/bin/README.md

@@ -0,0 +1,345 @@
+# Shenvy CLI
+
+CLI to manage projects, teams, members, and environment variables securely with end-to-end encryption.
+
+## Installation
+
+Shenvy CLI can be installed through several package managers for easy management and updates.
+
+### NPM (Node.js)
+The easiest way for web developers to install Shenvy CLI:
+```bash
+npm install -g @shenvy/cli
+```
+
+### Homebrew (macOS & Linux)
+Add our official tap and install the formula:
+```bash
+brew install Shenvy/tap/shenvy
+```
+
+### Scoop (Windows)
+Add our bucket and install:
+```bash
+scoop bucket add shenvy https://github.com/Shenvy/shenvy-cli-dist.git
+scoop install shenvy
+```
+
+### Direct Binary
+Download the latest binary for your platform from the [GitHub Releases](https://github.com/Shenvy/shenvy-cli-dist/releases) page and add it to your PATH.
+
+### Build from Source
+If you have Go installed, you can build it manually:
+```bash
+go build -o shenvy.exe
+```
+
+## Authentication
+
+### `login`
+Log in via browser (Google, GitHub, or email).
+
+```bash
+shenvy login
+```
+
+### `logout`
+Log out of the current session.
+
+```bash
+shenvy logout
+```
+
+### `user_info`
+Display information about the authenticated user.
+
+```bash
+shenvy user_info
+```
+
+## Project Management
+
+### `init`
+Initialize a shenvy repository in the current directory.
+
+```bash
+shenvy init
+```
+
+### `project list`
+List all projects you have access to.
+
+```bash
+shenvy project list
+```
+
+### `project info [projectId]`
+Display details of a project. If no ID is provided, it uses the current project.
+
+```bash
+shenvy project info
+shenvy project info <projectId>
+```
+
+### `project update [projectId]`
+Update the name or description of a project.
+
+```bash
+shenvy project update --name "New Name" --desc "New description"
+shenvy project update <projectId> --name "New Name"
+```
+
+### `project delete [projectId]`
+Delete a project (soft delete).
+
+```bash
+shenvy project delete
+shenvy project delete <projectId>
+```
+
+### `project restore <projectId>`
+Restore a deleted project.
+
+```bash
+shenvy project restore <projectId>
+```
+
+### `status`
+Display the current project status, tracked files, and pending changes.
+
+```bash
+shenvy status
+```
+
+## Team Management
+
+### `team create <name>`
+Create a new team.
+
+```bash
+shenvy team create "My Team"
+```
+
+### `team info [teamId]`
+Display details of a team. Without an ID, it lists all your teams.
+
+```bash
+shenvy team info
+shenvy team info <teamId>
+```
+
+### `team delete <teamId>`
+Permanently delete a team.
+
+```bash
+shenvy team delete <teamId>
+```
+
+### `team transfer <teamId> <newOwnerId>`
+Transfer team ownership to another user.
+
+```bash
+shenvy team transfer <teamId> <newOwnerId>
+```
+
+## Member Management
+
+### `member invite <teamId> <email> [role]`
+Invite a user to the team. Roles: `MEMBER` (default), `ADMIN`, `READER`.
+
+```bash
+shenvy member invite <teamId> user@example.com
+shenvy member invite <teamId> user@example.com ADMIN
+```
+
+### `member list <teamId>`
+List all members of a team.
+
+```bash
+shenvy member list <teamId>
+```
+
+### `member update <teamId> <userId> <role>`
+Update a member's role.
+
+```bash
+shenvy member update <teamId> <userId> ADMIN
+```
+
+### `member remove <teamId> <userId>`
+Remove a member from the team.
+
+```bash
+shenvy member remove <teamId> <userId>
+```
+
+## Device Management
+
+### `registerdevice`
+Register the current device as a recipient for the project.
+
+```bash
+shenvy registerdevice
+```
+
+### `unregisterdevice`
+Unregister the current device and remove the local identity.
+
+```bash
+shenvy unregisterdevice
+```
+
+### `device list`
+List all devices registered in the current project.
+
+```bash
+shenvy device list
+```
+
+### `reset`
+Reset the device identity.
+
+```bash
+shenvy reset
+```
+
+## Environment Variable Management
+
+### `add <filename>`
+Add a file to track.
+
+```bash
+shenvy add .env
+shenvy add .env.production
+```
+
+### `push`
+Encrypt and upload all tracked files.
+
+```bash
+shenvy push
+```
+
+### `pull`
+Download, decrypt, and restore all tracked files.
+
+```bash
+shenvy pull
+```
+
+### `run`
+Execute a command with the environment variables loaded.
+
+```bash
+# Load variables from the default environment
+shenvy run -- npm start
+
+# Load variables from a specific environment
+shenvy run -e development -- npm start
+```
+
+### `plan`
+Display information about the current subscription plan and its limits.
+
+```bash
+shenvy plan
+```
+
+### `timeline`
+Display the project's change history.
+
+```bash
+shenvy timeline
+```
+
+### `env delete <envName>`
+Delete a variable file (soft delete).
+
+```bash
+shenvy env delete .env.production
+```
+
+### `env restore <envId>`
+Restore a deleted variable file.
+
+```bash
+shenvy env restore <envId>
+```
+
+### `env versions <envName>`
+List all versions of a variable file.
+
+```bash
+shenvy env versions .env.production
+```
+
+### `env rollback <envName> <version>`
+Roll back a file to a specific version.
+
+```bash
+shenvy env rollback .env.production 3
+```
+
+## Autocomplete
+
+Generate autocomplete scripts for your shell:
+
+### PowerShell
+```powershell
+shenvy completion powershell | Out-String | Invoke-Expression
+```
+
+To make it permanent, add it to your `$PROFILE`:
+```powershell
+shenvy completion powershell | Out-String | Invoke-Expression
+```
+
+### Bash
+```bash
+shenvy completion bash > /etc/bash_completion.d/shenvy
+```
+
+### Zsh
+```bash
+shenvy completion zsh > "${fpath[1]}/_shenvy"
+```
+
+## Typical Workflow
+
+1. **Initialize project**:
+   ```bash
+   shenvy login
+   shenvy init
+   ```
+
+2. **Add environment files**:
+   ```bash
+   shenvy add .env
+   shenvy add .env.production
+   ```
+
+3. **Register device**:
+   ```bash
+   shenvy registerdevice
+   ```
+
+4. **Encrypt and upload**:
+   ```bash
+   shenvy push
+   ```
+
+5. **Download on another device**:
+   ```bash
+   shenvy login
+   cd <project>
+   shenvy registerdevice
+   # An admin must run 'shenvy push' to include the new device
+   shenvy pull
+   ```
+
+## Security Notes
+
+- **Zero Knowledge**: The server never knows your secrets.
+- **End-to-End Encryption**: Uses Age (X25519) + ChaCha20-Poly1305.
+- **Devices**: Each device has its own key. An admin must re-encrypt to include new devices.
+- **Soft Deletes**: Projects and variable files are soft-deleted and can be restored.

package/bin/install.js

@@ -41,10 +41,17 @@ function download(url, dest) {
     const file = fs.createWriteStream(dest);
     https.get(url, (response) => {
       if (response.statusCode === 302 || response.statusCode === 301) {
-        return download(response.headers.location, dest).then(resolve).catch(reject);
+        // Close the write stream BEFORE recursing — on Windows, open handles
+        // block PowerShell's Expand-Archive even after file.close() is called.
+        file.close(() => {
+          download(response.headers.location, dest).then(resolve).catch(reject);
+        });
+        return;
       }
       if (response.statusCode !== 200) {
-        reject(new Error(`Failed to download: ${response.statusCode}`));
+        file.close(() => {
+          reject(new Error(`Failed to download: ${response.statusCode}`));
+        });
         return;
       }
       response.pipe(file);
@@ -52,8 +59,10 @@ function download(url, dest) {
         file.close(() => resolve());
       });
     }).on('error', (err) => {
-      fs.unlink(dest, () => {});
-      reject(err);
+      file.close(() => {
+        fs.unlink(dest, () => {});
+        reject(err);
+      });
     });
   });
 }
@@ -63,8 +72,8 @@ const wait = (ms) => new Promise(r => setTimeout(r, ms));
 async function ensureFileReady(filePath) {
   for (let i = 0; i < 10; i++) {
     try {
-      // Try to open file for appending to check if it's locked
-      const fd = fs.openSync(filePath, 'r+');
+      // Open read-only to check if the OS has fully released the file handle
+      const fd = fs.openSync(filePath, 'r');
       fs.closeSync(fd);
       return true;
     } catch (e) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shenvy/cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Securely manage environment variables with E2EE (Go implementation wrapper)",
   "main": "bin/install.js",
   "bin": {

package/scoop/shenvy.json

@@ -1,19 +1,19 @@
 {
-    "version": "0.1.7",
+    "version": "0.1.8",
     "architecture": {
         "64bit": {
-            "url": "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.7/shenvy_windows_amd64.zip",
+            "url": "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.8/shenvy_windows_amd64.zip",
             "bin": [
                 "shenvy.exe"
             ],
-            "hash": "22304a00ee345b6d5a9a3971cc308cadd1530cb3859f2f2ab8a23a9539c50f1a"
+            "hash": "7b2ff88ba99e087343a9fc171057a4b11cbbb7bddfa9fdaf62558c1948957db3"
         },
         "arm64": {
-            "url": "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.7/shenvy_windows_arm64.zip",
+            "url": "https://github.com/Shenvy/shenvy-cli-dist/releases/download/v0.1.8/shenvy_windows_arm64.zip",
             "bin": [
                 "shenvy.exe"
             ],
-            "hash": "0e1daa2744d72e2ed8aaaae758a4501a2ae05cb72b14591a06a4d7803566fd68"
+            "hash": "9f829c5c8d8b7f1e42d1c7a71d21f465ab14da954ad4fa19e44ac0ebfd873944"
         }
     },
     "homepage": "https://shenvy.dev",