@it-healer/human-design-calculator 1.0.0

package/README.md

@@ -0,0 +1,131 @@
+# Human Design Bodygraph Calculator CLI
+
+CLI-инструмент для расчёта бодиграфа Human Design. Принимает дату, время, таймзону и координаты рождения, выдаёт полный JSON со всеми расчётами и опционально генерирует SVG-визуализацию бодиграфа.
+
+## Установка
+
+```bash
+npm install
+```
+
+## Файлы эфемерид (Swiss Ephemeris)
+
+Для высокоточных расчётов необходимо скачать файлы Swiss Ephemeris (.se1) и поместить их в папку `ephemeris/`.
+
+### Где скачать
+
+Файлы доступны на официальном FTP-сервере Swiss Ephemeris:
+
+**https://www.astro.com/ftp/swisseph/ephe/**
+
+Необходимые файлы (суммарно ~10 MB):
+
+| Файл            | Описание                         | Размер   |
+|-----------------|----------------------------------|----------|
+| `sepl_18.se1`   | Планеты (от Солнца до Плутона)   | ~3.5 MB  |
+| `semo_18.se1`   | Луна                             | ~5.5 MB  |
+| `seas_18.se1`   | Астероиды (включая True Node)    | ~0.5 MB  |
+
+Файлы `*_18.se1` покрывают период **600 BC — 2400 AD**, что достаточно для любых расчётов.
+
+### Скачивание одной командой
+
+```bash
+cd ephemeris
+curl -O https://www.astro.com/ftp/swisseph/ephe/sepl_18.se1
+curl -O https://www.astro.com/ftp/swisseph/ephe/semo_18.se1
+curl -O https://www.astro.com/ftp/swisseph/ephe/seas_18.se1
+```
+
+> **Без файлов эфемерид** инструмент всё равно работает — Swiss Ephemeris автоматически переключается на встроенный алгоритм Moshier (менее точный, но достаточный для Gate/Line/Color).
+
+## Использование
+
+```bash
+npm run start -- 22.04.1993 08:40 Europe/Kyiv 48.5678 39.3031 ./chart.svg
+```
+
+Или напрямую через `node`:
+
+```bash
+node src/index.js 22.04.1993 08:40 Europe/Kyiv 48.5678 39.3031 ./chart.svg
+```
+
+### Параметры
+
+| #   | Описание                                   | Пример                             |
+|-----|--------------------------------------------|------------------------------------|
+| 1   | Дата рождения (DD.MM.YYYY или YYYY-MM-DD) | `22.04.1993`                       |
+| 2   | Локальное время рождения (HH:MM)          | `08:40`                            |
+| 3   | Таймзона в формате IANA                    | `Europe/Kyiv`, `America/New_York`  |
+| 4   | Широта места рождения                     | `48.5678`                          |
+| 5   | Долгота места рождения                    | `39.3031`                          |
+| 6   | Путь для сохранения SVG (опционально)     | `./chart.svg`                      |
+
+Если 6-й параметр не указан, выводится только JSON без генерации SVG.
+
+### Примеры
+
+Только JSON:
+```bash
+npm run start -- 25.09.1983 14:30 America/New_York 42.4264 -71.065
+```
+
+JSON + SVG-визуализация:
+```bash
+npm run start -- 25.09.1983 14:30 America/New_York 42.4264 -71.065 ./bodygraph.svg
+```
+
+## SVG-визуализация
+
+При указании пути для SVG генерируется визуализация бодиграфа:
+
+- 9 центров с цветовой раскраской (определённые/неопределённые)
+- 36 каналов (активные выделены)
+- 64 гейта с номерами в кружках
+- Цветовая кодировка: чёрный — Personality, красный — Design, синий — оба
+- Контур человеческой фигуры на фоне
+
+## Выходной JSON
+
+Инструмент выводит JSON со следующими полями:
+
+```
+input                  — входные параметры
+birthDateUTC           — дата рождения в UTC
+designDateUTC          — дата дизайна (88° ретроград Солнца) в UTC
+activations            — активации для Personality и Design
+  personality/design   — для каждого из 13 тел: gate, line, color, tone, base
+    Sun, Earth, Moon, Mercury, Venus, Mars, Jupiter,
+    Saturn, Uranus, Neptune, Pluto, NorthNode, SouthNode
+type                   — Generator, Manifesting Generator, Projector, Manifestor, Reflector
+strategy               — To Respond, To Inform, To Wait for the Invitation, To Wait a Lunar Cycle
+signature              — Satisfaction, Peace, Success, Surprise
+notSelfTheme           — Frustration, Anger, Bitterness, Disappointment
+authority              — Solar Plexus, Sacral, Spleen, Ego, Self Projected, Outer Authority, Lunar
+definition             — None, Single, Split, Wide Split, Triple Split, Quad Split
+profile                — "Line/Line" (например "1/3")
+incarnationCross       — полное название инкарнационного креста
+variable               — "P[L/R][L/R] D[L/R][L/R]"
+channels               — массив активных каналов ("9-52", "29-46", ...)
+activatedGates         — массив всех уникальных активированных гейтов
+definedCenters         — массив определённых центров
+undefinedCenters       — массив неопределённых центров
+centerDefinition       — объект с булевыми флагами для каждого центра
+circuitries            — массив контуров (Individual, Tribal, Collective Logic, Collective Abstract)
+determination          — Appetite, Taste, Thirst, Touch, Sound, Light
+environment            — Caves, Markets, Kitchens, Mountains, Valleys, Shores
+view                   — Survival, Possibility, Power, Wanting, Probability, Personal
+motivation             — Fear, Hope, Desire, Need, Guilt, Innocence
+cognition              — Smell, Taste, Outer Vision, Inner Vision, Feeling, Touch
+sense                  — Security, Uncertainty, Action, Meditation, Judgment, Acceptance
+```
+
+## Технические детали
+
+- **Node.js** — чистый JavaScript, без TypeScript
+- **Swiss Ephemeris** (`swisseph` npm) — астрономические вычисления планетарных позиций
+- **Luxon** — конвертация локального времени в UTC с учётом таймзоны
+- **Бинарный поиск** для нахождения даты Дизайна (~50 итераций vs 800K+ в линейном подходе)
+- 13 небесных тел: Sun, Earth, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, South Node
+- Полная иерархия активации: Gate → Line → Color → Tone → Base

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@it-healer/human-design-calculator",
+  "version": "1.0.0",
+  "description": "Human Design bodygraph calculator CLI — calculates type, authority, profile, channels, gates, and generates SVG visualization",
+  "author": {
+    "name": "PAVLO POPOV",
+    "url": "https://it-healer.com"
+  },
+  "homepage": "https://it-healer.com",
+  "main": "src/index.js",
+  "bin": {
+    "hd-calculator": "src/index.js"
+  },
+  "files": [
+    "src/",
+    "ephemeris/"
+  ],
+  "scripts": {
+    "start": "node src/index.js"
+  },
+  "keywords": [
+    "human-design",
+    "bodygraph",
+    "astrology",
+    "swiss-ephemeris",
+    "cli"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "luxon": "^3.4.0",
+    "swisseph": "^0.5.17"
+  }
+}

