djedi/numerology
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Add comprehensive numerology calculator with 10 specialized tools

Browse source 
- Core calculations (Life Path, Expression, Soul Urge, Birthday)
- Advanced numbers (Maturity, Personality, Hidden Passion, Karmic Lessons)
- Timing cycles and optimal days finder
- Compatibility analysis and name optimizer
- Telos integration for personal development
- Professional PDF report generation
- Profile management system
- Security fix: Add .claude/ to .gitignore

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
rpriven 2025-11-01 14:00:15 -06:00
parent 06928cd605
commit fd6e171586
Signed by: djedi
GPG key ID: D04DED574622EF45
32 changed files with 10865 additions and 41 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

40
.gitignore vendored Normal file
View file

@ -0,0 +1,40 @@
# Generated PDF reports
*.pdf
# LaTeX build artifacts
*.aux
*.log
*.toc
*.out
*.synctex.gz
# Test/temp output files
test-output.md
*-output.md
# Node modules (if ever added)
node_modules/
# Bun lock file (optional - some prefer to commit this)
bun.lockb
# User profiles (private data)
# Note: Profiles are stored in ~/.numerology/profiles/ outside the repo
# Claude Code directory (contains local settings)
.claude/
# macOS
.DS_Store
# IDE
.vscode/
.idea/
*.swp
*.swo
*~
# Temp files
tmp/
temp/
*.tmp

405
CYCLES-DOCUMENTATION.md Normal file
View file

@ -0,0 +1,405 @@
# Numerology Timing Cycles - Complete Documentation
## 🌟 Overview
The timing cycles system calculates your personal energy patterns and universal (global) energy to help you plan activities, make decisions, and align your actions with natural rhythms.
## 📊 The Layered Cycle System
### 1. Universal Cycles (Global Energy)
Calculated from the current calendar date. Affects everyone on the planet.
- **Universal Year** - The overarching theme for the entire year globally
- **Universal Month** - Global monthly energy within the year
- **Universal Day** - The collective daily energy
### 2. Personal Cycles (Your Individual Energy)
Calculated from your birthdate + current date. Unique to you.
- **Personal Year** - Your major theme for the year (9-year cycle)
- **Personal Month** - Your monthly focus within your yearly theme
- **Personal Day** - Your daily energy and optimal activities
### 3. Combined Interpretation
Your personal cycles operate WITHIN universal cycles, creating a layered understanding of timing and energy.
**Example:**
- **Personal Year 5** (Change/Freedom) within **Universal Year 8** (Power/Achievement)
- This means: You're seeking freedom and change while the world focuses on power structures
- Strategy: Use global power structures to create personal freedom
## 🔢 The Pythagorean Math
### Why Pythagorean is "Easier"
The Pythagorean system uses **sequential reduction with modular calculation**:
1. **Reduce each component separately**
2. **Combine the reduced components**
3. **Reduce the final result**
4. **Check for master numbers (11, 22, 33) at each step**
### Calculation Formulas
#### Universal Cycles
```typescript
Universal Year = Reduce(Current Year)
Example: 2025 → 2+0+2+5 = 9
Universal Month = Reduce(Universal Year + Current Month)
Example: Year 9 + October (10→1) = 9+1 = 10 → 1
Universal Day = Reduce(Universal Month + Current Day)
Example: Month 1 + 13th = 1+4 = 5
```
#### Personal Cycles
```typescript
Personal Year = Reduce(Birth Month + Birth Day + Current Year)
Example: Born 5/13, Year 2025
5 + (1+3=4) + (2+0+2+5=9) = 18 → 9
Personal Month = Reduce(Personal Year + Current Month)
Example: PY 9 + October (10→1) = 10 → 1
Personal Day = Reduce(Personal Month + Current Day)
Example: PM 1 + 13th (1+3=4) = 5
```
### Master Number Rules
**Master numbers (11, 22, 33) are NOT reduced further.**
They appear when:
- A sum equals exactly 11, 22, or 33
- They represent heightened spiritual energy
- They carry both the master number meaning AND the reduced meaning
Example:
- Life Path 11 = 11 (master) + 2 (1+1) energy combined
- Personal Year 22 = 22 (master builder) + 4 (2+2) foundation energy
## 📅 The 9-Year Personal Year Cycle
Your life operates in repeating 9-year cycles. Each year has a specific theme and energy.
### Year-by-Year Breakdown
**Year 1 - New Beginnings**
- Plant seeds for new 9-year cycle
- Start fresh projects, relationships, ventures
- Be bold and independent
- Best for: Starting businesses, moving, career changes
**Year 2 - Patience & Cooperation**
- Nurture what was planted
- Build partnerships
- Focus on details
- Best for: Marriage, collaborations, developing relationships
**Year 3 - Expression & Creativity**
- Creative projects bloom
- Social life expands
- Express yourself fully
- Best for: Creative projects, public speaking, networking
**Year 4 - Hard Work & Foundation**
- Build solid foundations
- Work hard, get organized
- Create lasting structures
- Best for: Buying property, fitness goals, financial planning
**Year 5 - Change & Freedom**
- Major life changes possible
- Travel and explore
- Break free from limitations
- Best for: Travel, moving, changing careers, exploration
**Year 6 - Responsibility & Service**
- Focus on home and family
- Take on responsibilities
- Serve others
- Best for: Marriage, having children, home improvements, teaching
**Year 7 - Introspection & Spirituality**
- Turn inward
- Spiritual growth emphasized
- Rest and analyze
- Best for: Spiritual retreats, therapy, research, sabbaticals
**Year 8 - Achievement & Power**
- Harvest time!
- Financial rewards possible
- Career advancement
- Best for: Business expansion, promotions, real estate, authority roles
**Year 9 - Completion & Release**
- End of 9-year cycle
- Let go of what's finished
- Clear space for new cycle
- Best for: Ending relationships, selling property, clearing clutter
**Master Years (11, 22, 33)**
- Heightened spiritual energy
- Greater responsibility
- Opportunities for significant impact
- Can be challenging due to intensity
## 🎯 Practical Applications
### Weekly Planning
Use Personal Days to plan your week:
**Monday - Personal Day 1:**
- Start new projects
- Take initiative
- Be independent
**Tuesday - Personal Day 2:**
- Collaborate with others
- Handle details
- Be diplomatic
**Wednesday - Personal Day 3:**
- Creative work
- Socialize
- Communicate ideas
**Thursday - Personal Day 4:**
- Organize and work hard
- Build foundations
- Be practical
**Friday - Personal Day 5:**
- Be flexible
- Try new approaches
- Embrace variety
**Saturday - Personal Day 6:**
- Family time
- Home projects
- Help others
**Sunday - Personal Day 7:**
- Rest and reflect
- Spiritual practice
- Study
### Monthly Planning
Use Personal Months to plan your month:
**Month 1:** Start new initiatives
**Month 2:** Build partnerships, handle details
**Month 3:** Launch creative projects, socialize
**Month 4:** Work hard, organize, build
**Month 5:** Make changes, travel, explore
**Month 6:** Focus on home/family, take responsibility
**Month 7:** Rest, study, spiritual focus
**Month 8:** Push for achievement, handle business
**Month 9:** Complete projects, clear clutter
### Yearly Planning
Use Personal Year to plan major decisions:
**Planning to start a business?** → Wait for Personal Year 1 or 8
**Planning to get married?** → Personal Year 2 or 6 ideal
**Planning major travel?** → Personal Year 5 perfect
**Need to rest and recharge?** → Personal Year 7 necessary
**Want to complete old projects?** → Personal Year 9 is completion time
## 🔮 Advanced Applications
### Finding Optimal Days
Want to know which days this month are best for specific activities?
**Looking for Personal Day 1 days (new beginnings):**
```bash
bun cycles.ts find-optimal --birthdate "5/13/1982" --month 10 --year 2025 --number 1
```
**Result:** Days 13, 22, 31 are Personal Day 1 in October 2025
→ Schedule important meetings, launches, or first steps on these days
### Year-Ahead Planning
Generate your entire year's Personal Month cycle:
```bash
bun cycles.ts year-ahead --birthdate "5/13/1982" --year 2025
```
**Use this to:**
- Schedule major events in optimal months
- Know when to push (Month 1, 8) vs rest (Month 7, 9)
- Plan travel for Month 5
- Schedule family events in Month 6
### Relationship Compatibility Timing
Compare two people's cycles to find optimal collaboration times:
**When both people are in complementary cycles:**
- Person A in Personal Year 1 (pioneering) + Person B in Personal Year 2 (supporting) = Great partnership potential
- Person A in Personal Year 5 (change) + Person B in Personal Year 4 (stability) = Potential conflict or balance
## 🎯 Telos Integration (Advanced)
### Aligning Goals with Cycles
**The Power of Alignment:**
When your telos goals align with your current cycles, success comes more easily.
**Example Alignments:**
**Personal Year 1 + Career Change Goal:**
✅ PERFECT ALIGNMENT - Year 1 is for new beginnings
→ Take bold action, make the change
**Personal Year 7 + Certification Study Goal:**
✅ PERFECT ALIGNMENT - Year 7 is for deep study
→ This is your year to go deep into learning
**Personal Year 9 + Starting New Business:**
❌ MISALIGNMENT - Year 9 is for endings, not beginnings
→ Wait for next year (Personal Year 1)
### Weekly Goal Planning
Match your weekly tasks to your Personal Days:
**Your Weekly Telos Tasks:**
- Write blog post (Creative - Day 3)
- Client meeting (Cooperation - Day 2)
- Strategic planning (Achievement - Day 8)
- Deep research (Introspection - Day 7)
- Start new project (Initiation - Day 1)
**Optimal Schedule:**
- Monday (Day 1): Start new project
- Tuesday (Day 2): Client meeting
- Wednesday (Day 3): Write blog post
- Thursday (Day 7): Deep research
- Friday (Day 8): Strategic planning
## 🛠️ Command Reference
### Basic Usage
```bash
# Show today's cycles
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles
# Show cycles for specific date
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles --date "12/25/2025"
# Show chart + cycles
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --detailed --cycles
# Export to markdown
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles --format markdown > cycles-report.md
```
### Advanced Usage (Coming Soon)
```bash
# Weekly planner
bun telos-week.ts --birthdate "mm/dd/yyyy"
# Analyze goal-cycle alignment
bun telos-cycles-analyze.ts
# Find optimal days for activity
bun cycles.ts find-optimal --birthdate "mm/dd/yyyy" --month 11 --year 2025 --number 8
# Year-ahead cycle calendar
bun cycles.ts year-ahead --birthdate "mm/dd/yyyy" --year 2025
```
## 📚 Interpretation Guidelines
### Reading Your Cycles
1. **Start with Personal Year** - This is your overarching theme
2. **Add Personal Month context** - How the year's energy manifests this month
3. **Use Personal Day for daily decisions** - Tactical timing
4. **Consider Universal cycles** - The collective backdrop
### When Cycles Conflict
Sometimes your Personal cycle conflicts with Universal cycle or your goals:
**Personal Year 7 (rest) in Universal Year 8 (achievement):**
- The world pushes for achievement while you need rest
- Strategy: Take strategic rest to prepare for your Personal Year 8 next year
**Personal Day 7 (introspection) but urgent deadline:**
- Honor both: Do the work but minimize meetings and external focus
- Schedule deep work, avoid starting new things
### Master Number Years
**Personal Year 11, 22, or 33:**
- Heightened responsibility and opportunity
- More intense than regular years
- Potential for significant spiritual growth
- Can be overwhelming - extra self-care needed
- Greater impact on others possible
**If you're in a Master Year:**
- Trust your intuition more
- Expect big opportunities
- Practice nervous system regulation
- Don't force - allow things to flow
- Serve others from overflow, not depletion
## 🎓 Learning Numerology Cycles
### Beginner Level
1. Calculate your current Personal Year
2. Read the year's theme
3. Notice how it manifests in your life
### Intermediate Level
1. Track your Personal Month themes
2. Plan major decisions based on yearly cycles
3. Use Personal Days for weekly planning
### Advanced Level
1. Combine with telos goal planning
2. Analyze multi-year patterns
3. Use for relationship and business timing
4. Teach others about their cycles
## 📖 Recommended Reading
**Books:**
- "Numerology: The Complete Guide, Vol 1 & 2" by Matthew Oliver Goodwin
- "The Complete Book of Numerology" by David A. Phillips
- "Numerology and the Divine Triangle" by Faith Javane
**Practice:**
- Track your cycles for 3 months
- Note alignments and conflicts
- Adjust planning based on cycles
- Share insights with friends
## 🚀 Future Enhancements
**Planned Features:**
1. **Telos-Cycles Integration** - Auto-analyze goal alignment
2. **Weekly Planner** - Personal Day calendar with task suggestions
3. **Compatibility Analysis** - Compare two people's cycles
4. **Life Stages/Pinnacles** - Long-term cycle predictions
5. **Challenge Numbers** - Karmic lessons and obstacles
6. **Optimal Days Finder** - Find best days for specific activities
---
**Remember:** Numerology is a tool for understanding energy and timing, not fate. You always have free will. Use cycles as guidance, not rigid rules.
**The key insight:** Working WITH your natural rhythms makes life easier. Fighting against them creates unnecessary struggle.

150
PROFILE-HELPER-USAGE.md Normal file
View file

@ -0,0 +1,150 @@
# Profile Helper Usage Guide
## Quick Integration
To add profile support to any numerology tool, use the `profile-helper.ts` utility.
## Example: Before & After
### Before (without profile support)
```typescript
// Parse arguments
let name = '';
let birthdate = '';
for (let i = 0; i < args.length; i++) {
if (args[i] === '--name' && args[i + 1]) {
name = args[i + 1];
i++;
} else if (args[i] === '--birthdate' && args[i + 1]) {
birthdate = args[i + 1];
i++;
}
}
if (!name || !birthdate) {
console.error('Error: Both --name and --birthdate are required');
process.exit(1);
}
```
### After (with profile support)
```typescript
import { parseProfileOrDirect } from './profile-helper';
// Parse arguments - automatically handles --profile or --name/--birthdate
const { name, birthdate } = parseProfileOrDirect(args, {
toolName: 'optimal-days',
requiresBirthdate: true,
requiresName: false
});
```
That's it! Just 3 lines instead of 20+.
## Features
✅ Automatically handles `--profile` or `--name`/`--birthdate`
✅ Loads profile from storage
✅ Validates required fields
✅ Provides helpful error messages
✅ Consistent behavior across all tools
## Configuration Options
```typescript
interface ParseOptions {
toolName: string; // For error messages
requiresBirthdate?: boolean; // Default: true
requiresName?: boolean; // Default: true
}
```
## Real-World Example
Here's how to retrofit an existing tool:
```typescript
#!/usr/bin/env bun
import { parseProfileOrDirect } from './profile-helper';
const args = process.argv.slice(2);
// Old way (20+ lines):
// let name = '';
// let birthdate = '';
// for (let i = 0; i < args.length; i++) {
// if (args[i] === '--name' && args[i + 1]) { ... }
// if (args[i] === '--birthdate' && args[i + 1]) { ... }
// }
// if (!name || !birthdate) { ... }
// New way (1 line):
const { name, birthdate } = parseProfileOrDirect(args, {
toolName: 'advanced-numbers'
});
// Rest of your tool logic...
console.log(`Calculating for ${name} (${birthdate})`);
```
## Tools to Update
The following tools can be retrofitted:
- [ ] `advanced-numbers.ts`
- [ ] `compatibility.ts` (person1 only)
- [ ] `cycles-week.ts`
- [ ] `name-change.ts`
- [ ] `name-optimizer.ts`
- [ ] `optimal-days.ts`
- [ ] `pinnacles.ts`
- [ ] `telos-cycles-analyze.ts`
- [ ] `telos-export.ts`
- [ ] `telos-week.ts`
- [ ] `year-ahead.ts`
## Help Text Integration
Use `addProfileToHelp()` to automatically update help text:
```typescript
import { addProfileToHelp } from './profile-helper';
const helpText = `
USAGE:
bun tool.ts --name "..." --birthdate "..." [OPTIONS]
OPTIONS:
--name NAME Full name [required]
--birthdate DATE Birthdate [required]
`;
// Automatically adds --profile option and updates [required] text
console.log(addProfileToHelp(helpText));
```
Output:
```
USAGE:
bun tool.ts --name "..." --birthdate "..." [OPTIONS]
OPTIONS:
-p, --profile ID Use saved profile
--name NAME Full name [required if no profile]
--birthdate DATE Birthdate [required if no profile]
```
## Benefits
1. **DRY** - Don't repeat profile loading code
2. **Consistent** - Same behavior everywhere
3. **Maintainable** - Update once, fixes everywhere
4. **Simple** - 1-3 lines vs 20+ lines
5. **Type-safe** - TypeScript interfaces
## Next Steps
Tools can be updated individually as-needed, or all at once. The helper is ready to use!

304
PROFILE-SYSTEM.md Normal file
View file

@ -0,0 +1,304 @@
# Profile Management System
## Overview
The profile management system allows you to save your numerology data (name and birthdate) once and reuse it across all numerology tools. No more typing `--name "..." --birthdate "..."` every time!
## Features
- **Create profiles** with auto-generated or custom identifiers
- **List all profiles** to see what's saved
- **Show profile details** including creation/update dates
- **Delete profiles** when no longer needed
- **Use profiles everywhere** across all 10+ numerology tools
## Storage
Profiles are stored in JSON format at:
```
~/.numerology/profiles/<identifier>.json
```
Each profile contains:
```json
{
"name": "John Smith",
"birthdate": "3/15/1990",
"created": "2025-10-15T12:27:34.567Z",
"updated": "2025-10-15T12:27:34.567Z"
}
```
## Commands
### Create a Profile
```bash
# Auto-generate identifier from first name
bun profile.ts create --name "John Smith" --birthdate "3/15/1990"
# → Creates profile 'john'
# Custom identifier
bun profile.ts create johns --name "John Smith" --birthdate "3/15/1990"
# Update existing profile (same command)
bun profile.ts create rob --name "John Smith" --birthdate "3/15/1990"
```
**Options:**
- `--name, -n NAME` - Full name (required)
- `--birthdate, -b DATE` - Birthdate in mm/dd/yyyy format (required)
### List Profiles
```bash
bun profile.ts list
```
Shows all saved profiles with:
- Identifier
- Name
- Birthdate
- Creation date
### Show Profile Details
```bash
bun profile.ts show rob
```
Shows detailed information:
- Name
- Birthdate
- Created timestamp
- Updated timestamp
### Delete Profile
```bash
bun profile.ts delete rob
```
Permanently removes the profile from storage.
## Using Profiles
Once created, use `--profile` (or `-p`) flag with any numerology tool:
### Main Calculator
```bash
# Basic calculation
bun numerology.ts --profile john
# With detailed meanings
bun numerology.ts --profile john --detailed
# With advanced numbers
bun numerology.ts --profile john --advanced
# With timing cycles
bun numerology.ts --profile john --cycles
# All together
bun numerology.ts --profile john --detailed --advanced --cycles
```
### PDF Report Generator
```bash
# Generate comprehensive PDF report
bun generate-report.ts --profile john
# Custom output location
bun generate-report.ts --profile john --output ~/reports/rob-numerology.pdf
```
### Other Tools
```bash
# Compatibility analysis
bun compatibility.ts --profile john --person2 "Jane:1/1/1990"
# Optimal days finder
bun optimal-days.ts --profile john --day 1
# Year-ahead calendar
bun year-ahead.ts --profile john
# Pinnacles & life stages
bun pinnacles.ts --profile john
# Advanced numbers
bun advanced-numbers.ts --profile john --detailed
# Name change analysis (current name loaded from profile)
bun name-change.ts --profile john --alternative "John Smith"
# Name optimizer (base name loaded from profile)
bun name-optimizer.ts --profile john --find-masters
```
## Use Cases
### Personal Use
Save your own profile and quickly run any calculation:
```bash
bun profile.ts create --name "Your Name" --birthdate "mm/dd/yyyy"
bun numerology.ts --profile yourname --detailed --advanced --cycles
```
### Family Profiles
Store profiles for family members:
```bash
bun profile.ts create --name "Partner Name" --birthdate "mm/dd/yyyy"
bun profile.ts create --name "Child Name" --birthdate "mm/dd/yyyy"
# Compare compatibility
bun compatibility.ts --profile partner1 --profile partner2
```
### Professional/Client Use
Numerology practitioners can store client profiles:
```bash
# Create client profiles
bun profile.ts create client1 --name "Client Name" --birthdate "mm/dd/yyyy"
# Generate professional reports
bun generate-report.ts --profile client1 --output ~/clients/client1-report.pdf
```
### Multiple Profiles
Test different scenarios with saved profiles:
```bash
# Create variations
bun profile.ts create john-legal --name "John Smith" --birthdate "3/15/1990"
bun profile.ts create john-nick --name "John Smith" --birthdate "3/15/1990"
# Compare
bun numerology.ts --profile john-legal --detailed
bun numerology.ts --profile john-nick --detailed
```
## Architecture
### File Structure
```
profile-manager.ts # Core CRUD operations
profile.ts # CLI interface
~/.numerology/
└── profiles/
├── rob.json
├── jane.json
└── ...
```
### API Functions
From `profile-manager.ts`:
```typescript
// Save or update a profile
saveProfile(identifier: string, name: string, birthdate: string): void
// Load a profile
loadProfile(identifier: string): Profile | null
// List all profiles
listProfiles(): Array<{ identifier: string; profile: Profile }>
// Delete a profile
deleteProfile(identifier: string): boolean
// Check if profile exists
profileExists(identifier: string): boolean
// Generate identifier from name
generateIdentifier(name: string): string
```
### Profile Interface
```typescript
interface Profile {
name: string;
birthdate: string;
created: string; // ISO 8601 timestamp
updated: string; // ISO 8601 timestamp
}
```
## Implementation Details
### Identifier Generation
Auto-generated identifiers:
- Extract first name from full name
- Convert to lowercase
- Remove non-alphanumeric characters
Example: "John Smith" → "rob"
### File Naming
Profile files use sanitized identifiers:
- Lowercase
- Replace invalid characters with hyphens
- Only `a-z`, `0-9`, `-`, `_` allowed
Example: "Rob's Profile" → `robs-profile.json`
### Timestamp Tracking
- `created` - Never changes, set on first save
- `updated` - Updates every time profile is modified
### Error Handling
- Profile not found → Helpful error message with suggestion to list profiles
- Invalid data → Validation errors with clear instructions
- File system errors → Caught and reported gracefully
## Future Enhancements
Potential additions to the profile system:
1. **Profile metadata** - Add notes, tags, or categories
2. **Import/export** - Share profiles or backup to file
3. **Profile groups** - Organize profiles by family, clients, etc.
4. **Search** - Find profiles by name or birthdate pattern
5. **Aliases** - Multiple identifiers for same profile
6. **Defaults** - Set default profile for quick access
7. **Cloud sync** - Sync profiles across devices
8. **History** - Track calculation history per profile
## Benefits
✅ **Convenience** - Type once, use everywhere
✅ **Consistency** - Same data across all tools
✅ **Speed** - Faster workflow for repeated calculations
✅ **Organization** - Manage multiple people systematically
✅ **Professional** - Clean interface for client work
✅ **Portable** - Simple JSON format, easy to backup
## Compatibility
Works with all numerology tools:
- ✅ numerology.ts (main calculator)
- ✅ generate-report.ts (PDF reports)
- ✅ optimal-days.ts
- ✅ pinnacles.ts
- ✅ compatibility.ts
- ✅ year-ahead.ts
- ✅ advanced-numbers.ts
- ✅ name-change.ts
- ✅ name-optimizer.ts
- ✅ telos-week.ts
- ✅ And more...
---
**Status:** ✅ Fully Implemented (Phase 6)
**Version:** 1.0
**Date:** October 15, 2025

670
README.md
View file

@ -1,54 +1,668 @@
# Numerology Script
# Numerology Calculator
This is a Python script for calculating numerology values such as Life Path, Expression, Soul Urge, and Birthday based on a person's name and date of birth. The script also provides detailed meanings for each numerology value.
A comprehensive TypeScript-based numerology calculator with **10 specialized tools** for deep numerological analysis. Calculate core numbers, find optimal days, analyze relationships, optimize names for master numbers, and integrate with the Telos personal development framework.
**Built with Bun + TypeScript. Zero dependencies. Professional-grade calculations and interpretations.**
## Features
- Calculate Life Path, Expression, Soul Urge, and Birthday numbers
- Detect and handle master numbers (11, 22, 33)
- Provide detailed meanings for each numerology value
- User-friendly input validation
- Colorful and formatted terminal output using `colorama`
### Core Calculations
- **Life Path Number** - Your life's purpose and journey
- **Expression Number** - Your natural talents and abilities
- **Soul Urge Number** - Your inner desires and motivations
- **Birthday Number** - Special gifts from your birth day
- **Advanced Numbers** - Maturity, Personality, Hidden Passion, Karmic Lessons, Balance
- **Master Number Detection** - Automatically identifies 11, 22, and 33
### Timing & Cycles
- **Personal Cycles** - Year/Month/Day calculations for strategic planning
- **Universal Cycles** - Current world energy influences
- **Optimal Days Finder** - Find best days for launches, creative work, business deals
- **Year-Ahead Calendar** - 12-month Personal Month preview
- **Life Pinnacles** - 4 major life stages with challenge numbers
### Analysis Tools
- **Compatibility Analysis** - Compare charts for romantic, business, family, or friendship relationships
- **Name Change Analyzer** - Test how nicknames, stage names, or married names shift your energy
- **Name Optimizer** 🔮 - "Rainbow tables" for finding master number variations (90+ name tests)
- **Telos Integration** - Weekly planner aligning personal goals with daily numerology energy
### Output & Formats
- **Multiple Output Formats** - Terminal (with colors), Markdown, JSON
- **Detailed Interpretations** - Comprehensive meanings for every number
- **Professional Reports** - Ready for clients or personal deep-dive analysis
## Core Numbers Explained
### Life Path Number
Calculated from your complete birthdate (month + day + year), this is your primary number representing your life's purpose, the path you're meant to walk, and the lessons you're here to learn.
### Expression Number
Calculated from your full name, this represents your natural talents, abilities, and the tools you have to fulfill your Life Path. It's what you're naturally good at.
### Soul Urge Number
Calculated from the vowels in your name, this represents your inner desires, motivations, and what truly drives you at a soul level.
### Birthday Number
Calculated from your day of birth, this represents special gifts and talents you were born with. It's a modifier that adds nuance to your other numbers.
## Installation
1. **Clone the repository:**
```bash
git clone https://github.com/yourusername/numerology.git
git clone [your-repo-url]
cd numerology
# No dependencies to install - uses Bun's native TypeScript support!
```
2. Create and activate a virtual environment (optional):
## Profile Management ⭐ NEW
Save your numerology profile once and reuse it across all tools. No more typing your name and birthdate every time!
### Create a Profile
```bash
python -m venv venv
source venv/bin/activate # On Windows, use `venv\Scripts\activate`
# Auto-generate profile ID from first name
bun profile.ts create --name "John Smith" --birthdate "3/15/1990"
# → Creates profile 'john'
# Custom profile ID
bun profile.ts create johns --name "John Smith" --birthdate "3/15/1990"
```
3. Install the required packages:
### Manage Profiles
```bash
pip install -r requirements.txt
# List all profiles
bun profile.ts list
# Show profile details
bun profile.ts show rob
# Delete a profile
bun profile.ts delete rob
```
### Use Profiles Everywhere
Once created, use `--profile` flag with any tool:
```bash
# Main calculator
bun numerology.ts --profile john --detailed --advanced --cycles
# PDF Report generator
bun generate-report.ts --profile john
# Compatibility analysis
bun compatibility.ts --profile john --person2 "Jane:1/1/1990"
# Optimal days finder
bun optimal-days.ts --profile john --day 1
# Year-ahead calendar
bun year-ahead.ts --profile john
# And all other tools...
```
**Benefits:**
- Save multiple profiles (you, partner, family, clients)
- No more retyping name/birthdate
- Consistent data across all tools
- Profiles stored in `~/.numerology/profiles/`
## Usage
Run the script:
### Basic Calculation
```bash
python3 numerology.py
Follow the prompts to enter your full name and date of birth.
# Terminal output with colors
bun numerology.ts --name "John Doe" --birthdate "5/13/1982"
# Detailed terminal output
bun numerology.ts --name "John Doe" --birthdate "5/13/1982" --detailed
```
View the calculated numerology values and their detailed meanings in the terminal output.
### Output Formats
### File Structure
numerology.py: Main script for calculating and displaying numerology values.
meanings.py: Contains dictionaries with general and detailed meanings for numerology values.
requirements.txt: Lists the required Python packages (colorama).
```bash
# Markdown format
bun numerology.ts --name "Jane Smith" --birthdate "11/22/1990" --format markdown
### License
This project is licensed under the GNU General Public License v3.0. See the LICENSE file for details.
# JSON format
bun numerology.ts --name "Bob Jones" --birthdate "3/14/1975" --format json
### Contributing
Contributions are welcome! Please feel free to submit a Pull Request or open an Issue on GitHub.
# Save to file
bun numerology.ts --name "Alice Wonder" --birthdate "7/7/1977" --format markdown > profile.md
```
### Acknowledgments
This project uses the colorama library for terminal colors.
### Timing Cycles
Calculate your Personal and Universal timing cycles:
```bash
# Show today's cycles
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles
# Check cycles for specific date
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles --date "12/25/2025"
# Detailed chart + cycles
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --detailed --cycles
```
### Telos Integration
#### Export Numerology Profile
Generate telos-formatted numerology profile:
```bash
# Export numerology profile
bun telos-export.ts --name "Your Name" --birthdate "mm/dd/yyyy" > ~/.claude/context/personal/telos/numerology.md
```
#### Weekly Planner
Align your telos goals with Personal Day cycles for optimal timing:
```bash
# Generate this week's planner
bun telos-week.ts --name "Your Name" --birthdate "mm/dd/yyyy"
# Plan specific week
bun telos-week.ts --name "Your Name" --birthdate "mm/dd/yyyy" --week-start "10/14/2025"
# Use custom telos file
bun telos-week.ts --name "Your Name" --birthdate "mm/dd/yyyy" --telos-file ~/my-telos.md
```
**Example Output:**
```
╔════════════════════════════════════════════════════════════════╗
║ 📅 YOUR WEEK AHEAD (10/14-20, 2025) ║
╚════════════════════════════════════════════════════════════════╝
Monday, October 14 - Personal Day 3
═══════════════════════════════════════════════════════════════
🎨 ENERGY: Expression, Creativity, Communication
🎯 TELOS GOAL ALIGNMENT (High Priority):
✅ G2: Provide education materials
✅ PJ3: Content creation and social media
⚠️ AVOID TODAY:
❌ Deep analytical work (save for Day 7)
❌ Heavy organizational tasks (save for Day 4)
```
This integrates with the [Telos personal development framework](https://danielmiessler.com/p/telos/).
## Command Line Options
### numerology.ts
```
--name NAME Full name (required)
--birthdate DATE Birthdate in mm/dd/yyyy format (required)
--format FORMAT Output format: terminal, markdown, json (default: terminal)
--detailed, -d Show detailed meanings (terminal format only)
--cycles, -c Include timing cycles (Personal Year/Month/Day)
--date DATE Specific date for cycles (mm/dd/yyyy) [default: today]
--help, -h Show help message
```
### telos-export.ts
```
--name NAME Full name (required)
--birthdate DATE Birthdate in mm/dd/yyyy format (required)
--help, -h Show help message
```
### telos-week.ts
```
--name NAME Full name (required)
--birthdate DATE Birthdate in mm/dd/yyyy format (required)
--week-start DATE Week start date (mm/dd/yyyy) [default: next Monday]
--telos-file PATH Path to telos.md file [default: ~/.claude/context/personal/telos/telos.md]
--help, -h Show help message
```
### optimal-days.ts ✨ NEW
```
--birthdate DATE Your birthdate (mm/dd/yyyy) [required]
--month NUMBER Month to search (1-12) [optional - searches whole year if omitted]
--year NUMBER Year to search [default: current year]
--day NUMBER Target Personal Day number (1-9, 11, 22, 33)
--activity NAME Activity type (new, creative, business, study, etc.) [optional]
--help, -h Show help message
```
### pinnacles.ts ✨ NEW
```
--birthdate DATE Your birthdate (mm/dd/yyyy) [required]
--name NAME Your name [optional - for context]
--help, -h Show help message
```
### compatibility.ts ✨ NEW
```
--person1, --p1 First person (format: "Name:mm/dd/yyyy") [required]
--person2, --p2 Second person (format: "Name:mm/dd/yyyy") [required]
--type, -t Relationship type: general, romantic, business, family, friendship [default: general]
--help, -h Show help message
```
### year-ahead.ts ✨ NEW
```
--birthdate DATE Your birthdate (mm/dd/yyyy) [required]
--year NUMBER Year to preview [default: current year]
--name NAME Your name [optional - for personalized output]
--help, -h Show help message
```
### advanced-numbers.ts ✨ NEW
```
--name NAME Your full name [required]
--birthdate DATE Your birthdate (mm/dd/yyyy) [required]
--detailed, -d Show detailed interpretations
--help, -h Show help message
```
### name-change.ts ✨ NEW
```
--birthdate DATE Your birthdate (mm/dd/yyyy) [required]
--current NAME Your current/legal name [required]
--alternative NAME Alternative name to compare [can use multiple times]
--help, -h Show help message
```
### name-optimizer.ts 🔮 NEW
```
--birthdate DATE Your birthdate (mm/dd/yyyy) [required]
--current NAME Your base name [required]
--find-masters Find ANY master numbers (11, 22, 33)
--purpose TYPE Optimize for: spiritual, business, creative, teaching, analytical
--target-expression NUM Find specific Expression number
--target-soul-urge NUM Find specific Soul Urge number
--max NUMBER Max results to show [default: 20]
--help, -h Show help message
```
## Examples
### Example 1: Quick Check
```bash
$ bun numerology.ts --name "John Doe" --birthdate "5/13/1982"
╔═══════════════════════════════════════╗
║ NUMEROLOGY CHART ║
╚═══════════════════════════════════════╝
Name: John Doe
Birthdate: 5/13/1982
Core Numbers:
1. Life Path: 11
2. Expression: 8
3. Soul Urge: 8
4. Birthday: 4
```
### Example 2: Detailed Analysis
```bash
$ bun numerology.ts --name "John Doe" --birthdate "5/13/1982" --detailed
[Full detailed output with meanings for all numbers...]
```
### Example 3: JSON for Integration
```bash
$ bun numerology.ts --name "John Doe" --birthdate "5/13/1982" --format json
{
"name": "John Doe",
"birthdate": "5/13/1982",
"lifePath": 11,
"expression": 8,
"soulUrge": 8,
"birthday": 4,
"calculations": {
"month": 5,
"day": 4,
"year": 2,
"nameBreakdown": {
"John": 2,
"Doe": 11
},
"vowelBreakdown": {
"John": 6,
"Doe": 11
}
},
"meanings": {
"lifePath": { ... },
"expression": { ... },
"soulUrge": { ... },
"birthday": { ... }
}
}
```
### Example 4: Find Optimal Days
```bash
# Find all Personal Day 1 days in November 2025 (best for launches)
$ bun optimal-days.ts --birthdate "5/13/1982" --month 11 --year 2025 --day 1
# Find creative work days by activity type
$ bun optimal-days.ts --birthdate "5/13/1982" --month 12 --activity creative
# Find business deal days for entire year
$ bun optimal-days.ts --birthdate "5/13/1982" --year 2025 --day 8
```
### Example 5: Life Stages & Pinnacles
```bash
# See your life pinnacles and current stage
$ bun pinnacles.ts --birthdate "5/13/1982" --name "John Doe"
# Output shows:
# - 4 major life pinnacles (9-year cycles)
# - Challenge numbers for each stage
# - Current pinnacle with strategic guidance
# - Next pinnacle preview
```
### Example 6: Relationship Compatibility
```bash
# General compatibility analysis
$ bun compatibility.ts --person1 "John Doe:5/13/1982" --person2 "Jane Smith:11/22/1990"
# Romantic relationship analysis
$ bun compatibility.ts --p1 "Alice:7/7/1988" --p2 "Bob:3/14/1985" --type romantic
# Business partnership analysis
$ bun compatibility.ts --p1 "Sarah:1/1/1980" --p2 "Mike:8/8/1983" --type business
```
### Example 7: Year-Ahead Calendar
```bash
# Preview current year's Personal Month cycles
$ bun year-ahead.ts --birthdate "5/13/1982"
# Plan for 2026 with name
$ bun year-ahead.ts --birthdate "5/13/1982" --year 2026 --name "John Doe"
# Output shows:
# - Personal Year theme and overview
# - All 12 months with Personal Month numbers
# - Strategic planning guide (launch months, creative months, etc.)
# - Key opportunities grouped by cycle type
```
### Example 8: Advanced Numbers
```bash
# Calculate additional numbers beyond core 4
$ bun advanced-numbers.ts --name "John Doe" --birthdate "5/13/1982"
# With detailed interpretations
$ bun advanced-numbers.ts --name "Jane Smith" --birthdate "11/22/1990" --detailed
# Or use --advanced flag with main calculator for everything
$ bun numerology.ts --name "John Doe" --birthdate "5/13/1982" --advanced
# Output shows:
# - Maturity Number (who you become after age 40)
# - Personality Number (how others see you)
# - Hidden Passion Number (your secret talent)
# - Karmic Lessons (areas to develop)
# - Balance Number (how you handle crisis)
```
### Example 9: Name Change Analysis
```bash
# Compare name variations
$ bun name-change.ts --birthdate "1/1/1980" --current "John Smith" --alternative "John Smith"
# Test multiple alternatives
$ bun name-change.ts -b "5/13/1982" -c "Jane Smith" -a "Jane Doe" -a "J Smith" -a "JJ"
# Output shows:
# - Expression/Soul Urge/Personality shifts
# - Master number activations
# - Karmic lesson changes
# - Energy shift analysis
# - Recommendations for which contexts to use each name
```
### Example 10: Name Optimizer (Rainbow Tables) 🔮
```bash
# Find ANY master numbers
$ bun name-optimizer.ts -b "1/1/1980" -c "John Smith" --find-masters
# Optimize for spiritual writing pseudonym
$ bun name-optimizer.ts -b "5/13/1982" -c "Jane Smith" --purpose spiritual
# Find business power names (Expression 8)
$ bun name-optimizer.ts -b "3/14/1985" -c "John Doe" --target-expression 8
# Creative work optimization
$ bun name-optimizer.ts -b "7/7/1990" -c "Sarah Jones" --purpose creative
# Output shows:
# - Tests 90+ intelligent name variations
# - Finds master number combinations (11, 22, 33)
# - Scores and ranks results by purpose
# - Shows top matches with star ratings ⭐
# - Like "hash cracking" but for numerology!
```
## Master Numbers
The calculator automatically detects and preserves master numbers (11, 22, 33) during calculation. Master numbers are spiritually significant and are not reduced to single digits.
Example:
```
✨ Master number found in Life Path: 11
```
## Numerology Meanings Database
The calculator includes comprehensive meanings for each number covering:
- Keywords
- Full description
- Strengths
- Challenges
- Life purpose
- Career paths
- Relationship dynamics
- Spiritual lessons
Each number (1-9, 11, 22, 33) has contextual meanings that vary based on position:
- Life Path meanings (your core purpose)
- Expression meanings (your natural talents)
- Soul Urge meanings (your inner desires)
- Birthday meanings (your special gifts)
## How Numerology Works
Numerology is based on the Pythagorean system where:
- Each letter has a numeric value (A=1, B=2, ... Z=26)
- Numbers are reduced to single digits (or master numbers)
- Different calculations reveal different aspects of personality
**Calculation Methods:**
1. **Life Path** = Reduce(Month) + Reduce(Day) + Reduce(Year), then reduce sum
2. **Expression** = Sum of all letters in full name, reduced
3. **Soul Urge** = Sum of vowels in full name, reduced
4. **Birthday** = Day of birth, reduced
**Master Number Rule:** 11, 22, and 33 are never reduced further.
## File Structure
```
numerology/
├── core-calculator.ts # Core calculation functions
├── meanings.ts # Comprehensive numerology interpretations
├── cycle-meanings.ts # Timing cycle interpretations
├── cycles.ts # Timing cycle calculations
├── numerology.ts # Main calculator with CLI
├── generate-report.ts # LaTeX PDF report generator 📄 NEW
├── profile.ts # Profile management CLI ⭐ NEW
├── profile-manager.ts # Profile CRUD operations ⭐ NEW
├── telos-export.ts # Telos framework integration
├── telos-week.ts # Weekly planner (goals + cycles)
├── telos-cycles-analyze.ts # Goal alignment analyzer
├── optimal-days.ts # Find best days for activities ✨
├── pinnacles.ts # Life stages & pinnacles calculator ✨
├── compatibility.ts # Relationship compatibility analyzer ✨
├── year-ahead.ts # Year-ahead Personal Month calendar ✨
├── advanced-numbers.ts # Additional numbers (Maturity, Personality, etc.) ✨
├── name-change.ts # Name variation comparison tool ✨
├── name-optimizer.ts # Master number hunter (rainbow tables) 🔮
├── templates/
│ └── report-template.tex # LaTeX report template
├── archive/
│ ├── numerology.py # Original Python version
│ ├── r_num.py # Refactored Python version
│ └── requirements.txt # Python dependencies
├── CYCLES-DOCUMENTATION.md # Complete cycle system guide
├── TELOS-INTEGRATION.md # Integration vision document
├── PROFILE-SYSTEM.md # Profile management documentation
└── README.md # This file
```
## Technology Stack
- **Runtime:** Bun (fast TypeScript runtime)
- **Language:** TypeScript (type-safe, modern)
- **No Dependencies:** Pure TypeScript, no external packages required
## Development
The calculator is written in pure TypeScript with no external dependencies. It uses:
- Bun's native TypeScript support
- Standard library only
- ANSI escape codes for terminal colors
- Functional programming patterns
## Documentation
- **[CYCLES-DOCUMENTATION.md](./CYCLES-DOCUMENTATION.md)** - Complete guide to timing cycles
- **[TELOS-INTEGRATION.md](./TELOS-INTEGRATION.md)** - Telos integration vision and roadmap
## Roadmap
### Phase 1: Core Integration ✅
- [x] Build telos-week.ts weekly planner
- [x] Test with real telos data
- [x] Document timing cycles system
- [x] Update README
### Phase 2: Deep Analysis ✅
- [x] Build telos-cycles-analyze.ts - Goal alignment analyzer with scoring
- [x] Quarterly action plan generator
- [x] 2026 preview feature
### Phase 3: Fabric Integration ✅
- [x] Create t_numerology_guidance Fabric pattern
- [x] AI-powered combined analysis
- [ ] Integrate with telos-runner.ts
### Phase 4: Advanced Features ✅
- [x] Optimal days finder (find best days for specific activities) ✨
- [x] Life stages/pinnacles calculator ✨
- [x] Compatibility analysis (compare two charts) ✨
- [x] Year-ahead calendar (Personal Month overview for 12 months) ✨
### Phase 5: Polish ✅
- [x] Additional numbers (Maturity, Hidden Passion, Karmic Lessons, etc.) ✨
- [x] Name change analysis (compare name variations) ✨
- [x] Name optimizer (brute-force master numbers) 🔮
### Phase 6: Profile System & Ultimate Deliverable ✅ COMPLETE
- [x] Profile management system (save name/birthdate, reuse across all tools)
- `bun profile.ts create --name "..." --birthdate "..."`
- `bun numerology.ts --profile name [command]`
- Store in `~/.numerology/profiles/`
- Multiple profiles support (you, partner, clients)
- **ALL major tools now support --profile flag**
- [x] 📄 **LaTeX PDF Report Generator** - The ultimate deliverable!
- Beautiful full-spectrum numerology report
- Core numbers + advanced numbers + cycles + pinnacles
- Professional typography and layout
- Includes all calculations and detailed interpretations
- Shareable/printable for clients or personal use
- `bun generate-report.ts --profile name`
**🎯 CURRENT STATUS: Production-ready for client delivery via PDF reports**
### Phase 7: Future Enhancements (Post-Customer Validation)
**Strategy:** Start with PDF reports as primary deliverable. Gather customer feedback and traction. Then expand to web UI for self-service.
#### Calculation Enhancements
- [ ] **Transits Calculator** - Calculate when you'll experience specific Personal Days/Months/Years
- [ ] **Karmic Debt Numbers** - Detect and interpret 13, 14, 16, 19 karmic debt numbers
- [ ] **Master Number 44** - Add support for master number 44
- [ ] **Compound Numbers** - Track compound numbers before reduction (e.g., 29/11 vs 38/11)
- [ ] **Business Name Analysis** - Dedicated tool for business/brand name numerology
- [ ] **Pythagorean vs Chaldean** - Toggle between different numerology systems
#### Intelligence & Optimization
- [ ] **Business Name Generator** - Intelligent variations beyond middle initials for optimal numbers
- [ ] **Multi-person Compatibility** - Compare 3+ people (teams, families, partnerships)
#### User Experience & Delivery
- [ ] 🎨 **Web UI** (Bun.serve + React) - *Deploy after customer traction*
- Interactive forms with real-time calculations
- Visual comparisons and compatibility charts
- Side-by-side name variations explorer
- Shareable links and web-based PDF generation
- Profile/account management
- Date pickers and input validation
- [ ] **Interactive Birth Chart Visualization** - Visual representation of numerology charts
- [ ] **Email Delivery** - Automated email delivery of PDF reports to clients
- [ ] **Client Portal** - Dashboard for managing multiple client reports
## Credits
**Original Python Implementation:** Initial algorithm and calculation logic
**TypeScript Rewrite:** Modern implementation with comprehensive meanings database
**Numerology System:** Based on Pythagorean numerology
## License
GNU General Public License v3.0
## Resources
- [Numerology Basics](https://www.numerology.com/)
- [Life Path Calculator](https://www.tokenrock.com/numerology/life-path-number/)
- [Telos Framework](https://danielmiessler.com/p/telos/)
---
**Made with ❤️ and TypeScript**

503
TELOS-INTEGRATION.md Normal file
View file

@ -0,0 +1,503 @@
# Telos-Numerology Integration Plan
## 🎯 Vision
Combine your **telos goals** (what you want to achieve) with **numerology cycles** (optimal timing) to create **personalized, time-aware guidance** for achieving your life mission.
## 🌟 The Power of Integration
**Telos Framework** tells you:
- What you want to achieve (goals)
- Why it matters (missions)
- What's holding you back (challenges)
- Your strategies for success
**Numerology Cycles** tells you:
- WHEN to act (timing)
- HOW to approach (energy alignment)
- WHAT to prioritize (cycle themes)
- WHICH activities to emphasize (daily guidance)
**Together they create:**
- **Time-aware goal planning**
- **Energy-aligned action**
- **Reduced resistance and struggle**
- **Natural flow and momentum**
## 🛠️ Planned Tools
### 1. Weekly Planner (`telos-week.ts`)
**Purpose:** Plan your week based on Personal Days + Telos goals
**Usage:**
```bash
bun telos-week.ts
```
**Output:**
```
📅 YOUR WEEK AHEAD (Oct 14-20, 2025)
═══════════════════════════════════════
Monday, October 14 - Personal Day 3
═══════════════════════════════════════
🎨 ENERGY: Expression, Creativity, Communication
✅ BEST ACTIVITIES:
- Creative projects and content creation
- Social networking and meetings
- Public speaking or presentations
- Writing and communication
🎯 TELOS GOAL ALIGNMENT:
HIGH PRIORITY (Aligned with Day 3 energy):
✅ G2: Provide education materials
→ Write Daily Security Briefing blog post
→ Create Privacy Blog content
→ Record educational video
✅ PJ3: Automation Business
→ Client presentations
→ Social media content
→ Networking calls
AVOID TODAY:
❌ Deep analytical work (save for Day 7)
❌ Heavy organizational tasks (save for Day 4)
❌ Major decisions (not a decision day)
═══════════════════════════════════════
Tuesday, October 15 - Personal Day 4
═══════════════════════════════════════
🏗️ ENERGY: Work, Organization, Foundation Building
✅ BEST ACTIVITIES:
- Building systems and foundations
- Organizing and planning
- Physical work and projects
- Financial planning
🎯 TELOS GOAL ALIGNMENT:
HIGH PRIORITY:
✅ PJ3: Automation Business
→ Build new n8n workflows
→ Organize client documentation
→ System architecture work
→ Infrastructure improvements
✅ GB4: Scale automation business
→ Create standard operating procedures
→ Document processes
→ Financial planning
AVOID TODAY:
❌ Starting completely new projects
❌ Scattered creative work
❌ Excessive socializing
[... continues for full week]
═══════════════════════════════════════
📊 WEEKLY SUMMARY
═══════════════════════════════════════
CURRENT PERSONAL YEAR: 33 (Master Teaching)
CURRENT PERSONAL MONTH: 7 (Introspection)
🎯 WEEKLY THEME:
You're in a Master Teaching year, currently in an introspective month.
This week emphasizes balancing inner development (Month 7) with
external expression and service (Year 33).
🌟 KEY OPPORTUNITIES THIS WEEK:
1. Monday (Day 3): Share your knowledge through content
2. Thursday (Day 6): Serve clients and community
3. Saturday (Day 8): Business planning and financial decisions
⚠️ WEEKLY CHALLENGES:
- Month 7 wants rest, but Year 33 calls you to serve
- Balance introspection with action
- Don't over-commit (Year 33 energy is intense)
💡 WEEKLY ADVICE:
Create content privately (Month 7), release publicly (Day 3/Day 8).
Deep work in mornings, service in afternoons.
```
### 2. Goal-Cycle Alignment Analyzer (`telos-cycles-analyze.ts`)
**Purpose:** Deep analysis of how your telos goals align with current cycles
**Usage:**
```bash
bun telos-cycles-analyze.ts
```
**Output:**
```
🎯 TELOS GOAL ALIGNMENT ANALYSIS
═══════════════════════════════════════
YOUR CURRENT CYCLES
═══════════════════════════════════════
Personal Year: 33 (Master Teaching, Healing, Service)
Personal Month: 7 (Introspection, Spirituality, Rest)
Universal Year: 9 (Completion, Transformation)
═══════════════════════════════════════
CAREER GOALS ANALYSIS
═══════════════════════════════════════
G1: Get Security+ certification
┌─────────────────────────────────────┐
│ ALIGNMENT: ⚠️ MODERATE CHALLENGE │
│ SCORE: 4/10 │
└─────────────────────────────────────┘
ANALYSIS:
❌ Personal Year 33 is about teaching others, not personal certification
❌ Personal Month 7 supports study, but Year 33 pulls toward service
✅ Universal Year 9 supports completion if close to finishing
RECOMMENDATION:
→ If 80%+ prepared: Complete it (Year 9 completion energy)
→ If starting fresh: Wait for Personal Year 1 (2026)
→ Alternative: Study to TEACH security concepts (aligns with Year 33)
OPTIMAL TIMING: Personal Year 1 (2026) or Year 7 (2032)
─────────────────────────────────────
G2: Provide education materials
┌─────────────────────────────────────┐
│ ALIGNMENT: ✅ PERFECT MATCH │
│ SCORE: 10/10 │
└─────────────────────────────────────┘
ANALYSIS:
✅ Personal Year 33 is THE teaching/education year
✅ Your Life Path 11 + Expression 11 support education
✅ Universal Year 9 supports sharing accumulated wisdom
✅ TRIPLE MASTER NUMBERS (11/11/22) amplify this goal
RECOMMENDATION:
→ HIGHEST PRIORITY RIGHT NOW
→ This is your PERFECT year for this goal
→ You're literally built for this (core numbers)
→ Commit deeply - this goal is DESTINED for 2025
OPTIMAL TIMING: NOW (RIGHT NOW!)
MONTHLY BREAKDOWN:
- October (Month 7): Develop content privately
- November (Month 8): Launch/promote powerfully
- December (Month 9): Complete and release year's work
═══════════════════════════════════════
BUSINESS GOALS ANALYSIS
═══════════════════════════════════════
GB4: Scale automation business to profitability
┌─────────────────────────────────────┐
│ ALIGNMENT: ⚠️ MODERATE CHALLENGE │
│ SCORE: 5/10 │
└─────────────────────────────────────┘
ANALYSIS:
❌ Personal Year 33 emphasizes service over profit
❌ Universal Year 9 is ending, not scaling
✅ Personal Month 8 (November) supports business growth
⚠️ Year 33 can bring business IF focused on service
RECOMMENDATION:
→ Reframe: "Scale business to serve more people" (33 energy)
→ Focus on impact, not just profit (33 requirement)
→ Push hard in November (Personal Month 8)
→ Year 1 (2026) better for pure business growth
OPTIMAL TIMING:
- November 2025 (Month 8): Strong push
- Personal Year 1 (2026): Major scaling year
- Personal Year 8 (2033): Peak business year
═══════════════════════════════════════
PROJECT PRIORITIZATION
═══════════════════════════════════════
🥇 TOP PRIORITY (Perfect Alignment):
1. G2: Provide education materials (10/10)
2. PJ1: Mastering Prompt Engineering (9/10 - teaching AI)
3. GC2: Create Cypherpunk 101 course (10/10 - teaching + Year 33)
🥈 MEDIUM PRIORITY (Good Timing):
4. PJ3: Automation business service delivery (7/10)
5. GB6: Build reputation through teaching (8/10)
🥉 LOW PRIORITY (Wait for Better Timing):
6. G1: Security+ (4/10 - wait for Year 1)
7. GB4: Scale for profit (5/10 - reframe or wait)
8. New certifications (3/10 - next year)
═══════════════════════════════════════
QUARTERLY ACTION PLAN
═══════════════════════════════════════
Q4 2025 (Personal Year 33, Months 7-9):
OCTOBER (Month 7 - Introspection):
Focus: Develop educational content privately
Actions:
- Write Cypherpunk 101 course outline
- Develop automation course content
- Research and study deeply
- Create Daily Security Briefings (low effort)
NOVEMBER (Month 8 - Achievement):
Focus: Launch and promote powerfully
Actions:
- Launch Cypherpunk 101 course
- Promote automation services strongly
- Close business deals
- Scale what's working
DECEMBER (Month 9 - Completion):
Focus: Complete and release year's work
Actions:
- Finish all pending course content
- Complete client projects
- Clear away what didn't work
- Prepare for Personal Year 1 (2026)
═══════════════════════════════════════
2026 PREVIEW (Personal Year 1)
═══════════════════════════════════════
🎯 NEW 9-YEAR CYCLE BEGINS!
PERFECT FOR:
✅ Starting new business ventures
✅ Launching new services
✅ Beginning certifications
✅ Career pivots
✅ Moving or relocating
✅ New relationships/partnerships
PLAN NOW:
- What new cycle do you want to create?
- What foundations will you build in Year 1?
- What projects to complete in Dec 2025 to clear space?
```
### 3. Fabric Pattern: `t_numerology_guidance`
**Purpose:** AI-powered analysis combining telos + numerology + current context
**Pattern File:** `~/.config/fabric/patterns/t_numerology_guidance/system.md`
**Usage:**
```bash
# Generate telos file with numerology
bun telos-export.ts --name "Your Name" --birthdate "mm/dd/yyyy" > /tmp/telos-with-numerology.md
# Combine with regular telos
cat ~/.claude/context/personal/telos/telos.md /tmp/telos-with-numerology.md | fabric -p t_numerology_guidance
```
**Pattern Prompt:**
```markdown
# IDENTITY
You are an expert at numerology-based life guidance combined with telos framework analysis.
# GOAL
Provide personalized guidance by analyzing the person's:
- Life goals and missions (from telos)
- Current numerology cycles
- Core numerology numbers
- Challenges and strategies
# STEPS
1. Read the complete telos file
2. Study the numerology chart (core numbers + current cycles)
3. Identify goal-cycle alignments and misalignments
4. Prioritize goals based on cycle support
5. Provide specific, actionable timing guidance
# OUTPUT
Provide a comprehensive guidance report including:
- Current cycle interpretation
- Goal alignment analysis
- Priority recommendations
- Monthly action plan
- Specific timing for major decisions
- Warnings about mis-timed actions
# FORMAT
Use clear headers, bullet points, and specific dates.
Be direct and actionable.
```
### 4. Optimal Days Finder (`cycles.ts` extension)
**Purpose:** Find best days in a month for specific activities
**Usage:**
```bash
# Find all Personal Day 1 days (new beginnings) in November
bun cycles.ts find-optimal --birthdate "5/13/1982" --month 11 --year 2025 --number 1
# Find all Personal Day 8 days (achievement) in November
bun cycles.ts find-optimal --birthdate "5/13/1982" --month 11 --year 2025 --number 8
```
**Output:**
```
🎯 OPTIMAL DAYS IN NOVEMBER 2025
Personal Day 1 (New Beginnings):
- November 4
- November 13
- November 22
BEST FOR:
✅ Starting new projects
✅ First client meetings
✅ Launching products/services
✅ Making first moves
✅ Taking initiative
TELOS ALIGNMENT:
→ Launch Cypherpunk 101 course on Nov 13 (Day 1 + Master 22 day!)
→ Start new client projects on Nov 4
→ Begin certification study on Nov 22
```
## 🔮 Implementation Roadmap
### Phase 1: Core Integration ✅ COMPLETE
- [x] Document vision and approach
- [x] Build `telos-week.ts` - Weekly planner
- [x] Test with real telos file
- [x] Refine output format
- [x] Update README documentation
### Phase 2: Deep Analysis (Week 2)
- [ ] Build `telos-cycles-analyze.ts` - Goal alignment analyzer
- [ ] Create scoring algorithm for goal-cycle fit
- [ ] Generate quarterly action plans
- [ ] Add 2026 preview
### Phase 3: Fabric Integration (Week 3)
- [ ] Create `t_numerology_guidance` pattern
- [ ] Test with Ollama models
- [ ] Integrate with telos-runner.ts
- [ ] Add to daily/weekly automation
### Phase 4: Advanced Features (Week 4)
- [ ] Add optimal days finder
- [ ] Create year-ahead calendar
- [ ] Build compatibility analyzer
- [ ] Add life stages/pinnacles
### Phase 5: Telos System Integration (Ongoing)
- [ ] Auto-run weekly planner Sunday mornings
- [ ] Add to telos daily check-in
- [ ] Create cycle-aware TaskWarrior tasks
- [ ] Voice notifications for key cycle shifts
## 🎓 Usage Scenarios
### Scenario 1: Weekly Planning
**Every Sunday:**
```bash
bun telos-week.ts > ~/planning/week-$(date +%Y-%m-%d).md
```
Review output, schedule tasks based on Personal Days.
### Scenario 2: Quarterly Review
**Every quarter:**
```bash
bun telos-cycles-analyze.ts > ~/planning/q4-2025-analysis.md
```
Use for strategic planning, goal prioritization.
### Scenario 3: Daily Check-in
**Every morning:**
```bash
# What's today's energy?
bun numerology.ts --name "Your Name" --birthdate "mm/dd/yyyy" --cycles | grep "Personal Day"
```
Align day's activities with Personal Day energy.
### Scenario 4: Major Decision
**Before big decisions:**
```bash
# Should I start this business?
bun telos-cycles-analyze.ts | grep -A 20 "business"
# When should I launch?
bun cycles.ts find-optimal --month 11 --year 2025 --number 1
```
Use timing intel to make better decisions.
## 💡 Key Insights
### The Alignment Principle
**When goals align with cycles, success flows naturally.**
**When misaligned, you fight upstream.**
Example:
- Starting business in Personal Year 1 = ✅ Natural flow
- Starting business in Personal Year 9 = ❌ Swimming upstream
### The Triple Master Number Advantage
**Your chart (11/11/7/22) + Current Year 33:**
- Unprecedented spiritual power
- Teaching/healing emphasis
- Higher responsibility
- Greater impact potential
**This configuration suggests:**
→ You're meant to teach spiritual/esoteric subjects
→ Current year (33) is YOUR year to shine
→ Education goals are literally written in your numbers
### The Service-Success Connection
**Personal Year 33 paradox:**
- Trying to profit = Resistance
- Serving others = Abundance flows naturally
**Strategy:**
"How can I serve more people?" not "How can I make more money?"
Money follows service in Year 33.
## 🚀 Next Steps
1. **Immediate:** Build `telos-week.ts` for next week's planning
2. **This Week:** Use it to plan your week
3. **Next Week:** Build `telos-cycles-analyze.ts` for deep insights
4. **This Month:** Integrate with telos automation system
5. **This Quarter:** Create Fabric pattern for AI-powered guidance
---
**The Vision:**
A fully integrated system where your life goals automatically align with optimal timing, reducing struggle and maximizing flow.
**The Result:**
You work WITH natural rhythms instead of fighting against them, achieving goals with less resistance and more joy.

301
additional-meanings.ts Normal file
View file

@ -0,0 +1,301 @@
/**
* Additional Numerology Number Meanings
*
* Meanings for Maturity, Personality, Hidden Passion, Karmic Lessons, and Balance numbers
*/
export interface AdditionalMeaning {
keywords: string[];
description: string;
interpretation: string;
}
// Maturity Number - Who you become in later life (after age 40)
export const maturityMeanings: Record<number, AdditionalMeaning> = {
1: {
keywords: ['Independent', 'Leader', 'Self-reliant', 'Confident'],
description: 'You become increasingly independent and self-directed with age',
interpretation: 'Your mature years bring growing confidence in your ability to lead and pioneer. You develop strong self-reliance and the courage to stand alone when necessary. You may find yourself taking on leadership roles or starting new ventures later in life.'
},
2: {
keywords: ['Diplomatic', 'Cooperative', 'Peacemaker', 'Supportive'],
description: 'You become a skilled mediator and relationship builder in your mature years',
interpretation: 'With age comes deep wisdom about relationships and cooperation. You excel at bringing people together and creating harmony. Your diplomatic skills and patience become your greatest assets as you mature.'
},
3: {
keywords: ['Creative', 'Expressive', 'Joyful', 'Communicative'],
description: 'Your creative and communicative abilities flourish in later life',
interpretation: 'Your mature years bring heightened creativity and self-expression. You may discover hidden artistic talents or find new ways to communicate your ideas. Joy and optimism become your hallmarks as you age.'
},
4: {
keywords: ['Stable', 'Organized', 'Practical', 'Builder'],
description: 'You become a pillar of stability and practical wisdom',
interpretation: 'Maturity brings appreciation for structure, order, and hard work. You build lasting legacies and systems. Your practical wisdom and dedication to tangible results define your later years.'
},
5: {
keywords: ['Adventurous', 'Free', 'Adaptable', 'Progressive'],
description: 'Your thirst for freedom and new experiences grows with age',
interpretation: 'Your mature years are marked by continued adventure and adaptability. You remain young at heart, always seeking new experiences. Change and variety keep you energized as you age.'
},
6: {
keywords: ['Nurturing', 'Responsible', 'Devoted', 'Harmonious'],
description: 'You become the family and community caretaker in later life',
interpretation: 'Maturity brings deep satisfaction from service and responsibility. You create beautiful, harmonious environments and take care of those you love. Your nurturing nature reaches its fullest expression.'
},
7: {
keywords: ['Wise', 'Spiritual', 'Introspective', 'Analytical'],
description: 'You become increasingly philosophical and spiritually aware',
interpretation: 'Your mature years bring deep spiritual insight and wisdom. You seek truth and understanding, often becoming a teacher or spiritual guide. Solitude and contemplation become increasingly valuable.'
},
8: {
keywords: ['Successful', 'Authoritative', 'Prosperous', 'Powerful'],
description: 'You achieve material success and positions of authority',
interpretation: 'Maturity brings financial success and recognition. You step into positions of power and authority, using your business acumen to create abundance. Your leadership in material matters defines your later years.'
},
9: {
keywords: ['Humanitarian', 'Compassionate', 'Wise', 'Universal'],
description: 'You become deeply humanitarian and universally compassionate',
interpretation: 'Your mature years are dedicated to serving humanity. You develop profound compassion and understanding for all people. Your wisdom and charitable nature become your legacy.'
},
11: {
keywords: ['Inspirational', 'Intuitive', 'Illuminating', 'Visionary'],
description: 'You become an inspiring spiritual teacher and visionary',
interpretation: 'Maturity activates your master number energy fully. You inspire and illuminate others with your intuitive wisdom. Your later years may involve spiritual teaching or visionary leadership.'
},
22: {
keywords: ['Master Builder', 'Visionary', 'Practical Idealist', 'Legacy Creator'],
description: 'You build lasting structures and legacies that serve humanity',
interpretation: 'Your mature years bring the power to manifest great visions into reality. You combine practical skill with idealistic vision to create lasting works. Your legacy serves generations.'
},
33: {
keywords: ['Master Teacher', 'Healer', 'Selfless', 'Compassionate Leader'],
description: 'You become a selfless healer and teacher of universal love',
interpretation: 'Maturity brings the highest expression of service and compassion. You teach and heal at the highest level, often sacrificing personal needs for the greater good. Your mature years radiate unconditional love.'
}
};
// Personality Number - How others see you (the mask you wear)
export const personalityMeanings: Record<number, AdditionalMeaning> = {
1: {
keywords: ['Confident', 'Strong', 'Independent', 'Leader'],
description: 'Others see you as confident, strong, and natural leader',
interpretation: 'You project an aura of confidence and independence. People perceive you as capable, strong-willed, and someone who takes charge. Your outer personality commands respect and attention.'
},
2: {
keywords: ['Gentle', 'Diplomatic', 'Friendly', 'Approachable'],
description: 'Others see you as gentle, diplomatic, and easy to approach',
interpretation: 'You appear gentle, tactful, and considerate to others. People feel comfortable around you and seek your counsel. Your outer personality is non-threatening and supportive.'
},
3: {
keywords: ['Charming', 'Expressive', 'Social', 'Creative'],
description: 'Others see you as charming, expressive, and socially engaging',
interpretation: 'You come across as charismatic, creative, and fun-loving. People are drawn to your expressive nature and social skills. Your outer personality sparkles with charm and creativity.'
},
4: {
keywords: ['Solid', 'Dependable', 'Traditional', 'Serious'],
description: 'Others see you as solid, dependable, and grounded',
interpretation: 'You project stability, reliability, and practicality. People perceive you as trustworthy and down-to-earth. Your outer personality communicates competence and dedication.'
},
5: {
keywords: ['Dynamic', 'Exciting', 'Unconventional', 'Free-spirited'],
description: 'Others see you as dynamic, exciting, and full of life',
interpretation: 'You appear energetic, adventurous, and unconventional. People find you exciting and unpredictable. Your outer personality radiates freedom and vitality.'
},
6: {
keywords: ['Warm', 'Caring', 'Responsible', 'Protective'],
description: 'Others see you as warm, caring, and responsible',
interpretation: 'You project warmth, compassion, and reliability. People see you as nurturing and trustworthy. Your outer personality invites others to lean on you for support.'
},
7: {
keywords: ['Mysterious', 'Dignified', 'Reserved', 'Intellectual'],
description: 'Others see you as mysterious, dignified, and intellectually deep',
interpretation: 'You come across as somewhat reserved and mysterious. People perceive you as intelligent and refined. Your outer personality maintains a certain distance and dignity.'
},
8: {
keywords: ['Powerful', 'Successful', 'Authoritative', 'Impressive'],
description: 'Others see you as powerful, successful, and commanding',
interpretation: 'You project power, authority, and material success. People perceive you as someone who has it together financially. Your outer personality commands respect and admiration.'
},
9: {
keywords: ['Compassionate', 'Worldly', 'Idealistic', 'Magnetic'],
description: 'Others see you as compassionate, worldly, and idealistic',
interpretation: 'You appear understanding, compassionate, and globally aware. People sense your humanitarian nature. Your outer personality attracts those seeking wisdom and acceptance.'
},
11: {
keywords: ['Inspiring', 'Electric', 'Charismatic', 'Illuminating'],
description: 'Others see you as inspiring, charismatic, and spiritually aware',
interpretation: 'You project an electric, inspiring presence. People sense something special about you. Your outer personality naturally uplifts and inspires those around you.'
},
22: {
keywords: ['Impressive', 'Visionary', 'Capable', 'Commanding'],
description: 'Others see you as impressively capable and visionary',
interpretation: 'You appear as someone capable of great things. People sense your ability to turn visions into reality. Your outer personality combines practical competence with inspiring vision.'
},
33: {
keywords: ['Nurturing', 'Healing', 'Selfless', 'Radiant'],
description: 'Others see you as nurturing, healing, and selflessly devoted',
interpretation: 'You project profound compassion and healing energy. People naturally seek your guidance and comfort. Your outer personality radiates unconditional love and understanding.'
}
};
// Hidden Passion - Your deepest hidden talent
export const hiddenPassionMeanings: Record<number, AdditionalMeaning> = {
1: {
keywords: ['Leadership', 'Independence', 'Innovation', 'Courage'],
description: 'Your hidden passion is to lead, innovate, and stand independently',
interpretation: 'You have a deep, often unconscious drive to be first, to lead, and to forge your own path. This number appearing frequently in your name suggests leadership is your secret talent, even if you don\'t always recognize it.'
},
2: {
keywords: ['Harmony', 'Partnership', 'Diplomacy', 'Cooperation'],
description: 'Your hidden passion is creating harmony and building partnerships',
interpretation: 'You\'re secretly driven to bring people together and create peace. Cooperation and partnership are your hidden strengths, even when you don\'t consciously pursue them.'
},
3: {
keywords: ['Creativity', 'Self-expression', 'Communication', 'Joy'],
description: 'Your hidden passion is creative expression and joyful communication',
interpretation: 'Deep within, you\'re driven to create, express, and communicate. Creativity is your secret superpower, whether or not you currently use it. This is where your joy lies.'
},
4: {
keywords: ['Building', 'Organization', 'Systems', 'Practical Achievement'],
description: 'Your hidden passion is building lasting structures and systems',
interpretation: 'You have a deep drive to create order, build systems, and make things concrete. Your hidden talent is turning chaos into organized, practical reality.'
},
5: {
keywords: ['Freedom', 'Adventure', 'Change', 'Versatility'],
description: 'Your hidden passion is experiencing freedom and variety',
interpretation: 'You\'re secretly driven by a need for freedom, adventure, and change. Variety and new experiences fuel your soul, even if you don\'t always pursue them actively.'
},
6: {
keywords: ['Service', 'Nurturing', 'Responsibility', 'Beauty'],
description: 'Your hidden passion is serving others and creating beauty',
interpretation: 'Deep within, you\'re driven to care for others and create harmonious environments. Service and responsibility are your hidden strengths and sources of fulfillment.'
},
7: {
keywords: ['Truth', 'Wisdom', 'Understanding', 'Spirituality'],
description: 'Your hidden passion is seeking truth and spiritual understanding',
interpretation: 'You have a deep drive to understand life\'s mysteries and seek truth. Your hidden talent is analytical and spiritual insight. Wisdom-seeking is your secret passion.'
},
8: {
keywords: ['Achievement', 'Success', 'Power', 'Material Mastery'],
description: 'Your hidden passion is achieving material success and power',
interpretation: 'You\'re secretly driven to succeed materially and wield power effectively. Business acumen and the ability to manifest abundance are your hidden talents.'
},
9: {
keywords: ['Compassion', 'Humanitarianism', 'Universal Love', 'Completion'],
description: 'Your hidden passion is serving humanity with compassion',
interpretation: 'Deep within, you\'re driven to help all of humanity. Universal compassion and the ability to let go are your hidden strengths. Service to the greater good calls to you.'
}
};
// Karmic Lessons - Missing numbers represent areas to develop
export const karmicLessonMeanings: Record<number, AdditionalMeaning> = {
1: {
keywords: ['Independence', 'Courage', 'Leadership', 'Initiative'],
description: 'Learn to be independent, courageous, and take initiative',
interpretation: 'You\'re here to develop independence and courage. Learning to stand alone and take the initiative are key lessons. Don\'t wait for others - practice being your own leader.'
},
2: {
keywords: ['Cooperation', 'Patience', 'Tact', 'Partnership'],
description: 'Learn cooperation, patience, and how to work with others',
interpretation: 'You need to develop patience, tact, and the ability to cooperate. Learning to work in partnership and consider others\' needs are important lessons for you.'
},
3: {
keywords: ['Expression', 'Communication', 'Creativity', 'Joy'],
description: 'Learn to express yourself creatively and communicate openly',
interpretation: 'You\'re here to learn self-expression and communication. Developing your creative side and learning to share your thoughts and feelings are key lessons.'
},
4: {
keywords: ['Discipline', 'Organization', 'Hard Work', 'Practical Skills'],
description: 'Learn discipline, organization, and practical application',
interpretation: 'You need to develop discipline, organizational skills, and follow-through. Learning practical skills and the value of hard work are important lessons.'
},
5: {
keywords: ['Adaptability', 'Freedom', 'Change', 'Flexibility'],
description: 'Learn to embrace change, adapt, and find constructive freedom',
interpretation: 'You\'re here to learn adaptability and how to handle change. Developing flexibility and using freedom constructively are key lessons for you.'
},
6: {
keywords: ['Responsibility', 'Service', 'Balance', 'Compassion'],
description: 'Learn responsibility, service to others, and balanced caring',
interpretation: 'You need to develop responsibility and the ability to serve others without losing yourself. Learning balance between self-care and caring for others is key.'
},
7: {
keywords: ['Faith', 'Trust', 'Inner Work', 'Spiritual Development'],
description: 'Learn to trust your intuition and develop spiritual awareness',
interpretation: 'You\'re here to develop faith, trust, and spiritual awareness. Learning to go within and trust your intuition are important lessons for you.'
},
8: {
keywords: ['Material Mastery', 'Power', 'Authority', 'Business Sense'],
description: 'Learn to handle material success, power, and authority wisely',
interpretation: 'You need to learn proper use of power and material resources. Developing business sense and handling authority responsibly are key lessons.'
},
9: {
keywords: ['Letting Go', 'Compassion', 'Forgiveness', 'Universal Love'],
description: 'Learn compassion, forgiveness, and how to let go gracefully',
interpretation: 'You\'re here to learn universal compassion and the art of letting go. Developing forgiveness and understanding that endings are natural are important lessons.'
}
};
// Balance Number - How you handle crisis and maintain equilibrium
export const balanceMeanings: Record<number, AdditionalMeaning> = {
1: {
keywords: ['Take Action', 'Be Decisive', 'Lead', 'Assert Yourself'],
description: 'In crisis, you restore balance by taking decisive action',
interpretation: 'When stressed, you handle problems best by taking immediate action. Don\'t overthink - trust your instincts and move forward decisively. Lead the situation rather than waiting.'
},
2: {
keywords: ['Find Compromise', 'Cooperate', 'Stay Calm', 'Seek Support'],
description: 'In crisis, you restore balance through cooperation and patience',
interpretation: 'When stressed, seek support and work with others. Find compromise and middle ground. Stay calm and patient - rushing will make things worse. Let others help you.'
},
3: {
keywords: ['Express Feelings', 'Stay Positive', 'Communicate', 'Find Joy'],
description: 'In crisis, you restore balance by expressing yourself and staying optimistic',
interpretation: 'When stressed, talk it out. Express your feelings creatively or verbally. Maintain optimism and look for the positive. Communication and creative outlets restore your equilibrium.'
},
4: {
keywords: ['Make a Plan', 'Get Organized', 'Work Systematically', 'Be Practical'],
description: 'In crisis, you restore balance through organization and practical planning',
interpretation: 'When stressed, create a systematic plan and work through it step by step. Organization and practical action restore your balance. Break problems into manageable pieces.'
},
5: {
keywords: ['Stay Flexible', 'Adapt', 'Change Perspective', 'Seek Freedom'],
description: 'In crisis, you restore balance by adapting and changing your approach',
interpretation: 'When stressed, stay flexible and be willing to change course. Try different approaches. Sometimes stepping back and gaining perspective through physical movement or change of scenery helps most.'
},
6: {
keywords: ['Take Responsibility', 'Serve Others', 'Create Harmony', 'Beautify'],
description: 'In crisis, you restore balance by taking responsibility and helping others',
interpretation: 'When stressed, focus on service and responsibility. Helping others or creating beauty in your environment restores your balance. Taking care of home and family grounds you.'
},
7: {
keywords: ['Retreat and Reflect', 'Analyze', 'Meditate', 'Seek Truth'],
description: 'In crisis, you restore balance by withdrawing to reflect and analyze',
interpretation: 'When stressed, take time alone to think things through. Analysis, meditation, and spiritual practice restore your equilibrium. Don\'t rush - allow time for deep reflection.'
},
8: {
keywords: ['Take Charge', 'Be Efficient', 'Focus on Solutions', 'Use Authority'],
description: 'In crisis, you restore balance by taking charge and being efficient',
interpretation: 'When stressed, take control of the situation. Focus on efficient, businesslike solutions. Your ability to organize and delegate helps restore balance. Be authoritative but fair.'
},
9: {
keywords: ['Let Go', 'Forgive', 'Look at Big Picture', 'Be Compassionate'],
description: 'In crisis, you restore balance by letting go and seeing the bigger picture',
interpretation: 'When stressed, step back and view the situation with compassion. Sometimes letting go is the answer. Forgiveness (of self and others) and understanding the bigger picture restore your balance.'
},
11: {
keywords: ['Trust Intuition', 'Inspire Others', 'Stay Spiritual', 'Illuminate'],
description: 'In crisis, you restore balance through intuition and spiritual connection',
interpretation: 'When stressed, trust your intuition deeply. Connect with spiritual sources and inspire others with your vision. Your ability to illuminate the path forward restores balance.'
},
22: {
keywords: ['Build Solutions', 'Think Big', 'Manifest Answers', 'Lead Practically'],
description: 'In crisis, you restore balance by building practical solutions to big problems',
interpretation: 'When stressed, focus on building practical solutions. Think big but stay grounded. Your ability to manifest solutions and lead others through difficulty restores balance.'
},
33: {
keywords: ['Heal and Teach', 'Show Compassion', 'Serve Selflessly', 'Guide Others'],
description: 'In crisis, you restore balance by healing and teaching others',
interpretation: 'When stressed, focus on compassionate service. Teaching and healing others actually restores your own balance. Your selfless guidance helps everyone, including yourself.'
}
};

192
advanced-numbers.ts Executable file
View file

@ -0,0 +1,192 @@
#!/usr/bin/env bun
/**
* Advanced Numerology Numbers
*
* Calculate and display additional numerology numbers beyond the core 4:
* - Maturity Number (who you become after 40)
* - Personality Number (how others see you)
* - Hidden Passion Number (your secret talent)
* - Karmic Lessons (numbers missing from your name)
* - Balance Number (how you handle crisis)
*
* Usage:
* bun advanced-numbers.ts --name "John Doe" --birthdate "5/13/1982"
* bun advanced-numbers.ts --name "Jane Smith" --birthdate "11/22/1990" --detailed
*/
import { calculateCoreNumbers, calculateAdditionalNumbers } from './core-calculator';
import {
maturityMeanings,
personalityMeanings,
hiddenPassionMeanings,
karmicLessonMeanings,
balanceMeanings
} from './additional-meanings';
// Parse command line arguments
const args = process.argv.slice(2);
let name = '';
let birthdate = '';
let detailed = false;
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if (args[i] === '--detailed' || args[i] === '-d') {
detailed = true;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Advanced Numerology Numbers
Calculate additional numerology numbers beyond the core 4:
- Maturity Number: Who you become in your mature years (after age 40)
- Personality Number: How others see you (your outer mask)
- Hidden Passion Number: Your deepest hidden talent
- Karmic Lessons: Areas you're here to develop (missing numbers)
- Balance Number: How you handle crisis and stress
USAGE:
bun advanced-numbers.ts --name "Your Name" --birthdate "mm/dd/yyyy" [OPTIONS]
OPTIONS:
-n, --name NAME Your full name [required]
-b, --birthdate DATE Your birthdate (mm/dd/yyyy) [required]
-d, --detailed Show detailed interpretations
-h, --help Show this help message
EXAMPLES:
# Basic calculation
bun advanced-numbers.ts -n "John Doe" -b "5/13/1982"
# Detailed interpretations
bun advanced-numbers.ts -n "Jane Smith" -b "11/22/1990" --detailed
NUMBER EXPLANATIONS:
Maturity Number = Life Path + Expression
Personality Number = Sum of consonants in full name
Hidden Passion = Most frequently occurring number in name
Karmic Lessons = Numbers 1-9 that DON'T appear in your name
Balance Number = Sum of first letter of each name part
`);
process.exit(0);
}
}
if (!name || !birthdate) {
console.error('Error: Both --name and --birthdate are required');
console.error('Try: bun advanced-numbers.ts --help');
process.exit(1);
}
// Calculate numbers
const coreNumbers = calculateCoreNumbers(name, birthdate);
const additionalNumbers = calculateAdditionalNumbers(name, coreNumbers);
// Display results
console.log(`\n═══════════════════════════════════════════════════════════════`);
console.log(` ADVANCED NUMEROLOGY NUMBERS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`Name: ${name}`);
console.log(`Birthdate: ${birthdate}\n`);
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`ADDITIONAL NUMBERS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
// 1. Maturity Number
const maturityMeaning = maturityMeanings[additionalNumbers.maturity];
console.log(`1. 🌟 MATURITY NUMBER: ${additionalNumbers.maturity}`);
console.log(` (Life Path ${coreNumbers.lifePath} + Expression ${coreNumbers.expression} = ${additionalNumbers.maturity})`);
console.log(` Keywords: ${maturityMeaning.keywords.join(', ')}`);
console.log(` ${maturityMeaning.description}`);
if (detailed) {
console.log(`\n 💡 Full Meaning:`);
console.log(` ${maturityMeaning.interpretation}\n`);
} else {
console.log('');
}
// 2. Personality Number
const personalityMeaning = personalityMeanings[additionalNumbers.personality];
console.log(`2. 🎭 PERSONALITY NUMBER: ${additionalNumbers.personality}`);
console.log(` (Consonants in your name)`);
console.log(` Keywords: ${personalityMeaning.keywords.join(', ')}`);
console.log(` ${personalityMeaning.description}`);
if (detailed) {
console.log(`\n 💡 Full Meaning:`);
console.log(` ${personalityMeaning.interpretation}\n`);
} else {
console.log('');
}
// 3. Hidden Passion Number
if (additionalNumbers.hiddenPassion) {
const hiddenPassionMeaning = hiddenPassionMeanings[additionalNumbers.hiddenPassion];
console.log(`3. 🔥 HIDDEN PASSION NUMBER: ${additionalNumbers.hiddenPassion}`);
console.log(` (Appears ${additionalNumbers.hiddenPassionCount} times in your name)`);
console.log(` Keywords: ${hiddenPassionMeaning.keywords.join(', ')}`);
console.log(` ${hiddenPassionMeaning.description}`);
if (detailed) {
console.log(`\n 💡 Full Meaning:`);
console.log(` ${hiddenPassionMeaning.interpretation}\n`);
} else {
console.log('');
}
} else {
console.log(`3. 🔥 HIDDEN PASSION NUMBER: None`);
console.log(` (No number dominates your name)\n`);
}
// 4. Karmic Lessons
console.log(`4. ⚠️ KARMIC LESSONS: ${additionalNumbers.karmicLessons.length > 0 ? additionalNumbers.karmicLessons.join(', ') : 'None'}`);
if (additionalNumbers.karmicLessons.length > 0) {
console.log(` (Numbers missing from your name - areas to develop)\n`);
additionalNumbers.karmicLessons.forEach((lesson, index) => {
const lessonMeaning = karmicLessonMeanings[lesson];
console.log(` ${String.fromCharCode(97 + index)}) Number ${lesson}: ${lessonMeaning.keywords.join(', ')}`);
console.log(` ${lessonMeaning.description}`);
if (detailed) {
console.log(` 💡 ${lessonMeaning.interpretation}`);
}
console.log('');
});
} else {
console.log(` (All numbers 1-9 present - no specific karmic lessons)\n`);
}
// 5. Balance Number
const balanceMeaning = balanceMeanings[additionalNumbers.balance];
console.log(`5. ⚖️ BALANCE NUMBER: ${additionalNumbers.balance}`);
console.log(` (First letter of each name part)`);
console.log(` Keywords: ${balanceMeaning.keywords.join(', ')}`);
console.log(` ${balanceMeaning.description}`);
if (detailed) {
console.log(`\n 💡 Full Meaning:`);
console.log(` ${balanceMeaning.interpretation}\n`);
} else {
console.log('');
}
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`QUICK REFERENCE`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`Maturity (${additionalNumbers.maturity}): ${maturityMeaning.keywords.slice(0, 3).join(', ')}`);
console.log(`Personality (${additionalNumbers.personality}): ${personalityMeaning.keywords.slice(0, 3).join(', ')}`);
if (additionalNumbers.hiddenPassion) {
const hp = hiddenPassionMeanings[additionalNumbers.hiddenPassion];
console.log(`Hidden Passion (${additionalNumbers.hiddenPassion}): ${hp.keywords.slice(0, 3).join(', ')}`);
}
console.log(`Balance (${additionalNumbers.balance}): ${balanceMeaning.keywords.slice(0, 3).join(', ')}`);
if (additionalNumbers.karmicLessons.length > 0) {
console.log(`\nKarmic Lessons: Work on ${additionalNumbers.karmicLessons.map(n => karmicLessonMeanings[n].keywords[0]).join(', ')}`);
}
console.log(`\n💡 Use --detailed flag for full interpretations\n`);

124
archive/numerology.py Executable file
View file

@ -0,0 +1,124 @@
# Numerology
# Core Personality
import meanings
# Functions
# Reduces down to one digit or notifies of master number
def reduce(n, context=""):
master_nums = [11, 22, 33]
if n in master_nums:
if context:
print(f'Master number found in {context}:', n)
return n
total = sum(int(digit) for digit in str(n))
return total if total < 10 else reduce(total, context)
# Changes characters in name to digits and reduces
def name_num(name):
total = 0
for char in name:
x = ord(char) - 96
total += x if x < 10 else sum(int(digit) for digit in str(x))
return total
# Checks for master number, then reduces further as necessary
def master_check(total, context=""):
master_nums = [11, 22, 33]
if total in master_nums:
if context:
print(f'Master number found in {context}:', total)
return total
total = sum(int(digit) for digit in str(total))
return total if total < 10 else sum(int(digit) for digit in str(total))
def pull_vowels(name):
return [letter for letter in name if letter in 'aeiou']
# Asks for the person's full name
name_raw = input("Please enter the person's Full Name: \n").strip()
# Validate name input
while not name_raw or name_raw.isnumeric():
print('Error: Please enter a valid name (letters only).')
name_raw = input("Please enter the person's Full Name: \n").strip()
name = name_raw.lower()
name_split = name.split()
# Ensure the full name has at least first and last name
while len(name_split) < 2:
print('Error: More information needed. Please use at least your First and Last name.')
name_raw = input("Please enter the person's Full Name [First, Middle, Last]: \n").strip()
name = name_raw.lower()
name_split = name.split()
# Asks user for their birthdate
birth_raw = input('What is your full Date of Birth? (mm/dd/yyyy) [eg. 5/13/1982] \n').strip()
# Validate birth date input
while not birth_raw:
print('Error: Birth date cannot be blank.')
birth_raw = input('What is your full Date of Birth? (mm/dd/yyyy) [eg. 5/13/1982] \n').strip()
# Calculations
# Birthday
pieces = birth_raw.split('/')
month = reduce(int(pieces[0]), context="Month")
day = reduce(int(pieces[1]), context="Day")
year = reduce(int(pieces[2]), context="Year")
birth_date = month + day + year
# Life Path
life_path = reduce(birth_date, context="Life Path")
# Birthday
birthday = reduce(day, context="Birthday")
# Name
# Expression (Name)
subname_value = list()
# If name is longer than four subnames, only use first and last name
if len(name_split) > 4:
subname_value.append(reduce(master_check(name_num(name_split[0]), context="First Name"), context="First Name"))
subname_value.append(reduce(master_check(name_num(name_split[-1]), context="Last Name"), context="Last Name"))
else:
for subname in name_split:
subname_value.append(reduce(master_check(name_num(subname), context=f"Subname: {subname}"), context=f"Subname: {subname}"))
expression = master_check(reduce(sum(subname_value)), context="Expression")
# Soul Urge (Vowels)
subname_vowels = list()
for subname in name_split:
subname_vowels.append(master_check(name_num(pull_vowels(subname)), context=f"Vowels in {subname}"))
soul_urge = master_check(reduce(sum(subname_vowels)), context="Soul Urge")
# Core Output
print('\nCore for', name_raw,'\n')
# Core 1: Life Path (Birth Date)
print('1: Life Path:', life_path)
# Core 2: Expression (Name)
print('2: Expression:', expression)
# Core 3: Soul Urge (Vowels)
print("3: Soul Urge:", soul_urge)
# Core 4: Birthday
print('4: Birthday:', birthday)
# Detailed output
print('\nDetailed Meanings:\n')
# Life Path meaning
print(f'Life Path {life_path}:\n{meanings.life_path[life_path]}\n')
# Expression meaning
print(f'Expression {expression}:\n{meanings.expression[expression]}\n')
# Soul Urge meaning
print(f'Soul Urge {soul_urge}:\n{meanings.soul_urge[soul_urge]}\n')
# Birthday meaning
print(f'Birthday {birthday}:\n{meanings.birthday[birthday]}\n')

128
archive/r_num.py Executable file
View file

@ -0,0 +1,128 @@
import meanings
from typing import List
from colorama import Fore, Style, init
init(autoreset=True)
MASTER_NUMS = [11, 22, 33]
def reduce(n: int, context: str = "") -> int:
"""Reduces a number to a single digit or returns a master number with context."""
if n in MASTER_NUMS:
if context:
print(f'{Fore.YELLOW}Master number found in {context}: {n}')
return n
total = sum(int(digit) for digit in str(n))
return total if total < 10 else reduce(total, context)
def name_num(name: str) -> int:
"""Converts a name to a number by reducing each character to its numerical value."""
return sum(
(ord(char) - 96 if ord(char) - 96 < 10 else sum(int(digit) for digit in str(ord(char) - 96)))
for char in name
)
def master_check(total: int, context: str = "") -> int:
"""Checks for master number and reduces further if necessary, with context."""
if total in MASTER_NUMS:
if context:
print(f'{Fore.YELLOW}Master number found in {context}: {total}')
return total
total = sum(int(digit) for digit in str(total))
return total if total < 10 else sum(int(digit) for digit in str(total))
def pull_vowels(name: str) -> List[str]:
"""Extracts vowels from a given name."""
return [letter for letter in name if letter in 'aeiou']
def get_user_input(prompt: str) -> str:
"""Gets input from the user with a prompt, ensuring it is not blank."""
user_input = input(prompt).strip()
while not user_input:
print('Error: Input cannot be blank.')
user_input = input(prompt).strip()
return user_input
def validate_name(name: str) -> str:
"""Validates the user's name input."""
while not name or name.isnumeric():
print('Error: Please enter a valid name (letters only).')
name = get_user_input("Please enter the person's Full Name: \n")
return name.lower()
def validate_birthdate(birthdate: str) -> str:
"""Validates the user's birthdate input."""
while not birthdate:
print('Error: Birth date cannot be blank.')
birthdate = get_user_input('What is your full Date of Birth? (mm/dd/yyyy) [eg. 5/13/1982] \n')
return birthdate
def split_name(name: str) -> List[str]:
"""Splits the name into subnames and ensures at least first and last name are provided."""
name_split = name.split()
while len(name_split) < 2:
print('Error: More information needed. Please use at least your First and Last name.')
name = get_user_input("Please enter the person's Full Name [First, Middle, Last]: \n").lower()
name_split = name.split()
return name_split
def calculate_numbers(name_split: List[str], birth_raw: str):
"""Calculates Life Path, Expression, Soul Urge, and Birthday numbers."""
pieces = birth_raw.split('/')
month = reduce(int(pieces[0]), context="Month")
day = reduce(int(pieces[1]), context="Day")
year = reduce(int(pieces[2]), context="Year")
birth_date = month + day + year
life_path = reduce(birth_date, context="Life Path")
birthday = reduce(day, context="Birthday")
subname_value = []
if len(name_split) > 4:
subname_value.append(reduce(master_check(name_num(name_split[0]), context="First Name"), context="First Name"))
subname_value.append(reduce(master_check(name_num(name_split[-1]), context="Last Name"), context="Last Name"))
else:
for subname in name_split:
subname_value.append(reduce(master_check(name_num(subname), context=f"Subname: {subname}"), context=f"Subname: {subname}"))
expression = master_check(reduce(sum(subname_value)), context="Expression")
subname_vowels = []
for subname in name_split:
subname_vowels.append(master_check(name_num(pull_vowels(subname)), context=f"Vowels in {subname}"))
soul_urge = master_check(reduce(sum(subname_vowels)), context="Soul Urge")
return life_path, expression, soul_urge, birthday
def print_core_output(name_raw: str, life_path: int, expression: int, soul_urge: int, birthday: int):
"""Prints the core numerology output."""
print(f'\n{Fore.CYAN}Core for {name_raw}\n')
print(f'{Fore.GREEN}1: Life Path: {Fore.RESET}{life_path}')
print(f'{Fore.GREEN}2: Expression: {Fore.RESET}{expression}')
print(f'{Fore.GREEN}3: Soul Urge: {Fore.RESET}{soul_urge}')
print(f'{Fore.GREEN}4: Birthday: {Fore.RESET}{birthday}')
def print_detailed_output(life_path: int, expression: int, soul_urge: int, birthday: int):
"""Prints detailed numerology meanings."""
print('\nDetailed Meanings:\n')
print(f'{Fore.BLUE}Life Path {life_path}:\n{Style.RESET_ALL}{meanings.life_path[life_path]}\n')
print(f'{Fore.BLUE}Expression {expression}:\n{Style.RESET_ALL}{meanings.expression[expression]}\n')
print(f'{Fore.BLUE}Soul Urge {soul_urge}:\n{Style.RESET_ALL}{meanings.soul_urge[soul_urge]}\n')
print(f'{Fore.BLUE}Birthday {birthday}:\n{Style.RESET_ALL}{meanings.birthday[birthday]}\n')
def main():
name_raw = get_user_input("Please enter the person's Full Name: \n")
name = validate_name(name_raw)
name_split = split_name(name)
birth_raw = validate_birthdate(get_user_input('What is your full Date of Birth? (mm/dd/yyyy) [eg. 5/13/1982] \n'))
print() # Add a blank line for better readability
life_path, expression, soul_urge, birthday = calculate_numbers(name_split, birth_raw)
print_core_output(name_raw, life_path, expression, soul_urge, birthday)
print_detailed_output(life_path, expression, soul_urge, birthday)
if __name__ == "__main__":
main()

1
archive/requirements.txt Normal file
View file

@ -0,0 +1 @@
colorama==0.4.4

415
compatibility.ts Executable file
View file

@ -0,0 +1,415 @@
#!/usr/bin/env bun
/**
* Numerology Compatibility Analyzer
*
* Compare two people's numerology charts to understand relationship dynamics,
* strengths, challenges, and best collaboration strategies.
*
* Perfect for: Romantic relationships, business partnerships, parent-child dynamics,
* team collaboration, friendships, and any two-person dynamic.
*
* Usage:
* bun compatibility.ts --person1 "John Doe:5/13/1982" --person2 "Jane Smith:11/22/1990"
* bun compatibility.ts --p1 "Alice:3/14/1985" --p2 "Bob:7/7/1980" --type business
*/
import { calculateCoreNumbers, type CoreNumbers } from './core-calculator';
// Parse command line arguments
const args = process.argv.slice(2);
let person1Data = '';
let person2Data = '';
let relationshipType = 'general';
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--person1' || args[i] === '--p1') && args[i + 1]) {
person1Data = args[i + 1];
i++;
} else if ((args[i] === '--person2' || args[i] === '--p2') && args[i + 1]) {
person2Data = args[i + 1];
i++;
} else if ((args[i] === '--type' || args[i] === '-t') && args[i + 1]) {
relationshipType = args[i + 1].toLowerCase();
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Numerology Compatibility Analyzer
Compare two people's numerology charts for relationship insights.
USAGE:
bun compatibility.ts --person1 "Name:mm/dd/yyyy" --person2 "Name:mm/dd/yyyy"
OPTIONS:
--person1, --p1 First person (format: "Name:mm/dd/yyyy")
--person2, --p2 Second person (format: "Name:mm/dd/yyyy")
--type, -t Relationship type [general, romantic, business, family, friendship]
--help, -h Show this help message
EXAMPLES:
# Romantic relationship
bun compatibility.ts --p1 "John:5/13/1982" --p2 "Jane:11/22/1990" --type romantic
# Business partnership
bun compatibility.ts --p1 "Alice:3/14/1985" --p2 "Bob:7/7/1980" --type business
# General compatibility
bun compatibility.ts --p1 "Parent:1/1/1970" --p2 "Child:5/15/2010"
RELATIONSHIP TYPES:
general - Overall compatibility analysis
romantic - Love, marriage, intimate partnership
business - Work collaboration, business partners
family - Parent-child, siblings, relatives
friendship - Platonic relationships, social bonds
`);
process.exit(0);
}
}
if (!person1Data || !person2Data) {
console.error('Error: Both --person1 and --person2 are required');
console.error('Format: "Name:mm/dd/yyyy"');
console.error('Try: bun compatibility.ts --help');
process.exit(1);
}
// Parse person data
function parsePerson(data: string): { name: string; birthdate: string } {
const parts = data.split(':');
if (parts.length !== 2) {
console.error(`Error: Invalid format "${data}". Expected "Name:mm/dd/yyyy"`);
process.exit(1);
}
return { name: parts[0].trim(), birthdate: parts[1].trim() };
}
const person1 = parsePerson(person1Data);
const person2 = parsePerson(person2Data);
// Calculate core numbers for both
const chart1 = calculateCoreNumbers(person1.name, person1.birthdate);
const chart2 = calculateCoreNumbers(person2.name, person2.birthdate);
// Compatibility scoring
interface CompatibilityScore {
lifePath: number;
expression: number;
soulUrge: number;
overall: number;
}
function calculateCompatibility(c1: CoreNumbers, c2: CoreNumbers): CompatibilityScore {
const lifePath = scoreNumberPair(c1.lifePath, c2.lifePath);
const expression = scoreNumberPair(c1.expression, c2.expression);
const soulUrge = scoreNumberPair(c1.soulUrge, c2.soulUrge);
// Overall is weighted average (Life Path most important)
const overall = Math.round((lifePath * 0.4 + expression * 0.3 + soulUrge * 0.3));
return { lifePath, expression, soulUrge, overall };
}
// Score number pair compatibility (1-10 scale)
function scoreNumberPair(n1: number, n2: number): number {
// Reduce master numbers to base for compatibility
const num1 = n1 > 9 ? (n1 === 11 ? 2 : n1 === 22 ? 4 : 6) : n1;
const num2 = n2 > 9 ? (n2 === 11 ? 2 : n2 === 22 ? 4 : 6) : n2;
// Same number = high compatibility
if (num1 === num2) return 9;
// Compatibility matrix (simplified)
const compatibilityMatrix: Record<number, Record<number, number>> = {
1: { 2: 6, 3: 8, 4: 5, 5: 7, 6: 6, 7: 7, 8: 8, 9: 7 },
2: { 1: 6, 3: 7, 4: 8, 5: 5, 6: 9, 7: 6, 8: 8, 9: 8 },
3: { 1: 8, 2: 7, 4: 6, 5: 9, 6: 8, 7: 6, 8: 7, 9: 9 },
4: { 1: 5, 2: 8, 3: 6, 5: 6, 6: 8, 7: 7, 8: 9, 9: 6 },
5: { 1: 7, 2: 5, 3: 9, 4: 6, 6: 6, 7: 8, 8: 7, 9: 7 },
6: { 1: 6, 2: 9, 3: 8, 4: 8, 5: 6, 7: 7, 8: 7, 9: 9 },
7: { 1: 7, 2: 6, 3: 6, 4: 7, 5: 8, 6: 7, 8: 6, 9: 8 },
8: { 1: 8, 2: 8, 3: 7, 4: 9, 5: 7, 6: 7, 7: 6, 9: 7 },
9: { 1: 7, 2: 8, 3: 9, 4: 6, 5: 7, 6: 9, 7: 8, 8: 7 }
};
return compatibilityMatrix[num1]?.[num2] || 5;
}
// Compatibility descriptions
function getCompatibilityLevel(score: number): { level: string; emoji: string; description: string } {
if (score >= 9) return {
level: 'Excellent',
emoji: '💚',
description: 'Natural harmony and strong connection'
};
if (score >= 7) return {
level: 'Very Good',
emoji: '💙',
description: 'Compatible with minor adjustments needed'
};
if (score >= 5) return {
level: 'Moderate',
emoji: '💛',
description: 'Workable with conscious effort'
};
if (score >= 3) return {
level: 'Challenging',
emoji: '🧡',
description: 'Requires significant work and understanding'
};
return {
level: 'Difficult',
emoji: '❤️',
description: 'Major differences need bridging'
};
}
// Life Path compatibility insights
const lifePathInsights: Record<string, { strengths: string[]; challenges: string[]; advice: string }> = {
'1-1': {
strengths: ['Both independent and driven', 'Mutual respect for ambition', 'High energy dynamic'],
challenges: ['Power struggles possible', 'Both want to lead', 'Competitive tension'],
advice: 'Take turns leading. Create separate domains where each person has authority.'
},
'1-2': {
strengths: ['1 leads, 2 supports perfectly', 'Complementary energies', '1 inspires, 2 refines'],
challenges: ['2 may feel overshadowed', '1 may seem too aggressive', 'Balance of power needed'],
advice: '1: Value 2\'s input. 2: Speak up when needed. Balance independence with togetherness.'
},
'2-2': {
strengths: ['Deep emotional connection', 'Both diplomatic and sensitive', 'Natural harmony'],
challenges: ['Both indecisive', 'May avoid necessary conflict', 'Codependence risk'],
advice: 'Practice making decisions independently. One person take charge when needed.'
},
'3-3': {
strengths: ['Creative synergy', 'Fun and social together', 'Inspiring partnership'],
challenges: ['Both scattered', 'Lack of grounding', 'Too much surface, not enough depth'],
advice: 'Build in structure. Balance fun with responsibility. Ground your creativity.'
},
'3-5': {
strengths: ['Excitement and adventure', 'Freedom-loving duo', 'Creative exploration'],
challenges: ['Both avoid routine', 'Lack of stability', 'Commitment issues'],
advice: 'Establish some routines together. Balance adventure with security.'
},
'4-4': {
strengths: ['Both reliable and stable', 'Build solid foundations together', 'Shared work ethic'],
challenges: ['Both rigid', 'Too routine', 'Lack of spontaneity'],
advice: 'Schedule fun and adventure. Allow flexibility. Don\'t let work consume everything.'
},
'4-8': {
strengths: ['Powerful building duo', 'Material success likely', 'Ambitious partnership'],
challenges: ['Both workaholic', 'Emotions neglected', 'All work, no play'],
advice: 'Prioritize emotional connection. Balance ambition with intimacy.'
},
'5-5': {
strengths: ['Freedom and change', 'Adventurous partnership', 'Never boring'],
challenges: ['No stability', 'Commitment difficult', 'Restless energy'],
advice: 'Create flexible commitments. Establish home base. Ground your freedom.'
},
'6-6': {
strengths: ['Nurturing and caring', 'Home and family focused', 'Service-oriented'],
challenges: ['Both controlling', 'Martyr complex', 'Neglect of self'],
advice: 'Practice receiving. Set boundaries. Take care of yourselves too.'
},
'6-9': {
strengths: ['Service and compassion', 'Humanitarian goals', 'Caring partnership'],
challenges: ['Both give too much', 'Boundary issues', 'Burnout risk'],
advice: 'Fill your own cup first. Say no sometimes. Balance giving with receiving.'
},
'7-7': {
strengths: ['Deep intellectual bond', 'Spiritual connection', 'Mutual understanding'],
challenges: ['Both withdraw', 'Isolation together', 'Lack of action'],
advice: 'Engage with the world. Balance introspection with activity. Share your thoughts.'
},
'8-8': {
strengths: ['Power couple', 'Material success', 'Ambitious partnership'],
challenges: ['Power struggles', 'Both controlling', 'Work over relationship'],
advice: 'Create separate domains. Balance power. Make time for intimacy.'
},
'9-9': {
strengths: ['Humanitarian vision', 'Compassionate partnership', 'Idealistic goals'],
challenges: ['Both emotionally complex', 'Drama potential', 'Impractical together'],
advice: 'Stay grounded. Balance idealism with practicality. Clear boundaries.'
},
'1-3': {
strengths: ['Action meets creativity', '1 executes 3\'s ideas', 'Dynamic energy'],
challenges: ['1 too serious for 3', '3 too scattered for 1', 'Different paces'],
advice: '1: Lighten up. 3: Follow through. Appreciate different strengths.'
},
'1-5': {
strengths: ['Freedom-loving duo', 'Adventurous partnership', 'Independent together'],
challenges: ['Both self-focused', 'Commitment issues', 'Competitive'],
advice: 'Make time for togetherness. Balance independence with intimacy.'
},
'2-6': {
strengths: ['Nurturing harmony', 'Both caring', 'Natural partnership'],
challenges: ['Both give too much', 'Codependence risk', 'Need to receive'],
advice: 'Practice receiving. Set boundaries. Take care of yourselves.'
},
'3-6': {
strengths: ['Creative family', 'Joy and nurturing', 'Social and caring'],
challenges: ['3 scattered, 6 responsible', '6 too serious for 3', 'Different priorities'],
advice: '6: Allow play. 3: Help with responsibilities. Balance fun and duty.'
},
'4-7': {
strengths: ['Practical meets spiritual', 'Deep thinking + grounded', 'Quality focus'],
challenges: ['4 too mundane for 7', '7 too abstract for 4', 'Different worlds'],
advice: '4: Honor 7\'s spirituality. 7: Appreciate 4\'s practicality. Bridge worlds.'
},
'5-7': {
strengths: ['Freedom and wisdom', 'Adventurous spirit', 'Independent thinking'],
challenges: ['5 too social for 7', '7 too withdrawn for 5', 'Different social needs'],
advice: 'Respect different needs. 5: Give space. 7: Engage sometimes.'
},
'1-9': {
strengths: ['Leadership meets compassion', 'Pioneer + humanitarian', 'Visionary partnership'],
challenges: ['1 self-focused, 9 others-focused', 'Different priorities', 'Ego vs service'],
advice: '1: Think beyond self. 9: Set boundaries. Find common mission.'
}
};
// Get insights for Life Path pair
function getLifePathInsights(lp1: number, lp2: number): { strengths: string[]; challenges: string[]; advice: string } {
const key1 = `${lp1}-${lp2}`;
const key2 = `${lp2}-${lp1}`;
return lifePathInsights[key1] || lifePathInsights[key2] || {
strengths: ['Unique combination', 'Potential for growth', 'Complementary lessons'],
challenges: ['Different paths', 'Understanding needed', 'Bridge differences'],
advice: 'Focus on what you can learn from each other. Embrace differences as growth opportunities.'
};
}
// Calculate scores
const scores = calculateCompatibility(chart1, chart2);
// Output
console.log(`\n═══════════════════════════════════════════════════════════════`);
console.log(`💑 NUMEROLOGY COMPATIBILITY ANALYSIS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`${person1.name} & ${person2.name}`);
console.log(`Relationship Type: ${relationshipType.charAt(0).toUpperCase() + relationshipType.slice(1)}\n`);
// Overall compatibility
const overall = getCompatibilityLevel(scores.overall);
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`OVERALL COMPATIBILITY: ${overall.emoji} ${overall.level.toUpperCase()} (${scores.overall}/10)`);
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`${overall.description}\n`);
// Individual charts
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`INDIVIDUAL CHARTS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`${person1.name}:`);
console.log(` Life Path: ${chart1.lifePath}${chart1.lifePath > 9 ? ' (Master Number)' : ''}`);
console.log(` Expression: ${chart1.expression}${chart1.expression > 9 ? ' (Master Number)' : ''}`);
console.log(` Soul Urge: ${chart1.soulUrge}${chart1.soulUrge > 9 ? ' (Master Number)' : ''}`);
console.log(` Birthday: ${chart1.birthday}\n`);
console.log(`${person2.name}:`);
console.log(` Life Path: ${chart2.lifePath}${chart2.lifePath > 9 ? ' (Master Number)' : ''}`);
console.log(` Expression: ${chart2.expression}${chart2.expression > 9 ? ' (Master Number)' : ''}`);
console.log(` Soul Urge: ${chart2.soulUrge}${chart2.soulUrge > 9 ? ' (Master Number)' : ''}`);
console.log(` Birthday: ${chart2.birthday}\n`);
// Detailed compatibility breakdown
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`DETAILED COMPATIBILITY BREAKDOWN`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const lpCompat = getCompatibilityLevel(scores.lifePath);
console.log(`💚 LIFE PATH COMPATIBILITY (${scores.lifePath}/10) - ${lpCompat.level}`);
console.log(` ${person1.name}: ${chart1.lifePath} | ${person2.name}: ${chart2.lifePath}`);
console.log(` ${lpCompat.description}\n`);
const exprCompat = getCompatibilityLevel(scores.expression);
console.log(`💙 EXPRESSION COMPATIBILITY (${scores.expression}/10) - ${exprCompat.level}`);
console.log(` ${person1.name}: ${chart1.expression} | ${person2.name}: ${chart2.expression}`);
console.log(` How you work and express yourselves together\n`);
const soulCompat = getCompatibilityLevel(scores.soulUrge);
console.log(`💜 SOUL URGE COMPATIBILITY (${scores.soulUrge}/10) - ${soulCompat.level}`);
console.log(` ${person1.name}: ${chart1.soulUrge} | ${person2.name}: ${chart2.soulUrge}`);
console.log(` Deep inner desires and motivations\n`);
// Life Path specific insights
const insights = getLifePathInsights(chart1.lifePath, chart2.lifePath);
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`RELATIONSHIP DYNAMICS (Life Path ${chart1.lifePath} & ${chart2.lifePath})`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`✅ STRENGTHS:`);
insights.strengths.forEach(s => console.log(` • ${s}`));
console.log('');
console.log(`⚠️ CHALLENGES:`);
insights.challenges.forEach(c => console.log(` • ${c}`));
console.log('');
console.log(`💡 ADVICE:`);
console.log(` ${insights.advice}\n`);
// Relationship-specific guidance
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`${relationshipType.toUpperCase()} RELATIONSHIP GUIDANCE`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
if (relationshipType === 'romantic') {
console.log(`💕 ROMANTIC RELATIONSHIP:`);
console.log(` • Emotional compatibility: Focus on Soul Urge alignment`);
console.log(` • Long-term potential: Life Path compatibility is key`);
console.log(` • Daily harmony: Expression numbers show day-to-day interaction`);
console.log(` • Communication: Express your soul urges openly and honestly\n`);
} else if (relationshipType === 'business') {
console.log(`💼 BUSINESS PARTNERSHIP:`);
console.log(` • Working style: Expression numbers show collaboration style`);
console.log(` • Shared vision: Life Path shows long-term alignment`);
console.log(` • Motivation: Soul Urge reveals what drives each person`);
console.log(` • Division of labor: Play to each person's Expression strengths\n`);
} else if (relationshipType === 'family') {
console.log(`👨‍👩‍👧‍👦 FAMILY RELATIONSHIP:`);
console.log(` • Understanding: Life Path shows core life lessons`);
console.log(` • Communication: Expression numbers affect interaction style`);
console.log(` • Deep needs: Soul Urge reveals what each person truly needs`);
console.log(` • Patience: Honor different paths and timings\n`);
} else if (relationshipType === 'friendship') {
console.log(`🤝 FRIENDSHIP:`);
console.log(` • Common interests: Expression numbers show shared activities`);
console.log(` • Life philosophy: Life Path shows worldview alignment`);
console.log(` • Emotional support: Soul Urge shows how you support each other`);
console.log(` • Fun factor: Compatible Expression = enjoyable time together\n`);
} else {
console.log(`🌟 GENERAL COMPATIBILITY:`);
console.log(` • Life Path: Core life direction and purpose`);
console.log(` • Expression: How you interact and work together`);
console.log(` • Soul Urge: Deep compatibility of desires and motivations`);
console.log(` • Overall: Balance all three for full picture\n`);
}
// Key takeaways
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`KEY TAKEAWAYS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
if (scores.overall >= 8) {
console.log(`✨ This is a naturally harmonious pairing with strong potential.`);
console.log(` Focus on appreciating your compatibility while respecting differences.\n`);
} else if (scores.overall >= 6) {
console.log(`💫 Good compatibility with room for growth.`);
console.log(` Success requires communication and mutual understanding.\n`);
} else if (scores.overall >= 4) {
console.log(`⚡ Moderate compatibility - conscious effort needed.`);
console.log(` This relationship requires work but can teach valuable lessons.\n`);
} else {
console.log(`🔥 Challenging compatibility - major growth opportunity.`);
console.log(` Success requires exceptional communication, patience, and commitment.\n`);
}
console.log(`Remember: Numerology shows tendencies, not destiny.`);
console.log(`Any relationship can work with awareness, effort, and love.\n`);
console.log(`✨ Generated with Numerology Compatibility Analyzer\n`);

175
core-calculator.ts Normal file
View file

@ -0,0 +1,175 @@
/**
* Core Numerology Calculator
* Shared functions for calculating Life Path, Expression, Soul Urge, Birthday
*/
const MASTER_NUMBERS = [11, 22, 33];
export function reduce(n: number): number {
if (MASTER_NUMBERS.includes(n)) return n;
const total = String(n).split('').reduce((sum, digit) => sum + parseInt(digit), 0);
return total < 10 ? total : reduce(total);
}
function nameToNumber(name: string): number {
const cleaned = name.toLowerCase().replace(/[^a-z]/g, '');
let total = 0;
for (const char of cleaned) {
const value = char.charCodeAt(0) - 96;
total += value < 10 ? value : reduce(value);
}
return total;
}
function masterCheck(total: number): number {
if (MASTER_NUMBERS.includes(total)) return total;
const reduced = String(total).split('').reduce((sum, digit) => sum + parseInt(digit), 0);
return reduced < 10 ? reduced : reduce(reduced);
}
function extractVowels(name: string): string {
return name.toLowerCase().replace(/[^aeiou]/g, '');
}
function extractConsonants(name: string): string {
return name.toLowerCase().replace(/[^bcdfghjklmnpqrstvwxyz]/g, '');
}
function letterToNumber(letter: string): number {
const value = letter.toLowerCase().charCodeAt(0) - 96;
return value;
}
export interface CoreNumbers {
lifePath: number;
expression: number;
soulUrge: number;
birthday: number;
}
export interface AdditionalNumbers {
maturity: number;
personality: number;
hiddenPassion: number | null;
hiddenPassionCount: number;
karmicLessons: number[];
balance: number;
}
export function calculateCoreNumbers(name: string, birthdate: string): CoreNumbers {
// Parse birthdate
const parts = birthdate.split('/');
const month = parseInt(parts[0]);
const day = parseInt(parts[1]);
const year = parseInt(parts[2]);
// Life Path
const monthReduced = reduce(month);
const dayReduced = reduce(day);
const yearReduced = reduce(year);
const birthDateSum = monthReduced + dayReduced + yearReduced;
const lifePath = reduce(birthDateSum);
// Birthday
const birthday = reduce(day);
// Expression (from full name)
const nameParts = name.trim().split(/\s+/);
const namesToUse = nameParts.length > 4
? [nameParts[0], nameParts[nameParts.length - 1]]
: nameParts;
let expressionTotal = 0;
for (const part of namesToUse) {
const value = nameToNumber(part);
const checked = masterCheck(value);
expressionTotal += checked;
}
const expression = masterCheck(reduce(expressionTotal));
// Soul Urge (from vowels)
let soulUrgeTotal = 0;
for (const part of nameParts) {
const vowels = extractVowels(part);
if (vowels) {
const value = nameToNumber(vowels);
const checked = masterCheck(value);
soulUrgeTotal += checked;
}
}
const soulUrge = masterCheck(reduce(soulUrgeTotal));
return { lifePath, expression, soulUrge, birthday };
}
export function calculateAdditionalNumbers(
name: string,
coreNumbers: CoreNumbers
): AdditionalNumbers {
const nameParts = name.trim().split(/\s+/);
const fullName = name.trim();
// 1. Maturity Number (Life Path + Expression)
const maturitySum = coreNumbers.lifePath + coreNumbers.expression;
const maturity = reduce(maturitySum);
// 2. Personality Number (consonants in full name)
let personalityTotal = 0;
for (const part of nameParts) {
const consonants = extractConsonants(part);
if (consonants) {
const value = nameToNumber(consonants);
const checked = masterCheck(value);
personalityTotal += checked;
}
}
const personality = masterCheck(reduce(personalityTotal));
// 3. Hidden Passion Number (most frequent letter value)
const letterCounts: Record<number, number> = {};
const cleanedName = fullName.toLowerCase().replace(/[^a-z]/g, '');
for (const char of cleanedName) {
const num = letterToNumber(char);
const reduced = reduce(num);
letterCounts[reduced] = (letterCounts[reduced] || 0) + 1;
}
let hiddenPassion: number | null = null;
let hiddenPassionCount = 0;
for (const [num, count] of Object.entries(letterCounts)) {
if (count > hiddenPassionCount) {
hiddenPassionCount = count;
hiddenPassion = parseInt(num);
}
}
// 4. Karmic Lessons (missing numbers 1-9)
const karmicLessons: number[] = [];
for (let i = 1; i <= 9; i++) {
if (!letterCounts[i]) {
karmicLessons.push(i);
}
}
// 5. Balance Number (first letter of each name part)
let balanceTotal = 0;
for (const part of nameParts) {
if (part.length > 0) {
const firstLetter = part[0];
const num = letterToNumber(firstLetter);
balanceTotal += num;
}
}
const balance = reduce(balanceTotal);
return {
maturity,
personality,
hiddenPassion,
hiddenPassionCount,
karmicLessons,
balance
};
}

434
cycle-meanings.ts Normal file
View file

@ -0,0 +1,434 @@
/**
* Numerology Cycle Meanings
*
* Interpretations for Personal and Universal cycles
* Numbers have different meanings in cycle positions vs core numbers
*
* MASTER NUMBERS (Higher Vibrations):
* - 11 is a higher vibration of 2 (Cooperation → Spiritual Inspiration)
* - 22 is a higher vibration of 4 (Foundation → Master Building)
* - 33 is a higher vibration of 6 (Service → Master Teaching/Healing)
*
* Master numbers carry BOTH the base and master energy simultaneously.
* For example, Year 33 includes both Year 6's service and Year 33's master teaching.
*/
export interface CycleMeaning {
keywords: string[];
description?: string; // 2-3 sentence overview
theme: string;
opportunities: string[];
challenges: string[];
advice: string;
bestFor: string[];
avoidDoing: string[];
}
// Personal Year Cycle Meanings (9-year cycle)
export const personalYear: Record<number, CycleMeaning> = {
1: {
keywords: ["New Beginnings", "Independence", "Initiative", "Leadership"],
description: "Welcome to your Personal Year 1 - the beginning of a brand new 9-year cycle! This is your year to plant seeds for the future, reinvent yourself, and step boldly into new territory. Everything you initiate now sets the tone for the next nine years, so choose wisely and act courageously.",
theme: "Plant seeds for a new 9-year cycle. Time to start fresh, take initiative, and establish independence.",
opportunities: [
"Starting new projects or ventures",
"Reinventing yourself",
"Taking leadership roles",
"Breaking free from the past",
"Setting intentions for the next 9 years"
],
challenges: [
"Fear of starting over",
"Resistance to change",
"Impatience with progress",
"Loneliness while pioneering"
],
advice: "Take bold action. This is YOUR year. Don't wait for others. Be courageous and start what you've been dreaming about.",
bestFor: ["Launching businesses", "Moving", "Starting relationships", "Career changes", "Beginning education"],
avoidDoing: ["Staying stuck in old patterns", "Depending on others", "Being passive", "Waiting for permission"]
},
2: {
keywords: ["Patience", "Cooperation", "Relationships", "Details"],
description: "After last year's bold initiatives, Personal Year 2 asks you to slow down and nurture what you planted. This is a year of patience, cooperation, and building strong partnerships. Progress happens behind the scenes as you develop relationships, refine details, and learn the art of diplomacy.",
theme: "Nurture what was planted last year. Focus on partnerships, patience, and attention to detail.",
opportunities: [
"Building partnerships and alliances",
"Developing relationships",
"Attention to details",
"Diplomacy and mediation",
"Inner development"
],
challenges: [
"Impatience with slow progress",
"Oversensitivity",
"Indecision",
"Co-dependency"
],
advice: "Be patient. Progress happens behind the scenes. Focus on cooperation, not competition. Details matter now.",
bestFor: ["Marriage/commitment", "Collaborations", "Learning patience", "Deepening friendships", "Mediation work"],
avoidDoing: ["Forcing progress", "Going solo", "Ignoring details", "Making hasty decisions"]
},
3: {
keywords: ["Expression", "Creativity", "Joy", "Social Activity"],
description: "Personal Year 3 brings creative energy, social opportunities, and pure joy! After the patience of Year 2, you're ready to bloom. This is your time to express yourself, share your talents, and enjoy life. Your creative projects come to fruition and your social circle expands naturally.",
theme: "Express yourself! Time to bloom. Creative projects flourish. Social life expands. Joy returns.",
opportunities: [
"Creative projects coming to fruition",
"Public speaking or performing",
"Writing and communication",
"Social networking",
"Artistic expression"
],
challenges: [
"Scattering energy",
"Superficiality",
"Overcommitting socially",
"Not finishing projects"
],
advice: "Let yourself shine! Express your creativity. Network and socialize. Don't take life too seriously this year.",
bestFor: ["Launching creative projects", "Public speaking", "Writing books", "Expanding social circles", "Performing"],
avoidDoing: ["Isolating", "Being too serious", "Suppressing creativity", "Scattered focus"]
},
4: {
keywords: ["Hard Work", "Foundation", "Discipline", "Structure"],
description: "Personal Year 4 is about rolling up your sleeves and building something that lasts. This is a year of hard work, organization, and creating solid foundations for your future. While it may feel challenging at times, the structures you build now will support you for years to come.",
theme: "Build solid foundations. Work hard and create lasting structures. Organization and discipline are key.",
opportunities: [
"Building lasting foundations",
"Financial planning and organization",
"Physical fitness and health",
"Home improvements",
"Career advancement through effort"
],
challenges: [
"Feeling overwhelmed by work",
"Rigidity",
"Burnout",
"Resistance to necessary effort"
],
advice: "Roll up your sleeves. This is a work year. Build something that lasts. Get organized. Be disciplined.",
bestFor: ["Buying property", "Starting businesses with solid plans", "Fitness goals", "Financial restructuring"],
avoidDoing: ["Cutting corners", "Being lazy", "Avoiding responsibility", "Resisting structure"]
},
5: {
keywords: ["Change", "Freedom", "Adventure", "Expansion"],
description: "Personal Year 5 brings dynamic change, freedom, and adventure! After the hard work of Year 4, you're ready to break free and explore. This is a year of unexpected opportunities, travel, and personal expansion. Embrace the changes that come - they're liberating you from limitations.",
theme: "Freedom and change! Travel, explore, and embrace new experiences. Break free from limitations.",
opportunities: [
"Travel and adventure",
"Major life changes",
"Learning new skills",
"Breaking free from restrictions",
"Expanding horizons"
],
challenges: [
"Restlessness and chaos",
"Lack of commitment",
"Impulsiveness",
"Excess and addiction"
],
advice: "Embrace change! Take risks. Travel. Try new things. Don't commit to long-term plans this year.",
bestFor: ["Travel", "Moving", "Changing careers", "Exploring new relationships", "Learning new skills"],
avoidDoing: ["Long-term commitments", "Staying stuck", "Resisting change", "Playing it safe"]
},
6: {
keywords: ["Responsibility", "Family", "Service", "Home"],
description: "Personal Year 6 calls you home - to family, relationships, and responsibilities. After the freedom of Year 5, you're ready to create harmony, serve others, and build a beautiful home life. This is a year for marriage, family commitments, and creating environments of love and beauty.",
theme: "Focus on home, family, and responsibilities. Time to serve others and create harmony.",
opportunities: [
"Marriage and family commitments",
"Home improvement or moving",
"Caring for others",
"Counseling or teaching",
"Creating beauty and harmony"
],
challenges: [
"Becoming overwhelmed by others' needs",
"Perfectionism",
"Martyrdom",
"Meddling in others' affairs"
],
advice: "Embrace responsibility. Focus on family and home. Serve others but maintain boundaries.",
bestFor: ["Getting married", "Having children", "Caring for parents", "Home projects", "Teaching"],
avoidDoing: ["Neglecting self-care", "Being controlling", "Martyrdom", "Avoiding responsibility"]
},
7: {
keywords: ["Introspection", "Spirituality", "Analysis", "Rest"],
description: "Personal Year 7 invites you to journey inward for spiritual growth and deep reflection. After the service of Year 6, you need rest and contemplation. This is not a year for outer success - it's a year for inner development, study, and connecting with your deeper wisdom.",
theme: "Turn inward. Time for spiritual growth, rest, and deep analysis. Not a year for material pursuits.",
opportunities: [
"Spiritual development",
"Deep study and research",
"Inner work and therapy",
"Meditation and contemplation",
"Sabbatical or retreat"
],
challenges: [
"Isolation and loneliness",
"Depression or melancholy",
"Escapism",
"Over-analysis"
],
advice: "Go within. Study, meditate, rest. Don't push for outer success this year. Trust the process.",
bestFor: ["Spiritual retreats", "Therapy", "Research projects", "Writing", "Sabbaticals"],
avoidDoing: ["Major business launches", "Rushing", "Ignoring intuition", "Superficial activities"]
},
8: {
keywords: ["Power", "Achievement", "Money", "Recognition"],
description: "Personal Year 8 is harvest time - you reap what you've sown over the past seven years! This is a powerful year for achievement, financial success, and recognition. After the introspection of Year 7, you're ready to step into your power and claim the material rewards you've earned.",
theme: "Harvest time! Reap what you've sown. Power, achievement, and financial reward are possible.",
opportunities: [
"Financial success and abundance",
"Career advancement",
"Recognition and awards",
"Business expansion",
"Leadership positions"
],
challenges: [
"Workaholism",
"Greed or materialism",
"Power struggles",
"Burnout from ambition"
],
advice: "Go for it! Take charge. Make bold business moves. Expect rewards for past efforts. Think big.",
bestFor: ["Business growth", "Promotions", "Real estate investments", "Large purchases", "Authority roles"],
avoidDoing: ["Being passive", "Avoiding power", "Small thinking", "Neglecting material world"]
},
9: {
keywords: ["Completion", "Release", "Transformation", "Humanitarianism"],
description: "Personal Year 9 marks the completion of your 9-year cycle - a time of endings, release, and transformation. This year is about letting go of what no longer serves you to make room for the fresh start coming in Year 1. Embrace endings gracefully and focus on humanitarian service.",
theme: "End of the 9-year cycle. Let go of what no longer serves. Clear space for the new.",
opportunities: [
"Completing long-term projects",
"Releasing old patterns",
"Humanitarian work",
"Spiritual transformation",
"Forgiveness and closure"
],
challenges: [
"Grief and loss",
"Resistance to endings",
"Bitterness",
"Holding on to the past"
],
advice: "Let go. Release what's finished. Don't start major new ventures. Clear space for next year's new beginning.",
bestFor: ["Ending relationships", "Selling property", "Retiring", "Clearing clutter", "Forgiveness work"],
avoidDoing: ["Starting new ventures", "Clinging to the past", "Beginning long-term projects", "Being bitter"]
},
11: {
keywords: ["Inspiration", "Illumination", "Spiritual Growth", "Intuition"],
description: "Personal Year 11 is a master number year of spiritual inspiration and illumination! This is a higher vibration of Year 2, combining its sensitivity with profound spiritual insight. You're being called to inspire others, channel higher wisdom, and step into spiritual leadership. Your intuition is exceptionally strong this year.",
theme: "Master number year (higher vibration of 2) of inspiration and spiritual awakening. Channel higher wisdom. Combines 2's sensitivity with 11's spiritual leadership.",
opportunities: [
"Spiritual breakthroughs",
"Inspiring others",
"Intuitive development",
"Creative inspiration",
"Teaching and leading spiritually"
],
challenges: [
"Nervous tension",
"Feeling overwhelmed by sensitivity",
"Impracticality",
"Not grounding visions"
],
advice: "Trust your intuition. Inspire others. Ground your visions in reality. Manage nervous system carefully.",
bestFor: ["Spiritual teaching", "Intuitive work", "Inspirational projects", "Visionary leadership"],
avoidDoing: ["Ignoring intuition", "Being too practical", "Suppressing sensitivity", "Isolation"]
},
22: {
keywords: ["Master Building", "Large-Scale Impact", "Manifestation", "Legacy"],
description: "Personal Year 22 is the master builder year - the most powerful year for manifesting large-scale visions! This higher vibration of Year 4 combines practical building skills with the ability to create lasting legacies that serve humanity. Your dreams can manifest on a grand scale this year if you're willing to do the masterful work required.",
theme: "Master builder year (higher vibration of 4). Manifest large visions that serve humanity. Build lasting legacies. Combines 4's practical foundation work with 22's visionary manifestation.",
opportunities: [
"Building large-scale projects",
"International expansion",
"Masterful achievement",
"Leaving legacy",
"Visionary leadership"
],
challenges: [
"Overwhelm from scope",
"Self-sabotage",
"Taking on too much",
"Perfectionism"
],
advice: "Think globally. Build masterfully. Your visions can manifest on grand scale this year.",
bestFor: ["Large projects", "International ventures", "Major builds", "Legacy projects"],
avoidDoing: ["Small thinking", "Self-sabotage", "Giving up", "Losing faith in vision"]
},
33: {
keywords: ["Master Teaching", "Healing", "Compassion", "Service"],
description: "Personal Year 33 is the master teacher and healer year - a rare and sacred year of service to humanity! This highest vibration of Year 6 combines grounded service with master-level teaching and healing abilities. You're called to teach with unconditional love and to heal others through compassion.",
theme: "Master teacher year (higher vibration of 6). Teach love and compassion. Heal on profound levels. Combines 6's grounded service with 33's master-level teaching and healing.",
opportunities: [
"Teaching and mentoring",
"Healing work",
"Compassionate service",
"Leading with love",
"Uplifting humanity"
],
challenges: [
"Martyrdom",
"Overwhelmed by others' pain",
"Neglecting self",
"Unrealistic expectations"
],
advice: "Teach and heal with compassion. Remember self-care. You can't save everyone.",
bestFor: ["Teaching", "Healing professions", "Humanitarian work", "Spiritual leadership"],
avoidDoing: ["Martyrdom", "Neglecting self", "Trying to save everyone", "Burnout"]
}
};
// Personal Month Meanings (within Personal Year context)
export const personalMonth: Record<number, CycleMeaning> = {
1: {
keywords: ["Initiation", "New Energy", "Fresh Start"],
description: "Personal Month 1 brings fresh energy and new beginnings within your current year's theme. This is your monthly reset button - a perfect time to start new initiatives, take bold action, and set the tone for the weeks ahead. Whatever you begin this month has extra momentum behind it.",
theme: "Monthly new beginning. Start new projects or phases within your yearly theme.",
opportunities: ["New monthly initiatives", "Fresh perspective", "Taking action"],
challenges: ["Impatience", "Starting too many things"],
advice: "Take initiative this month. Start what you've been planning.",
bestFor: ["Beginning projects", "Making first moves", "Setting monthly goals"],
avoidDoing: ["Waiting", "Being passive", "Overthinking"]
},
2: {
keywords: ["Patience", "Partnership", "Details"],
description: "Personal Month 2 asks you to slow down and focus on cooperation and details. This month emphasizes partnerships, diplomacy, and patience. It's perfect for strengthening relationships, handling important details, and practicing the art of cooperation rather than competition.",
theme: "Month of patience and cooperation. Details and relationships are emphasized.",
opportunities: ["Building partnerships", "Attention to detail", "Diplomacy"],
challenges: ["Oversensitivity", "Impatience"],
advice: "Be patient. Work with others. Handle details carefully.",
bestFor: ["Collaborating", "Negotiating", "Detail work"],
avoidDoing: ["Rushing", "Going solo", "Ignoring feelings"]
},
3: {
keywords: ["Expression", "Joy", "Social"],
description: "Personal Month 3 is your time to shine! This month brings creative energy, social opportunities, and pure joy. Express yourself freely, network enthusiastically, and let your creativity flow. This is a light-hearted month perfect for communication and fun.",
theme: "Month of self-expression and social activity. Time to have fun.",
opportunities: ["Creative projects", "Socializing", "Communication"],
challenges: ["Scattering energy", "Superficiality"],
advice: "Express yourself creatively. Enjoy social activities.",
bestFor: ["Creative work", "Networking", "Presentations"],
avoidDoing: ["Being too serious", "Isolating", "Suppressing joy"]
},
4: {
keywords: ["Work", "Organization", "Foundation"],
description: "Personal Month 4 is time to buckle down and handle practical matters. This is your month for hard work, organization, and building solid foundations. While it may feel demanding, the structures you create now will serve you well in the months ahead.",
theme: "Month of hard work and building. Get organized and create structure.",
opportunities: ["Building foundations", "Organizing", "Physical work"],
challenges: ["Feeling overwhelmed", "Rigidity"],
advice: "Work hard. Get organized. Build something solid.",
bestFor: ["Organizing", "Hard work", "Planning"],
avoidDoing: ["Procrastinating", "Being disorganized", "Avoiding work"]
},
5: {
keywords: ["Change", "Freedom", "Adventure"],
description: "Personal Month 5 brings dynamic change and a need for freedom! This month is perfect for travel, trying new things, and embracing unexpected opportunities. Break free from routine, be flexible, and say yes to adventure.",
theme: "Month of change and freedom. Embrace new experiences.",
opportunities: ["Travel", "Changes", "New experiences"],
challenges: ["Restlessness", "Impulsiveness"],
advice: "Embrace change. Try new things. Be flexible.",
bestFor: ["Travel", "Changes", "Exploring"],
avoidDoing: ["Staying stuck", "Long commitments", "Being rigid"]
},
6: {
keywords: ["Responsibility", "Home", "Family"],
description: "Personal Month 6 calls you to focus on home, family, and responsibilities. This month emphasizes service, creating harmony, and taking care of loved ones. It's an excellent time for home improvements, family gatherings, and acts of caring.",
theme: "Month of responsibility and home focus. Attend to family matters.",
opportunities: ["Family time", "Home projects", "Caring for others"],
challenges: ["Feeling burdened", "Perfectionism"],
advice: "Focus on home and family. Take care of responsibilities.",
bestFor: ["Family matters", "Home improvements", "Caring"],
avoidDoing: ["Neglecting home", "Avoiding responsibility", "Being self-centered"]
},
7: {
keywords: ["Introspection", "Rest", "Spirituality"],
description: "Personal Month 7 invites you inward for rest, reflection, and spiritual connection. This is not a month for pushing forward in the outer world - it's a time for meditation, study, and deepening your inner wisdom. Trust the value of rest.",
theme: "Month of introspection and spiritual focus. Rest and reflect.",
opportunities: ["Meditation", "Study", "Inner work"],
challenges: ["Isolation", "Melancholy"],
advice: "Turn inward. Rest. Study. Connect spiritually.",
bestFor: ["Meditation", "Study", "Solitude"],
avoidDoing: ["Overworking", "Superficial activities", "Ignoring intuition"]
},
8: {
keywords: ["Achievement", "Power", "Money"],
description: "Personal Month 8 is your power month! This is prime time for achievement, financial matters, and stepping into authority. Focus on business, money management, and claiming your power. What you accomplish this month can have lasting material benefits.",
theme: "Month of achievement and power. Focus on material success.",
opportunities: ["Financial gains", "Recognition", "Authority"],
challenges: ["Workaholism", "Power struggles"],
advice: "Take charge. Focus on achievement. Handle money matters.",
bestFor: ["Business deals", "Financial planning", "Leadership"],
avoidDoing: ["Being passive", "Avoiding power", "Small thinking"]
},
9: {
keywords: ["Completion", "Release", "Letting Go"],
description: "Personal Month 9 is about completion and letting go. This month asks you to finish what you've started, release what's no longer needed, and clear space for next month's fresh start. Embrace endings gracefully and practice forgiveness.",
theme: "Month of completion. Finish projects and release what's done.",
opportunities: ["Completing projects", "Letting go", "Closure"],
challenges: ["Grief", "Resistance to endings"],
advice: "Complete what you started. Let go. Clear space for next month.",
bestFor: ["Finishing projects", "Clearing clutter", "Endings"],
avoidDoing: ["Starting new things", "Clinging", "Beginning major projects"]
},
11: {
keywords: ["Inspiration", "Intuition", "Spiritual Energy"],
description: "Personal Month 11 is a master month of spiritual inspiration and heightened intuition! Your psychic abilities are amplified, and you're meant to channel higher wisdom and inspire others. This month carries special spiritual significance - trust your inner guidance completely.",
theme: "Master month of spiritual inspiration. Channel higher wisdom. Inspire others.",
opportunities: ["Spiritual insights", "Inspiring messages", "Intuitive breakthroughs"],
challenges: ["Nervous energy", "Overstimulation"],
advice: "Trust your intuition. Share your insights. Inspire those around you.",
bestFor: ["Spiritual work", "Teaching", "Creative inspiration"],
avoidDoing: ["Ignoring intuition", "Being too grounded", "Suppressing inspiration"]
},
22: {
keywords: ["Master Building", "Big Plans", "Manifestation"],
description: "Personal Month 22 is the master builder month - think BIG! This month your ability to manifest large-scale visions is exceptional. Focus on projects that can have lasting impact and serve humanity. Your practical mastery combined with visionary thinking is at its peak.",
theme: "Master builder month. Think big. Build lasting structures.",
opportunities: ["Large projects", "Master-level work", "Manifesting visions"],
challenges: ["Overwhelm", "Perfectionism"],
advice: "Think big this month. Your plans can manifest on a large scale.",
bestFor: ["Starting major projects", "Planning big initiatives", "Master building"],
avoidDoing: ["Small thinking", "Self-doubt", "Giving up too soon"]
},
33: {
keywords: ["Master Teaching", "Healing", "Compassion"],
description: "Personal Month 33 is the master teacher and healer month - a sacred time for service! You're called to teach with unconditional love and heal through compassion. This rare month offers exceptional opportunities to uplift humanity, but remember to maintain healthy boundaries.",
theme: "Master teacher month. Teach with love. Heal. Serve compassionately.",
opportunities: ["Teaching opportunities", "Healing work", "Compassionate service"],
challenges: ["Martyrdom", "Overwhelm from others' needs"],
advice: "Teach and heal with love. Remember to care for yourself too.",
bestFor: ["Teaching", "Healing", "Serving with compassion"],
avoidDoing: ["Martyrdom", "Neglecting self", "Taking on too much"]
}
};
// Personal Day Meanings (daily energy)
export const personalDay: Record<number, string> = {
1: "New beginnings day. Take initiative. Start projects. Be independent.",
2: "Cooperation day. Work with others. Be patient. Handle details.",
3: "Expression day. Be creative. Socialize. Communicate. Have fun.",
4: "Work day. Get organized. Build. Be practical and disciplined.",
5: "Change day. Be flexible. Try new things. Embrace variety.",
6: "Responsibility day. Focus on home/family. Serve others. Create harmony.",
7: "Introspection day. Rest. Meditate. Study. Avoid pushing.",
8: "Achievement day. Handle business. Focus on money. Take charge.",
9: "Completion day. Finish things. Let go. Clear out. Forgive.",
11: "Inspiration day. Channel higher wisdom. Trust intuition. Inspire others.",
22: "Master building day. Think big. Build lasting structures. Manifest visions.",
33: "Master teaching day. Teach with love. Heal. Serve compassionately."
};
// Universal Year Meanings (global collective energy)
export const universalYear: Record<number, string> = {
1: "Global year of new beginnings. Worldwide initiatives and pioneering energy.",
2: "Global year of cooperation. Diplomacy and partnerships are emphasized worldwide.",
3: "Global year of expression. Creativity and communication flourish globally.",
4: "Global year of building. Foundations and structures are created worldwide.",
5: "Global year of change. Rapid changes and freedom movements occur globally.",
6: "Global year of responsibility. Family and community focus worldwide.",
7: "Global year of introspection. Spiritual seeking and analysis emphasized globally.",
8: "Global year of power. Financial markets and power structures shift worldwide.",
9: "Global year of completion. Old cycles end. Worldwide transformations occur."
};

320
cycles-week.ts Executable file
View file

@ -0,0 +1,320 @@
#!/usr/bin/env bun
/**
* Numerology Weekly Cycles (Simple Version)
*
* Shows your Personal Day cycles for the week with general guidance.
* No telos file needed - works for anyone!
*
* Usage:
* bun cycles-week.ts --birthdate "5/13/1982" --name "Your Name"
* bun cycles-week.ts --birthdate "5/13/1982" --name "Your Name" --start-date "10/14/2025"
*/
import { calculateCycles } from './cycles';
import { personalDay as personalDayMeanings } from './cycle-meanings';
import { loadProfile } from './profile-manager';
// Parse command line arguments
const args = process.argv.slice(2);
let birthdate = '';
let name = '';
let profileId = '';
let startDate = '';
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if ((args[i] === '--start-date' || args[i] === '-s') && args[i + 1]) {
startDate = args[i + 1];
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Numerology Weekly Cycles - Your personal energy forecast
USAGE:
bun cycles-week.ts --profile <id>
bun cycles-week.ts --birthdate "mm/dd/yyyy" --name "Your Name"
OPTIONS:
-p, --profile Use saved profile
-b, --birthdate Your birthdate (mm/dd/yyyy) [required if no profile]
-n, --name Your name (for personalization) [required if no profile]
-s, --start-date Start date (mm/dd/yyyy) [default: today]
-h, --help Show this help message
EXAMPLES:
# With profile
bun cycles-week.ts --profile rob
bun cycles-week.ts --profile rob -s "10/14/2025"
# With name/birthdate
bun cycles-week.ts -b "5/13/1982" -n "John"
bun cycles-week.ts -b "5/13/1982" -n "John" -s "10/14/2025"
`);
process.exit(0);
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
name = profile.name;
birthdate = profile.birthdate;
}
if (!birthdate || !name) {
console.error('Error: --birthdate and --name are required (or use --profile)');
console.error('Try: bun cycles-week.ts --help');
process.exit(1);
}
// Format date as mm/dd/yyyy
function formatDate(date: Date): string {
const month = (date.getMonth() + 1).toString().padStart(2, '0');
const day = date.getDate().toString().padStart(2, '0');
const year = date.getFullYear();
return `${month}/${day}/${year}`;
}
// Get day name (short)
function getDayName(date: Date): string {
return date.toLocaleDateString('en-US', { weekday: 'short' });
}
// Get month name (short)
function getMonthName(date: Date): string {
return date.toLocaleDateString('en-US', { month: 'short' });
}
// Get best activities for each Personal Day
function getBestActivities(personalDay: number): string[] {
const activities: Record<number, string[]> = {
1: ['Starting new projects', 'Taking initiative', 'Being independent', 'Leadership tasks'],
2: ['Collaboration', 'Detail work', 'Patience', 'Building partnerships'],
3: ['Content creation', 'Communication', 'Socializing', 'Creative projects'],
4: ['Organizing', 'Hard work', 'Building systems', 'Physical projects'],
5: ['Trying new things', 'Flexibility', 'Exploration', 'Variety'],
6: ['Client/family focus', 'Service', 'Taking responsibility', 'Home projects'],
7: ['Research', 'Deep study', 'Spiritual practice', 'Rest and reflection'],
8: ['Business planning', 'Financial matters', 'Achievement goals', 'Leadership'],
9: ['Finishing projects', 'Clearing clutter', 'Letting go', 'Completion'],
11: ['Inspiring others', 'Intuitive work', 'Spiritual teaching', 'Creative inspiration'],
22: ['Large-scale building', 'Manifesting visions', 'Legacy projects', 'Masterful work'],
33: ['Teaching', 'Healing work', 'Compassionate service', 'Mentoring']
};
return activities[personalDay] || activities[personalDay % 11] || [];
}
// Get things to avoid for each Personal Day
function getAvoidActivities(personalDay: number): string[] {
const avoid: Record<number, string[]> = {
1: ['Depending on others', 'Being passive', 'Waiting for permission'],
2: ['Rushing', 'Going solo', 'Making hasty decisions'],
3: ['Being too serious', 'Isolating', 'Suppressing creativity'],
4: ['Cutting corners', 'Being disorganized', 'Avoiding hard work'],
5: ['Long-term commitments', 'Staying stuck', 'Rigid plans'],
6: ['Neglecting responsibilities', 'Being self-centered', 'Avoiding commitments'],
7: ['Networking events', 'Major launches', 'Superficial activities'],
8: ['Being passive', 'Avoiding power', 'Small thinking'],
9: ['Starting new projects', 'Major commitments', 'Clinging to the past'],
11: ['Ignoring intuition', 'Being too practical', 'Suppressing sensitivity'],
22: ['Small thinking', 'Self-sabotage', 'Losing faith in vision'],
33: ['Martyrdom', 'Neglecting self-care', 'Trying to save everyone']
};
return avoid[personalDay] || avoid[personalDay % 11] || [];
}
// Main execution
async function main() {
// Determine start date (today by default)
let start: Date;
if (startDate) {
const parts = startDate.split('/');
start = new Date(parseInt(parts[2]), parseInt(parts[0]) - 1, parseInt(parts[1]));
} else {
start = new Date();
}
// Get cycles for 7 days starting from start date
const weekDays = [];
for (let i = 0; i < 7; i++) {
const date = new Date(start);
date.setDate(start.getDate() + i);
const dateStr = formatDate(date);
const cycles = calculateCycles(birthdate, dateStr);
weekDays.push({ date, dateStr, cycles });
}
// Calculate Personal Year and Month for context
const todayCycles = calculateCycles(birthdate);
const personalYear = todayCycles.personal.year;
const personalMonth = todayCycles.personal.month;
// Get year and month meanings
const yearMeanings: Record<number, string> = {
1: 'New Beginnings', 2: 'Patience & Cooperation', 3: 'Expression & Creativity',
4: 'Hard Work & Foundation', 5: 'Change & Freedom', 6: 'Responsibility & Service',
7: 'Introspection & Spirituality', 8: 'Achievement & Power', 9: 'Completion & Release',
11: 'Inspiration & Illumination', 22: 'Master Building', 33: 'Master Teaching'
};
const monthMeanings: Record<number, string> = {
1: 'Initiation', 2: 'Patience', 3: 'Expression', 4: 'Work',
5: 'Change', 6: 'Responsibility', 7: 'Introspection', 8: 'Achievement', 9: 'Completion'
};
// Output header
const startFormatted = `${getMonthName(start)} ${start.getDate()}`;
const endDate = new Date(start);
endDate.setDate(start.getDate() + 6);
const endFormatted = `${getMonthName(endDate)} ${endDate.getDate()}, ${endDate.getFullYear()}`;
console.log(`\n📅 YOUR WEEK: ${startFormatted}-${endFormatted}\n`);
console.log(`Personal Year ${personalYear} (${yearMeanings[personalYear]}) + Month ${personalMonth} (${monthMeanings[personalMonth]})`);
// Add contextual theme based on Year/Month combination
if (personalYear === 9 && personalMonth === 1) {
console.log(`→ Theme: Completing major cycles while initiating final projects`);
} else if (personalYear === 1) {
console.log(`→ Theme: Fresh starts and new beginnings - plant seeds for the next 9 years`);
} else if (personalYear === 33) {
console.log(`→ Theme: Master teaching year - share wisdom, serve, heal with compassion`);
} else if (personalYear === 22) {
console.log(`→ Theme: Master building year - manifest large-scale visions`);
} else if (personalYear === 11) {
console.log(`→ Theme: Inspiration year - channel higher wisdom, illuminate others`);
} else {
console.log(`→ Theme: Year ${personalYear} energy expressed through Month ${personalMonth} focus`);
}
console.log('');
// Output each day
for (const { date, cycles } of weekDays) {
const dayName = getDayName(date);
const dayNum = date.getDate();
const personalDay = cycles.personal.day;
// Get meaning keywords
const meaningText = personalDayMeanings[personalDay];
const meaningMatch = meaningText?.match(/^([^.]+)/);
const keywords = meaningMatch ? meaningMatch[1].replace(' day', '') : `Day ${personalDay}`;
// Get activities
const bestFor = getBestActivities(personalDay);
const avoid = getAvoidActivities(personalDay);
console.log(`─────────────────────────────────────────────────────────`);
console.log(`${dayName} ${getMonthName(date)} ${dayNum} - Personal Day ${personalDay} (${keywords})`);
console.log(` ✅ Best for: ${bestFor.join(', ')}`);
if (avoid.length > 0) {
console.log(` ⚠️ Avoid: ${avoid.join(', ')}`);
}
console.log('');
}
console.log(`─────────────────────────────────────────────────────────`);
// Weekly Summary
console.log(`\n📊 WEEKLY SUMMARY\n`);
console.log(`Personal Year ${personalYear} + Month ${personalMonth}`);
// Weekly Theme
console.log(`\n🎯 WEEKLY THEME:`);
if (personalYear === 9 && personalMonth === 1) {
console.log(`You're completing a 9-year cycle (endings/letting go) while Month 1 brings`);
console.log(`fresh energy. This paradox creates space for final completions while`);
console.log(`planting seeds for your next cycle starting next year.`);
} else if (personalYear === 33) {
console.log(`Master Teacher year - you're called to teach, heal, and serve at a higher`);
console.log(`level. This isn't about personal achievement - it's about uplifting others`);
console.log(`through compassionate service. Abundance follows when you lead with love.`);
} else if (personalYear === 1) {
console.log(`New 9-year cycle begins! Fresh starts, bold initiatives, and independent`);
console.log(`action are your themes. What you start this year echoes for 9 years.`);
} else if (personalYear === 8) {
console.log(`Power and achievement year. Business opportunities, financial growth, and`);
console.log(`leadership roles are highlighted. Think big - this is your harvest time.`);
} else if (personalYear === 7) {
console.log(`Introspection and spirituality year. Turn inward for wisdom. Rest, study,`);
console.log(`and spiritual practice are more important than external achievement now.`);
} else {
console.log(`Year ${personalYear} energy (${yearMeanings[personalYear]}) manifesting through Month ${personalMonth}.`);
console.log(`Balance your annual theme with monthly focus for best results.`);
}
// Key Opportunities
console.log(`\n🌟 KEY OPPORTUNITIES THIS WEEK:`);
const opportunityDays = weekDays.filter(d => [1, 3, 8, 11, 22, 33].includes(d.cycles.personal.day));
if (opportunityDays.length > 0) {
opportunityDays.forEach(d => {
const day = d.cycles.personal.day;
const opportunities: Record<number, string> = {
1: `${getDayName(d.date)} (Day 1): New beginnings - launch projects, take first steps`,
3: `${getDayName(d.date)} (Day 3): Expression - communicate, create, socialize`,
8: `${getDayName(d.date)} (Day 8): Achievement - business moves, financial decisions`,
11: `${getDayName(d.date)} (Day 11): Inspiration - teach, inspire, channel creativity`,
22: `${getDayName(d.date)} (Day 22): Master building - think big, build lasting legacies`,
33: `${getDayName(d.date)} (Day 33): Master teaching - heal, serve, uplift humanity`
};
if (opportunities[day]) {
console.log(` ${opportunities[day]}`);
}
});
} else {
console.log(` This week favors steady progress over dramatic breakthroughs.`);
console.log(` Focus on consistent alignment with each day's unique energy.`);
}
// Weekly Advice (personalized by year)
console.log(`\n💡 WEEKLY ADVICE:`);
if (personalYear === 9) {
console.log(` • Finish what you started - don't leave loose ends`);
console.log(` • Let go of relationships, projects, or beliefs that no longer fit`);
console.log(` • Reflect on lessons from the past 9 years - wisdom awaits`);
console.log(` • Clear physical/mental clutter to prepare for Year 1 next year`);
} else if (personalYear === 1) {
console.log(` • Be bold - this is your year to take initiative`);
console.log(` • Start before you feel ready - perfection kills momentum`);
console.log(` • Your independence is your greatest asset this year`);
console.log(` • Think long-term - what you plant now grows for 9 years`);
} else if (personalYear === 33) {
console.log(` • Teach what you know - your wisdom heals others`);
console.log(` • Serve from overflow, not depletion (self-care first)`);
console.log(` • Lead with compassion, not ego or profit motive`);
console.log(` • Your impact ripples further than you realize`);
} else if (personalYear === 7) {
console.log(` • Honor your need for solitude - it's not selfish, it's necessary`);
console.log(` • Deep study and spiritual practice trump busy-work this year`);
console.log(` • Listen to your intuition - it's especially clear now`);
console.log(` • Rest isn't laziness - it's strategic preparation`);
} else if (personalYear === 8) {
console.log(` • Think big - this is not the year for small goals`);
console.log(` • Take charge of financial matters and business opportunities`);
console.log(` • Step into leadership roles confidently`);
console.log(` • Remember: power is responsibility, not domination`);
} else {
console.log(` • Match your activities to each day's energy for maximum flow`);
console.log(` • Rest on Day 7, launch on Day 1, express on Day 3`);
console.log(` • Fighting your cycles creates unnecessary resistance`);
console.log(` • Trust the rhythm - you're part of a greater pattern`);
}
console.log(`\n✨ Generated with Numerology Cycles System`);
}
main().catch(console.error);

198
cycles.ts Normal file
View file

@ -0,0 +1,198 @@
/**
* Numerology Timing Cycles
*
* Calculates Personal and Universal timing cycles for planning and understanding
* the energy of different time periods.
*/
const MASTER_NUMBERS = [11, 22, 33];
/**
* Reduce number to single digit or master number
*/
function reduce(n: number): number {
if (MASTER_NUMBERS.includes(n)) {
return n;
}
const total = String(n).split('').reduce((sum, digit) => sum + parseInt(digit), 0);
return total < 10 ? total : reduce(total);
}
/**
* Parse date string (mm/dd/yyyy)
*/
function parseDate(dateStr: string): { month: number; day: number; year: number } {
const parts = dateStr.split('/');
if (parts.length !== 3) {
throw new Error('Invalid date format. Use mm/dd/yyyy');
}
return {
month: parseInt(parts[0]),
day: parseInt(parts[1]),
year: parseInt(parts[2])
};
}
export interface CycleCalculations {
targetDate: string;
birthdate: string;
universal: {
year: number;
month: number;
day: number;
};
personal: {
year: number;
month: number;
day: number;
};
calculations: {
universalYearCalc: string;
universalMonthCalc: string;
universalDayCalc: string;
personalYearCalc: string;
personalMonthCalc: string;
personalDayCalc: string;
};
}
/**
* Calculate all timing cycles for a specific date
*/
export function calculateCycles(birthdate: string, targetDate?: string): CycleCalculations {
// Use current date if not specified
const target = targetDate || new Date().toLocaleDateString('en-US', {
month: '2-digit',
day: '2-digit',
year: 'numeric'
}).replace(/\//g, '/');
const birth = parseDate(birthdate);
const current = parseDate(target);
// Universal Cycles (based on calendar date only)
const universalYear = reduce(current.year);
const universalMonth = reduce(universalYear + current.month);
const universalDay = reduce(universalMonth + current.day);
// Personal Cycles (based on birthdate + current date)
const birthMonth = reduce(birth.month);
const birthDay = reduce(birth.day);
// Personal Year = Birth Month + Birth Day + Current Year (all reduced)
const personalYear = reduce(birthMonth + birthDay + reduce(current.year));
// Personal Month = Personal Year + Current Month
const personalMonth = reduce(personalYear + current.month);
// Personal Day = Personal Month + Current Day
const personalDay = reduce(personalMonth + current.day);
return {
targetDate: target,
birthdate,
universal: {
year: universalYear,
month: universalMonth,
day: universalDay
},
personal: {
year: personalYear,
month: personalMonth,
day: personalDay
},
calculations: {
universalYearCalc: `${current.year} → ${universalYear}`,
universalMonthCalc: `UY(${universalYear}) + ${current.month} = ${universalMonth}`,
universalDayCalc: `UM(${universalMonth}) + ${current.day} = ${universalDay}`,
personalYearCalc: `BM(${birthMonth}) + BD(${birthDay}) + CY(${reduce(current.year)}) = ${personalYear}`,
personalMonthCalc: `PY(${personalYear}) + ${current.month} = ${personalMonth}`,
personalDayCalc: `PM(${personalMonth}) + ${current.day} = ${personalDay}`
}
};
}
/**
* Calculate Personal Year for entire year (Jan-Dec)
*/
export function calculateYearCycles(birthdate: string, year: number): Array<{month: number; personalMonth: number}> {
const birth = parseDate(birthdate);
const birthMonth = reduce(birth.month);
const birthDay = reduce(birth.day);
const personalYear = reduce(birthMonth + birthDay + reduce(year));
const months = [];
for (let month = 1; month <= 12; month++) {
const personalMonth = reduce(personalYear + month);
months.push({ month, personalMonth });
}
return months;
}
/**
* Calculate Personal Day for entire month
*/
export function calculateMonthCycles(
birthdate: string,
year: number,
month: number
): Array<{day: number; personalDay: number}> {
const birth = parseDate(birthdate);
const birthMonth = reduce(birth.month);
const birthDay = reduce(birth.day);
const personalYear = reduce(birthMonth + birthDay + reduce(year));
const personalMonth = reduce(personalYear + month);
// Get days in month
const daysInMonth = new Date(year, month, 0).getDate();
const days = [];
for (let day = 1; day <= daysInMonth; day++) {
const personalDay = reduce(personalMonth + day);
days.push({ day, personalDay });
}
return days;
}
/**
* Find optimal days in a month based on desired energy
*/
export function findOptimalDays(
birthdate: string,
year: number,
month: number,
desiredNumber: number
): number[] {
const days = calculateMonthCycles(birthdate, year, month);
return days
.filter(d => d.personalDay === desiredNumber)
.map(d => d.day);
}
/**
* Get cycle interpretation context
*/
export function getCycleContext(cycles: CycleCalculations): string {
let context = `## Timing Cycles for ${cycles.targetDate}\n\n`;
context += `**Universal Energy (Global):**\n`;
context += `- Year: ${cycles.universal.year}\n`;
context += `- Month: ${cycles.universal.month}\n`;
context += `- Day: ${cycles.universal.day}\n\n`;
context += `**Personal Energy (Your Rhythm):**\n`;
context += `- Year: ${cycles.personal.year}\n`;
context += `- Month: ${cycles.personal.month}\n`;
context += `- Day: ${cycles.personal.day}\n\n`;
context += `**Combined Interpretation:**\n`;
context += `You are in a Personal Year ${cycles.personal.year} within a Universal Year ${cycles.universal.year}.\n`;
context += `Your Personal Month ${cycles.personal.month} operates within Universal Month ${cycles.universal.month}.\n`;
context += `Today's Personal Day ${cycles.personal.day} aligns with Universal Day ${cycles.universal.day}.\n`;
return context;
}

597
generate-report.ts Executable file
View file

@ -0,0 +1,597 @@
#!/usr/bin/env bun
/**
* LaTeX PDF Report Generator
*
* Generates a beautiful, comprehensive numerology report in PDF format.
* Uses LaTeX for professional typography and layout.
*
* Usage:
* bun generate-report.ts --name "John Doe" --birthdate "5/13/1982"
* bun generate-report.ts --name "Jane Smith" --birthdate "11/22/1990" --output ~/jane-report.pdf
*/
import { calculateCoreNumbers, calculateAdditionalNumbers } from './core-calculator';
import { calculateCycles, calculateYearCycles, findOptimalDays } from './cycles';
import { lifePath, expression, soulUrge, birthday } from './meanings';
import { personalYear, personalMonth, personalDay } from './cycle-meanings';
import {
maturityMeanings,
personalityMeanings,
hiddenPassionMeanings,
karmicLessonMeanings,
balanceMeanings
} from './additional-meanings';
import { loadProfile } from './profile-manager';
// Parse command line arguments
const args = process.argv.slice(2);
let name = '';
let birthdate = '';
let outputPath = '';
let profileId = '';
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--output' || args[i] === '-o') && args[i + 1]) {
outputPath = args[i + 1];
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
LaTeX PDF Report Generator
Generate a beautiful, comprehensive numerology report in PDF format.
USAGE:
bun generate-report.ts --profile <id> [OPTIONS]
bun generate-report.ts --name "Your Name" --birthdate "mm/dd/yyyy" [OPTIONS]
OPTIONS:
-p, --profile ID Use saved profile
-n, --name NAME Your full name [required if no profile]
-b, --birthdate DATE Your birthdate (mm/dd/yyyy) [required if no profile]
-o, --output PATH Output PDF path [default: ./numerology-report-<name>.pdf]
-h, --help Show this help message
REQUIREMENTS:
- pdflatex must be installed (sudo apt install texlive-latex-extra texlive-fonts-extra)
EXAMPLES:
# Generate report with profile
bun generate-report.ts --profile john
# Generate report with name/birthdate
bun generate-report.ts --name "John Doe" --birthdate "5/13/1982"
# Custom output location
bun generate-report.ts --profile john --output ~/my-report.pdf
OUTPUT:
Creates a professional multi-page PDF report including:
- Core numbers with detailed interpretations
- Advanced numbers (Maturity, Personality, Hidden Passion, etc.)
- Current timing cycles
- Life pinnacles and challenges
- Synthesis and guidance
- Calculation appendix
`);
process.exit(0);
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
name = profile.name;
birthdate = profile.birthdate;
console.log(`Using profile '${profileId}': ${name} (${birthdate})`);
}
if (!name || !birthdate) {
console.error('Error: Either --profile or both --name and --birthdate are required');
console.error('Try: bun generate-report.ts --help');
process.exit(1);
}
// Set default output path
if (!outputPath) {
const safeName = name.toLowerCase().replace(/[^a-z0-9]/g, '-');
outputPath = `./numerology-report-${safeName}.pdf`;
}
// Helper functions
function escapeLatex(text: string | undefined): string {
if (!text) return '';
return text
.replace(/\\/g, '\\textbackslash{}')
.replace(/[&%$#_{}]/g, '\\$&')
.replace(/~/g, '\\textasciitilde{}')
.replace(/\^/g, '\\textasciicircum{}');
}
function formatList(items: string[] | undefined): string {
if (!items || items.length === 0) return ' \\item (None listed)';
return items.map(item => ` \\item ${escapeLatex(item)}`).join('\n');
}
function getMasterSymbol(num: number): string {
return [11, 22, 33].includes(num) ? '\\textcolor{accent}{\\textbf{(MASTER)}}' : '';
}
function reduce(num: number): number {
if (num === 11 || num === 22 || num === 33) return num;
while (num > 9) {
num = num.toString().split('').reduce((sum, digit) => sum + parseInt(digit), 0);
if (num === 11 || num === 22 || num === 33) return num;
}
return num;
}
// Reduce to single digit (0-9) - for challenge numbers only (no master numbers)
function reduceSingleDigit(num: number): number {
while (num > 9) {
num = num.toString().split('').reduce((sum, digit) => sum + parseInt(digit), 0);
}
return num;
}
function calculatePinnacles(birthdate: string, lifePath: number) {
const [month, day, year] = birthdate.split('/').map(n => parseInt(n));
const monthReduced = reduce(month);
const dayReduced = reduce(day);
const yearReduced = reduce(year);
// Calculate pinnacle numbers
const pinnacle1 = reduce(monthReduced + dayReduced);
const pinnacle2 = reduce(dayReduced + yearReduced);
const pinnacle3 = reduce(pinnacle1 + pinnacle2);
const pinnacle4 = reduce(monthReduced + yearReduced);
// Calculate challenge numbers (always reduce to 0-9, no master numbers in challenges)
const challenge1 = reduceSingleDigit(Math.abs(monthReduced - dayReduced));
const challenge2 = reduceSingleDigit(Math.abs(dayReduced - yearReduced));
const challenge3 = reduceSingleDigit(Math.abs(challenge1 - challenge2));
const challenge4 = reduceSingleDigit(Math.abs(monthReduced - yearReduced));
// Calculate age ranges
const age1End = 36 - lifePath;
const age2End = age1End + 9;
const age3End = age2End + 9;
const currentYear = new Date().getFullYear();
const birthYear = year;
const currentAge = currentYear - birthYear;
return {
pinnacle1: { number: pinnacle1, challenge: challenge1, ageStart: 0, ageEnd: age1End },
pinnacle2: { number: pinnacle2, challenge: challenge2, ageStart: age1End, ageEnd: age2End },
pinnacle3: { number: pinnacle3, challenge: challenge3, ageStart: age2End, ageEnd: age3End },
pinnacle4: { number: pinnacle4, challenge: challenge4, ageStart: age3End, ageEnd: 999 },
currentAge
};
}
// Calculate all numbers
console.log('Calculating numerology...');
const coreNumbers = calculateCoreNumbers(name, birthdate);
const additionalNumbers = calculateAdditionalNumbers(name, coreNumbers);
const today = new Date();
const cycles = calculateCycles(birthdate, today.toLocaleDateString('en-US'));
// Calculate pinnacles
const pinnacles = calculatePinnacles(birthdate, coreNumbers.lifePath);
// Calculate year-ahead cycles
const currentYear = today.getFullYear();
const nextYear = currentYear + 1;
const yearAheadCycles = calculateYearCycles(birthdate, nextYear);
// Find optimal days for next 3 months - all numbers including master numbers
const optimalDays: Array<{date: Date, personalDay: number}> = [];
for (let monthOffset = 0; monthOffset < 3; monthOffset++) {
const targetDate = new Date(today.getFullYear(), today.getMonth() + monthOffset, 1);
const targetYear = targetDate.getFullYear();
const targetMonth = targetDate.getMonth() + 1;
// Include all single-digit numbers 1-9 plus master numbers 11, 22, 33
[1, 2, 3, 4, 5, 6, 7, 8, 9, 11, 22, 33].forEach(desiredDay => {
const days = findOptimalDays(birthdate, targetYear, targetMonth, desiredDay);
days.forEach(day => {
optimalDays.push({
date: new Date(targetYear, targetMonth - 1, day),
personalDay: desiredDay
});
});
});
}
// Get meanings
const lifePathMeaning = lifePath[coreNumbers.lifePath];
const expressionMeaning = expression[coreNumbers.expression];
const soulUrgeMeaning = soulUrge[coreNumbers.soulUrge];
const birthdayMeaning = birthday[coreNumbers.birthday];
const maturityMeaning = maturityMeanings[additionalNumbers.maturity];
const personalityMeaning = personalityMeanings[additionalNumbers.personality];
const balanceMeaning = balanceMeanings[additionalNumbers.balance];
const personalYearMeaning = personalYear[cycles.personal.year];
const personalMonthMeaning = personalMonth[cycles.personal.month];
const personalDayMeaningText = personalDay[cycles.personal.day];
// Build template variables
const vars: Record<string, string> = {
name: escapeLatex(name),
birthdate: escapeLatex(birthdate),
date: today.toLocaleDateString('en-US', { year: 'numeric', month: 'long', day: 'numeric' }),
// Core numbers
lifePath: coreNumbers.lifePath.toString(),
lifePath_master: getMasterSymbol(coreNumbers.lifePath),
lifePath_keywords: escapeLatex(lifePathMeaning.keywords.join(', ')),
lifePath_description: escapeLatex(lifePathMeaning.description),
lifePath_purpose: escapeLatex(lifePathMeaning.lifePurpose),
lifePath_strengths: formatList(lifePathMeaning.strengths),
lifePath_challenges: formatList(lifePathMeaning.challenges),
lifePath_careers: escapeLatex((lifePathMeaning.careerPaths || []).join(', ')),
lifePath_relationships: escapeLatex(lifePathMeaning.relationships || ''),
lifePath_spiritual: escapeLatex(lifePathMeaning.spiritualLesson || ''),
expression: coreNumbers.expression.toString(),
expression_master: getMasterSymbol(coreNumbers.expression),
expression_keywords: escapeLatex(expressionMeaning.keywords.join(', ')),
expression_description: escapeLatex(expressionMeaning.description),
expression_purpose: escapeLatex(expressionMeaning.lifePurpose),
expression_strengths: formatList(expressionMeaning.strengths),
expression_challenges: formatList(expressionMeaning.challenges),
expression_careers: escapeLatex((expressionMeaning.careerPaths || []).join(', ')),
expression_relationships: escapeLatex(expressionMeaning.relationships || ''),
soulUrge: coreNumbers.soulUrge.toString(),
soulUrge_master: getMasterSymbol(coreNumbers.soulUrge),
soulUrge_keywords: escapeLatex(soulUrgeMeaning.keywords.join(', ')),
soulUrge_description: escapeLatex(soulUrgeMeaning.description),
soulUrge_purpose: escapeLatex(soulUrgeMeaning.lifePurpose),
soulUrge_strengths: formatList(soulUrgeMeaning.strengths),
soulUrge_challenges: formatList(soulUrgeMeaning.challenges),
birthday: coreNumbers.birthday.toString(),
birthday_keywords: escapeLatex(birthdayMeaning.keywords.join(', ')),
birthday_description: escapeLatex(birthdayMeaning.description),
birthday_purpose: escapeLatex(birthdayMeaning.lifePurpose),
birthday_strengths: formatList(birthdayMeaning.strengths),
// Advanced numbers
maturity: additionalNumbers.maturity.toString(),
maturity_master: getMasterSymbol(additionalNumbers.maturity),
maturity_description: escapeLatex(maturityMeaning.description),
personality: additionalNumbers.personality.toString(),
personality_master: getMasterSymbol(additionalNumbers.personality),
personality_description: escapeLatex(personalityMeaning.description),
balance: additionalNumbers.balance.toString(),
balance_description: escapeLatex(balanceMeaning.description),
// Timing cycles
personalYear: cycles.personal.year.toString(),
personalYear_keywords: escapeLatex(personalYearMeaning.keywords.join(', ')),
personalYear_description: escapeLatex(personalYearMeaning.description),
personalYear_meaning: escapeLatex(personalYearMeaning.theme),
personalYear_opportunities: formatList(personalYearMeaning.opportunities || []),
personalYear_challenges_list: formatList(personalYearMeaning.challenges || []),
currentYear: today.getFullYear().toString(),
personalMonth: cycles.personal.month.toString(),
personalMonth_description: escapeLatex(personalMonthMeaning.description),
personalMonth_focus: escapeLatex(personalMonthMeaning.theme),
currentMonth: today.toLocaleDateString('en-US', { month: 'long' }),
personalDay: cycles.personal.day.toString(),
personalDay_description: escapeLatex(personalDayMeaningText),
personalDay_activities: escapeLatex(personalDayMeaningText), // Same as description for simple format
today: today.toLocaleDateString('en-US'),
universalYear: cycles.universal.year.toString(),
universalMonth: cycles.universal.month.toString(),
universalDay: cycles.universal.day.toString(),
// Calculations (simplified for now)
calc_month: birthdate.split('/')[0],
calc_day: birthdate.split('/')[1],
calc_year: birthdate.split('/')[2],
calc_expression_breakdown: `Full name calculation: ${coreNumbers.expression}`,
calc_soulUrge_breakdown: `Vowels only calculation: ${coreNumbers.soulUrge}`,
calc_personality_breakdown: `${additionalNumbers.personality}`,
};
// Hidden Passion section
if (additionalNumbers.hiddenPassion) {
const hpMeaning = hiddenPassionMeanings[additionalNumbers.hiddenPassion];
vars.hiddenPassion_section = `
\\subsection{Hidden Passion Number: ${additionalNumbers.hiddenPassion} ${getMasterSymbol(additionalNumbers.hiddenPassion)}}
\\begin{tcolorbox}[meaningbox]
\\textbf{Your Secret Talent:}
${escapeLatex(hpMeaning.description)}
\\vspace{0.3cm}
This number appears ${additionalNumbers.hiddenPassionCount} times in your name - more than any other number. It represents a hidden talent or deep passion that drives you.
\\end{tcolorbox}
`;
} else {
vars.hiddenPassion_section = `
\\subsection{Hidden Passion Number: None}
\\begin{tcolorbox}[meaningbox]
No single number dominates your name, which means you have a balanced set of talents and interests.
\\end{tcolorbox}
`;
}
// Karmic Lessons section
if (additionalNumbers.karmicLessons.length > 0) {
const lessonsList = additionalNumbers.karmicLessons.map(lesson => {
const meaning = karmicLessonMeanings[lesson];
return `
\\textbf{Number ${lesson} - ${escapeLatex(meaning.keywords[0])}:}
${escapeLatex(meaning.description)}
`;
}).join('\n\n \\vspace{0.3cm}\n');
vars.karmicLessons_section = `
\\subsection{Karmic Lessons: ${additionalNumbers.karmicLessons.join(', ')}}
\\begin{tcolorbox}[meaningbox]
\\textbf{Areas for Growth:}
The following numbers are missing from your name, indicating areas you're here to develop:
\\vspace{0.3cm}
${lessonsList}
\\end{tcolorbox}
`;
} else {
vars.karmicLessons_section = `
\\subsection{Karmic Lessons: None}
\\begin{tcolorbox}[meaningbox]
All numbers 1-9 appear in your name, which means you have no specific karmic lessons to learn in this lifetime. You came in with a complete set of tools!
\\end{tcolorbox}
`;
}
// Pinnacles section - full implementation
const pinnacleNames = ['First Pinnacle', 'Second Pinnacle', 'Third Pinnacle', 'Fourth Pinnacle'];
const pinnacleDescriptions: Record<number, string> = {
1: 'Leadership, independence, new beginnings. This is a time to develop your individuality and take initiative.',
2: 'Cooperation, partnerships, patience. Focus on relationships and diplomacy.',
3: 'Creativity, self-expression, social connections. Time to develop your creative talents.',
4: 'Building, organization, hard work. Establish solid foundations and systems.',
5: 'Change, freedom, adventure. Embrace variety and new experiences.',
6: 'Responsibility, service, family. Focus on home, relationships, and helping others.',
7: 'Introspection, spirituality, wisdom. Develop inner knowledge and expertise.',
8: 'Material success, power, authority. Time to build wealth and recognition.',
9: 'Completion, humanitarianism, wisdom. Let go and serve the greater good.',
11: 'Inspiration, spiritual insight, illumination. Channel higher wisdom and inspire others.',
22: 'Master building, large-scale manifestation. Create lasting legacies that serve humanity.',
33: 'Master teaching, universal love, healing. Teach and heal at the highest level.'
};
const challengeDescriptions: Record<number, string> = {
0: 'Choice - You have many options and must learn to choose wisely.',
1: 'Independence vs. dependence - Balance self-reliance with accepting help.',
2: 'Sensitivity - Overcome timidity and learn to assert yourself tactfully.',
3: 'Self-expression - Overcome self-doubt and express your creativity.',
4: 'Limitation - Work within restrictions and build solid foundations.',
5: 'Change - Learn to handle unexpected changes and maintain focus.',
6: 'Responsibility - Balance giving to others with self-care.',
7: 'Trust - Develop faith and overcome skepticism or isolation.',
8: 'Power - Handle authority and success without becoming controlling.'
};
let currentPinnacle = 1;
if (pinnacles.currentAge >= pinnacles.pinnacle2.ageStart && pinnacles.currentAge < pinnacles.pinnacle2.ageEnd) currentPinnacle = 2;
else if (pinnacles.currentAge >= pinnacles.pinnacle3.ageStart && pinnacles.currentAge < pinnacles.pinnacle3.ageEnd) currentPinnacle = 3;
else if (pinnacles.currentAge >= pinnacles.pinnacle4.ageStart) currentPinnacle = 4;
const pinnaclesList = [pinnacles.pinnacle1, pinnacles.pinnacle2, pinnacles.pinnacle3, pinnacles.pinnacle4];
vars.pinnacles_content = pinnaclesList.map((p, idx) => {
const isCurrent = (idx + 1) === currentPinnacle;
const pinnacleNum = p.number;
const challengeNum = p.challenge;
const ageRange = p.ageEnd === 999 ? `Age ${p.ageStart}+` : `Ages ${p.ageStart}-${p.ageEnd}`;
const currentMarker = isCurrent ? ' \\textcolor{accent}{\\textbf{(CURRENT)}}' : '';
return `
\\subsection{${pinnacleNames[idx]}${currentMarker}: ${pinnacleNum} ${getMasterSymbol(pinnacleNum)}}
\\textbf{${ageRange}}
\\begin{tcolorbox}[meaningbox]
\\textbf{Theme:}
${escapeLatex(pinnacleDescriptions[pinnacleNum] || 'Development and growth.')}
\\vspace{0.3cm}
\\textbf{Challenge Number: ${challengeNum}}
${escapeLatex(challengeDescriptions[challengeNum] || 'Learning and growth opportunity.')}
${isCurrent ? `\\vspace{0.3cm}\n \\textcolor{accent}{\\textbf{You are currently in this pinnacle.}} This is the primary energy shaping your life right now.` : ''}
\\end{tcolorbox}
`;
}).join('\n');
// Optimal Days section
const dayMeanings: Record<number, string> = {
1: 'New beginnings, launches, starting projects',
2: 'Cooperation, partnerships, negotiations',
3: 'Creative work, socializing, presentations',
4: 'Organization, building systems, practical work',
5: 'Networking, trying new things, marketing',
6: 'Family matters, counseling, creating harmony',
7: 'Research, planning, spiritual work',
8: 'Business deals, financial decisions, leadership',
9: 'Completion, letting go, humanitarian work',
11: 'Inspirational work, teaching, intuitive guidance',
22: 'Large-scale projects, master building',
33: 'Healing, teaching with compassion'
};
const groupedDays: Record<string, Date[]> = {};
optimalDays.forEach(day => {
const dayNum = day.personalDay;
const key = `Day ${dayNum}: ${dayMeanings[dayNum] || 'General activities'}`;
if (!groupedDays[key]) groupedDays[key] = [];
groupedDays[key].push(day.date);
});
// Show all day types (1-9, 11, 22, 33)
vars.optimalDays_content = Object.entries(groupedDays).map(([desc, dates]) => {
const dateList = dates.slice(0, 5).map(d => d.toLocaleDateString('en-US', { month: 'short', day: 'numeric' })).join(', ');
const more = dates.length > 5 ? ` (and ${dates.length - 5} more)` : '';
return `\\textbf{${escapeLatex(desc)}}\\\\${dateList}${more}\\\\[0.3cm]`;
}).join('\n');
// Year Ahead section
const monthNames = ['January', 'February', 'March', 'April', 'May', 'June', 'July', 'August', 'September', 'October', 'November', 'December'];
const yearAheadPersonalYear = reduce(reduce(parseInt(birthdate.split('/')[0])) + reduce(parseInt(birthdate.split('/')[1])) + reduce(nextYear));
vars.nextYear = nextYear.toString();
vars.yearAhead_content = `
\\begin{tcolorbox}[meaningbox]
\\textbf{Your Personal Year ${yearAheadPersonalYear} in ${nextYear}}
${escapeLatex(personalYear[yearAheadPersonalYear]?.theme || 'A year of growth and development.')}
\\vspace{0.3cm}
\\textbf{Monthly Breakdown:}
\\begin{itemize}[leftmargin=1.5cm]
${yearAheadCycles.map(({ month, personalMonth: pmNum }) => {
const monthName = monthNames[month - 1];
const pmMeaning = personalMonth[pmNum];
const theme = pmMeaning?.keywords?.[0] || 'Development';
return ` \\item \\textbf{${monthName}:} Personal Month ${pmNum} - ${escapeLatex(theme)}`;
}).join('\n')}
\\end{itemize}
\\vspace{0.3cm}
\\textit{Best months for new beginnings: ${yearAheadCycles.filter(c => c.personalMonth === 1).map(c => monthNames[c.month - 1]).join(', ') || 'See your Personal Year theme'}}
\\textit{Best months for completion: ${yearAheadCycles.filter(c => c.personalMonth === 9).map(c => monthNames[c.month - 1]).join(', ') || 'See your Personal Year theme'}}
\\end{tcolorbox}
`;
// Master numbers section
const masterNumbers = [];
if ([11, 22, 33].includes(coreNumbers.lifePath)) masterNumbers.push(`Life Path ${coreNumbers.lifePath}`);
if ([11, 22, 33].includes(coreNumbers.expression)) masterNumbers.push(`Expression ${coreNumbers.expression}`);
if ([11, 22, 33].includes(coreNumbers.soulUrge)) masterNumbers.push(`Soul Urge ${coreNumbers.soulUrge}`);
if ([11, 22, 33].includes(additionalNumbers.maturity)) masterNumbers.push(`Maturity ${additionalNumbers.maturity}`);
if ([11, 22, 33].includes(additionalNumbers.personality)) masterNumbers.push(`Personality ${additionalNumbers.personality}`);
if (masterNumbers.length > 0) {
vars.masterNumbers_section = `
\\begin{tcolorbox}[numberbox]
\\textcolor{accent}{\\textbf{✨ You have ${masterNumbers.length} Master Number(s) in your chart!}}
\\vspace{0.3cm}
${masterNumbers.map(m => `\\textbf{${escapeLatex(m)}}`).join(' • ')}
\\vspace{0.3cm}
Master numbers (11, 22, 33) carry heightened spiritual significance and greater responsibility. They represent advanced soul development and the potential for making a significant impact on the world.
\\end{tcolorbox}
`;
} else {
vars.masterNumbers_section = `
\\begin{tcolorbox}[meaningbox]
You have no master numbers in your chart. This doesn't diminish your potential - it simply means your path is about mastering the single-digit energies with depth and consistency.
\\end{tcolorbox}
`;
}
// Synthesis variables (simplified summaries)
vars.synthesis_core = escapeLatex(lifePathMeaning.keywords.slice(0, 3).join(', ').toLowerCase());
vars.synthesis_soul = escapeLatex(soulUrgeMeaning.keywords[0].toLowerCase());
vars.synthesis_year = escapeLatex(personalYearMeaning.keywords.slice(0, 2).join(' and ').toLowerCase());
// Fix maturity synthesis to be more verbose
const maturityAge = 40; // This could be calculated based on Life Path
vars.synthesis_maturity = escapeLatex(`embodies ${maturityMeaning.keywords.slice(0, 2).join(' and ').toLowerCase()}`);
// Recommendations (generic for now - could be more personalized)
vars.rec_lifePath = escapeLatex(`Focus on the themes of ${lifePathMeaning.keywords.slice(0, 2).join(' and ').toLowerCase()}. This is your primary life purpose.`);
vars.rec_expression = escapeLatex(`Use your natural talents in ${expressionMeaning.keywords.slice(0, 2).join(' and ').toLowerCase()} to fulfill your Life Path.`);
vars.rec_soulUrge = escapeLatex(`Honor your deep desire for ${soulUrgeMeaning.keywords[0].toLowerCase()}. When you do, you'll feel most alive.`);
vars.rec_karmic = additionalNumbers.karmicLessons.length > 0
? escapeLatex(`Pay special attention to developing ${additionalNumbers.karmicLessons.map(n => karmicLessonMeanings[n].keywords[0].toLowerCase()).join(', ')}. These are growth areas.`)
: escapeLatex('You have no karmic lessons, so focus on refining and mastering your existing talents.');
vars.rec_cycles = escapeLatex(`This Personal Year ${cycles.personal.year} is about ${personalYearMeaning.keywords[0].toLowerCase()}. Align your actions with this energy.`);
// Read template
console.log('Reading LaTeX template...');
const templatePath = './templates/report-template.tex';
const templateFile = Bun.file(templatePath);
let template = await templateFile.text();
// Replace all variables
console.log('Populating template...');
for (const [key, value] of Object.entries(vars)) {
template = template.replace(new RegExp(`\\\\VAR{${key}}`, 'g'), value);
}
// Write populated template to temp file
const tempTexPath = '/tmp/numerology-report.tex';
await Bun.write(tempTexPath, template);
console.log(`LaTeX file generated: ${tempTexPath}`);
console.log('Compiling to PDF...');
// Compile with pdflatex
const proc = Bun.spawn(['pdflatex', '-interaction=nonstopmode', '-output-directory=/tmp', tempTexPath], {
stdout: 'pipe',
stderr: 'pipe',
});
await proc.exited;
if (proc.exitCode !== 0) {
console.error('Error: pdflatex compilation failed');
console.error('Make sure texlive is installed: sudo apt install texlive-latex-extra texlive-fonts-extra');
process.exit(1);
}
// Run pdflatex again for table of contents
const proc2 = Bun.spawn(['pdflatex', '-interaction=nonstopmode', '-output-directory=/tmp', tempTexPath], {
stdout: 'pipe',
stderr: 'pipe',
});
await proc2.exited;
// Move PDF to output location
const tempPdfPath = '/tmp/numerology-report.pdf';
await Bun.write(outputPath, Bun.file(tempPdfPath));
console.log(`\n✨ Report generated successfully!`);
console.log(`📄 Output: ${outputPath}`);
console.log(`\nOpen with: xdg-open ${outputPath}`);

451
meanings.ts Normal file
View file

@ -0,0 +1,451 @@
/**
* Numerology Meanings Database
* Comprehensive interpretations for Life Path, Expression, Soul Urge, and Birthday numbers
*/
export interface NumberMeaning {
keywords: string[];
description: string;
strengths: string[];
challenges: string[];
lifePurpose?: string;
careerPaths?: string[];
relationships?: string;
spiritualLesson?: string;
}
// Life Path Numbers - Your life's purpose and journey
export const lifePath: Record<number, NumberMeaning> = {
1: {
keywords: ["Leadership", "Independence", "Innovation", "Pioneering"],
description: "The Leader and Pioneer. You are here to develop independence, leadership, and originality. Your path involves initiating new ideas and courageously forging ahead where others hesitate.",
strengths: ["Natural leadership", "Independent thinking", "Innovative spirit", "Courage", "Determination"],
challenges: ["Can be domineering or self-centered", "May struggle with collaboration", "Tendency toward stubbornness", "Fear of appearing weak"],
lifePurpose: "To inspire others through your courage and vision, and to pioneer new ways of thinking and being.",
careerPaths: ["Entrepreneur", "CEO", "Inventor", "Military leader", "Pioneer in any field"],
relationships: "You need a partner who respects your independence but can also stand their ground. Avoid power struggles.",
spiritualLesson: "Learning that true leadership serves others, not just the ego."
},
2: {
keywords: ["Cooperation", "Diplomacy", "Sensitivity", "Partnership"],
description: "The Diplomat and Peacemaker. Your life path is about developing cooperation, diplomacy, and sensitivity to others. You excel at bringing people together and creating harmony.",
strengths: ["Excellent mediator", "Highly intuitive", "Diplomatic", "Patient", "Supportive"],
challenges: ["Can be overly sensitive", "May avoid confrontation", "Tendency to lose yourself in relationships", "Fear of conflict"],
lifePurpose: "To bring peace and harmony through cooperation, understanding, and gentle persuasion.",
careerPaths: ["Counselor", "Mediator", "Diplomat", "Teacher", "Social worker", "Musician"],
relationships: "You thrive in partnerships and need emotional connection. Guard against codependency.",
spiritualLesson: "Learning to maintain your identity while in relationship with others."
},
3: {
keywords: ["Creativity", "Expression", "Joy", "Communication"],
description: "The Creative Communicator. Your path involves expressing yourself creatively and inspiring joy in others. You're here to communicate, create, and spread optimism.",
strengths: ["Highly creative", "Excellent communicator", "Optimistic", "Entertaining", "Inspiring"],
challenges: ["Can scatter energy", "May be superficial", "Tendency to exaggerate", "Difficulty with focus"],
lifePurpose: "To inspire others through creative expression and to bring joy and beauty into the world.",
careerPaths: ["Artist", "Writer", "Performer", "Designer", "Marketing", "Public speaker"],
relationships: "You need a partner who appreciates your creativity and gives you freedom to express yourself.",
spiritualLesson: "Learning to focus your creative energy and go deeper than surface appearances."
},
4: {
keywords: ["Stability", "Foundation", "Hard Work", "Discipline"],
description: "The Builder and Organizer. Your life path is about creating solid foundations through discipline, hard work, and practical action. You bring order to chaos.",
strengths: ["Highly organized", "Reliable", "Disciplined", "Practical", "Strong work ethic"],
challenges: ["Can be rigid", "May resist change", "Tendency toward workaholism", "Fear of instability"],
lifePurpose: "To build lasting structures and systems that serve humanity for generations.",
careerPaths: ["Engineer", "Architect", "Accountant", "Manager", "Military", "Craftsperson"],
relationships: "You need stability and loyalty. You show love through actions more than words.",
spiritualLesson: "Learning flexibility and that sometimes you must tear down old structures to build anew."
},
5: {
keywords: ["Freedom", "Adventure", "Change", "Versatility"],
description: "The Freedom Seeker and Adventurer. Your path involves embracing change, seeking freedom, and experiencing life's variety. You're here to explore and adapt.",
strengths: ["Highly adaptable", "Adventurous", "Versatile", "Quick thinking", "Charismatic"],
challenges: ["Can be restless", "May avoid commitment", "Tendency toward excess", "Fear of limitation"],
lifePurpose: "To teach others about freedom, change, and the importance of experiencing life fully.",
careerPaths: ["Travel industry", "Sales", "Marketing", "Entertainment", "Journalism", "Entrepreneur"],
relationships: "You need freedom and variety. Choose a partner who's also adventurous and independent.",
spiritualLesson: "Learning that true freedom comes from mastery, not escape, and that commitment can liberate."
},
6: {
keywords: ["Responsibility", "Nurturing", "Service", "Harmony"],
description: "The Nurturer and Caregiver. Your life path is about responsibility, service to others, and creating harmony in your environment. You're the cosmic parent.",
strengths: ["Highly responsible", "Nurturing", "Excellent counselor", "Artistic", "Protective"],
challenges: ["Can be controlling", "May martyr yourself", "Tendency toward perfectionism", "Fear of being needed"],
lifePurpose: "To serve and nurture others while creating beauty and harmony in your environment.",
careerPaths: ["Healthcare", "Teaching", "Counseling", "Interior design", "Social work", "Chef"],
relationships: "You're naturally giving but must learn to receive. Choose someone who appreciates your care.",
spiritualLesson: "Learning when to help and when to let others learn their own lessons."
},
7: {
keywords: ["Wisdom", "Analysis", "Spirituality", "Introspection"],
description: "The Seeker and Analyst. Your path involves developing wisdom through introspection, analysis, and spiritual seeking. You're here to understand life's mysteries.",
strengths: ["Highly analytical", "Intuitive", "Spiritual depth", "Intellectual", "Discerning"],
challenges: ["Can be aloof", "May isolate yourself", "Tendency toward cynicism", "Fear of betrayal"],
lifePurpose: "To seek truth and wisdom, and to teach others to look beneath surface appearances.",
careerPaths: ["Scientist", "Researcher", "Spiritual teacher", "Analyst", "Writer", "Philosopher"],
relationships: "You need intellectual and spiritual connection. You require alone time to recharge.",
spiritualLesson: "Learning to trust and connect with others while maintaining your need for solitude."
},
8: {
keywords: ["Power", "Abundance", "Achievement", "Material Mastery"],
description: "The Powerhouse and Authority. Your life path is about mastering the material world and wielding power responsibly. You're here to achieve and empower others.",
strengths: ["Natural authority", "Business acumen", "Ambitious", "Confident", "Excellent judge of character"],
challenges: ["Can be materialistic", "May become power-hungry", "Tendency toward workaholism", "Fear of powerlessness"],
lifePurpose: "To achieve material success while using your power and resources to benefit humanity.",
careerPaths: ["Executive", "Banker", "Real estate", "Politician", "Attorney", "Large-scale entrepreneur"],
relationships: "You need a strong partner who respects your ambition. Avoid letting work consume your relationships.",
spiritualLesson: "Learning that true power comes from service and that material success should uplift others."
},
9: {
keywords: ["Compassion", "Completion", "Humanitarianism", "Wisdom"],
description: "The Humanitarian and Sage. Your path involves compassion, completion, and service to humanity. You're here to give back and help heal the world.",
strengths: ["Highly compassionate", "Wise", "Artistic", "Tolerant", "Humanitarian"],
challenges: ["Can be emotionally distant", "May become bitter", "Tendency toward martyrdom", "Fear of loss"],
lifePurpose: "To serve humanity with compassion and to help bring completion to old cycles.",
careerPaths: ["Non-profit work", "Healing arts", "Teacher", "Artist", "Philanthropist", "Counselor"],
relationships: "You love humanity but may struggle with intimacy. Choose someone who understands your mission.",
spiritualLesson: "Learning to receive as well as give, and that self-care enables you to serve better."
},
11: {
keywords: ["Inspiration", "Intuition", "Illumination", "Master Teacher"],
description: "The Inspired Illuminator (Master Number). You have a powerful spiritual mission to inspire and enlighten others. You're a channel for higher wisdom.",
strengths: ["Highly intuitive", "Inspirational", "Visionary", "Sensitive", "Idealistic"],
challenges: ["Can be impractical", "May be overwhelmed by sensitivity", "Tendency toward nervous tension", "Fear of your own power"],
lifePurpose: "To inspire humanity to reach higher levels of consciousness and to channel divine wisdom.",
careerPaths: ["Spiritual teacher", "Motivational speaker", "Artist", "Healer", "Inventor", "Visionary entrepreneur"],
relationships: "You need a spiritually-minded partner who can ground your energy and support your mission.",
spiritualLesson: "Learning to ground your visions in practical reality and to manage your sensitive nervous system."
},
22: {
keywords: ["Master Builder", "Visionary", "Manifestation", "Large-scale Impact"],
description: "The Master Builder. You're here to manifest grand visions that benefit humanity. You combine spiritual insight with practical ability.",
strengths: ["Visionary thinking", "Practical mastery", "Leadership", "Ability to manifest on large scale", "Inspiring"],
challenges: ["Can feel overwhelmed by responsibility", "May self-sabotage", "Tendency toward extremes", "Fear of failure"],
lifePurpose: "To manifest large-scale projects that serve humanity and to build lasting legacies.",
careerPaths: ["Architect", "Large-scale entrepreneur", "Visionary leader", "Social innovator", "Master craftsperson"],
relationships: "You need a stable partner who believes in your vision and can help ground your grand ideas.",
spiritualLesson: "Learning that patience and persistence are required to manifest great visions."
},
33: {
keywords: ["Master Teacher", "Healing", "Selfless Service", "Divine Love"],
description: "The Master Teacher (rare). You're here to embody and teach unconditional love and selfless service. Your life is about uplifting humanity.",
strengths: ["Profound compassion", "Natural healer", "Inspiring teacher", "Selfless", "Wise"],
challenges: ["Can become overwhelmed by others' pain", "May neglect self", "Tendency toward martyrdom", "Fear of not doing enough"],
lifePurpose: "To teach and embody unconditional love, and to heal on a profound level.",
careerPaths: ["Spiritual teacher", "Healer", "Humanitarian leader", "Counselor", "Minister", "Social innovator"],
relationships: "You give deeply but must learn healthy boundaries. Choose someone who honors your sensitive nature.",
spiritualLesson: "Learning that you can't save everyone and that self-care is essential to your mission."
}
};
// Expression Numbers - Your natural talents and abilities
export const expression: Record<number, NumberMeaning> = {
1: {
keywords: ["Leadership", "Originality", "Independence"],
description: "You have natural leadership abilities and original thinking. You're meant to pioneer and initiate.",
lifePurpose: "Your natural talents lie in leading, initiating, and pioneering new paths. You're here to express bold independence and original ideas. When you confidently step forward as a leader, you fulfill your highest expression.",
strengths: ["Independent", "Original", "Courageous", "Confident", "Determined"],
challenges: ["Can be domineering", "May struggle to collaborate", "Tendency toward stubbornness"],
careerPaths: ["Entrepreneur", "CEO", "Manager", "Inventor", "Independent consultant"],
relationships: "You express yourself as a natural leader. You need a partner who respects your autonomy and decision-making abilities."
},
2: {
keywords: ["Cooperation", "Diplomacy", "Sensitivity"],
description: "You have natural diplomatic abilities and sensitivity. You're meant to bring people together.",
lifePurpose: "Your gifts shine brightest when you're bringing people together and creating harmony. You express yourself through cooperation, diplomacy, and sensitivity to others' needs. Partnerships and collaboration are your forte.",
strengths: ["Diplomatic", "Cooperative", "Intuitive", "Patient", "Detailed"],
challenges: ["Can be overly sensitive", "May avoid conflict", "Tendency toward self-doubt"],
careerPaths: ["Counselor", "Mediator", "Team coordinator", "Diplomat", "Social worker"],
relationships: "You express yourself through cooperation and support. You thrive when working alongside others in harmony."
},
3: {
keywords: ["Creativity", "Expression", "Communication"],
description: "You have natural creative and communication abilities. You're meant to inspire through expression.",
lifePurpose: "You're a natural communicator and creative soul. Your talents emerge through artistic expression, joyful communication, and inspiring others with your optimism. Self-expression in all its forms is your calling.",
strengths: ["Creative", "Expressive", "Optimistic", "Charming", "Entertaining"],
challenges: ["Can scatter energy", "May be superficial", "Tendency toward exaggeration"],
careerPaths: ["Artist", "Writer", "Performer", "Designer", "Public speaker", "Marketing specialist"],
relationships: "You express yourself creatively and joyfully. You need a partner who appreciates your spontaneity and artistic nature."
},
4: {
keywords: ["Building", "Organization", "Discipline"],
description: "You have natural organizational and building abilities. You're meant to create solid foundations.",
lifePurpose: "You possess exceptional skills in organization, building lasting structures, and creating order from chaos. Your disciplined approach and practical mindset allow you to manifest tangible results that stand the test of time.",
strengths: ["Organized", "Reliable", "Practical", "Disciplined", "Detail-oriented"],
challenges: ["Can be rigid", "May resist change", "Tendency toward being overly serious"],
careerPaths: ["Engineer", "Accountant", "Project manager", "Builder", "Systems analyst"],
relationships: "You express yourself through dependable actions and practical support. You value stability and loyalty."
},
5: {
keywords: ["Freedom", "Versatility", "Adventure"],
description: "You have natural adaptability and communication skills. You're meant to experience and teach variety.",
lifePurpose: "Your talents thrive in dynamic environments where change is constant. You're a natural communicator who can adapt to any situation, and you're here to experience life's full spectrum and teach others about freedom and flexibility.",
strengths: ["Adaptable", "Versatile", "Energetic", "Persuasive", "Progressive"],
challenges: ["Can be restless", "May lack focus", "Tendency toward excess"],
careerPaths: ["Sales", "Travel agent", "Journalist", "Performer", "Marketing", "Entrepreneur"],
relationships: "You express yourself through variety and freedom. You need a partner who shares your love of adventure and change."
},
6: {
keywords: ["Responsibility", "Service", "Nurturing"],
description: "You have natural nurturing and counseling abilities. You're meant to serve and create harmony.",
lifePurpose: "You're a natural caregiver and counselor with an innate ability to nurture and create harmony. Your talents flourish when you're serving others, creating beauty, and taking responsibility for those in your care.",
strengths: ["Responsible", "Nurturing", "Artistic", "Protective", "Helpful"],
challenges: ["Can be interfering", "May become martyr", "Tendency toward perfectionism"],
careerPaths: ["Healthcare", "Teaching", "Interior design", "Chef", "Counselor", "Social services"],
relationships: "You express yourself through caring and service. You naturally take care of others and create beautiful environments."
},
7: {
keywords: ["Analysis", "Wisdom", "Spirituality"],
description: "You have natural analytical and spiritual abilities. You're meant to seek truth and wisdom.",
lifePurpose: "You possess exceptional analytical abilities and a deep spiritual nature. Your gifts emerge through research, contemplation, and seeking truth. You're here to gain wisdom and share profound insights with others.",
strengths: ["Analytical", "Intuitive", "Spiritual", "Intellectual", "Perfectionist"],
challenges: ["Can be aloof", "May be overly critical", "Tendency toward isolation"],
careerPaths: ["Researcher", "Analyst", "Scientist", "Spiritual teacher", "Detective", "Writer"],
relationships: "You express yourself through intellectual depth and spiritual insight. You need alone time and a mentally stimulating partner."
},
8: {
keywords: ["Power", "Achievement", "Material Mastery"],
description: "You have natural business and leadership abilities. You're meant to achieve and empower.",
lifePurpose: "You have a natural command of the material world and business acumen that sets you apart. Your talents lie in achieving success, wielding power responsibly, and empowering others through your leadership and financial expertise.",
strengths: ["Authoritative", "Business-minded", "Efficient", "Ambitious", "Confident"],
challenges: ["Can be materialistic", "May be power-hungry", "Tendency toward workaholism"],
careerPaths: ["Executive", "Banker", "Real estate", "Attorney", "Business owner", "Financial advisor"],
relationships: "You express yourself through achievement and success. You need a partner who respects your ambition and drive."
},
9: {
keywords: ["Compassion", "Humanitarianism", "Wisdom"],
description: "You have natural compassion and artistic abilities. You're meant to serve humanity.",
lifePurpose: "Your soul naturally gravitates toward compassion and humanitarian service. You possess artistic sensibilities and a deep understanding of human nature. You're here to serve humanity with wisdom and grace.",
strengths: ["Compassionate", "Artistic", "Generous", "Tolerant", "Wise"],
challenges: ["Can be impractical", "May become bitter", "Tendency toward emotional distance"],
careerPaths: ["Non-profit work", "Artist", "Teacher", "Healer", "Counselor", "Humanitarian worker"],
relationships: "You express yourself through compassion and service. You love humanity and need a partner who shares your ideals."
},
11: {
keywords: ["Inspiration", "Intuition", "Illumination"],
description: "You have natural inspirational and intuitive abilities. You're meant to inspire and illuminate.",
lifePurpose: "You carry the master number 11, indicating powerful intuitive abilities and a mission to inspire. You're a channel for higher wisdom, meant to illuminate paths for others and bring spiritual insight to the world.",
strengths: ["Intuitive", "Inspirational", "Idealistic", "Visionary", "Sensitive"],
challenges: ["Can be impractical", "May be overly sensitive", "Tendency toward nervous tension"],
careerPaths: ["Spiritual teacher", "Motivational speaker", "Artist", "Healer", "Counselor", "Visionary entrepreneur"],
relationships: "You express yourself through inspiration and intuition. You need a spiritually-minded partner who understands your sensitivity."
},
22: {
keywords: ["Master Building", "Visionary Leadership", "Manifestation"],
description: "You have master building abilities. You're meant to manifest large-scale visions.",
lifePurpose: "As a master number 22, you possess rare abilities to manifest grand visions into concrete reality. You combine visionary thinking with practical mastery, capable of building legacies that serve humanity on a large scale.",
strengths: ["Visionary", "Practical", "Leadership", "Master builder", "Inspiring"],
challenges: ["Can feel overwhelmed", "May self-sabotage", "Tendency toward extremes"],
careerPaths: ["Architect", "Large-scale entrepreneur", "Visionary leader", "Social innovator", "Master builder"],
relationships: "You express yourself through grand visions and practical mastery. You need a partner who believes in your large-scale dreams."
},
33: {
keywords: ["Master Teaching", "Healing", "Selfless Service"],
description: "You have master teaching abilities. You're meant to teach love and heal.",
lifePurpose: "You embody the master number 33, the most powerful of all. You're a master teacher and healer, here to uplift humanity through unconditional love and compassionate service. Your gifts are profound and far-reaching.",
strengths: ["Compassionate", "Healing", "Teaching", "Selfless", "Wise"],
challenges: ["Can become overwhelmed", "May neglect self", "Tendency toward martyrdom"],
careerPaths: ["Spiritual teacher", "Healer", "Humanitarian leader", "Minister", "Master counselor"],
relationships: "You express yourself through healing and teaching. You need a partner who honors your sensitive nature and spiritual mission."
}
};
// Soul Urge Numbers - Your inner desires and motivations
export const soulUrge: Record<number, NumberMeaning> = {
1: {
keywords: ["Independence", "Achievement", "Leadership"],
description: "You desire independence, recognition, and to lead. You want to stand out and be first.",
lifePurpose: "At your core, you yearn for independence and the freedom to lead your own way. You're driven by a deep need for recognition and achievement. Your inner motivation is to stand out, be first, and make your mark as an individual.",
strengths: ["Self-motivated", "Ambitious", "Courageous"],
challenges: ["Can be self-centered", "May struggle with authority", "Need for recognition"],
careerPaths: ["Leadership roles", "Solo ventures", "Competitive fields", "Pioneering work"],
relationships: "Deep down, you crave recognition and the freedom to lead. You need a partner who celebrates your achievements."
},
2: {
keywords: ["Peace", "Harmony", "Partnership"],
description: "You desire peace, harmony, and meaningful relationships. You want to belong and connect.",
lifePurpose: "Your deepest desire is for peace, harmony, and genuine connection with others. You're motivated by a soul-level need to belong, to create harmonious relationships, and to experience true partnership. Cooperation and emotional intimacy fulfill you.",
strengths: ["Empathetic", "Cooperative", "Supportive"],
challenges: ["Can lose yourself in relationships", "May avoid confrontation", "Need for approval"],
careerPaths: ["Partnership roles", "Mediation", "Team environments", "Support positions"],
relationships: "Your soul craves deep connection and harmony. You need a partner who values emotional intimacy and cooperation."
},
3: {
keywords: ["Self-Expression", "Joy", "Creativity"],
description: "You desire creative expression, joy, and to inspire others. You want to be seen and appreciated.",
lifePurpose: "Your soul craves creative expression, joy, and the opportunity to inspire others with your unique gifts. You're driven by a deep need to be seen, appreciated, and celebrated for who you truly are. Self-expression brings you alive.",
strengths: ["Creative", "Joyful", "Inspiring"],
challenges: ["Can be attention-seeking", "May avoid depth", "Need for validation"],
careerPaths: ["Creative fields", "Performance", "Communication roles", "Entertainment"],
relationships: "You desire joy, creativity, and appreciation. You need a partner who celebrates your uniqueness and shares your playful spirit."
},
4: {
keywords: ["Security", "Order", "Achievement"],
description: "You desire security, order, and tangible achievement. You want to build something lasting.",
lifePurpose: "Deep within, you yearn for security, stability, and tangible results you can see and touch. You're motivated by the desire to build something lasting and create order from chaos. Concrete achievement and practical accomplishment fulfill your soul.",
strengths: ["Hardworking", "Dependable", "Practical"],
challenges: ["Can be controlling", "May resist change", "Need for stability"],
careerPaths: ["Building trades", "Systems work", "Management", "Structured environments"],
relationships: "You crave security and stability. You need a dependable partner who shares your values of hard work and loyalty."
},
5: {
keywords: ["Freedom", "Variety", "Experience"],
description: "You desire freedom, variety, and new experiences. You want to explore and remain unbound.",
lifePurpose: "Your soul thirsts for freedom, adventure, and the full spectrum of life's experiences. You're driven by an intense need for variety, exploration, and the liberty to move freely through life without constraints. New experiences energize your spirit.",
strengths: ["Adventurous", "Adaptable", "Progressive"],
challenges: ["Can be restless", "May avoid commitment", "Need for constant change"],
careerPaths: ["Travel", "Sales", "Variety-rich roles", "Flexible positions"],
relationships: "Your soul craves freedom and adventure. You need a partner who respects your independence and shares your love of exploration."
},
6: {
keywords: ["Love", "Service", "Responsibility"],
description: "You desire to love, nurture, and be needed. You want to create harmony and serve others.",
lifePurpose: "At your deepest level, you desire to love unconditionally, to nurture, and to be needed by those you care for. You're motivated by a profound wish to serve others, create harmony, and take responsibility for the wellbeing of your loved ones.",
strengths: ["Caring", "Responsible", "Protective"],
challenges: ["Can be controlling", "May martyr yourself", "Need to be needed"],
careerPaths: ["Caregiving", "Teaching", "Counseling", "Service industries"],
relationships: "You deeply desire to love and be needed. You need a partner who appreciates your nurturing nature without taking advantage."
},
7: {
keywords: ["Truth", "Understanding", "Wisdom"],
description: "You desire truth, understanding, and spiritual wisdom. You want to know the deeper meaning.",
lifePurpose: "Your soul seeks truth, understanding, and the wisdom that comes from deep contemplation. You're driven by an insatiable need to know the deeper meaning of life, to understand the mysteries, and to gain spiritual and intellectual insight.",
strengths: ["Introspective", "Analytical", "Spiritual"],
challenges: ["Can be isolated", "May be cynical", "Need for alone time"],
careerPaths: ["Research", "Analysis", "Spiritual work", "Academic fields"],
relationships: "Your soul seeks truth and deep understanding. You need a partner who respects your need for solitude and intellectual depth."
},
8: {
keywords: ["Success", "Recognition", "Influence"],
description: "You desire success, recognition, and influence. You want power and material achievement.",
lifePurpose: "Deep within, you crave success, recognition, and the power to influence the world around you. You're motivated by material achievement, authority, and the desire to wield power responsibly. Financial abundance and worldly accomplishment drive you.",
strengths: ["Ambitious", "Determined", "Authoritative"],
challenges: ["Can be materialistic", "May be power-hungry", "Need for control"],
careerPaths: ["Business", "Finance", "Executive roles", "Positions of authority"],
relationships: "You crave success and recognition. You need a strong partner who respects your ambition and isn't intimidated by your drive."
},
9: {
keywords: ["Universal Love", "Service", "Compassion"],
description: "You desire to serve humanity and express universal love. You want to make a difference.",
lifePurpose: "Your soul yearns to serve humanity with compassion and express universal love that transcends personal boundaries. You're driven by a deep desire to make a meaningful difference in the world and to help heal collective suffering.",
strengths: ["Compassionate", "Idealistic", "Generous"],
challenges: ["Can be impractical", "May become bitter if disappointed", "Need to save the world"],
careerPaths: ["Humanitarian work", "Healing arts", "Social causes", "Philanthropy"],
relationships: "Your soul seeks to serve humanity. You need a partner who shares your ideals and understands your universal love."
},
11: {
keywords: ["Inspiration", "Spiritual Connection", "Illumination"],
description: "You desire to inspire and be spiritually connected. You want to channel higher wisdom.",
lifePurpose: "Your soul carries the master number 11, indicating a deep spiritual calling to inspire others and channel higher wisdom. You're driven by a profound need for spiritual connection, to illuminate paths for others, and to bring divine insight into the world.",
strengths: ["Intuitive", "Inspirational", "Visionary"],
challenges: ["Can be impractical", "May feel overwhelmed", "Need for spiritual purpose"],
careerPaths: ["Spiritual teaching", "Inspirational roles", "Intuitive work", "Visionary leadership"],
relationships: "Your soul craves spiritual connection and purpose. You need a spiritually aware partner who supports your mission."
},
22: {
keywords: ["Master Achievement", "Legacy", "Large Impact"],
description: "You desire to build something of lasting significance. You want to leave a major legacy.",
lifePurpose: "With master number 22, your soul desires to build something monumental that serves humanity. You're driven by the need to manifest grand visions, create lasting legacies, and make a large-scale impact that endures beyond your lifetime.",
strengths: ["Visionary", "Practical", "Ambitious"],
challenges: ["Can feel overwhelmed", "May self-sabotage", "Need for large-scale impact"],
careerPaths: ["Large-scale projects", "Visionary leadership", "Master building", "Legacy work"],
relationships: "You desire to create something monumental. You need a partner who believes in your vision and helps ground your grand dreams."
},
33: {
keywords: ["Universal Service", "Healing", "Unconditional Love"],
description: "You desire to heal and serve humanity with unconditional love. You want to uplift all beings.",
lifePurpose: "Your soul embodies the master number 33, the highest calling. You're driven by a profound desire to heal, teach, and serve humanity with unconditional love. Your deepest motivation is to uplift all beings and embody compassionate service at the highest level.",
strengths: ["Compassionate", "Healing", "Selfless"],
challenges: ["Can become overwhelmed", "May neglect self", "Need to help everyone"],
careerPaths: ["Healing professions", "Spiritual teaching", "Humanitarian leadership", "Selfless service"],
relationships: "Your soul seeks to heal and uplift all beings. You need a partner who honors your sensitivity and supports your healing mission."
}
};
// Birthday Numbers - Special talents from your birth day
export const birthday: Record<number, NumberMeaning> = {
1: {
keywords: ["Leadership", "Innovation", "Courage"],
description: "You have a natural ability to lead and pioneer. Original thinking is your gift.",
lifePurpose: "Born with innate leadership abilities, you came into this world with the gift of original thinking and courage. This special talent allows you to pioneer new paths and inspire others through your independent spirit.",
strengths: ["Leadership", "Independence", "Originality"],
challenges: ["Can be domineering", "May struggle with collaboration"]
},
2: {
keywords: ["Diplomacy", "Cooperation", "Sensitivity"],
description: "You have a natural ability to mediate and bring people together. Diplomacy is your gift.",
lifePurpose: "You were born with exceptional diplomatic abilities and sensitivity to others' needs. Your special gift is bringing people together, mediating conflicts, and creating harmony through tactful cooperation.",
strengths: ["Cooperation", "Tact", "Intuition"],
challenges: ["Can be overly sensitive", "May avoid confrontation"]
},
3: {
keywords: ["Creativity", "Communication", "Joy"],
description: "You have a natural ability to create and communicate. Creative expression is your gift.",
lifePurpose: "You came into life with natural creative and communication abilities. Your special gift is expressing yourself artistically, bringing joy to others, and inspiring through your optimistic and creative spirit.",
strengths: ["Creativity", "Self-expression", "Optimism"],
challenges: ["Can scatter energy", "May be superficial"]
},
4: {
keywords: ["Organization", "Building", "Discipline"],
description: "You have a natural ability to organize and build. Creating order is your gift.",
lifePurpose: "Born with exceptional organizational abilities, you possess the special gift of creating order from chaos and building lasting structures. Your natural discipline and reliability are talents you brought into this lifetime.",
strengths: ["Organization", "Discipline", "Reliability"],
challenges: ["Can be rigid", "May resist change"]
},
5: {
keywords: ["Adaptability", "Freedom", "Communication"],
description: "You have a natural ability to adapt and communicate. Versatility is your gift.",
lifePurpose: "You were born with remarkable adaptability and versatility. Your special gift is the ability to handle change with grace, communicate effectively in any situation, and teach others about freedom and flexibility.",
strengths: ["Adaptability", "Versatility", "Freedom-loving"],
challenges: ["Can be restless", "May lack focus"]
},
6: {
keywords: ["Responsibility", "Nurturing", "Service"],
description: "You have a natural ability to nurture and take responsibility. Service is your gift.",
lifePurpose: "You came into this world with innate nurturing abilities and a sense of responsibility. Your special gift is caring for others, creating harmony, and serving with a loving, protective nature.",
strengths: ["Responsibility", "Nurturing", "Harmony-seeking"],
challenges: ["Can be interfering", "May become martyr"]
},
7: {
keywords: ["Analysis", "Wisdom", "Introspection"],
description: "You have a natural ability to analyze and seek wisdom. Deep thinking is your gift.",
lifePurpose: "Born with profound analytical and spiritual abilities, you possess the special gift of seeing beneath surface appearances and understanding life's deeper mysteries. Your intuitive wisdom is your birthright.",
strengths: ["Analysis", "Spirituality", "Intuition"],
challenges: ["Can be aloof", "May isolate yourself"]
},
8: {
keywords: ["Achievement", "Authority", "Business"],
description: "You have a natural ability for business and achievement. Material mastery is your gift.",
lifePurpose: "You were born with natural authority and business acumen. Your special gift is the ability to achieve material success, handle power responsibly, and create abundance while empowering others.",
strengths: ["Authority", "Business acumen", "Efficiency"],
challenges: ["Can be materialistic", "May be power-hungry"]
},
9: {
keywords: ["Compassion", "Humanitarianism", "Tolerance"],
description: "You have a natural ability to understand and serve humanity. Compassion is your gift.",
lifePurpose: "Born with exceptional compassion and humanitarian spirit, your special gift is understanding human nature deeply and serving with wisdom and tolerance. You came here to help heal the world.",
strengths: ["Compassion", "Tolerance", "Wisdom"],
challenges: ["Can be impractical", "May become bitter"]
},
11: {
keywords: ["Intuition", "Inspiration", "Sensitivity"],
description: "You have natural intuitive and inspirational abilities. Channeling higher wisdom is your gift.",
lifePurpose: "You were born under the master number 11, carrying powerful intuitive and inspirational abilities from birth. Your special gift is channeling higher wisdom and illuminating paths for others through your heightened sensitivity.",
strengths: ["Intuition", "Inspiration", "Idealism"],
challenges: ["Can be impractical", "May be overly sensitive"]
},
22: {
keywords: ["Master Building", "Vision", "Leadership"],
description: "You have master building abilities. Creating lasting legacies is your gift.",
lifePurpose: "Born on a master number 22 day, you came into this life with exceptional abilities to manifest grand visions. Your special gift is building lasting legacies that serve humanity through visionary yet practical leadership.",
strengths: ["Visionary", "Practical mastery", "Leadership"],
challenges: ["Can feel overwhelmed", "May self-sabotage"]
},
33: {
keywords: ["Master Healing", "Teaching", "Service"],
description: "You have master healing and teaching abilities. Uplifting humanity is your gift.",
lifePurpose: "You were born on the rare master number 33 day, carrying profound healing and teaching abilities from birth. Your special gift is uplifting humanity through compassionate service and embodying unconditional love.",
strengths: ["Healing", "Teaching", "Compassion"],
challenges: ["Can be overwhelmed by responsibility", "May neglect self"]
}
};

287
name-change.ts Executable file
View file

@ -0,0 +1,287 @@
#!/usr/bin/env bun
/**
* Name Change Analyzer
*
* Compare how your numerology numbers change with different name variations.
* Perfect for testing nicknames, stage names, married names, or professional brands.
*
* Usage:
* bun name-change.ts --birthdate "5/13/1982" --current "John Smith" --alternative "John Smith"
* bun name-change.ts -b "5/13/1982" -c "Jane Smith" -a "Jane Doe" -a "J Smith"
*/
import { calculateCoreNumbers, calculateAdditionalNumbers } from './core-calculator';
import { expression, soulUrge } from './meanings';
import { personalityMeanings } from './additional-meanings';
// Parse command line arguments
const args = process.argv.slice(2);
let birthdate = '';
let currentName = '';
let alternativeNames: string[] = [];
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--current' || args[i] === '-c') && args[i + 1]) {
currentName = args[i + 1];
i++;
} else if ((args[i] === '--alternative' || args[i] === '-a') && args[i + 1]) {
alternativeNames.push(args[i + 1]);
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Name Change Analyzer
Compare how your numerology changes with different name variations.
Test nicknames, stage names, married names, or professional brands.
USAGE:
bun name-change.ts --birthdate "mm/dd/yyyy" --current "Current Name" --alternative "Alt Name" [OPTIONS]
OPTIONS:
-b, --birthdate DATE Your birthdate (mm/dd/yyyy) [required]
-c, --current NAME Your current/legal name [required]
-a, --alternative NAME Alternative name to compare [can use multiple times]
-h, --help Show this help message
EXAMPLES:
# Compare two name variations
bun name-change.ts -b "5/13/1982" -c "John Smith" -a "John Smith"
# Compare multiple alternatives
bun name-change.ts -b "11/22/1990" -c "Jane Smith" -a "Jane Doe" -a "J Smith"
# Test stage name vs real name
bun name-change.ts -b "3/14/1985" -c "Robert Johnson" -a "Rob J" -a "RJ"
WHAT IT SHOWS:
- Expression Number changes (your talents/abilities)
- Soul Urge changes (your inner desires)
- Personality Number changes (how others see you)
- Maturity Number shifts
- Hidden Passion changes
- Karmic Lessons differences
- Energy shift analysis
- Recommendations for which contexts to use each name
NOTE: Life Path and Birthday don't change (they're from your birthdate).
Only name-based numbers are compared.
`);
process.exit(0);
}
}
if (!birthdate || !currentName || alternativeNames.length === 0) {
console.error('Error: --birthdate, --current, and at least one --alternative are required');
console.error('Try: bun name-change.ts --help');
process.exit(1);
}
interface NameAnalysis {
name: string;
expression: number;
soulUrge: number;
personality: number;
maturity: number;
hiddenPassion: number | null;
karmicLessons: number[];
balance: number;
}
function analyzeName(name: string, birthdate: string): NameAnalysis {
const coreNumbers = calculateCoreNumbers(name, birthdate);
const additionalNumbers = calculateAdditionalNumbers(name, coreNumbers);
return {
name,
expression: coreNumbers.expression,
soulUrge: coreNumbers.soulUrge,
personality: additionalNumbers.personality,
maturity: additionalNumbers.maturity,
hiddenPassion: additionalNumbers.hiddenPassion,
karmicLessons: additionalNumbers.karmicLessons,
balance: additionalNumbers.balance
};
}
function getNumberDifference(num1: number, num2: number): string {
const diff = num2 - num1;
if (diff === 0) return '';
if (diff > 0) return `⬆️ +${diff}`;
return `⬇️ ${diff}`;
}
function getEnergyShift(fromNum: number, toNum: number, type: 'expression' | 'soulUrge'): string[] {
if (fromNum === toNum) return ['No change in energy'];
const shifts: string[] = [];
// Energy level descriptors
const energyLevels: Record<number, string> = {
1: 'Independent/Leadership',
2: 'Cooperative/Diplomatic',
3: 'Creative/Expressive',
4: 'Stable/Practical',
5: 'Dynamic/Freedom-seeking',
6: 'Nurturing/Responsible',
7: 'Analytical/Spiritual',
8: 'Powerful/Material Success',
9: 'Humanitarian/Universal',
11: 'Inspirational/Intuitive',
22: 'Master Builder/Visionary',
33: 'Master Teacher/Healer'
};
shifts.push(`${energyLevels[fromNum]} → ${energyLevels[toNum]}`);
// Specific shift interpretations
if (toNum === 8 && fromNum !== 8) {
shifts.push('• Stronger business/leadership energy');
shifts.push('• Better for professional success and authority');
}
if (toNum === 3 && fromNum !== 3) {
shifts.push('• More creative and expressive energy');
shifts.push('• Better for communication and social presence');
}
if (toNum === 7 && fromNum !== 7) {
shifts.push('• More introspective and analytical');
shifts.push('• Better for deep work and spiritual pursuits');
}
if (toNum === 1 && fromNum !== 1) {
shifts.push('• Stronger independent/pioneering energy');
shifts.push('• Better for solo ventures and leadership');
}
if ([11, 22, 33].includes(toNum) && ![11, 22, 33].includes(fromNum)) {
shifts.push('• ✨ Activates master number energy!');
shifts.push('• Higher spiritual potential and responsibility');
}
return shifts;
}
// Analyze all names
console.log(`\n═══════════════════════════════════════════════════════════════`);
console.log(`📝 NAME CHANGE ANALYSIS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`Birthdate: ${birthdate}`);
console.log(`Life Path: ${calculateCoreNumbers(currentName, birthdate).lifePath} (unchanging)\n`);
const currentAnalysis = analyzeName(currentName, birthdate);
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`CURRENT NAME: ${currentName}`);
console.log(`───────────────────────────────────────────────────────────────`);
console.log(`Expression: ${currentAnalysis.expression} (${expression[currentAnalysis.expression].keywords.slice(0, 3).join(', ')})`);
console.log(`Soul Urge: ${currentAnalysis.soulUrge} (${soulUrge[currentAnalysis.soulUrge].keywords.slice(0, 3).join(', ')})`);
console.log(`Personality: ${currentAnalysis.personality} (${personalityMeanings[currentAnalysis.personality].keywords.slice(0, 3).join(', ')})`);
console.log(`Maturity: ${currentAnalysis.maturity}`);
console.log(`Hidden Passion: ${currentAnalysis.hiddenPassion || 'None'}`);
console.log(`Karmic Lessons: ${currentAnalysis.karmicLessons.length > 0 ? currentAnalysis.karmicLessons.join(', ') : 'None'}`);
console.log(`Balance: ${currentAnalysis.balance}\n`);
// Compare each alternative
alternativeNames.forEach((altName, index) => {
const altAnalysis = analyzeName(altName, birthdate);
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`ALTERNATIVE ${index + 1}: ${altName}`);
console.log(`───────────────────────────────────────────────────────────────`);
console.log(`Expression: ${altAnalysis.expression} (${expression[altAnalysis.expression].keywords.slice(0, 3).join(', ')}) ${getNumberDifference(currentAnalysis.expression, altAnalysis.expression)}`);
console.log(`Soul Urge: ${altAnalysis.soulUrge} (${soulUrge[altAnalysis.soulUrge].keywords.slice(0, 3).join(', ')}) ${getNumberDifference(currentAnalysis.soulUrge, altAnalysis.soulUrge)}`);
console.log(`Personality: ${altAnalysis.personality} (${personalityMeanings[altAnalysis.personality].keywords.slice(0, 3).join(', ')}) ${getNumberDifference(currentAnalysis.personality, altAnalysis.personality)}`);
console.log(`Maturity: ${altAnalysis.maturity} ${getNumberDifference(currentAnalysis.maturity, altAnalysis.maturity)}`);
console.log(`Hidden Passion: ${altAnalysis.hiddenPassion || 'None'}`);
console.log(`Karmic Lessons: ${altAnalysis.karmicLessons.length > 0 ? altAnalysis.karmicLessons.join(', ') : 'None'}`);
console.log(`Balance: ${altAnalysis.balance} ${getNumberDifference(currentAnalysis.balance, altAnalysis.balance)}\n`);
// Key differences
console.log(`📊 KEY DIFFERENCES:`);
if (altAnalysis.expression !== currentAnalysis.expression) {
const shifts = getEnergyShift(currentAnalysis.expression, altAnalysis.expression, 'expression');
console.log(`\n🎯 Expression shift (talents/abilities):`);
shifts.forEach(s => console.log(` ${s}`));
}
if (altAnalysis.soulUrge !== currentAnalysis.soulUrge) {
const shifts = getEnergyShift(currentAnalysis.soulUrge, altAnalysis.soulUrge, 'soulUrge');
console.log(`\n💫 Soul Urge shift (inner desires):`);
shifts.forEach(s => console.log(` ${s}`));
}
if (altAnalysis.personality !== currentAnalysis.personality) {
console.log(`\n👤 Personality shift (how others see you):`);
console.log(` From: ${personalityMeanings[currentAnalysis.personality].description}`);
console.log(` To: ${personalityMeanings[altAnalysis.personality].description}`);
}
// Karmic Lessons comparison
const gainedLessons = altAnalysis.karmicLessons.filter(l => !currentAnalysis.karmicLessons.includes(l));
const resolvedLessons = currentAnalysis.karmicLessons.filter(l => !altAnalysis.karmicLessons.includes(l));
if (resolvedLessons.length > 0) {
console.log(`\n✅ Karmic Lessons resolved: ${resolvedLessons.join(', ')}`);
}
if (gainedLessons.length > 0) {
console.log(`\n⚠️ New Karmic Lessons: ${gainedLessons.join(', ')}`);
}
// Recommendations
console.log(`\n💡 RECOMMENDATIONS:`);
const expressionHigher = altAnalysis.expression > currentAnalysis.expression;
const soulUrgeHigher = altAnalysis.soulUrge > currentAnalysis.soulUrge;
const hasMaturity8 = altAnalysis.maturity === 8;
const hasMasterNumber = [11, 22, 33].includes(altAnalysis.expression) || [11, 22, 33].includes(altAnalysis.soulUrge);
if (altAnalysis.expression === 8 || altAnalysis.expression === 1) {
console.log(` → Use "${altName}" for: Business, leadership, professional contexts`);
}
if (altAnalysis.expression === 3 || altAnalysis.expression === 5) {
console.log(` → Use "${altName}" for: Creative work, social media, public speaking`);
}
if (altAnalysis.expression === 7) {
console.log(` → Use "${altName}" for: Writing, research, spiritual work`);
}
if (altAnalysis.expression === 6) {
console.log(` → Use "${altName}" for: Teaching, counseling, service work`);
}
if (hasMasterNumber) {
console.log(` → "${altName}" activates master number potential - use for your highest calling`);
}
if (resolvedLessons.length > 0 && gainedLessons.length === 0) {
console.log(` → "${altName}" resolves karmic lessons - energetically cleaner`);
}
if (altAnalysis.expression === currentAnalysis.expression &&
altAnalysis.soulUrge === currentAnalysis.soulUrge &&
altAnalysis.personality === currentAnalysis.personality) {
console.log(` → No significant energy difference - use whichever feels right`);
}
console.log('');
});
// Overall summary
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`📋 SUMMARY`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`Compared "${currentName}" with ${alternativeNames.length} alternative(s).\n`);
console.log(`Remember:`);
console.log(`• Legal name for official documents`);
console.log(`• Professional name for career/public presence`);
console.log(`• Personal nicknames for close relationships`);
console.log(`• Different contexts can use different name energies\n`);
console.log(`✨ Your core Life Path never changes - names only affect your expression\n`);

422
name-optimizer.ts Executable file
View file

@ -0,0 +1,422 @@
#!/usr/bin/env bun
/**
* Name Optimizer - "Rainbow Tables for Numerology" 🔮
*
* Intelligently searches through name variations to find those that
* produce master numbers or target specific numerology values.
*
* Like a hash cracker, but instead of cracking passwords, we're
* discovering your most powerful name variations!
*
* Usage:
* bun name-optimizer.ts -b "1/1/1980" -c "John Smith" --find-masters
* bun name-optimizer.ts -b "5/13/1982" -c "Jane Smith" --purpose spiritual
* bun name-optimizer.ts -b "3/14/1985" -c "John Doe" --target-expression 8
*/
import { calculateCoreNumbers, calculateAdditionalNumbers } from './core-calculator';
// Parse command line arguments
const args = process.argv.slice(2);
let birthdate = '';
let currentName = '';
let findMasters = false;
let purpose = '';
let targetExpression: number | null = null;
let targetSoulUrge: number | null = null;
let maxResults = 20;
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--current' || args[i] === '-c') && args[i + 1]) {
currentName = args[i + 1];
i++;
} else if (args[i] === '--find-masters' || args[i] === '-m') {
findMasters = true;
} else if ((args[i] === '--purpose' || args[i] === '-p') && args[i + 1]) {
purpose = args[i + 1].toLowerCase();
i++;
} else if (args[i] === '--target-expression' && args[i + 1]) {
targetExpression = parseInt(args[i + 1]);
i++;
} else if (args[i] === '--target-soul-urge' && args[i + 1]) {
targetSoulUrge = parseInt(args[i + 1]);
i++;
} else if ((args[i] === '--max' || args[i] === '-n') && args[i + 1]) {
maxResults = parseInt(args[i + 1]);
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Name Optimizer - Rainbow Tables for Numerology 🔮
Intelligently search through name variations to find ones that unlock
master numbers or target specific numerology values.
USAGE:
bun name-optimizer.ts --birthdate "mm/dd/yyyy" --current "Your Name" [OPTIONS]
OPTIONS:
-b, --birthdate DATE Your birthdate (mm/dd/yyyy) [required]
-c, --current NAME Your current/base name [required]
-m, --find-masters Find ANY master numbers (11, 22, 33)
-p, --purpose TYPE Optimize for purpose: spiritual, business, creative
--target-expression NUM Find names with specific Expression number
--target-soul-urge NUM Find names with specific Soul Urge number
-n, --max NUMBER Max results to show [default: 20]
-h, --help Show this help message
PURPOSES:
spiritual → Targets master 11, 7, 9 (intuition, wisdom, compassion)
business → Targets 8, 1, 22 (power, leadership, master building)
creative → Targets 3, 5, 11 (expression, freedom, inspiration)
teaching → Targets 6, 33 (service, master teaching)
analytical → Targets 7, 4 (wisdom, structure)
EXAMPLES:
# Find any master numbers
bun name-optimizer.ts -b "1/1/1980" -c "John Smith" --find-masters
# Optimize for spiritual writing pseudonym
bun name-optimizer.ts -b "5/13/1982" -c "Jane Smith" --purpose spiritual
# Find names with Expression 8 (business power)
bun name-optimizer.ts -b "3/14/1985" -c "John Doe" --target-expression 8
# Find names with Soul Urge 11 (intuitive desires)
bun name-optimizer.ts -b "7/7/1990" -c "Sarah Jones" --target-soul-urge 11
WHAT IT DOES:
1. Generates intelligent variations of your name
2. Tests each variation's numerology
3. Scores and ranks results
4. Shows you the most powerful variations
NOTE: This is like a "hash cracker" but for unlocking your name's
hidden numerological potential! 🔮
`);
process.exit(0);
}
}
if (!birthdate || !currentName) {
console.error('Error: --birthdate and --current are required');
console.error('Try: bun name-optimizer.ts --help');
process.exit(1);
}
if (!findMasters && !purpose && targetExpression === null && targetSoulUrge === null) {
console.error('Error: Specify search criteria: --find-masters, --purpose, --target-expression, or --target-soul-urge');
console.error('Try: bun name-optimizer.ts --help');
process.exit(1);
}
// Common nickname mappings
const nicknameMap: Record<string, string[]> = {
'robert': ['rob', 'bob', 'bobby', 'robbie', 'bert', 'robby'],
'william': ['will', 'bill', 'billy', 'liam', 'willy'],
'richard': ['rick', 'dick', 'rich', 'ricky', 'richie'],
'michael': ['mike', 'mick', 'mikey', 'mickey'],
'james': ['jim', 'jimmy', 'jamie', 'jay'],
'john': ['jack', 'johnny', 'jon'],
'joseph': ['joe', 'joey', 'jo'],
'david': ['dave', 'davey', 'davy'],
'christopher': ['chris', 'topher', 'kit'],
'daniel': ['dan', 'danny'],
'matthew': ['matt', 'matty'],
'anthony': ['tony', 'ant'],
'thomas': ['tom', 'tommy', 'thom'],
'charles': ['charlie', 'chuck', 'chas'],
'jennifer': ['jen', 'jenny', 'jenn'],
'elizabeth': ['liz', 'beth', 'betty', 'libby', 'eliza'],
'jessica': ['jess', 'jessie'],
'sarah': ['sara'],
'rebecca': ['becky', 'becca', 'bex'],
'katherine': ['kate', 'katie', 'kathy', 'kat', 'kath'],
'margaret': ['maggie', 'meg', 'peggy', 'marge'],
'patricia': ['pat', 'patty', 'trish'],
'christine': ['chris', 'chrissy', 'christie'],
'amanda': ['mandy', 'manda'],
'stephanie': ['steph', 'steffi', 'stephie']
};
interface NameVariation {
name: string;
expression: number;
soulUrge: number;
personality: number;
maturity: number;
hiddenPassion: number | null;
masterCount: number;
score: number;
}
function generateVariations(fullName: string): string[] {
const variations = new Set<string>();
variations.add(fullName); // Original
const parts = fullName.trim().split(/\s+/);
if (parts.length < 2) {
console.error('Error: Please provide at least first and last name');
process.exit(1);
}
const firstName = parts[0].toLowerCase();
const lastName = parts[parts.length - 1];
const middleNames = parts.slice(1, -1);
// 1. Nickname variations
const nicknames = nicknameMap[firstName] || [];
nicknames.forEach(nick => {
variations.add(`${nick.charAt(0).toUpperCase() + nick.slice(1)} ${lastName}`);
// With middle initials
middleNames.forEach(middle => {
variations.add(`${nick.charAt(0).toUpperCase() + nick.slice(1)} ${middle.charAt(0)}. ${lastName}`);
});
});
// 2. Initial variations
variations.add(`${firstName.charAt(0).toUpperCase()}. ${lastName}`);
variations.add(`${firstName.charAt(0).toUpperCase()} ${lastName}`);
// 3. Full name with middle initial
middleNames.forEach(middle => {
variations.add(`${parts[0]} ${middle.charAt(0)}. ${lastName}`);
variations.add(`${parts[0]} ${middle.charAt(0)} ${lastName}`);
});
// 4. Double initials
if (middleNames.length > 0) {
const middleInitial = middleNames[0].charAt(0).toUpperCase();
variations.add(`${firstName.charAt(0).toUpperCase()}. ${middleInitial}. ${lastName}`);
variations.add(`${firstName.charAt(0).toUpperCase()}${middleInitial} ${lastName}`);
}
// 5. Common middle initials to try
const commonMiddle = ['J', 'A', 'M', 'L', 'R', 'K', 'E', 'T', 'S', 'C'];
commonMiddle.forEach(initial => {
variations.add(`${parts[0]} ${initial}. ${lastName}`);
variations.add(`${parts[0]} ${initial} ${lastName}`);
// With nicknames
nicknames.forEach(nick => {
variations.add(`${nick.charAt(0).toUpperCase() + nick.slice(1)} ${initial}. ${lastName}`);
});
});
// 6. Professional titles
variations.add(`Dr. ${fullName}`);
variations.add(`Dr ${parts[0]} ${lastName}`);
// 7. Abbreviated first name
const shortFirst = parts[0].slice(0, Math.min(4, parts[0].length));
if (shortFirst !== parts[0]) {
variations.add(`${shortFirst} ${lastName}`);
}
return Array.from(variations);
}
function analyzeVariation(name: string, birthdate: string): NameVariation {
const coreNumbers = calculateCoreNumbers(name, birthdate);
const additionalNumbers = calculateAdditionalNumbers(name, coreNumbers);
// Count master numbers
let masterCount = 0;
if ([11, 22, 33].includes(coreNumbers.expression)) masterCount++;
if ([11, 22, 33].includes(coreNumbers.soulUrge)) masterCount++;
if ([11, 22, 33].includes(additionalNumbers.personality)) masterCount++;
if ([11, 22, 33].includes(additionalNumbers.maturity)) masterCount++;
return {
name,
expression: coreNumbers.expression,
soulUrge: coreNumbers.soulUrge,
personality: additionalNumbers.personality,
maturity: additionalNumbers.maturity,
hiddenPassion: additionalNumbers.hiddenPassion,
masterCount,
score: 0 // Will calculate later
};
}
function calculateScore(variation: NameVariation, criteria: any): number {
let score = 50; // Base score
// Master number bonus
score += variation.masterCount * 20;
// Target matching
if (criteria.targetExpression !== null) {
if (variation.expression === criteria.targetExpression) score += 30;
}
if (criteria.targetSoulUrge !== null) {
if (variation.soulUrge === criteria.targetSoulUrge) score += 30;
}
// Purpose alignment
if (criteria.purpose === 'spiritual') {
if ([11, 7, 9].includes(variation.expression)) score += 15;
if ([11, 7, 9].includes(variation.soulUrge)) score += 10;
} else if (criteria.purpose === 'business') {
if ([8, 1, 22].includes(variation.expression)) score += 15;
if ([8, 1].includes(variation.soulUrge)) score += 10;
} else if (criteria.purpose === 'creative') {
if ([3, 5, 11].includes(variation.expression)) score += 15;
if ([3, 5].includes(variation.soulUrge)) score += 10;
} else if (criteria.purpose === 'teaching') {
if ([6, 33].includes(variation.expression)) score += 15;
if ([6, 33].includes(variation.soulUrge)) score += 10;
} else if (criteria.purpose === 'analytical') {
if ([7, 4].includes(variation.expression)) score += 15;
if ([7, 4].includes(variation.soulUrge)) score += 10;
}
// Hidden passion bonus
if (variation.hiddenPassion && [11, 22, 33].includes(variation.hiddenPassion)) {
score += 5;
}
return Math.min(100, score);
}
// Main execution
console.log(`\n🔮 NAME OPTIMIZER - Rainbow Tables for Numerology`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`Base Name: ${currentName}`);
console.log(`Birthdate: ${birthdate}`);
if (findMasters) {
console.log(`Goal: Find ANY master numbers (11, 22, 33)\n`);
} else if (purpose) {
console.log(`Goal: Optimize for ${purpose} purpose\n`);
} else if (targetExpression) {
console.log(`Goal: Find Expression ${targetExpression}\n`);
} else if (targetSoulUrge) {
console.log(`Goal: Find Soul Urge ${targetSoulUrge}\n`);
}
// Show baseline/input name values
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`📍 BASELINE (Input Name)`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const baselineAnalysis = analyzeVariation(currentName, birthdate);
console.log(`Name: ${currentName}`);
console.log(`Expression: ${baselineAnalysis.expression}${[11, 22, 33].includes(baselineAnalysis.expression) ? ' ⭐ MASTER' : ''}`);
console.log(`Soul Urge: ${baselineAnalysis.soulUrge}${[11, 22, 33].includes(baselineAnalysis.soulUrge) ? ' ⭐ MASTER' : ''}`);
console.log(`Personality: ${baselineAnalysis.personality}${[11, 22, 33].includes(baselineAnalysis.personality) ? ' ⭐ MASTER' : ''}`);
console.log(`Maturity: ${baselineAnalysis.maturity}${[11, 22, 33].includes(baselineAnalysis.maturity) ? ' ⭐ MASTER' : ''}`);
if (baselineAnalysis.hiddenPassion) {
console.log(`Hidden Passion: ${baselineAnalysis.hiddenPassion}${[11, 22, 33].includes(baselineAnalysis.hiddenPassion) ? ' ⭐ MASTER' : ''}`);
}
console.log(`\n(Searching for variations with different values...)\n`);
console.log(`Generating variations...`);
const variations = generateVariations(currentName);
console.log(`Testing ${variations.length} name variations...\n`);
// Analyze all variations
const results: NameVariation[] = [];
const criteria = { findMasters, purpose, targetExpression, targetSoulUrge };
// Track unique combinations to avoid duplicates
const seenCombinations = new Set<string>();
for (const variant of variations) {
const analysis = analyzeVariation(variant, birthdate);
analysis.score = calculateScore(analysis, criteria);
// Create a unique key based on numerology values
const uniqueKey = `${analysis.expression}-${analysis.soulUrge}-${analysis.personality}-${analysis.maturity}-${analysis.hiddenPassion}`;
// Skip if we've seen this exact combination
if (seenCombinations.has(uniqueKey)) {
continue;
}
seenCombinations.add(uniqueKey);
// Filter based on criteria
if (findMasters && analysis.masterCount > 0) {
results.push(analysis);
} else if (purpose && analysis.score >= 60) {
results.push(analysis);
} else if (targetExpression !== null && analysis.expression === targetExpression) {
results.push(analysis);
} else if (targetSoulUrge !== null && analysis.soulUrge === targetSoulUrge) {
results.push(analysis);
}
}
// Sort by score
results.sort((a, b) => b.score - a.score);
// Display results
if (results.length === 0) {
console.log(`😞 No matches found. Try:`);
console.log(` • Different search criteria`);
console.log(` • Adding middle initials manually`);
console.log(` • Using --find-masters for broader search\n`);
process.exit(0);
}
console.log(`✨ FOUND ${results.length} MATCHING NAME${results.length > 1 ? 'S' : ''}:\n`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const displayResults = results.slice(0, maxResults);
displayResults.forEach((result, index) => {
const masterSymbols = '⭐'.repeat(result.masterCount);
console.log(`${index + 1}. ${result.name} ${masterSymbols}`);
console.log(` Score: ${result.score}/100`);
if ([11, 22, 33].includes(result.expression)) {
console.log(` Expression: ${result.expression} ⭐ MASTER`);
} else {
console.log(` Expression: ${result.expression}`);
}
if ([11, 22, 33].includes(result.soulUrge)) {
console.log(` Soul Urge: ${result.soulUrge} ⭐ MASTER`);
} else {
console.log(` Soul Urge: ${result.soulUrge}`);
}
if ([11, 22, 33].includes(result.personality)) {
console.log(` Personality: ${result.personality} ⭐ MASTER`);
}
if ([11, 22, 33].includes(result.maturity)) {
console.log(` Maturity: ${result.maturity} ⭐ MASTER`);
}
if (result.hiddenPassion && [11, 22, 33].includes(result.hiddenPassion)) {
console.log(` Hidden Passion: ${result.hiddenPassion} ⭐ MASTER`);
}
console.log('');
});
if (results.length > maxResults) {
console.log(`... and ${results.length - maxResults} more results (use --max ${results.length} to see all)\n`);
}
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`💡 USAGE TIPS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
if (displayResults.length > 0 && displayResults[0].masterCount > 0) {
console.log(`✨ Top result "${displayResults[0].name}" activates ${displayResults[0].masterCount} master number(s)!`);
console.log(` Use for: High-impact work, spiritual pursuits, or leadership\n`);
}
console.log(`📝 Next steps:`);
console.log(` 1. Test your top results with: bun name-change.ts`);
console.log(` 2. Use different variations for different contexts`);
console.log(` 3. Consider which variation "feels" right to you\n`);
console.log(`🔮 Remember: The most powerful name is one that resonates with your soul!\n`);

620
numerology.ts Executable file
View file

@ -0,0 +1,620 @@
#!/usr/bin/env bun
/**
* Numerology Calculator - TypeScript Edition
*
* Calculates core numerology numbers:
* - Life Path: Your life's purpose and journey
* - Expression: Your natural talents and abilities
* - Soul Urge: Your inner desires and motivations
* - Birthday: Special gifts from your birth day
*
* Usage:
* bun numerology.ts --name "John Doe" --birthdate "5/13/1982"
* bun numerology.ts --name "Jane Smith" --birthdate "11/22/1990" --format markdown
* bun numerology.ts --name "Bob Jones" --birthdate "3/14/1975" --format json
*/
import { lifePath, expression, soulUrge, birthday, type NumberMeaning } from './meanings';
import { calculateCycles, type CycleCalculations } from './cycles';
import { personalYear, personalMonth, personalDay, universalYear } from './cycle-meanings';
import { calculateCoreNumbers, calculateAdditionalNumbers, type AdditionalNumbers } from './core-calculator';
import {
maturityMeanings,
personalityMeanings,
hiddenPassionMeanings,
karmicLessonMeanings,
balanceMeanings
} from './additional-meanings';
import { loadProfile } from './profile-manager';
const MASTER_NUMBERS = [11, 22, 33];
interface NumerologyResult {
name: string;
birthdate: string;
lifePath: number;
expression: number;
soulUrge: number;
birthday: number;
calculations: {
month: number;
day: number;
year: number;
nameBreakdown: Record<string, number>;
vowelBreakdown: Record<string, number>;
};
}
/**
* Reduces a number to single digit or returns master number
*/
function reduce(n: number, context: string = "", silent: boolean = false): number {
if (MASTER_NUMBERS.includes(n)) {
if (context && !silent) {
console.error(`✨ Master number found in ${context}: ${n}`);
}
return n;
}
const total = String(n).split('').reduce((sum, digit) => sum + parseInt(digit), 0);
return total < 10 ? total : reduce(total, context);
}
/**
* Converts name to numerology value
*/
function nameToNumber(name: string): number {
const cleaned = name.toLowerCase().replace(/[^a-z]/g, '');
let total = 0;
for (const char of cleaned) {
const value = char.charCodeAt(0) - 96; // a=1, b=2, etc.
total += value < 10 ? value : reduce(value);
}
return total;
}
/**
* Checks for master number before further reduction
*/
function masterCheck(total: number, context: string = "", silent: boolean = false): number {
if (MASTER_NUMBERS.includes(total)) {
if (context && !silent) {
console.error(`✨ Master number found in ${context}: ${total}`);
}
return total;
}
const reduced = String(total).split('').reduce((sum, digit) => sum + parseInt(digit), 0);
return reduced < 10 ? reduced : reduce(reduced);
}
/**
* Extracts vowels from name
*/
function extractVowels(name: string): string {
return name.toLowerCase().replace(/[^aeiou]/g, '');
}
/**
* Parse birthdate string (mm/dd/yyyy)
*/
function parseBirthdate(birthdate: string): { month: number; day: number; year: number } {
const parts = birthdate.split('/');
if (parts.length !== 3) {
throw new Error('Invalid birthdate format. Use mm/dd/yyyy (e.g., 5/13/1982)');
}
return {
month: parseInt(parts[0]),
day: parseInt(parts[1]),
year: parseInt(parts[2])
};
}
/**
* Calculate all numerology numbers
*/
function calculate(name: string, birthdate: string, silent: boolean = false): NumerologyResult {
// Parse name
const nameParts = name.trim().split(/\s+/);
if (nameParts.length < 2) {
throw new Error('Please provide at least first and last name');
}
// Parse birthdate
const { month, day, year } = parseBirthdate(birthdate);
// Life Path (from birthdate)
const monthReduced = reduce(month, "Month", silent);
const dayReduced = reduce(day, "Day", silent);
const yearReduced = reduce(year, "Year", silent);
const birthDateSum = monthReduced + dayReduced + yearReduced;
const lifePathNum = reduce(birthDateSum, "Life Path", silent);
// Birthday (from day of birth)
const birthdayNum = reduce(day, "Birthday", silent);
// Expression (from full name)
const nameBreakdown: Record<string, number> = {};
let expressionTotal = 0;
// Use only first and last name if more than 4 parts
const namesToUse = nameParts.length > 4
? [nameParts[0], nameParts[nameParts.length - 1]]
: nameParts;
for (const part of namesToUse) {
const value = nameToNumber(part);
const checked = masterCheck(value, `Name: ${part}`, silent);
nameBreakdown[part] = checked;
expressionTotal += checked;
}
const expressionNum = masterCheck(reduce(expressionTotal, "", silent), "Expression", silent);
// Soul Urge (from vowels in name)
const vowelBreakdown: Record<string, number> = {};
let soulUrgeTotal = 0;
for (const part of nameParts) {
const vowels = extractVowels(part);
if (vowels) {
const value = nameToNumber(vowels);
const checked = masterCheck(value, `Vowels in ${part}`, silent);
vowelBreakdown[part] = checked;
soulUrgeTotal += checked;
}
}
const soulUrgeNum = masterCheck(reduce(soulUrgeTotal, "", silent), "Soul Urge", silent);
return {
name,
birthdate,
lifePath: lifePathNum,
expression: expressionNum,
soulUrge: soulUrgeNum,
birthday: birthdayNum,
calculations: {
month: monthReduced,
day: dayReduced,
year: yearReduced,
nameBreakdown,
vowelBreakdown
}
};
}
/**
* Format output as terminal text (with colors)
*/
function formatTerminal(result: NumerologyResult, detailed: boolean = false): string {
const CYAN = '\x1b[36m';
const GREEN = '\x1b[32m';
const YELLOW = '\x1b[33m';
const BLUE = '\x1b[34m';
const RESET = '\x1b[0m';
const BOLD = '\x1b[1m';
let output = `\n${CYAN}${BOLD}╔═══════════════════════════════════════╗${RESET}\n`;
output += `${CYAN}${BOLD}║ NUMEROLOGY CHART ║${RESET}\n`;
output += `${CYAN}${BOLD}╚═══════════════════════════════════════╝${RESET}\n\n`;
output += `${BOLD}Name:${RESET} ${result.name}\n`;
output += `${BOLD}Birthdate:${RESET} ${result.birthdate}\n\n`;
output += `${GREEN}${BOLD}Core Numbers:${RESET}\n`;
output += `${GREEN} 1. Life Path:${RESET} ${result.lifePath}\n`;
output += `${GREEN} 2. Expression:${RESET} ${result.expression}\n`;
output += `${GREEN} 3. Soul Urge:${RESET} ${result.soulUrge}\n`;
output += `${GREEN} 4. Birthday:${RESET} ${result.birthday}\n`;
if (detailed) {
output += `\n${BLUE}${BOLD}═══════════════════════════════════════${RESET}\n`;
output += `${BLUE}${BOLD}DETAILED MEANINGS${RESET}\n`;
output += `${BLUE}${BOLD}═══════════════════════════════════════${RESET}\n\n`;
// Life Path
const lpMeaning = lifePath[result.lifePath];
output += `${YELLOW}${BOLD}Life Path ${result.lifePath}:${RESET} ${lpMeaning.keywords.join(', ')}\n`;
output += `${lpMeaning.description}\n\n`;
output += `${BOLD}Strengths:${RESET} ${lpMeaning.strengths.join(', ')}\n`;
output += `${BOLD}Challenges:${RESET} ${lpMeaning.challenges.join(', ')}\n`;
if (lpMeaning.lifePurpose) {
output += `${BOLD}Life Purpose:${RESET} ${lpMeaning.lifePurpose}\n`;
}
output += '\n';
// Expression
const exMeaning = expression[result.expression];
output += `${YELLOW}${BOLD}Expression ${result.expression}:${RESET} ${exMeaning.keywords.join(', ')}\n`;
output += `${exMeaning.description}\n\n`;
// Soul Urge
const suMeaning = soulUrge[result.soulUrge];
output += `${YELLOW}${BOLD}Soul Urge ${result.soulUrge}:${RESET} ${suMeaning.keywords.join(', ')}\n`;
output += `${suMeaning.description}\n\n`;
// Birthday
const bdMeaning = birthday[result.birthday];
output += `${YELLOW}${BOLD}Birthday ${result.birthday}:${RESET} ${bdMeaning.keywords.join(', ')}\n`;
output += `${bdMeaning.description}\n`;
}
return output;
}
/**
* Format output as markdown
*/
function formatMarkdown(result: NumerologyResult): string {
let output = `# Numerology Chart\n\n`;
output += `**Name:** ${result.name} \n`;
output += `**Birthdate:** ${result.birthdate}\n\n`;
output += `## Core Numbers\n\n`;
output += `1. **Life Path:** ${result.lifePath}\n`;
output += `2. **Expression:** ${result.expression}\n`;
output += `3. **Soul Urge:** ${result.soulUrge}\n`;
output += `4. **Birthday:** ${result.birthday}\n\n`;
output += `---\n\n`;
output += `## Detailed Meanings\n\n`;
// Life Path
const lpMeaning = lifePath[result.lifePath];
output += `### Life Path ${result.lifePath}: ${lpMeaning.keywords.join(', ')}\n\n`;
output += `${lpMeaning.description}\n\n`;
output += `**Strengths:** ${lpMeaning.strengths.join(', ')}\n\n`;
output += `**Challenges:** ${lpMeaning.challenges.join(', ')}\n\n`;
if (lpMeaning.lifePurpose) {
output += `**Life Purpose:** ${lpMeaning.lifePurpose}\n\n`;
}
if (lpMeaning.careerPaths) {
output += `**Career Paths:** ${lpMeaning.careerPaths.join(', ')}\n\n`;
}
if (lpMeaning.relationships) {
output += `**Relationships:** ${lpMeaning.relationships}\n\n`;
}
if (lpMeaning.spiritualLesson) {
output += `**Spiritual Lesson:** ${lpMeaning.spiritualLesson}\n\n`;
}
// Expression
const exMeaning = expression[result.expression];
output += `### Expression ${result.expression}: ${exMeaning.keywords.join(', ')}\n\n`;
output += `${exMeaning.description}\n\n`;
output += `**Strengths:** ${exMeaning.strengths.join(', ')}\n\n`;
output += `**Challenges:** ${exMeaning.challenges.join(', ')}\n\n`;
// Soul Urge
const suMeaning = soulUrge[result.soulUrge];
output += `### Soul Urge ${result.soulUrge}: ${suMeaning.keywords.join(', ')}\n\n`;
output += `${suMeaning.description}\n\n`;
output += `**Strengths:** ${suMeaning.strengths.join(', ')}\n\n`;
output += `**Challenges:** ${suMeaning.challenges.join(', ')}\n\n`;
// Birthday
const bdMeaning = birthday[result.birthday];
output += `### Birthday ${result.birthday}: ${bdMeaning.keywords.join(', ')}\n\n`;
output += `${bdMeaning.description}\n\n`;
output += `**Strengths:** ${bdMeaning.strengths.join(', ')}\n\n`;
output += `**Challenges:** ${bdMeaning.challenges.join(', ')}\n\n`;
return output;
}
/**
* Format output as JSON
*/
function formatJson(result: NumerologyResult): string {
const output = {
...result,
meanings: {
lifePath: lifePath[result.lifePath],
expression: expression[result.expression],
soulUrge: soulUrge[result.soulUrge],
birthday: birthday[result.birthday]
}
};
return JSON.stringify(output, null, 2);
}
/**
* Format cycles output for terminal
*/
function formatCyclesTerminal(cycles: CycleCalculations): string {
const MAGENTA = '\x1b[35m';
const CYAN = '\x1b[36m';
const YELLOW = '\x1b[33m';
const RESET = '\x1b[0m';
const BOLD = '\x1b[1m';
let output = `\n${MAGENTA}${BOLD}═══════════════════════════════════════${RESET}\n`;
output += `${MAGENTA}${BOLD}TIMING CYCLES${RESET}\n`;
output += `${MAGENTA}${BOLD}═══════════════════════════════════════${RESET}\n\n`;
output += `${BOLD}Date:${RESET} ${cycles.targetDate}\n\n`;
// Universal Cycles
output += `${CYAN}${BOLD}Universal Energy (Global):${RESET}\n`;
output += ` Year: ${cycles.universal.year} ${universalYear[cycles.universal.year]}\n`;
output += ` Month: ${cycles.universal.month}\n`;
output += ` Day: ${cycles.universal.day}\n\n`;
// Personal Cycles
output += `${CYAN}${BOLD}Personal Energy (Your Rhythm):${RESET}\n`;
output += ` Year: ${cycles.personal.year}\n`;
output += ` Month: ${cycles.personal.month}\n`;
output += ` Day: ${cycles.personal.day} ${personalDay[cycles.personal.day]}\n\n`;
// Personal Year meaning
const pyMeaning = personalYear[cycles.personal.year];
output += `${YELLOW}${BOLD}Personal Year ${cycles.personal.year}: ${pyMeaning.keywords.join(', ')}${RESET}\n`;
output += `${pyMeaning.theme}\n\n`;
output += `${BOLD}Best For:${RESET} ${pyMeaning.bestFor.slice(0, 3).join(', ')}\n`;
output += `${BOLD}Avoid:${RESET} ${pyMeaning.avoidDoing.slice(0, 2).join(', ')}\n\n`;
// Personal Month meaning
const pmMeaning = personalMonth[cycles.personal.month];
output += `${YELLOW}${BOLD}Personal Month ${cycles.personal.month}: ${pmMeaning.keywords.join(', ')}${RESET}\n`;
output += `${pmMeaning.theme}\n`;
return output;
}
/**
* Format cycles output for markdown
*/
function formatCyclesMarkdown(cycles: CycleCalculations): string {
let output = `\n---\n\n# Timing Cycles\n\n`;
output += `**Date:** ${cycles.targetDate}\n\n`;
output += `## Universal Energy (Global)\n\n`;
output += `- **Year:** ${cycles.universal.year}\n`;
output += ` - ${universalYear[cycles.universal.year]}\n`;
output += `- **Month:** ${cycles.universal.month}\n`;
output += `- **Day:** ${cycles.universal.day}\n\n`;
output += `## Personal Energy (Your Rhythm)\n\n`;
output += `- **Year:** ${cycles.personal.year}\n`;
output += `- **Month:** ${cycles.personal.month}\n`;
output += `- **Day:** ${cycles.personal.day}\n`;
output += ` - ${personalDay[cycles.personal.day]}\n\n`;
// Personal Year meaning
const pyMeaning = personalYear[cycles.personal.year];
output += `## Personal Year ${cycles.personal.year}\n\n`;
output += `> *${pyMeaning.keywords.join(' • ')}*\n\n`;
output += `**Theme:** ${pyMeaning.theme}\n\n`;
output += `### Opportunities\n`;
pyMeaning.opportunities.forEach(o => output += `- ${o}\n`);
output += `\n### Challenges\n`;
pyMeaning.challenges.forEach(c => output += `- ${c}\n`);
output += `\n**Advice:** ${pyMeaning.advice}\n\n`;
output += `**Best For:** ${pyMeaning.bestFor.join(', ')}\n\n`;
output += `**Avoid Doing:** ${pyMeaning.avoidDoing.join(', ')}\n\n`;
// Personal Month meaning
const pmMeaning = personalMonth[cycles.personal.month];
output += `## Personal Month ${cycles.personal.month}\n\n`;
output += `> *${pmMeaning.keywords.join(' • ')}*\n\n`;
output += `**Theme:** ${pmMeaning.theme}\n\n`;
output += `**Advice:** ${pmMeaning.advice}\n\n`;
return output;
}
/**
* Format advanced numbers for terminal output
*/
function formatAdvancedTerminal(additional: AdditionalNumbers, detailed: boolean = false): string {
const PURPLE = '\x1b[35m';
const GREEN = '\x1b[32m';
const YELLOW = '\x1b[33m';
const RED = '\x1b[31m';
const RESET = '\x1b[0m';
const BOLD = '\x1b[1m';
let output = `\n${PURPLE}${BOLD}═══════════════════════════════════════${RESET}\n`;
output += `${PURPLE}${BOLD}ADVANCED NUMBERS${RESET}\n`;
output += `${PURPLE}${BOLD}═══════════════════════════════════════${RESET}\n\n`;
// Maturity
const maturityMeaning = maturityMeanings[additional.maturity];
output += `${GREEN} 5. Maturity:${RESET} ${additional.maturity} (${maturityMeaning.keywords.slice(0, 3).join(', ')})\n`;
if (detailed) {
output += ` ${maturityMeaning.description}\n`;
}
// Personality
const personalityMeaning = personalityMeanings[additional.personality];
output += `${GREEN} 6. Personality:${RESET} ${additional.personality} (${personalityMeaning.keywords.slice(0, 3).join(', ')})\n`;
if (detailed) {
output += ` ${personalityMeaning.description}\n`;
}
// Hidden Passion
if (additional.hiddenPassion) {
const hiddenPassionMeaning = hiddenPassionMeanings[additional.hiddenPassion];
output += `${GREEN} 7. Hidden Passion:${RESET} ${additional.hiddenPassion} (${hiddenPassionMeaning.keywords.slice(0, 2).join(', ')})\n`;
if (detailed) {
output += ` ${hiddenPassionMeaning.description}\n`;
}
}
// Balance
const balanceMeaning = balanceMeanings[additional.balance];
output += `${GREEN} 8. Balance:${RESET} ${additional.balance} (${balanceMeaning.keywords.slice(0, 2).join(', ')})\n`;
if (detailed) {
output += ` ${balanceMeaning.description}\n`;
}
// Karmic Lessons
if (additional.karmicLessons.length > 0) {
output += `${RED} 9. Karmic Lessons:${RESET} ${additional.karmicLessons.join(', ')}\n`;
if (detailed) {
output += ` Areas to develop: ${additional.karmicLessons.map(n => karmicLessonMeanings[n].keywords[0]).join(', ')}\n`;
}
} else {
output += `${GREEN} 9. Karmic Lessons:${RESET} None (All numbers 1-9 present)\n`;
}
output += '\n';
return output;
}
/**
* Main CLI handler
*/
function main() {
const args = process.argv.slice(2);
// Parse arguments
let name = '';
let birthdate = '';
let profileId = '';
let format: 'terminal' | 'markdown' | 'json' = 'terminal';
let detailed = false;
let showCycles = false;
let cycleDate = '';
let showAdvanced = false;
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if (args[i] === '--name' && args[i + 1]) {
name = args[i + 1];
i++;
} else if (args[i] === '--birthdate' && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if (args[i] === '--format' && args[i + 1]) {
const fmt = args[i + 1].toLowerCase();
if (fmt === 'terminal' || fmt === 'markdown' || fmt === 'json') {
format = fmt;
}
i++;
} else if (args[i] === '--detailed' || args[i] === '-d') {
detailed = true;
} else if (args[i] === '--cycles' || args[i] === '-c') {
showCycles = true;
} else if (args[i] === '--date' && args[i + 1]) {
cycleDate = args[i + 1];
i++;
} else if (args[i] === '--advanced' || args[i] === '-a') {
showAdvanced = true;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Numerology Calculator
Usage:
bun numerology.ts --profile <id> [options]
bun numerology.ts --name "Full Name" --birthdate "mm/dd/yyyy" [options]
Options:
-p, --profile ID Use saved profile
--name NAME Full name (required if no profile)
--birthdate DATE Birthdate in mm/dd/yyyy format (required if no profile)
--format FORMAT Output format: terminal, markdown, json (default: terminal)
--detailed, -d Show detailed meanings (terminal format only)
--advanced, -a Show advanced numbers (Maturity, Personality, Hidden Passion, etc.)
--cycles, -c Show timing cycles (Personal & Universal Year/Month/Day)
--date DATE Date for cycle calculation (default: today, format: mm/dd/yyyy)
--help, -h Show this help message
Examples:
# With profile
bun numerology.ts --profile john
bun numerology.ts --profile john --detailed --advanced --cycles
# With name/birthdate
bun numerology.ts --name "John Doe" --birthdate "5/13/1982"
bun numerology.ts --name "Jane Smith" --birthdate "11/22/1990" --format markdown
bun numerology.ts --name "Bob Jones" --birthdate "3/14/1975" --format json
bun numerology.ts --name "Alice Wonder" --birthdate "7/7/1977" --detailed
`);
process.exit(0);
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
name = profile.name;
birthdate = profile.birthdate;
}
// Validate inputs
if (!name || !birthdate) {
console.error('Error: Either --profile or both --name and --birthdate are required');
console.error('Use --help for usage information');
process.exit(1);
}
try {
// Calculate (silent mode for JSON to avoid console pollution)
const silent = format === 'json';
const result = calculate(name, birthdate, silent);
// Calculate advanced numbers if requested
let advancedNumbers: AdditionalNumbers | undefined;
if (showAdvanced) {
const coreNumbers = calculateCoreNumbers(name, birthdate);
advancedNumbers = calculateAdditionalNumbers(name, coreNumbers);
}
// Calculate cycles if requested
let cycles: CycleCalculations | undefined;
if (showCycles) {
cycles = calculateCycles(birthdate, cycleDate || undefined);
}
// Format and output
let output: string;
switch (format) {
case 'markdown':
output = formatMarkdown(result);
if (cycles) {
output += formatCyclesMarkdown(cycles);
}
break;
case 'json':
output = formatJson(result);
break;
default:
output = formatTerminal(result, detailed);
if (advancedNumbers) {
output += formatAdvancedTerminal(advancedNumbers, detailed);
}
if (cycles) {
output += formatCyclesTerminal(cycles);
}
}
console.log(output);
} catch (error) {
console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
process.exit(1);
}
}
// Run if called directly
if (import.meta.main) {
main();
}
export { calculate, formatTerminal, formatMarkdown, formatJson, type NumerologyResult };

487
optimal-days.ts Executable file
View file

@ -0,0 +1,487 @@
#!/usr/bin/env bun
/**
* Optimal Days Finder
*
* Find the best days in a month (or year) for specific activities based on
* Personal Day cycles. Perfect for scheduling launches, meetings, creative work, etc.
*
* Usage:
* bun optimal-days.ts --birthdate "5/13/1982" --month 11 --year 2025 --day 1
* bun optimal-days.ts --birthdate "5/13/1982" --month 11 --year 2025 --day 8 --activity "business"
* bun optimal-days.ts --birthdate "5/13/1982" --year 2025 --day 3 (find all Day 3s in the year)
*/
import { calculateCycles } from './cycles';
import { loadProfile } from './profile-manager';
// Parse command line arguments
const args = process.argv.slice(2);
let birthdate = '';
let profileId = '';
let month: number | null = null;
let year: number = new Date().getFullYear();
let targetDay: number | null = null;
let activity = '';
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--month' || args[i] === '-m') && args[i + 1]) {
month = parseInt(args[i + 1]);
i++;
} else if ((args[i] === '--year' || args[i] === '-y') && args[i + 1]) {
year = parseInt(args[i + 1]);
i++;
} else if ((args[i] === '--day' || args[i] === '-d') && args[i + 1]) {
targetDay = parseInt(args[i + 1]);
i++;
} else if ((args[i] === '--activity' || args[i] === '-a') && args[i + 1]) {
activity = args[i + 1].toLowerCase();
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Optimal Days Finder
Find the best days for specific activities based on Personal Day cycles.
USAGE:
bun optimal-days.ts --profile <id> [OPTIONS]
bun optimal-days.ts --birthdate "mm/dd/yyyy" [OPTIONS]
OPTIONS:
-p, --profile ID Use saved profile
-b, --birthdate DATE Your birthdate (mm/dd/yyyy) [required if no profile]
-m, --month NUMBER Month to search (1-12) [optional - searches whole year if omitted]
-y, --year NUMBER Year to search [default: current year]
-d, --day NUMBER Target Personal Day number (1-9, 11, 22, 33)
-a, --activity NAME Activity type (new, creative, business, study, etc.) [optional]
-h, --help Show this help message
EXAMPLES:
# With profile
bun optimal-days.ts --profile rob -m 11 -y 2025 -d 1
bun optimal-days.ts --profile rob -y 2025 -d 8
# With birthdate
bun optimal-days.ts -b "5/13/1982" -m 11 -y 2025 -d 1
bun optimal-days.ts -b "5/13/1982" -y 2025 -d 8
bun optimal-days.ts -b "5/13/1982" -m 12 -y 2025 -a new
bun optimal-days.ts -b "5/13/1982" -d 3
PERSONAL DAY MEANINGS:
1 - New beginnings, initiatives, independence
2 - Cooperation, partnerships, details
3 - Creative expression, communication, social
4 - Hard work, organization, foundation building
5 - Change, freedom, marketing, variety
6 - Service, responsibility, teaching, family
7 - Introspection, study, spirituality, rest
8 - Achievement, business, power, success
9 - Completion, endings, release, letting go
11 - Inspiration, intuition, spiritual leadership
22 - Master building, manifestation
33 - Master teaching, healing, service
ACTIVITY KEYWORDS:
new, begin, start, launch → Day 1
creative, write, content → Day 3
business, money, scale → Day 8
study, learn, research → Day 7
complete, finish, publish → Day 9
teach, serve, help → Day 6
`);
process.exit(0);
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
birthdate = profile.birthdate;
}
if (!birthdate) {
console.error('Error: --birthdate is required (or use --profile)');
console.error('Try: bun optimal-days.ts --help');
process.exit(1);
}
// Activity to Personal Day mapping
const activityMap: Record<string, number[]> = {
'new': [1],
'begin': [1],
'start': [1],
'launch': [1, 8],
'creative': [3],
'write': [3],
'content': [3],
'communicate': [3],
'business': [8],
'money': [8],
'financial': [8],
'scale': [8],
'study': [7],
'learn': [7],
'research': [7],
'certification': [7],
'complete': [9],
'finish': [9],
'publish': [9],
'release': [9],
'teach': [6, 33],
'serve': [6, 33],
'help': [6],
'organize': [4],
'build': [4, 22],
'system': [4],
'change': [5],
'market': [5],
'promote': [5],
'partner': [2],
'collaborate': [2],
'spiritual': [7, 11],
'inspire': [11],
};
// Determine target day from activity if not specified
if (!targetDay && activity) {
const matchedDays = activityMap[activity];
if (matchedDays && matchedDays.length > 0) {
targetDay = matchedDays[0]; // Use first match
console.log(`\n🎯 Searching for Personal Day ${targetDay} days (best for "${activity}" activities)\n`);
} else {
console.error(`Error: Unknown activity "${activity}"`);
console.error('Try: new, creative, business, study, complete, teach, etc.');
process.exit(1);
}
}
if (!targetDay) {
console.error('Error: Either --day or --activity is required');
console.error('Try: bun optimal-days.ts --help');
process.exit(1);
}
// Day meanings
const dayMeanings: Record<number, { name: string; energy: string; bestFor: string[] }> = {
1: {
name: 'New Beginnings',
energy: 'Initiative, Independence, Leadership',
bestFor: [
'Starting new projects or ventures',
'First client meetings',
'Launching products/services',
'Making bold decisions',
'Taking independent action',
'Breaking new ground'
]
},
2: {
name: 'Cooperation',
energy: 'Partnership, Patience, Details',
bestFor: [
'Building partnerships',
'Collaborative meetings',
'Detail-oriented work',
'Diplomatic negotiations',
'Relationship building',
'Refining and perfecting'
]
},
3: {
name: 'Creative Expression',
energy: 'Communication, Creativity, Social',
bestFor: [
'Writing and content creation',
'Public speaking',
'Social media and networking',
'Creative projects',
'Presentations',
'Joyful collaboration'
]
},
4: {
name: 'Foundation Building',
energy: 'Hard Work, Organization, Structure',
bestFor: [
'Building systems and processes',
'Organizing and planning',
'Infrastructure work',
'Physical projects',
'Financial planning',
'Detail implementation'
]
},
5: {
name: 'Change & Freedom',
energy: 'Variety, Adventure, Marketing',
bestFor: [
'Marketing and promotion',
'Trying new approaches',
'Embracing change',
'Travel and exploration',
'Experimenting',
'Pivoting strategies'
]
},
6: {
name: 'Service & Responsibility',
energy: 'Teaching, Helping, Family',
bestFor: [
'Client service work',
'Teaching and training',
'Taking on responsibility',
'Family matters',
'Home projects',
'Community service'
]
},
7: {
name: 'Introspection',
energy: 'Study, Spirituality, Analysis',
bestFor: [
'Deep study and learning',
'Research and analysis',
'Spiritual practice',
'Private development',
'Rest and rejuvenation',
'Strategic thinking'
]
},
8: {
name: 'Achievement',
energy: 'Power, Business, Success',
bestFor: [
'Business deals and negotiations',
'Financial decisions',
'Scaling operations',
'Authority building',
'Major launches',
'Leadership actions'
]
},
9: {
name: 'Completion',
energy: 'Release, Endings, Letting Go',
bestFor: [
'Completing projects',
'Publishing finished work',
'Releasing products',
'Ending what no longer serves',
'Wrapping up loose ends',
'Clearing space'
]
},
11: {
name: 'Inspiration',
energy: 'Intuition, Illumination, Spiritual Leadership',
bestFor: [
'Inspiring others',
'Channeling intuition',
'Spiritual teaching',
'Visionary work',
'Illuminating insights',
'Master-level guidance'
]
},
22: {
name: 'Master Building',
energy: 'Manifestation, Large-Scale Vision',
bestFor: [
'Building lasting legacies',
'Large-scale projects',
'Master-level manifestation',
'Visionary implementation',
'Foundation for decades',
'Ambitious launches'
]
},
33: {
name: 'Master Teaching',
energy: 'Healing, Compassionate Service',
bestFor: [
'Master teaching moments',
'Healing and service work',
'Compassionate leadership',
'Educational initiatives',
'Serving at highest level',
'Impact-focused action'
]
}
};
// Avoid activities
const avoidActivities: Record<number, string[]> = {
1: ['Waiting for others', 'Being passive', 'Following only'],
2: ['Solo ventures', 'Rushing', 'Being impatient'],
3: ['Heavy analytical work', 'Isolation', 'Serious only mode'],
4: ['Starting completely new things', 'Taking shortcuts', 'Scattered work'],
5: ['Rigid routines', 'Being stuck', 'Resisting change'],
6: ['Selfish pursuits', 'Avoiding responsibility', 'Neglecting others'],
7: ['Major public launches', 'Excessive socializing', 'Surface-level work'],
8: ['Spiritual retreats', 'Passive waiting', 'Small thinking'],
9: ['Starting new ventures', 'Beginning fresh', 'Initiating'],
11: ['Ignoring intuition', 'Playing small', 'Logical-only thinking'],
22: ['Small projects', 'Short-term thinking', 'Doubting vision'],
33: ['Selfish profit focus', 'Burnout', 'Saving everyone without boundaries']
};
interface OptimalDay {
date: Date;
dateString: string;
dayOfWeek: string;
personalDay: number;
personalMonth: number;
monthName: string;
}
// Find optimal days
function findOptimalDays(
birthdate: string,
targetDay: number,
month: number | null,
year: number
): OptimalDay[] {
const results: OptimalDay[] = [];
const startMonth = month || 1;
const endMonth = month || 12;
for (let m = startMonth; m <= endMonth; m++) {
const daysInMonth = new Date(year, m, 0).getDate();
for (let d = 1; d <= daysInMonth; d++) {
const dateStr = `${m}/${d}/${year}`;
const cycles = calculateCycles(birthdate, dateStr);
if (cycles.personal.day === targetDay) {
const date = new Date(year, m - 1, d);
results.push({
date,
dateString: dateStr,
dayOfWeek: date.toLocaleDateString('en-US', { weekday: 'long' }),
personalDay: cycles.personal.day,
personalMonth: cycles.personal.month,
monthName: date.toLocaleDateString('en-US', { month: 'long' })
});
}
}
}
return results;
}
// Main execution
console.log(`\n═══════════════════════════════════════════════════════════════`);
console.log(`🎯 OPTIMAL DAYS FINDER`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const searchPeriod = month
? `${new Date(year, month - 1).toLocaleDateString('en-US', { month: 'long' })} ${year}`
: `All of ${year}`;
console.log(`Searching: ${searchPeriod}`);
console.log(`Personal Day: ${targetDay} (${dayMeanings[targetDay]?.name || 'Unknown'})\n`);
const optimalDays = findOptimalDays(birthdate, targetDay, month, year);
if (optimalDays.length === 0) {
console.log(`❌ No Personal Day ${targetDay} days found in ${searchPeriod}\n`);
process.exit(0);
}
console.log(`Found ${optimalDays.length} optimal day${optimalDays.length > 1 ? 's' : ''}:\n`);
// Display results grouped by month
const byMonth: Record<string, OptimalDay[]> = {};
optimalDays.forEach(day => {
if (!byMonth[day.monthName]) byMonth[day.monthName] = [];
byMonth[day.monthName].push(day);
});
for (const [monthName, days] of Object.entries(byMonth)) {
console.log(`📅 ${monthName.toUpperCase()} ${year}:`);
days.forEach(day => {
const date = day.date;
const dateFormatted = `${monthName} ${date.getDate()}, ${year}`;
console.log(` • ${day.dayOfWeek}, ${dateFormatted}`);
});
console.log('');
}
// Display day meaning and guidance
const meaning = dayMeanings[targetDay];
if (meaning) {
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`PERSONAL DAY ${targetDay}: ${meaning.name.toUpperCase()}`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`🌟 ENERGY: ${meaning.energy}\n`);
console.log(`✅ BEST FOR:`);
meaning.bestFor.forEach(item => console.log(` • ${item}`));
console.log('');
if (avoidActivities[targetDay]) {
console.log(`⚠️ AVOID ON THESE DAYS:`);
avoidActivities[targetDay].forEach(item => console.log(` • ${item}`));
console.log('');
}
}
// Practical scheduling tips
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`💡 SCHEDULING TIPS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
if (targetDay === 1) {
console.log(`→ Schedule important launches and "first steps" on these days`);
console.log(`→ Use for kickoff meetings and bold initiatives`);
console.log(`→ These are YOUR days to lead and take charge\n`);
} else if (targetDay === 3) {
console.log(`→ Perfect days for content creation and publishing`);
console.log(`→ Schedule presentations and networking events`);
console.log(`→ Social media campaigns work great on Day 3\n`);
} else if (targetDay === 7) {
console.log(`→ Block these days for deep work and study`);
console.log(`→ Avoid scheduling external meetings if possible`);
console.log(`→ Use for strategy, analysis, and preparation\n`);
} else if (targetDay === 8) {
console.log(`→ Schedule major business deals and negotiations`);
console.log(`→ Perfect for product launches and promotions`);
console.log(`→ Make big financial decisions on these days\n`);
} else if (targetDay === 9) {
console.log(`→ Ideal days to ship completed projects`);
console.log(`→ Schedule "wrapping up" and "final release" work`);
console.log(`→ Good for ending contracts or relationships\n`);
}
// Show first 3 as "upcoming opportunities" if searching future
const today = new Date();
const futureDays = optimalDays.filter(d => d.date >= today).slice(0, 3);
if (futureDays.length > 0) {
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`🚀 UPCOMING OPPORTUNITIES`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
futureDays.forEach((day, i) => {
const daysUntil = Math.ceil((day.date.getTime() - today.getTime()) / (1000 * 60 * 60 * 24));
const urgent = daysUntil <= 7 ? '⚡' : '';
console.log(`${i + 1}. ${urgent} ${day.dayOfWeek}, ${day.monthName} ${day.date.getDate()}`);
console.log(` (${daysUntil} days from now - Personal Month ${day.personalMonth})\n`);
});
}
console.log(`✨ Use these optimal days to align your actions with natural energy cycles\n`);

766
pinnacles.ts Executable file
View file

@ -0,0 +1,766 @@
#!/usr/bin/env bun
/**
* Life Stages & Pinnacles Calculator
*
* Calculate your 4 major Life Pinnacles - the overarching themes and
* opportunities for growth during different life stages. Each pinnacle
* lasts approximately 9 years and represents major life chapters.
*
* Also calculates Challenge Numbers - obstacles and lessons to overcome.
*
* Usage:
* bun pinnacles.ts --birthdate "5/13/1982"
* bun pinnacles.ts --birthdate "5/13/1982" --name "Your Name"
*/
import { reduce } from './core-calculator';
import { loadProfile } from './profile-manager';
// Parse command line arguments
const args = process.argv.slice(2);
let birthdate = '';
let name = '';
let profileId = '';
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Life Stages & Pinnacles Calculator
Calculate your 4 major Life Pinnacles and Challenge Numbers.
Pinnacles are 9-year cycles representing major life themes and opportunities.
USAGE:
bun pinnacles.ts --profile <id>
bun pinnacles.ts --birthdate "mm/dd/yyyy" [OPTIONS]
OPTIONS:
-p, --profile ID Use saved profile
-b, --birthdate DATE Your birthdate (mm/dd/yyyy) [required if no profile]
-n, --name NAME Your name [optional - for context]
-h, --help Show this help message
EXAMPLES:
# With profile
bun pinnacles.ts --profile rob
# With birthdate
bun pinnacles.ts -b "5/13/1982"
bun pinnacles.ts -b "5/13/1982" -n "John Doe"
WHAT ARE PINNACLES?
Pinnacles are major 9-year life cycles, each with a specific theme and energy.
There are 4 pinnacles in a lifetime:
1st Pinnacle: Foundation & Growth (Birth to ~age 27-35)
2nd Pinnacle: Productivity & Building (Age ~27-44)
3rd Pinnacle: Harvest & Mastery (Age ~44-53)
4th Pinnacle: Wisdom & Legacy (Age ~53 onwards)
The age ranges depend on your Life Path number.
WHAT ARE CHALLENGES?
Challenges represent obstacles and lessons you must overcome during each
pinnacle period. They show where growth is needed.
`);
process.exit(0);
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
name = profile.name;
birthdate = profile.birthdate;
}
if (!birthdate) {
console.error('Error: --birthdate is required (or use --profile)');
console.error('Try: bun pinnacles.ts --help');
process.exit(1);
}
// Parse birthdate
const parts = birthdate.split('/');
if (parts.length !== 3) {
console.error('Error: Birthdate must be in mm/dd/yyyy format');
process.exit(1);
}
const month = parseInt(parts[0]);
const day = parseInt(parts[1]);
const year = parseInt(parts[2]);
// Calculate Life Path
function calculateLifePath(m: number, d: number, y: number): number {
const monthReduced = reduce(m);
const dayReduced = reduce(d);
const yearReduced = reduce(y);
const sum = monthReduced + dayReduced + yearReduced;
return reduce(sum);
}
const lifePath = calculateLifePath(month, day, year);
// Calculate Pinnacles
// Pinnacle 1 = Month + Day
// Pinnacle 2 = Day + Year
// Pinnacle 3 = Pinnacle 1 + Pinnacle 2
// Pinnacle 4 = Month + Year
const pinnacle1 = reduce(month + day);
const pinnacle2 = reduce(day + year);
const pinnacle3 = reduce(pinnacle1 + pinnacle2);
const pinnacle4 = reduce(month + year);
// Calculate Challenge Numbers
// Challenge 1 = |Month - Day|
// Challenge 2 = |Day - Year|
// Challenge 3 = |Challenge 1 - Challenge 2|
// Challenge 4 = |Month - Year|
const monthReduced = reduce(month);
const dayReduced = reduce(day);
const yearReduced = reduce(year);
const challenge1 = Math.abs(monthReduced - dayReduced);
const challenge2 = Math.abs(dayReduced - yearReduced);
const challenge3 = Math.abs(challenge1 - challenge2);
const challenge4 = Math.abs(monthReduced - yearReduced);
// Calculate Pinnacle Ages
// Age at end of 1st Pinnacle = 36 - Life Path
const firstPinnacleEnd = 36 - lifePath;
const secondPinnacleEnd = firstPinnacleEnd + 9;
const thirdPinnacleEnd = secondPinnacleEnd + 9;
// 4th Pinnacle continues for rest of life
// Calculate current age
const today = new Date();
const birthYear = year;
const currentAge = today.getFullYear() - birthYear;
// Determine current pinnacle
let currentPinnacle = 1;
let currentPinnacleNumber = pinnacle1;
let currentChallenge = challenge1;
let pinnacleStartAge = 0;
let pinnacleEndAge = firstPinnacleEnd;
if (currentAge > thirdPinnacleEnd) {
currentPinnacle = 4;
currentPinnacleNumber = pinnacle4;
currentChallenge = challenge4;
pinnacleStartAge = thirdPinnacleEnd + 1;
pinnacleEndAge = 999; // Lifetime
} else if (currentAge > secondPinnacleEnd) {
currentPinnacle = 3;
currentPinnacleNumber = pinnacle3;
currentChallenge = challenge3;
pinnacleStartAge = secondPinnacleEnd + 1;
pinnacleEndAge = thirdPinnacleEnd;
} else if (currentAge > firstPinnacleEnd) {
currentPinnacle = 2;
currentPinnacleNumber = pinnacle2;
currentChallenge = challenge2;
pinnacleStartAge = firstPinnacleEnd + 1;
pinnacleEndAge = secondPinnacleEnd;
} else {
currentPinnacle = 1;
currentPinnacleNumber = pinnacle1;
currentChallenge = challenge1;
pinnacleStartAge = 0;
pinnacleEndAge = firstPinnacleEnd;
}
// Pinnacle meanings
const pinnacleMeanings: Record<number, { theme: string; focus: string[]; opportunities: string[]; challenges: string[] }> = {
1: {
theme: 'Independence & Leadership',
focus: [
'Develop self-confidence and courage',
'Learn to stand on your own',
'Take initiative and lead',
'Forge your own path'
],
opportunities: [
'Starting new ventures',
'Developing leadership skills',
'Building self-reliance',
'Taking bold action',
'Pioneering new territory'
],
challenges: [
'Overcoming self-doubt',
'Avoiding excessive ego',
'Not being too aggressive',
'Learning independence without isolation'
]
},
2: {
theme: 'Cooperation & Relationships',
focus: [
'Build meaningful partnerships',
'Develop diplomacy and tact',
'Learn patience and cooperation',
'Master the art of collaboration'
],
opportunities: [
'Deep relationships and partnerships',
'Collaborative projects',
'Diplomatic roles',
'Building harmony',
'Supporting others'
],
challenges: [
'Avoiding codependence',
'Not losing yourself in others',
'Overcoming hypersensitivity',
'Speaking up when needed'
]
},
3: {
theme: 'Creative Expression & Communication',
focus: [
'Express yourself creatively',
'Develop communication skills',
'Find joy and optimism',
'Share your gifts with the world'
],
opportunities: [
'Creative projects and arts',
'Public speaking and writing',
'Social connections',
'Self-expression',
'Inspiring others through joy'
],
challenges: [
'Avoiding scattered energy',
'Not being superficial',
'Managing criticism',
'Finishing what you start'
]
},
4: {
theme: 'Foundation & Hard Work',
focus: [
'Build solid foundations',
'Develop discipline and organization',
'Work hard toward goals',
'Create lasting structures'
],
opportunities: [
'Building wealth through effort',
'Creating systems and order',
'Physical accomplishments',
'Real estate and property',
'Establishing security'
],
challenges: [
'Avoiding rigidity',
'Not overworking',
'Preventing burnout',
'Being flexible when needed'
]
},
5: {
theme: 'Freedom & Change',
focus: [
'Embrace change and variety',
'Explore and experience life',
'Develop adaptability',
'Learn from diverse experiences'
],
opportunities: [
'Travel and adventure',
'Career changes and pivots',
'Marketing and promotion',
'Trying new things',
'Personal freedom'
],
challenges: [
'Avoiding restlessness',
'Not being irresponsible',
'Managing impulses',
'Commitment when needed'
]
},
6: {
theme: 'Responsibility & Service',
focus: [
'Take responsibility for others',
'Serve family and community',
'Teach and nurture',
'Create harmony and beauty'
],
opportunities: [
'Family and home',
'Teaching and counseling',
'Helping professions',
'Creating beauty',
'Service to others'
],
challenges: [
'Avoiding martyrdom',
'Not being controlling',
'Setting boundaries',
'Self-care alongside service'
]
},
7: {
theme: 'Wisdom & Spirituality',
focus: [
'Seek inner truth and wisdom',
'Develop spiritual understanding',
'Master a specialty',
'Trust your intuition'
],
opportunities: [
'Deep study and research',
'Spiritual development',
'Teaching wisdom',
'Mastering expertise',
'Inner peace'
],
challenges: [
'Avoiding isolation',
'Not being too aloof',
'Connecting with others',
'Practical application of wisdom'
]
},
8: {
theme: 'Power & Achievement',
focus: [
'Build material success',
'Develop business acumen',
'Gain authority and respect',
'Master the material world'
],
opportunities: [
'Business success',
'Financial abundance',
'Leadership positions',
'Recognition and authority',
'Large-scale projects'
],
challenges: [
'Avoiding greed',
'Not abusing power',
'Staying ethical',
'Balancing material and spiritual'
]
},
9: {
theme: 'Completion & Humanitarianism',
focus: [
'Serve humanity broadly',
'Complete life lessons',
'Develop compassion',
'Let go of the past'
],
opportunities: [
'Humanitarian work',
'Teaching and healing',
'Artistic expression',
'Global thinking',
'Completion of major cycles'
],
challenges: [
'Avoiding emotional overwhelm',
'Not being impractical',
'Letting go when needed',
'Setting boundaries in service'
]
},
11: {
theme: 'Spiritual Illumination',
focus: [
'Inspire and illuminate others',
'Develop spiritual gifts',
'Lead through inspiration',
'Channel higher wisdom'
],
opportunities: [
'Spiritual teaching',
'Inspirational leadership',
'Intuitive development',
'Healing work',
'Visionary projects'
],
challenges: [
'Managing nervous system',
'Avoiding overwhelm',
'Grounding spiritual energy',
'Practical application of vision'
]
},
22: {
theme: 'Master Building',
focus: [
'Build lasting legacies',
'Manifest grand visions',
'Serve on large scale',
'Combine practical and visionary'
],
opportunities: [
'Large-scale manifestation',
'Building institutions',
'Global impact',
'Visionary leadership',
'Lasting contributions'
],
challenges: [
'Managing immense pressure',
'Not doubting grand vision',
'Staying grounded',
'Balancing ambition with reality'
]
},
33: {
theme: 'Master Teaching',
focus: [
'Teach and heal at master level',
'Serve humanity compassionately',
'Embody unconditional love',
'Lead through nurturing'
],
opportunities: [
'Master teaching',
'Healing on large scale',
'Compassionate leadership',
'Raising consciousness',
'Selfless service'
],
challenges: [
'Avoiding martyrdom',
'Preventing burnout',
'Setting healthy boundaries',
'Not trying to save everyone'
]
}
};
// Challenge meanings
const challengeMeanings: Record<number, { lesson: string; mustLearn: string[]; traps: string[] }> = {
0: {
lesson: 'Choice & Responsibility',
mustLearn: [
'Make clear decisions',
'Take full responsibility',
'Avoid indecisiveness',
'Choose your path'
],
traps: [
'Analysis paralysis',
'Avoiding decisions',
'Waiting for perfection'
]
},
1: {
lesson: 'Independence vs. Dependence',
mustLearn: [
'Stand on your own',
'Develop self-confidence',
'Take initiative',
'Balance independence with cooperation'
],
traps: [
'Too dependent on others',
'Too aggressive/domineering',
'Afraid to lead'
]
},
2: {
lesson: 'Sensitivity & Balance',
mustLearn: [
'Manage sensitivity',
'Find balance in relationships',
'Speak your truth',
'Cooperate without losing self'
],
traps: [
'Oversensitivity',
'Codependence',
'People-pleasing',
'Avoiding conflict'
]
},
3: {
lesson: 'Self-Expression',
mustLearn: [
'Express yourself authentically',
'Share your creativity',
'Communicate openly',
'Find your voice'
],
traps: [
'Self-criticism',
'Scattered energy',
'Superficiality',
'Fear of judgment'
]
},
4: {
lesson: 'Discipline & Order',
mustLearn: [
'Create structure',
'Develop discipline',
'Commit to hard work',
'Build foundations'
],
traps: [
'Rigidity',
'Workaholism',
'Avoiding necessary work',
'Too much restriction'
]
},
5: {
lesson: 'Freedom & Responsibility',
mustLearn: [
'Balance freedom with responsibility',
'Embrace change wisely',
'Develop self-discipline',
'Focus energy'
],
traps: [
'Restlessness',
'Irresponsibility',
'Overindulgence',
'Fear of commitment'
]
},
6: {
lesson: 'Responsibility & Boundaries',
mustLearn: [
'Set healthy boundaries',
'Serve without martyrdom',
'Accept responsibility appropriately',
'Love with wisdom'
],
traps: [
'Martyrdom',
'Controlling others',
'Codependence',
'Perfectionism'
]
},
7: {
lesson: 'Faith & Trust',
mustLearn: [
'Trust your intuition',
'Connect spiritually',
'Balance alone time with connection',
'Share your wisdom'
],
traps: [
'Isolation',
'Cynicism',
'Overthinking',
'Spiritual bypassing'
]
},
8: {
lesson: 'Power & Integrity',
mustLearn: [
'Use power ethically',
'Balance material and spiritual',
'Lead with integrity',
'Manage money wisely'
],
traps: [
'Greed',
'Abuse of power',
'Materialism',
'Workaholism'
]
}
};
// Output
console.log(`\n═══════════════════════════════════════════════════════════════`);
console.log(`📊 LIFE STAGES & PINNACLES`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
if (name) {
console.log(`Name: ${name}`);
}
console.log(`Birthdate: ${birthdate}`);
console.log(`Current Age: ${currentAge}`);
console.log(`Life Path: ${lifePath}\n`);
// Display all 4 pinnacles
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`YOUR 4 MAJOR LIFE PINNACLES`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const pinnacles = [
{ num: 1, value: pinnacle1, ages: `Birth - Age ${firstPinnacleEnd}`, challenge: challenge1 },
{ num: 2, value: pinnacle2, ages: `Age ${firstPinnacleEnd + 1} - ${secondPinnacleEnd}`, challenge: challenge2 },
{ num: 3, value: pinnacle3, ages: `Age ${secondPinnacleEnd + 1} - ${thirdPinnacleEnd}`, challenge: challenge3 },
{ num: 4, value: pinnacle4, ages: `Age ${thirdPinnacleEnd + 1}+`, challenge: challenge4 }
];
pinnacles.forEach(p => {
const isCurrent = p.num === currentPinnacle;
const marker = isCurrent ? ' 👉 YOU ARE HERE' : '';
const meaning = pinnacleMeanings[p.value];
console.log(`${isCurrent ? '✨ ' : ''}PINNACLE ${p.num}: ${p.ages}${marker}`);
console.log(`Number: ${p.value} - ${meaning?.theme || 'Unknown'}`);
console.log(`Challenge: ${p.challenge}\n`);
if (meaning && isCurrent) {
console.log(`CURRENT FOCUS:`);
meaning.focus.forEach(f => console.log(` • ${f}`));
console.log('');
}
});
// Detailed current pinnacle
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`YOUR CURRENT PINNACLE (Pinnacle ${currentPinnacle})`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const currentMeaning = pinnacleMeanings[currentPinnacleNumber];
if (currentMeaning) {
console.log(`PINNACLE ${currentPinnacle}: NUMBER ${currentPinnacleNumber}`);
console.log(`${currentMeaning.theme.toUpperCase()}\n`);
console.log(`AGE RANGE: ${pinnacleStartAge === 0 ? 'Birth' : `Age ${pinnacleStartAge}`} - ${pinnacleEndAge === 999 ? 'Rest of Life' : `Age ${pinnacleEndAge}`}`);
if (pinnacleEndAge !== 999) {
const yearsRemaining = pinnacleEndAge - currentAge;
console.log(`Years Remaining in This Pinnacle: ${yearsRemaining}\n`);
} else {
console.log(`This is your final pinnacle for the rest of your life.\n`);
}
console.log(`🎯 PRIMARY FOCUS:`);
currentMeaning.focus.forEach(f => console.log(` • ${f}`));
console.log('');
console.log(`✅ OPPORTUNITIES:`);
currentMeaning.opportunities.forEach(o => console.log(` • ${o}`));
console.log('');
console.log(`⚠️ CHALLENGES TO WATCH:`);
currentMeaning.challenges.forEach(c => console.log(` • ${c}`));
console.log('');
}
// Current Challenge
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`YOUR CURRENT CHALLENGE (Pinnacle ${currentPinnacle})`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const challengeMeaning = challengeMeanings[currentChallenge];
if (challengeMeaning) {
console.log(`CHALLENGE ${currentPinnacle}: NUMBER ${currentChallenge}`);
console.log(`${challengeMeaning.lesson.toUpperCase()}\n`);
console.log(`📚 MUST LEARN:`);
challengeMeaning.mustLearn.forEach(l => console.log(` • ${l}`));
console.log('');
console.log(`❌ TRAPS TO AVOID:`);
challengeMeaning.traps.forEach(t => console.log(` • ${t}`));
console.log('');
}
// Strategic Life Planning
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`STRATEGIC LIFE PLANNING`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
if (currentPinnacle === 1) {
console.log(`💡 You're in your Foundation & Growth period.\n`);
console.log(`This pinnacle is about:\n`);
console.log(`→ Building your foundation for life`);
console.log(`→ Discovering who you are`);
console.log(`→ Developing core skills and abilities`);
console.log(`→ Learning life's basic lessons\n`);
console.log(`Use this time to experiment, learn, and grow. The patterns you`);
console.log(`establish now will influence your entire life.\n`);
} else if (currentPinnacle === 2) {
console.log(`💡 You're in your Productivity & Building period.\n`);
console.log(`This pinnacle is about:\n`);
console.log(`→ Applying what you learned in Pinnacle 1`);
console.log(`→ Building your career and relationships`);
console.log(`→ Creating stability and structure`);
console.log(`→ Maximizing productivity\n`);
console.log(`This is your power building phase. Focus on creating the life`);
console.log(`you want to live in Pinnacles 3 and 4.\n`);
} else if (currentPinnacle === 3) {
console.log(`💡 You're in your Harvest & Mastery period.\n`);
console.log(`This pinnacle is about:\n`);
console.log(`→ Reaping what you've sown`);
console.log(`→ Mastering your craft`);
console.log(`→ Reassessing and adjusting`);
console.log(`→ Preparing for wisdom phase\n`);
console.log(`This is the harvest time. What you built in Pinnacles 1-2 now`);
console.log(`bears fruit. Use this time to master and perfect.\n`);
} else if (currentPinnacle === 4) {
console.log(`💡 You're in your Wisdom & Legacy period.\n`);
console.log(`This pinnacle is about:\n`);
console.log(`→ Sharing wisdom gained from life`);
console.log(`→ Creating lasting legacy`);
console.log(`→ Mentoring others`);
console.log(`→ Living your highest purpose\n`);
console.log(`This is your wisdom phase. You have a lifetime of experience.`);
console.log(`How will you share it? What legacy will you leave?\n`);
}
// Next Pinnacle Preview (if not in Pinnacle 4)
if (currentPinnacle < 4) {
const nextPinnacle = currentPinnacle + 1;
let nextNumber, nextStart, nextEnd;
if (nextPinnacle === 2) {
nextNumber = pinnacle2;
nextStart = firstPinnacleEnd + 1;
nextEnd = secondPinnacleEnd;
} else if (nextPinnacle === 3) {
nextNumber = pinnacle3;
nextStart = secondPinnacleEnd + 1;
nextEnd = thirdPinnacleEnd;
} else {
nextNumber = pinnacle4;
nextStart = thirdPinnacleEnd + 1;
nextEnd = 999;
}
const yearsUntilNext = nextStart - currentAge;
const nextMeaning = pinnacleMeanings[nextNumber];
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`NEXT PINNACLE PREVIEW`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`PINNACLE ${nextPinnacle}: NUMBER ${nextNumber} - ${nextMeaning?.theme}`);
console.log(`Begins: Age ${nextStart} (in ${yearsUntilNext} years)\n`);
if (nextMeaning) {
console.log(`PREPARE NOW FOR:`);
nextMeaning.focus.slice(0, 3).forEach(f => console.log(` • ${f}`));
console.log('');
}
}
console.log(`✨ Generated with Life Stages & Pinnacles Calculator\n`);

123
profile-helper.ts Normal file
View file

@ -0,0 +1,123 @@
/**
* Profile Helper Utility
*
* Standardized profile loading for all numerology tools.
* Import this to add profile support with just a few lines.
*
* Usage:
* import { parseProfileOrDirect } from './profile-helper';
*
* const { name, birthdate } = parseProfileOrDirect(args, {
* toolName: 'optimal-days',
* requiresBirthdate: true,
* requiresName: false
* });
*/
import { loadProfile } from './profile-manager';
export interface ParseOptions {
toolName: string;
requiresBirthdate?: boolean;
requiresName?: boolean;
}
export interface ParsedData {
name: string;
birthdate: string;
}
/**
* Parse command line args for either --profile or direct --name/--birthdate
*
* @param args - process.argv.slice(2)
* @param options - Configuration options
* @returns Object with name and birthdate
* @throws Error if required data is missing
*/
export function parseProfileOrDirect(args: string[], options: ParseOptions): ParsedData {
let name = '';
let birthdate = '';
let profileId = '';
// Parse arguments
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
name = profile.name;
birthdate = profile.birthdate;
console.log(`Using profile '${profileId}': ${name} (${birthdate})`);
}
// Validate required fields
const requiresName = options.requiresName !== false; // default true
const requiresBirthdate = options.requiresBirthdate !== false; // default true
if (requiresName && !name) {
console.error(`Error: ${options.toolName} requires --name (or --profile)`);
console.error('Try: bun --help');
process.exit(1);
}
if (requiresBirthdate && !birthdate) {
console.error(`Error: ${options.toolName} requires --birthdate (or --profile)`);
console.error('Try: bun --help');
process.exit(1);
}
return { name, birthdate };
}
/**
* Add profile flag to help text
*
* @param existingHelp - Existing help text with --name and --birthdate
* @returns Updated help text with --profile option
*/
export function addProfileToHelp(existingHelp: string): string {
// Add profile option to OPTIONS section
let updated = existingHelp.replace(
/(OPTIONS:|Options:)\s*\n/i,
'$1\n -p, --profile ID Use saved profile\n'
);
// Update required flags to say "or --profile"
updated = updated.replace(
/(\s+--name.*)\[required\]/gi,
'$1[required if no profile]'
);
updated = updated.replace(
/(\s+--birthdate.*)\[required\]/gi,
'$1[required if no profile]'
);
// Add profile example
if (updated.includes('EXAMPLES:') || updated.includes('Examples:')) {
updated = updated.replace(
/(EXAMPLES?:.*?\n)/i,
'$1 # With profile\n bun <tool>.ts --profile john\n\n'
);
}
return updated;
}

153
profile-manager.ts Normal file
View file

@ -0,0 +1,153 @@
#!/usr/bin/env bun
/**
* Profile Management System
*
* Manages numerology profiles stored in ~/.numerology/profiles/
* Each profile contains name and birthdate for easy reuse across all tools.
*
* Usage:
* import { loadProfile, saveProfile, listProfiles, deleteProfile } from './profile-manager';
*/
import { existsSync, mkdirSync, readdirSync, readFileSync, writeFileSync, unlinkSync } from 'fs';
import { join } from 'path';
import { homedir } from 'os';
export interface Profile {
name: string;
birthdate: string;
created: string;
updated: string;
}
const PROFILES_DIR = join(homedir(), '.numerology', 'profiles');
/**
* Ensure profiles directory exists
*/
function ensureProfilesDir(): void {
if (!existsSync(PROFILES_DIR)) {
mkdirSync(PROFILES_DIR, { recursive: true });
}
}
/**
* Generate profile filename from identifier
*/
function getProfilePath(identifier: string): string {
// Sanitize identifier to create safe filename
const safeName = identifier.toLowerCase().replace(/[^a-z0-9-_]/g, '-');
return join(PROFILES_DIR, `${safeName}.json`);
}
/**
* Save a profile
*/
export function saveProfile(identifier: string, name: string, birthdate: string): void {
ensureProfilesDir();
const profilePath = getProfilePath(identifier);
const now = new Date().toISOString();
// Check if profile exists to preserve created date
let created = now;
if (existsSync(profilePath)) {
try {
const existing = JSON.parse(readFileSync(profilePath, 'utf-8')) as Profile;
created = existing.created;
} catch {
// If file is corrupted, use current time
}
}
const profile: Profile = {
name,
birthdate,
created,
updated: now
};
writeFileSync(profilePath, JSON.stringify(profile, null, 2));
}
/**
* Load a profile
*/
export function loadProfile(identifier: string): Profile | null {
const profilePath = getProfilePath(identifier);
if (!existsSync(profilePath)) {
return null;
}
try {
const data = readFileSync(profilePath, 'utf-8');
return JSON.parse(data) as Profile;
} catch (error) {
console.error(`Error reading profile '${identifier}':`, error);
return null;
}
}
/**
* List all profiles
*/
export function listProfiles(): Array<{ identifier: string; profile: Profile }> {
ensureProfilesDir();
const profiles: Array<{ identifier: string; profile: Profile }> = [];
try {
const files = readdirSync(PROFILES_DIR);
for (const file of files) {
if (file.endsWith('.json')) {
const identifier = file.replace('.json', '');
const profile = loadProfile(identifier);
if (profile) {
profiles.push({ identifier, profile });
}
}
}
} catch (error) {
console.error('Error listing profiles:', error);
}
return profiles;
}
/**
* Delete a profile
*/
export function deleteProfile(identifier: string): boolean {
const profilePath = getProfilePath(identifier);
if (!existsSync(profilePath)) {
return false;
}
try {
unlinkSync(profilePath);
return true;
} catch (error) {
console.error(`Error deleting profile '${identifier}':`, error);
return false;
}
}
/**
* Check if a profile exists
*/
export function profileExists(identifier: string): boolean {
return existsSync(getProfilePath(identifier));
}
/**
* Get profile identifier from name (for auto-generation)
*/
export function generateIdentifier(name: string): string {
// Generate identifier from first name
const firstName = name.split(' ')[0];
return firstName.toLowerCase().replace(/[^a-z0-9]/g, '');
}

222
profile.ts Executable file
View file

@ -0,0 +1,222 @@
#!/usr/bin/env bun
/**
* Profile Management CLI
*
* Manage numerology profiles for easy reuse across all tools.
*
* Usage:
* bun profile.ts create --name "Your Name" --birthdate "mm/dd/yyyy"
* bun profile.ts create rob --name "John Smith" --birthdate "3/15/1990"
* bun profile.ts list
* bun profile.ts show rob
* bun profile.ts delete rob
*/
import {
saveProfile,
loadProfile,
listProfiles,
deleteProfile,
generateIdentifier,
profileExists
} from './profile-manager';
// Colors for terminal output
const colors = {
reset: '\x1b[0m',
bright: '\x1b[1m',
green: '\x1b[32m',
blue: '\x1b[34m',
yellow: '\x1b[33m',
red: '\x1b[31m',
cyan: '\x1b[36m',
};
function showHelp() {
console.log(`
${colors.bright}Profile Management${colors.reset}
Manage numerology profiles for easy reuse across all tools.
${colors.bright}USAGE:${colors.reset}
bun profile.ts <command> [options]
${colors.bright}COMMANDS:${colors.reset}
${colors.cyan}create${colors.reset} [identifier] Create or update a profile
${colors.cyan}list${colors.reset} List all profiles
${colors.cyan}show${colors.reset} <identifier> Show profile details
${colors.cyan}delete${colors.reset} <identifier> Delete a profile
${colors.bright}CREATE OPTIONS:${colors.reset}
--name NAME Full name (required)
--birthdate DATE Birthdate in mm/dd/yyyy format (required)
${colors.bright}EXAMPLES:${colors.reset}
# Create profile with auto-generated identifier from first name
bun profile.ts create --name "John Smith" --birthdate "3/15/1990"
${colors.blue}→ Creates profile 'john'${colors.reset}
# Create profile with custom identifier
bun profile.ts create johns --name "John Smith" --birthdate "3/15/1990"
${colors.blue}→ Creates profile 'johns'${colors.reset}
# List all profiles
bun profile.ts list
# Show specific profile
bun profile.ts show rob
# Delete profile
bun profile.ts delete rob
${colors.bright}USING PROFILES:${colors.reset}
Once created, use profiles with any numerology tool:
bun numerology.ts --profile john
bun generate-report.ts --profile john
bun compatibility.ts --profile john --person2 "Jane:1/1/1990"
bun optimal-days.ts --profile john --day 1
`);
}
// Parse command line arguments
const args = process.argv.slice(2);
if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
showHelp();
process.exit(0);
}
const command = args[0];
// CREATE command
if (command === 'create') {
let identifier: string | null = null;
let name = '';
let birthdate = '';
// Check if first arg after 'create' is the identifier (no dashes)
if (args[1] && !args[1].startsWith('-')) {
identifier = args[1];
}
// Parse options
for (let i = identifier ? 2 : 1; i < args.length; i++) {
if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
}
}
if (!name || !birthdate) {
console.error(`${colors.red}Error: Both --name and --birthdate are required${colors.reset}`);
console.error('Try: bun profile.ts create --help');
process.exit(1);
}
// Auto-generate identifier if not provided
if (!identifier) {
identifier = generateIdentifier(name);
}
const isUpdate = profileExists(identifier);
saveProfile(identifier, name, birthdate);
if (isUpdate) {
console.log(`${colors.green}✓${colors.reset} Profile '${colors.cyan}${identifier}${colors.reset}' updated`);
} else {
console.log(`${colors.green}✓${colors.reset} Profile '${colors.cyan}${identifier}${colors.reset}' created`);
}
console.log(` Name: ${name}`);
console.log(` Birthdate: ${birthdate}`);
console.log(`\nUse it with: ${colors.bright}--profile ${identifier}${colors.reset}`);
}
// LIST command
else if (command === 'list') {
const profiles = listProfiles();
if (profiles.length === 0) {
console.log(`${colors.yellow}No profiles found.${colors.reset}`);
console.log(`\nCreate one with: ${colors.bright}bun profile.ts create --name "Your Name" --birthdate "mm/dd/yyyy"${colors.reset}`);
process.exit(0);
}
console.log(`${colors.bright}\nProfiles (${profiles.length}):${colors.reset}\n`);
for (const { identifier, profile } of profiles) {
console.log(`${colors.cyan}${identifier}${colors.reset}`);
console.log(` Name: ${profile.name}`);
console.log(` Birthdate: ${profile.birthdate}`);
console.log(` Created: ${new Date(profile.created).toLocaleDateString()}`);
console.log('');
}
console.log(`Use with: ${colors.bright}--profile <identifier>${colors.reset}`);
}
// SHOW command
else if (command === 'show') {
const identifier = args[1];
if (!identifier) {
console.error(`${colors.red}Error: Profile identifier required${colors.reset}`);
console.error('Usage: bun profile.ts show <identifier>');
process.exit(1);
}
const profile = loadProfile(identifier);
if (!profile) {
console.error(`${colors.red}Error: Profile '${identifier}' not found${colors.reset}`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
console.log(`${colors.bright}\nProfile: ${colors.cyan}${identifier}${colors.reset}\n`);
console.log(`Name: ${profile.name}`);
console.log(`Birthdate: ${profile.birthdate}`);
console.log(`Created: ${new Date(profile.created).toLocaleString()}`);
console.log(`Updated: ${new Date(profile.updated).toLocaleString()}`);
console.log(`\nUse with: ${colors.bright}--profile ${identifier}${colors.reset}`);
}
// DELETE command
else if (command === 'delete') {
const identifier = args[1];
if (!identifier) {
console.error(`${colors.red}Error: Profile identifier required${colors.reset}`);
console.error('Usage: bun profile.ts delete <identifier>');
process.exit(1);
}
const profile = loadProfile(identifier);
if (!profile) {
console.error(`${colors.red}Error: Profile '${identifier}' not found${colors.reset}`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
const success = deleteProfile(identifier);
if (success) {
console.log(`${colors.green}✓${colors.reset} Profile '${colors.cyan}${identifier}${colors.reset}' deleted`);
console.log(` Was: ${profile.name} (${profile.birthdate})`);
} else {
console.error(`${colors.red}Error: Failed to delete profile '${identifier}'${colors.reset}`);
process.exit(1);
}
}
// Unknown command
else {
console.error(`${colors.red}Error: Unknown command '${command}'${colors.reset}`);
console.error('Try: bun profile.ts --help');
process.exit(1);
}

1
requirements.txt
View file

@ -1 +0,0 @@
colorama==0.4.4

891
telos-cycles-analyze.ts Executable file
View file

@ -0,0 +1,891 @@
#!/usr/bin/env bun
/**
* Telos-Cycles Goal Alignment Analyzer
*
* Deep analysis of how your telos goals align with current numerology cycles.
* Scores each goal (1-10), provides recommendations, and generates action plans.
*
* Usage:
* bun telos-cycles-analyze.ts --birthdate "5/13/1982" --name "Your Name"
* bun telos-cycles-analyze.ts --birthdate "5/13/1982" --name "Your Name" --telos-file ~/my-telos.md
*
* Default telos file: ~/.claude/context/personal/telos/telos.md
*/
import { calculateCycles } from './cycles';
import { calculateCoreNumbers, type CoreNumbers } from './core-calculator';
import { loadProfile } from './profile-manager';
// Parse command line arguments
const args = process.argv.slice(2);
let birthdate = '';
let name = '';
let profileId = '';
let telosFilePath = `${process.env.HOME}/.claude/context/personal/telos/telos.md`;
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if ((args[i] === '--telos-file' || args[i] === '-t') && args[i + 1]) {
telosFilePath = args[i + 1];
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Telos-Cycles Goal Alignment Analyzer
Analyzes how well your telos goals align with current numerology cycles.
Scores each goal, provides timing recommendations, and prioritizes actions.
USAGE:
bun telos-cycles-analyze.ts --profile <id>
bun telos-cycles-analyze.ts --birthdate "mm/dd/yyyy" --name "Your Name"
OPTIONS:
-p, --profile Use saved profile
-b, --birthdate Your birthdate (mm/dd/yyyy) [required if no profile]
-n, --name Your name [required if no profile]
-t, --telos-file Path to telos.md file [default: ~/.claude/context/personal/telos/telos.md]
-h, --help Show this help message
EXAMPLES:
# With profile
bun telos-cycles-analyze.ts --profile rob
bun telos-cycles-analyze.ts --profile rob -t ~/my-telos.md
# With name/birthdate
bun telos-cycles-analyze.ts -b "5/13/1982" -n "John"
bun telos-cycles-analyze.ts -b "5/13/1982" -n "John" -t ~/my-telos.md
`);
process.exit(0);
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
name = profile.name;
birthdate = profile.birthdate;
}
if (!birthdate || !name) {
console.error('Error: --birthdate and --name are required (or use --profile)');
console.error('Try: bun telos-cycles-analyze.ts --help');
process.exit(1);
}
// Telos Goal Interface
interface TelosGoal {
id: string;
description: string;
category: string;
status?: string;
}
// Goal Analysis Result
interface GoalAnalysis {
goal: TelosGoal;
score: number;
alignment: 'Perfect' | 'Good' | 'Moderate' | 'Challenge' | 'Poor';
reasons: { positive: string[]; negative: string[]; neutral: string[] };
recommendation: string;
optimalTiming: string;
monthlyBreakdown?: string[];
}
// Parse telos file
async function parseTelosFile(filePath: string): Promise<TelosGoal[]> {
try {
const file = Bun.file(filePath);
const content = await file.text();
const goals: TelosGoal[] = [];
let currentCategory = '';
const lines = content.split('\n');
for (let i = 0; i < lines.length; i++) {
const line = lines[i].trim();
if (line.match(/^(Career|Business|Personal|Technical|Content|Spiritual|Expression)/)) {
currentCategory = line.replace(/^#*\s*/, '').replace(/\s*-.*$/, '');
}
const goalMatch = line.match(/^-\s+(G[A-Z]*\d+):\s*(.+)/);
if (goalMatch && currentCategory) {
const [, id, description] = goalMatch;
const status = description.includes('✅') ? 'achieved' :
description.includes('Back burner') ? 'backburner' :
description.includes('Future goal') ? 'future' : 'active';
let cleanDesc = description
.replace(/✅\s*ACHIEVED\s*-?\s*/gi, '')
.replace(/✅\s*ONGOING\s*-?\s*/gi, '')
.replace(/✅\s*EXCEEDED\s*-?\s*/gi, '')
.replace(/\(.*?\)/g, '')
.replace(/Back burner/gi, '')
.replace(/Future goal/gi, '')
.trim();
goals.push({ id, description: cleanDesc, category: currentCategory, status });
}
}
return goals;
} catch (error) {
console.error(`Error reading telos file: ${error}`);
return [];
}
}
// Score goal alignment with current cycles (ENHANCED ALGORITHM)
function analyzeGoalAlignment(
goal: TelosGoal,
cycles: ReturnType<typeof calculateCycles>,
coreNumbers: CoreNumbers
): GoalAnalysis {
const { personal, universal } = cycles;
let score = 5; // Start neutral
const positive: string[] = [];
const negative: string[] = [];
const neutral: string[] = [];
const desc = goal.description.toLowerCase();
const cat = goal.category.toLowerCase();
// ═══════════════════════════════════════════════════════════
// PERSONAL YEAR ANALYSIS (Most Important - Weight: -4 to +4)
// ═══════════════════════════════════════════════════════════
if (personal.year === 1) {
// Year 1: New Beginnings, Independence, Leadership
if (desc.match(/\b(start|launch|begin|new|initiate|pioneer|first)\b/)) {
score += 4;
positive.push('Year 1 is THE perfect year for starting new ventures');
}
if (desc.match(/\b(business|company|venture)\b/)) {
score += 2;
positive.push('Year 1 supports new business initiatives');
}
if (desc.match(/\b(complete|finish|end|close|wrap)\b/)) {
score -= 3;
negative.push('Year 1 is for beginnings, not completions - wait for Year 9');
}
}
else if (personal.year === 2) {
// Year 2: Cooperation, Patience, Partnerships, Details
if (desc.match(/\b(partnership|collaborate|team|together)\b/)) {
score += 3;
positive.push('Year 2 is ideal for partnerships and collaboration');
}
if (desc.match(/\b(alone|independent|solo)\b/)) {
score -= 2;
negative.push('Year 2 favors cooperation over solo ventures');
}
}
else if (personal.year === 3) {
// Year 3: Expression, Creativity, Communication, Social
if (desc.match(/\b(write|create|content|blog|post|social|speak|present|communicate)\b/) || cat.includes('content')) {
score += 4;
positive.push('Year 3 is THE year for creative expression and communication');
}
if (desc.match(/\b(video|course|book|guide|resource)\b/)) {
score += 2;
positive.push('Year 3 energy supports creative content production');
}
}
else if (personal.year === 4) {
// Year 4: Hard Work, Foundation, Organization, Systems
if (desc.match(/\b(build|system|organize|foundation|structure|process)\b/)) {
score += 3;
positive.push('Year 4 is perfect for building solid foundations');
}
if (desc.match(/\b(automat|workflow|infrastructure)\b/) || cat.includes('technical')) {
score += 2;
positive.push('Year 4 supports systematic technical work');
}
if (desc.match(/\b(quick|fast|shortcut)\b/)) {
score -= 2;
negative.push('Year 4 requires patient, thorough work - no shortcuts');
}
}
else if (personal.year === 5) {
// Year 5: Change, Freedom, Variety, Adventure, Marketing
if (desc.match(/\b(change|pivot|explore|try|experiment|market|promote)\b/)) {
score += 3;
positive.push('Year 5 is ideal for change, exploration, and promotion');
}
if (desc.match(/\b(routine|stable|consistent|same)\b/)) {
score -= 2;
negative.push('Year 5 resists routine - embrace change and variety');
}
}
else if (personal.year === 6) {
// Year 6: Responsibility, Service, Family, Home, Teaching
if (desc.match(/\b(teach|help|serve|service|client|customer|family)\b/)) {
score += 3;
positive.push('Year 6 is perfect for service and teaching');
}
if (desc.match(/\b(business|revenue|profit|scale)\b/) && cat.includes('business')) {
score += 1;
neutral.push('Year 6 can bring business growth through service focus');
}
}
else if (personal.year === 7) {
// Year 7: Study, Introspection, Spirituality, Analysis, Rest
if (desc.match(/\b(study|learn|certification|research|analyze|spiritual|practice)\b/)) {
score += 4;
positive.push('Year 7 is THE perfect year for deep study and spiritual growth');
}
if (cat.includes('technical') && desc.match(/\b(practice|skill|learn)\b/)) {
score += 2;
positive.push('Year 7 supports technical skill development');
}
if (desc.match(/\b(launch|scale|promote|social|network)\b/)) {
score -= 3;
negative.push('Year 7 is introspective, not ideal for major external launches');
}
}
else if (personal.year === 8) {
// Year 8: Achievement, Power, Business, Money, Success
if (desc.match(/\b(business|scale|revenue|profit|money|financial|grow|expand)\b/) || cat.includes('business')) {
score += 4;
positive.push('Year 8 is THE power and achievement year - think BIG');
}
if (desc.match(/\b(reputation|authority|leader)\b/)) {
score += 2;
positive.push('Year 8 supports building authority and reputation');
}
if (desc.match(/\b(spiritual|rest|meditate)\b/)) {
score -= 2;
negative.push('Year 8 is for powerful action, not rest');
}
}
else if (personal.year === 9) {
// Year 9: Completion, Release, Endings, Letting Go
if (desc.match(/\b(complete|finish|publish|release|end|wrap|close)\b/)) {
score += 4;
positive.push('Year 9 is perfect for completing and releasing work');
}
if (desc.match(/\b(publish|share|give)\b/) && cat.includes('content')) {
score += 2;
positive.push('Year 9 supports releasing completed content');
}
if (desc.match(/\b(start|begin|new|launch|initiate)\b/)) {
score -= 4;
negative.push('Year 9 is for endings, NOT beginnings - wait for Year 1');
}
}
else if (personal.year === 11) {
// Year 11: Inspiration, Illumination, Intuition, Spiritual Leadership
if (desc.match(/\b(inspire|teach|illuminat|spiritual|intuition|channel|vision)\b/)) {
score += 4;
positive.push('Year 11 is for inspiring and illuminating others');
}
}
else if (personal.year === 22) {
// Year 22: Master Builder, Large-Scale Manifestation
if (desc.match(/\b(build|large|master|legacy|vision|manifest)\b/)) {
score += 4;
positive.push('Year 22 supports building large-scale, lasting legacies');
}
}
else if (personal.year === 33) {
// Year 33: Master Teacher, Healing, Compassionate Service
if (desc.match(/\b(teach|education|course|guide|help|serve|heal)\b/) || cat.includes('content')) {
score += 4;
positive.push('Year 33 is THE master teaching year - this goal is DESTINED');
}
if (desc.match(/\b(certification)\b/) && !desc.match(/\b(teach)\b/)) {
score -= 3;
negative.push('Year 33 is about teaching OTHERS, not personal certification');
}
if (desc.match(/\b(profit|money)\b/) && !desc.match(/\b(serv|help)\b/)) {
score -= 2;
negative.push('Year 33 emphasizes service over profit (abundance follows service)');
}
// Reframe profit goals as service goals
if (desc.match(/\b(business|scale)\b/) && desc.match(/\b(automat|help|serv)\b/)) {
score += 1;
neutral.push('Business growth aligned if focused on serving more people');
}
}
// ═══════════════════════════════════════════════════════════
// PERSONAL MONTH MODIFIERS (Weight: -2 to +2)
// ═══════════════════════════════════════════════════════════
if (personal.month === 1) {
if (desc.match(/\b(start|begin|initiate)\b/)) {
score += 1;
neutral.push('Month 1 adds extra "new beginnings" energy this month');
}
} else if (personal.month === 3) {
if (desc.match(/\b(content|write|create|communicate)\b/)) {
score += 1;
neutral.push('Month 3 boosts communication and creative expression');
}
} else if (personal.month === 7) {
if (desc.match(/\b(study|research|develop|prepare)\b/)) {
score += 1;
neutral.push('Month 7 supports private development and preparation');
}
if (desc.match(/\b(launch|publish|promote)\b/)) {
score -= 1;
neutral.push('Month 7 prefers private work over public launches');
}
} else if (personal.month === 8) {
if (desc.match(/\b(business|money|launch|scale)\b/)) {
score += 2;
neutral.push('Month 8 provides strong business and achievement energy');
}
} else if (personal.month === 9) {
if (desc.match(/\b(complete|finish|publish|release)\b/)) {
score += 1;
neutral.push('Month 9 supports completion and release');
}
}
// ═══════════════════════════════════════════════════════════
// CORE NUMBERS AMPLIFICATION (Weight: -1 to +2)
// ═══════════════════════════════════════════════════════════
// Life Path 11: Spiritual Teacher, Inspirer
if (coreNumbers.lifePath === 11) {
if (desc.match(/\b(teach|inspire|spiritual|illuminat|channel)\b/)) {
score += 2;
positive.push('Life Path 11 amplifies teaching and inspiration goals - this is your PURPOSE');
}
}
// Life Path 22: Master Builder
if (coreNumbers.lifePath === 22) {
if (desc.match(/\b(build|system|large|master|legacy)\b/)) {
score += 2;
positive.push('Life Path 22 amplifies building and manifestation goals');
}
}
// Expression 11: Natural Teacher/Inspirer
if (coreNumbers.expression === 11) {
if (desc.match(/\b(teach|educate|inspire|lead)\b/)) {
score += 1;
positive.push('Expression 11 makes you a natural teacher and inspirer');
}
}
// Soul Urge 7: Seeker of Truth
if (coreNumbers.soulUrge === 7) {
if (desc.match(/\b(spiritual|study|research|truth|deep|analyz)\b/)) {
score += 1;
positive.push('Soul Urge 7 deeply desires spiritual knowledge and truth');
}
}
// Soul Urge 8: Achievement and Power
if (coreNumbers.soulUrge === 8) {
if (desc.match(/\b(business|success|achieve|power|lead|financial)\b/)) {
score += 1;
positive.push('Soul Urge 8 craves achievement and success');
}
}
// Birthday 4: Practical Builder
if (coreNumbers.birthday === 4) {
if (desc.match(/\b(build|system|organize|structure|process)\b/)) {
score += 1;
positive.push('Birthday 4 gives natural talent for building systems');
}
}
// ═══════════════════════════════════════════════════════════
// CATEGORY-SPECIFIC ANALYSIS (Weight: +1 to +2)
// ═══════════════════════════════════════════════════════════
if (cat.includes('content') || cat.includes('education')) {
if (personal.year === 3 || personal.year === 33 || personal.year === 11) {
score += 2;
positive.push(`${cat} category perfectly aligned with Year ${personal.year} energy`);
}
}
if (cat.includes('business')) {
if (personal.year === 8 || personal.year === 1) {
score += 2;
positive.push('Business category aligns with current year energy');
}
if (personal.year === 7) {
score -= 1;
negative.push('Business growth difficult during introspective Year 7');
}
}
if (cat.includes('technical') || cat.includes('career')) {
if (personal.year === 7 && desc.match(/\b(learn|practice|skill)\b/)) {
score += 1;
positive.push('Technical skill development perfect for Year 7');
}
if (personal.year === 4) {
score += 1;
positive.push('Year 4 supports technical foundation building');
}
}
if (cat.includes('spiritual') || cat.includes('personal')) {
if (personal.year === 7 || personal.year === 11 || personal.year === 9) {
score += 1;
positive.push('Personal/spiritual development aligned with current year');
}
}
// ═══════════════════════════════════════════════════════════
// UNIVERSAL YEAR INFLUENCE (Minor Weight: +1)
// ═══════════════════════════════════════════════════════════
if (universal.year === 9) {
if (desc.match(/\b(complete|finish|release|end)\b/)) {
score += 1;
neutral.push('Universal Year 9 supports global completion energy');
}
}
// Clamp score to 1-10
score = Math.max(1, Math.min(10, score));
// Determine alignment
let alignment: GoalAnalysis['alignment'];
if (score >= 9) alignment = 'Perfect';
else if (score >= 7) alignment = 'Good';
else if (score >= 5) alignment = 'Moderate';
else if (score >= 3) alignment = 'Challenge';
else alignment = 'Poor';
// Generate recommendation
let recommendation = '';
if (score >= 8) {
recommendation = `🚀 HIGHEST PRIORITY - This goal is perfectly aligned with your current cycles. Commit deeply!`;
} else if (score >= 6) {
recommendation = `✅ GOOD TIMING - Proceed with this goal. Energy supports it.`;
} else if (score >= 4) {
recommendation = `⚠️ MODERATE FIT - Can pursue, but may require extra effort. Consider reframing or waiting.`;
} else {
recommendation = `❌ POOR TIMING - Strongly consider waiting for better cycles. Fighting upstream.`;
}
// Optimal timing
let optimalTiming = '';
if (desc.includes('certification') || desc.includes('study')) {
optimalTiming = personal.year === 7 ? 'NOW (Year 7)' : 'Personal Year 7 or Year 1 (for new beginnings)';
} else if (desc.includes('teach') || desc.includes('education')) {
optimalTiming = personal.year === 33 || personal.year === 11 ? 'NOW!' : 'Personal Year 3, 11, or 33';
} else if (desc.includes('business') || desc.includes('scale')) {
optimalTiming = personal.year === 8 || personal.year === 1 ? 'NOW (Year 8/1)' : 'Personal Year 1 or 8';
} else if (desc.includes('start') || desc.includes('begin')) {
optimalTiming = personal.year === 1 ? 'NOW (Year 1)' : 'Personal Year 1 (new beginnings)';
} else if (desc.includes('complete') || desc.includes('finish')) {
optimalTiming = personal.year === 9 ? 'NOW (Year 9)' : 'Personal Year 9 (completion)';
} else {
optimalTiming = 'Timing varies - see analysis';
}
return {
goal,
score,
alignment,
reasons: { positive, negative, neutral },
recommendation,
optimalTiming
};
}
// Main execution
async function main() {
console.log(`\n🎯 TELOS GOAL ALIGNMENT ANALYSIS\n`);
// Load goals
const goals = await parseTelosFile(telosFilePath);
const activeGoals = goals.filter(g => g.status === 'active');
// Calculate cycles and core numbers
const cycles = calculateCycles(birthdate);
const coreNumbers = calculateCoreNumbers(name, birthdate);
// Display current cycles
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`YOUR CURRENT CYCLES`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`Personal Year: ${cycles.personal.year}`);
console.log(`Personal Month: ${cycles.personal.month}`);
console.log(`Universal Year: ${cycles.universal.year}\n`);
console.log(`Core Numbers:`);
console.log(` Life Path: ${coreNumbers.lifePath}`);
console.log(` Expression: ${coreNumbers.expression}`);
console.log(` Soul Urge: ${coreNumbers.soulUrge}`);
console.log(` Birthday: ${coreNumbers.birthday}\n`);
// Analyze all active goals
const analyses: GoalAnalysis[] = [];
for (const goal of activeGoals) {
const analysis = analyzeGoalAlignment(goal, cycles, coreNumbers);
analyses.push(analysis);
}
// Sort by score (descending)
analyses.sort((a, b) => b.score - a.score);
// Group by category
const byCategory: Record<string, GoalAnalysis[]> = {};
analyses.forEach(a => {
if (!byCategory[a.goal.category]) byCategory[a.goal.category] = [];
byCategory[a.goal.category].push(a);
});
// Output analysis by category
for (const [category, categoryGoals] of Object.entries(byCategory)) {
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`${category.toUpperCase()} GOALS ANALYSIS`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
for (const analysis of categoryGoals) {
const { goal, score, alignment, reasons, recommendation, optimalTiming } = analysis;
console.log(`${goal.id}: ${goal.description}`);
console.log(`┌─────────────────────────────────────┐`);
console.log(`│ ALIGNMENT: ${getAlignmentEmoji(alignment)} ${alignment.toUpperCase().padEnd(20)} │`);
console.log(`│ SCORE: ${score}/10${' '.repeat(28)} │`);
console.log(`└─────────────────────────────────────┘\n`);
console.log(`ANALYSIS:`);
if (reasons.positive.length > 0) {
reasons.positive.forEach(r => console.log(`✅ ${r}`));
}
if (reasons.negative.length > 0) {
reasons.negative.forEach(r => console.log(`❌ ${r}`));
}
if (reasons.neutral.length > 0) {
reasons.neutral.forEach(r => console.log(`ℹ️ ${r}`));
}
console.log(`\nRECOMMENDATION:`);
console.log(`${recommendation}\n`);
console.log(`OPTIMAL TIMING: ${optimalTiming}\n`);
console.log(`─────────────────────────────────────────────────────────\n`);
}
}
// Priority ranking
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`GOAL PRIORITIZATION (BY ALIGNMENT SCORE)`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const topPriority = analyses.filter(a => a.score >= 8);
const mediumPriority = analyses.filter(a => a.score >= 5 && a.score < 8);
const lowPriority = analyses.filter(a => a.score < 5);
if (topPriority.length > 0) {
console.log(`🥇 TOP PRIORITY (Perfect/Good Alignment - Score 8-10):\n`);
topPriority.forEach((a, i) => {
console.log(`${i + 1}. ${a.goal.id}: ${a.goal.description} (${a.score}/10)`);
});
console.log('');
}
if (mediumPriority.length > 0) {
console.log(`🥈 MEDIUM PRIORITY (Moderate Alignment - Score 5-7):\n`);
mediumPriority.forEach((a, i) => {
console.log(`${i + 1}. ${a.goal.id}: ${a.goal.description} (${a.score}/10)`);
});
console.log('');
}
if (lowPriority.length > 0) {
console.log(`🥉 LOW PRIORITY (Poor Timing - Score 1-4):\n`);
lowPriority.forEach((a, i) => {
console.log(`${i + 1}. ${a.goal.id}: ${a.goal.description} (${a.score}/10 - wait for better timing)`);
});
console.log('');
}
// Year-specific strategic advice
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`STRATEGIC GUIDANCE FOR YEAR ${cycles.personal.year}`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
if (cycles.personal.year === 9) {
console.log(`🎯 YEAR 9 STRATEGY: Completion & Release\n`);
console.log(`DO:`);
console.log(`• Complete all pending projects before December`);
console.log(`• Release/publish finished work`);
console.log(`• Let go of goals that no longer resonate`);
console.log(`• Document lessons from past 9 years\n`);
console.log(`DON'T:`);
console.log(`• Start major new ventures (wait for Year 1 next year)`);
console.log(`• Make long-term commitments`);
console.log(`• Cling to what's finished\n`);
} else if (cycles.personal.year === 1) {
console.log(`🎯 YEAR 1 STRATEGY: New Beginnings\n`);
console.log(`DO:`);
console.log(`• Start new projects boldly`);
console.log(`• Take independent initiative`);
console.log(`• Plant seeds for 9-year cycle`);
console.log(`• Break free from past patterns\n`);
console.log(`DON'T:`);
console.log(`• Wait for perfect conditions`);
console.log(`• Depend too heavily on others`);
console.log(`• Play small\n`);
} else if (cycles.personal.year === 33) {
console.log(`🎯 YEAR 33 STRATEGY: Master Teaching & Service\n`);
console.log(`📖 MASTER NUMBER CONTEXT:`);
console.log(`Year 33 is a higher vibration of Year 6 (Service/Responsibility).`);
console.log(`You experience BOTH energies: 6's grounded service + 33's master healing.\n`);
console.log(`DO:`);
console.log(`• Teach and share your wisdom generously`);
console.log(`• Serve from overflow (self-care first)`);
console.log(`• Focus on impact over income`);
console.log(`• Lead with compassion and love`);
console.log(`• Take on responsibility (Year 6) but at a master level (33)\n`);
console.log(`DON'T:`);
console.log(`• Pursue goals purely for profit`);
console.log(`• Neglect self-care (burnout risk)`);
console.log(`• Try to save everyone (boundaries!)\n`);
} else if (cycles.personal.year === 11) {
console.log(`🎯 YEAR 11 STRATEGY: Inspiration & Illumination\n`);
console.log(`📖 MASTER NUMBER CONTEXT:`);
console.log(`Year 11 is a higher vibration of Year 2 (Cooperation/Intuition).`);
console.log(`You experience BOTH energies: 2's sensitivity + 11's spiritual leadership.\n`);
console.log(`DO:`);
console.log(`• Channel higher wisdom and share insights`);
console.log(`• Trust your intuition completely`);
console.log(`• Inspire others through your vision`);
console.log(`• Collaborate spiritually (Year 2 + 11 energy)\n`);
console.log(`DON'T:`);
console.log(`• Ignore your heightened sensitivity`);
console.log(`• Play small with your spiritual gifts`);
console.log(`• Doubt your intuitive hits\n`);
} else if (cycles.personal.year === 22) {
console.log(`🎯 YEAR 22 STRATEGY: Master Building\n`);
console.log(`📖 MASTER NUMBER CONTEXT:`);
console.log(`Year 22 is a higher vibration of Year 4 (Foundation/Structure).`);
console.log(`You experience BOTH energies: 4's practical building + 22's visionary manifestation.\n`);
console.log(`DO:`);
console.log(`• Build large-scale, lasting legacies`);
console.log(`• Manifest ambitious visions into reality`);
console.log(`• Combine practical work (4) with master vision (22)`);
console.log(`• Think in terms of decades, not years\n`);
console.log(`DON'T:`);
console.log(`• Think small - this is master builder energy`);
console.log(`• Rush the foundation work`);
console.log(`• Lose faith in your grand vision\n`);
}
// ═══════════════════════════════════════════════════════════════
// QUARTERLY ACTION PLAN (Rest of current year)
// ═══════════════════════════════════════════════════════════════
const today = new Date();
const currentMonth = today.getMonth() + 1; // 1-12
const currentYear = today.getFullYear();
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`QUARTERLY ACTION PLAN (REST OF ${currentYear})`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
// Calculate Personal Months for rest of year
const monthsRemaining = [];
for (let month = currentMonth; month <= 12; month++) {
const date = new Date(currentYear, month - 1, 1);
const monthStr = date.toLocaleDateString('en-US', { month: 'long' });
const personalMonthCycles = calculateCycles(birthdate, `${month}/15/${currentYear}`);
monthsRemaining.push({ month: monthStr, number: month, cycles: personalMonthCycles });
}
for (const { month, number, cycles: monthCycles } of monthsRemaining) {
console.log(`📅 ${month.toUpperCase()} ${currentYear} (Personal Month ${monthCycles.personal.month})`);
console.log(`───────────────────────────────────────────────────────\n`);
// Month-specific guidance
const pMonth = monthCycles.personal.month;
if (pMonth === 1) {
console.log(`🌱 THEME: New Beginnings`);
console.log(`FOCUS: Start fresh projects, take initiative, be bold`);
console.log(`BEST FOR: Launching, first steps, independence\n`);
} else if (pMonth === 2) {
console.log(`🤝 THEME: Cooperation & Patience`);
console.log(`FOCUS: Partnerships, details, diplomacy, patience`);
console.log(`BEST FOR: Collaboration, relationship building, refinement\n`);
} else if (pMonth === 3) {
console.log(`🎨 THEME: Expression & Communication`);
console.log(`FOCUS: Create content, communicate, socialize`);
console.log(`BEST FOR: Writing, presenting, creative work, networking\n`);
} else if (pMonth === 4) {
console.log(`🏗️ THEME: Foundation & Hard Work`);
console.log(`FOCUS: Build systems, organize, work diligently`);
console.log(`BEST FOR: Infrastructure, processes, detail work\n`);
} else if (pMonth === 5) {
console.log(`🔄 THEME: Change & Freedom`);
console.log(`FOCUS: Embrace change, promote, experiment`);
console.log(`BEST FOR: Pivots, marketing, trying new approaches\n`);
} else if (pMonth === 6) {
console.log(`💚 THEME: Service & Responsibility`);
console.log(`FOCUS: Serve clients, teach, take responsibility`);
console.log(`BEST FOR: Client work, teaching, family/home focus\n`);
} else if (pMonth === 7) {
console.log(`🧘 THEME: Introspection & Study`);
console.log(`FOCUS: Develop privately, study, rest, analyze`);
console.log(`BEST FOR: Content development, learning, spiritual work\n`);
} else if (pMonth === 8) {
console.log(`💼 THEME: Achievement & Power`);
console.log(`FOCUS: Business action, launch, scale, financial moves`);
console.log(`BEST FOR: Big launches, promotions, business deals\n`);
} else if (pMonth === 9) {
console.log(`🎁 THEME: Completion & Release`);
console.log(`FOCUS: Finish projects, publish, let go`);
console.log(`BEST FOR: Completing work, releasing products, clearing clutter\n`);
}
// Recommend top goals for this month
const monthlyTopGoals = analyses
.filter(a => {
const desc = a.goal.description.toLowerCase();
// Match month energy to goals
if (pMonth === 1 && desc.match(/\b(start|launch|begin)\b/)) return true;
if (pMonth === 3 && desc.match(/\b(content|write|create|communicate)\b/)) return true;
if (pMonth === 7 && desc.match(/\b(develop|study|prepare|learn)\b/)) return true;
if (pMonth === 8 && desc.match(/\b(business|scale|launch|promote)\b/)) return true;
if (pMonth === 9 && desc.match(/\b(complete|finish|publish|release)\b/)) return true;
return a.score >= 8; // Always include high-scoring goals
})
.slice(0, 3);
if (monthlyTopGoals.length > 0) {
console.log(`🎯 RECOMMENDED GOALS THIS MONTH:`);
monthlyTopGoals.forEach(a => {
console.log(` • ${a.goal.id}: ${a.goal.description}`);
});
console.log('');
}
}
// ═══════════════════════════════════════════════════════════════
// NEXT YEAR PREVIEW
// ═══════════════════════════════════════════════════════════════
console.log(`═══════════════════════════════════════════════════════════════`);
// Calculate next Personal Year (handle master numbers correctly)
let nextYearNumber: number;
if (cycles.personal.year === 9) {
nextYearNumber = 1;
} else if (cycles.personal.year === 11) {
nextYearNumber = 3; // 11 → 3 (2+1=3, but 11 base is 2, so 2+1=3)
} else if (cycles.personal.year === 22) {
nextYearNumber = 5; // 22 → 5 (4+1=5)
} else if (cycles.personal.year === 33) {
nextYearNumber = 7; // 33 → 7 (6+1=7)
} else {
nextYearNumber = cycles.personal.year + 1;
}
console.log(`${currentYear + 1} PREVIEW (Personal Year ${nextYearNumber})`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const nextYear = nextYearNumber;
if (nextYear === 1) {
console.log(`🚀 NEW 9-YEAR CYCLE BEGINS!\n`);
console.log(`MAJOR THEME: Fresh starts, new ventures, independence, leadership\n`);
console.log(`PERFECT FOR:`);
console.log(`✅ Starting new businesses or ventures`);
console.log(`✅ Launching new products/services`);
console.log(`✅ Beginning certifications or new skills`);
console.log(`✅ Career pivots or job changes`);
console.log(`✅ Moving to new location`);
console.log(`✅ New relationships or partnerships\n`);
console.log(`PREPARE NOW (while in Year ${cycles.personal.year}):`);
console.log(`• Complete all pending projects by December`);
console.log(`• Clear space mentally and physically`);
console.log(`• Research what you want to start`);
console.log(`• Build energy reserves for bold action\n`);
} else if (nextYear === 2) {
console.log(`🤝 COOPERATION & PATIENCE YEAR\n`);
console.log(`MAJOR THEME: Partnerships, collaboration, details, diplomacy\n`);
console.log(`PERFECT FOR:`);
console.log(`✅ Building partnerships and alliances`);
console.log(`✅ Detail-oriented work`);
console.log(`✅ Relationship development`);
console.log(`✅ Team projects and collaboration\n`);
} else if (nextYear === 3) {
console.log(`🎨 EXPRESSION & CREATIVITY YEAR\n`);
console.log(`MAJOR THEME: Communication, creativity, social expansion\n`);
console.log(`PERFECT FOR:`);
console.log(`✅ Content creation (blogs, videos, courses)`);
console.log(`✅ Public speaking and presentations`);
console.log(`✅ Social media and networking`);
console.log(`✅ Creative projects and artistic expression\n`);
} else if (nextYear === 7) {
console.log(`🧘 INTROSPECTION & STUDY YEAR\n`);
console.log(`MAJOR THEME: Deep study, spiritual growth, rest, analysis\n`);
console.log(`PERFECT FOR:`);
console.log(`✅ Certifications and deep learning`);
console.log(`✅ Spiritual practice and development`);
console.log(`✅ Research and analysis projects`);
console.log(`✅ Rest and rejuvenation\n`);
} else if (nextYear === 8) {
console.log(`💼 POWER & ACHIEVEMENT YEAR\n`);
console.log(`MAJOR THEME: Business success, financial growth, authority\n`);
console.log(`PERFECT FOR:`);
console.log(`✅ Scaling businesses aggressively`);
console.log(`✅ Major financial moves`);
console.log(`✅ Building authority and reputation`);
console.log(`✅ Leadership roles and promotions\n`);
} else if (nextYear === 33) {
console.log(`🙏 MASTER TEACHING YEAR (Higher vibration of 6)\n`);
console.log(`MAJOR THEME: Teaching, healing, compassionate service at master level\n`);
console.log(`PERFECT FOR:`);
console.log(`✅ Teaching and education programs`);
console.log(`✅ Healing work and service`);
console.log(`✅ Compassionate leadership`);
console.log(`✅ Impact-focused business growth\n`);
}
console.log(`✨ Generated with Telos-Cycles Alignment Analyzer`);
}
function getAlignmentEmoji(alignment: string): string {
const emojis: Record<string, string> = {
'Perfect': '✅',
'Good': '👍',
'Moderate': '⚠️ ',
'Challenge': '⚠️ ',
'Poor': '❌'
};
return emojis[alignment] || '•';
}
main().catch(console.error);

181
telos-export.ts Executable file
View file

@ -0,0 +1,181 @@
#!/usr/bin/env bun
/**
* Telos Numerology Exporter
*
* Generates numerology profile for telos integration
* Output format matches ~/.claude/context/personal/telos/numerology.md template
*
* Usage:
* bun telos-export.ts --name "Your Name" --birthdate "mm/dd/yyyy" > ~/.claude/context/personal/telos/numerology.md
*/
import { calculate } from './numerology';
import { lifePath, expression, soulUrge, birthday } from './meanings';
function generateTelosFormat(name: string, birthdate: string): string {
const result = calculate(name, birthdate, true); // Silent mode
let output = `# Numerology Profile\n\n`;
output += `**Generated:** ${new Date().toISOString().split('T')[0]}\n\n`;
output += `**Name:** ${name} \n`;
output += `**Birthdate:** ${birthdate}\n\n`;
output += `---\n\n`;
output += `## Core Numbers\n\n`;
output += `| Number | Value | Keywords |\n`;
output += `|--------|-------|----------|\n`;
output += `| Life Path | ${result.lifePath} | ${lifePath[result.lifePath].keywords.join(', ')} |\n`;
output += `| Expression | ${result.expression} | ${expression[result.expression].keywords.join(', ')} |\n`;
output += `| Soul Urge | ${result.soulUrge} | ${soulUrge[result.soulUrge].keywords.join(', ')} |\n`;
output += `| Birthday | ${result.birthday} | ${birthday[result.birthday].keywords.join(', ')} |\n\n`;
output += `---\n\n`;
// Life Path
const lp = lifePath[result.lifePath];
output += `## Life Path ${result.lifePath}\n\n`;
output += `> *${lp.keywords.join(' • ')}*\n\n`;
output += `${lp.description}\n\n`;
output += `### Strengths\n`;
lp.strengths.forEach(s => output += `- ${s}\n`);
output += `\n### Challenges\n`;
lp.challenges.forEach(c => output += `- ${c}\n`);
if (lp.lifePurpose) {
output += `\n### Life Purpose\n`;
output += `${lp.lifePurpose}\n`;
}
if (lp.careerPaths && lp.careerPaths.length > 0) {
output += `\n### Career Paths\n`;
lp.careerPaths.forEach(c => output += `- ${c}\n`);
}
if (lp.relationships) {
output += `\n### Relationships\n`;
output += `${lp.relationships}\n`;
}
if (lp.spiritualLesson) {
output += `\n### Spiritual Lesson\n`;
output += `${lp.spiritualLesson}\n`;
}
output += `\n---\n\n`;
// Expression
const ex = expression[result.expression];
output += `## Expression ${result.expression}\n\n`;
output += `> *${ex.keywords.join(' • ')}*\n\n`;
output += `${ex.description}\n\n`;
output += `### Strengths\n`;
ex.strengths.forEach(s => output += `- ${s}\n`);
output += `\n### Challenges\n`;
ex.challenges.forEach(c => output += `- ${c}\n`);
output += `\n---\n\n`;
// Soul Urge
const su = soulUrge[result.soulUrge];
output += `## Soul Urge ${result.soulUrge}\n\n`;
output += `> *${su.keywords.join(' • ')}*\n\n`;
output += `${su.description}\n\n`;
output += `### Strengths\n`;
su.strengths.forEach(s => output += `- ${s}\n`);
output += `\n### Challenges\n`;
su.challenges.forEach(c => output += `- ${c}\n`);
output += `\n---\n\n`;
// Birthday
const bd = birthday[result.birthday];
output += `## Birthday ${result.birthday}\n\n`;
output += `> *${bd.keywords.join(' • ')}*\n\n`;
output += `${bd.description}\n\n`;
output += `### Strengths\n`;
bd.strengths.forEach(s => output += `- ${s}\n`);
output += `\n### Challenges\n`;
bd.challenges.forEach(c => output += `- ${c}\n`);
output += `\n---\n\n`;
output += `## Telos Integration\n\n`;
output += `### How This Relates to Your Goals\n\n`;
output += `Use the numerology insights above to:\n\n`;
output += `- **Align goals with your Life Path** - Ensure major goals match your core purpose\n`;
output += `- **Leverage your Expression strengths** - Use natural talents in projects\n`;
output += `- **Honor your Soul Urge** - Make sure goals satisfy inner desires\n`;
output += `- **Utilize Birthday gifts** - Apply special talents to overcome challenges\n\n`;
output += `### Current Life Path Alignment Check\n\n`;
output += `Review your telos goals and ask:\n\n`;
output += `1. Do my goals align with my Life Path ${result.lifePath} purpose?\n`;
output += `2. Am I leveraging my Expression ${result.expression} talents?\n`;
output += `3. Are my pursuits satisfying my Soul Urge ${result.soulUrge} desires?\n`;
output += `4. Am I using my Birthday ${result.birthday} gifts to their full potential?\n\n`;
output += `### Numerology-Based Recommendations\n\n`;
if (lp.careerPaths && lp.careerPaths.length > 0) {
output += `**Career Alignment:** Your Life Path ${result.lifePath} suggests careers in: ${lp.careerPaths.join(', ')}\n\n`;
}
output += `**Challenge Awareness:** Watch for ${lp.challenges[0].toLowerCase()} - this is your primary numerological challenge.\n\n`;
output += `**Spiritual Growth:** ${lp.spiritualLesson}\n\n`;
output += `---\n\n`;
output += `*This numerology profile is generated to enhance your telos self-understanding. Use it as one lens among many to understand yourself and your path.*\n`;
return output;
}
function main() {
const args = process.argv.slice(2);
let name = '';
let birthdate = '';
for (let i = 0; i < args.length; i++) {
if (args[i] === '--name' && args[i + 1]) {
name = args[i + 1];
i++;
} else if (args[i] === '--birthdate' && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Telos Numerology Exporter
Generates numerology profile formatted for telos integration.
Usage:
bun telos-export.ts --name "Full Name" --birthdate "mm/dd/yyyy"
Output to file:
bun telos-export.ts --name "Your Name" --birthdate "5/13/1982" > ~/.claude/context/personal/telos/numerology.md
Options:
--name NAME Full name (required)
--birthdate DATE Birthdate in mm/dd/yyyy format (required)
--help, -h Show this help message
`);
process.exit(0);
}
}
if (!name || !birthdate) {
console.error('Error: Both --name and --birthdate are required');
console.error('Use --help for usage information');
process.exit(1);
}
try {
const output = generateTelosFormat(name, birthdate);
console.log(output);
} catch (error) {
console.error(`Error: ${error instanceof Error ? error.message : String(error)}`);
process.exit(1);
}
}
if (import.meta.main) {
main();
}
export { generateTelosFormat };

439
telos-week.ts Executable file
View file

@ -0,0 +1,439 @@
#!/usr/bin/env bun
/**
* Telos Weekly Planner
*
* Combines Personal Day cycles with Telos goals to create weekly action plan.
* Shows which telos goals align with each day's energy.
*
* Usage:
* bun telos-week.ts --birthdate "5/13/1982" --name "Your Name"
* bun telos-week.ts --birthdate "5/13/1982" --name "Your Name" --start-date "10/14/2025"
* bun telos-week.ts --birthdate "5/13/1982" --name "Your Name" --telos-file ~/path/to/telos.md
*
* Default telos file: ~/.claude/context/personal/telos/telos.md
*/
import { calculateCycles } from './cycles';
import { personalDay as personalDayMeanings } from './cycle-meanings';
import { loadProfile } from './profile-manager';
// Parse command line arguments
const args = process.argv.slice(2);
let birthdate = '';
let name = '';
let profileId = '';
let startDate = '';
let telosFilePath = `${process.env.HOME}/.claude/context/personal/telos/telos.md`;
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if ((args[i] === '--start-date' || args[i] === '-s') && args[i + 1]) {
startDate = args[i + 1];
i++;
} else if ((args[i] === '--telos-file' || args[i] === '-t') && args[i + 1]) {
telosFilePath = args[i + 1];
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Telos Weekly Planner - Align your goals with daily energy cycles
USAGE:
bun telos-week.ts --profile <id>
bun telos-week.ts --birthdate "mm/dd/yyyy" --name "Your Name"
OPTIONS:
-p, --profile Use saved profile
-b, --birthdate Your birthdate (mm/dd/yyyy) [required if no profile]
-n, --name Your name (for personalization) [required if no profile]
-s, --start-date Start date (mm/dd/yyyy) [default: today]
-t, --telos-file Path to telos.md file [default: ~/.claude/context/personal/telos/telos.md]
-h, --help Show this help message
EXAMPLES:
# With profile
bun telos-week.ts --profile rob
bun telos-week.ts --profile rob -s "10/14/2025"
# With name/birthdate
bun telos-week.ts -b "5/13/1982" -n "John"
bun telos-week.ts -b "5/13/1982" -n "John" -s "10/14/2025"
bun telos-week.ts -b "5/13/1982" -n "John" -t ~/my-telos.md
`);
process.exit(0);
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
name = profile.name;
birthdate = profile.birthdate;
}
if (!birthdate || !name) {
console.error('Error: --birthdate and --name are required (or use --profile)');
console.error('Try: bun telos-week.ts --help');
process.exit(1);
}
// Load and parse telos file
interface TelosGoal {
id: string;
description: string;
category: string;
status?: string;
}
async function parseTelosFile(filePath: string): Promise<TelosGoal[]> {
try {
const file = Bun.file(filePath);
const content = await file.text();
const goals: TelosGoal[] = [];
let currentCategory = '';
const lines = content.split('\n');
for (let i = 0; i < lines.length; i++) {
const line = lines[i].trim();
// Detect category headers
if (line.match(/^(Career|Business|Personal|Technical|Content|Spiritual|Expression)/)) {
currentCategory = line.replace(/^#*\s*/, '').replace(/\s*-.*$/, '');
}
// Parse goal lines
const goalMatch = line.match(/^-\s+(G[A-Z]*\d+):\s*(.+)/);
if (goalMatch && currentCategory) {
const [, id, description] = goalMatch;
const status = description.includes('✅') ? 'achieved' :
description.includes('Back burner') ? 'backburner' :
description.includes('Future goal') ? 'future' : 'active';
let cleanDesc = description
.replace(/✅\s*ACHIEVED\s*-?\s*/gi, '')
.replace(/✅\s*ONGOING\s*-?\s*/gi, '')
.replace(/✅\s*EXCEEDED\s*-?\s*/gi, '')
.replace(/\(.*?\)/g, '')
.replace(/Back burner/gi, '')
.replace(/Future goal/gi, '')
.trim();
goals.push({
id,
description: cleanDesc,
category: currentCategory,
status
});
}
}
return goals;
} catch (error) {
console.error(`Error reading telos file: ${error}`);
return [];
}
}
// Format date as mm/dd/yyyy
function formatDate(date: Date): string {
const month = (date.getMonth() + 1).toString().padStart(2, '0');
const day = date.getDate().toString().padStart(2, '0');
const year = date.getFullYear();
return `${month}/${day}/${year}`;
}
// Get day name (short)
function getDayName(date: Date): string {
return date.toLocaleDateString('en-US', { weekday: 'short' });
}
// Get month name (short)
function getMonthName(date: Date): string {
return date.toLocaleDateString('en-US', { month: 'short' });
}
// Get best activities for Personal Day
function getBestActivities(personalDay: number): string {
const activities: Record<number, string> = {
1: 'Starting new projects, taking initiative, independence',
2: 'Collaboration, details, patience, partnerships',
3: 'Content creation, communication, socializing',
4: 'Organizing, building systems, hard work',
5: 'Trying new things, flexibility, exploration',
6: 'Client/family focus, service, responsibility',
7: 'Research, deep study, spiritual practice, rest',
8: 'Business planning, financial matters, achievement',
9: 'Finishing projects, clearing clutter, completion',
11: 'Inspiring others, intuitive work, spiritual teaching',
22: 'Large-scale building, manifesting visions, legacy work',
33: 'Teaching, healing, compassionate service'
};
return activities[personalDay] || activities[personalDay % 11] || 'General activities';
}
// Match goals to Personal Day energy (simplified)
function matchGoalsToDay(personalDay: number, goals: TelosGoal[]): string[] {
const matched: string[] = [];
// Day-specific matching
const patterns: Record<number, string[]> = {
1: ['start', 'launch', 'begin', 'new'],
2: ['partner', 'collaboration', 'team', 'detail'],
3: ['content', 'blog', 'video', 'education', 'speaking', 'write'],
4: ['build', 'system', 'infrastructure', 'organize'],
5: ['learn', 'explore', 'new', 'practice'],
6: ['client', 'help', 'service', 'teaching', 'education'],
7: ['study', 'certification', 'research', 'spiritual'],
8: ['scale', 'revenue', 'business', 'profitability'],
9: ['finish', 'complete', 'publish'],
11: ['inspire', 'teach', 'spiritual', 'intuitive'],
22: ['build', 'scale', 'infrastructure', 'legacy'],
33: ['teach', 'education', 'service', 'heal']
};
const dayPatterns = patterns[personalDay] || [];
goals.forEach(g => {
if (g.status !== 'active') return;
const desc = g.description.toLowerCase();
const cat = g.category.toLowerCase();
for (const pattern of dayPatterns) {
if (desc.includes(pattern) || cat.includes(pattern)) {
matched.push(`${g.id}: ${g.description.substring(0, 60)}${g.description.length > 60 ? '...' : ''}`);
return; // Only match once
}
}
});
return matched.slice(0, 3); // Max 3 goals per day
}
// Get avoid activities
function getAvoidActivities(personalDay: number): string {
const avoid: Record<number, string> = {
1: 'Depending on others, waiting for permission',
2: 'Rushing, going solo, hasty decisions',
3: 'Deep analytical work, heavy organizing',
4: 'Scattered creative work, starting new things',
5: 'Long-term commitments, rigid plans',
6: 'Self-focused work, ignoring commitments',
7: 'Networking events, major launches, sales calls',
8: 'Being passive, rest days',
9: 'Starting new projects, major commitments',
11: 'Ignoring intuition, suppressing sensitivity',
22: 'Small thinking, self-sabotage',
33: 'Martyrdom, neglecting self-care'
};
return avoid[personalDay] || avoid[personalDay % 11] || '';
}
// Main execution
async function main() {
// Load telos goals
const goals = await parseTelosFile(telosFilePath);
const activeGoals = goals.filter(g => g.status === 'active');
// Determine start date (today by default)
let start: Date;
if (startDate) {
const parts = startDate.split('/');
start = new Date(parseInt(parts[2]), parseInt(parts[0]) - 1, parseInt(parts[1]));
} else {
start = new Date();
}
// Get cycles for 7 days
const weekDays = [];
for (let i = 0; i < 7; i++) {
const date = new Date(start);
date.setDate(start.getDate() + i);
const dateStr = formatDate(date);
const cycles = calculateCycles(birthdate, dateStr);
weekDays.push({ date, dateStr, cycles });
}
// Calculate Personal Year and Month
const todayCycles = calculateCycles(birthdate);
const personalYear = todayCycles.personal.year;
const personalMonth = todayCycles.personal.month;
// Get meanings
const yearMeanings: Record<number, string> = {
1: 'New Beginnings', 2: 'Patience & Cooperation', 3: 'Expression & Creativity',
4: 'Hard Work & Foundation', 5: 'Change & Freedom', 6: 'Responsibility & Service',
7: 'Introspection & Spirituality', 8: 'Achievement & Power', 9: 'Completion & Release',
11: 'Inspiration & Illumination', 22: 'Master Building', 33: 'Master Teaching'
};
const monthMeanings: Record<number, string> = {
1: 'Initiation', 2: 'Patience', 3: 'Expression', 4: 'Work',
5: 'Change', 6: 'Responsibility', 7: 'Introspection', 8: 'Achievement', 9: 'Completion'
};
// Output header
const startFormatted = `${getMonthName(start)} ${start.getDate()}`;
const endDate = new Date(start);
endDate.setDate(start.getDate() + 6);
const endFormatted = `${getMonthName(endDate)} ${endDate.getDate()}, ${endDate.getFullYear()}`;
console.log(`\n📅 YOUR WEEK: ${startFormatted}-${endFormatted}\n`);
console.log(`Personal Year ${personalYear} (${yearMeanings[personalYear]}) + Month ${personalMonth} (${monthMeanings[personalMonth]})`);
// Contextual theme
if (personalYear === 9 && personalMonth === 1) {
console.log(`→ Theme: Completing major cycles while initiating final projects`);
console.log(` (Year 9 wants to finish/release, Month 1 brings fresh energy)`);
} else if (personalYear === 33) {
console.log(`→ Theme: Master teaching year - share wisdom through service, not profit`);
console.log(` (Focus on teaching/healing - abundance follows service)`);
} else if (personalYear === 1) {
console.log(`→ Theme: Fresh starts - plant seeds for the next 9-year cycle`);
} else {
console.log(`→ Theme: Year ${personalYear} energy expressed through Month ${personalMonth} focus`);
}
console.log(`\n📊 Active Goals: ${activeGoals.length} | Telos file: ${telosFilePath.replace(process.env.HOME || '', '~')}\n`);
// Output each day
for (const { date, cycles } of weekDays) {
const dayName = getDayName(date);
const dayNum = date.getDate();
const personalDay = cycles.personal.day;
// Get meaning keywords
const meaningText = personalDayMeanings[personalDay];
const meaningMatch = meaningText?.match(/^([^.]+)/);
const keywords = meaningMatch ? meaningMatch[1].replace(' day', '') : `Day ${personalDay}`;
// Match goals
const matchedGoals = matchGoalsToDay(personalDay, goals);
const bestFor = getBestActivities(personalDay);
const avoid = getAvoidActivities(personalDay);
console.log(`─────────────────────────────────────────────────────────`);
console.log(`${dayName} ${getMonthName(date)} ${dayNum} - Personal Day ${personalDay} (${keywords})`);
console.log(` ✅ Best for: ${bestFor}`);
if (matchedGoals.length > 0) {
console.log(` 🎯 Telos:`);
matchedGoals.forEach(goal => console.log(` • ${goal}`));
} else {
// Provide category-level guidance when no specific match
const categoryGuidance: Record<number, string> = {
3: 'Content creation goals, communication, public speaking',
7: 'Study/certification goals, spiritual practice',
8: 'Business scaling goals, financial planning',
1: 'New project launches, initiating goals',
6: 'Client service goals, teaching, helping others',
4: 'Infrastructure/system building goals',
5: 'Learning/exploration goals, trying new approaches',
9: 'Completing pending projects, publishing finished work',
11: 'Inspiring/teaching goals, intuitive projects',
22: 'Large-scale building, legacy projects',
33: 'Education/teaching goals, healing/service work'
};
const guidance = categoryGuidance[personalDay] || 'Work on any active goals with appropriate energy';
console.log(` 💡 Guidance: Good day for ${guidance}`);
}
if (avoid) {
console.log(` ⚠️ Avoid: ${avoid}`);
}
console.log('');
}
console.log(`─────────────────────────────────────────────────────────`);
// Weekly Summary
console.log(`\n📊 WEEKLY SUMMARY\n`);
console.log(`Personal Year ${personalYear} + Month ${personalMonth}`);
// Weekly Theme based on Year/Month
console.log(`\n🎯 WEEKLY THEME:`);
if (personalYear === 9 && personalMonth === 1) {
console.log(`You're completing a 9-year cycle (endings/teaching) while Month 1 brings`);
console.log(`fresh initiative energy. Focus on finishing major projects while preparing`);
console.log(`seeds for your new cycle starting in ${new Date().getFullYear() + 1}.`);
} else if (personalYear === 33) {
console.log(`Master Teacher year - your purpose this year is to uplift and heal through`);
console.log(`teaching and service. Focus on sharing wisdom, not accumulating wealth.`);
console.log(`Abundance flows naturally when you serve from overflow.`);
} else if (personalYear === 1) {
console.log(`New 9-year cycle begins! This week sets the tone for the next 9 years.`);
console.log(`Be bold, take initiative, plant seeds you want to harvest over this cycle.`);
} else if (personalYear === 8) {
console.log(`Power and achievement year. This week offers opportunities for business`);
console.log(`growth, financial gains, and stepping into leadership roles.`);
} else {
console.log(`Year ${personalYear} energy (${yearMeanings[personalYear]}) flowing through Month ${personalMonth}.`);
console.log(`Balance your yearly theme with monthly focus for optimal results.`);
}
// Key Opportunities
console.log(`\n🌟 KEY OPPORTUNITIES THIS WEEK:`);
const opportunityDays = weekDays.filter(d => [1, 3, 8, 11, 22, 33].includes(d.cycles.personal.day));
if (opportunityDays.length > 0) {
opportunityDays.forEach(d => {
const day = d.cycles.personal.day;
const opportunities: Record<number, string> = {
1: `${getDayName(d.date)} (Day 1): New beginnings - start important projects`,
3: `${getDayName(d.date)} (Day 3): Expression - create content, communicate ideas`,
8: `${getDayName(d.date)} (Day 8): Achievement - business deals, financial planning`,
11: `${getDayName(d.date)} (Day 11): Inspiration - channel higher wisdom, teach`,
22: `${getDayName(d.date)} (Day 22): Master building - manifest grand visions`,
33: `${getDayName(d.date)} (Day 33): Master teaching - heal and serve compassionately`
};
if (opportunities[day]) {
console.log(` ${opportunities[day]}`);
}
});
} else {
console.log(` This week emphasizes steady progress over dramatic breakthroughs.`);
console.log(` Focus on consistent daily action aligned with each day's energy.`);
}
// Weekly Advice
console.log(`\n💡 WEEKLY ADVICE:`);
if (personalYear === 9) {
console.log(` • Complete unfinished projects before starting new ones`);
console.log(` • Release what no longer serves your growth`);
console.log(` • Document lessons learned - they'll guide your next cycle`);
} else if (personalYear === 1) {
console.log(` • Take initiative even if you don't feel 100% ready`);
console.log(` • Your independence is your superpower this year`);
console.log(` • Small seeds planted now become big trees later`);
} else if (personalYear === 33) {
console.log(` • Teach what you know - your wisdom helps others heal`);
console.log(` • Self-care is non-negotiable (can't pour from empty cup)`);
console.log(` • Focus on service impact, not financial compensation`);
} else if (personalYear === 7) {
console.log(` • Honor your need for solitude and introspection`);
console.log(` • Deep study and research are favored over action`);
console.log(` • Trust your intuition - it's especially strong this year`);
} else {
console.log(` • Align daily tasks with each Personal Day's energy`);
console.log(` • Work with your cycles, not against them`);
console.log(` • Rest on Day 7, launch on Day 1, create on Day 3`);
}
console.log(`\n✨ Generated with Telos + Numerology Integration System`);
}
main().catch(console.error);

540
templates/report-template.tex Normal file
View file

@ -0,0 +1,540 @@
\documentclass[11pt,letterpaper]{article}
% Packages
\usepackage[utf8]{inputenc}
\usepackage{newunicodechar}
\usepackage[hidelinks]{hyperref}
\usepackage[margin=1in]{geometry}
\usepackage{graphicx}
\usepackage{xcolor}
\usepackage{tikz}
\usepackage{fancyhdr}
\usepackage{titlesec}
\usepackage{enumitem}
\usepackage{tcolorbox}
\usepackage{booktabs}
\usepackage{array}
\usepackage{longtable}
\usepackage{multicol}
\usepackage{fontawesome5}
% Unicode character definitions
\newunicodechar{✨}{$\star$}
\newunicodechar{📅}{[Calendar]}
\newunicodechar{🎨}{[Art]}
\newunicodechar{🎯}{[Target]}
\newunicodechar{⚠}{!}
\newunicodechar{❌}{X}
% Colors
\definecolor{primary}{RGB}{75,0,130} % Deep purple
\definecolor{secondary}{RGB}{138,43,226} % Blue-violet
\definecolor{accent}{RGB}{218,165,32} % Goldenrod
\definecolor{lightgray}{RGB}{240,240,240}
\definecolor{darkgray}{RGB}{100,100,100}
% Header/Footer
\pagestyle{fancy}
\fancyhf{}
\renewcommand{\headrulewidth}{0.5pt}
\renewcommand{\footrulewidth}{0.5pt}
\fancyhead[L]{\small \textcolor{primary}{Numerology Report}}
\fancyhead[R]{\small \textcolor{primary}{\VAR{name}}}
\fancyfoot[L]{\small \textcolor{darkgray}{\textit{Djedi Consulting}}}
\fancyfoot[R]{\small \textcolor{darkgray}{\thepage}}
% Section formatting
\titleformat{\section}
{\Large\bfseries\color{primary}}
{}
{0em}
{}
[\titlerule]
\titleformat{\subsection}
{\large\bfseries\color{secondary}}
{}
{0em}
{}
% Custom boxes
\tcbset{
numberbox/.style={
colback=lightgray,
colframe=primary,
boxrule=2pt,
arc=5pt,
left=10pt,
right=10pt,
top=10pt,
bottom=10pt
},
meaningbox/.style={
colback=white,
colframe=secondary,
boxrule=1pt,
arc=3pt,
left=8pt,
right=8pt,
top=8pt,
bottom=8pt
}
}
% Document
\begin{document}
% Title Page
\begin{titlepage}
\centering
\vspace*{2cm}
{\Huge\bfseries\color{primary} Comprehensive Numerology Report\par}
\vspace{1cm}
{\Large\itshape A Complete Analysis of Your Numbers\par}
\vspace{2cm}
\begin{tcolorbox}[numberbox, width=0.7\textwidth]
\centering
{\LARGE\bfseries \VAR{name}\par}
\vspace{0.5cm}
{\large Born: \VAR{birthdate}\par}
\vspace{0.3cm}
{\normalsize Report Generated: \VAR{date}\par}
\end{tcolorbox}
\vfill
{\large This report contains:\par}
\vspace{0.5cm}
\begin{itemize}[leftmargin=2cm]
\item Core Numbers (Life Path, Expression, Soul Urge, Birthday)
\item Advanced Numbers (Maturity, Personality, Hidden Passion, Karmic Lessons)
\item Current Timing Cycles (Personal Year, Month, Day)
\item Life Pinnacles \& Challenge Numbers
\item Detailed Interpretations \& Guidance
\end{itemize}
\vfill
{\footnotesize\itshape Professional Numerology Analysis • Pythagorean System\par}
\vspace{0.5cm}
{\small\textcolor{darkgray}{Prepared by \textbf{Djedi Consulting}}\par}
\end{titlepage}
% Table of Contents
\tableofcontents
\newpage
% ====================
% SECTION 1: CORE NUMBERS
% ====================
\section{Core Numbers}
Your core numbers form the foundation of your numerological profile. These numbers reveal your life's purpose, natural talents, inner desires, and special gifts.
\subsection{Life Path Number: \VAR{lifePath} \VAR{lifePath_master}}
\begin{tcolorbox}[numberbox]
\textbf{Keywords:} \VAR{lifePath_keywords}
\vspace{0.5cm}
\VAR{lifePath_description}
\end{tcolorbox}
\begin{tcolorbox}[meaningbox]
\textbf{Your Life Purpose:}
\VAR{lifePath_purpose}
\vspace{0.3cm}
\textbf{Natural Strengths:}
\begin{itemize}[leftmargin=1cm]
\VAR{lifePath_strengths}
\end{itemize}
\textbf{Challenges to Overcome:}
\begin{itemize}[leftmargin=1cm]
\VAR{lifePath_challenges}
\end{itemize}
\end{tcolorbox}
\begin{tcolorbox}[meaningbox]
\textbf{Ideal Vocations \& Career Paths:}
\VAR{lifePath_careers}
\vspace{0.3cm}
\textbf{In Relationships:}
\VAR{lifePath_relationships}
\vspace{0.3cm}
\textbf{Spiritual Lesson:}
\VAR{lifePath_spiritual}
\end{tcolorbox}
\subsection{Expression Number: \VAR{expression} \VAR{expression_master}}
\begin{tcolorbox}[numberbox]
\textbf{Keywords:} \VAR{expression_keywords}
\vspace{0.5cm}
\VAR{expression_description}
\end{tcolorbox}
\begin{tcolorbox}[meaningbox]
\textbf{Natural Talents \& Abilities:}
\VAR{expression_purpose}
\vspace{0.3cm}
\textbf{Your Strengths:}
\begin{itemize}[leftmargin=1cm]
\VAR{expression_strengths}
\end{itemize}
\textbf{Potential Challenges:}
\begin{itemize}[leftmargin=1cm]
\VAR{expression_challenges}
\end{itemize}
\end{tcolorbox}
\begin{tcolorbox}[meaningbox]
\textbf{Best Career Paths:}
\VAR{expression_careers}
\vspace{0.3cm}
\textbf{In Relationships:}
\VAR{expression_relationships}
\end{tcolorbox}
\subsection{Soul Urge Number: \VAR{soulUrge} \VAR{soulUrge_master}}
\begin{tcolorbox}[numberbox]
\textbf{Keywords:} \VAR{soulUrge_keywords}
\vspace{0.5cm}
\VAR{soulUrge_description}
\end{tcolorbox}
\begin{tcolorbox}[meaningbox]
\textbf{Your Inner Desires \& Motivations:}
\VAR{soulUrge_purpose}
\vspace{0.3cm}
\textbf{What Drives You:}
\begin{itemize}[leftmargin=1cm]
\VAR{soulUrge_strengths}
\end{itemize}
\textbf{Potential Inner Conflicts:}
\begin{itemize}[leftmargin=1cm]
\VAR{soulUrge_challenges}
\end{itemize}
\end{tcolorbox}
\subsection{Birthday Number: \VAR{birthday}}
\begin{tcolorbox}[numberbox]
\textbf{Keywords:} \VAR{birthday_keywords}
\vspace{0.5cm}
\VAR{birthday_description}
\end{tcolorbox}
\begin{tcolorbox}[meaningbox]
\textbf{Your Special Gifts:}
\VAR{birthday_purpose}
\vspace{0.3cm}
\textbf{How to Use This Gift:}
\begin{itemize}[leftmargin=1cm]
\VAR{birthday_strengths}
\end{itemize}
\vspace{0.3cm}
\textit{Note: Your Birthday Number is a modifier that adds specific nuances to your other core numbers. It represents talents you were born with that can support your Life Path and Expression.}
\end{tcolorbox}
\newpage
% ====================
% SECTION 2: ADVANCED NUMBERS
% ====================
\section{Advanced Numbers}
These additional numbers provide deeper insight into your personality, hidden talents, areas for growth, and how you'll evolve over time.
\subsection{Maturity Number: \VAR{maturity} \VAR{maturity_master}}
\begin{tcolorbox}[meaningbox]
\textbf{Who You Become in Your Mature Years:}
\VAR{maturity_description}
\vspace{0.3cm}
This number represents the person you grow into as you mature, typically manifesting strongly around age 35-45. It's calculated from your Life Path + Expression, showing how these two fundamental aspects of your being merge in your later years.
\end{tcolorbox}
\subsection{Personality Number: \VAR{personality} \VAR{personality_master}}
\begin{tcolorbox}[meaningbox]
\textbf{How Others See You:}
\VAR{personality_description}
\vspace{0.3cm}
Your Personality Number is your "outer mask" - the first impression you give to others before they get to know the real you.
\end{tcolorbox}
\VAR{hiddenPassion_section}
\VAR{karmicLessons_section}
\subsection{Balance Number: \VAR{balance}}
\begin{tcolorbox}[meaningbox]
\textbf{How You Handle Crisis:}
\VAR{balance_description}
\vspace{0.3cm}
This number shows how you instinctively respond to stress, challenges, and difficult situations.
\end{tcolorbox}
\newpage
% ====================
% SECTION 3: TIMING CYCLES
% ====================
\section{Current Timing Cycles}
Numerology isn't just about who you are - it's also about when to act. Your personal cycles reveal the energetic themes influencing your life right now.
\subsection{Personal Year: \VAR{personalYear}}
\begin{tcolorbox}[numberbox]
\textbf{Annual Theme (\VAR{currentYear}):} \VAR{personalYear_keywords}
\vspace{0.5cm}
\VAR{personalYear_description}
\end{tcolorbox}
\begin{tcolorbox}[meaningbox]
\textbf{What This Year Is About:}
\VAR{personalYear_meaning}
\vspace{0.3cm}
\textbf{Opportunities:}
\begin{itemize}[leftmargin=1cm]
\VAR{personalYear_opportunities}
\end{itemize}
\textbf{Challenges:}
\begin{itemize}[leftmargin=1cm]
\VAR{personalYear_challenges_list}
\end{itemize}
\end{tcolorbox}
\subsection{Personal Month: \VAR{personalMonth}}
\begin{tcolorbox}[meaningbox]
\textbf{Current Month's Energy (\VAR{currentMonth}):}
\VAR{personalMonth_description}
\vspace{0.3cm}
\textbf{Focus Areas:} \VAR{personalMonth_focus}
\end{tcolorbox}
\subsection{Personal Day: \VAR{personalDay}}
\begin{tcolorbox}[meaningbox]
\textbf{Today's Energy (\VAR{today}):}
\VAR{personalDay_description}
\vspace{0.3cm}
\textbf{Best Activities:} \VAR{personalDay_activities}
\end{tcolorbox}
\subsection{Universal Cycles}
\begin{tabular}{ll}
\toprule
\textbf{Cycle} & \textbf{Number} \\
\midrule
Universal Year & \VAR{universalYear} \\
Universal Month & \VAR{universalMonth} \\
Universal Day & \VAR{universalDay} \\
\bottomrule
\end{tabular}
\vspace{0.5cm}
The Universal cycles represent the collective energy affecting everyone on Earth right now.
\newpage
% ====================
% SECTION 4: LIFE PINNACLES
% ====================
\section{Life Pinnacles \& Challenges}
Your life is divided into four major pinnacles - each lasting approximately 9 years. These represent the major themes and lessons of different life stages.
\VAR{pinnacles_content}
\newpage
% ====================
% SECTION 5: OPTIMAL DAYS & YEAR AHEAD
% ====================
\section{Strategic Timing}
Knowing the right timing can make all the difference. This section shows you the most favorable days coming up and what to expect in the year ahead.
\subsection{Optimal Days - Next 3 Months}
\VAR{optimalDays_content}
\subsection{Year Ahead: \VAR{nextYear}}
\VAR{yearAhead_content}
\newpage
% ====================
% SECTION 6: SYNTHESIS & GUIDANCE
% ====================
\section{Synthesis \& Life Guidance}
\subsection{Your Unique Numerological Profile}
\begin{tcolorbox}[meaningbox]
\textbf{Core Identity:}
With a Life Path \VAR{lifePath} and Expression \VAR{expression}, your journey is about \VAR{synthesis_core}. Your Soul Urge \VAR{soulUrge} reveals that deep down, you're driven by \VAR{synthesis_soul}.
\vspace{0.3cm}
\textbf{Current Phase:}
You're currently in a Personal Year \VAR{personalYear}, which means this is a time for \VAR{synthesis_year}. Your Maturity Number \VAR{maturity} shows that as you age, you're growing into someone who \VAR{synthesis_maturity}.
\end{tcolorbox}
\subsection{Master Numbers in Your Chart}
\VAR{masterNumbers_section}
\subsection{Key Recommendations}
\begin{tcolorbox}[numberbox]
\textbf{1. Embrace Your Life Path}
\VAR{rec_lifePath}
\vspace{0.3cm}
\textbf{2. Leverage Your Expression}
\VAR{rec_expression}
\vspace{0.3cm}
\textbf{3. Honor Your Soul Urge}
\VAR{rec_soulUrge}
\vspace{0.3cm}
\textbf{4. Work On Karmic Lessons}
\VAR{rec_karmic}
\vspace{0.3cm}
\textbf{5. Align With Current Cycles}
\VAR{rec_cycles}
\end{tcolorbox}
\newpage
% ====================
% APPENDIX: CALCULATIONS
% ====================
\section{Appendix: Calculation Breakdown}
\subsection{Life Path Calculation}
\begin{verbatim}
Birthdate: \VAR{birthdate}
Month: \VAR{calc_month}
Day: \VAR{calc_day}
Year: \VAR{calc_year}
Life Path = \VAR{calc_month} + \VAR{calc_day} + \VAR{calc_year} = \VAR{lifePath}
\end{verbatim}
\subsection{Expression Calculation}
\begin{verbatim}
Name: \VAR{name}
\VAR{calc_expression_breakdown}
Expression Number: \VAR{expression}
\end{verbatim}
\subsection{Soul Urge Calculation}
\begin{verbatim}
\VAR{calc_soulUrge_breakdown}
Soul Urge Number: \VAR{soulUrge}
\end{verbatim}
\subsection{Personality Number Calculation}
\begin{verbatim}
Consonants only: \VAR{calc_personality_breakdown}
Personality Number: \VAR{personality}
\end{verbatim}
\subsection{Birthday Number}
\begin{verbatim}
Birth Day: \VAR{calc_day}
Birthday Number: \VAR{birthday}
\end{verbatim}
\subsection{Maturity Number Calculation}
\begin{verbatim}
Life Path (\VAR{lifePath}) + Expression (\VAR{expression}) = \VAR{maturity}
Maturity Number: \VAR{maturity}
\end{verbatim}
\vfill
\begin{center}
\rule{0.5\textwidth}{0.5pt}
\vspace{0.5cm}
\textit{This report was generated using the Pythagorean numerology system.}
\textit{All numbers have been calculated using traditional numerological methods,}
\textit{with master numbers (11, 22, 33) preserved throughout.}
\vspace{0.5cm}
{\small Generated by Numerology Calculator • \url{https://github.com/rpriven/numerology}}
\end{center}
\end{document}

342
year-ahead.ts Executable file
View file

@ -0,0 +1,342 @@
#!/usr/bin/env bun
/**
* Year-Ahead Calendar
*
* Shows Personal Month cycles for an entire year, giving you a strategic
* overview of the energy themes for each month ahead.
*
* Usage:
* bun year-ahead.ts --birthdate "5/13/1982" --year 2025
* bun year-ahead.ts --birthdate "5/13/1982" --name "John Doe"
*/
import { calculateCycles } from './cycles';
import { personalMonth, personalYear as personalYearMeanings } from './cycle-meanings';
import { loadProfile } from './profile-manager';
// Parse command line arguments
const args = process.argv.slice(2);
let birthdate = '';
let year: number = new Date().getFullYear();
let name = '';
let profileId = '';
for (let i = 0; i < args.length; i++) {
if ((args[i] === '--profile' || args[i] === '-p') && args[i + 1]) {
profileId = args[i + 1];
i++;
} else if ((args[i] === '--birthdate' || args[i] === '-b') && args[i + 1]) {
birthdate = args[i + 1];
i++;
} else if ((args[i] === '--year' || args[i] === '-y') && args[i + 1]) {
year = parseInt(args[i + 1]);
i++;
} else if ((args[i] === '--name' || args[i] === '-n') && args[i + 1]) {
name = args[i + 1];
i++;
} else if (args[i] === '--help' || args[i] === '-h') {
console.log(`
Year-Ahead Calendar
Shows Personal Month cycles for the entire year ahead, giving you a
strategic overview of energy themes and planning opportunities.
USAGE:
bun year-ahead.ts --profile <id> [OPTIONS]
bun year-ahead.ts --birthdate "mm/dd/yyyy" [OPTIONS]
OPTIONS:
-p, --profile ID Use saved profile
-b, --birthdate DATE Your birthdate (mm/dd/yyyy) [required if no profile]
-y, --year NUMBER Year to preview [default: current year]
-n, --name NAME Your name [optional - for personalized output]
-h, --help Show this help message
EXAMPLES:
# With profile
bun year-ahead.ts --profile rob
bun year-ahead.ts --profile rob -y 2026
# With birthdate
bun year-ahead.ts -b "5/13/1982"
bun year-ahead.ts -b "5/13/1982" -y 2026
bun year-ahead.ts -b "5/13/1982" -n "John Doe" -y 2025
PERSONAL MONTH MEANINGS:
1 - New beginnings, fresh starts, independence
2 - Cooperation, relationships, patience
3 - Creativity, communication, self-expression
4 - Hard work, structure, foundation building
5 - Change, freedom, adventure, variety
6 - Responsibility, service, family, home
7 - Reflection, study, spirituality, rest
8 - Achievement, ambition, financial focus
9 - Completion, endings, release, preparation
11 - Inspiration, intuition, spiritual awakening
22 - Master building, manifesting visions
33 - Master teaching, compassionate service
STRATEGIC PLANNING:
Use this calendar to:
- Plan major projects around supportive month cycles
- Schedule launches during Personal Month 1 or 8
- Block creative work for Month 3
- Reserve Month 7 for planning and strategy
- Complete and release during Month 9
`);
process.exit(0);
}
}
// Load profile if specified
if (profileId) {
const profile = loadProfile(profileId);
if (!profile) {
console.error(`Error: Profile '${profileId}' not found`);
console.error('List profiles with: bun profile.ts list');
process.exit(1);
}
name = profile.name;
birthdate = profile.birthdate;
}
if (!birthdate) {
console.error('Error: --birthdate is required (or use --profile)');
console.error('Try: bun year-ahead.ts --help');
process.exit(1);
}
interface MonthInfo {
month: number;
monthName: string;
personalMonth: number;
personalYear: number;
universalMonth: number;
universalYear: number;
theme: string;
focus: string[];
bestFor: string[];
avoid: string[];
}
// Month names
const monthNames = [
'January', 'February', 'March', 'April', 'May', 'June',
'July', 'August', 'September', 'October', 'November', 'December'
];
// Simplified month guidance
const monthGuidance: Record<number, { theme: string; focus: string[]; bestFor: string[]; avoid: string[] }> = {
1: {
theme: 'New Beginnings',
focus: ['Fresh starts', 'Independence', 'Initiative'],
bestFor: ['Launching projects', 'Starting new ventures', 'Bold decisions', 'Leadership actions'],
avoid: ['Waiting for others', 'Being passive', 'Following only']
},
2: {
theme: 'Cooperation',
focus: ['Partnerships', 'Patience', 'Details'],
bestFor: ['Building relationships', 'Collaborative work', 'Diplomacy', 'Refinement'],
avoid: ['Solo ventures', 'Rushing', 'Impatience']
},
3: {
theme: 'Creative Expression',
focus: ['Communication', 'Creativity', 'Social connection'],
bestFor: ['Content creation', 'Public speaking', 'Networking', 'Creative projects'],
avoid: ['Heavy analytical work', 'Isolation', 'Overthinking']
},
4: {
theme: 'Foundation Building',
focus: ['Hard work', 'Organization', 'Structure'],
bestFor: ['System building', 'Planning', 'Infrastructure', 'Financial organization'],
avoid: ['Starting completely new things', 'Taking shortcuts', 'Scattered efforts']
},
5: {
theme: 'Change & Freedom',
focus: ['Variety', 'Adventure', 'Adaptation'],
bestFor: ['Marketing', 'Trying new approaches', 'Travel', 'Experimentation'],
avoid: ['Rigid routines', 'Being stuck', 'Resisting change']
},
6: {
theme: 'Service & Responsibility',
focus: ['Teaching', 'Helping', 'Family'],
bestFor: ['Client service', 'Teaching', 'Community work', 'Home projects'],
avoid: ['Selfish pursuits', 'Avoiding responsibility', 'Neglecting others']
},
7: {
theme: 'Introspection',
focus: ['Study', 'Spirituality', 'Analysis'],
bestFor: ['Deep study', 'Research', 'Strategy', 'Rest and rejuvenation'],
avoid: ['Major public launches', 'Excessive socializing', 'Surface-level work']
},
8: {
theme: 'Achievement',
focus: ['Power', 'Business', 'Success'],
bestFor: ['Business deals', 'Financial decisions', 'Scaling', 'Major launches'],
avoid: ['Spiritual retreats', 'Passive waiting', 'Small thinking']
},
9: {
theme: 'Completion',
focus: ['Release', 'Endings', 'Letting go'],
bestFor: ['Completing projects', 'Publishing', 'Clearing space', 'Endings'],
avoid: ['Starting new ventures', 'Beginning fresh', 'Major initiations']
},
11: {
theme: 'Inspiration',
focus: ['Intuition', 'Illumination', 'Spiritual leadership'],
bestFor: ['Inspiring others', 'Visionary work', 'Spiritual teaching', 'Master guidance'],
avoid: ['Ignoring intuition', 'Playing small', 'Logical-only thinking']
},
22: {
theme: 'Master Building',
focus: ['Manifestation', 'Large-scale vision', 'Legacy work'],
bestFor: ['Building legacies', 'Large projects', 'Visionary implementation', 'Ambitious launches'],
avoid: ['Small projects', 'Short-term thinking', 'Doubting vision']
},
33: {
theme: 'Master Teaching',
focus: ['Healing', 'Compassionate service', 'Education'],
bestFor: ['Master teaching', 'Healing work', 'Educational initiatives', 'High-level service'],
avoid: ['Selfish profit focus', 'Burnout', 'Boundary violations']
}
};
// Calculate all months
function getYearAhead(birthdate: string, year: number): MonthInfo[] {
const months: MonthInfo[] = [];
for (let month = 1; month <= 12; month++) {
const dateStr = `${month}/15/${year}`; // Use middle of month
const cycles = calculateCycles(birthdate, dateStr);
const guidance = monthGuidance[cycles.personal.month] || monthGuidance[1];
months.push({
month,
monthName: monthNames[month - 1],
personalMonth: cycles.personal.month,
personalYear: cycles.personal.year,
universalMonth: cycles.universal.month,
universalYear: cycles.universal.year,
theme: guidance.theme,
focus: guidance.focus,
bestFor: guidance.bestFor,
avoid: guidance.avoid
});
}
return months;
}
// Main execution
console.log(`\n═══════════════════════════════════════════════════════════════`);
console.log(`📅 YOUR YEAR AHEAD: ${year}`);
if (name) console.log(` ${name}`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
const months = getYearAhead(birthdate, year);
const personalYear = months[0].personalYear;
const pyNum = months[0].personalYear;
const pyMeaning = personalYearMeanings[pyNum];
console.log(`🌟 Personal Year ${pyNum}: ${pyMeaning?.keywords.join(', ') || 'Growth & Evolution'}\n`);
// Year overview
if (pyMeaning) {
console.log(`YEAR ${year} OVERVIEW:\n`);
console.log(`Theme: ${pyMeaning.theme}\n`);
}
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`MONTHLY BREAKDOWN`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
// Display each month
months.forEach((month, index) => {
const isCurrentMonth = new Date().getMonth() === month.month - 1 && new Date().getFullYear() === year;
const marker = isCurrentMonth ? '▶️ ' : ' ';
console.log(`${marker}${month.monthName.toUpperCase()} - Personal Month ${month.personalMonth}`);
console.log(` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━`);
console.log(` 🎯 THEME: ${month.theme}`);
console.log(` 📍 FOCUS: ${month.focus.join(' • ')}`);
console.log(` ✅ BEST FOR: ${month.bestFor[0]}`);
if (index < months.length - 1) {
console.log('');
}
});
console.log(`\n═══════════════════════════════════════════════════════════════`);
console.log(`STRATEGIC PLANNING GUIDE`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
// Group months by theme for strategic planning
const monthsByNumber: Record<number, string[]> = {};
months.forEach(m => {
if (!monthsByNumber[m.personalMonth]) {
monthsByNumber[m.personalMonth] = [];
}
monthsByNumber[m.personalMonth].push(m.monthName);
});
console.log(`KEY PLANNING OPPORTUNITIES:\n`);
// Highlight strategic months
if (monthsByNumber[1]) {
console.log(`🚀 LAUNCH MONTHS (Personal Month 1):`);
console.log(` ${monthsByNumber[1].join(', ')}`);
console.log(` → Best for: New projects, bold initiatives, fresh starts\n`);
}
if (monthsByNumber[3]) {
console.log(`🎨 CREATIVE MONTHS (Personal Month 3):`);
console.log(` ${monthsByNumber[3].join(', ')}`);
console.log(` → Best for: Content creation, communication, networking\n`);
}
if (monthsByNumber[7]) {
console.log(`🧘 REFLECTION MONTHS (Personal Month 7):`);
console.log(` ${monthsByNumber[7].join(', ')}`);
console.log(` → Best for: Strategy, deep study, rest and planning\n`);
}
if (monthsByNumber[8]) {
console.log(`💼 BUSINESS MONTHS (Personal Month 8):`);
console.log(` ${monthsByNumber[8].join(', ')}`);
console.log(` → Best for: Major deals, scaling, financial decisions\n`);
}
if (monthsByNumber[9]) {
console.log(`🏁 COMPLETION MONTHS (Personal Month 9):`);
console.log(` ${monthsByNumber[9].join(', ')}`);
console.log(` → Best for: Finishing projects, releasing, wrapping up\n`);
}
// Master numbers
[11, 22, 33].forEach(num => {
if (monthsByNumber[num]) {
const names = { 11: 'INSPIRATION', 22: 'MASTER BUILDING', 33: 'MASTER TEACHING' };
console.log(`✨ ${names[num as 11 | 22 | 33]} MONTHS (Personal Month ${num}):`);
console.log(` ${monthsByNumber[num].join(', ')}`);
console.log(` → Special high-vibration months with amplified potential\n`);
}
});
console.log(`═══════════════════════════════════════════════════════════════`);
console.log(`💡 HOW TO USE THIS CALENDAR`);
console.log(`═══════════════════════════════════════════════════════════════\n`);
console.log(`1. ALIGN MAJOR PROJECTS with supportive month cycles`);
console.log(`2. SCHEDULE LAUNCHES during Month 1 or Month 8`);
console.log(`3. BLOCK CREATIVE TIME during Month 3`);
console.log(`4. RESERVE Month 7 for strategic planning and rest`);
console.log(`5. COMPLETE & RELEASE during Month 9\n`);
console.log(`💫 Use this overview for annual planning, then drill down with:`);
console.log(` • telos-week.ts for weekly planning`);
console.log(` • optimal-days.ts to find specific optimal days`);
console.log(` • cycles.ts for daily cycle guidance\n`);
console.log(`✨ Align your actions with natural cycles for maximum effectiveness\n`);