tlc-claude-code 1.2.20 → 1.2.22

package/config.md

@@ -1,6 +1,6 @@
-# /tlc:config - Configure Test Frameworks
+# /tlc:config - Setup Wizard
 
-Manage test framework settings for your project.
+Interactive setup for TLC. No JSON editing required.
 
 ## Usage
 
@@ -8,229 +8,224 @@ Manage test framework settings for your project.
 /tlc:config
 ```
 
-## Configuration File
+## Process
 
-TLC stores test preferences in `.tlc.json` at the project root:
+### Step 1: Welcome & Auto-Detect
 
-```json
-{
-  "testFrameworks": {
-    "primary": "mocha",
-    "installed": ["mocha", "chai", "sinon", "proxyquire"],
-    "run": ["mocha"]
-  },
-  "testCommand": "npm test",
-  "testDirectory": "test"
-}
-```
+First, scan the project and greet the user:
 
-### Fields
+```
+═══════════════════════════════════════════════════════════════
+TLC Setup Wizard
+═══════════════════════════════════════════════════════════════
 
-| Field | Description |
-|-------|-------------|
-| `primary` | Main test framework for new tests |
-| `installed` | All test libraries available in project |
-| `run` | Which frameworks to execute (subset of installed) |
-| `testCommand` | Command to run tests |
-| `testDirectory` | Where test files live |
+Scanning your project...
 
-## Supported Frameworks
+✓ Found: package.json (Node.js project)
+✓ Found: 12 existing test files
+✓ Detected: Jest is installed
 
-### Default Stack (Recommended)
+Let's configure TLC for your project!
+```
 
-TLC defaults to the mocha ecosystem for new projects:
+### Step 2: Test Framework
 
-| Library | Purpose |
-|---------|---------|
-| **mocha** | Test runner |
-| **chai** | Assertions (expect, should, assert) |
-| **sinon** | Mocks, stubs, spies |
-| **proxyquire** | Module mocking/dependency injection |
+Ask in plain language:
 
-```bash
-npm install -D mocha chai sinon proxyquire @types/mocha @types/chai @types/sinon
 ```
+───────────────────────────────────────────────────────────────
+Question 1 of 4: Test Framework
+───────────────────────────────────────────────────────────────
 
-### Alternative Frameworks
+Which test framework do you want to use?
 
-| Framework | Use Case |
-|-----------|----------|
-| **vitest** | Vite projects, fast, ESM-native |
-| **jest** | React/Meta ecosystem, all-in-one |
-| **pytest** | Python projects |
-| **go test** | Go projects (built-in) |
-| **rspec** | Ruby projects |
+  [1] Keep Jest (already installed) ← Recommended
+  [2] Switch to Mocha (TLC default)
+  [3] Use Vitest (fast, modern)
+  [4] I'm not sure - choose for me
 
-## Process
+Choice [1/2/3/4]: _
+```
 
-### Step 1: Check for Existing Config
+**If user chooses 4 ("not sure"):**
+- Node.js project → Mocha
+- Vite project → Vitest
+- React/Next.js → Jest
+- Python → pytest
+- Go → go test
 
-Look for `.tlc.json` in project root.
+**After selection, handle installation silently:**
+```
+Setting up Mocha...
+✓ Installed mocha, chai, sinon
+✓ Created test/ folder
+✓ Added test script to package.json
 
-If exists, display current settings:
+Done!
 ```
-Current TLC Configuration:
 
-Test Framework: mocha
-Libraries: mocha, chai, sinon, proxyquire
-Run Command: npm test
-Test Directory: test/
+### Step 3: Coverage Target
 
-What would you like to do?
-1) View/edit frameworks to run
-2) Add a new framework
-3) Change primary framework
-4) Reset to defaults
 ```
+───────────────────────────────────────────────────────────────
+Question 2 of 4: Code Coverage
+───────────────────────────────────────────────────────────────
+
+How thorough should testing be?
 
-### Step 2: First-Time Setup
+  [1] Relaxed (60%) - Good for prototypes
+  [2] Standard (80%) - Recommended for most projects
+  [3] Strict (95%) - For critical systems
+  [4] Skip coverage checks
 
-If no config exists, check for existing tests:
+Choice [1/2/3/4]: _
+```
 
-1. **Detect installed frameworks** from package.json/dependencies
-2. **Detect test files** patterns in use
-3. **Propose configuration** based on findings
+### Step 4: Team or Solo
 
 ```
-No TLC config found. Analyzing project...
+───────────────────────────────────────────────────────────────
+Question 3 of 4: Working Style
+───────────────────────────────────────────────────────────────
+
+Are you working alone or with a team?
 
-Detected:
-  - jest (installed)
-  - 47 test files using Jest patterns
+  [1] Solo - Just me
+  [2] Team - Multiple people on this project
 
-Options:
-1) Keep Jest as primary (detected)
-2) Add mocha alongside Jest
-3) Switch to mocha (TLC default)
-4) Custom configuration
+Choice [1/2]: _
 ```
 
