tlc-claude-code 1.5.3 → 1.5.4

package/.claude/commands/tlc/checklist.md

@@ -0,0 +1,212 @@
+# /tlc:checklist - Full Project Checklist
+
+**TLC v1.4.9**
+
+Shows the complete project status across all phases with best practices checklist.
+
+## What This Does
+
+Displays a comprehensive view of:
+1. Project setup status
+2. All phases with workflow completion
+3. Skipped steps across the project
+4. Quality metrics summary
+5. Recommended actions
+
+## Output Format
+
+```
+TLC v1.4.9                                         Project Checklist
+═══════════════════════════════════════════════════════════════════════════
+
+PROJECT SETUP
+─────────────────────────────────────────────────────────────────────────────
+  [x] PROJECT.md exists
+  [x] .tlc.json configured
+  [x] Git repository initialized
+  [x] Main branch: main
+
+  Test Infrastructure:
+  [x] Unit test framework: mocha
+  [x] E2E framework: playwright
+  [ ] CI/CD configured
+
+  Quality Gates:
+  [x] Coverage threshold: 80%
+  [x] Quality score threshold: 75
+
+═══════════════════════════════════════════════════════════════════════════
+
+PHASE OVERVIEW
+─────────────────────────────────────────────────────────────────────────────
+
+  Phase 1: Authentication                              [COMPLETE] ✓
+  ─────────────────────────────────────────────────────
+  [x] Discussed    [x] Planned    [x] Unit Tests
+  [x] E2E Tests    [x] Implemented [x] Verified
+
+  Phase 2: User Dashboard                              [IN PROGRESS]
+  ─────────────────────────────────────────────────────
+  [x] Discussed    [x] Planned    [ ] Unit Tests
+  [ ] E2E Tests    [ ] Implemented [ ] Verified
+
+  ⚠️  Skipped: E2E scenarios not in plan
+
+  Phase 3: Reports                                     [PENDING]
+  ─────────────────────────────────────────────────────
+  [ ] Discussed    [ ] Planned    [ ] Unit Tests
+  [ ] E2E Tests    [ ] Implemented [ ] Verified
+
+  Phase 4: Admin Panel                                 [PENDING]
+  ─────────────────────────────────────────────────────
+  [ ] Discussed    [ ] Planned    [ ] Unit Tests
+  [ ] E2E Tests    [ ] Implemented [ ] Verified
+
+═══════════════════════════════════════════════════════════════════════════
+
+QUALITY SUMMARY
+─────────────────────────────────────────────────────────────────────────────
+
+  Test Coverage:
+  ──────────────
+  Overall: 72% (target: 80%)  ⚠️ BELOW TARGET
+
+  Phase 1: 89% ✓
+  Phase 2: 45% ⚠️
+  Phase 3: --
+  Phase 4: --
+
+  Test Counts:
+  ────────────
+  Unit tests:  47 passing, 0 failing
+  E2E tests:   12 passing, 0 failing
+
+  Quality Score: 78/100 (target: 75) ✓
+
+═══════════════════════════════════════════════════════════════════════════
+
+SKIPPED STEPS (ACTION NEEDED)
+─────────────────────────────────────────────────────────────────────────────
+
+  1. Phase 2: No E2E scenarios defined
+     → Add E2E section to .planning/phases/2-PLAN.md
+
+  2. Phase 2: Coverage below threshold (45%)
+     → Run /tlc:coverage to identify gaps
+
+  3. Project: No CI/CD configured
+     → Run /tlc:ci to generate pipeline
+
+═══════════════════════════════════════════════════════════════════════════
+
+RECOMMENDED WORKFLOW
+─────────────────────────────────────────────────────────────────────────────
+
+  For each phase, follow this order:
+
+  1. /tlc:discuss    Shape the implementation approach
+  2. /tlc:plan       Break into tasks with test cases + E2E scenarios
+  3. /tlc:build      Write tests → implement → run E2E
+  4. /tlc:verify     Human acceptance testing
+  5. /tlc:coverage   Check test coverage meets threshold
+
+  Before release:
+  6. /tlc:quality    Ensure quality score meets threshold
+  7. /tlc:complete   Tag release
+
+═══════════════════════════════════════════════════════════════════════════
+
+Quick Actions:
+  [1] Continue current phase  → /tlc
+  [2] Fix skipped steps       → Shows fix menu
+  [3] Run coverage check      → /tlc:coverage
+  [4] Show all commands       → /tlc:help
+
+Choice [1/2/3/4]: _
+```
+
+## Process
+
+### Step 1: Load Project Config
+
+```bash
+# Read .tlc.json
+config=$(cat .tlc.json)
+
+# Extract settings
+unitFramework=$(echo $config | jq -r '.testFrameworks.primary // "not configured"')
+e2eFramework=$(echo $config | jq -r '.e2e.framework // "not configured"')
+coverageThreshold=$(echo $config | jq -r '.quality.coverageThreshold // 80')
+qualityThreshold=$(echo $config | jq -r '.quality.qualityScoreThreshold // 75')
+mainBranch=$(echo $config | jq -r '.git.mainBranch // "main"')
+```
+
+### Step 2: Scan All Phases
+
+```bash
+# Parse ROADMAP.md for all phases
+phases=$(grep -E '^\s*-\s*\[' .planning/ROADMAP.md)
+
+# For each phase, check artifacts
+for phase in 1 2 3 4 5; do
+  discussion=".planning/phases/${phase}-DISCUSSION.md"
+  plan=".planning/phases/${phase}-PLAN.md"
+  tests=".planning/phases/${phase}-TESTS.md"
+  e2e="tests/e2e/phase-${phase}.spec.ts"
+  verified=".planning/phases/${phase}-VERIFIED.md"
+
+  # Check existence
+  [ -f "$discussion" ] && discussed="[x]" || discussed="[ ]"
+  [ -f "$plan" ] && planned="[x]" || planned="[ ]"
+  # ... etc
+done
+```
+
+### Step 3: Collect Skipped Steps
+
+Build list of all skipped/missing steps across project:
+
+```
+Skipped Step Categories:
+─────────────────────────
+
+1. Missing artifacts (DISCUSSION.md, PLAN.md, etc.)
+2. E2E scenarios not defined in plans
+3. Coverage below threshold
+4. Quality score below threshold
+5. CI/CD not configured
+6. Phases not verified
+7. Tests written after code (detected by commit order)
+```
+
+### Step 4: Calculate Quality Metrics
+
+```bash
+# Run test coverage
+npm run test:coverage 2>/dev/null
+
+# Parse coverage report
+coverage=$(cat coverage/coverage-summary.json | jq '.total.lines.pct')
+
+# Run quality scorer
+qualityScore=$(node -e "require('./server/lib/quality-scorer').score()" 2>/dev/null)
+```
+
+### Step 5: Display and Prompt
+
+Show the full checklist and offer actions.
+
+## Usage
+
+```
+/tlc:checklist
+```
+
+No arguments. Shows complete project status.
+
+## When to Use
+
+- Starting a work session (see overall status)
+- Before release (ensure nothing skipped)
+- Onboarding new team member (show project health)
+- Sprint planning (identify gaps to address)

