eklavya 1.77.0 → 1.79.0

package/dist/tools/index.js.map

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

package/dist/user-skill/eklavya/SKILL.md

@@ -262,18 +262,27 @@ the learning history. Two cases it can't fix on its own, and `doctor` says which
   `~/.claude/skills/eklavya/`. Never overwrite it. Tell them to move theirs
   first, then run `eklavya install`.
 
-**Auto mode denied a panel tool.** A message such as `plugin:eklavya:eklavya -
-panel_sync (mcp) denied by auto mode` means Claude Code's auto mode refused a
-call the quiz panel made on its own; a plugin cannot grant its own permissions.
-When they ask you to fix it, read `~/.claude/settings.json` and add these to
-`permissions.allow`, keeping every existing entry and adding none twice:
+**Auto mode denied an Eklavya tool.** A message such as `plugin:eklavya:eklavya -
+panel_sync (mcp) denied by auto mode`, or a denial of `get_session_quiz_plan`
+with an odd reason like "Irreversible Local Destruction", means Claude Code's
+auto mode refused a call Eklavya's hooks or panel make on their own; a plugin
+cannot grant its own permissions. When they ask you to fix it, read
+`~/.claude/settings.json` and add these ten to `permissions.allow`, keeping every
+existing entry and adding none twice:
 `mcp__plugin_eklavya_eklavya__panel_sync`,
-`mcp__plugin_eklavya_eklavya__panel_answer` and
-`mcp__plugin_eklavya_eklavya__present_question`. Create `permissions.allow` if
-it is missing, and leave the file valid JSON. Do not allow the whole
-`mcp__plugin_eklavya_eklavya` server instead: that would also let
-`memory_delete` and `set_config` run unasked. Show them the entries you added.
-If the denial continues, a restart of Claude Code reloads the settings.
+`mcp__plugin_eklavya_eklavya__panel_answer`,
+`mcp__plugin_eklavya_eklavya__present_question`,
+`mcp__plugin_eklavya_eklavya__log_session_concepts`,
+`mcp__plugin_eklavya_eklavya__get_session_quiz_plan`,
+`mcp__plugin_eklavya_eklavya__record_attempt`,
+`mcp__plugin_eklavya_eklavya__upsert_concepts`,
+`mcp__plugin_eklavya_eklavya__get_learner_profile`,
+`mcp__plugin_eklavya_eklavya__memory_search` and
+`mcp__plugin_eklavya_eklavya__memory_get`.
+Create `permissions.allow` if it is missing, and leave the file valid JSON. Do not
+allow the whole `mcp__plugin_eklavya_eklavya` server instead: that would also let
+`memory_write`, `memory_delete` and `set_config` run unasked. Show them the entries
+you added. If the denial continues, a restart of Claude Code reloads the settings.
 `eklavya:eklavya-explainer denied by auto mode` needs no fix and has none: auto
 mode drops `Agent` allow rules, so do not add one. The panel asks once more,
 then queues a prompt for you to start the explainer; do that and tell them
@@ -297,7 +306,11 @@ full field list is https://eklavya-run.web.app/docs/usage-analytics/. Besides th
 learning, memory and settings counts it has a `feedback` event: whether
 `feedback.enabled` is on, how many prompt reviews were made and how many were
 acknowledged, and three `feature_use` counts of how the Feedback page was
-reached. Never the prompt or anything a review says.
+reached. Never the prompt or anything a review says. It also counts, as
+`feature_use`, which dashboard workflows are opened, whether an explainer opened
+in the dashboard was scrolled to 25, 50, 75 and 100 percent, which setting was
+changed from the dashboard or the CLI (the key, never the value), and MCP tool
+calls that returned an error.
 
 Restarting Claude Code is what picks up a repaired install — the plugin and MCP
 server are read at session start. The only background process is the dashboard,

package/dist/user-skill/eklavya-artifacts/SKILL.md

@@ -65,22 +65,129 @@ paragraph of definition. Name the gotcha at the end, in plain terms.
 before/after, a hierarchy or a number worth comparing is a diagram that has not
 been drawn yet; two or three in a medium page is normal.
 
