Metadata-Version: 2.4
Name: skskyforge
Version: 1.1.0
Summary: SKSkyforge - Sovereign Alignment Calendar System with daily crontab reports
Author-email: smilinTux <chefboyrdave2.1@gmail.com>
License-Expression: AGPL-3.0-or-later
Project-URL: Homepage, https://github.com/smilinTux/skyforge
Project-URL: Documentation, https://github.com/smilinTux/skyforge#readme
Project-URL: Repository, https://github.com/smilinTux/skyforge
Project-URL: Issues, https://github.com/smilinTux/skyforge/issues
Keywords: astrology,numerology,human-design,i-ching,biorhythm,calendar,wellness,spiritual,daily-guidance,sovereign-alignment,crontab,openclaw
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Astronomy
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: pydantic<3.0.0,>=2.5.0
Requires-Dist: pydantic-settings<3.0.0,>=2.1.0
Requires-Dist: pyswisseph<3.0.0,>=2.10.3
Requires-Dist: ephem<5.0.0,>=4.1.5
Requires-Dist: click<9.0.0,>=8.1.0
Requires-Dist: rich<14.0.0,>=13.7.0
Requires-Dist: reportlab<5.0.0,>=4.1.0
Requires-Dist: openpyxl<4.0.0,>=3.1.2
Requires-Dist: pandas<3.0.0,>=2.2.0
Requires-Dist: geopy<3.0.0,>=2.4.1
Requires-Dist: timezonefinder<7.0.0,>=6.4.0
Requires-Dist: pytz>=2024.1
Requires-Dist: python-dotenv<2.0.0,>=1.0.1
Requires-Dist: pyyaml<7.0.0,>=6.0.1
Requires-Dist: httpx<1.0.0,>=0.27.0
Provides-Extra: web
Requires-Dist: fastapi<1.0.0,>=0.109.0; extra == "web"
Requires-Dist: uvicorn<1.0.0,>=0.27.0; extra == "web"
Requires-Dist: jinja2<4.0.0,>=3.1.3; extra == "web"
Provides-Extra: dev
Requires-Dist: pytest<9.0.0,>=8.0.0; extra == "dev"
Requires-Dist: pytest-cov<5.0.0,>=4.1.0; extra == "dev"
Requires-Dist: pytest-asyncio<1.0.0,>=0.23.0; extra == "dev"
Requires-Dist: black<25.0.0,>=24.1.0; extra == "dev"
Requires-Dist: ruff<1.0.0,>=0.2.0; extra == "dev"
Requires-Dist: mypy<2.0.0,>=1.8.0; extra == "dev"
Provides-Extra: all
Requires-Dist: skskyforge[dev,web]; extra == "all"
Dynamic: license-file

# SKSkyforge 🌟

> **"Forge your sovereign path through the cosmos"**

SKSkyforge is a comprehensive daily preparation system that generates personalized sovereign alignment calendars. It integrates 10 domains of guidance into a unified system for optimal daily performance.

## ✨ Features

### 10 Integrated Domains

| Domain | Description |
|--------|-------------|
| 🌓 **Moon Phase & Sign** | Lunar phase, zodiac position, void-of-course periods |
| 🔢 **Numerology** | Life path, personal year/month/day calculations |
| 🌞 **Solar Return** | Annual chart, house focus, planetary transits |
| 🧬 **Human Design** | Type, strategy, authority, daily gate activations |
| ☯️ **I Ching** | Daily hexagram overlay with wisdom guidance |
| 📈 **Biorhythm** | Physical, emotional, intellectual cycle tracking |
| ⚠️ **Risk Analysis** | Multi-domain risk scoring and warnings |
| 🧘 **Exercise & Embodiment** | Physical activity recommendations |
| 🥣 **Nourishment** | Element-based dietary guidance |
| 📖 **Spiritual Reading** | Daily wisdom texts from curated library |

### Key Capabilities

- **Year-Agnostic**: Generate calendars for any year (2025, 2026, 2027, etc.)
- **Multi-User Profiles**: Support multiple users with saved birth data
- **Multiple Output Formats**: PDF, Excel/CSV, JSON, Web Dashboard
- **Actionable Guidance**: Daily practices for optimal performance

## 🚀 Quick Start

### Installation

