@zodic/shared 0.0.249 → 0.0.251

package/db/migrations/meta/_journal.json

@@ -22,6 +22,13 @@
       "when": 1740175232182,
       "tag": "0002_reflective_firelord",
       "breakpoints": true
+    },
+    {
+      "idx": 3,
+      "version": "6",
+      "when": 1740256286190,
+      "tag": "0003_thin_valeria_richards",
+      "breakpoints": true
     }
   ]
 }

package/db/schema.ts

@@ -189,8 +189,10 @@ export const astroReports = sqliteTable(
     name: text('name').notNull(), // Slug (e.g., 'sun', 'pars_fortuna')
     sign: text('sign'), // Slug (e.g., 'aries', 'taurus') - nullable for house-only reports
     house: integer('house'), // Nullable, only for applicable placements
-    enDescription: text('en_description'), // General explanation of the placement
-    ptDescription: text('pt_description'),
+    descriptionTemplateId: text('description_template_id').references(
+      () => astroDescriptionTemplates.id,
+      { onDelete: 'set null' }
+    ), // NEW: Foreign key to astro_description_templates.id
     enReport: text('en_report'), // Full report content in English
     ptReport: text('pt_report'), // Full report content in Portuguese
     createdAt: integer('created_at').default(sql`CURRENT_TIMESTAMP`),
@@ -209,8 +211,10 @@ export const houseReports = sqliteTable(
     id: text('id').primaryKey(), // Unique identifier
     sign: text('sign').notNull(), // Lowercase slug (e.g., 'aries', 'taurus')
     house: integer('house').notNull(), // House placement (1-12)
-    enDescription: text('en_description'), // General explanation of the sign in a house
-    ptDescription: text('pt_description'),
+    descriptionTemplateId: text('description_template_id').references(
+      () => astroDescriptionTemplates.id,
+      { onDelete: 'set null' }
+    ), // NEW: Foreign key to astro_description_templates.id
     enReport: text('en_report'), // Full report content in English
     ptReport: text('pt_report'), // Full report content in Portuguese
     createdAt: integer('created_at').default(sql`CURRENT_TIMESTAMP`),
@@ -218,6 +222,7 @@ export const houseReports = sqliteTable(
   },
   (t) => [
     index('house_reports_sign_house_idx').on(t.sign, t.house), // Optimized index for sign + house lookups
+    index('house_reports_description_template_idx').on(t.descriptionTemplateId), // NEW: Index for foreign key performance
   ]
 );
 
@@ -228,8 +233,10 @@ export const aspectReports = sqliteTable(
     aspectingPlanet: text('aspecting_planet').notNull(), // Planet/point initiating the aspect (e.g., 'sun', 'mars')
     aspectedPlanet: text('aspected_planet').notNull(), // Planet/point receiving the aspect (e.g., 'moon', 'venus')
     aspect: text('aspect').notNull(), // Aspect type ('conjunction', 'trine', 'square', etc.)
-    enDescription: text('en_description'), // General explanation of the aspect
-    ptDescription: text('pt_description'),
+    descriptionTemplateId: text('description_template_id').references(
+      () => astroDescriptionTemplates.id,
+      { onDelete: 'set null' }
+    ), // NEW: Foreign key to astro_description_templates.id
     enReport: text('en_report'), // Full report content in English
     ptReport: text('pt_report'), // Full report content in Portuguese
     createdAt: integer('created_at').default(sql`CURRENT_TIMESTAMP`),
@@ -239,11 +246,8 @@ export const aspectReports = sqliteTable(
     index('aspect_reports_aspecting_idx').on(t.aspectingPlanet),
     index('aspect_reports_aspected_idx').on(t.aspectedPlanet),
     index('aspect_reports_aspect_idx').on(t.aspect),
-    index('aspect_reports_combined_idx').on(
-      t.aspectingPlanet,
-      t.aspectedPlanet,
-      t.aspect
-    ), // Optimized for aspect lookups
+    index('aspect_reports_combined_idx').on(t.aspectingPlanet, t.aspectedPlanet, t.aspect),
+    index('aspect_reports_description_template_idx').on(t.descriptionTemplateId), // NEW: Index for foreign key performance
   ]
 );
 
@@ -251,17 +255,38 @@ export const astroFeatureReports = sqliteTable(
   'astro_feature_reports',
   {
     id: text('id').primaryKey(), // Unique identifier
-    featureType: text('feature_type').notNull(), // e.g., "moon_phase", "element", "mode", "hemisphere_east_west", "hemisphere_north_south", "dominant_sign"
-    name: text('name').notNull(), // e.g., "last-quarter-moon", "fire", "cardinal", "east-west", "north-south", "capricorn"
-    enDescription: text('en_description'), // Introductory text in English
-    ptDescription: text('pt_description'), // Introductory text in Portuguese
+    featureType: text('feature_type').notNull(), // e.g., "moon_phase", "element", "mode", "hemisphere_east_west", "hemisphere_north_south"
+    name: text('name').notNull(), // e.g., "last-quarter-moon", "fire", "cardinal", "east", "north"
+    descriptionTemplateId: text('description_template_id').references(
+      () => astroDescriptionTemplates.id,
+      { onDelete: 'set null' }
+    ), // NEW: Foreign key to astro_description_templates.id
     enReport: text('en_report'), // Full report content in English (JSON string)
     ptReport: text('pt_report'), // Full report content in Portuguese (JSON string)
     createdAt: integer('created_at').default(sql`CURRENT_TIMESTAMP`),
     updatedAt: integer('updated_at').default(sql`CURRENT_TIMESTAMP`),
   },
   (t) => [
-    index('astro_feature_reports_type_name_idx').on(t.featureType, t.name), // Optimized for lookups by type and name
+    index('astro_feature_reports_type_name_idx').on(t.featureType, t.name),
+    index('astro_feature_reports_description_template_idx').on(t.descriptionTemplateId), // NEW: Index for foreign key performance
+  ]
+);
+
+export const astroDescriptionTemplates = sqliteTable(
+  'astro_description_templates',
+  {
+    id: text('id').primaryKey(), // Unique identifier
+    entityType: text('entity_type').notNull(), // e.g., "planet", "key_point", "karmic_point", "arabic_part", "house", "aspect", "moon_phase", "element", "mode", "hemisphere_east_west", "hemisphere_north_south"
+    name: text('name').notNull(), // Slug (e.g., "last-quarter-moon", "fire", "cardinal", "east", "house_1")
+    enName: text('en_name'), // Optional human-readable name in English (e.g., "Last Quarter Moon", "Fire")
+    ptName: text('pt_name'), // Optional human-readable name in Portuguese (e.g., "Lua Minguante", "Fogo")
+    enDescription: text('en_description').notNull(), // Shared 150–180 word intro in English
+    ptDescription: text('pt_description').notNull(), // Shared 150–180 word intro in Portuguese
+    createdAt: integer('created_at').default(sql`CURRENT_TIMESTAMP`),
+    updatedAt: integer('updated_at').default(sql`CURRENT_TIMESTAMP`),
+  },
+  (t) => [
+    index('astro_description_templates_type_name_idx').on(t.entityType, t.name), // Optimized for lookups by type and slug
   ]
 );
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zodic/shared",
-  "version": "0.0.249",
+  "version": "0.0.251",
   "module": "index.ts",
   "type": "module",
   "publishConfig": {

package/types/scopes/generic.ts

@@ -45,6 +45,31 @@ export interface AstrologicalReport {
   sections: Record<string, ContentItem[]>;
 }
 
+export interface AstroReportRow {
+  id: string;
+  type?: string; // For astroReports
+  name?: string;
+  sign?: string;
+  house?: number;
+  featureType?: string; // For astroFeatureReports
+  enReport: string | null;
+  ptReport: string | null;
+  enDescription?: string | null;
+  ptDescription?: string | null;
+  createdAt: number | null;
+  updatedAt: number | null;
+}
+
+export interface DescriptionTemplateRow {
+  id: string;
+  entityType: string;
+  name: string;
+  enDescription: string | null;
+  ptDescription: string | null;
+  createdAt: number | null;
+  updatedAt: number | null;
+}
+
 export type AstroReportParams =
   | {
       reportType: 'sign';

package/utils/astroPrompts/index.ts

@@ -49,6 +49,12 @@ interface AspectParams {
   aspectingType: AspectType;
 }
 
+interface DescriptionParams {
+  entityType: string;
+  name: string;
+  isGeneric?: boolean; // Flag for generic descriptions (aspects, moon phases, elements, modes, hemispheres)
+}
+
 export const astroPrompts = {
   planetOrPoint: ({ type, sign, pointName }: PlanetOrPointParams): string => {
     const validTypes = ['planet', 'key_point', 'karmic_point', 'arabic_part'];
@@ -224,4 +230,24 @@ export const astroPrompts = {
         throw new Error(`Unknown feature type in params: ${params}`);
     }
   },
+
+  makeIntroDescription: ({ entityType, name, isGeneric }: DescriptionParams): string => {
+    const baseFormat = `
+      Make me an introductory, explanatory description of 150 to 180 words about the astrological ${entityType}.
+      The result must have an English version and a Portuguese version.
+      The result format must be exactly like the following:
+      -- EN
+      [Single block of plain text with English version]
+      -- PT
+      [Single block of plain text with Portuguese version]
+    `.trim();
+
+    if (isGeneric) {
+      return `
+        ${baseFormat.replace("astrological", "astrological concept representing").replace("about the astrological", "about what the")}
+      `.trim();
+    } else {
+      return `${baseFormat} ${name ? `named ${name}.` : ""}`.trim();
+    }
+  },
 };