@ihsandeen/aya 1.0.0

package/src/commands/adab.ts

@@ -0,0 +1,24 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { adabData } from '../data/nak';
+import { printCommandHeader } from '../utils/printer';
+
+export const adabCommand = new Command('adab')
+  .description('The Manners Engine (Relationships)')
+  .action(async () => {
+    printCommandHeader('adab');
+    const { relation } = await inquirer.prompt([{
+      type: 'list',
+      name: 'relation',
+      message: 'Select a relationship to improve:',
+      choices: adabData.map(r => r.relation)
+    }]);
+
+    const data = adabData.find(r => r.relation === relation);
+    if (data) {
+      console.log(chalk.blue.bold(`\n  Relationship: ${data.relation}`));
+      console.log(chalk.yellow(`  Quranic Keyword: ${data.arabicKeyword} (${data.meaning})`));
+      console.log(chalk.white(`  Practice: ${data.practice}\n`));
+    }
+  });

package/src/commands/adhan.ts

@@ -0,0 +1,55 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import { exec } from 'child_process';
+import os from 'os';
+import { printCommandHeader } from '../utils/printer';
+
+export const adhanCommand = new Command('adhan')
+  .description('Call to Prayer (Adhan) - Plays audio or shows text')
+  .option('-s, --silent', 'Show text only, do not play audio')
+  .action(async (options) => {
+    printCommandHeader('adhan');
+    console.log(chalk.green.bold('\n  Allahu Akbar, Allahu Akbar\n'));
+
+    const lines = [
+      { arabic: 'الله أكبر الله أكبر', translation: 'God is the Greatest, God is the Greatest' },
+      { arabic: 'أشهد أن لا إله إلا الله', translation: 'I bear witness that there is no god except God' },
+      { arabic: 'أشهد أن محمدا رسول الله', translation: 'I bear witness that Muhammad is the Messenger of God' },
+      { arabic: 'حي على الصلاة', translation: 'Hasten to the prayer' },
+      { arabic: 'حي على الفلاح', translation: 'Hasten to success' },
+      { arabic: 'الله أكبر الله أكبر', translation: 'God is the Greatest, God is the Greatest' },
+      { arabic: 'لا إله إلا الله', translation: 'There is no god except God' }
+    ];
+
+    // Print Adhan beautifully with delays
+    for (const line of lines) {
+      console.log(chalk.yellow.bold(line.arabic));
+      console.log(chalk.gray(line.translation));
+      console.log('');
+      await new Promise(resolve => setTimeout(resolve, 1500));
+    }
+
+    if (!options.silent) {
+      const spinner = ora('Playing Adhan...').start();
+      
+      // Attempt to play a system sound
+      try {
+        if (os.platform() === 'darwin') {
+           // macOS
+           exec('afplay /System/Library/Sounds/Glass.aiff');
+        } else if (os.platform() === 'linux') {
+           // Linux (try paplay or aplay)
+           exec('paplay /usr/share/sounds/freedesktop/stereo/complete.oga || aplay /usr/share/sounds/alsa/Front_Center.wav'); 
+        } else if (os.platform() === 'win32') {
+           // Windows
+           // PowerShell beep
+           exec('powershell -c "(New-Object Media.SoundPlayer \'C:\\Windows\\Media\\notify.wav\').PlaySync();"');
+        }
+      } catch (e) {
+        // Ignore errors if sound fails
+      }
+
+      spinner.succeed('Adhan completed.');
+    }
+  });

package/src/commands/anatomy.ts

