eklavya 1.51.0 → 1.52.0

package/dist/migrations/025_panel_questions.sql

@@ -0,0 +1,43 @@
+-- Pending questions for the quiz side panel.
+--
+-- With the panel the model no longer asks and grades in one blocked turn: it
+-- hands the question to `present_question` and goes back to work, and a Claude
+-- Code mod (which has no database and loses its state on reload) shows it. So
+-- the question, its answer key and the once-only guard need a transactional
+-- home next to `attempts`.
+--
+-- `key` is the model's grading of each option ({correct_id, grades}). It is
+-- never sent to the mod: the server grades from it.
+--
+-- `attempt_id` is set in the same transaction as the attempt row, and `result`
+-- is the exact reply the pane was given, so a retried answer returns it
+-- verbatim and writes nothing.
+--
+-- `phase`: pending (waiting), unplaced (the host could not seat the pane),
+-- grading (reserved for a typed answer graded later), answered, skipped,
+-- expired (24 hours unanswered; an unanswered question is not a decline).
+CREATE TABLE IF NOT EXISTS panel_questions (
+  id          TEXT PRIMARY KEY,
+  session_id  TEXT NOT NULL,
+  repo        TEXT NOT NULL,
+  concept_id  INTEGER NOT NULL REFERENCES concepts(id),
+  tier        INTEGER NOT NULL,
+  stem        TEXT NOT NULL,
+  options     TEXT NOT NULL,
+  key         TEXT NOT NULL,
+  explanation TEXT NOT NULL,
+  -- 1 when the model has more questions queued in this round (an explicit
+  -- /eklavya:quiz): the pane offers "Next question" only then.
+  more        INTEGER NOT NULL DEFAULT 0,
+  phase       TEXT NOT NULL DEFAULT 'pending'
+              CHECK (phase IN ('pending','unplaced','grading','answered','skipped','expired')),
+  attempt_id  INTEGER REFERENCES attempts(id),
+  result      TEXT,
+  created_at  TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at  TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- At most one open question per session, enforced where two callers cannot
+-- get around it.
+CREATE UNIQUE INDEX IF NOT EXISTS idx_panel_questions_open
+  ON panel_questions(session_id) WHERE phase IN ('pending','unplaced','grading');

package/dist/panel-state.js

@@ -0,0 +1,117 @@
+import { isCowork } from './surface.js';
+/**
+ * What the hooks and the planner need to know about the side panel, and nothing
+ * else: whether this session's host showed up recently, and whether a question
+ * is already waiting. Kept apart from `panel.ts` so a hook can read it without
+ * loading the recorder (zod, the grading code) behind `panelAnswer`.
+ *
+ * The panel is a Claude Code mod, and a mod being installed proves nothing. The
+ * mod says it is alive by calling `panel_sync` on lifecycle events, which stamps
+ * a heartbeat here. A question is presented in the panel only when the setting
+ * is on and that heartbeat is fresh; any doubt keeps today's question card.
+ */
+/** How long after its last `panel_sync` a mod still counts as present. */
+export const PANEL_HEARTBEAT_TTL_MS = 90_000;
+/**
+ * Host surfaces that have been seen to take an answer. Verified on the terminal
+ * only (docs/verified-schemas.md, Stage 0); the Desktop Code tab is added here
+ * when it has been tried, not before.
+ */
+export const PANEL_SURFACES = ['terminal'];
+/** The phases in which a question is still waiting for its answer. */
+export const OPEN_PHASES = "('pending','unplaced','grading')";
+/** An unanswered question stops being open after this long (`panel.ts` expires it). */
+export const PANEL_EXPIRY_HOURS = 24;
+const heartbeatKey = (sessionId) => `panel_hb:${sessionId}`;
+/**
+ * Stamps the heartbeat for a session. `placed` is the mod's latest word on
+ * whether the host could seat the pane; a sync that carries none keeps the last.
+ */
+export function recordHeartbeat(db, sessionId, host, placed, now = new Date()) {
+    const before = readHeartbeat(db, sessionId);
+    const beat = { at: now.toISOString(), surface: host.surface, placed: placed ?? before?.placed ?? true };
+    db.prepare(`INSERT INTO meta (key, value) VALUES (?, ?)
+     ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(heartbeatKey(sessionId), JSON.stringify(beat));
+    // A session's heartbeat means nothing a day later; drop the stale ones as they
+    // are written rather than let one row per session pile up.
+    db.prepare("DELETE FROM meta WHERE key LIKE 'panel_hb:%' AND json_extract(value, '$.at') < ?").run(new Date(now.getTime() - PANEL_EXPIRY_HOURS * 3600_000).toISOString());
+}
+function readHeartbeat(db, sessionId) {
+    const row = db.prepare('SELECT value FROM meta WHERE key = ?').get(heartbeatKey(sessionId));
+    return row ? JSON.parse(row.value) : null;
+}
+/**
+ * Where this session's next question goes. `panel` only when the setting is on,
+ * the host reported in within `PANEL_HEARTBEAT_TTL_MS` from a surface known to
+ * work, and its last placement did not fail. Everything else, including Cowork and a
+ * database that predates the panel, is the question card.
+ */
+export function panelPresentation(db, config, sessionId, now = new Date()) {
+    if (!config.quiz.panel || isCowork())
+        return 'tool';
+    try {
+        const beat = readHeartbeat(db, sessionId);
+        if (!beat || !beat.placed || !PANEL_SURFACES.includes(beat.surface))
+            return 'tool';
+        return now.getTime() - Date.parse(beat.at) <= PANEL_HEARTBEAT_TTL_MS ? 'panel' : 'tool';
+    }
+    catch {
+        return 'tool';
+    }
+}
+/**
+ * Is a panel question already waiting for this session? The hooks go quiet when
+ * one is: it is the outstanding question. Read-only, and false for a database
+ * that has no `panel_questions` yet (a hook never migrates).
+ */
+export function hasOpenPanelQuestion(db, sessionId) {
+    try {
+        return (db
+            .prepare(`SELECT 1 FROM panel_questions
+            WHERE session_id = ? AND phase IN ${OPEN_PHASES} AND created_at >= datetime('now', ?) LIMIT 1`)
+            .get(sessionId, `-${PANEL_EXPIRY_HOURS} hours`) !== undefined);
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * The explicit round a learner asked for (a topic quiz, `max` questions): the
+ * slugs still to ask, in order. The planner saves it when it plans a round for
+ * the panel, `present_question` takes each question off it, and Next resumes it,
+ * so the round keeps its topic and its length across the questions and the last
+ * one is known to be last. Stored in `meta`, so it needs no migration.
+ */
+const roundKey = (sessionId) => `panel_round:${sessionId}`;
+export function saveRound(db, sessionId, queue, now = new Date()) {
+    db.prepare(`INSERT INTO meta (key, value) VALUES (?, ?)
+     ON CONFLICT(key) DO UPDATE SET value = excluded.value`).run(roundKey(sessionId), JSON.stringify({ at: now.toISOString(), queue }));
+}
+export function clearRound(db, sessionId) {
+    db.prepare('DELETE FROM meta WHERE key = ?').run(roundKey(sessionId));
+}
+/** The slugs still to ask, or null when no round is running (or it is a day old). */
+export function loadRound(db, sessionId, now = new Date()) {
+    const row = db.prepare('SELECT value FROM meta WHERE key = ?').get(roundKey(sessionId));
+    if (!row)
+        return null;
+    const round = JSON.parse(row.value);
+    return now.getTime() - Date.parse(round.at) <= PANEL_EXPIRY_HOURS * 3600_000 ? round.queue : null;
+}
+/**
+ * Takes `slug` off the round as it is presented. Returns whether more remain,
+ * or null when `slug` is not part of a running round (the caller's own `more`
+ * then stands).
+ */
+export function advanceRound(db, sessionId, slug) {
+    const queue = loadRound(db, sessionId);
+    if (!queue || !queue.includes(slug))
+        return null;
+    const rest = queue.filter((s) => s !== slug);
+    if (rest.length > 0)
+        saveRound(db, sessionId, rest);
+    else
+        clearRound(db, sessionId);
+    return rest.length > 0;
+}
+//# sourceMappingURL=panel-state.js.map

package/dist/panel-state.js.map

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

package/dist/panel.js

@@ -0,0 +1,241 @@
+import { randomUUID } from 'node:crypto';
+import { loadConfig } from './config.js';
+import { answerPosition, MCQ_OPTION_COUNT } from './mcq.js';
+import { normalizeSlug } from './slug.js';
+import { resolveSessionId } from './session.js';
+import { stripAskHeader } from './ask.js';
+import { conceptBySlug, hasAskedQuestion, projectKey, recentQuestions, ASKED_HISTORY, PASSING_GRADE } from './store.js';
+import { recordAttemptCore } from './tools/record_attempt.js';
+import { OPEN_PHASES, PANEL_EXPIRY_HOURS, advanceRound, panelPresentation, recordHeartbeat } from './panel-state.js';
+/** Open rows past their expiry become `expired`. Called first by every entry point. */
+function expireStale(db) {
+    db.prepare(`UPDATE panel_questions SET phase = 'expired', updated_at = datetime('now')
+      WHERE phase IN ${OPEN_PHASES} AND created_at < datetime('now', ?)`).run(`-${PANEL_EXPIRY_HOURS} hours`);
+}
+function openRow(db, sessionId, repo) {
+    return db
+        .prepare(`SELECT * FROM panel_questions WHERE session_id = ? AND repo = ? AND phase IN ${OPEN_PHASES}`)
+        .get(sessionId, repo);
+}
+/**
+ * Stores a question the model has written and returns immediately. Placement of
+ * the right option is enforced here, not trusted: the planner computes it, and a
+ * model that ignores it would put the answer in the same slot every time.
+ */
+export function presentQuestion(db, args) {
+    const { config, repoRoot } = loadConfig(args.cwd);
+    const sessionId = resolveSessionId(db, args.session_id, args.cwd);
+    const repo = projectKey(repoRoot);
+    // Off is inert.
+    if (!config.quiz.panel) {
+        return { error: 'panel_disabled', detail: 'The side panel is off. Ask with AskUserQuestion, as the plan says.' };
+    }
+    expireStale(db);
+    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 open = openRow(db, sessionId, repo);
+    if (open) {
+        return {
+            error: 'question_open',
+            question_id: open.id,
+            detail: 'A question is already waiting in the panel for this session. Do not present another; carry on with the task.',
+        };
+    }
+    // A mod that is not reporting in is no place to leave a question: it would sit
+    // unseen and block this session's next one for a day. The learner gets the
+    // question card instead, which is what `presentation` in the plan said. After
+    // the open-row check, so a question already waiting is named as such.
+    if (panelPresentation(db, config, sessionId) !== 'panel') {
+        return { error: 'panel_unavailable', detail: 'No side panel is showing questions in this session. Ask with AskUserQuestion instead.' };
+    }
+    const labels = args.options.map((o) => o.label.trim().toLowerCase());
+    // A letter or a number is a marker, not an option: the pane draws its own
+    // numbering, and the text the learner must read belongs in the label.
+    const markers = args.options.some((o) => /^\(?[a-z0-9][.):]?$/i.test(o.label.trim()));
+    const correctAt = args.options.flatMap((o, i) => (o.correct ? [i] : []));
+    const badGrade = args.options.some((o) => (o.correct ? o.grade !== 4 : o.grade !== 1 && o.grade !== 2));
+    if (args.options.length !== MCQ_OPTION_COUNT ||
+        new Set(labels).size !== labels.length ||
+        markers ||
+        correctAt.length !== 1 ||
+        badGrade) {
+        return {
+            error: 'invalid_options',
+            detail: `Give exactly ${MCQ_OPTION_COUNT} options with different labels, each label the option's own words (a complete claim, never a letter or number), exactly one with correct: true and grade 4; every other option grade 2 (right shape, wrong in the way that matters) or 1 (built on a misconception). Nothing was stored.`,
+        };
+    }
+    const expected = answerPosition(concept.slug, recentQuestions(db, concept.id, ASKED_HISTORY).length);
+    if (correctAt[0] + 1 !== expected) {
+        return {
+            error: 'wrong_answer_position',
+            expected,
+            detail: `Put the correct option in slot ${expected} (1-${MCQ_OPTION_COUNT}), as the plan's answer_position says. Nothing was stored.`,
+        };
+    }
+    const stem = stripAskHeader(args.question);
+    const repeat = hasAskedQuestion(db, concept.id, stem);
+    const options = args.options.map((o, i) => ({ id: `o${i + 1}`, label: o.label, note: o.description }));
+    const key = {
+        correct_id: `o${correctAt[0] + 1}`,
+        grades: Object.fromEntries(args.options.map((o, i) => [`o${i + 1}`, o.grade])),
+    };
+    // In a round the queue says whether this is the last question; the model's own
+    // `more` only stands for a question outside one.
+    const more = advanceRound(db, sessionId, concept.slug) ?? Boolean(args.more);
+    const id = randomUUID();
+    db.prepare(`INSERT INTO panel_questions (id, session_id, repo, concept_id, tier, stem, options, key, explanation, more)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(id, sessionId, repo, concept.id, args.difficulty, stem, JSON.stringify(options), JSON.stringify(key), args.explanation, more ? 1 : 0);
+    return {
+        question_id: id,
+        status: 'presented',
+        ...(repeat ? { repeat_question: true } : {}),
+        next: 'The panel shows it and records the answer. Do not wait, do not ask anything else, and do not call record_attempt; carry on with the task.',
+    };
+}
+/**
+ * What the mod asks on every lifecycle event: is a question waiting here? The
+ * reply never carries the key, the grades or the explanation, so nothing the
+ * mod holds can reveal the answer before it is given.
+ */
+export function panelSync(db, args) {
+    const { config, repoRoot } = loadConfig(args.cwd);
+    const repo = projectKey(repoRoot);
+    // Off is inert: no heartbeat, nothing for the mod to show. A question still
+    // open here is superseded by the card the session falls back to, so it is
+    // expired (no attempt written) and turning the panel back on cannot revive it.
+    if (!config.quiz.panel) {
+        db.prepare(`UPDATE panel_questions SET phase = 'expired', updated_at = datetime('now')
+        WHERE session_id = ? AND repo = ? AND phase IN ${OPEN_PHASES}`).run(args.session_id, repo);
+        return { disabled: true };
+    }
+    expireStale(db);
+    recordHeartbeat(db, args.session_id, args.host, args.placed?.ok);
+    const row = openRow(db, args.session_id, repo);
+    if (!row)
+        return { none: true };
+    // Answered by another route while the panel was off (the sync that would have
+    // expired it never ran): the card's attempt supersedes it.
+    const superseded = db
+        .prepare('SELECT 1 FROM attempts WHERE session_id = ? AND concept_id = ? AND ts > ? LIMIT 1')
+        .get(row.session_id, row.concept_id, row.created_at);
+    if (superseded) {
+        db.prepare("UPDATE panel_questions SET phase = 'expired', updated_at = datetime('now') WHERE id = ?").run(row.id);
+        return { none: true };
+    }
+    // The mod reports whether the host could seat the pane. An invisible question
+    // is never counted as shown: it waits as `unplaced` until a later open works.
+    const placed = args.placed;
+    let phase = row.phase;
+    if (placed && placed.question_id === row.id) {
+        const next = placed.ok ? (phase === 'unplaced' ? 'pending' : phase) : phase === 'pending' ? 'unplaced' : phase;
+        if (next !== phase) {
+            db.prepare("UPDATE panel_questions SET phase = ?, updated_at = datetime('now') WHERE id = ?").run(next, row.id);
+            phase = next;
+        }
+    }
+    const concept = db.prepare('SELECT name FROM concepts WHERE id = ?').get(row.concept_id);
+    return {
+        question_id: row.id,
+        repo: row.repo,
+        stem: row.stem,
+        options: JSON.parse(row.options),
+        phase,
+        concept_name: concept.name,
+        tier: row.tier,
+        more: row.more === 1,
+    };
+}
+/**
+ * Grades and records one answer, exactly once. A second call for the same
+ * question returns the stored reply and writes nothing.
+ */
+export function panelAnswer(db, args) {
+    return db.transaction(() => {
+        expireStale(db);
+        const row = db.prepare('SELECT * FROM panel_questions WHERE id = ?').get(args.question_id);
+        if (!row)
+            return { error: 'unknown_question' };
+        // Another session, another project, or a question that timed out.
+        if (row.session_id !== args.session_id ||
+            row.repo !== args.repo ||
+            projectKey(loadConfig(args.cwd).repoRoot) !== row.repo ||
+            row.phase === 'expired') {
+            return { error: 'stale_question' };
+        }
+        if (row.result)
+            return JSON.parse(row.result);
+        const options = JSON.parse(row.options);
+        const key = JSON.parse(row.key);
+        const picked = options.find((o) => o.id === args.option_id);
+        const typed = (args.text ?? '').trim();
+        const correctLabel = options.find((o) => o.id === key.correct_id).label;
+        // Typed words with no verdict yet: the first half of a typed answer. The
+        // panel's grader needs the right option to judge against, so it is handed
+        // over now, once the learner has committed to words, and never before.
+        // The question is `grading` meanwhile: still open, so nothing else is asked,
+        // and a Retry after an interrupted grading simply asks again.
+        if (args.kind === 'text' && args.grade === undefined && args.outcome === undefined) {
+            if (!typed)
+                return { error: 'invalid_answer', detail: 'Nothing was recorded.' };
+            if (row.phase !== 'grading') {
+                db.prepare("UPDATE panel_questions SET phase = 'grading', updated_at = datetime('now') WHERE id = ?").run(row.id);
+            }
+            return { phase: 'grading', correct_label: correctLabel };
+        }
+        if ((args.kind === 'choice' && !picked) ||
+            (args.kind === 'text' &&
+                (!typed || !Number.isInteger(args.grade) || args.grade < 0 || args.grade > 5 ||
+                    (args.outcome !== 'answered' && args.outcome !== 'dont_know') ||
+                    (args.outcome === 'dont_know' && args.grade !== 0)))) {
+            return { error: 'invalid_answer', detail: 'Nothing was recorded.' };
+        }
+        // The table the handoff fixes: a pick takes the grade the model wrote beside
+        // it, typed words take the grader's, a skip is a decline.
+        const grade = args.kind === 'choice' ? key.grades[picked.id] : args.kind === 'text' ? args.grade : 0;
+        const concept = db.prepare('SELECT slug FROM concepts WHERE id = ?').get(row.concept_id);
+        const recorded = recordAttemptCore(db, {
+            session_id: row.session_id,
+            cwd: args.cwd,
+            slug: concept.slug,
+            question: row.stem,
+            answer: args.kind === 'choice' ? picked.label : args.kind === 'text' ? typed : undefined,
+            grade,
+            difficulty: row.tier,
+            feedback: args.kind === 'choice' ? row.explanation : args.kind === 'text' ? args.feedback : undefined,
+            outcome: args.kind === 'skip' ? 'declined' : args.kind === 'text' ? args.outcome : 'answered',
+            // Free recall carries no format, so it is not capped at 4.
+            format: args.kind === 'text' ? undefined : 'mcq',
+            options: options.map((o) => o.label),
+            correct: correctLabel,
+            option_notes: options.map((o) => o.note),
+        });
+        if ('error' in recorded)
+            return recorded;
+        const phase = args.kind === 'skip' ? 'skipped' : 'answered';
+        const isRight = args.kind === 'choice' ? picked.id === key.correct_id : args.outcome === 'answered' && grade >= PASSING_GRADE;
+        const result = {
+            phase,
+            attempt_id: recorded.attempt_id,
+            ...(args.kind === 'skip'
+                ? {}
+                : {
+                    correct: isRight,
+                    ...(isRight ? {} : { correct_label: correctLabel }),
+                    explanation: args.kind === 'text' && args.feedback ? args.feedback : row.explanation,
+                }),
+            ...(recorded.level_up ? { level_up: { from: recorded.level_up.from, to: recorded.level_up.to } } : {}),
+            ...(recorded.explain ? { explain: recorded.explain } : {}),
+        };
+        // Same transaction as the attempt: both land or neither does.
+        db.prepare("UPDATE panel_questions SET phase = ?, attempt_id = ?, result = ?, updated_at = datetime('now') WHERE id = ?").run(phase, result.attempt_id, JSON.stringify(result), row.id);
+        return result;
+    }).immediate();
+}
+//# sourceMappingURL=panel.js.map

package/dist/panel.js.map

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

package/dist/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "eklavya",
   "displayName": "Eklavya",
-  "version": "1.51.0",
+  "version": "1.52.0",
   "description": "Learn while your agent works. Turns coding-agent generation time into adaptive, Socratic learning grounded in the code being written.",
   "author": {
     "name": "Ajay Kumar"
@@ -13,5 +13,6 @@
     "tutor",
     "knowledge-graph",
     "mentorship"
-  ]
+  ],
+  "types": "./hooks/panel/types/index.d.ts"
 }

package/dist/plugin/agents/tutor.md

@@ -42,7 +42,9 @@ Reply with a letter, or "teach me" if you'd rather I explain it.
 
 The plan's `ask_attribution` names a `header` field you do not have. Take the
 rest of it and put `[Eklavya]` on its own line above the stem — always, on
-every host. The chip it describes is what the main session gets instead, and
+every host. If the plan says `presentation: "panel"` it has no `ask_attribution`
+and you have no `present_question` either: ignore it, ask in lettered text as
+here, and `record_attempt` as usual. The chip it describes is what the main session gets instead, and
 without it your question arrives in the transcript unsigned.
 
 The answer is at C there because the plan said `answer_position: 3`, and

package/dist/plugin/hooks/CLAUDE.md

@@ -27,6 +27,24 @@ The MCP matcher accepts both standalone and plugin-scoped names. Do not narrow
 it to one prefix. Keep the work-tool regex anchored. Hook timeouts are 10 seconds,
 except Stop at 15 seconds; consult the manifest before changing them.
 
+## The quiz panel is a mod, not a command hook
+
+`hooks/panel/` is a Claude Code mod: function hooks declared under `modules` in
+`hooks.json` beside the command hooks, in a runtime with no Node and no
+filesystem. Fail-open applies to it exactly as to a command hook: a handler that
+throws is skipped and the question stays in the database (`panel_questions`) for
+the next sync. The rules it is validated against: static relative imports only,
+every `$` call inline or in a function declared at the top of the file, literal
+event names, render only its own pane, and never hold the answer key (the server
+grades; the mod draws and relays). It is opt-in: with `quiz.panel` off, `panel_sync`
+returns `{disabled: true}` and the mod opens and draws nothing. `presentation` in
+`get_session_quiz_plan` is the one source for which tool asks; the checkpoint,
+the Stop sweep and the delegation lines (`delegation-lib.ts`) read it, and an
+open panel question silences the checkpoint and the Stop sweep. Read
+`docs/verified-schemas.md` (mods section) before changing anything it records.
+Run `scripts/test-panel-mod.sh`: it stages the mod as its own plugin, validates
+it, runs `claude plugin test`, then validates the distributed plugin.
+
 ## Failures and latency
 
 Every hook body runs inside `await run(async (input) => { ... })` and returns 0.

package/dist/plugin/hooks/hooks.json

@@ -6,7 +6,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "session-start"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "session-start"
+            ],
             "timeout": 10,
             "statusMessage": "Eklavya: loading learner profile"
           }
@@ -19,7 +22,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "prompt-submit-nudge"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "prompt-submit-nudge"
+            ],
             "timeout": 10
           }
         ]
@@ -31,7 +37,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "subagent-start"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "subagent-start"
+            ],
             "timeout": 10
           }
         ]
@@ -44,7 +53,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "pre-tool-gate"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "pre-tool-gate"
+            ],
             "timeout": 10
           }
         ]
@@ -55,7 +67,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "file-context"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "file-context"
+            ],
             "timeout": 10
           }
         ]
@@ -67,7 +82,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "capture-tool"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "capture-tool"
+            ],
             "timeout": 10
           }
         ]
@@ -78,7 +96,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "checkpoint-quiz"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "checkpoint-quiz"
+            ],
             "timeout": 10,
             "statusMessage": "Eklavya: checking if it is time to ask"
           }
@@ -90,7 +111,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "checkpoint-quiz"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "checkpoint-quiz"
+            ],
             "timeout": 10
           }
         ]
@@ -101,7 +125,10 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "delegate-nudge"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "delegate-nudge"
+            ],
             "timeout": 10
           }
         ]
@@ -113,12 +140,18 @@
           {
             "type": "command",
             "command": "node",
-            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "stop-quiz-check"],
+            "args": [
+              "${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs",
+              "stop-quiz-check"
+            ],
             "timeout": 15,
             "statusMessage": "Eklavya: checking what you learned"
           }
         ]
       }
     ]
-  }
+  },
+  "modules": [
+    "./panel/register.tsx"
+  ]
 }