@ihsandeen/aya 1.0.0

package/dist/data/tafsir.js

@@ -0,0 +1,157 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tafsirData = void 0;
+exports.tafsirData = [
+    {
+        surah: 'Ad-Duhaa',
+        ayah: 3,
+        steps: [
+            {
+                word: 'Maa',
+                meaning: 'Not / Negation',
+                explanation: 'The sentence starts with a strong negation. Allah is immediately shutting down the whispers of the disbelievers who said He had abandoned the Prophet (saw).'
+            },
+            {
+                word: 'wadda\'aka',
+                meaning: 'He said goodbye / He bid farewell',
+                explanation: 'From "wada\'a". This isn\'t just "left". It\'s a warm, affectionate goodbye. Like when a mother says goodbye to her child. Allah is saying "I didn\'t even say a warm goodbye to you, let alone abandon you."'
+            },
+            {
+                word: 'Rabbuka',
+                meaning: 'Your Lord / Your Master / Your Sustainer',
+                explanation: 'He didn\'t say "Allah". He said "Your Lord". The one who has been raising you, sustaining you, and caring for you from the beginning. It\'s personal. "YOUR" Lord.'
+            },
+            {
+                word: 'wa maa qalaa',
+                meaning: 'And He is not displeased / He does not hate',
+                explanation: '"Qalaa" means intense displeasure or hate. Notice He didn\'t say "wa maa qalaa-ka" (He is not displeased with YOU). He left out the "you" (ka). Why? Because He loves the Prophet (saw) so much, He didn\'t even want to put the word "hate" and "you" in the same sentence. SubhanAllah.'
+            }
+        ],
+        finalThought: "If you feel distant from Allah, know that He hasn't said goodbye. He is your Rabb. He is sustaining you even in your silence."
+    },
+    {
+        surah: 'Al-Fatiha',
+        ayah: 5,
+        steps: [
+            {
+                word: 'Iyyaka',
+                meaning: 'Only You',
+                explanation: 'Grammatically, "Na\'budu" (We worship) should come first. But Allah placed "Iyyaka" (Only You) at the front. This is "Taqdeem" for "Ikhtisas" (Exclusivity). Not "We worship You", but "It is ONLY You we worship".'
+            },
+            {
+                word: 'Na\'budu',
+                meaning: 'We worship / We enslave ourselves',
+                explanation: 'From "Abd" (Slave). Worship isn\'t just prayer. It is slavery. It is total submission. And notice "We". Even when you pray alone, you are part of the "We"—the Ummah.'
+            },
+            {
+                word: 'Wa Iyyaka',
+                meaning: 'And Only You',
+                explanation: 'Repetition for emphasis. We are not just monotheists in worship, but monotheists in seeking help.'
+            },
+            {
+                word: 'Nasta\'een',
+                meaning: 'We seek help / We ask for aid',
+                explanation: 'From "Isti\'anah". This isn\'t just "help me lift this box". It is asking for help in a matter you are already struggling with. You have to make the effort first, then ask for His aid to complete it.'
+            }
+        ],
+        finalThought: "You can't skip to 'Nasta'een' (Help me) without first committing to 'Na'budu' (I am your slave). The help comes to the one who serves."
+    },
+    {
+        surah: 'Al-Asr',
+        ayah: 1,
+        steps: [
+            {
+                word: 'Wal-Asr',
+                meaning: 'By Time',
+                explanation: 'Allah swears by "Time" (Asr). But Asr isn\'t just time; it\'s the squeezing of time. It\'s the late afternoon when the day is slipping away. He is swearing by the very thing we are losing every second.'
+            },
+            {
+                word: 'Inna',
+                meaning: 'Indeed / Verily',
+                explanation: 'Emphasis. No doubt about it.'
+            },
+            {
+                word: 'Al-Insaan',
+                meaning: 'The Human Being',
+                explanation: 'He didn\'t say "The Disbeliever". He said "The Human". Every single one of us. We are all in the same boat.'
+            },
+            {
+                word: 'La-fee Khusr',
+                meaning: 'Is surely in loss',
+                explanation: 'We aren\'t "going" to be in loss. We are *drowning* in loss right now. Like ice melting. Every breath is a capital loss unless invested.'
+            }
+        ],
+        finalThought: "You are running out of time. The only way to stop the loss is to invest your time in Iman and good deeds."
+    },
+    {
+        surah: 'Al-Ikhlas',
+        ayah: 1,
+        steps: [
+            {
+                word: 'Qul',
+                meaning: 'Say / Declare',
+                explanation: 'A direct command. Don\'t just know it, announce it. This is your identity.'
+            },
+            {
+                word: 'Huwa Allahu',
+                meaning: 'He is Allah',
+                explanation: 'The name Allah is unique. It has no plural, no gender. It is the proper name of God.'
+            },
+            {
+                word: 'Ahad',
+                meaning: 'The One / The Unique',
+                explanation: 'Not "Wahid" (one in number), but "Ahad" (Unique in every way). There is nothing comparable to Him. He is a category of One.'
+            }
+        ],
+        finalThought: "Purify your concept of God. He is not like anything you can imagine."
+    },
+    {
+        surah: 'Al-Falaq',
+        ayah: 1,
+        steps: [
+            {
+                word: 'Qul',
+                meaning: 'Say',
+                explanation: 'Again, a command to seek refuge actively.'
+            },
+            {
+                word: 'A\'udhu',
+                meaning: 'I seek refuge / I take cover',
+                explanation: 'Imagine a fortress. You are running into it for safety. You are admitting you are weak and need protection.'
+            },
+            {
+                word: 'Bi Rabbil Falaq',
+                meaning: 'In the Lord of the Daybreak',
+                explanation: 'Falaq is the splitting of darkness by light. Just as He splits the night to bring the dawn, He can split your problems to bring relief.'
+            }
+        ],
+        finalThought: "Darkness is temporary. The Lord of the Dawn is always ready to bring the light."
+    },
+    {
+        surah: 'An-Nas',
+        ayah: 1,
+        steps: [
+            {
+                word: 'Qul A\'udhu',
+                meaning: 'Say: I seek refuge',
+                explanation: 'We start with seeking protection again.'
+            },
+            {
+                word: 'Bi Rabbin-Nas',
+                meaning: 'In the Lord of Mankind',
+                explanation: 'He created us, sustains us, and owns us.'
+            },
+            {
+                word: 'Malikin-Nas',
+                meaning: 'The King of Mankind',
+                explanation: 'He has full authority over all people, including those who wish you harm.'
+            },
+            {
+                word: 'Ilahin-Nas',
+                meaning: 'The God of Mankind',
+                explanation: 'The only one worthy of worship and total devotion.'
+            }
+        ],
+        finalThought: "He is your Lord, your King, and your God. Who can harm you when you are with Him?"
+    }
+];

