---
summary: "Landing page tools section grouped by mutability with chip + search filter; status strip gains repo link; add-app-tool host-theming guidance; maintenance v2.0 hard-rule on framework adoption"
breaking: false
---

# 0.8.2 — 2026-04-28

Landing-page UX pass plus skill tightening. No runtime API changes.

## Changed

- **Tools section** (`src/mcp-server/transports/http/landing-page/sections/tools.ts`) — replaces prefix-based grouping with mutability buckets (`read` / `write` / `destructive`) using `tool.annotations.{readOnlyHint, destructiveHint}`. Annotation-less tools bucket as `write` (matches the existing `pill-destructive === true` rule). Cards now carry `data-tool-card`, `data-mutability`, `data-name`, `data-search` for the filter script. Auth display reduced to the trailing access-level chip (`tool:foo:read` → `read`); full scope list still in the `title` tooltip.
- **Tool filter bar** — new chip row (`all` + populated buckets) with `aria-pressed` toggling, plus a `<input type="search">` indexed against `data-search` (lowercased `name + description`). Empty state renders `No tools match the current filter.` Filter logic lives in the inlined script — no framework, no transitions, ships under 2 KB.
- **Status strip** (`sections/status-strip.ts`) — adds a dim `github` repo link when `manifest.landing.repoRoot` is set. Same visual weight as the count + protocol items; the prominent "Source" footer entry stays for scrollers.
- **Inlined client script** (`assets/copy-script.ts`) — wraps copy-to-clipboard + tool filtering in a single IIFE. Filter handler bails early when `[data-tools-section]` or `[data-tool-card]` is absent, so the empty server still ships clean.
- **Styles** (`assets/styles.ts`) — adds CSS for the filter bar, mutability-tinted chips, group-count pills, and the `tools-empty` placeholder. Mobile breakpoint preserved.
- **`add-app-tool` skill** — sharper "ship self-contained HTML" guidance (CSP / supply-chain / offline footguns enumerated). New "Adopt the host's visual identity" section documenting `applyDocumentTheme` / `applyHostStyleVariables` / `applyHostFonts` and the pre-connect `prefers-color-scheme` baseline pattern that prevents first-paint flashes.
- **`maintenance` skill v1.9 → v2.0** — framework-adoption default hardened from "default adopt" to "auto-adopt every applicable site, in this pass." Adds an explicit valid/invalid deferrals table and forbids scope/effort/marginal-benefit deferrals in the "Open decisions" section. Cost/benefit reasoning now applies to third-party adoptions only.
