Files
amethyst/commons/plans
Claude 8f38d4a0b9 docs(commons): correct what blocks the event cache from commonMain
The earlier note said the NIP-95 `java.io.File` spill was the only thing
keeping the cache out of `commonMain`. That was wrong. The binding blocker is
that the cache's own storage — `LargeSoftCache`, holding `users`, `notes` and
`addressables` — is itself `jvmAndroid`, as are both `*ListMatchingFilter`
observables, `MintDirectoryIndex` and `NwcPaymentTracker`. `EventCache` cannot
go without them.

The audit also found most of it is already answered in the tree:
`commons.util.WeakReference` is an expect/actual that already anticipates iOS,
quartz's commonMain ships `ConcurrentMap`/`ConcurrentSet`/`LargeCache`, and
`LargeSoftCache`'s skip-list ordering is not load-bearing — its surface has no
ordered read, so the skip list is there for concurrency alone.

That leaves two pieces of real work: an okio or `expect` blob sink, and
getting `java.util.SortedSet` out of `EventCache.filter`'s signature, which
has no common equivalent and ripples into `CacheSearch`, both observables and
the parity test.

Recorded with a bottom-up order, and noted that none of it is on part B's
critical path — Desktop is JVM.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01KkULS5SVq4GHDdoCzajKi8
2026-09-21 02:23:40 +00:00
..

commons plans

Audited 2026-06-30 (+ 2026-09-12 split entry). 7 plans: 3 shipped, 2 in-progress, 2 queued, 0 abandoned.

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.

Queued

Plan Summary
2026-04-21-event-renderer.md Cross-platform UI-agnostic RenderedEvent subsystem shared by Amy, Desktop, and Android; not started.
2026-05-30-amethyst-to-commons-migration.md Roadmap to move shared amethyst Android code into commons; keystone Account/LocalCache extraction not begun.
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.