eklavya-mcp 1.0.0

package/dist/tools/get_session_quiz_plan.js

@@ -0,0 +1,107 @@
+import { z } from 'zod';
+import { loadConfig } from '../config.js';
+import { decayedScore, isDue, isKnown, nextTierToAsk } from '../srs.js';
+import { resolveSessionId } from '../session.js';
+import { lastAttempt, lastAttemptAt, masteryFor, sessionConcepts } from '../store.js';
+import { CWD_HINT, SESSION_HINT } from './types.js';
+function minutesSince(iso, now) {
+    if (!iso)
+        return Number.POSITIVE_INFINITY;
+    // SQLite datetime('now') is UTC without a zone marker; make that explicit.
+    const t = Date.parse(iso.includes('T') ? iso : `${iso.replace(' ', 'T')}Z`);
+    if (!Number.isFinite(t))
+        return Number.POSITIVE_INFINITY;
+    return (now.getTime() - t) / 60_000;
+}
+export const getSessionQuizPlan = {
+    name: 'get_session_quiz_plan',
+    title: 'Get session quiz plan',
+    description: 'What to quiz on right now and at what difficulty tier, chosen from this session\'s concepts and whatever is due for review. Returns questions_needed: 0 when there is nothing worth asking.',
+    inputSchema: {
+        session_id: z.string().optional().describe(SESSION_HINT),
+        cwd: z.string().optional().describe(CWD_HINT),
+        max: z.number().int().min(1).max(10).optional().describe('Cap on questions. Defaults to the configured max_questions_per_task.'),
+    },
+    handler: (args, { db }) => {
+        const now = new Date();
+        const { config } = loadConfig(args.cwd);
+        const sessionId = resolveSessionId(db, args.session_id);
+        const max = args.max ?? config.max_questions_per_task;
+        if (config.mode === 'off') {
+            return { session_id: sessionId, questions_needed: 0, concepts: [], reason: 'mode_off' };
+        }
+        // Cooldown keeps ambient mode from nagging. It must never apply in enforced
+        // mode, or a cooldown could make a commit gate unpassable (decision G5).
+        if (config.mode === 'ambient') {
+            const since = minutesSince(lastAttemptAt(db, sessionId), now);
+            if (since < config.min_minutes_between_quizzes) {
+                return {
+                    session_id: sessionId,
+                    questions_needed: 0,
+                    concepts: [],
+                    reason: 'cooldown',
+                    minutes_remaining: Math.ceil(config.min_minutes_between_quizzes - since),
+                };
+            }
+        }
+        const picked = [];
+        const seen = new Set();
+        const domains = new Set();
+        const add = (concept, context, reason) => {
+            if (seen.has(concept.slug) || picked.length >= max)
+                return;
+            const m = masteryFor(db, concept.id);
+            const score = decayedScore(m.score, m.next_review, now);
+            const last = lastAttempt(db, concept.id);
+            seen.add(concept.slug);
+            picked.push({
+                slug: concept.slug,
+                name: concept.name,
+                domain: concept.domain,
+                tier_to_ask: nextTierToAsk({
+                    conceptTier: concept.tier,
+                    lastDifficulty: last?.difficulty ?? null,
+                    lastGrade: last?.grade ?? null,
+                    score,
+                }),
+                context,
+                last_grade: last?.grade ?? null,
+                reason,
+            });
+        };
+        const touched = sessionConcepts(db, sessionId);
+        for (const c of touched)
+            domains.add(c.domain);
+        // (a) concepts this session touched that the learner has not mastered
+        for (const c of touched) {
+            const m = masteryFor(db, c.id);
+            const score = decayedScore(m.score, m.next_review, now);
+            if (!isKnown({ score, reps: m.reps }))
+                add(c, c.context, 'unmastered');
+        }
+        // (b) concepts this session touched that are due for review
+        for (const c of touched) {
+            const m = masteryFor(db, c.id);
+            if (isDue(m.next_review, now))
+                add(c, c.context, 'due_review');
+        }
+        // (c) anything else due in the same domains, so review debt gets paid down
+        if (picked.length < max && domains.size > 0) {
+            const placeholders = [...domains].map(() => '?').join(',');
+            const rows = db
+                .prepare(`SELECT c.* FROM concepts c
+           JOIN mastery m ON m.concept_id = c.id
+           WHERE c.domain IN (${placeholders}) AND m.next_review IS NOT NULL AND m.next_review <= ?
+           ORDER BY m.next_review ASC`)
+                .all(...domains, now.toISOString());
+            for (const c of rows)
+                add(c, null, 'domain_review');
+        }
+        return {
+            session_id: sessionId,
+            questions_needed: picked.length,
+            concepts: picked,
+        };
+    },
+};
+//# sourceMappingURL=get_session_quiz_plan.js.map

