archy/docs/TODO.md

# TODO

Working backlog of forward-looking items not yet scoped into a dedicated plan
doc. See [`ROADMAP.md`](ROADMAP.md) for the curated, public-facing direction.

## Framework incident — closed with operator acceptance

- **CLOSED WITH OPERATOR ACCEPTANCE (2026-09-30): Framework LND startup /
  missing Receive address / false zero balance.** Startup, native balances,
  Cashu address and source integration were verified; the operator accepted the
  remaining display check and authorized release. See the incident record for evidence.
  See [incident evidence and closure criteria](incident-framework-lnd-startup.md)
  and the repository `AGENTS.md` session-start instructions.

## Next release after 1.8.21 — reported 2026-09-30

- [x] Review and repair open paid-download PRs #161 and #162, refresh both
  branches from main, run independent and combined isolated suites, and verify
  rootless file permissions in disposable scratch storage. Combined result:
  1,585 passed, zero failed, four existing tests ignored. See the
  [review evidence and remaining acceptance work](pr-review-20260930.md).
- [ ] Integrate the reviewed PR branches into the next release and run funded
  candidate acceptance, including Tor-only transport and payments with change.
  PRs remain open; the reviewed code has not been deployed to live wallets.
- [ ] Design durable recovery for an accepted payment whose response is lost.
  Preserve the truthful unconfirmed-refund warning and prevent automatic
  duplicate payment while that recovery work is outstanding.
- [ ] **ThinkPad X250 kiosk: Bitcoin installation version selector is unreadable
  and appears underneath the pruning information.** Operator reports white
  styling with invisible text on the actual kiosk; the same flow works in remote
  Brave. Reproduce on the X250's kiosk engine and record its version, display
  scale and resolution. Inspect the native `<select>` in
  `neode-ui/src/components/InstallVersionModal.vue`, its option colors, and the
  scroll/stacking behavior in `BaseModal.vue`; these are investigation leads,
  not a confirmed cause. Fix contrast and popup visibility without changing
  version selection or pruning behavior. Validate Core and Knots, open/closed
  and scrolled dropdowns, keyboard/touch selection, and pruning on/off on the
  actual kiosk, with remote Brave and mobile regression checks. Browser mocks
  alone do not establish that the kiosk rendering is fixed. Track for the next
  release; the signed 1.8.21 artifacts remain unchanged.

## 1.8.21 repair and release tasks — completed 2026-09-30

See the [execution record](repair-release-20260929.md) for evidence and limits.

- [x] Fix Cashu paid-file redemption between dev and Shorty; test keyset IDs,
  mint errors, fees, and refund reporting before live validation.
- [x] Record Framework verification and the operator's acceptance of the
  remaining display check before release.
- [x] Replace the unavailable tx1138.com explorer default with mempool.space;
  migrate the old default with fresh consent and preserve custom/local explorers.
- [x] Offer pruning in the Bitcoin installation version modal, using the same
  pruning settings as automatic pruning even on large disks.
- [x] Explain Bitcoin warmup without raw RPC errors; gate LND unlock on Bitcoin
  RPC readiness and show install/start/sync waiting states with automatic recovery.
- [x] Test the completed changes on this development box, then publish a new
  signed OTA and raw ISO release. Record any remaining verification gaps.

## Dev & build process (priority)

- Formalize the contributor workflow: releases, CI, maintainers, automated
  builds, PR/issue flow, branch naming, and reproducible builds.

## Federation & peering

- Peering trust model — define tiers (trusted / public / private / peered)
  on top of the existing federation DID trust levels.
- Federation architecture built on the above peering model.

## Distributed git & OTA

- Nostr-hosted git for the alpha (see
  [`nostr-git-source-hosting.md`](nostr-git-source-hosting.md)).
- Distributed git beyond the nostr-hosting case.
- Distributed OTA / app delivery.

## Nostr integration

- Nostr signer integration.

## Platform / OS

- Source-availability ISO — define the build/distribution story.
- HW/OS update pipeline.
- Deeper OpenWRT integration.
- GrapheneOS integration — backups, attestation, profiles.

## App ecosystem

- Full pass testing every app in the catalog; expect issues across the board.
- App update strategy — finalize the update policy referenced in
  [`app-developer-guide.md`](app-developer-guide.md) (pinned vs. mutable
  tags, catalog-vs-disk precedence, rollout/rollback).
- App wishlist — candidates not yet packaged: Cashu wallet, phoenixd.
  (CLN is already shipped as `apps/core-lightning`.)

## Access & security

- SSH access strategy — define the access model (keys, rotation, recovery
  path, remote-support access).

## Observability

- Capture error logs to troubleshoot customer issues.
- Stats & visualization for traffic, blocked attacks, VPNs, routing.