athar-mcp 0.1.0

package/dist/cli/index.js

@@ -0,0 +1,43 @@
+#!/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
+ */
+import { Command } from 'commander';
+import { reviewCommand } from './commands/review.js';
+import { statusCommand } from './commands/status.js';
+import { listCommand } from './commands/list.js';
+import { setupCommand } from './commands/setup.js';
+const program = new Command();
+program
+    .name('athar')
+    .description('أثر — AI-powered programming lesson memory with spaced repetition')
+    .version('0.1.0');
+program
+    .command('setup')
+    .description('Configure Antigravity IDE to use Athar MCP server')
+    .action(setupCommand);
+program
+    .command('review')
+    .description('Start an interactive spaced repetition review session')
+    .action(reviewCommand);
+program
+    .command('status')
+    .description('Show pending reviews and lesson statistics')
+    .action(statusCommand);
+program
+    .command('list')
+    .description('Browse all saved lessons')
+    .option('-t, --tag <tag>', 'Filter by tag')
+    .option('-l, --language <lang>', 'Filter by programming language')
+    .option('-s, --status <status>', 'Filter by status (new, learning, learned, mastered)')
+    .option('-q, --search <query>', 'Search lessons by keyword')
+    .option('-n, --limit <number>', 'Maximum results', '20')
+    .action(listCommand);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;GAQG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,OAAO,CAAC;KACb,WAAW,CAAC,mEAAmE,CAAC;KAChF,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,YAAY,CAAC,CAAC;AAExB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,uDAAuD,CAAC;KACpE,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,4CAA4C,CAAC;KACzD,MAAM,CAAC,aAAa,CAAC,CAAC;AAEzB,OAAO;KACJ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,0BAA0B,CAAC;KACvC,MAAM,CAAC,iBAAiB,EAAE,eAAe,CAAC;KAC1C,MAAM,CAAC,uBAAuB,EAAE,gCAAgC,CAAC;KACjE,MAAM,CAAC,uBAAuB,EAAE,qDAAqD,CAAC;KACtF,MAAM,CAAC,sBAAsB,EAAE,2BAA2B,CAAC;KAC3D,MAAM,CAAC,sBAAsB,EAAE,iBAAiB,EAAE,IAAI,CAAC;KACvD,MAAM,CAAC,WAAW,CAAC,CAAC;AAEvB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/db/connection.d.ts

@@ -0,0 +1,11 @@
+import { DatabaseSync } from 'node:sqlite';
+/**
+ * Get the singleton database connection.
+ * Creates the database and schema on first call.
+ */
+export declare function getDatabase(): DatabaseSync;
+/**
+ * Close the database connection gracefully.
+ */
+export declare function closeDatabase(): void;
+//# sourceMappingURL=connection.d.ts.map

package/dist/db/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAU3C;;;GAGG;AACH,wBAAgB,WAAW,IAAI,YAAY,CA6B1C;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAMpC"}

package/dist/db/connection.js

@@ -0,0 +1,49 @@
+import { DatabaseSync } from 'node:sqlite';
+import { existsSync } from 'node:fs';
+import { getDatabasePath } from '../utils/paths.js';
+import { CREATE_TABLES } from './schema.js';
+import { createLogger } from '../utils/logger.js';
+const log = createLogger('db');
+let db = null;
+/**
+ * Get the singleton database connection.
+ * Creates the database and schema on first call.
+ */
+export function getDatabase() {
+    if (db)
+        return db;
+    const dbPath = getDatabasePath();
+    const isNew = !existsSync(dbPath);
+    log.info(`Opening database at: ${dbPath}`);
+    db = new DatabaseSync(dbPath);
+    // Enable WAL mode for better concurrent read performance
+    db.exec('PRAGMA journal_mode = WAL');
+    db.exec('PRAGMA foreign_keys = ON');
+    if (isNew) {
+        log.info('Creating database schema (first run)...');
+        db.exec(CREATE_TABLES);
+        log.info('Schema created successfully.');
+    }
+    else {
+        // Ensure FTS table and triggers exist (in case of upgrades)
+        try {
+            db.exec(CREATE_TABLES);
+        }
+        catch {
+            // Tables already exist — that's fine
+            log.debug('Schema already up to date.');
+        }
+    }
+    return db;
+}
+/**
+ * Close the database connection gracefully.
+ */
+export function closeDatabase() {
+    if (db) {
+        db.close();
+        db = null;
+        log.info('Database connection closed.');
+    }
+}
+//# sourceMappingURL=connection.js.map

