eklavya 1.25.3 → 1.26.0

package/dist/update.js

@@ -0,0 +1,360 @@
+/**
+ * The auto-updater: Eklavya keeps itself current the way Claude Code does —
+ * a background check at session start, an install nobody waits on, one line
+ * when it worked, and one line naming the fix when it did not.
+ *
+ * What moves, and how:
+ *
+ *   - The runtime (`~/.eklavya/runtime`) is the only thing npm installs. It is
+ *     under the user's home, so an update never needs sudo — which is why the
+ *     global `eklavya` command is not updated at all: `cli.ts` hands off to the
+ *     runtime whenever the runtime is newer, so a stale global binary runs new
+ *     code without anyone touching npm.
+ *   - Everything else `eklavya install` sets up — the plugin files, the chat
+ *     skill, the registration, the status line — is refreshed by running the
+ *     NEW runtime's own `install --auto`. One code path for a manual install and
+ *     an automatic one, so an update can never do less than an install would.
+ *     `--auto` never asks a question and never changes a setting.
+ *
+ * `update.json` beside the database is the whole state: when it last checked,
+ * which version `install` last finished for, and the last failure. The
+ * SessionStart hook reads it to decide whether to start a run and what to say;
+ * `eklavya doctor` reads it to report.
+ *
+ * Deliberately light on imports: the SessionStart hook loads this module on
+ * every session, and only `runUpdate` (in its own background process) spawns
+ * anything slow.
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { spawn, spawnSync } from 'node:child_process';
+import { eklavyaHome } from './paths.js';
+import { loadGlobalConfig } from './config.js';
+/** How often the background check runs, at most. Every session would ask npm otherwise. */
+export const CHECK_EVERY_MS = 60 * 60 * 1000;
+/** A stamp older than this is a run that died, not one in progress. Shared with `hooks/run.mjs`. */
+const STAMP_TTL_MS = 60 * 60 * 1000;
+/**
+ * `run.mjs`'s heal stamps a date, not a pid, and never removes it — its npm is
+ * detached. Past this age that npm has long finished, so the stamp is not a
+ * reason to wait out the rest of the hour.
+ */
+const HEAL_STAMP_MS = 10 * 60 * 1000;
+/** Offline is not a failure worth a line — until it has lasted this long. */
+export const OFFLINE_GRACE_MS = 7 * 24 * 60 * 60 * 1000;
+export function statePath() {
+    return path.join(eklavyaHome(), 'update.json');
+}
+export function logPath() {
+    return path.join(eklavyaHome(), 'update.log');
+}
+/** The runtime this updater owns. Never an `EKLAVYA_RUNTIME` build: that one is pinned on purpose. */
+function runtimeDir() {
+    return path.join(eklavyaHome(), 'runtime');
+}
+export function runtimeCli() {
+    return path.join(runtimeDir(), 'node_modules', 'eklavya', 'dist', 'cli.js');
+}
+export function runtimeVersion() {
+    try {
+        const pkg = path.join(runtimeDir(), 'node_modules', 'eklavya', 'package.json');
+        return JSON.parse(fs.readFileSync(pkg, 'utf8')).version ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function readState() {
+    try {
+        const value = JSON.parse(fs.readFileSync(statePath(), 'utf8'));
+        return value && typeof value === 'object' ? value : {};
+    }
+    catch {
+        return {};
+    }
+}
+/** Merges `patch` in. Never throws: losing a state write costs one extra check, not a session. */
+export function writeState(patch) {
+    try {
+        fs.mkdirSync(eklavyaHome(), { recursive: true });
+        const tmp = `${statePath()}.${process.pid}.tmp`;
+        fs.writeFileSync(tmp, `${JSON.stringify({ ...readState(), ...patch }, null, 2)}\n`);
+        fs.renameSync(tmp, statePath());
+    }
+    catch {
+        /* see above */
+    }
+}
+/** `auto_update`, from the global file only: a project cannot opt the machine out. */
+export function autoUpdateEnabled() {
+    return loadGlobalConfig().auto_update;
+}
+/** -1, 0 or 1 over the numeric parts of two versions; a prerelease tag is ignored. */
+export function compareVersions(a, b) {
+    const parts = (v) => v.split('-')[0].split('.').map((n) => Number(n) || 0);
+    const [x, y] = [parts(a), parts(b)];
+    for (let i = 0; i < Math.max(x.length, y.length); i++) {
+        const d = (x[i] ?? 0) - (y[i] ?? 0);
+        if (d !== 0)
+            return Math.sign(d);
+    }
+    return 0;
+}
+/**
+ * Should a session start a background run? Only for an installed runtime (a
+ * missing one is `run.mjs`'s heal), never under `EKLAVYA_RUNTIME`, and only
+ * when the last check is an hour old — or when the runtime moved without
+ * `install` following it, which is what the pinned heal in `run.mjs` does.
+ */
+export function updateDue(now = Date.now()) {
+    if (process.env.EKLAVYA_RUNTIME || !autoUpdateEnabled())
+        return false;
+    const installed = runtimeVersion();
+    if (!installed)
+        return false;
+    const state = readState();
+    const recent = now - (state.checked_at ? Date.parse(state.checked_at) : NaN) < CHECK_EVERY_MS;
+    // A failure waits out the hour too: a broken npm retried every session is
+    // a spawn per session for nothing.
+    return !recent || (state.applied !== installed && !state.error);
+}
+/**
+ * Starts `eklavya update --background` from the runtime, detached, when one is
+ * due. Returns at once; every failure is swallowed — the caller is a hook.
+ */
+export function startBackgroundUpdate() {
+    try {
+        if (!updateDue())
+            return;
+        fs.mkdirSync(eklavyaHome(), { recursive: true });
+        // stdio ignored: the run writes its own log, and only once it holds the
+        // claim, so a run that finds another in progress cannot wipe that log.
+        const child = spawn(process.execPath, [runtimeCli(), 'update', '--background'], {
+            detached: true,
+            stdio: 'ignore',
+            windowsHide: true,
+        });
+        // An async spawn failure lands here, after this hook has moved on. Without
+        // a listener it is an uncaught error and the hook exits 1.
+        child.on('error', () => { });
+        child.unref();
+    }
+    catch {
+        /* an update that cannot start is retried next session */
+    }
+}
+/**
+ * The one line a session shows about updates, or null. "Updated" once per
+ * version; a failure every session until it clears, like Claude Code's own —
+ * except being offline, which says nothing until it has lasted a week.
+ *
+ * `announces` is set on the "updated" line: the caller passes it to
+ * `markAnnounced` once the line has actually gone out, so a session that
+ * returns early does not swallow it.
+ */
+export function updateNotice(now = Date.now()) {
+    const state = readState();
+    if (state.error) {
+        const lastOk = state.ok_at ? Date.parse(state.ok_at) : NaN;
+        const longOffline = !(now - lastOk < OFFLINE_GRACE_MS);
+        if (state.error_class !== 'network' || longOffline) {
+            return { text: `Eklavya can't update itself · ${state.error} · run: eklavya update` };
+        }
+    }
+    const version = state.applied;
+    if (version && version !== state.announced && version === runtimeVersion()) {
+        return { text: `Eklavya updated to ${version}`, announces: version };
+    }
+    return null;
+}
+export function markAnnounced(version) {
+    writeState({ announced: version });
+}
+// --- the run ----------------------------------------------------------------
+/**
+ * The claim `hooks/run.mjs` and `installRuntime` already use, so no two npm
+ * installs ever land in the runtime at once. Taken the way `claimHeal` takes
+ * it: an exclusive create (`wx`), which only one process can win, and a stamp
+ * nobody holds any more is taken by renaming it away — again one winner — and
+ * put back if what was renamed turned out to be live.
+ */
+function claim() {
+    const stamp = path.join(runtimeDir(), '.installing');
+    const create = () => {
+        try {
+            fs.writeFileSync(stamp, String(process.pid), { flag: 'wx' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    };
+    try {
+        fs.mkdirSync(runtimeDir(), { recursive: true });
+    }
+    catch {
+        return false;
+    }
+    if (create())
+        return true;
+    try {
+        if (held(stamp))
+            return false;
+        const taken = `${stamp}.${process.pid}`;
+        fs.renameSync(stamp, taken);
+        if (held(taken)) {
+            fs.renameSync(taken, stamp);
+            return false;
+        }
+        fs.rmSync(taken, { force: true });
+    }
+    catch {
+        // Cannot read or move it, so it cannot be judged: wait for the next run.
+        return false;
+    }
+    return create();
+}
+/**
+ * Is this stamp someone's live claim? A pid stamp (this updater,
+ * `installRuntime`) is while its process runs; the heal's date stamp only for
+ * as long as its detached npm plausibly does. Nothing past the hour is.
+ */
+function held(stamp) {
+    const age = Date.now() - fs.statSync(stamp).mtimeMs;
+    if (age >= STAMP_TTL_MS)
+        return false;
+    const owner = fs.readFileSync(stamp, 'utf8').trim();
+    return /^\d+$/.test(owner) ? alive(Number(owner)) : age < HEAL_STAMP_MS;
+}
+function alive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        // EPERM: it exists, it is just not ours to signal.
+        return err.code === 'EPERM';
+    }
+}
+function release() {
+    try {
+        fs.rmSync(path.join(runtimeDir(), '.installing'), { force: true });
+    }
+    catch {
+        /* the TTL covers it */
+    }
+}
+const npm = process.platform === 'win32' ? 'npm.cmd' : 'npm';
+function run(cmd, args, timeout) {
+    return spawnSync(cmd, args, {
+        encoding: 'utf8',
+        timeout,
+        shell: process.platform === 'win32',
+        windowsHide: true,
+    });
+}
+/**
+ * The line of a failed command that says why: a Node `…Error:` line, else an
+ * npm error code (`EACCES`, `ENOTFOUND`), else the last line that is not Node's
+ * `Node.js v…` trailer.
+ */
+function lastLine(text) {
+    const lines = (text ?? '').split('\n').map((l) => l.replace(/^npm (ERR!|error)\s*/, '').trim()).filter(Boolean);
+    const why = lines.find((l) => /^[A-Za-z]*Error:/.test(l)) ??
+        lines.find((l) => /\bE[A-Z]{3,}\b/.test(l)) ??
+        lines.filter((l) => !/^Node\.js v/.test(l)).at(-1);
+    return (why ?? 'unknown error').slice(0, 160);
+}
+const NETWORK = /ENOTFOUND|EAI_AGAIN|ETIMEDOUT|ECONNREFUSED|ECONNRESET|ENETUNREACH|network|socket hang up/i;
+class UpdateError extends Error {
+    cls;
+    constructor(message, cls) {
+        super(message);
+        this.cls = cls;
+    }
+}
+/**
+ * One update run: ask npm for the latest version, install it into the runtime
+ * if it is newer, then let the runtime's own `install --auto` refresh
+ * everything else. `say` is where progress goes — nowhere in the background.
+ */
+export async function runUpdate(opts) {
+    if (opts.background && !updateDue())
+        return { status: 'skipped' };
+    if (!claim())
+        return { status: 'busy' };
+    // The background run's log is this run's alone: truncated here, after the claim.
+    const log = (text) => {
+        if (!opts.background)
+            return;
+        try {
+            fs.appendFileSync(logPath(), text);
+        }
+        catch {
+            /* a log is a courtesy */
+        }
+    };
+    if (opts.background) {
+        try {
+            fs.writeFileSync(logPath(), `${new Date().toISOString()} eklavya update\n`);
+        }
+        catch {
+            /* see above */
+        }
+    }
+    const say = (line) => {
+        log(`${line}\n`);
+        opts.say?.(line);
+    };
+    const now = new Date().toISOString();
+    const from = runtimeVersion();
+    try {
+        const view = run(npm, ['view', 'eklavya@latest', 'version'], 60_000);
+        if (view.error || view.status !== 0) {
+            const why = view.error?.message ?? lastLine(view.stderr);
+            throw new UpdateError(view.error?.code === 'ENOENT' ? 'npm not found on PATH' : `npm view failed: ${why}`, NETWORK.test(why) ? 'network' : 'npm');
+        }
+        const latest = view.stdout.trim();
+        // Anything else is npm talking (a warning on stdout, an .npmrc notice), and
+        // installing `eklavya@<that>` would fail in a way that names the wrong thing.
+        if (!/^\d+\.\d+\.\d+(-[\w.]+)?$/.test(latest)) {
+            throw new UpdateError(`npm view returned no version: ${lastLine(latest || view.stderr)}`, 'npm');
+        }
+        say(`latest ${latest}, runtime ${from ?? 'not installed'}`);
+        if (!from || compareVersions(latest, from) > 0) {
+            say(`installing eklavya@${latest}…`);
+            const install = run(npm, ['install', `eklavya@${latest}`, '--prefix', runtimeDir(), '--omit=dev', '--no-audit', '--no-fund', '--loglevel=error'], 10 * 60_000);
+            if (install.error || install.status !== 0) {
+                const why = install.error?.message ?? lastLine(install.stderr);
+                throw new UpdateError(`npm install failed: ${why}`, NETWORK.test(why) ? 'network' : 'npm');
+            }
+        }
+        const version = runtimeVersion();
+        if (!version)
+            throw new UpdateError('the runtime is missing after npm install', 'npm');
+        // The new runtime's install, so the plugin files, skill and registration
+        // match the code that will run them. Skipped when it already finished for
+        // this version: an hourly re-registration would rewrite Claude Code's files
+        // for nothing.
+        if (readState().applied !== version) {
+            say(`refreshing the plugin, skill and registration for ${version}…`);
+            const refresh = run(process.execPath, [runtimeCli(), 'install', '--auto'], 5 * 60_000);
+            log(`${refresh.stdout ?? ''}${refresh.stderr ?? ''}`);
+            if (refresh.error || refresh.status !== 0) {
+                throw new UpdateError(`eklavya install failed: ${lastLine(refresh.stderr || refresh.stdout)}`, 'install');
+            }
+        }
+        writeState({ checked_at: now, ok_at: now, latest, applied: version, error: null, error_class: null });
+        return from === version ? { status: 'current', version } : { status: 'updated', from, to: version };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        log(`failed: ${error}\n`);
+        writeState({ checked_at: now, error, error_class: err instanceof UpdateError ? err.cls : 'install' });
+        return { status: 'failed', error };
+    }
+    finally {
+        release();
+    }
+}
+//# sourceMappingURL=update.js.map

package/dist/update.js.map

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

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

@@ -1,6 +1,6 @@
 ---
 name: eklavya
-description: "Operate Eklavya, the local memory and learning tool that records what this developer's agent did and quizzes them on it. Use when the user mentions Eklavya by name, asks what Eklavya remembers about a project or whether it is still capturing, or asks to change how often or how hard it quizzes them (its quiz, focus, cadence or difficulty dials), see their learning progress or mastery, open the dashboard, check the commit gate, or find where their data lives. Do not use for ordinary coding help, for teaching a concept, or merely because a task is educational."
+description: "Operate Eklavya, the local memory and learning tool that records what this developer's agent did and quizzes them on it. Use when the user mentions Eklavya by name, asks what Eklavya remembers about a project or whether it is still capturing, or asks to change how often or how hard it quizzes them (its quiz, focus, cadence or difficulty dials), see their learning progress or mastery, open the dashboard, check the commit gate, update Eklavya, or find where their data lives. Do not use for ordinary coding help, for teaching a concept, or merely because a task is educational."
 ---
 
 # Eklavya
@@ -222,6 +222,15 @@ 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`.
 
+**Updates are automatic.** Eklavya checks npm at session start, at most hourly,
+and installs a newer release on its own, settings untouched. So "update
+Eklavya" needs nothing, and if they want it now, run `eklavya update`. If
+session start said `Eklavya can't update itself · <reason> · run: eklavya
+update`, run `eklavya update` to see the full error, and `doctor`'s `updates`
+row says the same. Never suggest `npm install -g eklavya` for an update: the
+`eklavya` command already runs the newer runtime's copy on its own.
+`auto_update false` turns updates off, globally only.
+
 Restarting Claude Code is what picks up a repaired install — the plugin and MCP
 server are read at session start. There is no background process to restart.
 

package/package.json

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