tlc-claude-code 1.2.0 → 1.2.2

package/CLAUDE.md

@@ -27,15 +27,41 @@ Instead, use TLC's file-based system:
 | Test status | `.planning/phases/{N}-TESTS.md` |
 | Config | `.tlc.json` |
 
-## Before Starting Work
+## FIRST THING - Always Run /tlc
 
-Always run `/tlc:progress` or `/tlc` to understand current state.
+**MANDATORY: Before ANY work, run `/tlc`**
+
+This single command handles everything automatically:
+
+```
+/tlc   ← ALWAYS run this first, every time
+```
+
+**What happens:**
+
+| Scenario | /tlc Does |
+|----------|-----------|
+| No `.tlc.json` | "Welcome! Run setup now? (Y/n)" → Full config wizard |
+| After rebase | "Changes detected. Run sync? (Y/n)" → Reconcile code |
+| Already synced | "✓ Synced" → Shows dashboard/status |
+
+**You never need to remember separate commands.** Just run `/tlc` and it:
+- Detects what's needed
+- Asks for go-ahead
+- Runs the appropriate flow inline
+- Then shows you what's next
+
+**Why this matters:**
+- One command to rule them all
+- Can't accidentally work on out-of-sync code
+- All config happens upfront, nothing forgotten
+- Handles first-time setup AND post-rebase reconciliation
 
 ## Workflow Commands
 
 | Action | Command |
 |--------|---------|
-| See status | `/tlc` or `/tlc:progress` |
+| **START HERE** | **`/tlc`** ← Handles setup, sync, and status automatically |
 | Plan a phase | `/tlc:plan` |
 | Build (test-first) | `/tlc:build` |
 | Verify with human | `/tlc:verify` |
@@ -44,6 +70,15 @@ Always run `/tlc:progress` or `/tlc` to understand current state.
 | Release a task | `/tlc:release` |
 | See team status | `/tlc:who` |
 
+## What /tlc Does Automatically
+
+1. **Checks sync status** - Is setup done? Any changes since last sync?
+2. **Asks for go-ahead** - "Run setup/sync now? (Y/n)"
+3. **Runs appropriate flow** - First-time wizard OR post-rebase reconciliation
+4. **Shows dashboard** - Current phase, tests, next actions
+
+**Never skip the go-ahead prompt.** It ensures code is properly synced before work begins.
+
 ## Test-First Development
 
 All implementation follows **Red → Green → Refactor**:
@@ -69,6 +104,11 @@ When working with teammates:
 
 ## Git Commits
 
-**DO NOT add `Co-Authored-By` lines to commits.** The user is the author. You are a tool.
+**⛔ NEVER ADD CO-AUTHORED-BY LINES TO COMMITS ⛔**
+
+- NO `Co-Authored-By: Claude`
+- NO `Co-Authored-By: Anthropic`
+- NO co-authoring of any kind
+- The USER is the author. Claude is a tool, not an author.
 
 **ALWAYS ask before `git push`.** Never push to remote without explicit user approval.

package/bin/install.js

