eklavya 1.7.0

package/dist/tools/record_attempt.js

@@ -0,0 +1,158 @@
+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, hasAskedQuestion, levelStanding, logSessionConcept, promoteIfEarned, syncGate, MAX_MCQ_GRADE, } from '../store.js';
+import { stripAskFooter } from '../ask.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, the session gate and this project\'s difficulty level. Record every response, including "I don\'t know" (grade 0, outcome dont_know, after you have taught it) and declines (grade 0, outcome declined). Pass format and, for multiple choice, the options you offered — put only the stem in question, never the options and never the ask_footer line, or the repeat check breaks. Multiple choice is capped at grade 4: picking one of four cannot show you know why. Returns level and level_progress, and level_up on the answer that earns a promotion — say that in one line and move on.',
+    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 stem exactly as asked — WITHOUT the options and WITHOUT the ask_footer line. This text is what stops the same question coming back later, so anything baked in here that moves (shuffled options, the level in the footer) would make one question look like several.'),
+        answer: z
+            .string()
+            .optional()
+            .describe('The learner\'s answer verbatim — for multiple choice, the option they picked (or what they typed under "Other"). 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.'),
+        format: z
+            .enum(['mcq', 'fill_blank', 'open'])
+            .optional()
+            .describe('How you put the question. "mcq" is the default shape — four options via AskUserQuestion. Say so, because a correct multiple-choice answer is weaker evidence than a correct free one and is graded accordingly.'),
+        options: z
+            .array(z.string())
+            .optional()
+            .describe('For mcq: the option labels you offered, in the order shown. Not the stem.'),
+        outcome: z
+            .enum(['answered', 'dont_know', 'declined'])
+            .optional()
+            .describe('Why the grade is what it is. "answered" they attempted it; "dont_know" they said they did not know and you taught it; "declined" they chose to skip. Grade 0 covers the last two, so this is the only thing that tells them apart later.'),
+    },
+    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.',
+            };
+        }
+        // The footer is presentation. Stripped rather than rejected, because the
+        // tutor pasting back the block it displayed is the likely mistake and losing
+        // a real answer over it would be the wrong trade.
+        const question = stripAskFooter(args.question);
+        // Which band this answer was earned at, read before the write so a promotion
+        // triggered by this very attempt cannot relabel it.
+        const standing = levelStanding(db, config, repoRoot);
+        // Checked before the write, or the question we are recording matches itself.
+        const repeatQuestion = hasAskedQuestion(db, concept.id, question);
+        // Enforced here rather than trusted to the tutor. Grade 5 means "explained
+        // why", which choosing among four options cannot demonstrate; one in four is
+        // a coin. Capping is visible in the response so a tutor that keeps awarding
+        // 5s for multiple choice finds out.
+        const capped = args.format === 'mcq' && args.grade > MAX_MCQ_GRADE;
+        const grade = capped ? MAX_MCQ_GRADE : args.grade;
+        const graded = db.transaction(() => {
+            // An attempt on a concept the session never logged still counts toward
+            // `answered`, so quizzing on review debt is not free -- but it lands as
+            // 'review', so it cannot satisfy a bar that the session's actual work set.
+            // If the task did touch this concept, log_session_concepts has already
+            // marked it 'work' and that wins.
+            logSessionConcept(db, sessionId, concept.id, null, 'review');
+            const next = gradeConcept(db, {
+                conceptId: concept.id,
+                sessionId,
+                question,
+                answer: args.answer ?? null,
+                grade,
+                difficulty: args.difficulty,
+                feedback: args.feedback ?? null,
+                format: args.format ?? null,
+                options: args.options ?? null,
+                // Left NULL rather than guessed when the tutor does not say. An absent
+                // answer is a fair hint that nothing was attempted, but it cannot tell
+                // "teach me" from "leave it" -- and inventing the difference here would
+                // put a value in the column that nobody observed.
+                outcome: args.outcome ?? null,
+                repo: standing.repo,
+                level: standing.level,
+                now,
+            });
+            // In the same transaction as the grade: a promotion is a fact about
+            // attempt rows, and a crash between the two would leave a level claiming
+            // evidence that was rolled back.
+            return { state: next, promotion: promoteIfEarned(db, config, repoRoot) };
+        })();
+        const state = graded.state;
+        const after = levelStanding(db, config, repoRoot);
+        const gate = syncGate(db, sessionId, config, { repo: repoRoot });
+        const score = decayedScore(state.score, state.next_review, now);
+        return {
+            slug: concept.slug,
+            recorded_grade: grade,
+            // Silence here would let the tutor keep miscalibrating; say what was
+            // changed and why.
+            ...(capped
+                ? {
+                    grade_capped: true,
+                    detail: `Multiple choice is capped at ${MAX_MCQ_GRADE}: recognising the right option does not show you can explain it. Recorded ${grade} instead of ${args.grade}.`,
+                }
+                : {}),
+            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 }),
+            // PRD goal 2. Recorded either way — refusing the write would lose a real
+            // answer — but the tutor is told, so the next question can be a new one.
+            repeat_question: repeatQuestion,
+            gate,
+            level: after.level,
+            // The runway, said in numbers. A level nobody can see the progress toward
+            // is a level that feels identical in week one and week ten.
+            level_progress: {
+                passed: after.counts.passed,
+                needed: after.needed.answers,
+                answered: after.counts.answered,
+                accuracy: after.accuracy,
+                min_accuracy: after.needed.accuracy,
+                concepts: after.counts.concepts,
+                needed_concepts: after.needed.concepts,
+                next: after.next,
+                ...(after.pinned ? { pinned: true } : {}),
+                ...(after.unmet.length > 0 ? { unmet: after.unmet } : {}),
+            },
+            ...(graded.promotion
+                ? {
+                    level_up: {
+                        from: graded.promotion.from,
+                        to: graded.promotion.to,
+                        passed: graded.promotion.counts.passed,
+                        accuracy: Number((graded.promotion.counts.passed / Math.max(1, graded.promotion.counts.answered)).toFixed(3)),
+                        detail: `Say this in one line and go back to the task: they have cleared ${graded.promotion.from} on this project, and questions now come from the ${graded.promotion.to} band.`,
+                    },
+                }
+                : {}),
+        };
+    },
+};
+//# 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":"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"}

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":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AACpG,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAElE,MAAM,CAAC,MAAM,cAAc,GAAY;IACrC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,iNAAiN;IACnN,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;YAChB,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,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;SACnC,CAAC,CACH;aACA,GAAG,CAAC,CAAC,CAAC;QACT,KAAK,EAAE,CAAC;aACL,KAAK,CACJ,CAAC,CAAC,MAAM,CAAC;YACP,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;YAChB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;YACd,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,iBAAiB,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;SAC/D,CAAC,CACH;aACA,QAAQ,EAAE;aACV,QAAQ,CAAC,yEAAyE,CAAC;KACvF;IACD,OAAO,EAAE,CACP,IAKC,EACD,EAAE,EAAE,EAAE,EACN,EAAE;QACF,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACxC,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,QAAQ,GAAuC,EAAE,CAAC;QACxD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC/C,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;YAClB,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,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;oBACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAC;oBAC5D,SAAS;gBACX,CAAC;gBAED,MAAM,QAAQ,GAAG,aAAa,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;gBACzC,IAAI,QAAQ,EAAE,CAAC;oBACb,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC;oBAC5C,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;oBAC3D,SAAS;gBACX,CAAC;gBAED,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC;gBACvD,IAAI,IAAI,EAAE,CAAC;oBACT,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;oBACxC,OAAO,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;oBACvD,SAAS;gBACX,CAAC;gBAED,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;oBAChB,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,qBAAqB,EAAE,CAAC,CAAC;oBACvD,SAAS;gBACX,CAAC;gBAED,MAAM,OAAO,GAAG,aAAa,CAAC,EAAE,EAAE;oBAChC,IAAI;oBACJ,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC;oBAC3C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;oBACjC,WAAW,EAAE,KAAK,CAAC,WAAW,IAAI,IAAI;oBACtC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC;oBACrB,MAAM,EAAE,KAAK;iBACd,CAAC,CAAC;gBACH,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC3C,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBAC3B,MAAM,IAAI,CAAC,CAAC;YACd,CAAC;YAED,MAAM,UAAU,GAAG,EAAE,CAAC,OAAO,CAC3B,mFAAmF,CACpF,CAAC;YACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;gBACpC,MAAM,IAAI,GAAG,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBACxF,MAAM,EAAE,GAAG,aAAa,CAAC,EAAE,EAAE,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;gBAClF,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE;oBAAE,SAAS;gBAChD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;gBAC7D,UAAU,IAAI,MAAM,CAAC,OAAO,CAAC;YAC/B,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;IACjE,CAAC;CACF,CAAC"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "eklavya",
+  "version": "1.7.0",
+  "description": "Learn while your agent works \u2014 local knowledge graph, spaced repetition, and quiz gating for agent-assisted development.",
+  "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": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "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
+  }
+}