tlc-claude-code 0.8.8 → 0.9.1

package/README.md

@@ -172,8 +172,6 @@ tlc rebuild      # After package.json changes or to get a clean slate
 
 **Requirements:** [Docker Desktop](https://www.docker.com/products/docker-desktop)
 
-> **Note:** Windows only for now. macOS/Linux support coming soon.
-
 ---
 
 ## Test Quality

package/bin/init.js

@@ -57,7 +57,7 @@ powershell -ExecutionPolicy Bypass -File "%TLC_DIR%\\start-dev.ps1" -ProjectPath
 pause
 `;
 
-// macOS/Linux shell script (placeholder for future)
+// macOS/Linux shell script
 const shContent = `#!/bin/bash
 # ========================================
 # TLC Dev Server Launcher
@@ -68,15 +68,48 @@ const shContent = `#!/bin/bash
 # Database:  localhost:5433
 # ========================================
 
-echo "[TLC] macOS/Linux support coming soon!"
-echo "[TLC] For now, run manually:"
-echo ""
-echo "  export PROJECT_DIR=\\$(pwd)"
-echo "  export COMPOSE_PROJECT_NAME=\\$(basename \\$(pwd) | tr -cd 'a-z0-9')"
-echo "  docker-compose -f /path/to/TLC/docker-compose.dev.yml up"
+set -e
+
+# Find TLC installation
+TLC_DIR=""
+LOCATIONS=(
+    "$HOME/.nvm/versions/node/*/lib/node_modules/tlc-claude-code"
+    "/usr/local/lib/node_modules/tlc-claude-code"
+    "/usr/lib/node_modules/tlc-claude-code"
+    "$HOME/.npm-global/lib/node_modules/tlc-claude-code"
+)
+
+# Check npm global
+NPM_ROOT=$(npm root -g 2>/dev/null || echo "")
+if [ -n "$NPM_ROOT" ] && [ -f "$NPM_ROOT/tlc-claude-code/start-dev.sh" ]; then
+    TLC_DIR="$NPM_ROOT/tlc-claude-code"
+fi
+
+# Check common locations
+if [ -z "$TLC_DIR" ]; then
+    for pattern in "\${LOCATIONS[@]}"; do
+        for dir in $pattern; do
+            if [ -f "$dir/start-dev.sh" ]; then
+                TLC_DIR="$dir"
+                break 2
+            fi
+        done
+    done
+fi
+
+if [ -z "$TLC_DIR" ]; then
+    echo "[TLC] ERROR: Could not find TLC installation"
+    echo "[TLC] Install with: npm install -g tlc-claude-code"
+    exit 1
+fi
+
+PROJECT_PATH="$(cd "$(dirname "\${BASH_SOURCE[0]}")" && pwd)"
+
+echo "[TLC] Found TLC at: $TLC_DIR"
+echo "[TLC] Starting dev server for: $PROJECT_PATH"
 echo ""
 
-# TODO: Implement full macOS/Linux support
+exec "$TLC_DIR/start-dev.sh" "$PROJECT_PATH"
 `;
 
 // Detect OS - WSL counts as Windows since user will double-click .bat from Explorer

package/docker-compose.dev.yml

@@ -79,5 +79,21 @@ services:
       - app
     restart: on-failure
 
+  # Playwright E2E Tests (optional - starts on demand)
+  playwright:
+    image: mcr.microsoft.com/playwright:v1.40.0-jammy
+    container_name: tlc-${COMPOSE_PROJECT_NAME:-dev}-playwright
+    working_dir: /app
+    profiles:
+      - test
+    command: npx playwright test
+    environment:
+      - BASE_URL=http://app:5000
+      - CI=true
+    volumes:
+      - ${PROJECT_DIR:-.}:/app
+    depends_on:
+      - app
+
 volumes:
   postgres-data:

package/package.json

@@ -1,15 +1,10 @@
 {
   "name": "tlc-claude-code",
-  "version": "0.8.8",
+  "version": "0.9.1",
   "description": "TLC - Test Led Coding for Claude Code",
   "bin": {
     "tlc": "./bin/tlc.js",
-    "tlc-claude-code": "./bin/install.js",
-    "tlc-dashboard": "./dashboard/dist/index.js",
-    "tlc-server": "./bin/server.js",
-    "tlc-setup": "./bin/setup.js",
-    "tlc-init": "./bin/init.js",
-    "tlc-rebuild": "./bin/rebuild.js"
+    "tlc-claude-code": "./bin/install.js"
   },
   "files": [
     "bin/",
@@ -18,6 +13,7 @@
     "server/",
     "docker-compose.dev.yml",
     "start-dev.ps1",
+    "start-dev.sh",
     "start-dev.bat",
     "*.md",
     "install.sh"

package/server/index.js

@@ -211,6 +211,7 @@ app.get('/api/status', (req, res) => {
     appPort,
     testsPass: plan.testsPass || 0,
     testsFail: plan.testsFail || 0,
+    tasks: plan.tasks?.length || 0,
     bugsOpen: bugs.filter(b => b.status === 'open').length,
     phase: plan.currentPhase,
     phaseName: plan.currentPhaseName
@@ -235,6 +236,123 @@ app.get('/api/tasks', (req, res) => {
   });
 });
 
+// Plan content endpoint
+app.get('/api/plan', (req, res) => {
+  const plan = parsePlan(PROJECT_DIR);
+  let content = '';
+
+  // Try to read current phase plan file
+  const phasesDir = path.join(PROJECT_DIR, '.planning', 'phases');
+  if (plan.currentPhase && fs.existsSync(phasesDir)) {
+    const planFile = path.join(phasesDir, `${plan.currentPhase}-PLAN.md`);
+    if (fs.existsSync(planFile)) {
+      content = fs.readFileSync(planFile, 'utf-8');
+    }
+  }
+
+  // Fallback to ROADMAP.md
+  if (!content) {
+    const roadmapFile = path.join(PROJECT_DIR, '.planning', 'ROADMAP.md');
+    if (fs.existsSync(roadmapFile)) {
+      content = fs.readFileSync(roadmapFile, 'utf-8');
+    }
+  }
+
+  res.json({
+    phase: plan.currentPhase,
+    phaseName: plan.currentPhaseName,
+    content
+  });
+});
+
+// Test checklist endpoint
+app.get('/api/tests', (req, res) => {
+  const plan = parsePlan(PROJECT_DIR);
+  let items = [];
+
+  // Try to read TESTS.md for current phase
+  const phasesDir = path.join(PROJECT_DIR, '.planning', 'phases');
+  if (plan.currentPhase && fs.existsSync(phasesDir)) {
+    const testsFile = path.join(phasesDir, `${plan.currentPhase}-TESTS.md`);
+    if (fs.existsSync(testsFile)) {
+      const content = fs.readFileSync(testsFile, 'utf-8');
+      // Parse checkboxes
+      const lines = content.split('\n');
+      for (const line of lines) {
+        const match = line.match(/^[-*]\s*\[([ x])\]\s*(.+)$/i);
+        if (match) {
+          items.push({
+            checked: match[1].toLowerCase() === 'x',
+            text: match[2].trim()
+          });
+        }
+      }
+    }
+  }
+
+  res.json({ items });
+});
+
+// Bugs list endpoint
+app.get('/api/bugs', (req, res) => {
+  const bugs = parseBugs(PROJECT_DIR);
+  res.json(bugs);
+});
+
+// Changelog endpoint
+app.get('/api/changelog', (req, res) => {
+  try {
+    const { execSync } = require('child_process');
+    const output = execSync('git log --oneline -20 --pretty=format:"%h|%s|%an|%ar"', {
+      cwd: PROJECT_DIR,
+      encoding: 'utf-8'
+    });
+
+    const commits = output.trim().split('\n').filter(Boolean).map(line => {
+      const [hash, message, author, date] = line.split('|');
+      return { hash, message, author, date };
+    });
+
+    res.json({ commits });
+  } catch (e) {
+    res.json({ commits: [] });
+  }
+});
+
+// Playwright endpoint
+app.post('/api/playwright', (req, res) => {
+  addLog('test', '--- Running Playwright tests ---', 'info');
+
+  const testProcess = spawn('npx', ['playwright', 'test'], {
+    cwd: PROJECT_DIR,
+    env: { ...process.env, CI: 'true' },
+    shell: true
+  });
+
+  testProcess.stdout.on('data', (data) => {
+    const text = data.toString().trim();
+    if (text) {
+      broadcast('test-output', { data: text, stream: 'stdout' });
+      addLog('test', text);
+    }
+  });
+
+  testProcess.stderr.on('data', (data) => {
+    const text = data.toString().trim();
+    if (text) {
+      broadcast('test-output', { data: text, stream: 'stderr' });
+      addLog('test', text, 'error');
+    }
+  });
+
+  testProcess.on('exit', (code) => {
+    broadcast('test-complete', { exitCode: code });
+    addLog('test', `Playwright ${code === 0 ? 'passed' : 'failed'}`, code === 0 ? 'success' : 'error');
+  });
+
+  res.json({ success: true });
+});
+
 app.post('/api/bug', (req, res) => {
   const { description, url, screenshot, severity } = req.body;
 

package/start-dev.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+
+# TLC Dev Server Launcher
+# Usage: ./start-dev.sh [project-path]
+
+set -e
+
+PROJECT_PATH="${1:-$(pwd)}"
+
+echo ""
+echo "  ============================"
+echo "       TLC Dev Server"
+echo "  ============================"
+echo ""
+
+# Check Docker
+echo "[TLC] Checking Docker..."
+if ! docker info >/dev/null 2>&1; then
+    echo "[TLC] Docker is not running."
+
+    # Try to start Docker based on OS
+    if [[ "$OSTYPE" == "darwin"* ]]; then
+        echo "[TLC] Starting Docker Desktop..."
+        open -a Docker
+    elif [[ -f /etc/debian_version ]] || [[ -f /etc/redhat-release ]]; then
+        echo "[TLC] Starting Docker service..."
+        sudo systemctl start docker 2>/dev/null || sudo service docker start 2>/dev/null || true
+    fi
+
+    echo "[TLC] Waiting for Docker..."
+    TIMEOUT=60
+    ELAPSED=0
+    while [ $ELAPSED -lt $TIMEOUT ]; do
+        sleep 2
+        ELAPSED=$((ELAPSED + 2))
+        if docker info >/dev/null 2>&1; then
+            break
+        fi
+        printf "."
+    done
+    echo ""
+
+    if ! docker info >/dev/null 2>&1; then
+        echo "[TLC] ERROR: Docker failed to start"
+        echo "[TLC] Please start Docker manually and try again"
+        exit 1
+    fi
+fi
+
+echo "[TLC] Docker is ready!"
+
+# Resolve project path
+PROJECT_PATH="$(cd "$PROJECT_PATH" 2>/dev/null && pwd)"
+if [ -z "$PROJECT_PATH" ]; then
+    echo "[TLC] ERROR: Invalid project path"
+    exit 1
+fi
+
+# Get project name from directory
+PROJECT_NAME=$(basename "$PROJECT_PATH" | tr '[:upper:]' '[:lower:]' | tr -cd 'a-z0-9')
+if [ -z "$PROJECT_NAME" ]; then
+    PROJECT_NAME="dev"
+fi
+
+echo "[TLC] Project: $PROJECT_PATH"
+echo "[TLC] Name:    $PROJECT_NAME"
+
+# Set environment
+export PROJECT_DIR="$PROJECT_PATH"
+export COMPOSE_PROJECT_NAME="$PROJECT_NAME"
+
+# Find TLC installation directory
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+cd "$SCRIPT_DIR"
+
+echo ""
+echo "[TLC] Starting services..."
+echo "      Dashboard: http://localhost:3147"
+echo "      App:       http://localhost:5000"
+echo "      DB Admin:  http://localhost:8080"
+echo "      Database:  localhost:5433 (postgres/postgres)"
+echo ""
+echo "[TLC] Containers: tlc-$PROJECT_NAME-*"
+echo "[TLC] Press Ctrl+C to stop"
+echo ""
+
+# Run docker-compose
+docker-compose -f docker-compose.dev.yml up --build
+
+echo ""
+echo "[TLC] Stopped."