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.
TypeScript 3d-modelingagent-frameworkagent-harnessai-agentscadclaude-codecodexcoding-agentsdeveloper-toolsesp32game-developmentmcp-servermulti-agentopen-hardwareopencodeopenharnesspcbroboticsterminaltmux
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.dartindex 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.dartindex 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.dartindex 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.dartindex 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.dartindex 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.mdindex 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.mdindex 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 instructionis to work, commit, and push directly on main from now on. This supersedesthe 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 rowsand 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 intothe 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 notrestarted, so do not claim its process has loaded these source changes.The preceding Add/shortcut integration passed 51 native keymap decoderand 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 msversus 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 catalogbuild measured 0.188 ms median / 0.259 ms p95 in the earlier integrated run fordiff --git a/docs/harness-v2-performance.md b/docs/harness-v2-performance.mdindex 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 focusAdd now reuses up to 48 recently built result rows. Moving the highlight rebuildsdiff --git a/docs/harness-v2-progress.md b/docs/harness-v2-progress.mdindex 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 andleaving the text editor alone when only the highlight changes. In the paired2,000-agent headless fixture, arrow selection median fell 8.592 to 4.714 ms;