eklavya 1.26.0 → 1.27.1

package/README.md

@@ -1,27 +1,29 @@
-# eklavya
+# Eklavya
 
-[Eklavya](https://github.com/ProjectAJ14/eklavya) — learn while your agent works. This package is
-the whole thing: the installer, the MCP server, the CLI, and the Claude Code plugin it installs.
+[Eklavya](https://github.com/ProjectAJ14/eklavya) teaches the concepts behind
+agent-written code and keeps local project memory. This package includes the
+Claude Code plugin, installer, CLI and MCP server.
 
-## Install
+## Install in Claude Code
+
+With Node 22 or newer:
 
 ```bash
 npx eklavya install
 ```
 
-That checks your Node version, installs the runtime and its SQLite driver, registers the plugin
-with Claude Code and enables it, installs the chat skill into `~/.claude/skills/`, and creates the
-database. Restart Claude Code afterwards, then run `/eklavya:setup` to pick a mode. Re-running it
-is how you upgrade; `npx eklavya uninstall` removes it and keeps your history unless you pass
-`--purge`.
+Follow the settings prompts, then restart Claude Code. The installer registers
+the plugin, installs the managed runtime and chat/artifact skills, and prepares
+local storage. `/eklavya:setup` lets you revisit settings.
 
-Requires **Node 22+** — below that the SQLite driver has no prebuilt binary and would need a C++
-toolchain to compile.
+Read the [installation guide](https://eklavya-run.web.app/docs/installing/) for
+verification and [updates and removal](https://eklavya-run.web.app/docs/updates/)
+for maintenance. Uninstall preserves learner data unless you explicitly use
+`--purge`.
 
-## As a standalone MCP server
+## Standalone MCP connection
 
-The server runs on its own, so any MCP client can use it — this is what makes Eklavya
-editor-agnostic.
+An MCP client can connect directly:
 
 ```json
 {
@@ -31,41 +33,45 @@ editor-agnostic.
 }
 ```
 
-> Renamed from `eklavya-mcp` after 1.7.0, and the separate `eklavya-mcp` binary folded into
-> `eklavya serve` at the same time — one package, one command. The old package still exists on
-> npm so older installs keep resolving, but it is no longer updated.
+This exposes tools. Automatic capture, checkpoints and session instructions
+depend on host integration; an MCP connection alone does not provide Claude
+Code's learning loop.
 
-State lives in `~/.eklavya/knowledge.db` (SQLite, WAL). Override with `EKLAVYA_HOME` or `EKLAVYA_DB`.
+## Available tools
 
-## Tools
-
-| Tool | Purpose |
+| Purpose | Tools |
 |---|---|
-| `get_learner_profile` | what the developer already knows; call before teaching |
-| `log_session_concepts` | record what the current task exercises, with code context |
-| `get_session_quiz_plan` | what to ask, and at which difficulty tier |
-| `record_attempt` | grade 0–5, update mastery and the review schedule |
-| `get_gate_status` | whether this session's quiz gate has passed |
-| `upsert_concepts` | grow the graph, with slug normalization and dedupe |
-| `get_concept_graph` | a domain in prerequisite order |
-| `get_config` / `set_config` | global and per-repo settings |
+| 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` |
+| 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` |
+| Inspect code | `code_outline`, `code_find_symbol` |
 
-`session_id` is optional on every tool — the server resolves the current session itself.
+Search first, choose relevant entries, then use `memory_get` for their full
+content. Session-aware learning and configuration tools resolve the current session
+when `session_id` is omitted. In `memory_timeline`, it instead filters results
+to one session; omission shows the project timeline. Other tools may not accept
+that argument.
 
-## CLI
+## CLI and data
 
 ```bash
-eklavya install                     # install into Claude Code, runtime included
-eklavya uninstall [--purge]         # remove it; --purge also deletes your history
-eklavya doctor                      # check the install
-eklavya config get
-eklavya config set quiz.enforced true [--project]  # gate commits on one codebase
-eklavya config set focus concept              # what it teaches
-eklavya config set focus learn --topic caching
-eklavya export-rules --out rules.md              # the tutor pedagogy as Markdown
-eklavya dashboard [--port <n>] [--no-open]       # your learning history, served locally and opened
-                                                 # in your browser (--no-open just prints the URL)
-eklavya db-path
+npx eklavya doctor
+npx eklavya memory status
+npx eklavya config get
+npx eklavya dashboard
+npx eklavya db-path
 ```
 
+The [CLI reference](https://eklavya-run.web.app/docs/cli/) lists all commands and
+flags. [Configuration](https://eklavya-run.web.app/docs/configuration/) lists
+defaults and scopes. The [memory guide](https://eklavya-run.web.app/docs/memory/)
+covers retrieval, processing, providers, privacy and sync.
+
+State is local under `~/.eklavya/`, including `knowledge.db` (SQLite, WAL).
+`EKLAVYA_HOME` and `EKLAVYA_DB` override those paths. Questions and memory have
+independent switches. External processing is optional and explicitly configured;
+see [your data](https://eklavya-run.web.app/docs/your-data/).
+
 MIT.

package/dist/artifacts.js

@@ -0,0 +1,214 @@
+/**
+ * Artifacts: self-contained HTML pages an agent writes to explain something —
+ * a concept the developer got wrong, a design, a report — kept under
+ * `~/.eklavya/artifacts/<project slug>/`.
+ *
+ * Three rules shape this file.
+ *
+ * **The files are the index.** There is no table. `listArtifacts` reads each
+ * page's `<head>` for the metadata `createArtifact` stamped into it, so a page
+ * deleted, renamed or copied in by hand is reflected on the next read, and
+ * there is nothing to fall out of step with the disk. The ceiling is a scan of
+ * every file per dashboard load; `HEAD_BYTES` keeps each read small, and a few
+ * thousand pages is still milliseconds.
+ *
+ * **The design tokens are inlined at creation, not copied into the template.**
+ * `tokens.css` is the one palette the site and the dashboard share; a second
+ * hand-kept copy inside a template is the copy nobody updates. Inlining makes
+ * the page self-contained — its "download HTML" button hands over a file that
+ * still themes and prints — without a second source.
+ *
+ * **Every path in is untrusted.** `resolveArtifact` is what the dashboard
+ * serves through, and it refuses anything that does not land on an `.html`
+ * file directly inside one project folder.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { findRepoConfig, mainRepoRoot } from './config.js';
+import { artifactsDir, projectSlug } from './paths.js';
+const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+/** Enough of a file to hold its `<head>`: the metadata is written first. */
+const HEAD_BYTES = 16 * 1024;
+/** What a page is filed under: the main checkout behind a worktree, else the directory itself. */
+export function artifactProject(cwd = process.cwd()) {
+    const { repoRoot } = findRepoConfig(cwd);
+    if (repoRoot)
+        return mainRepoRoot(repoRoot);
+    try {
+        return fs.realpathSync(path.resolve(cwd));
+    }
+    catch {
+        return path.resolve(cwd);
+    }
+}
+export function kebab(title) {
+    const s = title
+        .normalize('NFKD')
+        .replace(/[̀-ͯ]/g, '')
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .slice(0, 60)
+        .replace(/-+$/, '');
+    return s || 'artifact';
+}
+const escHtml = (s) => s.replace(/[&<>"']/g, (c) => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[c]);
+function assetPath(name) {
+    return path.join(moduleDir, 'assets', name);
+}
+/** The shared tokens, minus the remote font import (the template links the fonts itself). */
+function inlineTokens() {
+    try {
+        const css = fs.readFileSync(assetPath('tokens.css'), 'utf8');
+        return css.replace(/@import\s+url\([^)]*\)[^;]*;\s*/gi, '');
+    }
+    catch {
+        // A build without the tokens still writes the page; it renders unstyled
+        // until the tokens are restored, rather than failing the command.
+        return '';
+    }
+}
+/**
+ * Writes the template, filled in, to a fresh file and returns its path. Never
+ * overwrites: a second page with the same title on the same day gets `-2`.
+ */
+export function createArtifact(opts) {
+    const title = opts.title.trim();
+    if (!title)
+        throw new Error('an artifact needs a title');
+    const now = opts.now ?? new Date();
+    const project = artifactProject(opts.cwd);
+    const folder = projectSlug(project);
+    const dir = path.join(artifactsDir(), folder);
+    fs.mkdirSync(dir, { recursive: true });
+    // The local date, not UTC: the filename is for the person reading their folder.
+    const pad = (n) => String(n).padStart(2, '0');
+    const day = `${now.getFullYear()}-${pad(now.getMonth() + 1)}-${pad(now.getDate())}`;
+    const stem = `${day}-${kebab(title)}`;
+    let file = `${stem}.html`;
+    for (let n = 2; fs.existsSync(path.join(dir, file)); n++)
+        file = `${stem}-${n}.html`;
+    const description = (opts.description ?? '').trim();
+    const kind = opts.kind ?? 'artifact';
+    const fill = {
+        '{{TITLE}}': escHtml(title),
+        '{{DESCRIPTION}}': escHtml(description),
+        '{{PROJECT}}': escHtml(project),
+        '{{PROJECT_NAME}}': escHtml(path.basename(project) || project),
+        '{{KIND}}': kind,
+        '{{CONCEPT}}': escHtml(opts.concept ?? ''),
+        '{{CREATED}}': now.toISOString(),
+        '{{EYEBROW}}': kind === 'explainer' ? 'Explainer' : 'Artifact',
+    };
+    let html = fs.readFileSync(assetPath('artifact-template.html'), 'utf8');
+    // Tokens first: the CSS contains no placeholders, but user text could.
+    html = html.replace('/*{{TOKENS}}*/', () => inlineTokens());
+    html = html.replace(/\{\{[A-Z_]+\}\}/g, (m) => fill[m] ?? m);
+    const target = path.join(dir, file);
+    fs.writeFileSync(target, html, { flag: 'wx' });
+    return { path: target, id: `${folder}/${file}`, project };
+}
+function meta(head, name) {
+    const re = new RegExp(`<meta\\s+name="${name}"\\s+content="([^"]*)"`, 'i');
+    const m = re.exec(head);
+    return m ? unescHtml(m[1]) : null;
+}
+function unescHtml(s) {
+    return s.replace(/&(amp|lt|gt|quot|#39);/g, (_, e) => ({ amp: '&', lt: '<', gt: '>', quot: '"', '#39': "'" })[e]);
+}
+function readHead(file) {
+    const fd = fs.openSync(file, 'r');
+    try {
+        const buf = Buffer.alloc(HEAD_BYTES);
+        const n = fs.readSync(fd, buf, 0, HEAD_BYTES, 0);
+        return buf.subarray(0, n).toString('utf8');
+    }
+    finally {
+        fs.closeSync(fd);
+    }
+}
+/**
+ * Every artifact on disk, newest first. A page with no Eklavya metadata — one
+ * copied in by hand — is still listed, titled from its `<title>` or filename.
+ * Never throws: an unreadable file costs that one row.
+ */
+export function listArtifacts(root = artifactsDir()) {
+    const rows = [];
+    let folders;
+    try {
+        folders = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return rows;
+    }
+    for (const folder of folders) {
+        // The same rules `resolveArtifact` serves by, so nothing is listed that
+        // the dashboard would then refuse: no dot-names, no symlinks — a link's
+        // `<head>` would otherwise be read from wherever it points.
+        if (!folder.isDirectory() || folder.name.startsWith('.'))
+            continue;
+        let files;
+        try {
+            files = fs.readdirSync(path.join(root, folder.name));
+        }
+        catch {
+            continue;
+        }
+        for (const name of files) {
+            if (!/\.html?$/i.test(name) || name.startsWith('.'))
+                continue;
+            const file = path.join(root, folder.name, name);
+            try {
+                const st = fs.lstatSync(file);
+                if (!st.isFile())
+                    continue;
+                const head = readHead(file);
+                const title = /<title>([^<]*)<\/title>/i.exec(head)?.[1]?.trim();
+                const kind = meta(head, 'eklavya:kind');
+                rows.push({
+                    id: `${folder.name}/${name}`,
+                    title: title ? unescHtml(title) : name.replace(/\.html?$/i, ''),
+                    description: meta(head, 'description') ?? '',
+                    project: meta(head, 'eklavya:project') || null,
+                    kind: kind === 'explainer' ? 'explainer' : 'artifact',
+                    concept: meta(head, 'eklavya:concept') || null,
+                    created: meta(head, 'eklavya:created') || st.mtime.toISOString(),
+                    bytes: st.size,
+                });
+            }
+            catch {
+                continue;
+            }
+        }
+    }
+    return rows.sort((a, b) => (a.created < b.created ? 1 : a.created > b.created ? -1 : 0));
+}
+/**
+ * The file behind an id, or null. Exactly `<folder>/<file>.html`, both plain
+ * names — no separators, no `..`, no leading dot — and the resolved path must
+ * still sit inside the root after symlinks, so a link planted in a project
+ * folder cannot serve a file from elsewhere on the machine.
+ */
+export function resolveArtifact(id, root = artifactsDir()) {
+    const parts = id.split('/');
+    if (parts.length !== 2)
+        return null;
+    const plain = /^[^/\\\0]+$/;
+    for (const p of parts)
+        if (!plain.test(p) || p.startsWith('.'))
+            return null;
+    if (!/\.html?$/i.test(parts[1]))
+        return null;
+    try {
+        const realRoot = fs.realpathSync(root);
+        const real = fs.realpathSync(path.join(root, parts[0], parts[1]));
+        if (path.dirname(path.dirname(real)) !== realRoot)
+            return null;
+        return fs.statSync(real).isFile() ? real : null;
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=artifacts.js.map

package/dist/artifacts.js.map

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

package/dist/assets/artifact-template.html

@@ -0,0 +1,144 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>{{TITLE}}</title>
+<meta name="description" content="{{DESCRIPTION}}">
+<meta name="eklavya:project" content="{{PROJECT}}">
+<meta name="eklavya:kind" content="{{KIND}}">
+<meta name="eklavya:concept" content="{{CONCEPT}}">
+<meta name="eklavya:created" content="{{CREATED}}">
+<!-- Eklavya type. Offline, the stacks fall back to system faces; nothing breaks. -->
+<link rel="preconnect" href="https://fonts.googleapis.com">
+<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Archivo:wght@600;800;900&family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500;600&display=swap">
+<style>
+/* Eklavya design tokens, inlined from web/public/tokens.css when this page was
+   created. Ink (dark) is the default on screen and in the PDF; data-mode="paper"
+   on <html> switches to the paper ground. Components below name ROLES only. */
+/*{{TOKENS}}*/
+</style>
+<style>
+  :root{ --maxw:880px; }
+
+  *{box-sizing:border-box}
+  body{margin:0;background:var(--bg);color:var(--ink);font:15px/1.65 var(--font-body)}
+  ::selection{background:var(--spot);color:var(--spot-ink)}
+  main{max-width:var(--maxw);margin:0 auto;padding:64px 16px 96px}
+
+  .eyebrow{margin:0 0 14px;font:400 11px/1 var(--font-mono);letter-spacing:var(--tracking-caps-wide);
+    text-transform:uppercase;color:var(--spot)}
+  h1{font:900 clamp(34px,5.4vw,64px)/.95 var(--font-disp);letter-spacing:var(--tracking-display);margin:0 0 .35em}
+  h2{font:800 clamp(24px,3vw,34px)/1 var(--font-disp);letter-spacing:var(--tracking-tight);
+    margin:2.4em 0 .7em;padding-top:1em;border-top:1px solid var(--line-2)}
+  h3{font:800 18px/1.3 var(--font-disp);letter-spacing:var(--tracking-snug);margin:1.8em 0 .4em}
+  p,li{color:var(--ink)}
+  .lede{color:var(--dim);font-size:17px;max-width:620px;margin:0 0 2.4em}
+  .muted{color:var(--dim)}
+  a{color:var(--spot);text-decoration:none;border-bottom:1px solid var(--spot)}
+  strong{font-weight:600}
+
+  code{font-family:var(--font-mono);font-size:.88em;background:var(--mass);padding:.1em .38em}
+  pre{background:var(--panel);border:1px solid var(--line-2);padding:14px 16px;overflow:auto;font-size:13px}
+  pre code{background:none;padding:0}
+
+  table{width:100%;border-collapse:collapse;margin:1.2em 0;font-size:14px}
+  th,td{text-align:left;padding:10px 12px;border-bottom:1px solid var(--line-2);vertical-align:top}
+  th{font:400 11px var(--font-mono);letter-spacing:var(--tracking-caps);text-transform:uppercase;color:var(--faint)}
+  td.num,th.num{text-align:right;font-family:var(--font-mono);font-variant-numeric:tabular-nums}
+  blockquote{margin:1.2em 0;padding:.2em 0 .2em 16px;border-left:2px solid var(--spot);color:var(--dim)}
+
+  .card{background:var(--panel);border:1px solid var(--line);padding:24px}
+  .card h3{margin-top:0}
+  .card p{color:var(--dim);font-size:14.5px;margin:0}
+  .grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(180px,1fr));gap:16px;margin:1.4em 0}
+  .chip{display:inline-block;font:12px var(--font-mono);color:var(--spot);background:var(--spot-soft);
+    border:1px solid var(--spot);padding:2px 9px}
+  .chip.warn{color:var(--warning);border-color:var(--warning);background:color-mix(in srgb,var(--warning) 12%,transparent)}
+  .chip.bad{color:var(--error);border-color:var(--error);background:color-mix(in srgb,var(--error) 12%,transparent)}
+  .stat{border:1px solid var(--line-2);padding:18px 20px}
+  .stat .k{font:400 11px var(--font-mono);letter-spacing:var(--tracking-caps);text-transform:uppercase;color:var(--faint)}
+  .stat .v{font:900 40px/1.1 var(--font-disp);letter-spacing:var(--tracking-tight);margin-top:6px}
+  .stat .d{color:var(--dim);font-size:13px}
+  .callout{border:1px solid var(--spot);background:var(--spot-soft);padding:14px 18px;margin:1.4em 0}
+
+  figure{margin:1.8em 0;background:var(--panel);border:1px solid var(--line-2);
+    padding:20px;text-align:center;break-inside:avoid}
+  figure svg{max-width:100%;height:auto}
+  figcaption{margin-top:12px;color:var(--dim);font-size:13px;text-align:center}
+  .svg-ink{fill:var(--ink)} .svg-muted{fill:var(--dim)}
+  .svg-box{fill:var(--mass);stroke:var(--line-2);stroke-width:1}
+  .svg-box-spot{fill:var(--spot-soft);stroke:var(--spot);stroke-width:1.5}
+  .svg-line{stroke:var(--faint);stroke-width:1.5;fill:none}
+  .svg-line-spot{stroke:var(--spot);stroke-width:1.5;fill:none}
+  .svg-label{font:500 13px var(--font-body);fill:var(--ink)}
+  .svg-small{font:11px var(--font-mono);fill:var(--dim)}
+
+  .actions{position:fixed;top:16px;right:16px;z-index:50;display:flex;gap:8px;flex-wrap:wrap;justify-content:flex-end}
+  .actions button{display:inline-flex;gap:7px;align-items:center;padding:8px 14px;
+    border:1px solid var(--line-2);border-radius:0;background:var(--panel);color:var(--ink);
+    font:500 12px var(--font-mono);letter-spacing:.06em;cursor:pointer}
+  .actions button:hover{border-color:var(--spot);color:var(--spot)}
+  .actions button:focus-visible{outline:none;box-shadow:var(--ring)}
+
+  @media screen{
+    body{background-image:linear-gradient(var(--grid) 1px,transparent 1px),
+      linear-gradient(90deg,var(--grid) 1px,transparent 1px);background-size:72px 72px}
+    main{background:var(--bg);border-left:1px solid var(--line-2);border-right:1px solid var(--line-2);
+      padding-left:40px;padding-right:40px;min-height:100vh}
+  }
+  @media (max-width:640px){ main{padding:76px 16px 64px!important} .actions{top:12px;right:12px} }
+
+  @media print{
+    /* Dark in the PDF too. The @page margin is canvas and prints white, so the
+       page has none, a fixed layer covers the sheet, and the gutter lives on
+       <main>, repeated on every page fragment by box-decoration-break. */
+    *{-webkit-print-color-adjust:exact;print-color-adjust:exact}
+    html,body{background:var(--bg);color:var(--ink)}
+    @page{margin:0}
+    body::before{content:"";position:fixed;inset:0;background:var(--bg);z-index:-1}
+    .actions{display:none}
+    body{font-size:11pt}
+    main{padding:12mm 16mm;max-width:none;-webkit-box-decoration-break:clone;box-decoration-break:clone}
+    h1,h2,h3{break-after:avoid;break-inside:avoid}
+    p,li{orphans:3;widows:3}
+    /* Anything that can outgrow a page must be allowed to split. */
+    table,pre,section,div{break-inside:auto}
+    thead{display:table-header-group}
+    tfoot{display:table-footer-group}
+    tr,td,th,li,.card,.stat{break-inside:avoid}
+    figure,blockquote{break-inside:avoid}
+    figure svg,figure img{max-height:170mm}
+    a{color:inherit;border:0}
+  }
+</style>
+</head>
+<body>
+<div class="actions">
+  <button type="button" onclick="window.print()" aria-label="Download this page as PDF">PDF</button>
+  <button type="button" onclick="saveHtml()" aria-label="Download this page as an HTML file">HTML</button>
+</div>
+<script>
+function saveHtml(){
+  var name=(location.pathname.split('/').pop()||'').replace(/\.html?$/,'')||'artifact';
+  var blob=new Blob(['<!DOCTYPE html>\n'+document.documentElement.outerHTML],{type:'text/html'});
+  var a=document.createElement('a');
+  a.href=URL.createObjectURL(blob); a.download=name+'.html';
+  document.body.appendChild(a); a.click(); a.remove();
+  setTimeout(function(){URL.revokeObjectURL(a.href)},1000);
+}
+</script>
+
+<main>
+  <p class="eyebrow">{{EYEBROW}} · {{PROJECT_NAME}}</p>
+  <h1>{{TITLE}}</h1>
+  <p class="lede">{{DESCRIPTION}}</p>
+
+  <!-- CONTENT: replace this comment with the page. Sections under <h2>, a
+       <figure> with an inline SVG (the .svg-* classes) for every sequence,
+       branch or before/after, a <figcaption> that states the takeaway. -->
+
+</main>
+</body>
+</html>