Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
33 changes: 33 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,38 @@
# Changelog

## 1.4.0-alpha - 2026-08-13

Alpha prerelease: the integration candidate of the Pane Search release,
bundling the v1.3.1, v1.3.2, and v1.3.3 engineering checkpoints on top of
v1.3.0-beta3 for manual validation. Published as a GitHub prerelease with
the standard asset layout; GitHub Latest and WinGet keep pointing at the
stable v1.2.0, and this alpha replaces v1.3.0-beta3 as the newest published
prerelease. A `PASS` verdict from manual testing promotes this build to
`1.4.0-beta`; a `FAIL` produces a fixed `1.4.1-alpha`.

### Added

- Pane Search, end to end: `Ctrl+F` opens Find in the active pane only
(`Ctrl+Shift+F` retained as a remappable alias), with live search over
the pane's entire scrollback, all-match highlighting, `Enter` /
`Shift+Enter` navigation with wrap-around, case-sensitive and regex
modes, and full input isolation from the shell (Phase 1, v1.3.1); the
winTerm compact search box with the `current / total` counter and
width-adaptive layouts, plus the scrollbar search overview with one
marker per matching row and current-match emphasis, independent of the
`ShowMarks` setting (Phase 2, v1.3.2); and performance/edge-case
hardening — per-pane typing coalescing, mid-output refresh convergence,
scrollbar repaint signatures, resize/reflow and alternate-screen safety,
eviction and Unicode coverage (Phase 3, v1.3.3).

### Changed

- Executable metadata major.minor advances to `1.4`; the release channel
switches to `alpha` with package version `1.4.0.0` and module prerelease
suffix `alpha`. The `v1.4.0-alpha` tag runs the full guarded release
pipeline (build, compiled tests, artifact generation, draft asset
round-trip testing) before the prerelease is published.

## 1.3.3 - 2026-08-12

Engineering checkpoint for the Pane Search roadmap, Phase 3: performance and
Expand Down
12 changes: 6 additions & 6 deletions README.ja.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,10 +15,10 @@
最新の安定版リリースページには、インストーラー(Setup EXE)、ポータブルZIP、
リリースノート、チェックサムがまとめて掲載されています。

