release: 0.2.0 (#168)

Co-authored-by: Claude Fable 5 <noreply@anthropic.com>

changelog/0.2.0/2026-08-03-oss-distribution.md

@@ -0,0 +1,8 @@
+# Tooling: Alibaba Cloud OSS distribution for Release assets
+
+Release downloads no longer depend on GitHub's reachability alone (#166).
+
+- A new `mirror-oss` release job downloads the exact assets attached to the GitHub Release, re-verifies their checksums, and mirrors the same bytes to an Alibaba Cloud OSS bucket; `latest.json` is uploaded last and only after every asset landed, so the mirror never advertises a partially mirrored version. The job reads its provider/role ARNs and bucket settings from the `oss-production` environment and fails fast with a named error when one is missing.
+- `install.sh` / `install.ps1` gain a download-source switch: `PENGUIN_DOWNLOAD_SOURCE=auto` (default) prefers the OSS mirror and falls back to the same version on GitHub when the mirror is unavailable; `oss` and `github` pin one source. `PENGUIN_DOWNLOAD_BASE_URL` / `PENGUIN_DOWNLOAD_FALLBACK_BASE_URL` override the asset directories directly (https-validated), and download progress names the source it is actually using.
+- An `oss-staging` workflow plus `scripts/publish-release-to-oss.sh`, `scripts/install-ossutil.sh` and `scripts/test-oss-staging.sh` exercise the mirror path end to end before production, and the hermetic installer tests cover the source switch on both platforms.
+- The installation docs document the download-source row for both languages.

changelog/0.2.0/README.md

@@ -1,6 +1,8 @@
-# Unreleased
+# Version 0.2.0
 
-Changes since v0.1.5. The version number is assigned at release, when this folder is renamed.
+Released on 2026-08-03.
+
+- [2026-08-03] Tooling: Release assets are mirrored to Alibaba Cloud OSS — the mirror-oss release job re-uploads the exact checksum-verified GitHub Release artifacts (`latest.json` last, only after every asset landed), and the installers gain a download-source switch (`PENGUIN_DOWNLOAD_SOURCE=auto|oss|github`, auto preferring OSS with a same-version GitHub fallback) plus validated `PENGUIN_DOWNLOAD_BASE_URL` overrides, with a staging workflow and installer tests covering the mirror path. ([details](2026-08-03-oss-distribution.md))
 
 - [2026-08-03] Web App: three chat-navigation aids — ↑ recalls the session's previous inputs shell-style in the composer, the "Reasoning & Tools" header and the current thinking/tool row stick to the top of the stream stacked by level so long runs collapse from anywhere inside them, and a zero-width tick-rail minimap over the stream's left gutter previews every exchange on hover (question + truncated answer) for one-click jumps. ([details](2026-08-03-web-chat-navigation.md))
 

changelog/0.2.0/RELEASE.md

@@ -0,0 +1,48 @@
+PenguinHarness 0.2.0 — one sealed installer bundle per platform (now also served from an OSS mirror), tool output that survives truncation, and long conversations you can actually navigate.
+
+## Install
+
+```sh
+curl -fsSL https://penguin.ooo/install.sh | sh
+penguin web
+```
+
+Windows (PowerShell):
+
+```powershell
+irm https://penguin.ooo/install.ps1 | iex
+penguin web
+```
+
+Linux, macOS and Windows, with a bundled Node runtime. Or via npm (needs Node >= 24):
+
+```sh
+npm install -g @prismshadow/penguin-cli
+```
+
+**One artifact per target.** Each Release now attaches exactly one file per platform — `penguin-{linux,darwin}-{x64,arm64}.tar.gz`, `penguin-universal.tar.gz`, `penguin-win32-x64.zip` — a flat installer bundle sealing the native installer, the program payload and its checksum. The same file serves online and offline installation: download it anywhere, copy it to the target, extract, and run the bundled `install.sh` / `install.cmd`; checksums are verified unconditionally at both layers. **New download source:** the installers now prefer an Alibaba Cloud OSS mirror carrying the exact same bytes and fall back to GitHub automatically (`PENGUIN_DOWNLOAD_SOURCE=auto|oss|github`).
+
+## Highlights
+
+**Long conversations became navigable.** The composer recalls this session's previous inputs with ↑/↓, shell-style — edits end recall, multi-line entries walk the caret first, IME candidates are untouched. The "Reasoning & Tools" header and the currently scrolled thinking/tool row stick to the top of the stream stacked by level, so a long run collapses from anywhere inside it, per section or as a whole. And a zero-width minimap tick rail overlays the stream's left gutter — one tick per exchange, hover for a question-plus-answer preview card, click to jump — moving into a top-right toolbar dropdown whenever the gutter (or a hover pointer) isn't there.
+
+**Truncated tool output is recoverable.** Output that exceeds the per-call cap in an Agent Session is saved to the Session scratchpad, and the recovery path rides the same truncated result the model and both frontends see — no new tool, no protocol change. Every model-visible path core composes now shares one forward-slash spelling on Windows, and the file tools keep accepting both spellings.
+
+**Steering that survives everything, and a session list that scales.** Mid-run steering messages survive reloads with their content visible, retire exactly once delivered, and now carry file attachments just like images. Tool-card subtitles render once fully formed instead of jittering while arguments stream. The sidebar session list is served straight from the database by default — CLI sessions become an opt-in toggle — and both the lists and the groups themselves page, so many agents and workspaces stay scannable.
+
+**A current model catalog.** The qianwenai groups move to the current lineup (qwen3.8-max and deepseek-v4-flash-0731 in), OpenRouter gains deepseek/deepseek-v4-flash-0731 and openai/gpt-5.6-luna, every gateway row's prices are re-read from the models API, and new Projects default to deepseek-v4-flash — existing Projects keep their stored models and default.
+
+## Notable in this release
+
+- **Installs and upgrades hardened.** In-place upgrades survive filesystems that pin in-use directories, the Windows payload drops its policy-blocked `penguin.ps1` launcher (typing `penguin` is unaffected), the installer broadcasts the user-Path change so new terminals find `penguin`, and hermetic installer tests run in CI.
+- **File tools diagnose missing paths.** `read_file` / `edit_file` report the deepest existing ancestor, the first missing segment and nearest-named entries instead of a bare "File not found".
+- **Update checks report every outcome.** The manual "Check for updates" row shows a busy spinner, success toasts for both up-to-date and update-found, and the existing failure notices.
+- **Evaluation Center case details.** Target-agent task materials are separated from project-member-visible scoring rubrics, Score charts use a padded dynamic axis, and the benchmark Skills write YAML-safe Scoreboard summaries.
+- **File summaries move to the Task boundary.** One card per completed Task scanning all of its assistant text; negative existence results are no longer cached, so later Tasks can surface newly created paths.
+- **Backward compatibility, recorded once.** The installers keep a content-probed legacy path so pre-0.2.0 releases stay installable; installer scripts saved from older releases break loudly against new assets by design — re-fetch them. See [the batch's compatibility notes](https://github.com/Prism-Shadow/penguin-harness/blob/main/changelog/0.2.0/2026-07-31-backward-compatibility.md).
+
+## Requirements
+
+Linux or macOS (x64 / arm64), or Windows 10+ (x64). The installers bundle their own Node runtime; installing from npm needs Node >= 24. All data stays under `~/.penguin/data`.
+
+Full detail: [changelog/0.2.0/](https://github.com/Prism-Shadow/penguin-harness/tree/main/changelog/0.2.0).