eklavya 1.7.0

package/dist/tools/get_concept_graph.js

@@ -0,0 +1,104 @@
+import { z } from 'zod';
+import { decayedScore, isKnown } from '../srs.js';
+const NODE_CAP = 200;
+/**
+ * Prerequisite-first ordering (decision G10). Cycles are broken by tier then
+ * slug so the order is stable rather than dependent on insertion order.
+ */
+function topoSort(nodes, edges) {
+    const indegree = new Map(nodes.map((n) => [n.id, 0]));
+    const out = new Map(nodes.map((n) => [n.id, []]));
+    for (const e of edges) {
+        if (!indegree.has(e.from) || !indegree.has(e.to))
+            continue;
+        out.get(e.from).push(e.to);
+        indegree.set(e.to, indegree.get(e.to) + 1);
+    }
+    const byId = new Map(nodes.map((n) => [n.id, n]));
+    const rank = (id) => {
+        const n = byId.get(id);
+        return `${n.tier}-${n.slug}`;
+    };
+    const ready = nodes.filter((n) => indegree.get(n.id) === 0).map((n) => n.id);
+    ready.sort((a, b) => rank(a).localeCompare(rank(b)));
+    const ordered = [];
+    while (ready.length > 0) {
+        const id = ready.shift();
+        ordered.push(id);
+        for (const next of out.get(id) ?? []) {
+            indegree.set(next, indegree.get(next) - 1);
+            if (indegree.get(next) === 0) {
+                ready.push(next);
+                ready.sort((a, b) => rank(a).localeCompare(rank(b)));
+            }
+        }
+    }
+    // Anything left sits in a cycle; append it deterministically rather than drop it.
+    const placed = new Set(ordered);
+    const leftovers = nodes.filter((n) => !placed.has(n.id)).sort((a, b) => rank(a.id).localeCompare(rank(b.id)));
+    return [...ordered, ...leftovers.map((n) => n.id)];
+}
+export const getConceptGraph = {
+    name: 'get_concept_graph',
+    title: 'Get concept graph',
+    description: 'Concepts and edges for a domain in prerequisite order — the order to teach them in. Optionally annotated with this learner\'s mastery.',
+    inputSchema: {
+        domain: z.string().describe('e.g. "web-auth", "react", "git", "node-backend"'),
+        include_mastery: z.boolean().optional(),
+        unmastered_only: z.boolean().optional().describe('Drop concepts the learner already knows.'),
+    },
+    handler: (args, { db }) => {
+        const now = new Date();
+        const rows = db
+            .prepare(`SELECT c.id, c.slug, c.name, c.tier,
+                m.score, m.reps, m.next_review,
+                (SELECT count(*) FROM attempts a WHERE a.concept_id = c.id) AS attempts
+         FROM concepts c
+         LEFT JOIN mastery m ON m.concept_id = c.id
+         WHERE c.domain = ?`)
+            .all(args.domain);
+        if (rows.length === 0) {
+            return { domain: args.domain, concepts: [], edges: [], truncated: false };
+        }
+        const ids = rows.map((r) => r.id);
+        const placeholders = ids.map(() => '?').join(',');
+        const edgeRows = db
+            .prepare(`SELECT from_concept, to_concept, relation FROM edges
+         WHERE from_concept IN (${placeholders}) AND to_concept IN (${placeholders})`)
+            .all(...ids, ...ids);
+        const order = topoSort(rows.map((r) => ({ id: r.id, slug: r.slug, tier: r.tier })), edgeRows
+            .filter((e) => e.relation === 'prerequisite_of')
+            .map((e) => ({ from: e.from_concept, to: e.to_concept })));
+        const byId = new Map(rows.map((r) => [r.id, r]));
+        const slugOf = new Map(rows.map((r) => [r.id, r.slug]));
+        let nodes = order.map((id) => {
+            const r = byId.get(id);
+            const node = { slug: r.slug, name: r.name, tier: r.tier };
+            if (args.include_mastery) {
+                const score = decayedScore(r.score ?? 0, r.next_review, now);
+                node.score = Number(score.toFixed(2));
+                node.known = r.attempts > 0 && isKnown({ score, reps: r.reps ?? 0 });
+                node.attempts = r.attempts;
+            }
+            return node;
+        });
+        if (args.unmastered_only) {
+            const now2 = new Date();
+            const knownIds = new Set(rows
+                .filter((r) => r.attempts > 0 &&
+                isKnown({ score: decayedScore(r.score ?? 0, r.next_review, now2), reps: r.reps ?? 0 }))
+                .map((r) => r.slug));
+            nodes = nodes.filter((n) => !knownIds.has(n.slug));
+        }
+        const truncated = nodes.length > NODE_CAP;
+        return {
+            domain: args.domain,
+            concepts: nodes.slice(0, NODE_CAP),
+            edges: edgeRows
+                .map((e) => ({ from: slugOf.get(e.from_concept), to: slugOf.get(e.to_concept), relation: e.relation }))
+                .slice(0, NODE_CAP * 2),
+            truncated,
+        };
+    },
+};
+//# sourceMappingURL=get_concept_graph.js.map

