athar-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ameen
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,242 @@
+# أثر — Athar
+
+> **Every mistake leaves a trace, every lesson leaves an impact.**
+
+An open-source, local-first MCP server that captures programming lessons from AI-assisted coding sessions, stores them in a local SQLite database, and uses spaced repetition to ensure you never repeat the same mistake twice.
+
+<div align="center">
+
+![Node.js](https://img.shields.io/badge/Node.js-≥20-339933?logo=node.js&logoColor=white)
+![MCP](https://img.shields.io/badge/MCP-Protocol-blueviolet)
+![License](https://img.shields.io/badge/License-MIT-green)
+![SQLite](https://img.shields.io/badge/SQLite-Local--First-003B57?logo=sqlite&logoColor=white)
+
+</div>
+
+---
+
+## 🧠 What is Athar?
+
+**Athar** (أثر) is a memory system for developers. It works as an [MCP (Model Context Protocol)](https://modelcontextprotocol.io/) server that integrates with AI-powered IDEs like [Antigravity IDE](https://antigravity.google).
+
+When you're coding with an AI assistant and it helps you fix a real bug, Athar automatically captures the lesson — the problem, root cause, fix, and review questions — and stores it locally. Later, it uses **spaced repetition** (SM-2 algorithm) to quiz you on past mistakes so they stick in your memory permanently.
+
+### How it works
+
+```
+┌─────────────────────┐     stdio      ┌──────────────────┐
+│   Antigravity IDE   │ ◄────────────► │   Athar MCP      │
+│   (AI Assistant)    │   JSON-RPC     │   Server         │
+└─────────────────────┘                └────────┬─────────┘
+                                                │
+                                       ┌────────▼─────────┐
+                                       │   SQLite DB      │
+                                       │   (local-first)  │
+                                       │   ~/.local/share/ │
+                                       │   athar/lessons.db│
+                                       └──────────────────┘
+                                                │
+                                       ┌────────▼─────────┐
+                                       │   CLI & Dashboard │
+                                       │   athar review    │
+                                       │   athar status    │
+                                       └──────────────────┘
+```
+
+---
+
+## ✨ Features
+
+- **🔌 MCP Integration** — Works seamlessly with Antigravity IDE via stdio transport
+- **📝 Smart Lesson Capture** — AI assistant saves lessons with structured data: problem, root cause, bad/good code, review questions
+- **🛡️ Quality Validation** — Rejects trivial changes (formatting, typos) and detects duplicates
+- **🔍 Full-Text Search** — FTS5-powered search to recall past lessons instantly
+- **🧠 Spaced Repetition** — SM-2 algorithm schedules reviews at optimal intervals
+- **💾 Local-First** — All data stored locally in SQLite. No cloud, no API keys, no costs
+- **🌐 Bilingual** — Supports lessons in both Arabic and English
+- **⚡ Zero Native Dependencies** — Uses Node.js built-in `node:sqlite` module
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- **Node.js** ≥ 20 (tested on v24)
+- **Antigravity IDE** (or any MCP-compatible IDE)
+
+### Installation
+
+```bash
+# Clone the repository
+git clone https://github.com/ameenmv/athar.git
+cd athar
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+```
+
+### Setup with Antigravity IDE
+
+Run the setup command (coming in Phase 2), or manually add to your MCP config:
+
+**`~/.gemini/config/mcp_config.json`**
+
+```json
+{
+  "mcpServers": {
+    "athar": {
+      "command": "node",
+      "args": ["/absolute/path/to/athar/dist/index.js"]
+    }
+  }
+}
+```
+
+Then restart/refresh MCP servers in Antigravity IDE.
+
+---
+
+## 🛠️ MCP Tools
+
+Athar exposes two tools to the AI assistant:
+
+### `save_lesson`
+
+Captures a programming lesson from a real mistake.
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `title` | string | ✅ | Concise title describing the mistake pattern |
+| `problem` | string | ✅ | What went wrong — the symptom observed |
+| `root_cause` | string | ✅ | WHY it happened — the actual root cause |
+| `lesson` | string | ✅ | Key takeaway — what to remember |
+| `tags` | string[] | ✅ | Categorization tags |
+| `review_questions` | {q,a}[] | ✅ | 1-3 review questions for spaced repetition |
+| `error_message` | string | ❌ | Exact error message or stack trace |
+| `bad_code` | string | ❌ | The incorrect code snippet |
+| `good_code` | string | ❌ | The corrected code snippet |
+| `language` | string | ❌ | Programming language |
+| `file_path` | string | ❌ | File where the error occurred |
+| `git_diff` | string | ❌ | Git diff context |
+
+**Validation rules:**
+- Rejects trivial formatting/style changes
+- Rejects if problem and root_cause are identical
+- Requires both bad_code and good_code if either is provided
+- Detects and rejects duplicates via FTS5 similarity
+
+### `memory`
+
+Searches past lessons for relevant mistakes and solutions.
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `query` | string | ✅ | Search query — keyword, error pattern, or tag |
+| `limit` | number | ❌ | Max results (1-10, default: 3) |
+| `language` | string | ❌ | Filter by programming language |
+| `tags` | string[] | ❌ | Filter by tags |
+
+---
+
+## 📁 Project Structure
+
+```
+athar/
+├── src/
+│   ├── index.ts              # MCP server entry point
+│   ├── server.ts             # McpServer setup & tool registration
+│   ├── db/
+│   │   ├── schema.ts         # SQLite schema + FTS5 + triggers
+│   │   └── connection.ts     # Database singleton
+│   ├── tools/
+│   │   ├── save-lesson.ts    # save_lesson handler + validation
+│   │   ├── memory.ts         # memory search handler
+│   │   └── validators.ts     # Zod schemas
+│   ├── spaced-repetition/    # SM-2 algorithm (Phase 3)
+│   ├── cli/                  # CLI commands (Phase 3)
+│   └── utils/
+│       ├── paths.ts          # XDG-compliant paths
+│       └── logger.ts         # stderr-only logger
+├── dashboard/                # Nuxt 4 web UI (Phase 4)
+├── package.json
+└── tsconfig.json
+```
+
+---
+
+## 🗺️ Roadmap
+
+- [x] **Phase 1** — Core MCP Server & Database
+  - [x] SQLite schema with FTS5 full-text search
+  - [x] `save_lesson` tool with quality validation
+  - [x] `memory` search tool with FTS5 + LIKE fallback
+  - [x] Duplicate detection
+  - [x] stderr-only logging (MCP-safe)
+
+- [ ] **Phase 2** — IDE Integration
+  - [ ] `athar setup` command for Antigravity IDE
+  - [ ] Auto-detect and configure MCP settings
+
+- [ ] **Phase 3** — Spaced Repetition & CLI
+  - [ ] SM-2 algorithm implementation
+  - [ ] `athar review` — interactive terminal review sessions
+  - [ ] `athar status` — pending reviews dashboard
+  - [ ] `athar list` — browse and filter lessons
+
+- [ ] **Phase 4** — Nuxt 4 Dashboard
+  - [ ] Web UI for browsing lessons
+  - [ ] Syntax-highlighted code diff viewer
+  - [ ] Review progress visualization
+
+---
+
+## 🧪 Development
+
+```bash
+# Type check
+npm run typecheck
+
+# Build
+npm run build
+
+# Run MCP server directly (for testing)
+npm run dev
+
+# Run smoke tests
+npx tsx src/smoke-test.ts
+```
+
+### Debug logging
+
+Set `ATHAR_DEBUG=1` to enable verbose logging to stderr:
+
+```bash
+ATHAR_DEBUG=1 npm run dev
+```
+
+---
+
+## 💡 How the AI Decides to Save a Lesson
+
+The MCP server includes detailed instructions for the AI assistant. It will save a lesson when:
+
+- ✅ Helping fix a **non-trivial bug** with a clear root cause
+- ✅ Correcting a **misconception** about an API or framework
+- ✅ A **debugging session** reveals unexpected behavior
+- ✅ An **architectural mistake** is identified
+- ✅ A **security vulnerability** or performance issue is discovered
+
+It will **NOT** save for:
+- ❌ Simple typos or formatting fixes
+- ❌ Routine code generation
+- ❌ Style preferences
+
+---
+
+## 📄 License
+
+[MIT](LICENSE) — Built with ❤️ by [Ameen](https://github.com/ameenmv)

package/dist/cli/commands/list.d.ts

@@ -0,0 +1,10 @@
+interface ListOptions {
+    tag?: string;
+    language?: string;
+    status?: string;
+    search?: string;
+    limit: string;
+}
+export declare function listCommand(options: ListOptions): Promise<void>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/cli/commands/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"AAIA,UAAU,WAAW;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CA2FrE"}

package/dist/cli/commands/list.js

@@ -0,0 +1,73 @@
+import chalk from 'chalk';
+import { getDatabase } from '../../db/connection.js';
+import { closeDatabase } from '../../db/connection.js';
+export async function listCommand(options) {
+    try {
+        const db = getDatabase();
+        const limit = parseInt(options.limit, 10) || 20;
+        let sql = `
+      SELECT id, title, tags, language, status, review_count,
+             interval_days, next_review_at, created_at
+      FROM lessons
+    `;
+        const conditions = [];
+        const params = [];
+        if (options.tag) {
+            conditions.push('tags LIKE ?');
+            params.push(`%"${options.tag}"%`);
+        }
+        if (options.language) {
+            conditions.push('language = ?');
+            params.push(options.language);
+        }
+        if (options.status) {
+            conditions.push('status = ?');
+            params.push(options.status);
+        }
+        if (options.search) {
+            conditions.push('(title LIKE ? OR problem LIKE ? OR root_cause LIKE ? OR lesson LIKE ?)');
+            const q = `%${options.search}%`;
+            params.push(q, q, q, q);
+        }
+        if (conditions.length > 0) {
+            sql += ' WHERE ' + conditions.join(' AND ');
+        }
+        sql += ' ORDER BY created_at DESC LIMIT ?';
+        params.push(limit);
+        const lessons = db.prepare(sql).all(...params);
+        if (lessons.length === 0) {
+            console.log(chalk.gray('\n  No lessons found matching your criteria.\n'));
+            return;
+        }
+        console.log(chalk.bold(`\n📚 Lessons (${lessons.length} results)\n`));
+        const statusIcons = {
+            new: '🆕',
+            learning: '📖',
+            learned: '✅',
+            mastered: '🏆',
+        };
+        for (const lesson of lessons) {
+            const tags = JSON.parse(lesson.tags || '[]');
+            const icon = statusIcons[lesson.status] || '❓';
+            const date = lesson.created_at.split('T')[0];
+            console.log(`  ${icon} ${chalk.bold.white(`#${lesson.id}`)} ${chalk.white(lesson.title)}`);
+            console.log(`     ${chalk.gray(date)} · ${chalk.blue(tags.join(', '))} · ${chalk.gray(lesson.language || 'N/A')} · Reviews: ${chalk.white(lesson.review_count)}`);
+            if (lesson.next_review_at) {
+                const nextReview = new Date(lesson.next_review_at);
+                const now = new Date();
+                const daysUntil = Math.ceil((nextReview.getTime() - now.getTime()) / (1000 * 60 * 60 * 24));
+                if (daysUntil <= 0) {
+                    console.log(`     ${chalk.yellow('⚠️  Due for review!')}`);
+                }
+                else {
+                    console.log(`     ${chalk.gray(`Next review in ${daysUntil} day(s)`)}`);
+                }
+            }
+            console.log();
+        }
+    }
+    finally {
+        closeDatabase();
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/cli/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/cli/commands/list.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/review.d.ts

@@ -0,0 +1,2 @@
+export declare function reviewCommand(): Promise<void>;
+//# sourceMappingURL=review.d.ts.map

package/dist/cli/commands/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/review.ts"],"names":[],"mappings":"AAYA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAqHnD"}

package/dist/cli/commands/review.js

@@ -0,0 +1,112 @@
+import chalk from 'chalk';
+import { getDueReviews, recordReview } from '../../spaced-repetition/scheduler.js';
+import { qualityLabel } from '../../spaced-repetition/sm2.js';
+import { closeDatabase } from '../../db/connection.js';
+import { createInterface } from 'node:readline';
+function askQuestion(rl, prompt) {
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => resolve(answer.trim()));
+    });
+}
+export async function reviewCommand() {
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const dueReviews = getDueReviews();
+        if (dueReviews.length === 0) {
+            console.log(chalk.green('\n  ✨ No lessons due for review. Great job!'));
+            console.log(chalk.gray('     Check back later or run `athar status` for stats.\n'));
+            rl.close();
+            return;
+        }
+        console.log(chalk.bold(`\n╔${'═'.repeat(50)}╗`));
+        console.log(chalk.bold(`║  أثر Review Session — ${chalk.yellow(dueReviews.length)} lesson(s) due${' '.repeat(Math.max(0, 50 - 30 - String(dueReviews.length).length))}║`));
+        console.log(chalk.bold(`╚${'═'.repeat(50)}╝\n`));
+        let reviewed = 0;
+        let skipped = 0;
+        for (let i = 0; i < dueReviews.length; i++) {
+            const lesson = dueReviews[i];
+            const tags = JSON.parse(lesson.tags || '[]');
+            const questions = JSON.parse(lesson.review_questions || '[]');
+            console.log(chalk.bold(`\n📖 Lesson ${i + 1}/${dueReviews.length}: "${lesson.title}"`));
+            console.log(chalk.gray('━'.repeat(55)));
+            console.log(`${chalk.gray('Tags:')} ${tags.map(t => chalk.blue(t)).join(', ')}`);
+            console.log(`${chalk.gray('Language:')} ${lesson.language || 'N/A'}  ${chalk.gray('Status:')} ${lesson.status}`);
+            // Show problem
+            console.log(chalk.bold('\n❗ Problem:'));
+            console.log(chalk.white(`   ${lesson.problem}`));
+            // Show review questions one by one
+            for (const question of questions) {
+                console.log(chalk.bold.yellow(`\n❓ ${question.q}`));
+                await askQuestion(rl, chalk.gray('\n   Press Enter to reveal answer...'));
+                console.log(chalk.bold.green(`\n✅ ${question.a}`));
+            }
+            // Show root cause and lesson
+            console.log(chalk.bold('\n🔍 Root Cause:'));
+            console.log(chalk.white(`   ${lesson.root_cause}`));
+            console.log(chalk.bold('\n💡 Key Lesson:'));
+            console.log(chalk.white(`   ${lesson.lesson}`));
+            // Show code comparison if available
+            if (lesson.bad_code && lesson.good_code) {
+                console.log(chalk.bold.red('\n✗ Bad Code:'));
+                console.log(chalk.gray('   ┌─'));
+                for (const line of lesson.bad_code.split('\n')) {
+                    console.log(chalk.red(`   │ ${line}`));
+                }
+                console.log(chalk.gray('   └─'));
+                console.log(chalk.bold.green('\n✓ Good Code:'));
+                console.log(chalk.gray('   ┌─'));
+                for (const line of lesson.good_code.split('\n')) {
+                    console.log(chalk.green(`   │ ${line}`));
+                }
+                console.log(chalk.gray('   └─'));
+            }
+            // Ask for quality rating
+            console.log(chalk.bold('\n📊 How well did you recall this?'));
+            console.log(chalk.gray('   0 = Complete blackout'));
+            console.log(chalk.gray('   1 = Incorrect, vague memory'));
+            console.log(chalk.gray('   2 = Incorrect, but recognized answer'));
+            console.log(chalk.gray('   3 = Correct with difficulty'));
+            console.log(chalk.gray('   4 = Correct after hesitation'));
+            console.log(chalk.gray('   5 = Perfect recall'));
+            console.log(chalk.gray('   s = Skip this lesson'));
+            let quality = null;
+            while (quality === null) {
+                const answer = await askQuestion(rl, chalk.bold('\n   Your rating (0-5 or s): '));
+                if (answer.toLowerCase() === 's') {
+                    skipped++;
+                    console.log(chalk.gray('   Skipped.'));
+                    break;
+                }
+                const parsed = parseInt(answer, 10);
+                if (!isNaN(parsed) && parsed >= 0 && parsed <= 5) {
+                    quality = parsed;
+                }
+                else {
+                    console.log(chalk.red('   Please enter a number 0-5 or "s" to skip.'));
+                }
+            }
+            if (quality !== null) {
+                const result = recordReview(lesson.id, quality);
+                reviewed++;
+                console.log(`\n   ${qualityLabel(quality)}`);
+                console.log(`   → Next review in ${chalk.bold(result.intervalDays + ' day(s)')} ${chalk.green('✓')}`);
+                console.log(`   → Status: ${chalk.bold(result.newStatus)}`);
+            }
+        }
+        // Summary
+        console.log(chalk.bold(`\n${'━'.repeat(55)}`));
+        console.log(chalk.bold('📋 Review Session Summary'));
+        console.log(`   Reviewed: ${chalk.green(reviewed)}`);
+        console.log(`   Skipped:  ${chalk.yellow(skipped)}`);
+        console.log(`   Total:    ${dueReviews.length}`);
+        console.log(chalk.bold(`${'━'.repeat(55)}\n`));
+        if (reviewed > 0) {
+            console.log(chalk.green('   🎉 Great work! Keep learning from your mistakes.\n'));
+        }
+    }
+    finally {
+        rl.close();
+        closeDatabase();
+    }
+}
+//# sourceMappingURL=review.js.map

package/dist/cli/commands/review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.js","sourceRoot":"","sources":["../../../src/cli/commands/review.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/setup.d.ts

@@ -0,0 +1,2 @@
+export declare function setupCommand(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/commands/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"AAKA,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAsDlD"}

package/dist/cli/commands/setup.js

@@ -0,0 +1,55 @@
+import chalk from 'chalk';
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { getMcpConfigPath } from '../../utils/paths.js';
+export async function setupCommand() {
+    console.log(chalk.bold('\n🔮 Athar Setup — Antigravity IDE Integration\n'));
+    const configPath = getMcpConfigPath();
+    const serverPath = resolve(join(import.meta.dirname, '..', '..', '..', 'dist', 'index.js'));
+    // Check if dist/index.js exists
+    if (!existsSync(serverPath)) {
+        console.log(chalk.red('❌ Built server not found at:'), serverPath);
+        console.log(chalk.yellow('   Run `npm run build` first.\n'));
+        process.exit(1);
+    }
+    console.log(chalk.gray(`  Config path: ${configPath}`));
+    console.log(chalk.gray(`  Server path: ${serverPath}\n`));
+    // Read or create config
+    let config;
+    if (existsSync(configPath)) {
+        try {
+            config = JSON.parse(readFileSync(configPath, 'utf-8'));
+            if (!config.mcpServers)
+                config.mcpServers = {};
+        }
+        catch {
+            console.log(chalk.yellow('⚠️  Existing config is invalid, creating new one...'));
+            config = { mcpServers: {} };
+        }
+    }
+    else {
+        // Create directory if needed
+        const dir = join(configPath, '..');
+        mkdirSync(dir, { recursive: true });
+        config = { mcpServers: {} };
+    }
+    // Check if already configured
+    if (config.mcpServers.athar) {
+        console.log(chalk.yellow('⚠️  Athar is already configured in your MCP settings.'));
+        console.log(chalk.gray('   Updating to latest path...\n'));
+    }
+    // Add/update athar entry
+    config.mcpServers.athar = {
+        command: 'node',
+        args: ['--experimental-sqlite', serverPath],
+    };
+    // Write config
+    writeFileSync(configPath, JSON.stringify(config, null, 2));
+    console.log(chalk.green('✅ Athar MCP server configured successfully!\n'));
+    console.log(chalk.bold('Next steps:'));
+    console.log(chalk.white('  1. Refresh MCP servers in Antigravity IDE'));
+    console.log(chalk.white('     (Click "..." → "Manage MCP Servers" → Refresh)'));
+    console.log(chalk.white('  2. Start coding — the AI will save lessons automatically'));
+    console.log(chalk.white('  3. Run `athar status` to check your progress\n'));
+}
+//# sourceMappingURL=setup.js.map

package/dist/cli/commands/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/cli/commands/setup.ts"],"names":[],"mappings":"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"}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,2 @@
+export declare function statusCommand(): Promise<void>;
+//# sourceMappingURL=status.d.ts.map

package/dist/cli/commands/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAIA,wBAAsB,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAoCnD"}

package/dist/cli/commands/status.js

@@ -0,0 +1,39 @@
+import chalk from 'chalk';
+import { getStats } from '../../spaced-repetition/scheduler.js';
+import { closeDatabase } from '../../db/connection.js';
+export async function statusCommand() {
+    try {
+        const stats = getStats();
+        console.log(chalk.bold('\n📊 Athar Memory Status'));
+        console.log(chalk.gray('━'.repeat(40)));
+        console.log(`\n  Total Lessons:    ${chalk.bold.white(stats.total)}`);
+        console.log(`  Due Today:        ${stats.dueToday > 0 ? chalk.bold.yellow(stats.dueToday + ' ⚠️') : chalk.green('0 ✓')}`);
+        console.log(`  Due This Week:    ${chalk.white(stats.dueThisWeek)}`);
+        console.log(chalk.bold('\n  By Status:'));
+        console.log(`    🆕  New:         ${chalk.white(stats.byStatus['new'] || 0)}`);
+        console.log(`    📖  Learning:    ${chalk.cyan(stats.byStatus['learning'] || 0)}`);
+        console.log(`    ✅  Learned:     ${chalk.green(stats.byStatus['learned'] || 0)}`);
+        console.log(`    🏆  Mastered:    ${chalk.magenta(stats.byStatus['mastered'] || 0)}`);
+        if (stats.topTags.length > 0) {
+            console.log(chalk.bold('\n  Top Tags:'));
+            for (const { tag, count } of stats.topTags) {
+                const bar = chalk.blue('█'.repeat(Math.min(count * 2, 20)));
+                console.log(`    ${chalk.white(tag.padEnd(18))} ${bar} ${chalk.gray(count)}`);
+            }
+        }
+        if (stats.dueToday > 0) {
+            console.log(chalk.yellow(`\n  💡 You have ${stats.dueToday} lesson(s) due for review!`));
+            console.log(chalk.white('     Run `athar review` to start.\n'));
+        }
+        else if (stats.total === 0) {
+            console.log(chalk.gray('\n  No lessons yet. Start coding with Athar MCP in your IDE!\n'));
+        }
+        else {
+            console.log(chalk.green('\n  ✨ All caught up! No reviews due today.\n'));
+        }
+    }
+    finally {
+        closeDatabase();
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"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"}

package/dist/cli/index.d.ts

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+/**
+ * Athar CLI (أثر)
+ *
+ * Commands:
+ *   athar setup     — Configure Antigravity IDE integration
+ *   athar review    — Interactive spaced repetition review
+ *   athar status    — Show pending reviews and stats
+ *   athar list      — Browse all lessons
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG"}