Command Timelineを先行して試せる**ベータ版**のチャンネルもあります
[v1.3.0-beta3](https://github.com/HelloThisWorld/winTerm/releases/tag/v1.3.0-beta3)
Pane Search(ペイン検索)を先行して試せる**アルファ版**のプレリリースもあります
[v1.4.0-alpha](https://github.com/HelloThisWorld/winTerm/releases/tag/v1.4.0-alpha)
はGitHubのプレリリースとして公開されており、資産の構成は安定版と同じです。
ベータ版は動作確認を目的とした配布のため、通常の利用には上記の安定版を推奨します。
プレリリースは動作確認を目的とした配布のため、通常の利用には上記の安定版を推奨します。

インストーラーは署名されていないため、Windowsに「不明な発行元」または
SmartScreenの警告が表示される場合があります。必ず上記の公式リリースから
Expand All @@ -38,7 +38,7 @@ Microsoft、Windows、Windows Terminalのロゴも使用していません。
- `winTerm-<version>-setup-x64.exe` — 現在のユーザー、または全ユーザーへのインストール用;
- `winTerm-<version>-portable-x64.zip` — 展開してそのまま実行する用。

現在のソースバージョンは `1.3.3` で、
現在のソースバージョンは `1.4.0-alpha` で、
最新の安定版リリースは `1.2.0` です。公開されている資産の一覧とチェックサムの全体は、
[最新の公式リリース](https://github.com/HelloThisWorld/winTerm/releases/latest)
を参照してください。
Expand Down Expand Up @@ -111,8 +111,8 @@ PowerShell 7と、[ビルド手順(英語)](docs/build.md)に記載された
.\scripts\winterm\build.ps1 -Configuration Release -Platform x64 -IncludeTests
.\scripts\winterm\test.ps1 -Suite Relevant -Configuration Release -Platform x64
.\scripts\winterm\build-unpackaged.ps1 -Configuration Release -Platform x64
.\scripts\winterm\build-installer.ps1 -Version 1.3.3 -Platform x64
.\scripts\winterm\build-portable.ps1 -Version 1.3.3 -Platform x64
.\scripts\winterm\build-installer.ps1 -Version 1.4.0-alpha -Platform x64
.\scripts\winterm\build-portable.ps1 -Version 1.4.0-alpha -Platform x64
```

アンパッケージ形式の生成処理では、統合されたリソースインデックスを作るための
Expand Down
15 changes: 7 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,11 +13,10 @@ English | [日本語](README.ja.md)
The latest stable Release page provides the Setup EXE, Portable ZIP, release
notes, and checksums together.

A **beta** channel is also available for early access to the Command
Timeline:
[v1.3.0-beta3](https://github.com/HelloThisWorld/winTerm/releases/tag/v1.3.0-beta3)
is published as a GitHub prerelease with the same asset layout. Betas are for
testing; the stable release above stays the recommended download.
An **alpha** prerelease is also available for early access to Pane Search:
[v1.4.0-alpha](https://github.com/HelloThisWorld/winTerm/releases/tag/v1.4.0-alpha)
is published as a GitHub prerelease with the same asset layout. Prereleases
are for testing; the stable release above stays the recommended download.

The installer is unsigned, so Windows may display Unknown Publisher or a
SmartScreen warning. Download only from the official release above and verify
Expand All @@ -37,7 +36,7 @@ application downloads are:
- `winTerm-<version>-setup-x64.exe` — current-user or all-users installation;
- `winTerm-<version>-portable-x64.zip` — extract and run without installation.

The current source version is `1.3.3`;
The current source version is `1.4.0-alpha`;
the latest stable release is `1.2.0`. See the
[latest official Release](https://github.com/HelloThisWorld/winTerm/releases/latest)
for the complete published asset list and checksums.
Expand Down Expand Up @@ -106,8 +105,8 @@ Use PowerShell 7 and the Microsoft Terminal toolchain described in
.\scripts\winterm\build.ps1 -Configuration Release -Platform x64 -IncludeTests
.\scripts\winterm\test.ps1 -Suite Relevant -Configuration Release -Platform x64
.\scripts\winterm\build-unpackaged.ps1 -Configuration Release -Platform x64
.\scripts\winterm\build-installer.ps1 -Version 1.3.3 -Platform x64
.\scripts\winterm\build-portable.ps1 -Version 1.3.3 -Platform x64
.\scripts\winterm\build-installer.ps1 -Version 1.4.0-alpha -Platform x64
.\scripts\winterm\build-portable.ps1 -Version 1.4.0-alpha -Platform x64
```

The unpackaged generator uses an unsigned MSIX only as an upstream build
Expand Down
2 changes: 1 addition & 1 deletion custom.props
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@
<XesUseOneStoreVersioning>true</XesUseOneStoreVersioning>
<XesBaseYearForStoreVersion>2026</XesBaseYearForStoreVersion>
<VersionMajor>1</VersionMajor>
<VersionMinor>3</VersionMinor>
<VersionMinor>4</VersionMinor>
<VersionInfoProductName Condition="'$(WindowsTerminalBranding)'=='WinTerm'">winTerm</VersionInfoProductName>
<VersionInfoProductName Condition="'$(VersionInfoProductName)'==''">Windows Terminal</VersionInfoProductName>
<VersionInfoCulture>1033</VersionInfoCulture>
Expand Down
52 changes: 28 additions & 24 deletions docs/current-progress.md
Original file line number Diff line number Diff line change
@@ -1,37 +1,38 @@
# Current development progress

Last updated: 2026-08-12
Last updated: 2026-08-13

## Repository state

- Branch: `feature/v1.3.3-pane-search-phase3`, based on `main` at
`97ecb7e85` (Pane Search Phase 2 checkpoint, pull request #45)
- Branch: `release/v1.4.0-alpha`, based on `main` at
`e436fdf00` (Pane Search Phase 3 checkpoint, pull request #46)
- Microsoft Terminal upstream revision:
`1cea42d433253d95c4487a3037db48197b5e72f4`
- Application version: `1.3.3`
- Package/file version: `1.3.3.0`
- PowerShell module version: `1.3.3` with no prerelease suffix
- Release channel: `stable` (engineering checkpoint; nothing is published)
- Checkpoint tag: `v1.3.3`, listed with the earlier checkpoint tags in the
release workflow so a pushed checkpoint tag runs quick validation only and
can never produce release artifacts
- Application version: `1.4.0-alpha`
- Package/file version: `1.4.0.0`
- PowerShell module version: `1.4.0` with prerelease suffix `alpha`
- Release channel: `alpha` (published as a GitHub prerelease)
- Release tag: `v1.4.0-alpha`. This is not an engineering checkpoint: the
tag runs the full guarded release pipeline (build, compiled tests,
artifact generation, draft asset round-trip testing, then publication as
a prerelease). The checkpoint-tag allowlist is unchanged.
- Current public Latest: `v1.2.0`, the stable Visual Progress release
- Newest published prerelease: `v1.3.0-beta3` on the beta channel
- Newest published prerelease: `v1.4.0-alpha` (replacing `v1.3.0-beta3`)
- Supported target: Windows 11 x64

`v1.3.3` is an engineering checkpoint, the third of the Pane Search roadmap
toward v1.4. Like the v1.2.1 through v1.2.4 Command Timeline checkpoints, it
is a source/development version only: no GitHub Release, website slot, or
WinGet update is produced, and `/releases/latest` keeps resolving to v1.2.0.
`v1.4.0-alpha` is the integration candidate of the Pane Search release. It
bundles the three engineering checkpoints (`1.3.1`, `1.3.2`, `1.3.3`) for
manual validation. `/releases/latest` keeps resolving to v1.2.0, and WinGet
is not updated for prereleases.

## Pane Search status (v1.4 roadmap)

- Phase 1 — active-pane search — complete at `1.3.1`.
- Phase 2 — search UX and scrollbar overview — complete at `1.3.2`.
- Phase 3 — performance and edge-case hardening — complete at `1.3.3`.
- Final integration — `1.4.0-alpha`, promoted to beta only after manual
user validation. Starting `1.4.0-alpha` requires a separate instruction;
it is not begun automatically.
- Final integration — `1.4.0-alpha` published for manual user validation.
`PASS` promotes to `1.4.0-beta`; `FAIL` produces a fixed `1.4.1-alpha`.
Only the user authorizes the alpha → beta promotion.

Phase 1 made `Ctrl+F` (with the retained `Ctrl+Shift+F` alias) open the
existing Microsoft Terminal search box inside the focused pane only,
Expand Down Expand Up @@ -189,12 +190,15 @@ through pull request #32:

## Next steps

1. Final integration checkpoint `1.4.0-alpha`, then manual user validation
before any beta promotion. This stage requires a separate instruction
from the user; do not begin it automatically.
2. Collect Command Timeline beta feedback; promote a stable `v1.3.0` only
after beta testing, which is the point at which Latest, WinGet, and the
website stable slot move.
1. Manual user validation of the published `v1.4.0-alpha` prerelease
(typing responsiveness, continuous output, huge match counts, resize
and reflow, split panes, alternate-screen applications, Unicode
queries, rapid open/close). `PASS` promotes to `1.4.0-beta`; `FAIL`
produces a fixed `1.4.1-alpha`. Only the user authorizes the
promotion.
2. Collect Command Timeline and Pane Search beta feedback; promote a
stable release only after beta testing, which is the point at which
Latest, WinGet, and the website stable slot move.

## Validation state

Expand Down
77 changes: 77 additions & 0 deletions docs/releases/1.4.0-alpha.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,77 @@
# winTerm 1.4.0-alpha

**This is an alpha prerelease.** The current stable release remains
[v1.2.0](https://github.com/HelloThisWorld/winTerm/releases/tag/v1.2.0), and
`/releases/latest` continues to point there. The alpha is published as a
GitHub prerelease for manual validation; it is not submitted to WinGet and
is not the recommended download for everyday use.

winTerm 1.4.0-alpha is the integration candidate of the **Pane Search**
release. It bundles the three engineering checkpoints of the Pane Search
roadmap (v1.3.1, v1.3.2, v1.3.3) on top of v1.3.0-beta3 for hands-on
testing before any beta promotion.

## What is new since v1.3.0-beta3: Pane Search

`Ctrl+F` opens Find in the **active pane only** (`Ctrl+Shift+F` stays as a
compatibility alias; both chords are remappable). The proven Microsoft
Terminal search pipeline is reused end to end — there is no second search
engine, no index, and no buffer duplication.

- **Search that follows your typing.** Results update live while you type,
across the pane's entire scrollback, with every match highlighted at
once. `Enter` / `Shift+Enter` step through matches with wrap-around;
case-sensitive and regular-expression modes are one toggle away; `Esc`
closes and returns focus to the shell. Typed characters never leak into
the terminal.
- **The winTerm search box.** The pane-local box follows the winTerm
compact overlay language — search glyph, input, `current / total` match
counter, case/regex toggles, previous/next, close — and adapts to narrow
panes through layout states that always keep the input and the close
button usable. The counter keeps the familiar semantics, including
`No results`, the bounded `999+` form, and the invalid-regex message.
- **A scrollbar search overview.** While search is open, the scrollbar
shows one marker per matching buffer row across the full scrollback,
with the current match's row emphasized at double width. The overview is
independent of the `showMarksOnScrollbar` setting (generic shell marks
keep obeying it), coexists with generic marks, disappears on close, and
respects a deliberately hidden scrollbar. Split panes keep fully
isolated search state, including their overview markers.
- **Hardened for real workloads.** Rapid typing is coalesced per pane
(leading keystroke searches immediately; the latest query always wins).
An open search keeps converging while output streams continuously —
`tail -f`-style logs update the counter, highlights, and overview
instead of freezing them — and a closed search costs the terminal
nothing. Scrolling with very large result sets no longer repaints
identical scrollbar pixels. Pane resize/reflow, scrollback eviction,
alternate-screen applications (`vim`, `less`, TUIs), wide characters
(CJK, emoji), and invalid regular expressions are all covered by
deterministic regression tests.

## What to validate in this alpha

This build exists for manual confirmation of the Pane Search experience
under real use: typing responsiveness at large scrollback, continuous
output with an open search, huge match counts, pane resize and reflow,
multiple panes with independent searches, alternate-screen entry/exit,
Unicode queries, and rapid open/close. A `PASS` verdict promotes this
build to `1.4.0-beta`; a `FAIL` produces a fixed `1.4.1-alpha`.

## Everything in v1.3.0-beta3 is included

The Command Timeline, Visual Progress, shell integration, Workspaces,
pane management, and all fixes through v1.3.0-beta3 ship unchanged in
this alpha.

## Downloads

- `winTerm-1.4.0-alpha-setup-x64.exe` — current-user or all-users
installation.
- `winTerm-1.4.0-alpha-portable-x64.zip` — extract and run without
installation (creates `portable.marker` alongside the executable).
- `SHA256SUMS.txt` — checksums for both application assets; verify before
running.

Requires Windows 11 x64. winTerm is an independent open-source project
based on Microsoft Terminal source code; it is not a Microsoft product and
is not affiliated with or endorsed by Microsoft.
6 changes: 3 additions & 3 deletions scripts/winterm/package-shell-assets.ps1
Original file line number Diff line number Diff line change
Expand Up @@ -32,9 +32,9 @@ foreach ($relativePath in $sourceAssets)
}

$version = Get-Content -LiteralPath (Join-Path $repositoryRoot 'shell\shared\version.json') -Raw | ConvertFrom-Json
if ($version.moduleVersion -ne '1.3.3' -or
$version.modulePrerelease -ne '' -or
$version.applicationVersion -ne '1.3.3' -or
if ($version.moduleVersion -ne '1.4.0' -or
$version.modulePrerelease -ne 'alpha' -or
$version.applicationVersion -ne '1.4.0-alpha' -or
$version.protocolVersion -ne 1)
{
throw 'The winTerm Shell asset version metadata is invalid.'
Expand Down
Loading