npm - eklavya - Versions diffs - 1.25.3 → 1.27.0 - Mend

eklavya 1.25.3 → 1.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (46) hide show

package/dist/artifacts.js +214 -0
package/dist/artifacts.js.map +1 -0
package/dist/assets/artifact-template.html +144 -0
package/dist/assets/dashboard.html +119 -2
package/dist/assets/tutor/SKILL.md +7 -0
package/dist/cli-memory.js +6 -3
package/dist/cli-memory.js.map +1 -1
package/dist/cli.js +185 -5
package/dist/cli.js.map +1 -1
package/dist/config.js +10 -2
package/dist/config.js.map +1 -1
package/dist/dashboard.js +41 -1
package/dist/dashboard.js.map +1 -1
package/dist/hooks/memory-lib.js +1 -1
package/dist/hooks/memory-lib.js.map +1 -1
package/dist/hooks/session-start.js +34 -3
package/dist/hooks/session-start.js.map +1 -1
package/dist/install-lock.js +155 -0
package/dist/install-lock.js.map +1 -0
package/dist/install.js +82 -60
package/dist/install.js.map +1 -1
package/dist/memory/reservation.js +15 -5
package/dist/memory/reservation.js.map +1 -1
package/dist/memory/worker.js +72 -31
package/dist/memory/worker.js.map +1 -1
package/dist/migrations/015_event_link_indexes.sql +24 -0
package/dist/onboard.js +29 -15
package/dist/onboard.js.map +1 -1
package/dist/paths.js +8 -0
package/dist/paths.js.map +1 -1
package/dist/plugin/.claude-plugin/plugin.json +1 -1
package/dist/plugin/agents/explainer.md +55 -0
package/dist/plugin/agents/tutor.md +7 -0
package/dist/plugin/hooks/CLAUDE.md +15 -3
package/dist/plugin/hooks/run.mjs +104 -21
package/dist/plugin/skills/CLAUDE.md +7 -0
package/dist/plugin/skills/tutor/SKILL.md +7 -0
package/dist/tools/config_tools.js +8 -0
package/dist/tools/config_tools.js.map +1 -1
package/dist/tools/record_attempt.js +25 -1
package/dist/tools/record_attempt.js.map +1 -1
package/dist/update.js +284 -0
package/dist/update.js.map +1 -0
package/dist/user-skill/eklavya/SKILL.md +18 -1
package/dist/user-skill/eklavya-artifacts/SKILL.md +116 -0
package/package.json +1 -1

package/dist/artifacts.js ADDED Viewed

@@ -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 yields a readable page: the template's
+        // own fallbacks cover the roles it names.
+        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 ADDED Viewed

@@ -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 ADDED Viewed

@@ -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{ --ok:var(--spot); --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:0 0 0 2px var(--bg),0 0 0 4px var(--spot)}
+  @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>

package/dist/assets/dashboard.html CHANGED Viewed

@@ -566,6 +566,7 @@ const T = {
   session:  { page:1 },
   memory:   { page:1, q:'', tag:'all', since:'', until:'' },
   reuse:    { page:1, only:'all' },
+  artifacts:{ page:1, q:'' },
 };
 const PER = 20;