package/src/activation.js

@@ -0,0 +1,43 @@
+const { GATE_ORDER } = require('./data/gates');
+
+/**
+ * Convert ecliptic longitude (decimal degrees 0-360) to HD activation.
+ *
+ * HD gates start at Gate 41 at 02°00'00" Aquarius.
+ * Offset from 00° Aries = 58 degrees exactly.
+ *
+ * The zodiac wheel (360°) subdivides into:
+ *   64 gates × 6 lines × 6 colors × 6 tones × 5 bases = 69,120 total subdivisions
+ */
+function getActivation(longitude) {
+  let adjusted = longitude + 58;
+  if (adjusted >= 360) adjusted -= 360;
+
+  const pct = adjusted / 360;
+
+  const gateIndex = Math.floor(pct * 64);
+  const gate = GATE_ORDER[gateIndex];
+
+  const exactLine = 384 * pct;       // 64 * 6
+  const line = Math.floor((exactLine % 6) + 1);
+
+  const exactColor = 2304 * pct;     // 64 * 6 * 6
+  const color = Math.floor((exactColor % 6) + 1);
+
+  const exactTone = 13824 * pct;     // 64 * 6 * 6 * 6
+  const tone = Math.floor((exactTone % 6) + 1);
+
+  const exactBase = 69120 * pct;     // 64 * 6 * 6 * 6 * 5
+  const base = Math.floor((exactBase % 5) + 1);
+
+  return { gate, line, color, tone, base };
+}
+
+/** Get activation for the opposite point (Earth = Sun+180°, SouthNode = NorthNode+180°) */
+function getOppositeActivation(longitude) {
+  let opposite = longitude + 180;
+  if (opposite >= 360) opposite -= 360;
+  return getActivation(opposite);
+}
+
+module.exports = { getActivation, getOppositeActivation };

