caelus-mcp 0.15.0 → 0.16.0

package/README.md

@@ -1,7 +1,7 @@
 # caelus-mcp
 
 MCP server for the [caelus](https://github.com/heavyblotto/caelus) ephemeris
-engine: twenty-two chart tools over stdio. Computation only — positions, houses,
+engine: twenty-seven chart tools over stdio. Computation only — positions, houses,
 aspects with orbs, event search, electional, returns, progressions, composite,
 dignities, Hermetic lots, the Hellenistic time-lords (profections, firdaria,
 zodiacal releasing), primary directions, and the Vedic layer (nakshatras,

package/dist/src/server.d.ts

@@ -1312,26 +1312,34 @@ export declare const dignitiesOut: z.ZodObject<{
     bodies: z.ZodRecord<z.ZodString, z.ZodObject<{
         sign: z.ZodString;
         dignity: z.ZodArray<z.ZodEnum<["domicile", "exaltation", "detriment", "fall"]>, "many">;
+        score: z.ZodNumber;
+        peregrine: z.ZodOptional<z.ZodBoolean>;
         planetary_sect: z.ZodNullable<z.ZodEnum<["diurnal", "nocturnal"]>>;
         in_sect: z.ZodNullable<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         dignity: ("domicile" | "exaltation" | "detriment" | "fall")[];
         sign: string;
+        score: number;
         planetary_sect: "diurnal" | "nocturnal" | null;
         in_sect: boolean | null;
+        peregrine?: boolean | undefined;
     }, {
         dignity: ("domicile" | "exaltation" | "detriment" | "fall")[];
         sign: string;
+        score: number;
         planetary_sect: "diurnal" | "nocturnal" | null;
         in_sect: boolean | null;
+        peregrine?: boolean | undefined;
     }>>;
 }, "strip", z.ZodTypeAny, {
     utc: string;
     bodies: Record<string, {
         dignity: ("domicile" | "exaltation" | "detriment" | "fall")[];
         sign: string;
+        score: number;
         planetary_sect: "diurnal" | "nocturnal" | null;
         in_sect: boolean | null;
+        peregrine?: boolean | undefined;
     }>;
     sect: "day" | "night";
 }, {
@@ -1339,8 +1347,10 @@ export declare const dignitiesOut: z.ZodObject<{
     bodies: Record<string, {
         dignity: ("domicile" | "exaltation" | "detriment" | "fall")[];
         sign: string;
+        score: number;
         planetary_sect: "diurnal" | "nocturnal" | null;
         in_sect: boolean | null;
+        peregrine?: boolean | undefined;
     }>;
     sect: "day" | "night";
 }>;
@@ -1960,6 +1970,317 @@ export declare const yogasOut: z.ZodObject<{
     }[];
     yogakarakas: string[];
 }>;
+export declare const patternsOut: z.ZodObject<{
+    utc: z.ZodString;
+    houses: z.ZodEnum<["placidus", "whole_sign", "equal", "porphyry", "koch", "regiomontanus", "campanus", "alcabitius", "morinus", "meridian", "polich_page", "vehlow"]>;
+    zodiac: z.ZodOptional<z.ZodEnum<["tropical", "sidereal:lahiri", "sidereal:fagan_bradley", "sidereal:krishnamurti", "sidereal:raman", "sidereal:yukteshwar", "sidereal:galcent_0sag", "sidereal:true_citra"]>>;
+    patterns: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        bodies: z.ZodArray<z.ZodString, "many">;
+        apex: z.ZodOptional<z.ZodString>;
+        sign: z.ZodOptional<z.ZodString>;
+        house: z.ZodOptional<z.ZodNumber>;
+        orb: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        orb: number;
+        bodies: string[];
+        kind: string;
+        house?: number | undefined;
+        sign?: string | undefined;
+        apex?: string | undefined;
+    }, {
+        orb: number;
+        bodies: string[];
+        kind: string;
+        house?: number | undefined;
+        sign?: string | undefined;
+        apex?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    utc: string;
+    houses: "placidus" | "whole_sign" | "equal" | "porphyry" | "koch" | "regiomontanus" | "campanus" | "alcabitius" | "morinus" | "meridian" | "polich_page" | "vehlow";
+    patterns: {
+        orb: number;
+        bodies: string[];
+        kind: string;
+        house?: number | undefined;
+        sign?: string | undefined;
+        apex?: string | undefined;
+    }[];
+    zodiac?: "tropical" | "sidereal:lahiri" | "sidereal:fagan_bradley" | "sidereal:krishnamurti" | "sidereal:raman" | "sidereal:yukteshwar" | "sidereal:galcent_0sag" | "sidereal:true_citra" | undefined;
+}, {
+    utc: string;
+    houses: "placidus" | "whole_sign" | "equal" | "porphyry" | "koch" | "regiomontanus" | "campanus" | "alcabitius" | "morinus" | "meridian" | "polich_page" | "vehlow";
+    patterns: {
+        orb: number;
+        bodies: string[];
+        kind: string;
+        house?: number | undefined;
+        sign?: string | undefined;
+        apex?: string | undefined;
+    }[];
+    zodiac?: "tropical" | "sidereal:lahiri" | "sidereal:fagan_bradley" | "sidereal:krishnamurti" | "sidereal:raman" | "sidereal:yukteshwar" | "sidereal:galcent_0sag" | "sidereal:true_citra" | undefined;
+}>;
+export declare const signatureOut: z.ZodObject<{
+    utc: z.ZodString;
+    houses: z.ZodEnum<["placidus", "whole_sign", "equal", "porphyry", "koch", "regiomontanus", "campanus", "alcabitius", "morinus", "meridian", "polich_page", "vehlow"]>;
+    zodiac: z.ZodOptional<z.ZodEnum<["tropical", "sidereal:lahiri", "sidereal:fagan_bradley", "sidereal:krishnamurti", "sidereal:raman", "sidereal:yukteshwar", "sidereal:galcent_0sag", "sidereal:true_citra"]>>;
+    signature: z.ZodObject<{
+        elements: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        modalities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        angularity: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        quadrants: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        hemispheres: z.ZodRecord<z.ZodString, z.ZodNumber>;
+        dominant: z.ZodObject<{
+            element: z.ZodString;
+            modality: z.ZodString;
+            sign: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            sign: string | null;
+            element: string;
+            modality: string;
+        }, {
+            sign: string | null;
+            element: string;
+            modality: string;
+        }>;
+        ruler: z.ZodNullable<z.ZodString>;
+        bodies: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        bodies: string[];
+        ruler: string | null;
+        elements: Record<string, number>;
+        modalities: Record<string, number>;
+        angularity: Record<string, number>;
+        quadrants: Record<string, number>;
+        hemispheres: Record<string, number>;
+        dominant: {
+            sign: string | null;
+            element: string;
+            modality: string;
+        };
+    }, {
+        bodies: string[];
+        ruler: string | null;
+        elements: Record<string, number>;
+        modalities: Record<string, number>;
+        angularity: Record<string, number>;
+        quadrants: Record<string, number>;
+        hemispheres: Record<string, number>;
+        dominant: {
+            sign: string | null;
+            element: string;
+            modality: string;
+        };
+    }>;
+}, "strip", z.ZodTypeAny, {
+    utc: string;
+    houses: "placidus" | "whole_sign" | "equal" | "porphyry" | "koch" | "regiomontanus" | "campanus" | "alcabitius" | "morinus" | "meridian" | "polich_page" | "vehlow";
+    signature: {
+        bodies: string[];
+        ruler: string | null;
+        elements: Record<string, number>;
+        modalities: Record<string, number>;
+        angularity: Record<string, number>;
+        quadrants: Record<string, number>;
+        hemispheres: Record<string, number>;
+        dominant: {
+            sign: string | null;
+            element: string;
+            modality: string;
+        };
+    };
+    zodiac?: "tropical" | "sidereal:lahiri" | "sidereal:fagan_bradley" | "sidereal:krishnamurti" | "sidereal:raman" | "sidereal:yukteshwar" | "sidereal:galcent_0sag" | "sidereal:true_citra" | undefined;
+}, {
+    utc: string;
+    houses: "placidus" | "whole_sign" | "equal" | "porphyry" | "koch" | "regiomontanus" | "campanus" | "alcabitius" | "morinus" | "meridian" | "polich_page" | "vehlow";
+    signature: {
+        bodies: string[];
+        ruler: string | null;
+        elements: Record<string, number>;
+        modalities: Record<string, number>;
+        angularity: Record<string, number>;
+        quadrants: Record<string, number>;
+        hemispheres: Record<string, number>;
+        dominant: {
+            sign: string | null;
+            element: string;
+            modality: string;
+        };
+    };
+    zodiac?: "tropical" | "sidereal:lahiri" | "sidereal:fagan_bradley" | "sidereal:krishnamurti" | "sidereal:raman" | "sidereal:yukteshwar" | "sidereal:galcent_0sag" | "sidereal:true_citra" | undefined;
+}>;
+export declare const similarSkiesOut: z.ZodObject<{
+    reference_utc: z.ZodString;
+    matches: z.ZodArray<z.ZodObject<{
+        utc: z.ZodString;
+        similarity: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        utc: string;
+        similarity: number;
+    }, {
+        utc: string;
+        similarity: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    reference_utc: string;
+    matches: {
+        utc: string;
+        similarity: number;
+    }[];
+}, {
+    reference_utc: string;
+    matches: {
+        utc: string;
+        similarity: number;
+    }[];
+}>;
+export declare const electionalOut: z.ZodObject<{
+    start: z.ZodString;
+    end: z.ZodString;
+    moments: z.ZodArray<z.ZodObject<{
+        utc: z.ZodString;
+        score: z.ZodNumber;
+        matched: z.ZodArray<z.ZodObject<{
+            a: z.ZodString;
+            b: z.ZodString;
+            aspect: z.ZodEnum<["conjunction", "sextile", "square", "trine", "opposition"]>;
+            orb: z.ZodNumber;
+            applying: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            applying: boolean;
+            a: string;
+            b: string;
+            aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+            orb: number;
+        }, {
+            applying: boolean;
+            a: string;
+            b: string;
+            aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+            orb: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        utc: string;
+        score: number;
+        matched: {
+            applying: boolean;
+            a: string;
+            b: string;
+            aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+            orb: number;
+        }[];
+    }, {
+        utc: string;
+        score: number;
+        matched: {
+            applying: boolean;
+            a: string;
+            b: string;
+            aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+            orb: number;
+        }[];
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    start: string;
+    end: string;
+    moments: {
+        utc: string;
+        score: number;
+        matched: {
+            applying: boolean;
+            a: string;
+            b: string;
+            aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+            orb: number;
+        }[];
+    }[];
+}, {
+    start: string;
+    end: string;
+    moments: {
+        utc: string;
+        score: number;
+        matched: {
+            applying: boolean;
+            a: string;
+            b: string;
+            aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+            orb: number;
+        }[];
+    }[];
+}>;
+export declare const cosmicWeatherOut: z.ZodObject<{
+    utc: z.ZodString;
+    patterns: z.ZodArray<z.ZodObject<{
+        kind: z.ZodString;
+        bodies: z.ZodArray<z.ZodString, "many">;
+        apex: z.ZodOptional<z.ZodString>;
+        sign: z.ZodOptional<z.ZodString>;
+        house: z.ZodOptional<z.ZodNumber>;
+        orb: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        orb: number;
+        bodies: string[];
+        kind: string;
+        house?: number | undefined;
+        sign?: string | undefined;
+        apex?: string | undefined;
+    }, {
+        orb: number;
+        bodies: string[];
+        kind: string;
+        house?: number | undefined;
+        sign?: string | undefined;
+        apex?: string | undefined;
+    }>, "many">;
+    stationing: z.ZodArray<z.ZodObject<{
+        body: z.ZodString;
+        utc: z.ZodString;
+        direction: z.ZodEnum<["retrograde", "direct"]>;
+    }, "strip", z.ZodTypeAny, {
+        utc: string;
+        body: string;
+        direction: "retrograde" | "direct";
+    }, {
+        utc: string;
+        body: string;
+        direction: "retrograde" | "direct";
+    }>, "many">;
+    moon_void_of_course: z.ZodBoolean;
+}, "strip", z.ZodTypeAny, {
+    utc: string;
+    patterns: {
+        orb: number;
+        bodies: string[];
+        kind: string;
+        house?: number | undefined;
+        sign?: string | undefined;
+        apex?: string | undefined;
+    }[];
+    stationing: {
+        utc: string;
+        body: string;
+        direction: "retrograde" | "direct";
+    }[];
+    moon_void_of_course: boolean;
+}, {
+    utc: string;
+    patterns: {
+        orb: number;
+        bodies: string[];
+        kind: string;
+        house?: number | undefined;
+        sign?: string | undefined;
+        apex?: string | undefined;
+    }[];
+    stationing: {
+        utc: string;
+        body: string;
+        direction: "retrograde" | "direct";
+    }[];
+    moon_void_of_course: boolean;
+}>;
 export declare const OUTPUT_SCHEMAS: {
     readonly natal_chart: z.ZodObject<{
         utc: z.ZodString;
@@ -3389,26 +3710,34 @@ export declare const OUTPUT_SCHEMAS: {
         bodies: z.ZodRecord<z.ZodString, z.ZodObject<{
             sign: z.ZodString;
             dignity: z.ZodArray<z.ZodEnum<["domicile", "exaltation", "detriment", "fall"]>, "many">;
+            score: z.ZodNumber;
+            peregrine: z.ZodOptional<z.ZodBoolean>;
             planetary_sect: z.ZodNullable<z.ZodEnum<["diurnal", "nocturnal"]>>;
             in_sect: z.ZodNullable<z.ZodBoolean>;
         }, "strip", z.ZodTypeAny, {
             dignity: ("domicile" | "exaltation" | "detriment" | "fall")[];
             sign: string;
+            score: number;
             planetary_sect: "diurnal" | "nocturnal" | null;
             in_sect: boolean | null;
+            peregrine?: boolean | undefined;
         }, {
             dignity: ("domicile" | "exaltation" | "detriment" | "fall")[];
             sign: string;
+            score: number;
             planetary_sect: "diurnal" | "nocturnal" | null;
             in_sect: boolean | null;
+            peregrine?: boolean | undefined;
         }>>;
     }, "strip", z.ZodTypeAny, {
         utc: string;
         bodies: Record<string, {
             dignity: ("domicile" | "exaltation" | "detriment" | "fall")[];
             sign: string;
+            score: number;
             planetary_sect: "diurnal" | "nocturnal" | null;
             in_sect: boolean | null;
+            peregrine?: boolean | undefined;
         }>;
         sect: "day" | "night";
     }, {
@@ -3416,8 +3745,10 @@ export declare const OUTPUT_SCHEMAS: {
         bodies: Record<string, {
             dignity: ("domicile" | "exaltation" | "detriment" | "fall")[];
             sign: string;
+            score: number;
             planetary_sect: "diurnal" | "nocturnal" | null;
             in_sect: boolean | null;
+            peregrine?: boolean | undefined;
         }>;
         sect: "day" | "night";
     }>;
@@ -4037,6 +4368,317 @@ export declare const OUTPUT_SCHEMAS: {
         }[];
         yogakarakas: string[];
     }>;
+    readonly aspect_patterns: z.ZodObject<{
+        utc: z.ZodString;
+        houses: z.ZodEnum<["placidus", "whole_sign", "equal", "porphyry", "koch", "regiomontanus", "campanus", "alcabitius", "morinus", "meridian", "polich_page", "vehlow"]>;
+        zodiac: z.ZodOptional<z.ZodEnum<["tropical", "sidereal:lahiri", "sidereal:fagan_bradley", "sidereal:krishnamurti", "sidereal:raman", "sidereal:yukteshwar", "sidereal:galcent_0sag", "sidereal:true_citra"]>>;
+        patterns: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            bodies: z.ZodArray<z.ZodString, "many">;
+            apex: z.ZodOptional<z.ZodString>;
+            sign: z.ZodOptional<z.ZodString>;
+            house: z.ZodOptional<z.ZodNumber>;
+            orb: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            orb: number;
+            bodies: string[];
+            kind: string;
+            house?: number | undefined;
+            sign?: string | undefined;
+            apex?: string | undefined;
+        }, {
+            orb: number;
+            bodies: string[];
+            kind: string;
+            house?: number | undefined;
+            sign?: string | undefined;
+            apex?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        utc: string;
+        houses: "placidus" | "whole_sign" | "equal" | "porphyry" | "koch" | "regiomontanus" | "campanus" | "alcabitius" | "morinus" | "meridian" | "polich_page" | "vehlow";
+        patterns: {
+            orb: number;
+            bodies: string[];
+            kind: string;
+            house?: number | undefined;
+            sign?: string | undefined;
+            apex?: string | undefined;
+        }[];
+        zodiac?: "tropical" | "sidereal:lahiri" | "sidereal:fagan_bradley" | "sidereal:krishnamurti" | "sidereal:raman" | "sidereal:yukteshwar" | "sidereal:galcent_0sag" | "sidereal:true_citra" | undefined;
+    }, {
+        utc: string;
+        houses: "placidus" | "whole_sign" | "equal" | "porphyry" | "koch" | "regiomontanus" | "campanus" | "alcabitius" | "morinus" | "meridian" | "polich_page" | "vehlow";
+        patterns: {
+            orb: number;
+            bodies: string[];
+            kind: string;
+            house?: number | undefined;
+            sign?: string | undefined;
+            apex?: string | undefined;
+        }[];
+        zodiac?: "tropical" | "sidereal:lahiri" | "sidereal:fagan_bradley" | "sidereal:krishnamurti" | "sidereal:raman" | "sidereal:yukteshwar" | "sidereal:galcent_0sag" | "sidereal:true_citra" | undefined;
+    }>;
+    readonly chart_signature: z.ZodObject<{
+        utc: z.ZodString;
+        houses: z.ZodEnum<["placidus", "whole_sign", "equal", "porphyry", "koch", "regiomontanus", "campanus", "alcabitius", "morinus", "meridian", "polich_page", "vehlow"]>;
+        zodiac: z.ZodOptional<z.ZodEnum<["tropical", "sidereal:lahiri", "sidereal:fagan_bradley", "sidereal:krishnamurti", "sidereal:raman", "sidereal:yukteshwar", "sidereal:galcent_0sag", "sidereal:true_citra"]>>;
+        signature: z.ZodObject<{
+            elements: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            modalities: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            angularity: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            quadrants: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            hemispheres: z.ZodRecord<z.ZodString, z.ZodNumber>;
+            dominant: z.ZodObject<{
+                element: z.ZodString;
+                modality: z.ZodString;
+                sign: z.ZodNullable<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                sign: string | null;
+                element: string;
+                modality: string;
+            }, {
+                sign: string | null;
+                element: string;
+                modality: string;
+            }>;
+            ruler: z.ZodNullable<z.ZodString>;
+            bodies: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            bodies: string[];
+            ruler: string | null;
+            elements: Record<string, number>;
+            modalities: Record<string, number>;
+            angularity: Record<string, number>;
+            quadrants: Record<string, number>;
+            hemispheres: Record<string, number>;
+            dominant: {
+                sign: string | null;
+                element: string;
+                modality: string;
+            };
+        }, {
+            bodies: string[];
+            ruler: string | null;
+            elements: Record<string, number>;
+            modalities: Record<string, number>;
+            angularity: Record<string, number>;
+            quadrants: Record<string, number>;
+            hemispheres: Record<string, number>;
+            dominant: {
+                sign: string | null;
+                element: string;
+                modality: string;
+            };
+        }>;
+    }, "strip", z.ZodTypeAny, {
+        utc: string;
+        houses: "placidus" | "whole_sign" | "equal" | "porphyry" | "koch" | "regiomontanus" | "campanus" | "alcabitius" | "morinus" | "meridian" | "polich_page" | "vehlow";
+        signature: {
+            bodies: string[];
+            ruler: string | null;
+            elements: Record<string, number>;
+            modalities: Record<string, number>;
+            angularity: Record<string, number>;
+            quadrants: Record<string, number>;
+            hemispheres: Record<string, number>;
+            dominant: {
+                sign: string | null;
+                element: string;
+                modality: string;
+            };
+        };
+        zodiac?: "tropical" | "sidereal:lahiri" | "sidereal:fagan_bradley" | "sidereal:krishnamurti" | "sidereal:raman" | "sidereal:yukteshwar" | "sidereal:galcent_0sag" | "sidereal:true_citra" | undefined;
+    }, {
+        utc: string;
+        houses: "placidus" | "whole_sign" | "equal" | "porphyry" | "koch" | "regiomontanus" | "campanus" | "alcabitius" | "morinus" | "meridian" | "polich_page" | "vehlow";
+        signature: {
+            bodies: string[];
+            ruler: string | null;
+            elements: Record<string, number>;
+            modalities: Record<string, number>;
+            angularity: Record<string, number>;
+            quadrants: Record<string, number>;
+            hemispheres: Record<string, number>;
+            dominant: {
+                sign: string | null;
+                element: string;
+                modality: string;
+            };
+        };
+        zodiac?: "tropical" | "sidereal:lahiri" | "sidereal:fagan_bradley" | "sidereal:krishnamurti" | "sidereal:raman" | "sidereal:yukteshwar" | "sidereal:galcent_0sag" | "sidereal:true_citra" | undefined;
+    }>;
+    readonly similar_skies: z.ZodObject<{
+        reference_utc: z.ZodString;
+        matches: z.ZodArray<z.ZodObject<{
+            utc: z.ZodString;
+            similarity: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            utc: string;
+            similarity: number;
+        }, {
+            utc: string;
+            similarity: number;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        reference_utc: string;
+        matches: {
+            utc: string;
+            similarity: number;
+        }[];
+    }, {
+        reference_utc: string;
+        matches: {
+            utc: string;
+            similarity: number;
+        }[];
+    }>;
+    readonly electional_search: z.ZodObject<{
+        start: z.ZodString;
+        end: z.ZodString;
+        moments: z.ZodArray<z.ZodObject<{
+            utc: z.ZodString;
+            score: z.ZodNumber;
+            matched: z.ZodArray<z.ZodObject<{
+                a: z.ZodString;
+                b: z.ZodString;
+                aspect: z.ZodEnum<["conjunction", "sextile", "square", "trine", "opposition"]>;
+                orb: z.ZodNumber;
+                applying: z.ZodBoolean;
+            }, "strip", z.ZodTypeAny, {
+                applying: boolean;
+                a: string;
+                b: string;
+                aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+                orb: number;
+            }, {
+                applying: boolean;
+                a: string;
+                b: string;
+                aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+                orb: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            utc: string;
+            score: number;
+            matched: {
+                applying: boolean;
+                a: string;
+                b: string;
+                aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+                orb: number;
+            }[];
+        }, {
+            utc: string;
+            score: number;
+            matched: {
+                applying: boolean;
+                a: string;
+                b: string;
+                aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+                orb: number;
+            }[];
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        start: string;
+        end: string;
+        moments: {
+            utc: string;
+            score: number;
+            matched: {
+                applying: boolean;
+                a: string;
+                b: string;
+                aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+                orb: number;
+            }[];
+        }[];
+    }, {
+        start: string;
+        end: string;
+        moments: {
+            utc: string;
+            score: number;
+            matched: {
+                applying: boolean;
+                a: string;
+                b: string;
+                aspect: "conjunction" | "sextile" | "square" | "trine" | "opposition";
+                orb: number;
+            }[];
+        }[];
+    }>;
+    readonly cosmic_weather: z.ZodObject<{
+        utc: z.ZodString;
+        patterns: z.ZodArray<z.ZodObject<{
+            kind: z.ZodString;
+            bodies: z.ZodArray<z.ZodString, "many">;
+            apex: z.ZodOptional<z.ZodString>;
+            sign: z.ZodOptional<z.ZodString>;
+            house: z.ZodOptional<z.ZodNumber>;
+            orb: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            orb: number;
+            bodies: string[];
+            kind: string;
+            house?: number | undefined;
+            sign?: string | undefined;
+            apex?: string | undefined;
+        }, {
+            orb: number;
+            bodies: string[];
+            kind: string;
+            house?: number | undefined;
+            sign?: string | undefined;
+            apex?: string | undefined;
+        }>, "many">;
+        stationing: z.ZodArray<z.ZodObject<{
+            body: z.ZodString;
+            utc: z.ZodString;
+            direction: z.ZodEnum<["retrograde", "direct"]>;
+        }, "strip", z.ZodTypeAny, {
+            utc: string;
+            body: string;
+            direction: "retrograde" | "direct";
+        }, {
+            utc: string;
+            body: string;
+            direction: "retrograde" | "direct";
+        }>, "many">;
+        moon_void_of_course: z.ZodBoolean;
+    }, "strip", z.ZodTypeAny, {
+        utc: string;
+        patterns: {
+            orb: number;
+            bodies: string[];
+            kind: string;
+            house?: number | undefined;
+            sign?: string | undefined;
+            apex?: string | undefined;
+        }[];
+        stationing: {
+            utc: string;
+            body: string;
+            direction: "retrograde" | "direct";
+        }[];
+        moon_void_of_course: boolean;
+    }, {
+        utc: string;
+        patterns: {
+            orb: number;
+            bodies: string[];
+            kind: string;
+            house?: number | undefined;
+            sign?: string | undefined;
+            apex?: string | undefined;
+        }[];
+        stationing: {
+            utc: string;
+            body: string;
+            direction: "retrograde" | "direct";
+        }[];
+        moon_void_of_course: boolean;
+    }>;
 };
 export interface BuildServerOptions {
     version?: string;

package/dist/src/server.js

@@ -17,7 +17,7 @@ import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 import { createRequire } from "node:module";
 import { realpathSync } from "node:fs";
-import { Engine, BODIES, julianDay, mod, riseSet, crossings, lunarPhases, stations, lunarEclipses, solarEclipses, ASPECTS, DEFAULT_ORBS, SIGNS as SIGN_NAMES, dignities, normalizeHouseSystem, solarPhase, aspectPhase, planetaryHour, voidOfCourse, CAZIMI_DEG, COMBUST_DEG, UNDER_BEAMS_DEG, solarReturn, lunarReturn, progressedLongitude, directedLongitude, solarArc, progressedJd, compositeLongitudes, davisonParams, midpointLon, dignityOf, isDayChart, planetarySect, inSect, lots, HERMETIC_LOTS, profectionAt, firdaria, firdariaActive, zrRelease, zrActive, lotSpirit, lotFortune, primaryDirections, mundaneDirections, nakshatra, vimshottariDashas, vimshottariAt, yoginiDashas, yoginiAt, ashtottariDashas, ashtottariAt, varga, VARGA_DIVISIONS, yogasAt, kemadrumaAt, rajaYogasAt, dhanaYogasAt, } from "caelus";
+import { Engine, BODIES, julianDay, mod, riseSet, crossings, lunarPhases, stations, lunarEclipses, solarEclipses, ASPECTS, DEFAULT_ORBS, SIGNS as SIGN_NAMES, dignities, normalizeHouseSystem, solarPhase, aspectPhase, planetaryHour, voidOfCourse, CAZIMI_DEG, COMBUST_DEG, UNDER_BEAMS_DEG, solarReturn, lunarReturn, progressedLongitude, directedLongitude, solarArc, progressedJd, compositeLongitudes, davisonParams, midpointLon, dignityOf, isDayChart, planetarySect, inSect, lots, HERMETIC_LOTS, profectionAt, firdaria, firdariaActive, zrRelease, zrActive, lotSpirit, lotFortune, primaryDirections, mundaneDirections, nakshatra, vimshottariDashas, vimshottariAt, yoginiDashas, yoginiAt, ashtottariDashas, ashtottariAt, varga, VARGA_DIVISIONS, yogasAt, kemadrumaAt, rajaYogasAt, dhanaYogasAt, detectPatterns, detectPatternsIn, chartSignature, chartFeatures, searchConfigurations, dignityScore, aspectBetween, } from "caelus";
 import { loadNodeData } from "caelus/node";
 const require = createRequire(import.meta.url);
 // Read our own version relative to this file (dist/src/server.js -> the package
@@ -339,6 +339,8 @@ export const compositeOut = z.object({
 const dignityBody = z.object({
     sign: z.string(),
     dignity: z.array(z.enum(["domicile", "exaltation", "detriment", "fall"])),
+    score: z.number(),
+    peregrine: z.boolean().optional(),
     planetary_sect: z.enum(["diurnal", "nocturnal"]).nullable(),
     in_sect: z.boolean().nullable(),
 });
@@ -482,6 +484,62 @@ export const yogasOut = z.object({
     dhana_yogas: z.array(lordPairOut),
     yogakarakas: z.array(z.string()),
 });
+export const patternsOut = z.object({
+    utc: z.string(),
+    houses: z.enum(HOUSE_SYSTEMS),
+    zodiac: z.enum(ZODIACS).optional(),
+    patterns: z.array(z.object({
+        kind: z.string(),
+        bodies: z.array(z.string()),
+        apex: z.string().optional(),
+        sign: z.string().optional(),
+        house: z.number().int().optional(),
+        orb: z.number(),
+    })),
+});
+const countMap = z.record(z.string(), z.number().int());
+export const signatureOut = z.object({
+    utc: z.string(),
+    houses: z.enum(HOUSE_SYSTEMS),
+    zodiac: z.enum(ZODIACS).optional(),
+    signature: z.object({
+        elements: countMap,
+        modalities: countMap,
+        angularity: countMap,
+        quadrants: countMap,
+        hemispheres: countMap,
+        dominant: z.object({ element: z.string(), modality: z.string(), sign: z.string().nullable() }),
+        ruler: z.string().nullable(),
+        bodies: z.array(z.string()),
+    }),
+});
+export const similarSkiesOut = z.object({
+    reference_utc: z.string(),
+    matches: z.array(z.object({ utc: z.string(), similarity: z.number() })),
+});
+export const electionalOut = z.object({
+    start: z.string(),
+    end: z.string(),
+    moments: z.array(z.object({
+        utc: z.string(),
+        score: z.number(),
+        matched: z.array(z.object({
+            a: z.string(), b: z.string(), aspect: aspectName, orb: z.number(),
+            applying: z.boolean(),
+        })),
+    })),
+});
+const patternRow = z.object({
+    kind: z.string(), bodies: z.array(z.string()),
+    apex: z.string().optional(), sign: z.string().optional(),
+    house: z.number().int().optional(), orb: z.number(),
+});
+export const cosmicWeatherOut = z.object({
+    utc: z.string(),
+    patterns: z.array(patternRow),
+    stationing: z.array(z.object({ body: z.string(), utc: z.string(), direction: z.enum(["retrograde", "direct"]) })),
+    moon_void_of_course: z.boolean(),
+});
 export const OUTPUT_SCHEMAS = {
     natal_chart: chartOut,
     current_sky: chartOut,
@@ -505,6 +563,11 @@ export const OUTPUT_SCHEMAS = {
     dasha: dashaOut,
     vargas: vargasOut,
     yogas: yogasOut,
+    aspect_patterns: patternsOut,
+    chart_signature: signatureOut,
+    similar_skies: similarSkiesOut,
+    electional_search: electionalOut,
+    cosmic_weather: cosmicWeatherOut,
 };
 export function buildServer(engine = defaultEngine(), opts = {}) {
     const version = opts.version ?? VERSION;
@@ -903,7 +966,7 @@ export function buildServer(engine = defaultEngine(), opts = {}) {
         });
     });
     server.registerTool("dignities", {
-        description: "Essential dignity and sect for the seven traditional planets at a moment and place. Per planet: its sign, any essential dignity (domicile/exaltation/detriment/fall), its planetary sect (diurnal/nocturnal, null for Mercury), and whether it is in sect given a day or night chart. The chart is day when the Sun is above the horizon — so lat+lon are required.",
+        description: "Essential dignity and sect for the seven traditional planets at a moment and place. Per planet: its sign, any essential dignity (domicile/exaltation/detriment/fall), its weighted essential-dignity score (Lilly: rulership 5, exaltation 4, triplicity 3, term 2, face 1; detriment -5, fall -4) with a peregrine flag, its planetary sect (diurnal/nocturnal, null for Mercury), and whether it is in sect given a day or night chart. The chart is day when the Sun is above the horizon — so lat+lon are required.",
         inputSchema: { ...birth, zodiac: zodiacSchema },
     }, async ({ date, lat, lon, zodiac }) => {
         const jd = jdFromIso(date);
@@ -911,9 +974,13 @@ export function buildServer(engine = defaultEngine(), opts = {}) {
         const bodies = {};
         for (const b of TRADITIONAL) {
             const lonB = engine.longitude(b, jd, { zodiac });
+            // Weighted essential-dignity score (Lilly) for this planet at its place.
+            const ds = dignityScore(b, lonB, dayChart ? "day" : "night");
             bodies[b] = {
                 sign: SIGNS[Math.floor(lonB / 30)],
                 dignity: dignityOf(engine, b, jd, zodiac),
+                score: ds.total,
+                ...(ds.peregrine ? { peregrine: true } : {}),
                 planetary_sect: planetarySect(b),
                 in_sect: inSect(b, dayChart),
             };
@@ -1179,6 +1246,120 @@ export function buildServer(engine = defaultEngine(), opts = {}) {
             yogakarakas,
         });
     });
+    server.registerTool("aspect_patterns", {
+        description: "Classical aspect configurations in a chart: T-squares, grand trines, grand crosses, yods, kites, mystic rectangles, and stelliums by sign and by house. Each is a structured object with the participating bodies and the worst defining-aspect orb; T-squares and yods also name the apex, stelliums their sign or house. Reported patterns are maximal — a grand cross hides the T-squares it contains, a kite its grand trine. Pure geometry (engine orbs plus a quincunx for yods), no interpretation. Needs date, lat, lon.",
+        inputSchema: { ...birth, house_system: houseSys, zodiac: zodiacSchema },
+    }, async ({ date, lat, lon, house_system, zodiac }) => {
+        const d = new Date(date);
+        if (Number.isNaN(d.getTime()))
+            throw new Error(`Invalid date: ${date}`);
+        const c = engine.chart(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate(), d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds(), lat, lon, { houseSystem: normalizeHouseSystem(house_system), zodiac });
+        return text({
+            utc: date, houses: c.houseSystem,
+            ...(zodiac !== "tropical" ? { zodiac } : {}),
+            patterns: detectPatterns(c),
+        });
+    });
+    server.registerTool("chart_signature", {
+        description: "A chart's structural signature as plain counts: element, modality, angularity, quadrant, and hemisphere distributions over the bodies; the dominant element, modality, and most-occupied sign; and the classical chart ruler (the ruler of the Ascendant's sign). Counts only, no interpretation — a compact summary for emphasis and comparison. Needs date, lat, lon.",
+        inputSchema: { ...birth, house_system: houseSys, zodiac: zodiacSchema },
+    }, async ({ date, lat, lon, house_system, zodiac }) => {
+        const d = new Date(date);
+        if (Number.isNaN(d.getTime()))
+            throw new Error(`Invalid date: ${date}`);
+        const c = engine.chart(d.getUTCFullYear(), d.getUTCMonth() + 1, d.getUTCDate(), d.getUTCHours(), d.getUTCMinutes(), d.getUTCSeconds(), lat, lon, { houseSystem: normalizeHouseSystem(house_system), zodiac });
+        return text({
+            utc: date, houses: c.houseSystem,
+            ...(zodiac !== "tropical" ? { zodiac } : {}),
+            signature: chartSignature(c),
+        });
+    });
+    server.registerTool("similar_skies", {
+        description: "Find when the sky most resembled a reference moment. Builds a feature vector for the reference date's planetary configuration and scans a window for the closest matches by cosine similarity (1.0 = identical configuration). Answers 'when did the sky last look like this?' for transit echoes and historical analogues. Returns the top matches with their similarity, highest first.",
+        inputSchema: {
+            reference_date: z.string().describe("UTC ISO date whose sky is the target to match"),
+            start: z.string().describe("UTC ISO start of the search window"),
+            end: z.string().describe("UTC ISO end of the search window"),
+            step_days: z.number().positive().default(1).describe("sampling step in days (default 1)"),
+            limit: z.number().int().positive().default(10).describe("max matches to return (default 10)"),
+        },
+    }, async ({ reference_date, start, end, step_days, limit }) => {
+        const target = chartFeatures(engine, jdFromIso(reference_date));
+        const matches = searchConfigurations(engine, target, {
+            start: jdFromIso(start), end: jdFromIso(end), step: step_days, limit,
+        });
+        return text({
+            reference_utc: reference_date,
+            matches: matches.map((m) => ({ utc: isoFromJd(m.jd), similarity: Math.round(m.score * 1e4) / 1e4 })),
+        });
+    });
+    server.registerTool("electional_search", {
+        description: "Rank moments in a window for an electional aim. Samples the window and scores each instant by how closely a set of wanted body-to-body aspects is satisfied (tighter and applying aspects score higher), optionally penalizing a void-of-course Moon. Returns the top moments with the aspects that matched. Body-to-body only; for aspects to the angles, compute the chart at a candidate moment.",
+        inputSchema: {
+            start: z.string().describe("UTC ISO start of the window"),
+            end: z.string().describe("UTC ISO end of the window"),
+            wanted: z.array(z.object({
+                a: z.string().describe("first body, snake_case"),
+                b: z.string().describe("second body, snake_case"),
+                aspect: aspectName,
+            })).min(1).describe("aspects to reward when close to exact"),
+            step_hours: z.number().positive().default(6).describe("sampling step in hours (default 6)"),
+            avoid_void_moon: z.boolean().default(false).describe("penalize a void-of-course Moon"),
+            limit: z.number().int().positive().default(10).describe("max moments to return (default 10)"),
+            zodiac: zodiacSchema,
+        },
+    }, async ({ start, end, wanted, step_hours, avoid_void_moon, limit, zodiac }) => {
+        const startJd = jdFromIso(start);
+        const endJd = jdFromIso(end);
+        const stepJd = step_hours / 24;
+        const moments = [];
+        for (let jd = startJd; jd <= endJd + 1e-9; jd += stepJd) {
+            const matched = [];
+            let score = 0;
+            for (const w of wanted) {
+                const m = aspectBetween(engine, w.a, w.b, jd, zodiac);
+                if (m && m.aspect === w.aspect) {
+                    const maxOrb = DEFAULT_ORBS[w.aspect] ?? 6;
+                    const orb = Math.abs(m.orb); // aspectBetween returns a signed orb
+                    const applying = m.phase === "applying";
+                    score += Math.max(0, 1 - orb / maxOrb) + (applying ? 0.3 : 0);
+                    matched.push({ a: w.a, b: w.b, aspect: w.aspect, orb: r2(orb), applying });
+                }
+            }
+            if (avoid_void_moon && voidOfCourse(engine, jd, zodiac).isVoid)
+                score -= 1;
+            if (matched.length > 0)
+                moments.push({ utc: isoFromJd(jd), score: r2(score), matched });
+        }
+        moments.sort((a, b) => b.score - a.score);
+        return text({ start, end, moments: moments.slice(0, limit) });
+    });
+    server.registerTool("cosmic_weather", {
+        description: "The mundane sky on a date: the active aspect configurations among the transiting planets (T-squares, grand trines, grand crosses, yods, kites, mystic rectangles, stelliums by sign), any planet stationing within a window, and whether the Moon is void of course. A 'cosmic weather' snapshot; no birth chart or location needed.",
+        inputSchema: {
+            date: z.string().describe("UTC ISO date"),
+            window_days: z.number().positive().default(7).describe("days either side to scan for stations (default 7)"),
+            zodiac: zodiacSchema,
+        },
+    }, async ({ date, window_days, zodiac }) => {
+        const jd = jdFromIso(date);
+        const bodies = {};
+        for (const b of BODIES)
+            bodies[b] = { lon: engine.longitude(b, jd, { zodiac }) };
+        const stationing = [];
+        for (const b of ["mercury", "venus", "mars", "jupiter", "saturn", "uranus", "neptune", "pluto"]) {
+            for (const [sjd, direction] of stations(engine, b, jd - window_days, jd + window_days, 2)) {
+                stationing.push({ body: b, utc: isoFromJd(sjd), direction });
+            }
+        }
+        stationing.sort((x, y) => (x.utc < y.utc ? -1 : 1));
+        return text({
+            utc: date,
+            patterns: detectPatternsIn(bodies),
+            stationing,
+            moon_void_of_course: voidOfCourse(engine, jd, zodiac).isVoid,
+        });
+    });
     // --------------------------------------------------------- resources
     // Chart wheel widget (MCP Apps / Apps SDK). The CSP allowlists the embed
     // origin only for loading the widget script (resourceDomains) — no
@@ -1259,6 +1440,16 @@ if (isMain) {
         const server = buildServer();
         const transport = new StdioServerTransport();
         await server.connect(transport);
-        console.error("caelus-mcp listening on stdio");
+        // Caelus under the velificatio, in stderr's ASCII. stdout is the protocol
+        // channel, so the banner goes to stderr where hosts collect logs.
+        const arch = String.raw `
+       .-~~~~~-.
+     .'  *  .   '.
+    /  ( o   o )  \
+   |       >       |
+    \    \___/    /
+     '.         .'
+       '-_____-'`;
+        console.error(`${arch}\n   caelus-mcp v${VERSION} · western + vedic ephemeris · MIT\n   listening on stdio\n`);
     })();
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "caelus-mcp",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "mcpName": "io.github.heavyblotto/caelus-mcp",
   "description": "MCP server for caelus chart computation.",
   "type": "module",
@@ -15,7 +15,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.26.0",
     "zod": "^3.24.0",
-    "caelus": "^0.15.0"
+    "caelus": "^0.16.0"
   },
   "devDependencies": {
     "ajv": "^8.17.1"