fix:platforms:incremental-support

Reports platform support inconsistencies across game versions to ensure platforms are only gained, not lost.

Overview

This command analyzes platform support across game versions to ensure consistency. It identifies cases where newer versions lose platform support that was available in previous versions.

Platform Logic

The command enforces the principle that platform support should be incremental:

Once a platform is supported in any version, it should remain supported in all subsequent versions
Newer versions can gain additional platform support
Newer versions should never lose platform support from previous versions

Platforms Checked

Platform	Database Field	Description
Windows	is_windows	Windows desktop support
Linux	is_linux	Linux desktop support
Mac	is_mac	macOS desktop support
Android	is_android	Android mobile support
Web	is_web	Web browser support

Usage

php artisan fix:platforms:incremental-support [options]

Options

--game-id=ID: Report only a specific game by ID. Useful for investigating specific games.

Examples

php artisan fix:platforms:incremental-support

Analyzes platform support consistency for all games with multiple versions.

php artisan fix:platforms:incremental-support --game-id=123

Analyzes platform support only for game ID 123.

Output Format

The command generates a detailed table for each game with issues:

Game: Example Visual Novel (ID: 123)
┌─────────┬────────┬─────┬───────┬─────┬─────────┬─────┬───────────┐
│ Version │ Latest │ Win │ Linux │ Mac │ Android │ Web │ Missing   │
├─────────┼────────┼─────┼───────┼─────┼─────────┼─────┼───────────┤
│ 1.0     │        │ ✓   │ ✓     │     │         │     │           │
│ 1.1     │        │ ✓   │ ✓     │ ✓   │         │     │           │
│ 1.2     │ ✓      │ ✓   │ ✗     │ ✓   │ ✓       │     │ Linux     │
└─────────┴────────┴─────┴───────┴─────┴─────────┴─────┴───────────┘

Legend

✓ - Platform supported
✗ - Platform missing (should be supported based on previous versions)
Latest - Indicates the current latest version
Missing - Lists platforms that should be supported but aren't

When to Use

Recommended Usage Scenarios

Before releasing new game versions
During platform support audits
When investigating platform availability issues
As part of quality assurance processes
After bulk updates to game version data

Understanding Results

No Issues Found

Analyzing platform support consistency across game versions...
No games found to analyze.

Processed 15 games, 0 games with platform support issues found.

Issues Found

Analyzing platform support consistency across game versions...

Game: Example VN (ID: 123)
[Table showing version inconsistencies]

Game: Another Game (ID: 456)  
[Table showing version inconsistencies]

Summary:
Processed 25 games, 2 games with platform support issues found.

Troubleshooting Platform Issues

When the command identifies inconsistencies:

Review the output to understand which platforms are missing in which versions
Check the game data to verify if the platform support is actually incorrect
Update game version records manually if the data is wrong
Investigate the cause - was platform support accidentally removed during updates?

This command is standalone but complements the character fix commands by ensuring overall data consistency across the platform.

Last modified: 01 June 2025