thoth-cli 0.1.1 → 0.2.0

package/dist/chunk-NEQKNEBO.js

@@ -0,0 +1,1211 @@
+// src/lib/core.ts
+import { execa } from "execa";
+
+// src/lib/binary.ts
+import { platform, arch } from "os";
+import { join, dirname } from "path";
+import { existsSync } from "fs";
+import { fileURLToPath } from "url";
+var __dirname = dirname(fileURLToPath(import.meta.url));
+function getPlatformKey() {
+  const p = platform();
+  const a = arch();
+  const platformMap = {
+    "darwin": "darwin",
+    "linux": "linux",
+    "win32": "win32"
+  };
+  const archMap = {
+    "x64": "x64",
+    "arm64": "arm64"
+  };
+  const mappedPlatform = platformMap[p];
+  const mappedArch = archMap[a];
+  if (!mappedPlatform || !mappedArch) {
+    throw new Error(`Unsupported platform: ${p}-${a}`);
+  }
+  return `${mappedPlatform}-${mappedArch}`;
+}
+function getBinaryName() {
+  const p = platform();
+  return p === "win32" ? "thoth-core.exe" : "thoth-core";
+}
+function getBinaryPath() {
+  const platformKey = getPlatformKey();
+  const binaryName = getBinaryName();
+  const possiblePaths = [
+    // Installed via npm (production)
+    join(__dirname, "..", "..", "bin", platformKey, binaryName),
+    // Development (monorepo)
+    join(__dirname, "..", "..", "..", "..", "bin", platformKey, binaryName),
+    // Local development
+    join(__dirname, "..", "..", "bin", binaryName)
+  ];
+  for (const p of possiblePaths) {
+    if (existsSync(p)) {
+      return p;
+    }
+  }
+  return "python";
+}
+function getCommand() {
+  const binaryPath = getBinaryPath();
+  if (binaryPath === "python") {
+    return {
+      command: "thoth-core",
+      args: []
+    };
+  }
+  return {
+    command: binaryPath,
+    args: []
+  };
+}
+
+// src/lib/core.ts
+async function execute(subcommand, args) {
+  const { command, args: baseArgs } = getCommand();
+  try {
+    const result = await execa(command, [...baseArgs, subcommand, ...args], {
+      encoding: "utf8",
+      reject: false
+    });
+    if (result.exitCode !== 0) {
+      const error = result.stderr || result.stdout;
+      try {
+        return JSON.parse(error);
+      } catch {
+        return { error: error || "Unknown error" };
+      }
+    }
+    return JSON.parse(result.stdout);
+  } catch (err) {
+    return { error: err instanceof Error ? err.message : "Unknown error" };
+  }
+}
+async function chart(options) {
+  const args = [
+    "--year",
+    String(options.year),
+    "--month",
+    String(options.month),
+    "--day",
+    String(options.day),
+    "--hour",
+    String(options.hour ?? 12),
+    "--minute",
+    String(options.minute ?? 0),
+    "--name",
+    options.name ?? "Subject"
+  ];
+  if (options.city) {
+    args.push("--city", options.city);
+    args.push("--nation", options.nation ?? "US");
+  } else if (options.lat !== void 0 && options.lng !== void 0) {
+    args.push("--lat", String(options.lat));
+    args.push("--lng", String(options.lng));
+  }
+  if (options.svg) {
+    args.push("--svg");
+  }
+  return execute("chart", args);
+}
+async function transit(options) {
+  const args = [
+    "--natal-year",
+    String(options.natalYear),
+    "--natal-month",
+    String(options.natalMonth),
+    "--natal-day",
+    String(options.natalDay),
+    "--natal-hour",
+    String(options.natalHour ?? 12),
+    "--natal-minute",
+    String(options.natalMinute ?? 0),
+    "--orb",
+    String(options.orb ?? 3)
+  ];
+  if (options.natalCity) {
+    args.push("--natal-city", options.natalCity);
+    args.push("--nation", options.nation ?? "US");
+  } else if (options.natalLat !== void 0 && options.natalLng !== void 0) {
+    args.push("--natal-lat", String(options.natalLat));
+    args.push("--natal-lng", String(options.natalLng));
+  }
+  if (options.transitYear) args.push("--transit-year", String(options.transitYear));
+  if (options.transitMonth) args.push("--transit-month", String(options.transitMonth));
+  if (options.transitDay) args.push("--transit-day", String(options.transitDay));
+  if (options.svg) args.push("--svg");
+  return execute("transit", args);
+}
+async function solarReturn(options) {
+  const args = [
+    "--natal-year",
+    String(options.natalYear),
+    "--natal-month",
+    String(options.natalMonth),
+    "--natal-day",
+    String(options.natalDay),
+    "--natal-hour",
+    String(options.natalHour ?? 12),
+    "--natal-minute",
+    String(options.natalMinute ?? 0),
+    "--return-year",
+    String(options.returnYear)
+  ];
+  if (options.natalCity) {
+    args.push("--natal-city", options.natalCity);
+    args.push("--nation", options.nation ?? "US");
+  } else if (options.natalLat !== void 0 && options.natalLng !== void 0) {
+    args.push("--natal-lat", String(options.natalLat));
+    args.push("--natal-lng", String(options.natalLng));
+  }
+  if (options.returnCity) args.push("--return-city", options.returnCity);
+  if (options.svg) args.push("--svg");
+  return execute("solar-return", args);
+}
+async function lunarReturn(options) {
+  const args = [
+    "--natal-year",
+    String(options.natalYear),
+    "--natal-month",
+    String(options.natalMonth),
+    "--natal-day",
+    String(options.natalDay),
+    "--natal-hour",
+    String(options.natalHour ?? 12),
+    "--natal-minute",
+    String(options.natalMinute ?? 0),
+    "--from-year",
+    String(options.fromYear),
+    "--from-month",
+    String(options.fromMonth),
+    "--from-day",
+    String(options.fromDay ?? 1)
+  ];
+  if (options.natalCity) {
+    args.push("--natal-city", options.natalCity);
+    args.push("--nation", options.nation ?? "US");
+  } else if (options.natalLat !== void 0 && options.natalLng !== void 0) {
+    args.push("--natal-lat", String(options.natalLat));
+    args.push("--natal-lng", String(options.natalLng));
+  }
+  if (options.returnCity) args.push("--return-city", options.returnCity);
+  if (options.svg) args.push("--svg");
+  return execute("lunar-return", args);
+}
+async function synastry(options) {
+  const args = [
+    "--year1",
+    String(options.year1),
+    "--month1",
+    String(options.month1),
+    "--day1",
+    String(options.day1),
+    "--hour1",
+    String(options.hour1 ?? 12),
+    "--minute1",
+    String(options.minute1 ?? 0),
+    "--name1",
+    options.name1 ?? "Person 1",
+    "--year2",
+    String(options.year2),
+    "--month2",
+    String(options.month2),
+    "--day2",
+    String(options.day2),
+    "--hour2",
+    String(options.hour2 ?? 12),
+    "--minute2",
+    String(options.minute2 ?? 0),
+    "--name2",
+    options.name2 ?? "Person 2",
+    "--orb",
+    String(options.orb ?? 6)
+  ];
+  if (options.city1) {
+    args.push("--city1", options.city1);
+    args.push("--nation1", options.nation1 ?? "US");
+  } else if (options.lat1 !== void 0 && options.lng1 !== void 0) {
+    args.push("--lat1", String(options.lat1));
+    args.push("--lng1", String(options.lng1));
+  }
+  if (options.city2) {
+    args.push("--city2", options.city2);
+    args.push("--nation2", options.nation2 ?? "US");
+  } else if (options.lat2 !== void 0 && options.lng2 !== void 0) {
+    args.push("--lat2", String(options.lat2));
+    args.push("--lng2", String(options.lng2));
+  }
+  if (options.svg) args.push("--svg");
+  return execute("synastry", args);
+}
+async function progressions(options) {
+  const args = [
+    "--natal-year",
+    String(options.natalYear),
+    "--natal-month",
+    String(options.natalMonth),
+    "--natal-day",
+    String(options.natalDay),
+    "--natal-hour",
+    String(options.natalHour ?? 12),
+    "--natal-minute",
+    String(options.natalMinute ?? 0),
+    "--target-year",
+    String(options.targetYear),
+    "--target-month",
+    String(options.targetMonth ?? 1),
+    "--target-day",
+    String(options.targetDay ?? 1)
+  ];
+  if (options.natalCity) {
+    args.push("--natal-city", options.natalCity);
+    args.push("--nation", options.nation ?? "US");
+  } else if (options.natalLat !== void 0 && options.natalLng !== void 0) {
+    args.push("--natal-lat", String(options.natalLat));
+    args.push("--natal-lng", String(options.natalLng));
+  }
+  if (options.svg) args.push("--svg");
+  return execute("progressions", args);
+}
+async function ephemerisRange(options) {
+  const args = [
+    "--body",
+    options.body,
+    "--start-year",
+    String(options.startYear),
+    "--start-month",
+    String(options.startMonth ?? 1),
+    "--start-day",
+    String(options.startDay ?? 1),
+    "--end-year",
+    String(options.endYear),
+    "--end-month",
+    String(options.endMonth ?? 12),
+    "--end-day",
+    String(options.endDay ?? 28),
+    "--step",
+    options.step ?? "month"
+  ];
+  return execute("ephemeris-range", args);
+}
+async function moon(options = {}) {
+  const args = [];
+  if (options.year) args.push("--year", String(options.year));
+  if (options.month) args.push("--month", String(options.month));
+  if (options.day) args.push("--day", String(options.day));
+  if (options.lat) args.push("--lat", String(options.lat));
+  if (options.lng) args.push("--lng", String(options.lng));
+  return execute("moon", args);
+}
+async function ephemeris(options) {
+  const args = ["--body", options.body];
+  if (options.year) args.push("--year", String(options.year));
+  if (options.month) args.push("--month", String(options.month));
+  if (options.day) args.push("--day", String(options.day));
+  return execute("ephemeris", args);
+}
+async function composite(options) {
+  const args = [
+    "--year1",
+    String(options.year1),
+    "--month1",
+    String(options.month1),
+    "--day1",
+    String(options.day1),
+    "--hour1",
+    String(options.hour1 ?? 12),
+    "--minute1",
+    String(options.minute1 ?? 0),
+    "--name1",
+    options.name1 ?? "Person 1",
+    "--year2",
+    String(options.year2),
+    "--month2",
+    String(options.month2),
+    "--day2",
+    String(options.day2),
+    "--hour2",
+    String(options.hour2 ?? 12),
+    "--minute2",
+    String(options.minute2 ?? 0),
+    "--name2",
+    options.name2 ?? "Person 2"
+  ];
+  if (options.city1) {
+    args.push("--city1", options.city1);
+    args.push("--nation1", options.nation1 ?? "US");
+  } else if (options.lat1 !== void 0 && options.lng1 !== void 0) {
+    args.push("--lat1", String(options.lat1));
+    args.push("--lng1", String(options.lng1));
+  }
+  if (options.city2) {
+    args.push("--city2", options.city2);
+    args.push("--nation2", options.nation2 ?? "US");
+  } else if (options.lat2 !== void 0 && options.lng2 !== void 0) {
+    args.push("--lat2", String(options.lat2));
+    args.push("--lng2", String(options.lng2));
+  }
+  if (options.svg) args.push("--svg");
+  return execute("composite", args);
+}
+async function solarArc(options) {
+  const args = [
+    "--natal-year",
+    String(options.natalYear),
+    "--natal-month",
+    String(options.natalMonth),
+    "--natal-day",
+    String(options.natalDay),
+    "--natal-hour",
+    String(options.natalHour ?? 12),
+    "--natal-minute",
+    String(options.natalMinute ?? 0),
+    "--target-year",
+    String(options.targetYear),
+    "--target-month",
+    String(options.targetMonth ?? 1),
+    "--target-day",
+    String(options.targetDay ?? 1)
+  ];
+  if (options.natalCity) {
+    args.push("--natal-city", options.natalCity);
+    args.push("--nation", options.nation ?? "US");
+  } else if (options.natalLat !== void 0 && options.natalLng !== void 0) {
+    args.push("--natal-lat", String(options.natalLat));
+    args.push("--natal-lng", String(options.natalLng));
+  }
+  return execute("solar-arc", args);
+}
+async function horary(options) {
+  const args = [
+    "--question",
+    options.question
+  ];
+  if (options.year) args.push("--year", String(options.year));
+  if (options.month) args.push("--month", String(options.month));
+  if (options.day) args.push("--day", String(options.day));
+  if (options.hour !== void 0) args.push("--hour", String(options.hour));
+  if (options.minute !== void 0) args.push("--minute", String(options.minute));
+  if (options.city) {
+    args.push("--city", options.city);
+    args.push("--nation", options.nation ?? "US");
+  } else if (options.lat !== void 0 && options.lng !== void 0) {
+    args.push("--lat", String(options.lat));
+    args.push("--lng", String(options.lng));
+  }
+  return execute("horary", args);
+}
+async function version() {
+  return execute("version", []);
+}
+
+// src/lib/format.ts
+import chalk from "chalk";
+var COLORS = {
+  // Planets (Sephirotic correspondences)
+  sun: chalk.hex("#FFD700"),
+  // Gold - Tiphareth
+  moon: chalk.hex("#C0C0C0"),
+  // Silver - Yesod
+  mercury: chalk.hex("#FF8C00"),
+  // Orange - Hod
+  venus: chalk.hex("#00FF7F"),
+  // Green - Netzach
+  mars: chalk.hex("#FF0000"),
+  // Red - Geburah
+  jupiter: chalk.hex("#4169E1"),
+  // Royal Blue - Chesed
+  saturn: chalk.hex("#4B0082"),
+  // Indigo - Binah
+  uranus: chalk.hex("#00FFFF"),
+  // Electric Cyan - Chokmah
+  neptune: chalk.hex("#20B2AA"),
+  // Sea Green
+  pluto: chalk.hex("#8B0000"),
+  // Dark Red
+  chiron: chalk.hex("#9932CC"),
+  // Purple - wounded healer
+  lilith: chalk.hex("#800020"),
+  // Burgundy - primal
+  northNode: chalk.hex("#FFD700"),
+  // Gold
+  southNode: chalk.hex("#C0C0C0")
+  // Silver
+};
+function getPlanetColor(name) {
+  const colorMap = {
+    "sun": COLORS.sun,
+    "moon": COLORS.moon,
+    "mercury": COLORS.mercury,
+    "venus": COLORS.venus,
+    "mars": COLORS.mars,
+    "jupiter": COLORS.jupiter,
+    "saturn": COLORS.saturn,
+    "uranus": COLORS.uranus,
+    "neptune": COLORS.neptune,
+    "pluto": COLORS.pluto,
+    "chiron": COLORS.chiron,
+    "mean_lilith": COLORS.lilith,
+    "lilith": COLORS.lilith,
+    "true_north_lunar_node": COLORS.northNode,
+    "true_south_lunar_node": COLORS.southNode,
+    "nn": COLORS.northNode,
+    "sn": COLORS.southNode
+  };
+  return colorMap[name.toLowerCase()] || chalk.white;
+}
+function getZodiacColor(sign) {
+  const colorMap = {
+    "Ari": COLORS.mars,
+    "Tau": COLORS.venus,
+    "Gem": COLORS.mercury,
+    "Can": COLORS.moon,
+    "Leo": COLORS.sun,
+    "Vir": COLORS.mercury,
+    "Lib": COLORS.venus,
+    "Sco": COLORS.pluto,
+    "Sag": COLORS.jupiter,
+    "Cap": COLORS.saturn,
+    "Aqu": COLORS.uranus,
+    "Pis": COLORS.neptune
+  };
+  return colorMap[sign] || chalk.white;
+}
+function getAspectColor(aspect) {
+  const colorMap = {
+    "conjunction": COLORS.sun,
+    // Tiphareth
+    "opposition": COLORS.moon,
+    // Yesod  
+    "trine": COLORS.jupiter,
+    // Chesed
+    "square": COLORS.mars,
+    // Geburah
+    "sextile": COLORS.venus,
+    // Netzach
+    "quintile": COLORS.mercury,
+    // Hod
+    "quincunx": COLORS.uranus
+  };
+  return colorMap[aspect] || chalk.white;
+}
+var ZODIAC_SYMBOLS = {
+  "Ari": "\u2648",
+  "Tau": "\u2649",
+  "Gem": "\u264A",
+  "Can": "\u264B",
+  "Leo": "\u264C",
+  "Vir": "\u264D",
+  "Lib": "\u264E",
+  "Sco": "\u264F",
+  "Sag": "\u2650",
+  "Cap": "\u2651",
+  "Aqu": "\u2652",
+  "Pis": "\u2653"
+};
+var PLANET_SYMBOLS = {
+  "sun": "\u2609",
+  "moon": "\u263D",
+  "mercury": "\u263F",
+  "venus": "\u2640",
+  "mars": "\u2642",
+  "jupiter": "\u2643",
+  "saturn": "\u2644",
+  "uranus": "\u2645",
+  "neptune": "\u2646",
+  "pluto": "\u2647",
+  "chiron": "\u26B7",
+  "north_node": "\u260A",
+  "south_node": "\u260B",
+  "true_north_lunar_node": "\u260A",
+  "true_south_lunar_node": "\u260B",
+  "mean_lilith": "\u26B8",
+  "medium_coeli": "MC",
+  "imum_coeli": "IC",
+  "ascendant": "ASC",
+  "descendant": "DSC",
+  // Short names from transit aspects
+  "nn": "\u260A",
+  "sn": "\u260B",
+  "lilith": "\u26B8",
+  "mc": "MC",
+  "ic": "IC",
+  "asc": "ASC",
+  "dsc": "DSC"
+};
+var ASPECT_SYMBOLS = {
+  "conjunction": "\u260C",
+  "opposition": "\u260D",
+  "trine": "\u25B3",
+  "square": "\u25A1",
+  "sextile": "\u26B9",
+  "quintile": "\u235F",
+  "quincunx": "\u26BB",
+  "semi-sextile": "\u26BA",
+  "semi-square": "\u2220",
+  "sesquiquadrate": "\u26BC"
+};
+function getZodiacSymbol(sign) {
+  const key = sign.slice(0, 3);
+  return ZODIAC_SYMBOLS[key] || sign;
+}
+function getPlanetSymbol(planet) {
+  return PLANET_SYMBOLS[planet.toLowerCase()] || planet;
+}
+function getAspectSymbol(aspect) {
+  return ASPECT_SYMBOLS[aspect.toLowerCase()] || aspect;
+}
+function formatDegrees(degrees) {
+  const d = Math.floor(degrees);
+  const m = Math.floor((degrees - d) * 60);
+  return `${d}\xB0${m.toString().padStart(2, "0")}'`;
+}
+function formatChart(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u{1315D} Natal Chart: ${result.name}`));
+  const dateStr = `${result.datetime.year}-${String(result.datetime.month).padStart(2, "0")}-${String(result.datetime.day).padStart(2, "0")} ${String(result.datetime.hour).padStart(2, "0")}:${String(result.datetime.minute).padStart(2, "0")}`;
+  lines.push(chalk.dim(`   ${dateStr}`));
+  if (result.location.city) {
+    lines.push(chalk.dim(`   ${result.location.city}`));
+  } else {
+    lines.push(chalk.dim(`   Lat: ${result.location.lat}, Lng: ${result.location.lng}`));
+  }
+  if (result.lunar_phase) {
+    lines.push(chalk.dim(`   Born during: ${result.lunar_phase.emoji} ${result.lunar_phase.name}`));
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 ANGLES \u2500\u2500"));
+  if (result.ascendant.sign) {
+    const zColor = getZodiacColor(result.ascendant.sign);
+    lines.push(`   ${COLORS.mars("ASC")}  ${zColor(getZodiacSymbol(result.ascendant.sign) + " " + result.ascendant.sign)} ${chalk.white(formatDegrees(result.ascendant.position || 0))}`);
+  }
+  if (result.midheaven.sign) {
+    const zColor = getZodiacColor(result.midheaven.sign);
+    lines.push(`   ${COLORS.sun("MC")}   ${zColor(getZodiacSymbol(result.midheaven.sign) + " " + result.midheaven.sign)} ${chalk.white(formatDegrees(result.midheaven.position || 0))}`);
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 PLANETS \u2500\u2500"));
+  const planetOrder = ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"];
+  for (const name of planetOrder) {
+    const planet = result.planets[name];
+    if (planet) {
+      const pColor = getPlanetColor(name);
+      const zColor = getZodiacColor(planet.sign);
+      const symbol = getPlanetSymbol(name);
+      const zodiac = getZodiacSymbol(planet.sign);
+      const deg = formatDegrees(planet.position);
+      const rx = planet.retrograde ? COLORS.mars(" \u211E") : "";
+      const house = planet.house ? chalk.dim(` (${planet.house})`) : "";
+      lines.push(`   ${pColor(symbol)} ${name.padEnd(10)} ${zColor(zodiac + " " + planet.sign)} ${chalk.white(deg)}${rx}${house}`);
+    }
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 POINTS \u2500\u2500"));
+  const pointOrder = ["chiron", "mean_lilith", "true_north_lunar_node", "true_south_lunar_node"];
+  const pointNames = {
+    "chiron": "Chiron",
+    "mean_lilith": "Lilith",
+    "true_north_lunar_node": "North Node",
+    "true_south_lunar_node": "South Node"
+  };
+  for (const name of pointOrder) {
+    const planet = result.planets[name];
+    if (planet) {
+      const pColor = getPlanetColor(name);
+      const zColor = getZodiacColor(planet.sign);
+      const symbol = getPlanetSymbol(name);
+      const displayName = pointNames[name] || name;
+      const zodiac = getZodiacSymbol(planet.sign);
+      const deg = formatDegrees(planet.position);
+      const house = planet.house ? chalk.dim(` (${planet.house})`) : "";
+      lines.push(`   ${pColor(symbol)} ${displayName.padEnd(10)} ${zColor(zodiac + " " + planet.sign)} ${chalk.white(deg)}${house}`);
+    }
+  }
+  lines.push("");
+  if (result.houses && Object.keys(result.houses).length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 HOUSES \u2500\u2500"));
+    for (let i = 1; i <= 12; i++) {
+      const house = result.houses[String(i)];
+      if (house && house.sign) {
+        const zodiac = getZodiacSymbol(house.sign);
+        const deg = formatDegrees(house.position || 0);
+        const label = i === 1 ? "(ASC)" : i === 4 ? "(IC)" : i === 7 ? "(DSC)" : i === 10 ? "(MC)" : "";
+        lines.push(`   ${String(i).padStart(2)}  ${chalk.cyan(zodiac)} ${house.sign} ${chalk.dim(deg)} ${chalk.yellow(label)}`);
+      }
+    }
+    lines.push("");
+  }
+  if (result.elements && result.modes) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 BALANCE \u2500\u2500"));
+    const elem = result.elements;
+    const mode = result.modes;
+    lines.push(`   ${COLORS.mars("\u{1F702} Fire:")} ${elem.Fire}  ${COLORS.venus("\u{1F703} Earth:")} ${elem.Earth}  ${COLORS.mercury("\u{1F701} Air:")} ${elem.Air}  ${COLORS.moon("\u{1F704} Water:")} ${elem.Water}`);
+    lines.push(`   ${COLORS.mars("Cardinal:")} ${mode.Cardinal}  ${COLORS.sun("Fixed:")} ${mode.Fixed}  ${COLORS.mercury("Mutable:")} ${mode.Mutable}`);
+    lines.push("");
+  }
+  if (result.aspects && result.aspects.length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 ASPECTS \u2500\u2500"));
+    const aspects = result.aspects.slice(0, 15);
+    for (const asp of aspects) {
+      const p1Name = asp.planet1.toLowerCase().replace(/ /g, "_");
+      const p2Name = asp.planet2.toLowerCase().replace(/ /g, "_");
+      const p1Color = getPlanetColor(p1Name);
+      const p2Color = getPlanetColor(p2Name);
+      const p1 = getPlanetSymbol(p1Name);
+      const p2 = getPlanetSymbol(p2Name);
+      const aspectSym = getAspectSymbol(asp.aspect);
+      const aspectName = asp.aspect.charAt(0).toUpperCase() + asp.aspect.slice(1);
+      const aColor = getAspectColor(asp.aspect);
+      lines.push(`   ${p1Color(p1)} ${asp.planet1.padEnd(10)} ${aColor(aspectSym + " " + aspectName.padEnd(11))} ${p2Color(p2)} ${asp.planet2.padEnd(10)} ${chalk.dim(`${asp.orb}\xB0`)}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatTransits(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u{1315D} Transits`));
+  if (result.natal.name) {
+    lines.push(chalk.dim(`   For: ${result.natal.name}`));
+  }
+  if (result.natal.city) {
+    lines.push(chalk.dim(`   Natal: ${result.natal.datetime} \xB7 ${result.natal.city}`));
+  } else {
+    lines.push(chalk.dim(`   Natal: ${result.natal.datetime}`));
+  }
+  lines.push(chalk.dim(`   Transit: ${result.transit.datetime}`));
+  if (result.transit.lunar_phase) {
+    lines.push(chalk.dim(`   Moon: ${result.transit.lunar_phase.emoji} ${result.transit.lunar_phase.name}`));
+  }
+  lines.push("");
+  if (result.transit.planets) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 CURRENT SKY \u2500\u2500"));
+    const planets = result.transit.planets;
+    for (const name of ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"]) {
+      const planet = planets[name];
+      if (planet) {
+        const pColor = getPlanetColor(name);
+        const zColor = getZodiacColor(planet.sign);
+        const symbol = getPlanetSymbol(name);
+        const zodiac = getZodiacSymbol(planet.sign);
+        const deg = formatDegrees(planet.position);
+        const rx = planet.retrograde ? COLORS.mars("\u211E") : " ";
+        const cH = planet.house ? planet.house.replace(/ house/i, "").replace(/first/i, "1").replace(/second/i, "2").replace(/third/i, "3").replace(/fourth/i, "4").replace(/fifth/i, "5").replace(/sixth/i, "6").replace(/seventh/i, "7").replace(/eighth/i, "8").replace(/ninth/i, "9").replace(/tenth/i, "10").replace(/eleventh/i, "11").replace(/twelfth/i, "12") : "?";
+        lines.push(`   ${pColor(symbol)}  ${zColor(zodiac + " " + planet.sign)} ${chalk.white(deg)} ${rx} ${chalk.dim(`${cH}H`)}`);
+      }
+    }
+    lines.push("");
+  }
+  const transitHouses = result.transit.houses;
+  const natalHouses = result.natal_houses;
+  if (transitHouses && natalHouses && Object.keys(transitHouses).length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 HOUSES \u2500\u2500"));
+    lines.push(chalk.dim("       TRANSIT        NATAL"));
+    for (let i = 1; i <= 12; i++) {
+      const tH = transitHouses[String(i)];
+      const nH = natalHouses[String(i)];
+      if (tH && nH) {
+        const label = i === 1 ? "ASC" : i === 4 ? "IC" : i === 7 ? "DSC" : i === 10 ? "MC" : `${i}`.padStart(2) + "H";
+        const tZColor = getZodiacColor(tH.sign);
+        const nZColor = getZodiacColor(nH.sign);
+        const tZodiac = getZodiacSymbol(tH.sign);
+        const nZodiac = getZodiacSymbol(nH.sign);
+        const tDeg = formatDegrees(tH.position);
+        const nDeg = formatDegrees(nH.position);
+        lines.push(`   ${chalk.white(label.padStart(3))}  ${tZColor(tZodiac + " " + tH.sign)} ${chalk.dim(tDeg)}  ${nZColor(nZodiac + " " + nH.sign)} ${chalk.dim(nDeg)}`);
+      }
+    }
+    lines.push("");
+  }
+  lines.push(chalk.bold.cyan("\u2500\u2500 TRANSITS TO NATAL \u2500\u2500"));
+  if (result.aspects.length === 0) {
+    lines.push(chalk.dim("   No aspects within orb"));
+  } else {
+    const shortName = (name) => {
+      const map = {
+        "sun": "SUN",
+        "moon": "MOO",
+        "mercury": "MER",
+        "venus": "VEN",
+        "mars": "MAR",
+        "jupiter": "JUP",
+        "saturn": "SAT",
+        "uranus": "URA",
+        "neptune": "NEP",
+        "pluto": "PLU",
+        "chiron": "CHI",
+        "nn": "NN",
+        "sn": "SN",
+        "lilith": "LIL",
+        "mc": "MC",
+        "ic": "IC",
+        "asc": "ASC",
+        "dsc": "DSC"
+      };
+      return map[name.toLowerCase()] || name.slice(0, 3).toUpperCase();
+    };
+    for (const aspect of result.aspects) {
+      const tPlanet = aspect.transit_planet.toLowerCase().replace(/ /g, "_");
+      const nPlanet = aspect.natal_planet.toLowerCase().replace(/ /g, "_");
+      const tColor = getPlanetColor(tPlanet);
+      const nColor = getPlanetColor(nPlanet);
+      const tSym = getPlanetSymbol(tPlanet);
+      const nSym = getPlanetSymbol(nPlanet);
+      const tName = shortName(aspect.transit_planet);
+      const nName = shortName(aspect.natal_planet);
+      const aSym = getAspectSymbol(aspect.aspect);
+      const aColor = getAspectColor(aspect.aspect);
+      const aspectShort = aspect.aspect === "conjunction" ? "CNJ" : aspect.aspect === "opposition" ? "OPP" : aspect.aspect === "trine" ? "TRI" : aspect.aspect === "square" ? "SQR" : aspect.aspect === "sextile" ? "SXT" : aspect.aspect === "quintile" ? "QNT" : aspect.aspect === "quincunx" ? "QCX" : String(aspect.aspect).slice(0, 3).toUpperCase();
+      const tH = aspect.transit_house;
+      const nH = aspect.natal_house;
+      const houses = `${tH || "?"}H\u2192${nH || "?"}H`;
+      const orb = aspect.orb.toFixed(2).padStart(5);
+      lines.push(`   ${tColor(tSym)} ${tName.padEnd(3)} ${aColor(aSym + " " + aspectShort)} ${nColor(nSym)} ${nName.padEnd(3)}  ${chalk.dim(orb + "\xB0")}  ${chalk.dim(houses)}`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function formatMoon(result) {
+  const lines = [];
+  const moonEmoji = result.phase.illumination > 50 ? "\u{1F315}" : "\u{1F311}";
+  const zColor = getZodiacColor(result.moon.sign);
+  lines.push(chalk.bold.white(`
+${moonEmoji} Moon Phase`));
+  lines.push(chalk.dim(`   ${result.datetime}`));
+  lines.push("");
+  lines.push(`   ${COLORS.moon("\u263D")} ${chalk.white("Moon in")} ${zColor(result.moon.sign)} ${chalk.white(formatDegrees(result.moon.position))}`);
+  lines.push(`   ${chalk.white("Phase:")} ${COLORS.moon(result.phase.name)}`);
+  lines.push(`   ${chalk.white("Illumination:")} ${COLORS.moon(result.phase.illumination.toFixed(1) + "%")}`);
+  lines.push("");
+  return lines.join("\n");
+}
+function formatEphemeris(result) {
+  const lines = [];
+  const pColor = getPlanetColor(result.body);
+  const zColor = getZodiacColor(result.sign);
+  const symbol = getPlanetSymbol(result.body);
+  const rx = result.retrograde ? COLORS.mars(" \u211E") : "";
+  lines.push(chalk.bold.white(`
+\u{1315D} Ephemeris: ${result.body}`));
+  lines.push(chalk.dim(`   ${result.datetime}`));
+  lines.push("");
+  lines.push(`   ${pColor(symbol)} ${chalk.white(result.body)} in ${zColor(result.sign)} ${chalk.white(formatDegrees(result.position))}${rx}`);
+  lines.push(`   ${chalk.dim(`Absolute: ${result.abs_position.toFixed(4)}\xB0`)}`);
+  lines.push("");
+  return lines.join("\n");
+}
+function formatSolarReturn(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u2609 Solar Return ${result.return_year}`));
+  lines.push(chalk.dim(`   Natal: ${result.natal_date}`));
+  lines.push(chalk.dim(`   Exact: ${result.exact_datetime}`));
+  if (result.location.city) {
+    lines.push(chalk.dim(`   Location: ${result.location.city}`));
+  }
+  if (result.lunar_phase) {
+    lines.push(chalk.dim(`   Moon Phase: ${result.lunar_phase.emoji} ${result.lunar_phase.name}`));
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 ANGLES \u2500\u2500"));
+  const ascColor = getZodiacColor(result.ascendant.sign);
+  const mcColor = getZodiacColor(result.midheaven.sign);
+  lines.push(`   ${COLORS.mars("ASC")}  ${ascColor(getZodiacSymbol(result.ascendant.sign) + " " + result.ascendant.sign)} ${chalk.white(formatDegrees(result.ascendant.position))}`);
+  lines.push(`   ${COLORS.sun("MC")}   ${mcColor(getZodiacSymbol(result.midheaven.sign) + " " + result.midheaven.sign)} ${chalk.white(formatDegrees(result.midheaven.position))}`);
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 PLANETS \u2500\u2500"));
+  const planetOrder = ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"];
+  for (const name of planetOrder) {
+    const planet = result.planets[name];
+    if (planet) {
+      const pColor = getPlanetColor(name);
+      const zColor = getZodiacColor(planet.sign);
+      const symbol = getPlanetSymbol(name);
+      const zodiac = getZodiacSymbol(planet.sign);
+      const deg = formatDegrees(planet.position);
+      const rx = planet.retrograde ? COLORS.mars(" \u211E") : "";
+      const house = planet.house ? chalk.dim(` (${planet.house})`) : "";
+      lines.push(`   ${pColor(symbol)} ${name.padEnd(10)} ${zColor(zodiac + " " + planet.sign)} ${chalk.white(deg)}${rx}${house}`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function formatLunarReturn(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u263D Lunar Return`));
+  lines.push(chalk.dim(`   Natal: ${result.natal_date}`));
+  lines.push(chalk.dim(`   Natal Moon: ${getZodiacSymbol(result.natal_moon.sign)} ${result.natal_moon.sign} ${formatDegrees(result.natal_moon.position)}`));
+  lines.push(chalk.dim(`   Search from: ${result.search_from}`));
+  lines.push(chalk.green(`   Exact: ${result.exact_datetime}`));
+  if (result.location.city) {
+    lines.push(chalk.dim(`   Location: ${result.location.city}`));
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 ANGLES \u2500\u2500"));
+  const ascColor = getZodiacColor(result.ascendant.sign);
+  const mcColor = getZodiacColor(result.midheaven.sign);
+  lines.push(`   ${COLORS.mars("ASC")}  ${ascColor(getZodiacSymbol(result.ascendant.sign) + " " + result.ascendant.sign)} ${chalk.white(formatDegrees(result.ascendant.position))}`);
+  lines.push(`   ${COLORS.sun("MC")}   ${mcColor(getZodiacSymbol(result.midheaven.sign) + " " + result.midheaven.sign)} ${chalk.white(formatDegrees(result.midheaven.position))}`);
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 PLANETS \u2500\u2500"));
+  const planetOrder = ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"];
+  for (const name of planetOrder) {
+    const planet = result.planets[name];
+    if (planet) {
+      const pColor = getPlanetColor(name);
+      const zColor = getZodiacColor(planet.sign);
+      const symbol = getPlanetSymbol(name);
+      const zodiac = getZodiacSymbol(planet.sign);
+      const deg = formatDegrees(planet.position);
+      const rx = planet.retrograde ? COLORS.mars(" \u211E") : "";
+      const house = planet.house ? chalk.dim(` (${planet.house})`) : "";
+      lines.push(`   ${pColor(symbol)} ${name.padEnd(10)} ${zColor(zodiac + " " + planet.sign)} ${chalk.white(deg)}${rx}${house}`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function formatSynastry(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u{1F491} Synastry`));
+  lines.push(chalk.dim(`   ${result.person1.name} (${result.person1.date})`));
+  lines.push(chalk.dim(`   ${result.person2.name} (${result.person2.date})`));
+  lines.push(chalk.dim(`   Aspects found: ${result.aspect_count}`));
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 KEY POSITIONS \u2500\u2500"));
+  lines.push(chalk.dim(`       ${result.person1.name.slice(0, 10).padEnd(12)}  ${result.person2.name.slice(0, 10).padEnd(12)}`));
+  const planetOrder = ["sun", "moon", "mercury", "venus", "mars"];
+  for (const name of planetOrder) {
+    const p1 = result.person1.planets[name];
+    const p2 = result.person2.planets[name];
+    if (p1 && p2) {
+      const pColor = getPlanetColor(name);
+      const symbol = getPlanetSymbol(name);
+      const z1Color = getZodiacColor(p1.sign);
+      const z2Color = getZodiacColor(p2.sign);
+      lines.push(`   ${pColor(symbol)}  ${z1Color(p1.sign)} ${formatDegrees(p1.position).padEnd(7)}  ${z2Color(p2.sign)} ${formatDegrees(p2.position)}`);
+    }
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 SYNASTRY ASPECTS \u2500\u2500"));
+  if (result.aspects.length === 0) {
+    lines.push(chalk.dim("   No aspects within orb"));
+  } else {
+    for (const asp of result.aspects.slice(0, 20)) {
+      const p1Name = asp.planet1.toLowerCase().replace(/ /g, "_");
+      const p2Name = asp.planet2.toLowerCase().replace(/ /g, "_");
+      const p1Color = getPlanetColor(p1Name);
+      const p2Color = getPlanetColor(p2Name);
+      const p1Sym = getPlanetSymbol(p1Name);
+      const p2Sym = getPlanetSymbol(p2Name);
+      const aSym = getAspectSymbol(asp.aspect);
+      const aColor = getAspectColor(asp.aspect);
+      const aspectName = asp.aspect.charAt(0).toUpperCase() + asp.aspect.slice(1);
+      lines.push(`   ${p1Color(p1Sym)} ${asp.planet1.slice(0, 8).padEnd(8)} ${aColor(aSym)} ${aColor(aspectName.slice(0, 6).padEnd(6))} ${p2Color(p2Sym)} ${asp.planet2.slice(0, 8).padEnd(8)} ${chalk.dim(asp.orb.toFixed(2) + "\xB0")}`);
+    }
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function formatProgressions(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u{1F319} Secondary Progressions`));
+  lines.push(chalk.dim(`   Method: ${result.method}`));
+  lines.push(chalk.dim(`   Natal: ${result.natal_date}`));
+  lines.push(chalk.dim(`   Target: ${result.target_date} (age ${result.age_at_target})`));
+  lines.push(chalk.dim(`   Progressed date: ${result.progressed_date}`));
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 PROGRESSED ANGLES \u2500\u2500"));
+  const ascColor = getZodiacColor(result.progressed_ascendant.sign);
+  const mcColor = getZodiacColor(result.progressed_midheaven.sign);
+  lines.push(`   ${COLORS.mars("ASC")}  ${ascColor(getZodiacSymbol(result.progressed_ascendant.sign) + " " + result.progressed_ascendant.sign)} ${chalk.white(formatDegrees(result.progressed_ascendant.position))}`);
+  lines.push(`   ${COLORS.sun("MC")}   ${mcColor(getZodiacSymbol(result.progressed_midheaven.sign) + " " + result.progressed_midheaven.sign)} ${chalk.white(formatDegrees(result.progressed_midheaven.position))}`);
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 PROGRESSED vs NATAL \u2500\u2500"));
+  lines.push(chalk.dim("       PROGRESSED      NATAL"));
+  const planetOrder = ["sun", "moon", "mercury", "venus", "mars"];
+  for (const name of planetOrder) {
+    const prog = result.progressed_planets[name];
+    const natal = result.natal_planets[name];
+    if (prog && natal) {
+      const pColor = getPlanetColor(name);
+      const symbol = getPlanetSymbol(name);
+      const pZColor = getZodiacColor(prog.sign);
+      const nZColor = getZodiacColor(natal.sign);
+      const rx = prog.retrograde ? COLORS.mars("\u211E") : " ";
+      lines.push(`   ${pColor(symbol)}  ${pZColor(prog.sign)} ${formatDegrees(prog.position).padEnd(7)}${rx} ${nZColor(natal.sign)} ${formatDegrees(natal.position)}`);
+    }
+  }
+  lines.push("");
+  if (result.progressed_to_natal_aspects.length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 PROGRESSED \u2192 NATAL ASPECTS \u2500\u2500"));
+    for (const asp of result.progressed_to_natal_aspects.slice(0, 10)) {
+      const pName = asp.progressed.toLowerCase().replace(/ /g, "_");
+      const nName = asp.natal.toLowerCase().replace(/ /g, "_");
+      const pColor = getPlanetColor(pName);
+      const nColor = getPlanetColor(nName);
+      const pSym = getPlanetSymbol(pName);
+      const nSym = getPlanetSymbol(nName);
+      const aSym = getAspectSymbol(asp.aspect);
+      const aColor = getAspectColor(asp.aspect);
+      lines.push(`   ${pColor(pSym)} ${asp.progressed.slice(0, 8).padEnd(8)} ${aColor(aSym)} ${nColor(nSym)} ${asp.natal.slice(0, 8).padEnd(8)} ${chalk.dim(asp.orb.toFixed(2) + "\xB0")}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatEphemerisRange(result) {
+  const lines = [];
+  const pColor = getPlanetColor(result.body);
+  const symbol = getPlanetSymbol(result.body);
+  lines.push(chalk.bold.white(`
+${pColor(symbol)} ${result.body.charAt(0).toUpperCase() + result.body.slice(1)} Ephemeris`));
+  lines.push(chalk.dim(`   ${result.range.start} \u2192 ${result.range.end} (${result.range.step})`));
+  lines.push("");
+  if (result.sign_changes.length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 SIGN CHANGES \u2500\u2500"));
+    for (const change of result.sign_changes) {
+      const fromColor = getZodiacColor(change.from);
+      const toColor = getZodiacColor(change.to);
+      lines.push(`   ${chalk.white(change.date)}  ${fromColor(getZodiacSymbol(change.from) + " " + change.from)} \u2192 ${toColor(getZodiacSymbol(change.to) + " " + change.to)}`);
+    }
+    lines.push("");
+  }
+  if (result.retrograde_stations.length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 RETROGRADE STATIONS \u2500\u2500"));
+    for (const station of result.retrograde_stations) {
+      const zColor = getZodiacColor(station.sign);
+      const stationType = station.station === "retrograde" ? COLORS.mars("\u211E RETRO") : COLORS.jupiter("\u2B95 DIRECT");
+      lines.push(`   ${chalk.white(station.date)}  ${stationType}  ${zColor(station.sign)} ${formatDegrees(station.position)}`);
+    }
+    lines.push("");
+  }
+  lines.push(chalk.bold.cyan("\u2500\u2500 POSITIONS \u2500\u2500"));
+  for (const pos of result.positions) {
+    const zColor = getZodiacColor(pos.sign);
+    const rx = pos.retrograde ? COLORS.mars(" \u211E") : "";
+    lines.push(`   ${chalk.dim(pos.date)}  ${zColor(getZodiacSymbol(pos.sign) + " " + pos.sign)} ${chalk.white(formatDegrees(pos.position))}${rx}`);
+  }
+  lines.push("");
+  return lines.join("\n");
+}
+function formatComposite(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u{1F52E} Composite Chart`));
+  lines.push(chalk.dim(`   ${result.person1.name} + ${result.person2.name}`));
+  lines.push(chalk.dim(`   Method: ${result.method}`));
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 COMPOSITE ANGLES \u2500\u2500"));
+  const ascColor = getZodiacColor(result.ascendant.sign);
+  const mcColor = getZodiacColor(result.midheaven.sign);
+  lines.push(`   ${COLORS.mars("ASC")}  ${ascColor(getZodiacSymbol(result.ascendant.sign) + " " + result.ascendant.sign)} ${chalk.white(formatDegrees(result.ascendant.position))}`);
+  lines.push(`   ${COLORS.sun("MC")}   ${mcColor(getZodiacSymbol(result.midheaven.sign) + " " + result.midheaven.sign)} ${chalk.white(formatDegrees(result.midheaven.position))}`);
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 COMPOSITE PLANETS \u2500\u2500"));
+  const planetOrder = ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"];
+  for (const name of planetOrder) {
+    const planet = result.planets[name];
+    if (planet) {
+      const pColor = getPlanetColor(name);
+      const zColor = getZodiacColor(planet.sign);
+      const symbol = getPlanetSymbol(name);
+      const zodiac = getZodiacSymbol(planet.sign);
+      const deg = formatDegrees(planet.position);
+      const house = planet.house ? chalk.dim(` (${planet.house})`) : "";
+      lines.push(`   ${pColor(symbol)} ${name.padEnd(10)} ${zColor(zodiac + " " + planet.sign)} ${chalk.white(deg)}${house}`);
+    }
+  }
+  lines.push("");
+  lines.push(chalk.dim("   The composite chart represents the relationship as its own entity."));
+  lines.push(chalk.dim("   Each planet is the midpoint between both individuals' placements."));
+  lines.push("");
+  return lines.join("\n");
+}
+function formatSolarArc(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u2600\uFE0F Solar Arc Directions`));
+  lines.push(chalk.dim(`   Method: ${result.method}`));
+  lines.push(chalk.dim(`   Natal: ${result.natal_date}`));
+  lines.push(chalk.dim(`   Target: ${result.target_date} (age ${result.age_at_target})`));
+  lines.push(chalk.green(`   Solar Arc: ${result.solar_arc.toFixed(2)}\xB0`));
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 DIRECTED ANGLES \u2500\u2500"));
+  const ascColor = getZodiacColor(result.directed_ascendant.sign);
+  const mcColor = getZodiacColor(result.directed_midheaven.sign);
+  lines.push(`   ${COLORS.mars("ASC")}  ${ascColor(getZodiacSymbol(result.directed_ascendant.sign) + " " + result.directed_ascendant.sign)} ${chalk.white(formatDegrees(result.directed_ascendant.position))} ${chalk.dim(`\u2190 ${result.directed_ascendant.natal_sign} ${formatDegrees(result.directed_ascendant.natal_position)}`)}`);
+  lines.push(`   ${COLORS.sun("MC")}   ${mcColor(getZodiacSymbol(result.directed_midheaven.sign) + " " + result.directed_midheaven.sign)} ${chalk.white(formatDegrees(result.directed_midheaven.position))} ${chalk.dim(`\u2190 ${result.directed_midheaven.natal_sign} ${formatDegrees(result.directed_midheaven.natal_position)}`)}`);
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 DIRECTED PLANETS \u2500\u2500"));
+  lines.push(chalk.dim("       DIRECTED        \u2190 NATAL"));
+  const planetOrder = ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"];
+  for (const name of planetOrder) {
+    const planet = result.directed_planets[name];
+    if (planet) {
+      const pColor = getPlanetColor(name);
+      const symbol = getPlanetSymbol(name);
+      const dZColor = getZodiacColor(planet.sign);
+      const nZColor = getZodiacColor(planet.natal_sign);
+      lines.push(`   ${pColor(symbol)}  ${dZColor(planet.sign)} ${formatDegrees(planet.position).padEnd(7)} \u2190 ${nZColor(planet.natal_sign)} ${formatDegrees(planet.natal_position)}`);
+    }
+  }
+  lines.push("");
+  if (result.directed_to_natal_aspects.length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 DIRECTED \u2192 NATAL ASPECTS \u2500\u2500"));
+    for (const asp of result.directed_to_natal_aspects.slice(0, 15)) {
+      const dName = asp.directed.toLowerCase();
+      const nName = asp.natal.toLowerCase();
+      const dColor = getPlanetColor(dName);
+      const nColor = getPlanetColor(nName);
+      const dSym = getPlanetSymbol(dName);
+      const nSym = getPlanetSymbol(nName);
+      const aSym = getAspectSymbol(asp.aspect);
+      const aColor = getAspectColor(asp.aspect);
+      lines.push(`   ${dColor(dSym)} ${asp.directed.slice(0, 7).padEnd(7)} ${aColor(aSym)} ${nColor(nSym)} ${asp.natal.slice(0, 7).padEnd(7)} ${chalk.dim(asp.orb.toFixed(2) + "\xB0")}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatHorary(result) {
+  const lines = [];
+  lines.push(chalk.bold.white(`
+\u{1F52E} HORARY CHART`));
+  lines.push(chalk.bold.yellow(`   "${result.question}"`));
+  lines.push("");
+  lines.push(chalk.dim(`   Cast: ${result.cast_time.datetime}`));
+  if (result.cast_time.city) {
+    lines.push(chalk.dim(`   Location: ${result.cast_time.city}`));
+  }
+  lines.push(chalk.dim(`   Planetary Hour: ${result.planetary_hour} | Day Ruler: ${result.day_ruler}`));
+  lines.push("");
+  if (result.strictures.length > 0) {
+    lines.push(chalk.bold.red("\u26A0\uFE0F  STRICTURES AGAINST JUDGMENT"));
+    for (const stricture of result.strictures) {
+      lines.push(chalk.red(`   \u2022 ${stricture}`));
+    }
+    lines.push("");
+  }
+  lines.push(chalk.bold.cyan("\u2500\u2500 THE QUERENT \u2500\u2500"));
+  const qRuler = result.querent.ruler.toLowerCase();
+  const qColor = getPlanetColor(qRuler);
+  const qZColor = getZodiacColor(result.querent.sign);
+  const qPosZColor = getZodiacColor(result.querent.ruler_position.sign);
+  lines.push(`   Ascendant: ${qZColor(getZodiacSymbol(result.querent.sign) + " " + result.querent.sign)} ${formatDegrees(result.ascendant.position)}`);
+  lines.push(`   You are signified by: ${qColor(getPlanetSymbol(qRuler) + " " + result.querent.ruler)}`);
+  const rx = result.querent.ruler_position.retrograde ? COLORS.mars(" \u211E") : "";
+  lines.push(`   ${result.querent.ruler} is in: ${qPosZColor(result.querent.ruler_position.sign)} ${formatDegrees(result.querent.ruler_position.position)}${rx}`);
+  if (result.querent.ruler_position.house) {
+    lines.push(`   ${result.querent.ruler} is in: ${chalk.white(result.querent.ruler_position.house)}`);
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 THE MOON \u2500\u2500"));
+  const moonZColor = getZodiacColor(result.moon.sign);
+  lines.push(`   ${COLORS.moon("\u263D")} Moon in ${moonZColor(getZodiacSymbol(result.moon.sign) + " " + result.moon.sign)} ${formatDegrees(result.moon.position)}`);
+  if (result.moon.house) {
+    lines.push(`   House: ${chalk.white(result.moon.house)}`);
+  }
+  if (result.moon.void_of_course) {
+    lines.push(`   ${chalk.red("\u26A0\uFE0F  VOID OF COURSE")} \u2014 ${chalk.dim(`${result.moon.degrees_until_sign_change.toFixed(1)}\xB0 until sign change`)}`);
+    lines.push(chalk.dim("   (Nothing may come of the matter, or outcome is already fated)"));
+  } else {
+    lines.push(`   ${chalk.green("Moon is active")} \u2014 ${chalk.dim(`${result.moon.degrees_until_sign_change.toFixed(1)}\xB0 until sign change`)}`);
+  }
+  if (result.moon.aspects.length > 0) {
+    lines.push("");
+    lines.push(chalk.dim("   Moon aspects:"));
+    for (const asp of result.moon.aspects.slice(0, 5)) {
+      const pColor = getPlanetColor(asp.planet.toLowerCase());
+      const aSym = getAspectSymbol(asp.aspect);
+      const applying = asp.applying ? chalk.green("\u2192 applying") : chalk.dim("\u2190 separating");
+      lines.push(`   ${COLORS.moon("\u263D")} ${aSym} ${pColor(asp.planet.padEnd(8))} ${chalk.dim(asp.orb.toFixed(2) + "\xB0")} ${applying}`);
+    }
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 HOUSES \u2500\u2500"));
+  lines.push(chalk.dim("   Use these to identify the quesited (thing asked about):"));
+  lines.push("");
+  const importantHouses = ["1", "2", "5", "7", "10", "11"];
+  for (const num of importantHouses) {
+    const house = result.houses[num];
+    if (house) {
+      const hZColor = getZodiacColor(house.sign);
+      const ruler = house.ruler.toLowerCase();
+      const rColor = getPlanetColor(ruler);
+      lines.push(`   ${chalk.bold(num.padStart(2))}H  ${hZColor(getZodiacSymbol(house.sign))} ${house.sign.padEnd(3)} \u2192 ${rColor(house.ruler.padEnd(7))}  ${chalk.dim(house.topic)}`);
+    }
+  }
+  lines.push(chalk.dim("   ... (other houses available in JSON output)"));
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 KEY PLANETS \u2500\u2500"));
+  const keyPlanets = ["sun", "moon", "mercury", "venus", "mars", "jupiter", "saturn"];
+  for (const name of keyPlanets) {
+    const planet = result.planets[name];
+    if (planet) {
+      const pColor = getPlanetColor(name);
+      const zColor = getZodiacColor(planet.sign);
+      const symbol = getPlanetSymbol(name);
+      const deg = formatDegrees(planet.position);
+      const rx2 = planet.retrograde ? COLORS.mars(" \u211E") : "";
+      const house = planet.house ? chalk.dim(` (${planet.house})`) : "";
+      lines.push(`   ${pColor(symbol)} ${name.padEnd(8)} ${zColor(planet.sign)} ${deg}${rx2}${house}`);
+    }
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 HOW TO READ \u2500\u2500"));
+  lines.push(chalk.dim("   1. Identify the quesited's house (what you're asking about)"));
+  lines.push(chalk.dim("   2. Find that house's ruler (the significator)"));
+  lines.push(chalk.dim("   3. Look for aspects between querent's ruler and quesited's ruler"));
+  lines.push(chalk.dim("   4. Applying aspects = future contact; Separating = past"));
+  lines.push(chalk.dim("   5. Moon's next aspect often shows the outcome"));
+  lines.push("");
+  return lines.join("\n");
+}
+
+// src/types.ts
+function isError(result) {
+  return "error" in result;
+}
+
+export {
+  chart,
+  transit,
+  solarReturn,
+  lunarReturn,
+  synastry,
+  progressions,
+  ephemerisRange,
+  moon,
+  ephemeris,
+  composite,
+  solarArc,
+  horary,
+  version,
+  getZodiacSymbol,
+  getPlanetSymbol,
+  getAspectSymbol,
+  formatDegrees,
+  formatChart,
+  formatTransits,
+  formatMoon,
+  formatEphemeris,
+  formatSolarReturn,
+  formatLunarReturn,
+  formatSynastry,
+  formatProgressions,
+  formatEphemerisRange,
+  formatComposite,
+  formatSolarArc,
+  formatHorary,
+  isError
+};