Skip to content

The ultimate harness for coding agents and beyond. All your agents. All your machines. One command center. Start with code, then follow your curiosity and build across disciplines: CAD, circuits, robots, games and music.

Reuse validated catalogs and keep the canvas stable when pickers open

dee339f008bb56b
diff --git a/desktop/lib/screens/swarm_screen.dart b/desktop/lib/screens/swarm_screen.dart
index b60d55de7..54c0b3b97 100644
--- a/desktop/lib/screens/swarm_screen.dart
+++ b/desktop/lib/screens/swarm_screen.dart
@@ -77,6 +77,8 @@ class _SwarmScreenState extends State<SwarmScreen> {
skipTraversal: true,
);
final _navigation = SwarmNavigationHistory();
+ final _searchCatalog = SwarmSearchCatalog();
+ final _locationCatalog = SwarmLocationCatalog();
final _searchText = TextEditingController();
final _searchFocus = FocusNode(debugLabel: 'Search agents and swarms');
SwarmSearchController? _search;
@@ -694,12 +696,14 @@ class _SwarmScreenState extends State<SwarmScreen> {
adding: adding,
navigating: !adding,
split: split,
+ catalog: _searchCatalog,
+ locations: _locationCatalog,
)..setQuery(query);
_search!.addListener(_syncSearch);
_searchOverlay = OverlayEntry(builder: _buildSearchOverlay);
Overlay.of(context).insert(_searchOverlay!);
_syncSearch();
- setState(() {});
+ // The overlay and focus nodes update independently of the retained canvas.
_focusSearch();
}
@@ -762,7 +766,6 @@ class _SwarmScreenState extends State<SwarmScreen> {
_shellFocus.requestFocus();
}
}
- if (mounted) setState(() {});
}
Future<void> _chooseSearch(SwarmSearchSelection choice) async {
@@ -1320,6 +1323,7 @@ class _SwarmScreenState extends State<SwarmScreen> {
app: app,
projects: _projects,
recent: _navigation.recent,
+ catalog: _searchCatalog,
commands: _searchCommands,
onChoose: _activateSearch,
onNewAgent: _newAgent,
diff --git a/desktop/lib/state/swarm_search.dart b/desktop/lib/state/swarm_search.dart
index 96084ce5a..ef15211c4 100644
--- a/desktop/lib/state/swarm_search.dart
+++ b/desktop/lib/state/swarm_search.dart
@@ -20,7 +20,11 @@ class SwarmSearchController extends ChangeNotifier {
this.adding = false,
this.navigating = false,
this.split,
- }) : targetId = app.activeSwarmId,
+ SwarmSearchCatalog? catalog,
+ SwarmLocationCatalog? locations,
+ }) : _cache = catalog ?? SwarmSearchCatalog(),
+ _locations = locations ?? SwarmLocationCatalog(),
+ targetId = app.activeSwarmId,
targetName = app.activeSwarm.name {
_refresh();
app.addListener(_refresh);
@@ -41,8 +45,10 @@ class SwarmSearchController extends ChangeNotifier {
bool get allowsCommands => split == null && history == null;
bool get isCommandMode => allowsCommands && query.trimLeft().startsWith('>');
final String targetId, targetName;
- final _cache = SwarmSearchCatalog();
- final _locations = SwarmLocationCatalog();
+ // The workspace can retain normalized metadata across picker openings. Each
+ // read still validates its snapshot; query, selection and output stay local.
+ final SwarmSearchCatalog _cache;
+ final SwarmLocationCatalog _locations;
List<SwarmDestination> _catalog = const [];
Set<String> _catalogIds = const {};
Set<String> _commandIds = const {};
diff --git a/desktop/lib/widgets/swarm_inline_search.dart b/desktop/lib/widgets/swarm_inline_search.dart
index 7a821c983..c824e1493 100644
--- a/desktop/lib/widgets/swarm_inline_search.dart
+++ b/desktop/lib/widgets/swarm_inline_search.dart
@@ -23,6 +23,7 @@ class SwarmInlineSearch extends StatefulWidget {
required this.onChoose,
this.commands,
this.onNewAgent,
+ this.catalog,
});
final AppNotifier app;
@@ -30,6 +31,7 @@ class SwarmInlineSearch extends StatefulWidget {
final List<String> recent;
final List<SwarmDestination> Function()? commands;
final VoidCallback? onNewAgent;
+ final SwarmSearchCatalog? catalog;
final void Function(SwarmSearchSelection choice, String target) onChoose;
@override
@@ -41,6 +43,7 @@ class _SwarmInlineSearchState extends State<SwarmInlineSearch> {
final _focus = FocusNode(debugLabel: 'New swarm search');
final _overlay = OverlayPortalController();
final _tapGroup = Object();
+ final _catalog = SwarmSearchCatalog();
SwarmSearchController? _search;
AppKeymap? _keymap;
@@ -76,6 +79,7 @@ class _SwarmInlineSearchState extends State<SwarmInlineSearch> {
projects: widget.projects,
commands: widget.commands,
adding: true,
+ catalog: widget.catalog ?? _catalog,
)..setQuery(_text.text);
_search!.addListener(_changed);
_overlay.show();
diff --git a/desktop/test/benchmarks/swarm_add_benchmark.dart b/desktop/test/benchmarks/swarm_add_benchmark.dart
index 512aafc03..5ce62e0af 100644
--- a/desktop/test/benchmarks/swarm_add_benchmark.dart
+++ b/desktop/test/benchmarks/swarm_add_benchmark.dart
@@ -55,11 +55,17 @@ void main() {
addTearDown(() => messenger.setMockMethodCallHandler(native, null));
await mount(tester, app, nativeTabs: true);
+ var openDispatchMicros = 0;
+ var openFrameMicros = 0;
Future<void> open() async {
+ final watch = Stopwatch()..start();
await tester.sendKeyDownEvent(LogicalKeyboardKey.meta);
await tester.sendKeyEvent(LogicalKeyboardKey.keyN);
await tester.sendKeyUpEvent(LogicalKeyboardKey.meta);
+ openDispatchMicros = watch.elapsedMicroseconds;
+ watch.reset();
await tester.pump();
+ openFrameMicros = watch.elapsedMicroseconds;
}
Future<void> close() async {
@@ -96,7 +102,17 @@ void main() {
return counts;
}
- final opening = await measure((_) => open(), after: close);
+ final dispatchTimes = <int>[];
+ final frameTimes = <int>[];
+ final opening = await measure((i) async {
+ await open();
+ if (i >= 20) {
+ dispatchTimes.add(openDispatchMicros);
+ frameTimes.add(openFrameMicros);
+ }
+ }, after: close);
+ final openingRebuilds = await rebuilds(open);
+ final closingRebuilds = await rebuilds(close);
await open();
final field = find.byKey(const ValueKey('swarm-search-input'));
final controller = tester
@@ -128,7 +144,7 @@ void main() {
expect(target.panes, panes);
expect(tester.takeException(), isNull);
debugPrint(
- 'SWARM_BENCH ${jsonEncode({'kind': 'headless_debug_cpu', 'operation': 'add_picker_frame', 'agents': 2000, 'machines': 1, 'projects': 50, 'retainedTerminals': 5, 'scrollbackLinesPerTerminal': 1000, 'viewport': '1280x800', 'nativeBridge': 'stubbed', 'openAndFrame': opening, 'queryAndFrame': typing, 'arrowAndFrame': arrows, 'queryRebuilds': typingRebuilds, 'arrowRebuilds': arrowRebuilds})}',
+ 'SWARM_BENCH ${jsonEncode({'kind': 'headless_debug_cpu', 'operation': 'add_picker_frame', 'agents': 2000, 'machines': 1, 'projects': 50, 'retainedTerminals': 5, 'scrollbackLinesPerTerminal': 1000, 'viewport': '1280x800', 'nativeBridge': 'stubbed', 'openAndFrame': opening, 'openDispatch': distribution(dispatchTimes), 'openFrame': distribution(frameTimes), 'queryAndFrame': typing, 'arrowAndFrame': arrows, 'openingRebuilds': openingRebuilds, 'closingRebuilds': closingRebuilds, 'queryRebuilds': typingRebuilds, 'arrowRebuilds': arrowRebuilds})}',
);
await close();
await tester.pumpWidget(const SizedBox());
diff --git a/desktop/test/swarm_search_render_test.dart b/desktop/test/swarm_search_render_test.dart
index 7e6899f38..e9bf6e44e 100644
--- a/desktop/test/swarm_search_render_test.dart
+++ b/desktop/test/swarm_search_render_test.dart
@@ -1,6 +1,7 @@
import 'package:flutter/material.dart';
import 'package:flutter/services.dart';
import 'package:flutter_test/flutter_test.dart';
+import 'package:harness/core/models.dart';
import 'package:harness/screens/swarm_screen.dart';
import 'package:harness/shared/theme/app_theme.dart' as grid;
import 'package:harness/shared/theme/color_palette.dart';
@@ -8,12 +9,227 @@ import 'package:harness/state/app_state.dart';
import 'package:harness/state/swarm_navigation.dart';
import 'package:harness/terminal/terminal_binary.dart';
import 'package:harness/widgets/swarm_search_input.dart';
+import 'package:harness/widgets/swarm_switcher.dart';
+import 'package:xterm/xterm.dart';
import 'swarm_interactions_test.dart' show chord;
import 'swarm_screen_test.dart' show mount, terminal;
import 'swarm_state_test.dart' show createApp;
+class _CatalogMachine extends MachineState {
+ _CatalogMachine(super.machine);
+ var projectReads = 0;
+
+ @override
+ AgentProject? projectOf(Agent agent) {
+ projectReads++;
+ return super.projectOf(agent);
+ }
+}
+
void main() {
+ for (final add in [false, true]) {
+ testWidgets(
+ 'reopened ${add ? 'Add' : 'Navigate'} sees changed metadata and membership',
+ (tester) async {
+ final app = createApp();
+ final machine = app.machineStates['m']!;
+ machine.nodeOnline = true;
+ const original = Agent(
+ id: 'a0',
+ name: 'Original agent',
+ engine: 'codex',
+ terminalAvailable: true,
+ project: AgentProject(
+ name: 'Workbench',
+ cwd: '/work/workbench',
+ branch: 'before-branch',
+ ),
+ );
+ machine.agents = [
+ original,
+ ...machine.agents.where((agent) => agent.id != original.id),
+ ];
+ final input = <TerminalBinaryFrame>[];
+ app.adoptSessionForTest(terminal('a0', input));
+ final source = app.activeSwarm;
+ app.newSwarm();
+ app.adoptSessionForTest(terminal('a69', input));
+ final target = app.activeSwarm;
+ await mount(tester, app);
+ final field = find.byKey(const ValueKey('swarm-search-input'));
+ Future<void> open() => chord(
+ tester,
+ add ? LogicalKeyboardKey.keyN : LogicalKeyboardKey.keyP,
+ );
+ SwarmSearchKeys keys() => tester.widget<SwarmSearchKeys>(
+ find.ancestor(of: field, matching: find.byType(SwarmSearchKeys)),
+ );
+ await open();
+ await tester.enterText(field, 'before-branch');
+ await tester.pump();
+ expect(
+ keys().search!.rows.singleWhere((row) => row.agentId == 'a0').title,
+ 'Original agent',
+ );
+ await tester.sendKeyEvent(LogicalKeyboardKey.escape);
+ await tester.pump();
+
+ await app.addAgentToSwarm('m', 'a0', swarmId: target.id);
+ machine.agents = [
+ const Agent(
+ id: 'a0',
+ name: 'Latest agent',
+ engine: 'codex',
+ terminalAvailable: true,
+ project: AgentProject(
+ name: 'Workbench',
+ cwd: '/work/workbench',
+ branch: 'after-branch',
+ ),
+ ),
+ ...machine.agents.where((agent) => agent.id != original.id),
+ ];
+ machine.nodeOnline = false;
+ app.renameSwarm(source.id, 'Renamed swarm');
+ await tester.pump();
+ await open();
+ await tester.enterText(field, 'after-branch');
+ await tester.pump();
+ final search = keys().search!;
+ final rows = search.rows.where((row) => row.agentId == 'a0');
+ expect(rows, hasLength(add ? 1 : 2));
+ expect(rows.every((row) => row.title == 'Latest agent'), isTrue);
+ expect(rows.every((row) => row.detail.contains('Offline')), isTrue);
+ expect(search.targetId, target.id);
+ if (add) {
+ expect(search.alreadyHere(rows.single), isTrue);
+ expect(search.canSubmit(rows.single), isFalse);
+ } else {
+ expect(rows.map((row) => row.swarmId).toSet(), {
+ source.id,
+ target.id,
+ });
+ expect(
+ rows.singleWhere((row) => row.swarmId == source.id).swarmName,
+ 'Renamed swarm',
+ );
+ }
+ await tester.enterText(field, 'before-branch');
+ await tester.pump();
+ expect(search.rows.where((row) => row.agentId == 'a0'), isEmpty);
+ expect(input, isEmpty);
+ await tester.pumpWidget(const SizedBox());
+ app.dispose();
+ },
+ );
+ }
+
+ testWidgets(
+ 'reopening Add reuses catalog work but refreshes output and choices',
+ (tester) async {
+ final app = createApp();
+ final machine = _CatalogMachine(app.machineStates['m']!.machine)
+ ..agents = app.machineStates['m']!.agents
+ ..nodeOnline = true;
+ app.machineStates['m'] = machine;
+ final input = <TerminalBinaryFrame>[];
+ final session = terminal('a0', input);
+ session.terminal.write('Earlier useful output.\r\n');
+ app.adoptSessionForTest(session);
+ app.newSwarm();
+ app.adoptSessionForTest(terminal('a69', input));
+ await mount(tester, app);
+ final field = find.byKey(const ValueKey('swarm-search-input'));
+ SwarmSearchInput inputWidget() => tester.widget<SwarmSearchInput>(
+ find.ancestor(of: field, matching: find.byType(SwarmSearchInput)),
+ );
+ await chord(tester, LogicalKeyboardKey.keyN);
+ await tester.enterText(field, 'Agent 0');
+ await tester.pump();
+ final first = inputWidget().search!;
+ final oldRow = first.selected!;
+ expect(oldRow.agentId, 'a0');
+ expect(first.preview!.text, contains('Earlier useful output.'));
+ first.toggle();
+ await tester.pump();
+ expect(first.checkedCount, 1);
+ await tester.sendKeyEvent(LogicalKeyboardKey.escape);
+ await tester.pump();
+ session.terminal.write('Newest useful output.\r\n');
+ machine.projectReads = 0;
+ await chord(tester, LogicalKeyboardKey.keyN);
+ expect(tester.widget<TextField>(field).controller!.text, isEmpty);
+ await tester.enterText(field, 'Agent 0');
+ await tester.pump();
+ final next = inputWidget().search!;
+ expect(next.checkedCount, 0);
+ expect(next.preview!.text, contains('Newest useful output.'));
+ expect(next.selected, same(oldRow));
+ expect(machine.projectReads, 0, reason: 'Agent metadata did not change');
+ expect(input, isEmpty);
+ await tester.pumpWidget(const SizedBox());
+ app.dispose();
+ },
+ );
+
+ for (final native in [false, true]) {
+ for (final add in [false, true]) {
+ testWidgets(
+ '${add ? 'Add' : 'Navigate'} opening and cancel keep the canvas built (native $native)',
+ (tester) async {
+ const channel = MethodChannel('harness/swarm_tabs');
+ final messenger = tester.binding.defaultBinaryMessenger;
+ messenger.setMockMethodCallHandler(channel, (_) async => null);
+ addTearDown(() => messenger.setMockMethodCallHandler(channel, null));
+ final app = createApp();
+ final input = <TerminalBinaryFrame>[];
+ app.adoptSessionForTest(terminal('a69', input));
+ await mount(tester, app, nativeTabs: native);
+ final terminalView = tester.widget<TerminalView>(
+ find.byType(TerminalView),
+ );
+ var canvasBuilds = 0;
+ debugOnRebuildDirtyWidget = (element, _) {
+ if (element.widget is SwarmScreen) canvasBuilds++;
+ };
+ try {
+ await chord(
+ tester,
+ add ? LogicalKeyboardKey.keyN : LogicalKeyboardKey.keyP,
+ );
+ expect(
+ tester
+ .widget<TextField>(
+ find.byKey(const ValueKey('swarm-search-input')),
+ )
+ .focusNode!
+ .hasFocus,
+ isTrue,
+ );
+ expect(canvasBuilds, 0, reason: 'The canvas did not change');
+ await tester.sendKeyEvent(LogicalKeyboardKey.escape);
+ await tester.pump();
+ expect(canvasBuilds, 0, reason: 'Cancel only removes the overlay');
+ } finally {
+ debugOnRebuildDirtyWidget = null;
+ }
+ expect(terminalView.focusNode!.hasFocus, isTrue);
+ expect(
+ tester.widget<TerminalView>(find.byType(TerminalView)).controller,
+ same(terminalView.controller),
+ );
+ expect(input, isEmpty);
+ await tester.sendKeyEvent(LogicalKeyboardKey.arrowLeft);
+ await tester.pump();
+ expect(input.single.bytes, [27, 91, 68]);
+ await tester.pumpWidget(const SizedBox());
+ app.dispose();
+ },
+ );
+ }
+ }
+
testWidgets('Add arrow movement rebuilds only the changed result rows', (
tester,
) async {
diff --git a/docs/harness-v2-developer-tools-research.md b/docs/harness-v2-developer-tools-research.md
index d065a6e72..d4c4786fd 100644
--- a/docs/harness-v2-developer-tools-research.md
+++ b/docs/harness-v2-developer-tools-research.md
@@ -2,13 +2,31 @@
Research and source audit: 2026-09-12. Recommendation for the existing `app-v2` build.
+**Historical audit:** the [current handoff](harness-v2-handoff.md) supersedes
+earlier menu, toolbar, picker, shortcut and onboarding experiments recorded here.
+
Harness should make three things excellent: **keep work alive, reach any work instantly, and steer agents without losing concentration.** A developer should be able to spend a whole day here directing their existing agents.
This is a qualitative sample of firsthand accounts and tool authors' documentation, not a survey of all exceptional developers. “World-class” has no objective tool list. Publication dates matter: several authors have changed their workflows. Product documentation establishes advertised behavior; it does not independently establish performance, reliability or developer affection.
-## Current implementation queue
+## Browser keyboard follow-up (2026-09-14)
+
+Safari and Chrome document explicit keyboard paths for focusing their search/
+address field, moving between tabs, reopening closed tabs, and finding within
+the current page. Those are separate operations, with different scopes.
+Sources: [Safari shortcuts](https://support.apple.com/guide/safari/keyboard-shortcuts-and-gestures-cpsh003/mac)
+and [Chrome shortcuts](https://support.google.com/chrome/answer/157179?co=GENIE.Platform%3DDesktop&hl=en).
+
+Our adaptation is to preserve Harness's agreed Navigate/Add distinction and
+bindings, with predictable focus when a temporary picker opens or is canceled.
+The current performance pass removes unchanged-canvas builds and repeated
+catalog formatting from that loop. The browser references establish advertised
+interaction conventions, not performance or usability evidence for Harness;
+the measured scope and unverified native checks stay in the performance record.
+
+## Historical implementation queue
-Updated 2026-09-13 after user review. Keep the existing simple Command shortcuts: H/J/K/L and arrows for movement, S for layout, B for Boss mode. The modifier-heavy proposal and general-purpose-terminal assumption are withdrawn. This is the working list; [the progress log](harness-v2-progress.md) records checks and remaining gaps.
+Recorded 2026-09-13 after user review. The simple Command shortcuts use H/J/K/L and arrows for movement, S for layout, B for Boss mode. The modifier-heavy proposal and general-purpose-terminal assumption were withdrawn. This historical list predates the latest Navigate/Add and Cmd-N decisions; use the current handoff above for implementation direction.
| Status | Work |
| --- | --- |
diff --git a/docs/harness-v2-handoff.md b/docs/harness-v2-handoff.md
index 200405878..a7d33dded 100644
--- a/docs/harness-v2-handoff.md
+++ b/docs/harness-v2-handoff.md
@@ -30,6 +30,12 @@ Research must lead to justified improvements, not feature accumulation.
- Continue on **`main`**, tracking `origin/main`. The user's latest instruction
is to work, commit, and push directly on main from now on. This supersedes
the earlier preference for creating a fresh feature branch after each merge.
+- The latest opening continuation keeps the retained canvas built while a
+ picker opens/closes and shares validated catalogs across openings. Warm Add
+ opening measured 22.006 ms median versus 26.273 ms in the same headless
+ fixture; cold starts and native display latency are not established by it.
+ Main includes the team's independent device change `5f8baac`. The complete
+ desktop suite passes 1,309 tests with one existing skip.
- **`e71e0ca`** saves Add's frame continuation: it reuses unchanged result rows
and keeps background pane additions from taking the picker's Flutter focus.
The full suite passes 1,302 tests. Native fixture identity repair is saved in
@@ -250,14 +256,14 @@ unverified; do not infer them from these UI changes.
**Archived drafts:** both are superseded. The onboarding ideas were adapted into
the common page, without adding another first-tab-only component.
-**Latest verification:** the Add frame/focus continuation on integrated main
-passes 1,302 desktop tests with one existing skip.
+**Latest verification:** the picker-opening continuation on main passes 1,309
+desktop tests with one existing skip.
Analyzer reports zero errors/warnings and 14 existing informational diagnostics
(12 vendored, two inherited from main). Logs:
-`/private/tmp/harness-add-render-integrated-{tests,analyze}.log`.
-The final macOS arm64 Release build also succeeds with
+`/private/tmp/harness-add-open-{full-tests,analyze}.log`.
+The final macOS arm64 Release build succeeds with
`FLUTTER_TARGET=lib/main.dart`; log:
-`/private/tmp/harness-add-render-integrated-build.log`. The running app was not
+`/private/tmp/harness-add-open-release-build.log`. The running app was not
restarted, so do not claim its process has loaded these source changes.
The preceding Add/shortcut integration passed 51 native keymap decoder
and 347 AppKit assertions, including the exported Dart keymap and hidden window
@@ -272,6 +278,11 @@ The integrated Release build uses the new `ai.autonomous.harness` bundle ID.
Add's new full-frame fixture observes an arrow-selection median of 4.714 ms
versus 8.592 ms before the change, with 2,000 agents and five retained terminals.
Opening did not improve. This is headless debug CPU time, not displayed latency.
+The next paired opening pass reuses unchanged catalogs and removes redundant
+canvas builds: warm opening median is 22.006 ms versus 26.273 ms. Query timing
+was worse in that run. Reopening refreshes output and revalidates metadata and
+membership without retaining canceled queries/selections. See the current
+performance table before making a broader speed claim.
Navigate/Add timings and their exact scope are in
[the performance record](harness-v2-performance.md). The new navigation catalog
build measured 0.188 ms median / 0.259 ms p95 in the earlier integrated run for
diff --git a/docs/harness-v2-performance.md b/docs/harness-v2-performance.md
index 2e3671c63..56961a61e 100644
--- a/docs/harness-v2-performance.md
+++ b/docs/harness-v2-performance.md
@@ -12,6 +12,48 @@ It prints `SWARM_BENCH` JSON records. Its filename deliberately does not end in
## Current continuation benchmark (2026-09-14)
+### Warm picker reopening
+
+Add and Navigate no longer rebuild the unchanged Swarm screen when their
+overlay opens or closes. Their focus nodes and overlay update independently.
+The workspace also retains its validated Add/location catalogs across openings;
+inline Add, the floating button and splits share the Add catalog. This retains
+normalized metadata only. Every read still checks discovery, project, location
+and membership identity; each new picker owns its query, checked selection and
+fresh output excerpt.
+
+The same 2,000-agent/five-terminal fixture below now separates keyboard dispatch
+and setup from the following frame pump. There are 20 warmups and 100 samples,
+with repeated opening/canceling on an unchanged workspace. This measures **warm
+reopening**, not app startup or a cold/invalidated catalog. Runs did not overlap
+this session's correctness checks or builds.
+
+| Operation | Before median / p95 / p99 | After median / p95 / p99 |
+| --- | ---: | ---: |
+| Warm Cmd-N open + frame | 26.273 / 32.719 / 73.537 ms | 22.006 / 27.653 / 52.138 ms |
+| Opening: dispatch and setup | 6.258 / 7.262 / 9.023 ms | 2.141 / 3.374 / 3.548 ms |
+| Opening: frame pump | 20.033 / 26.514 / 66.335 ms | 19.729 / 25.161 / 49.592 ms |
+| Query edit + frame | 10.779 / 15.600 / 19.924 ms | 11.784 / 16.763 / 20.294 ms |
+| Arrow selection + frame | 4.628 / 6.527 / 7.866 ms | 4.757 / 5.932 / 7.623 ms |
+
+Warm opening's median fell about 16%. Query timing was worse; no new query or
+arrow improvement is claimed. Removing the redundant canvas build alone had a
+25.608 ms opening median, before catalog reuse. Rebuild observations fell from
+950 to 877 on open and 100 to 27 on cancel; SwarmScreen, Scaffold and PaneGrid
+went from one to zero. Retained TerminalPanel/TerminalView builds stayed zero.
+Headless debug/JIT and shared-host variation limit conclusions about tails or
+native performance. These are not input-to-display latency measurements.
+
+Seven added regressions cover both picker kinds and chrome configurations,
+Escape/first-terminal-key ownership, fresh output with cleared canceled choices,
+and metadata/offline/membership changes while closed. An unchanged reopen makes
+zero project-metadata reads. All **1,309 desktop tests** pass with one existing
+skip; analysis has zero errors/warnings and 14 existing infos.
+The normal macOS arm64 Release build succeeds; no running app was restarted.
+Benchmark logs: `/private/tmp/harness-add-open-{stages-before,canvas-after,cache-after}.log`.
+Checks: `/private/tmp/harness-add-open-{full-tests,analyze,release-build}.log`.
+The initial unstaged trace is `/private/tmp/harness-add-open-before.log`.
+
### Add picker frame work and keyboard focus
Add now reuses up to 48 recently built result rows. Moving the highlight rebuilds
diff --git a/docs/harness-v2-progress.md b/docs/harness-v2-progress.md
index 527dd225e..9d7141101 100644
--- a/docs/harness-v2-progress.md
+++ b/docs/harness-v2-progress.md
@@ -6,6 +6,17 @@ Updated 2026-09-14 after integrating the continuation into main. This is a worki
## Continue directly on main
+- Picker opening/cancellation no longer rebuilds the retained Swarm canvas.
+ Add and Navigate reuse validated catalogs across openings, including shared
+ inline/floating/split Add data. Output excerpts remain fresh and canceled
+ queries/selections remain local to their picker. The paired headless fixture
+ measured warm Add opening at 22.006 ms median versus 26.273 ms. Query timing
+ was worse; full scope and tails are in the performance record. Seven new
+ regressions pass; the full desktop suite passes **1,309 tests**, one existing
+ skip, with no analyzer errors/warnings and 14 existing infos. Preserved the
+ team's independent device UI change `5f8baac` by fast-forwarding main.
+ The normal macOS arm64 Release build succeeds. Verification artifacts:
+ `/private/tmp/harness-add-open-{full-tests,analyze,release-build}.log`.
- Improved Add's arrow-key frame work by reusing unchanged result rows and
leaving the text editor alone when only the highlight changes. In the paired
2,000-agent headless fixture, arrow selection median fell 8.592 to 4.714 ms;