@@ -2162,8 +2163,8 @@ function viewHealth() {
 /* ============================================================
    Workflows and routes
-   Two workflows, one shell. The registry below is the only description of
-   either: the sidebar, the picker, the route resolver and the page renderer all
+   Three workflows, one shell. The registry below is the only description of
+   any of them: the sidebar, the picker, the route resolver and the page renderer all
    read it, so the selector, the highlighted item and the screen cannot disagree
    about where the reader is.
@@ -2171,7 +2172,106 @@ function viewHealth() {
    workflow, the page, the highlighted item and the project scope, so a refresh,
    a pasted link or Back/Forward rebuilds the same screen from nothing.
    ============================================================ */
+/* ============================================================
+   Artifacts — the pages an agent wrote under ~/.eklavya/artifacts/.
+   `S.artifacts` is read from the files on every load; opening one is a plain
+   link to `/artifacts/<id>`, which the server serves sandboxed, in a new tab.
+   ============================================================ */
+const ARTIFACT_KINDS = ['all', 'explainer', 'artifact'];
+const artifactsInScope = () => (S.artifacts ?? []).filter((a) => inScope(a.project));
+const artifactUrl = (a) => '/artifacts/' + a.id.split('/').map(encodeURIComponent).join('/');
+function artifactRow(a) {
+  const known = a.concept && S.concepts.some((c) => c.slug === a.concept);
+  const concept = !a.concept ? '<span class="slug">—</span>'
+    : known ? `<a class="link slug" data-go="${esc(LH('concept', a.concept))}">${esc(a.concept)}</a>`
+    : `<span class="slug">${esc(a.concept)}</span>`;
+  return `<tr>
+    <td style="min-width:260px"><a class="link title" href="${esc(artifactUrl(a))}" target="_blank" rel="noopener">${esc(a.title)}</a>
+      ${a.description ? `<div class="ctx">${esc(a.description)}</div>` : ''}</td>
+    <td><span class="pill">${esc(a.kind)}</span></td>
+    <td>${concept}</td>
+    <td class="num slug" style="white-space:nowrap">${esc(stamp(a.created))}</td></tr>`;
+}
+function viewArtifacts(param) {
+  const t = T.artifacts;
+  const kind = ARTIFACT_KINDS.includes(param) ? param : 'all';
+  const all = artifactsInScope();
+  const q = t.q.trim().toLowerCase();
+  const list = all.filter((a) => {
+    if (kind !== 'all' && a.kind !== kind) return false;
+    if (q && ![a.title, a.description, a.concept ?? '', pname(a.project), a.id].join(' ').toLowerCase().includes(q)) return false;
+    return true;
+  });
+  const p = page('artifacts', list.length);
+  // The page's slice, grouped by project in the order it arrives (newest first).
+  const groups = new Map();
+  for (const a of slice(list, p)) {
+    const id = pid(a.project);
+    if (!groups.has(id)) groups.set(id, []);
+    groups.get(id).push(a);
+  }
+  const counts = { all: all.length, explainer: all.filter((a) => a.kind === 'explainer').length };
+  counts.artifact = all.length - counts.explainer;
+  const chip = (k, label) => `<button class="chip" data-go="${esc(AH('dashboard', k === 'all' ? null : k))}" aria-pressed="${kind === k}">${label} ${counts[k]}</button>`;
+  const cols = [{t:'Page'},{t:'Kind'},{t:'Concept'},{t:'Written',n:1}];
+  const body = !list.length
+    ? `<p class="empty">${all.length ? 'Nothing matches that search.' : 'No artifacts yet. Ask for an Eklavya artifact, or turn on explain_on_wrong, and they land here.'}</p>`
+    : [...groups].map(([id, rows]) =>
+        `<h3 class="slug" style="margin:var(--space-5) 0 var(--space-2)">${esc(projectById(id)?.name ?? (id === '~' ? 'no project' : base(id)))}</h3>`
+        + table(cols, rows.map(artifactRow))).join('') + pager('artifacts', list.length, p);
+  return [
+    `<div>
+       <h1 class="page__title">Artifacts</h1>
+       <p class="page__sub">Pages your agent wrote for you — explainers after a missed question, and anything you asked
+         to have turned into a page. Each opens in a new tab, from <code>~/.eklavya/artifacts/</code>.</p>
+     </div>`,
+    tiles([
+      ['Artifacts', all.length, 'in scope'],
+      ['Explainers', counts.explainer, 'written after a question', null, counts.explainer ? AH('dashboard', 'explainer') : null],
+      ['Projects', new Set(all.map((a) => pid(a.project))).size, 'with at least one page', null, AH('projects')],
+    ]),
+    card(null, null,
+      `<div class="filters">
+         <div class="grow"><input type="search" id="aq" value="${esc(t.q)}" placeholder="Search title, description, concept or project…" aria-label="Search artifacts"></div>
+       </div>
+       <div class="chips">${chip('all','All')}${chip('explainer','Explainers')}${chip('artifact','Other pages')}</div>
+       <div style="margin-top:var(--space-4)">${body}</div>`),
+  ].join('');
+}
+function viewArtifactProjects() {
+  const by = new Map();
+  for (const a of artifactsInScope()) {
+    const id = pid(a.project);
+    const r = by.get(id) ?? { id, n: 0, explainers: 0, last: a.created };
+    r.n += 1; if (a.kind === 'explainer') r.explainers += 1;
+    if (a.created > r.last) r.last = a.created;
+    by.set(id, r);
+  }
+  // ponytail: a project the inventory has never seen (a directory with no
+  // Eklavya activity) cannot be a scope, so its row is not a link. Upgrade:
+  // teach `projectInventory` to count artifact projects.
+  const rows = [...by.values()].sort((a, b) => (a.last < b.last ? 1 : -1)).map((r) => {
+    const p = projectById(r.id);
+    return `<tr${p ? ` class="row" data-go="${esc(AH('dashboard', null, { project: r.id }))}"` : ''}>
+      <td style="min-width:220px"><span class="title">${esc(p?.name ?? base(r.id))}</span><div class="slug">${esc(r.id)}</div></td>
+      <td class="num">${r.n}</td><td class="num">${r.explainers || '—'}</td>
+      <td class="num slug">${esc(ago(r.last))}</td></tr>`;
+  });
+  return [
+    `<div>
+       <h1 class="page__title">Projects</h1>
+       <p class="page__sub">Artifacts are filed by the project they were written in — the main checkout, for a worktree.
+         Open one to see only its pages.</p>
+     </div>`,
+    card(null, null, table([{t:'Project'},{t:'Pages',n:1},{t:'Explainers',n:1},{t:'Last written',n:1}], rows)),
+  ].join('');
+}
 const ICONS = {
+  artifacts: '<path d="M6 3h9l4 4v14H6z"/><path d="M14 3v5h5"/><path d="M9 13h7M9 17h5"/>',
   learning:  '<path d="M4 19V6a2 2 0 0 1 2-2h13v13H6a2 2 0 0 0-2 2z"/><path d="M6 21h13v-4"/><path d="M9 8h6"/>',
   memory:    '<ellipse cx="12" cy="6" rx="8" ry="3"/><path d="M4 6v6c0 1.7 3.6 3 8 3s8-1.3 8-3V6"/><path d="M4 12v6c0 1.7 3.6 3 8 3s8-1.3 8-3v-6"/>',
   dashboard: '<path d="M3 12l9-9 9 9"/><path d="M5 10v10h14V10"/>',
@@ -2230,6 +2330,16 @@ const WORKFLOWS = {
       health:    { label: 'Health', view: () => viewHealth() },
     },
   },
+  artifacts: {
+    name: 'Artifacts',
+    groups: [
+      { id: 'library', label: 'Library', items: ['projects'] },
+    ],
+    pages: {
+      dashboard: { label: 'Dashboard', view: (p) => viewArtifacts(p) },
+      projects:  { label: 'Projects', view: () => viewArtifactProjects() },
+    },
+  },
 };
 /**
@@ -2247,6 +2357,7 @@ function href(wf, page, param, q = {}) {
 }
 const LH = (page, param, q) => href('learning', page, param, q);
 const MH = (page, param, q) => href('memory', page, param, q);
+const AH = (page, param, q) => href('artifacts', page, param, q);
 /** A session opened from Memory stays in Memory, and from Learning in Learning. */
 const sessHref = (id) => href(CUR.wf, 'session', id);
