tlc-claude-code 1.2.10 → 1.2.12

package/README.md

@@ -77,7 +77,7 @@ TLC knows where you are and what's next.
 ### For Enterprise
 
 - **CI/CD pipelines** — GitHub Actions, GitLab, Azure, CircleCI
-- **VPS deployment** — Branch previews with auth & Slack webhooks
+- **Dev server** — Branch previews with auth & Slack webhooks
 - **Multi-tool export** — Works with Cursor, Copilot, Continue, Cody
 
 ---
@@ -110,7 +110,7 @@ TLC knows where you are and what's next.
 | `/tlc:ci` | Generate CI/CD pipeline |
 | `/tlc:issues` | Sync with GitHub/Jira/Linear |
 | `/tlc:export` | Export for Cursor/Copilot/etc |
-| `/tlc:deploy` | VPS deployment |
+| `/tlc:deploy` | Dev server deployment |
 
 [**See all commands →**](help.md)
 
@@ -290,9 +290,9 @@ Commands install to `.claude/commands/tlc/`
 
 ---
 
-## VPS Deployment
+## TLC Dev Server
 
-Deploy TLC server for your team on any VPS.
+Deploy TLC dev server for your team on any Linux server.
 
 ### Quick Setup (Ubuntu)
 
@@ -310,8 +310,8 @@ curl -fsSL https://raw.githubusercontent.com/jurgencalleja/TLC/main/scripts/vps-
 
 ### Requirements
 
-- Ubuntu 22.04+ VPS (2GB+ RAM)
-- Domain with wildcard DNS (`*.project.com → VPS_IP`)
+- Ubuntu 22.04+ server (2GB+ RAM)
+- Domain with wildcard DNS (`*.project.com → SERVER_IP`)
 - GitHub/GitLab repo access
 
 ### Manual Setup
@@ -340,7 +340,7 @@ curl -fsSL https://raw.githubusercontent.com/jurgencalleja/TLC/main/scripts/vps-
 
 5. **Configure webhook** in GitHub/GitLab repo settings
 
-[**Full VPS Guide →**](docs/vps-deployment.md)
+[**Full Dev Server Guide →**](docs/devserver.md)
 
 ---
 
@@ -373,7 +373,7 @@ helm install tlc tlc/tlc-server \
 
 - **[Help / All Commands](help.md)** — Complete command reference
 - **[Team Workflow](docs/team-workflow.md)** — Guide for teams (engineers + PO + QA)
-- **[VPS Deployment](docs/vps-deployment.md)** — Deploy on Ubuntu VPS
+- **[Dev Server](docs/devserver.md)** — Deploy on Ubuntu server
 - **[Kubernetes Deployment](docs/kubernetes-deployment.md)** — Deploy on K8s
 
 ---

package/deploy.md

@@ -1,6 +1,6 @@
-# /tlc:deploy - VPS Deployment Server
+# /tlc:deploy - TLC Dev Server
 
-Deploy your TLC project to a VPS for team collaboration.
+Deploy your TLC project to a remote dev server for team collaboration.
 
 ## Usage
 
@@ -9,17 +9,115 @@ Deploy your TLC project to a VPS for team collaboration.
 ```
 
 Commands:
-- `setup` - Configure deployment server
+- `setup` - Generate server config and setup instructions
 - `push` - Deploy current branch
 - `status` - Check deployment status
 - `logs` - View deployment logs
 - `users` - Manage server users
 
+---
+
+## Quick Setup (Terminal)
+
+Run `/tlc:deploy setup` to generate your server config:
+
+```
+TLC Dev Server Setup
+════════════════════════════════════════════════════════════════════
+
+Project Configuration
+─────────────────────
+  Name:    my-awesome-app
+  Repo:    git@github.com:myorg/my-awesome-app.git
+  Domain:  (enter your domain)
+
+Domain for dev server: myapp.example.com
+
+Generating config...
+
+════════════════════════════════════════════════════════════════════
+STEP 1: Run this on your Ubuntu server
+════════════════════════════════════════════════════════════════════
+
+┌────────────────────────────────────────────────────────────────────┐
+│                                                                    │
+│  curl -fsSL https://tlc.dev/install | bash -s -- \                │
+│    --project "my-awesome-app" \                                    │
+│    --repo "git@github.com:myorg/my-awesome-app.git" \             │
+│    --domain "myapp.example.com" \                                  │
+│    --webhook-secret "a1b2c3d4e5f6g7h8"                            │
+│                                                                    │
+└────────────────────────────────────────────────────────────────────┘
+                                                        [Copy to clipboard]
+
+════════════════════════════════════════════════════════════════════
+STEP 2: Configure DNS
+════════════════════════════════════════════════════════════════════
+
+Add these DNS records pointing to your server IP:
+
+  *.myapp.example.com      →  YOUR_SERVER_IP
+  dashboard.myapp.example.com  →  YOUR_SERVER_IP
+
+════════════════════════════════════════════════════════════════════
+STEP 3: Add GitHub Webhook
+════════════════════════════════════════════════════════════════════
+
+Go to: https://github.com/myorg/my-awesome-app/settings/hooks/new
+
+  Payload URL:  https://dashboard.myapp.example.com/api/webhook
+  Content type: application/json
+  Secret:       a1b2c3d4e5f6g7h8
+  Events:       Just the push event
+
+════════════════════════════════════════════════════════════════════
+STEP 4: Done!
+════════════════════════════════════════════════════════════════════
+
+Once server setup completes, you'll get:
+
+  Dashboard:     https://dashboard.myapp.example.com
+  Main branch:   https://main.myapp.example.com
+  Feature branches: https://{branch}.myapp.example.com
+
+Admin credentials will be shown after server setup.
+
+────────────────────────────────────────────────────────────────────
+Config saved to .tlc.json
+```
+
+### Process
+
+1. **Read project info** from `.tlc.json` or `package.json`
+2. **Ask for domain** if not configured
+3. **Generate webhook secret** (random 16 chars)
+4. **Output setup command** with all config embedded
+5. **Save config** to `.tlc.json`
+
+```javascript
+// Config generation
+const config = {
+  project: packageJson.name,
+  repo: getGitRemoteUrl(),
+  domain: userInput.domain,
+  webhookSecret: crypto.randomBytes(16).toString('hex')
+};
+
+// Generate one-liner
+const command = `curl -fsSL https://tlc.dev/install | bash -s -- \\
+  --project "${config.project}" \\
+  --repo "${config.repo}" \\
+  --domain "${config.domain}" \\
+  --webhook-secret "${config.webhookSecret}"`;
+```
+
+---
+
 ## Architecture
 
 ```
 ┌─────────────────────────────────────────────────────────────┐