package/dist/data/vocab.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vocabList = void 0;
+exports.vocabList = [
+    // Surah Al-Fatiha
+    {
+        id: 'fatiha_1',
+        ayah: '_____ iyyaka na\'budu wa iyyaka nasta\'een (1:5)',
+        missingWord: '[?]',
+        answer: 'Iyyaka',
+        meaning: 'Only You',
+        category: 'fatiha'
+    },
+    {
+        id: 'fatiha_2',
+        ayah: 'Ihdina al-sirat al-_____ (1:6)',
+        missingWord: '[?]',
+        answer: 'mustaqeem',
+        meaning: 'straight / upright',
+        category: 'fatiha'
+    },
+    {
+        id: 'fatiha_3',
+        ayah: 'Maliki yawm al-_____ (1:4)',
+        missingWord: '[?]',
+        answer: 'deen',
+        meaning: 'judgment / recompense',
+        category: 'fatiha'
+    },
+    {
+        id: 'fatiha_4',
+        ayah: 'Al-hamdu lillahi rabbi al-_____ (1:2)',
+        missingWord: '[?]',
+        answer: 'alameen',
+        meaning: 'worlds / universe',
+        category: 'fatiha'
+    },
+    // Names of Allah
+    {
+        id: 'names_1',
+        ayah: 'Wa huwa al-Ghafoor al-_____ (85:14)',
+        missingWord: '[?]',
+        answer: 'wadood',
+        meaning: 'The Loving / Affectionate',
+        category: 'names_of_allah'
+    },
+    {
+        id: 'names_2',
+        ayah: 'Qul huwa Allahu _____ (112:1)',
+        missingWord: '[?]',
+        answer: 'ahad',
+        meaning: 'The One / Unique',
+        category: 'names_of_allah'
+    },
+    {
+        id: 'names_3',
+        ayah: 'Ar-Rahman _____ (55:1)',
+        missingWord: '[?]',
+        answer: 'Ar-Raheem',
+        meaning: 'The Most Merciful',
+        category: 'names_of_allah'
+    },
+    // Common Words
+    {
+        id: 'common_1',
+        ayah: 'Inna ma\'al usri _____ (94:6)',
+        missingWord: '[?]',
+        answer: 'yusra',
+        meaning: 'relief / ease',
+        category: 'common'
+    },
+    {
+        id: 'common_2',
+        ayah: 'Hasbuna Allah wa ni\'mal _____ (3:173)',
+        missingWord: '[?]',
+        answer: 'wakil',
+        meaning: 'disposer of affairs / trustee',
+        category: 'common'
+    },
+    // Short Surahs
+    {
+        id: 'short_1',
+        ayah: 'Wama _____ rabbuka wama qalaa (93:3)',
+        missingWord: '[?]',
+        answer: 'wadda\'aka',
+        meaning: 'said goodbye / abandoned',
+        category: 'short_surahs'
+    },
+    {
+        id: 'short_2',
+        ayah: 'Inna a\'tayna kal _____ (108:1)',
+        missingWord: '[?]',
+        answer: 'kawthar',
+        meaning: 'abundance / river in paradise',
+        category: 'short_surahs'
+    },
+    {
+        id: 'short_3',
+        ayah: 'Idha ja\'a nasrullahi wal _____ (110:1)',
+        missingWord: '[?]',
+        answer: 'fath',
+        meaning: 'victory / opening',
+        category: 'short_surahs'
+    }
+];

