ether-to-astro 1.3.0 → 1.4.0

package/README.md

@@ -295,6 +295,8 @@ Ask your AI agent:
 ## MCP Tools Available
 
 ### Setup
+- `get_server_status` - Inspect loaded chart state and effective MCP session settings
+- `set_preferences` - Update process-local MCP runtime preferences such as reporting timezone and preferred house style
 - `set_natal_chart` - Store birth chart data
 
 ### Transits
@@ -304,11 +306,12 @@ Ask your AI agent:
   - `forecast`: day-grouped transit output across the selected date window
   - if `mode` is omitted, legacy behavior is preserved: `days_ahead=0` resolves to `snapshot`, and `days_ahead>0` resolves to `best_hit`
   - each transit now includes additive placement metadata for both sides: sign, degree, and house
-  - with `include_mundane=true`, output includes deterministic mundane positions plus `mundane.aspects` and non-narrative `mundane.weather` grouping metadata
+  - with `include_mundane=true`, output includes deterministic mundane positions normalized with the same sign-boundary policy as serialized transits, plus `mundane.aspects` and non-narrative `mundane.weather` grouping metadata
   - when `include_mundane=true` and `mode=forecast`, output includes `mundane.days[]` with per-day grouped mundane aspects/weather
 
 ### Electional
 - `get_electional_context` - Stateless electional context for a local date, time, and location. Returns deterministic ascendant, sect/day-night classification, Moon phase, applying aspects, and optional ASC-ruler basics without requiring a natal chart.
+- `get_sign_boundary_events` - Stateless exact sign-boundary crossings for supported planets across a local date window, with both `from_sign` and `to_sign` so ingress and egress are represented as one event.
 
 ### Advanced Tools
 - `get_houses` - House cusps, Ascendant, Midheaven (Placidus, Koch, Whole Sign, Equal)
@@ -324,6 +327,7 @@ Ask your AI agent:
 ## CLI Commands Available
 
 - `set-natal-chart`
+- `get-sign-boundary-events`
 - `get-transits`
 - `get-houses`
 - `get-retrograde-planets`

package/dist/astro-service/natal-service.d.ts

@@ -1,7 +1,7 @@
 import type { McpStartupDefaults } from '../entrypoint.js';
 import type { EphemerisCalculator } from '../ephemeris.js';
 import type { HouseCalculator } from '../houses.js';
-import { type NatalChart } from '../types.js';
+import { type HouseSystem, type NatalChart } from '../types.js';
 import type { GetHousesInput, ServiceResult, SetNatalChartInput } from './service-types.js';
 interface NatalServiceDependencies {
     ephem: EphemerisCalculator;
@@ -9,6 +9,10 @@ interface NatalServiceDependencies {
     mcpStartupDefaults: Readonly<McpStartupDefaults>;
     isInitialized: () => boolean;
 }
+interface RuntimePreferenceSnapshot {
+    preferredTimezone?: string;
+    preferredHouseStyle?: HouseSystem;
+}
 /**
  * Internal natal/chart-state workflow used by `AstroService`.
  *
@@ -36,6 +40,6 @@ export declare class NatalService {
     /**
      * Summarize process-local server state and configured startup defaults.
      */
-    getServerStatus(natalChart: NatalChart | null): ServiceResult<Record<string, unknown>>;
+    getServerStatus(natalChart: NatalChart | null, runtimePreferences?: RuntimePreferenceSnapshot): ServiceResult<Record<string, unknown>>;
 }
 export {};

package/dist/astro-service/natal-service.js

