# commons plans

_Audited 2026-06-30 (+ 2026-09-12 split entry, 2026-09-27 migration and one-UI entries, 2026-10-09 iOS and web entries, 2026-10-17 platform review)._

## In progress
| Plan | Summary |
| ---- | ------- |
| [2026-11-01-nap-upload-common-intent.md](2026-11-01-nap-upload-common-intent.md) | NAP-UPLOAD (Blossom rail, draft reply shapes), NAP-COMMON (NIP-19 helpers, profile/follow reads, follow/unfollow/react/report published as the event they are) and NAP-INTENT (favorites as the handler catalog, favorites order as the default, delivery once the target is ready). Napplet cards now say which required domains are missing. |
| [2026-11-01-nap-inc.md](2026-11-01-nap-inc.md) | NAP-INC for napplets: topics and channels under runtime endpoint ids, one `NappletIncBus` per host (Android broker service, desktop runtime), `window.napplet.inc` in the shim. Unblocks the napplet.run napplets that require `inc`. Checked in real Chromium; Android not yet run on a device. |
| [2026-10-30-chess-on-feeds.md](2026-10-30-chess-on-feeds.md) | Chess rebuilt on the app's own machinery: games are Jester start notes in LocalCache with their moves as replies, the lobby is two TopNav-filtered feeds, and each open board keeps one live REQ on the game's relays. Replaces the polling of three hard-coded relays and drops every connection/sync/broadcast indicator. Desktop checked read-only; a full two-account game and Android not yet run. |
| [2026-10-30-inline-napplets.md](2026-10-30-inline-napplets.md) | Run a NIP-5D napplet inside its note: a poster with Run here, one run at a time, a trusted bar above the page, and no consent dialogs from the feed (the broker refuses and the note offers Open). Android reuses the favorite tabs' cross-process surface; the desktop draws an off-screen Chromium browser (`OffscreenCefBrowser`) as an image. Desktop verified headless; Android not yet run on a device. |
| [2026-10-30-webxdc.md](2026-10-30-webxdc.md) | Webxdc apps in posts (NIP-DC draft): a card with Start for a `.xdc` in a note or a kind-1063 file, run in a third host posture (`HostProfile.WEBXDC`: own origin and storage, no network), from an archive downloaded, verified and unpacked under limits. Phase 1 keeps updates on the device; kind 4932 over Nostr is next. |
| [2026-10-20-nostr-dev-tools.md](2026-10-20-nostr-dev-tools.md) | In-app Nostr developer tools (Android + Desktop): a hub in Settings, NIP-19 converter, event inspector (id/signature check, also from a note's menu), kind lookup (type a number → name + every way clients encode it: events sampled from relays found via NIP-66, grouped by client or tag shape, with examples), kind browser, "find this event on relays", and a raw relay console with REQ/COUNT builders and confirm-before-AUTH. Prototype shipped; ranks the next tools (rebroadcast, REQ playground, kind 0/3/10002 history restore, zap/LNURL and NIP-05 debuggers). |
| [2026-05-04-custom-feeds-plan.md](2026-05-04-custom-feeds-plan.md) | Custom feed creation/discovery/management for Desktop; core model + builder + kind 31890 + desktop UI shipped, but relay-filter layer, DVM marketplace, kind 10090 sync, and list resolution still pending. |
| [2026-05-06-nest-subscription-manager-extraction.md](2026-05-06-nest-subscription-manager-extraction.md) | Split the per-speaker subscription state machine out of `NestViewModel`; only the `ActiveSubscription` stepping-stone is extracted so far. |
| [2026-10-09-legacy-desktop-retirement.md](2026-10-09-legacy-desktop-retirement.md) | What each legacy-desktop-only feature becomes before `runLegacy` is deleted: port the privacy lock (whole app / messages / wallet, Android too), the relay latency engine, custom feeds (in the top-bar picker), a compression preview with resolution steps, a NIP-30 emoji picker, and a deck with workspaces on the shared shell; discard the rest. Decided, not started. |
| [2026-09-27-one-ui-android-desktop.md](2026-09-27-one-ui-android-desktop.md) | **The target.** Android ships on laptops, so the whole UI (screens + navigation shell) moves to `commonsUI`, `amethyst` becomes an Android shim, and a new JVM `desktopApp` renders the same UI. Measures Wave 4: `Account`'s 77-file move-group, its 5 blocked files and 14 seams, and `AccountViewModel`'s dependencies; sequences the rest. |
| [2026-08-30-commons-migration-sweep.md](2026-08-30-commons-migration-sweep.md) | The running log of moving `amethyst/` code into `commons`/`commonsUI`: waves, what moved each round. `LocalCache` has moved. Its STAY list and Wave 2 part B are superseded by the one-UI plan above. |
| [2026-05-30-amethyst-to-commons-migration.md](2026-05-30-amethyst-to-commons-migration.md) | The original roadmap for the same move; superseded in practice by the sweep tracker above. |
| [2026-04-21-event-renderer.md](2026-04-21-event-renderer.md) | Cross-platform UI-agnostic `RenderedEvent` subsystem shared by Amy, Desktop, and Android. Core, 12 kind renderers and the JSON formatter shipped (amy `notes show/thread/feed`, `notifications`); the Compose formatter and the Android/Desktop switch-over remain. |

## Queued
| Plan | Summary |
| ---- | ------- |
| [2026-11-08-media-size-hint.md](2026-11-08-media-size-hint.md) | With auto-download off, every media placeholder (image, video, audio, PDF; Android and Desktop) shows "Video · 12.4 MB": the size declared in the event first, then the `Content-Range` total the MP4 track probe already reads, else a `HEAD` request over the media client's Tor routing; cached per URL, 2xx with a length only. Media without a blurhash gets a real placeholder card instead of a bare URL line. Implemented on `feat/media-size-hint`; checked on an Android emulator and device, not on Desktop. |
| [2026-11-04-tabs-and-windows-layouts.md](2026-11-04-tabs-and-windows-layouts.md) | A *Navigation layout* setting: Stack (today, default), Deck (the stack with deck columns), Tabs (each screen in its own browser-style tab) and Windows (each screen in its own OS window for window managers); one screen per tab or window, so no back button: you close instead. Tabs and Windows are desktop-only; Android offers Stack and Deck. One model per layout (`StackModel`, `TabsModel`, `WindowsModel`) behind `NavRequest`s, one destination table drawn with each screen's own `INav`, and a `DesktopWindowManager` for the OS windows. Built, in review (vitorpamplona/amethyst#4764); the account-session split and Android windows are not. |
| [2026-11-05-git-dashboard-remaining.md](2026-11-05-git-dashboard-remaining.md) | Done 2026-11-05 (dev GRASP server, amy pushes PRs/edits, 20/20 end-to-end run, windowed editor, local-only desktop runs). What the git dashboard audit left: no end-to-end run of the signing flows (needs a dev GRASP server in geode and `amy git pr` on `GitProposals`), editing cost linear in file size (149 ms per keystroke at 256 KB; `TextFieldState` alone does not help: windowed editor), diff row colours that stop at the text, a private-repo event leaking to the outbox when its announcement is not cached, and the blame/search waits that follow the quartz fetch plan. |
| [2026-10-09-ios-app.md](2026-10-09-ios-app.md) | iOS as a third shim of the One-UI app, at feature parity with Android. Part A is groundwork shared with web: a `nonJvmMain` source set, Ktor transports, and the shim graph and last screens moved out of `jvmAndroid`. Part B is the iOS app: Keychain, AVPlayer, APNs + Notification Service Extension, WKWebView napplets, CallKit, nests, Tor. Decided: direct APNs, the richtext fork gains iOS/wasm targets, scheduled posts hidden on iOS. Supersedes `amethyst/plans/2026-05-24-ios-support.md`. Proposed. |
| [2026-10-09-web-app.md](2026-10-09-web-app.md) | The same app in the browser via Compose for Web (wasmJs), reusing the iOS plan's Part A. Starts with a spike that measures whether one browser thread keeps up with event ingest, then the IO-dispatcher and sync-crypto fixes for wasm, a `:webApp` shim, NIP-07 login, and CORS/fonts/media. Smaller scope than Android, with a table of what ships. **On hold**: a browser tab cannot inject NIP-07 into the websites its in-app browser opens, which the maintainer made a condition. |
| [2026-10-07-wot-network-index.md](2026-10-07-wot-network-index.md) | Download every NIP-85 kind 30382 card from the user's trust provider (~300k) into a 6 MB on-disk sorted index (not LocalCache), kept current with small updates, to gate DM Known/New, Curated notifications and replies by a minimum trust score; includes Brainstorm onboarding. Implemented except public chats, `amy wot` and Desktop. |
| [2026-08-03-poll-results-page.md](2026-08-03-poll-results-page.md) | Extended NIP-88 poll results page (per-option counts + who voted for what) for Android and Desktop; also specifies four tally-correctness fixes and the missing poll-relay subscription. Proposed, not started. |
| [2026-10-17-platform-code-sharing-review.md](2026-10-17-platform-code-sharing-review.md) | Review of the code still in `amethyst/` and `desktopApp/` after the one-UI move: eight Desktop bugs (GIFs bypass Tor, blank place names and meeting events, a dead-end QR scanner, no-op calendar reminders, no WoT refresh, raw payment text, robohash Concord images; all fixed 2026-10-18), dead legacy Desktop code (deleted 2026-10-18), and ranked moves for each direction (Android→shared, Desktop→shared such as the tile map, and duplicates such as Tor, image loading, notifications and the image viewer). Proposed. |

## Shipped
| Plan | Summary |
| ---- | ------- |
| [2026-10-23-nip19-codec-speed.md](2026-10-23-nip19-codec-speed.md) | NIP-19 encode/decode cost, per entity: quartz's Bech32 boxes every 5-bit value, copies each string several times and parses TLV into a map of copies. The single-pass codec (identical output, benchmarked in `commons` jvmTest) encodes 3.5–4.2× faster with ~5× less allocation and decodes 3–4× faster with 6–9× less. Also records a TLV bug: values over 255 bytes produce an `naddr` quartz itself cannot decode. Shipped in quartz 2.2.0 (vitorpamplona/quartz#14) and bumped here, with the call sites that cite other people's d-tags moved to a fallback that never throws. |
| [2026-10-20-nip05-remote-signer-login.md](2026-10-20-nip05-remote-signer-login.md) | Signing login from a `name@domain` address: read the NIP-05 document's `nip46` field (the spec's `name=_` shape and the legacy `nip46[pubkey]` shape nostr-tools uses), connect through the existing bunker / `nostrconnect://` use cases and `auth_url` prompt, and require the signer's account to match the address. Falls back to the read-only login. Implemented for Amethyst and `amy`; not yet checked against a live provider. |
| [2026-10-15-dlist-three-tier-rendering.md](2026-10-15-dlist-three-tier-rendering.md) | Decentralized List items drawn in three tiers after Brainstorm-UI ADRs 0004/0007: raw tags, the governing definition (copy resolution, display hints, URL templates, media, location, "More fields"), and hand-made views for GitHub accounts, food and drink places and books on the item's page. Third-party enrichment (GitHub, Open Library) not ported. |
| [2026-09-12-audit-findings.md](2026-09-12-audit-findings.md) | Bug/performance audit of `commons` + `commonsUI` after the split: 34 verified fixes shipped, 4 deferred with rationale, 6 rejected. |
| [2026-09-12-commons-ui-split.md](2026-09-12-commons-ui-split.md) | Split the Compose half of `commons` into the new `:commonsUI` module (same packages, `api(:commons)`), so `cli` no longer carries Compose/Skiko; records the classification method and follow-ups. |

## Archived (shipped)
| Plan | Summary |
| ---- | ------- |
| [archive/2026-05-04-custom-feeds-testing-sheet.md](archive/2026-05-04-custom-feeds-testing-sheet.md) | Test sheet recording the completed custom-feeds phases (unit + manual coverage). |
| [archive/2026-05-05-feed-builder-enhancements-plan.md](archive/2026-05-05-feed-builder-enhancements-plan.md) | Six FeedBuilderDialog enhancements (npub decode, author search, kind filters, edit/delete, save-as-feed, exclude authors) — all landed. |
