A1 Prerequisites & account guidance

Area: A — Getting started
Audience: operator
Kind: feature
Status: accepted
Maturity: shipped
Shipped in: 0.2.0
Labels: verification, ux
Relates to: A2 A3 C8 G2

The feature in the specification · Read at 2026-10-25T06:47:13Z

Requirements

A1-R1acceptedMUST
lemonfiber MUST present the full list of required third-party accounts before requesting any credential.
locked by
0.2.0 uncited
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
A1-R2acceptedMUST
The list MUST be derived from the operator's stated protocol choices, and MUST NOT show prerequisites for protocols they declined.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@6340ebd178 lemonfiber@7229d1adac
A1-R3acceptedMUST
lemonfiber MUST state that a library-only configuration requires no third-party accounts, and MUST offer it as a supported end state.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@7229d1adac
A1-R4acceptedMUST
For each prerequisite, lemonfiber MUST explain in plain language what it is, why it is needed, and its approximate cost band.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@7229d1adac
A1-R5acceptedMUST
lemonfiber MUST NOT recommend, rank, or link to specific commercial providers. It MUST describe selection criteria instead.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@7229d1adac
A1-R6acceptedMUST
lemonfiber MUST distinguish a Usenet provider from a Usenet indexer wherever both are referenced.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@7229d1adac
A1-R7acceptedMAY
No credential MAY be persisted before validating successfully — see A3-R1.
locked by
0.2.0 uncited
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
A1-R8acceptedMUST
Checklist progress MUST survive quitting and MUST be restored on next run.
locked by
0.2.0 uncited
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
A1-R9acceptedMUST
If the operator selects torrents without a VPN, lemonfiber MUST warn explicitly and require confirmation, and MUST NOT refuse to proceed.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@d419e827bc
A1-R10acceptedMUST
Validation failures MUST distinguish rejected credentials from unreachable services, with a distinct remedy for each — see G4.
locked by
0.2.0 uncited
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
A1-R11acceptedMUST
Any prerequisite MAY be skipped; skipping MUST disable only the dependent features, and MUST state which.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@7229d1adac
A1-R12acceptedMUST
Where torrents are selected, VPN port-forwarding support MUST be stated as a selection criterion before the operator is asked for VPN credentials.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@7229d1adac
A1-R13acceptedMUST
The consequence of a provider without port forwarding — reduced peer connectivity and seeding — MUST be stated in plain language.
locked by
0.2.0 met
recorded done
lemonfiber spec:10-functional/features/a-getting-started/a2-setup-wizard.md crates/lemonfiber-core/src/prerequisites.rs crates/lemonfiber/src/prompt.rs crates/lemonfiber-core/src/wizard/steps.rs crates/lemonfiber-core/src/wizard/answers.rs
cited by
lemonfiber@7229d1adac