package/dist/tools/get_session_quiz_plan.js.map

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

package/dist/tools/index.js

@@ -0,0 +1,45 @@
+import { retryOnBusy } from '../concurrency.js';
+import { getLearnerProfile } from './get_learner_profile.js';
+import { logSessionConcepts } from './log_session_concepts.js';
+import { getSessionQuizPlan } from './get_session_quiz_plan.js';
+import { recordAttempt } from './record_attempt.js';
+import { getGateStatus } from './get_gate_status.js';
+import { upsertConcepts } from './upsert_concepts.js';
+import { getConceptGraph } from './get_concept_graph.js';
+import { getConfig, setConfig } from './config_tools.js';
+export const TOOLS = [
+    getLearnerProfile,
+    logSessionConcepts,
+    getSessionQuizPlan,
+    recordAttempt,
+    getGateStatus,
+    upsertConcepts,
+    getConceptGraph,
+    getConfig,
+    setConfig,
+];
+/** Tool results are JSON text: compact, and small enough to live in context (decision G7). */
+function toResult(payload) {
+    const text = JSON.stringify(payload);
+    const isError = typeof payload === 'object' && payload !== null && 'error' in payload;
+    return { content: [{ type: 'text', text }], isError };
+}
+export function registerTools(server, db) {
+    for (const tool of TOOLS) {
+        server.registerTool(tool.name, { title: tool.title, description: tool.description, inputSchema: tool.inputSchema }, async (args) => {
+            try {
+                // Safe to retry: a busy transaction has already rolled back.
+                return toResult(retryOnBusy(() => tool.handler(args, { db })));
+            }
+            catch (err) {
+                // A tool throwing must not take the server down mid-session.
+                return toResult({
+                    error: 'tool_failed',
+                    tool: tool.name,
+                    detail: err instanceof Error ? err.message : String(err),
+                });
+            }
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAEzD,MAAM,CAAC,MAAM,KAAK,GAAc;IAC9B,iBAAiB;IACjB,kBAAkB;IAClB,kBAAkB;IAClB,aAAa;IACb,aAAa;IACb,cAAc;IACd,eAAe;IACf,SAAS;IACT,SAAS;CACV,CAAC;AAEF,8FAA8F;AAC9F,SAAS,QAAQ,CAAC,OAAgB;IAChC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,IAAI,OAAO,CAAC;IACtF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAiB,EAAE,EAAM;IACrD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,YAAY,CACjB,IAAI,CAAC,IAAI,EACT,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,EACnF,KAAK,EAAE,IAAa,EAAE,EAAE;YACtB,IAAI,CAAC;gBACH,6DAA6D;gBAC7D,OAAO,QAAQ,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YACjE,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,6DAA6D;gBAC7D,OAAO,QAAQ,CAAC;oBACd,KAAK,EAAE,aAAa;oBACpB,IAAI,EAAE,IAAI,CAAC,IAAI;oBACf,MAAM,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBACzD,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CACF,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/tools/log_session_concepts.js

@@ -0,0 +1,83 @@
+import { z } from 'zod';
+import { loadConfig } from '../config.js';
+import { normalizeSlug, findFuzzyMatch } from '../slug.js';
+import { decayedScore, isKnown } from '../srs.js';
+import { resolveSessionId } from '../session.js';
+import { allConceptSlugs, conceptBySlug, insertConcept, logSessionConcept, masteryFor, newConceptsThisSession, sessionConcepts, syncGate, } from '../store.js';
+import { CWD_HINT, SESSION_HINT } from './types.js';
+const DEFAULT_DOMAIN = 'general';
+const DEFAULT_TIER = 2;
+export const logSessionConcepts = {
+    name: 'log_session_concepts',
+    title: 'Log session concepts',
+    description: 'Record the concepts the current task genuinely exercises, each with a one-line context pointing at the real code you wrote. Call this while implementing, batched, 3-8 concepts per task. Unknown slugs are created automatically.',
+    inputSchema: {
+        session_id: z.string().optional().describe(SESSION_HINT),
+        cwd: z.string().optional().describe(CWD_HINT),
+        concepts: z
+            .array(z.object({
+            slug: z.string().describe('kebab-case, e.g. "httponly-cookies"'),
+            name: z.string().optional(),
+            domain: z.string().optional(),
+            tier: z.number().int().min(1).max(5).optional(),
+            context: z.string().optional().describe('One line naming the actual code, e.g. "set httpOnly on the refresh cookie in auth.ts".'),
+        }))
+            .min(1),
+    },
+    handler: (args, { db }) => {
+        const now = new Date();
+        const { config, repoRoot } = loadConfig(args.cwd);
+        const sessionId = resolveSessionId(db, args.session_id);
+        const created = [];
+        const matched = [];
+        const logged = [];
+        let capped = 0;
+        const apply = db.transaction(() => {
+            let budget = Math.max(0, config.max_new_concepts_per_session - newConceptsThisSession(db, sessionId));
+            for (const input of args.concepts) {
+                const slug = normalizeSlug(input.slug);
+                if (!slug)
+                    continue;
+                let concept = conceptBySlug(db, slug);
+                if (!concept) {
+                    const near = findFuzzyMatch(slug, allConceptSlugs(db));
+                    if (near) {
+                        concept = conceptBySlug(db, near.slug);
+                        if (concept)
+                            matched.push({ requested: slug, resolved: concept.slug });
+                    }
+                }
+                if (!concept) {
+                    if (budget <= 0) {
+                        capped += 1;
+                        continue;
+                    }
+                    concept = insertConcept(db, {
+                        slug,
+                        name: input.name ?? slug.replace(/-/g, ' '),
+                        domain: input.domain ?? DEFAULT_DOMAIN,
+                        tier: input.tier ?? DEFAULT_TIER,
+                        source: 'llm',
+                    });
+                    created.push(concept.slug);
+                    budget -= 1;
+                }
+                logSessionConcept(db, sessionId, concept.id, input.context ?? null);
+                logged.push(concept.slug);
+            }
+        });
+        apply();
+        // The gate's bar rises with the work: how many touched concepts are still
+        // unmastered, capped at the configured questions per task.
+        const unmastered = sessionConcepts(db, sessionId).filter((c) => {
+            const m = masteryFor(db, c.id);
+            return !isKnown({ score: decayedScore(m.score, m.next_review, now), reps: m.reps });
+        }).length;
+        const gate = syncGate(db, sessionId, config, {
+            requiredHint: Math.min(unmastered, config.max_questions_per_task),
+            repo: repoRoot,
+        });
+        return { session_id: sessionId, logged, created, matched, capped, gate };
+    },
+};
+//# sourceMappingURL=log_session_concepts.js.map

package/dist/tools/log_session_concepts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log_session_concepts.js","sourceRoot":"","sources":["../../src/tools/log_session_concepts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EACL,eAAe,EACf,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,sBAAsB,EACtB,eAAe,EACf,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAElE,MAAM,cAAc,GAAG,SAAS,CAAC;AACjC,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,CAAC,MAAM,kBAAkB,GAAY;IACzC,IAAI,EAAE,sBAAsB;IAC5B,KAAK,EAAE,sBAAsB;IAC7B,WAAW,EACT,oOAAoO;IACtO,WAAW,EAAE;QACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7C,QAAQ,EAAE,CAAC;aACR,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC;YAChE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC3B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wFAAwF,CAAC;SAClI,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;KACV;IACD,OAAO,EAAE,CACP,IAIC,EACD,EAAE,EAAE,EAAE,EACN,EAAE;QACF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAExD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,MAAM,OAAO,GAA8C,EAAE,CAAC;QAC9D,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAChC,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,4BAA4B,GAAG,sBAAsB,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,CAAC;YAEtG,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClC,MAAM,IAAI,GAAG,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvC,IAAI,CAAC,IAAI;oBAAE,SAAS;gBAEpB,IAAI,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBAEtC,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;oBACvD,IAAI,IAAI,EAAE,CAAC;wBACT,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;wBACvC,IAAI,OAAO;4BAAE,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;oBACzE,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;wBAChB,MAAM,IAAI,CAAC,CAAC;wBACZ,SAAS;oBACX,CAAC;oBACD,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE;wBAC1B,IAAI;wBACJ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;wBAC3C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,cAAc;wBACtC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,YAAY;wBAChC,MAAM,EAAE,KAAK;qBACd,CAAC,CAAC;oBACH,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;oBAC3B,MAAM,IAAI,CAAC,CAAC;gBACd,CAAC;gBAED,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;gBACpE,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;QACH,KAAK,EAAE,CAAC;QAER,0EAA0E;QAC1E,2DAA2D;QAC3D,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,EAAE,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7D,MAAM,CAAC,GAAG,UAAU,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC/B,OAAO,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACtF,CAAC,CAAC,CAAC,MAAM,CAAC;QAEV,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE;YAC3C,YAAY,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,sBAAsB,CAAC;YACjE,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;QAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IAC3E,CAAC;CACF,CAAC"}

package/dist/tools/record_attempt.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+import { loadConfig } from '../config.js';
+import { normalizeSlug } from '../slug.js';
+import { decayedScore, isKnown } from '../srs.js';
+import { resolveSessionId } from '../session.js';
+import { conceptBySlug, gradeConcept, logSessionConcept, syncGate } from '../store.js';
+import { CWD_HINT, SESSION_HINT } from './types.js';
+export const recordAttempt = {
+    name: 'record_attempt',
+    title: 'Record a quiz attempt',
+    description: 'Grade one answer on the 0-5 SM-2 scale and persist it. Updates mastery, the next review date and the session gate. Record skips too, as grade 0 with feedback "skipped".',
+    inputSchema: {
+        session_id: z.string().optional().describe(SESSION_HINT),
+        cwd: z.string().optional().describe(CWD_HINT),
+        slug: z.string().describe('The concept that was asked about.'),
+        question: z.string().describe('The question exactly as asked.'),
+        answer: z.string().optional().describe('The learner\'s answer verbatim. Omit for a skip.'),
+        grade: z
+            .number()
+            .int()
+            .min(0)
+            .max(5)
+            .describe('0 no answer/skip, 1-2 wrong, 3 correct but laboured, 4 correct, 5 correct and explained the why.'),
+        difficulty: z.number().int().min(1).max(5).describe('The tier you actually asked at — use tier_to_ask from the plan.'),
+        feedback: z.string().optional().describe('The short explanation you gave back.'),
+    },
+    handler: (args, { db }) => {
+        const now = new Date();
+        const { config, repoRoot } = loadConfig(args.cwd);
+        const sessionId = resolveSessionId(db, args.session_id);
+        const slug = normalizeSlug(args.slug);
+        const concept = conceptBySlug(db, slug);
+        if (!concept) {
+            return {
+                error: 'unknown_concept',
+                slug,
+                detail: 'No concept with that slug. Call upsert_concepts or log_session_concepts first.',
+            };
+        }
+        const state = db.transaction(() => {
+            // An attempt on a concept the session never logged still counts toward the
+            // gate, so quizzing on review debt is not free.
+            logSessionConcept(db, sessionId, concept.id, null);
+            return gradeConcept(db, {
+                conceptId: concept.id,
+                sessionId,
+                question: args.question,
+                answer: args.answer ?? null,
+                grade: args.grade,
+                difficulty: args.difficulty,
+                feedback: args.feedback ?? null,
+                now,
+            });
+        })();
+        const gate = syncGate(db, sessionId, config, { repo: repoRoot });
+        const score = decayedScore(state.score, state.next_review, now);
+        return {
+            slug: concept.slug,
+            new_score: Number(state.score.toFixed(3)),
+            next_review: state.next_review,
+            interval_days: state.interval_d,
+            reps: state.reps,
+            ease: Number(state.ease.toFixed(2)),
+            known: isKnown({ score, reps: state.reps }),
+            gate,
+        };
+    },
+};
+//# sourceMappingURL=record_attempt.js.map

package/dist/tools/record_attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"record_attempt.js","sourceRoot":"","sources":["../../src/tools/record_attempt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,uBAAuB;IAC9B,WAAW,EACT,0KAA0K;IAC5K,WAAW,EAAE;QACX,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC;QACxD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;QAC9D,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;QAC/D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kDAAkD,CAAC;QAC1F,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,CAAC,CAAC;aACN,QAAQ,CAAC,kGAAkG,CAAC;QAC/G,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iEAAiE,CAAC;QACtH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;KACjF;IACD,OAAO,EAAE,CACP,IASC,EACD,EAAE,EAAE,EAAE,EACN,EAAE;QACF,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,gBAAgB,CAAC,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAExD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO;gBACL,KAAK,EAAE,iBAAiB;gBACxB,IAAI;gBACJ,MAAM,EAAE,gFAAgF;aACzF,CAAC;QACJ,CAAC;QAED,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAChC,2EAA2E;YAC3E,gDAAgD;YAChD,iBAAiB,CAAC,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YACnD,OAAO,YAAY,CAAC,EAAE,EAAE;gBACtB,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,SAAS;gBACT,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,IAAI;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK;gBACjB,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;gBAC/B,GAAG;aACJ,CAAC,CAAC;QACL,CAAC,CAAC,EAAE,CAAC;QAEL,MAAM,IAAI,GAAG,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACjE,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAEhE,OAAO;YACL,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACzC,WAAW,EAAE,KAAK,CAAC,WAAW;YAC9B,aAAa,EAAE,KAAK,CAAC,UAAU;YAC/B,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACnC,KAAK,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC3C,IAAI;SACL,CAAC;IACJ,CAAC;CACF,CAAC"}

package/dist/tools/types.js

@@ -0,0 +1,4 @@
+/** Shared arg shapes so every tool speaks the same dialect. */
+export const CWD_HINT = 'Working directory, so the repo-level .eklavya.json is found. Defaults to the server cwd.';
+export const SESSION_HINT = 'Claude Code session id. Optional — omit it and the server resolves the current session itself.';
+//# sourceMappingURL=types.js.map

package/dist/tools/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAeA,+DAA+D;AAC/D,MAAM,CAAC,MAAM,QAAQ,GAAG,0FAA0F,CAAC;AACnH,MAAM,CAAC,MAAM,YAAY,GACvB,gGAAgG,CAAC"}

package/dist/tools/upsert_concepts.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { loadConfig } from '../config.js';
+import { normalizeSlug, isValidSlug, findFuzzyMatch } from '../slug.js';
+import { resolveSessionId } from '../session.js';
+import { allConceptSlugs, conceptBySlug, insertConcept, newConceptsThisSession } from '../store.js';
+import { CWD_HINT, SESSION_HINT } from './types.js';
+export const upsertConcepts = {
+    name: 'upsert_concepts',
+    title: 'Upsert concepts',
+    description: 'Grow the knowledge graph when work touches a concept that has no slug yet. Slugs are normalized and near-duplicates are folded into the existing concept, so check the returned canonical slug before using it.',
+    inputSchema: {
+        session_id: z.string().optional().describe(SESSION_HINT),
+        cwd: z.string().optional().describe(CWD_HINT),
+        concepts: z
+            .array(z.object({
+            slug: z.string(),
+            name: z.string().optional(),
+            domain: z.string().optional(),
+            tier: z.number().int().min(1).max(5).optional(),
+            description: z.string().optional(),
+        }))
+            .min(1),
+        edges: z
+            .array(z.object({
+            from: z.string(),
+            to: z.string(),
+            relation: z.enum(['prerequisite_of', 'related_to', 'part_of']),
+        }))
+            .optional()
+            .describe('Prefer prerequisite_of edges — they are what orders a teaching session.'),
+    },
+    handler: (args, { db }) => {
+        const { config } = loadConfig(args.cwd);
+        const sessionId = resolveSessionId(db, args.session_id);
+        const created = [];
+        const matched = [];
+        const rejected = [];
+        const resolvedSlug = new Map();
+        let edgesAdded = 0;
+        db.transaction(() => {
+            let budget = Math.max(0, config.max_new_concepts_per_session - newConceptsThisSession(db, sessionId));
+            for (const input of args.concepts) {
+                const slug = normalizeSlug(input.slug);
+                if (!isValidSlug(slug)) {
+                    rejected.push({ slug: input.slug, reason: 'invalid_slug' });
+                    continue;
+                }
+                const existing = conceptBySlug(db, slug);
+                if (existing) {
+                    resolvedSlug.set(input.slug, existing.slug);
+                    matched.push({ requested: slug, resolved: existing.slug });
+                    continue;
+                }
+                const near = findFuzzyMatch(slug, allConceptSlugs(db));
+                if (near) {
+                    resolvedSlug.set(input.slug, near.slug);
+                    matched.push({ requested: slug, resolved: near.slug });
+                    continue;
+                }
+                if (budget <= 0) {
+                    rejected.push({ slug, reason: 'session_cap_reached' });
+                    continue;
+                }
+                const concept = insertConcept(db, {
+                    slug,
+                    name: input.name ?? slug.replace(/-/g, ' '),
+                    domain: input.domain ?? 'general',
+                    description: input.description ?? null,
+                    tier: input.tier ?? 2,
+                    source: 'llm',
+                });
+                resolvedSlug.set(input.slug, concept.slug);
+                created.push(concept.slug);
+                budget -= 1;
+            }
+            const insertEdge = db.prepare('INSERT OR IGNORE INTO edges (from_concept, to_concept, relation) VALUES (?, ?, ?)');
+            for (const edge of args.edges ?? []) {
+                const from = conceptBySlug(db, resolvedSlug.get(edge.from) ?? normalizeSlug(edge.from));
+                const to = conceptBySlug(db, resolvedSlug.get(edge.to) ?? normalizeSlug(edge.to));
+                if (!from || !to || from.id === to.id)
+                    continue;
+                const result = insertEdge.run(from.id, to.id, edge.relation);
+                edgesAdded += result.changes;
+            }
+        })();
+        return { created, matched, rejected, edges_added: edgesAdded };
+    },
+};
+//# sourceMappingURL=upsert_concepts.js.map

package/dist/tools/upsert_concepts.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "eklavya-mcp",
+  "version": "1.0.0",
+  "description": "Eklavya MCP server — local knowledge graph, spaced repetition, and quiz gating for agent-assisted learning.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ProjectAJ14/eklavya.git",
+    "directory": "mcp"
+  },
+  "homepage": "https://github.com/ProjectAJ14/eklavya#readme",
+  "bugs": {
+    "url": "https://github.com/ProjectAJ14/eklavya/issues"
+  },
+  "author": "Ajay Kumar",
+  "keywords": [
+    "mcp",
+    "claude-code",
+    "learning",
+    "spaced-repetition",
+    "sm-2",
+    "knowledge-graph",
+    "tutor",
+    "mentorship"
+  ],
+  "type": "module",
+  "bin": {
+    "eklavya-mcp": "dist/server.js",
+    "eklavya": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && node scripts/copy-assets.mjs",
+    "dev": "tsx src/server.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "pretest": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^12.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.11",
+    "@types/node": "^22.0.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^4.1.11"
+  },
+  "allowScripts": {
+    "better-sqlite3@12.11.1": true,
+    "esbuild@0.28.2": true,
+    "esbuild@0.21.5": true
+  }
+}