docs: Consolidate documentation and update all folder references

- Remove CONTRIBUTING.md (merged into README-for-developers.md)
- Add "Getting Started" section to README-for-developers.md
- Update all references: comparison-test-harness → tests/comparison
- Update all references: src/test → tests/unit
- Update all references: manual-test-cases → tests/manual
- Update project structure diagram
- Rename package from "comparison-test-harness" to "comparison-tests"
- Update .vscodeignore to use tests/** pattern

Author: JohannesHoppe

.github/workflows/test.yml

@@ -37,7 +37,7 @@ jobs:
         if: runner.os != 'Linux'
         run: npm test
 
-      - name: Install comparison test harness dependencies
+      - name: Install comparison tests dependencies
         run: npm install
         working-directory: ./tests/comparison
 

.vscodeignore

@@ -19,8 +19,7 @@ esbuild.js
 .yarnrc
 
 # Test infrastructure (DO NOT SHIP)
-comparison-test-harness/**
-manual-test-cases/**
+tests/**
 
 # Documentation - exclude all .md and .txt files EXCEPT user-facing docs
 **/*.md

CLAUDE.md

@@ -11,7 +11,7 @@
 
 **Terminology**:
 - **Old extension** = Original "TypeScript Hero" by Christoph Bühler (deprecated, uses typescript-parser)
-  - Included as git submodule at `comparison-test-harness/old-typescript-hero/`
+  - Included as git submodule at `tests/comparison/old-typescript-hero/`
   - Used by comparison tests to verify backward compatibility
 - **New extension** = This project "Mini TypeScript Hero" (modern, uses ts-morph)
 
@@ -123,7 +123,7 @@ const result = await organizeImports(input, config);
 assert.equal(result, expected, 'Must produce correct output');  // ✅ Validates correctness!
 ```
 
-**For Comparison Tests (test harness):**
+**For Comparison Tests:**
 ```typescript
 // CORRECT - Validates BOTH extensions against known-good expected output
 const input = `...source code...`;
@@ -263,7 +263,7 @@ The `tests/workspaces` folder MUST be excluded from TypeScript compilation:
 
 ## 🔧 Two Test Environments
 
-### 1. General Extension Tests (`src/test/`)
+### 1. General Extension Tests (`tests/unit/`)
 
 **Purpose**: Ensure the new extension has high reliability and catches all known bugs
 
@@ -329,7 +329,7 @@ The `activationEvents` array is **required and correct**:
 
 ---
 
-### 2. Test Harness Tests (`comparison-test-harness/`)
+### 2. Comparison Tests (`tests/comparison/`)
 
 **Purpose**: Validate backward compatibility between old and new extension
 
@@ -506,8 +506,8 @@ TypeScript 3.8+ `import type` syntax affects runtime semantics and bundling. Con
 # Main extension tests
 npm test
 
-# Comparison test harness
-cd comparison-test-harness
+# Comparison tests
+cd tests/comparison
 npm test
 
 # Watch mode (during development)
@@ -546,7 +546,7 @@ and of the old typescript hero
 
 ```
 gitingest -e "*node_modules*,*vscode-test*,*.js,*logo*,*old-typescript*,*package*,CLAUDE*,*logo*,.claude,*.DS_Store*,digest.txt,*out*" ./
-cd comparison-test-harness/old-typescript-hero && gitingest -e "*node_modules*,*vscode-test*,*.DS_Store*,digest.txt" ./ && cd ../..
+cd tests/comparison/old-typescript-hero && gitingest -e "*node_modules*,*vscode-test*,*.DS_Store*,digest.txt" ./ && cd ../../..
 {
   echo "*** MINI TYPESCRIPT HERO FOLDER CONTENT ***"
   echo ""
@@ -555,6 +555,6 @@ cd comparison-test-harness/old-typescript-hero && gitingest -e "*node_modules*,*
   echo ""
   echo "*** OLD TYPESCRIPT HERO FOLDER CONTENT ***"
   echo ""
-  cat comparison-test-harness/old-typescript-hero/digest.txt
+  cat tests/comparison/old-typescript-hero/digest.txt
 } > digest-combined.txt && mv digest-combined.txt digest.txt
 ```

CONTRIBUTING.md

@@ -2,6 +2,23 @@
 
 This guide is for developers working on the Mini TypeScript Hero extension.
 
+## Getting Started
+
+```bash
+# Clone the repository
+git clone https://github.com/angular-schule/mini-typescript-hero.git
+cd mini-typescript-hero
+
+# Install dependencies
+npm install
+
+# Compile and watch for changes
+npm run watch
+
+# Run tests
+npm test
+```
+
 ## Running Unit Tests
 
 ### Run Tests
@@ -18,8 +35,8 @@ This will:
 **Note:** These are integration tests that run in a real VS Code environment with the full TypeScript/JavaScript language server. Tests use real file I/O (temp files in `os.tmpdir()`), real VS Code APIs (`workspace.openTextDocument`, `workspace.applyEdit`), and real ts-morph parsing. This makes them slower than unit tests but ensures accurate testing of the actual user experience.
 
 - Tests run on: Ubuntu, macOS, Windows (via GitHub Actions)
