mirror of https://github.com/vitorpamplona/amethyst.git synced 2026-10-06 03:38:23 +00:00

Files

T

Claude 09d356edfb refactor: fold contextvm and cordn into quartz

Both were Gradle modules on reasoning that does not survive examination.

`:cordn`'s stated reason was circular: "the coordinator client needs
`:contextvm`, and quartz cannot depend on it without a cycle" -- true, but only
because `:contextvm` had been put outside quartz first. A consequence of an
earlier choice was written down as if it were a constraint.

`:contextvm`'s reason was "a peer of `:quic`". That analogy does not hold.
`:quic` is a transport library with no Nostr in it at all -- which is exactly
why it is a module. ContextVM is nothing but Nostr: kind 25910 events, NIP-59
gift wraps, relay subscriptions. Its build file also claimed quartz's
serialization dependency was not transitive, which only mattered across a
boundary the same decision had created; quartz has had
kotlinx-serialization-json all along.

What actually governs is the precedent already in the tree. `marmot/` is 18,876
LOC of non-NIP protocol family living inside quartz with its own MIP spec
series -- the same shape as cordn and three times the size of both modules
combined. `concord/` is another, `buzz/` a third. CLAUDE.md's own rule is that
quartz holds implementations of Nostr specifications, and CEPs are to ContextVM
what NIPs are to Nostr core.

So: `quartz/…/contextvm/` and `quartz/…/cordn/`, as the plan said in the first
place. Two build files and two settings entries deleted.

Two things got better rather than just tidier:

- **Both now build for every quartz target**, iOS and linuxX64 included.
  Neither had a single platform-specific file, so as jvm+android modules they
  were narrower than the code required. Verified with
  `compileCommonMainKotlinMetadata`, which type-checks commonMain against the
  intersection of all declared targets.
- **The crypto-dependent tests moved from `jvmTest` to `jvmAndroidTest`**,
  where quartz keeps the rest of its secp256k1 tests, so they now run on the
  Android host too instead of the JVM alone.

`:quartz:jvmTest` 5086 -> 5330, exactly the 174 + 70 that moved, none lost. The
ts-mls interop gate still passes all ten checks after the move.

`:quartz:testAndroidHostTest` has four failures in `NostrServerTest` and
`LiveNegentropyIndexStoreTest`. They are pre-existing and unrelated -- relay
server and SQLite store -- confirmed by stashing this change and reproducing
them identically at the parent commit.

CLAUDE.md now records the placement rule, so the next protocol does not have to
rediscover it: a protocol over Nostr is a quartz package, not a module;
`quic`/`nestsClient`/`marmotQuic` are modules because they carry no Nostr.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012BfD4txdnsaPRXmNXbup9n

2026-09-18 20:58:23 +00:00

README.md

quartz plans

Audited 2026-09-17. 13 plans: 7 shipped (archived), 0 in-progress, 5 queued, 1 closed (negative result).

Queued

Plan	Summary
2026-05-08-local-headers-explorer.md	Headers-only Bitcoin P2P client to verify NIP-03 OTS attestations without a trusted block explorer.
2026-06-12-giftwrap-deletion-requests.md	Let a recipient-authored kind-5 delete/block a gift wrap (kind 1059) addressed to them.
2026-07-03-incremental-negentropy-storage.md	Always-current (created_at, id) index so cold NEG-OPENs stop paying a full scan + seal (~340 ms at 50k vs strfry's ~21 ms).
2026-07-04-small-req-floor.md	Small-REQ dispatch floor: decomposed, inline fast path tried and reverted (no wire-level win); floor is transport-side.
2026-08-13-gpu-pow-mining.md	GPU NIP-13 mining declined (ARMv8 has SHA-256 in silicon, mobile GPUs do not). Midstate is ~3x on JVM targets; Android hinges on Conscrypt per-digest JNI cost, still unmeasured. created_at refresh while mining shipped.
2026-09-17-cordn-interop.md	Cordn (cordn.net) is an alternative binding of MLS onto Nostr, not an alternative to MLS: same ciphersuite `0x0001`, byte-identical ChaCha20-Poly1305 seal and NIP-01 envelope, but the delivery service is an MCP server over ContextVM with no key-package event kind. Only the RFC 9420 engine is shareable, and it is not yet Marmot-clean (3 files, 10 imports, 3 hardcoded policies). ContextVM must be written from scratch: full review of the spec + all 12 CEPs, with a per-CEP compliance matrix, `CVM-*` rule ids and a 5-tier test method (including a fixture server that misbehaves on demand, and RFC 8785 JCS which Quartz lacks). Blocked on the credential-identity encoding (raw 32 bytes vs 64-byte hex ASCII). Includes a coordinator metadata-exposure analysis.
2026-09-08-marmot-spec-resync.md	Marmot moved off the MIP-era spec (2026-07-02): group state split into `app_data_dictionary` components, account identity proof v2, and a convergence engine. Current MDK rejects our groups outright. Gap analysis + 8-stage plan; Stages 0-4 done (mdk interop reference, app_data_dictionary, identity proof v2, the six group components, transport corrections); lifecycle + branch selection landed.

Archived (shipped)

Plan	Summary
archive/2026-06-03-fix-nip46-bunker-double-resume-plan.md	Fix NIP-46 bunker double-resume crash and retry id-reuse races via Channel-per-request + fresh id per attempt.
archive/2026-06-04-auth-scope-vs-policy.md	Move relay-server authenticated-identity state from the policy into the engine-owned connection scope.
archive/2026-06-09-clink.md	Implement CLINK (Offers/Debits/Manage) Lightning-over-Nostr pointers, events, and client/server in Quartz.
archive/2026-06-11-runstr-interop.md	RUNSTR kind-1301 workout events and supporting fitness kinds in Quartz plus Amethyst fitness screens.
archive/2026-06-19-napplet-nip5a-resolver.md	Platform-agnostic NIP-5A static-site resolver verifying content-addressed Blossom blobs against signed manifests.
archive/2026-06-20-powr-interop.md	Parse and render the POWR/NIP-101e kind-1301 strength-workout dialect alongside the existing RUNSTR dialect.
archive/2026-06-28-git-smart-http-browser.md	Git smart-HTTP v2 client to browse NIP-34 repo file trees and render source from the clone URL.