Updates

kernel/README.md

@@ -14,7 +14,7 @@ Files in this directory are **read from disk by the seeder** (or copied into `pa
 
 ## Contents
 
-- **`init.js`** — Kernel entry: must define `async function start(ctx)`. Reads `/etc/os-release`, prints a short banner, loops on `readLine` / `execLine` (with error handling so user mistakes do not tear down the session).
+- **`init.js`** — Kernel entry: must define `async function start(ctx)`. Reads `/etc/os-release`, prints a short banner, loops on `readLine` / `execLine` (with error handling so user mistakes do not tear down the session). Custom kernels may call **`ctx.registerKernelShutdownHook(fn)`** to run teardown when the session ends (before initd disposers); see [`developer-guide/02-the-context-object.md`](../developer-guide/02-the-context-object.md).
 - **`bin/`** — **Tier-1 utilities** built by [bare-os-coreutils](../packages/bare-os-coreutils/README.md). Each file is **`runtime.js`** + optional **`lib/*-engine.js`** (**`sed`**, **`awk`**) or **`lib/man-render.js`** (**`man`**) + **`async function run(ctx, argv)`** (no ESM **`import`** in **`src/`**).
 - **`share/man/man.json`** — Merged manual database for **`/bin/man`** (built by **`bare-os-coreutils`**; see [handbook ch.10](../handbook/10-manpages-and-online-help.md)).
 - **`etc/os-release`** — Static OS metadata (`NAME`, `VERSION`, …).