eklavya 1.7.0

package/dist/dashboard.js

@@ -0,0 +1,214 @@
+/**
+ * `eklavya dashboard` — the learning state as a local web page.
+ *
+ * The terminal report has to fit in twenty lines, so it answers "what now?".
+ * This answers "am I getting better?", which needs history, per-project
+ * comparison and the full concept list — none of which fit in a paragraph.
+ *
+ * Deliberately a static page plus one JSON endpoint: no framework, no build
+ * step, same rule the landing page follows. It binds to loopback only, which
+ * is the whole security model — the data never leaves the machine, and that
+ * is a promise the landing page makes on Eklavya's behalf.
+ */
+import http from 'node:http';
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { decayedScore, isDue, isKnown } from './srs.js';
+import { GLOBAL_PROJECT } from './store.js';
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+/**
+ * High, unassigned, and deliberately boring to collide with.
+ *
+ * The low 5000s are where every dev server lands — Vite alone walks 5173, 5174,
+ * 5175 upward as it finds ports taken — so a default down there is a default
+ * you have to override. This sits above the registered services in /etc/services
+ * and below the 49152+ ephemeral range the OS hands out for outbound sockets,
+ * so neither end can claim it first. (1729 is the Hardy–Ramanujan number, which
+ * is as good a reason as any to remember it.)
+ */
+const DEFAULT_PORT = 41729;
+/** Enough history to see a trend, short enough to stay one screen wide. */
+const TIMELINE_DAYS = 30;
+export function dashboardState(db) {
+    const now = new Date();
+    // One row per calendar day, split three ways. `grade >= 3` is the same pass
+    // line the level ladder uses, so the chart and the promotion agree.
+    const timeline = db
+        .prepare(`SELECT date(ts) AS day,
+              NULLIF(trim(COALESCE(repo, '')), '') AS repo,
+              sum(CASE WHEN grade >= 3 THEN 1 ELSE 0 END) AS passed,
+              sum(CASE WHEN grade < 3 AND (outcome IS NULL OR outcome = 'answered') THEN 1 ELSE 0 END) AS missed,
+              sum(CASE WHEN outcome IN ('declined','dont_know') THEN 1 ELSE 0 END) AS skipped
+       FROM attempts
+       WHERE ts >= date('now', ?)
+       GROUP BY day, repo
+       ORDER BY day`)
+        .all(`-${TIMELINE_DAYS} days`);
+    // A null repo is the pre-migration-003 bucket. It is kept, not dropped:
+    // hiding those rows would silently shrink every total on the page.
+    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,
+              sum(CASE WHEN a.outcome IN ('declined','dont_know') THEN 1 ELSE 0 END) AS skipped,
+              count(DISTINCT a.concept_id) AS concepts,
+              max(a.ts) AS last_active
+       FROM attempts a
+       GROUP BY repo
+       ORDER BY last_active DESC`)
+        .all();
+    const levels = new Map(db.prepare('SELECT repo, level, promoted_at FROM project_levels').all().map((r) => [r.repo, r]));
+    const conceptRows = db
+        .prepare(`SELECT c.slug, c.name, c.domain, c.tier,
+              m.score, m.reps, m.next_review, m.last_seen,
+              (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 sc.context FROM session_concepts sc
+                WHERE sc.concept_id = c.id AND sc.context IS NOT NULL
+                ORDER BY sc.ts DESC LIMIT 1) AS last_context,
+              (SELECT a.repo FROM attempts a
+                WHERE a.concept_id = c.id AND a.repo IS NOT NULL AND trim(a.repo) <> ''
+                ORDER BY a.id DESC LIMIT 1) AS last_repo
+       FROM concepts c
+       LEFT JOIN mastery m ON m.concept_id = c.id`)
+        .all();
+    const domains = new Map();
+    const concepts = [];
+    for (const row of conceptRows) {
+        const bucket = domains.get(row.domain) ?? { domain: row.domain, mastered: 0, learning: 0, unseen: 0 };
+        domains.set(row.domain, bucket);
+        if (row.attempts === 0) {
+            bucket.unseen += 1;
+            continue;
+        }
+        // Read-time decay only, exactly as the profile computes it — two surfaces
+        // disagreeing about the same score is worse than either being wrong.
+        const score = decayedScore(row.score ?? 0, row.next_review, now);
+        const mastered = isKnown({ score, reps: row.reps ?? 0 });
+        if (mastered)
+            bucket.mastered += 1;
+        else
+            bucket.learning += 1;
+        concepts.push({
+            slug: row.slug,
+            name: row.name,
+            domain: row.domain,
+            tier: row.tier,
+            score: Number(score.toFixed(2)),
+            reps: row.reps ?? 0,
+            attempts: row.attempts,
+            last_grade: row.last_grade,
+            mastered,
+            due: isDue(row.next_review, now),
+            next_review: row.next_review,
+            last_seen: row.last_seen,
+            context: row.last_context,
+            repo: row.last_repo,
+        });
+    }
+    concepts.sort((a, b) => a.score - b.score);
+    const skipped = db
+        .prepare(`SELECT c.slug AS slug, c.name AS name, c.domain AS domain,
+              a.outcome AS outcome, a.repo AS repo, a.ts AS ts, a.question AS question
+       FROM attempts a JOIN concepts c ON c.id = a.concept_id
+       WHERE a.outcome IN ('declined','dont_know')
+       ORDER BY a.ts DESC`)
+        .all();
+    const recent = db
+        .prepare(`SELECT c.slug AS slug, c.domain AS domain, 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) <> ''
+       ORDER BY sc.ts DESC
+       LIMIT 40`)
+        .all();
+    const totals = timeline.reduce((acc, d) => ({
+        passed: acc.passed + d.passed,
+        missed: acc.missed + d.missed,
+        skipped: acc.skipped + d.skipped,
+    }), { passed: 0, missed: 0, skipped: 0 });
+    const allTime = db
+        .prepare(`SELECT count(*) AS answers,
+              sum(CASE WHEN grade >= 3 THEN 1 ELSE 0 END) AS passed,
+              sum(CASE WHEN outcome IN ('declined','dont_know') THEN 1 ELSE 0 END) AS skipped
+       FROM attempts`)
+        .get();
+    return {
+        generated_at: now.toISOString(),
+        timeline_days: TIMELINE_DAYS,
+        totals: {
+            answers: allTime.answers,
+            passed: allTime.passed ?? 0,
+            skipped: allTime.skipped ?? 0,
+            mastered: concepts.filter((c) => c.mastered).length,
+            due: concepts.filter((c) => c.due).length,
+            touched: concepts.length,
+            catalogue: conceptRows.length,
+            window: totals,
+        },
+        timeline,
+        projects: projects.map((p) => ({
+            ...p,
+            level: levels.get(p.repo ?? GLOBAL_PROJECT)?.level ?? 'easy',
+            promoted_at: levels.get(p.repo ?? GLOBAL_PROJECT)?.promoted_at ?? null,
+        })),
+        domains: [...domains.values()].sort((a, b) => b.mastered + b.learning - (a.mastered + a.learning)),
+        concepts,
+        skipped,
+        recent,
+    };
+}
+function send(res, status, type, body) {
+    res.writeHead(status, {
+        'content-type': type,
+        // A dashboard read from a stale cache is a dashboard that lies about
+        // progress made ten seconds ago, which is the one thing it is for.
+        'cache-control': 'no-store',
+    });
+    res.end(body);
+}
+/**
+ * Starts the server and resolves with the URL it actually bound to. The
+ * requested port may be taken by a second dashboard or an unrelated dev
+ * server; falling back to an ephemeral port beats failing with EADDRINUSE
+ * when the caller does not care which port it gets.
+ */
+export function startDashboard(db, opts = {}) {
+    const host = opts.host ?? '127.0.0.1';
+    const wanted = opts.port ?? DEFAULT_PORT;
+    const assets = path.join(moduleDir, 'assets');
+    const server = http.createServer((req, res) => {
+        const url = new URL(req.url ?? '/', `http://${host}`);
+        try {
+            if (url.pathname === '/api/state') {
+                return send(res, 200, 'application/json', JSON.stringify(dashboardState(db)));
+            }
+            if (url.pathname === '/tokens.css') {
+                return send(res, 200, 'text/css', fs.readFileSync(path.join(assets, 'tokens.css')));
+            }
+            if (url.pathname === '/' || url.pathname === '/index.html') {
+                return send(res, 200, 'text/html; charset=utf-8', fs.readFileSync(path.join(assets, 'dashboard.html')));
+            }
+            return send(res, 404, 'text/plain', 'not found');
+        }
+        catch (err) {
+            return send(res, 500, 'text/plain', err instanceof Error ? err.message : 'error');
+        }
+    });
+    return new Promise((resolve, reject) => {
+        server.once('error', (err) => {
+            if (err.code !== 'EADDRINUSE' || opts.port !== undefined)
+                return reject(err);
+            server.listen(0, host);
+        });
+        server.on('listening', () => {
+            const addr = server.address();
+            const port = typeof addr === 'object' && addr ? addr.port : wanted;
+            resolve({ url: `http://${host}:${port}`, close: () => server.close() });
+        });
+        server.listen(wanted, host);
+    });
+}
+//# sourceMappingURL=dashboard.js.map

