thoth-cli 0.2.15 → 0.2.17

package/dist/bin.js

@@ -3,30 +3,38 @@ import {
   chart,
   composite,
   ephemeris,
+  ephemerisMulti,
   ephemerisRange,
   formatChart,
   formatComposite,
   formatEphemeris,
+  formatEphemerisMulti,
   formatEphemerisRange,
   formatHorary,
   formatLunarReturn,
   formatMoon,
+  formatMoonExtended,
   formatProgressions,
+  formatScore,
   formatSolarArc,
   formatSolarReturn,
   formatSynastry,
+  formatTransitScan,
   formatTransits,
   horary,
   isError,
   lunarReturn,
   moon,
+  moonExtended,
   progressions,
+  score,
   solarArc,
   solarReturn,
   synastry,
   transit,
+  transitScan,
   version
-} from "./chunk-SURUD7BV.js";
+} from "./chunk-QND56LGZ.js";
 
 // src/bin.ts
 import { Command } from "commander";
@@ -88,7 +96,7 @@ EPHEMERIS & MOON
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
 REFERENCE
 \u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501\u2501
-  thoth key                                           # full symbol reference`).version("0.2.15");
+  thoth key                                           # full symbol reference`).version("0.2.17");
 program.command("chart").description("Calculate a natal chart").requiredOption("--date <date>", "Birth date (YYYY-MM-DD)").requiredOption("--time <time>", "Birth time (HH:MM)").option("--lat <lat>", "Latitude", parseFloat).option("--lng <lng>", "Longitude", parseFloat).option("--city <city>", "City name").option("--nation <nation>", "Country code", "US").option("--name <name>", "Name", "Subject").option("--json", "Output raw JSON").option("--svg", "Output SVG chart").option("--svg-file <path>", "Save SVG to file").action(async (options) => {
   if (!options.city && (!options.lat || !options.lng)) {
     console.error(chalk.red("Error: Must provide either --city or both --lat and --lng"));
@@ -664,7 +672,134 @@ program.command("key").description("Symbol reference guide").action(() => {
   console.log(`   ${chalk.bold("Fall")}        Planet opposite exaltation. Weakened. ${chalk.dim("e.g., \u2609 in Libra")}`);
   console.log("");
 });
+program.command("score").description("Calculate relationship compatibility score").requiredOption("--date1 <date>", "Person 1 birth date (YYYY-MM-DD)").requiredOption("--time1 <time>", "Person 1 birth time (HH:MM)").option("--city1 <city>", "Person 1 city").option("--nation1 <nation>", "Person 1 country code", "US").option("--lat1 <lat>", "Person 1 latitude", parseFloat).option("--lng1 <lng>", "Person 1 longitude", parseFloat).option("--name1 <name>", "Person 1 name", "Person 1").requiredOption("--date2 <date>", "Person 2 birth date (YYYY-MM-DD)").requiredOption("--time2 <time>", "Person 2 birth time (HH:MM)").option("--city2 <city>", "Person 2 city").option("--nation2 <nation>", "Person 2 country code", "US").option("--lat2 <lat>", "Person 2 latitude", parseFloat).option("--lng2 <lng>", "Person 2 longitude", parseFloat).option("--name2 <name>", "Person 2 name", "Person 2").option("--json", "Output raw JSON").action(async (options) => {
+  const [year1, month1, day1] = options.date1.split("-").map(Number);
+  const [hour1, minute1] = options.time1.split(":").map(Number);
+  const [year2, month2, day2] = options.date2.split("-").map(Number);
+  const [hour2, minute2] = options.time2.split(":").map(Number);
+  const spinner = ora("Calculating compatibility...").start();
+  const result = await score({
+    year1,
+    month1,
+    day1,
+    hour1,
+    minute1,
+    city1: options.city1,
+    nation1: options.nation1,
+    lat1: options.lat1,
+    lng1: options.lng1,
+    name1: options.name1,
+    year2,
+    month2,
+    day2,
+    hour2,
+    minute2,
+    city2: options.city2,
+    nation2: options.nation2,
+    lat2: options.lat2,
+    lng2: options.lng2,
+    name2: options.name2
+  });
+  spinner.stop();
+  if (isError(result)) {
+    console.error(chalk.red("Error: " + result.error));
+    process.exit(1);
+  }
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatScore(result));
+  }
+});
+program.command("moon-extended").description("Get detailed moon data with eclipses and sunrise/sunset").option("--date <date>", "Date (YYYY-MM-DD, default: today)").option("--lat <lat>", "Latitude", parseFloat, 40.7128).option("--lng <lng>", "Longitude", parseFloat, -74.006).option("--tz <tz>", "Timezone", "America/New_York").option("--json", "Output raw JSON").action(async (options) => {
+  let year, month, day;
+  if (options.date) {
+    [year, month, day] = options.date.split("-").map(Number);
+  }
+  const spinner = ora("Getting moon details...").start();
+  const result = await moonExtended({
+    year,
+    month,
+    day,
+    lat: options.lat,
+    lng: options.lng,
+    tz: options.tz
+  });
+  spinner.stop();
+  if (isError(result)) {
+    console.error(chalk.red("Error: " + result.error));
+    process.exit(1);
+  }
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatMoonExtended(result));
+  }
+});
+program.command("transit-scan").description("Scan for transit aspects over a date range").requiredOption("--natal-date <date>", "Natal birth date (YYYY-MM-DD)").requiredOption("--natal-time <time>", "Natal birth time (HH:MM)").option("--city <city>", "Natal city").option("--nation <nation>", "Country code", "US").option("--lat <lat>", "Natal latitude", parseFloat).option("--lng <lng>", "Natal longitude", parseFloat).requiredOption("--from <date>", "Start date (YYYY-MM-DD)").requiredOption("--to <date>", "End date (YYYY-MM-DD)").option("--orb <orb>", "Aspect orb in degrees", parseFloat, 1).option("--step <step>", "Step: day or week", "day").option("--json", "Output raw JSON").action(async (options) => {
+  const [natalYear, natalMonth, natalDay] = options.natalDate.split("-").map(Number);
+  const [natalHour, natalMinute] = options.natalTime.split(":").map(Number);
+  const [startYear, startMonth, startDay] = options.from.split("-").map(Number);
+  const [endYear, endMonth, endDay] = options.to.split("-").map(Number);
+  const spinner = ora("Scanning transits...").start();
+  const result = await transitScan({
+    natalYear,
+    natalMonth,
+    natalDay,
+    natalHour,
+    natalMinute,
+    natalCity: options.city,
+    nation: options.nation,
+    natalLat: options.lat,
+    natalLng: options.lng,
+    startYear,
+    startMonth,
+    startDay,
+    endYear,
+    endMonth,
+    endDay,
+    orb: options.orb,
+    step: options.step
+  });
+  spinner.stop();
+  if (isError(result)) {
+    console.error(chalk.red("Error: " + result.error));
+    process.exit(1);
+  }
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatTransitScan(result));
+  }
+});
+program.command("ephemeris-multi").description("Get ephemeris for multiple bodies over a date range").option("--bodies <bodies>", "Comma-separated bodies", "sun,moon,mercury,venus,mars,jupiter,saturn").requiredOption("--from <date>", "Start date (YYYY-MM-DD)").requiredOption("--to <date>", "End date (YYYY-MM-DD)").option("--step <step>", "Step: hour, day, week, month", "day").option("--lat <lat>", "Latitude", parseFloat).option("--lng <lng>", "Longitude", parseFloat).option("--json", "Output raw JSON").action(async (options) => {
+  const [startYear, startMonth, startDay] = options.from.split("-").map(Number);
+  const [endYear, endMonth, endDay] = options.to.split("-").map(Number);
+  const spinner = ora("Getting ephemeris data...").start();
+  const result = await ephemerisMulti({
+    bodies: options.bodies,
+    startYear,
+    startMonth,
+    startDay,
+    endYear,
+    endMonth,
+    endDay,
+    step: options.step,
+    lat: options.lat,
+    lng: options.lng
+  });
+  spinner.stop();
+  if (isError(result)) {
+    console.error(chalk.red("Error: " + result.error));
+    process.exit(1);
+  }
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+  } else {
+    console.log(formatEphemerisMulti(result));
+  }
+});
 console.log(chalk.dim(""));
