feat: add CLI bundling scripts and CI release workflow

Author: JhaSourav07

.github/workflows/release.yml

@@ -0,0 +1,70 @@
+name: Automated Release Pipeline
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  release:
+    name: Build & Release Standalone Binaries
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+
+    steps:
+      - name: Checkout Repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v4
+        with:
+          version: 9.15.4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: 22.x
+          cache: 'pnpm'
+
+      - name: Install Monorepo Dependencies
+        run: pnpm install --frozen-lockfile
+
+      - name: Build Workspace Packages
+        run: pnpm run build
+
+      - name: Package Standalone CLI Executables
+        run: pnpm --filter @collagility/cli package
+
+      - name: Create GitHub Release & Upload Assets
+        uses: softprops/action-gh-release@v2
+        with:
+          name: Collagility ${{ github.ref_name }}
+          draft: false
+          prerelease: ${{ contains(github.ref_name, 'alpha') || contains(github.ref_name, 'beta') || contains(github.ref_name, 'rc') }}
+          files: |
+            apps/cli/dist/releases/collagility-linux-x64.tar.gz
+            apps/cli/dist/releases/collagility-linux-arm64.tar.gz
+            apps/cli/dist/releases/collagility-macos-x64.tar.gz
+            apps/cli/dist/releases/collagility-macos-arm64.tar.gz
+            apps/cli/dist/releases/collagility-windows-x64.zip
+          body: |
+            # Collagility ${{ github.ref_name }}
+
+            🚀 **Single-Command Installation**
+
+            ```bash
+            curl -fsSL https://raw.githubusercontent.com/JhaSourav07/Collagility/main/install.sh | bash
+            ```
+
+            ## Release Assets
+            - **Linux (x64)**: `collagility-linux-x64.tar.gz`
+            - **Linux (arm64)**: `collagility-linux-arm64.tar.gz`
+            - **macOS (Intel x64)**: `collagility-macos-x64.tar.gz`
+            - **macOS (Apple Silicon arm64)**: `collagility-macos-arm64.tar.gz`
+            - **Windows (x64)**: `collagility-windows-x64.zip`
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -6,6 +6,7 @@ node_modules/
 dist/
 build/
 out/
+.next/
 *.tsbuildinfo
 .turbo/
 

README.md

@@ -38,18 +38,47 @@ Prompt: "create index.ts"                           ─────────
 
 ## 📦 Installation
 
-Prerequisites: Node.js `>= 22.0.0`, `pnpm` >= 9.0.0, and Antigravity CLI (`agy`) or Gemini CLI.
+### Single-Command Quick Install (Zero Dependencies Required)
+
+No Node.js, pnpm, or repository cloning is required. Run the automated installer in your terminal:
 
 ```bash
-# 1. Clone repository
-git clone https://github.com/JhaSourav07/Collagility.git
-cd Collagility
+curl -fsSL https://raw.githubusercontent.com/JhaSourav07/Collagility/main/install.sh | bash
+```
+
+The installer detects your OS and architecture, downloads the latest standalone release binary, and installs it into `~/.local/bin/collagility`.
+
+---
+
+### 💻 Supported Platforms
+
+| Platform | Architecture | Binary Archive |
+| -------- | ------------ | -------------- |
+| Linux | x64 (AMD64) | `collagility-linux-x64.tar.gz` |
+| Linux | arm64 (AArch64) | `collagility-linux-arm64.tar.gz` |
+| macOS | Intel (x64) | `collagility-macos-x64.tar.gz` |
+| macOS | Apple Silicon (M1/M2/M3) | `collagility-macos-arm64.tar.gz` |
+| Windows | x64 | `collagility-windows-x64.zip` |
+
+---
 
-# 2. Install dependencies & build monorepo packages (single command at root)
-pnpm install
-pnpm run build
+### 🔄 Updating Collagility
 