@@ -157,23 +157,62 @@ export class NatalService {
     /**
      * Summarize process-local server state and configured startup defaults.
      */
-    getServerStatus(natalChart) {
+    getServerStatus(natalChart, runtimePreferences = {}) {
+        const reportingTimezone = runtimePreferences.preferredTimezone ??
+            this.mcpStartupDefaults.preferredTimezone ??
+            natalChart?.location.timezone ??
+            'UTC';
+        const reportingTimezoneSource = runtimePreferences.preferredTimezone !== undefined
+            ? 'runtime'
+            : this.mcpStartupDefaults.preferredTimezone !== undefined
+                ? 'startup'
+                : natalChart?.location.timezone
+                    ? 'natal'
+                    : 'fallback';
+        const preferredHouseStyle = runtimePreferences.preferredHouseStyle ??
+            natalChart?.requestedHouseSystem ??
+            this.mcpStartupDefaults.preferredHouseStyle ??
+            natalChart?.houseSystem ??
+            'P';
+        const preferredHouseStyleSource = runtimePreferences.preferredHouseStyle !== undefined
+            ? 'runtime'
+            : natalChart?.requestedHouseSystem !== undefined
+                ? 'chart_requested'
+                : this.mcpStartupDefaults.preferredHouseStyle !== undefined
+                    ? 'startup'
+                    : natalChart?.houseSystem !== undefined
+                        ? 'chart_resolved'
+                        : 'fallback';
         const statusData = {
             serverVersion: '1.0.0',
             hasNatalChart: natalChart !== null,
             natalChartName: natalChart?.name ?? null,
             natalChartTimezone: natalChart?.location.timezone ?? null,
+            natalChartRequestedHouseSystem: natalChart?.requestedHouseSystem ?? null,
+            natalChartResolvedHouseSystem: natalChart?.houseSystem ?? null,
             startupDefaults: {
                 preferredTimezone: this.mcpStartupDefaults.preferredTimezone ?? null,
                 preferredHouseStyle: this.mcpStartupDefaults.preferredHouseStyle ?? null,
                 weekdayLabels: this.mcpStartupDefaults.weekdayLabels ?? null,
             },
+            runtimePreferences: {
+                preferredTimezone: runtimePreferences.preferredTimezone ?? null,
+                preferredHouseStyle: runtimePreferences.preferredHouseStyle ?? null,
+            },
+            effectiveSettings: {
+                reportingTimezone,
+                reportingTimezoneSource,
+                preferredHouseStyle,
+                preferredHouseStyleSource,
+            },
             ephemerisInitialized: this.isInitialized(),
             stateModel: 'stateful-per-process',
         };
-        const humanText = natalChart
-            ? `Server ready. Natal chart loaded: ${natalChart.name} (${natalChart.location.timezone})`
-            : 'Server ready. No natal chart loaded — call set_natal_chart first.';
+        const chartText = natalChart
+            ? `Natal chart loaded: ${natalChart.name} (${natalChart.location.timezone})`
+            : 'No natal chart loaded';
+        const humanText = `Server ready. Reporting timezone: ${reportingTimezone} (${reportingTimezoneSource}). ` +
+            `House style: ${preferredHouseStyle} (${preferredHouseStyleSource}). ${chartText}.`;
         return { data: statusData, text: humanText };
     }
 }

package/dist/astro-service/service-types.d.ts

@@ -1,5 +1,5 @@
 import type { Disambiguation } from '../time-utils.js';
-import type { ElectionalHouseSystem, HouseSystem } from '../types.js';
+import type { ElectionalHouseSystem, HouseSystem, SignBoundaryBody } from '../types.js';
 /**
  * Public input type for building and caching the shared natal chart payload.
  */
@@ -21,6 +21,7 @@ export interface SetNatalChartInput {
  */
 export interface GetTransitsInput {
     date?: string;
+    timezone?: string;
     categories?: string[];
     include_mundane?: boolean;
     days_ahead?: number;
@@ -59,6 +60,15 @@ export interface GetRisingSignWindowsInput {
     timezone: string;
     mode?: 'approximate' | 'exact';
 }
+/**
+ * Public input type for stateless sign-boundary event lookup.
+ */
+export interface GetSignBoundaryEventsInput {
+    date?: string;
+    timezone?: string;
+    days_ahead?: number;
+    bodies?: SignBoundaryBody[];
+}
 /**
  * Public output-wrapper shared by service methods that return data plus text.
  */
@@ -66,6 +76,13 @@ export interface ServiceResult<T> {
     data: T;
     text: string;
 }
+/**
+ * Public input type for updating process-local MCP runtime preferences.
+ */
+export interface SetPreferencesInput {
+    preferred_timezone?: string | null;
+    preferred_house_style?: HouseSystem | null;
+}
 /**
  * Public input type for chart rendering methods.
  */

package/dist/astro-service/shared.d.ts

@@ -1,5 +1,5 @@
 import type { McpStartupDefaults } from '../entrypoint.js';
-import { type HouseData, type HouseSystem, type NatalChart } from '../types.js';
+import { type HouseData, type HouseSystem, type NatalChart, type PlanetPosition } from '../types.js';
 /**
  * Normalize any longitude into the standard 0-360 range.
  *
@@ -21,6 +21,13 @@ export declare function getSignAndDegree(longitude: number): {
     sign: string;
     degree: number;
 };
+/**
+ * Normalize a serialized planet placement to the shared sign-boundary policy.
+ *
+ * @param position - Planet position to normalize for response output
+ * @returns Copy of the position with sign/degree derived from shared boundary handling
+ */
+export declare function normalizePlanetPlacement(position: PlanetPosition): PlanetPosition;
 /**
  * Map a longitude to its house number for a resolved house table.
  *

package/dist/astro-service/shared.js

@@ -1,4 +1,4 @@
-import { ZODIAC_SIGNS } from '../types.js';
+import { ZODIAC_SIGNS, } from '../types.js';
 /**
  * Normalize any longitude into the standard 0-360 range.
  *
@@ -31,6 +31,20 @@ export function getSignAndDegree(longitude) {
         degree: shouldCarryToNextSign ? 0 : roundedDegree,
     };
 }
+/**
+ * Normalize a serialized planet placement to the shared sign-boundary policy.
+ *
+ * @param position - Planet position to normalize for response output
+ * @returns Copy of the position with sign/degree derived from shared boundary handling
+ */
+export function normalizePlanetPlacement(position) {
+    const placement = getSignAndDegree(position.longitude);
+    return {
+        ...position,
+        sign: placement.sign,
+        degree: placement.degree,
+    };
+}
 /**
  * Map a longitude to its house number for a resolved house table.
  *

package/dist/astro-service/sign-boundary-service.d.ts

@@ -0,0 +1,36 @@
+import type { EphemerisCalculator } from '../ephemeris.js';
+import type { GetSignBoundaryEventsInput, ServiceResult } from './service-types.js';
+interface SignBoundaryServiceDependencies {
+    ephem: EphemerisCalculator;
+    now: () => Date;
+}
+/**
+ * Internal stateless sign-boundary event scanner used by `AstroService`.
+ *
+ * @remarks
+ * This service owns local-day window resolution plus exact root lookup for
+ * planets crossing zodiac sign boundaries. It returns reusable structured
+ * events rather than question-shaped ingress/egress prose.
+ */
+export declare class SignBoundaryService {
+    private readonly ephem;
+    private readonly now;
+    constructor(deps: SignBoundaryServiceDependencies);
+    /**
+     * Return sign-boundary crossing events across a local calendar window.
+     */
+    getSignBoundaryEvents(input: GetSignBoundaryEventsInput & {
+        timezone: string;
+    }): ServiceResult<Record<string, unknown>>;
+    /**
+     * Resolve the local-midnight window start for the requested date.
+     */
+    private resolveWindowStart;
+    /**
+     * Format a local date for stable response metadata.
+     */
+    private formatDateLabel;
+    private classifyCrossing;
+    private signedBoundaryOffset;
+}
+export {};

package/dist/astro-service/sign-boundary-service.js

@@ -0,0 +1,156 @@
+import { addLocalDays, localToUTC, utcToLocal } from '../time-utils.js';
+import { PLANET_IDS_BY_NAME, SIGN_BOUNDARY_BODIES, ZODIAC_SIGNS, } from '../types.js';
+import { parseDateOnlyInput } from './date-input.js';
+import { normalizeLongitude } from './shared.js';
+const ROOT_CLASSIFICATION_SAMPLE_DAYS = 1 / 24;
+/**
+ * Internal stateless sign-boundary event scanner used by `AstroService`.
+ *
+ * @remarks
+ * This service owns local-day window resolution plus exact root lookup for
+ * planets crossing zodiac sign boundaries. It returns reusable structured
+ * events rather than question-shaped ingress/egress prose.
+ */
+export class SignBoundaryService {
+    ephem;
+    now;
+    constructor(deps) {
+        this.ephem = deps.ephem;
+        this.now = deps.now;
+    }
+    /**
+     * Return sign-boundary crossing events across a local calendar window.
+     */
+    getSignBoundaryEvents(input) {
+        const daysAhead = input.days_ahead ?? 0;
+        if (!Number.isFinite(daysAhead) || daysAhead < 0) {
+            throw new Error('days_ahead must be a finite number >= 0');
+        }
+        const requestedBodies = input.bodies ?? SIGN_BOUNDARY_BODIES;
+        for (const body of requestedBodies) {
+            if (!SIGN_BOUNDARY_BODIES.includes(body)) {
+                throw new Error(`Invalid body: ${body} (must be one of ${SIGN_BOUNDARY_BODIES.join(', ')})`);
+            }
+        }
+        const windowStart = this.resolveWindowStart(input.date, input.timezone);
+        const windowEnd = addLocalDays(utcToLocal(windowStart, input.timezone), input.timezone, daysAhead + 1);
+        const startJD = this.ephem.dateToJulianDay(windowStart);
+        const endJD = this.ephem.dateToJulianDay(windowEnd);
+        const events = [];
+        const seenKeys = new Set();
+        for (const body of requestedBodies) {
+            const planetId = PLANET_IDS_BY_NAME[body];
+            for (let signIndex = 0; signIndex < ZODIAC_SIGNS.length; signIndex++) {
+                const boundaryLongitude = signIndex * 30;
+                const roots = this.ephem.findExactTransitTimes(planetId, boundaryLongitude, startJD, endJD);
+                for (const root of roots) {
+                    if (root >= endJD) {
+                        continue;
+                    }
+                    const crossing = this.classifyCrossing(planetId, root, boundaryLongitude);
+                    if (!crossing) {
+                        continue;
+                    }
+                    const eventDate = this.ephem.julianDayToDate(root);
+                    const position = this.ephem.getPlanetPosition(planetId, root);
+                    const normalizedLongitude = normalizeLongitude(position.longitude);
+                    const event = {
+                        body,
+                        from_sign: crossing.fromSign,
+                        to_sign: crossing.toSign,
+                        exact_time: eventDate.toISOString(),
+                        longitude: Number.parseFloat(normalizedLongitude.toFixed(6)),
+                        direction: crossing.direction,
+                    };
+                    const dedupeKey = `${event.body}:${event.exact_time}:${event.to_sign}:${event.from_sign}`;
+                    if (!seenKeys.has(dedupeKey)) {
+                        seenKeys.add(dedupeKey);
+                        events.push(event);
+                    }
+                }
+            }
+        }
+        events.sort((left, right) => {
+            const timeOrder = left.exact_time.localeCompare(right.exact_time);
+            if (timeOrder !== 0) {
+                return timeOrder;
+            }
+            return left.body.localeCompare(right.body);
+        });
+        const startLocal = utcToLocal(windowStart, input.timezone);
+        const response = {
+            date: this.formatDateLabel(startLocal),
+            timezone: input.timezone,
+            calculation_timezone: input.timezone,
+            reporting_timezone: input.timezone,
+            days_ahead: daysAhead,
+            events,
+        };
+        const rangeLabel = daysAhead > 0 ? ` (next ${daysAhead + 1} days)` : '';
+        const humanText = events.length === 0
+            ? `No sign-boundary events found${rangeLabel}.`
+            : `Sign-boundary events${rangeLabel}:\n\n${events
+                .map((event) => `${event.body}: ${event.from_sign} -> ${event.to_sign} at ${event.exact_time} (${event.direction})`)
+                .join('\n')}`;
+        return {
+            data: response,
+            text: humanText,
+        };
+    }
+    /**
+     * Resolve the local-midnight window start for the requested date.
+     */
+    resolveWindowStart(date, timezone) {
+        if (date) {
+            const parsed = parseDateOnlyInput(date);
+            return localToUTC({ ...parsed, hour: 0, minute: 0, second: 0 }, timezone);
+        }
+        const localNow = utcToLocal(this.now(), timezone);
+        return localToUTC({
+            year: localNow.year,
+            month: localNow.month,
+            day: localNow.day,
+            hour: 0,
+            minute: 0,
+            second: 0,
+        }, timezone);
+    }
+    /**
+     * Format a local date for stable response metadata.
+     */
+    formatDateLabel(localDate) {
+        return `${localDate.year}-${String(localDate.month).padStart(2, '0')}-${String(localDate.day).padStart(2, '0')}`;
+    }
+    classifyCrossing(planetId, root, boundaryLongitude) {
+        const before = this.signedBoundaryOffset(planetId, root - ROOT_CLASSIFICATION_SAMPLE_DAYS, boundaryLongitude);
+        const after = this.signedBoundaryOffset(planetId, root + ROOT_CLASSIFICATION_SAMPLE_DAYS, boundaryLongitude);
+        if (before === 0 || after === 0 || before === after) {
+            return null;
+        }
+        const toSignIndex = Math.floor(boundaryLongitude / 30) % ZODIAC_SIGNS.length;
+        const fromSignIndex = (toSignIndex - 1 + ZODIAC_SIGNS.length) % ZODIAC_SIGNS.length;
+        return before < after
+            ? {
+                fromSign: ZODIAC_SIGNS[fromSignIndex],
+                toSign: ZODIAC_SIGNS[toSignIndex],
+                direction: 'direct',
+            }
+            : {
+                fromSign: ZODIAC_SIGNS[toSignIndex],
+                toSign: ZODIAC_SIGNS[fromSignIndex],
+                direction: 'retrograde',
+            };
+    }
+    signedBoundaryOffset(planetId, jd, boundaryLongitude) {
+        const longitude = this.ephem.getPlanetPosition(planetId, jd).longitude;
+        let diff = normalizeLongitude(longitude) - normalizeLongitude(boundaryLongitude);
+        if (diff > 180)
+            diff -= 360;
+        if (diff < -180)
+            diff += 360;
+        if (Math.abs(diff) < 1e-6) {
+            return 0;
+        }
+        return diff > 0 ? 1 : -1;
+    }
+}

package/dist/astro-service/sky-service.d.ts

@@ -1,5 +1,4 @@
 import type { EclipseCalculator } from '../eclipses.js';
-import type { McpStartupDefaults } from '../entrypoint.js';
 import type { EphemerisCalculator } from '../ephemeris.js';
 import type { RiseSetCalculator } from '../riseset.js';
 import { type NatalChart } from '../types.js';
@@ -8,7 +7,6 @@ interface SkyServiceDependencies {
     ephem: EphemerisCalculator;
     riseSetCalc: RiseSetCalculator;
     eclipseCalc: EclipseCalculator;
-    mcpStartupDefaults: Readonly<McpStartupDefaults>;
     now: () => Date;
     formatTimestamp: (date: Date, timezone: string) => string;
 }
@@ -23,7 +21,6 @@ export declare class SkyService {
     private readonly ephem;
     private readonly riseSetCalc;
     private readonly eclipseCalc;
-    private readonly mcpStartupDefaults;
     private readonly now;
     private readonly formatTimestamp;
     constructor(deps: SkyServiceDependencies);
@@ -34,7 +31,7 @@ export declare class SkyService {
     /**
      * Return the next rise and set events after the local day anchor for the chart location.
      */
-    getRiseSetTimes(natalChart: NatalChart): Promise<ServiceResult<Record<string, unknown>>>;
+    getRiseSetTimes(natalChart: NatalChart, reportingTimezone: string): Promise<ServiceResult<Record<string, unknown>>>;
     /**
      * Return current asteroid and node positions for the requested reporting timezone.
      */

package/dist/astro-service/sky-service.js

@@ -1,6 +1,5 @@
 import { localToUTC, utcToLocal } from '../time-utils.js';
 import { ASTEROIDS, NODES, PLANETS } from '../types.js';
-import { resolveReportingTimezone } from './shared.js';
 /**
  * Internal current-sky and runtime lookup workflow used by `AstroService`.
  *
@@ -12,14 +11,12 @@ export class SkyService {
     ephem;
     riseSetCalc;
     eclipseCalc;
-    mcpStartupDefaults;
     now;
     formatTimestamp;
     constructor(deps) {
         this.ephem = deps.ephem;
         this.riseSetCalc = deps.riseSetCalc;
         this.eclipseCalc = deps.eclipseCalc;
-        this.mcpStartupDefaults = deps.mcpStartupDefaults;
         this.now = deps.now;
         this.formatTimestamp = deps.formatTimestamp;
     }
@@ -27,7 +24,7 @@ export class SkyService {
      * Return the currently retrograde planets for the requested reporting timezone.
      */
     getRetrogradePlanets(timezone) {
-        const resolvedTimezone = resolveReportingTimezone(this.mcpStartupDefaults, timezone);
+        const resolvedTimezone = timezone ?? 'UTC';
         const now = this.now();
         const jd = this.ephem.dateToJulianDay(now);
         const positions = this.ephem.getAllPlanets(jd, Object.values(PLANETS));
@@ -35,6 +32,7 @@ export class SkyService {
         const structuredData = {
             date: this.getDateLabel(now, resolvedTimezone),
             timezone: resolvedTimezone,
+            reporting_timezone: resolvedTimezone,
             planets: retrograde,
         };
         const humanText = retrograde.length === 0
@@ -45,11 +43,10 @@ export class SkyService {
     /**
      * Return the next rise and set events after the local day anchor for the chart location.
      */
-    async getRiseSetTimes(natalChart) {
-        const timezone = natalChart.location.timezone;
-        const reportingTimezone = this.mcpStartupDefaults.preferredTimezone || timezone;
+    async getRiseSetTimes(natalChart, reportingTimezone) {
+        const calculationTimezone = natalChart.location.timezone;
         const now = this.now();
-        const localNow = utcToLocal(now, timezone);
+        const localNow = utcToLocal(now, calculationTimezone);
         const localMidnight = {
             year: localNow.year,
             month: localNow.month,
@@ -58,11 +55,13 @@ export class SkyService {
             minute: 0,
             second: 0,
         };
-        const midnightUTC = localToUTC(localMidnight, timezone);
+        const midnightUTC = localToUTC(localMidnight, calculationTimezone);
         const results = await this.riseSetCalc.getAllRiseSet(midnightUTC, natalChart.location.latitude, natalChart.location.longitude);
         const structuredData = {
-            date: this.getDateLabel(now, timezone),
-            timezone,
+            date: this.getDateLabel(now, calculationTimezone),
+            timezone: calculationTimezone,
+            calculation_timezone: calculationTimezone,
+            reporting_timezone: reportingTimezone,
             times: results.map((result) => ({
                 planet: result.planet,
                 rise: result.rise?.toISOString() ?? null,
@@ -85,13 +84,14 @@ export class SkyService {
      * Return current asteroid and node positions for the requested reporting timezone.
      */
     getAsteroidPositions(timezone) {
-        const resolvedTimezone = resolveReportingTimezone(this.mcpStartupDefaults, timezone);
+        const resolvedTimezone = timezone ?? 'UTC';
         const now = this.now();
         const jd = this.ephem.dateToJulianDay(now);
         const positions = this.ephem.getAllPlanets(jd, [...ASTEROIDS, ...NODES]);
         const structuredData = {
             date: this.getDateLabel(now, resolvedTimezone),
             timezone: resolvedTimezone,
+            reporting_timezone: resolvedTimezone,
             positions,
         };
         const humanText = `Asteroid & Node Positions:\n\n${positions
@@ -109,7 +109,7 @@ export class SkyService {
      * Look up the next solar and lunar eclipses after the current instant.
      */
     getNextEclipses(timezone) {
-        const resolvedTimezone = resolveReportingTimezone(this.mcpStartupDefaults, timezone);
+        const resolvedTimezone = timezone ?? 'UTC';
         const jd = this.ephem.dateToJulianDay(this.now());
         const solarEclipse = this.eclipseCalc.findNextSolarEclipse(jd);
         const lunarEclipse = this.eclipseCalc.findNextLunarEclipse(jd);
@@ -131,7 +131,11 @@ export class SkyService {
             });
             humanLines.push(`Next Lunar Eclipse: ${this.formatTimestamp(lunarEclipse.maxTime, resolvedTimezone)} (${lunarEclipse.eclipseType})`);
         }
-        const structuredData = { timezone: resolvedTimezone, eclipses };
+        const structuredData = {
+            timezone: resolvedTimezone,
+            reporting_timezone: resolvedTimezone,
+            eclipses,
+        };
         const humanText = eclipses.length === 0
             ? 'No eclipses found in the near future.'
             : `Upcoming Eclipses:\n\n${humanLines.join('\n')}`;

package/dist/astro-service/transit-service.js

@@ -1,8 +1,8 @@
 import { addLocalDays, localToUTC, utcToLocal } from '../time-utils.js';
 import { deduplicateTransits } from '../transits.js';
-import { ASPECTS, OUTER_PLANETS, PERSONAL_PLANETS, PLANET_NAMES, PLANETS, } from '../types.js';
+import { ASPECTS, OUTER_PLANETS, PERSONAL_PLANETS, PLANET_IDS_BY_NAME, PLANETS, } from '../types.js';
 import { parseDateOnlyInput } from './date-input.js';
-import { getHouseNumber, getSignAndDegree, resolveHouseSystem, resolveTimezones, } from './shared.js';
+import { getHouseNumber, getSignAndDegree, normalizePlanetPlacement, resolveHouseSystem, resolveTimezones, } from './shared.js';
 /**
  * Internal transit workflow service used by `AstroService`.
  *
@@ -56,7 +56,7 @@ export class TransitService {
         const mode = requestedMode ?? (daysAhead === 0 ? 'snapshot' : 'best_hit');
         const modeSource = requestedMode === undefined ? 'legacy_default' : 'explicit';
         const transitingPlanetIds = this.resolveTransitingPlanetIds(categories);
-        const { calculationTimezone, reportingTimezone } = resolveTimezones(this.mcpStartupDefaults, undefined, natalChart.location.timezone);
+        const { calculationTimezone, reportingTimezone } = resolveTimezones(this.mcpStartupDefaults, input.timezone, natalChart.location.timezone);
         const targetDate = this.resolveTargetDate(dateStr, calculationTimezone);
         const allTransits = [];
         const transitsByDay = new Map();
@@ -88,7 +88,7 @@ export class TransitService {
         const chartHouseSystem = resolveHouseSystem(natalChart, this.mcpStartupDefaults);
         const natalHouses = this.houseCalc.calculateHouses(natalChart.julianDay, natalChart.location.latitude, natalChart.location.longitude, chartHouseSystem);
         const transitHouseCache = new Map();
-        const planetIdsByName = new Map(Object.entries(PLANET_NAMES).map(([planetId, planetName]) => [planetName, Number(planetId)]));
+        const planetIdsByName = new Map(Object.entries(PLANET_IDS_BY_NAME).map(([planetName, planetId]) => [planetName, planetId]));
         const getTransitHouses = (julianDay) => {
             const cached = transitHouseCache.get(julianDay);
             if (cached) {
@@ -334,7 +334,9 @@ export class TransitService {
         const localDay = utcToLocal(dayUTC, timezone);
         const dateLabel = this.formatDateLabel(localDay);
         const currentJD = this.ephem.dateToJulianDay(dayUTC);
-        const positions = this.ephem.getAllPlanets(currentJD, transitingPlanetIds);
+        const positions = this.ephem
+            .getAllPlanets(currentJD, transitingPlanetIds)
+            .map(normalizePlanetPlacement);
         const aspects = this.getMundaneAspects(dateLabel, positions);
         return {
             date: dateLabel,

package/dist/astro-service.d.ts

@@ -1,4 +1,4 @@
-import type { GenerateChartInput, GenerateTransitChartInput, GetElectionalContextInput, GetHousesInput, GetRisingSignWindowsInput, GetTransitsInput, ServiceResult, SetNatalChartInput } from './astro-service/service-types.js';
+import type { GenerateChartInput, GenerateTransitChartInput, GetElectionalContextInput, GetHousesInput, GetRisingSignWindowsInput, GetSignBoundaryEventsInput, GetTransitsInput, ServiceResult, SetNatalChartInput, SetPreferencesInput } from './astro-service/service-types.js';
 import { ChartRenderer } from './charts.js';
 import { EclipseCalculator } from './eclipses.js';
 import type { McpStartupDefaults } from './entrypoint.js';
@@ -29,7 +29,7 @@ interface ChartServiceResult {
     };
 }
 export { parseDateOnlyInput } from './astro-service/date-input.js';
-export type { GenerateChartInput, GenerateTransitChartInput, GetElectionalContextInput, GetHousesInput, GetRisingSignWindowsInput, GetTransitsInput, ServiceResult, SetNatalChartInput, } from './astro-service/service-types.js';
+export type { GenerateChartInput, GenerateTransitChartInput, GetElectionalContextInput, GetHousesInput, GetRisingSignWindowsInput, GetSignBoundaryEventsInput, GetTransitsInput, ServiceResult, SetNatalChartInput, SetPreferencesInput, } from './astro-service/service-types.js';
 /**
  * Shared service facade used by both the MCP server and the CLI.
  *
@@ -45,9 +45,11 @@ export declare class AstroService {
     readonly eclipseCalc: EclipseCalculator;
     readonly chartRenderer: ChartRenderer;
     readonly mcpStartupDefaults: Readonly<McpStartupDefaults>;
+    private readonly runtimePreferences;
     private readonly transitService;
     private readonly electionalService;
     private readonly risingSignService;
+    private readonly signBoundaryService;
     private readonly natalService;
     private readonly skyService;
     private readonly chartOutputService;
@@ -66,6 +68,7 @@ export declare class AstroService {
      * timezone, and finally UTC.
      */
     resolveReportingTimezone(explicitTimezone?: string, natalTimezone?: string): string;
+    private applyRuntimeHouseStyle;
     /**
      * Initialize the underlying ephemeris engine.
      */
@@ -116,6 +119,10 @@ export declare class AstroService {
      * keeps the cheaper bucketed scan behavior.
      */
     getRisingSignWindows(input: GetRisingSignWindowsInput): ServiceResult<Record<string, unknown>>;
+    /**
+     * Return exact sign-boundary events across a local calendar window.
+     */
+    getSignBoundaryEvents(input?: GetSignBoundaryEventsInput): ServiceResult<Record<string, unknown>>;
     /**
      * Return the currently retrograde planets for the requested reporting timezone.
      */
@@ -127,7 +134,7 @@ export declare class AstroService {
      * The lookup anchor remains local midnight in the natal chart timezone even
      * when reporting text uses a preferred reporting timezone.
      */
-    getRiseSetTimes(natalChart: NatalChart): Promise<ServiceResult<Record<string, unknown>>>;
+    getRiseSetTimes(natalChart: NatalChart, timezone?: string): Promise<ServiceResult<Record<string, unknown>>>;
     /**
      * Return current asteroid and node positions for the requested reporting timezone.
      */
@@ -140,6 +147,10 @@ export declare class AstroService {
      * Summarize process-local server state and configured startup defaults.
      */
     getServerStatus(natalChart: NatalChart | null): ServiceResult<Record<string, unknown>>;
+    /**
+     * Update process-local MCP runtime preferences.
+     */
+    setPreferences(input: SetPreferencesInput): ServiceResult<Record<string, unknown>>;
     /**
      * Generate a natal chart image or SVG for the current chart.
      *