package/dist/db/connection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.js","sourceRoot":"","sources":["../../src/db/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,GAAG,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;AAE/B,IAAI,EAAE,GAAwB,IAAI,CAAC;AAEnC;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAElB,MAAM,MAAM,GAAG,eAAe,EAAE,CAAC;IACjC,MAAM,KAAK,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAElC,GAAG,CAAC,IAAI,CAAC,wBAAwB,MAAM,EAAE,CAAC,CAAC;IAE3C,EAAE,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;IAE9B,yDAAyD;IACzD,EAAE,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IACrC,EAAE,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAEpC,IAAI,KAAK,EAAE,CAAC;QACV,GAAG,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACpD,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,8BAA8B,CAAC,CAAC;IAC3C,CAAC;SAAM,CAAC;QACN,4DAA4D;QAC5D,IAAI,CAAC;YACH,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,qCAAqC;YACrC,GAAG,CAAC,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IAED,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,EAAE,EAAE,CAAC;QACP,EAAE,CAAC,KAAK,EAAE,CAAC;QACX,EAAE,GAAG,IAAI,CAAC;QACV,GAAG,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/db/schema.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Database schema for Athar lessons.
+ *
+ * Designed for:
+ * - Structured lesson storage with rich metadata
+ * - SM-2 spaced repetition scheduling
+ * - Full-text search across lesson content
+ * - Bilingual support (Arabic + English)
+ */
+export declare const SCHEMA_VERSION = 1;
+export declare const CREATE_TABLES = "\n  -- Main lessons table\n  CREATE TABLE IF NOT EXISTS lessons (\n    id               INTEGER PRIMARY KEY AUTOINCREMENT,\n    \n    -- Core lesson content (bilingual: AR/EN)\n    title            TEXT NOT NULL,\n    problem          TEXT NOT NULL,\n    error_message    TEXT,\n    root_cause       TEXT NOT NULL,\n    bad_code         TEXT,\n    good_code        TEXT,\n    lesson           TEXT NOT NULL,\n    \n    -- Categorization\n    tags             TEXT,          -- JSON array: [\"async\", \"react\", \"typescript\"]\n    language         TEXT,          -- Programming language: \"typescript\", \"python\", etc.\n    file_path        TEXT,          -- Original file where error occurred\n    git_diff         TEXT,          -- Git diff context (auto-captured or provided)\n    \n    -- Spaced repetition (SM-2 algorithm)\n    repetitions      INTEGER DEFAULT 0,\n    easiness_factor  REAL    DEFAULT 2.5,\n    interval_days    INTEGER DEFAULT 0,\n    next_review_at   TEXT,          -- ISO 8601 datetime\n    last_reviewed_at TEXT,\n    \n    -- Review questions: JSON array of {q, a} objects\n    review_questions TEXT NOT NULL,\n    \n    -- Status tracking\n    status           TEXT DEFAULT 'new' CHECK(status IN ('new', 'learning', 'learned', 'mastered')),\n    quality_score    INTEGER,       -- Last SM-2 quality score (0-5)\n    review_count     INTEGER DEFAULT 0,\n    \n    -- Metadata\n    created_at       TEXT DEFAULT (datetime('now')),\n    updated_at       TEXT DEFAULT (datetime('now'))\n  );\n\n  -- Performance indexes\n  CREATE INDEX IF NOT EXISTS idx_lessons_next_review ON lessons(next_review_at);\n  CREATE INDEX IF NOT EXISTS idx_lessons_status      ON lessons(status);\n  CREATE INDEX IF NOT EXISTS idx_lessons_language     ON lessons(language);\n  CREATE INDEX IF NOT EXISTS idx_lessons_created      ON lessons(created_at);\n\n  -- Full-text search virtual table\n  CREATE VIRTUAL TABLE IF NOT EXISTS lessons_fts USING fts5(\n    title,\n    problem,\n    root_cause,\n    lesson,\n    tags,\n    content=lessons,\n    content_rowid=id\n  );\n\n  -- Triggers to keep FTS in sync\n  CREATE TRIGGER IF NOT EXISTS lessons_ai AFTER INSERT ON lessons BEGIN\n    INSERT INTO lessons_fts(rowid, title, problem, root_cause, lesson, tags)\n    VALUES (new.id, new.title, new.problem, new.root_cause, new.lesson, new.tags);\n  END;\n\n  CREATE TRIGGER IF NOT EXISTS lessons_ad AFTER DELETE ON lessons BEGIN\n    INSERT INTO lessons_fts(lessons_fts, rowid, title, problem, root_cause, lesson, tags)\n    VALUES ('delete', old.id, old.title, old.problem, old.root_cause, old.lesson, old.tags);\n  END;\n\n  CREATE TRIGGER IF NOT EXISTS lessons_au AFTER UPDATE ON lessons BEGIN\n    INSERT INTO lessons_fts(lessons_fts, rowid, title, problem, root_cause, lesson, tags)\n    VALUES ('delete', old.id, old.title, old.problem, old.root_cause, old.lesson, old.tags);\n    INSERT INTO lessons_fts(rowid, title, problem, root_cause, lesson, tags)\n    VALUES (new.id, new.title, new.problem, new.root_cause, new.lesson, new.tags);\n  END;\n\n  -- Schema version tracking\n  CREATE TABLE IF NOT EXISTS schema_meta (\n    key   TEXT PRIMARY KEY,\n    value TEXT NOT NULL\n  );\n\n  INSERT OR REPLACE INTO schema_meta (key, value)\n  VALUES ('version', '1');\n";
+//# sourceMappingURL=schema.d.ts.map

