{
  "_comment": "BUILDABLE ITEMS — cost-based improvements. A build costs the `cost` below (in `resources`) and takes effect when purchased; it is AVAILABLE once every research id in its `requires` is complete — ids are \"<category>/<node id>\" pointing at data/research/<category>.json → nodes (e.g. \"exploration/tether_l2\"). The research side declares the same relationship in its node's `unlocks.builds`; dev/research-builds.test.mjs keeps the two in lock-step. `category` says where it applies: `ship` = improve the player's ship, `planet` = improve things on planets, `station` = improve space stations, `general` = new capabilities for the player; `targets` (optional) lists the surfaces a build can be placed on (defaults to `[category]` when absent). `repeatable` builds can be bought more than once (treat as false when absent). Add a build = one entry under `builds` (the key is the build's id). Keys starting with `_` (like `_template`) are documentation, not data. The build state/UI is not implemented yet — this file is the data layer that will drive it.",
  "resources": {
    "credits": {
      "label": "Credits",
      "description": "Money — the galaxy's currency."
    },
    "minerals": {
      "label": "Minerals",
      "description": "Raw materials — mined from resource worlds."
    }
  },
  "builds": {
    "tether-l2": {
      "_comment": "Placeholder entry — proves the research→build unlock wiring (exploration/tether_l2 `unlocks.builds` ↔ this `requires`). Cost/effect are first guesses: tune when the build panel lands.",
      "label": "Tether Ring · Level 2",
      "description": "Anchor a level-2 tether ring on a planet or space station you hold. Its 6,400 m field stitches into your home tether — open space where there was a wall.",
      "category": "general",
      "targets": ["planet", "station"],
      "cost": {
        "credits": 400,
        "minerals": 60
      },
      "requires": ["exploration/tether_l2"],
      "repeatable": false,
      "effects": {
        "tether": { "level": 2, "anchor": "target" }
      },
      "theme": {
        "color": "#00e5ff"
      }
    }
  },
  "_template": {
    "label": "Buildable Item",
    "description": "What this is and what it does.",
    "category": "ship",
    "targets": ["ship"],
    "cost": {
      "credits": 250,
      "minerals": 40
    },
    "requires": ["exploration/<node id>"],
    "repeatable": false,
    "effects": {},
    "theme": {
      "color": "#ffc94d"
    }
  }
}