@@ -2355,6 +2466,7 @@ function navCounts(wf) {
       domains: new Set(conceptsInScope().map((c) => c.domain)).size,
     };
   }
+  if (wf === 'artifacts') return { projects: new Set(artifactsInScope().map((a) => pid(a.project))).size };
   return {
     timeline: sum((p) => p.memory.entries),
     sessions: sum((p) => p.memory.sessions),
@@ -2694,6 +2806,11 @@ $('view').addEventListener('input', (e) => {
     T.concepts.page = 1;
     render({ id:'q', pos:e.target.selectionStart });
   }
+  if (e.target.id === 'aq') {
+    T.artifacts.q = e.target.value;
+    T.artifacts.page = 1;
+    render({ id:'aq', pos:e.target.selectionStart });
+  }
   if (e.target.id === 'mq') {
     T.memory.q = e.target.value;
     T.memory.page = 1;

package/dist/assets/tutor/SKILL.md CHANGED Viewed

@@ -168,6 +168,13 @@ tool exists to prevent. **Read `references/grading.md` before you grade** — bo
 scales, how long feedback may be, the sequence a blank earns, and what
 `already_taught` changes.
+**A missed answer can come back with `explain`.** That is `explain_on_wrong` at
+work: follow its `instruction` exactly. The page is written in the background
+and opens by itself, so give the verdict, say the page is on its way, and go
+back to the task — no longer explanation, no waiting. When the developer asks
+for something to be explained as a page ("explain this to me", "make me a page
+on this"), start the same background explainer whatever the setting says.
 ## The dials
 **Mode** is how hard to push, **focus** is what to teach, **cadence** is when to

package/dist/cli-memory.js CHANGED Viewed

@@ -451,11 +451,14 @@ function memoryPrune() {
     try {
         const { config } = loadConfig();
         if (!config.memory.retention_days) {
-            process.stdout.write('memory.retention_days is not set, so raw evidence is kept until deleted by hand.\n');
+            process.stdout.write('memory.retention_days is not set for this project, so its raw evidence is kept until deleted by hand.\n');
             return;
         }
-        const removed = pruneEvidence(db, config);
-        process.stdout.write(`Deleted ${removed} raw evidence events older than ${config.memory.retention_days} days.\n`);
+        // This project only, under this project's resolved retention: another
+        // project may keep its evidence (retention unset) or a different window.
+        const project = currentProject();
+        const removed = pruneEvidence(db, config, { project });
+        process.stdout.write(`Deleted ${removed} raw evidence events older than ${config.memory.retention_days} days in ${project}.\n`);
     }
     finally {
         db.close();