fix(ci): fix GitHub Packages (GPR) publish registry setup, fallback error handling, and update READMEs with GPR install options

Author: navaranjithsai

.github/workflows/release.yml

@@ -164,18 +164,32 @@ jobs:
           git tag ${{ needs.version.outputs.tag }}
           git push origin HEAD:main ${{ needs.version.outputs.tag }}
 
-      - uses: actions/setup-node@v4
+      - name: Setup npm registry
+        uses: actions/setup-node@v4
         with:
           node-version: '22'
           registry-url: 'https://registry.npmjs.org'
           cache: npm
           cache-dependency-path: cloudsync-cli/package-lock.json
-      - run: npm ci
-      - run: npm publish --access public
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Publish to npm
+        continue-on-error: true
+        run: npm publish --access public
         env:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
 
-      - name: Publish to GPR
+      - name: Setup GitHub Package Registry
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          registry-url: 'https://npm.pkg.github.com'
+          scope: '@tech4file'
+
+      - name: Publish to GPR (GitHub Packages)
+        continue-on-error: true
         run: |
           npm pkg set name="@tech4file/cloudsync-cli"
           npm publish --access public
@@ -188,7 +202,8 @@ jobs:
           find . -type f ! -name '*.zip' ! -name '*.bat' ! -name '*.iss' ! -name '*.md' ! -name 'LICENSE' \
             -exec sha256sum {} \; > checksums.txt
 
-      - uses: softprops/action-gh-release@v1
+      - name: GitHub Release
+        uses: softprops/action-gh-release@v2
         with:
           tag_name: ${{ needs.version.outputs.tag }}
           name: ${{ needs.version.outputs.version }}

README.md

@@ -2,68 +2,93 @@
 
 <div align="center">
 