```bash
# Clone the repository
git clone https://github.com/smilinTux/SKyForge.git
cd SKyForge

# Create virtual environment
python -m venv venv
source venv/bin/activate  # Linux/Mac
# or: venv\Scripts\activate  # Windows

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .
```

### Create Your Profile

```bash
# Interactive profile creation
skskyforge profile create

# Or with all options
skskyforge profile create \
  --name "my_profile" \
  --birth-date "1985-03-15" \
  --birth-time "14:30" \
  --birth-location "New York, NY, USA"
```

### Generate Your Calendar

```bash
# Generate full year calendar
skskyforge generate --year 2026

# Generate single month
skskyforge generate --year 2026 --month 1

# Generate with specific format
skskyforge generate --year 2026 --format pdf

# Preview a single day
skskyforge preview --date 2026-01-15
```

## 📋 Requirements

- Python 3.10 or later
- Swiss Ephemeris data files (downloaded automatically)

## 🏗️ Project Structure

```
skskyforge/
├── agent.md              # AI agent instructions
├── prd.txt               # Product requirements
├── requirements.txt      # Python dependencies
├── pyproject.toml        # Project configuration
├── config/
│   ├── settings.yaml     # Global settings
│   └── profiles/         # User profiles
├── src/skskyforge/
│   ├── cli.py            # Command-line interface
│   ├── models/           # Data models
│   ├── calculators/      # Domain calculators
│   ├── analyzers/        # Risk & wellness analyzers
│   ├── generators/       # Output generators
│   └── data/             # Reference data
└── tests/                # Test suite
```

## 📖 Documentation

- **[agent.md](agent.md)** - Technical specifications for developers
- **[prd.txt](prd.txt)** - Product requirements document

## 🔧 Configuration

### Environment Variables

Copy `.env.example` to `.env` and configure:

```bash
cp .env.example .env
```

Key settings:
- `SKSKYFORGE_OUTPUT_DIR` - Output directory for generated files
- `SKSKYFORGE_DEFAULT_PROFILE` - Default profile name
- `SWISSEPH_PATH` - Swiss Ephemeris data path

### Settings File

Edit `config/settings.yaml` to customize:
- Output format preferences
- Calculation parameters
- Wellness recommendation rules
- Spiritual library rotation

## 🧪 Development

### Running Tests

```bash
# Run all tests
pytest

# Run with coverage
pytest --cov=skskyforge

# Run specific test file
pytest tests/test_calculators/test_numerology.py
```

### Code Quality

```bash
# Format code
black src/ tests/

# Lint code
ruff src/ tests/

# Type checking
mypy src/
```

## 📄 Sample Output

```
╔══════════════════════════════════════════════════════════════════╗
║  SKSKYFORGE DAILY SOVEREIGN ALIGNMENT                              ║
║  Wednesday, January 15, 2026 (Day 15 of 365)                     ║
╠══════════════════════════════════════════════════════════════════╣
║  DAILY THEME: "Grounded Action with Emotional Wisdom"            ║
║  OVERALL ENERGY: Moderate-High | RISK LEVEL: Low                 ║
╚══════════════════════════════════════════════════════════════════╝

🌙 MOON: Waxing Gibbous (78%) in Taurus
🔢 NUMEROLOGY: Personal Day 5 (Universal Day 7)
☀️ SOLAR TRANSIT: Sun in Capricorn, 10th House Focus
🧬 HUMAN DESIGN: Gate 41 (Decrease) Active
☯️ I CHING: Hexagram 41 - Decrease
📊 BIORHYTHM: Physical +67% | Emotional +23% | Mental -12%
⚠️ RISK ANALYSIS: Low (Score: 22/100)

💫 TODAY'S AFFIRMATION:
   "I build my dreams with patient, steady hands."
```

## 🤝 Contributing

Contributions are welcome! Please read the contributing guidelines before submitting pull requests.

## 📜 License

This project is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0)**.

Copyright (C) 2025 **S&K Holding QT (Quantum Technologies)**

> **SK** = *staycuriousANDkeepsmilin* 🐧

See [LICENSE](LICENSE) for the full license text.

## 🙏 Acknowledgments

- Swiss Ephemeris for astronomical calculations
- The I Ching and Human Design communities
- All wisdom traditions represented in the spiritual library

---

**SKSkyforge** - *Scientifically mapped. Spiritually grounded.*
