ether-to-astro 1.3.0 → 1.4.0

package/dist/astro-service.js

@@ -4,6 +4,7 @@ import { ElectionalService } from './astro-service/electional-service.js';
 import { NatalService } from './astro-service/natal-service.js';
 import { RisingSignService } from './astro-service/rising-sign-service.js';
 import { resolveReportingTimezone } from './astro-service/shared.js';
+import { SignBoundaryService } from './astro-service/sign-boundary-service.js';
 import { SkyService } from './astro-service/sky-service.js';
 import { TransitService } from './astro-service/transit-service.js';
 import { ChartRenderer } from './charts.js';
@@ -12,7 +13,9 @@ import { EphemerisCalculator } from './ephemeris.js';
 import { formatInTimezone } from './formatter.js';
 import { HouseCalculator } from './houses.js';
 import { RiseSetCalculator } from './riseset.js';
+import { isValidTimezone } from './time-utils.js';
 import { TransitCalculator } from './transits.js';
+const VALID_RUNTIME_HOUSE_STYLES = new Set(['P', 'W', 'K', 'E']);
 export { parseDateOnlyInput } from './astro-service/date-input.js';
 /**
  * Shared service facade used by both the MCP server and the CLI.
@@ -29,9 +32,11 @@ export class AstroService {
     eclipseCalc;
     chartRenderer;
     mcpStartupDefaults;
+    runtimePreferences = {};
     transitService;
     electionalService;
     risingSignService;
+    signBoundaryService;
     natalService;
     skyService;
     chartOutputService;
@@ -63,6 +68,10 @@ export class AstroService {
             ephem: this.ephem,
             houseCalc: this.houseCalc,
         });
+        this.signBoundaryService = new SignBoundaryService({
+            ephem: this.ephem,
+            now: this.now,
+        });
         this.natalService = new NatalService({
             ephem: this.ephem,
             houseCalc: this.houseCalc,
@@ -73,7 +82,6 @@ export class AstroService {
             ephem: this.ephem,
             riseSetCalc: this.riseSetCalc,
             eclipseCalc: this.eclipseCalc,
-            mcpStartupDefaults: this.mcpStartupDefaults,
             now: this.now,
             formatTimestamp: this.formatTimestamp.bind(this),
         });
@@ -99,7 +107,18 @@ export class AstroService {
      * timezone, and finally UTC.
      */
     resolveReportingTimezone(explicitTimezone, natalTimezone) {
-        return resolveReportingTimezone(this.mcpStartupDefaults, explicitTimezone, natalTimezone);
+        return (explicitTimezone ??
+            this.runtimePreferences.preferredTimezone ??
+            resolveReportingTimezone(this.mcpStartupDefaults, undefined, natalTimezone));
+    }
+    applyRuntimeHouseStyle(natalChart) {
+        if (this.runtimePreferences.preferredHouseStyle === undefined) {
+            return natalChart;
+        }
+        return {
+            ...natalChart,
+            requestedHouseSystem: this.runtimePreferences.preferredHouseStyle,
+        };
     }
     /**
      * Initialize the underlying ephemeris engine.
@@ -131,7 +150,10 @@ export class AstroService {
      * may use a different reporting timezone for labels when startup defaults are set.
      */
     getTransits(natalChart, input = {}) {
-        return this.transitService.getTransits(natalChart, input);
+        const effectiveInput = input.timezone === undefined && this.runtimePreferences.preferredTimezone !== undefined
+            ? { ...input, timezone: this.runtimePreferences.preferredTimezone }
+            : input;
+        return this.transitService.getTransits(this.applyRuntimeHouseStyle(natalChart), effectiveInput);
     }
     /**
      * Produce deterministic electional context for a single local instant.
@@ -151,7 +173,7 @@ export class AstroService {
      * chart preference, then startup defaults.
      */
     getHouses(natalChart, input = {}) {
-        return this.natalService.getHouses(natalChart, input);
+        return this.natalService.getHouses(this.applyRuntimeHouseStyle(natalChart), input);
     }
     /**
      * Find rising-sign windows across a calendar day at a specific location.
@@ -163,11 +185,21 @@ export class AstroService {
     getRisingSignWindows(input) {
         return this.risingSignService.getRisingSignWindows(input);
     }
+    /**
+     * Return exact sign-boundary events across a local calendar window.
+     */
+    getSignBoundaryEvents(input = {}) {
+        const timezone = this.resolveReportingTimezone(input.timezone);
+        return this.signBoundaryService.getSignBoundaryEvents({
+            ...input,
+            timezone,
+        });
+    }
     /**
      * Return the currently retrograde planets for the requested reporting timezone.
      */
     getRetrogradePlanets(timezone) {
-        return this.skyService.getRetrogradePlanets(timezone);
+        return this.skyService.getRetrogradePlanets(this.resolveReportingTimezone(timezone));
     }
     /**
      * Return the next rise and set events after the local day anchor for the chart location.
@@ -176,26 +208,64 @@ export class AstroService {
      * The lookup anchor remains local midnight in the natal chart timezone even
      * when reporting text uses a preferred reporting timezone.
      */
