# Starfall Haven 0.3.0 Release Contract

## Product identity
- Package: `space.animefu.starfallhaven`
- Version code/name: `3` / `0.3.0`
- Landscape, offline runtime, minSdk 23, targetSdk 35.
- Preserve the existing release certificate and migrate qualified v1/v2 saves.

## Originality boundary
Starfall Haven may implement broad colony-simulation conventions but must not copy another game's code, writing, terminology, factions, event text, balance tables, UI composition, icons, artwork, characters, lore, map appearance or trade dress.

## Required player-facing systems
1. **Landing region selection**
   - Deterministic procedural region map generated from a visible seed.
   - Multiple candidate landing regions with biome, resources, hazard and fertility summaries.
   - The local colony map derives from the selected site.
2. **Regional society**
   - Nearby original settlements are visible before landing and afterward.
   - Every settlement clearly reports faction, relation (friendly/neutral/hostile), distance and trade availability.
   - Factions perform deterministic strategic AI actions that can improve or damage relations.
3. **Area designation**
   - Explicit touch mode separates camera panning from rectangular tile selection.
   - Drag-designate multiple resources for harvest.
   - Drag-designate multiple ground stacks for hauling/pickup.
   - Drag or line-designate supported construction blueprints with preview, count, confirm and cancel.
4. **Trade and diplomacy**
   - Friendly/neutral settlements or visiting trade skiffs expose original offers.
   - Transactions check inventory/currency and update reputation.
   - Hostile settlements do not trade unless relations improve.
5. **Family growth**
   - Adult partners/households may choose pregnancy deterministically under safe colony conditions.
   - Pregnancy and birth are non-explicit.
   - Infant and child stages are safe noncombatants with care, food, rest and comfort needs.
   - Caregivers autonomously prioritize critical child care.
6. **Artificial intelligence**
   - Settlers choose needs, care, emergency, explicit orders and normal work using explainable priority rules.
   - Factions choose trade, outreach, patrol, rivalry or raid pressure based on relation and resources.

## Asset requirement
Bundle original semantic assets for the region map, three faction attitudes, trade craft, nursery, agriculture and multi-designation UI. PixelLab remains build-time only; no token or MCP configuration may enter source or APK.

## Acceptance gates
- Platform-neutral deterministic tests for region generation, site selection, faction AI, trade, family stages and area designation.
- v1 and v2 migration plus v3 round-trip.
- Android lint and signed release build.
- Exact signed 0.2 → 0.3 in-place upgrade.
- On-device exercise: choose landing site, inspect nearby factions, make a multi-tile designation, place an area blueprint, open trade, inspect family/care state, save, force-stop and relaunch.
- Final APK alignment/signature/version verification and clean runtime logs.