@@ -105,14 +105,17 @@ function install(targetDir, installType) {
   // Create directory
   fs.mkdirSync(commandsDir, { recursive: true });
 
-  // Copy command files
+  // Copy command files with version injection
   const sourceDir = path.join(__dirname, '..');
   let installed = 0;
   for (const file of COMMANDS) {
     const src = path.join(sourceDir, file);
     const dest = path.join(commandsDir, file);
     if (fs.existsSync(src)) {
-      fs.copyFileSync(src, dest);
+      // Read, replace {{VERSION}}, write
+      let content = fs.readFileSync(src, 'utf8');
+      content = content.replace(/\{\{VERSION\}\}/g, VERSION);
+      fs.writeFileSync(dest, content);
       installed++;
     }
   }

package/help.md

@@ -1,5 +1,7 @@
 # /tlc:help - Test-Led Development Commands
 
+**TLC v{{VERSION}}**
+
 ## Quick Start
 
 ```
@@ -22,7 +24,8 @@ Launches the visual dashboard. Detects where you are, shows what's next.
 
 | Command | What It Does |
 |---------|--------------|
-| `/tlc:sync` | **One command to rule them all.** First-time setup or post-rebase reconciliation |
+| `/tlc` | **Start here.** Auto-detects setup/sync needs, asks, then runs |
+| `/tlc:sync` | Direct access to setup/sync (usually not needed - /tlc handles it) |
 | `/tlc:new-project` | Start new project (discusses stack, creates roadmap) |
 | `/tlc:init` | Add TLC to existing code |
 | `/tlc:import-project` | Import multi-repo microservices architecture |
@@ -98,31 +101,28 @@ Launches the visual dashboard. Detects where you are, shows what's next.
 
 ## Workflow
 
-**Simple version:**
+**Just one command:**
 ```
-/tlc:sync               <- First time or after rebase
-/tlc                    <- Then just keep running this
+/tlc                    <- Always start here
 ```
 
-**Detailed version:**
+That's it. `/tlc` handles everything:
+
 ```
-/tlc:sync               First-time setup (all config in one go)
-    ↓                   Or: post-rebase reconciliation
-/tlc:new-project        New project (or /tlc:init for existing)
-    ↓
-/tlc                    Guides you through each phase:
-                        → discuss → plan → build → verify
-    ↓
-/tlc:complete           Tag release
+/tlc
+ ↓
+ No config? → "Run setup? (Y/n)" → Full wizard
+ ↓
+ Rebase detected? → "Run sync? (Y/n)" → Reconcile
+ ↓
+ Already synced? → Dashboard + next actions
 ```
 
 **After rebasing:**
 ```
-git rebase origin/main  TLC detects changes
-    ↓
-/tlc:sync               Reconcile incoming code
+git rebase origin/main
     ↓
-/tlc                    Continue working
+/tlc                    ← Detects changes, asks, syncs, continues
 ```
 
 ---

package/package.json

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

package/tlc.md

@@ -1,31 +1,53 @@
 # /tlc - Smart Entry Point
 
+**TLC v{{VERSION}}**
+
 One command. Context-aware. Visual dashboard.
 
+## First Response
+
+Always start by showing the version:
+
+```
+TLC v1.2.1
+```
+
+Then proceed with sync check and status.
+
 ## What This Does
 
 Launches the TLC dashboard - a visual interface showing project state, phases, tests, and next actions.
 
 ## Process
 
-### Step 0: Check Sync Status (ALWAYS FIRST)
+### Step 0: Auto-Sync Check (ALWAYS FIRST)
 
-Before anything else, check if codebase is synced:
+Before anything else, check if sync is needed and handle it automatically:
 
 ```bash
 # Check if .tlc.json exists
 if [ ! -f ".tlc.json" ]; then
   # No TLC config - need first-time setup
-  echo "No TLC configuration found."
-  echo "→ Run /tlc:sync to set up TLC"
-  exit
+  echo "Welcome to TLC!"
+  echo ""
+  echo "No configuration found. Let's set up your project."
+  echo "This configures test framework, team settings, quality gates, and more."
+  echo ""
+  echo "Run setup now? (Y/n)"
+  # If yes → Run /tlc:sync inline (first-time flow)
+  # Then continue to Step 1
 fi
 
 # Check for rebase marker
 if [ -f ".tlc-rebase-marker" ]; then
   echo "⚠️ Rebase detected since last sync."
-  echo "→ Run /tlc:sync to reconcile changes"
-  exit
+  echo ""
+  echo "TLC needs to reconcile incoming changes."
+  echo "This ensures new code meets TLC standards."
+  echo ""
+  echo "Run sync now? (Y/n)"
+  # If yes → Run /tlc:sync inline (post-rebase flow)
+  # Then continue to Step 1
 fi
 
 # Check if HEAD matches lastSync
@@ -37,12 +59,25 @@ if [ -n "$lastSync" ] && [ "$lastSync" != "$currentHead" ]; then
   echo "   Last sync: ${lastSync:0:7}"
   echo "   Current:   ${currentHead:0:7}"
   echo ""
-  echo "→ Run /tlc:sync to reconcile changes"
-  exit
+  changedCount=$(git diff --name-only $lastSync $currentHead 2>/dev/null | wc -l)
+  echo "   $changedCount files changed"
+  echo ""
+  echo "Run sync now? (Y/n)"
+  # If yes → Run /tlc:sync inline (post-rebase flow)
+  # Then continue to Step 1
 fi
+
+# If we get here, sync is current
+echo "✓ Synced"
 ```
 
-Only proceed if synced. This prevents working on out-of-sync code.
+**Key behavior:**
+- Detects if sync needed
+- Asks for confirmation
+- Runs sync flow inline (not separate command)
+- Then continues to dashboard/status
+
+User never needs to know about `/tlc:sync` as a separate command - `/tlc` handles everything.
 
 ### Step 1: Launch Dashboard