package/src/bodygraph.js

@@ -0,0 +1,138 @@
+const { DateTime } = require('luxon');
+const {
+  initEphemeris, dateToJulianDay, julianDayToDate,
+  getAllPositions, PLANET_NAMES,
+} = require('./ephemeris');
+const { getActivation, getOppositeActivation } = require('./activation');
+const { findDesignDate } = require('./design-date');
+const {
+  getAllActivatedGates, getChannels, getDefinedCenters,
+  getType, getTypeProperties, getAuthority, getDefinition,
+  getProfile, getVariable, getCircuitries,
+} = require('./type');
+const {
+  getIncarnationCross, getDetermination, getEnvironment,
+  getView, getMotivation, getCognition, getSense,
+} = require('./properties');
+const { CENTER_NAMES } = require('./data/centers');
+
+function julianDayToISO(jd) {
+  const d = julianDayToDate(jd);
+  const totalHours = d.hour;
+  const hours = Math.floor(totalHours);
+  const totalMinutes = (totalHours - hours) * 60;
+  const minutes = Math.floor(totalMinutes);
+  const seconds = Math.floor((totalMinutes - minutes) * 60);
+  return DateTime.utc(d.year, d.month, d.day, hours, minutes, seconds).toISO();
+}
+
+function calculateBodygraph(dateStr, timeStr, tz, lat, lon, ephemerisPath) {
+  initEphemeris(ephemerisPath);
+
+  // 1. Convert local time → UTC
+  const localDt = DateTime.fromISO(`${dateStr}T${timeStr}`, { zone: tz });
+  if (!localDt.isValid) {
+    throw new Error(`Invalid date/time/timezone: ${dateStr} ${timeStr} ${tz}`);
+  }
+  const utcDt = localDt.toUTC();
+
+  // 2. Birth Julian Day
+  const hourDecimal = utcDt.hour + utcDt.minute / 60 + utcDt.second / 3600;
+  const birthJD = dateToJulianDay(utcDt.year, utcDt.month, utcDt.day, hourDecimal);
+
+  // 3. Personality planetary positions and activations
+  const personalityPositions = getAllPositions(birthJD);
+  const personalityActs = {};
+  for (const planet of PLANET_NAMES) {
+    personalityActs[planet] = getActivation(personalityPositions[planet].longitude);
+  }
+  personalityActs['Earth'] = getOppositeActivation(personalityPositions.Sun.longitude);
+  personalityActs['SouthNode'] = getOppositeActivation(personalityPositions.NorthNode.longitude);
+
+  // 4. Find Design Date (88° retrograde sun)
+  const designJD = findDesignDate(birthJD);
+
+  // 5. Design planetary positions and activations
+  const designPositions = getAllPositions(designJD);
+  const designActs = {};
+  for (const planet of PLANET_NAMES) {
+    designActs[planet] = getActivation(designPositions[planet].longitude);
+  }
+  designActs['Earth'] = getOppositeActivation(designPositions.Sun.longitude);
+  designActs['SouthNode'] = getOppositeActivation(designPositions.NorthNode.longitude);
+
+  // 6. Derive gates, channels, centers
+  const acts = { personality: personalityActs, design: designActs };
+  const activatedGates = getAllActivatedGates(acts);
+  const channels = getChannels(activatedGates);
+  const definedCenters = getDefinedCenters(channels);
+
+  // 7. Derive type, authority, definition
+  const type = getType(channels, definedCenters, activatedGates);
+  const { strategy, signature, notSelfTheme } = getTypeProperties(type);
+  const authority = getAuthority(definedCenters, activatedGates);
+  const definition = getDefinition(channels, definedCenters, activatedGates);
+  const profile = getProfile(personalityActs.Sun.line, designActs.Sun.line);
+  const variable = getVariable(
+    personalityActs.Sun.tone, personalityActs.NorthNode.tone,
+    designActs.Sun.tone, designActs.NorthNode.tone,
+  );
+  const circuitries = getCircuitries(channels);
+
+  // 8. Derive properties
+  const incarnationCross = getIncarnationCross(personalityActs.Sun, designActs.Sun);
+  const determination = getDetermination(designActs.Sun);
+  const environment = getEnvironment(designActs.NorthNode);
+  const view = getView(personalityActs.NorthNode);
+  const motivation = getMotivation(personalityActs.Sun);
+  const cognition = getCognition(designActs.Sun);
+  const sense = getSense(personalityActs.Sun);
+
+  // 9. Center definition flags
+  const centerDef = {};
+  const defined = [];
+  const undefined_ = [];
+  for (const c of CENTER_NAMES) {
+    const isDef = definedCenters.has(c);
+    centerDef[c] = isDef;
+    if (isDef) defined.push(c);
+    else undefined_.push(c);
+  }
+
+  // 10. Assemble result
+  return {
+    input: {
+      date: dateStr,
+      time: timeStr,
+      timezone: tz,
+      latitude: lat,
+      longitude: lon,
+    },
+    birthDateUTC: utcDt.toISO(),
+    designDateUTC: julianDayToISO(designJD),
+    activations: acts,
+    type,
+    strategy,
+    signature,
+    notSelfTheme,
+    authority,
+    definition,
+    profile,
+    incarnationCross,
+    variable,
+    channels,
+    activatedGates: Array.from(activatedGates).sort((a, b) => a - b),
+    definedCenters: defined,
+    undefinedCenters: undefined_,
+    centerDefinition: centerDef,
+    circuitries,
+    determination,
+    environment,
+    view,
+    motivation,
+    cognition,
+    sense,
+  };
+}
+
+module.exports = { calculateBodygraph };

