@enerlence/suntropy-cli 0.3.0 → 0.4.0

package/dist/bin/suntropy.js

@@ -388,9 +388,709 @@ function registerAuthCommands(program2) {
   });
 }
 
+// src/commands/config/shared.ts
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync3, unlinkSync } from "fs";
+import { tmpdir } from "os";
+import { join as join2 } from "path";
+import { spawnSync } from "child_process";
+function getGlobalOpts2(cmd) {
+  let root = cmd;
+  while (root.parent) root = root.parent;
+  return root.opts();
+}
+function coerceValue(raw) {
+  if (raw === "true") return true;
+  if (raw === "false") return false;
+  if (raw === "null") return null;
+  if (/^-?\d+$/.test(raw)) return parseInt(raw, 10);
+  if (/^-?\d*\.\d+$/.test(raw)) return parseFloat(raw);
+  if (raw.startsWith("{") && raw.endsWith("}") || raw.startsWith("[") && raw.endsWith("]")) {
+    try {
+      return JSON.parse(raw);
+    } catch {
+    }
+  }
+  return raw;
+}
+function parseSetFlags(entries) {
+  if (!entries || entries.length === 0) return {};
+  const out = {};
+  for (const entry of entries) {
+    const eq = entry.indexOf("=");
+    if (eq < 0) throw new Error(`Invalid --set value "${entry}" (expected key=value)`);
+    const key = entry.slice(0, eq).trim();
+    const rawVal = entry.slice(eq + 1);
+    if (!key) throw new Error(`Invalid --set value "${entry}" (empty key)`);
+    out[key] = coerceValue(rawVal);
+  }
+  return out;
+}
+function loadFromFile(path) {
+  const raw = readFileSync2(path, "utf-8");
+  const parsed = JSON.parse(raw);
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error(`File ${path} must contain a JSON object at the top level`);
+  }
+  return parsed;
+}
+function pickKeys(obj, keys) {
+  const out = {};
+  if (!obj) return out;
+  for (const k of keys) {
+    if (k in obj) out[k] = obj[k];
+  }
+  return out;
+}
+function buildPayload(flagValues, setEntries, fromFile, allowedKeys) {
+  const payload = {};
+  if (fromFile) Object.assign(payload, loadFromFile(fromFile));
+  if (setEntries) Object.assign(payload, parseSetFlags(setEntries));
+  for (const [k, v] of Object.entries(flagValues)) {
+    if (v !== void 0) payload[k] = v;
+  }
+  if (allowedKeys) {
+    for (const k of Object.keys(payload)) {
+      if (!allowedKeys.includes(k)) {
+        throw new Error(`Field "${k}" does not belong to this section. Allowed: ${allowedKeys.join(", ")}`);
+      }
+    }
+  }
+  return payload;
+}
+function editJson(initial, filenameHint = "config") {
+  const editor = process.env.EDITOR || process.env.VISUAL || "vi";
+  const tmp = join2(tmpdir(), `suntropy-${filenameHint}-${Date.now()}.json`);
+  writeFileSync3(tmp, JSON.stringify(initial ?? {}, null, 2));
+  try {
+    const res = spawnSync(editor, [tmp], { stdio: "inherit" });
+    if (res.status !== 0) throw new Error(`Editor "${editor}" exited with status ${res.status}`);
+    const updated = readFileSync2(tmp, "utf-8");
+    const parsed = JSON.parse(updated);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+      throw new Error("Edited content must be a JSON object at the top level");
+    }
+    return parsed;
+  } finally {
+    try {
+      unlinkSync(tmp);
+    } catch {
+    }
+  }
+}
+
+// src/commands/config/theme.ts
+var THEME_KEYS = [
+  "idClientThemeConfig",
+  "primary",
+  "btnPrimary",
+  "btnSecondary",
+  "background",
+  "navbarBackgroundColor",
+  "graph1",
+  "graph2",
+  "graph3",
+  "graph4",
+  "graph5",
+  "graph6",
+  "logoUrl",
+  "faviconUrl",
+  "clientAppTitle",
+  "carouselLinks",
+  "enableCustomTheme"
+];
+function registerThemeCommands(configRoot) {
+  const theme = configRoot.command("theme").description(
+    "Client branding & theme (security service).\nColours, logo, favicon and app title applied across Suntropy.\nEndpoints: GET /clients/config/clientThemeByClientUID/:uid (public)\n           POST /clients/config/updateTheme (requires admin role)\n\nFields:\n  primary, btnPrimary, btnSecondary   Core palette (hex).\n  background, navbarBackgroundColor   Surface colours.\n  graph1..graph6                      Chart palette (6 slots).\n  logoUrl, faviconUrl                 Asset URLs.\n  clientAppTitle                      Visible app title.\n  carouselLinks                       JSON-serialised carousel config.\n  enableCustomTheme                   Toggles the custom theme on/off."
+  );
+  theme.command("get").description("Fetch the theme of a client (public endpoint, no auth required for reads).").requiredOption("--client-uid <uid>", "Client UID whose theme should be fetched").action(async (opts) => {
+    try {
+      const global = getGlobalOpts2(theme);
+      const client = createServiceClient("security", global);
+      const res = await client.get(`/clients/config/clientThemeByClientUID/${opts.clientUid}`);
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  theme.command("set").description(
+    'Update the theme of the authenticated client (requires admin role).\nCombine individual flags, repeatable --set key=value, and/or --from-file.\nExample:\n  suntropy config theme set --primary "#0066ff" --logo-url https://cdn/logo.svg\n  suntropy config theme set --set graph1=#ff0000 --set graph2=#00ff00\n  suntropy config theme set --from-file theme.json'
+  ).option("--primary <hex>", "Primary colour").option("--btn-primary <hex>", "Primary button colour").option("--btn-secondary <hex>", "Secondary button colour").option("--background <hex>", "Background colour").option("--navbar-background-color <hex>", "Navbar background colour").option("--logo-url <url>", "Logo URL").option("--favicon-url <url>", "Favicon URL").option("--client-app-title <title>", "Visible app title").option("--enable-custom-theme [bool]", "Toggle the custom theme (true/false)").option("--set <entries...>", "Additional field assignments as key=value (repeatable)").option("--from-file <path>", "Load a partial payload from a JSON file").action(async (opts) => {
+    try {
+      const global = getGlobalOpts2(theme);
+      const client = createServiceClient("security", global);
+      const flagValues = {
+        primary: opts.primary,
+        btnPrimary: opts.btnPrimary,
+        btnSecondary: opts.btnSecondary,
+        background: opts.background,
+        navbarBackgroundColor: opts.navbarBackgroundColor,
+        logoUrl: opts.logoUrl,
+        faviconUrl: opts.faviconUrl,
+        clientAppTitle: opts.clientAppTitle,
+        enableCustomTheme: opts.enableCustomTheme === void 0 ? void 0 : opts.enableCustomTheme === true || opts.enableCustomTheme === "true"
+      };
+      const payload = buildPayload(flagValues, opts.set, opts.fromFile, THEME_KEYS);
+      if (Object.keys(payload).length === 0) {
+        outputError(new Error("No fields provided. Use flags, --set, or --from-file."));
+        return;
+      }
+      const res = await client.post("/clients/config/updateTheme", payload);
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  theme.command("edit").description("Open $EDITOR with the theme JSON and PUT the edited result.").requiredOption("--client-uid <uid>", "Client UID to fetch the current theme from").action(async (opts) => {
+    try {
+      const global = getGlobalOpts2(theme);
+      const client = createServiceClient("security", global);
+      const current = await client.get(`/clients/config/clientThemeByClientUID/${opts.clientUid}`);
+      const subset = pickKeys(current.data, THEME_KEYS);
+      const edited = editJson(subset, "theme");
+      const res = await client.post("/clients/config/updateTheme", edited);
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+}
+
+// src/commands/config/advanced.ts
+function kebab(key) {
+  return key.replace(/[A-Z0-9]+/g, (m, i) => i === 0 ? m.toLowerCase() : "-" + m.toLowerCase());
+}
+var GENERAL = {
+  name: "general",
+  title: "General configuration (branding, language, tracking, base aesthetics).",
+  summary: 'Applies to the entire widget: navbar, favicon, global theme, analytics/pixels\nand page-wide injected scripts. Equivalent to the "General Configuration"\npanel in the Suntropy admin.',
+  fields: [
+    "logoUrl",
+    "faviconUrl",
+    "tabTitle",
+    "onAddressButtonClick",
+    "onSendButtonClick",
+    "googleConversionId",
+    "googleConversionLabelOnAddress",
+    "googleConversionLabelOnSend",
+    "metaConversionId",
+    "customTrackingHTML",
+    "defaultLanguage",
+    "enableLanguageMenu",
+    "customColorOfElements",
+    "steticVariant",
+    "themeColor",
+    "navbarColor",
+    "addNumberToSteps",
+    "showFooter"
+  ],
+  fieldDocs: {
+    logoUrl: "Logo displayed in the navbar (and on the cover if includeLogoInCover=true). Empty = no logo.",
+    faviconUrl: "Browser tab favicon.",
+    tabTitle: "Browser tab title (HTML <title>).",
+    onAddressButtonClick: 'JavaScript evaluated (eval) when the user hits "Continue" on the address step. \u26A0 XSS risk; never accept untrusted input.',
+    onSendButtonClick: "JavaScript evaluated (eval) when the final form is submitted. Same XSS risk as above.",
+    googleConversionId: "Google Ads ID; injects gtag.js in <head>.",
+    googleConversionLabelOnAddress: "Google conversion label fired after the address step.",
+    googleConversionLabelOnSend: "Google conversion label fired on submit.",
+    metaConversionId: 'Meta/Facebook pixel ID; fires a "Lead" event on submit.',
+    customTrackingHTML: "Arbitrary HTML/JS injected in <head> (Hotjar, Mixpanel, GTM\u2026).",
+    defaultLanguage: 'Initial language: en|es|fr|it|pt|cat. Falls back to browser pref, then "en".',
+    enableLanguageMenu: "Shows the language picker in the navbar. false pins the user to defaultLanguage.",
+    customColorOfElements: "Accent colour for buttons / active borders.",
+    steticVariant: "Visual variant: default (rounded) | sharped (hard corners) | simple (minimalist, no shadows).",
+    themeColor: "Primary colour (navbar, buttons, focus ring). Default #575757.",
+    navbarColor: "Overrides themeColor for the navbar only.",
+    addNumberToSteps: 'Prefix step names with their number ("1. Address", \u2026).',
+    showFooter: "Pins the footer to the bottom instead of inlining it in the flow."
+  }
+};
+var COVER = {
+  name: "cover",
+  title: "Cover / hero screen shown before the address step.",
+  summary: "Configures the first screen the user sees: title, subtitle, carousel background, colours and logo placement.",
+  fields: [
+    "coverTitle",
+    "coverSubtitle",
+    "coverBackgroundImageUrl1",
+    "coverBackgroundImageUrl2",
+    "coverBackgroundImageUrl3",
+    "coverBackgroundImageUrl4",
+    "staticCoverImages",
+    "coverTextColor",
+    "coverFilterColor",
+    "includeLogoInCover"
+  ],
+  fieldDocs: {
+    coverTitle: "Hero title.",
+    coverSubtitle: "Hero subtitle below the title.",
+    coverBackgroundImageUrl1: "Background image #1 (also first frame of the carousel).",
+    coverBackgroundImageUrl2: "Background image #2.",
+    coverBackgroundImageUrl3: "Background image #3.",
+    coverBackgroundImageUrl4: "Background image #4.",
+    staticCoverImages: "true = no rotation (always shows the first image). false = carousel auto-rotates.",
+    coverTextColor: "Colour applied to coverTitle and coverSubtitle.",
+    coverFilterColor: "Overlay colour on top of the image. Default rgba(75,55,30,0.7); improves text contrast.",
+    includeLogoInCover: "true repeats the navbar logo on the cover. false keeps it only in the navbar."
+  }
+};
+var SURFACES = {
+  name: "surfaces",
+  title: "Surfaces step: the map where the user draws the roof polygon(s).",
+  summary: "Controls whether the step runs, how many surfaces are allowed, and the per-device help messages.",
+  fields: ["surfaceStepEnabled", "multipleSurfaces", "enableMapMarker", "messageOnDesktopDevices", "messageOnMobileDevices"],
+  fieldDocs: {
+    surfaceStepEnabled: "Enables/disables the whole step. false = the lead is sized without any polygon input.",
+    multipleSurfaces: "Allows drawing more than one roof surface per lead.",
+    enableMapMarker: "Drops a pin on the installation location over the satellite view.",
+    messageOnDesktopDevices: "Instruction text shown on desktop during the step.",
+    messageOnMobileDevices: 'Instruction text shown on mobile (e.g. "Tap to draw").'
+  }
+};
+var CONSUMER = {
+  name: "consumer",
+  title: "Consumer step: residential / commercial / community picker.",
+  summary: "Each subtype has its own visibility flag, image and label. defaultConsumptionPattern feeds the calculation engine.",
+  fields: [
+    "consumerStepEnabled",
+    "residentialConsumerTypeEnabled",
+    "residentialConsumerImageUrl",
+    "residentialConsumerTitle",
+    "commercialConsumerTypeEnabled",
+    "commercialConsumerImageUrl",
+    "commercialConsumerTitle",
+    "communityConsumerTypeEnabled",
+    "communityConsumerImageUrl",
+    "communityConsumerTitle",
+    "defaultConsumptionPattern"
+  ],
+  fieldDocs: {
+    consumerStepEnabled: "Shows/hides the whole step.",
+    residentialConsumerTypeEnabled: 'Makes the "Residential" option visible.',
+    residentialConsumerImageUrl: "Icon/photo for the Residential option.",
+    residentialConsumerTitle: 'Residential label (e.g. "Home").',
+    commercialConsumerTypeEnabled: 'Makes the "Commercial" option visible.',
+    commercialConsumerImageUrl: "Icon/photo for the Commercial option.",
+    commercialConsumerTitle: 'Commercial label (e.g. "Business").',
+    communityConsumerTypeEnabled: 'Makes the "Community" option visible.',
+    communityConsumerImageUrl: "Icon/photo for the Community option.",
+    communityConsumerTitle: "Community label.",
+    defaultConsumptionPattern: "Preselected pattern: Balance | Nightly | Morning | Afternoon | Domestic | Commercial | Community. Feeds the hourly curve used by the engine."
+  }
+};
+var INCLINATION = {
+  name: "inclination",
+  title: "Roof inclination step (flat / inclined / very inclined).",
+  summary: "Each variant carries its own image and label. defaultInclination is also used when the step is disabled.",
+  fields: [
+    "inclinationStepEnabled",
+    "flatRoofImageUrl",
+    "textFlatRoof",
+    "inclinedRoofImageUrl",
+    "textInclinedRoof",
+    "veryInclinedRoofImageUrl",
+    "textVeryInclinedRoof",
+    "defaultInclination",
+    "inclinationStepTitle"
+  ],
+  fieldDocs: {
+    inclinationStepEnabled: "Shows/hides the step. When false, defaultInclination is fed directly into the calculation.",
+    flatRoofImageUrl: "Image for the flat-roof option (0-15\xB0).",
+    textFlatRoof: 'Label for flat roof. Default "0-15\xB0".',
+    inclinedRoofImageUrl: "Image for the inclined-roof option (15-30\xB0).",
+    textInclinedRoof: 'Label for inclined roof. Default "15-30\xB0".',
+    veryInclinedRoofImageUrl: "Image for the very-inclined option (>30\xB0).",
+    textVeryInclinedRoof: 'Label for very inclined roof. Default ">30\xB0".',
+    defaultInclination: "Degrees (0-90). Preselected value and fallback when the step is disabled.",
+    inclinationStepTitle: "Title for the step."
+  }
+};
+var ORIENTATION = {
+  name: "orientation",
+  title: "Roof orientation (azimuth) step.",
+  summary: "Directly impacts yield estimates.",
+  fields: ["orientationStepEnabled", "defaultOrientation"],
+  fieldDocs: {
+    orientationStepEnabled: "Shows/hides the step. When false, defaultOrientation is fed to the engine.",
+    defaultOrientation: "Degrees 0-360 (0=N, 90=E, 180=S, 270=W)."
+  }
+};
+var PANELS = {
+  name: "panels",
+  title: "Solar panel & kit-category selection step.",
+  summary: "Drives which panel + kit category the lead is sized with.",
+  fields: ["panelStepEnabled", "defaultSolarPanel", "kitCategories", "defaultKitCategoryId", "panelSectionTitle", "panelTitle"],
+  fieldDocs: {
+    panelStepEnabled: "Shows/hides the step. When false, the backend uses defaultSolarPanel + defaultKitCategoryId unattended.",
+    defaultSolarPanel: "ID of the preselected SolarPanel (reference to the client inventory).",
+    kitCategories: "Array of kit categories offered to the lead. Each item: { id, name, description, priority }. Use --from-file for multi-item payloads.",
+    defaultKitCategoryId: "ID of the preselected kit category.",
+    panelSectionTitle: "Navbar/breadcrumb label for the panel section.",
+    panelTitle: "Step title."
+  }
+};
+var CONSUMPTION = {
+  name: "consumption",
+  title: "Electric-consumption input step.",
+  summary: "Controls the input mode and display density of the consumption step.",
+  fields: ["showOnlyOneConsumptionFieldAtATime", "defaultConsumptionIntroductionMode"],
+  fieldDocs: {
+    showOnlyOneConsumptionFieldAtATime: "true = guided mode (one field per screen). false = all fields visible at once.",
+    defaultConsumptionIntroductionMode: "monthlyConsumption (kWh/month) | monthlySpending (EUR/month). User can toggle if both are enabled."
+  }
+};
+var RESULTS = {
+  name: "results",
+  title: "Results screen, contact form and calculation-engine hooks.",
+  summary: "Largest section: visual layout, form fields for lead capture, confirmation modal, and engine toggles (batteries, PPA, alternative endpoint).",
+  fields: [
+    "resultsMode",
+    "resultsBackgroundImageUrl",
+    "hideBackgroundImageInResults",
+    "colorOfBackgroundInResults",
+    "includeLogoInResults",
+    "includeMapInResults",
+    "hideResults",
+    "hideROI",
+    "formTitle",
+    "formSubtitle",
+    "resultsWhenSent",
+    "colorOfResultsPanelBackground",
+    "showDniFieldOnResults",
+    "showPhonePrefixFieldOnResults",
+    "showTypeOfDocumentFieldOnResults",
+    "showDniValidationFieldOnResults",
+    "showPhoneNumberValidationFieldOnResults",
+    "showIdentifierValidationFieldOnResults",
+    "showSurnameValidationFieldOnResults",
+    "showTypeOfClientSelectorOnResults",
+    "titleModalOfConfirm",
+    "textModalOfConfirm",
+    "businessName",
+    "enablePeakPowerLimitation",
+    "includeBatteries",
+    "enabledPPACalculation",
+    "hideCommentField",
+    "alternativeCalculationEndpoint",
+    "alternativeCalculationLoadingMessage",
+    "redirectToShareable"
+  ],
+  fieldDocs: {
+    resultsMode: "Default (ROI, payback, savings) | SolarResource (irradiance map + technical data).",
+    resultsBackgroundImageUrl: "Background image behind the results panel.",
+    hideBackgroundImageInResults: "Hides the background image even when set.",
+    colorOfBackgroundInResults: "Overlay colour on top of the background image. Default rgba(75,55,30,0.7).",
+    colorOfResultsPanelBackground: "Background of the metrics card. Default rgba(0,0,0,0.5).",
+    includeLogoInResults: "Shows the logo on the results screen.",
+    includeMapInResults: "Shows the interactive map with the drawn panels.",
+    hideResults: "true = no metrics shown, only the contact form.",
+    hideROI: "Hides the payback/ROI widget.",
+    formTitle: "Contact form title.",
+    formSubtitle: "Contact form subtitle.",
+    resultsWhenSent: "true = results shown before submit. false = form must be filled first.",
+    showDniFieldOnResults: "Adds a DNI/CIF input to the form.",
+    showPhonePrefixFieldOnResults: "Adds a phone-prefix selector.",
+    showTypeOfDocumentFieldOnResults: "Adds a document-type selector.",
+    showDniValidationFieldOnResults: "Visual DNI validation (green check).",
+    showPhoneNumberValidationFieldOnResults: "Visual phone validation.",
+    showIdentifierValidationFieldOnResults: "Visual identifier validation.",
+    showSurnameValidationFieldOnResults: "Visual surname validation.",
+    showTypeOfClientSelectorOnResults: "Selector for Individual / Company / Community.",
+    titleModalOfConfirm: "Title of the confirmation modal shown before submit.",
+    textModalOfConfirm: "Body of the confirmation modal.",
+    businessName: 'Adds a "Business name" field to the form.',
+    enablePeakPowerLimitation: "Adds a peak-power limiter to the consumption section. Affects engine sizing.",
+    includeBatteries: "Includes battery sizing in the results.",
+    enabledPPACalculation: "Enables PPA (Power Purchase Agreement) modelling.",
+    hideCommentField: "Hides the free-text comment field.",
+    alternativeCalculationEndpoint: "URL to which calculation data is POSTed instead of the default engine endpoint. For white-label integrations.",
+    alternativeCalculationLoadingMessage: "Loading text while awaiting the alternative endpoint response.",
+    redirectToShareable: "After calculation, redirect to the shareable-study URL instead of rendering results in-place."
+  }
+};
+var CUSTOM_FIELDS = {
+  name: "custom-fields",
+  title: "Extra lead fields persisted on the SolarStudy (plugin-gated).",
+  summary: 'Only available when the client has the "studyCustomFields" plugin active.',
+  fields: ["solarStudyCustomFields"],
+  fieldDocs: {
+    solarStudyCustomFields: "Array of custom-field definitions, serialised. Each item: { id, label, type, required, options? }. Types: text|number|select|boolean. Use --from-file to avoid quoting headaches."
+  }
+};
+var SECTIONS = [
+  GENERAL,
+  COVER,
+  SURFACES,
+  CONSUMER,
+  INCLINATION,
+  ORIENTATION,
+  PANELS,
+  CONSUMPTION,
+  RESULTS,
+  CUSTOM_FIELDS
+];
+function getAdvanced(client) {
+  return client.get("/solar-form/config/advanced").then((r) => r.data);
+}
+function putAdvanced(client, payload) {
+  return client.put("/solar-form/config/advanced", payload).then((r) => r.data);
+}
+function formatFieldsHelp(section) {
+  const longest = Math.max(...section.fields.map((f) => f.length));
+  return [
+    section.title,
+    "",
+    section.summary,
+    "",
+    "Fields:",
+    ...section.fields.map((f) => `  ${f.padEnd(longest)}  ${section.fieldDocs[f] ?? ""}`),
+    "",
+    "Operations: get | set [--set key=value] [--from-file] [--<field> <value>] | edit"
+  ].join("\n");
+}
+function attachSectionCommand(advanced, section) {
+  const sec = advanced.command(section.name).description(formatFieldsHelp(section));
+  sec.command("get").description(`Fetch only the ${section.name} fields of the advanced config.`).action(async () => {
+    try {
+      const global = getGlobalOpts2(sec);
+      const client = createServiceClient("solar", global);
+      const doc = await getAdvanced(client);
+      output(pickKeys(doc, section.fields), global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  const setCmd = sec.command("set").description(
+    `Update the ${section.name} fields of the advanced config.
+Combine per-field flags, repeatable --set key=value, and/or --from-file.
+Internally GETs the current config, merges this section, and PUTs the whole thing.`
+  ).option("--set <entries...>", "Field assignments as key=value (repeatable)").option("--from-file <path>", "Load a partial payload from a JSON file");
+  for (const field of section.fields) {
+    setCmd.option(`--${kebab(field)} <value>`, section.fieldDocs[field] ?? field);
+  }
+  setCmd.action(async (opts) => {
+    try {
+      const global = getGlobalOpts2(sec);
+      const client = createServiceClient("solar", global);
+      const flagValues = {};
+      for (const field of section.fields) {
+        const val = opts[field];
+        if (val !== void 0) flagValues[field] = coerceValue(String(val));
+      }
+      const partial = buildPayload(flagValues, opts.set, opts.fromFile, section.fields);
+      if (Object.keys(partial).length === 0) {
+        outputError(new Error("No fields provided. Use flags, --set, or --from-file."));
+        return;
+      }
+      const current = await getAdvanced(client);
+      const merged = { ...current, ...partial };
+      const res = await putAdvanced(client, merged);
+      output(pickKeys(res, section.fields), global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  sec.command("edit").description(`Open $EDITOR on the ${section.name} subset of the advanced config, then PUT the whole config.`).action(async () => {
+    try {
+      const global = getGlobalOpts2(sec);
+      const client = createServiceClient("solar", global);
+      const current = await getAdvanced(client);
+      const subset = pickKeys(current, section.fields);
+      const edited = editJson(subset, `advanced-${section.name}`);
+      const merged = { ...current, ...edited };
+      const res = await putAdvanced(client, merged);
+      output(pickKeys(res, section.fields), global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+}
+function registerAdvancedCommands(solarform) {
+  const advanced = solarform.command("advanced").description(
+    "SolarForm Advanced configuration (white-label microsite).\nEach subcommand maps 1:1 with a section of the admin accordion and with a\nsubset of fields in the AdvancedSolarFormConfig DTO.\n\nWhole-payload operations:\n  get                    Fetch the full advanced config.\n  update                 Merge a partial payload (--set / --from-file).\n  delete                 Delete the authenticated client's advanced config.\n  init-default           Create the default config for a clientUID (superadmin / localhost).\n\nSections (each: get / set / edit):\n" + SECTIONS.map((s) => `  ${s.name.padEnd(14)} ${s.title}`).join("\n") + "\n\nConventions:\n  --set <field>=<value>  Assign a single field (repeatable).\n  --from-file <path>     Load a partial payload from JSON.\n  edit                   Open $EDITOR on the section's current state."
+  );
+  advanced.command("get").description("Fetch the full AdvancedSolarFormConfig for the authenticated client.").action(async () => {
+    try {
+      const global = getGlobalOpts2(advanced);
+      const client = createServiceClient("solar", global);
+      const data = await getAdvanced(client);
+      output(data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  advanced.command("update").description("Merge a partial AdvancedSolarFormConfig from --set / --from-file and PUT.").option("--set <entries...>", "Field assignments as key=value (repeatable)").option("--from-file <path>", "Load a partial payload from a JSON file").action(async (opts) => {
+    try {
+      const global = getGlobalOpts2(advanced);
+      const client = createServiceClient("solar", global);
+      const partial = buildPayload({}, opts.set, opts.fromFile);
+      if (Object.keys(partial).length === 0) {
+        outputError(new Error("No fields provided. Use --set or --from-file."));
+        return;
+      }
+      const current = await getAdvanced(client);
+      const res = await putAdvanced(client, { ...current, ...partial });
+      output(res, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  advanced.command("delete").description("Delete the authenticated client's advanced config.").action(async () => {
+    try {
+      const global = getGlobalOpts2(advanced);
+      const client = createServiceClient("solar", global);
+      const res = await client.delete("/solar-form/config/advanced");
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  advanced.command("init-default").description(
+    'Create the default advanced config for a clientUID.\nRestricted: requires the "suntropy-auth: <clientUID>" header or localhost execution.'
+  ).requiredOption("--client-uid <uid>", "Client UID to initialise").option("--email <email>", "Operator email (optional)").option("--url <url>", "Site URL (optional)").action(async (opts) => {
+    try {
+      const global = getGlobalOpts2(advanced);
+      const client = createServiceClient("solar", global);
+      const params = {};
+      if (opts.email) params.email = opts.email;
+      if (opts.url) params.url = opts.url;
+      const res = await client.post(
+        `/solar-form/config/default/advanced/${opts.clientUid}`,
+        {},
+        { params, headers: { "suntropy-auth": opts.clientUid } }
+      );
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  for (const section of SECTIONS) attachSectionCommand(advanced, section);
+}
+
+// src/commands/config/solarform.ts
+var SOLARFORM_KEYS = [
+  "idSolarFormConfig",
+  "clientUID",
+  "solarFormUrl",
+  "enabled",
+  "notificationEmailAddress",
+  "confirmationReplytoEmailAdress",
+  "notificationEmailSubject",
+  "enableNotificationEmail",
+  "enableSendConfirmationEmailToClient",
+  "confirmationEmailSubject",
+  "confirmationEmailBody",
+  "enableConfirmationEmailBody",
+  "formTitle",
+  "formSubtitle",
+  "formBackgroundColor",
+  "formBackgroundImageURL",
+  "formFaviconUrl",
+  "locationMode",
+  "hideFinalProjectPrice",
+  "enableRequiredPhoneNumberField",
+  "enableRequiredNameField",
+  "callToActionButtonText",
+  "renderPDF",
+  "defaultSolarStudyTemplateId",
+  "redirectUrl",
+  "privacyPolicy",
+  "advertisingPolicy",
+  "generateShareable",
+  "incentiveTemplateGroup",
+  "disabledSolarForm",
+  "redirectOnClose"
+];
+function registerSolarformConfigCommands(configRoot) {
+  const solarform = configRoot.command("solarform").description(
+    'SolarForm (basic) and SolarForm Advanced configuration (solar service).\nThe basic config controls the public lead-capture form (URL, notifications,\nappearance, mandatory fields). The advanced subtree configures the modern\nwhite-label widget rendered by the "advanced-solar-form" microsite.\n\nEndpoints:\n  GET  /solar-form/get-solar-form-config?getParameters=\n  GET  /solar-form/solar-form-config             (public, resolved by Origin)\n  POST /solar-form/solar-form-config?getParameters=\n  PUT  /solar-form/solar-form-config/:id'
+  );
+  solarform.command("get").description("Fetch the current SolarForm configuration for the authenticated client.").option("--with-parameters", "Include the associated SolarFormParameters in the response").action(async (opts) => {
+    try {
+      const global = getGlobalOpts2(solarform);
+      const client = createServiceClient("solar", global);
+      const params = {};
+      if (opts.withParameters) params.getParameters = "true";
+      const res = await client.get("/solar-form/get-solar-form-config", { params });
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  solarform.command("create").description(
+    "Create a new SolarFormConfig for the authenticated client.\n--url is the public slug/URL of the form. Other fields may come from flags,\n--set key=value, or --from-file. Accepted keys:\n  " + SOLARFORM_KEYS.join(", ")
+  ).requiredOption("--url <slug>", "Public URL/slug of the form (solarFormUrl)").option("--enabled [bool]", "Whether the form is publicly enabled", "true").option("--form-title <text>", "Form title displayed to the end user").option("--form-subtitle <text>", "Form subtitle").option("--form-background-color <color>", "Background colour of the form container").option("--form-background-image-url <url>", "Background image URL").option("--form-favicon-url <url>", "Favicon URL").option("--call-to-action-button-text <text>", "Primary CTA button label").option("--notification-email-address <email>", "Where new lead notifications go").option("--location-mode <mode>", "fullSurface | locationOnly").option("--with-parameters", "Include SolarFormParameters in the response").option("--set <entries...>", "Additional field assignments as key=value (repeatable)").option("--from-file <path>", "Load a payload from a JSON file").action(async (opts) => {
+    try {
+      const global = getGlobalOpts2(solarform);
+      const client = createServiceClient("solar", global);
+      const flagValues = {
+        solarFormUrl: opts.url,
+        enabled: opts.enabled === void 0 ? void 0 : opts.enabled === true || opts.enabled === "true",
+        formTitle: opts.formTitle,
+        formSubtitle: opts.formSubtitle,
+        formBackgroundColor: opts.formBackgroundColor,
+        formBackgroundImageURL: opts.formBackgroundImageUrl,
+        formFaviconUrl: opts.formFaviconUrl,
+        callToActionButtonText: opts.callToActionButtonText,
+        notificationEmailAddress: opts.notificationEmailAddress,
+        locationMode: opts.locationMode
+      };
+      const payload = buildPayload(flagValues, opts.set, opts.fromFile, SOLARFORM_KEYS);
+      const params = {};
+      if (opts.withParameters) params.getParameters = "true";
+      const res = await client.post("/solar-form/solar-form-config", payload, { params });
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  solarform.command("update <idSolarFormConfig>").description("Update an existing SolarFormConfig by numeric ID.").option("--set <entries...>", "Additional field assignments as key=value (repeatable)").option("--from-file <path>", "Load a payload from a JSON file").option("--form-title <text>", "Form title").option("--form-subtitle <text>", "Form subtitle").option("--enabled [bool]", "Whether the form is publicly enabled").option("--disabled-solar-form [bool]", "Explicit disable flag").action(async (idSolarFormConfig, opts) => {
+    try {
+      const global = getGlobalOpts2(solarform);
+      const client = createServiceClient("solar", global);
+      const flagValues = {
+        formTitle: opts.formTitle,
+        formSubtitle: opts.formSubtitle,
+        enabled: opts.enabled === void 0 ? void 0 : opts.enabled === true || opts.enabled === "true",
+        disabledSolarForm: opts.disabledSolarForm === void 0 ? void 0 : opts.disabledSolarForm === true || opts.disabledSolarForm === "true"
+      };
+      const payload = buildPayload(flagValues, opts.set, opts.fromFile, SOLARFORM_KEYS);
+      if (Object.keys(payload).length === 0) {
+        outputError(new Error("No fields to update."));
+        return;
+      }
+      const res = await client.put(`/solar-form/solar-form-config/${idSolarFormConfig}`, payload);
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  solarform.command("edit").description("Fetch the current SolarForm config, open $EDITOR, and PUT the edited result.").action(async () => {
+    try {
+      const global = getGlobalOpts2(solarform);
+      const client = createServiceClient("solar", global);
+      const current = await client.get("/solar-form/get-solar-form-config");
+      const doc = current.data;
+      const id = doc?.idSolarFormConfig;
+      if (!id) {
+        outputError(new Error('No existing SolarFormConfig found to edit. Use "create" first.'));
+        return;
+      }
+      const subset = pickKeys(doc, SOLARFORM_KEYS);
+      const edited = editJson(subset, "solarform");
+      const res = await client.put(`/solar-form/solar-form-config/${id}`, edited);
+      output(res.data, global);
+    } catch (err) {
+      outputError(handleApiError(err));
+    }
+  });
+  registerAdvancedCommands(solarform);
+}
+
 // src/commands/config.ts
 function registerConfigCommands(program2) {
-  const cfg = program2.command("config").description("CLI configuration management");
+  const cfg = program2.command("config").description(
+    "CLI configuration (profiles, server, token) plus tenant configuration\n(theme & SolarForm / SolarForm Advanced) served by the security and solar backends."
+  );
   cfg.command("set <key> <value>").description("Set a configuration value. Keys: server, token, activeProfile").option("--profile <name>", "Profile to modify").action((key, value, opts) => {
     try {
       if (key === "activeProfile") {
@@ -458,11 +1158,13 @@ function registerConfigCommands(program2) {
       outputError(err);
     }
   });
+  registerThemeCommands(cfg);
+  registerSolarformConfigCommands(cfg);
 }
 
 // src/commands/inventory/factory.ts
 import { Command } from "commander";
-function getGlobalOpts2(cmd) {
+function getGlobalOpts3(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -470,8 +1172,8 @@ function getGlobalOpts2(cmd) {
 function parseData(data) {
   if (!data) return void 0;
   if (data === "-") {
-    const { readFileSync: readFileSync5 } = __require("fs");
-    const input = readFileSync5(0, "utf-8");
+    const { readFileSync: readFileSync6 } = __require("fs");
+    const input = readFileSync6(0, "utf-8");
     return JSON.parse(input);
   }
   return JSON.parse(data);
@@ -481,7 +1183,7 @@ function createResourceCommands(cfg) {
   const service = cfg.service || "solar";
   cmd.command("list").description(`List ${cfg.singular}s with pagination. Fields: ${cfg.listFields.join(", ")}`).option("--limit <n>", "Max results", "20").option("--offset <n>", "Skip results", "0").option("--active-only", "Only active items (exclude inactive)").action(async (opts) => {
     try {
-      const global = getGlobalOpts2(cmd);
+      const global = getGlobalOpts3(cmd);
       const client = createServiceClient(service, global);
       const params = {
         limit: parseInt(opts.limit),
@@ -516,7 +1218,7 @@ function createResourceCommands(cfg) {
   });
   cmd.command("get <id>").description(`Get a ${cfg.singular} by ID. All fields returned by default.`).action(async (id) => {
     try {
-      const global = getGlobalOpts2(cmd);
+      const global = getGlobalOpts3(cmd);
       const client = createServiceClient(service, global);
       if (cfg.getViaFilter) {
         const res = await client.get(cfg.basePath, { params: { unactive: true } });
@@ -539,7 +1241,7 @@ function createResourceCommands(cfg) {
   });
   cmd.command("create").description(`Create a new ${cfg.singular}. Pass JSON via --data or stdin (--data -)`).requiredOption("--data <json>", "JSON data (or - for stdin)").action(async (opts) => {
     try {
-      const global = getGlobalOpts2(cmd);
+      const global = getGlobalOpts3(cmd);
       const client = createServiceClient(service, global);
       const body = parseData(opts.data);
       const res = await client.post(cfg.basePath, body);
@@ -550,7 +1252,7 @@ function createResourceCommands(cfg) {
   });
   cmd.command("update <id>").description(`Update a ${cfg.singular}`).requiredOption("--data <json>", "JSON data with fields to update (or - for stdin)").action(async (id, opts) => {
     try {
-      const global = getGlobalOpts2(cmd);
+      const global = getGlobalOpts3(cmd);
       const client = createServiceClient(service, global);
       const body = parseData(opts.data);
       if (cfg.putBodyOnly) {
@@ -566,7 +1268,7 @@ function createResourceCommands(cfg) {
   });
   cmd.command("delete <id>").description(`Delete a ${cfg.singular}`).action(async (id) => {
     try {
-      const global = getGlobalOpts2(cmd);
+      const global = getGlobalOpts3(cmd);
       const client = createServiceClient(service, global);
       const res = await client.delete(`${cfg.basePath}/${id}`);
       output(res.data ?? { success: true, deleted: id }, global);
@@ -577,7 +1279,7 @@ function createResourceCommands(cfg) {
   if (cfg.batchDeletePath) {
     cmd.command("delete-batch").description(`Batch delete ${cfg.singular}s`).requiredOption("--ids <ids>", "Comma-separated IDs").action(async (opts) => {
       try {
-        const global = getGlobalOpts2(cmd);
+        const global = getGlobalOpts3(cmd);
         const client = createServiceClient(service, global);
         const ids = opts.ids.split(",").map((s) => s.trim());
         const res = await client.post(`${cfg.basePath}/${cfg.batchDeletePath}`, ids);
@@ -589,7 +1291,7 @@ function createResourceCommands(cfg) {
   }
   cmd.command("filter").description(`Advanced filter for ${cfg.singular}s. Pass filter query as JSON.`).requiredOption("--query <json>", "Filter query JSON (or - for stdin)").option("--limit <n>", "Max results", "20").option("--offset <n>", "Skip results", "0").action(async (opts) => {
     try {
-      const global = getGlobalOpts2(cmd);
+      const global = getGlobalOpts3(cmd);
       const client = createServiceClient(service, global);
       const query = parseData(opts.query);
       const filterUrl = cfg.filterPath || `${cfg.basePath}/filter`;
@@ -609,15 +1311,15 @@ function createResourceCommands(cfg) {
 }
 
 // src/commands/inventory/kits.ts
-function getGlobalOpts3(cmd) {
+function getGlobalOpts4(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
 }
 function parseData2(data) {
   if (data === "-") {
-    const { readFileSync: readFileSync5 } = __require("fs");
-    return JSON.parse(readFileSync5(0, "utf-8"));
+    const { readFileSync: readFileSync6 } = __require("fs");
+    return JSON.parse(readFileSync6(0, "utf-8"));
   }
   return JSON.parse(data);
 }
@@ -636,7 +1338,7 @@ function registerKitsCommands(inventory) {
   if (kitsCreateIdx !== -1) kits.commands.splice(kitsCreateIdx, 1);
   kits.command("archive <kitId>").description("Archive a solar kit (soft-disable)").action(async (kitId) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.put(`/solar-kits/archive/${kitId}`);
       output(res.data ?? { success: true, archived: kitId }, global);
@@ -647,7 +1349,7 @@ function registerKitsCommands(inventory) {
   const kitPanels = kits.command("panels").description("Manage kit solar panels");
   kitPanels.command("list").description("List all kit solar panels. Fields: idKitSolarPanel, name, manufacturer, peakPower, efficiency, costPerUnit").option("--limit <n>", "Max results", "50").option("--offset <n>", "Skip results", "0").action(async (opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.get("/solar-kits/solar-panels", { params: { limit: opts.limit, offset: opts.offset } });
       output(res.data, global);
@@ -657,7 +1359,7 @@ function registerKitsCommands(inventory) {
   });
   kitPanels.command("get <id>").description("Get a kit solar panel by ID").action(async (id) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.post("/solar-kits/solar-panels/filter", { idKitSolarPanel: id });
       const data = Array.isArray(res.data) ? res.data[0] : res.data?.data?.[0] || res.data;
@@ -668,7 +1370,7 @@ function registerKitsCommands(inventory) {
   });
   kitPanels.command("create").description("Create a kit solar panel").requiredOption("--data <json>", "JSON data").action(async (opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.post("/solar-kits/solar-panels", parseData2(opts.data));
       output(res.data, global);
@@ -678,7 +1380,7 @@ function registerKitsCommands(inventory) {
   });
   kitPanels.command("update <id>").description("Update a kit solar panel").requiredOption("--data <json>", "JSON data").action(async (id, opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.put(`/solar-kits/solar-panels/${id}`, parseData2(opts.data));
       output(res.data, global);
@@ -688,7 +1390,7 @@ function registerKitsCommands(inventory) {
   });
   kitPanels.command("delete <id>").description("Delete a kit solar panel").action(async (id) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.delete(`/solar-kits/solar-panels/${id}`);
       output(res.data ?? { success: true, deleted: id }, global);
@@ -698,7 +1400,7 @@ function registerKitsCommands(inventory) {
   });
   kitPanels.command("featured <kitPanelId>").description("List solar kits that feature this kit panel").action(async (kitPanelId) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-kits/solar-panels/findFeaturedSolarKits/${kitPanelId}`);
       output(res.data, global);
@@ -709,7 +1411,7 @@ function registerKitsCommands(inventory) {
   const kitInverters = kits.command("inverters").description("Manage kit inverters");
   kitInverters.command("list").description("List all kit inverters. Fields: idKitInverter, name, manufacturer, nominalPower, efficiency, costPerUnit").option("--limit <n>", "Max results", "50").option("--offset <n>", "Skip results", "0").action(async (opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.get("/solar-kits/inverters", { params: { limit: opts.limit, offset: opts.offset } });
       output(res.data, global);
@@ -719,7 +1421,7 @@ function registerKitsCommands(inventory) {
   });
   kitInverters.command("create").description("Create a kit inverter").requiredOption("--data <json>", "JSON data").action(async (opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.post("/solar-kits/inverters", parseData2(opts.data));
       output(res.data, global);
@@ -729,7 +1431,7 @@ function registerKitsCommands(inventory) {
   });
   kitInverters.command("update <id>").description("Update a kit inverter").requiredOption("--data <json>", "JSON data").action(async (id, opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.put(`/solar-kits/inverters/${id}`, parseData2(opts.data));
       output(res.data, global);
@@ -739,7 +1441,7 @@ function registerKitsCommands(inventory) {
   });
   kitInverters.command("delete <id>").description("Delete a kit inverter").action(async (id) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.delete(`/solar-kits/inverters/${id}`);
       output(res.data ?? { success: true, deleted: id }, global);
@@ -749,7 +1451,7 @@ function registerKitsCommands(inventory) {
   });
   kitInverters.command("featured <kitInverterId>").description("List solar kits that feature this kit inverter").action(async (kitInverterId) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-kits/inverters/findFeaturedSolarKits/${kitInverterId}`);
       output(res.data, global);
@@ -760,7 +1462,7 @@ function registerKitsCommands(inventory) {
   const kitBatteries = kits.command("batteries").description("Manage kit batteries");
   kitBatteries.command("list").description("List all kit batteries. Fields: idKitBattery, name, manufacturer, capacity, costPerUnit").option("--limit <n>", "Max results", "50").option("--offset <n>", "Skip results", "0").action(async (opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.get("/solar-kits/batteries", { params: { limit: opts.limit, offset: opts.offset } });
       output(res.data, global);
@@ -770,7 +1472,7 @@ function registerKitsCommands(inventory) {
   });
   kitBatteries.command("create").description("Create a kit battery").requiredOption("--data <json>", "JSON data").action(async (opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.post("/solar-kits/batteries", parseData2(opts.data));
       output(res.data, global);
@@ -780,7 +1482,7 @@ function registerKitsCommands(inventory) {
   });
   kitBatteries.command("delete <id>").description("Delete a kit battery").action(async (id) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const res = await client.delete(`/solar-kits/batteries/${id}`);
       output(res.data ?? { success: true, deleted: id }, global);
@@ -792,7 +1494,7 @@ function registerKitsCommands(inventory) {
     'Assemble a solar kit from existing components by ID.\nReferences kit panels, inverters, batteries, and custom assets by their IDs.\n\nCustom assets format: --custom-asset <assetId>:<units> (repeatable)\n\nExamples:\n  suntropy inventory kits assemble --name "Kit 5kW" --panel 123 --inverter 456 --panels-count 12 --price 6500\n  suntropy inventory kits assemble --name "Kit Premium" --panel 123 --inverter 456 --battery 789 \\\n    --panels-count 12 --inverters-count 1 --batteries-count 1 --peak-power 5.4 --price 8500 \\\n    --custom-asset 100:12 --custom-asset 200:1 --phase single_phase'
   ).requiredOption("--name <identifier>", "Kit name/identifier").option("--panel <kitPanelId>", "Kit panel ID (idKitSolarPanel)").option("--inverter <kitInverterId>", "Kit inverter ID (idKitInverter)").option("--battery <batteryId>", "Battery ID from inventory (batteryId)").option("--panels-count <n>", "Number of panels", "12").option("--inverters-count <n>", "Number of inverters", "1").option("--batteries-count <n>", "Number of batteries", "0").option("--peak-power <kW>", "Total peak power in kW").requiredOption("--price <eur>", "Kit price in EUR (required)").option("--phase <type>", "Phase: single_phase or three_phase", "single_phase").option("--coplanar", "Coplanar mounting").option("--taxes <pct>", "Default tax percentage", "21").option("--custom-asset <id:units>", "Custom asset as id:units (repeatable)", collectCustomAssets, []).action(async (opts) => {
     try {
-      const global = getGlobalOpts3(kits);
+      const global = getGlobalOpts4(kits);
       const client = createServiceClient("solar", global);
       const validationErrors = [];
       if (opts.panel) {
@@ -893,7 +1595,7 @@ function collectCustomAssets(value, previous) {
 }
 
 // src/commands/inventory/manufacturers.ts
-function getGlobalOpts4(cmd) {
+function getGlobalOpts5(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -902,7 +1604,7 @@ function registerManufacturersCommands(inventory) {
   const mfr = inventory.command("manufacturers").description("Manage manufacturers (referenced by all inventory devices)");
   mfr.command("list").description("List all manufacturers. Fields: idManufacturer, name, imageUrl").action(async () => {
     try {
-      const global = getGlobalOpts4(mfr);
+      const global = getGlobalOpts5(mfr);
       const client = createServiceClient("solar", global);
       const res = await client.get("/manufacturers");
       output(res.data, global);
@@ -912,7 +1614,7 @@ function registerManufacturersCommands(inventory) {
   });
   mfr.command("create").description("Create a new manufacturer").requiredOption("--data <json>", 'JSON: { "name": "Manufacturer Name", "imageUrl": "..." }').action(async (opts) => {
     try {
-      const global = getGlobalOpts4(mfr);
+      const global = getGlobalOpts5(mfr);
       const client = createServiceClient("solar", global);
       const body = JSON.parse(opts.data);
       const res = await client.post("/manufacturers", body);
@@ -924,7 +1626,7 @@ function registerManufacturersCommands(inventory) {
 }
 
 // src/commands/inventory/custom-fields.ts
-function getGlobalOpts5(cmd) {
+function getGlobalOpts6(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -939,7 +1641,7 @@ function registerCustomFieldsCommands(inventory) {
   );
   fields.command("list").description("List all custom fields").action(async () => {
     try {
-      const global = getGlobalOpts5(fields);
+      const global = getGlobalOpts6(fields);
       const client = createServiceClient("solar", global);
       const res = await client.get("/custom-asset/custom-field/all");
       output(res.data, global);
@@ -949,7 +1651,7 @@ function registerCustomFieldsCommands(inventory) {
   });
   fields.command("get <id>").description("Get a custom field by ID").action(async (id) => {
     try {
-      const global = getGlobalOpts5(fields);
+      const global = getGlobalOpts6(fields);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/custom-asset/custom-field/id/${id}`);
       output(res.data, global);
@@ -967,7 +1669,7 @@ Example:
   suntropy inventory custom-fields create --data '{"label":"Size","type":"options","customAssetTypeId":1,"customFieldOptions":[{"label":"S","value":"s"},{"label":"M","value":"m"},{"label":"L","value":"l"}]}'`
   ).requiredOption("--data <json>", "Field definition as JSON").action(async (opts) => {
     try {
-      const global = getGlobalOpts5(fields);
+      const global = getGlobalOpts6(fields);
       const client = createServiceClient("solar", global);
       const body = parseData3(opts.data);
       const res = await client.post("/custom-asset/custom-field", body);
@@ -978,7 +1680,7 @@ Example:
   });
   fields.command("update <id>").description("Update a custom field").requiredOption("--data <json>", "Updated field data as JSON").action(async (id, opts) => {
     try {
-      const global = getGlobalOpts5(fields);
+      const global = getGlobalOpts6(fields);
       const client = createServiceClient("solar", global);
       const body = parseData3(opts.data);
       const res = await client.put(`/custom-asset/custom-field/${id}`, body);
@@ -989,7 +1691,7 @@ Example:
   });
   fields.command("delete <id>").description("Delete a custom field").action(async (id) => {
     try {
-      const global = getGlobalOpts5(fields);
+      const global = getGlobalOpts6(fields);
       const client = createServiceClient("solar", global);
       const res = await client.delete(`/custom-asset/custom-field/${id}`);
       output(res.data ?? { success: true, deleted: id }, global);
@@ -1092,7 +1794,7 @@ function registerInventoryCommands(program2) {
 }
 
 // src/commands/studies/builder.ts
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync3, existsSync as existsSync2 } from "fs";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync4, existsSync as existsSync2 } from "fs";
 
 // node_modules/uuid/dist/esm-node/rng.js
 import crypto from "crypto";
@@ -1345,10 +2047,10 @@ function readStudy(filePath) {
   if (!existsSync2(filePath)) {
     throw new Error(`Study file not found: ${filePath}. Use 'studies init --file ${filePath}' to create one.`);
   }
-  return JSON.parse(readFileSync2(filePath, "utf-8"));
+  return JSON.parse(readFileSync3(filePath, "utf-8"));
 }
 function writeStudy(filePath, study) {
-  writeFileSync3(filePath, JSON.stringify(study, null, 2), "utf-8");
+  writeFileSync4(filePath, JSON.stringify(study, null, 2), "utf-8");
 }
 function updateStudy(filePath, updater) {
   const study = readStudy(filePath);
@@ -1381,7 +2083,7 @@ function deepMerge(target, source) {
     }
   }
 }
-function getGlobalOpts6(cmd) {
+function getGlobalOpts7(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -1406,7 +2108,7 @@ function registerStudyBuilderCommands(studies) {
         stepsProgress,
         completionPercentage: 0,
         missing
-      }, getGlobalOpts6(studies));
+      }, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1422,7 +2124,7 @@ function registerStudyBuilderCommands(studies) {
         stepsProgress,
         completionPercentage: calculateCompletionPercentage(stepsProgress),
         missing
-      }, getGlobalOpts6(studies));
+      }, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1432,7 +2134,7 @@ function registerStudyBuilderCommands(studies) {
   ).option("--file <path>", "Study file path").option("--state-id <n>", "Solar study metadata state ID").option("--credit-amount <n>", "Credit amount to consume").option("--save-as-new", "Force save as new study (even if _id exists)").action(async (opts) => {
     try {
       const filePath = resolveFile(opts);
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const study = readStudy(filePath);
       const { stepsProgress } = evaluateSteps(study);
       const progress = study.solarStudyProgress;
@@ -1475,7 +2177,7 @@ function registerStudyBuilderCommands(studies) {
   ).option("--file <path>", "Output file path").action(async (studyId, opts) => {
     try {
       const filePath = resolveFile(opts);
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
       const study = res.data;
@@ -1504,7 +2206,7 @@ function registerStudyBuilderCommands(studies) {
         study.name = opts.name;
         return void 0;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1515,7 +2217,7 @@ function registerStudyBuilderCommands(studies) {
         study.market = opts.market;
         return void 0;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1540,7 +2242,7 @@ function registerStudyBuilderCommands(studies) {
         study.clientDetails = cd;
         return void 0;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1549,7 +2251,7 @@ function registerStudyBuilderCommands(studies) {
     "Set ATR tariff and geographical zone. Auto-sets phase (>3 periods \u2192 three_phase).\nCommon tariff IDs (Spain): 13=2.0TD (3 periods), 14=3.0TD (6 periods)\nZone IDs (Spain): 1=Peninsula, 2=Canarias, 3=Baleares\nExample: suntropy studies set tariff --file study.json --tariff-id 13 --zone-id 1"
   ).option("--file <path>", "Study file path").requiredOption("--tariff-id <n>", "ATR tariff ID").option("--zone-id <n>", "Geographical zone ID", "1").option("--market <code>", "Market code for tariff lookup", "es").action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const client = createServiceClient("periods", global);
       const tariffRes = await client.get("/tarifas-atr", {
         params: { market: opts.market }
@@ -1613,7 +2315,7 @@ Examples:
         }
         return void 0;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1634,7 +2336,7 @@ Examples:
   suntropy studies set consumption --file study.json --monthly '{"1":350,"2":320,...}'`
   ).option("--file <path>", "Study file path").option("--from-file <curvePath>", "Load PowerCurve from JSON file").option("--annual <kWh>", "Annual consumption in kWh").option("--pattern <name>", "Pattern: Balance, Nightly, Morning, Afternoon, Domestic, Commercial").option("--by-period <json>", 'Period consumption JSON: {"p1":N,"p2":N,...}').option("--monthly <json>", 'Monthly consumption JSON: {"1":N,...,"12":N}').option("--monthly-by-period <json>", 'Monthly by period: {"1":{"p1":N,...},...}').option("--tariff <code>", "Tariff code for profile lookup (default: from study)").option("--market <code>", "Market code (default: from study)").action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const filePath = resolveFile(opts);
       const study = readStudy(filePath);
       const studyTariff = study.atrTariff?.nombre || "3.0TD";
@@ -1645,7 +2347,7 @@ Examples:
       let curveData;
       let introductionMode;
       if (opts.fromFile) {
-        curveData = JSON.parse(readFileSync2(opts.fromFile, "utf-8"));
+        curveData = JSON.parse(readFileSync3(opts.fromFile, "utf-8"));
         introductionMode = "upload";
       } else if (opts.annual && opts.pattern) {
         const profilesClient = createServiceClient("profiles", global);
@@ -1714,7 +2416,7 @@ Examples:
         if (opts.power) surface.installedPower = parseFloat(opts.power);
         if (opts.panelsCount) surface.panelNumber = parseInt(opts.panelsCount);
         if (opts.production) {
-          surface.production = JSON.parse(readFileSync2(opts.production, "utf-8"));
+          surface.production = JSON.parse(readFileSync3(opts.production, "utf-8"));
         }
         study.location = { lat: parseFloat(opts.lat), lng: parseFloat(opts.lon) };
         study.mapCenter = { lat: parseFloat(opts.lat), lng: parseFloat(opts.lon) };
@@ -1723,7 +2425,7 @@ Examples:
         study.surfaces = surfaces;
         return "surfaces";
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1740,7 +2442,7 @@ Examples:
         study.surfaces = surfaces.length > 0 ? surfaces : void 0;
         return "surfaces";
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1749,7 +2451,7 @@ Examples:
     'Set solar panel for the study. Auto-sets peakPowerIntroductionMode to "solarPanel".\nFetches full panel data from inventory.\nExample: suntropy studies set panel --file study.json --panel-id 456 --panels-count 12'
   ).option("--file <path>", "Study file path").requiredOption("--panel-id <n>", "Solar panel ID from inventory").option("--panels-count <n>", "Number of panels").action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const solarClient = createServiceClient("solar", global);
       const panelRes = await solarClient.get(`/solar-panels/${opts.panelId}`);
       const panel = panelRes.data;
@@ -1774,7 +2476,7 @@ Examples:
     'Set solar kit for the study. Auto-sets peakPowerIntroductionMode to "solarKit".\nFetches full kit data from inventory.\nExample: suntropy studies set kit --file study.json --kit-id 123'
   ).option("--file <path>", "Study file path").requiredOption("--kit-id <n>", "Solar kit ID from inventory").action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const solarClient = createServiceClient("solar", global);
       const kitsRes = await solarClient.get("/solar-kits", { params: { unactive: true } });
       const allKits = Array.isArray(kitsRes.data) && Array.isArray(kitsRes.data[0]) ? kitsRes.data[0] : Array.isArray(kitsRes.data) ? kitsRes.data : kitsRes.data?.data || [];
@@ -1800,7 +2502,7 @@ Examples:
     "Set inverter(s) for the study (when using solarPanel mode).\nExample: suntropy studies set inverter --file study.json --inverter-id 789"
   ).option("--file <path>", "Study file path").requiredOption("--inverter-id <ids>", "Inverter ID(s), comma-separated for multiple").action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const solarClient = createServiceClient("solar", global);
       const ids = opts.inverterId.split(",").map((s) => parseInt(s.trim()));
       const inverters = [];
@@ -1827,7 +2529,7 @@ Examples:
         study.instalationPhaseNumber = opts.phase;
         return void 0;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1853,7 +2555,7 @@ Examples:
         study.economicResults = er;
         return void 0;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1862,7 +2564,7 @@ Examples:
     "Set selected custom assets for the study.\nExample: suntropy studies set custom-assets --file study.json --asset 100:12 --asset 200:1"
   ).option("--file <path>", "Study file path").requiredOption("--asset <id:qty>", "Custom asset as id:quantity (repeatable)", collectAssets, []).action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const solarClient = createServiceClient("solar", global);
       const assets = [];
       for (const { id, quantity } of opts.asset) {
@@ -1893,7 +2595,7 @@ Examples:
         }
         return void 0;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1912,7 +2614,7 @@ Example: suntropy studies set data --file study.json --data '{"referenceId":"REF
         deepMerge(study, parsed);
         return cascadeField;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -1921,7 +2623,7 @@ Example: suntropy studies set data --file study.json --data '{"referenceId":"REF
     "Calculate production for study surfaces using backend API.\nExample: suntropy studies calculate production --file study.json [--surface-index 0 | --all-surfaces]"
   ).option("--file <path>", "Study file path").option("--surface-index <n>", "Calculate for specific surface index").option("--all-surfaces", "Calculate for all surfaces").option("--losses <n>", "Losses percentage", "14").action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const filePath = resolveFile(opts);
       const study = readStudy(filePath);
       const surfaces = study.surfaces;
@@ -1968,7 +2670,7 @@ Example: suntropy studies set data --file study.json --data '{"referenceId":"REF
     "Calculate energy results replicating frontend SolarResultCalculator.\nComputes: net consumption, excesses, spending/savings by period, coverage.\nRequires: consumption, production, energyPrices, atrTariff.\nExample: suntropy studies calculate-results --file study.json"
   ).option("--file <path>", "Study file path").action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const filePath = resolveFile(opts);
       const study = readStudy(filePath);
       const consumption = study.consumption;
@@ -2120,7 +2822,7 @@ Example: suntropy studies set data --file study.json --data '{"referenceId":"REF
     "Optimize peak power based on consumption.\n\nSupports two modes:\n  - Panel mode (default or when solarPanel is set): iterates peak power\n  - Kit mode (when solarKit is set or --use-kits): evaluates available kits\n\nOptimization criteria (pick one):\n  --energy-savings <pct>     Target energy savings percentage\n  --raw-consumption <pct>    Production as percentage of consumption\n  --max-excesses <pct>       Max excesses as percentage of production\n  --max-overproduction-months <n>  Max months with overproduction\n\nSurface constraints:\n  If surfaces have area + panel dimensions, max panels per surface is calculated.\n  Without area, no surface constraint is applied (unlimited space).\n\nExamples:\n  suntropy studies optimize-peakpower --file study.json --energy-savings 70\n  suntropy studies optimize-peakpower --file study.json --raw-consumption 100 --use-kits\n  suntropy studies optimize-peakpower --file study.json --max-excesses 15"
   ).option("--file <path>", "Study file path").option("--energy-savings <pct>", "Target energy savings %").option("--raw-consumption <pct>", "Target production as % of consumption").option("--max-excesses <pct>", "Max excesses as % of production").option("--max-overproduction-months <n>", "Max months with overproduction").option("--use-kits", "Force kit mode (fetch all active kits and select optimal)").option("--apply", "Apply the result to the study file (set peakpower/kit, recalculate production)").action(async (opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const filePath = resolveFile(opts);
       const study = readStudy(filePath);
       const evaluationMode = {};
@@ -2432,7 +3134,7 @@ Example: suntropy studies set data --file study.json --data '{"referenceId":"REF
         study.comments = comments;
         return void 0;
       });
-      output(result, getGlobalOpts6(studies));
+      output(result, getGlobalOpts7(studies));
     } catch (err) {
       outputError(err instanceof Error ? err : new Error(String(err)));
     }
@@ -2441,7 +3143,7 @@ Example: suntropy studies set data --file study.json --data '{"referenceId":"REF
     'Add a comment to an existing study via API.\nExample: suntropy studies comment abc123 --content "Revisado por agente"'
   ).requiredOption("--content <text>", "Comment text").action(async (studyId, opts) => {
     try {
-      const global = getGlobalOpts6(studies);
+      const global = getGlobalOpts7(studies);
       const client = createServiceClient("solar", global);
       const comment = createComment("commented", opts.content);
       const res = await client.post(`/solar-study/addSolarStudyComment/${studyId}`, comment);
@@ -2582,7 +3284,7 @@ function createComment(type, content) {
 }
 
 // src/commands/studies/index.ts
-function getGlobalOpts7(cmd) {
+function getGlobalOpts8(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -2701,7 +3403,7 @@ function registerStudiesCommands(program2) {
   );
   studies.command("list").description("List solar studies metadata. Fields: idSolarStudyMetadata, solarStudyId, clientName, peakPower, currentState, creationTimestamp").option("--limit <n>", "Max results", "20").option("--offset <n>", "Skip results", "0").option("--state <state>", "Filter by state name").option("--client-name <name>", "Filter by client name").option("--from <date>", "Filter from date (YYYY-MM-DD)").option("--to <date>", "Filter to date (YYYY-MM-DD)").action(async (opts) => {
     try {
-      const global = getGlobalOpts7(studies);
+      const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const body = {
         limit: parseInt(opts.limit),
@@ -2735,7 +3437,7 @@ function registerStudiesCommands(program2) {
   });
   studies.command("metadata <id>").description("Get solar study metadata by metadata ID (relational). Full MySQL record with state, costs, versions.").option("--by-study-id", "Interpret <id> as MongoDB solarStudyId instead of metadata ID").action(async (id, opts) => {
     try {
-      const global = getGlobalOpts7(studies);
+      const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const path = opts.byStudyId ? `/solar-study/metadata/solar-study-id/${id}` : `/solar-study/findSolarStudyMetadataById/${id}`;
       const res = await client.get(path);
@@ -2748,7 +3450,7 @@ function registerStudiesCommands(program2) {
     "Get solar study by MongoDB ID. By default returns summary (no heavy curves).\nExpand sections: surfaces, results, economics, batteries, consumption, equipment, client, location\nExamples:\n  suntropy studies get abc123\n  suntropy studies get abc123 --expand surfaces,results\n  suntropy studies get abc123 --expand all\n  suntropy studies get abc123 --fields name,market  (bypasses expand filter)"
   ).option("--expand <sections>", 'Comma-separated sections to expand (or "all")').action(async (studyId, opts) => {
     try {
-      const global = getGlobalOpts7(studies);
+      const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
       const study = res.data;
@@ -2770,7 +3472,7 @@ function registerStudiesCommands(program2) {
     "Extract and analyze a PowerCurve from a study.\nCurve names: consumption, production, net-consumption, excesses\nDefault: --stats. Use --raw for full hourly data (8760 values).\nUse --monthly for monthly aggregates, --daily for daily totals."
   ).option("--stats", "Show statistics (default if no other flag)").option("--monthly", "Monthly accumulated values").option("--daily", "Daily accumulated values").option("--raw", "Full hourly DayCurve[] data").option("--total", "Just the total accumulated value").option("--surface-index <n>", "Surface index for production curve", "0").option("--save <file>", "Save curve data to file").action(async (studyId, curveName, opts) => {
     try {
-      const global = getGlobalOpts7(studies);
+      const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get(`/solar-study/findById/${studyId}`);
       const study = res.data;
@@ -2837,7 +3539,7 @@ function registerStudiesCommands(program2) {
   });
   studies.command("calculate-production").description("Calculate solar production curve for given coordinates and configuration").requiredOption("--lat <n>", "Latitude").requiredOption("--lon <n>", "Longitude").requiredOption("--power <w>", "Installed power in Watts").option("--angle <n>", "Panel inclination degrees", "30").option("--azimuth <n>", "Panel orientation degrees (0=north, 180=south)", "180").option("--losses <n>", "Losses percentage", "14").option("--year <n>", "Year for calculation", String((/* @__PURE__ */ new Date()).getFullYear())).option("--save <file>", "Save result to file").action(async (opts) => {
     try {
-      const global = getGlobalOpts7(studies);
+      const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const body = {
         lat: parseFloat(opts.lat),
@@ -2857,7 +3559,7 @@ function registerStudiesCommands(program2) {
   });
   studies.command("optimize-surfaces").description("Calculate optimal panel angle and azimuth for coordinates").requiredOption("--lat <n>", "Latitude").requiredOption("--lon <n>", "Longitude").action(async (opts) => {
     try {
-      const global = getGlobalOpts7(studies);
+      const global = getGlobalOpts8(studies);
       const client = createServiceClient("solar", global);
       const res = await client.get("/solar-study/optimizeSurfaces", {
         params: { lat: parseFloat(opts.lat), lon: parseFloat(opts.lon) }
@@ -2871,8 +3573,8 @@ function registerStudiesCommands(program2) {
 }
 
 // src/commands/curves/index.ts
-import { readFileSync as readFileSync3 } from "fs";
-function getGlobalOpts8(cmd) {
+import { readFileSync as readFileSync4 } from "fs";
+function getGlobalOpts9(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -2891,7 +3593,7 @@ function readStdin() {
 async function readCurveInput(inputPath) {
   let raw;
   if (inputPath && inputPath !== "-") {
-    raw = readFileSync3(inputPath, "utf-8");
+    raw = readFileSync4(inputPath, "utf-8");
   } else {
     raw = await readStdin();
   }
@@ -2916,7 +3618,7 @@ function registerCurvesCommands(program2) {
       const data = await readCurveInput(opts.input);
       const pc = await buildCurve(data, "stats");
       const raw = pc.calculateStatistics();
-      output(raw.statistics || raw, getGlobalOpts8(curves));
+      output(raw.statistics || raw, getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -2925,7 +3627,7 @@ function registerCurvesCommands(program2) {
     try {
       const data = await readCurveInput(opts.input);
       const pc = await buildCurve(data, "total");
-      output({ total: pc.getTotalAcumulate(), days: pc.days.length }, getGlobalOpts8(curves));
+      output({ total: pc.getTotalAcumulate(), days: pc.days.length }, getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -2935,32 +3637,32 @@ function registerCurvesCommands(program2) {
       const data = await readCurveInput(opts.input);
       const pc = await buildCurve(data, "multiplied");
       const result = pc.applyMultiplier(parseFloat(factor));
-      output(serializeCurve(result), getGlobalOpts8(curves));
+      output(serializeCurve(result), getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
   });
   curves.command("aggregate").description("Sum two PowerCurves (A + B). Returns a new PowerCurve.").requiredOption("--a <file>", "First curve file").requiredOption("--b <file>", "Second curve file").action(async (opts) => {
     try {
-      const dataA = JSON.parse(readFileSync3(opts.a, "utf-8"));
-      const dataB = JSON.parse(readFileSync3(opts.b, "utf-8"));
+      const dataA = JSON.parse(readFileSync4(opts.a, "utf-8"));
+      const dataB = JSON.parse(readFileSync4(opts.b, "utf-8"));
       const pcA = await buildCurve(dataA, "a");
       const pcB = await buildCurve(dataB, "b");
       const result = pcA.aggregatePowerCurve(pcB);
-      output(serializeCurve(result), getGlobalOpts8(curves));
+      output(serializeCurve(result), getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
   });
   curves.command("subtract").description("Subtract two PowerCurves (A - B). Returns a new PowerCurve.").requiredOption("--a <file>", "First curve file (minuend)").requiredOption("--b <file>", "Second curve file (subtrahend)").action(async (opts) => {
     try {
-      const dataA = JSON.parse(readFileSync3(opts.a, "utf-8"));
-      const dataB = JSON.parse(readFileSync3(opts.b, "utf-8"));
+      const dataA = JSON.parse(readFileSync4(opts.a, "utf-8"));
+      const dataB = JSON.parse(readFileSync4(opts.b, "utf-8"));
       const pcA = await buildCurve(dataA, "a");
       const pcB = await buildCurve(dataB, "b");
       const negB = pcB.applyMultiplier(-1);
       const result = pcA.aggregatePowerCurve(negB);
-      output(serializeCurve(result), getGlobalOpts8(curves));
+      output(serializeCurve(result), getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -2970,7 +3672,7 @@ function registerCurvesCommands(program2) {
       const data = await readCurveInput(opts.input);
       const pc = await buildCurve(data, "positive");
       const result = pc.filterNegativeValues();
-      output(serializeCurve(result), getGlobalOpts8(curves));
+      output(serializeCurve(result), getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -2980,7 +3682,7 @@ function registerCurvesCommands(program2) {
       const data = await readCurveInput(opts.input);
       const pc = await buildCurve(data, "negative");
       const result = pc.filterPositiveValues();
-      output(serializeCurve(result), getGlobalOpts8(curves));
+      output(serializeCurve(result), getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -2990,7 +3692,7 @@ function registerCurvesCommands(program2) {
       const data = await readCurveInput(opts.input);
       const pc = await buildCurve(data, "sorted");
       const sortedDays = pc.sortByDate();
-      output({ days: sortedDays, identifier: pc.identifier, ignore0: pc.ignore0 }, getGlobalOpts8(curves));
+      output({ days: sortedDays, identifier: pc.identifier, ignore0: pc.ignore0 }, getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -3002,7 +3704,7 @@ function registerCurvesCommands(program2) {
       const start = opts.start ? new Date(opts.start) : void 0;
       const end = opts.end ? new Date(opts.end) : void 0;
       const filteredDays = pc.filterByDates(start, end);
-      output({ days: filteredDays, identifier: pc.identifier, ignore0: pc.ignore0 }, getGlobalOpts8(curves));
+      output({ days: filteredDays, identifier: pc.identifier, ignore0: pc.ignore0 }, getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -3012,7 +3714,7 @@ function registerCurvesCommands(program2) {
       const data = await readCurveInput(opts.input);
       const pc = await buildCurve(data, "serie");
       const serie = pc.convertoToSerie();
-      output(serie, getGlobalOpts8(curves));
+      output(serie, getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -3023,9 +3725,9 @@ function registerCurvesCommands(program2) {
     try {
       const data = await readCurveInput(opts.input);
       const pc = await buildCurve(data, "by-period");
-      const periodsData = JSON.parse(readFileSync3(opts.periods, "utf-8"));
+      const periodsData = JSON.parse(readFileSync4(opts.periods, "utf-8"));
       const result = pc.aggregateByPeriod(periodsData);
-      output(result, getGlobalOpts8(curves));
+      output(result, getGlobalOpts9(curves));
     } catch (err) {
       outputError(err);
     }
@@ -3033,8 +3735,8 @@ function registerCurvesCommands(program2) {
 }
 
 // src/commands/consumption/index.ts
-import { readFileSync as readFileSync4 } from "fs";
-function getGlobalOpts9(cmd) {
+import { readFileSync as readFileSync5 } from "fs";
+function getGlobalOpts10(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -3053,7 +3755,7 @@ Examples:
   suntropy consumption estimate --annual 5000 --custom-profile-id abc123`
   ).requiredOption("--annual <kWh>", "Annual consumption in kWh").option("--pattern <name>", "Consumption pattern: Balance, Nightly, Morning, Afternoon, Domestic, Commercial").option("--start-date <YYYY-MM-DD>", "Start date (default: Jan 1 current year)").option("--end-date <YYYY-MM-DD>", "End date (default: Dec 31 current year)").option("--tariff <code>", "Electricity tariff code (e.g. 3.0TD)", "3.0TD").option("--type <type>", "Profile type: Initial or Final", "Final").option("--market <code>", "Market: es, pt, it", "es").option("--custom-profile-id <id>", "Use a custom consumption profile by ID").option("--monthly-data <json>", 'Monthly consumption JSON: {"1":val,"2":val,...,"12":val}').option("--daily-curve <json>", "Custom daily curve JSON (DayCurve format)").option("--save <file>", "Save result to file").action(async (opts) => {
     try {
-      const global = getGlobalOpts9(consumption);
+      const global = getGlobalOpts10(consumption);
       const client = createServiceClient("profiles", global);
       const year = (/* @__PURE__ */ new Date()).getFullYear();
       const startDate = opts.startDate || `${year}-01-01`;
@@ -3085,7 +3787,7 @@ Examples:
     "Fetch REE (Red El\xE9ctrica) hourly profiles for a date range and tariff.\nReturns the raw profile data used as basis for consumption estimation.\nExample: suntropy consumption ree-profiles --start 2024-01-01 --end 2024-12-31 --tariff 3.0TD"
   ).requiredOption("--start <YYYY-MM-DD>", "Start date").requiredOption("--end <YYYY-MM-DD>", "End date").option("--tariff <code>", "Tariff code", "3.0TD").option("--type <type>", "Profile type: Initial or Final", "Final").option("--market <code>", "Market code: es, pt, it", "es").option("--save <file>", "Save result to file").action(async (opts) => {
     try {
-      const global = getGlobalOpts9(consumption);
+      const global = getGlobalOpts10(consumption);
       const client = createServiceClient("profiles", global);
       const res = await client.get("/ree-profiles", {
         params: {
@@ -3103,7 +3805,7 @@ Examples:
   });
   consumption.command("custom-tags").description("List available custom consumption profile tags for the authenticated client").action(async () => {
     try {
-      const global = getGlobalOpts9(consumption);
+      const global = getGlobalOpts10(consumption);
       const client = createServiceClient("profiles", global);
       const res = await client.get("/custom-profiles/getTags");
       output(res.data, global);
@@ -3113,7 +3815,7 @@ Examples:
   });
   consumption.command("custom-profile-info").description("Get details of a custom consumption profile by ID").requiredOption("--id <profileId>", "Custom profile ID").action(async (opts) => {
     try {
-      const global = getGlobalOpts9(consumption);
+      const global = getGlobalOpts10(consumption);
       const client = createServiceClient("profiles", global);
       const res = await client.get("/custom-profiles/getInfo", {
         params: { id: opts.id }
@@ -3127,7 +3829,7 @@ Examples:
     "Fetch period distribution (hour\u2192P1-P6 mapping) from the periods service.\nReturns DayCurve[] where each hour's value is the period number (1-6).\nUse with `suntropy curves by-period` to aggregate any curve by tariff period.\n\nCommon tariff IDs (Spain): 13=2.0TD, 14=3.0TD\nZone IDs (Spain): 1=Peninsula, 2=Canarias, 3=Baleares\n\nExamples:\n  suntropy consumption periods --tariff-id 14 --zone-id 1 --save /tmp/periods.json\n  suntropy consumption periods --tariff-id 13 --start 2025-01-01 --end 2025-12-31"
   ).option("--tariff-id <n>", "ATR tariff ID (13=2.0TD, 14=3.0TD)", "14").option("--zone-id <n>", "Geographical zone ID (1=Peninsula)", "1").option("--start <YYYY-MM-DD>", "Start date (default: Jan 1 current year)").option("--end <YYYY-MM-DD>", "End date (default: Dec 31 current year)").option("--market <code>", "Market: es, pt, it, fr", "es").option("--save <file>", "Save result to file").action(async (opts) => {
     try {
-      const global = getGlobalOpts9(consumption);
+      const global = getGlobalOpts10(consumption);
       const client = createServiceClient("periods", global);
       const year = (/* @__PURE__ */ new Date()).getFullYear();
       const res = await client.get("/periodos", {
@@ -3148,12 +3850,12 @@ Examples:
     "Generate consumption curve from an uploaded file.\nSupported formats: Portuguese EREDES ZIP files.\nExample: suntropy consumption from-file --eredes-zip /path/to/file.zip"
   ).option("--eredes-zip <path>", "Path to Portuguese EREDES ZIP file").option("--save <file>", "Save result to file").action(async (opts) => {
     try {
-      const global = getGlobalOpts9(consumption);
+      const global = getGlobalOpts10(consumption);
       const client = createServiceClient("profiles", global);
       if (opts.eredesZip) {
         const FormData = (await import("form-data")).default;
         const form = new FormData();
-        form.append("file", readFileSync4(opts.eredesZip), {
+        form.append("file", readFileSync5(opts.eredesZip), {
           filename: opts.eredesZip.split("/").pop(),
           contentType: "application/zip"
         });
@@ -3171,7 +3873,7 @@ Examples:
 }
 
 // src/commands/solarform/index.ts
-function getGlobalOpts10(cmd) {
+function getGlobalOpts11(cmd) {
   let root = cmd;
   while (root.parent) root = root.parent;
   return root.opts();
@@ -3237,7 +3939,7 @@ function registerSolarformCommands(program2) {
     'Create a solar study with minimal parameters (simplified mode).\nAutomatically resolves location from region/subregion, applies consumption patterns,\nand optimizes kit selection.\n\nConsumption patterns: Balance, Nightly, Morning, Afternoon, Domestic, Commercial\nConsumption mode: monthlyConsumption (kWh) or monthlySpending (EUR)\nExcesses modes: PPA, gridSelling, noInjection, virtualBattery\n\nExamples:\n  suntropy solarform simple --region "Andaluc\xEDa" --sub-region "Sevilla" --consumption 5000\n  suntropy solarform simple --region "Catalu\xF1a" --sub-region "Barcelona" --consumption 300 --consumption-mode monthlySpending --save\n  suntropy solarform simple --region "Madrid" --sub-region "Madrid" --consumption 8000 --pattern Domestic --kit-id abc123 --save'
   ).requiredOption("--region <name>", "Region name (must exist in database)").requiredOption("--sub-region <name>", "Sub-region name").requiredOption("--consumption <value>", "Consumption value (kWh or EUR depending on --consumption-mode)").option("--pattern <name>", "Consumption pattern: Balance, Nightly, Morning, Afternoon, Domestic, Commercial", "Balance").option("--consumption-mode <mode>", "monthlyConsumption (kWh) or monthlySpending (EUR)", "monthlyConsumption").option("--kit-id <id>", "Use a specific solar kit instead of auto-optimization").option("--excesses-mode <mode>", "Excesses compensation: PPA, gridSelling, noInjection, virtualBattery").option("--assigned-user <uid>", "Assign study to a user UID").option("--email <email>", "Send results to this email").option("--save", "Save study to database").option("--raw", "Return full study with PowerCurve data (no compaction)").option("--save-file <file>", "Save result to local file").action(async (opts) => {
     try {
-      const global = getGlobalOpts10(solarform);
+      const global = getGlobalOpts11(solarform);
       const client = createServiceClient("solar", global);
       const body = {
         region: opts.region,
@@ -3281,7 +3983,7 @@ Examples:
   cat study-input.json | suntropy solarform calculate --data - --save --email client@co.com`
   ).requiredOption("--data <json>", "Full SimplifiedSolarStudy JSON body (or - for stdin)").option("--save", "Save study to database").option("--email <email>", "Send results to this email").option("--raw", "Return full study with PowerCurve data (no compaction)").option("--save-file <file>", "Save result to local file").action(async (opts) => {
     try {
-      const global = getGlobalOpts10(solarform);
+      const global = getGlobalOpts11(solarform);
       const client = createServiceClient("solar", global);
       const body = await parseData4(opts.data);
       if (!body) {
@@ -3309,7 +4011,7 @@ Examples:
     "Get the solar form configuration for the authenticated client.\nReturns form settings, appearance, enabled steps, custom fields, etc."
   ).action(async () => {
     try {
-      const global = getGlobalOpts10(solarform);
+      const global = getGlobalOpts11(solarform);
       const client = createServiceClient("solar", global);
       const res = await client.get("/solar-form/solar-form-config");
       output(res.data, global);
@@ -3321,7 +4023,7 @@ Examples:
     "List or create solar form submission statistics.\nUsed for tracking form analytics and conversion data."
   ).option("--create", "Create a new statistics entry").option("--update", "Update an existing statistics entry").option("--data <json>", "Statistics data as JSON").option("--stats-id <id>", "Statistics ID (for update or linking)").action(async (opts) => {
     try {
-      const global = getGlobalOpts10(solarform);
+      const global = getGlobalOpts11(solarform);
       const client = createServiceClient("solar", global);
       if (opts.update) {
         const body = await parseData4(opts.data);