-### Step 3: Multi-Framework Setup
+**If Team selected:**
+```
+Great! Team mode enables:
+  • Task claiming (prevent duplicate work)
+  • @mentions in plans
+  • Team status dashboard
 
-When multiple frameworks coexist:
+Your team name (from git): alice
 
+Is this correct? [Y/n]: _
 ```
-Multiple test frameworks detected:
-  - mocha: test/unit/*.test.js (23 files)
-  - jest: __tests__/*.spec.js (15 files)
 
-Configure which to run:
-  [x] mocha - run these tests
-  [x] jest - run these tests
-  [ ] Run all frameworks
+### Step 5: Summary & Confirm
 
-Test commands:
-  mocha: npx mocha 'test/**/*.test.js'
-  jest: npx jest
-  combined: npm test (runs both)
 ```
+───────────────────────────────────────────────────────────────
+Setup Summary
+───────────────────────────────────────────────────────────────
 
-### Step 4: Save Configuration
+  Test Framework:  Mocha + Chai + Sinon
+  Coverage Target: 80%
+  Team Mode:       Enabled (you: @alice)
+  Test Folder:     test/
 
-Write `.tlc.json`:
+Apply these settings? [Y/n]: _
+```
 
-```json
-{
-  "testFrameworks": {
-    "primary": "mocha",
-    "installed": ["mocha", "chai", "sinon", "proxyquire", "jest"],
-    "run": ["mocha", "jest"]
-  },
-  "commands": {
-    "mocha": "npx mocha 'test/**/*.test.js'",
-    "jest": "npx jest",
-    "all": "npm test"
-  },
-  "testDirectory": "test",
-  "patterns": {
-    "mocha": "test/**/*.test.js",
-    "jest": "__tests__/**/*.spec.js"
-  }
-}
+**On confirm:**
 ```
+═══════════════════════════════════════════════════════════════
+✓ TLC Configured!
+═══════════════════════════════════════════════════════════════
 
-### Step 5: Update package.json
+You're all set. Here's what to do next:
 
-Ensure test scripts are configured:
+  /tlc              See project status
+  /tlc:build        Build current phase (writes tests first)
+  /tlc:status       Check if tests are passing
 
-```json
-{
-  "scripts": {
-    "test": "npm run test:mocha && npm run test:jest",
-    "test:mocha": "mocha 'test/**/*.test.js'",
-    "test:jest": "jest",
-    "test:watch": "mocha --watch 'test/**/*.test.js'"
-  }
-}
+Happy coding!
 ```
 
-## Example: Adding a Framework
+## Reconfigure
+
+If `.tlc.json` already exists, show current settings first:
 
 ```
-> /tlc:config
+═══════════════════════════════════════════════════════════════
+Current TLC Settings
+═══════════════════════════════════════════════════════════════
 
-Current: mocha (primary)
+  Test Framework:  Mocha
+  Coverage Target: 80%
+  Team Mode:       Off
 
-What would you like to do?
-> 2) Add a new framework
+What would you like to change?
 
-Available frameworks to add:
-1) jest - All-in-one testing (React ecosystem)
-2) vitest - Fast, Vite-native
-3) Other (specify)
+  [1] Test framework
+  [2] Coverage target
+  [3] Enable/disable team mode
+  [4] Reset everything
+  [5] Exit (keep current settings)
 
-> 1) jest
+Choice [1/2/3/4/5]: _
+```
 
-Installing jest...
-npm install -D jest @types/jest
+## Advanced Mode
 
-Configure jest test location:
-> __tests__/
+For power users who want to edit JSON directly:
 
-Updated .tlc.json:
-  installed: mocha, chai, sinon, proxyquire, jest
-  run: mocha, jest
+```
+/tlc:config --advanced
+```
 
-Run which tests?
-1) All frameworks (mocha + jest)
-2) Only mocha
-3) Only jest
-4) Let me choose per-run
+Shows the raw `.tlc.json` and allows direct editing. But this is hidden from the main flow.
 
-> 1) All frameworks
+## Auto-Detection Rules
 