package/src/data/centers.js

@@ -0,0 +1,94 @@
+const CENTER_NAMES = [
+  'Head', 'Ajna', 'Throat', 'G', 'Ego', 'Sacral',
+  'Solar Plexus', 'Spleen', 'Root'
+];
+
+/** Which center each gate belongs to */
+const CENTER_BY_GATE = {
+  1: 'G', 2: 'G', 3: 'Sacral', 4: 'Ajna', 5: 'Sacral',
+  6: 'Solar Plexus', 7: 'G', 8: 'Throat', 9: 'Sacral',
+  10: 'G', 11: 'Ajna', 12: 'Throat', 13: 'G', 14: 'Sacral',
+  15: 'G', 16: 'Throat', 17: 'Ajna', 18: 'Spleen', 19: 'Root',
+  20: 'Throat', 21: 'Ego', 22: 'Solar Plexus', 23: 'Throat',
+  24: 'Ajna', 25: 'G', 26: 'Ego', 27: 'Sacral', 28: 'Spleen',
+  29: 'Sacral', 30: 'Solar Plexus', 31: 'Throat', 32: 'Spleen',
+  33: 'Throat', 34: 'Sacral', 35: 'Throat', 36: 'Solar Plexus',
+  37: 'Solar Plexus', 38: 'Root', 39: 'Root', 40: 'Ego',
+  41: 'Root', 42: 'Sacral', 43: 'Ajna', 44: 'Spleen',
+  45: 'Throat', 46: 'G', 47: 'Ajna', 48: 'Spleen',
+  49: 'Solar Plexus', 50: 'Spleen', 51: 'Ego', 52: 'Root',
+  53: 'Root', 54: 'Root', 55: 'Solar Plexus', 56: 'Throat',
+  57: 'Spleen', 58: 'Root', 59: 'Sacral', 60: 'Root',
+  61: 'Head', 62: 'Throat', 63: 'Head', 64: 'Head',
+};
+
+/** Adjacency graph between centers */
+const ADJACENT_CENTERS = {
+  'Head':          ['Ajna'],
+  'Ajna':          ['Head', 'Throat'],
+  'Throat':        ['Ajna', 'G', 'Ego', 'Sacral', 'Spleen', 'Solar Plexus'],
+  'G':             ['Throat', 'Ego', 'Sacral', 'Spleen'],
+  'Ego':           ['Throat', 'G', 'Spleen', 'Solar Plexus'],
+  'Sacral':        ['Throat', 'G', 'Spleen', 'Solar Plexus', 'Root'],
+  'Solar Plexus':  ['Throat', 'Ego', 'Sacral', 'Root'],
+  'Spleen':        ['Throat', 'G', 'Ego', 'Sacral', 'Root'],
+  'Root':          ['Sacral', 'Spleen', 'Solar Plexus'],
+};
+
+/** Bridging gates between pairs of centers (used for Wide Split detection) */
+const BRIDGING_GATES = {
+  'Head': {
+    'Ajna': [64, 61, 63, 47, 24, 4],
+  },
+  'Ajna': {
+    'Head':   [64, 61, 63, 47, 24, 4],
+    'Throat': [17, 43, 11, 62, 23, 56],
+  },
+  'Throat': {
+    'Ajna':          [17, 43, 11, 62, 23, 56],
+    'Solar Plexus':  [35, 36, 12, 22],
+    'Ego':           [45, 21],
+    'G':             [31, 8, 33, 7, 1, 13, 10],
+    'Sacral':        [34, 20],
+    'Spleen':        [57, 20, 16, 48],
+  },
+  'Solar Plexus': {
+    'Throat': [35, 36, 12, 22],
+    'Ego':    [37, 40],
+    'Sacral': [6, 59],
+    'Root':   [19, 49, 39, 55, 41, 30],
+  },
+  'Ego': {
+    'Throat':        [45, 21],
+    'Solar Plexus':  [37, 40],
+    'G':             [25, 51],
+    'Spleen':        [26, 44],
+  },
+  'G': {
+    'Throat': [31, 8, 33, 7, 1, 13, 10],
+    'Ego':    [25, 51],
+    'Sacral': [15, 2, 46, 10, 34],
+    'Spleen': [57, 10],
+  },
+  'Spleen': {
+    'Throat': [57, 20, 16, 48],
+    'G':      [57, 10],
+    'Ego':    [26, 44],
+    'Sacral': [50, 27, 34, 57],
+    'Root':   [32, 54, 28, 38, 18, 58],
+  },
+  'Sacral': {
+    'Throat':        [34, 20],
+    'G':             [15, 2, 46, 10, 34],
+    'Solar Plexus':  [6, 59],
+    'Spleen':        [50, 27, 34, 57],
+    'Root':          [42, 3, 9, 53, 60, 52],
+  },
+  'Root': {
+    'Spleen':        [32, 54, 28, 38, 18, 58],
+    'Sacral':        [42, 3, 9, 53, 60, 52],
+    'Solar Plexus':  [19, 49, 39, 55, 41, 30],
+  },
+};
+
+module.exports = { CENTER_NAMES, CENTER_BY_GATE, ADJACENT_CENTERS, BRIDGING_GATES };