@@ -0,0 +1,25 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { anatomyData } from '../data/nak';
+import { printCommandHeader } from '../utils/printer';
+
+export const anatomyCommand = new Command('anatomy')
+  .description('The Spiritual Function of Body Parts')
+  .action(async () => {
+    printCommandHeader('anatomy');
+    const { part } = await inquirer.prompt([{
+      type: 'list',
+      name: 'part',
+      message: 'Select a body part to understand its spiritual role:',
+      choices: anatomyData.map(p => p.part)
+    }]);
+
+    const data = anatomyData.find(p => p.part === part);
+    if (data) {
+      console.log(chalk.blue.bold(`\n  ${data.part} (${data.arabic})`));
+      console.log(chalk.white(`  Function: ${data.function}`));
+      console.log(chalk.green(`  Spiritual Role: ${data.spiritualRole}`));
+      console.log(chalk.gray(`\n  Reflection:\n  ${data.reflection}\n`));
+    }
+  });

package/src/commands/blame.ts

@@ -0,0 +1,31 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { printCommandHeader } from '../utils/printer';
+import boxen from 'boxen';
+
+export const blameCommand = new Command('blame')
+  .description('Self-reflection tool (Muhasabah)')
+  .action(() => {
+    printCommandHeader('blame');
+    
+    console.log(
+      boxen(
+        chalk.red.bold(' git blame? No. ') + '\n' +
+        chalk.yellow(" It wasn't the compiler. It wasn't the PM. ") + '\n\n' +
+        chalk.white.italic('"Nay, man is evidence against himself." (75:14)'),
+        {
+          padding: 1,
+          margin: 1,
+          borderStyle: 'double',
+          borderColor: 'red',
+          title: 'Muhasabah (Self-Audit)',
+          titleAlignment: 'center'
+        }
+      )
+    );
+
+    console.log(chalk.cyan(' ➜ Take a breath.'));
+    console.log(chalk.cyan(' ➜ Say Astaghfirullah.'));
+    console.log(chalk.cyan(' ➜ Debug with a clear heart.'));
+    console.log('');
+  });

package/src/commands/commit.ts

@@ -0,0 +1,42 @@
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { printCommandHeader } from '../utils/printer';
+import { logger } from '../utils/logger';
+
+export const commitCommand = new Command('commit')
+  .description('Commit a good deed or intention')
+  .option('-m, --message <message>', 'The deed you commit to')
+  .action(async (options) => {
+    printCommandHeader('commit');
+    let message = options.message;
+
+    if (!message) {
+      const answers = await inquirer.prompt([
+        {
+          type: 'input',
+          name: 'message',
+          message: 'What good deed are you committing to today?',
+          validate: (input) => input.length > 0 ? true : 'Please enter a valid commitment.'
+        }
+      ]);
+      message = answers.message;
+    }
+
+    // Log the commit using our new utility
+    const commit = logger.logCommit(message);
+    const totalDeeds = logger.getTotalDeeds();
+
+    // NAK Style Output
+    console.log(chalk.gray(`[main ${commit.hash}] Commit confirmed.`));
+    console.log(chalk.green(' Angels are recording. 📝'));
+    console.log(chalk.cyan(` + 1 good deed added to your scale.`));
+    
+    // Encouragement based on total deeds
+    let encouragement = "";
+    if (totalDeeds % 10 === 0) encouragement = chalk.yellow.bold(" MashaAllah! A milestone reached!");
+    else if (totalDeeds === 1) encouragement = chalk.yellow.bold(" Bismillah! Your first step.");
+
+    console.log(chalk.white(` Total good deeds recorded: ${chalk.bold(totalDeeds)}`) + encouragement);
+    console.log(chalk.dim('\n"Verily, the good deeds remove the evil deeds." (11:114)'));
+  });

package/src/commands/diff.ts

