5ad0700b41
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>
390 lines
7.6 KiB
Markdown
390 lines
7.6 KiB
Markdown
# 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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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`
|
|
```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
|
|
|
|
```javascript
|
|
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
|
|
|
|
1. Create `.pgn` file with proper metadata
|
|
2. Validate PGN using chess.js
|
|
3. Add description to this README
|
|
4. Categorize appropriately
|
|
5. Create corresponding test cases
|
|
|
|
## PGN Validation
|
|
|
|
```javascript
|
|
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/
|