eklavya 1.20.0 → 1.21.0

package/dist/assets/tutor/SKILL.md

@@ -80,7 +80,7 @@ checkpoint answered is one the sweep no longer asks, so a session that
 checkpointed through the budget ends in silence. That is intended — do not top it
 up because the ending felt quiet. What the budget never reached stays unmastered
 and comes back in a later plan with `reason: "backlog"`, once that session's own
-concepts and review debt are covered, from the domains that session touches, and
+concepts and review debt are covered, from that project and the domains it touches, and
 never when `quiz.enforced` is set. It is not spaced repetition that brings it
 back — that only schedules concepts already answered once.
 

package/dist/assets/tutor/references/focus-and-level.md

@@ -72,9 +72,10 @@ you reach for the idea instead. Ask about them on their own terms.
 
 Items with `reason: "backlog"` are older work — a concept an earlier session
 logged that no question ever reached, offered once this session's own concepts
-and review debt are covered, and only from the domains this session touched --
-there is one database for every project, so the scope is what keeps a Flutter
-session off last month's Terraform. Never when `quiz.enforced` is set: a backlog answer
+and review debt are covered, and only from this project and the domains this
+session touched -- there is one database for every project, so the scope is what
+keeps a Flutter session off last month's Terraform. Review debt is scoped to this
+project the same way. Never when `quiz.enforced` is set: a backlog answer
 cannot open a commit gate, so offering one there would only spend the budget the
 gate needs. They also arrive with `context: null`, and for a
 blunter reason: the code that taught them is not on screen and may not even be

package/dist/claude-mem.js

