eklavya 1.71.0 → 1.71.2

package/README.md

@@ -52,7 +52,7 @@ Code's learning loop.
 |---|---|
 | Learner state and concepts | `get_learner_profile`, `log_session_concepts`, `upsert_concepts`, `get_concept_graph` |
 | Questions and assessment | `get_session_quiz_plan`, `record_attempt`, `get_gate_status` |
-| Quiz side panel (experimental) | `present_question` for the model; `panel_sync` and `panel_answer`, called only by the panel mod, never by the model |
+| Quiz side panel (experimental) | `present_question` for the model; `panel_sync` and `panel_answer`, called only by the panel mod, never by the model; its header stacks the mark above the topic in a pane under 60 cells wide |
 | Settings | `get_config`, `set_config` |
 | Find and read memory | `memory_search`, `memory_get`, `memory_timeline`, `memory_file_history`, `memory_status` |
 | Maintain memory | `memory_write`, `memory_correct`, `memory_delete`, `memory_collections` |
@@ -83,7 +83,7 @@ level.
 right one, 2 for a near miss, 1 for a misconception), the right one in the
 plan's `answer_position` slot, and an explanation. It stores the question and
 returns at once; it writes no attempt. The panel records the answer through
-`panel_answer` with the same code `record_attempt` uses, exactly once. `kind: "dont_know"` (the panel's **Teach me** button) records `dont_know` with grade 0, replies with the right answer and `taught: true`, and always carries `explain`. On a miss with `explain_on_wrong` on, its reply carries the same `explain` block `record_attempt` returns, and the panel starts the explainer agent from it. `present_question` sends a question back once with `conspicuous_options` (nothing stored) when one option's label plus description outruns the next by a few words or a description explains itself, and presents the same stem as written on the second call. It returns `panel_disabled` while `quiz.panel` is off, and
+`panel_answer` with the same code `record_attempt` uses, exactly once. `kind: "dont_know"` (the panel's **New to me — Teach me** button) records `dont_know` with grade 0, replies with the right answer and `taught: true`, and always carries `explain`. On a miss with `explain_on_wrong` on, its reply carries the same `explain` block `record_attempt` returns, and the panel starts the explainer agent from it. `present_question` sends a question back once with `conspicuous_options` (nothing stored) when one option's label plus description outruns the next by a few words or a description explains itself, and presents the same stem as written on the second call. It returns `panel_disabled` while `quiz.panel` is off, and
 `panel_sync` returns `{disabled: true}` and expires the session's open question without recording an attempt, so turning the panel back on cannot revive it; `panel_answer` answers only a question
 that already exists. A round the learner asked for (a topic, `max`) is remembered per session: `present_question` takes each question off it and sets the last one's `more` false, and `get_session_quiz_plan` with `resume_round: true` plans what is left. This is
 a Claude Code mod feature: a standalone MCP client has the tools but not the

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

@@ -1,7 +1,7 @@
 {
   "name": "eklavya",
   "displayName": "Eklavya",
-  "version": "1.71.0",
+  "version": "1.71.2",
   "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"

package/dist/plugin/hooks/panel/model.ts

@@ -22,6 +22,8 @@ export const TIER: Record<number, string> = { 1: 'recall', 2: 'mechanism', 3: 'j
 export const BRAND = '#79D5C4'
 /** The fill and text of the picked answer: set together so the contrast holds in a light or a dark theme. */
 export const PICKED = { bg: '#1E5A52', text: '#FFFFFF', note: '#C9E8E3' }
+/** Teach me is Claude's orange (the logo's mascot), fill and border. The text is dark, as white on that orange is too faint at body size. */
+export const TEACH = { bg: '#D97757', text: '#1F1E1D' }
 
 /**
  * The logo: the Claude mascot (orange) holding an Eklavya bow and arrow (white), drawn on a
@@ -106,14 +108,14 @@ export function codify(text: string): string {
     .join('')
 }
 
-/** Block Markdown that bold marks around it would break: a fence, heading, list, quote, or bold already in it. */
-const NOT_BOLDABLE = /```|\*\*|^\s*(?:#|[-*+>]|\d+[.)])\s/m
+/** Block Markdown a heading mark would break: a fence, heading, list, quote, or bold already in it. */
+const NOT_HEADING = /```|\*\*|^\s*(?:#|[-*+>]|\d+[.)])\s/m
 
-/** Bolds each plain paragraph of a question, so a blank line never sits inside a bold span. */
-export function boldParagraphs(text: string): string {
+/** Makes each plain paragraph of a question a heading, so the app draws it larger and bold; a heading is one line, so its line breaks become spaces. */
+export function headingParagraphs(text: string): string {
   return text
     .split(/\n{2,}/)
-    .map(p => (p.trim() && !NOT_BOLDABLE.test(p) ? `**${p.trim()}**` : p))
+    .map(p => (p.trim() && !NOT_HEADING.test(p) ? `### ${p.trim().replace(/\s*\n\s*/g, ' ')}` : p))
     .join('\n\n')
 }
 
@@ -132,7 +134,7 @@ export const STR = {
   brand: 'Eklavya',
   submit: 'Submit answer',
   skip: 'Skip question',
-  teach: 'Teach me',
+  teach: 'New to me — Teach me',
   next: 'Next question',
   done: 'Done',
   autoClose: 'Closes by itself in 15 seconds.',
@@ -159,7 +161,6 @@ export const STR = {
   askedOther: 'Eklavya: a note for Claude',
   focus: 'Ctrl+X then Tab moves the keys here.',
   keys: '1–4 pick · o other · s submit · k skip · t teach me · Esc back to prompt',
-  keysApp: '1–4 pick · o other · s submit · k skip · t teach me',
   off: 'The quiz panel is off. Turn it on with: eklavya config set quiz.panel true',
 } as const
 
@@ -202,11 +203,11 @@ export function explainerBrief(x: ExplainBlock): string {
 export const answerWas = (label: string): string => `The answer was: ${label}`
 
 /**
- * The hint lines under the pane. Moving the keys with Ctrl+X then Tab and
- * leaving with Esc are the terminal's; an app draws native buttons, so it gets
- * the answer keys only.
+ * The key hints. Only the terminal gets them: there Ctrl+X then Tab moves the keys into the pane. The
+ * desktop app keeps typing in its prompt even after a click on the pane (seen 2026-10-16), so a mod's
+ * hotkeys never reach it there, and it shows no keys at all.
  */
-export const hintLines = (surface: string): string[] => (surface === 'terminal' ? [STR.focus, STR.keys] : [STR.keysApp])
+export const hintLines = (surface: string): string[] => (surface === 'terminal' ? [STR.focus, STR.keys] : [])
 
 export const unplacedNotice = (): string => `A question is waiting. ${REOPEN} to open it.`
 export const levelLine = (level: string, project: string): string => `You've cleared ${level} on ${project}.`

package/dist/plugin/hooks/panel/register.tsx

@@ -4,6 +4,7 @@ import type { EngineInterface, Register } from 'claude-code'
 import {
   BRAND,
   PICKED,
+  TEACH,
   EMPTY,
   EXPLAINER,
   NEXT_PROMPT,
@@ -18,7 +19,7 @@ import {
   gradingRequest,
   logoRows,
   boxRows,
-  boldParagraphs,
+  headingParagraphs,
   plainLabel,
   levelLine,
   parseVerdict,
@@ -42,6 +43,9 @@ import type { PanelPending, PanelQuestion, PanelState } from './types'
  * for the next sync.
  */
 
+// Below this many cells across, the header stacks the mark over the topic (the pane reports bodyColumns).
+const NARROW = 60
+
 const REF = { plugin: 'eklavya', key: 'quiz' } as const
 const quiz = atom(REF, EMPTY)
 
@@ -364,8 +368,8 @@ export const register: Register = on => {
     const s: PanelState = await read($, quiz)
     const q = s.question
 
-    // Any surface but the terminal is the desktop app's: it sets the question bold, spaces the answers
-    // apart and draws the mark in boxes. The terminal keeps its text layout.
+    // Any surface but the terminal is the desktop app's: it sets the question as a heading, spaces the
+    // answers apart and draws the mark in boxes. The terminal keeps its text layout.
     const app = e.surface !== 'terminal'
     // The mark is drawn in text, as Claude Code draws its own, so it shows in every terminal. The
     // desktop app sets text in a proportional font with its own line height, so glyph cells do not
@@ -396,19 +400,23 @@ export const register: Register = on => {
           ))}
         </Box>
       )
-    // A list tile: the mark on the left; the name over the topic beside it.
+    // A list tile: the mark on the left, the name over the topic beside it. A pane narrower than
+    // NARROW cells stacks them, so the topic gets the full width instead of a sliver.
+    const stacked = ((e.props as { bodyColumns?: number }).bodyColumns ?? Infinity) < NARROW
     const head = (subtitle?: string) => (
-      <Box flexDirection="row" alignItems="center" gap={2}>
+      <Box flexDirection={stacked ? 'column' : 'row'} alignItems={stacked ? 'flex-start' : 'center'} gap={2}>
         {logo}
         <Box flexDirection="column" flexShrink={1}>
           <Text bold color={BRAND}>
             {WORDMARK}
           </Text>
-          {subtitle ? <Text>{subtitle}</Text> : null}
+          {subtitle ? <Text wrap="wrap">{subtitle}</Text> : null}
         </Box>
       </Box>
     )
-    const hint = (
+    // The desktop app never sends the pane its keys (see hintLines), so it gets no hotkeys and no hints.
+    const hk = (k: string) => (app ? undefined : k)
+    const hint = app ? null : (
       <Box flexDirection="column">
         {hintLines(e.surface).map(line => (
           <Text key={line} dimColor>
@@ -418,8 +426,9 @@ export const register: Register = on => {
       </Box>
     )
     // One answer: a bordered block. The Button holds the whole answer text, so a press anywhere on it
-    // selects; the border and a tick show the pick, and nothing implies it is right. The desktop app gives
-    // the text more room inside the border; the terminal keeps its tight cards.
+    // selects; the border and fill show the pick, and nothing implies it is
+    // right. The desktop app gives the text more room inside the border; the padding itself is not
+    // pressable, since a Button takes none. The terminal keeps its tight cards.
     // Other is never filled: the learner types inside it, in the host's own text colour, which a fixed fill could hide.
     const card = (id: string, selected: boolean, button: unknown, body: unknown[], roomy = false) => (
       <Box
@@ -455,17 +464,17 @@ export const register: Register = on => {
       )
     }
 
-    const stem = <Markdown text={app ? boldParagraphs(codify(q.stem)) : codify(q.stem)} />
+    const stem = <Markdown text={app ? headingParagraphs(codify(q.stem)) : codify(q.stem)} />
 
     if (s.step === 'feedback' || s.step === 'skipped') {
       const r = s.result
       if (s.step === 'skipped' || !r) {
-        return frame(<Text>{STR.skipped}</Text>, q.more ? null : <Text dimColor>{STR.autoClose}</Text>, <Button key="done" label={STR.done} variant="primary" hotkey="d" onPress={() => done($)} />)
+        return frame(<Text>{STR.skipped}</Text>, q.more ? null : <Text dimColor>{STR.autoClose}</Text>, <Button key="done" label={STR.done} variant="primary" hotkey={hk('d')} onPress={() => done($)} />)
       }
       const right = r.correct === true
       return frame(
         stem,
-        <Text bold color={right ? 'suggestion' : r.taught ? undefined : 'error'}>
+        <Text bold color={right ? 'suggestion' : r.taught ? BRAND : 'error'}>
           {right ? STR.correct : r.taught ? STR.taught : STR.wrong}
         </Text>,
         right || !r.correct_label ? null : <Text>{answerWas(r.correct_label)}</Text>,
@@ -474,8 +483,8 @@ export const register: Register = on => {
         r.explain ? <Text dimColor>{r.taught ? STR.taughtExplainer : STR.explainer}</Text> : null,
         q.more ? null : <Text dimColor>{STR.autoClose}</Text>,
         <Box flexDirection="row" gap={2}>
-          {q.more ? <Button key="next" label={STR.next} hotkey="n" onPress={() => askNext($)} /> : null}
-          <Button key="done" label={STR.done} variant="primary" hotkey="d" onPress={() => done($)} />
+          {q.more ? <Button key="next" label={STR.next} hotkey={hk('n')} onPress={() => askNext($)} /> : null}
+          <Button key="done" label={STR.done} variant="primary" hotkey={hk('d')} onPress={() => done($)} />
         </Box>,
       )
     }
@@ -485,16 +494,20 @@ export const register: Register = on => {
     const hasDraft = s.draft.other ? s.draft.text.trim().length > 0 : s.draft.picked !== null
     // The answer and its note are the Button's own inline Text, so a press anywhere on them selects.
     // Markdown marks cannot show inside a Button, so the code and bold marks are dropped from both.
+    // The pick shows by the card's border and fill, never a mark in the text, so picking moves nothing.
+    // On the desktop app the note starts where the answer does; the terminal indents it under the `1: `
+    // its plain Button draws.
+    // `wrap` asks the app to wrap a long answer rather than cut it off.
     const answer = (id: string, key: string, hotkey: string, label: string, chosen: boolean, note?: string) => (
       <Button
         key={key}
         plain
-        hotkey={hotkey}
+        hotkey={hk(hotkey)}
         label={label}
         onPress={() => (locked ? undefined : id === 'other' ? chooseOther($) : pick($, id))}
       >
-        <Text bold={chosen} color={chosen && id !== 'other' ? PICKED.text : undefined}>{`${chosen ? '✓ ' : ''}${label}`}</Text>
-        {note ? <Text dimColor={!chosen} color={chosen ? PICKED.note : undefined}>{`\n   ${note}`}</Text> : null}
+        <Text wrap="wrap" bold={chosen} color={chosen && id !== 'other' ? PICKED.text : undefined}>{label}</Text>
+        {note ? <Text wrap="wrap" dimColor={!chosen} color={chosen ? PICKED.note : undefined}>{`\n${app ? '' : '   '}${note}`}</Text> : null}
       </Button>
     )
     const options = q.options.map((o, i) => {
@@ -509,7 +522,7 @@ export const register: Register = on => {
 
     return frame(
       stem,
-      <Box flexDirection="column" gap={app ? 2 : 0}>
+      <Box flexDirection="column" gap={app ? 2 : 0} marginTop={app ? 1 : 0}>
         {options}
         {card(
           'other',
@@ -538,14 +551,29 @@ export const register: Register = on => {
       s.step === 'awaiting' && s.message ? <Text color="warning">{s.message}</Text> : null,
       <Box flexDirection="row" gap={2}>
         {locked ? null : s.step === 'error' ? (
-          <Button key="retry" label={STR.retry} variant="primary" hotkey="r" onPress={() => submit($, null)} />
+          <Button key="retry" label={STR.retry} variant="primary" hotkey={hk('r')} onPress={() => submit($, null)} />
         ) : (
-          <Button key="submit" label={STR.submit} variant="primary" dimColor={!hasDraft} hotkey="s" onPress={() => submit($, null)} />
+          <Button key="submit" label={STR.submit} variant="primary" dimColor={!hasDraft} hotkey={hk('s')} onPress={() => submit($, null)} />
         )}
-        {locked ? null : <Button key="teach" label={STR.teach} hotkey="t" onPress={() => teach($)} />}
-        {locked ? null : <Button key="skip" label={STR.skip} dimColor hotkey="k" onPress={() => skip($)} />}
+        {locked ? null : <Button key="skip" label={STR.skip} dimColor hotkey={hk('k')} onPress={() => skip($)} />}
         {s.step === 'error' ? <Button key="close" label={STR.close} onPress={() => $.ui.close({ id: PANE })} /> : null}
       </Box>,
+      // Teach me has a row of its own, under Submit. A Button takes no fill, and a desktop draws a plain
+      // one without its grey chrome: the orange box is the button's body, and as a column it
+      // stretches the Button across its width, so all but the thin padding is pressable.
+      locked ? null : app ? (
+        <Box key="teach-box" flexDirection="column" backgroundColor={TEACH.bg} borderStyle="round" borderColor={TEACH.bg} paddingX={1} paddingY={0.5}>
+          <Button key="teach" plain label={STR.teach} onPress={() => teach($)}>
+            <Text color={TEACH.text}>{STR.teach}</Text>
+          </Button>
+        </Box>
+      ) : (
+        <Box key="teach-row" flexDirection="row">
+          <Button key="teach" label={STR.teach} hotkey={hk('t')} onPress={() => teach($)}>
+            <Text color={TEACH.text} backgroundColor={TEACH.bg}>{STR.teach}</Text>
+          </Button>
+        </Box>
+      ),
     )
   })
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "eklavya",
-  "version": "1.71.0",
+  "version": "1.71.2",
   "description": "Learn while your agent works — local knowledge graph, spaced repetition, and quiz gating for agent-assisted development.",
   "license": "MIT",
   "repository": {