-    async getRiseSetTimes(natalChart) {
-        return this.skyService.getRiseSetTimes(natalChart);
+    async getRiseSetTimes(natalChart, timezone) {
+        return this.skyService.getRiseSetTimes(natalChart, this.resolveReportingTimezone(timezone, natalChart.location.timezone));
     }
     /**
      * Return current asteroid and node positions for the requested reporting timezone.
      */
     getAsteroidPositions(timezone) {
-        return this.skyService.getAsteroidPositions(timezone);
+        return this.skyService.getAsteroidPositions(this.resolveReportingTimezone(timezone));
     }
     /**
      * Look up the next solar and lunar eclipses after the current instant.
      */
     getNextEclipses(timezone) {
-        return this.skyService.getNextEclipses(timezone);
+        return this.skyService.getNextEclipses(this.resolveReportingTimezone(timezone));
     }
     /**
      * Summarize process-local server state and configured startup defaults.
      */
     getServerStatus(natalChart) {
-        return this.natalService.getServerStatus(natalChart);
+        return this.natalService.getServerStatus(natalChart, this.runtimePreferences);
+    }
+    /**
+     * Update process-local MCP runtime preferences.
+     */
+    setPreferences(input) {
+        if (input.preferred_timezone !== undefined) {
+            if (input.preferred_timezone === null) {
+                delete this.runtimePreferences.preferredTimezone;
+            }
+            else {
+                if (!isValidTimezone(input.preferred_timezone)) {
+                    throw new Error(`Invalid timezone: ${input.preferred_timezone}`);
+                }
+                this.runtimePreferences.preferredTimezone = input.preferred_timezone;
+            }
+        }
+        if (input.preferred_house_style !== undefined) {
+            if (input.preferred_house_style === null) {
+                delete this.runtimePreferences.preferredHouseStyle;
+            }
+            else {
+                if (!VALID_RUNTIME_HOUSE_STYLES.has(input.preferred_house_style)) {
+                    throw new Error(`Invalid preferred house style: ${input.preferred_house_style} (must be one of P, W, K, E)`);
+                }
+                this.runtimePreferences.preferredHouseStyle = input.preferred_house_style;
+            }
+        }
+        const preferredTimezone = this.runtimePreferences.preferredTimezone ?? null;
+        const preferredHouseStyle = this.runtimePreferences.preferredHouseStyle ?? null;
+        return {
+            data: {
+                runtimePreferences: {
+                    preferredTimezone,
+                    preferredHouseStyle,
+                },
+            },
+            text: `Runtime preferences updated. Reporting timezone: ${preferredTimezone ?? 'default'}. House style: ${preferredHouseStyle ?? 'default'}.`,
+        };
     }
     /**
      * Generate a natal chart image or SVG for the current chart.

package/dist/cli.js

@@ -308,6 +308,29 @@ export async function runCli(argv, io = {
         const result = await spec.execute({ service, natalChart: null }, { timezone });
         emitExecution(io, result, options.pretty ?? false);
     });
+    program
+        .command('get-sign-boundary-events')
+        .description(mustTool('get_sign_boundary_events').description)
+        .option('--date <yyyy-mm-dd>', toolSchemaProperty('get_sign_boundary_events', 'date').description ?? 'Start local date')
+        .option('--days-ahead <number>', toolSchemaProperty('get_sign_boundary_events', 'days_ahead').description ?? 'Days ahead')
+        .option('--timezone <tz>', toolSchemaProperty('get_sign_boundary_events', 'timezone').description ?? 'Timezone')
+        .option('--bodies <list>', 'Comma-separated list of bodies to scan (Sun,Moon,Mercury,Venus,Mars,Jupiter,Saturn,Uranus,Neptune,Pluto)')
+        .option('--pretty', 'Human-readable output instead of JSON')
+        .action(async (options) => {
+        const spec = mustTool('get_sign_boundary_events');
+        const timezone = await resolveCommandTimezone(options);
+        const bodies = options.bodies
+            ?.split(',')
+            .map((value) => value.trim())
+            .filter(Boolean);
+        const result = await spec.execute({ service, natalChart: null }, {
+            date: options.date,
+            timezone,
+            days_ahead: options.daysAhead == null ? undefined : toNumber(options.daysAhead, 'days-ahead'),
+            bodies,
+        });
+        emitExecution(io, result, options.pretty ?? false);
+    });
     program
         .command('get-electional-context')
         .description(mustTool('get_electional_context').description)

package/dist/entrypoint.d.ts

@@ -11,3 +11,4 @@ export interface EntrypointResolution {
     mcpStartupDefaults: Readonly<McpStartupDefaults>;
 }
 export declare function resolveEntrypoint(argv: string[], invokedPath?: string): EntrypointResolution;
+export declare function isDirectExecution(importMetaUrl: string, invokedPath?: string): boolean;

package/dist/entrypoint.js

@@ -1,4 +1,6 @@
+import { realpathSync } from 'node:fs';
 import path from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { isValidTimezone } from './time-utils.js';
 const VALID_HOUSE_STYLES = new Set(['P', 'W', 'K', 'E']);
 function readOptionValue(argv, index, flag) {
@@ -76,3 +78,14 @@ export function resolveEntrypoint(argv, invokedPath = process.argv[1] ?? '') {
         mcpStartupDefaults: Object.freeze({ ...defaults }),
     };
 }
+export function isDirectExecution(importMetaUrl, invokedPath = process.argv[1] ?? '') {
+    if (!invokedPath) {
+        return false;
+    }
+    try {
+        return realpathSync(fileURLToPath(importMetaUrl)) === realpathSync(invokedPath);
+    }
+    catch {
+        return false;
+    }
+}

package/dist/loader.js

@@ -3,7 +3,7 @@ import { readFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 // Set up browser globals for astrochart library BEFORE any imports
 import { JSDOM } from 'jsdom';
-import { resolveEntrypoint } from './entrypoint.js';
+import { isDirectExecution, resolveEntrypoint } from './entrypoint.js';
 function initializeRuntime() {
     const dom = new JSDOM('<!DOCTYPE html><html><body></body></html>');
     globalThis.window = dom.window;
@@ -61,7 +61,7 @@ export async function runEntrypoint(argv = process.argv.slice(2), invokedPath =
     const code = await runCli(resolved.cliArgv);
     process.exit(code);
 }
-if (import.meta.url === `file://${process.argv[1]}`) {
+if (isDirectExecution(import.meta.url)) {
     runEntrypoint().catch((error) => {
         console.error('[ERROR] Failed to start program:', error);
         process.exit(1);

package/dist/mcp-alias.js

@@ -1,6 +1,7 @@
 #!/usr/bin/env node
+import { isDirectExecution } from './entrypoint.js';
 import { runEntrypoint } from './loader.js';
-if (import.meta.url === `file://${process.argv[1]}`) {
+if (isDirectExecution(import.meta.url)) {
     runEntrypoint(['--mcp', ...process.argv.slice(2)], process.argv[1]).catch((error) => {
         console.error('[ERROR] Failed to start program:', error);
         process.exit(1);

package/dist/tool-registry.d.ts

@@ -1,5 +1,5 @@
 import type { AstroService } from './astro-service.js';
-import type { NatalChart } from './types.js';
+import { type NatalChart } from './types.js';
 type ToolContent = {
     type: 'text';
     text: string;

package/dist/tool-registry.js

@@ -1,4 +1,30 @@
+import { SIGN_BOUNDARY_BODIES, } from './types.js';
 export const MCP_TOOL_SPECS = [
+    {
+        name: 'set_preferences',
+        description: 'Update process-local MCP runtime preferences. Use this to change session reporting defaults such as timezone and house style without restarting the server.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                preferred_timezone: {
+                    anyOf: [{ type: 'string' }, { type: 'null' }],
+                    description: 'Optional reporting timezone override for this MCP session. Use null to clear the override.',
+                },
+                preferred_house_style: {
+                    anyOf: [{ type: 'string', enum: ['P', 'W', 'K', 'E'] }, { type: 'null' }],
+                    description: 'Optional preferred house style override for this MCP session. Use null to clear the override.',
+                },
+            },
+        },
+        requiresNatalChart: false,
+        execute: (ctx, args) => {
+            const result = ctx.service.setPreferences({
+                preferred_timezone: args.preferred_timezone,
+                preferred_house_style: args.preferred_house_style,
+            });
+            return { kind: 'state', data: result.data, text: result.text };
+        },
+    },
     {
         name: 'set_natal_chart',
         description: 'Store natal chart data for transit calculations. Birth time should be LOCAL time at the birth location (not UTC). The server converts to UTC using the timezone parameter. Optional birth_time_disambiguation handles DST overlap/gap edge cases (default: reject).',
@@ -98,6 +124,46 @@ export const MCP_TOOL_SPECS = [
             return { kind: 'state', data: result.data, text: result.text };
         },
     },
+    {
+        name: 'get_sign_boundary_events',
+        description: 'Return exact sign-boundary events for one or more planets across a local date window. Each event includes both from_sign and to_sign so ingress and egress are represented as one crossing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                date: {
+                    type: 'string',
+                    description: 'Start local date (YYYY-MM-DD). Defaults to today in the resolved timezone.',
+                },
+                timezone: {
+                    type: 'string',
+                    description: 'Optional timezone used for local-day interpretation and reporting. Falls back to the current MCP session timezone.',
+                },
+                days_ahead: {
+                    type: 'number',
+                    description: 'Number of days to look ahead from the start date. Defaults to 0 for a single-day window.',
+                    default: 0,
+                },
+                bodies: {
+                    type: 'array',
+                    items: {
+                        type: 'string',
+                        enum: [...SIGN_BOUNDARY_BODIES],
+                    },
+                    description: 'Optional list of supported bodies to scan. Defaults to all supported sign-boundary bodies.',
+                },
+            },
+        },
+        requiresNatalChart: false,
+        execute: (ctx, args) => {
+            const result = ctx.service.getSignBoundaryEvents({
+                date: args.date,
+                timezone: args.timezone,
+                days_ahead: args.days_ahead,
+                bodies: args.bodies,
+            });
+            return { kind: 'state', data: result.data, text: result.text };
+        },
+    },
     {
         name: 'get_electional_context',
         description: 'Get stateless electional context for a specific local date, time, and location. Returns deterministic timing facts such as ascendant, sect/day-night classification, Moon phase, applying aspects, and optional ascendant-ruler basics. This tool does not require a natal chart and is separate from get_transits.',
@@ -168,6 +234,10 @@ export const MCP_TOOL_SPECS = [
                     type: 'string',
                     description: 'Date for transits (ISO format YYYY-MM-DD). Defaults to today.',
                 },
+                timezone: {
+                    type: 'string',
+                    description: 'Optional reporting timezone override. Calculation day interpretation still uses the natal chart timezone.',
+                },
                 categories: {
                     type: 'array',
                     items: { type: 'string', enum: ['moon', 'personal', 'outer', 'all'] },
@@ -175,7 +245,7 @@ export const MCP_TOOL_SPECS = [
                 },
                 include_mundane: {
                     type: 'boolean',
-                    description: 'Include deterministic mundane baseline data for the requested window. Output includes planetary positions, transit-to-transit mundane aspects, and non-narrative weather grouping metadata; forecast windows also include per-day mundane.days entries. Defaults to false.',
+                    description: 'Include deterministic mundane baseline data for the requested window. Output includes planetary positions using the same sign-boundary normalization as serialized transits, transit-to-transit mundane aspects, and non-narrative weather grouping metadata; forecast windows also include per-day mundane.days entries. Defaults to false.',
                 },
                 days_ahead: {
                     type: 'number',
@@ -206,6 +276,7 @@ export const MCP_TOOL_SPECS = [
         execute: (ctx, args) => {
             const result = ctx.service.getTransits(ctx.natalChart, {
                 date: args.date,
+                timezone: args.timezone,
                 categories: args.categories,
                 include_mundane: args.include_mundane,
                 days_ahead: args.days_ahead,
@@ -242,7 +313,15 @@ export const MCP_TOOL_SPECS = [
     {
         name: 'get_retrograde_planets',
         description: 'Show which planets are currently retrograde',
-        inputSchema: { type: 'object', properties: {} },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timezone: {
+                    type: 'string',
+                    description: 'Optional reporting timezone override',
+                },
+            },
+        },
         requiresNatalChart: false,
         execute: (ctx, args) => {
             const timezone = ctx.service.resolveReportingTimezone(args.timezone, ctx.natalChart?.location?.timezone);
@@ -253,17 +332,33 @@ export const MCP_TOOL_SPECS = [
     {
         name: 'get_rise_set_times',
         description: 'Get sunrise, sunset, moonrise, moonset times for today',
-        inputSchema: { type: 'object', properties: {} },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timezone: {
+                    type: 'string',
+                    description: 'Optional reporting timezone override. Rise/set anchoring still uses the natal chart timezone.',
+                },
+            },
+        },
         requiresNatalChart: true,
-        execute: async (ctx) => {
-            const result = await ctx.service.getRiseSetTimes(ctx.natalChart);
+        execute: async (ctx, args) => {
+            const result = await ctx.service.getRiseSetTimes(ctx.natalChart, args.timezone);
             return { kind: 'state', data: result.data, text: result.text };
         },
     },
     {
         name: 'get_asteroid_positions',
         description: 'Get positions of major asteroids (Chiron, Ceres, Pallas, Juno, Vesta) and Nodes',
-        inputSchema: { type: 'object', properties: {} },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timezone: {
+                    type: 'string',
+                    description: 'Optional reporting timezone override',
+                },
+            },
+        },
         requiresNatalChart: false,
         execute: (ctx, args) => {
             const timezone = ctx.service.resolveReportingTimezone(args.timezone, ctx.natalChart?.location?.timezone);
@@ -274,7 +369,15 @@ export const MCP_TOOL_SPECS = [
     {
         name: 'get_next_eclipses',
         description: 'Find the next solar and lunar eclipses',
-        inputSchema: { type: 'object', properties: {} },
+        inputSchema: {
+            type: 'object',
+            properties: {
+                timezone: {
+                    type: 'string',
+                    description: 'Optional reporting timezone override',
+                },
+            },
+        },
         requiresNatalChart: false,
         execute: (ctx, args) => {
             const timezone = ctx.service.resolveReportingTimezone(args.timezone, ctx.natalChart?.location?.timezone);
@@ -284,7 +387,7 @@ export const MCP_TOOL_SPECS = [
     },
     {
         name: 'get_server_status',
-        description: 'Inspect the current server state: whether a natal chart is loaded, its name and timezone, and the server version. Call this before making assumptions about loaded context.',
+        description: 'Inspect the current server state: whether a natal chart is loaded, its name and timezone, the effective reporting timezone and house-style context, and the server version. Call this before making assumptions about loaded context.',
         inputSchema: { type: 'object', properties: {} },
         requiresNatalChart: false,
         execute: (ctx) => {

package/dist/tool-result.js

@@ -124,7 +124,8 @@ export function mapToolErrorMessageToCode(errorMessage) {
         errorMessage.includes('missing julianDay') ||
         errorMessage.includes('Invalid mode') ||
         errorMessage.includes('Invalid latitude') ||
-        errorMessage.includes('Invalid longitude')) {
+        errorMessage.includes('Invalid longitude') ||
+        errorMessage.includes('Invalid preferred house style')) {
         return 'INVALID_INPUT';
     }
     if (errorMessage.includes('Invalid timezone') || errorMessage.includes('timezone')) {

package/dist/types.d.ts

@@ -1,7 +1,13 @@
 export type HouseSystem = 'P' | 'K' | 'W' | 'E' | 'O' | 'R' | 'C' | 'A' | 'V' | 'X' | 'H' | 'T' | 'B';
 export type SolarEclipseType = 'partial' | 'annular' | 'total' | 'annular-total';
 export type LunarEclipseType = 'penumbral' | 'partial' | 'total';
-export type PlanetName = 'Sun' | 'Moon' | 'Mercury' | 'Venus' | 'Mars' | 'Jupiter' | 'Saturn' | 'Uranus' | 'Neptune' | 'Pluto' | 'Chiron' | 'North Node (Mean)' | 'North Node (True)' | 'Ceres' | 'Pallas' | 'Juno' | 'Vesta';
+export declare const CLASSICAL_PLANET_NAMES: readonly ["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn"];
+export declare const MAJOR_PLANET_NAMES: readonly ["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto"];
+export declare const SUPPLEMENTAL_PLANET_NAMES: readonly ["Chiron", "North Node (Mean)", "North Node (True)", "Ceres", "Pallas", "Juno", "Vesta"];
+export declare const ALL_PLANET_NAMES: readonly ["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "Chiron", "North Node (Mean)", "North Node (True)", "Ceres", "Pallas", "Juno", "Vesta"];
+export type PlanetName = (typeof ALL_PLANET_NAMES)[number];
+export declare const SIGN_BOUNDARY_BODIES: readonly ["Sun", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto"];
+export type SignBoundaryBody = (typeof SIGN_BOUNDARY_BODIES)[number];
 /**
  * Represents a complete natal birth chart with all necessary data for calculations
  *
@@ -124,6 +130,22 @@ export interface PlanetPosition {
      */
     isRetrograde: boolean;
 }