package/dist/db/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,eAAO,MAAM,cAAc,IAAI,CAAC;AAEhC,eAAO,MAAM,aAAa,+sGAmFzB,CAAC"}

package/dist/db/schema.js

@@ -0,0 +1,95 @@
+/**
+ * Database schema for Athar lessons.
+ *
+ * Designed for:
+ * - Structured lesson storage with rich metadata
+ * - SM-2 spaced repetition scheduling
+ * - Full-text search across lesson content
+ * - Bilingual support (Arabic + English)
+ */
+export const SCHEMA_VERSION = 1;
+export const CREATE_TABLES = `
+  -- Main lessons table
+  CREATE TABLE IF NOT EXISTS lessons (
+    id               INTEGER PRIMARY KEY AUTOINCREMENT,
+    
+    -- Core lesson content (bilingual: AR/EN)
+    title            TEXT NOT NULL,
+    problem          TEXT NOT NULL,
+    error_message    TEXT,
+    root_cause       TEXT NOT NULL,
+    bad_code         TEXT,
+    good_code        TEXT,
+    lesson           TEXT NOT NULL,
+    
+    -- Categorization
+    tags             TEXT,          -- JSON array: ["async", "react", "typescript"]
+    language         TEXT,          -- Programming language: "typescript", "python", etc.
+    file_path        TEXT,          -- Original file where error occurred
+    git_diff         TEXT,          -- Git diff context (auto-captured or provided)
+    
+    -- Spaced repetition (SM-2 algorithm)
+    repetitions      INTEGER DEFAULT 0,
+    easiness_factor  REAL    DEFAULT 2.5,
+    interval_days    INTEGER DEFAULT 0,
+    next_review_at   TEXT,          -- ISO 8601 datetime
+    last_reviewed_at TEXT,
+    
+    -- Review questions: JSON array of {q, a} objects
+    review_questions TEXT NOT NULL,
+    
+    -- Status tracking
+    status           TEXT DEFAULT 'new' CHECK(status IN ('new', 'learning', 'learned', 'mastered')),
+    quality_score    INTEGER,       -- Last SM-2 quality score (0-5)
+    review_count     INTEGER DEFAULT 0,
+    
+    -- Metadata
+    created_at       TEXT DEFAULT (datetime('now')),
+    updated_at       TEXT DEFAULT (datetime('now'))
+  );
+
+  -- Performance indexes
+  CREATE INDEX IF NOT EXISTS idx_lessons_next_review ON lessons(next_review_at);
+  CREATE INDEX IF NOT EXISTS idx_lessons_status      ON lessons(status);
+  CREATE INDEX IF NOT EXISTS idx_lessons_language     ON lessons(language);
+  CREATE INDEX IF NOT EXISTS idx_lessons_created      ON lessons(created_at);
+
+  -- Full-text search virtual table
+  CREATE VIRTUAL TABLE IF NOT EXISTS lessons_fts USING fts5(
+    title,
+    problem,
+    root_cause,
+    lesson,
+    tags,
+    content=lessons,
+    content_rowid=id
+  );
+
+  -- Triggers to keep FTS in sync
+  CREATE TRIGGER IF NOT EXISTS lessons_ai AFTER INSERT ON lessons BEGIN
+    INSERT INTO lessons_fts(rowid, title, problem, root_cause, lesson, tags)
+    VALUES (new.id, new.title, new.problem, new.root_cause, new.lesson, new.tags);
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS lessons_ad AFTER DELETE ON lessons BEGIN
+    INSERT INTO lessons_fts(lessons_fts, rowid, title, problem, root_cause, lesson, tags)
+    VALUES ('delete', old.id, old.title, old.problem, old.root_cause, old.lesson, old.tags);
+  END;
+
+  CREATE TRIGGER IF NOT EXISTS lessons_au AFTER UPDATE ON lessons BEGIN
+    INSERT INTO lessons_fts(lessons_fts, rowid, title, problem, root_cause, lesson, tags)
+    VALUES ('delete', old.id, old.title, old.problem, old.root_cause, old.lesson, old.tags);
+    INSERT INTO lessons_fts(rowid, title, problem, root_cause, lesson, tags)
+    VALUES (new.id, new.title, new.problem, new.root_cause, new.lesson, new.tags);
+  END;
+
+  -- Schema version tracking
+  CREATE TABLE IF NOT EXISTS schema_meta (
+    key   TEXT PRIMARY KEY,
+    value TEXT NOT NULL
+  );
+
+  INSERT OR REPLACE INTO schema_meta (key, value)
+  VALUES ('version', '${SCHEMA_VERSION}');
+`;
+//# sourceMappingURL=schema.js.map