@@ -0,0 +1,56 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { diffData } from '../data/nak';
+import { printCommandHeader } from '../utils/printer';
+
+export const diffCommand = new Command('diff')
+  .description('The "Almost" Word (Synonym Challenge)')
+  .action(async () => {
+    printCommandHeader('diff');
+    console.clear();
+    console.log(chalk.yellow.bold('\n  Aya Diff: The Precision of Divine Speech'));
+    console.log(chalk.gray('Why did Allah use *this* word and not *that* one?\n'));
+
+    // Select a random challenge or iterate? Let's just pick one for now or loop.
+    // Let's loop through all available challenges.
+    
+    for (const challenge of diffData) {
+      console.log(chalk.white.bold(`Prompt: "${challenge.prompt}"`));
+      
+      const answer = await inquirer.prompt([{
+        type: 'list',
+        name: 'choice',
+        message: 'Which word is used in the Quran?',
+        choices: challenge.options.map(o => ({
+          name: o.label,
+          value: o.value
+        }))
+      }]);
+
+      const selected = challenge.options.find(o => o.value === answer.choice);
+      const isCorrect = selected?.isCorrect;
+
+      if (isCorrect) {
+        console.log(chalk.green.bold('\n  Correct!'));
+      } else {
+        console.log(chalk.red.bold(`\n  Not quite. The Quran uses: ${challenge.reveal}`));
+      }
+
+      console.log(chalk.cyan.italic(`\n  Lesson: ${challenge.lesson}`));
+      console.log(chalk.gray('----------------------------------------\n'));
+
+      // Pause before next?
+      const { next } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'next',
+        message: 'Next challenge?',
+        default: true
+      }]);
+
+      if (!next) break;
+      console.clear();
+    }
+    
+    console.log(chalk.yellow('End of challenges. SubhanAllah!'));
+  });

package/src/commands/dua.ts

@@ -0,0 +1,34 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { duaData } from '../data/nak';
+import { printCommandHeader } from '../utils/printer';
+
+export const duaCommand = new Command('dua')
+  .description('Prophetic Duas with Context & Backstory')
+  .action(async () => {
+    printCommandHeader('dua');
+    const { situation } = await inquirer.prompt([{
+      type: 'list',
+      name: 'situation',
+      message: 'What are you feeling / facing?',
+      choices: duaData.map(d => ({ name: d.situation, value: d }))
+    }]);
+
+    displayDua(situation);
+  });
+
+function displayDua(dua: any) {
+  console.clear();
+  console.log(chalk.yellow.bold(`\n  The Dua of ${dua.prophet}`));
+  console.log(chalk.gray(`  Situation: ${dua.situation}\n`));
+  
+  console.log(chalk.cyan.bold('  The Backstory (Context):'));
+  console.log(chalk.white(`  ${dua.context}\n`));
+  
+  console.log(chalk.green.bold(`  "${dua.arabic}"`));
+  console.log(chalk.white.italic(`  "${dua.translation}"\n`));
+  
+  console.log(chalk.magenta.bold('  The Gem:'));
+  console.log(chalk.white(`  ${dua.gem}\n`));
+}

package/src/commands/fast.ts

@@ -0,0 +1,35 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { fastData } from '../data/nak';
+import { printCommandHeader } from '../utils/printer';
+
+export const fastCommand = new Command('fast')
+  .description('Sunnah Fasting Reminders & Spiritual Why')
+  .action(async () => {
+    printCommandHeader('fast');
+    console.clear();
+    console.log(chalk.green.bold('\n  The Shield of Fasting (As-Sawm)\n'));
+    
+    const today = new Date();
+    const day = today.getDay(); // 0 = Sun, 1 = Mon, 4 = Thu
+    
+    // Check if tomorrow is Mon (1) or Thu (4)
+    const isSunnahTomorrow = day === 0 || day === 3;
+    const isSunnahToday = day === 1 || day === 4;
+
+    if (isSunnahToday) {
+      console.log(chalk.yellow.bold('  Today is a Sunnah fasting day! (Monday/Thursday)'));
+      console.log(chalk.gray('  "The gates of Paradise are opened..."\n'));
+    } else if (isSunnahTomorrow) {
+      console.log(chalk.cyan.bold('  Tomorrow is a Sunnah fasting day! Prepare your Suhoor.'));
+    }
+
+    console.log(chalk.white.bold('  Why we fast (beyond Ramadan):'));
+    
+    fastData.forEach(f => {
+      console.log(chalk.blue.bold(`\n  ${f.type} (${f.when})`));
+      console.log(chalk.white(`  Reward: ${f.reward}`));
+      console.log(chalk.gray.italic(`  "${f.spiritualWhy}"`));
+    });
+    console.log('\n');
+  });

