Files
amethyst/commons/plans
Claude 289702b4b0 refactor(avm): move AccountViewModel and its group into commonsUI and commons
The 127 files reachable from AccountViewModel leave the app, split by
what they import:
- commonsUI/commonMain (33 files): AccountViewModel,
  AccountFeedContentStates, the payment stack (Zap/V4V handlers,
  MeltProcessor, LightningInvoiceResolver, HttpStatusMessages,
  NwcResponseMessages), TopNavFilterState, NotificationSummaryState, the
  account filter assemblers that hold the feed states, the nest
  assemblers and bridges, CallSessionBridge, ReloadMintViewModel. They
  need compose-resources strings, Vico or commonsUI symbols.
- commons/commonMain (94 files): the feed filters, the chat, relay-group,
  concord and hashtag assemblers, EventSync, the Clink payer, the card
  feed state, the chat-room read markers.

Packages are renamed on the way: ui.screen.loggedIn -> commons.viewmodels,
ui.screen.loggedIn.X -> commons.X, ui.screen and ui.dal -> commons.feeds,
ui.nwc -> commons.service.nwc, service.relayClient.X ->
commons.relayClient.X, service.X -> commons.service.X. Every reference in
the app, desktop and tests is repointed.

commonMain needed only kotlinx.coroutines.IO and kotlin.concurrent.Volatile
imports, toLongValue() on one BigDecimal, and three cross-module smart
casts read into locals. commonsUI gains Vico (Apache-2.0, already an app
dependency, multiplatform for all commonsUI targets) and
kotlinx-serialization-json. The resolver test moves to commonsUI's
jvmTest with the code it tests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01S7FuNBSKiyVecARSoE4B9P
2026-09-28 15:15:21 +00:00
..

commons plans

Audited 2026-06-30 (+ 2026-09-12 split entry, 2026-09-27 migration and one-UI entries).

In progress

Plan Summary
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 Split the per-speaker subscription state machine out of NestViewModel; only the ActiveSubscription stepping-stone is extracted so far.
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 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 The original roadmap for the same move; superseded in practice by the sweep tracker above.

Queued

Plan Summary
2026-04-21-event-renderer.md Cross-platform UI-agnostic RenderedEvent subsystem shared by Amy, Desktop, and Android; not started.
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.

Shipped

Plan Summary
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 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 Test sheet recording the completed custom-feeds phases (unit + manual coverage).
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.