-│                        VPS Server                            │
+│                      TLC Dev Server                          │
 │                                                              │
 │  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐         │
 │  │   Branch    │  │   Branch    │  │   Branch    │         │
@@ -65,7 +163,7 @@ Commands:
 
 TLC Deployment Server Setup
 
-VPS Configuration:
+Dev Server Configuration:
   Host: deploy.example.com
   SSH Key: ~/.ssh/id_rsa (detected)
 
@@ -82,7 +180,7 @@ Domain Configuration:
   Branches will be: {branch}.project.example.com
 
 Configure DNS:
-  *.project.example.com → VPS_IP
+  *.project.example.com → SERVER_IP
 
 Admin User:
   Email: admin@example.com
@@ -183,7 +281,7 @@ app.get('/api/status', requireRole(['admin', 'engineer', 'qa', 'po']));
 
 Deploying branch: feat-auth
 
-Pushing to VPS...
+Pushing to dev server...
   ✓ Code uploaded
   ✓ Dependencies installed
   ✓ Tests passed (23/23)
@@ -363,7 +461,7 @@ EXPOSE 3000
 CMD ["npm", "start"]
 ```
 
-### docker-compose.yml (on VPS)
+### docker-compose.yml (on dev server)
 
 ```yaml
 version: '3.8'
