Implement soil testing feature for park areas using existing game systems

[Copilot]

This PR implements a comprehensive soil testing feature that allows players to analyze soil quality in park areas using specialized equipment. The feature builds entirely on existing game infrastructure without disrupting current functionality.

What's New

Soil Testing Equipment: Added 6 new items to the ItemDatabase including pH Test Kit, Soil Probe, Moisture Meter, Soil Thermometer, NPK Test Kit, and Soil Sample Bag. Each piece of equipment reveals different soil properties when used.

Realistic Soil Properties: Park tiles now include randomly generated but realistic soil characteristics:

• pH levels (4.5-8.5 range)
• Moisture content (10-80%)
• Soil temperature (5-25°C)
• Nutrient levels (NPK - Nitrogen, Phosphorus, Potassium)
• Compaction measurements
• Automatic quality assessment based on multiple factors

Interactive Testing: Players can now tap on themselves while standing in park areas to perform soil tests. The system uses the first available testing equipment from their inventory and displays results as temporary labels above the player.

Technical Implementation

The feature seamlessly integrates with existing systems:

// Soil properties are automatically generated for park tiles
if districtType == .park {
    tiles[idx].soilProperties = SoilProperties()
}

// Players can test soil using their equipment
if let result = player.performSoilTest(at: location, soilProperties: soilProperties) {
    showSoilTestResult(result)
}

Key Integration Points:

• Leverages existing .park and .hidingArea tile types
• Uses established ItemDatabase and inventory systems
• Integrates with current touch input handling
• Compatible with all existing dungeon generation algorithms
• Follows existing code patterns and architecture

Player Experience: Players start with one piece of soil testing equipment and can discover more during exploration. Different equipment reveals different aspects of soil composition, encouraging players to collect various tools for comprehensive analysis.

Testing & Documentation

Added comprehensive unit tests covering soil property generation, equipment functionality, and end-to-end testing workflows. Updated the Getting Started documentation with usage examples and code snippets for developers.

The soil testing feature adds meaningful scientific exploration mechanics while maintaining the game's urban exploration theme and building entirely on established game systems.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

[Copilot]

Pull Request Overview

This PR implements a comprehensive soil testing feature that allows players to analyze soil quality in park areas using specialized equipment. The feature integrates seamlessly with existing game systems without disrupting current functionality.

Key changes:

• Added 6 new soil testing equipment items to the ItemDatabase with realistic properties and values
• Implemented soil properties system with randomized but realistic values (pH, moisture, temperature, nutrients, compaction)
• Added interactive soil testing mechanics that activate when players tap themselves while standing in park areas

Reviewed Changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
TileType.swift	Added SoilProperties struct and SoilTestResult struct with comprehensive soil analysis capabilities
ItemDatabase.swift	Added 6 new soil testing equipment items (pH Test Kit, Soil Probe, etc.) to enable testing functionality
GameScene.swift	Implemented soil testing interaction logic and result display system
Entity.swift	Extended Player class with soil testing methods and guaranteed starting equipment
CityMapGenerator.swift	Modified park tile generation to include soil properties for testing
Getting-Started.md	Added documentation and code examples for the new soil testing feature
DeepLevelTests.swift	Added comprehensive unit tests covering soil properties, equipment, and end-to-end testing

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

[Copilot]

The soil testing equipment names are duplicated from the hasSoilTestingEquipment() method. This creates a maintenance burden where changes must be made in multiple places.

Suggested change

	["pH Test Kit", "Moisture Meter", "Soil Thermometer", "Soil Probe", "NPK Test Kit"].contains(item.title)
	/// Soil testing equipment names (single source of truth)
	static let soilTestingEquipmentNames: [String] = [
	"pH Test Kit", "Moisture Meter", "Soil Thermometer", "Soil Probe", "NPK Test Kit"
	]
	/// Check if player has any soil testing equipment
	func hasSoilTestingEquipment() -> Bool {
	return inventory.contains { item in
	Entity.soilTestingEquipmentNames.contains(item.title)
	}
	}
	/// Get available soil testing equipment
	func availableSoilTestingEquipment() -> [StoredItem] {
	return inventory.filter { item in
	Entity.soilTestingEquipmentNames.contains(item.title)

[Copilot]

[nitpick] The tile mutation logic is complex and updates the map directly. Consider moving this logic to a dedicated method or making the tile's soilProperties mutable through a cleaner interface.