Make large archives easier to manage across web and mobile

[Quicksaver]

Summary

The old Archive settings view did not hold up once an archive got large. Web used a flat list, native offered a different set of controls, and archived-only workspaces could disappear because snapshots were tied to environments with active projects.

This turns Archive into a dense project browser on both clients. Threads are grouped by project and environment, searchable with ranked multi-term matching, sortable by archive or creation time, and manageable one at a time or in project-sized batches. It also loads every configured environment, keeps successful results visible when another environment fails, and applies the same confirmation, locking, and partial-failure rules across row and bulk actions.

The practical result is that large archives stay scannable, archived-only work remains reachable, and destructive or overlapping actions cannot quietly misreport what happened. Native Settings now exposes Archived Threads in both local-only and T3 Connect modes without folding the legacy waitlist route into the new Archive route.

Reopened

This reopens #3552. That PR was closed because its connection to #2829 was only tangential. The archive work itself is independent. The branch continues to follow main, and #2829 can merge here later if it lands first.

Alongside #7386 and #4384, this delivers useful behavior that does not need to wait for orchestration v2.

What changed

• Replaced the flat web Archive panel with collapsed project groups, compact rows, project favicons, context-aware environment labels, and hover or keyboard-focus actions. Archive context menus follow the shared restore, destructive-action, and separator conventions. Native uses matching project sections with platform-native swipe and long-press actions.
• Added persistent, case-insensitive archive search on both clients. Multi-term results rank exact phrases first, then titles matching every term, then partial matches. Search opens matching groups, scopes project actions to visible rows, and updates the native list without remounting it.
• Added archived and created-time sorting, invalid archive-date fallback, relative age columns, and native project ordering that follows the selected field and direction.
• Load archived snapshots from every configured environment, including archived-only workspaces. Active rows are excluded, while partial failures remain visible with their error and retry action above the environments that loaded successfully.
• Added per-thread and project-level unarchive and delete actions. Confirmations follow the shared web delete preference and native guarded flows, and web delete dialogs use the destructive theme.
• Prevented overlapping row and bulk mutations with collision-safe per-thread reservations. Bulk work uses bounded concurrency, stops scheduling after unexpected exceptions, waits for active workers, refreshes once after each attempt, and reports successes, failures, and already-running skips separately.
• Exposed Archived Threads in local-only and T3 Connect Settings through one shared settings tail and route contract. Archive stays in the header-owning content stack, while the legacy waitlist alias remains a separate auth route.
• Moved grouping, ranking, sorting, and bulk-action logic out of the React components into focused web and native modules, with regression coverage for archive behavior and archived-only project deletion safeguards.
• Added an Archive user guide and updated the documentation index and glossary to distinguish settled, archived, restored, and permanently deleted threads.

Validation

• Focused archive context-menu checks passed with 2 files and 33 tests after the latest upstream merge.
• Focused web and mobile test runs passed with 4 files and 49 tests, 2 files and 44 tests, 3 files and 32 tests, 2 files and 29 tests, 1 file and 9 tests, 1 file and 10 tests, and 1 file and 12 tests. These runs covered grouping, search ranking, sorting, timestamp fallback, action reservations, concurrency and partial outcomes, row rejection feedback, focus behavior, and archive-load errors.
• Focused formatting, type-aware lint, and git diff --check passed for the files affected by the review follow-ups.
• Playwright verified active-row filtering, invalid timestamp fallback, search ranking, sorting, confirmation and overlapping-action states, Settings search and focus, row alignment and pointer behavior, single-row unarchive, mouse and keyboard focus behavior, and partial and total environment-load error retries.
• Two iOS runs verified incremental search without a list remount and long-press unarchive of one archived row. A separate sort-control attempt reached Archive but could not render its fixture rows. The requested serve-sim stream registered the framebuffer but failed to encode frames with encodingFailed, so native evidence used semantic UI snapshots and screenshots.
• Android verification on emulator-5554 loaded the disposable archive fixture and opened the native Unarchive and Delete actions from a row long press. Metro later exited with an unrelated watcher ENOENT after the affected flow completed.
• Package typechecks were attempted but remain blocked by unrelated existing errors elsewhere in the web and mobile packages.

Proof

🤖 Generated by GPT-5 in Codex via T3 Code

---

Note

