Files
SeedPass/docs
thePR0M3TH3ANandClaude Fable 5 dce30d669a feat: rebuild interactive mode as Python's legacy TUI menus
The list-and-arrow-keys interface I wrote was not the thing to build. What
`seedpass` opens is a numbered menu tree, and navigating it is typing a
number and pressing Enter, with a blank line to go back -- so an interface
driven by arrow keys and single-letter bindings was unnavigable to anyone who
already knows SeedPass, however well it worked on its own terms.

This follows src/main.py item for item: the same eight main-menu entries in
the same order, the same nine entry types under Add Entry, the same eighteen
settings under the same numbers, the Profiles and Nostr submenus, the entry
action and edit menus with Python's letter keys. Numbering is part of the
interface, not decoration -- 7 then 1 has to still be Settings then Profiles
-- so items this build cannot perform stay in place and say why when
selected, rather than vanishing and shifting everything below them.

Line-based means no raw mode, no alternate screen, and no terminal to
restore, which removes a whole class of failure the previous version had to
defend against. Raw mode is now entered only around a password prompt, where
echo must be off.

The agent-blind rule survives the change: listings and details show metadata
with stored secrets as has_* flags, and a secret appears only through Show
Secret or Copy. Secret Mode -- a setting Python already has -- routes both to
the clipboard instead of the screen, so it means the same thing in both
implementations. The key/value field, hidden custom fields, and seed phrases
are read without echo.

Three settings needed new profile operations: changePassword re-wraps only
parent_seed.enc, since the index is keyed by the seed rather than the
password and a half-applied change would leave the two disagreeing;
writeParentSeed and setProfileName back the profile menu.

Verified through a pty against a real vault -- every menu, adding a password
entry, editing a label, revealing a secret -- and the derived values match
the CLI. 28 menu tests drive the tree through a scripted UI, including that
listings never contain a stored secret and that a non-numeric length is
refused rather than stored as NaN.

128 CLI tests, 220 core tests, 36/36 cross-impl checks. test/nostr.test.ts
is flaky under parallel load (it uses a live relay); it failed once during
this work and passed on rerun and three times in isolation.

Co-Authored-By: Claude Fable 5 <[email protected]>
2026-08-15 17:15:17 -04:00
..
2025-07-10 19:37:30 -04:00
2025-07-10 19:37:30 -04:00
2025-07-10 19:37:30 -04:00
2025-08-03 10:27:13 -04:00
2026-02-25 18:07:22 -05:00

SeedPass Docs

This directory contains SeedPass project documentation.

Start Here

  • dev_control_center.md (single source to decide what to do next)

Agent and Autonomy Docs

  • agent_autonomy_security_plan.md
  • policy_as_code.md
  • sync_conflict_contract.md

Core Security Docs

  • security_readiness_checklist.md
  • threat_model.md
  • crypto_key_management_review.md
  • secret_handling_local_exposure_review.md
  • auth_lock_unlock_access_review.md
  • supply_chain_release_integrity.md
  • release_verification_runbook.md
  • release_protection_policy.md
  • operational_runbooks.md
  • staged_rollout_runbook.md

Architecture and Product Docs

  • ARCHITECTURE.md
  • SPEC.md
  • typescript_web_extension_port_plan.md
  • entry_types.md
  • entry_graph.md
  • tui_v3_plan.md (active roadmap for scratch rebuild)
  • tui_v2_plan.md (legacy logic reference)
  • tui_v2_parity_checklist.md
  • tui_v2_parity_backlog.md
  • tui_v2_legacy_parity_matrix.md
  • tui_v2_ui_refresh_plan.md
  • semantic_vector_index_plan.md
  • tui_v2_cutover_decision.md
  • tui_v2_large_vault_validation.md
  • security.md
  • nostr_setup.md
  • nostr_namespace_reset.md
  • packaging.md

QA and Testing Docs

  • TEST_INVENTORY.md (central index of all tests and runners)
  • agent_testing_roadmap.md
  • ai_agent_tui_testing.md
  • agent_test_format.md
  • installer_testing.md
  • kb_scale_validation.md
  • ci-health-2026-02-19.md
  • agent-handoffs/README.md

Discoverability Commands

  • seedpass --help
  • seedpass
  • seedpass tui2
  • seedpass --legacy-tui
  • seedpass legacy
  • seedpass <group> --help
  • seedpass tui2 --help
  • seedpass tui2 --check
  • seedpass capabilities --format json
  • seedpass agent bootstrap-context