package/dist/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const chalk_1 = __importDefault(require("chalk"));
+const figlet_1 = __importDefault(require("figlet"));
+const init_1 = require("./commands/init");
+const pull_1 = require("./commands/pull");
+const status_1 = require("./commands/status");
+const commit_1 = require("./commands/commit");
+const blame_1 = require("./commands/blame");
+const push_1 = require("./commands/push");
+const journal_1 = require("./commands/journal");
+const tafsir_1 = require("./commands/tafsir");
+const memorize_1 = require("./commands/memorize");
+const qibla_1 = require("./commands/qibla");
+const adhan_1 = require("./commands/adhan");
+const parable_1 = require("./commands/parable");
+const history_1 = require("./commands/history");
+const nazm_1 = require("./commands/nazm");
+const diff_1 = require("./commands/diff");
+const mirror_1 = require("./commands/mirror");
+const sound_1 = require("./commands/sound");
+const lens_1 = require("./commands/lens");
+const scene_1 = require("./commands/scene");
+const hero_1 = require("./commands/hero");
+const hijri_1 = require("./commands/hijri");
+const zakat_1 = require("./commands/zakat");
+const tasbih_1 = require("./commands/tasbih");
+const prayers_1 = require("./commands/prayers");
+const names_1 = require("./commands/names");
+const dua_1 = require("./commands/dua");
+const fast_1 = require("./commands/fast");
+const sunnah_1 = require("./commands/sunnah");
+const sleep_1 = require("./commands/sleep");
+const anatomy_1 = require("./commands/anatomy");
+const journey_1 = require("./commands/journey");
+const nature_1 = require("./commands/nature");
+const wudu_1 = require("./commands/wudu");
+const invest_1 = require("./commands/invest");
+const sabr_1 = require("./commands/sabr");
+const shukr_1 = require("./commands/shukr");
+const friday_1 = require("./commands/friday");
+const adab_1 = require("./commands/adab");
+const seek_1 = require("./commands/seek");
+const repo_1 = require("./commands/repo");
+const program = new commander_1.Command();
+// Bismillah Header
+console.log(chalk_1.default.dim('In the name of Allah, the Most Gracious, the Most Merciful'));
+console.log(chalk_1.default.green(figlet_1.default.textSync('aya', { horizontalLayout: 'full' })));
+program
+    .name('aya')
+    .description('A CLI for the mindful Muslim developer')
+    .version('1.0.0')
+    .action(() => {
+    program.outputHelp();
+});
+// Register Commands
+const commands = [
+    init_1.initCommand, pull_1.pullCommand, status_1.statusCommand, commit_1.commitCommand, blame_1.blameCommand,
+    push_1.pushCommand, journal_1.journalCommand, tafsir_1.tafsirCommand, memorize_1.memorizeCommand, qibla_1.qiblaCommand,
+    adhan_1.adhanCommand, parable_1.parableCommand, history_1.historyCommand, nazm_1.nazmCommand, diff_1.diffCommand,
+    mirror_1.mirrorCommand, sound_1.soundCommand, lens_1.lensCommand, scene_1.sceneCommand, hero_1.heroCommand,
+    hijri_1.hijriCommand, zakat_1.zakatCommand, tasbih_1.tasbihCommand, prayers_1.prayersCommand, names_1.namesCommand,
+    dua_1.duaCommand, fast_1.fastCommand, sunnah_1.sunnahCommand, sleep_1.sleepCommand, anatomy_1.anatomyCommand,
+    journey_1.journeyCommand, nature_1.natureCommand, wudu_1.wuduCommand, invest_1.investCommand, sabr_1.sabrCommand,
+    shukr_1.shukrCommand, friday_1.fridayCommand, adab_1.adabCommand, seek_1.seekCommand, repo_1.repoCommand
+];
+commands.forEach(cmd => program.addCommand(cmd));
+// Global Error Handler
+process.on('uncaughtException', (error) => {
+    if (error instanceof Error && error.message.includes('EPIPE')) {
+        // Ignore EPIPE errors (broken pipe) often caused by piping output
+        return;
+    }
+    console.error(chalk_1.default.red('\n❌ An unexpected error occurred (Qadar Allah).'));
+    console.error(chalk_1.default.gray(error.message));
+    process.exit(1);
+});
+program.parse(process.argv);
+if (!process.argv.slice(2).length) {
+    program.outputHelp();
+}

