autonomous-circuit

// Circuit settings — ~/.autonomous-circuit/settings.json {hasOnboarded, autoBuild, model}.
//
// Contract §2: the settings file carries exactly these three fields. The
// `app_settings_read` reply is padded with harmless legacy defaults so the
// donor's `AppSettings` TS shape (kept verbatim in transport.ts) stays
// satisfied for not-yet-excised client code.

import fs from "node:fs";
import path from "node:path";

import { circuitHome } from "./projects.mjs";

export function settingsFilePath(env = process.env) {
  return path.join(circuitHome(env), "settings.json");
}

// A board that reaches a user has to be orderable on the first build, so the
// model and the reasoning effort behind it are product decisions, not whatever
// the CLI happens to default to. Pinned here; a user can still override both.
//
// Opus for design work: composing a board, reading two rendered images and
// judging what is wrong with them is exactly the kind of task where the
// stronger model earns its cost — a repair round costs far more than the
// tokens saved, and a wrong board costs $85 and two weeks.
export const DEFAULT_MODEL = "claude-opus-5";
export const DEFAULT_EFFORT = "high";
export const EFFORT_LEVELS = Object.freeze(["low", "medium", "high", "xhigh", "max"]);

const DEFAULTS = Object.freeze({
  hasOnboarded: false,
  autoBuild: true,
  model: DEFAULT_MODEL,
  effort: DEFAULT_EFFORT,
});

function normalize(raw) {
  const obj = raw && typeof raw === "object" ? raw : {};
  const out = {
    hasOnboarded: typeof obj.hasOnboarded === "boolean" ? obj.hasOnboarded : DEFAULTS.hasOnboarded,
    // Missing → autopilot on (matches the donor's serde default).
    autoBuild: typeof obj.autoBuild === "boolean" ? obj.autoBuild : DEFAULTS.autoBuild,
  };
  const effort = typeof obj.effort === "string" ? obj.effort.trim() : "";
  out.effort = EFFORT_LEVELS.includes(effort) ? effort : DEFAULTS.effort;
  const model = typeof obj.model === "string" ? obj.model.trim() : "";
  if (model) {
    out.model = model;
  }
  // Contract §2: the donor's renderProvider is dropped — no field survives.
  return out;
}

export function createSettingsStore({ filePath = settingsFilePath() } = {}) {
  function read() {
    try {
      return normalize(JSON.parse(fs.readFileSync(filePath, "utf8")));
    } catch {
      return normalize(null);
    }
  }

  /** Merge-write: only the Circuit trio is persisted; unknown keys are dropped. */
  function write(partial) {
    const current = read();
    const merged = { ...current, ...(partial && typeof partial === "object" ? partial : {}) };
    const next = normalize(merged);
    // An explicit `model: ""` / null clears the stored model.
    if (partial && Object.prototype.hasOwnProperty.call(partial, "model")) {
      const model = typeof partial.model === "string" ? partial.model.trim() : "";
      if (model) {
        next.model = model;
      } else {
        delete next.model;
      }
    }
    fs.mkdirSync(path.dirname(filePath), { recursive: true });
    fs.writeFileSync(filePath, `${JSON.stringify(next, null, 2)}\n`);
    return next;
  }

  /** The full AppSettings wire shape (circuit trio + legacy-compatible pads). */
  function readWire() {
    const s = read();
    return {
      defaultFilament: "PLA",
      slicerBinaryPath: "",
      hasOnboarded: s.hasOnboarded,
      autoUpdate: false,
      autoBuild: s.autoBuild,
      ...(s.model ? { model: s.model } : {}),
      ...(s.effort ? { effort: s.effort } : {}),
    };
  }

  return { filePath, read, write, readWire };
}