git-push-deploy-cli 0.1.1 → 0.2.0

package/README.md

@@ -4,10 +4,10 @@ Git Push Deploy - A CLI for git-based deployments with PM2 support. Push to depl
 
 ## Features
 
-- **Git-based deployment**: Push to bare repo, SSH triggers install
-- **PM2 integration**: Automatic process restarts
-- **Monorepo support**: Stage multiple packages for deployment
-- **SSH orchestration**: Everything runs from your dev machine
+- **Git-based deployment**: Push to bare repo, server hook handles install
+- **PM2 integration**: Automatic process restarts with user isolation
+- **Lazy initialization**: Deploy repo created on first `gpd stage`
+- **SSH orchestration**: Server setup from your dev machine
 - **Config-driven**: Define services in `.git-deploy.json`
 
 ## Installation
@@ -23,17 +23,25 @@ npm install -g git-push-deploy-cli
 ```json
 {
   "services": {
-    "my-api": {
-      "packages": ["my-api"],
-      "mainPackage": "my-api",
-      "deployRepo": "../deploy-my-api",
-      "processName": "my-api",
+    "my-api-staging": {
+      "sourceDir": "my-api",
+      "deployRepo": "deploy/staging",
+      "artifacts": ["dist/index.js", "package.json", "ecosystem.config.cjs"],
+      "processManager": "pm2",
+      "processName": "my-api-staging",
       "pm2Home": "/opt/myapp/.pm2",
-      "artifacts": ["dist", "package.json", "package-lock.json", "ecosystem.config.cjs"],
+      "pm2User": "myapp",
+      "environment": "staging",
+      "env": {
+        "PORT": 5000,
+        "NODE_ENV": "staging"
+      },
       "server": {
         "host": "user@myserver",
-        "targetDir": "/opt/myapp/my-api",
-        "bareRepo": "/git/deploy-my-api"
+        "sshOptions": "-p 22",
+        "targetDir": "/opt/myapp/staging/my-api",
+        "bareRepo": "/git/deploy-myapp/staging/my-api",
+        "group": "deploy-myapp"
       }
     }
   }
@@ -43,23 +51,25 @@ npm install -g git-push-deploy-cli
 ### 2. Initialize server (once per service)
 
 ```bash
-gpd init my-api
+gpd init my-api-staging
 ```
 
 This creates via SSH:
-- Bare git repository at `/git/deploy-my-api`
-- Clone at `/opt/myapp/my-api`
+- Bare git repository at `/git/deploy-myapp/staging/my-api`
+- Target directory at `/opt/myapp/staging/my-api`
+- Post-receive hook that calls `gpd install`
 
 ### 3. Deploy
 
 ```bash
-gpd deploy my-api
+gpd deploy my-api-staging
 ```
 
 This:
-1. Copies build artifacts to local deploy repo
-2. Commits and pushes to bare repo on server
-3. SSH: `git pull && npm install && pm2 restart`
+1. Creates deploy repo (if needed) at `my-api/deploy/staging/`
+2. Copies build artifacts to deploy repo
+3. Commits and pushes to bare repo on server
+4. Server hook: `git checkout && npm install && pm2 restart`
 
 ## Commands
 
@@ -68,15 +78,16 @@ This:
 | `gpd status` | Show all configured services |
 | `gpd stage <service>` | Copy build artifacts to deploy repo |
 | `gpd release <service>` | Commit and push deploy repo |
-| `gpd deploy <service>` | Stage + release + SSH install |
-| `gpd init <service>` | Initialize bare repo and clone on server |
+| `gpd deploy <service>` | Stage + release (hook handles install) |
+| `gpd init <service>` | Initialize server (bare repo, target dir, hook) |
+| `gpd install <service>` | Server-side install (called by hook) |
 | `gpd logs <service>` | Show PM2 logs from server via SSH |
 
 ## Options
 
 ```bash
 gpd deploy my-api -m "custom commit message"