-console.log(chalk.yellow("  \u{1315D}") + chalk.dim(" thoth-cli v0.2.15"));
+console.log(chalk.yellow("  \u{1315D}") + chalk.dim(" thoth-cli v0.2.17"));
 console.log(chalk.dim(""));
 program.parse();

package/dist/{chunk-SURUD7BV.js → chunk-QND56LGZ.js}

@@ -400,6 +400,120 @@ async function horary(options) {
 async function version() {
   return execute("version", []);
 }
+async function score(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));
+  }
+  return execute("score", args);
+}
+async function moonExtended(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 !== void 0) args.push("--lat", String(options.lat));
+  if (options.lng !== void 0) args.push("--lng", String(options.lng));
+  if (options.tz) args.push("--tz", options.tz);
+  return execute("moon-extended", args);
+}
+async function transitScan(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),
+    "--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),
+    "--orb",
+    String(options.orb ?? 1),
+    "--step",
+    options.step ?? "day"
+  ];
+  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("transit-scan", args);
+}
+async function ephemerisMulti(options) {
+  const args = [
+    "--bodies",
+    options.bodies ?? "sun,moon,mercury,venus,mars,jupiter,saturn",
+    "--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 ?? "day"
+  ];
+  if (options.lat !== void 0) args.push("--lat", String(options.lat));
+  if (options.lng !== void 0) args.push("--lng", String(options.lng));
+  return execute("ephemeris-multi", args);
+}
 
 // src/lib/format.ts
 import chalk from "chalk";