package/dist/tools/get_concept_graph.js.map

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

package/dist/tools/get_gate_status.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { loadConfig } from '../config.js';
+import { resolveSessionId } from '../session.js';
+import { syncGate } from '../store.js';
+import { CWD_HINT, SESSION_HINT } from './types.js';
+export const getGateStatus = {
+    name: 'get_gate_status',
+    title: 'Get gate status',
+    description: 'Whether this session has passed its quiz gate. In enforced mode commits stay blocked until it has.',
+    inputSchema: {
+        session_id: z.string().optional().describe(SESSION_HINT),
+        cwd: z.string().optional().describe(CWD_HINT),
+    },
+    handler: (args, { db }) => {
+        const { config, repoRoot } = loadConfig(args.cwd);
+        const sessionId = resolveSessionId(db, args.session_id);
+        return { session_id: sessionId, ...syncGate(db, sessionId, config, { repo: repoRoot }) };
+    },
+};
+//# sourceMappingURL=get_gate_status.js.map

package/dist/tools/get_gate_status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_gate_status.js","sourceRoot":"","sources":["../../src/tools/get_gate_status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAgB,MAAM,YAAY,CAAC;AAElE,MAAM,CAAC,MAAM,aAAa,GAAY;IACpC,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,iBAAiB;IACxB,WAAW,EACT,oGAAoG;IACtG,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;KAC9C;IACD,OAAO,EAAE,CAAC,IAA2C,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE;QAC/D,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;QACxD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAC;IAC3F,CAAC;CACF,CAAC"}

package/dist/tools/get_learner_profile.js