Medium Risk
Touches permanent thread deletion, bulk mutations, and multi-environment archive loading; behavior is heavily tested but mistakes could delete data or misreport partial failures.

Overview
Replaces flat archive lists with a project-grouped browser on web settings and native Archived Threads, aligned on grouping, ranked search, sortable Archived / Created columns, favicons, and environment labeling.

Data and discovery: Snapshots load from all configured environments (including archived-only workspaces), with partial load errors shown above successful groups. Web settings search can jump to Archive and focus the search field. Multi-term title search ranks phrase and all-token matches; active search expands matching groups and scopes project bulk actions to visible rows.

Actions: Row and project unarchive / delete use collision-safe per-thread locks, guarded confirmations (destructive delete on web where applicable), bounded-concurrency bulk runners with partial-outcome messaging, and a single refresh after bulk attempts. Native adds swipe, long-press menus, environment filter, and list updates that avoid remounting on every keystroke.

Structure: Logic moves into ArchiveSettings.logic.ts and archivedThreadList.ts with expanded tests. Mobile settings share a General → Appearance → Legacy → Archive → App tail and register Archive via settingsRouteScreens while keeping the waitlist deep link on auth. Server test coverage adds project.delete rejection when only archived threads remain without force.

^{Reviewed by Cursor Bugbot for commit f2b1cdc. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add archive management panel with search, sorting, and bulk actions

• Introduces ArchivedThreadsPanel on web and refactored ArchivedThreadsScreen on mobile with search, multi-field sorting (archivedAt/createdAt, asc/desc), per-thread context menus, and project-level bulk unarchive/delete scoped to matching or all threads
• Shared logic in archivedThreadList.ts handles tiered search scoring, grouping, sorting, and bounded-concurrency bulk actions via runArchivedThreadActions
• useThreadActionExecutor now returns tri-state results (succeeded/failed/skipped) and accepts ThreadActionOptions to suppress failure alerts and archive refresh on a per-call basis
• Thread identity keys switched to JSON tuple (environmentId, id) in threadActionKey, archivedThreadActionKey, and archivedProjectGroupKey, replacing scopedThreadKey/scopedProjectKey to avoid collisions when ids contain separators
• Behavioral Change: useArchivedThreadListActions no longer accepts onCompleted callback; unarchiveThread/deleteThread return Promise<ThreadListActionResult>; useThreadActions.unarchiveThread/deleteThread accept { refreshArchivedThreads: false } (default true unchanged)

^{Macroscope summarized f2b1cdc.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 4cf030e9-8341-4edb-960d-816e3013d1e2

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[macroscopeapp]

UI Consistency: 3 findings

Reviewed the changed web UI surface (ArchiveSettings.tsx, ArchiveSettings.logic.ts, settingsLayout.tsx, SettingsPanels.tsx, useThreadActions.ts, routes/settings.archived.tsx). The panel composes the shared Button, Input, Tooltip, and settings-layout primitives correctly, and the removed SettingsPanels archive block has no remaining consumers. Three concrete issues below: one shared-CSS ownership gap for the new settings-search destination, one primitive-geometry override, and one invalid ARIA attribute.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR introduces a substantial new feature for archive management including search with ranking, bulk actions, sortable columns, and project grouping across web and mobile platforms. The scope of new components, state management patterns, and user-facing behavior warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[macroscopeapp]

Reviewed the new web Archive settings surface (ArchiveSettings.tsx, settingsLayout.tsx, index.css) against the shared control system. The previously flagged items (search-target pulse selector for the input, rounded-md overrides of --control-radius, and aria-sort on a button) are all resolved. Three remaining consistency issues in the new dense archive table, all on changed lines.

^{Posted via Macroscope — UI Consistency}

[macroscopeapp]

Two findings on the new Archive panel: the row action reveal deviates from the documented sidebar list-row pattern, and the new settings-search pulse rule for inputs can never take effect.

^{Posted via Macroscope — UI Consistency}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit f20d7e4. Configure here.}

[macroscopeapp]

Reviewed the changed web UI in apps/web/src/**. Two findings on the new partial-archive-failure banner; the earlier sort-header, control-radius, cursor, focus-visible and pulse-selector findings all look addressed on this head.

^{Posted via Macroscope — UI Consistency}

[Quicksaver]

Branch will be rebased and PR reopened at a later time.

🤖 Generated by GPT-5 in Codex via T3 Code