-# 3. Link CLI globally (runs right from root)
+To update Collagility to the latest version at any time, re-run the installation command:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/JhaSourav07/Collagility/main/install.sh | bash
+```
+
+---
+
+### 🛠️ Installing from Source (Contributors)
+
+```bash
+# Clone repository & build monorepo packages
+git clone https://github.com/JhaSourav07/Collagility.git
+cd Collagility
+pnpm install && pnpm run build
 sudo npm link
 ```
 

apps/cli/package.json

@@ -10,6 +10,8 @@
   "main": "./dist/index.js",
   "scripts": {
     "build": "tsc --build",
+    "bundle": "node ./scripts/bundle.js",
+    "package": "node ./scripts/bundle.js && node ./scripts/package.js",
     "dev": "tsc --build --watch",
     "start": "node ./dist/index.js",
     "lint": "eslint src/**/*.ts",
@@ -31,6 +33,8 @@
   "devDependencies": {
     "@types/node": "^22.10.2",
     "@types/ws": "^8.5.13",
+    "@yao-pkg/pkg": "^5.15.1",
+    "esbuild": "^0.24.2",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8"
   }

apps/cli/scripts/bundle.js

@@ -0,0 +1,33 @@
+import * as esbuild from 'esbuild';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const projectRoot = path.resolve(__dirname, '..');
+
+console.log('📦 Bundling @collagility/cli with esbuild...');
+
+try {
+  await esbuild.build({
+    entryPoints: [path.join(projectRoot, 'src', 'index.ts')],
+    bundle: true,
+    platform: 'node',
+    target: 'node20',
+    format: 'cjs',
+    outfile: path.join(projectRoot, 'dist', 'bundle.cjs'),
+    sourcemap: false,
+    minify: false,
+    loader: {
+      '.ts': 'ts',
+    },
+    define: {
+      'process.env.NODE_ENV': '"production"',
+    },
+  });
+
+  console.log('✓ ESBuild bundle generated: apps/cli/dist/bundle.cjs');
+} catch (err) {
+  console.error('✖ Bundle failed:', err);
+  process.exit(1);
+}

apps/cli/scripts/package.js

@@ -0,0 +1,83 @@
+import { execSync } from 'node:child_process';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const projectRoot = path.resolve(__dirname, '..');
+const bundlePath = path.join(projectRoot, 'dist', 'bundle.cjs');
+const binariesDir = path.join(projectRoot, 'dist', 'binaries');
+const releasesDir = path.join(projectRoot, 'dist', 'releases');
+
+if (!fs.existsSync(bundlePath)) {
+  console.error('✖ Bundle dist/bundle.cjs missing. Please run `pnpm run bundle` first.');
+  process.exit(1);
+}
+
+fs.mkdirSync(binariesDir, { recursive: true });
+fs.mkdirSync(releasesDir, { recursive: true });
+
+const targets = [
+  { target: 'node20-linux-x64', name: 'collagility-linux-x64', archive: 'collagility-linux-x64.tar.gz' },
+  { target: 'node20-linux-arm64', name: 'collagility-linux-arm64', archive: 'collagility-linux-arm64.tar.gz' },
+  { target: 'node20-macos-x64', name: 'collagility-macos-x64', archive: 'collagility-macos-x64.tar.gz' },
+  { target: 'node20-macos-arm64', name: 'collagility-macos-arm64', archive: 'collagility-macos-arm64.tar.gz' },
+  { target: 'node20-win-x64', name: 'collagility-windows-x64.exe', archive: 'collagility-windows-x64.zip' },
+];
+
+console.log('⚡ Packaging standalone binaries with pkg...');
+
+for (const t of targets) {
+  const outputPath = path.join(binariesDir, t.name);
+  console.log(`Building binary for target: ${t.target} -> ${t.name}`);
+
+  try {
+    execSync(`npx @yao-pkg/pkg --target ${t.target} --output "${outputPath}" "${bundlePath}"`, {
+      stdio: 'inherit',
+      cwd: projectRoot,
+    });
+    console.log(`✓ Generated ${t.name}`);
+  } catch (err) {
+    console.error(`✖ Failed to build binary for ${t.target}:`, err);
+  }
+}
+
+console.log('📦 Creating release archives (.tar.gz / .zip)...');
+
+for (const t of targets) {
+  const binaryPath = path.join(binariesDir, t.name);
+  const archivePath = path.join(releasesDir, t.archive);
+
+  if (!fs.existsSync(binaryPath)) {
+    console.warn(`⚠️ Warning: Binary ${binaryPath} not found. Skipping archive creation.`);
+    continue;
+  }
+
+  try {
+    if (t.archive.endsWith('.tar.gz')) {
+      const binaryFileName = t.name;
+      // Package binary named "collagility" inside tarball so extraction produces "collagility" executable
+      const tempDir = path.join(binariesDir, `temp-${t.name}`);
+      fs.mkdirSync(tempDir, { recursive: true });
+      fs.copyFileSync(binaryPath, path.join(tempDir, 'collagility'));
+      execSync(`chmod +x "${path.join(tempDir, 'collagility')}"`);
+
+      execSync(`tar -czf "${archivePath}" -C "${tempDir}" collagility`, { stdio: 'inherit' });
+      fs.rmSync(tempDir, { recursive: true, force: true });
+      console.log(`✓ Created release archive: dist/releases/${t.archive}`);
+    } else if (t.archive.endsWith('.zip')) {
+      const tempDir = path.join(binariesDir, `temp-${t.name}`);
+      fs.mkdirSync(tempDir, { recursive: true });
+      fs.copyFileSync(binaryPath, path.join(tempDir, 'collagility.exe'));
+
+      execSync(`zip -j "${archivePath}" "${path.join(tempDir, 'collagility.exe')}"`, { stdio: 'inherit' });
+      fs.rmSync(tempDir, { recursive: true, force: true });
+      console.log(`✓ Created release archive: dist/releases/${t.archive}`);
+    }
+  } catch (err) {
+    console.error(`✖ Failed to create archive ${t.archive}:`, err);
+  }
+}
+
+console.log('🎉 Packaging complete! All binaries and release archives ready in apps/cli/dist/releases/');