tlc-claude-code 1.2.11 → 1.2.13

package/deploy.md

@@ -9,12 +9,153 @@ 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. **Detect project state**:
+   - New project? Use info from `/tlc:new-project` or `/tlc:init`
+   - Existing TLC project? Read from `.tlc.json`
+   - Legacy project? Read from `package.json` + git remote
+2. **Ask for domain** if not configured
+3. **Generate webhook secret** (random 16 chars)
+4. **Output setup command** with all config embedded
+5. **Save/update config** in `.tlc.json`
+
+### Upgrading Existing Projects
+
+For projects already using TLC but without team features:
+
+```
+> /tlc:deploy setup
+
+TLC Dev Server Setup
+════════════════════════════════════════════════════════════════════
+
+Detected existing TLC project: my-awesome-app
+  ✓ .tlc.json found
+  ✓ .planning/ directory exists
+  ✗ No deploy config yet
+
+Adding team collaboration features...
+
+Project: my-awesome-app
+Repo:    git@github.com:myorg/my-awesome-app.git
+
+Enter your server domain: _
+```
+
+The setup continues with the same flow - generates config, shows server command, DNS instructions, webhook config.
+
+**What gets added to .tlc.json:**
+
+```json
+{
+  "project": "my-awesome-app",
+  "testFrameworks": { ... },    // existing config preserved
+  "deploy": {                   // NEW: added by setup
+    "domain": "myapp.example.com",
+    "webhookSecret": "x7k9m2p4q8r1s5t3",
+    "dashboardUrl": "https://dashboard.myapp.example.com",
+    "configured": false
+  }
+}
+```
+
+```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.13",
   "description": "TLC - Test Led Coding for Claude Code",
   "bin": {
     "tlc": "./bin/tlc.js",

package/tlc.md

@@ -64,6 +64,23 @@ fi
 echo "✓ Synced"
 ```
 
+### Step 0b: Check for Team Features (Existing Projects)
+
+For projects that existed before team features, check if dev server is configured:
+
+```bash
+# Check if deploy config exists
+deployDomain=$(jq -r '.deploy.domain // ""' .tlc.json)
+
+if [ -z "$deployDomain" ]; then
+  # No deploy config - this is an existing project without team setup
+  # Show subtle hint in header (not blocking)
+  teamHint="│ 💡 Team sharing available: /tlc:deploy setup"
+fi
+```
+
+This adds a non-blocking hint. Users can also access it via Quick Actions [5].
+
 ### Step 1: Show Phase Checklist (ALWAYS SHOW THIS)
 
 **This is the core of `/tlc` - always show the current phase status:**
@@ -102,8 +119,9 @@ Phase 2: User Dashboard
   [2] Go back and fix skipped steps
   [3] Show all commands (/tlc:help)
   [4] Full project checklist (/tlc:checklist)
+  [5] Set up team dev server (/tlc:deploy setup)
 
-Choice [1/2/3/4]: _
+Choice [1/2/3/4/5]: _
 ```
 
 ### Step 2: Detect Current Phase
@@ -256,6 +274,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
 
 ```