Release 0.2.0: docs, changelog, version bump

CHANGELOG.md

@@ -0,0 +1,23 @@
+# Changelog
+
+## [0.2.0] — 2026-08-10
+
+### Added
+- Nebula **light** theme alongside glass dark (`ASK_QUESTION_THEME` / prefs `theme`)
+- `action_class` band chrome: `file` · `secrets` · `comms` · `destructive` · `policy`
+- Optional `image` / `images` preview (Linux Gtk + Nebula; carousel for multi)
+- Windows Nebula WebView2 MCQ path (glass default)
+
+### Fixed
+- Dense ` · `-packed Confirm questions split into lead + detail (Gtk parity)
+- Policy/dangerous banner no longer repeats the full question under the band label
+- Linux Nebula known-goods: window drag, ↑/↓+Enter, audio checkbox vs env mute
+- Confirm body clipping, footer Cancel/OK visibility, image dialog sizing
+
+### Changed
+- Default MCQ audio off until the human opts in
+- TTS/STT URLs remain optional; text-only is the lean default
+
+## [0.1.0] — 2026-07-26
+
+First public release — Gtk4/Adw `ask_multiple_choice`, text-first, optional voice.

README.md

@@ -16,6 +16,7 @@ dialog (`ask_multiple_choice`) on any compatible host. **Works text-only**
 
 [Demo](https://www.youtube.com/watch?v=5wVKCIXAfi4) ·
 [SETUP](SETUP.md) ·
+[Changelog](CHANGELOG.md) ·
 [Dependencies](DEPENDENCIES.md) ·
 [Security](SECURITY.md) (3-year fix window) ·
 [Maintainers](MAINTAINERS.md)
@@ -98,6 +99,8 @@ Full env / prefs: [SETUP.md](SETUP.md). Never commit tokens.
   returned as MCP image blocks (max 4, no lasting files)
 - **Idle timeout hold:** default `timeout_sec=0` (waits). If a timeout is set,
   typing / paste / select cancels auto-close until OK/Cancel
+- **`action_class`** band chrome: `file` · `secrets` · `comms` · `destructive` ·
+  `policy` (COMMS wording only for real outbound messages)
 - Linux aesthetic: **Nebula** glass (dark default) + **light** daylight companion
   (`ASK_QUESTION_THEME` / prefs `theme`: `glass` | `light` | `ink` | `signal` | `hybrid`)
 - Remembers last dialog size (`prefs.window`; position on Windows; size-only

docs/AGENTS.md

@@ -73,6 +73,7 @@ skill via `ask-question-install --skill` (`~/.cursor/skills/ask-multiple-choice`
 | `allow_multiple` | bool | no | default `false` (radio); `true` = checklist |
 | `allow_other` | bool | no | **Ignored** — Something else is always appended when missing |
 | `dangerous` | bool | no | Danger chrome; OK/Enter armed ~1s (`ASK_QUESTION_DANGER_ARM_MS`, same default as normal). Normal MCQs arm ~1s (`ASK_QUESTION_ARM_MS`). |
+| `action_class` | string \| null | no | Band colour: `file` \| `secrets` \| `comms` \| `destructive` \| `policy`. Use **COMMS** only for real outbound messages (never “send this” for file/secrets/policy). Bare `dangerous=true` maps to destructive chrome. |
 | `speak` | bool | no | default `true` (honours mute env / missing TTS) |
 | `title` | string | no | default `"Decide"` — short noun phrase |
 | `agent` | string \| null | **strongly yes** | Window title prefix `[agent]` |
@@ -151,6 +152,7 @@ Routine forks stay short (no referent dump):
   "title": "Force push",
   "agent": "release-agent",
   "dangerous": true,
+  "action_class": "destructive",
   "recommended_id": "abort",
   "options": [
     { "id": "abort", "label": "Abort (recommended)" },
@@ -159,6 +161,9 @@ Routine forks stay short (no referent dump):
 }
 ```
 
+**Theme (Nebula):** env `ASK_QUESTION_THEME` or prefs `theme` —
+`glass` (default dark) · `light` · `ink` · `signal` · `hybrid`.
+
 OK and Enter stay locked briefly after open (countdown on OK): **~1s** for both
 normal (`ASK_QUESTION_ARM_MS`) and `dangerous` (`ASK_QUESTION_DANGER_ARM_MS`).
 (Dangerous used to be ~4s; shortened 2026-08-01.) Set either env to `0` to

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "ask-question-mcp"
-version = "0.1.0"
+version = "0.2.0"
 description = "Stdio MCP desktop multiple-choice (Gtk/tk); works text-only, optional TTS/STT"
 readme = "README.md"
 requires-python = ">=3.12"