package/src/commands/friday.ts

@@ -0,0 +1,17 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { fridayData } from '../data/nak';
+import { printCommandHeader } from '../utils/printer';
+
+export const fridayCommand = new Command('friday')
+  .description('The Jumu\'ah Manager')
+  .action(() => {
+    printCommandHeader('friday');
+    console.log(chalk.cyan.bold('\n  Friday (Jumu\'ah) Checklist & Reflections\n'));
+
+    fridayData.forEach((item) => {
+      console.log(chalk.blue.bold(`  [ ] ${item.item}`));
+      console.log(chalk.white(`      Significance: ${item.significance}`));
+      console.log(chalk.gray(`      Deep Dive: ${item.nakNote}\n`));
+    });
+  });

package/src/commands/hero.ts

@@ -0,0 +1,73 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { heroData } from '../data/nak';
+import { printCommandHeader } from '../utils/printer';
+
+const drawBar = (val: number, max: number = 10) => {
+  // Use simple ASCII blocks if needed, but standard ones are fine
+  const filledChar = '█';
+  const emptyChar = '░';
+  const filled = filledChar.repeat(val);
+  const empty = emptyChar.repeat(max - val);
+  
+  // Color logic
+  let color = chalk.red;
+  if (val >= 8) color = chalk.green;
+  else if (val >= 5) color = chalk.yellow;
+  
+  return `${color(filled)}${chalk.gray(empty)} ${val}/${max}`;
+};
+
+export const heroCommand = new Command('hero')
+  .description('The Prophet Profile (RPG Character Sheet)')
+  .argument('[name]', 'Name of the Prophet (e.g. Musa)')
+  .action(async (name) => {
+    printCommandHeader('hero');
+    let data = name
+      ? heroData.find(h => h.name.toLowerCase().includes(name.toLowerCase()))
+      : null;
+
+    if (!data && name) {
+      console.log(chalk.red('Profile not found for that Prophet.'));
+    }
+
+    if (!data) {
+      const { choice } = await inquirer.prompt([{
+        type: 'list',
+        name: 'choice',
+        message: 'Select a Prophet to view profile:',
+        choices: heroData.map(h => ({
+          name: h.name,
+          value: h
+        }))
+      }]);
+      data = choice;
+    }
+
+    if (!data) return;
+
+    console.clear();
+    console.log(chalk.cyan.bold(`\n  Aya Hero: ${data.name}`));
+    console.log(chalk.gray(`Title: ${data.title}\n`));
+
+    console.log(chalk.white.bold('  Stats:'));
+    console.log(`Strength:  ${drawBar(data.stats.strength)}`);
+    console.log(`Speech:    ${drawBar(data.stats.speech)}`);
+    console.log(`Patience:  ${drawBar(data.stats.patience)}`);
+    console.log(`Wisdom:    ${drawBar(data.stats.wisdom)}`);
+    console.log(chalk.gray('----------------------------------------'));
+
+    console.log(chalk.yellow.bold('\n  Special Ability:'));
+    console.log(chalk.white(data.specialAbility));
+
+    console.log(chalk.red.bold('\n  Weakness / Challenge:'));
+    console.log(chalk.white(data.weakness));
+
+    console.log(chalk.magenta.bold('\n  Arch-Nemesis:'));
+    console.log(chalk.white(data.archNemesis));
+
+    console.log(chalk.blue.bold('\n  Quranic Profile:'));
+    console.log(chalk.italic(data.quranicProfile));
+    console.log('');
+  });

package/src/commands/hijri.ts