@@ -434,7 +532,7 @@ server {
 Generating deployment SSH key...
   ✓ Key generated: ~/.ssh/tlc_deploy
 
-Add this to VPS authorized_keys:
+Add this to server authorized_keys:
   ssh-rsa AAAA... tlc-deploy
 
 Add to GitHub deploy keys (read-only):
@@ -443,7 +541,7 @@ Add to GitHub deploy keys (read-only):
 
 ### Environment Variables
 
-Secrets stored on VPS:
+Secrets stored on dev server:
 
 ```bash
 # /opt/tlc-deploy/.env

package/help.md

@@ -92,7 +92,8 @@ Launches the visual dashboard. Detects where you are, shows what's next.
 | `/tlc:export --list` | Show all supported AI tools |
 | `/tlc:export --detect` | Detect which AI tool is running |
 | `/tlc:deploy` | Show deployment status |
-| `/tlc:deploy start <branch>` | Deploy branch to VPS |
+| `/tlc:deploy setup` | Generate server config + copy-paste install command |
+| `/tlc:deploy start <branch>` | Deploy branch to dev server |
 | `/tlc:deploy stop <branch>` | Stop branch deployment |
 | `/tlc:deploy logs <branch>` | View deployment logs |
 | `/tlc:deploy list` | List all active deployments |

package/init.md

@@ -388,6 +388,28 @@ Next steps:
 - Run /tlc:quick for ad-hoc tasks with tests
 ```
 
+### Step 13: Offer Dev Server Setup
+
+After initialization, offer remote dev server:
+
+```
+───────────────────────────────────────────────────────────────
+Dev Server (Optional)
+───────────────────────────────────────────────────────────────
+
+Set up a shared dev server for team collaboration?
+  • Each branch gets its own preview URL
+  • QA and PO can access without local setup
+  • Slack notifications for deployments
+
+  [1] Yes, set up dev server
+  [2] Skip for now
+
+Choice [1/2]: _
+```
+
+**If [1] selected:** Run the dev server setup flow from `/tlc:deploy setup`.
+
 ## Usage
 
 ```

package/new-project.md

@@ -380,6 +380,37 @@ npx cypress open
 Ready to build. Run /tlc:plan to create your first phase.
 ```
 
+### Step 10: Offer Dev Server Setup
+
+After project is configured, offer remote dev server:
+
+```
+───────────────────────────────────────────────────────────────
+Dev Server (Optional)
+───────────────────────────────────────────────────────────────
+
+Set up a shared dev server for team collaboration?
+  • Each branch gets its own preview URL
+  • QA and PO can access without local setup
+  • Slack notifications for deployments
+
+  [1] Yes, set up dev server
+  [2] Skip for now
+
+Choice [1/2]: _
+```
+
+**If [1] selected:**
+
+1. Ask for server domain
+2. Generate webhook secret
+3. Show setup command for server
+4. Show DNS instructions
+5. Show GitHub webhook config
+6. Save config to `.tlc.json`
+
+See `/tlc:deploy setup` for full output format.
+
 ## Usage
 
 ```
@@ -392,3 +423,4 @@ Interactive flow that:
 3. Lets you adjust
 4. Creates roadmap
 5. Sets up tests
+6. Offers dev server setup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tlc-claude-code",
-  "version": "1.2.10",
+  "version": "1.2.12",
   "description": "TLC - Test Led Coding for Claude Code",
   "bin": {
     "tlc": "./bin/tlc.js",

package/tlc.md

@@ -256,6 +256,114 @@ Options:
 Choice [1/2]: _
 ```
 
+## After Project Setup (First Time)
+
+After `/tlc:new-project` or `/tlc:init` completes, show dev server option:
+
+```
+TLC v{{VERSION}}
+═══════════════════════════════════════════════════════════════
+
+✓ Project configured: my-awesome-app
+
+───────────────────────────────────────────────────────────────
+Dev Server Setup (Optional)
+───────────────────────────────────────────────────────────────
+
+Deploy to a shared dev server for team collaboration?
+Each branch gets its own preview URL.
+
+  [1] Yes, set up dev server  → Shows setup instructions
+  [2] Skip for now            → Continue to project
+
+Choice [1/2]: _
+```
+
+**If [1] selected**, show inline setup panel:
+
+```
+═══════════════════════════════════════════════════════════════
+TLC Dev Server Setup
+═══════════════════════════════════════════════════════════════
+
+Project: my-awesome-app
+Repo:    git@github.com:myorg/my-awesome-app.git
+
+Enter your server domain: myapp.example.com
+
+───────────────────────────────────────────────────────────────
+STEP 1: Run on Ubuntu Server
+───────────────────────────────────────────────────────────────
+
+┌─────────────────────────────────────────────────────────────┐
+│ curl -fsSL https://tlc.dev/install | bash -s -- \          │
+│   --project "my-awesome-app" \                              │
+│   --repo "git@github.com:myorg/my-awesome-app.git" \       │
+│   --domain "myapp.example.com" \                            │
+│   --webhook-secret "x7k9m2p4q8r1s5t3"                       │
+└─────────────────────────────────────────────────────────────┘
+
+───────────────────────────────────────────────────────────────
+STEP 2: Configure DNS
+───────────────────────────────────────────────────────────────
+
+Point these to your server:
+  *.myapp.example.com          → SERVER_IP
+  dashboard.myapp.example.com  → SERVER_IP
+
+───────────────────────────────────────────────────────────────
+STEP 3: Add Webhook to GitHub
+───────────────────────────────────────────────────────────────
+
+URL:     https://dashboard.myapp.example.com/api/webhook
+Secret:  x7k9m2p4q8r1s5t3
+
+───────────────────────────────────────────────────────────────
+What You Get
+───────────────────────────────────────────────────────────────
+
+  Dashboard:        https://dashboard.myapp.example.com
+  Main branch:      https://main.myapp.example.com
+  Feature branches: https://{branch}.myapp.example.com
+
+───────────────────────────────────────────────────────────────
+
+Config saved to .tlc.json
+
+Press Enter to continue...
+```
+
+### Config Generation
+
+When generating the setup command:
+
+```javascript
+// Read from project
+const projectName = tlcJson.project || packageJson.name;
+const repoUrl = execSync('git remote get-url origin').toString().trim();
+
+// Ask user for domain
+const domain = await prompt('Enter your server domain:');
+
+// Generate secure webhook secret
+const webhookSecret = crypto.randomBytes(8).toString('hex');
+
+// Save to .tlc.json
+tlcJson.deploy = {
+  domain: domain,
+  webhookSecret: webhookSecret,
+  dashboardUrl: `https://dashboard.${domain}`,
+  configured: false  // Set to true after server confirms
+};
+
+// Generate command
+const setupCommand = `curl -fsSL https://tlc.dev/install | bash -s -- \\
+  --project "${projectName}" \\
+  --repo "${repoUrl}" \\
+  --domain "${domain}" \\
+  --webhook-secret "${webhookSecret}"`;
+```
+
 ## All Phases Complete
 
 ```