package/src/data/channels.js

@@ -0,0 +1,81 @@
+/** Map channel string "low-high" to the two centers it connects */
+const DEFINED_CENTERS_BY_CHANNEL = {
+  '1-8':   ['G', 'Throat'],
+  '2-14':  ['G', 'Sacral'],
+  '3-60':  ['Sacral', 'Root'],
+  '4-63':  ['Head', 'Ajna'],
+  '5-15':  ['G', 'Sacral'],
+  '6-59':  ['Solar Plexus', 'Sacral'],
+  '7-31':  ['G', 'Throat'],
+  '9-52':  ['Sacral', 'Root'],
+  '10-20': ['G', 'Throat'],
+  '10-34': ['G', 'Sacral'],
+  '10-57': ['G', 'Spleen'],
+  '11-56': ['Ajna', 'Throat'],
+  '12-22': ['Throat', 'Solar Plexus'],
+  '13-33': ['G', 'Throat'],
+  '16-48': ['Throat', 'Spleen'],
+  '17-62': ['Ajna', 'Throat'],
+  '18-58': ['Spleen', 'Root'],
+  '19-49': ['Solar Plexus', 'Root'],
+  '20-34': ['Throat', 'Sacral'],
+  '20-57': ['Throat', 'Spleen'],
+  '21-45': ['Ego', 'Throat'],
+  '23-43': ['Ajna', 'Throat'],
+  '24-61': ['Head', 'Ajna'],
+  '25-51': ['G', 'Ego'],
+  '26-44': ['Spleen', 'Ego'],
+  '27-50': ['Spleen', 'Sacral'],
+  '28-38': ['Spleen', 'Root'],
+  '29-46': ['G', 'Sacral'],
+  '30-41': ['Solar Plexus', 'Root'],
+  '32-54': ['Spleen', 'Root'],
+  '34-57': ['Sacral', 'Spleen'],
+  '35-36': ['Throat', 'Solar Plexus'],
+  '37-40': ['Ego', 'Solar Plexus'],
+  '39-55': ['Solar Plexus', 'Root'],
+  '42-53': ['Sacral', 'Root'],
+  '47-64': ['Head', 'Ajna'],
+};
+
+/** Map channel string to its circuitry */
+const CIRCUITRY_BY_CHANNEL = {
+  '1-8':   'Individual',
+  '2-14':  'Individual',
+  '3-60':  'Individual',
+  '4-63':  'Collective Logic',
+  '5-15':  'Collective Logic',
+  '6-59':  'Tribal',
+  '7-31':  'Collective Logic',
+  '9-52':  'Collective Logic',
+  '10-20': 'Individual',
+  '10-34': 'Individual',
+  '10-57': 'Individual',
+  '11-56': 'Collective Abstract',
+  '12-22': 'Individual',
+  '13-33': 'Collective Abstract',
+  '16-48': 'Collective Logic',
+  '17-62': 'Collective Logic',
+  '18-58': 'Collective Logic',
+  '19-49': 'Tribal',
+  '20-34': 'Individual',
+  '20-57': 'Individual',
+  '21-45': 'Tribal',
+  '23-43': 'Individual',
+  '24-61': 'Individual',
+  '25-51': 'Individual',
+  '26-44': 'Tribal',
+  '27-50': 'Tribal',
+  '28-38': 'Individual',
+  '29-46': 'Collective Abstract',
+  '30-41': 'Collective Abstract',
+  '32-54': 'Tribal',
+  '34-57': 'Individual',
+  '35-36': 'Collective Abstract',
+  '37-40': 'Tribal',
+  '39-55': 'Individual',
+  '42-53': 'Collective Abstract',
+  '47-64': 'Collective Abstract',
+};
+
+module.exports = { DEFINED_CENTERS_BY_CHANNEL, CIRCUITRY_BY_CHANNEL };