Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
178 commits
Select commit Hold shift + click to select a range
e9e8f91
docs: design the yourssh command-line interface and URL scheme
thangnm93 Nov 12, 2026
1cefcb8
docs: implementation plan for yourssh CLI phase 1
thangnm93 Nov 12, 2026
d327fae
merge: develop into feature/cli
thangnm93 Nov 12, 2026
a4bf6a6
docs: add the MCP server (phase 4) to the CLI design
thangnm93 Nov 12, 2026
b019bc7
feat(cli): wire protocol, endpoint paths and token file
thangnm93 Nov 12, 2026
3912f8b
fix(cli): do not apply the request size cap to responses
thangnm93 Nov 12, 2026
3fd48ac
feat(cli): host resolution and secret-free host summaries
thangnm93 Nov 12, 2026
2f8435b
feat(cli): request handling and URL validation in CliServer
thangnm93 Nov 12, 2026
47d4971
fix(cli): contain handler errors, restrict trusted path, tighten ad-h…
thangnm93 Nov 12, 2026
94b0d95
chore: sync develop with the 0.3.0 release
thangnm93 Nov 12, 2026
a8a7576
feat(cli): unix-socket listener with peer uid check
thangnm93 Nov 12, 2026
2678b4c
fix(cli): harden unix listener and add short-path endpoint fallback
thangnm93 Nov 12, 2026
d1dc390
feat(cli): start the CLI endpoint in the app and forward second launches
thangnm93 Nov 12, 2026
aefb0e4
fix(cli): own the endpoint via an exclusive lock, clean up on close, …
thangnm93 Nov 12, 2026
a53eb2c
feat(cli): yourssh:// URL scheme on macOS, Windows and Linux
thangnm93 Nov 12, 2026
6563e36
fix(cli): harden yourssh:// URL delivery and start-up ordering
thangnm93 Nov 12, 2026
e6a574a
feat(cli): yourssh executable with connect, ls, version and open
thangnm93 Nov 12, 2026
68cf6b5
fix(cli): token states, launch hardening, connect-phase retry rules a…
thangnm93 Nov 12, 2026
63dc00f
docs: describe the yourssh CLI and URL scheme
thangnm93 Nov 12, 2026
9e96329
docs: correct URL scheme registration per platform
thangnm93 Nov 12, 2026
8aac7e9
docs: complete the CLI not-yet list and Windows notes
thangnm93 Nov 12, 2026
4a20818
Merge remote-tracking branch 'origin/develop' into feature/cli
thangnm93 Nov 12, 2026
4c3dcd0
docs: UI redesign with forui (Amber Brand) design spec
thangnm93 Nov 12, 2026
f7a307f
docs: UI redesign phase 0-1 plan and task docs
thangnm93 Nov 12, 2026
bb2424b
feat(ui): add yourssh_ui package with forui
thangnm93 Nov 12, 2026
a9ec261
feat(cli): named-pipe transport for Windows
thangnm93 Nov 12, 2026
bbe4e2b
docs(cli): Windows named-pipe endpoint and single-instance forwarding
thangnm93 Nov 12, 2026
389a441
test: poll for the connection count in the local-forward test (CI flake)
thangnm93 Nov 12, 2026
0d1aaac
docs: Flutter 3.50 upgrade task docs
thangnm93 Nov 12, 2026
d78ab87
docs: UI redesign targets Flutter 3.50 and forui 0.27.7
thangnm93 Nov 12, 2026
37693e8
docs: plan targets Flutter 3.50
thangnm93 Nov 12, 2026
5653727
feat(ui): Amber Brand tokens and forui/Material themes
thangnm93 Nov 12, 2026
449d7d8
fix(ui): Material fallback theme uses the app's flutter/material Them…
thangnm93 Nov 12, 2026
1ca9e83
docs: optional phase 7 — evaluate dropping MaterialApp
thangnm93 Nov 12, 2026
00d3b01
fix(cli): Windows pipe errors without GetLastError
thangnm93 Nov 12, 2026
1b236ca
feat(ui): bundle Inter and wrap the app root in FTheme
thangnm93 Nov 12, 2026
867b680
ci: debug Android build on PRs
thangnm93 Nov 12, 2026
acb0c27
chore: commit Flutter's generated project migrations
thangnm93 Nov 12, 2026
dd3bd67
chore: build with Flutter 3.50.0
thangnm93 Nov 12, 2026
95ccc52
docs: Flutter 3.50 upgrade changelog
thangnm93 Nov 12, 2026
ff86971
docs: Flutter 3.50 upgrade report
thangnm93 Nov 12, 2026
e3dd685
feat(ui): switch the app palette to Amber Brand tokens
thangnm93 Nov 12, 2026
b990c07
feat(ui): YourSSH Amber terminal theme for new installs
thangnm93 Nov 12, 2026
5d871a3
docs: describe the yourssh_ui design system
thangnm93 Nov 12, 2026
569db55
Merge pull request #120 from YoursshLabs/chore/flutter-3.50
thangnm93 Nov 12, 2026
0d9b2b4
Merge remote-tracking branch 'origin/develop' into feature/ui-redesign
thangnm93 Nov 12, 2026
f1a0336
Merge remote-tracking branch 'origin/develop' into feature/cli
thangnm93 Nov 12, 2026
cd094f4
feat(ui): sidebar on FSidebar
thangnm93 Nov 12, 2026
ac8f5e3
feat(ui): session tab bar on YsTab
thangnm93 Nov 12, 2026
dff0fbc
fix(ui): tab close button keeps its space on hover
thangnm93 Nov 12, 2026
39fa15d
fix(cli): dev endpoint variant, launch and version fixes, private sha…
thangnm93 Nov 12, 2026
f6646a1
feat(ui): toasts on forui across the app
thangnm93 Nov 12, 2026
8f5520d
fix(ui): keep clearError when the settings screen unmounts
thangnm93 Nov 12, 2026
10606b3
fix(cli): take the instance lock before start-up, share the URL gate,…
thangnm93 Nov 12, 2026
5b2b9e9
docs(cli): lock-first start-up, dev endpoint, agent auth for ad-hoc h…
thangnm93 Nov 12, 2026
d1d57d3
perf(cli): skip the redundant chmod of the run dir before runApp
thangnm93 Nov 12, 2026
c6eed98
docs: UI redesign phases 2-6 implementation plan
thangnm93 Nov 12, 2026
dbb477c
test(cli): wider forward window for the lock-busy start-up claim test
thangnm93 Nov 12, 2026
be0300c
feat(ui): dialogs on forui across the app
thangnm93 Nov 12, 2026
d47ece6
docs: ui-redesign task changelog
thangnm93 Nov 12, 2026
6f4077a
fix(cli): open a URL once on slow starts; resilient stat lookup
thangnm93 Nov 12, 2026
ff2fd3a
Merge pull request #119 from YoursshLabs/feature/cli
thangnm93 Nov 12, 2026
322c0f5
fix(ui): dialog actions in one row, security focus tests and dialog p…
thangnm93 Nov 12, 2026
f729721
fix(ui): dialog actions stay on one row; bounded container picker
thangnm93 Nov 12, 2026
68a2106
docs: shell, toasts and dialogs on the design system
thangnm93 Nov 12, 2026
ed5bbd4
Merge remote-tracking branch 'origin/develop' into feature/ui-shell
thangnm93 Nov 12, 2026
ba64e19
docs: note the Flutter 3.50 merge
thangnm93 Nov 12, 2026
082f018
feat(ui): host card, OS tile, section header, empty state and badges
thangnm93 Nov 12, 2026
5405ef6
fix(ui): host card mono font, keyboard and semantics
thangnm93 Nov 12, 2026
e9f4e4d
feat(ui): hosts dashboard on forui
thangnm93 Nov 12, 2026
39812a2
fix(ui): token-only material scheme, tint-only dialog barrier, cached…
thangnm93 Nov 12, 2026
78e6349
fix(ui): lift tertiary text contrast, scrollable TOFU dialogs with re…
thangnm93 Nov 12, 2026
bcc81d1
fix(ui): notification bell and tab context menu on design-system tokens
thangnm93 Nov 12, 2026
dc1af07
fix(ui): sidebar header overflow, mobile toast offset, root test, int…
thangnm93 Nov 12, 2026
185be3f
test(cli): listen to the lock-busy claim before the owner starts
thangnm93 Nov 12, 2026
1b04fc6
perf(ui): stop per-frame SessionProvider rebuilds from remote desktops
thangnm93 Nov 12, 2026
a6ee6bf
fix(ui): dashboard keyboard focus and a11y polish
thangnm93 Nov 12, 2026
c33b5c4
feat(ui): host editor on forui
thangnm93 Nov 12, 2026
c376dc8
fix(session): ignore a cert error for a closed RDP tab; purge every p…
thangnm93 Nov 12, 2026
8a20a4c
test: real status-change baseline and RDP frame-rebuild coverage
thangnm93 Nov 12, 2026
5455134
test: silence the protected-member warning in the RDP probe test
thangnm93 Nov 12, 2026
4c95fc5
fix(ui): host editor validates every section on save
thangnm93 Nov 12, 2026
d17ccbe
feat(ui): import panel and bulk actions on forui
thangnm93 Nov 12, 2026
a2cad1d
test: wait for the onUploaded callback, not just the recorded upload …
thangnm93 Nov 12, 2026
062c8a2
feat(ui): terminal workspace chrome and side panels on forui
thangnm93 Nov 12, 2026
b883fc6
fix(ui): slider tap-to-jump, stable snippet groups, labelled actions
thangnm93 Nov 12, 2026
3e3b758
feat(ui): terminal bars, overlays and status bar on forui
thangnm93 Nov 12, 2026
bd754f1
docs: Task 12 mounts the session status bar in RDP/VNC workspaces
thangnm93 Nov 12, 2026
ba908be
fix(ui): input bar takes typing on open, accurate status bar, search …
thangnm93 Nov 12, 2026
5e950a6
feat(ui): SFTP panels on YsFileTable
thangnm93 Nov 12, 2026
a8d5e2e
fix(ui): SFTP keyboard flow, pane minimum, consistent open gesture
thangnm93 Nov 12, 2026
652da0e
feat(ui): transfers, file dialogs and editor chrome on forui
thangnm93 Nov 12, 2026
d76b629
fix(sftp): confirm before opening an executable from the local panel
thangnm93 Nov 12, 2026
56430c1
fix(ui): octal field error state, indeterminate transfer progress, ed…
thangnm93 Nov 12, 2026
24385f4
test(bulk): snippet button, compare pick and push overflow coverage
thangnm93 Nov 12, 2026
33ef801
feat(ui): settings on forui
thangnm93 Nov 12, 2026
07fc959
feat(ui): port forwarding, known hosts, recordings and audit on forui
thangnm93 Nov 12, 2026
86774dd
fix(ui): keyboard-reachable rule delete, port validation and manageme…
thangnm93 Nov 12, 2026
629e540
fix(ui): app-wide tile-group tap guard; whole-row switch toggles
thangnm93 Nov 12, 2026
0212c2a
fix(sync): confirm before disconnecting (removes the only sync key)
thangnm93 Nov 12, 2026
3dd8121
feat(ui): keys, sync, notifications and palette on forui
thangnm93 Nov 12, 2026
ce1cbe7
feat(ui): plugin screens and AI chat on forui
thangnm93 Nov 12, 2026
17c1e86
fix(ui): keychain test seam, palette keyboard tests and inert hidden …
thangnm93 Nov 12, 2026
f293f2d
fix(ui): plugin manager keyboard test, Enter-to-send in AI chat and t…
thangnm93 Nov 12, 2026
4c02ced
test: drop two unused imports flagged by the analyzer
thangnm93 Nov 12, 2026
05f7865
feat(ui): remote-desktop workspace chrome on forui with the session s…
thangnm93 Nov 12, 2026
56398f2
fix(ui): remote toolbar keeps canvas focus; explain toolbar settle
thangnm93 Nov 12, 2026
580ba32
feat(ui): container screens on forui
thangnm93 Nov 12, 2026
0727bda
fix(compose): confirm before bringing a stack down; keyboard reachabi…
thangnm93 Nov 12, 2026
9a7f331
feat(ui): devops tool screens on forui
thangnm93 Nov 12, 2026
b00a61c
fix(devops): mail body parsing, persistent Clear all, Cloudflare Ente…
thangnm93 Nov 12, 2026
a7a4752
fix(mail-catcher): append-mode, unbuffered log so cleared and new mai…
thangnm93 Nov 12, 2026
e974a9d
feat(ui): snippets and devops plugin packages on the design system
thangnm93 Nov 13, 2026
0eb92aa
fix(ui): plugin row actions inert while hidden; plugin-host dialog th…
thangnm93 Nov 13, 2026
c7fd570
feat(ui): web tools plugin on the design system
thangnm93 Nov 13, 2026
809f6d7
test(web-tools): loopback send-path coverage; icon and loading cue fixes
thangnm93 Nov 13, 2026
b1968a5
fix(web-tools): keep the URL caret in range when params change the URL
thangnm93 Nov 13, 2026
b270386
feat(ui): mobile foundations on forui
thangnm93 Nov 13, 2026
ade461a
fix(mobile): finish forui migration of shared primitives; toast inset…
thangnm93 Nov 13, 2026
ace5316
fix(hosts): validate the port range in the host editor
thangnm93 Nov 13, 2026
9d9f51a
feat(ui): mobile keys, sync and sftp screens on forui
thangnm93 Nov 13, 2026
32164f5
fix(mobile): obscure sync secrets, Lucide icons and header tooltips
thangnm93 Nov 13, 2026
8651367
feat(ui): mobile terminal and security gates on forui
thangnm93 Nov 13, 2026
9aa4feb
test(mobile): accessory keys keep terminal focus
thangnm93 Nov 13, 2026
f338d90
feat(ui): mobile host, settings, forwarding and snippet screens on forui
thangnm93 Nov 13, 2026
fed1d8f
fix(mobile): host port range, tag chip height, unique key picker
thangnm93 Nov 13, 2026
c34a48f
fix(ui): keyboard-reachable tabs, 44px touch items, Cloudflare tunnel…
thangnm93 Nov 13, 2026
a707519
refactor(ui): move shared form controls out of settings_tiles
thangnm93 Nov 13, 2026
2207ee9
chore(ui): token sweep, deprecate legacy colour aliases and add the U…
thangnm93 Nov 13, 2026
7b43904
fix(hosts): reset the host editor when the edited host changes
thangnm93 Nov 13, 2026
971edc6
fix(mail-catcher): skip ESMTP options preamble
thangnm93 Nov 13, 2026
cfe0360
fix(ui): confirm host and host-key removal
thangnm93 Nov 13, 2026
8c60a5e
fix(terminal): header and status bar follow host edits
thangnm93 Nov 13, 2026
fb7b802
fix(hosts): validate the proxy port range
thangnm93 Nov 13, 2026
2e34a5b
refactor(ui): migrate remaining sheets and fields; extend the UI lint…
thangnm93 Nov 13, 2026
caae90d
fix(terminal): restore an informational cue on the watch banner
thangnm93 Nov 13, 2026
423fd81
chore(ci): test yourssh_web_tools in the plugin matrix; document swit…
thangnm93 Nov 13, 2026
d5c7747
docs: complete the redesign changelog and design-system notes
thangnm93 Nov 13, 2026
57e7fa7
test(terminal): drop an unused import
thangnm93 Nov 13, 2026
f50a314
fix(editor): only text edits mark the fallback editor dirty
thangnm93 Nov 13, 2026
63340de
chore(ci): UI lint also catches generic calls such as showDialog<T>(
thangnm93 Nov 13, 2026
9475f01
fix(ui): centre tab content vertically
thangnm93 Nov 13, 2026
1622a20
fix(terminal): host chips on the left, header actions on the right
thangnm93 Nov 13, 2026
fc267f5
test(docs): user-journey screenshot harness
thangnm93 Nov 13, 2026
70dd8fd
fix(main-screen): defer SFTP connection setState when fired while the…
thangnm93 Nov 13, 2026
7825c08
fix(ssh): bound the dial with a connect timeout and show the retry re…
thangnm93 Nov 13, 2026
6142662
fix(ssh): close a socket whose dial finishes after the connect timeout
thangnm93 Nov 13, 2026
494482c
fix(plugins): stop shipping the half-migrated JS Snippets plugin
thangnm93 Nov 13, 2026
3110250
fix(plugins): reserve built-in plugin ids against script plugins
thangnm93 Nov 13, 2026
af4f3b7
fix(snippets): recover snippets a JS plugin migrated out of yourssh.s…
thangnm93 Nov 13, 2026
99101e9
fix(web-tools): top-align text in expanding code areas
thangnm93 Nov 13, 2026
9cce050
fix(terminal): anchor shell-integration gutter markers to buffer lines
thangnm93 Nov 13, 2026
3f98dca
fix(dartssh2): keep exit-status that arrives before the session handl…
thangnm93 Nov 13, 2026
2b2b646
fix(bulk): one rule for unknown/non-zero exit in row, footer and audit
thangnm93 Nov 13, 2026
6772e1f
fix(sftp): readable errors and already-exists check for create/rename
thangnm93 Nov 13, 2026
c73cd33
fix(ai-chat): stop ellipsizing the sidebar title when there is room
thangnm93 Nov 13, 2026
39bedc5
fix(ui): sentence case for keychain, port forwarding, audit and bulk …
thangnm93 Nov 13, 2026
68b1300
fix(terminal): tell the user how to fill an empty split pane
thangnm93 Nov 13, 2026
44c8237
fix(mobile): give keys bottom sheets an opaque card surface
thangnm93 Nov 13, 2026
07d25b6
fix(sync): close the QR export dialog on Escape like Cancel
thangnm93 Nov 13, 2026
0aebc2e
fix(remote): keep the RDP/VNC Retry button at a normal width
thangnm93 Nov 13, 2026
57094a2
fix(devops): stop the Mail Catcher list title ellipsizing with free s…
thangnm93 Nov 13, 2026
d0be276
fix(hosts): collapse the dashboard toolbar by priority so nothing cli…
thangnm93 Nov 13, 2026
716a3ef
fix(hosts): clear stale field errors on edit and shorten the port error
thangnm93 Nov 13, 2026
c685a53
fix(rdp): show a neutral waiting state during the first-use certifica…
thangnm93 Nov 13, 2026
cc7cbdc
docs: note the dartssh2/xterm patches and reserved plugin ids from th…
thangnm93 Nov 13, 2026
4cd2aba
test(docs): refresh the journey harness for the fix round
thangnm93 Nov 13, 2026
342b53a
docs: refresh README screenshots with the redesigned UI and log the d…
thangnm93 Nov 13, 2026
5f6278a
test(docs): force the phone-sized window for the mobile pass
thangnm93 Nov 13, 2026
b8d165c
fix(terminal): replace the pre-handshake prompt instead of leaving an…
thangnm93 Nov 13, 2026
34678d3
fix(devops): confirm before clearing captured mail
thangnm93 Nov 13, 2026
d0014b8
docs: note that the handshake gate replaces the pre-handshake prompt
thangnm93 Nov 13, 2026
6f519e5
test(terminal): guard that Esc dismissing an overlay never reaches th…
thangnm93 Nov 13, 2026
e10f5b5
test(docs): press Esc once after the tab colour submenu
thangnm93 Nov 13, 2026
63c6fd0
test(docs): final harness pass (mail clear dialog, no CR workaround, …
thangnm93 Nov 13, 2026
875d14b
docs: refresh README screenshots from the final journey run
thangnm93 Nov 13, 2026
8c6f0cd
Merge pull request #121 from YoursshLabs/feature/ui-shell
thangnm93 Nov 13, 2026
a75dd8c
release: 0.4.0 — Amber Brand redesign, yourssh CLI and docs-run fixes
thangnm93 Nov 13, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
5 changes: 5 additions & 0 deletions .docs/flutter-3-50-upgrade/brief.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
# Flutter 3.50 upgrade — brief

**What:** Move CI and the release builds from Flutter 3.47.1 to the latest stable, **3.50.0** (Dart 3.14, released 2026-11-11). This includes the Android toolchain bumps that 3.50 requires.

**Why:** The owner asked for the latest Flutter and forui (2026-11-12). forui 0.27.7, the latest version, is the base of the UI redesign.
22 changes: 22 additions & 0 deletions .docs/flutter-3-50-upgrade/changelog.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,22 @@
# Changelog

- 2026-11-12: Started. The owner asked for the latest Flutter and forui.
- 2026-11-12: Flutter 3.50.0 upgrade done on `chore/flutter-3.50` (full detail in `report.md`).
- **CI pin** 3.47.1 → 3.50.0 in `pr-test.yml` and `release.yml`. Tag `3.50.0` exists upstream (ab2912035e) and is in the stable release manifests, so both `subosito/flutter-action` and the ARM64 `git clone -b` steps resolve it.
- **Android toolchain.** Gradle 9.1.0 → 9.5.1, AGP 9.0.1 → 9.3.3, Kotlin 2.3.20 → 2.4.21. Why: Flutter 3.50's Gradle plugin throws below Gradle 9.3.1 / AGP 9.1.1 / KGP 2.4.10 and warns below 9.5.0 / 9.3.1 / 2.4.20. The versions chosen are the newest set inside every compatibility table:
- KGP 2.4.20–2.4.21 documents AGP ≤ 9.3.1, so AGP stays on 9.3.x (9.3.3 is the newest patch; 9.3.2 fixed a lint crash on JDK 17).
- AGP 9.3 needs Gradle ≥ 9.5.0. Flutter 3.50 tests and knows Gradle only up to 9.5.0, so Gradle stays on 9.5.x (9.5.1).
- AGP 9.4 and 9.5 are outside KGP 2.4's documented range, and Kotlin 2.5.0 is only an RC.
- No DSL migration was needed. The app already matches the 3.50 template (`android.newDsl=false`, `android.builtInKotlin=false`, `kotlin { compilerOptions }`). `minSdk` 24, `targetSdk` 36, `compileSdk` 36 and NDK 28.2 are the same in 3.47.1 and 3.50.0.
- `packages/flutter_pty/android` was left unchanged: it has a namespace, no Kotlin, and its buildscript AGP 8.1.0 classpath is shadowed by the app's settings classpath, as before.
- **New `android` job** in `pr-test.yml` runs `flutter build apk --debug`, on JDK 17 and `setup-java` v6 pinned by SHA. The `test` gate now needs it. Before this, the Android build was only exercised by `release.yml` on master, which is how PR #113's breakage went unnoticed.
- **Lock.** `app/pubspec.lock` changed only in SDK-pinned packages: matcher, meta, test_api, stack_trace, clock, vector_math, and the new `listen` dependency of `package:flutter`. All URLs are pub.dev.
- **Generated project migrations (separate commit).** These come from Flutter 3.47.1 too, not from 3.50. The 0.3.0 release build on 3.47.1 printed the same "Upgrading …" lines. Develop simply never committed them, so every local build dirtied the tree.
- `pub get` adds `analyzer.exclude` (`build/**` and the platform folders) to `app/analysis_options.yaml`. The block was moved below `include:`.
- `flutter build macos` raises `MACOSX_DEPLOYMENT_TARGET` / `platform :osx` from 10.15 to 12.0.
- Swift Package Manager is on by default, so `Podfile.lock` only lists the plugins that lack SwiftPM support.
- Shipped builds already target macOS 12.0, so this is not a new user-facing requirement.
- The two Xcode `swiftpm/Package.resolved` files the build creates stay untracked, as in the main checkout.
- **Analyzer.** 0 issues on 3.47.1 → 214 infos on 3.50.0, all `deprecated_member_use` for `package:flutter/material.dart`. The material_ui migration is a separate task.
- **Docs.** CLAUDE.md gained a Toolchain section (the pin and the "bump Android with Flutter" rule). CHANGELOG `[Unreleased]` says "Built with Flutter 3.50".
- 2026-11-12: PR #120 green (incl. new android job; only notice: third-party plugins still apply KGP); merged into develop.
16 changes: 16 additions & 0 deletions .docs/flutter-3-50-upgrade/context.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,16 @@
# Context

**Earlier attempt.** CI was pinned to 3.47.1 in PR #113, because Flutter 3.50 rejected the Android toolchain.
- Flutter 3.50 requires Gradle ≥ 9.3.1, AGP ≥ 9.1.1 and Kotlin ≥ 2.4.10.
- The app uses Gradle 9.1.0, AGP 9.0.1 and Kotlin 2.3.20.

**Pins** (`FLUTTER_VERSION`):
- `.github/workflows/pr-test.yml`
- `.github/workflows/release.yml`, which also has two `git clone -b $FLUTTER_VERSION` steps for Windows and Linux.

**Android modules:**
- `app/android`
- `packages/flutter_pty/android` (local fork)
- any other plugin package that has an `android/` directory

**Analyzer.** About 215 analyzer infos come from material.dart deprecations in 3.47+. CI uses `--no-fatal-infos`.
7 changes: 7 additions & 0 deletions .docs/flutter-3-50-upgrade/plan.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Plan

1. Bump `FLUTTER_VERSION` to 3.50.0 in every workflow.
2. Bump Android Gradle, AGP and Kotlin to Flutter 3.50's minimums or later, in app and in the forked plugin modules. Migrate any AGP 9 DSL breakages.
3. Run `flutter pub get` on 3.50. The lock must contain only pub.dev URLs.
4. Run `flutter analyze` (0 errors) and `flutter test` (green). Build macOS and Android (`flutter build apk --debug`) locally.
5. Open a PR and get CI green.
59 changes: 59 additions & 0 deletions .docs/flutter-3-50-upgrade/report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
# Flutter 3.50 upgrade — report

## Versions

| | Before | After | Flutter 3.50 rejects below / warns below |
|---|---|---|---|
| Flutter | 3.47.1 | **3.50.0** (Dart 3.14.0) | — |
| Gradle | 9.1.0 | **9.5.1** | 9.3.1 / 9.5.0 |
| AGP | 9.0.1 | **9.3.3** | 9.1.1 / 9.3.1 |
| Kotlin | 2.3.20 | **2.4.21** | 2.4.10 / 2.4.20 |
| JDK | 17 | 17 | — |

`minSdk`, `targetSdk`, `compileSdk` and the NDK version are unchanged.

Each version is the newest that all parties document as compatible:
- **Kotlin 2.4.21** is the newest stable release.
- **AGP 9.3.3:** Kotlin 2.4 supports AGP up to 9.3.x.
- **Gradle 9.5.1:** AGP 9.3 needs Gradle 9.5 or later.
- **AGP 9.4 and 9.5 are excluded.** They need Gradle 9.6, which is outside the AGP range Kotlin 2.4 supports.

Sources:
- Flutter SDK 3.50.0: `DependencyVersionChecker.kt` and `gradle_utils.dart`
- kotlinlang.org, the Gradle compatibility table
- The AGP 9.3, 9.4 and 9.5 release notes

## Changes

- **CI pins.** `pr-test.yml` and `release.yml` move to 3.50.0.
- **New `android` job in pr-test.** It runs `flutter build apk --debug` with Temurin 17, has a 30-minute timeout and needs no secrets. It is part of the `test` aggregate.
- **Android build files.** `gradle-wrapper.properties` now points to Gradle 9.5.1. `settings.gradle.kts` now uses AGP 9.3.3 and Kotlin 2.4.21.
- **Lockfile.** Only the versions the 3.50 SDK forces changed:

| Package | Version |
|---|---|
| clock | 1.1.3 |
| matcher | 0.12.20 |
| meta | 1.19.0 |
| stack_trace | 1.12.2 |
| test_api | 0.7.14 |
| vector_math | 2.4.4 |
| listen | 1.0.1 (new) |

All URLs are on pub.dev.
- **Generated project migrations committed.** These are the `analysis_options` excludes, the macOS deployment target 12.0, and the Podfile/SPM change. The 0.3.0 release build already applied them, but develop never committed them.

## Verification

- **Analyze:** 0 errors, 0 warnings, 214 infos. The infos are `deprecated_member_use` warnings about material.dart.
- **App tests:** 2023 passed, 3 skipped.
- **Bridge tests:** rdp and vnc pass.
- **macOS build:** `flutter build macos --debug` succeeds.
- **Android:** verified only by the new CI job, since there is no Android SDK locally.

## Risks

- Only master runs the release-only builds: the release APK, the Windows and Linux desktop builds, and the macOS release build.
- `flutter analyze --suggestions` caps the AGP 9.3 template at Gradle 9.5.0. This is a tooling cap, not a build break.
- AGP 10 will remove the old DSL, including `newDsl=false`, `builtInKotlin=false` and the `BaseExtension` compileSdk hack.
- `release.yml` still uses setup-java v4, which only produces a deprecation warning.
9 changes: 9 additions & 0 deletions .docs/ui-redesign/brief.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# UI redesign with forui — brief

**What:** Redesign every YourSSH screen on the forui design system, "Amber Brand" direction (B): dark stone neutrals, amber accent, bundled Inter font, Lucide icons. Same look on macOS, Windows, Linux, Android and iOS.

**Why:** The owner finds every screen unattractive and inconsistent across platforms.

**Docs:**
- Spec: `docs/superpowers/specs/2026-11-12-yourssh-ui-redesign-design.md`
- Mockups: `docs/superpowers/specs/assets/ui-redesign/`
10 changes: 10 additions & 0 deletions .docs/ui-redesign/changelog.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
# Changelog

- 2026-11-12: Built the spike: 3 directions, 18 screenshots. The owner chose B.
- 2026-11-12: Spec written. A builder check raised 6 questions, all settled as defaults (see "Decided here").
- 2026-11-12: Phase 0–1 plan written.
- 2026-11-12: Phase 0 done (PR #118, awaiting owner OK). Phase 1 tasks 7-9 done on feature/ui-shell. Phases 2-6 plan written (17 tasks).
- 2026-11-12: Phase 1 (shell) done on feature/ui-shell.
- 2026-11-12: Phases 2-6 plan written and executed (phases 2-5 desktop, phase 6 mobile); Task 17 token sweep, lint gate and docs done.
- 2026-11-13: Final review fix round (P30): host editor remounts per edit target (data-loss fix), mail catcher skips the ESMTP options preamble, confirms for dashboard host Delete and Known Hosts Remove, terminal header and status bar follow host edits, proxy port range check, discovery and monitor sheets plus inline rename and fallback editor on forui, lint gate extended, `yourssh_web_tools` in the plugin CI matrix, watch banner cue restored, docs completed.
- 2026-11-13: Docs user-journey harness (app/integration_test/docs/) drove the final app against demo containers and captured 208 screenshots (untracked, screenshots/docs/). Its findings plus a controller review of every shot gave 22 fixes in 4 parallel worktrees (P31), incl. a pre-existing snippets data-loss bug from the half-migrated bundled JS Snippets plugin (P32). Journey re-run clean; README screenshots refreshed from it.
20 changes: 20 additions & 0 deletions .docs/ui-redesign/context.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
# Context

**Spike.** forui 0.27.7 needs Flutter >=3.47 and Dart >=3.13. The app now builds on Flutter 3.50.0 (CI pins it). The throwaway spike lives in the session scratchpad.

**Current UI.**
- Palette: `AppColors` with a green accent, plus a separate mobile palette `MobileColors`/`MobileTokens`.
- Theme: Material `buildAppTheme()`; mobile uses `google_fonts`, which fetches fonts at runtime.
- `AppColors.accent`: 193 uses in 46 files. Some mean "success", others mean "primary".
- Material widgets: 117 of 261 files import Material.

**Shell.** The shell is inside `app/lib/screens/main_screen.dart`: `_Sidebar` and `_TopTabBar` (1842 lines). Session tab: `app/lib/widgets/session_tab.dart`.

**Terminal theme.** "YourSSH Dark" already exists in the catalog. The new default is therefore named "YourSSH Amber" and applies to new installs only.

**State after phases 2-6.**
- The whole app (desktop and mobile) and the Snippets, DevOps and Web Tools plugins are on forui and the `yourssh_ui` components (`YsTab`, `YsFileTable`, `YsHostCard`, `YsStatusBar`, `YsPluginHost`, dialogs, toasts).
- `AppColors` and `MobileColors` stay as `@Deprecated` aliases of `YsColors`.
- `tool/check_ui_lint.sh` blocks Material `IconButton(`, `AlertDialog(`, `SnackBar(`, `Icons.`, `ScaffoldMessenger`, `showDialog(`, `showModalBottomSheet` and `TextField(`; the allowlist is empty.
- The host editor (`HostDetailPanel`) reads `existing` only in `initState`, so the shell mounts it with `hostEditorKey(editing, serial)`.
- Terminal header chips and the status bar read the host through `selectLiveHost` (fresh `HostProvider` lookup, snapshot fallback).
7 changes: 7 additions & 0 deletions .docs/ui-redesign/plan.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
# Plan

- Phases 0-1 plan: `docs/superpowers/plans/2026-11-12-yourssh-ui-redesign-phase0-1.md` (done: foundation + shell).
- Phases 2-6 plan: `docs/superpowers/plans/2026-11-12-yourssh-ui-redesign-phase2-6.md` (done: dialogs and settings, hosts/dashboard/editor, terminal workspace, SFTP and tools, web tools, mobile).
- Task 17: token sweep, `AppColors`/`MobileColors` deprecated aliases, UI lint gate (`tool/check_ui_lint.sh`), CLAUDE.md and CHANGELOG.
- Final whole-branch review fix round (ruling P30): host editor reset, mail parser, delete/host-key confirms, live host in header and status bar, proxy port range, remaining Material sheets and fields, lint extension, CI for `yourssh_web_tools`, docs.
- Decision ledger and rulings P1-P30: `.superpowers/sdd/2026-11-12-yourssh-ui-redesign-phase2-6/progress.md`.
164 changes: 158 additions & 6 deletions .github/workflows/pr-test.yml
Original file line number Diff line number Diff line change
Expand Up @@ -19,11 +19,13 @@ concurrency:
group: ${{ github.workflow }}-${{ github.event.pull_request.number || github.ref }}
cancel-in-progress: true

# Flutter is pinned: the stable channel moved to 3.50, which deprecates
# package:flutter/material.dart and requires Gradle >= 9.3.1 / AGP >= 9.1.1 /
# Kotlin >= 2.4.10 for Android. Bump this together with that migration.
# Flutter is pinned so a new stable release never changes CI under an open PR.
# Bump it together with release.yml and with the Android toolchain in
# app/android (Gradle wrapper, AGP and Kotlin in settings.gradle.kts): each
# Flutter release raises the minimum versions its Gradle plugin accepts, and
# the `android` job below is what proves the pair still builds.
env:
FLUTTER_VERSION: 3.47.1
FLUTTER_VERSION: 3.50.0

jobs:
# The app suite needs no Rust at all: nothing under app/test loads the native
Expand Down Expand Up @@ -62,6 +64,63 @@ jobs:
working-directory: app
run: flutter test

# forui-based UI kit: pure Dart widgets, no native bridge, so a small job.
ui:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7

- uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 # v2
with:
channel: stable
flutter-version: ${{ env.FLUTTER_VERSION }}

# Pure shell, no Flutter needed: fails on new Material IconButton /
# AlertDialog / SnackBar / Icons. / ScaffoldMessenger outside yourssh_ui.
- name: UI lint gate
run: |
bash tool/check_ui_lint_selftest.sh
bash tool/check_ui_lint.sh

- name: Install dependencies
working-directory: packages/yourssh_ui
run: flutter pub get

- name: Analyze (yourssh_ui)
working-directory: packages/yourssh_ui
run: flutter analyze --no-fatal-infos

- name: Test (yourssh_ui)
working-directory: packages/yourssh_ui
run: flutter test

# Plugin packages built on yourssh_ui; pure Dart/Flutter, no native bridge.
plugins:
runs-on: ubuntu-latest
strategy:
fail-fast: false
matrix:
package: [yourssh_snippets, yourssh_devops, yourssh_web_tools]
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7

- uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 # v2
with:
channel: stable
flutter-version: ${{ env.FLUTTER_VERSION }}

- name: Install dependencies
working-directory: packages/${{ matrix.package }}
run: flutter pub get

- name: Analyze (${{ matrix.package }})
working-directory: packages/${{ matrix.package }}
run: flutter analyze --no-fatal-infos

- name: Test (${{ matrix.package }})
working-directory: packages/${{ matrix.package }}
run: flutter test

# One job per Rust crate. The cargo tests, build.sh and the Dart bridge tests
# stay together on purpose: both cargo invocations use --release, so the
# library build reuses the test build's compilation. Splitting them across jobs
Expand Down Expand Up @@ -98,19 +157,112 @@ jobs:
working-directory: packages/${{ matrix.crate }}
run: flutter test

# Debug APK only: proves the Android toolchain (Gradle / AGP / Kotlin in
# app/android) still satisfies the pinned Flutter's Gradle plugin and that
# every Android plugin module, including the flutter_pty fork's CMake build,
# still compiles. It needs no secrets: debug builds sign with the debug key
# the Android SDK generates, and the mobile UI is SSH-only, so no Rust
# libraries are built (same as release.yml's build-android).
android:
runs-on: ubuntu-latest
timeout-minutes: 30
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7

# AGP 9 needs JDK 17 or newer; 17 matches release.yml's build-android.
- uses: actions/setup-java@b843ebf9b913146b38da2eaa7aeddf76074ae1ad # v6
with:
distribution: temurin
java-version: '17'

- uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 # v2
with:
channel: stable
flutter-version: ${{ env.FLUTTER_VERSION }}

- name: Install dependencies
working-directory: app
run: flutter pub get

- name: Build debug APK
working-directory: app
run: flutter build apk --debug

# Pure-Dart CLI protocol package: no Flutter, no native libs.
cli:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7

- uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 # v2
with:
channel: stable
flutter-version: ${{ env.FLUTTER_VERSION }}

- name: Install dependencies
working-directory: packages/yourssh_cli
run: dart pub get

- name: Test (yourssh_cli)
working-directory: packages/yourssh_cli
run: dart test

- name: Compile smoke (yourssh_cli)
working-directory: packages/yourssh_cli
run: dart compile exe bin/yourssh.dart -o "$RUNNER_TEMP/yourssh"

# The Windows CLI endpoint (named pipe, DACL, SID checks, cli.lock) only
# runs on Windows: the package suite, a compile smoke and the app's CLI
# tests on a real runner. No app build.
windows-cli:
runs-on: windows-latest
timeout-minutes: 20
steps:
- uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7

- uses: subosito/flutter-action@1a449444c387b1966244ae4d4f8c696479add0b2 # v2
with:
channel: stable
flutter-version: ${{ env.FLUTTER_VERSION }}

- name: Install dependencies (yourssh_cli)
working-directory: packages/yourssh_cli
run: dart pub get

- name: Test (yourssh_cli)
working-directory: packages/yourssh_cli
run: dart test

- name: Compile smoke (yourssh_cli)
working-directory: packages/yourssh_cli
shell: bash
run: dart compile exe bin/yourssh.dart -o "$RUNNER_TEMP/yourssh.exe"

- name: Install dependencies (app)
working-directory: app
run: flutter pub get

- name: Test (app CLI services)
working-directory: app
run: flutter test test/services/cli/

# Aggregate gate. master's branch protection requires a check literally named
# "test", so that name has to survive the split — this job carries it, and it
# is red unless every job above is green. `always()` matters: without it the
# job would be skipped when something fails, leaving the required check pending
# forever instead of failing.
test:
name: test
needs: [app, bridge]
needs: [app, ui, bridge, android, cli, windows-cli]
if: always()
runs-on: ubuntu-latest
steps:
- name: Check job results
run: |
echo "app=${{ needs.app.result }} bridge=${{ needs.bridge.result }}"
echo "app=${{ needs.app.result }} ui=${{ needs.ui.result }} bridge=${{ needs.bridge.result }} android=${{ needs.android.result }} cli=${{ needs.cli.result }} windows-cli=${{ needs.windows-cli.result }}"
[ "${{ needs.app.result }}" = "success" ] || exit 1
[ "${{ needs.ui.result }}" = "success" ] || exit 1
[ "${{ needs.bridge.result }}" = "success" ] || exit 1
[ "${{ needs.android.result }}" = "success" ] || exit 1
[ "${{ needs.cli.result }}" = "success" ] || exit 1
[ "${{ needs.windows-cli.result }}" = "success" ] || exit 1
Loading
Loading