Christoph Wagner 5ad0700b41 refactor: Consolidate repository structure - flatten from workspace pattern

Restructured project from nested workspace pattern to flat single-repo layout.
This eliminates redundant nesting and consolidates all project files under version control.

## Migration Summary

**Before:**
```
alex/ (workspace, not versioned)
├── chess-game/ (git repo)
│   ├── js/, css/, tests/
│   └── index.html
└── docs/ (planning, not versioned)
```

**After:**
```
alex/ (git repo, everything versioned)
├── js/, css/, tests/
├── index.html
├── docs/ (project documentation)
├── planning/ (historical planning docs)
├── .gitea/ (CI/CD)
└── CLAUDE.md (configuration)
```

## Changes Made

### Structure Consolidation
- Moved all chess-game/ contents to root level
- Removed redundant chess-game/ subdirectory
- Flattened directory structure (eliminated one nesting level)

### Documentation Organization
- Moved chess-game/docs/ → docs/ (project documentation)
- Moved alex/docs/ → planning/ (historical planning documents)
- Added CLAUDE.md (workspace configuration)
- Added IMPLEMENTATION_PROMPT.md (original project prompt)

### Version Control Improvements
- All project files now under version control
- Planning documents preserved in planning/ folder
- Merged .gitignore files (workspace + project)
- Added .claude/ agent configurations

### File Updates
- Updated .gitignore to include both workspace and project excludes
- Moved README.md to root level
- All import paths remain functional (relative paths unchanged)

## Benefits

✅ **Simpler Structure** - One level of nesting removed
✅ **Complete Versioning** - All documentation now in git
✅ **Standard Layout** - Matches open-source project conventions
✅ **Easier Navigation** - Direct access to all project files
✅ **CI/CD Compatible** - All workflows still functional

## Technical Validation

- ✅ Node.js environment verified
- ✅ Dependencies installed successfully
- ✅ Dev server starts and responds
- ✅ All core files present and accessible
- ✅ Git repository functional

## Files Preserved

**Implementation Files:**
- js/ (3,517 lines of code)
- css/ (4 stylesheets)
- tests/ (87 test cases)
- index.html
- package.json

**CI/CD Pipeline:**
- .gitea/workflows/ci.yml
- .gitea/workflows/release.yml

**Documentation:**
- docs/ (12+ documentation files)
- planning/ (historical planning materials)
- README.md

**Configuration:**
- jest.config.js, babel.config.cjs, playwright.config.js
- .gitignore (merged)
- CLAUDE.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-23 10:05:26 +01:00

7.6 KiB

Raw Blame History

Chess Game Test Data (PGN Format)

This directory contains PGN (Portable Game Notation) files of complete chess games for testing game replay, move validation, and analysis features.

PGN Format

PGN includes:

Game metadata (Event, Site, Date, Round, White, Black, Result)
Move sequences in standard algebraic notation
Optional annotations and variations

Available Games

Famous Short Games

Fool's Mate

File: fools-mate.pgn

[Event "Fool's Mate Example"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "0-1"]

1. f3 e5 2. g4 Qh4# 0-1

Description: Shortest possible checkmate (2 moves) Moves: 2 Result: Black wins

Scholar's Mate

File: scholars-mate.pgn

[Event "Scholar's Mate Example"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "1-0"]

1. e4 e5 2. Bc4 Nc6 3. Qh5 Nf6 4. Qxf7# 1-0

Description: Four-move checkmate Moves: 4 Result: White wins

Historic Masterpieces

The Immortal Game

File: immortal-game.pgn

[Event "Casual Game"]
[Site "London"]
[Date "1851.06.21"]
[Round "?"]
[White "Adolf Anderssen"]
[Black "Lionel Kieseritzky"]
[Result "1-0"]

1. e4 e5 2. f4 exf4 3. Bc4 Qh4+ 4. Kf1 b5 5. Bxb5 Nf6 6. Nf3 Qh6
7. d3 Nh5 8. Nh4 Qg5 9. Nf5 c6 10. g4 Nf6 11. Rg1 cxb5 12. h4 Qg6
13. h5 Qg5 14. Qf3 Ng8 15. Bxf4 Qf6 16. Nc3 Bc5 17. Nd5 Qxb2
18. Bd6 Bxg1 19. e5 Qxa1+ 20. Ke2 Na6 21. Nxg7+ Kd8 22. Qf6+ Nxf6
23. Be7# 1-0

Description: Famous 1851 game with brilliant sacrifices Moves: 23 Result: White wins Notable: Multiple piece sacrifices leading to checkmate

The Opera Game

File: opera-game.pgn

[Event "Paris Opera"]
[Site "Paris"]
[Date "1858.??.??"]
[Round "?"]
[White "Paul Morphy"]
[Black "Duke of Brunswick and Count Isouard"]
[Result "1-0"]

1. e4 e5 2. Nf3 d6 3. d4 Bg4 4. dxe5 Bxf3 5. Qxf3 dxe5 6. Bc4 Nf6
7. Qb3 Qe7 8. Nc3 c6 9. Bg5 b5 10. Nxb5 cxb5 11. Bxb5+ Nbd7
12. O-O-O Rd8 13. Rxd7 Rxd7 14. Rd1 Qe6 15. Bxd7+ Nxd7 16. Qb8+ Nxb8
17. Rd8# 1-0

Description: Morphy's famous game at the Paris Opera Moves: 17 Result: White wins Notable: Brilliant tactical play, queen sacrifice

Test Cases for Special Moves

En Passant Capture

File: en-passant-game.pgn

[Event "En Passant Test"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "*"]