package/dist/server.js

@@ -0,0 +1,140 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.startServer = void 0;
+const http_1 = __importDefault(require("http"));
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const logger_1 = require("./utils/logger");
+const PUBLIC_DIR = path_1.default.join(__dirname, '../public');
+const serveFile = (res, filePath, contentType = 'text/html') => {
+    fs_1.default.readFile(filePath, (err, content) => {
+        if (err) {
+            if (err.code === 'ENOENT') {
+                res.writeHead(404);
+                res.end('Not Found');
+            }
+            else {
+                res.writeHead(500);
+                res.end(`Server Error: ${err.code}`);
+            }
+        }
+        else {
+            res.writeHead(200, { 'Content-Type': contentType });
+            res.end(content, 'utf-8');
+        }
+    });
+};
+const readBody = (req) => {
+    return new Promise((resolve, reject) => {
+        let body = '';
+        req.on('data', chunk => { body += chunk.toString(); });
+        req.on('end', () => {
+            try {
+                resolve(body ? JSON.parse(body) : {});
+            }
+            catch (e) {
+                reject(e);
+            }
+        });
+        req.on('error', (err) => reject(err));
+    });
+};
+const startServer = (port = 0) => {
+    return new Promise((resolve) => {
+        const server = http_1.default.createServer(async (req, res) => {
+            // Basic Router
+            if (req.url === '/' || req.url === '/index.html') {
+                serveFile(res, path_1.default.join(PUBLIC_DIR, 'index.html'));
+            }
+            else if (req.url === '/repo') {
+                serveFile(res, path_1.default.join(PUBLIC_DIR, 'repo.html'));
+            }
+            else if (req.url === '/api/commits') {
+                // API Endpoint: Serve commits log as JSON using the Logger utility
+                try {
+                    const commits = logger_1.logger.getCommits();
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify(commits));
+                }
+                catch (error) {
+                    res.writeHead(500, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify({ error: 'Failed to read logs' }));
+                }
+            }
+            else if (req.url === '/api/issues') {
+                if (req.method === 'GET') {
+                    const issues = logger_1.logger.getIssues();
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify(issues));
+                }
+                else if (req.method === 'POST') {
+                    try {
+                        const body = await readBody(req);
+                        if (body.title) {
+                            const issue = logger_1.logger.logIssue(body.title);
+                            res.writeHead(201, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify(issue));
+                        }
+                        else {
+                            res.writeHead(400, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({ error: 'Title required' }));
+                        }
+                    }
+                    catch (e) {
+                        res.writeHead(400, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ error: 'Invalid JSON' }));
+                    }
+                }
+            }
+            else if (req.url === '/api/pulls') {
+                if (req.method === 'GET') {
+                    const pulls = logger_1.logger.getPulls();
+                    res.writeHead(200, { 'Content-Type': 'application/json' });
+                    res.end(JSON.stringify(pulls));
+                }
+                else if (req.method === 'POST') {
+                    try {
+                        const body = await readBody(req);
+                        if (body.title) {
+                            const pull = logger_1.logger.logPull(body.title);
+                            res.writeHead(201, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify(pull));
+                        }
+                        else {
+                            res.writeHead(400, { 'Content-Type': 'application/json' });
+                            res.end(JSON.stringify({ error: 'Title required' }));
+                        }
+                    }
+                    catch (e) {
+                        res.writeHead(400, { 'Content-Type': 'application/json' });
+                        res.end(JSON.stringify({ error: 'Invalid JSON' }));
+                    }
+                }
+            }
+            else {
+                // 404 for any other route
+                res.writeHead(404);
+                res.end('Not found');
+            }
+        });
+        server.listen(port, () => {
+            const address = server.address();
+            const assignedPort = typeof address === 'string' ? 0 : address.port;
+            resolve(assignedPort);
+        });
+    });
+};
+exports.startServer = startServer;
+// Only run directly if executed as a script (not imported)
+if (require.main === module) {
+    (0, exports.startServer)().then(port => {
+        console.log(chalk_1.default.green.bold(`\n  🌙 aya Landing Page is running!`));
+        console.log(chalk_1.default.white(`  Open your Book of Deeds:`));
+        console.log(chalk_1.default.cyan.bold(`  http://localhost:${port}/repo`));
+        console.log(chalk_1.default.gray(`\n  Press Ctrl+C to stop.`));
+    });
+}