+export interface SignBoundaryEvent {
+    body: SignBoundaryBody;
+    from_sign: string;
+    to_sign: string;
+    exact_time: string;
+    longitude: number;
+    direction: 'direct' | 'retrograde';
+}
+export interface SignBoundaryEventResponse {
+    date: string;
+    timezone: string;
+    calculation_timezone: string;
+    reporting_timezone: string;
+    days_ahead: number;
+    events: SignBoundaryEvent[];
+}
 /**
  * Base interface for all transit data
  *
@@ -370,6 +392,7 @@ export type PlanetId = (typeof PLANETS)[keyof typeof PLANETS];
 export declare const PLANET_NAMES: {
     [key: number]: PlanetName;
 };
+export declare const PLANET_IDS_BY_NAME: Record<PlanetName, PlanetId>;
 /**
  * Personal planets (inner planets)
  *
@@ -400,7 +423,7 @@ export declare const OUTER_PLANETS: (8 | 6 | 5 | 7 | 9)[];
  * - Juno: Partnership, commitment
  * - Vesta: Devotion, service
  */
-export declare const ASTEROIDS: (18 | 15 | 17 | 19 | 20)[];
+export declare const ASTEROIDS: (18 | 17 | 15 | 19 | 20)[];
 /**
  * Lunar nodes
  *

package/dist/types.js

@@ -1,3 +1,29 @@
+export const CLASSICAL_PLANET_NAMES = [
+    'Sun',
+    'Moon',
+    'Mercury',
+    'Venus',
+    'Mars',
+    'Jupiter',
+    'Saturn',
+];
+export const MAJOR_PLANET_NAMES = [
+    ...CLASSICAL_PLANET_NAMES,
+    'Uranus',
+    'Neptune',
+    'Pluto',
+];
+export const SUPPLEMENTAL_PLANET_NAMES = [
+    'Chiron',
+    'North Node (Mean)',
+    'North Node (True)',
+    'Ceres',
+    'Pallas',
+    'Juno',
+    'Vesta',
+];
+export const ALL_PLANET_NAMES = [...MAJOR_PLANET_NAMES, ...SUPPLEMENTAL_PLANET_NAMES];
+export const SIGN_BOUNDARY_BODIES = MAJOR_PLANET_NAMES;
 /**
  * Aspect definitions with angles and default orbs
  *
@@ -81,6 +107,25 @@ export const PLANET_NAMES = {
     19: 'Juno',
     20: 'Vesta',
 };
+export const PLANET_IDS_BY_NAME = {
+    Sun: PLANETS.SUN,
+    Moon: PLANETS.MOON,
+    Mercury: PLANETS.MERCURY,
+    Venus: PLANETS.VENUS,
+    Mars: PLANETS.MARS,
+    Jupiter: PLANETS.JUPITER,
+    Saturn: PLANETS.SATURN,
+    Uranus: PLANETS.URANUS,
+    Neptune: PLANETS.NEPTUNE,
+    Pluto: PLANETS.PLUTO,
+    Chiron: PLANETS.CHIRON,
+    'North Node (Mean)': PLANETS.MEAN_NODE,
+    'North Node (True)': PLANETS.TRUE_NODE,
+    Ceres: PLANETS.CERES,
+    Pallas: PLANETS.PALLAS,
+    Juno: PLANETS.JUNO,
+    Vesta: PLANETS.VESTA,
+};
 /**
  * Personal planets (inner planets)
  *

package/docs/releases/1.4.0.md

@@ -0,0 +1,36 @@
+# ether-to-astro v1.4.0
+
+Suggested release type: `minor`
+
+This release builds on `1.3.1` by adding a reusable sign-boundary event primitive for deterministic ingress and egress queries across MCP, CLI, and the shared AstroService layer. It also hardens cusp-edge behavior so exact-boundary lookups avoid false events at tangential stations and at the exclusive end of a requested local-date window.
+
+## 1.4.0 (2026-03-29)
+
+### New feature
+
+- add `get_sign_boundary_events` as a stateless MCP tool for exact sign-boundary crossings across a local date window
+- add `get-sign-boundary-events` to the CLI so sign-boundary scans are available outside MCP sessions
+- add shared `AstroService` support and structured response types for reusable sign-boundary event lookups
+
+### Bug fix
+
+- skip cusp-touch roots that do not actually move the body into the adjacent sign
+- exclude sign-boundary roots that land exactly on the exclusive end of the requested window
+- keep error mapping and response-shape coverage aligned with the new sign-boundary surface
+
+### Documentation Changes
+
+- document the new sign-boundary tool in the README tool and CLI command lists
+
+### ⚙️ Chore
+
+- centralize supported sign-boundary bodies and planet-name constants for reuse across service logic and tests
+- extend unit and property coverage for the new sign-boundary workflow and related shared typing
+
+## Upgrade notes
+
+- no breaking API changes are included in this release
+
+## Included PRs
+
+- #65 add sign boundary events tool

package/docs/releases/README.md

@@ -10,8 +10,9 @@ Conventions:
 
 Current draft:
 
-- [v1.2.0 draft](/Users/salted/Code/astro-mcp/docs/releases/1.2.0-draft.md)
+- none currently
 
 Released notes:
 
-- [v1.3.0 notes](/Users/salted/Code/astro-mcp/docs/releases/1.3.0.md)
+- [v1.4.0 notes](./1.4.0.md)
+- [v1.3.0 notes](./1.3.0.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ether-to-astro",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Local-first astrology toolkit with a unified e2a binary for CLI and MCP workflows, plus an e2a-mcp compatibility alias.",
   "type": "module",
   "main": "dist/index.js",