eklavya 1.18.3 → 1.19.1

package/dist/packs.js

@@ -8,23 +8,31 @@
  * mid-session. A pack is the same file shape, loaded from two places Eklavya
  * does not own:
  *
- *   ~/.eklavya/packs/*.json        the learner's own, and anything installed
- *   <repo>/.eklavya/packs/*.json   a team's, versioned with the codebase
+ *   ~/.eklavya/packs/*.json                      yours, everywhere
+ *   ~/.eklavya/projects/<slug>/packs/*.json      yours, on one codebase
+ *   <repo>/.eklavya/packs/*.json                 read-only, the pre-move home
  *
- * The second is the interesting one. A repository that ships its own concepts
- * and prerequisites is describing itself to a new joiner, which is onboarding
- * rather than quizzing.
+ * The second is the interesting one. A pack that describes a codebase's own
+ * concepts and prerequisites is onboarding rather than quizzing.
+ *
+ * It used to be the third, committed alongside the code, and that was the last
+ * thing Eklavya wrote into a repository. The argument for it was real — unlike
+ * settings, a concept graph genuinely is the same for everyone — but it lost to
+ * a simpler rule: Eklavya creates no files in your project. The old directory is
+ * still **read**, so a repository that already ships a pack keeps working, and
+ * nothing deletes it: a committed pack is authored content somebody reviewed,
+ * which is not ours to relocate. Only the writers moved.
  *
  * Packs are applied AFTER the seed and merged over it, so a pack may retier or
- * rename a shipped concept, and a repo pack wins over a global one. Nothing
+ * rename a shipped concept, and a project pack wins over a global one. Nothing
  * here touches `mastery`: the seed's rule is the pack's rule, and a learner's
  * history survives any pack being installed, edited or deleted.
  */
 import fs from 'node:fs';
 import path from 'node:path';
 import crypto from 'node:crypto';
