theseus/PENDING.md

Pending — uncommitted Theseus changes

Working-tree state that hasn't been committed or shipped. Read this before touching the same files. Update when you land or add work.

Format: each group has a session: label so parallel sessions can see what belongs to whom and coordinate. Naming convention: YYYY-MM-DD:short-slug for date-bounded work, or parallel:<theme> for work owned by a session that isn't the current one.

Last updated: 2026-08-02.

---

session: 2026-08-02:theseus-ux-polish

Owner's focus: Theseus UX polish + downloads. Everything below bundles into one commit + one Theseus rebuild + redeploy.

Settings — General

• Startup group at the top of #general with "Open previous windows and tabs" toggle (moved up from below).
• Appearance replaced with three visual theme cards: System / Light / Dark. System follows nativeTheme.themeSource = "system" so it tracks the OS. Legacy settings.theme values outside {system, light, dark} fall back to system.
• Files: settings.html, main.js (applyTheme already handles all three values).

Settings — new Search section

• Sidebar gets a Search top-level item between General and Naming.
• Search-engine controls moved OUT of General into this section.
• Only enabled engines listed in the main "Additional search engines" block, grouped by kind (Search engines / AI answer engines), drag-reorder within a kind, toggle to disable, ✕ to delete custom.
• + Add search engine button toggles a catalog panel below with built-in engines the user hasn't enabled (each with + Add) + a "Or add a custom URL" form.
• Files: settings.html (nav, section, CSS .engcat, JS).

Settings — dropdown color-scheme + layout

• :root { color-scheme: dark } + @media (prefers-color-scheme: light) override. Native <select> popups on Windows now match app theme because nativeTheme.themeSource drives prefers-color-scheme. Fixes light popup on dark app (and vice versa).
• .ctl layout flipped to flex-direction: row with flex-wrap: wrap, so anti-fingerprint mode select + value input fit side-by-side on wide rows.
• Files: settings.html.

Search catalog

• SEARCH_ENGINES entries gain kind: "search" | "llm" and tier: "catalog" | "extra". allEngines() propagates both; custom user-added engines carry tier: "custom".
• Two-tier discovery in settings: catalog panel has "Add from catalog" (curated first-class disabled built-ins) + "Discover more engines" (wider tier:"extra" bank, filtered by a live search box) + "Or add a custom URL".
• Removed from catalog (require sign-in before ?q= works): ChatGPT, Claude, You.com. Kept as LLM engines: Perplexity, Phind.
• Removed SearXNG (federated — searx.be is anti-bot-locked and every single-instance default rots as instances rate-limit / die). Users who want it add their preferred instance via the custom URL form.
• Added as tier:"extra": Marginalia, Stract, Yep, Presearch, MetaGer, Qwant, Swisscows, Naver, Baidu. All non-login ?q= URLs. Same rot rule as LLMs: if one starts bouncing to a login gate, drop it.
• Files: main.js.

Search picker

• engine-picker.html renders two headed groups: "Search with" / "Ask an AI". Empty sections hidden.
• settings.html default-engine <select> groups options with <optgroup> by kind. Drag-reorder constrained to same-kind (a cross-kind drop would re-group on next render).

Chrome / toolbar

• Loadbar collapses to 0px when idle (.loadbar { height: 0 }, .loadbar.on { height: 2px }, 120ms transition). Previously reserved a permanent 2px strip below the address bar.
• Downloads button (#downloads) between the search box and Tor toggle. Subscribes to onDownloads for badge + spin/done/err class.
• Files: chrome.html.

Downloads (new feature)

• New files: downloads.html, downloads-preload.js. Both added to build.files in package.json.
• installDownloadTracker() in main.js hooks session.defaultSession.on("will-download", …). In-memory list only; no cross-session persistence.
• IPC surface: downloads-get, toggle-downloads, close-downloads, downloads-resize, download-open, download-show, download-cancel, download-clear, downloads-clear-all.
• New downloadsPop WebContentsView, positioned via positionDownloads() from layout().
• Preload exposes getDownloads, toggleDownloads, onDownloads.

Preview harness

• _preview.html — window.DL_ITEMS seed + __toggleDownloads overlay; stub window.theseus.getDownloads / onDownloads / toggleDownloads; kind on stub engines; LLM catalog trimmed to Perplexity + Phind.
• _settings-preview.html — kind on stub engines; LLM catalog trimmed.

---

session: parallel:collision-policy

Owner's focus: BCNR ↔ ICANN name collision handling. Present in the working tree, not mine. Leave for that session to land or bundle by explicit ask.

Chrome + main-process changes

• main.js — big block of new IPC around collision policy + soft-collision picker + electrum discovery.
• popover.html, popover-preload.js — collision switcher on the site-info popover.
• preload.js — collisionSwitch + collisionState.
• settings-preload.js — same.

Settings

• Entire Naming section in settings.html (BCNR/ICANN collision policy radio group + remembered choices reset button). Untouched by my changes.

New files (untracked in git)

• collision.html, collision-preload.js — the soft-collision "Open with…" prompt window (referenced from main.js:219).

---

Live state

Shipped hashes live at ../site/releases-manifest.json and https://dl.silentmode.st/releases-manifest.json. On-chain pointer at releases.silentmode.bch. See GOTCHAS.md for the release gotchas.