package/dist/utils/config.js

@@ -0,0 +1,38 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setConfig = exports.getConfig = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const CONFIG_DIR = path_1.default.join(process.cwd(), '.aya');
+const CONFIG_FILE = path_1.default.join(CONFIG_DIR, 'config.json');
+const defaultConfig = {
+    location: {
+        city: 'Mecca',
+        country: 'Saudi Arabia'
+    }
+};
+const getConfig = () => {
+    if (!fs_1.default.existsSync(CONFIG_FILE)) {
+        return defaultConfig;
+    }
+    try {
+        const data = fs_1.default.readFileSync(CONFIG_FILE, 'utf-8');
+        return JSON.parse(data);
+    }
+    catch (error) {
+        return defaultConfig;
+    }
+};
+exports.getConfig = getConfig;
+const setConfig = (newConfig) => {
+    if (!fs_1.default.existsSync(CONFIG_DIR)) {
+        fs_1.default.mkdirSync(CONFIG_DIR, { recursive: true });
+    }
+    const currentConfig = (0, exports.getConfig)();
+    const updatedConfig = { ...currentConfig, ...newConfig };
+    fs_1.default.writeFileSync(CONFIG_FILE, JSON.stringify(updatedConfig, null, 2));
+};
+exports.setConfig = setConfig;

package/dist/utils/logger.js