@@ -0,0 +1,142 @@
+import { z } from 'zod';
+import { loadConfig, isDomainEnabled } from '../config.js';
+import { clampToLevel, decayedScore, isKnown, isDue, nextTierToAsk, suggestedTier } from '../srs.js';
+import { levelStanding } from '../store.js';
+import { CWD_HINT } from './types.js';
+const LIST_CAP = 8;
+/** Mastered concepts are the "don't ask this" list, so it gets more room than the rest. */
+const KNOWN_CAP = 30;
+const WEAK_THRESHOLD = 0.5;
+export const getLearnerProfile = {
+    name: 'get_learner_profile',
+    title: 'Get learner profile',
+    description: 'What this developer already knows. Call before teaching or quizzing so you never ask about a mastered concept. Returns mode, per-domain counts, the concepts already mastered, weak concepts, what is due for review, the tier to pitch at, and this project\'s difficulty level with the progress toward the next one. Every tier here is already clamped to that level. Also returns the three things a progress report needs and mastery counts cannot give: `projects` (per-repo answered/passed, so a report can say *which* codebase), `recent_concepts` (what was logged, with the context line naming the real code it came from) and `skipped` (declined or blanked, the actionable backlog).',
+    inputSchema: {
+        domain: z.string().optional().describe('Restrict to one domain, e.g. "web-auth".'),
+        cwd: z.string().optional().describe(CWD_HINT),
+    },
+    handler: (args, { db }) => {
+        const now = new Date();
+        const { config, repoRoot } = loadConfig(args.cwd);
+        // Tiers reported here are what the tutor calibrates against, so they are
+        // clamped to the project's band exactly as the planner clamps them. An
+        // unclamped `suggested_tier` is how a learner on `easy` gets pitched at 3.
+        const standing = levelStanding(db, config, repoRoot);
+        const rows = db
+            .prepare(`SELECT c.id, c.slug, c.domain, c.tier,
+                m.score, m.reps, m.next_review,
+                (SELECT count(*) FROM attempts a WHERE a.concept_id = c.id) AS attempts,
+                (SELECT a.grade FROM attempts a WHERE a.concept_id = c.id ORDER BY a.id DESC LIMIT 1) AS last_grade,
+                (SELECT a.difficulty FROM attempts a WHERE a.concept_id = c.id ORDER BY a.id DESC LIMIT 1) AS last_difficulty
+         FROM concepts c
+         LEFT JOIN mastery m ON m.concept_id = c.id
+         ${args.domain ? 'WHERE c.domain = ?' : ''}`)
+            .all(...(args.domain ? [args.domain] : []));
+        const domains = new Map();
+        const knownTiers = [];
+        const weak = [];
+        const known = [];
+        const due = [];
+        for (const row of rows) {
+            if (!isDomainEnabled(config, row.domain))
+                continue;
+            const bucket = domains.get(row.domain) ?? { domain: row.domain, known: 0, learning: 0, unseen: 0 };
+            domains.set(row.domain, bucket);
+            if (row.attempts === 0) {
+                bucket.unseen += 1;
+                continue;
+            }
+            // Decay is a read-time view only — never written back (PRD §7).
+            const score = decayedScore(row.score ?? 0, row.next_review, now);
+            const reps = row.reps ?? 0;
+            if (isKnown({ score, reps })) {
+                bucket.known += 1;
+                knownTiers.push(row.tier);
+                // Named, not just counted: the tutor is told never to re-ask a mastered
+                // concept, which it can only honor if it is told which ones those are.
+                known.push({ slug: row.slug, score });
+            }
+            else {
+                bucket.learning += 1;
+            }
+            if (score < WEAK_THRESHOLD)
+                weak.push({ slug: row.slug, score: Number(score.toFixed(2)), tier: row.tier });
+            if (isDue(row.next_review, now)) {
+                due.push({
+                    slug: row.slug,
+                    tier: row.tier,
+                    tier_to_ask: clampToLevel(nextTierToAsk({
+                        conceptTier: row.tier,
+                        lastDifficulty: row.last_difficulty,
+                        lastGrade: row.last_grade,
+                        score,
+                    }), standing.level),
+                });
+            }
+        }
+        const domainFilter = args.domain ? 'AND c.domain = ?' : '';
+        const domainArg = args.domain ? [args.domain] : [];
+        // Three things mastery counts cannot answer, and a progress report must:
+        // which project this happened on, what was actually learned there, and
+        // what was ducked. All three are already in the schema; nothing read them.
+        const projects = db
+            .prepare(`SELECT NULLIF(trim(COALESCE(a.repo, '')), '') AS repo, count(*) AS answers,
+                sum(CASE WHEN a.grade >= 3 THEN 1 ELSE 0 END) AS passed,
+                max(a.ts) AS last_active
+         FROM attempts a JOIN concepts c ON c.id = a.concept_id
+         WHERE 1 = 1 ${domainFilter}
+         GROUP BY repo
+         ORDER BY last_active DESC
+         LIMIT ?`)
+            .all(...domainArg, LIST_CAP);
+        // `session_concepts` has no repo of its own; the session's gate row carries
+        // it. LEFT JOIN because a session that never opened a gate still logged work.
+        const recent = db
+            .prepare(`SELECT c.slug AS slug, sc.context AS context, sc.ts AS ts, g.repo AS repo
+         FROM session_concepts sc
+         JOIN concepts c ON c.id = sc.concept_id
+         LEFT JOIN gates g ON g.session_id = sc.session_id
+         WHERE sc.context IS NOT NULL AND trim(sc.context) <> '' ${domainFilter}
+         ORDER BY sc.ts DESC
+         LIMIT ?`)
+            .all(...domainArg, LIST_CAP);
+        // A NULL outcome is a row written before migration 004, not a skip. `IN`
+        // excludes it: counting those as ducked would invent a backlog.
+        const skipped = db
+            .prepare(`SELECT c.slug AS slug, a.outcome AS outcome, a.repo AS repo, a.ts AS ts
+         FROM attempts a JOIN concepts c ON c.id = a.concept_id
+         WHERE a.outcome IN ('declined','dont_know') ${domainFilter}
+         ORDER BY a.ts DESC
+         LIMIT ?`)
+            .all(...domainArg, LIST_CAP);
+        weak.sort((a, b) => a.score - b.score);
+        due.sort((a, b) => b.tier - a.tier);
+        known.sort((a, b) => b.score - a.score);
+        return {
+            mode: config.mode,
+            domains: [...domains.values()].sort((a, b) => a.domain.localeCompare(b.domain)),
+            known: known.slice(0, KNOWN_CAP).map((k) => k.slug),
+            known_total: known.length,
+            weak: weak.slice(0, LIST_CAP).map((w) => w.slug),
+            due_for_review: due.slice(0, LIST_CAP),
+            projects,
+            recent_concepts: recent,
+            skipped,
+            suggested_tier: clampToLevel(suggestedTier(knownTiers), standing.level),
+            level: {
+                level: standing.level,
+                next: standing.next,
+                passed: standing.counts.passed,
+                needed: standing.needed.answers,
+                concepts: standing.counts.concepts,
+                needed_concepts: standing.needed.concepts,
+                accuracy: standing.accuracy,
+                min_accuracy: standing.needed.accuracy,
+                repo: standing.repo,
+                ...(standing.pinned ? { pinned: true } : {}),
+            },
+            truncated: weak.length > LIST_CAP || due.length > LIST_CAP || known.length > KNOWN_CAP,
+        };
+    },
+};
+//# sourceMappingURL=get_learner_profile.js.map

package/dist/tools/get_learner_profile.js.map

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