package/dist/dashboard.js.map

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

package/dist/db.js

@@ -0,0 +1,26 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import Database from 'better-sqlite3';
+import { dbPath } from './paths.js';
+import { runMigrations } from './migrate.js';
+import { seedIfNeeded } from './seed.js';
+/**
+ * Opens (creating if needed) the knowledge DB with the pragmas the design
+ * depends on: WAL so several Claude Code sessions and the git hook can share
+ * the file (PRD §8 "Concurrency"), and foreign keys so the graph stays honest.
+ */
+export function openDb(file = dbPath()) {
+    if (file !== ':memory:') {
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+    }
+    const db = new Database(file);
+    db.pragma('journal_mode = WAL');
+    db.pragma('foreign_keys = ON');
+    // Concurrent writers (two sessions, or a session plus the pre-commit hook)
+    // should wait briefly rather than fail with SQLITE_BUSY.
+    db.pragma('busy_timeout = 5000');
+    runMigrations(db);
+    seedIfNeeded(db);
+    return db;
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAIzC;;;;GAIG;AACH,MAAM,UAAU,MAAM,CAAC,OAAe,MAAM,EAAE;IAC5C,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC9B,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAChC,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,CAAC;IAC/B,2EAA2E;IAC3E,yDAAyD;IACzD,EAAE,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;IAEjC,aAAa,CAAC,EAAE,CAAC,CAAC;IAClB,YAAY,CAAC,EAAE,CAAC,CAAC;IAEjB,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/hooks/checkpoint-quiz.js

@@ -0,0 +1,152 @@
+/**
+ * PostToolUse(log_session_concepts): ask ONE question, here, now, mid-task.
+ *
+ * This is the hook that makes the pitch literal. Everything else in Eklavya
+ * quizzes at Stop, which means the developer is asked four questions at the exact
+ * moment they wanted to be finished -- learning bolted onto the end of the work
+ * rather than happening during it. The seam this fires on is the best one
+ * available: the model has just told the server "this task exercises
+ * jwt-verification, and here is the line where", so the code that teaches the
+ * concept is still on screen and still in context. A question asked there costs
+ * seconds. The same question asked twenty minutes later costs a re-read.
+ *
+ * THE BURST GUARD IS THE POINT OF THIS FILE, exactly as the loop guard is the
+ * point of stop-quiz-check.ts -- but it guards a different failure. That one
+ * stops an end-of-turn loop; this one stops a mid-turn pile-up. The model logs
+ * concepts in batches of 3-8 and may call the tool several times in one task, so
+ * the naive version asks eight questions in a row and gets uninstalled. Three
+ * rules keep it to a trickle:
+ *
+ *   1. one question per checkpoint, never a batch (max: 1, and we say so);
+ *   2. min_minutes_between_checkpoints since the last one, wall clock;
+ *   3. the session budget is max_questions_per_task, shared with the Stop hook.
+ *
+ * Rule 3 is why this does not add questions, it moves them. Every answer here is
+ * an `attempts` row, and stop-quiz-check.ts subtracts those from its own budget.
+ * Answer the lot while the agent works and the Stop hook says nothing at all.
+ *
+ * Failure is always silent: exit 0, no output. A missed question is nothing; a
+ * hook that errors on every tool call is a plugin nobody keeps.
+ */
+import { run, openExisting, config, cwdOf, sessionId, minutesSince, framingFor } from './lib.js';
+await run(async (input) => {
+    // Fast path. `agent_id` is present only inside a subagent, and a subagent
+    // cannot ask the developer anything -- AskUserQuestion is not in its toolset,
+    // and the human is not watching that transcript. Checkpointing there would
+    // burn a question from the budget on a prompt nobody ever sees.
+    if (input.agent_id)
+        return 0;
+    const db = openExisting();
+    if (!db)
+        return 0;
+    const cwd = cwdOf(input);
+    const { mode, cadence, focus, focus_topic, max_questions_per_task, min_minutes_between_checkpoints } = config(cwd).config;
+    if (mode === 'off')
+        return 0;
+    // The whole feature behind one switch. `end` is the pre-1.4 behaviour: silence
+    // until Stop.
+    if (cadence !== 'interleaved')
+        return 0;
+    const sid = sessionId(input, db);
+    if (!sid)
+        return 0;
+    // One query for every number this decision needs.
+    //
+    // The candidate count and the concept line below share their WHERE clause with
+    // stop-quiz-check.ts, and must: a concept this hook considers unaskable is one
+    // the Stop hook has to catch, and the two disagreeing is how a learner gets
+    // asked about something twice or never.
+    const stats = db
+        .prepare(`SELECT
+         (SELECT count(*) FROM session_concepts sc
+            JOIN concepts c ON c.id = sc.concept_id
+            LEFT JOIN mastery m ON m.concept_id = c.id
+           WHERE sc.session_id = @sid
+             AND COALESCE(sc.origin,'work') = 'work'
+             AND NOT (COALESCE(m.score,0) >= 0.7 AND COALESCE(m.reps,0) >= 2)
+             AND sc.concept_id NOT IN
+                 (SELECT concept_id FROM attempts WHERE session_id = @sid)) AS candidates,
+         -- Spent budget. Every attempt counts, wherever it was asked: a question
+         -- the Stop hook already got answered is one this hook must not re-spend.
+         (SELECT count(*) FROM attempts WHERE session_id = @sid) AS spent,
+         -- Both clocks, for the same reason stop-quiz-check.ts checks both: a
+         -- checkpoint stamped without a question ever being asked (the model
+         -- ignored us) should still pace the next one, and an answer given
+         -- without a checkpoint (the Stop hook ran, or the developer asked for a
+         -- quiz) should too.
+         (SELECT last_checkpoint_at FROM checkpoints WHERE session_id = @sid) AS last_checkpoint,
+         (SELECT ts FROM attempts WHERE session_id = @sid ORDER BY id DESC LIMIT 1) AS last_answer`)
+        .get({ sid });
+    if (!stats)
+        return 0;
+    // Nothing unmastered and unasked. Concepts already attempted this session are
+    // excluded above -- they have had their turn.
+    if (stats.candidates <= 0)
+        return 0;
+    // --- the burst guard -------------------------------------------------------
+    if (stats.spent >= max_questions_per_task)
+        return 0;
+    if (minutesSince(stats.last_checkpoint) < min_minutes_between_checkpoints)
+        return 0;
+    if (minutesSince(stats.last_answer) < min_minutes_between_checkpoints)
+        return 0;
+    // ---------------------------------------------------------------------------
+    // The concept most recently logged, not the oldest. The Stop hook orders ASC
+    // because it is sweeping up a whole session; this hook is asking about the code
+    // that was just written, and the last row is the one the call that triggered us
+    // put there.
+    const row = db
+        .prepare(`SELECT c.slug || COALESCE(' (' || sc.context || ')', '') AS concept
+         FROM session_concepts sc
+         JOIN concepts c ON c.id = sc.concept_id
+         LEFT JOIN mastery m ON m.concept_id = c.id
+        WHERE sc.session_id = @sid
+          AND COALESCE(sc.origin,'work') = 'work'
+          AND NOT (COALESCE(m.score,0) >= 0.7 AND COALESCE(m.reps,0) >= 2)
+          AND sc.concept_id NOT IN
+              (SELECT concept_id FROM attempts WHERE session_id = @sid)
+        ORDER BY sc.ts DESC, sc.rowid DESC
+        LIMIT 1`)
+        .get({ sid });
+    if (!row?.concept)
+        return 0;
+    // Stamp BEFORE emitting. If anything below fails the worst case is a missed
+    // question; stamping after would let a crash between the two re-fire on the very
+    // next tool call, which is the burst this file exists to prevent.
+    db.prepare(`INSERT INTO checkpoints (session_id, last_checkpoint_at, count)
+     VALUES (@sid, strftime('%Y-%m-%dT%H:%M:%fZ','now'), 1)
+     ON CONFLICT(session_id) DO UPDATE SET
+       last_checkpoint_at = excluded.last_checkpoint_at,
+       count              = checkpoints.count + 1`).run({ sid });
+    const remaining = max_questions_per_task - stats.spent;
+    const framing = framingFor(focus, focus_topic, 'checkpoint');
+    const context = `[Eklavya checkpoint] You just logged a concept. Before writing another line, ask the developer ONE question about it -- this is the whole point of the tool: they learn while you work, not in a pile at the end.
+
+Concept: ${row.concept}
+
+Do exactly this, then get straight back to the task:
+  1. get_session_quiz_plan with max: 1 and ignore_cooldown: true (the pacing is already decided -- this hook is the cooldown).
+  2. Ask that ONE question with AskUserQuestion: four options, one correct, three plausible, and put the correct one in the slot answer_position names. Header "Eklavya", so it is clear who is asking.
+     End the question text with a blank line and then the plan item's ask_footer, verbatim -- it is the only thing on screen naming the mode, focus, level and tier that chose this question. Show it whenever the plan carries one.
+  3. Grade it with record_attempt: format "mcq", the labels in "options", the stem alone in "question".
+  4. Resume the task exactly where you left off. Do not summarise, do not re-plan, do not ask a second question.
+
+ONE question. Not two, not the whole plan. ${remaining} left in this session's budget, and the Stop hook spends whatever you do not.
+${framing}
+If they pick Other or say skip, record it as grade 0, teach the answer in two lines, and carry on. Do not ask again.`;
+    // exit 0 + JSON, not exit 2 + stderr. The Stop hook uses exit 2 because it has
+    // to *prevent* something; this hook has nothing to prevent, and exit 2 renders
+    // to the developer as a hook warning -- an error face on a feature that is
+    // working. So: additionalContext carries the instruction to the model,
+    // systemMessage tells the human why their agent just stopped to ask them
+    // something.
+    process.stdout.write(`${JSON.stringify({
+        hookSpecificOutput: {
+            hookEventName: 'PostToolUse',
+            additionalContext: context,
+            systemMessage: 'Eklavya: quick question on what you just built',
+        },
+    })}\n`);
+    return 0;
+});
+//# sourceMappingURL=checkpoint-quiz.js.map

package/dist/hooks/checkpoint-quiz.js.map

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

package/dist/hooks/lib.js

@@ -0,0 +1,177 @@
+/**
+ * Shared helpers for the Eklavya hooks.
+ *
+ * These used to be `hooks/lib.sh`, and the port was not cosmetic. Hook commands
+ * run through `sh -c` on macOS and Linux but through Git Bash — or PowerShell,
+ * or WSL's bash, depending on what is installed — on Windows, where `.sh` hooks
+ * are a documented minefield (claude-code#18610, #21847, #23556, #73971). The
+ * hooks reference names the way out: `node` plus a script path is the one form
+ * that works everywhere, because `node.exe` is a real executable.
+ *
+ * Porting also deletes the dependency list. The shell version needed `jq`,
+ * the `sqlite3` CLI and a POSIX shell on PATH before it could do anything;
+ * this version needs the Node that Eklavya already requires.
+ *
+ * The hard rule survives the port unchanged (PRD §9.1): a hook must never break
+ * a session. `run()` is the only entry point, and it swallows everything.
+ */
+import fs from 'node:fs';
+import Database from 'better-sqlite3';
+import { dbPath } from '../paths.js';
+import { loadConfig } from '../config.js';
+/**
+ * Reads stdin to EOF. Hooks are always given JSON, but "always" is doing a lot
+ * of work on a critical path — a hook invoked by hand, or by a harness version
+ * that changes its mind, gets an empty object rather than an exception.
+ */
+async function readStdin() {
+    if (process.stdin.isTTY)
+        return '';
+    const chunks = [];
+    for await (const chunk of process.stdin)
+        chunks.push(chunk);
+    return Buffer.concat(chunks).toString('utf8');
+}
+export async function readInput() {
+    try {
+        const raw = await readStdin();
+        if (!raw.trim())
+            return {};
+        const parsed = JSON.parse(raw);
+        return typeof parsed === 'object' && parsed !== null ? parsed : {};
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Opens the knowledge DB read-write, WITHOUT migrating or seeding it.
+ *
+ * `openDb()` is the server's entry point and does both, which is right for a
+ * server and wrong here: a hook is not the thing that should be migrating a
+ * schema, and four hooks racing a migration on session start is a corruption
+ * story rather than a feature. A hook that finds no database has nothing to say,
+ * which is the same answer `eklavya_have_deps` gave.
+ */
+export function openExisting() {
+    const file = dbPath();
+    if (!fs.existsSync(file))
+        return null;
+    try {
+        const db = new Database(file);
+        db.pragma('busy_timeout = 2000');
+        db.pragma('foreign_keys = ON');
+        return db;
+    }
+    catch {
+        return null;
+    }
+}
+export function config(cwd) {
+    return loadConfig(cwd);
+}
+/** The cwd the hook should reason about: what the harness said, else ours. */
+export function cwdOf(input) {
+    return input.cwd && input.cwd.length > 0 ? input.cwd : process.cwd();
+}
+/**
+ * The session id every hook and MCP tool must agree on.
+ *
+ * `EKLAVYA_SESSION_ID` wins when set, so two panes sharing one task (see
+ * docs/parallel-tutoring.md) agree on an id even though Claude Code gives each
+ * pane its own. Unset in normal use, where the harness id is authoritative. The
+ * `meta` fallback is for hooks the harness did not hand an id to.
+ */
+export function sessionId(input, db) {
+    const fromEnv = process.env.EKLAVYA_SESSION_ID;
+    if (fromEnv)
+        return fromEnv;
+    if (input.session_id)
+        return input.session_id;
+    if (!db)
+        return null;
+    try {
+        const row = db.prepare("SELECT value FROM meta WHERE key = 'current_session'").get();
+        return row?.value ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Minutes since a timestamp, or a number large enough to never gate. */
+export const NEVER = 999_999;
+/**
+ * Minutes since a timestamp written by SQLite.
+ *
+ * This schema stores two shapes, and the difference is a trap. `strftime(...Z)`
+ * is explicitly UTC, but `datetime('now')` — the default on `session_concepts.ts`
+ * and `attempts.ts` — produces "2026-09-05 18:04:09": UTC, with nothing saying
+ * so. `Date.parse` reads that as LOCAL time, so every cooldown came out wrong by
+ * the machine's UTC offset, and west of UTC the elapsed time was negative and no
+ * cooldown ever passed. The shell version never had this bug because `julianday`
+ * assumes UTC for exactly this format.
+ *
+ * So: normalise to UTC before parsing, and never return a negative — a clock
+ * that has moved backwards should read as "just now", not as "never".
+ */
+export function minutesSince(ts) {
+    if (!ts)
+        return NEVER;
+    const hasZone = /(?:Z|[+-]\d{2}:?\d{2})$/.test(ts);
+    const normalised = hasZone ? ts : `${ts.replace(' ', 'T')}Z`;
+    const then = Date.parse(normalised);
+    if (Number.isNaN(then))
+        return NEVER;
+    return Math.max(0, Math.floor((Date.now() - then) / 60_000));
+}
+/** The timestamp format every table in this schema stores. */
+export function nowIso() {
+    return new Date().toISOString().replace(/(\.\d{3})Z$/, '$1Z');
+}
+/**
+ * The focus framing, stated by the hooks rather than left to the tutor skill.
+ *
+ * The skill is model-invoked: it competes with every other skill on the machine
+ * and may never load. Without this line an ambient session teaches whatever the
+ * default is rather than what the developer configured.
+ */
+export function framingFor(focus, topic, where) {
+    if (focus === 'concept') {
+        return where === 'checkpoint'
+            ? "Focus is 'concept': open from the code you just wrote, then ask for the general rule -- the answer must be usable on a different codebase."
+            : "Focus is 'concept': ask the transferable version. Open from the code just written, then ask for the general rule or the class of problem — the answer must be usable on a different codebase.";
+    }
+    if (focus === 'learn') {
+        if (!topic) {
+            return where === 'checkpoint'
+                ? "Focus is 'learn' but no focus_topic is set. Skip the question and say so."
+                : "Focus is 'learn' but no focus_topic is set. Ask what they want to learn and set it before quizzing.";
+        }
+        return where === 'checkpoint'
+            ? `Focus is 'learn' on "${topic}": ask the next thing in that topic. Use the code you just wrote as the worked example only where it genuinely overlaps.`
+            : `Focus is 'learn' on "${topic}": teach that topic in prerequisite order. Where the plan marks bridge_context, this session's code is your worked example; otherwise teach it on its own terms.`;
+    }
+    return where === 'checkpoint'
+        ? "Focus is 'project': ground the question in the code you just wrote -- the file, the line, the decision."
+        : "Focus is 'project': ground every question in the diff just written — the file, the line, the decision.";
+}
+/**
+ * Runs a hook body and guarantees the session survives it.
+ *
+ * Every failure path exits 0 with no output — a missed question is nothing, a
+ * hook that errors on every tool call is a plugin nobody keeps. The one
+ * deliberate exception is the Stop hook, which blocks with exit 2 by returning
+ * an explicit code; anything thrown still lands here and still exits 0.
+ */
+export async function run(body) {
+    let code = 0;
+    try {
+        const input = await readInput();
+        code = (await body(input)) ?? 0;
+    }
+    catch {
+        code = 0;
+    }
+    process.exit(code);
+}
+//# sourceMappingURL=lib.js.map

package/dist/hooks/lib.js.map

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

package/dist/hooks/pre-tool-gate.js

@@ -0,0 +1,53 @@
+/**
+ * PreToolUse(Bash): hold commits until the session quiz is passed.
+ *
+ * This runs on EVERY Bash call, so the first thing it does is decide the command
+ * is none of its business and get out of the way.
+ */
+import { run, openExisting, config, cwdOf, sessionId } from './lib.js';
+/**
+ * `git commit` only counts at a command position: after the start of the line or
+ * a shell separator. This is what keeps `echo "git commit"` from being blocked,
+ * while `npm test && git commit -m x` is still caught. The option group allows a
+ * value after a flag, so `git -C . commit` and `git -c user.name=x commit` are
+ * caught alongside plain `git commit`.
+ */
+const COMMIT = /(^|[;&|])\s*(sudo\s+)?git(\s+-\S+(\s+[^-\s]\S*)?)*\s+commit(\s|$)/;
+await run(async (input) => {
+    // Fast path: no string match, no work. PreToolUse fires on every Bash call.
+    const command = input.tool_input?.command;
+    if (!command || !command.includes('commit'))
+        return 0;
+    if (!COMMIT.test(command))
+        return 0;
+    const cwd = cwdOf(input);
+    if (config(cwd).config.mode !== 'enforced')
+        return 0;
+    const db = openExisting();
+    if (!db)
+        return 0;
+    const sid = sessionId(input, db);
+    if (!sid)
+        return 0;
+    const gate = db
+        .prepare('SELECT passed, required, answered FROM gates WHERE session_id = ?')
+        .get(sid);
+    // No gate row means nothing was taught this session, so there is nothing to
+    // prove. Blocking here would be unpassable, not strict.
+    if (!gate)
+        return 0;
+    if (gate.passed === 1)
+        return 0;
+    const reason = `Eklavya gate: this session's quiz has not been passed yet (${gate.answered} of ${gate.required} concepts answered). ` +
+        'Run the quiz first — get_session_quiz_plan, ask one question at a time, grade each answer with record_attempt — ' +
+        'then retry the commit. Nothing else is blocked.';
+    process.stdout.write(`${JSON.stringify({
+        hookSpecificOutput: {
+            hookEventName: 'PreToolUse',
+            permissionDecision: 'deny',
+            permissionDecisionReason: reason,
+        },
+    })}\n`);
+    return 0;
+});
+//# sourceMappingURL=pre-tool-gate.js.map

package/dist/hooks/pre-tool-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pre-tool-gate.js","sourceRoot":"","sources":["../../src/hooks/pre-tool-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAEvE;;;;;;GAMG;AACH,MAAM,MAAM,GAAG,mEAAmE,CAAC;AAEnF,MAAM,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;IACxB,4EAA4E;IAC5E,MAAM,OAAO,GAAG,KAAK,CAAC,UAAU,EAAE,OAAO,CAAC;IAC1C,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,CAAC,CAAC;IACtD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,CAAC,CAAC;IAEpC,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACzB,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,CAAC,CAAC;IAErD,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAC1B,IAAI,CAAC,EAAE;QAAE,OAAO,CAAC,CAAC;IAElB,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG;QAAE,OAAO,CAAC,CAAC;IAEnB,MAAM,IAAI,GAAG,EAAE;SACZ,OAAO,CAAC,mEAAmE,CAAC;SAC5E,GAAG,CAAC,GAAG,CAAuE,CAAC;IAElF,4EAA4E;IAC5E,wDAAwD;IACxD,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEhC,MAAM,MAAM,GACV,8DAA8D,IAAI,CAAC,QAAQ,OAAO,IAAI,CAAC,QAAQ,uBAAuB;QACtH,kHAAkH;QAClH,iDAAiD,CAAC;IAEpD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CAAC;QAChB,kBAAkB,EAAE;YAClB,aAAa,EAAE,YAAY;YAC3B,kBAAkB,EAAE,MAAM;YAC1B,wBAAwB,EAAE,MAAM;SACjC;KACF,CAAC,IAAI,CACP,CAAC;IACF,OAAO,CAAC,CAAC;AACX,CAAC,CAAC,CAAC"}