-import { eklavyaHome } from './paths.js';
-import { findRepoConfig } from './config.js';
+import { eklavyaHome, projectPacksDir } from './paths.js';
+import { findRepoConfig, mainRepoRoot } from './config.js';
 import { applySeedGraph, validateSeedGraph, SEED_VERSION } from './seed.js';
 /**
  * One row per set of pack directories, not one row for the install.
@@ -38,17 +46,23 @@ export function packFingerprintKey(dirs) {
     return `packs_fingerprint:${crypto.createHash('sha256').update(dirs.join('\n')).digest('hex').slice(0, 16)}`;
 }
 /**
- * Global first, repo second, because later wins. `packs/` under both, so the
- * rule is one sentence: packs live in a `packs/` directory next to Eklavya's
- * state, whether that state is yours or the repository's.
+ * Global first, then the project's, because later wins.
+ *
+ * The legacy in-repo directory sits between them: after global, so a pack a
+ * repository already ships still overrides your own, and before the project
+ * directory, so moving a pack out of the checkout takes effect rather than
+ * being silently outranked by the copy left behind.
  */
 export function packDirs(cwd = process.cwd()) {
     const dirs = [
         { dir: path.join(eklavyaHome(), 'packs'), scope: 'global' },
     ];
     const { repoRoot } = findRepoConfig(cwd);
-    if (repoRoot)
+    if (repoRoot) {
+        const project = mainRepoRoot(repoRoot);
         dirs.push({ dir: path.join(repoRoot, '.eklavya', 'packs'), scope: 'repo' });
+        dirs.push({ dir: projectPacksDir(project), scope: 'project' });
+    }
     return dirs;
 }
 function listPackFiles(dir) {

package/dist/packs.js.map

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

package/dist/paths.js

@@ -22,4 +22,64 @@ export function migrationsDir() {
 export function seedDir() {
     return path.join(moduleDir, 'seed');
 }
+/**
+ * Per-project settings, kept **outside** the checkout.
+ *
+ * Eklavya used to read `<repo>/.eklavya.json`, a file you committed. That was
+ * wrong in the ordinary case: a project's settings are how *you* want to be
+ * taught in that codebase, and a committed file makes one person's choice
+ * everybody's. It also made every clone a configuration file from a stranger,
+ * which cost a whole security boundary to contain.
+ *
+ * So project settings live beside the global ones, keyed by the checkout's
+ * absolute path, the way `~/.claude/projects/` does it:
+ *
+ *   ~/.eklavya/config.json                         you, everywhere
+ *   ~/.eklavya/projects/<slug>/config.json         you, on one project
+ *
+ * Nothing Eklavya writes ever lands in a repository again — concept packs
+ * included; see `projectPacksDir` below, which moved for the same reason. The
+ * pre-move directories are still *read* so nothing breaks on upgrade, and the
+ * settings file is deleted from the checkout while a pack is not, because a
+ * committed pack is authored content somebody reviewed.
+ */
+export function projectsDir() {
+    return path.join(eklavyaHome(), 'projects');
+}
+/**
+ * The directory name for a checkout: its absolute path with the separators
+ * turned into dashes, which is what `~/.claude/projects/` does and what makes
+ * the directory identifiable at a glance. Readability is the whole point —
+ * somebody looking for "the settings for this repo" has to be able to find
+ * them without a lookup table.
+ *
+ * It is lossy, and deliberately so: `/a/b-c` and `/a-b/c` both slug to
+ * `-a-b-c`. The collision is caught rather than avoided — `projectConfigPath`'s
+ * file records the path it belongs to, and `loadConfig` ignores a file whose
+ * `project` names a different checkout. A rare wrong-directory read is worth a
+ * name you can recognise; a silent one would not be.
+ */
+export function projectSlug(repoRoot) {
+    return repoRoot.replace(/[/\\:]/g, '-');
+}
+export function projectConfigPath(repoRoot) {
+    return path.join(projectsDir(), projectSlug(repoRoot), 'config.json');
+}
+/**
+ * A project's concept packs, kept outside the checkout like its settings.
+ *
+ * Packs used to live at `<repo>/.eklavya/packs/`, committed, and that was the
+ * last thing Eklavya wrote into a repository. The argument for keeping them
+ * there was real — a pack is a shared concept graph, the same for everyone —
+ * but it lost to a simpler rule: Eklavya creates no files in your project.
+ *
+ * `loadPacks` still *reads* the old location, so a repository that already
+ * ships one keeps working, and nothing deletes it. That asymmetry with the
+ * settings file is deliberate: a settings file was a mistake to undo, while a
+ * committed pack is authored content somebody reviewed, and relocating it is
+ * their decision rather than ours.
+ */
+export function projectPacksDir(repoRoot) {
+    return path.join(projectsDir(), projectSlug(repoRoot), 'packs');
+}
 //# sourceMappingURL=paths.js.map

package/dist/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,CAAC;AACjD,CAAC;AAED,0EAA0E;AAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../src/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,MAAM;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,cAAc,CAAC,CAAC;AAC5E,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,CAAC;AACjD,CAAC;AAED,0EAA0E;AAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE/D,MAAM,UAAU,aAAa;IAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,WAAW,CAAC,QAAgB;IAC1C,OAAO,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC;AACxE,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,QAAgB;IAC9C,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,WAAW,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC;AAClE,CAAC"}

package/dist/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "eklavya",
   "displayName": "Eklavya",
-  "version": "1.18.3",
+  "version": "1.19.1",
   "description": "Learn while your agent works. Turns coding-agent generation time into adaptive, Socratic learning grounded in the code being written.",
   "author": {
     "name": "Ajay Kumar"

package/dist/plugin/agents/tutor.md

@@ -1,7 +1,7 @@
 ---
 name: eklavya-tutor
 description: Teaches the developer the concepts behind work being done, using the Eklavya knowledge graph. Use when you want tutoring to run alongside implementation rather than after it, or when the main thread is busy building and someone should be explaining.
-tools: Read, Grep, Glob, mcp__plugin_eklavya_eklavya__get_learner_profile, mcp__plugin_eklavya_eklavya__get_session_quiz_plan, mcp__plugin_eklavya_eklavya__record_attempt, mcp__plugin_eklavya_eklavya__get_concept_graph, mcp__plugin_eklavya_eklavya__upsert_concepts, mcp__plugin_eklavya_eklavya__get_gate_status, mcp__eklavya__get_learner_profile, mcp__eklavya__get_session_quiz_plan, mcp__eklavya__record_attempt, mcp__eklavya__get_concept_graph, mcp__eklavya__upsert_concepts, mcp__eklavya__get_gate_status
+tools: Read, Grep, Glob, mcp__plugin_eklavya_eklavya__get_learner_profile, mcp__plugin_eklavya_eklavya__get_session_quiz_plan, mcp__plugin_eklavya_eklavya__record_attempt, mcp__plugin_eklavya_eklavya__get_concept_graph, mcp__plugin_eklavya_eklavya__upsert_concepts, mcp__plugin_eklavya_eklavya__get_gate_status, mcp__plugin_eklavya_eklavya__memory_search, mcp__plugin_eklavya_eklavya__memory_get, mcp__plugin_eklavya_eklavya__memory_file_history, mcp__eklavya__get_learner_profile, mcp__eklavya__get_session_quiz_plan, mcp__eklavya__record_attempt, mcp__eklavya__get_concept_graph, mcp__eklavya__upsert_concepts, mcp__eklavya__get_gate_status, mcp__eklavya__memory_search, mcp__eklavya__memory_get, mcp__eklavya__memory_file_history
 ---
 
 You are Eklavya's tutor, running as a separate agent while implementation happens elsewhere.
@@ -10,6 +10,8 @@ Follow the `tutor` skill for all pedagogy — profile first, one question at a t
 
 Note that "grounded in real code" is `project` focus, not a universal rule: in `concept` focus the plan hands you `context: null` deliberately, and quoting the diff back defeats the point. Read `framing` before writing a question.
 
+You also have the read-only memory tools, and in parallel they matter more than they do in the main thread: you cannot see the conversation the developer is having, so the project's recorded history is the only way you know what this codebase has actually done. `references/focus-and-level.md` has the rule for using it — briefly, and only when the plan left you without a concrete example.
+
 ## Why the tool list is spelled twice
 
 An MCP server provided by a plugin is namespaced: its tools resolve as

package/dist/plugin/cli/CLAUDE.md

@@ -20,10 +20,22 @@ between the `# >>> eklavya gate >>>` markers, and if a `pre-commit` already
 existed it moves it to `pre-commit.local` and chains it first. `--uninstall`
 restores it.
 
-Then the script itself only acts on a repo whose `.eklavya.json` sets
-`"mode": "enforced"`. Note that it reads **only** the repo file — not
-`~/.eklavya/config.json` — so a globally enforced mode does not gate a bare
-terminal. Any doc claiming a terminal commit is gated has to attach the installer
+Then the script itself only acts on a project whose config sets `quiz.enforced`
+(or the retired `"mode": "enforced"`, which it still reads). That config is at
+`~/.eklavya/projects/<slug>/config.json` — the script rebuilds the slug itself,
+in shell, from `git rev-parse --show-toplevel` folded to the main checkout via
+`--git-common-dir`, because a worktree shares its parent's settings. Note that it
+reads enforcement from **only** the project file — not `~/.eklavya/config.json` —
+so a globally set gate does not hold a bare terminal. The global file is read for
+one thing: a `quiz.enabled: false` (or `mode: off`) there, not overridden by the
+project, releases the gate, exactly as `coerce()` does — otherwise a terminal
+commit is held by a gate no quiz will ever run to clear. The slug path is built
+with `pwd -P` so a checkout reached through a symlink still finds its file.
+
+It reads `<repo>/.eklavya.json` as a fallback and does **not** migrate it. The
+node half moves that file out automatically; a git pre-commit hook is the wrong
+place to start rewriting somebody's working tree, so it reads the old location
+and lets the next ordinary session do the move. Any doc claiming a terminal commit is gated has to attach the installer
 step and the repo config; `web/src/content/docs/docs/commit-gate.mdx` and
 `skills/setup/SKILL.md` are where that lives.
 
@@ -33,10 +45,12 @@ A learning tool that bricks commits gets uninstalled, and an unpassable gate
 teaches nothing. Every one of these exits 0:
 
 - not inside a git repo, or `git rev-parse` fails;
-- no `.eklavya.json` in the repo root;
+- no config for this project, at either the current or the legacy location;
 - `jq` not on PATH (warns on stderr) — **or** `sqlite3` not on PATH (warns too).
   It needs both, not just `jq`;
-- `mode` is anything but `enforced`;
+- the config does not ask for enforcement — `quiz.enforced` false or absent with
+  no `mode: enforced` behind it, or `quiz.enabled` false — in the project file,
+  or in the global one when the project does not say;
 - the database file does not exist;
 - the `sqlite3` query errors, or returns no gate row for this repo.
 
@@ -51,8 +65,18 @@ SQL and duplicates things it cannot import. Keep it in step with:
 - the `gates` table shape — it selects `passed, required, answered` and picks the
   repo's most recent row by `updated_at`. `syncGate` in `mcp/src/store.ts` is the
   only writer; a renamed or added column lands here in the same commit.
-- `DEFAULT_CONFIG.mode` in `mcp/src/config.ts` — the script hardcodes `"ambient"`
-  as jq's fallback for a `.eklavya.json` with no `mode`.
+- `DEFAULT_CONFIG.quiz` in `mcp/src/config.ts` — the script defaults a config
+  with neither `quiz` nor `mode` to unenforced.
+- `projectSlug` in `mcp/src/paths.ts` — the script rebuilds it with
+  `tr '/\\:' '-'`, and `test/gate.test.ts` runs both parsers over one set of
+  configs so the two cannot drift apart silently.
+- the `mode` → `quiz` alias in `normalizeLegacyKeys`, and the rule that
+  `quiz.enabled: false` forces `enforced` off. Both are duplicated here in jq,
+  spelled out with `if`/`elif` rather than `//`: jq's `//` is an alternative
+  operator, so `.quiz.enforced // (.mode == "enforced")` reads an explicit
+  `false` as unset and falls back to a stale `mode` in the same file — a gate
+  that keeps holding commits after somebody switched it off.
+  `test/gate.test.ts` runs both parsers over the same five configs.
 
 The pass/fail arithmetic itself (`PASSING_GRADE`, `pass_threshold`,
 `ceil(required * pass_threshold)`) is **not** duplicated here — the script trusts

package/dist/plugin/cli/eklavya-gate

@@ -9,10 +9,24 @@
 # bricks commits when a dependency is absent gets uninstalled, and an unpassable
 # gate teaches nothing.
 #
-# It reads the repo's .eklavya.json and nothing else -- never ~/.eklavya/config.json.
-# That is deliberate: a git hook installed once must not start blocking commits
-# because someone flipped a global setting. Gating a repo is a per-repo decision,
-# stated in a file the repo can see.
+# Enforcement is read from this project's config only -- never from
+# ~/.eklavya/config.json. That is deliberate: a git hook installed once must not
+# start blocking commits because someone flipped a global setting. Gating a
+# codebase is a per-project decision, stated in that project's own file. The
+# global file is consulted for one thing: a `quiz.enabled: false` there switches
+# the questions off, and a gate nothing can pass must not hold.
+#
+# That file used to be <repo>/.eklavya.json, committed. It is not any more: a
+# project's settings say how *you* want to be taught in that codebase, and a
+# committed file made one person's choice everybody's. They now live at
+# ~/.eklavya/projects/<checkout path with separators as dashes>/config.json,
+# alongside the global config and keyed the way ~/.claude/projects/ keys its own.
+# Nothing Eklavya writes lands in a checkout.
+#
+# The node half migrates a leftover .eklavya.json out of the repo automatically.
+# This script does not -- a git pre-commit hook is the wrong place to start
+# rewriting somebody's working tree -- so it reads the legacy file as a fallback
+# and lets the next ordinary session do the move.
 
 set -u
 
@@ -22,8 +36,37 @@ eklavya_db()   { printf '%s' "${EKLAVYA_DB:-$(eklavya_home)/knowledge.db}"; }
 REPO=$(git rev-parse --show-toplevel 2>/dev/null) || exit 0
 [ -n "$REPO" ] || exit 0
 
-# Only repos that explicitly opt in are gated.
-CONFIG="$REPO/.eklavya.json"
+# A linked worktree is a branch of the same codebase, not a project to configure
+# again -- the same fold `mainRepoRoot` applies on the node side. `--git-common-dir`
+# points at the main checkout's .git for a worktree and at this one's otherwise,
+# so stripping the trailing /.git yields the checkout that owns the settings.
+#
+# `--path-format=absolute` would be the obvious way to ask, and is deliberately
+# not used: it needs git >= 2.31, and on anything older the whole `rev-parse`
+# fails, the slug misses, and the gate fails open in every linked worktree --
+# enforcement somebody was promised, silently not happening. Plain
+# `--git-common-dir` has been there for years and answers relative to the
+# current directory, so the relative case is resolved by hand.
+#
+# Resolved with `pwd -P`, never `$(pwd)/...`: in a hook `pwd` echoes the `PWD`
+# the shell handed down, which is the symlinked spelling when the repo was
+# reached through one (macOS's /tmp, a symlinked ~/code). The node side keys on
+# the real path, so a symlinked prefix misses the slug and the gate fails open.
+PROJECT="$REPO"
+COMMON=$(git rev-parse --git-common-dir 2>/dev/null) || COMMON=''
+[ -n "$COMMON" ] && COMMON=$(cd "$COMMON" 2>/dev/null && pwd -P) || COMMON=''
+case "$COMMON" in
+  */.git) CANDIDATE=${COMMON%/.git}; [ -d "$CANDIDATE" ] && PROJECT="$CANDIDATE" ;;
+esac
+
+# The slug `projectSlug` builds: the absolute path with separators as dashes.
+SLUG=$(printf '%s' "$PROJECT" | tr '/\\:' '-')
+CONFIG="$(eklavya_home)/projects/$SLUG/config.json"
+
+# The pre-move location, read only while a checkout still has one.
+[ -f "$CONFIG" ] || CONFIG="$REPO/.eklavya.json"
+
+# Only projects that explicitly opt in are gated.
 [ -f "$CONFIG" ] || exit 0
 
 if ! command -v jq >/dev/null 2>&1; then
@@ -35,8 +78,36 @@ if ! command -v sqlite3 >/dev/null 2>&1; then
   exit 0
 fi
 
-MODE=$(jq -r '.mode // "ambient"' "$CONFIG" 2>/dev/null) || exit 0
-[ "$MODE" = "enforced" ] || exit 0
+# `quiz.enforced`, with the retired `mode` dial honoured as a fallback -- this
+# script meets configs written years before it.
+#
+# Spelled out with if/elif rather than jq's `//`, which is an alternative
+# operator and not a null-coalescing one: `false // X` evaluates to X, so the
+# obvious `.quiz.enforced // (.mode == "enforced")` would read an explicit
+# `"enforced": false` as unset and fall through to a stale `mode` left in the
+# same file. That is a gate holding commits after somebody switched it off.
+#
+ENFORCED=$(jq -r '
+  if .quiz.enforced != null then .quiz.enforced
+  else (.mode == "enforced") end
+' "$CONFIG" 2>/dev/null) || exit 0
+[ "$ENFORCED" = "true" ] || exit 0
+
+# `quiz.enabled`, resolved the way `coerce()` resolves it: project over global,
+# `mode` per file. A gate with no questions behind it can never be passed, so
+# it must not hold -- and the switch that silences the questions may well be in
+# the global file. This is the one thing read from there: the global config can
+# release this gate, never impose one.
+QUIZ_ENABLED='
+  if .quiz.enabled != null then .quiz.enabled
+  elif .mode == "off" then false
+  elif .mode == "ambient" or .mode == "enforced" then true
+  else null end'
+ENABLED=$(jq -r "$QUIZ_ENABLED" "$CONFIG" 2>/dev/null) || exit 0
+if [ "$ENABLED" = "null" ] && [ -f "$(eklavya_home)/config.json" ]; then
+  ENABLED=$(jq -r "$QUIZ_ENABLED" "$(eklavya_home)/config.json" 2>/dev/null) || exit 0
+fi
+[ "$ENABLED" = "false" ] && exit 0
 
 DB=$(eklavya_db)
 [ -f "$DB" ] || exit 0
@@ -70,7 +141,7 @@ cat >&2 <<EOF
   Open Claude Code in this repo and run /eklavya:quiz to finish, then commit again.
 
   To see what is outstanding:  /eklavya:gate
-  To turn this off for the repo, set "mode" to "ambient" in .eklavya.json
+  To turn this off:  eklavya config set quiz.enforced false --project
 
 EOF
 exit 1

package/dist/plugin/hooks/CLAUDE.md

@@ -30,18 +30,42 @@ triple in here, even in a comment, fails that test on purpose.
 `scripts/bump-version.sh` bumps `plugin.json` and `mcp/package.json`, nothing
 else.
 
-## The six hooks, out of `hooks.json`
+## The seven hooks, out of `hooks.json`
 
 | Event | Matcher | Timeout | Script | Job |
 |---|---|---|---|---|
-| SessionStart | — | 10s | `session-start` | stamp this checkout's session pointer (`meta.current_session:<repo root>`), print the profile banner and the standing log directive |
+| SessionStart | — | 10s | `session-start` | stamp this checkout's session pointer (`meta.current_session:<repo root>`), replay the spool, summarise the last session's batch, recall this project's memory, print the profile banner and the standing log directive |
 | UserPromptSubmit | — | 10s | `prompt-submit-nudge` | re-stamp this checkout's session pointer, then re-state the log directive in one line, but only for a session that has logged nothing after a grace window |
 | SubagentStart | — | 10s | `subagent-start` | give a delegated agent the log directive the parent's SessionStart never reached it with |
-| PreToolUse | `Bash` | 10s | `pre-tool-gate` | in `enforced` mode only, deny a `git commit` whose session gate has not passed |
+| PreToolUse | `Bash` | 10s | `pre-tool-gate` | with `quiz.enforced` only, deny a `git commit` whose session gate has not passed |
+| PostToolUse | — | 10s | `capture-tool` | record the tool use as memory evidence |
 | PostToolUse | `mcp__.*log_session_concepts` | 10s | `checkpoint-quiz` | one mid-task question, `interleaved` cadence only |
 | Stop | — | 15s | `stop-quiz-check` | block the turn and demand a quiz |
 
-The PostToolUse matcher is a regex over the MCP tool name, not a literal, because
+## Memory capture is not governed by `quiz`
+
+`capture-tool` has no matcher, so it runs after **every** tool call — it is the
+hook that fires most often in a session, and it does the least: resolve
+identity, normalise one event, one insert, exit. It never quizzes, summarises
+or calls a provider.
+
+Four hooks now carry memory work, and all four do it **before** their `quiz`
+check, because `memory.enabled` is a separate decision from the learning dials
+(PRD CFG-01): `quiz.enabled: false` means no quizzes, not no project history.
+That separation is why the `mode` dial was retired — it was always true and the
+word `off` denied it, so `session-start` now says on screen which half stopped.
+`session-start` replays the spool and recalls; `prompt-submit-nudge` captures
+the prompt; `capture-tool` captures the tool use; `stop-quiz-check` closes the
+batch at the seam. `mcp/src/hooks/memory-lib.ts` holds the shared helpers, and
+every one of them swallows its own failures — a capture path that throws is a
+throw on every tool call.
+
+The seam never waits on inference. With `providers.observer` configured,
+`flushAtSeam` queues the batch and returns; the next session start, or
+`eklavya memory process`, drains it. A Stop hook that waits on an API call is
+exactly what PRD LRN-04 forbids.
+
+The PostToolUse matcher on `checkpoint-quiz` is a regex over the MCP tool name, not a literal, because
 the prefix depends on how the plugin was installed —
 `mcp__eklavya__log_session_concepts` standalone,
 `mcp__plugin_eklavya_eklavya__log_session_concepts` via `/plugin`. `mcp__.*`
@@ -171,20 +195,21 @@ reads rather than output anyone sees.
 
 That was a bug for a while, and a bad one: `session-start` returned before
 pushing the directive, so a developer who turned the greeting off logged
-nothing, was never quizzed, and saw `mode: ambient` in `get_config` the whole
-time. Two tests encoded it as intended behaviour. `mode: off` is the off switch
-— along with its session-scoped twin below, which is the same switch with a
-shorter life.
-
-## The Stop hook blocks in `ambient` too
-
-Commonly got wrong. `ambient` is not "never interrupts" — `stop-quiz-check.ts`
-returns 2 in ambient as readily as in enforced. `enforced` changes three things:
-the `min_minutes_between_quizzes` cooldown is skipped (a cooldown could make a
-commit gate unpassable — decision G5); the one-question cap under `interleaved`
-is lifted, so the sweep asks for the whole remaining budget; and `pre-tool-gate`
-plus `cli/eklavya-gate` start holding commits. Only `mode === 'off'` silences
-everything.
+nothing, was never quizzed, and saw quizzing reported as enabled in
+`get_config` the whole time. Two tests encoded it as intended behaviour.
+`quiz.enabled: false` is the off switch — along with its session-scoped twin
+below, which is the same switch with a shorter life.
+
+## The Stop hook blocks when unenforced too
+
+Commonly got wrong. Unenforced is not "never interrupts" — `stop-quiz-check.ts`
+returns 2 without the gate as readily as with it. `quiz.enforced` changes three
+things: the `min_minutes_between_quizzes` cooldown is skipped (a cooldown could
+make a commit gate unpassable — decision G5); the one-question cap under
+`interleaved` is lifted, so the sweep asks for the whole remaining budget; and
+`pre-tool-gate` plus `cli/eklavya-gate` start holding commits. Only
+`quiz.enabled: false` silences the questions — and it silences only those, not
+the memory half.
 
 ## The per-session off switch
 
@@ -198,7 +223,7 @@ config file has quietly turned the product off for good.
 
 Two rules it is easy to get wrong:
 
-- It silences, it does not exempt. `cli/eklavya-gate` reads `.eklavya.json` and
+- It silences, it does not exempt. `cli/eklavya-gate` reads the project config and
   never sees a session id, so an enforced repo still holds the commit. Making
   the gate honour it would turn a per-session convenience into a gate bypass.
   `pre-tool-gate` reads `isSessionOff` for one reason only: its refusal tells

package/dist/plugin/hooks/hooks.json

@@ -51,6 +51,16 @@
       }
     ],
     "PostToolUse": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node",
+            "args": ["${CLAUDE_PLUGIN_ROOT}/hooks/run.mjs", "capture-tool"],
+            "timeout": 10
+          }
+        ]
+      },
       {
         "matcher": "mcp__.*log_session_concepts",
         "hooks": [

package/dist/plugin/scripts/install-git-hook.sh

@@ -78,4 +78,5 @@ EOF
 
 chmod +x "$HOOK"
 printf 'Installed the Eklavya commit gate in %s\n' "$HOOK"
-printf 'It only acts on repositories whose .eklavya.json sets "mode": "enforced".\n'
+printf 'It only acts on projects whose config sets quiz.enforced. That config lives at\n'
+printf '~/.eklavya/projects/<checkout>/config.json, never inside the repository.\n'

package/dist/plugin/skills/CLAUDE.md

@@ -11,9 +11,9 @@ One directory, one `SKILL.md`, YAML frontmatter with `name` and `description`.
 `/eklavya:<name>` slash command** — the model can no longer load it on its own,
 and the developer types it. Without that line the skill is model-invocable only.
 
-Eight have it, and they are the eight slash commands:
+Nine have it, and they are the nine slash commands:
 
-`gate`, `learn`, `level`, `mode`, `pack`, `progress`, `quiz`, `setup`.
+`gate`, `learn`, `level`, `memory`, `mode`, `pack`, `progress`, `quiz`, `setup`.
 
 `skills/tutor/SKILL.md` deliberately does not. It is the pedagogy — one
 question at a time, honest grading, never the same question twice — and every
@@ -64,10 +64,18 @@ by what it is, not loaded by trigger.
 
 ## A skill is a prompt, but it is also an API client
 
-Nine tools, all in `mcp/src/tools/`: `get_learner_profile`,
-`log_session_concepts`, `get_session_quiz_plan`, `record_attempt`,
-`get_gate_status`, `upsert_concepts`, `get_concept_graph`, `get_config`,
-`set_config`.
+Twenty tools, all in `mcp/src/tools/`. Nine for learning:
+`get_learner_profile`, `log_session_concepts`, `get_session_quiz_plan`,
+`record_attempt`, `get_gate_status`, `upsert_concepts`, `get_concept_graph`,
+`get_config`, `set_config`. Eleven for memory: `memory_search`, `memory_get`,
+`memory_timeline`, `memory_file_history`, `memory_status`, `memory_write`,
+`memory_correct`, `memory_delete`, `memory_collections`, `code_outline`,
+`code_find_symbol`.
+
+The memory tools are two-stage on purpose: the index tools return identifiers
+and titles, and `memory_get` is the only one that returns a narrative. A skill
+that tells the model to hydrate everything a search returned spends exactly
+the context the feature exists to save. Say "search, choose, then get".
 
 **Before you write "call `X` with `Y`", open `mcp/src/tools/<X>.ts`.** Check
 `Y` is in the `inputSchema`, and check the field you are telling the model to
@@ -75,7 +83,9 @@ read is in what the handler returns. A skill that names a field the server
 never returns fails silently — the model improvises a plausible value and the
 developer sees a confident number nobody computed.
 
-`config_tools.ts` holds `get_config` and `set_config`; the rest are one file
+`config_tools.ts` holds `get_config` and `set_config`, and the memory tools are
+grouped the same way — `memory_read_tools.ts`, `memory_write_tools.ts`,
+`code_tools.ts`, `collection_tools.ts`. The nine learning tools are one file
 per tool name.
 
 ### Not every tool takes `session_id`
@@ -96,16 +106,16 @@ Check every one of these against the code when you touch a skill.
   write it: `grep -rn 'focus' skills/ user-skill/ agents/`.
 - **The `interleaved` one-question cap has exemptions.** In
   `mcp/src/tools/get_session_quiz_plan.ts`:
-  `capped = cadence === 'interleaved' && mode !== 'enforced' && !explicitTopic`,
+  `capped = cadence === 'interleaved' && !quiz.enforced && !explicitTopic`,
   and then `max = args.max ?? (capped ? 1 : max_questions_per_task)`.
-  So `enforced` mode is exempt, an explicit `domain` or `slugs` is exempt, and
+  So `quiz.enforced` is exempt, an explicit `domain` or `slugs` is exempt, and
   an explicit `max` wins outright because it is read first. Read that code
   rather than trusting prose about it — including this paragraph.
-- **The Stop hook blocks in `ambient` too.** `mcp/src/hooks/stop-quiz-check.ts`
-  blocks in both modes; what `enforced` changes is that it skips the
+- **The Stop hook blocks when unenforced too.** `mcp/src/hooks/stop-quiz-check.ts`
+  blocks either way; what `quiz.enforced` changes is that it skips the
   `min_minutes_between_quizzes` cooldown, takes the whole remaining budget
-  instead of one question, and gates commits. Do not write "ambient never
-  interrupts".
+  instead of one question, and gates commits. Do not write "it never
+  interrupts unless enforced".
 - **`get_learner_profile`'s lists are capped, and `known` is ordered by score.**
   `LIST_CAP = 8` covers `weak`, `due_for_review`, `projects`,
   `recent_concepts` and `skipped`; `KNOWN_CAP = 30` covers `known`, with the
@@ -120,14 +130,16 @@ Check every one of these against the code when you touch a skill.
 
 Until 1.14 every plan item carried `ask_header` and the tutor printed it above
 the question: `[mode: ambient · focus: concept · level: easy · tier: 2
-mechanism]`. It existed for a real reason — on `concept` focus a deliberately
+mechanism]` — in the vocabulary of the day, when a single `mode` dial still
+existed. It existed for a real reason — on `concept` focus a deliberately
 transferable question reads as a vague one, and on `easy` a tier-2 question
 reads as shallow rather than as a runway — but it spent four settings' worth of
 screen above *every* stem to say something that is true for the whole session.
 
 Ambient state belongs somewhere ambient. `statusLine` in `mcp/src/statusline.ts`
-composes `[EKLAVYA ambient · concept · interleaved · easy]` for
-`eklavya statusline`, which the host's status bar runs. `askHeader` is deleted,
+composes `[EKLAVYA concept · interleaved · easy]` for `eklavya statusline`,
+which the host's status bar runs — with `enforced` prepended only when it is
+set, since a segment that is always there is a segment nobody reads. `askHeader` is deleted,
 the plan no longer carries `ask_header`, and both hooks now say *ask the stem on
 its own*.
 
@@ -277,7 +289,7 @@ renderers that lack it.
 ## Consistency
 
 The same behaviour described in two skills has drifted apart before — that is
-how `focus: project` got into three files. The four dials appear in
+how `focus: project` got into three files. The dials appear in
 `skills/mode/SKILL.md` and `user-skill/eklavya/SKILL.md`; the level bands
 appear in `skills/level/SKILL.md` and `tutor/references/focus-and-level.md`;
 the cadence cap appears in `mode`, `quiz` and that same reference. **When you

package/dist/plugin/skills/gate/SKILL.md

@@ -8,7 +8,7 @@ disable-model-invocation: true
 
 Call `get_gate_status` and report it in a few lines:
 
-- Mode. If it is not `enforced`, say that nothing is gated and stop.
+- Whether `quiz.enforced` is set. If it is not, say that nothing is gated and stop.
 - `passed_count` of `needed` passing answers, out of `required` concepts.
 - Passed or not.
 

package/dist/plugin/skills/level/SKILL.md

@@ -29,7 +29,7 @@ Report it in three lines or fewer:
 - **The runway** — `passed`/`needed` passing answers, plus whichever other condition is still short (accuracy, or distinct concepts). Say the number; a progress bar nobody can total is not progress.
 - **What is next** — the band above, and what changes about the questions when they reach it. If they are on `hard`, say that this is the top and the tier ladder keeps working inside it.
 
-If `pinned` is set, say who pinned it (global config or this repo's `.eklavya.json`) and that nothing will promote while it stands. Do not report a runway toward a level a pin makes unreachable.
+If `pinned` is set, say where it was pinned (their global config or their settings for this project) and that nothing will promote while it stands. Do not report a runway toward a level a pin makes unreachable.
 
 ## With an argument
 
@@ -41,11 +41,11 @@ If `pinned` is set, say who pinned it (global config or this repo's `.eklavya.js
 Scope, and ask when it is ambiguous:
 
 - **global** (default) — their own setting on every project. `hard` here is a senior saying they do not want the runway.
-- **repo** — `.eklavya.json` at the root, and it beats global for **everyone** working in that project. `easy` here is an onboarding codebase that stays gentle whoever opens it.
+- **project** — `~/.eklavya/projects/<checkout>/config.json`, and it beats global whenever *they* work in that codebase. `easy` here is a codebase they are new to and want kept gentle. It is in their home directory, not the repository, so it reaches nobody else.
 
 Two things to say plainly before writing:
 
-- Pinning at repo scope overrides every contributor's personal setting in that project.
+- Pinning at project scope overrides their own global setting in that codebase, and nobody else's.
 - Pinning `hard` on a codebase someone has just met is the failure levels exist to prevent. If they are pinning up because the questions feel trivial, check the level first — they may simply be near a promotion.
 
 ## Confirm