@@ -0,0 +1,43 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import axios from 'axios';
+import ora from 'ora';
+import { format } from 'date-fns';
+import { printCommandHeader } from '../utils/printer';
+
+export const hijriCommand = new Command('hijri')
+  .description('Date Converter (Gregorian <-> Hijri)')
+  .option('-d, --date <date>', 'Date to convert (DD-MM-YYYY)')
+  .action(async (options) => {
+    printCommandHeader('hijri');
+    const spinner = ora('Converting date...').start();
+    
+    try {
+      const today = new Date();
+      const dateStr = options.date || format(today, 'dd-MM-yyyy');
+      
+      // Use Aladhan API for accurate conversion based on sighting adjustment if needed
+      const response = await axios.get(`http://api.aladhan.com/v1/gToH/${dateStr}`);
+      const data = response.data.data;
+      const hijri = data.hijri;
+      const gregorian = data.gregorian;
+
+      spinner.stop();
+
+      console.clear();
+      console.log(chalk.green.bold('\n  Islamic Date Converter'));
+      console.log(chalk.gray('----------------------------------------'));
+      
+      console.log(chalk.white('Gregorian: ') + chalk.bold(`${gregorian.day} ${gregorian.month.en} ${gregorian.year}`));
+      console.log(chalk.yellow('Hijri:     ') + chalk.bold(`${hijri.day} ${hijri.month.en} ${hijri.year}`));
+      console.log(chalk.gray(`(${hijri.month.ar})`));
+      
+      console.log('');
+      console.log(chalk.cyan(`Weekday:   ${hijri.weekday.en} (${hijri.weekday.ar})`));
+      console.log('');
+      
+    } catch (error) {
+      spinner.fail('Conversion failed.');
+      console.log(chalk.red('Please ensure date format is DD-MM-YYYY'));
+    }
+  });

package/src/commands/history.ts

@@ -0,0 +1,103 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import ora from 'ora';
+import { eventsList, HistoricalEvent } from '../data/events';
+import { printCommandHeader } from '../utils/printer';
+
+const sleep = (ms: number) => new Promise(r => setTimeout(r, ms));
+
+export const historyCommand = new Command('history')
+  .description('Interactive Timeline of Revelation')
+  .argument('[event]', 'Name of the historical event (e.g., badr, uhud, migration)')
+  .action(async (event) => {
+    printCommandHeader('history');
+    
+    if (event) {
+      const selectedEvent = eventsList.find(e => e.name.toLowerCase().includes(event.toLowerCase()) || e.id.toLowerCase().includes(event.toLowerCase()));
+      if (selectedEvent) {
+        await displayEvent(selectedEvent);
+      } else {
+        console.log(chalk.red('Event not found.'));
+      }
+      return;
+    }
+
+    // Interactive Mode
+    let currentIndex = 0;
+    let keepRunning = true;
+
+    while (keepRunning) {
+      console.clear();
+      const currentEvent = eventsList[currentIndex];
+      
+      console.log(chalk.yellow.bold('\n  Timeline of the Seerah\n'));
+      
+      // Timeline visualization
+      const totalEvents = eventsList.length;
+      const progress = Math.round(((currentIndex + 1) / totalEvents) * 20);
+      const progressBar = '█'.repeat(progress) + '░'.repeat(20 - progress);
+      console.log(chalk.gray(`[${progressBar}] ${currentIndex + 1}/${totalEvents}`));
+      
+      await displayEvent(currentEvent, false);
+
+      const { action } = await inquirer.prompt([
+        {
+          type: 'list',
+          name: 'action',
+          message: 'Navigate:',
+          choices: [
+            { name: 'Next Event ▶', value: 'next', disabled: currentIndex === eventsList.length - 1 },
+            { name: 'Previous Event ◀', value: 'prev', disabled: currentIndex === 0 },
+            { name: 'Select Specific Event', value: 'select' },
+            { name: 'Exit', value: 'exit' }
+          ]
+        }
+      ]);
+
+      if (action === 'next') {
+        currentIndex++;
+      } else if (action === 'prev') {
+        currentIndex--;
+      } else if (action === 'select') {
+        const { selected } = await inquirer.prompt([
+          {
+            type: 'list',
+            name: 'selected',
+            message: 'Jump to:',
+            choices: eventsList.map((e, index) => ({ name: `${e.year} - ${e.name}`, value: index }))
+          }
+        ]);
+        currentIndex = selected;
+      } else {
+        keepRunning = false;
+      }
+    }
+  });
+
+async function displayEvent(event: HistoricalEvent, animate = true) {
+  if (animate) {
+    const spinner = ora('Traveling back in time...').start();
+    await sleep(1000);
+    spinner.stop();
+  }
+
+  console.log(chalk.green.bold(`\n  Year: ${event.year}`));
+  console.log(chalk.green(`  Location: ${event.location}`));
+  console.log(chalk.blue.bold(`Event: ${event.name}`));
+  console.log('');
+  
+  console.log(chalk.white.italic(event.scene));
+  console.log('');
+  
+  if (animate) await sleep(1500);
+
+  console.log(chalk.yellow.bold('  Revelation Sent Down:'));
+  console.log(chalk.cyan(`"${event.revelation}"`));
+  console.log(chalk.gray(`(Surah ${event.ayah})`));
+  
+  if (event.details) {
+      console.log(chalk.gray(`\nNote: ${event.details}`));
+  }
+  console.log('');
+}

