Principles
Four rules Lorevik does not bend, and the five states every Page must handle honestly.
The four hard rules#
These come from the business rules in Lorevik's domain context. They apply to every Package, every Agent, and every part of the app.
Local-first#
Anything that touches private local data, the user's Agent, writes to the Vault, or scanning runs in the desktop app, not on the web. The web is the control plane: discovery, accounts, purchases, metadata, consent, and audit.
Raw data stays local#
Raw data, uploads, Package contents, and the app's own .lorevik/ files stay on the user's machine. Without a second, explicit consent from the user, raw data never goes to the cloud. The cloud receives metadata only: listing text, the Package's identity, and consent and audit hashes.
Fail closed#
When the local connection to the Agent is unavailable, the app shows an error state. It never substitutes made-up Agent output and never quietly falls back to a web-only mode.
Only the creator publishes#
No Agent can publish a Package. A Package appears in Explore only after its creator confirms it, and publishing happens only in Studio.
Honest Degradation#
A Package can be as small as one SKILL.md. When an optional part is missing, Lorevik shows an honest fallback instead of an error or a blank screen:
- With only
SKILL.md, the Package still opens. - Without Package data, the Page renders with an empty object.
- Without a Page, the container shows a placeholder while the Page is generated.
The five states#
Every Page has to handle these five states honestly. No fake data, no fake progress bars, no blank screens.
| State | What the Page shows |
|---|---|
| ready | The real content, from the Package data |
| empty | There is nothing yet, and what to do next |
| loading | Neutral placeholders, with no invented percentage |
| error | What is wrong, so the user or their Agent can fix it |
| degraded | What still works, and what could not be confirmed |
Note: A Package that has been revoked for a security or IP takedown is handled before these five states. Lorevik shows an isolation notice and never mounts the Page.