package/dist/db/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../src/db/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAEhC,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;wBAkFL,cAAc;CACrC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+/**
+ * Athar (أثر) — MCP Server Entry Point
+ *
+ * This is the main entry point for the MCP server.
+ * It initializes the server and connects via stdio transport.
+ *
+ * Usage in Antigravity IDE mcp_config.json:
+ * {
+ *   "mcpServers": {
+ *     "athar": {
+ *       "command": "node",
+ *       "args": ["path/to/dist/index.js"]
+ *     }
+ *   }
+ * }
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/**
+ * Athar (أثر) — MCP Server Entry Point
+ *
+ * This is the main entry point for the MCP server.
+ * It initializes the server and connects via stdio transport.
+ *
+ * Usage in Antigravity IDE mcp_config.json:
+ * {
+ *   "mcpServers": {
+ *     "athar": {
+ *       "command": "node",
+ *       "args": ["path/to/dist/index.js"]
+ *     }
+ *   }
+ * }
+ */
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createAtharServer } from './server.js';
+import { closeDatabase } from './db/connection.js';
+import { createLogger } from './utils/logger.js';
+const log = createLogger('main');
+async function main() {
+    log.info('Starting Athar MCP server v0.1.0...');
+    const server = createAtharServer();
+    const transport = new StdioServerTransport();
+    // Graceful shutdown
+    const shutdown = () => {
+        log.info('Shutting down...');
+        closeDatabase();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    process.on('uncaughtException', (err) => {
+        log.error('Uncaught exception:', String(err));
+        closeDatabase();
+        process.exit(1);
+    });
+    await server.connect(transport);
+    log.info('Athar MCP server connected and ready.');
+}
+main().catch((err) => {
+    log.error('Fatal error:', String(err));
+    closeDatabase();
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,GAAG,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;AAEjC,KAAK,UAAU,IAAI;IACjB,GAAG,CAAC,IAAI,CAAC,qCAAqC,CAAC,CAAC;IAEhD,MAAM,MAAM,GAAG,iBAAiB,EAAE,CAAC;IACnC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAE7C,oBAAoB;IACpB,MAAM,QAAQ,GAAG,GAAS,EAAE;QAC1B,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAC7B,aAAa,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IAEF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,GAAG,EAAE,EAAE;QACtC,GAAG,CAAC,KAAK,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC9C,aAAa,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,GAAG,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC;AACpD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,GAAG,CAAC,KAAK,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IACvC,aAAa,EAAE,CAAC;IAChB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create and configure the Athar MCP server.
+ * Registers all tools and their handlers.
+ */
+export declare function createAtharServer(): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAQpE;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,SAAS,CA6I7C"}

package/dist/server.js

@@ -0,0 +1,139 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { SaveLessonSchema, MemorySchema } from './tools/validators.js';
+import { saveLesson } from './tools/save-lesson.js';
+import { searchMemory } from './tools/memory.js';
+import { createLogger } from './utils/logger.js';
+const log = createLogger('server');
+/**
+ * Create and configure the Athar MCP server.
+ * Registers all tools and their handlers.
+ */
+export function createAtharServer() {
+    const server = new McpServer({
+        name: 'athar',
+        version: '0.1.0',
+    }, {
+        instructions: `You have access to **Athar (أثر)**, a programming lesson memory system that captures and recalls lessons from real coding mistakes.
+
+## WHEN TO SAVE A LESSON (save_lesson):
+- When you help fix a **non-trivial bug** and identify a clear root cause
+- When a **misconception** about an API, language feature, or framework is corrected
+- When a **debugging session** reveals unexpected behavior worth remembering
+- When an **architectural mistake** is identified and a better pattern is suggested
+- When a **security vulnerability** or performance anti-pattern is discovered
+
+## WHEN NOT TO SAVE:
+- Simple typos, formatting changes, or import order fixes
+- Routine code generation without any mistake involved
+- Style preferences or subjective code choices
+- Changes so trivial they wouldn't teach anyone anything
+
+## WHEN TO SEARCH MEMORY (memory):
+- When you detect an error pattern that looks like a past mistake
+- When the developer explicitly asks "have I done this before?" or similar
+- When starting work in an area where past lessons might prevent repeated errors
+- Proactively at the start of a debugging session in a known problem area
+
+## IMPORTANT GUIDELINES:
+- Always include code examples (bad_code + good_code) when applicable
+- Write lessons in the same language the developer uses (Arabic or English)
+- Tags should be specific and lowercase (e.g., "async-await", "react-hooks", "sql-injection")
+- Review questions should test understanding, not just recall
+- The git_diff field is optional — include it if the fix involves specific file changes`,
+    });
+    // ═══════════════════════════════════════════════════════
+    // Tool: save_lesson
+    // ═══════════════════════════════════════════════════════
+    server.tool('save_lesson', `Save a programming lesson learned from a real mistake during this coding session.
+
+ONLY call this when you identify a genuine, non-trivial learning moment — NOT for formatting changes, simple typos, or routine code adjustments.
+
+The lesson must contain:
+- A clear problem description (what went wrong)
+- A root cause analysis (WHY it happened)
+- An actionable takeaway (what to remember)
+- At least one review question for spaced repetition`, {
+        title: SaveLessonSchema.shape.title,
+        problem: SaveLessonSchema.shape.problem,
+        error_message: SaveLessonSchema.shape.error_message,
+        root_cause: SaveLessonSchema.shape.root_cause,
+        bad_code: SaveLessonSchema.shape.bad_code,
+        good_code: SaveLessonSchema.shape.good_code,
+        lesson: SaveLessonSchema.shape.lesson,
+        tags: SaveLessonSchema.shape.tags,
+        language: SaveLessonSchema.shape.language,
+        file_path: SaveLessonSchema.shape.file_path,
+        git_diff: SaveLessonSchema.shape.git_diff,
+        review_questions: SaveLessonSchema.shape.review_questions,
+    }, async (args) => {
+        log.info('save_lesson called', args.title);
+        try {
+            const result = saveLesson(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: result.message,
+                    },
+                ],
+                isError: !result.success,
+            };
+        }
+        catch (err) {
+            log.error('save_lesson failed', String(err));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ Failed to save lesson: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // ═══════════════════════════════════════════════════════
+    // Tool: memory
+    // ═══════════════════════════════════════════════════════
+    server.tool('memory', `Search your programming lesson history for past mistakes and solutions.
+
+Use this when:
+- You detect an error pattern that might match a previously learned lesson
+- The developer asks about past mistakes in a specific area
+- You want to proactively check if a similar mistake has been made before
+
+Returns relevant lessons with their problem, root cause, solution, and code examples.`, {
+        query: MemorySchema.shape.query,
+        limit: MemorySchema.shape.limit,
+        language: MemorySchema.shape.language,
+        tags: MemorySchema.shape.tags,
+    }, async (args) => {
+        log.info('memory called', args.query);
+        try {
+            const result = searchMemory(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: result.message,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            log.error('memory search failed', String(err));
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `❌ Memory search failed: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    log.info('Athar MCP server created with 2 tools: save_lesson, memory');
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/smoke-test.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Smoke test for Athar MCP server.
+ * Tests: DB creation, save_lesson, memory search.
+ */
+export {};
+//# sourceMappingURL=smoke-test.d.ts.map

package/dist/smoke-test.d.ts.map

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

package/dist/smoke-test.js

@@ -0,0 +1,99 @@
+#!/usr/bin/env node
+/**
+ * Smoke test for Athar MCP server.
+ * Tests: DB creation, save_lesson, memory search.
+ */
+import { getDatabase, closeDatabase } from './db/connection.js';
+import { saveLesson } from './tools/save-lesson.js';
+import { searchMemory } from './tools/memory.js';
+import { getDatabasePath } from './utils/paths.js';
+// Use a test database
+const testDbPath = getDatabasePath();
+console.log(`\n🧪 Athar Smoke Test`);
+console.log(`📂 Database path: ${testDbPath}\n`);
+// Test 1: Database initialization
+console.log('━━━ Test 1: Database Initialization ━━━');
+try {
+    const db = getDatabase();
+    console.log('✅ Database initialized successfully\n');
+}
+catch (err) {
+    console.error('❌ Database initialization failed:', err);
+    process.exit(1);
+}
+// Test 2: Save a valid lesson
+console.log('━━━ Test 2: Save Valid Lesson ━━━');
+const validLesson = {
+    title: 'React useEffect cleanup prevents memory leaks in async operations',
+    problem: 'Component fetches data in useEffect but the response arrives after unmounting, causing "Cannot update state on unmounted component" warning',
+    error_message: 'Warning: Can\'t perform a React state update on an unmounted component',
+    root_cause: 'The useEffect callback starts an async fetch but has no cleanup function. When the component unmounts before the fetch completes, the .then() callback tries to call setState on a component that no longer exists in the DOM.',
+    bad_code: `useEffect(() => {
+  fetch('/api/data')
+    .then(res => res.json())
+    .then(data => setData(data));
+}, []);`,
+    good_code: `useEffect(() => {
+  const controller = new AbortController();
+  fetch('/api/data', { signal: controller.signal })
+    .then(res => res.json())
+    .then(data => setData(data))
+    .catch(err => {
+      if (err.name !== 'AbortError') throw err;
+    });
+  return () => controller.abort();
+}, []);`,
+    lesson: 'Always return a cleanup function from useEffect when performing async operations. Use AbortController to cancel pending fetch requests when the component unmounts.',
+    tags: ['react', 'useEffect', 'async', 'memory-leak', 'cleanup'],
+    language: 'typescript',
+    file_path: 'src/components/UserProfile.tsx',
+    review_questions: [
+        {
+            q: 'What happens when a useEffect fetches data but the component unmounts before the response arrives?',
+            a: 'The state update runs on an unmounted component, causing a memory leak warning. The fix is to use AbortController and return a cleanup function.',
+        },
+        {
+            q: 'How do you properly cancel a fetch request in a useEffect cleanup?',
+            a: 'Create an AbortController, pass its signal to fetch(), and call controller.abort() in the cleanup return function.',
+        },
+    ],
+};
+const saveResult = saveLesson(validLesson);
+console.log(`Result: ${saveResult.success ? '✅' : '❌'} ${saveResult.message.split('\n')[0]}`);
+if (saveResult.lessonId) {
+    console.log(`Lesson ID: ${saveResult.lessonId}\n`);
+}
+// Test 3: Reject trivial lesson
+console.log('━━━ Test 3: Reject Trivial Lesson ━━━');
+const trivialLesson = {
+    title: 'Fix indentation in utils file',
+    problem: 'The code had wrong indentation',
+    root_cause: 'The code had wrong indentation in the utility file',
+    lesson: 'Always use consistent indentation in utility files',
+    tags: ['formatting'],
+    review_questions: [{ q: 'Why is indentation important?', a: 'For readability' }],
+};
+const trivialResult = saveLesson(trivialLesson);
+console.log(`Result: ${trivialResult.success ? '❌ Should have been rejected!' : '✅ Correctly rejected'}`);
+console.log(`Message: ${trivialResult.message.substring(0, 100)}...\n`);
+// Test 4: Reject duplicate
+console.log('━━━ Test 4: Duplicate Detection ━━━');
+const duplicateResult = saveLesson(validLesson);
+console.log(`Result: ${duplicateResult.success ? '❌ Should have been rejected!' : '✅ Correctly detected duplicate'}`);
+console.log(`Message: ${duplicateResult.message.substring(0, 100)}...\n`);
+// Test 5: Memory search
+console.log('━━━ Test 5: Memory Search ━━━');
+const searchResult = searchMemory({ query: 'useEffect memory leak', limit: 3 });
+console.log(`Found: ${searchResult.results.length} result(s)`);
+console.log(`Result: ${searchResult.results.length > 0 ? '✅' : '❌'} ${searchResult.results.length > 0 ? 'Search found the saved lesson!' : 'Search returned no results'}\n`);
+// Test 6: Memory search with no matches
+console.log('━━━ Test 6: Search With No Matches ━━━');
+const emptySearch = searchMemory({ query: 'xyznonexistent', limit: 3 });
+console.log(`Found: ${emptySearch.results.length} result(s)`);
+console.log(`Result: ${emptySearch.results.length === 0 ? '✅' : '❌'} Correctly returned no results\n`);
+// Cleanup
+closeDatabase();
+console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━');
+console.log('🎉 All smoke tests passed!');
+console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━\n');
+//# sourceMappingURL=smoke-test.js.map

package/dist/smoke-test.js.map

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

package/dist/spaced-repetition/scheduler.d.ts

@@ -0,0 +1,46 @@
+export interface LessonForReview {
+    id: number;
+    title: string;
+    problem: string;
+    root_cause: string;
+    lesson: string;
+    bad_code: string | null;
+    good_code: string | null;
+    tags: string;
+    language: string | null;
+    review_questions: string;
+    repetitions: number;
+    easiness_factor: number;
+    interval_days: number;
+    status: string;
+    review_count: number;
+    created_at: string;
+}
+/**
+ * Get all lessons that are due for review (next_review_at <= now).
+ */
+export declare function getDueReviews(): LessonForReview[];
+/**
+ * Update a lesson after a review session.
+ * Applies the SM-2 algorithm and updates the database.
+ */
+export declare function recordReview(lessonId: number, quality: number): {
+    success: boolean;
+    nextReviewAt: Date;
+    newStatus: string;
+    intervalDays: number;
+};
+/**
+ * Get statistics about all lessons.
+ */
+export declare function getStats(): {
+    total: number;
+    dueToday: number;
+    dueThisWeek: number;
+    byStatus: Record<string, number>;
+    topTags: Array<{
+        tag: string;
+        count: number;
+    }>;
+};
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/spaced-repetition/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/spaced-repetition/scheduler.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,eAAe,EAAE,CAejD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;IAC/D,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,IAAI,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB,CAsDA;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAChD,CA2CA"}