thoth-cli 0.1.0

package/README.md

@@ -0,0 +1,25 @@
+# 𓅝 thoth-cli
+
+Hermetic astrology from the command line.
+
+See the [main README](../../README.md) for full documentation.
+
+## Quick Start
+
+```bash
+npm install -g thoth-cli
+
+thoth chart --date 1879-03-14 --time 11:30 --city "Ulm" --nation "DE" --name "Einstein"
+thoth transit --natal-date 1879-03-14 --natal-time 11:30 --city "Ulm" --nation "DE"
+thoth moon
+thoth ephemeris --body pluto
+thoth key
+```
+
+## Privacy
+
+No data collection. All calculations run locally.
+
+## License
+
+MIT

package/dist/bin.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/bin.js

@@ -0,0 +1,298 @@
+#!/usr/bin/env node
+import {
+  chart,
+  ephemeris,
+  formatChart,
+  formatEphemeris,
+  formatMoon,
+  formatTransits,
+  isError,
+  moon,
+  transit,
+  version
+} from "./chunk-NYXKYHNK.js";
+
+// src/bin.ts
+import { Command } from "commander";
+import chalk from "chalk";
+import ora from "ora";
+var program = new Command();
+program.name("thoth").description(`\u{1315D} Astrological calculations from the command line
+
+Examples:
+  thoth chart --date 1991-07-08 --time 14:06 --city "New York"
+  thoth transit --natal-date 1991-07-08 --natal-time 14:06 --city "New York"
+  thoth moon
+  thoth ephemeris --body pluto`).version("0.1.0");
+program.command("chart").description(`Calculate a natal chart
+
+  Examples:
+    thoth chart --date 1991-07-08 --time 14:06 --city "New York" --name "AKLO"
+    thoth chart --date 1986-07-29 --time 12:00 --lat 40.7128 --lng -74.0060`).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 (e.g., "New York")').option("--nation <nation>", "Country code (e.g., US, UK)", "US").option("--name <name>", "Name", "Subject").option("--json", "Output raw JSON").action(async (options) => {
+  if (!options.city && (!options.lat || !options.lng)) {
+    console.error(chalk.red("Error: Must provide either --city or both --lat and --lng"));
+    process.exit(1);
+  }
+  const spinner = ora("Calculating chart...").start();
+  const [year, month, day] = options.date.split("-").map(Number);
+  const [hour, minute] = options.time.split(":").map(Number);
+  const result = await chart({
+    year,
+    month,
+    day,
+    hour,
+    minute,
+    lat: options.lat,
+    lng: options.lng,
+    city: options.city,
+    nation: options.nation,
+    name: options.name
+  });
+  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(formatChart(result));
+  }
+});
+program.command("transit").description(`Calculate transits to a natal chart
+
+  Examples:
+    thoth transit --natal-date 1991-07-08 --natal-time 14:06 --city "New York"
+    thoth transit --natal-date 1991-07-08 --natal-time 14:06 --city "New York" --orb 1`).requiredOption("--natal-date <date>", "Natal date (YYYY-MM-DD)").requiredOption("--natal-time <time>", "Natal time (HH:MM)").option("--lat <lat>", "Latitude", parseFloat).option("--lng <lng>", "Longitude", parseFloat).option("--city <city>", 'City name (e.g., "New York")').option("--nation <nation>", "Country code (e.g., US, UK)", "US").option("--transit-date <date>", "Transit date (YYYY-MM-DD, default: today)").option("--orb <degrees>", "Orb in degrees", parseFloat, 3).option("--json", "Output raw JSON").action(async (options) => {
+  if (!options.city && (!options.lat || !options.lng)) {
+    console.error(chalk.red("Error: Must provide either --city or both --lat and --lng"));
+    process.exit(1);
+  }
+  const spinner = ora("Calculating transits...").start();
+  const [natalYear, natalMonth, natalDay] = options.natalDate.split("-").map(Number);
+  const [natalHour, natalMinute] = options.natalTime.split(":").map(Number);
+  let transitYear, transitMonth, transitDay;
+  if (options.transitDate) {
+    [transitYear, transitMonth, transitDay] = options.transitDate.split("-").map(Number);
+  }
+  const result = await transit({
+    natalYear,
+    natalMonth,
+    natalDay,
+    natalHour,
+    natalMinute,
+    natalLat: options.lat,
+    natalLng: options.lng,
+    natalCity: options.city,
+    nation: options.nation,
+    transitYear,
+    transitMonth,
+    transitDay,
+    orb: options.orb
+  });
+  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(formatTransits(result));
+  }
+});
+program.command("moon").description("Get current moon phase and position").option("--date <date>", "Date (YYYY-MM-DD, default: today)").option("--lat <lat>", "Latitude", parseFloat, 40.7128).option("--lng <lng>", "Longitude", parseFloat, -74.006).option("--json", "Output raw JSON").action(async (options) => {
+  const spinner = ora("Getting moon phase...").start();
+  let year, month, day;
+  if (options.date) {
+    [year, month, day] = options.date.split("-").map(Number);
+  }
+  const result = await moon({
+    year,
+    month,
+    day,
+    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(formatMoon(result));
+  }
+});
+program.command("ephemeris").description("Get ephemeris position for a celestial body").requiredOption("--body <body>", "Celestial body (sun, moon, mars, etc.)").option("--date <date>", "Date (YYYY-MM-DD, default: today)").option("--json", "Output raw JSON").action(async (options) => {
+  const spinner = ora(`Getting ${options.body} position...`).start();
+  let year, month, day;
+  if (options.date) {
+    [year, month, day] = options.date.split("-").map(Number);
+  }
+  const result = await ephemeris({
+    body: options.body,
+    year,
+    month,
+    day
+  });
+  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(formatEphemeris(result));
+  }
+});
+program.command("core-version").description("Show thoth-core version").action(async () => {
+  const result = await version();
+  if (isError(result)) {
+    console.error(chalk.red(`Error: ${result.error}`));
+    process.exit(1);
+  }
+  console.log(chalk.cyan(`thoth-core v${result.version}`));
+});
+program.command("key").description("Symbol reference guide").action(() => {
+  const sun = chalk.hex("#FFD700");
+  const moon2 = chalk.hex("#C0C0C0");
+  const mercury = chalk.hex("#FF8C00");
+  const venus = chalk.hex("#00FF7F");
+  const mars = chalk.hex("#FF0000");
+  const jupiter = chalk.hex("#4169E1");
+  const saturn = chalk.hex("#4B0082");
+  const uranus = chalk.hex("#00FFFF");
+  const neptune = chalk.hex("#20B2AA");
+  const pluto = chalk.hex("#8B0000");
+  const chiron = chalk.hex("#9932CC");
+  const lilith = chalk.hex("#800020");
+  const northNode = chalk.hex("#FFD700");
+  const southNode = chalk.hex("#C0C0C0");
+  console.log(chalk.bold.white("\n\u{1315D} THOTH KEY \u2014 Complete Reference\n"));
+  console.log(chalk.bold.cyan("\u2550\u2550 PLANETS \u2550\u2550"));
+  console.log(`   ${sun("\u2609 Sun")}       Identity, vitality, ego, life force`);
+  console.log(`               ${chalk.dim("Rules:")} ${sun("Leo")}  ${chalk.dim("Sephira:")} Tiphareth`);
+  console.log(`   ${moon2("\u263D Moon")}      Emotions, instincts, the unconscious, mother`);
+  console.log(`               ${chalk.dim("Rules:")} ${moon2("Cancer")}  ${chalk.dim("Sephira:")} Yesod`);
+  console.log(`   ${mercury("\u263F Mercury")}   Mind, communication, learning, commerce`);
+  console.log(`               ${chalk.dim("Rules:")} ${mercury("Gemini, Virgo")}  ${chalk.dim("Sephira:")} Hod`);
+  console.log(`   ${venus("\u2640 Venus")}     Love, beauty, values, attraction, harmony`);
+  console.log(`               ${chalk.dim("Rules:")} ${venus("Taurus, Libra")}  ${chalk.dim("Sephira:")} Netzach`);
+  console.log(`   ${mars("\u2642 Mars")}      Action, desire, aggression, courage, drive`);
+  console.log(`               ${chalk.dim("Rules:")} ${mars("Aries")}  ${chalk.dim("Sephira:")} Geburah`);
+  console.log(`   ${jupiter("\u2643 Jupiter")}   Expansion, luck, wisdom, abundance, faith`);
+  console.log(`               ${chalk.dim("Rules:")} ${jupiter("Sagittarius")}  ${chalk.dim("Sephira:")} Chesed`);
+  console.log(`   ${saturn("\u2644 Saturn")}    Structure, limits, time, karma, discipline`);
+  console.log(`               ${chalk.dim("Rules:")} ${saturn("Capricorn")}  ${chalk.dim("Sephira:")} Binah`);
+  console.log(`   ${uranus("\u2645 Uranus")}    Revolution, awakening, innovation, freedom`);
+  console.log(`               ${chalk.dim("Rules:")} ${uranus("Aquarius")}  ${chalk.dim("Sephira:")} Chokmah`);
+  console.log(`   ${neptune("\u2646 Neptune")}   Dreams, illusion, spirituality, dissolution`);
+  console.log(`               ${chalk.dim("Rules:")} ${neptune("Pisces")}`);
+  console.log(`   ${pluto("\u2647 Pluto")}     Transformation, death/rebirth, power, shadow`);
+  console.log(`               ${chalk.dim("Rules:")} ${pluto("Scorpio")}`);
+  console.log("");
+  console.log(chalk.bold.cyan("\u2550\u2550 POINTS \u2550\u2550"));
+  console.log(`   ${chiron("\u26B7 Chiron")}      The wounded healer. Core wound & gift of healing.`);
+  console.log(`   ${lilith("\u26B8 Lilith")}      Black Moon. Primal feminine, shadow, rejection.`);
+  console.log(`   ${northNode("\u260A North Node")}  Soul's direction. Growth edge. Future karma.`);
+  console.log(`   ${southNode("\u260B South Node")}  Past life gifts. Comfort zone. Past karma.`);
+  console.log("");
+  console.log(chalk.bold.cyan("\u2550\u2550 ZODIAC SIGNS \u2550\u2550"));
+  console.log(`   ${mars("\u2648 Aries")}        ${chalk.dim("Cardinal Fire")}   Initiative, courage, impatience`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${mars("Mars")}  ${chalk.dim('"I AM"')}`);
+  console.log(`   ${venus("\u2649 Taurus")}       ${chalk.dim("Fixed Earth")}     Stability, sensuality, stubborn`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${venus("Venus")}  ${chalk.dim('"I HAVE"')}`);
+  console.log(`   ${mercury("\u264A Gemini")}       ${chalk.dim("Mutable Air")}     Curiosity, duality, scattered`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${mercury("Mercury")}  ${chalk.dim('"I THINK"')}`);
+  console.log(`   ${moon2("\u264B Cancer")}       ${chalk.dim("Cardinal Water")}  Nurturing, protective, moody`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${moon2("Moon")}  ${chalk.dim('"I FEEL"')}`);
+  console.log(`   ${sun("\u264C Leo")}          ${chalk.dim("Fixed Fire")}      Creative, proud, dramatic`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${sun("Sun")}  ${chalk.dim('"I WILL"')}`);
+  console.log(`   ${mercury("\u264D Virgo")}        ${chalk.dim("Mutable Earth")}   Analytical, service, critical`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${mercury("Mercury")}  ${chalk.dim('"I ANALYZE"')}`);
+  console.log(`   ${venus("\u264E Libra")}        ${chalk.dim("Cardinal Air")}    Balance, partnership, indecisive`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${venus("Venus")}  ${chalk.dim('"I BALANCE"')}`);
+  console.log(`   ${pluto("\u264F Scorpio")}      ${chalk.dim("Fixed Water")}     Intensity, depth, secretive`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${pluto("Pluto")}  ${chalk.dim('"I DESIRE"')}`);
+  console.log(`   ${jupiter("\u2650 Sagittarius")}  ${chalk.dim("Mutable Fire")}    Adventure, truth, reckless`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${jupiter("Jupiter")}  ${chalk.dim('"I SEE"')}`);
+  console.log(`   ${saturn("\u2651 Capricorn")}    ${chalk.dim("Cardinal Earth")}  Ambition, mastery, cold`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${saturn("Saturn")}  ${chalk.dim('"I USE"')}`);
+  console.log(`   ${uranus("\u2652 Aquarius")}     ${chalk.dim("Fixed Air")}       Humanitarian, eccentric, detached`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${uranus("Uranus")}  ${chalk.dim('"I KNOW"')}`);
+  console.log(`   ${neptune("\u2653 Pisces")}       ${chalk.dim("Mutable Water")}   Compassion, dreams, escapist`);
+  console.log(`                    ${chalk.dim("Ruler:")} ${neptune("Neptune")}  ${chalk.dim('"I BELIEVE"')}`);
+  console.log("");
+  console.log(chalk.bold.cyan("\u2550\u2550 HOUSES \u2550\u2550"));
+  console.log(`   ${chalk.bold("1st House")}   ${mars("Ascendant")}   Self, identity, appearance, first impressions`);
+  console.log(`   ${chalk.bold("2nd House")}               Money, possessions, values, self-worth`);
+  console.log(`   ${chalk.bold("3rd House")}               Communication, siblings, short travel, learning`);
+  console.log(`   ${chalk.bold("4th House")}   ${saturn("IC")}          Home, family, roots, private self, mother`);
+  console.log(`   ${chalk.bold("5th House")}               Creativity, romance, children, pleasure, play`);
+  console.log(`   ${chalk.bold("6th House")}               Health, work, service, daily routines, pets`);
+  console.log(`   ${chalk.bold("7th House")}   ${chalk.white("Descendant")}  Partnerships, marriage, open enemies, others`);
+  console.log(`   ${chalk.bold("8th House")}               Death, sex, shared resources, transformation`);
+  console.log(`   ${chalk.bold("9th House")}               Philosophy, long travel, higher education, beliefs`);
+  console.log(`   ${chalk.bold("10th House")}  ${sun("MC")}          Career, reputation, public self, father`);
+  console.log(`   ${chalk.bold("11th House")}              Friends, groups, hopes, wishes, humanity`);
+  console.log(`   ${chalk.bold("12th House")}              Unconscious, isolation, secrets, karma, dreams`);
+  console.log("");
+  console.log(chalk.bold.cyan("\u2550\u2550 ASPECTS \u2550\u2550"));
+  console.log(`   ${sun("\u260C Conjunction")}    0\xB0   Fusion, intensification, new cycle`);
+  console.log(`                       ${chalk.dim("Sephira: Tiphareth (Sun) \u2014 creative union")}`);
+  console.log(`   ${moon2("\u260D Opposition")}   180\xB0   Awareness, tension, projection`);
+  console.log(`                       ${chalk.dim("Sephira: Yesod (Moon) \u2014 polarity, reflection")}`);
+  console.log(`   ${jupiter("\u25B3 Trine")}        120\xB0   Harmony, ease, natural talent`);
+  console.log(`                       ${chalk.dim("Sephira: Chesed (Jupiter) \u2014 grace, flow")}`);
+  console.log(`   ${mars("\u25A1 Square")}        90\xB0   Friction, challenge, forced growth`);
+  console.log(`                       ${chalk.dim("Sephira: Geburah (Mars) \u2014 strength through struggle")}`);
+  console.log(`   ${venus("\u26B9 Sextile")}       60\xB0   Opportunity, cooperation, ease`);
+  console.log(`                       ${chalk.dim("Sephira: Netzach (Venus) \u2014 gentle harmony")}`);
+  console.log(`   ${mercury("\u235F Quintile")}      72\xB0   Creativity, talent, genius`);
+  console.log(`                       ${chalk.dim("Sephira: Hod (Mercury) \u2014 mental brilliance")}`);
+  console.log(`   ${uranus("\u26BB Quincunx")}     150\xB0   Adjustment, awkwardness, recalibration`);
+  console.log("");
+  console.log(chalk.bold.cyan("\u2550\u2550 ELEMENTS \u2550\u2550"));
+  console.log(`   ${mars("\u{1F702} Fire")}     ${mars("Aries, Leo, Sagittarius")}`);
+  console.log(`             Spirit, will, action, enthusiasm`);
+  console.log(`             ${chalk.dim("Hot & Dry \u2014 Choleric \u2014 Intuitive function")}`);
+  console.log(`   ${venus("\u{1F703} Earth")}    ${venus("Taurus, Virgo, Capricorn")}`);
+  console.log(`             Matter, stability, practicality, form`);
+  console.log(`             ${chalk.dim("Cold & Dry \u2014 Melancholic \u2014 Sensation function")}`);
+  console.log(`   ${mercury("\u{1F701} Air")}      ${mercury("Gemini, Libra, Aquarius")}`);
+  console.log(`             Mind, communication, connection, ideas`);
+  console.log(`             ${chalk.dim("Hot & Wet \u2014 Sanguine \u2014 Thinking function")}`);
+  console.log(`   ${moon2("\u{1F704} Water")}    ${moon2("Cancer")}, ${pluto("Scorpio")}, ${neptune("Pisces")}`);
+  console.log(`             Emotion, intuition, the unconscious, soul`);
+  console.log(`             ${chalk.dim("Cold & Wet \u2014 Phlegmatic \u2014 Feeling function")}`);
+  console.log("");
+  console.log(chalk.bold.cyan("\u2550\u2550 MODALITIES \u2550\u2550"));
+  console.log(`   ${chalk.bold("Cardinal")}   ${mars("Aries")}, ${moon2("Cancer")}, ${venus("Libra")}, ${saturn("Capricorn")}`);
+  console.log(`             Initiating, leadership, action`);
+  console.log(`             ${chalk.dim('The spark. Begins seasons. "I start."')}`);
+  console.log(`   ${chalk.bold("Fixed")}      ${venus("Taurus")}, ${sun("Leo")}, ${pluto("Scorpio")}, ${uranus("Aquarius")}`);
+  console.log(`             Stabilizing, persistence, stubborn`);
+  console.log(`             ${chalk.dim('The sustainer. Mid-season. "I maintain."')}`);
+  console.log(`   ${chalk.bold("Mutable")}    ${mercury("Gemini")}, ${mercury("Virgo")}, ${jupiter("Sagittarius")}, ${neptune("Pisces")}`);
+  console.log(`             Adapting, flexible, changeable`);
+  console.log(`             ${chalk.dim('The dissolver. End of season. "I change."')}`);
+  console.log("");
+  console.log(chalk.bold.cyan("\u2550\u2550 OTHER \u2550\u2550"));
+  console.log(`   ${mars("\u211E")}  Retrograde    Planet appears to move backward. Internalized energy.`);
+  console.log(`   H  House         Area of life. e.g., 4H = home, roots, private self`);
+  console.log(`   \u2192  Flow          Direction. e.g., 2H\u21924H (transit house \u2192 natal house)`);
+  console.log("");
+  console.log(chalk.bold.cyan("\u2550\u2550 DIGNITIES \u2550\u2550"));
+  console.log(`   ${chalk.bold("Domicile")}    Planet in sign it rules. Full power. ${chalk.dim("e.g., Mars in Aries")}`);
+  console.log(`   ${chalk.bold("Exaltation")} Planet in sign of peak expression. ${chalk.dim("e.g., Sun in Aries")}`);
+  console.log(`   ${chalk.bold("Detriment")}  Planet opposite its home. Challenged. ${chalk.dim("e.g., Mars in Libra")}`);
+  console.log(`   ${chalk.bold("Fall")}       Planet opposite exaltation. Weakened. ${chalk.dim("e.g., Sun in Libra")}`);
+  console.log("");
+});
+console.log(chalk.dim(""));
+console.log(chalk.yellow("  \u{1315D}") + chalk.dim(" thoth-cli"));
+console.log(chalk.dim(""));
+program.parse();

package/dist/chunk-NYXKYHNK.js

@@ -0,0 +1,576 @@
+// 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: "python3",
+      args: ["-m", "thoth_core.cli"]
+    };
+  }
+  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));
+  }
+  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));
+  return execute("transit", 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 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");
+}
+
+// src/types.ts
+function isError(result) {
+  return "error" in result;
+}
+
+export {
+  chart,
+  transit,
+  moon,
+  ephemeris,
+  version,
+  getZodiacSymbol,
+  getPlanetSymbol,
+  getAspectSymbol,
+  formatDegrees,
+  formatChart,
+  formatTransits,
+  formatMoon,
+  formatEphemeris,
+  isError
+};

package/dist/index.d.ts

@@ -0,0 +1,191 @@
+/**
+ * Thoth CLI Types
+ * 𓅝
+ */
+interface Planet {
+    sign: string;
+    position: number;
+    abs_position: number;
+    house?: number | null;
+    retrograde: boolean;
+}
+interface House {
+    sign: string | null;
+    position: number | null;
+}
+interface ChartResult {
+    name: string;
+    datetime: {
+        year: number;
+        month: number;
+        day: number;
+        hour: number;
+        minute: number;
+    };
+    location: {
+        lat: number;
+        lng: number;
+    };
+    planets: Record<string, Planet>;
+    houses: Record<string, House>;
+    ascendant: {
+        sign: string | null;
+        position: number | null;
+    };
+    midheaven: {
+        sign: string | null;
+        position: number | null;
+    };
+}
+interface Aspect {
+    transit_planet: string;
+    natal_planet: string;
+    aspect: 'conjunction' | 'opposition' | 'trine' | 'square' | 'sextile';
+    orb: number;
+    transit_position: number;
+    natal_position: number;
+    applying: boolean;
+}
+interface TransitResult {
+    natal: {
+        datetime: string;
+    };
+    transit: {
+        datetime: string;
+    };
+    aspects: Aspect[];
+}
+interface MoonResult {
+    datetime: string;
+    moon: {
+        sign: string;
+        position: number;
+        abs_position: number;
+    };
+    phase: {
+        name: string;
+        angle: number;
+        illumination: number;
+    };
+}
+interface EphemerisResult {
+    body: string;
+    datetime: string;
+    sign: string;
+    position: number;
+    abs_position: number;
+    retrograde: boolean;
+}
+interface ChartOptions {
+    year: number;
+    month: number;
+    day: number;
+    hour?: number;
+    minute?: number;
+    lat?: number;
+    lng?: number;
+    city?: string;
+    nation?: string;
+    name?: string;
+}
+interface TransitOptions {
+    natalYear: number;
+    natalMonth: number;
+    natalDay: number;
+    natalHour?: number;
+    natalMinute?: number;
+    natalLat?: number;
+    natalLng?: number;
+    natalCity?: string;
+    nation?: string;
+    transitYear?: number;
+    transitMonth?: number;
+    transitDay?: number;
+    orb?: number;
+}
+interface MoonOptions {
+    year?: number;
+    month?: number;
+    day?: number;
+    lat?: number;
+    lng?: number;
+}
+interface EphemerisOptions {
+    body: string;
+    year?: number;
+    month?: number;
+    day?: number;
+}
+interface ThothError {
+    error: string;
+}
+type ThothResult<T> = T | ThothError;
+declare function isError<T extends object>(result: ThothResult<T>): result is ThothError;
+
+/**
+ * Core wrapper for thoth-core binary
+ * 𓅝
+ */
+
+/**
+ * Calculate a natal chart
+ */
+declare function chart(options: ChartOptions): Promise<ThothResult<ChartResult>>;
+/**
+ * Calculate transits to a natal chart
+ */
+declare function transit(options: TransitOptions): Promise<ThothResult<TransitResult>>;
+/**
+ * Get moon phase and position
+ */
+declare function moon(options?: MoonOptions): Promise<ThothResult<MoonResult>>;
+/**
+ * Get ephemeris position for a celestial body
+ */
+declare function ephemeris(options: EphemerisOptions): Promise<ThothResult<EphemerisResult>>;
+/**
+ * Get version
+ */
+declare function version(): Promise<ThothResult<{
+    version: string;
+}>>;
+
+/**
+ * Output formatting utilities
+ * 𓅝
+ */
+
+/**
+ * Get zodiac symbol
+ */
+declare function getZodiacSymbol(sign: string): string;
+/**
+ * Get planet symbol
+ */
+declare function getPlanetSymbol(planet: string): string;
+/**
+ * Get aspect symbol
+ */
+declare function getAspectSymbol(aspect: string): string;
+/**
+ * Format degrees to degrees, minutes, seconds
+ */
+declare function formatDegrees(degrees: number): string;
+/**
+ * Format a chart result
+ */
+declare function formatChart(result: ChartResult): string;
+/**
+ * Format transits result
+ */
+declare function formatTransits(result: TransitResult): string;
+/**
+ * Format moon result
+ */
+declare function formatMoon(result: MoonResult): string;
+/**
+ * Format ephemeris result
+ */
+declare function formatEphemeris(result: EphemerisResult): string;
+
+export { type Aspect, type ChartOptions, type ChartResult, type EphemerisOptions, type EphemerisResult, type House, type MoonOptions, type MoonResult, type Planet, type ThothError, type ThothResult, type TransitOptions, type TransitResult, chart, ephemeris, formatChart, formatDegrees, formatEphemeris, formatMoon, formatTransits, getAspectSymbol, getPlanetSymbol, getZodiacSymbol, isError, moon, transit, version };

package/dist/index.js

@@ -0,0 +1,32 @@
+import {
+  chart,
+  ephemeris,
+  formatChart,
+  formatDegrees,
+  formatEphemeris,
+  formatMoon,
+  formatTransits,
+  getAspectSymbol,
+  getPlanetSymbol,
+  getZodiacSymbol,
+  isError,
+  moon,
+  transit,
+  version
+} from "./chunk-NYXKYHNK.js";
+export {
+  chart,
+  ephemeris,
+  formatChart,
+  formatDegrees,
+  formatEphemeris,
+  formatMoon,
+  formatTransits,
+  getAspectSymbol,
+  getPlanetSymbol,
+  getZodiacSymbol,
+  isError,
+  moon,
+  transit,
+  version
+};

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "thoth-cli",
+  "version": "0.1.0",
+  "description": "𓅝 Astrological calculations from the command line. Swiss Ephemeris precision. Built for humans and agents.",
+  "author": "AKLO <aklo@aklolabs.com>",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "thoth": "./dist/bin.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/bin.ts --format esm --dts --clean",
+    "dev": "tsup src/index.ts src/bin.ts --format esm --dts --watch",
+    "postinstall": "node scripts/postinstall.js",
+    "test": "vitest"
+  },
+  "dependencies": {
+    "chalk": "^5.3.0",
+    "commander": "^12.0.0",
+    "ora": "^8.0.0",
+    "execa": "^8.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "astrology",
+    "cli",
+    "ephemeris",
+    "horoscope",
+    "natal-chart",
+    "thoth"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aklo/thoth-cli.git"
+  }
+}