Release v0.18.0 - Compact mobile UI, tool expansion controls, smoother streaming, session fixes and Winget automation (#568)

## Thanks for contributions

- [@shantur](https://github.com/shantur):
[#535](#535),
[#556](#556),
[#557](#557),
[#562](#562),
[#563](#563),
[#564](#564),
[#565](#565),
[#567](#567)
- [@pascalandr](https://github.com/pascalandr):
[#533](#533),
[#551](#551)
- [@JDis03](https://github.com/JDis03):
[#484](#484),
[#536](#536)
- [@aayurt](https://github.com/aayurt):
[#552](#552)

## Highlights

- **Compact mode is much better on mobile**: The message UI has been
redesigned for compact layouts, with cleaner controls and a denser
conversation view that works better on smaller screens.
- **Tool output is easier to control**: New tool-level expansion
settings let you choose how much tool-call detail you want to see,
making busy sessions easier to scan.
- **Streaming output feels steadier**: Bash output, tool output, and
assistant responses now stay pinned more reliably while streaming,
reducing jumps and missed updates.
- **Project sessions are scoped more accurately**: Session lists now
respect the active project more consistently, so switching projects is
less likely to show unrelated sessions.
- **Tab closing is more dependable**: Closing tabs has been tightened up
to avoid cases where the wrong tab behavior could interrupt your
workflow.

## What’s Improved

- **Cleaner compact conversation layout**: Message blocks, message
sections, tool calls, permissions, questions, todos, and task output
have all been polished for a more readable compact experience.
- **More useful tool-call presentation**: Tool calls now have a stronger
registry-backed rendering path, clearer titles, improved status display,
and better per-tool output handling.
- **Better follow behavior near the bottom of sessions**: The session
view now tracks bottom-follow intent more carefully, helping the app
stay with new output when you expect it to.
- **Smoother live session creation**: Session-created events from the
live event stream are now handled directly, so new sessions appear more
reliably without manual refreshes.
- **Improved permission denial feedback**: Denied permissions now
produce simpler, less noisy feedback in the conversation.

## Fixes

- **More reliable autoscroll during long responses**: Hold-mode
assistant autoscroll, message-part tool output autoscroll, and streaming
bash output pinning were stabilized.
- **Less duplicated streaming text**: SSE part deltas are throttled and
buffered more carefully to prevent stale delta text from being
duplicated in streamed messages.
- **Better session list isolation**: Project session list requests are
now scoped so sessions from one project do not bleed into another
project’s list.
- **More stable tab management**: A tab close bug was fixed to make
multi-session navigation safer.
- **Release pipeline reliability**: Winget release automation is now
wired into the release workflow so Windows package updates can be
published more consistently.

## Docs

- **New contributor guide**: A `CONTRIBUTING.md` guide was added to help
new contributors set up the project and understand the development
workflow.
- **Winget release docs updated**: Supporting documentation for Winget
release automation was refreshed.

### Contributors

- [@shantur](https://github.com/shantur)
- [@pascalandr](https://github.com/pascalandr)
- [@JDis03](https://github.com/JDis03)
- [@aayurt](https://github.com/aayurt)

**Full Changelog**:
[v0.17.0...v0.18.0](v0.17.0...v0.18.0)

## Merged Pull Requests

### [@shantur](https://github.com/shantur)

- PR [#535](#535)
“fix(ui): simplify permission denial feedback”
- PR [#556](#556)
“fix(ui): keep streaming bash output pinned”
- PR [#557](#557) “WIP:
Compact mode message UI redesign”
- PR [#562](#562)
“fix(ui): handle session created SSE events”
- PR [#563](#563)
“feat(ui): Add tool level expansion settings.”
- PR [#564](#564)
“Improve compact mobile UI controls”
- PR [#565](#565)
“fix(ui): scope project session list requests”
- PR [#567](#567)
“fix(ui): keep message-part tool output auto-scroll synced”

### [@pascalandr](https://github.com/pascalandr)

- PR [#533](#533) “fix:
stabilize hold-mode assistant autoscroll”
- PR [#551](#551) “fix:
wire Winget automation into release pipeline”

### [@JDis03](https://github.com/JDis03)

- PR [#484](#484) “docs:
add CONTRIBUTING.md guide for new contributors”
- PR [#536](#536)
“fix(ui): throttle SSE part deltas and prevent stale delta text
duplication”

### [@aayurt](https://github.com/aayurt)

- PR [#552](#552)
“Bugfix/tab close bug”

Author: shantur

.github/workflows/reusable-release.yml

@@ -97,6 +97,18 @@ jobs:
       release_name: ${{ needs.prepare-release.outputs.release_name }}
     secrets: inherit
 
+  update-winget:
+    needs:
+      - prepare-release
+      - build-and-upload
+    if: ${{ !inputs.prerelease }}
+    permissions:
+      contents: read
+    uses: ./.github/workflows/update-winget.yml
+    with:
+      release_tag: ${{ needs.prepare-release.outputs.tag }}
+    secrets: inherit
+
   release-ui:
     needs: prepare-release
     if: ${{ inputs.release_ui }}

.github/workflows/update-winget.yml

@@ -1,17 +1,83 @@
 name: Update Winget
 
 on:
-  release:
-    types:
-      - published
+  workflow_call:
+    inputs:
+      release_tag:
+        description: "Stable release tag to inspect"
+        required: true
+        type: string
+      release_id:
+        description: "Optional numeric GitHub release id"
+        required: false
+        default: ""
+        type: string
+  workflow_dispatch:
+    inputs:
+      release_tag:
+        description: "Stable release tag to inspect"
+        required: true
+        type: string
+      release_id:
+        description: "Optional numeric GitHub release id"
+        required: false
+        default: ""
+        type: string
 
 permissions:
   contents: read
 
 jobs:
+  resolve-release:
+    name: Resolve release metadata
+    runs-on: ubuntu-latest
+    outputs:
+      release_id: ${{ steps.release.outputs.release_id }}
+      release_tag: ${{ steps.release.outputs.release_tag }}
+      draft: ${{ steps.release.outputs.draft }}
+      prerelease: ${{ steps.release.outputs.prerelease }}
+    steps:
+      - name: Resolve release metadata
+        id: release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          RELEASE_TAG: ${{ inputs.release_tag }}
+          RELEASE_ID_INPUT: ${{ inputs.release_id }}
+        run: |
+          set -euo pipefail
+
+          if [ -n "$RELEASE_ID_INPUT" ]; then
+            release_api="repos/${GITHUB_REPOSITORY}/releases/${RELEASE_ID_INPUT}"
+          else
+            release_api="repos/${GITHUB_REPOSITORY}/releases/tags/${RELEASE_TAG}"
+          fi
+
+          release_id="$(gh api "$release_api" --jq '.id')"
+          release_tag="$(gh api "$release_api" --jq '.tag_name')"
+          draft="$(gh api "$release_api" --jq '.draft')"
+          prerelease="$(gh api "$release_api" --jq '.prerelease')"
+
+          if [ -z "$release_id" ] || [ "$release_id" = "null" ]; then
+            echo "Unable to resolve release id for tag '$RELEASE_TAG'" >&2
+            exit 1
+          fi
+
+          echo "release_id=$release_id" >> "$GITHUB_OUTPUT"
+          echo "release_tag=$release_tag" >> "$GITHUB_OUTPUT"
+          echo "draft=$draft" >> "$GITHUB_OUTPUT"
+          echo "prerelease=$prerelease" >> "$GITHUB_OUTPUT"
+
+      - name: Log resolved release metadata
+        run: |
+          echo "Release tag: ${{ steps.release.outputs.release_tag }}"
+          echo "Release id: ${{ steps.release.outputs.release_id }}"
+          echo "Draft: ${{ steps.release.outputs.draft }}"
+          echo "Prerelease: ${{ steps.release.outputs.prerelease }}"
+
   update-winget:
     name: Submit Winget manifest update
-    if: ${{ !github.event.release.draft && !github.event.release.prerelease }}
+    needs: resolve-release
+    if: ${{ needs.resolve-release.outputs.draft != 'true' && needs.resolve-release.outputs.prerelease != 'true' }}
     runs-on: ubuntu-latest
     env:
       WINGET_PACKAGE_IDENTIFIER: ${{ vars.WINGET_PACKAGE_IDENTIFIER || 'NeuralNomadsAI.CodeNomad' }}
@@ -35,8 +101,8 @@ jobs:
         run: |
           args=(
             --repo "${{ github.repository }}"
-            --release-id "${{ github.event.release.id }}"
-            --tag "${{ github.event.release.tag_name }}"
+            --release-id "${{ needs.resolve-release.outputs.release_id }}"
+            --tag "${{ needs.resolve-release.outputs.release_tag }}"
             --asset-name-template "$WINGET_WINDOWS_ASSET_NAME_TEMPLATE"
             --timeout-seconds "$WINGET_ASSET_WAIT_TIMEOUT_SECONDS"
             --poll-interval-seconds "$WINGET_ASSET_POLL_INTERVAL_SECONDS"
@@ -79,7 +145,7 @@ jobs:
         with:
           identifier: ${{ env.WINGET_PACKAGE_IDENTIFIER }}
           version: ${{ steps.release_asset.outputs.version }}
-          release-tag: ${{ github.event.release.tag_name }}
+          release-tag: ${{ needs.resolve-release.outputs.release_tag }}
           installers-regex: ${{ steps.release_asset.outputs.asset_regex }}
           fork-user: ${{ env.WINGET_FORK_OWNER }}
           token: ${{ secrets.WINGET_GITHUB_TOKEN }}

AGENTS.md

@@ -6,6 +6,7 @@
 - When adding new component styles, place them beside their peers in the scoped subdirectory (e.g., `src/styles/messaging/new-part.css`) and import them from the corresponding aggregator file.
 - Prefer smaller, focused style files (≈150 lines or less) over large monoliths. Split by component or feature area if a file grows beyond that size.
 - Co-locate reusable UI patterns (buttons, selectors, dropdowns, etc.) under `src/styles/components/` and avoid redefining the same utility classes elsewhere.
+- Never use rounded corners in UI styling; keep corners square unless the user explicitly requests otherwise for a specific change.
 - Document any new styling conventions or directory additions in this file so future changes remain consistent.
 
 ## Coding Principles

CONTRIBUTING.md

@@ -0,0 +1,154 @@
+# Contributing to CodeNomad
+
+Thank you for your interest in contributing! This guide will help you get started.
+
+## Prerequisites
+
+- **Node.js 18+** and npm
+- **OpenCode CLI** in your `PATH` (the server connects to the OpenCode binary to manage workspaces)
+
+## Quick Start
+
+```bash
+git clone https://github.com/NeuralNomadsAI/CodeNomad.git
+cd CodeNomad
+npm install
+npm run dev
+```
+
+## Finding Issues to Work On
+
+Browse [open issues](https://github.com/NeuralNomadsAI/CodeNomad/issues) and look for these labels:
+
+| Label | Meaning |
+|---|---|
+| `ready-to-work` | Clear scope, ready for anyone to pick up |
+| `good-first-issue` | Good for first-time contributors |
+| `enhancement` | New feature requests |
+| `bug` | Bug reports |
+
+**Before starting:** comment on the issue so we can discuss approach and avoid duplicate work.
+
+## Development Workflow
+
+### 1. Fork and Branch
+
+```bash
+# Fork the repo on GitHub, then clone your fork
+git clone https://github.com/YOUR_USERNAME/CodeNomad.git
+cd CodeNomad
+
+# Add the upstream remote
+git remote add upstream https://github.com/NeuralNomadsAI/CodeNomad.git
+
+# Create a branch from upstream/dev
+git fetch upstream
+git checkout -b fix/your-branch-name upstream/dev
+```
+
+### 2. Branch Naming
+
+| Prefix | Use for |
+|---|---|
+| `fix/` | Bug fixes |
+| `feat/` | New features |
+| `docs/` | Documentation changes |
+| `refactor/` | Code refactoring |
+| `chore/` | Build, config, maintenance |
+
+Examples: `fix/question-queue-ordering`, `feat/retry-tool-call`, `docs/contributing-guide`
+
+### 3. Make Your Changes
+
+```bash
+# Install dependencies
+npm install
+
+# Run the dev server
+npm run dev
+
+# Run type checking
+npm run typecheck --workspace @codenomad/ui
+```
+
+### 4. Commit
+
+Write clear, descriptive commit messages. Explain **what** changed and **why**.
+
+```bash
+git add .
+git commit -m "fix(ui): preserve question queue order when upserting duplicate requests
+
+When a question arrives as a global entry and later resolves to a tool
+part with a newer timestamp, the original enqueue time was lost, causing
+the question to move behind newer entries and break interruption order."
+```
+
+### 5. Push and Create a PR
+
+```bash
+git push origin your-branch-name
+```
+
+Then open a pull request on GitHub targeting the `dev` branch.
+
+**PR checklist:**
+- [ ] Branch is based on latest `upstream/dev`
+- [ ] One issue per PR (don't mix unrelated changes)
+- [ ] Type checking passes: `npm run typecheck` (root) or the workspace-specific script matching your change area
+- [ ] Tests pass (if applicable)
+- [ ] PR description explains the change, includes relevant screenshots for UI changes, and links related issues when applicable
+
+## Project Structure
+
+| Package | Description |
+|---|---|
+| `packages/server` | Core logic & CLI — workspaces, OpenCode proxy, API, auth |
+| `packages/ui` | SolidJS frontend — reactive UI components and stores |
+| `packages/electron-app` | Electron desktop shell |
+| `packages/tauri-app` | Tauri desktop shell (experimental) |
+| `packages/opencode-plugin` | OpenCode plugin integration |
+| `packages/cloudflare` | Cloudflare deployment adapters |
+
+### Key UI Files
+
+| Path | Purpose |
+|---|---|
+| `packages/ui/src/stores/session-events.ts` | SSE event handlers (idle, status, permissions, questions) |
+| `packages/ui/src/stores/session-actions.ts` | User actions (send message, abort, revert, fork) |
+| `packages/ui/src/stores/message-v2/` | Message store (v2 architecture) |
+| `packages/ui/src/stores/instances.ts` | Instance management and interruption queues |
+| `packages/ui/src/components/tool-call.tsx` | Tool call rendering |
+| `packages/ui/src/components/message-block.tsx` | Message display blocks |
+| `packages/ui/src/components/session/session-view.tsx` | Main session view |
+| `packages/ui/src/lib/i18n/messages/` | Translation files (en, es, fr, ja, ru, he, zh-Hans) |
+
+> For a comprehensive map of all six functional areas (server, UI, desktop, speech/audio, build, Cloudflare), SDK integration patterns, and feature traces, load the `codenomad-architecture-guide` skill:  
+> `.opencode/skills/codenomad-architecture-guide/SKILL.md`
+
+### Styling
+
+- Tokens: `packages/ui/src/styles/tokens.css`
+- Utilities: `packages/ui/src/styles/utilities.css`
+- Component styles: `packages/ui/src/styles/components/`, `packages/ui/src/styles/messaging/`, `packages/ui/src/styles/panels/`
+- Keep style files under ~150 lines; split by component
+
+### Internationalization (i18n)
+
+- Use `useI18n()` in components, `tGlobal()` in stores
+- Messages live in `packages/ui/src/lib/i18n/messages/<locale>/`
+- When adding a string: add to `en/` first, then add the same key to every other locale
+- Placeholders use `{name}` syntax (word characters only)
+
+## Code Principles
+
+- **KISS**: Keep modules narrowly scoped
+- **DRY**: Share helpers before copy-pasting
+- **Single responsibility**: Split files when concerns diverge
+- **Composable primitives**: Prefer signals, hooks, utilities over deep inheritance
+
+## Need Help?
+
+- Check existing [issues](https://github.com/NeuralNomadsAI/CodeNomad/issues) and [PRs](https://github.com/NeuralNomadsAI/CodeNomad/pulls)
+- Ask in the issue you're working on
+- Review the [server documentation](packages/server/README.md) for CLI flags and configuration

docs/guides/winget-release-automation.md

@@ -1,11 +1,13 @@
 # Winget release automation
 
-CodeNomad publishes Winget updates from GitHub Releases with `.github/workflows/update-winget.yml`.
+CodeNomad publishes Winget updates from the stable GitHub release pipeline. `.github/workflows/reusable-release.yml` now calls `.github/workflows/update-winget.yml` after the release assets finish uploading.
 
 ## Trigger
 
-- Runs on `release.published`.
-- Exits early for draft or prerelease releases.
+- Runs as a reusable workflow from the stable release pipeline, after `build-and-upload` completes.
+- Resolves the target release by tag through the GitHub API, then exits early for draft or prerelease releases.
+- Can also be rerun manually with `workflow_dispatch` by supplying the stable release tag (and optionally the numeric release id).
+- This avoids the old `release.published` trap where a release created by GitHub Actions with the default `GITHUB_TOKEN` does not fan out into a second workflow run.
 - Waits for the expected stable Windows Tauri asset because the release record can exist before all assets finish uploading.
 
 ## Required configuration
@@ -28,7 +30,7 @@ CodeNomad publishes Winget updates from GitHub Releases with `.github/workflows/
 
 ## Runtime flow
 
-1. Resolve the release version from `github.event.release.tag_name`.
+1. Resolve the target release by tag through the GitHub API, then derive the package version from the resolved release tag.
 2. Poll the release API until exactly one uploaded asset matches the configured Windows Tauri asset template.
 3. Download the matched asset once and compute a SHA-256 for logging and verification.
 4. Verify the PAT owner matches `WINGET_FORK_OWNER` and that `${WINGET_FORK_OWNER}/winget-pkgs` is a fork of `microsoft/winget-pkgs`.
@@ -38,3 +40,4 @@ CodeNomad publishes Winget updates from GitHub Releases with `.github/workflows/
 
 - The workflow does not depend on a persistent local `winget-pkgs` clone.
 - The current package in `winget-pkgs` uses the release ZIP with a nested NSIS installer, so the workflow targets the stable `CodeNomad-Tauri-windows-x64-{version}.zip` asset.
+- If a maintainer publishes a release outside the standard release workflow, they should manually run `Update Winget` for that stable tag.