tlc-claude-code 1.2.11 → 1.2.12

package/deploy.md

@@ -9,12 +9,110 @@ Deploy your TLC project to a remote dev server 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
 
 ```

package/help.md

@@ -92,6 +92,7 @@ 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 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 |

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.11",
+  "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
 
 ```