-| The thing being explained | Draw |
-|---|---|
-| Ordered process, pipeline | Step / flow diagram |
-| Decision, branch, retry | Gate or decision diagram |
-| Who calls whom, over time | Sequence diagram |
-| Boxes and boundaries | Architecture diagram |
-| States and transitions | State diagram |
-| Two options side by side | Comparison table plus a before/after pair |
-
-Draw them as **inline SVG** inside `<figure>`, with the template's classes —
-`.svg-box`, `.svg-box-spot` (the one node that matters), `.svg-line`,
-`.svg-line-spot`, `.svg-label`, `.svg-small`, `.svg-muted` — and a
-`<figcaption>` that states the takeaway, not the title. Never a raster image,
-ASCII boxes or a Mermaid script: inline SVG themes and prints, the others do
-not. The first `<figure>` diagram is the page's thumbnail in the dashboard's
-Artifacts gallery, so put the one that explains the page first.
+**Pick the diagram from the idea, not from habit.** Every page so far has been
+one left-to-right row of boxes. Choose the type that matches the shape of the
+thing, and when a page has two or three diagrams, make them different types.
+
+| The idea | Draw | Colour it by |
+|---|---|---|
+| Ordered steps, a pipeline | **Step flow** | actor or phase |
+| Who calls whom, over time | **Sequence** (lifelines, numbered messages) | one colour per participant |
+| A choice, a retry, a guard | **Decision** (diamonds, yes/no edges) | the outcome: `.svg-ok` / `.svg-bad` |
+| Several actors or layers share a job | **Swimlane** | one lane per actor |
+| Parts and boundaries | **Layered architecture** (nested zones) | the layer or trust boundary |
+| States and transitions | **State machine** | the kind of state; terminal state in `-spot` |
+| Before vs after, broken vs fixed | **Split panel** | `.svg-bad` left, `.svg-ok` right, only for a real fault and its fix |
+| Quantities, costs, counts | **Bars** (`.svg-bar-N`, value printed on each) | the series |
+| Parent and child, nesting | **Tree** | depth or kind |
+| Time and overlap | **Timeline strip** (one row per actor, bars on an axis) | the actor |
+| A cycle that feeds itself | **Loop** (nodes on a ring, arrows clockwise) | the phase |
+| Two measures, four verdicts | **Quadrant** (2×2 with labelled corners) | the quadrant |
+| Narrowing or ranking | **Funnel / pyramid** (stacked bars, count on each) | the stage |
+| Tables and their links | **Schema / ER** (box per table, key columns, lines with 1 / n) | the owner of the data |
+| Many things against many | **Matrix / heatmap** (grid, one tint per cell, value printed) | the value band |
+| What overlaps, what is only in one | **Venn** (two or three circles, `fill-opacity` via `-soft`) | the set |
+
+**Before drawing, decide in one line**: the type, the one thing the reader should
+take away, and what you will leave out. Deleting a box usually improves a
+diagram more than adding one. Avoid:
+
+- a generic row of identical rounded boxes when a lane, layer or axis would
+  show the structure;
+- decoration with no meaning (icons, gradients, extra arrows, a legend for one colour);
+- a colour used on everything: colour the groups, and let `-spot` mark the one
+  thing that matters;
+- a diagram of a list (use a table) or of a single shape (use a sentence);
+- invented detail: every label is a real name from the code or the question.
+
+Layout: snap coordinates, widths and gaps to multiples of 4 so edges line up;
+keep 16px between a shape and its text; one idea per diagram, at most about
+eight nodes. Give every `<svg>` a `<title>` and a one-sentence `<desc>` as its
+first children, as well as `role="img"` and `aria-label`.
+
+Draw them as **inline SVG** inside `<figure>`, with a `<figcaption>` that
+states the takeaway, not the title. Never a raster image, ASCII boxes or a
+Mermaid script: inline SVG themes and prints, the others do not. The first
+`<figure>` diagram is the page's thumbnail in the dashboard's Artifacts
+gallery, so put the one that explains the page first.
+
+SVG classes (all role colours, so both grounds work):
+
+- Neutral: `.svg-box`, `.svg-line`, `.svg-label`, `.svg-small`, `.svg-muted`,
+  `.svg-chip`, `.svg-axis`, `.svg-lane`, `.svg-life` (lifeline), `.svg-dash`
+  (add to a line for "optional" or "reply"), `.svg-head` (arrowhead).
+- **Categories 1–5**: `.svg-box-N` (tinted fill, coloured edge), `.svg-line-N`,
+  `.svg-bar-N`, `.svg-text-N` (coloured heading), `.svg-head-N` (arrowhead).
+  Colour means *a group*: assign 1 to the first actor, 2 to the second, and keep
+  it for the whole page. Use at most four categories in one diagram, and put
+  the group's name in text on or beside every coloured shape, so the diagram
+  still reads in print and without colour. A legend is a row of small
+  `.svg-box-N` squares with a `.svg-small` label.
+- State: `.svg-ok` (fixed, allowed), `.svg-bad` (broken, rejected),
+  `.svg-box-spot` / `.svg-line-spot` (the one node or edge the page is about).
+
+Arrowheads: put one `<defs>` in the diagram,
+`<marker id="a1" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto"><path class="svg-head" d="M0 0L8 4L0 8z"/></marker>`,
+and set `marker-end="url(#a1)"` on a line. Marker ids are shared by the whole
+page, so use `a1`, `a2`, `a3`, … across diagrams, never the same id twice. Give every
+`<svg>` a `viewBox`, `role="img"` and an `aria-label`; keep text at least 11px
+at the viewBox size and keep the width at 640 so it fits a phone.
+
+Skeletons (copy, then change the words and the numbers):
+
+```html
+<!-- Sequence: lifelines, one colour per participant -->
+<svg viewBox="0 0 640 220" role="img" aria-label="Browser asks the API, which asks the database">
+  <defs><marker id="a1" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto"><path class="svg-head" d="M0 0L8 4L0 8z"/></marker></defs>
+  <rect class="svg-box-1" x="40" y="10" width="120" height="34"/><text class="svg-text-1" x="100" y="32" text-anchor="middle">Browser</text>
+  <rect class="svg-box-2" x="260" y="10" width="120" height="34"/><text class="svg-text-2" x="320" y="32" text-anchor="middle">API</text>
+  <rect class="svg-box-3" x="480" y="10" width="120" height="34"/><text class="svg-text-3" x="540" y="32" text-anchor="middle">Database</text>
+  <line class="svg-life" x1="100" y1="44" x2="100" y2="210"/><line class="svg-life" x1="320" y1="44" x2="320" y2="210"/><line class="svg-life" x1="540" y1="44" x2="540" y2="210"/>
+  <line class="svg-line-1" x1="100" y1="86" x2="316" y2="86" marker-end="url(#a1)"/><text class="svg-small" x="110" y="78">1 GET /orders</text>
+  <line class="svg-line-2" x1="320" y1="126" x2="536" y2="126" marker-end="url(#a1)"/><text class="svg-small" x="330" y="118">2 SELECT</text>
+  <line class="svg-line-3 svg-dash" x1="536" y1="166" x2="324" y2="166" marker-end="url(#a1)"/><text class="svg-small" x="360" y="158">3 rows</text>
+</svg>
+
+<!-- Swimlane: a band per actor, steps inside it -->
+<svg viewBox="0 0 640 200" role="img" aria-label="The client validates, the server saves">
+  <defs><marker id="a2" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto"><path class="svg-head-1" d="M0 0L8 4L0 8z"/></marker></defs>
+  <rect class="svg-lane" x="0" y="0" width="640" height="90"/><text class="svg-text-1" x="12" y="20">Client</text>
+  <rect class="svg-lane" x="0" y="100" width="640" height="90"/><text class="svg-text-2" x="12" y="120">Server</text>
+  <rect class="svg-box-1" x="110" y="30" width="140" height="44"/><text class="svg-label" x="180" y="57" text-anchor="middle">Validate form</text>
+  <rect class="svg-box-2" x="330" y="130" width="140" height="44"/><text class="svg-label" x="400" y="157" text-anchor="middle">Save order</text>
+  <path class="svg-line-1" d="M250 52H290V152H326" marker-end="url(#a2)"/>
+</svg>
+
+<!-- Decision: diamond, outcomes coloured by result -->
+<svg viewBox="0 0 640 180" role="img" aria-label="If the token is expired, refresh it, otherwise send the request">
+  <polygon class="svg-box-spot" points="120,20 200,70 120,120 40,70"/><text class="svg-label" x="120" y="74" text-anchor="middle">Expired?</text>
+  <line class="svg-line-spot" x1="200" y1="70" x2="330" y2="70"/><text class="svg-small" x="250" y="60">yes</text>
+  <rect class="svg-box-2" x="330" y="48" width="150" height="44"/><text class="svg-label" x="405" y="75" text-anchor="middle">Refresh token</text>
+  <line class="svg-line" x1="120" y1="120" x2="120" y2="150"/><text class="svg-small" x="130" y="140">no</text>
+  <rect class="svg-ok" x="40" y="150" width="160" height="26"/><text class="svg-label" x="120" y="168" text-anchor="middle">Send request</text>
+</svg>
+
+<!-- State machine: rounded states, labelled edges -->
+<svg viewBox="0 0 640 140" role="img" aria-label="An order goes from draft to paid to shipped">
+  <defs><marker id="a3" viewBox="0 0 8 8" refX="7" refY="4" markerWidth="7" markerHeight="7" orient="auto"><path class="svg-head" d="M0 0L8 4L0 8z"/></marker></defs>
+  <rect class="svg-box-1" x="20" y="50" width="130" height="40"/><text class="svg-text-1" x="85" y="75" text-anchor="middle">draft</text>
+  <rect class="svg-box-2" x="260" y="50" width="130" height="40"/><text class="svg-text-2" x="325" y="75" text-anchor="middle">paid</text>
+  <rect class="svg-box-spot" x="490" y="50" width="130" height="40"/><text class="svg-label" x="555" y="75" text-anchor="middle">shipped</text>
+  <line class="svg-line" x1="150" y1="70" x2="258" y2="70" marker-end="url(#a3)"/><text class="svg-small" x="170" y="62">pay()</text>
+  <line class="svg-line" x1="390" y1="70" x2="488" y2="70" marker-end="url(#a3)"/><text class="svg-small" x="408" y="62">ship()</text>
+</svg>
+
+<!-- Bars: value printed on every bar -->
+<svg viewBox="0 0 640 150" role="img" aria-label="Query time before 840 ms, after 60 ms">
+  <line class="svg-axis" x1="110" y1="10" x2="110" y2="130"/>
+  <text class="svg-small" x="10" y="42">before</text><rect class="svg-bar-2" x="110" y="26" width="440" height="24"/><text class="svg-label" x="558" y="43">840 ms</text>
+  <text class="svg-small" x="10" y="92">after</text><rect class="svg-bar-1" x="110" y="76" width="34" height="24"/><text class="svg-label" x="152" y="93">60 ms</text>
+</svg>
+```
+
+Whatever the type, it shows the real mechanism of *this*
+page, with the real names from the code, not a generic boxes-and-arrows
+picture. Check it at phone width (labels not clipped, nothing overlapping).
 
 **Stay on the design system.** Components already in the template: `.eyebrow`,
 `.lede`, `.card`, `.grid`, `.chip` (`.warn`, `.bad`), `.stat` (`.k`, `.v`,
@@ -98,10 +205,13 @@ follows Eklavya's rules:
   `--line-2`; accent `--spot`, `--spot-soft` (tints), `--spot-ink` (text on a
   `--spot` fill); state `--warning`, `--error`. `--faint-2` is for disabled
   marks only, never readable text.
-- **One accent**, verdigris `--spot`, spent a handful of times: the node that
-  matters, a key number, a link. No other hues. `--warning` and `--error` mean
-  a real warning or mistake, and always carry a word or mark too — never
-  colour alone.
+- **One accent for the page**, verdigris `--spot`, spent a handful of times: the
+  node that matters, a key number, a link. **Diagrams may also use the five
+  category roles** `--viz-1` … `--viz-5` (teal, amber, blue, violet, rose) and
+  their `-soft` tints, through the `.svg-*-N` classes only. A colour names a
+  group and always carries a word. `--warning` and `--error` mean a real
+  warning or mistake: use `.svg-bad` for a fault, never a category colour.
+  No other hues, and no category colour outside a diagram.
 - **Square and flat.** `border-radius: 0` on every box, chip and table; circles
   only for dots. Separate with 1px hairlines, not shadows.
 - **Type through the variables**: `--font-disp` (Archivo) for headings,
@@ -143,6 +253,8 @@ searchable view.
 |---|---|
 | Writing the file into the project repository | Artifacts live under `~/.eklavya/artifacts/`, always — `new` puts them there |
 | A wall of prose describing a sequence | That is a step diagram. Draw it |
+| Every diagram is a grey row of boxes | Pick the type from the table; colour by actor or layer |
+| A colour with no label, or the same marker id in two diagrams | Name the group in text; `a1`, `a2`, … once each |
 | Raw hex, rounded cards, drop shadows | Role tokens, square chrome, hairlines |
 | `html2pdf` or `jspdf` from a CDN | The PDF button is `window.print()` plus the print stylesheet |
 | A PDF page two-thirds empty | A `break-inside: avoid` on a block taller than a page |

package/package.json

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