package/.claude/commands/tlc/ci.md

@@ -0,0 +1,414 @@
+# /tlc:ci - CI/CD Integration
+
+Generate CI/CD pipeline configuration for your TLC project.
+
+## Usage
+
+```
+/tlc:ci [provider]
+```
+
+Providers: `github`, `gitlab`, `bitbucket`, `azure`, `circle`
+
+If no provider specified, auto-detects from git remote.
+
+## What This Does
+
+1. Detects your CI/CD platform from git remote
+2. Generates appropriate config file
+3. Includes test-first validation
+4. Adds regression test gates
+
+## GitHub Actions
+
+Creates `.github/workflows/tlc.yml`:
+
+```yaml
+name: TLC Pipeline
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Run tests
+        run: npm test
+
+      - name: Upload coverage
+        uses: codecov/codecov-action@v4
+        if: always()
+
+  lint:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+      - run: npm ci
+      - run: npm run lint
+
+  regression:
+    runs-on: ubuntu-latest
+    needs: [test]
+    if: github.event_name == 'pull_request'
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - run: npm ci
+
+      - name: Check for untested code
+        run: |
+          # Get changed files
+          CHANGED=$(git diff --name-only origin/main...HEAD | grep -E '\.(ts|js|tsx|jsx)$' | grep -v '\.test\.' || true)
+
+          if [ -n "$CHANGED" ]; then
+            echo "Changed source files:"
+            echo "$CHANGED"
+
+            # Check each has corresponding test
+            for file in $CHANGED; do
+              testfile="${file%.*}.test.${file##*.}"
+              if [ ! -f "$testfile" ]; then
+                echo "::warning file=$file::No test file found for $file"
+              fi
+            done
+          fi
+
+      - name: Run regression tests
+        run: npm test -- --coverage
+
+      - name: Coverage diff
+        run: |
+          # Compare coverage with base branch
+          echo "Coverage report generated"
+```
+
+## GitLab CI
+
+Creates `.gitlab-ci.yml`:
+
+```yaml
+stages:
+  - test
+  - regression
+
+default:
+  image: node:20
+  cache:
+    paths:
+      - node_modules/
+
+test:
+  stage: test
+  script:
+    - npm ci
+    - npm test
+  coverage: '/Lines\s*:\s*(\d+\.?\d*)%/'
+  artifacts:
+    reports:
+      coverage_report:
+        coverage_format: cobertura
+        path: coverage/cobertura-coverage.xml
+
+lint:
+  stage: test
+  script:
+    - npm ci
+    - npm run lint
+  allow_failure: true
+
+regression:
+  stage: regression
+  only:
+    - merge_requests
+  script:
+    - npm ci
+    - |
+      CHANGED=$(git diff --name-only $CI_MERGE_REQUEST_DIFF_BASE_SHA...HEAD | grep -E '\.(ts|js)$' | grep -v '\.test\.' || true)
+      if [ -n "$CHANGED" ]; then
+        echo "Checking tests for changed files..."
+        for file in $CHANGED; do
+          testfile="${file%.*}.test.${file##*.}"
+          if [ ! -f "$testfile" ]; then
+            echo "WARNING: No test file for $file"
+          fi
+        done
+      fi
+    - npm test -- --coverage
+```
+
+## Bitbucket Pipelines
+
+Creates `bitbucket-pipelines.yml`:
+
+```yaml
+image: node:20
+
+definitions:
+  caches:
+    npm: ~/.npm
+
+pipelines:
+  default:
+    - step:
+        name: Test
+        caches:
+          - npm
+        script:
+          - npm ci
+          - npm test
+
+  pull-requests:
+    '**':
+      - step:
+          name: Test
+          caches:
+            - npm
+          script:
+            - npm ci
+            - npm test
+      - step:
+          name: Regression Check
+          caches:
+            - npm
+          script:
+            - npm ci
+            - npm test -- --coverage
+```
+
+## Azure Pipelines
+
+Creates `azure-pipelines.yml`:
+
+```yaml
+trigger:
+  - main
+  - develop
+
+pool:
+  vmImage: 'ubuntu-latest'
+
+stages:
+  - stage: Test
+    jobs:
+      - job: Test
+        steps:
+          - task: NodeTool@0
+            inputs:
+              versionSpec: '20.x'
+
+          - script: npm ci
+            displayName: Install dependencies
+
+          - script: npm test
+            displayName: Run tests
+
+          - task: PublishCodeCoverageResults@2
+            inputs:
+              summaryFileLocation: '$(System.DefaultWorkingDirectory)/coverage/cobertura-coverage.xml'
+
+  - stage: Regression
+    condition: eq(variables['Build.Reason'], 'PullRequest')
+    jobs:
+      - job: Regression
+        steps:
+          - task: NodeTool@0
+            inputs:
+              versionSpec: '20.x'
+          - script: npm ci
+          - script: npm test -- --coverage
+            displayName: Regression tests
+```
+
+## CircleCI
+
+Creates `.circleci/config.yml`:
+
+```yaml
+version: 2.1
+
+executors:
+  node:
+    docker:
+      - image: cimg/node:20.0
+
+jobs:
+  test:
+    executor: node
+    steps:
+      - checkout
+      - restore_cache:
+          keys:
+            - npm-{{ checksum "package-lock.json" }}
+      - run: npm ci
+      - save_cache:
+          paths:
+            - node_modules
+          key: npm-{{ checksum "package-lock.json" }}
+      - run: npm test
+      - store_test_results:
+          path: test-results
+      - store_artifacts:
+          path: coverage
+
+  regression:
+    executor: node
+    steps:
+      - checkout
+      - restore_cache:
+          keys:
+            - npm-{{ checksum "package-lock.json" }}
+      - run: npm ci
+      - run:
+          name: Check for untested code
+          command: |
+            CHANGED=$(git diff --name-only origin/main...HEAD | grep -E '\.(ts|js)$' | grep -v '\.test\.' || true)
+            if [ -n "$CHANGED" ]; then
+              echo "Changed files: $CHANGED"
+            fi
+      - run: npm test -- --coverage
+
+workflows:
+  test-and-deploy:
+    jobs:
+      - test
+      - regression:
+          filters:
+            branches:
+              ignore: main
+```
+
+## Regression Test Features
+
+### Automatic Detection
+
+The CI config includes regression checks that:
+
+1. **Identify changed files** in the PR/MR
+2. **Verify test coverage** for changed files
+3. **Run full test suite** to catch regressions
+4. **Report coverage diff** vs base branch
+
+### Configuring Regression Behavior
+
+In `.tlc.json`:
+
+```json
+{
+  "ci": {
+    "requireTestsForNewFiles": true,
+    "coverageThreshold": 80,
+    "failOnCoverageDecrease": true,
+    "regressionOnPR": true
+  }
+}
+```
+
+### Coverage Requirements
+
+Set minimum coverage in `package.json`:
+
+```json
+{
+  "jest": {
+    "coverageThreshold": {
+      "global": {
+        "branches": 80,
+        "functions": 80,
+        "lines": 80,
+        "statements": 80
+      }
+    }
+  }
+}
+```
+
+Or for mocha with nyc:
+
+```json
+{
+  "nyc": {
+    "check-coverage": true,
+    "lines": 80,
+    "functions": 80,
+    "branches": 80
+  }
+}
+```
+
+## Import/Merge Regression
+
+When importing external code (`/tlc:import-project`), automatically run regression:
+
+```
+> /tlc:import-project ../legacy-api
+
+Importing legacy-api...
+
+Found 47 source files without tests.
+
+Running regression tests on merge...
+  ✓ 23 existing tests pass
+  ⚠ 12 new files need tests
+
+Create tasks for missing tests? (Y/n)
+```
+
+## Example Session
+
+```
+> /tlc:ci
+
+Detecting CI/CD platform...
+  Remote: git@github.com:acme/myproject.git
+  Platform: GitHub
+
+Generating .github/workflows/tlc.yml...
+
+Created CI pipeline with:
+  ✓ Test job (runs on all pushes)
+  ✓ Lint job (runs on all pushes)
+  ✓ Regression job (runs on PRs)
+  ✓ Coverage reporting (Codecov)
+
+Commit this file? (Y/n) y
+
+Committed: ci: add TLC GitHub Actions pipeline
+
+Next steps:
+  1. Push to GitHub
+  2. Add CODECOV_TOKEN secret (optional)
+  3. PRs will now require passing tests
+```
+
+## Notes
+
+- CI config respects `.tlc.json` settings
+- Coverage thresholds match project config
+- Regression checks are PR-only by default
+- Use `/tlc:ci --dry-run` to preview without creating files