package/src/commands/init.ts

@@ -0,0 +1,53 @@
+import { Command } from 'commander';
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import { setConfig, getConfig } from '../utils/config';
+import { printCommandHeader } from '../utils/printer';
+
+export const initCommand = new Command('init')
+  .description('Set your intention (niyyah) for this session')
+  .action(async () => {
+    printCommandHeader('init');
+    const config = getConfig();
+
+    console.log(chalk.green('Bismillah. Let us begin with the right intention.'));
+    
+    const answers = await inquirer.prompt([
+      {
+        type: 'input',
+        name: 'name',
+        message: 'What is your name?',
+        default: config.name || 'Abdullah'
+      },
+      {
+        type: 'input',
+        name: 'intention',
+        message: 'What is your intention for this session?',
+        default: config.intention || 'Seeking the pleasure of Allah through code'
+      },
+      {
+        type: 'input',
+        name: 'city',
+        message: 'Where are you located (City)?',
+        default: config.location?.city || 'Mecca'
+      },
+      {
+        type: 'input',
+        name: 'country',
+        message: 'Where are you located (Country)?',
+        default: config.location?.country || 'Saudi Arabia'
+      }
+    ]);
+
+    setConfig({
+      name: answers.name,
+      intention: answers.intention,
+      location: {
+        city: answers.city,
+        country: answers.country
+      }
+    });
+
+    console.log(chalk.cyan(`\n✨ Intention set: "${answers.intention}"`));
+    console.log(chalk.gray('May Allah accept your efforts and place Barakah in your code.'));
+  });

package/src/commands/invest.ts

@@ -0,0 +1,22 @@
+import { Command } from 'commander';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import { printCommandHeader } from '../utils/printer';
+
+export const investCommand = new Command('invest')
+  .description('Sadaqah Calculator (The Infinite ROI)')
+  .action(async () => {
+    printCommandHeader('invest');
+    const { amount } = await inquirer.prompt([{
+      type: 'number',
+      name: 'amount',
+      message: 'Enter amount to invest (Sadaqah):'
+    }]);
+
+    console.log(chalk.yellow.bold(`\n  Investment Analysis for $${amount}`));
+    console.log(chalk.white('\n  Guarantor: The Lord of the Worlds'));
+    console.log(chalk.green('  Multiplier: 700x to Infinity (Surah Al-Baqarah 2:261)'));
+    console.log(chalk.blue(`  Minimum Return (Hereafter): ${amount * 700} deeds`));
+    console.log(chalk.cyan('  Risk Factor: 0% ("Charity does not decrease wealth")'));
+    console.log(chalk.gray('\n  "Who is it that would loan Allah a goodly loan so He may multiply it for him many times over?" (2:245)\n'));
+  });