-gpd deploy my-api --skip-remote    # Only stage and release, no SSH
+gpd deploy my-api --skip-push      # Only stage, do not push
 gpd logs my-api -f                 # Follow logs
 gpd logs my-api -n 100             # Show last 100 lines
 ```
@@ -85,48 +96,71 @@ gpd logs my-api -n 100             # Show last 100 lines
 
 ```typescript
 interface ServiceConfig {
-  packages: string[];        // Packages to deploy (monorepo)
-  mainPackage: string;       // Package with ecosystem.config.cjs
-  deployRepo: string;        // Local deploy repo path
+  sourceDir: string;         // Project directory (e.g., "my-api")
+  deployRepo: string;        // Deploy repo path, relative to sourceDir
+  artifacts: string[];       // Files/dirs to copy
+  processManager: 'pm2';     // Process manager type
   processName: string;       // PM2 process name
   pm2Home?: string;          // PM2_HOME on server
-  artifacts?: string[];      // Files to copy (default: dist, package.json, etc.)
+  pm2User?: string;          // User to run PM2 as (sudo -u)
+  environment?: string;      // staging | production
+  env?: Record<string, any>; // Environment variables for .env file
   server: {
     host: string;            // SSH host (user@hostname)
-    targetDir: string;       // Clone directory on server
+    sshOptions?: string;     // SSH options (e.g., "-p 6771 -4")
+    targetDir: string;       // Target directory on server
     bareRepo: string;        // Bare repo path on server
+    group?: string;          // Unix group for permissions
   };
 }
 ```
 
+## Architecture
+
+```
+Workspace                              Server
+─────────                              ──────
+my-api/
+├── src/                               /git/deploy-myapp/staging/my-api/
+├── dist/                                └── hooks/post-receive
+└── deploy/                                   ↓
+    └── staging/                       /opt/myapp/staging/my-api/
+        ├── .git → ssh://...           ├── dist/index.js
+        ├── dist/                      ├── package.json
+        └── package.json               ├── node_modules/
+                                       └── .env (generated)
+```
+
 ## Workflow
 
 ```
 Dev Machine                           Server
 ───────────                           ──────
-gpd deploy my-api
+gpd deploy my-api-staging
   │
   ├─ gpd stage
-  │    └─ Copy artifacts → ../deploy-my-api/
-  │
-  ├─ gpd release  
-  │    └─ git push ──────────────────→ /git/deploy-my-api (bare)
+  │    └─ Copy artifacts → my-api/deploy/staging/
   │