@@ -0,0 +1,228 @@
+/**
+ * Claude Mem, seen from `eklavya install`.
+ *
+ * Both tools record every tool call and recall it at session start. Installed
+ * together, every session is captured twice and recalled twice, into two
+ * databases that never agree. So install asks once which one records, and acts
+ * on the answer:
+ *
+ *   eklavya     uninstall the Claude Mem plugin, import its history with every
+ *               project it can place filed under its checkout, and retire
+ *               `~/.claude-mem` (moved, never deleted — it is the rollback).
+ *   claude-mem  set `memory.enabled: false`. The quiz half is unaffected.
+ *
+ * The hard part is the project map. Claude Mem names a project with a bare
+ * string; Eklavya keys it by checkout path. Every Claude Mem session carries the
+ * Claude Code session id, and Claude Code's transcript for that id records the
+ * cwd — so the map is read off the transcripts rather than guessed from names.
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { spawnSync } from 'node:child_process';
+import Database from 'better-sqlite3';
+import { findRepoConfig } from './config.js';
+import { projectKey } from './store.js';
+/** `CLAUDE_MEM_DATA_DIR` is Claude Mem's own override, so it is ours too. */
+export function claudeMemDir() {
+    return process.env.CLAUDE_MEM_DATA_DIR ?? path.join(os.homedir(), '.claude-mem');
+}
+export function claudeMemDb() {
+    return path.join(claudeMemDir(), 'claude-mem.db');
+}
+function readJson(file) {
+    try {
+        return JSON.parse(fs.readFileSync(file, 'utf8'));
+    }
+    catch {
+        return {};
+    }
+}
+/** Every registered plugin id that is Claude Mem, whatever marketplace it came from. */
+export function claudeMemPluginIds(claudeHome) {
+    const installed = readJson(path.join(claudeHome, 'plugins', 'installed_plugins.json'));
+    const settings = readJson(path.join(claudeHome, 'settings.json'));
+    const ids = [
+        ...Object.keys((installed.plugins ?? {})),
+        ...Object.keys((settings.enabledPlugins ?? {})),
+    ];
+    return [...new Set(ids.filter((id) => id.startsWith('claude-mem@')))];
+}
+/**
+ * Removes the plugin through Claude Code's own CLI, and falls back to switching
+ * it off in settings.json when `claude` is not on PATH. Off is enough to stop
+ * the double recording; the fallback just cannot delete the files.
+ */
+export function removeClaudeMemPlugin(claudeHome, ids) {
+    let viaCli = true;
+    for (const id of ids) {
+        const res = spawnSync('claude', ['plugin', 'uninstall', id], {
+            stdio: 'ignore',
+            shell: process.platform === 'win32',
+            env: { ...process.env, CLAUDE_CONFIG_DIR: claudeHome },
+        });
+        if (res.status !== 0)
+            viaCli = false;
+    }
+    if (viaCli)
+        return 'uninstalled';
+    const file = path.join(claudeHome, 'settings.json');
+    const settings = readJson(file);
+    const enabled = (settings.enabledPlugins ?? {});
+    for (const id of ids)
+        enabled[id] = false;
+    settings.enabledPlugins = enabled;
+    const tmp = `${file}.tmp-${process.pid}`;
+    fs.writeFileSync(tmp, `${JSON.stringify(settings, null, 2)}\n`, 'utf8');
+    fs.renameSync(tmp, file);
+    return 'disabled';
+}
+/** The first `cwd` a transcript records, or null. Only the head is read. */
+function transcriptCwd(file) {
+    try {
+        const fd = fs.openSync(file, 'r');
+        const buf = Buffer.alloc(64 * 1024);
+        const n = fs.readSync(fd, buf, 0, buf.length, 0);
+        fs.closeSync(fd);
+        const m = /"cwd":"((?:[^"\\]|\\.)*)"/.exec(buf.toString('utf8', 0, n));
+        return m ? JSON.parse(`"${m[1]}"`) : null;
+    }
+    catch {
+        return null;
+    }
+}
+function safeMtime(file) {
+    try {
+        return fs.statSync(file).mtimeMs;
+    }
+    catch {
+        return -1;
+    }
+}
+/** The checkout a path belongs to, folded through worktrees — or null if it is gone. */
+function checkoutOf(dir) {
+    if (!dir || !fs.existsSync(dir))
+        return null;
+    const root = findRepoConfig(dir).repoRoot;
+    return root ? projectKey(root) : null;
+}
+/**
+ * Where a transcript directory's name points today. Claude Code names it after
+ * the project path with every non-alphanumeric turned into `-`, and renames it
+ * when the checkout moves — while the transcripts inside keep the old `cwd`. The
+ * encoding is lossy (`a_b`, `a-b` and `a/b` all read `a-b`), so it is decoded by
+ * walking the filesystem, keeping only segments that exist. Case-insensitive,
+ * because macOS is. Returns null on anything it cannot walk, Windows included.
+ */
+function decodeTranscriptDir(name) {
+    const enc = (s) => `-${s.replace(/[^A-Za-z0-9]/g, '-')}`.toLowerCase();
+    const walk = (dir, rest) => {
+        if (!rest)
+            return dir;
+        let entries = [];
+        try {
+            entries = fs.readdirSync(dir);
+        }
+        catch {
+            return null;
+        }
+        for (const e of entries) {
+            const seg = enc(e);
+            if (rest !== seg && !rest.startsWith(`${seg}-`))
+                continue;
+            const hit = walk(path.join(dir, e), rest.slice(seg.length));
+            if (hit)
+                return hit;
+        }
+        return null;
+    };
+    return walk('/', name.toLowerCase());
+}
+/**
+ * Claude Mem project name → Eklavya project key, for every project that can be
+ * placed. A project is placed by majority vote over its sessions' transcripts —
+ * each session counts for the checkout its `cwd` is in, or, where that path is
+ * gone, the checkout its transcript directory now points at. Failing that, by a
+ * unique live checkout whose folder carries the same name. Anything else is left
+ * out, and the importer keeps it as-is — searchable with `--all-projects`,
+ * mappable later with `--map`.
+ *
+ * ponytail: reads at most 20 transcripts per project, which is plenty to vote.
+ */
+export function guessProjectMap(sourceDb, claudeHome) {
+    const projectsDir = path.join(claudeHome, 'projects');
+    let dirs = [];
+    try {
+        dirs = fs.readdirSync(projectsDir);
+    }
+    catch {
+        return {};
+    }
+    const byId = new Map();
+    const liveByName = new Map();
+    for (const d of dirs) {
+        let files = [];
+        try {
+            files = fs.readdirSync(path.join(projectsDir, d)).filter((f) => f.endsWith('.jsonl'));
+        }
+        catch {
+            continue;
+        }
+        const paths = files.map((f) => path.join(projectsDir, d, f));
+        // The newest transcript is likeliest to name where the project lives now.
+        let newest;
+        let newestAt = -1;
+        for (const file of paths) {
+            const at = safeMtime(file);
+            if (at > newestAt)
+                [newest, newestAt] = [file, at];
+        }
+        const dirRoot = checkoutOf(newest ? transcriptCwd(newest) : null) ?? checkoutOf(decodeTranscriptDir(d));
+        for (const file of paths)
+            byId.set(path.basename(file, '.jsonl'), { file, dirRoot });
+        if (dirRoot) {
+            const name = path.basename(dirRoot);
+            liveByName.set(name, (liveByName.get(name) ?? new Set()).add(dirRoot));
+        }
+    }
+    const src = new Database(sourceDb, { readonly: true, fileMustExist: true });
+    let rows = [];
+    try {
+        rows = src
+            .prepare('SELECT project, group_concat(content_session_id) AS ids FROM sdk_sessions GROUP BY project')
+            .all();
+    }
+    catch {
+        /* no sdk_sessions: nothing to vote with */
+    }
+    finally {
+        src.close();
+    }
+    const map = {};
+    for (const { project, ids } of rows) {
+        const votes = new Map();
+        for (const id of (ids ?? '').split(',').slice(0, 20)) {
+            const t = byId.get(id);
+            const root = t ? checkoutOf(transcriptCwd(t.file)) ?? t.dirRoot : null;
+            if (root)
+                votes.set(root, (votes.get(root) ?? 0) + 1);
+        }
+        const best = [...votes].sort((a, b) => b[1] - a[1])[0];
+        const byName = liveByName.get(path.basename(project));
+        if (best)
+            map[project] = best[0];
+        else if (byName?.size === 1)
+            map[project] = [...byName][0];
+    }
+    return map;
+}
+/** `~/.claude-mem` → `~/.claude-mem.retired` (or `.retired-2`, …). Never a delete. */
+export function retireClaudeMemDir() {
+    const from = claudeMemDir();
+    let to = `${from}.retired`;
+    for (let i = 2; fs.existsSync(to); i++)
+        to = `${from}.retired-${i}`;
+    fs.renameSync(from, to);
+    return to;
+}
+//# sourceMappingURL=claude-mem.js.map

