Files
amethyst/PLANS.md
Claude 9afa8127da refactor!: take quartz from vitorpamplona/quartz
Quartz moves to its own repo, the way the crypto primitives moved to
crypto-kmp. Every module depends on com.vitorpamplona.quartz:quartz
2.0.0 (libs.quartz) instead of :quartz, and -PquartzDir=../quartz
builds a local checkout instead of the artifact, for every module and
for quic's own quartz dependency (which replaces the root build's
substitution of the published quartz with :quartz).

What moved with quartz: its CI jobs (lint tasks, test-quartz-linux-native,
test-quartz-ios), the Maven Central publish step of the release
workflow, jitpack.yml, tools/unicode-nfkc, the nostr-expert and
event-store-semantics skills, the agent-skill check, and the README's
library usage docs.

What stays here:
- The four quartz client tests that need a real Ktor socket relay
  (TrustNetworkSync*, GiantReqStreamTest, BulkDownloadBenchmark) move to
  geode's tests; geode forwards -PprodRelayBench for the latter. quartz's
  other relay-client tests now use a test relay of its own, which ends
  quartz's test dependency on geode.
- The benchmark module's resources (previously read from quartz's
  androidDeviceTest resources) move into benchmark/; relayBench --real
  reads the corpus from there.
- NoteComposeKindCoverageTest reads EventFactory.kt from quartz's JVM
  sources jar, or from the -PquartzDir checkout, passed by commonsUI's
  build.
- commons and commonsUI declare crypto-kmp (and commons mls-kmp), which
  they import directly. Through quartz's api alone, a -PcryptoKmpDir
  checkout never reached the common metadata compile.
- The catalog drops what only quartz used (kchesslib, negentropy,
  jackson-databind, sqlite-bundled, secp256k1-kmp common, compose
  runtime-annotation, the maven-publish plugin).

agent_config_check checks a skill's quartz/... paths against a ../quartz
checkout when there is one and skips them otherwise. AGENTS.md, the
skills, CONTRIBUTING, BUILDING, RELEASE_OPS, PLANS and the READMEs point
at the new repo.

Needs quartz 2.0.0 (and crypto-kmp 1.0.0) on Maven Central before CI can
resolve it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01DEkJaDWYrcTbGvT8JLQCrG
2026-10-21 16:32:25 +00:00

6.5 KiB

Amethyst plans index

Cross-module roll-up of every plans/ folder. Surveyed 2026-06-30.

Plans in this repo are decentralized: each module keeps its own design docs in <module>/plans/YYYY-MM-DD-<slug>.md (see AGENTS.md → "Plans per module"). There is no single plans directory — this file is the master index that stitches the per-folder indexes together.

Each plan carries a Status: header (shipped | in-progress | queued | abandoned) backed by codebase evidence. Shipped plans are moved into each folder's archive/; live work stays at the top level. For the full per-folder listing (including archived plans), open that folder's README.md.

docs/plans/ is the frozen legacy global folder — it is indexed here for completeness, but new plans must go in the owning module's plans/ folder.

Totals

137 plans across 8 folders:

Status Count
shipped (archived) 118
in-progress 9
queued 8
abandoned 2

By module

Module Plans Shipped In-prog Queued Aband. Index
amethyst 21 19 1 1 0 amethyst/plans
nestsClient 26 23 1 2 0 nestsClient/plans
desktopApp 13 10 2 1 0 desktopApp/plans
quartz (own repo) 10 7 0 3 0 quartz/plans
commons 6 2 2 2 0 commons/plans
cli 6 5 1 0 0 cli/plans
geode 5 4 0 0 0 geode/plans
docs (frozen) 52 48 2 0 2 docs/plans

Live work (not shipped)

Everything still open, across all modules. Shipped plans are omitted here — find them under each folder's archive/ via the per-module index above.

In progress (9)

Module Plan Summary
amethyst ios-support KMP-to-iOS port; quartz/commons iOS targets configured (Phase 1) but no iosApp module yet.
commons custom-feeds-plan Custom feeds; model + builder + kind 31890 + desktop UI shipped, but relay-filter layer, DVM marketplace, kind 10090 sync, list resolution pending.
commons nest-subscription-manager-extraction Split per-speaker subscription state machine out of NestViewModel; only the ActiveSubscription stepping-stone extracted.
desktopApp wallet-zapping-test-coverage NWC handler + RPC round-trip tests shipped; wallet-column-state and zap-dialog-logic tests still missing.
desktopApp napplet-desktop-host Desktop NIP-5A/5D host; shared core extractions done, desktop engine/scheme-handler/transport/UI edge not built.
cli cashu-cli NIP-60/61/87 Cashu wallet verbs in amy; full command surface ships, production-mint interop harness pending.
nestsClient t16-closure-roadmap Priorities 1 & 2 closed and suite passes, but CI gating deferred and framesPerGroup rerun + two upstream items open.
docs viewport-aware-metadata-loading Base preloader/rate-limiter infra exists but the LazyListState/snapshotFlow viewport selection isn't clearly wired.
docs macos-bunker-relogin PR 1 defense-in-depth shipped, but the cold-boot root cause is still open/unidentified.

Queued (8)

Module Plan Summary
amethyst napplet-inter-applet NAP-INC / NAP-INTENT inter-applet messaging; prerequisites (multi-applet hosting, archetype registry, MESSAGING capability) not built.
quartz local-headers-explorer Headers-only Bitcoin P2P client to verify NIP-03 OTS attestations without a trusted block explorer.
quartz giftwrap-deletion-requests Let a recipient-authored kind-5 delete/block a gift wrap (kind 1059) addressed to them.
quartz incremental-negentropy-storage Always-current (created_at, id) index so cold NEG-OPENs stop paying a full scan + seal.
commons event-renderer Cross-platform UI-agnostic RenderedEvent subsystem shared by Amy, Desktop, Android; not started.
commons amethyst-to-commons-migration Roadmap to move shared amethyst Android code into commons; keystone Account/LocalCache extraction not begun.
desktopApp embedded-wallet-phase2-research Research for an embedded self-custodial Lightning wallet (Breez/ldk-node/lightning-kmp); parked, no code.
nestsClient cross-stack-interop-ci-gating CI gating for the cross-stack interop suite; infra built then removed over wallclock cost, kept as a ready revisit target.
nestsClient framespergroup-production-rerun Re-run the two-phone field tests to settle the framesPerGroup test-pin (5) vs default (50); needs prod-rig access.

Abandoned (2)

Module Plan Summary
docs desktop-relay-config-single-source Single DesktopRelayConfig class never built; relay state landed as DesktopRelayCategories/LocalRelayCategories instead.
docs macos-vlc-bundled-discovery macOS bundled-VLC setenv discovery fix; moot after VLC/VLCJ was removed entirely in the kdroidFilter migration.