{
  "name": "Locus energy powered by laserbrain",
  "version": "1.0.0",
  "updated": "2026-07-25",
  "href": "/locus/laserbrain",
  "tagline": "Energy that stays on goal — hardware by Locus, recursion by laserbrain",
  "stack": {
    "locus": {
      "role": "energy hardware and multi-world envelopes",
      "schemes": ["grow_your_own_energy", "resonance_harvester"],
      "surfaces": ["/locus", "/locus/worlds", "/locus/kit", "/locus/runs", "/locus/hybrid"]
    },
    "laserbrain": {
      "role": "smart recursion harness — fixed reference so agents and control loops do not drift off the pass line",
      "surfaces": ["/laserbrain", "/laserbrain/quickstart", "/laserbrain/protocols"],
      "mcp": "laserbrain check_state / reset_task",
      "pip": "laserbrain"
    }
  },
  "why": [
    "Locus pass criteria are binary and fixed for a run — laserbrain holds that goal as ground",
    "Build agents writing firmware, analyzing lab-logs, or retuning f0 spiral without a fixed reference",
    "Multi-world ops (Earth/Moon/Mars) multiply context; harness keeps the mission goal stable",
    "Field instruments and lab-logs measure energy; laserbrain measures whether the agent still serves the energy goal"
  ],
  "attach": {
    "goal_examples": [
      "P0: MPPT delivers more energy than fixed load under comparable irradiance",
      "P2: wet side viable; dry envelope holds; algae SoC + lux_exit logged",
      "RP0: matched drive; piezo energy rises only while drive_on",
      "Hybrid: three ledgers co-timestamped; no free-energy fold",
      "Moon analog: store_soc above floor through simulated multi-day dark"
    ],
    "when": [
      "Each build step on /locus/build",
      "Each analysis pass over /locus/runs JSON",
      "Firmware iteration from /locus/firmware recipe",
      "World-envelope design choices on /locus/worlds"
    ],
    "python": "from laserbrain import Harness\nh = Harness()\n# each step:\nout = h.check(goal=GOAL, progress=\"advancing\", distance=d, doing=...)\nif out.get(\"drifting\"): return_to_goal()",
    "mcp": "laserbrain__check_state with goal held identical to the lab-log goal field"
  },
  "layers": [
    { "id": "E", "name": "Energy", "who": "Locus", "what": "PV, match, fibre, live store, piezo harvest" },
    { "id": "L", "name": "Ledger", "who": "Locus lab-log", "what": "samples, status pass|fail, environment.world" },
    { "id": "A", "name": "Agent", "who": "laserbrain", "what": "goal ground, Φ drift, return advice" },
    { "id": "F", "name": "Field", "who": "laserfield (optional)", "what": "shared weather / tandem for multi-agent ops" }
  ]
}
