Beta v0.8.2

What's Changed

🚀 New Features

• Prompt sets and prompt attachments driven by prompt.json (7005fb7, 39ab044) — Operators can enable one Home prompt set with /promptset or crystal promptsets, and list, enable, disable, or reorder prompt attachments with /promptattach, crystal prompt-attachments, or --prompt-attachments. Each directory uses a prompt.json manifest with enabled, order, name, and description, the workspace copy replaces the Home copy, and the old config.json keys are ignored.
• Image tools through a configured image model (11e9a52) — Setting imageModel in config.json gives Plan and Work a describe_image tool that returns the vision model's text description of an image, and an image-capable session model also gets view_image to load the file into the next round. Both follow the read path fence, so files outside the workspace still need approval.
• Session launch overrides on the interactive commands (99aa491) — crystal and crystal space now accept the same per-process flags as crystal run, including --approval, --plan, --work, --thinking, --prompt-set, --skills, --plugins, --model-calls, and --tool-calls. The flags shape that process only and are not written at startup.
• list tool for directory contents (685f161) — Plan and Work can list a directory's immediate entries with list, using the optional path, 1-based offset, and limit arguments to page through up to 1,000 entries. Directories end with a slash, and ignored build directories are skipped.
• Paging for the glob tool (28cb546) — glob now takes optional 1-based offset and limit arguments and reports how many files remain, and grep returns up to 1,000 matches per call.
• Thinking gear for the approval model (e20adfa) — /approval thinking [effort] cycles or sets the reviewer's thinking effort and stores it in approvalModel.thinkingEffort, --approval-thinking <effort> sets it for one process, and /status shows it with the model.
• Tab completion for approval-model arguments (5361100, 4cffb97) — Tab after /approval model offers on, off, and the catalog models, and Tab after /approval thinking offers the selected model's thinking gears.
• Prompt placeholders and catalog snapshots for plugins (0ad6fae) — Plugins can add prompt placeholders and receive a read-only snapshot of the loaded plugins, external tool sets, external tools, and skills, with placeholder values resolved on every prompt bind.
• Session and review model access for plugins (3414910) — Plugins can read live session and review model facts and, when they implement IPluginModelClient, receive side-channel clients for calling those models without entering the transcript, approval path, or turn budget.
• Build and host sections in crystal version (4219288) — The command now prints Configuration with the build lines and then, after a blank line, Runtime and an OS line that includes the architecture.
• Highlighted-row following in question panels (596c24c) — Moving the selection, or the cursor while editing a custom answer, scrolls the panel so that row is visible, and a manual scroll stays until the highlight or cursor moves.
• Pinned frame for scrolling overlay cards (20324b0) — A tall /btw answer now scrolls its rows under a fixed title and border, and PageUp, PageDown, and Ctrl+Up/Down move by the rows inside the frame.
• Refined built-in Work, Plan, Review, and compaction prompts (dec9e17) — The defaults now explain the review risk levels and authorization scale, state the precedence of workspace instructions and the latest user message, keep Plan todos pending for Work, and record what was verified and how in compaction summaries.

🐛 Fixes

• Newline input with Ctrl+J and backslash-Enter in the composer (3d187fc) — Ctrl+J now inserts a newline on terminals that report it as Enter with LF, and a backslash before Enter works with the cursor anywhere in the text, not only at the end.
• Console input-mode re-arming and UTF-8 output (779ad68) — The session repeats bracketed paste and mouse reporting while it is open and turns off Windows quick edit, so the wheel keeps scrolling the transcript, and console output is UTF-8 so the braille spinner no longer shows a question mark on Windows.
• Launch overrides kept out of saved settings (9aca8a3) — A later preference save no longer writes this process's launch overrides to config.json, and /promptset switching or /promptattach enable, disable, up, and down are refused while the matching --prompt-set or --prompt-attachments off flag is set.
• Scrolling inside tall question panels (59f35df) — The mouse wheel, PageUp, PageDown, and Ctrl+Up/Down scroll a question panel that is taller than its slot, and only a scroll past either end or a panel that fits moves the transcript.
• Ctrl+J handling on question choice lists (bec0657) — The J, K, H, and L shortcuts on question panels now apply only to plain keys, so Ctrl+J stays a newline.
• Approval thinking gear kept out of config.json (a675eb3) — --approval-thinking applies to one process only, /approval model keeps the saved gear, and only /approval thinking writes a new one.
• LF line endings in model-visible tool output (69c75a0) — read, list, glob, grep, and command output now use LF on every platform, so provider text and session files no longer vary with the host's newline convention.
• Paging past the first glob maximum (c04b426) — offset and limit now page through the full match set instead of only the first 1,000 files, and only the requested page is kept in memory.
• Duplicate glob match skipping (6fd7ee1) — A path reached more than once is reported once, so the match total and the paging offsets stay consistent.
• Symlinked file entries kept distinct in workspace walks (2e56b49) — Directory enumeration yields the entry path instead of the resolved target, so two links to one file appear separately and a search rooted below the target reports the path it found.
• Prompt-attachment enable on the winning copy (c60be8d) — Enabling an attachment from crystal prompt-attachments or /promptattach now writes the Home or workspace manifest that discovery actually uses.
• Trailing newlines in prompt attachments (807a5ca) — Attachment text keeps its trailing newline, so appended sections no longer run together.
• Two blank lines between appended prompt parts (0932a04) — The resolved prompt and each attachment are now separated by two blank lines.

📝 Documentation

• Git for Windows requirement for the bash tool (a9da62e) — The README and user guide now tell Windows operators to install Git for Windows so Git Bash provides bash.
• Workspace-level configuration documented as unread (6ab56fd) — The documents now state that operator preferences load only from ~/.crystal/config.json and that reading <workspace>/.crystal/config.json is deferred.
• Work mode tool order documented (0fc5732) — The architecture and user guide now list the built-in Work tools in registration order.
• Deferred custom modes and the Plan bash question documented (c254b1e) — The product document now records that modes beyond Plan and Work are deferred and that whether Plan may include bash is undecided.
• Multi-directory sessions on the unimplemented list (e85393e) — The product document now lists multiple accessible directories in one session as unimplemented.

Full Changelog: B0.8.1...B0.8.2