@@ -0,0 +1,104 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const CONFIG_DIR = path_1.default.join(process.cwd(), '.aya');
+const LOG_FILE = path_1.default.join(CONFIG_DIR, 'commits.log');
+const ISSUES_FILE = path_1.default.join(CONFIG_DIR, 'issues.log');
+const PULLS_FILE = path_1.default.join(CONFIG_DIR, 'pulls.log');
+exports.logger = {
+    ensureInit: () => {
+        if (!fs_1.default.existsSync(CONFIG_DIR)) {
+            fs_1.default.mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+    },
+    // --- Commits (Deeds) ---
+    logCommit: (message) => {
+        exports.logger.ensureInit();
+        const timestamp = new Date().toISOString();
+        // Simple format: [ISO] Message
+        const logEntry = `[${timestamp}] ${message}\n`;
+        fs_1.default.appendFileSync(LOG_FILE, logEntry);
+        return {
+            timestamp,
+            message,
+            hash: Math.random().toString(16).substring(2, 9)
+        };
+    },
+    getCommits: () => {
+        if (!fs_1.default.existsSync(LOG_FILE))
+            return [];
+        try {
+            const content = fs_1.default.readFileSync(LOG_FILE, 'utf-8');
+            const lines = content.split('\n').filter(line => line.trim());
+            return lines.map(line => {
+                // Match [timestamp] message
+                const match = line.match(/^\[(.*?)\] (.*)$/);
+                if (match) {
+                    // Generate a deterministic-looking hash from timestamp
+                    const hash = Math.abs(match[1].split('').reduce((a, b) => { a = ((a << 5) - a) + b.charCodeAt(0); return a & a; }, 0)).toString(16).substring(0, 7);
+                    return {
+                        timestamp: match[1],
+                        message: match[2],
+                        hash: hash
+                    };
+                }
+                return null;
+            }).filter((c) => c !== null);
+        }
+        catch (error) {
+            console.error('Error reading log file:', error);
+            return [];
+        }
+    },
+    getTotalDeeds: () => {
+        if (!fs_1.default.existsSync(LOG_FILE))
+            return 0;
+        const content = fs_1.default.readFileSync(LOG_FILE, 'utf-8');
+        return content.split('\n').filter(line => line.trim()).length;
+    },
+    // --- Issues (Istighfar/Sins) ---
+    logIssue: (title) => {
+        exports.logger.ensureInit();
+        const timestamp = new Date().toISOString();
+        const id = Math.floor(Math.random() * 1000).toString();
+        const entry = JSON.stringify({ id, title, status: 'open', timestamp }) + '\n';
+        fs_1.default.appendFileSync(ISSUES_FILE, entry);
+        return { id, title, status: 'open', timestamp };
+    },
+    getIssues: () => {
+        if (!fs_1.default.existsSync(ISSUES_FILE))
+            return [];
+        try {
+            const content = fs_1.default.readFileSync(ISSUES_FILE, 'utf-8');
+            return content.trim().split('\n').map(line => JSON.parse(line));
+        }
+        catch (e) {
+            return [];
+        }
+    },
+    // --- Pulls (Duas) ---
+    logPull: (title) => {
+        exports.logger.ensureInit();
+        const timestamp = new Date().toISOString();
+        const id = Math.floor(Math.random() * 1000).toString();
+        const entry = JSON.stringify({ id, title, status: 'open', timestamp }) + '\n';
+        fs_1.default.appendFileSync(PULLS_FILE, entry);
+        return { id, title, status: 'open', timestamp };
+    },
+    getPulls: () => {
+        if (!fs_1.default.existsSync(PULLS_FILE))
+            return [];
+        try {
+            const content = fs_1.default.readFileSync(PULLS_FILE, 'utf-8');
+            return content.trim().split('\n').map(line => JSON.parse(line));
+        }
+        catch (e) {
+            return [];
+        }
+    }
+};

package/dist/utils/printer.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.printCommandHeader = void 0;
+const chalk_1 = __importDefault(require("chalk"));
+const boxen_1 = __importDefault(require("boxen"));
+const commands_db_1 = require("../data/commands-db");
+const printCommandHeader = (commandName) => {
+    const data = commands_db_1.commandsDB[commandName];
+    if (!data)
+        return;
+    console.log((0, boxen_1.default)(chalk_1.default.bold.green(data.arabic) + ' ' + chalk_1.default.dim(`(${data.transliteration})`) + '\n' +
+        chalk_1.default.white(data.meaning), {
+        padding: 1,
+        margin: 1,
+        borderStyle: 'round',
+        borderColor: 'green',
+        title: `aya ${data.name}`,
+        titleAlignment: 'center',
+        textAlignment: 'center'
+    }));
+    console.log(chalk_1.default.bold.yellow('📖 The Story (Deep Dive):'));
+    console.log(chalk_1.default.italic.gray(data.story));
+    console.log();
+    console.log(chalk_1.default.bold.blue('🤲 Reflection (Khutbah):'));
+    console.log(chalk_1.default.white(data.reflection));
+    console.log();
+    console.log(chalk_1.default.bold.magenta('💻 Technical Analogy:'));
+    console.log(chalk_1.default.cyan(data.technical));
+    console.log();
+    console.log(chalk_1.default.dim('─'.repeat(50)));
+    console.log();
+};
+exports.printCommandHeader = printCommandHeader;