-[![GitHub license](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](LICENSE)
-[![npm version](https://img.shields.io/npm/v/cloudsync-cli.svg?style=for-the-badge)](https://www.npmjs.com/package/cloudsync-cli)
-[![GitHub Actions CI](https://img.shields.io/github/actions/workflow/status/Tech4File/cloudsync-cli/ci.yml?style=for-the-badge&branch=main)](https://github.com/Tech4File/cloudsync-cli/actions)
+[![npm version](https://img.shields.io/npm/v/cloudsync-cli.svg?style=for-the-badge&color=cb3837)](https://www.npmjs.com/package/cloudsync-cli)
+[![GitHub Packages](https://img.shields.io/badge/GitHub%20Packages-@tech4file/cloudsync--cli-blue?style=for-the-badge&logo=github)](https://github.com/Tech4File/cloudsync-cli/packages)
+[![GitHub release](https://img.shields.io/github/v/release/Tech4File/cloudsync-cli?style=for-the-badge&color=2da44e)](https://github.com/Tech4File/cloudsync-cli/releases)
+[![License](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](LICENSE)
+[![Node.js Version](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen?style=for-the-badge)](https://nodejs.org/)
+[![GitHub Actions CI](https://img.shields.io/github/actions/workflow/status/Tech4File/cloudsync-cli/ci.yml?style=for-the-badge&branch=main&label=CI)](https://github.com/Tech4File/cloudsync-cli/actions)
 
-**Secure, Git-like version control CLI for synchronizing files between local and remote environments over encrypted SSH tunnels.**
+**An open-source, Git-like version control CLI for secure cloud-to-local synchronization via encrypted SSH tunnels.**
+
+*"Your configs, your cloud, your rules — no public repos required."*
 
 </div>
 
 ---
 
-## What is CloudSync-CLI?
-
-CloudSync-CLI is a cross-platform command-line tool that brings Git-like version control (stage, commit, history, diff, rollback) to configuration files and sensitive data — syncing them directly between machines over encrypted tunnels without ever touching a public repository.
+## 🚀 Quick Installation
 
-**10 transport protocols.** **Git-like VCS.** **Zero public exposure.**
-
----
+### Option 1: Install via npm (Global CLI)
+```bash
+npm install -g cloudsync-cli
+```
 
-## Repository Structure
+### Option 2: Install via GitHub Packages (GPR)
+```bash
+npm install -g @tech4file/cloudsync-cli --registry=https://npm.pkg.github.com
+```
 
-| Path | Description |
-|---|---|
-| `cloudsync-cli/` | The npm package — CLI source, commands, transport engine, VCS |
-| `.github/workflows/ci.yml` | CI pipeline — tests on Ubuntu (18/20/22) + Windows + macOS |
-| `.github/workflows/release.yml` | Auto-release on tag push — builds Win/Mac/Linux binaries + npm + GPR |
+### Option 3: Download Standalone Binaries (Windows / Linux / macOS)
+Download single-executable binaries directly from the latest [GitHub Releases](https://github.com/Tech4File/cloudsync-cli/releases):
+- 🪟 `cloudsync.exe` / `cloudsync-windows-x64.zip` (Windows)
+- 🐧 `cloudsync` (Linux x64)
+- 🍏 `cloudsync` (macOS x64 / ARM64)
 
 ---
 
-## Quick Start
+## 📋 Quick Start
 
 ```bash
-npm install -g cloudsync-cli
-cloudsync init --host your-server.com --user username
+# 1. Initialize configuration
+cloudsync init --host your-server.com --user username --port 22
+
+# 2. Stage files for version control
 cloudsync stage .env config.json
-cloudsync commit "Update config"
-cloudsync upload --include .env --exclude node_modules
-cloudsync --help
+
+# 3. Commit staged changes locally
+cloudsync commit "Update database config"
+
+# 4. Securely upload to remote target
+cloudsync upload --profile default
+
+# 5. Check operational health & network connectivity
+cloudsync doctor
 ```
 
-Full docs: [cloudsync-cli/README.md](cloudsync-cli/README.md)
+Full documentation & CLI command reference: [cloudsync-cli/README.md](cloudsync-cli/README.md)
 
 ---
 
-## Automated CI/CD
+## 📁 Repository Structure
 
-| Trigger | What Happens |
+| Path | Description |
 |---|---|
-| Push to `main` / PR | `ci.yml` — tests Ubuntu (18/20/22) + Windows + macOS + security |
-| Push version tag `v1.0.6` | `release.yml` — tests → builds EXEs → npm publish → GPR publish → GitHub Release |
+| [`cloudsync-cli/`](cloudsync-cli/) | The npm package directory containing CLI source, commands, transport engine, and VCS modules. |
+| [`.github/workflows/ci.yml`](.github/workflows/ci.yml) | Continuous Integration matrix testing Node 18, 20, 22 on Ubuntu, Windows, and macOS. |
+| [`.github/workflows/release.yml`](.github/workflows/release.yml) | Automated build & publication pipeline — produces standalone binaries, releases to npmjs, publishes to GitHub Packages (GPR), and creates GitHub Releases. |
+
+---
 
-**No `npm publish` locally. Everything automated.**
+## ⚙️ Automated CI/CD Pipeline
+
+| Pipeline | Trigger | Automated Operations |
+|---|---|---|
+| **CI Matrix** (`ci.yml`) | Push / PR to `main` | Runs multi-OS test matrix across Node.js 18, 20, and 22. |
+| **Release Pipeline** (`release.yml`) | Push to `main` | Runs test suite $\rightarrow$ builds bundles $\rightarrow$ compiles standalone EXEs/binaries $\rightarrow$ publishes to npmjs $\rightarrow$ publishes to GPR $\rightarrow$ generates GitHub Release with SHA-256 checksums. |
 
 ---
 
-## Development
+## 🛡️ Security & Hardening Highlights
 
-```bash
-git clone https://github.com/Tech4File/cloudsync-cli.git
-cd cloudsync-cli/cloudsync-cli
-npm install && npm test
-```
+- **Zero-Dependency Security Core**: Hardened with prototype pollution protection (`safeJsonParse`), path traversal filtering (`safePath`), and SSRF-safe hostname validation.
+- **Encrypted SSH Channels**: Native `ssh2` transport layer supporting keypair auth, custom ports, and SCP/SFTP/RSYNC protocols.
+- **HTTP Share Server Security**: Built-in HTTP sharing with rate limiting (60 req/min), CORS restriction, and security headers (`CSP`, `X-Frame-Options: DENY`, `X-Content-Type-Options: nosniff`).
+
+---
+
+## 📄 License
 
-## License
+Distributed under the **MIT License**. See [LICENSE](LICENSE) for details.
 
-MIT — [LICENSE](LICENSE) | [Security policy](cloudsync-cli/SECURITY.md) | [Contributing](cloudsync-cli/CONTRIBUTING.md)
+Security Policy: [SECURITY.md](cloudsync-cli/SECURITY.md) | Contributing Guidelines: [CONTRIBUTING.md](cloudsync-cli/CONTRIBUTING.md)

cloudsync-cli/README.md

@@ -82,17 +82,21 @@ CloudSync-CLI brings **Git-like version control** to sensitive configuration fil
 
 ---
 
-## 📥 Installation
-
-### Via npm (Global)
+### Via npm (Global - npmjs.org)
 
 ```bash
 npm install -g cloudsync-cli
 ```
 
-### Via Windows Installer
+### Via GitHub Packages (GPR)
+
+```bash
+npm install -g @tech4file/cloudsync-cli --registry=https://npm.pkg.github.com
+```
+
+### Standalone Executable Binaries (Windows / Linux / macOS)
 
-Download `CloudSync-Setup.exe` from our [releases page](https://github.com/Tech4File/cloudsync-cli/releases) and run the installer.
+Download pre-compiled single-executable binaries (`cloudsync.exe`, `cloudsync` Linux/macOS) directly from the [GitHub Releases Page](https://github.com/Tech4File/cloudsync-cli/releases).
 
 ### Verify Installation