-  └─ SSH ────────────────────────────→ cd /opt/myapp/my-api
-                                       git pull
-                                       npm install --omit=dev
-                                       pm2 restart my-api
+  └─ gpd release  
+       └─ git push ───────────────→ /git/deploy-myapp/staging/my-api
+                                          │
+                                          └─ post-receive hook:
+                                               gpd install my-api-staging
+                                                 │
+                                                 ├─ git checkout -f
+                                                 ├─ .env generation
+                                                 ├─ npm install --omit=dev
+                                                 └─ pm2 restart
 ```
 
 ## Server Prerequisites
 
 - Node.js + npm
 - PM2 (`npm install -g pm2`)
+- gpd CLI (`npm install -g git-push-deploy-cli`)
 - SSH access from dev machine
 - Git
 
-No gpd installation needed on the server!
-
 ## License
 
 MIT

package/dist/commands/deploy.d.ts

@@ -1,9 +1,16 @@
 interface DeployOptions {
     message?: string;
-    skipRemote?: boolean;
+    skipPush?: boolean;
 }
 /**
- * Deploy command - stage, release, and trigger remote install
+ * Deploy command - stage artifacts and push to server
+ *
+ * New architecture:
+ * 1. Stage: Copy build artifacts to deploy repo (with lazy init)
+ * 2. Release: Commit and push to bare repo on server
+ * 3. Server hook handles: git checkout, npm install, pm2 restart
+ *
+ * No more SSH install from client - the post-receive hook does everything!
  */
 export declare function deployCommand(serviceName: string, options?: DeployOptions): Promise<void>;
 export {};

package/dist/commands/deploy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAMA,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BnG"}
+{"version":3,"file":"deploy.d.ts","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAKA,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBnG"}

package/dist/commands/deploy.js

@@ -2,31 +2,36 @@ import chalk from 'chalk';
 import { stageCommand } from './stage.js';
 import { releaseCommand } from './release.js';
 import { getServiceConfig } from '../config/loader.js';
-import { sshExec } from '../utils/shell.js';
 /**
- * Deploy command - stage, release, and trigger remote install
+ * Deploy command - stage artifacts and push to server
+ *
+ * New architecture:
+ * 1. Stage: Copy build artifacts to deploy repo (with lazy init)
+ * 2. Release: Commit and push to bare repo on server
+ * 3. Server hook handles: git checkout, npm install, pm2 restart
+ *
+ * No more SSH install from client - the post-receive hook does everything!
  */
 export async function deployCommand(serviceName, options = {}) {
-    // 1. Stage artifacts
+    const config = getServiceConfig(serviceName);
+    console.log(chalk.blue.bold(`Deploying ${serviceName}...`));
+    console.log(chalk.gray(`  Environment: ${config.environment || 'production'}`));
+    console.log(chalk.gray(`  Server: ${config.server.host}`));
+    console.log('');
+    // 1. Stage artifacts to deploy repo
     await stageCommand(serviceName);
-    // 2. Commit and push
-    await releaseCommand(serviceName, options);
-    // 3. Trigger remote install via SSH
-    if (!options.skipRemote) {
-        const config = getServiceConfig(serviceName);
-        const { host, targetDir } = config.server;
-        const { mainPackage, processName, pm2Home } = config;
-        console.log(chalk.blue(`Installing on ${host}...`));
-        const pm2Env = pm2Home ? `PM2_HOME=${pm2Home} ` : '';
-        const remoteCmd = [
-            `cd ${targetDir}`,
-            'git pull --ff-only',
-            `cd ${mainPackage}`,
-            'npm install --omit=dev',
-            `${pm2Env}pm2 restart ecosystem.config.cjs`
-        ].join(' && ');
-        sshExec(host, remoteCmd);
-        console.log(chalk.green(`✓ Deployed ${serviceName} to ${host}`));
+    console.log('');
+    // 2. Commit and push (triggers server-side hook)
+    if (!options.skipPush) {
+        await releaseCommand(serviceName, options);
+        console.log('');
+        console.log(chalk.green.bold(`✓ Deployed ${serviceName}`));
+        console.log(chalk.gray('  The server hook will handle: git checkout, npm install, pm2 restart'));
+        console.log(chalk.gray(`  Check logs: gpd logs ${serviceName}`));
+    }
+    else {
+        console.log(chalk.yellow('Skipped push (--skip-push). Run manually:'));
+        console.log(chalk.white(`  gpd release ${serviceName}`));
     }
 }
 //# sourceMappingURL=deploy.js.map

package/dist/commands/deploy.js.map

@@ -1 +1 @@
-{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAO5C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,UAAyB,EAAE;IAClF,qBAAqB;IACrB,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IAEhC,qBAAqB;IACrB,MAAM,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IAE3C,oCAAoC;IACpC,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;QAC7C,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;QAC1C,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC;QAErD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,IAAI,KAAK,CAAC,CAAC,CAAC;QAEpD,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG;YAChB,MAAM,SAAS,EAAE;YACjB,oBAAoB;YACpB,MAAM,WAAW,EAAE;YACnB,wBAAwB;YACxB,GAAG,MAAM,kCAAkC;SAC5C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAEf,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAEzB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc,WAAW,OAAO,IAAI,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;AACH,CAAC"}
+{"version":3,"file":"deploy.js","sourceRoot":"","sources":["../../src/commands/deploy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAOvD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,WAAmB,EAAE,UAAyB,EAAE;IAClF,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAE7C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,WAAW,KAAK,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,kBAAkB,MAAM,CAAC,WAAW,IAAI,YAAY,EAAE,CAAC,CAAC,CAAC;IAChF,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3D,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,oCAAoC;IACpC,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IAChC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAEhB,iDAAiD;IACjD,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtB,MAAM,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,cAAc,WAAW,EAAE,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC,CAAC;QACjG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,0BAA0B,WAAW,EAAE,CAAC,CAAC,CAAC;IACnE,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,2CAA2C,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC,CAAC;IAC3D,CAAC;AACH,CAAC"}

package/dist/commands/init.d.ts

@@ -1,11 +1,12 @@
 interface InitOptions {
 }
 /**
- * Init command - initialize bare repo and clone on remote server via SSH
+ * Init command - initialize bare repo and target directory on remote server via SSH
  *
  * Creates:
- * 1. Bare repo at server.bareRepo (e.g., /git/sym/deploy-kairox-api)
- * 2. Clone at server.targetDir (e.g., /opt/kairox/kairox-api)
+ * 1. Bare repo at server.bareRepo (e.g., /git/sym/deploy-kairox/staging/kairox-api)
+ * 2. Target directory at server.targetDir (e.g., /opt/kairox/staging/kairox-api)
+ * 3. Post-receive hook that calls `gpd install <service>`
  */
 export declare function initCommand(serviceName: string, _options?: InitOptions): Promise<void>;
 export {};

package/dist/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,UAAU,WAAW;CAEpB;AAED;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA0BhG"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAIA,UAAU,WAAW;CAEpB;AA8DD;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,GAAE,WAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6EhG"}

package/dist/commands/init.js

@@ -2,29 +2,132 @@ import chalk from 'chalk';
 import { getServiceConfig } from '../config/loader.js';
 import { sshExec } from '../utils/shell.js';
 /**
- * Init command - initialize bare repo and clone on remote server via SSH
+ * Generate post-receive hook content
+ * The hook simply calls `gpd install <service>` which handles all the logic
+ */
+function generatePostReceiveHook(serviceName, config) {
+    const { targetDir, bareRepo, pm2User, pm2Home } = config;
+    // Build the install command with sudo if pm2User is specified
+    let installCmd = 'gpd install ' + serviceName;
+    if (pm2User) {
+        // Run gpd as the pm2User
+        installCmd = `sudo -u ${pm2User} ${installCmd}`;
+    }
+    return `#!/bin/bash
+set -e
+
+# GPD post-receive hook for ${serviceName}
+# Generated by: gpd init ${serviceName}
+
+SERVICE="${serviceName}"
+TARGET_DIR="${targetDir}"
+GIT_DIR="${bareRepo}"
+LOG_FILE="/var/log/gpd-${serviceName}.log"
+
+log() {
+    echo "[$(date '+%Y-%m-%d %H:%M:%S')] $1" | tee -a "$LOG_FILE"
+}
+
+log "=== Deployment started for $SERVICE ==="
+
+while read oldrev newrev refname; do
+    BRANCH=$(echo "$refname" | sed 's|refs/heads/||')
+    log "Received push to branch: $BRANCH"
+    
+    if [ "$BRANCH" != "main" ] && [ "$BRANCH" != "master" ]; then
+        log "Ignoring branch $BRANCH (only main/master triggers deploy)"
+        continue
+    fi
+
+    # Export variables for gpd install
+    export GPD_TARGET_DIR="$TARGET_DIR"
+    export GPD_GIT_DIR="$GIT_DIR"
+    export GPD_SERVICE="$SERVICE"
+    ${pm2Home ? `export PM2_HOME="${pm2Home}"` : ''}
+
+    # Run gpd install (handles checkout, npm install, pm2 restart)
+    log "Running: ${installCmd}"
+    ${installCmd} 2>&1 | tee -a "$LOG_FILE"
+done
+
+log "=== Deployment completed ==="
+`;
+}
+/**
+ * Init command - initialize bare repo and target directory on remote server via SSH
  *
  * Creates:
- * 1. Bare repo at server.bareRepo (e.g., /git/sym/deploy-kairox-api)
- * 2. Clone at server.targetDir (e.g., /opt/kairox/kairox-api)
+ * 1. Bare repo at server.bareRepo (e.g., /git/sym/deploy-kairox/staging/kairox-api)
+ * 2. Target directory at server.targetDir (e.g., /opt/kairox/staging/kairox-api)
+ * 3. Post-receive hook that calls `gpd install <service>`
  */
 export async function initCommand(serviceName, _options = {}) {
     console.log(chalk.blue(`Initializing ${serviceName}...`));
     const config = getServiceConfig(serviceName);
-    const { host, bareRepo, targetDir } = config.server;
+    const { host, bareRepo, targetDir, sshOptions, group } = config.server;
+    const { pm2User, pm2Home } = config;
     console.log(chalk.gray(`  Host: ${host}`));
     console.log(chalk.gray(`  Bare repo: ${bareRepo}`));
     console.log(chalk.gray(`  Target dir: ${targetDir}`));
-    // 1. Create bare repo
+    if (group)
+        console.log(chalk.gray(`  Group: ${group}`));
+    if (pm2User)
+        console.log(chalk.gray(`  PM2 user: ${pm2User}`));
+    // 1. Create group if specified
+    if (group) {
+        console.log(chalk.gray(`  Creating group ${group}...`));
+        const createGroupCmd = `sudo groupadd -f ${group} && sudo usermod -aG ${group} $(whoami)`;
+        sshExec(host, createGroupCmd, { sshOptions });
+    }
+    // 2. Create bare repo with shared group access
     console.log(chalk.gray(`  Creating bare repo...`));
-    const createBareCmd = `mkdir -p ${bareRepo} && cd ${bareRepo} && git init --bare`;
-    sshExec(host, createBareCmd);
-    // 2. Create target directory and clone
-    console.log(chalk.gray(`  Creating clone at target...`));
-    const parentDir = targetDir.split('/').slice(0, -1).join('/');
-    const cloneName = targetDir.split('/').pop();
-    const cloneCmd = `mkdir -p ${parentDir} && cd ${parentDir} && git clone ${bareRepo} ${cloneName} 2>/dev/null || (cd ${targetDir} && git pull)`;
-    sshExec(host, cloneCmd);
+    const bareRepoParent = bareRepo.split('/').slice(0, -1).join('/');
+    let createBareCmd = `sudo mkdir -p ${bareRepoParent}`;
+    if (group) {
+        createBareCmd += ` && sudo chgrp ${group} ${bareRepoParent} && sudo chmod g+rwxs ${bareRepoParent}`;
+    }
+    createBareCmd += ` && cd ${bareRepoParent} && git init --bare --shared=group ${bareRepo.split('/').pop()}`;
+    if (group) {
+        createBareCmd += ` && sudo chgrp -R ${group} ${bareRepo}`;
+    }
+    sshExec(host, createBareCmd, { sshOptions });
+    // 3. Create target directory
+    console.log(chalk.gray(`  Creating target directory...`));
+    const targetParent = targetDir.split('/').slice(0, -1).join('/');
+    let createTargetCmd = `sudo mkdir -p ${targetDir}`;
+    if (pm2User) {
+        createTargetCmd += ` && sudo chown ${pm2User}:${group || pm2User} ${targetDir}`;
+    }
+    if (group) {
+        createTargetCmd += ` && sudo chgrp -R ${group} ${targetParent} && sudo chmod g+rwxs ${targetParent}`;
+    }
+    sshExec(host, createTargetCmd, { sshOptions });
+    // 4. Create post-receive hook
+    console.log(chalk.gray(`  Creating post-receive hook...`));
+    const hookContent = generatePostReceiveHook(serviceName, {
+        targetDir,
+        bareRepo,
+        pm2User,
+        pm2Home
+    });
+    // Escape for shell (use base64 to avoid quote issues)
+    const hookBase64 = Buffer.from(hookContent).toString('base64');
+    const hookPath = `${bareRepo}/hooks/post-receive`;
+    const createHookCmd = `echo '${hookBase64}' | base64 -d | sudo tee ${hookPath} > /dev/null && sudo chmod +x ${hookPath}`;
+    if (group) {
+        sshExec(host, `${createHookCmd} && sudo chgrp ${group} ${hookPath}`, { sshOptions });
+    }
+    else {
+        sshExec(host, createHookCmd, { sshOptions });
+    }
+    // 5. Create log file
+    console.log(chalk.gray(`  Creating log file...`));
+    const logFile = `/var/log/gpd-${serviceName}.log`;
+    let createLogCmd = `sudo touch ${logFile} && sudo chmod 666 ${logFile}`;
+    if (group) {
+        createLogCmd += ` && sudo chgrp ${group} ${logFile}`;
+    }
+    sshExec(host, createLogCmd, { sshOptions });
     console.log(chalk.green(`✓ Initialized ${serviceName}`));
     console.log('');
     console.log(chalk.gray('Server setup complete. Now you can deploy:'));

package/dist/commands/init.js.map

@@ -1 +1 @@
-{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAM5C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,WAAmB,EAAE,WAAwB,EAAE;IAC/E,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,WAAW,KAAK,CAAC,CAAC,CAAC;IAE1D,MAAM,MAAM,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC;IAC7C,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,CAAC;IAEpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,iBAAiB,SAAS,EAAE,CAAC,CAAC,CAAC;IAEtD,sBAAsB;IACtB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,YAAY,QAAQ,UAAU,QAAQ,qBAAqB,CAAC;IAClF,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;IAE7B,uCAAuC;IACvC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,+BAA+B,CAAC,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9D,MAAM,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAC7C,MAAM,QAAQ,GAAG,YAAY,SAAS,UAAU,SAAS,iBAAiB,QAAQ,IAAI,SAAS,uBAAuB,SAAS,eAAe,CAAC;IAC/I,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAExB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,iBAAiB,WAAW,EAAE,CAAC,CAAC,CAAC;IACzD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4CAA4C,CAAC,CAAC,CAAC;IACtE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,gBAAgB,WAAW,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC"}
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../src/commands/init.ts"],"names":[],"mappings":"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"}

package/dist/commands/install.d.ts

@@ -0,0 +1,21 @@
+interface InstallOptions {
+    configPath?: string;
+}
+/**
+ * Install command - runs on server after git push (called by post-receive hook)
+ *
+ * Environment variables from hook:
+ * - GPD_TARGET_DIR: Where to install (e.g., /opt/kairox/staging/kairox-api)
+ * - GPD_GIT_DIR: Bare repo path (e.g., /git/sym/deploy-kairox/staging/kairox-api)
+ * - GPD_SERVICE: Service name (e.g., kairox-api-staging)
+ * - PM2_HOME: PM2 home directory (optional)
+ *
+ * Steps:
+ * 1. git checkout from bare repo to target dir
+ * 2. Generate .env file from config
+ * 3. npm install --omit=dev
+ * 4. PM2 restart
+ */
+export declare function installCommand(serviceName: string, options?: InstallOptions): Promise<void>;
+export {};
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAMA,UAAU,cAAc;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAoDD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiHrG"}