-- Main extension tests location: `src/test/`
-- Comparison tests location: `comparison-test-harness/test-cases/`
+- Main extension tests location: `tests/unit/`
+- Comparison tests location: `tests/comparison/test-cases/`
 
 ## Manual Testing
 
@@ -33,7 +50,7 @@ This will:
 
 ### Manual Test Cases
 
-The `manual-test-cases/` folder contains 10 test scenarios:
+The `tests/manual/` folder contains 10 test scenarios:
 
 #### Case 01: Basic Unused Imports (`case01-basic-unused-imports.ts`)
 **Tests:** Basic unused import removal
@@ -88,7 +105,7 @@ The `manual-test-cases/` folder contains 10 test scenarios:
 ### Testing Workflow
 
 1. Open Extension Development Host (F5)
-2. Open a test case file from `manual-test-cases/`
+2. Open a test case file from `tests/manual/`
 3. Press `Ctrl+Alt+O` (or `Cmd+Alt+O`)
 4. Verify:
    - ✅ Unused imports are removed
@@ -168,13 +185,14 @@ mini-typescript-hero/
 │   │   ├── import-organizer.ts # VSCode integration
 │   │   ├── import-types.ts     # Import representations
 │   │   └── import-utilities.ts # Sorting/precedence
-│   ├── test/                   # Unit tests
-│   │   ├── configuration/      # Migration tests
-│   │   └── imports/            # Import logic tests
 │   └── extension.ts            # Extension entry point
-├── manual-test-cases/          # Manual testing scenarios
-│   ├── case01-*.ts             # Test case files
-│   └── helpers/                # Mock modules
+├── tests/
+│   ├── unit/                   # Main extension tests
+│   ├── comparison/             # Old vs new extension comparison
+│   ├── manual/                 # Manual testing scenarios
+│   │   ├── case01-*.ts         # Test case files
+│   │   └── helpers/            # Mock modules
+│   └── workspaces/             # Pre-configured test workspaces
 ├── package.json                # Extension manifest
 ├── tsconfig.json               # TypeScript config
 └── esbuild.js                  # Build configuration
@@ -208,7 +226,7 @@ mini-typescript-hero/
 ### TypeScript Configuration
 
 - **Extension runtime** (`src/`): Compiled with `strict: true`, `noUnusedLocals: true`
-- **Comparison test harness** (`comparison-test-harness/`): Uses relaxed `tsconfig.json` with `strict: false` so we can compile the original TypeScript Hero code without rewriting it
+- **Comparison tests** (`tests/comparison/`): Uses relaxed `tsconfig.json` with `strict: false` so we can compile the original TypeScript Hero code without rewriting it
 - **Manual test cases**: Simple demonstration files, may use `any` for clarity
 
 ## Debugging

README-for-developers.md

@@ -264,7 +264,7 @@ Original work Copyright (c) Christoph Bühler
 
 - [Configuration Reference](README-configuration.md) — Complete settings documentation
 - [Migration Guide](README-migration.md) — Migrating from TypeScript Hero
-- [Contributing](CONTRIBUTING.md) — Development setup and debugging
+- [Developer Guide](README-for-developers.md) — Development setup, debugging, and contributing
 - [Report Issues](https://github.com/angular-schule/mini-typescript-hero/issues)
 - [Request Features](https://github.com/angular-schule/mini-typescript-hero/issues)
 

README.md

@@ -3,7 +3,7 @@ import { defineConfig } from '@vscode/test-cli';
 export default defineConfig({
 	files: 'out/tests/comparison/test-cases/**/*.test.js',
 	// Use shorter user-data-dir to avoid macOS socket path length issues (103 char limit)
-	launchArgs: ['--user-data-dir=/tmp/vscode-test-harness'],
+	launchArgs: ['--user-data-dir=/tmp/vscode-comparison-tests'],
 	mocha: {
 		timeout: 10000 // Increased from default 2000ms for slower CI environments (especially macOS)
 	}

tests/comparison/.vscode-test.mjs

@@ -1,4 +1,4 @@
-# Comparison Test Harness
+# Comparison Tests
 
 Verifies behavioral compatibility between old TypeScript Hero and new Mini TypeScript Hero.
 
@@ -7,7 +7,7 @@ Verifies behavioral compatibility between old TypeScript Hero and new Mini TypeS
 ## Structure
 
 ```
-comparison-test-harness/
+tests/comparison/
 ├── old-typescript-hero/     # Git submodule to buehler/typescript-hero
 ├── old-extension/adapter.ts # Wrapper for old extension
 ├── new-extension/adapter.ts # Wrapper for new extension

tests/comparison/README.md

@@ -1,7 +1,7 @@
 {
-  "name": "comparison-test-harness",
+  "name": "comparison-tests",
   "version": "1.0.0",
-  "description": "Test harness comparing old vs new TypeScript Hero",
+  "description": "Comparison tests: old vs new TypeScript Hero",
   "private": true,
   "engines": {
     "vscode": "^1.85.0",