1. e4 a6 2. e5 d5 3. exd6 *

Description: Demonstrates en passant capture Moves: 3 Result: Unfinished Test: En passant on move 3

Castling Both Sides

File: castling-game.pgn

[Event "Castling Test"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "*"]

1. e4 e5 2. Nf3 Nc6 3. Bc4 Bc5 4. O-O Nf6 5. d3 d6 6. Nc3 O-O *

Description: Both sides castle kingside Moves: 6 Result: Unfinished Test: Castling validation

Pawn Promotion

File: pawn-promotion-game.pgn

[Event "Promotion Test"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "*"]

1. e4 d5 2. exd5 Qxd5 3. Nc3 Qe6+ 4. Be2 Qg6 5. Nf3 Qxg2 6. Rg1 Qh3
7. Rg3 Qh6 8. Rg8+ Qf8 9. Rxf8# *

Description: Game with pawn promotion scenario Moves: 9 Result: Unfinished

Draw Test Cases

Stalemate

File: stalemate-game.pgn

[Event "Stalemate Test"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "1/2-1/2"]

1. e3 a5 2. Qh5 Ra6 3. Qxa5 h5 4. Qxc7 Rah6 5. h4 f6 6. Qxd7+ Kf7
7. Qxb7 Qd3 8. Qxb8 Qh7 9. Qxc8 Kg6 10. Qe6 1/2-1/2

Description: Game ending in stalemate Moves: 10 Result: Draw Test: Stalemate detection

Insufficient Material

File: insufficient-material.pgn

[Event "Insufficient Material Test"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "1/2-1/2"]

1. e4 e5 2. Nf3 Nc6 3. Bb5 a6 4. Bxc6 dxc6 5. Nxe5 Qd4 6. Nxf7 Qxe4+
7. Qe2 Qxe2# 1/2-1/2

Description: Game ending with insufficient material Result: Draw

Threefold Repetition

File: threefold-repetition.pgn

[Event "Threefold Repetition Test"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "1/2-1/2"]

1. Nf3 Nf6 2. Ng1 Ng8 3. Nf3 Nf6 4. Ng1 Ng8 5. Nf3 1/2-1/2

Description: Threefold repetition draw Moves: 5 Result: Draw Test: Repetition detection

Opening Repertoire

Italian Game

File: italian-game.pgn

[Event "Italian Opening"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "*"]

1. e4 e5 2. Nf3 Nc6 3. Bc4 Bc5 4. c3 Nf6 5. d4 exd4 6. cxd4 Bb4+
7. Nc3 Nxe4 8. O-O Bxc3 9. d5 *

Description: Italian Game main line Moves: 9

Sicilian Defense

File: sicilian-defense.pgn

[Event "Sicilian Defense"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "*"]

1. e4 c5 2. Nf3 d6 3. d4 cxd4 4. Nxd4 Nf6 5. Nc3 a6 6. Be3 e5
7. Nb3 Be6 8. f3 *

Description: Sicilian Defense, Najdorf Variation Moves: 8

Queen's Gambit

File: queens-gambit.pgn

[Event "Queen's Gambit"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "*"]

1. d4 d5 2. c4 e6 3. Nc3 Nf6 4. Bg5 Be7 5. e3 O-O 6. Nf3 h6
7. Bh4 b6 8. cxd5 *

Description: Queen's Gambit Declined Moves: 8

Edge Case Games

Maximum Moves (Longest Game)

File: long-game.pgn

[Event "Long Game Test"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "*"]

[100+ moves for endurance testing]

Description: Very long game for stress testing Moves: 100+

All Piece Types Promoted

File: all-promotions.pgn

[Event "All Promotions Test"]
[Site "?"]
[Date "????.??.??"]
[Round "?"]
[White "White"]
[Black "Black"]
[Result "*"]

[Game demonstrating promotion to Q, R, B, N]

Description: Tests all promotion piece types

Usage in Tests

import { loadPGN } from '../utils/fixtures';
import { Chess } from 'chess.js';

test('Replay Immortal Game', () => {
  const pgn = loadPGN('immortal-game');
  const chess = new Chess();

  chess.loadPgn(pgn);
  expect(chess.isCheckmate()).toBe(true);
});

test('Validate all moves in Opera Game', () => {
  const pgn = loadPGN('opera-game');
  const chess = new Chess();

  const result = chess.loadPgn(pgn);
  expect(result).toBe(true); // All moves valid
});

Test Categories

Functional Tests

fools-mate.pgn, scholars-mate.pgn - Basic checkmate
en-passant-game.pgn - Special moves
castling-game.pgn - Castling validation
pawn-promotion-game.pgn - Pawn promotion

Edge Cases

stalemate-game.pgn - Draw by stalemate
threefold-repetition.pgn - Draw by repetition
insufficient-material.pgn - Draw by insufficient material
long-game.pgn - Endurance testing

Historic Games

immortal-game.pgn - Tactics and sacrifices
opera-game.pgn - Brilliant play
Famous games for regression testing

Adding New Games

Create .pgn file with proper metadata
Validate PGN using chess.js
Add description to this README
Categorize appropriately
Create corresponding test cases

PGN Validation

import { Chess } from 'chess.js';

const isValidPGN = (pgn) => {
  const chess = new Chess();
  return chess.loadPgn(pgn);
};

Resources

PGN Specification: https://www.chessclub.com/help/PGN-spec
Chess.js: https://github.com/jhlywa/chess.js
Online PGN Viewer: https://www.chess.com/analysis
Game Database: https://www.pgnmentor.com/

7.6 KiB Raw Blame History