package/dist/claude-mem.js.map

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

package/dist/cli.js

@@ -20,6 +20,7 @@ import { START_LEVEL } from './srs.js';
 import Database from 'better-sqlite3';
 import { startDashboard, openInBrowser } from './dashboard.js';
 import { install, uninstall, health } from './install.js';
+import { check, dim, heading, verdict } from './theme.js';
 import { identityFor } from './memory/identity.js';
 import { countEntries, entryById, entryEvents, entryTags, pendingEventCount, receiptTotals, resumePaused, timeline, } from './memory/store.js';
 import { search } from './memory/search.js';
@@ -317,13 +318,14 @@ function doctor() {
     if (repoHere)
         migrateLegacyRepoConfig(repoHere, mainRepoRoot(repoHere));
     const resolved = loadConfig();
-    const lines = [];
+    const rows = [];
+    const add = (mark, label, detail) => rows.push([mark, label, detail]);
     let ok = true;
     // Kept apart from `ok` so the blanket remedy below stays true: `eklavya
     // install` repairs a broken install and cannot do a thing about a paused
     // queue. A memory failure still exits non-zero; it just names its own fix.
     let memoryOk = true;
-    lines.push(`home:     ${eklavyaHome()}`);
+    add('ok', 'home', eklavyaHome());
     // The install checks come first because they are what someone is looking for
     // when Eklavya has gone quiet. Everything below reads fine on an install that
     // Claude Code can no longer load at all.
@@ -331,7 +333,7 @@ function doctor() {
     for (const check of checks) {
         if (!check.ok)
             ok = false;
-        lines.push(`${`${check.name}:`.padEnd(10)}${check.ok ? '' : 'FAILED — '}${check.detail}`);
+        add(check.ok ? 'ok' : 'fail', check.name, `${check.ok ? '' : 'FAILED — '}${check.detail}`);
     }
     // Which surfaces the checks above actually cover. The `plugin` check reads
     // Claude Code's registry under `~/.claude`, which the Code tab in Claude
@@ -339,10 +341,10 @@ function doctor() {
     // inside the app's data directory and is installed from its own UI, so a
     // green doctor says nothing about it. Someone whose Cowork sessions are
     // silent needs to be told that here, not left reading a clean report.
-    lines.push('surfaces: Claude Code CLI and the Code tab in Claude Desktop (checked above).');
-    lines.push('          Cowork keeps a separate plugin list — install it there from Customize → Plugins;');
-    lines.push('          this command cannot see it. Your learning history is shared either way.');
-    lines.push(`database: ${file}${fs.existsSync(file) ? '' : '   (not created yet)'}`);
+    add('ok', 'surfaces', 'Claude Code CLI and the Code tab in Claude Desktop (checked above)');
+    add('skip', 'cowork', dim('keeps a separate plugin list — install it there from Customize → Plugins;'));
+    add('skip', 'cowork', dim('this command cannot see it. Your learning history is shared either way.'));
+    add(fs.existsSync(file) ? 'ok' : 'warn', 'database', `${file}${fs.existsSync(file) ? '' : dim('   (not created yet)')}`);
     let edgesDropped = 0;
     // Held open past the try so the memory section below can read it, and can
     // still report when it is null -- the spool drop count is exactly the number
@@ -359,20 +361,20 @@ function doctor() {
         const concepts = db.prepare('SELECT count(*) n FROM concepts').get().n;
         const attempts = db.prepare('SELECT count(*) n FROM attempts').get().n;
         const known = db.prepare('SELECT count(*) n FROM mastery WHERE score >= 0.7 AND reps >= 2').get().n;
-        lines.push(`concepts: ${concepts}`);
-        lines.push(`attempts: ${attempts}`);
-        lines.push(`mastered: ${known}`);
-        lines.push(`journal:  ${String(db.pragma('journal_mode', { simple: true }))}`);
+        add('ok', 'concepts', String(concepts));
+        add('ok', 'attempts', String(attempts));
+        add('ok', 'mastered', String(known));
+        add('ok', 'journal', String(db.pragma('journal_mode', { simple: true })));
         // The project's band, and the runway left in it. Read here because `doctor`
         // is where someone looks when the questions feel wrong for them.
         const standing = levelStanding(db, resolved.config, resolved.repoRoot);
-        lines.push(`level:    ${standing.level}${standing.pinned
-            ? ' (pinned by config — no progression)'
-            : ` (${standing.counts.passed}/${standing.needed.answers} passing answers in ${standing.repo})`}`);
+        add('ok', 'level', `${standing.level} ${dim(standing.pinned
+            ? '(pinned by config — no progression)'
+            : `(${standing.counts.passed}/${standing.needed.answers} passing answers in ${standing.repo})`)}`);
     }
     catch (err) {
         ok = false;
-        lines.push(`database error: ${err instanceof Error ? err.message : String(err)}`);
+        add('fail', 'database', `FAILED — ${err instanceof Error ? err.message : String(err)}`);
     }
     // The memory half. `eklavya memory status` says more, but it is scoped to one
     // project and nobody runs it when the question is "is anything broken" — so
@@ -388,20 +390,20 @@ function doctor() {
     const rawQuiz = resolved.raw.quiz;
     if (rawQuiz?.enabled === false && rawQuiz?.enforced === true) {
         ok = false;
-        lines.push('conflict: FAILED — quiz.enabled is false and quiz.enforced is true. A gate needs ' +
+        add('fail', 'conflict', 'FAILED — quiz.enabled is false and quiz.enforced is true. A gate needs ' +
             'passed questions and nothing will ask any, so the enforcement is being ignored ' +
             'rather than blocking every commit. Set quiz.enabled true to gate commits, or drop ' +
             'quiz.enforced to accept the silence.');
     }
     const memory = resolved.config.memory;
-    lines.push(`memory:   ${memory.enabled ? `on · capture ${memory.capture}` : 'off (memory.enabled is false)'}`);
+    add(memory.enabled ? 'ok' : 'skip', 'memory', memory.enabled ? `on · capture ${memory.capture}` : 'off (memory.enabled is false)');
     if (db) {
         const entries = safely(() => countEntries(db), 0);
         const evidence = safely(() => db.prepare('SELECT count(*) n FROM evidence_events').get().n, 0);
         const waiting = safely(() => pendingEventCount(db), 0);
-        lines.push(`memory:   ${entries} entries, ${evidence} evidence events (${waiting} not yet summarised)`);
+        add('ok', 'memory', `${entries} entries, ${evidence} evidence events ${dim(`(${waiting} not yet summarised)`)}`);
         const queue = safely(() => queueDepth(db), { pending: 0, paused: 0, failed: 0, oldest: null });
-        lines.push(`memory:   queue ${queue.pending} pending · ${queue.paused} paused · ${queue.failed} failed`);
+        add('ok', 'memory', `queue ${queue.pending} pending · ${queue.paused} paused · ${queue.failed} failed`);
         // The class, never the message. `last_error` is the provider's own prose
         // and has carried a URL with a token in it; the class is what tells someone
         // whether to fix a key or a quota, and it is a fixed vocabulary.
@@ -412,20 +414,20 @@ function doctor() {
             .join(', '), '') || 'unclassified';
         if (queue.paused > 0) {
             memoryOk = false;
-            lines.push(`memory:   FAILED — ${queue.paused} job(s) paused (${classes('paused')}); nothing is being summarised`);
-            lines.push('memory:   fix the credentials or quota behind providers.observer, then: eklavya memory process');
+            add('fail', 'memory', `FAILED — ${queue.paused} job(s) paused (${classes('paused')}); nothing is being summarised`);
+            add('fail', 'memory', dim('fix the credentials or quota behind providers.observer, then: eklavya memory process'));
         }
         if (queue.failed > 0) {
             // Not a failure: a permanently failed job is a batch that will never
             // summarise, and no command repairs it. Saying so beats a clean report.
-            lines.push(`memory:   ${queue.failed} job(s) failed permanently (${classes('failed')})`);
+            add('warn', 'memory', `${queue.failed} job(s) failed permanently (${classes('failed')})`);
         }
         // The capture heartbeat: memory that is "on" with nothing arriving is the
         // failure the entry count alone cannot show.
         const newest = safely(() => db.prepare('SELECT MAX(occurred_at) AS at FROM evidence_events').get().at, null);
-        lines.push(`memory:   last evidence ${newest ?? '— none captured yet'}`);
+        add('ok', 'memory', `last evidence ${newest ?? '— none captured yet'}`);
         const sync = safely(() => syncStatus(db, resolved.config), null);
-        lines.push(`memory:   sync ${sync?.enabled ? `on -> ${sync.target ?? '(no target set — set sync.target)'}` : 'off'}`);
+        add('ok', 'memory', `sync ${sync?.enabled ? `on -> ${sync.target ?? '(no target set — set sync.target)'}` : 'off'}`);
     }
     const dropped = safely(() => droppedCount(), 0);
     if (dropped > 0) {
@@ -433,10 +435,10 @@ function doctor() {
         // spool file, so nothing replays them on its own. The transcripts are the
         // only remaining copy.
         memoryOk = false;
-        lines.push(`memory:   FAILED — ${dropped} event(s) dropped before they reached the database`);
-        lines.push('memory:   recover them from this checkout’s transcripts with: eklavya memory replay');
+        add('fail', 'memory', `FAILED — ${dropped} event(s) dropped before they reached the database`);
+        add('fail', 'memory', dim('recover them from this checkout’s transcripts with: eklavya memory replay'));
     }
-    lines.push(`memory:   provider ${resolved.config.providers.observer ? 'configured — batches leave this machine' : 'none — nothing leaves this machine'}`);
+    add('ok', 'memory', `provider ${resolved.config.providers.observer ? 'configured — batches leave this machine' : 'none — nothing leaves this machine'}`);
     db?.close();
     // Per key, not per file. A project config that sets only `quiz` must not make
     // `focus` and `cadence` claim they came from it -- they came from the
@@ -444,18 +446,18 @@ function doctor() {
     // as the dial this release renamed. `projectPath` is a path Eklavya *would*
     // write to, so the file is read rather than assumed to exist.
     const projectKeys = new Set(resolved.projectPath ? Object.keys(readConfigFile(resolved.projectPath)) : []);
-    const from = (key) => (projectKeys.has(key) ? ' (set for this project)' : '');
+    const from = (key) => (projectKeys.has(key) ? dim(' (set for this project)') : '');
     const q = resolved.config.quiz;
-    lines.push(`quiz:     ${q.enabled ? 'on' : 'off — memory is unaffected'}${q.enforced ? ' · enforced (commits gated)' : ''}${from('quiz')}`);
-    lines.push(`focus:    ${resolved.config.focus}${resolved.config.focus === 'learn' ? ` (${resolved.config.focus_topic ?? 'no topic set'})` : ''}${from('focus')}`);
-    lines.push(`cadence:  ${resolved.config.cadence}${resolved.config.cadence === 'interleaved'
-        ? ` (one question mid-task, min ${resolved.config.min_minutes_between_checkpoints}m apart)`
-        : ' (all questions at the end of the task)'}${from('cadence')}`);
+    add(q.enabled ? 'ok' : 'skip', 'quiz', `${q.enabled ? 'on' : 'off — memory is unaffected'}${q.enforced ? ' · enforced (commits gated)' : ''}${from('quiz')}`);
+    add('ok', 'focus', `${resolved.config.focus}${resolved.config.focus === 'learn' ? ` (${resolved.config.focus_topic ?? 'no topic set'})` : ''}${from('focus')}`);
+    add('ok', 'cadence', `${resolved.config.cadence} ${dim(resolved.config.cadence === 'interleaved'
+        ? `(one question mid-task, min ${resolved.config.min_minutes_between_checkpoints}m apart)`
+        : '(all questions at the end of the task)')}${from('cadence')}`);
     if (resolved.overrides.length > 0) {
-        lines.push(`overridden for this project: ${resolved.overrides.join(', ')}`);
+        add('warn', 'overrides', `for this project: ${resolved.overrides.join(', ')}`);
     }
     if (resolved.projectPath)
-        lines.push(`project:  ${resolved.projectPath}`);
+        add('ok', 'project', resolved.projectPath);
     // Packs, and the one place a broken one is visible. `loadPacks` never throws
     // -- a malformed file in ~/.eklavya/packs/ makes one pack unavailable, not
     // Eklavya -- so without this line the failure is a domain that quietly never
@@ -463,41 +465,45 @@ function doctor() {
     const packs = loadPacks();
     if (packs.length > 0) {
         const good = packs.filter((p) => p.pack);
-        lines.push(`packs:    ${good.length} loaded${good.length > 0
+        add('ok', 'packs', `${good.length} loaded${good.length > 0
             ? ` — ${good.map((p) => `${p.pack.pack}${p.pack.version ? `@${p.pack.version}` : ''} (${p.scope})`).join(', ')}`
             : ''}`);
         if (edgesDropped > 0) {
             // An edge endpoint naming nothing is almost always a typo, and it is
             // silent everywhere else: the pack loads, the concept appears, and the
             // prerequisite it was meant to hang off simply is not there.
-            lines.push(`packs:    ${edgesDropped} edge(s) dropped — an endpoint named a slug that does not exist`);
+            add('warn', 'packs', `${edgesDropped} edge(s) dropped — an endpoint named a slug that does not exist`);
         }
         // The one remaining way an Eklavya file ends up in a checkout, and it only
         // ever got there before the move. Named rather than fixed: a committed pack
         // is authored content somebody reviewed, so relocating it is their call.
         const inRepo = good.filter((p) => p.scope === 'repo');
         if (inRepo.length > 0) {
-            lines.push(`packs:    ${inRepo.length} still inside the checkout (${inRepo
+            add('warn', 'packs', `${inRepo.length} still inside the checkout (${inRepo
                 .map((p) => p.pack.pack)
                 .join(', ')}) — they load, but Eklavya no longer writes there;`);
-            lines.push(`packs:    move them to ~/.eklavya/projects/<checkout>/packs/ to keep the repo clean`);
+            add('warn', 'packs', dim('move them to ~/.eklavya/projects/<checkout>/packs/ to keep the repo clean'));
         }
         for (const bad of packs.filter((p) => !p.pack)) {
             // Deliberately does NOT set `ok`. A bad pack costs that pack and nothing
             // else, and the blanket remedy below is `eklavya install`, which never
             // touches ~/.eklavya/packs/ and could not repair this if it wanted to.
-            lines.push(`packs:    FAILED — ${bad.file}: ${bad.error}`);
-            lines.push(`packs:    fix or delete that file; everything else is unaffected`);
+            add('fail', 'packs', `FAILED — ${bad.file}: ${bad.error}`);
+            add('fail', 'packs', dim('fix or delete that file; everything else is unaffected'));
         }
     }
     // One fix for all of them: `install` is idempotent, so re-running it is the
     // repair. Naming it here is the whole point of the checks above — a report
     // nobody can act on is worse than no report.
-    if (!ok) {
-        lines.push('');
-        lines.push('Something is broken. Run: eklavya install');
-    }
-    process.stdout.write(`${lines.join('\n')}\n`);
+    heading('eklavya doctor');
+    // A label is said once, and its glyph again only when the state changes: a run
+    // of rows under one label reads as a block, and a failure inside it still shows.
+    rows.forEach(([mark, label, detail], i) => {
+        const prev = rows[i - 1];
+        const same = prev?.[1] === label;
+        check(same && prev[0] === mark ? null : mark, same ? '' : label, detail);
+    });
+    verdict(!ok ? 'Something is broken. Run: eklavya install' : !memoryOk ? 'Memory needs attention — see above' : null, 'ALL CLEAR · Eklavya is wired up');
     if (!ok || !memoryOk)
         process.exit(1);
 }