thoth-cli 0.2.20 → 0.2.22

package/dist/bin.js

@@ -12,27 +12,37 @@ import {
   formatEphemerisRange,
   formatHorary,
   formatLunarReturn,
+  formatMoon,
   formatMoonExtended,
   formatProgressions,
   formatScore,
   formatSolarArc,
   formatSolarReturn,
   formatSynastry,
+  formatTarotCard,
+  formatTarotDeck,
+  formatTarotDraw,
+  formatTarotSpreads,
   formatTransitScan,
   formatTransits,
   horary,
   isError,
   lunarReturn,
+  moon,
   moonExtended,
   progressions,
   score,
   solarArc,
   solarReturn,
   synastry,
+  tarotCard,
+  tarotDeck,
+  tarotDraw,
+  tarotSpreads,
   transit,
   transitScan,
   version
-} from "./chunk-QND56LGZ.js";
+} from "./chunk-X7IGMJUH.js";
 
 // src/bin.ts
 import { Command } from "commander";
@@ -94,7 +104,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.20");
+  thoth key                                           # full symbol reference`).version("0.2.21");
 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"));
@@ -479,19 +489,40 @@ program.command("horary").description("Cast a horary chart for divination (like
     console.log(formatHorary(result));
   }
 });
-program.command("moon").description("Get moon phase, eclipses, 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) => {
+program.command("moon").description("Get 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("--tz <tz>", "Timezone (for --extended)", "America/New_York").option("-e, --extended", "Show eclipses, sunrise/sunset, upcoming phases").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 data...").start();
-  const result = await moonExtended({
+  if (options.extended) {
+    const spinner2 = ora("Getting moon details...").start();
+    const result2 = await moonExtended({
+      year,
+      month,
+      day,
+      lat: options.lat,
+      lng: options.lng,
+      tz: options.tz
+    });
+    spinner2.stop();
+    if (isError(result2)) {
+      console.error(chalk.red(`Error: ${result2.error}`));
+      process.exit(1);
+    }
+    if (options.json) {
+      console.log(JSON.stringify(result2, null, 2));
+    } else {
+      console.log(formatMoonExtended(result2));
+    }
+    return;
+  }
+  const spinner = ora("Getting moon phase...").start();
+  const result = await moon({
     year,
     month,
     day,
     lat: options.lat,
-    lng: options.lng,
-    tz: options.tz
+    lng: options.lng
   });
   spinner.stop();
   if (isError(result)) {
@@ -501,7 +532,7 @@ program.command("moon").description("Get moon phase, eclipses, sunrise/sunset").
   if (options.json) {
     console.log(JSON.stringify(result, null, 2));
   } else {
-    console.log(formatMoonExtended(result));
+    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) => {
@@ -537,7 +568,7 @@ program.command("core-version").description("Show thoth-core version").action(as
 });
 program.command("key").description("Symbol reference guide").action(() => {
   const sun = chalk.hex("#FFD700");
-  const moon = chalk.hex("#C0C0C0");
+  const moon2 = chalk.hex("#C0C0C0");
   const mercury = chalk.hex("#FF8C00");
   const venus = chalk.hex("#00FF7F");
   const mars = chalk.hex("#FF0000");
@@ -554,8 +585,8 @@ program.command("key").description("Symbol reference guide").action(() => {
   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(`   ${moon("\u263D Moon")}      Emotions, instincts, the unconscious, mother`);
-  console.log(`               ${chalk.dim("Rules:")} ${moon("Cancer")}  ${chalk.dim("Sephira:")} Yesod`);
+  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`);
@@ -586,8 +617,8 @@ program.command("key").description("Symbol reference guide").action(() => {
   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(`   ${moon("\u264B Cancer")}       ${chalk.dim("Cardinal Water")}  Nurturing, protective, moody`);
-  console.log(`                    ${chalk.dim("Ruler:")} ${moon("Moon")}  ${chalk.dim('"I FEEL"')}`);
+  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`);
@@ -622,7 +653,7 @@ program.command("key").description("Symbol reference guide").action(() => {
   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(`   ${moon("\u260D Opposition")}   180\xB0   Awareness, tension, projection`);
+  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")}`);
@@ -644,12 +675,12 @@ program.command("key").description("Symbol reference guide").action(() => {
   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(`   ${jupiter("\u{1F704} Water")}    ${moon("Cancer, Scorpio, Pisces")}`);
+  console.log(`   ${jupiter("\u{1F704} Water")}    ${moon2("Cancer, Scorpio, 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")}, ${moon("Cancer")}, ${venus("Libra")}, ${saturn("Capricorn")}`);
+  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")}`);
@@ -773,7 +804,62 @@ program.command("ephemeris-multi").description("Get ephemeris for multiple bodie
     console.log(formatEphemerisMulti(result));
   }
 });
+program.command("tarot").alias("draw").description("Draw tarot cards (cryptographic randomness)").option("-s, --spread <spread>", "Spread: single, 3-card, celtic, horseshoe, relationship, decision", "single").option("-q, --question <question>", "Question for the reading").option("-n, --count <count>", "Number of cards (for custom spread)", parseInt).option("--no-reversals", "Disable reversed cards").option("--json", "Output raw JSON").action(async (options) => {
+  const spinner = ora("Shuffling the deck...").start();
+  const result = await tarotDraw({
+    spread: options.spread,
+    question: options.question,
+    count: options.count,
+    reversals: options.reversals
+  });
+  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(formatTarotDraw(result));
+  }
+});
+program.command("tarot-card <card>").alias("card").description("Look up a tarot card by name or number").option("--json", "Output raw JSON").action(async (card, options) => {
+  const result = await tarotCard(card);
+  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(formatTarotCard(result));
+  }
+});
+program.command("tarot-deck").alias("deck").description("List tarot cards").option("-f, --filter <filter>", "Filter: major, minor, wands, cups, swords, pentacles").option("--json", "Output raw JSON").action(async (options) => {
+  const result = await tarotDeck(options.filter);
+  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(formatTarotDeck(result));
+  }
+});
+program.command("tarot-spreads").alias("spreads").description("List available tarot spreads").option("--json", "Output raw JSON").action(async (options) => {
+  const result = await tarotSpreads();
+  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(formatTarotSpreads(result));
+  }
+});
 console.log(chalk.dim(""));
-console.log(chalk.yellow("  \u{1315D}") + chalk.dim(" thoth-cli v0.2.20"));
+console.log(chalk.yellow("  \u{1315D}") + chalk.dim(" thoth-cli v0.2.22"));
 console.log(chalk.dim(""));
 program.parse();

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

@@ -514,6 +514,25 @@ async function ephemerisMulti(options) {
   if (options.lng !== void 0) args.push("--lng", String(options.lng));
   return execute("ephemeris-multi", args);
 }
+async function tarotDraw(options) {
+  const args = [];
+  if (options.count) args.push("--count", String(options.count));
+  if (options.spread) args.push("--spread", options.spread);
+  if (options.question) args.push("--question", options.question);
+  if (options.reversals === false) args.push("--no-reversals");
+  return execute("tarot-draw", args);
+}
+async function tarotCard(identifier) {
+  return execute("tarot-card", [identifier]);
+}
+async function tarotDeck(filter) {
+  const args = [];
+  if (filter) args.push("--filter", filter);
+  return execute("tarot-deck", args);
+}
+async function tarotSpreads() {
+  return execute("tarot-spreads", []);
+}
 
 // src/lib/format.ts
 import chalk from "chalk";
@@ -1434,6 +1453,159 @@ function formatEphemerisMulti(result) {
   lines.push("");
   return lines.join("\n");
 }
+var TAROT_COLORS = {
+  major: chalk.hex("#FFD700"),
+  // Gold for Major Arcana
+  wands: chalk.hex("#FF4500"),
+  // Fire - Orange Red
+  cups: chalk.hex("#4169E1"),
+  // Water - Royal Blue
+  swords: chalk.hex("#E0E0E0"),
+  // Air - Silver
+  pentacles: chalk.hex("#228B22")
+  // Earth - Forest Green
+};
+function getTarotColor(card) {
+  if (card.arcana === "major") return TAROT_COLORS.major;
+  return TAROT_COLORS[card.suit] || chalk.white;
+}
+function getSuitSymbol(suit) {
+  const symbols = {
+    wands: "\u{1F702}",
+    // Fire alchemical symbol
+    cups: "\u{1F704}",
+    // Water alchemical symbol
+    swords: "\u{1F701}",
+    // Air alchemical symbol
+    pentacles: "\u{1F703}"
+    // Earth alchemical symbol
+  };
+  return symbols[suit] || "";
+}
+function formatTarotDraw(result) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk.bold.hex("#9932CC")("\u{1F3B4} TAROT READING"));
+  lines.push(`   ${chalk.dim("Spread:")} ${result.spread_name}`);
+  if (result.question) {
+    lines.push(`   ${chalk.dim("Question:")} "${result.question}"`);
+  }
+  lines.push(`   ${chalk.dim("Entropy:")} ${result.entropy_source}`);
+  lines.push(`   ${chalk.dim("Time:")} ${result.timestamp}`);
+  lines.push("");
+  lines.push(chalk.bold.cyan("\u2500\u2500 THE CARDS \u2500\u2500"));
+  lines.push("");
+  for (const card of result.cards) {
+    const color = getTarotColor(card);
+    const reversed = card.reversed ? chalk.red(" \u211E REVERSED") : "";
+    const suitSymbol = card.suit ? ` ${getSuitSymbol(card.suit)}` : "";
+    lines.push(`   ${chalk.bold.white(`[${card.position}] ${card.position_name}`)}`);
+    lines.push(`   ${color(card.name)}${suitSymbol}${reversed}`);
+    if (card.arcana === "major") {
+      const details = [];
+      if (card.hebrew) details.push(card.hebrew);
+      if (card.planet) details.push(`\u2609 ${card.planet}`);
+      if (card.zodiac) details.push(`\u2648 ${card.zodiac}`);
+      if (card.element) details.push(`\u25B3 ${card.element}`);
+      if (details.length > 0) {
+        lines.push(`   ${chalk.dim(details.join(" | "))}`);
+      }
+    } else {
+      const details = [];
+      if (card.element) details.push(`${card.element}`);
+      if (card.sephira) details.push(card.sephira);
+      if (card.theme) details.push(card.theme);
+      if (details.length > 0) {
+        lines.push(`   ${chalk.dim(details.join(" | "))}`);
+      }
+    }
+    const keywords = card.reversed ? card.keywords_reversed : card.keywords_upright;
+    if (keywords && keywords.length > 0) {
+      const keywordStr = keywords.slice(0, 5).join(", ");
+      lines.push(`   ${chalk.italic(keywordStr)}`);
+    }
+    lines.push("");
+  }
+  lines.push(chalk.dim("\u2500".repeat(60)));
+  lines.push(chalk.dim("   The cards are cast. The interpretation is yours."));
+  lines.push("");
+  return lines.join("\n");
+}
+function formatTarotCard(card) {
+  const lines = [];
+  const color = getTarotColor(card);
+  lines.push("");
+  lines.push(color(`\u{1F3B4} ${card.name}`));
+  lines.push(`   ${chalk.dim("Number:")} ${card.number} | ${chalk.dim("Arcana:")} ${card.arcana}`);
+  if (card.arcana === "major") {
+    if (card.hebrew) lines.push(`   ${chalk.dim("Hebrew:")} ${card.hebrew} | ${chalk.dim("Path:")} ${card.path}`);
+    if (card.planet) lines.push(`   ${chalk.dim("Planet:")} ${card.planet}`);
+    if (card.zodiac) lines.push(`   ${chalk.dim("Zodiac:")} ${card.zodiac}`);
+    if (card.element) lines.push(`   ${chalk.dim("Element:")} ${card.element}`);
+  } else {
+    lines.push(`   ${chalk.dim("Suit:")} ${card.suit} (${card.element})`);
+    lines.push(`   ${chalk.dim("Rank:")} ${card.rank} | ${chalk.dim("Sephira:")} ${card.sephira}`);
+    lines.push(`   ${chalk.dim("Theme:")} ${card.theme}`);
+  }
+  lines.push("");
+  lines.push(chalk.bold.green("   Upright:"));
+  lines.push(`   ${card.keywords_upright.join(", ")}`);
+  lines.push("");
+  lines.push(chalk.bold.red("   Reversed:"));
+  lines.push(`   ${card.keywords_reversed.join(", ")}`);
+  lines.push("");
+  return lines.join("\n");
+}
+function formatTarotDeck(result) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk.bold.hex("#9932CC")(`\u{1F3B4} TAROT DECK (${result.count} cards)`));
+  if (result.filter) {
+    lines.push(`   Filter: ${result.filter}`);
+  }
+  lines.push("");
+  const majors = result.cards.filter((c) => c.arcana === "major");
+  const wands = result.cards.filter((c) => c.suit === "wands");
+  const cups = result.cards.filter((c) => c.suit === "cups");
+  const swords = result.cards.filter((c) => c.suit === "swords");
+  const pentacles = result.cards.filter((c) => c.suit === "pentacles");
+  if (majors.length > 0) {
+    lines.push(TAROT_COLORS.major("\u2500\u2500 MAJOR ARCANA \u2500\u2500"));
+    for (const card of majors) {
+      lines.push(`   ${String(card.number).padStart(2)}. ${card.name}`);
+    }
+    lines.push("");
+  }
+  const suits = [
+    { name: "WANDS", cards: wands, color: TAROT_COLORS.wands, symbol: "\u{1F702}" },
+    { name: "CUPS", cards: cups, color: TAROT_COLORS.cups, symbol: "\u{1F704}" },
+    { name: "SWORDS", cards: swords, color: TAROT_COLORS.swords, symbol: "\u{1F701}" },
+    { name: "PENTACLES", cards: pentacles, color: TAROT_COLORS.pentacles, symbol: "\u{1F703}" }
+  ];
+  for (const suit of suits) {
+    if (suit.cards.length > 0) {
+      lines.push(suit.color(`\u2500\u2500 ${suit.symbol} ${suit.name} \u2500\u2500`));
+      for (const card of suit.cards) {
+        lines.push(`   ${String(card.number).padStart(2)}. ${card.name}`);
+      }
+      lines.push("");
+    }
+  }
+  return lines.join("\n");
+}
+function formatTarotSpreads(result) {
+  const lines = [];
+  lines.push("");
+  lines.push(chalk.bold.hex("#9932CC")("\u{1F3B4} AVAILABLE SPREADS"));
+  lines.push("");
+  for (const spread of result.spreads) {
+    lines.push(chalk.bold(`   ${spread.name} (${spread.id})`));
+    lines.push(`   ${chalk.dim(spread.description)}`);
+    lines.push(`   Cards: ${spread.count} \u2014 ${spread.positions.join(" \u2192 ")}`);
+    lines.push("");
+  }
+  return lines.join("\n");
+}
 
 // src/types.ts
 function isError(result) {
@@ -1458,6 +1630,10 @@ export {
   moonExtended,
   transitScan,
   ephemerisMulti,
+  tarotDraw,
+  tarotCard,
+  tarotDeck,
+  tarotSpreads,
   getZodiacSymbol,
   getPlanetSymbol,
   getAspectSymbol,
@@ -1478,5 +1654,9 @@ export {
   formatMoonExtended,
   formatTransitScan,
   formatEphemerisMulti,
+  formatTarotDraw,
+  formatTarotCard,
+  formatTarotDeck,
+  formatTarotSpreads,
   isError
 };

package/dist/index.d.ts

@@ -498,6 +498,59 @@ interface ThothError {
 }
 type ThothResult<T> = T | ThothError;
 declare function isError<T extends object>(result: ThothResult<T>): result is ThothError;
+interface TarotCard {
+    number: number;
+    name: string;
+    arcana: 'major' | 'minor';
+    suit?: string;
+    rank?: string;
+    hebrew?: string;
+    path?: number;
+    element?: string;
+    planet?: string;
+    zodiac?: string;
+    domain?: string;
+    sephira?: string;
+    theme?: string;
+    keywords_upright: string[];
+    keywords_reversed: string[];
+    reversed?: boolean;
+    position?: number;
+    position_name?: string;
+}
+interface TarotDrawResult {
+    type: string;
+    timestamp: string;
+    entropy_source: string;
+    question?: string;
+    spread: string;
+    spread_name: string;
+    cards: TarotCard[];
+    total_cards: number;
+}
+interface TarotDrawOptions {
+    count?: number;
+    spread?: string;
+    question?: string;
+    reversals?: boolean;
+}
+interface TarotDeckResult {
+    type: string;
+    filter?: string;
+    count: number;
+    cards: TarotCard[];
+}
+interface TarotSpread {
+    id: string;
+    name: string;
+    count: number;
+    positions: string[];
+    description: string;
+}
+interface TarotSpreadsResult {
+    type: string;
+    spreads: TarotSpread[];
+}
 interface ScoreOptions {
     year1: number;
     month1: number;
@@ -747,6 +800,22 @@ declare function transitScan(options: TransitScanOptions): Promise<ThothResult<T
  * Get multi-body ephemeris over a date range
  */
 declare function ephemerisMulti(options: EphemerisMultiOptions): Promise<ThothResult<EphemerisMultiResult>>;
+/**
+ * Draw tarot cards with cryptographic randomness
+ */
+declare function tarotDraw(options: TarotDrawOptions): Promise<ThothResult<TarotDrawResult>>;
+/**
+ * Look up a specific tarot card
+ */
+declare function tarotCard(identifier: string): Promise<ThothResult<TarotCard>>;
+/**
+ * Get tarot deck (optionally filtered)
+ */
+declare function tarotDeck(filter?: string): Promise<ThothResult<TarotDeckResult>>;
+/**
+ * List available tarot spreads
+ */
+declare function tarotSpreads(): Promise<ThothResult<TarotSpreadsResult>>;
 
 /**
  * Output formatting utilities
@@ -833,5 +902,21 @@ declare function formatTransitScan(result: any): string;
  * Format multi-body ephemeris
  */
 declare function formatEphemerisMulti(result: any): string;
+/**
+ * Format a tarot draw result
+ */
+declare function formatTarotDraw(result: any): string;
+/**
+ * Format a single tarot card lookup
+ */
+declare function formatTarotCard(card: any): string;
+/**
+ * Format tarot deck listing
+ */
+declare function formatTarotDeck(result: any): string;
+/**
+ * Format available spreads
+ */
+declare function formatTarotSpreads(result: any): string;
 
-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 };
+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 TarotCard, type TarotDeckResult, type TarotDrawOptions, type TarotDrawResult, type TarotSpread, type TarotSpreadsResult, 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, formatTarotCard, formatTarotDeck, formatTarotDraw, formatTarotSpreads, formatTransitScan, formatTransits, getAspectSymbol, getPlanetSymbol, getZodiacSymbol, horary, isError, lunarReturn, moon, moonExtended, progressions, score, solarArc, solarReturn, synastry, tarotCard, tarotDeck, tarotDraw, tarotSpreads, transit, transitScan, version };

package/dist/index.js

@@ -19,6 +19,10 @@ import {
   formatSolarArc,
   formatSolarReturn,
   formatSynastry,
+  formatTarotCard,
+  formatTarotDeck,
+  formatTarotDraw,
+  formatTarotSpreads,
   formatTransitScan,
   formatTransits,
   getAspectSymbol,
@@ -34,10 +38,14 @@ import {
   solarArc,
   solarReturn,
   synastry,
+  tarotCard,
+  tarotDeck,
+  tarotDraw,
+  tarotSpreads,
   transit,
   transitScan,
   version
-} from "./chunk-QND56LGZ.js";
+} from "./chunk-X7IGMJUH.js";
 export {
   chart,
   composite,
@@ -59,6 +67,10 @@ export {
   formatSolarArc,
   formatSolarReturn,
   formatSynastry,
+  formatTarotCard,
+  formatTarotDeck,
+  formatTarotDraw,
+  formatTarotSpreads,
   formatTransitScan,
   formatTransits,
   getAspectSymbol,
@@ -74,6 +86,10 @@ export {
   solarArc,
   solarReturn,
   synastry,
+  tarotCard,
+  tarotDeck,
+  tarotDraw,
+  tarotSpreads,
   transit,
   transitScan,
   version

package/package.json

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