# STEP 8G — Numerology Crystal Profile

## Status
Clean Step 8G package built from the confirmed Step 8F baseline.

## What this step adds
- Book-v1 Numerology Crystal Profile.
- Life Path crystal allies.
- Destiny / Expression crystal allies.
- Personal Year crystal allies.
- Core frequency / theme for each mapped number.
- Purpose / practical meaning from the book-v1 crystal matrix.
- Dashboard Crystal Profile section.
- Crystal profile included in the calculation result and calculation snapshot.

## Methodology source
This step follows the book-v1 **Numerology and Crystals — The Numerical Matrix of Stones** section. The source explicitly maps:

- 1 → Red Jasper, Garnet, Ruby → Action – Initiation – Courage
- 2 → Moonstone, Selenite, Chrysocolla → Balance – Partnership
- 3 → Citrine, Yellow Calcite, Tiger’s Eye → Expression – Creativity
- 4 → Green Aventurine, Moss Agate, Jade → Stability – Order
- 5 → Blue Apatite, Turquoise, Amazonite → Freedom – Communication
- 6 → Lapis Lazuli, Sodalite, Indigo Kyanite → Responsibility – Service
- 7 → Amethyst, Lepidolite, Purple Fluorite → Introspection – Wisdom
- 8 → Pyrite, Goldstone, Smoky Quartz → Power – Manifestation
- 9 → Clear Quartz, Selenite, Howlite → Completion – Universal Love
- 11 → Ametrine, Herkimer Diamond → Illumination – Revelation
- 22 → Hematite, Black Tourmaline, Shungite → Master Builder – Earth Alchemist
- 33 → Rose Quartz, Rhodochrosite, Morganite → Christic Compassion

The book also states that users should identify their Life Path, Destiny and Personal Year, then select stones whose frequency matches or balances those numbers.

## Database
No schema changes are required.
No SQL import is required.
Existing database credentials are not included or replaced.

## Tests
Run:
- `php tests/test-crystal-profile-calculator.php`
- `php tests/test-step8g-integration.php`

Expected:
- Crystal matrix: `RESULT: 13/13 passed.`
- Step 8G integration: `RESULT: 7/7 passed.`

## User test
1. Upload/merge this package over the currently confirmed Step 8F installation.
2. Do not replace your server's `api/config/database.php`.
3. Do not import SQL.
4. Log in.
5. Open `public/calculator.html`.
6. Use the same working test details:
   - First name: Ibrahim
   - Middle name: Folawiyo
   - Last name: Ajayi
   - Date of birth: 08/19/1987
7. Click **Preview my profile**.
8. Confirm the calculation succeeds.
9. Open the dashboard.
10. Confirm **Your Numerology Crystal Profile** appears.
11. Confirm Life Path, Destiny / Expression and Personal Year crystal cards are displayed.
12. Confirm the existing Colour Profile and Chakra Profile still display correctly.
13. Perform one second calculation to confirm the repeat-calculation flow still works.

## Stop condition
Stop after this single upload/test cycle and report the exact result shown. Do not modify SQL or database credentials if a test fails.