@@ -1171,6 +1285,155 @@ function formatHorary(result) {
   lines.push("");
   return lines.join("\n");
 }
+function formatScore(result) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk.bold.magenta("\u{1F495} Relationship Compatibility Score"));
+  lines.push("");
+  const scoreValue = result.score.value;
+  const scoreDesc = result.score.description;
+  const scoreColor = scoreValue >= 15 ? chalk.green : scoreValue >= 8 ? chalk.yellow : chalk.red;
+  lines.push(`   ${chalk.bold("Score:")} ${scoreColor(scoreValue)} / 20 (${scoreDesc})`);
+  if (result.score.is_destiny_sign) {
+    lines.push(`   ${chalk.magenta("\u2728 Destiny Sign Connection!")}`);
+  }
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 COMPARISON \u2500\u2500"));
+  const p1 = result.person1;
+  const p2 = result.person2;
+  lines.push(`   ${chalk.bold(p1.name)}: ${getZodiacSymbol(p1.sun)} ${p1.sun} Sun, ${getZodiacSymbol(p1.moon)} ${p1.moon} Moon`);
+  lines.push(`   ${chalk.bold(p2.name)}: ${getZodiacSymbol(p2.sun)} ${p2.sun} Sun, ${getZodiacSymbol(p2.moon)} ${p2.moon} Moon`);
+  lines.push("");
+  if (result.breakdown && result.breakdown.length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 SCORE BREAKDOWN \u2500\u2500"));
+    for (const b of result.breakdown) {
+      const pointColor = b.points > 0 ? chalk.green : chalk.red;
+      lines.push(`   ${pointColor(`+${b.points}`)} ${b.description}`);
+      lines.push(chalk.dim(`      ${b.details}`));
+    }
+    lines.push("");
+  }
+  if (result.aspects && result.aspects.length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 KEY ASPECTS \u2500\u2500"));
+    for (const asp of result.aspects.slice(0, 10)) {
+      const aspSymbol = getAspectSymbol(asp.aspect);
+      lines.push(`   ${asp.planet1} ${aspSymbol} ${asp.aspect} ${asp.planet2}  ${chalk.dim(`(orb: ${asp.orb}\xB0)`)}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatMoonExtended(result) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk.bold.hex("#C0C0C0")(`\u{1F319} Moon Extended \u2014 ${result.datetime}`));
+  lines.push(`   Location: ${result.location.lat}\xB0, ${result.location.lng}\xB0 (${result.location.timezone})`);
+  lines.push("");
+  const moon2 = result.moon;
+  const moonColor = COLORS.moon;
+  lines.push(chalk.bold.cyan("\u2500\u2500 MOON \u2500\u2500"));
+  lines.push(`   ${moon2.emoji} ${chalk.bold(moon2.phase_name)} (${moon2.stage})`);
+  lines.push(`   ${moonColor(getZodiacSymbol(moon2.sign))} Moon in ${moon2.sign}`);
+  lines.push(`   Illumination: ${moon2.illumination}`);
+  lines.push(`   Age: ${moon2.age_days} days`);
+  lines.push("");
+  const sun = result.sun;
+  lines.push(chalk.bold.cyan("\u2500\u2500 SUN \u2500\u2500"));
+  lines.push(`   \u2600\uFE0F Sunrise: ${sun.sunrise}  |  Sunset: ${sun.sunset}`);
+  lines.push(`   Solar noon: ${sun.solar_noon}  |  Day length: ${sun.day_length}`);
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 ECLIPSES \u2500\u2500"));
+  if (moon2.next_lunar_eclipse) {
+    lines.push(`   \u{1F311} Next Lunar Eclipse: ${moon2.next_lunar_eclipse.date}`);
+    lines.push(`      Type: ${moon2.next_lunar_eclipse.type}`);
+  }
+  if (sun.next_solar_eclipse) {
+    lines.push(`   \u2600\uFE0F Next Solar Eclipse: ${sun.next_solar_eclipse.date}`);
+    lines.push(`      Type: ${sun.next_solar_eclipse.type}`);
+  }
+  lines.push("");
+  if (result.upcoming_phases) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 UPCOMING PHASES \u2500\u2500"));
+    const phases = ["new_moon", "first_quarter", "full_moon", "last_quarter"];
+    const phaseEmojis = {
+      "new_moon": "\u{1F311}",
+      "first_quarter": "\u{1F313}",
+      "full_moon": "\u{1F315}",
+      "last_quarter": "\u{1F317}"
+    };
+    for (const phase of phases) {
+      const data = result.upcoming_phases[phase];
+      if (data && data.next) {
+        const emoji = phaseEmojis[phase] || "\u{1F319}";
+        const name = phase.replace("_", " ").replace(/\b\w/g, (c) => c.toUpperCase());
+        lines.push(`   ${emoji} ${name}: ${data.next} ${chalk.dim(`(${data.days_until_next} days)`)}`);
+      }
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatTransitScan(result) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk.bold.blue("\u{1F52D} Transit Scan"));
+  lines.push(`   Natal: ${result.natal.date}`);
+  lines.push(`   Range: ${result.scan_range.start} to ${result.scan_range.end}`);
+  lines.push(`   Step: ${result.scan_range.step}  |  Orb: ${result.scan_range.orb}\xB0`);
+  lines.push(`   Found: ${result.total_hits} transit hits`);
+  lines.push("");
+  if (result.hits && result.hits.length > 0) {
+    lines.push(chalk.bold.cyan("\u2500\u2500 TRANSIT HITS \u2500\u2500"));
+    let currentDate = "";
+    for (const hit of result.hits) {
+      if (hit.date !== currentDate) {
+        currentDate = hit.date;
+        lines.push("");
+        lines.push(chalk.bold(`   \u{1F4C5} ${hit.date}`));
+      }
+      const tColor = getPlanetColor(hit.transit_planet.toLowerCase());
+      const nColor = getPlanetColor(hit.natal_planet.toLowerCase());
+      const aspSymbol = getAspectSymbol(hit.aspect);
+      lines.push(`      ${tColor(hit.transit_planet)} ${aspSymbol} ${hit.aspect.slice(0, 4)} ${nColor(hit.natal_planet)}  ${chalk.dim(`(${hit.orb.toFixed(2)}\xB0)`)}`);
+    }
+    lines.push("");
+  }
+  return lines.join("\n");
+}
+function formatEphemerisMulti(result) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u{1F4CA} Multi-Body Ephemeris"));
+  lines.push(`   Bodies: ${result.bodies.join(", ")}`);
+  lines.push(`   Range: ${result.range.start} to ${result.range.end}`);
+  lines.push(`   Step: ${result.range.step}  |  Points: ${result.total_points}`);
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 POSITIONS \u2500\u2500"));
+  const bodyHeaders = result.bodies.map((b) => b.slice(0, 6).padEnd(8)).join("");
+  lines.push(`   ${chalk.dim("Date".padEnd(12))}${bodyHeaders}`);
+  lines.push(chalk.dim("   " + "\u2500".repeat(12 + result.bodies.length * 8)));
+  for (const pos of result.positions.slice(0, 30)) {
+    const date = pos.datetime.slice(0, 10);
+    let row = `   ${date}  `;
+    for (const body of result.bodies) {
+      const data = pos[body];
+      if (data && typeof data === "object") {
+        const sign = data.sign.slice(0, 3);
+        const deg = Math.floor(data.position);
+        const color = getZodiacColor(sign);
+        row += color(`${sign}${deg}\xB0`.padEnd(8));
+      } else {
+        row += "".padEnd(8);
+      }
+    }
+    lines.push(row);
+  }
+  if (result.positions.length > 30) {
+    lines.push(chalk.dim(`   ... and ${result.positions.length - 30} more rows (use --json for full data)`));
+  }
+  lines.push("");
+  return lines.join("\n");
+}
 
 // src/types.ts
 function isError(result) {
@@ -1191,6 +1454,10 @@ export {
   solarArc,
   horary,
   version,
+  score,
+  moonExtended,
+  transitScan,
+  ephemerisMulti,
   getZodiacSymbol,
   getPlanetSymbol,
   getAspectSymbol,
@@ -1207,5 +1474,9 @@ export {
   formatComposite,
   formatSolarArc,
   formatHorary,
+  formatScore,
+  formatMoonExtended,
+  formatTransitScan,
+  formatEphemerisMulti,
   isError
 };

package/dist/index.d.ts

@@ -498,6 +498,179 @@ interface ThothError {
 }
 type ThothResult<T> = T | ThothError;
 declare function isError<T extends object>(result: ThothResult<T>): result is ThothError;
+interface ScoreOptions {
+    year1: number;
+    month1: number;
+    day1: number;
+    hour1?: number;
+    minute1?: number;
+    city1?: string;
+    nation1?: string;
+    lat1?: number;
+    lng1?: number;
+    name1?: string;
+    year2: number;
+    month2: number;
+    day2: number;
+    hour2?: number;
+    minute2?: number;
+    city2?: string;
+    nation2?: string;
+    lat2?: number;
+    lng2?: number;
+    name2?: string;
+}
+interface ScoreResult {
+    type: string;
+    person1: {
+        name: string;
+        date: string;
+        sun: string;
+        moon: string;
+        ascendant?: string;
+    };
+    person2: {
+        name: string;
+        date: string;
+        sun: string;
+        moon: string;
+        ascendant?: string;
+    };
+    score: {
+        value: number;
+        description: string;
+        is_destiny_sign: boolean;
+    };
+    breakdown: Array<{
+        rule: string;
+        description: string;
+        points: number;
+        details: string;
+    }>;
+    aspects: Array<{
+        planet1: string;
+        planet2: string;
+        aspect: string;
+        orb: number;
+    }>;
+}
+interface MoonExtendedOptions {
+    year?: number;
+    month?: number;
+    day?: number;
+    lat?: number;
+    lng?: number;
+    tz?: string;
+}
+interface MoonExtendedResult {
+    type: string;
+    datetime: string;
+    location: {
+        lat: number;
+        lng: number;
+        timezone: string;
+    };
+    sun: {
+        sunrise: string;
+        sunset: string;
+        solar_noon: string;
+        day_length: string;
+        next_solar_eclipse?: {
+            date: string;
+            type: string;
+        };
+    };
+    moon: {
+        sign: string;
+        phase_name: string;
+        major_phase: string;
+        stage: string;
+        illumination: string;
+        age_days: number;
+        emoji: string;
+        moonrise?: string;
+        moonset?: string;
+        next_lunar_eclipse?: {
+            date: string;
+            type: string;
+        };
+    };
+    upcoming_phases?: Record<string, {
+        last?: string;
+        next?: string;
+        days_until_next?: number;
+    }>;
+}
+interface TransitScanOptions {
+    natalYear: number;
+    natalMonth: number;
+    natalDay: number;
+    natalHour?: number;
+    natalMinute?: number;
+    natalCity?: string;
+    nation?: string;
+    natalLat?: number;
+    natalLng?: number;
+    startYear: number;
+    startMonth?: number;
+    startDay?: number;
+    endYear: number;
+    endMonth?: number;
+    endDay?: number;
+    orb?: number;
+    step?: 'day' | 'week';
+}
+interface TransitScanResult {
+    type: string;
+    natal: {
+        date: string;
+    };
+    scan_range: {
+        start: string;
+        end: string;
+        step: string;
+        orb: number;
+    };
+    hits: Array<{
+        date: string;
+        transit_planet: string;
+        aspect: string;
+        natal_planet: string;
+        orb: number;
+    }>;
+    total_hits: number;
+}
+interface EphemerisMultiOptions {
+    bodies?: string;
+    startYear: number;
+    startMonth?: number;
+    startDay?: number;
+    endYear: number;
+    endMonth?: number;
+    endDay?: number;
+    step?: 'hour' | 'day' | 'week' | 'month';
+    lat?: number;
+    lng?: number;
+}
+interface EphemerisMultiResult {
+    type: string;
+    bodies: string[];
+    range: {
+        start: string;
+        end: string;
+        step: string;
+    };
+    positions: Array<{
+        datetime: string;
+        [body: string]: {
+            sign: string;
+            position: number;
+            abs_position: number;
+            retrograde: boolean;
+        } | string;
+    }>;
+    total_points: number;
+}
 
 /**
  * Core wrapper for thoth-core binary
@@ -558,6 +731,22 @@ declare function horary(options: HoraryOptions): Promise<ThothResult<HoraryResul
 declare function version(): Promise<ThothResult<{
     version: string;
 }>>;
+/**
+ * Calculate relationship compatibility score
+ */
+declare function score(options: ScoreOptions): Promise<ThothResult<ScoreResult>>;
+/**
+ * Get extended moon data with eclipses
+ */
+declare function moonExtended(options: MoonExtendedOptions): Promise<ThothResult<MoonExtendedResult>>;
+/**
+ * Scan for transits over a date range
+ */
+declare function transitScan(options: TransitScanOptions): Promise<ThothResult<TransitScanResult>>;
+/**
+ * Get multi-body ephemeris over a date range
+ */
+declare function ephemerisMulti(options: EphemerisMultiOptions): Promise<ThothResult<EphemerisMultiResult>>;
 
 /**
  * Output formatting utilities
@@ -628,5 +817,21 @@ declare function formatSolarArc(result: SolarArcResult): string;
  * Format horary chart result
  */
 declare function formatHorary(result: HoraryResult): string;
+/**
+ * Format relationship compatibility score
+ */
+declare function formatScore(result: any): string;
+/**
+ * Format extended moon data
+ */
+declare function formatMoonExtended(result: any): string;
+/**
+ * Format transit scan results
+ */
+declare function formatTransitScan(result: any): string;
+/**
+ * Format multi-body ephemeris
+ */
+declare function formatEphemerisMulti(result: any): string;
 
-export { type Aspect, type ChartOptions, type ChartResult, type CompositeOptions, type CompositeResult, type DirectedPlanet, type EphemerisOptions, type EphemerisPosition, type EphemerisRangeOptions, type EphemerisRangeResult, type EphemerisResult, type HoraryHouse, type HoraryOptions, type HoraryResult, type House, type LunarPhase, type LunarReturnOptions, type LunarReturnResult, type MoonAspect, type MoonOptions, type MoonResult, type Planet, type ProgressionsOptions, type ProgressionsResult, type RetrogradeStation, type SignChange, type SolarArcOptions, type SolarArcResult, type SolarReturnOptions, type SolarReturnResult, type SynastryOptions, type SynastryResult, type ThothError, type ThothResult, type TransitOptions, type TransitResult, chart, composite, ephemeris, ephemerisRange, formatChart, formatComposite, formatDegrees, formatEphemeris, formatEphemerisRange, formatHorary, formatLunarReturn, formatMoon, formatProgressions, formatSolarArc, formatSolarReturn, formatSynastry, formatTransits, getAspectSymbol, getPlanetSymbol, getZodiacSymbol, horary, isError, lunarReturn, moon, progressions, solarArc, solarReturn, synastry, transit, version };
+export { type Aspect, type ChartOptions, type ChartResult, type CompositeOptions, type CompositeResult, type DirectedPlanet, type EphemerisMultiOptions, type EphemerisMultiResult, type EphemerisOptions, type EphemerisPosition, type EphemerisRangeOptions, type EphemerisRangeResult, type EphemerisResult, type HoraryHouse, type HoraryOptions, type HoraryResult, type House, type LunarPhase, type LunarReturnOptions, type LunarReturnResult, type MoonAspect, type MoonExtendedOptions, type MoonExtendedResult, type MoonOptions, type MoonResult, type Planet, type ProgressionsOptions, type ProgressionsResult, type RetrogradeStation, type ScoreOptions, type ScoreResult, type SignChange, type SolarArcOptions, type SolarArcResult, type SolarReturnOptions, type SolarReturnResult, type SynastryOptions, type SynastryResult, type ThothError, type ThothResult, type TransitOptions, type TransitResult, type TransitScanOptions, type TransitScanResult, chart, composite, ephemeris, ephemerisMulti, ephemerisRange, formatChart, formatComposite, formatDegrees, formatEphemeris, formatEphemerisMulti, formatEphemerisRange, formatHorary, formatLunarReturn, formatMoon, formatMoonExtended, formatProgressions, formatScore, formatSolarArc, formatSolarReturn, formatSynastry, formatTransitScan, formatTransits, getAspectSymbol, getPlanetSymbol, getZodiacSymbol, horary, isError, lunarReturn, moon, moonExtended, progressions, score, solarArc, solarReturn, synastry, transit, transitScan, version };

package/dist/index.js

@@ -2,19 +2,24 @@ import {
   chart,
   composite,
   ephemeris,
+  ephemerisMulti,
   ephemerisRange,
   formatChart,
   formatComposite,
   formatDegrees,
   formatEphemeris,
+  formatEphemerisMulti,
   formatEphemerisRange,
   formatHorary,
   formatLunarReturn,
   formatMoon,
+  formatMoonExtended,
   formatProgressions,
+  formatScore,
   formatSolarArc,
   formatSolarReturn,
   formatSynastry,
+  formatTransitScan,
   formatTransits,
   getAspectSymbol,
   getPlanetSymbol,
@@ -23,30 +28,38 @@ import {
   isError,
   lunarReturn,
   moon,
+  moonExtended,
   progressions,
+  score,
   solarArc,
   solarReturn,
   synastry,
   transit,
+  transitScan,
   version
-} from "./chunk-SURUD7BV.js";
+} from "./chunk-QND56LGZ.js";
 export {
   chart,
   composite,
   ephemeris,
+  ephemerisMulti,
   ephemerisRange,
   formatChart,
   formatComposite,
   formatDegrees,
   formatEphemeris,
+  formatEphemerisMulti,
   formatEphemerisRange,
   formatHorary,
   formatLunarReturn,
   formatMoon,
+  formatMoonExtended,
   formatProgressions,
+  formatScore,
   formatSolarArc,
   formatSolarReturn,
   formatSynastry,
+  formatTransitScan,
   formatTransits,
   getAspectSymbol,
   getPlanetSymbol,
@@ -55,10 +68,13 @@ export {
   isError,
   lunarReturn,
   moon,
+  moonExtended,
   progressions,
+  score,
   solarArc,
   solarReturn,
   synastry,
   transit,
+  transitScan,
   version
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "thoth-cli",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "𓅝 Astrological calculations from the command line. Swiss Ephemeris precision. Built for humans and agents.",
   "author": "AKLO <aklo@aklolabs.com>",
   "license": "MIT",

package/scripts/postinstall.js

@@ -14,7 +14,7 @@ import https from 'https';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
 
-const VERSION = '0.2.15';
+const VERSION = '0.2.17';
 const REPO = 'aklo360/thoth-cli';
 
 // Use jsDelivr CDN for faster downloads (mirrors GitHub releases)