settled-reach/tooling/star-map-seed.json

{
  "_comment": "Star map generation seed configuration. All 300 systems in this map have horizon stations — systems without stations are simply not included. The ~2500 other nearby stars without stations exist in-setting but are not graph nodes.",

  "random_seed": 20260313,

  "system_count": 300,

  "sector_distribution": {
    "core": 25,
    "north_reach": 50,
    "west_reach": 50,
    "south_reach": 50,
    "east_reach": 50,
    "deep_frontier": 75
  },

  "_comment_deep_frontier": "deep_frontier is larger than any single cardinal sector because it wraps the outer edge of all four cardinal directions. The extra 25 systems (vs 50 per cardinal) represent the scattered outer activation edge.",

  "gateway": {
    "_comment": "The Gateway system. Pre-seeded. First hop from Earth. Former Grand Central, now institutional/surveillance. Assembly capital is elsewhere.",
    "system_id": "S-001",
    "geographic_sector": "core",
    "geographic_band": "core",
    "political_zone": "diplomatic_periphery",
    "gate_topology": "hub",
    "aperture_count": 5,
    "gate_connections": 4,
    "_comment_apertures": "5 apertures total: 4 active connections into the Reach + 1 dormant Sol-facing aperture. gate_connections = 4 (Sol aperture is not a traversable connection).",
    "settlement_wave": "wave_1",
    "is_gateway": true,
    "pre_placed": true
  },

  "topology_targets": {
    "_comment": "Target percentage distribution. Checked during Phase 6 validation. Tolerance: +/- 3 percentage points per category.",
    "dead_end": 0.20,
    "spur_end": 0.15,
    "through_route": 0.25,
    "loop_member": 0.15,
    "junction": 0.18,
    "hub": 0.07
  },

  "hub_count_targets": {
    "_comment": "Hub count per sector. Algorithm targets exactly this many hubs per sector during augmentation. Deep frontier is sparse — 0 forced hubs; organic hubs may still arise from cross-sector bridge augmentation.",
    "core": 2,
    "north_reach": 2,
    "west_reach": 2,
    "south_reach": 2,
    "east_reach": 2,
    "deep_frontier": 0
  },

  "cross_sector_connection_targets": {
    "_comment": "Target number of connections crossing each sector boundary. These become chokepoints.",
    "core_to_north": 3,
    "core_to_west": 3,
    "core_to_south": 3,
    "core_to_east": 3,
    "north_to_deep_frontier": 2,
    "west_to_deep_frontier": 2,
    "south_to_deep_frontier": 2,
    "east_to_deep_frontier": 2,
    "north_to_west": 1,
    "west_to_south": 1,
    "south_to_east": 1,
    "east_to_north": 1
  },

  "star_type_distribution": {
    "_comment": "Spectral type targets. M-type dwarfs are most common. Percentages sum to 1.0.",
    "M": 0.47,
    "K": 0.27,
    "G": 0.13,
    "F": 0.06,
    "binary": 0.04,
    "unusual": 0.03
  },

  "settlement_wave_by_sector": {
    "_comment": "Wave probability weights per sector. Core = Wave 1-2 heavy. Deep frontier = Wave 4-5 heavy. With variation.",
    "core": {
      "wave_1": 0.45,
      "wave_2": 0.35,
      "wave_3": 0.12,
      "wave_4": 0.05,
      "wave_5": 0.02,
      "unsettled": 0.01
    },
    "north_reach": {
      "wave_1": 0.05,
      "wave_2": 0.25,
      "wave_3": 0.35,
      "wave_4": 0.20,
      "wave_5": 0.10,
      "unsettled": 0.05
    },
    "west_reach": {
      "wave_1": 0.05,
      "wave_2": 0.25,
      "wave_3": 0.35,
      "wave_4": 0.20,
      "wave_5": 0.10,
      "unsettled": 0.05
    },
    "south_reach": {
      "wave_1": 0.05,
      "wave_2": 0.25,
      "wave_3": 0.35,
      "wave_4": 0.20,
      "wave_5": 0.10,
      "unsettled": 0.05
    },
    "east_reach": {
      "wave_1": 0.05,
      "wave_2": 0.25,
      "wave_3": 0.35,
      "wave_4": 0.20,
      "wave_5": 0.10,
      "unsettled": 0.05
    },
    "deep_frontier": {
      "wave_1": 0.01,
      "wave_2": 0.05,
      "wave_3": 0.15,
      "wave_4": 0.35,
      "wave_5": 0.30,
      "unsettled": 0.14
    }
  },

  "geographic_band_by_sector": {
    "_comment": "Band assignment probabilities per sector. Core uses 'core' band only. Cardinal sectors split inner/outer.",
    "core": {
      "core": 1.0
    },
    "north_reach": {
      "inner": 0.55,
      "outer": 0.45
    },
    "west_reach": {
      "inner": 0.55,
      "outer": 0.45
    },
    "south_reach": {
      "inner": 0.55,
      "outer": 0.45
    },
    "east_reach": {
      "inner": 0.55,
      "outer": 0.45
    },
    "deep_frontier": {
      "inner": 0.25,
      "outer": 0.75
    }
  },

  "augmentation_weights": {
    "_comment": "Tuning parameters for Phase 3 augmentation passes.",
    "hub_target_degree_min": 5,
    "hub_target_degree_max": 6,
    "junction_target_degree_min": 3,
    "junction_target_degree_max": 3,
    "loop_formation_target_count": 20,
    "loop_min_path_length": 3,
    "loop_max_path_length": 8,
    "cross_sector_weight_penalty": 0.3,
    "inner_to_inner_weight_bonus": 0.4,
    "outer_to_inner_weight_bonus": 0.3,
    "unused_aperture_probability": 0.15
  },

  "validation_tolerances": {
    "topology_target_tolerance_pct": 0.06,
    "min_hubs_total": 15,
    "max_hubs_pct": 0.12,
    "dead_end_plus_spur_min_pct": 0.28,
    "dead_end_plus_spur_max_pct": 0.45,
    "gateway_min_connections": 4,
    "gateway_max_connections": 5,
    "earth_proximity_immediate_max": 20,
    "earth_proximity_proximate_max_hops": 10
  }
}