-Done. Run 'npm test' to execute all test suites.
-```
+| What We Find | What We Set Up |
+|--------------|----------------|
+| `jest` in package.json | Jest as primary |
+| `vitest` in package.json | Vitest as primary |
+| `mocha` in package.json | Mocha as primary |
+| `pytest` in requirements.txt | pytest as primary |
+| Vite project (vite.config) | Suggest Vitest |
+| React/Next.js project | Suggest Jest |
+| Nothing detected | Default to Mocha |
 
-## Example: Project with Existing Jest
+## Silent Installation
+
+When setting up a framework, install everything needed without asking:
+
+**Mocha:**
+```bash
+npm install -D mocha chai sinon proxyquire
+```
 
+**Jest:**
+```bash
+npm install -D jest
 ```
-> /tlc:config
 
-Detected: jest (47 test files)
+**Vitest:**
+```bash
+npm install -D vitest
+```
 
-Your project uses Jest. Options:
+**pytest:**
+```bash
+pip install pytest pytest-cov pytest-mock
+```
 
-1) Keep Jest only
-2) Add mocha for new tests, keep Jest for existing
-3) Migrate to mocha (will need to convert tests)
+## Error Recovery
 
-> 2) Add mocha for new tests
+If something goes wrong:
 
-Setting up mocha alongside Jest...
+```
+⚠️ Couldn't install mocha automatically.
 
-New tests will use: mocha + chai + sinon
-Existing tests remain: jest
+Try running this manually:
+  npm install -D mocha chai sinon proxyquire
 
-Updated scripts:
-  npm test        - runs both
-  npm run test:new - runs mocha only
-  npm run test:legacy - runs jest only
+Then run /tlc:config again.
 ```
 
 ## Notes
 
-- TLC defaults to mocha for consistency across projects
-- Multiple frameworks can coexist when inheriting codebases
-- Use `run` array to control which frameworks execute
-- The `primary` framework is used for new test generation
+- Never show JSON to beginners
+- Always provide numbered choices
+- Auto-detect as much as possible
+- Install packages automatically
+- Provide sensible defaults
+- Explain what each choice means in plain English

package/help.md

@@ -61,6 +61,7 @@ Launches the visual dashboard. Detects where you are, shows what's next.
 | `/tlc:new-milestone` | Start next version |
 | `/tlc:bug` | Log a bug or feedback |
 | `/tlc:server` | Start dashboard server for QA |
+| `/tlc:update` | Update TLC to latest version |
 
 ### Multi-User Collaboration
 

package/package.json

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

package/update.md

@@ -0,0 +1,132 @@
+# /tlc:update - Update TLC
+
+Update TLC to the latest version.
+
+## Usage
+
+```
+/tlc:update
+```
+
+## Process
+
+### Step 1: Check Current Version
+
+```
+═══════════════════════════════════════════════════════════════
+TLC Update
+═══════════════════════════════════════════════════════════════
+
+Current version: v1.2.20
+Checking for updates...
+```
+
+### Step 2: Check for Updates
+
+```bash
+# Get latest version from npm
+latestVersion=$(npm show tlc-claude-code version)
+currentVersion=$(cat ~/.claude/commands/tlc/package.json | jq -r '.version')
+
+if [ "$latestVersion" = "$currentVersion" ]; then
+  echo "✓ You're on the latest version (v$currentVersion)"
+  exit 0
+fi
+```
+
+### Step 3: Show What's New
+
+```
+New version available: v1.2.21
+
+What's new:
+  • Setup wizard - no more JSON editing
+  • GitHub Desktop recommended for beginners
+  • Fixed wiki links
+
+Update now? [Y/n]: _
+```
+
+### Step 4: Update
+
+```
+Updating TLC...
+
+npx tlc-claude-code@latest --global
+
+✓ Updated to v1.2.21
+
+Restart Claude Code to load the new commands.
+```
+
+### Step 5: Show Changes (Optional)
+
+If user wants to see full changelog:
+
+```
+Show full changelog? [y/N]: _
+```
+
+If yes, fetch and display:
+```
+v1.2.21 (2024-01-30)
+  • Setup wizard for configuration
+  • Beginner-friendly docs
+
+v1.2.20 (2024-01-30)
+  • Fixed wiki link format
+
+v1.2.19 (2024-01-30)
+  • GitHub Desktop in noob guide
+```
+
+## Auto-Update Check
+
+When running `/tlc`, check for updates in background:
+
+```bash
+# Silent check (don't block)
+latestVersion=$(npm show tlc-claude-code version 2>/dev/null)
+
+if [ "$latestVersion" != "$currentVersion" ]; then
+  echo "💡 TLC update available: v$latestVersion (you have v$currentVersion)"
+  echo "   Run /tlc:update to upgrade"
+fi
+```
+
+## Force Update
+
+Skip confirmation:
+
+```
+/tlc:update --yes
+```
+
+## Specific Version
+
+Install a specific version:
+
+```
+/tlc:update --version 1.2.15
+```
+
+## Offline / No Update
+
+```
+═══════════════════════════════════════════════════════════════
+TLC Update
+═══════════════════════════════════════════════════════════════
+
+Current version: v1.2.20
+
+⚠️ Couldn't check for updates (offline or npm unreachable)
+
+To update manually:
+  npx tlc-claude-code@latest --global
+```
+
+## Notes
+
+- Updates install globally via npm
+- Requires restart of Claude Code to load new commands
+- Check npm for latest: https://www.npmjs.com/package/tlc-claude-code