The demonstration installation
Showing the vault to someone used to cost a full manual setup: create the
compartments, invite the people, rotate every forced password, find some
documents, upload them, and hope the reach came out right — paid again
for every demonstration. One operator command now stands up a complete,
populated, immediately demonstrable vault instead: two compartments named
hr and sales, six accounts, and a public-domain demonstration corpus
split by document category so that each account sees a different slice
of the same vault.
The six accounts are three pairs, and each pair differs in exactly one
thing. Both halves hold the same compartments; one of them may file
documents into them and the other, named with an "_ro" suffix so the
pairing is legible in the sign-in list itself, may only ask. Being able
to read and not to write is a first-class thing to be here rather than a
half-broken account — in a real engagement it is what most people are —
so the demonstration ships those people and lets an audience watch both
halves of a pair work the same compartment side by side. A read-only
account signs in the same way, reaches the same documents, searches,
asks, reads summaries and follows citations exactly as its writing twin
does. The single difference is that the vault refuses to let it file a
document, and refuses without storing any part of one.
Three things make that repeatable, and the same three would be a serious
vulnerability in any real deployment: all six accounts share one email
address, they share one short password, and none of them is asked to
change that password at first sign-in — the single documented exception
to the rule that every provisioned account must replace its admin-known
password before the vault will do anything else for it. So the weakness
is fenced by the vault itself rather than by a warning in a document.
The mode refuses unless the deployment has been explicitly marked for
demonstration use, and is reachable only as an operator command — never
from any page or interface, for any account, including an administrator.
Behind that marker it EMPTIES the vault before it builds: every document,
compartment and account is removed and the demonstration is rebuilt from
nothing, so it is the same vault every time however much anybody clicked
around beforehand. Refusing when the vault was not already empty would
sound safer and would not be: the guarantee would expire the first time
somebody tried an upload. Two things the emptying never touches: the
audit trail and the deployment's own configuration. So everything the
trail already recorded about those documents — who uploaded them, who
read them, what was refused — outlives them. The emptying itself writes
no entry, and the rebuild that follows writes the ordinary ones, because
it goes through the same audited path an operator's own work does.
What is NOT waived is the authentication itself. All six demonstration
accounts are created already enrolled with their second factor turned
off, which is a state any account can put itself into from its own
profile page — so they sign in on the password alone by the ordinary
policy, and a demonstration needs no mailbox at all. Being read-only is
not an authentication difference and buys no lesser footing at the door:
a read-only account signs in on exactly the terms its writing twin does.
The administrator was never put in that state, so it is asked for its
code like anybody else. A demonstration authenticates people exactly as
a real deployment does, because that is part of what it is demonstrating.
Showing it to somebody is its own job, so the vault ships the script for
that too: an ordered list of what to show, each beat with the clicks that
show it and the point it makes, and a set of sample questions that cannot
be answered out of one document. The questions are chosen so their
evidence falls on both sides of the compartment boundary — which is what
makes the same question return different answers to different accounts —
and one of them deliberately does not, so that an audience can see the
difference is about grants rather than about some accounts getting a
worse vault. Each question says how it was checked, and the page says
plainly which of its claims no test holds.
A deployment that never asked to be a demonstration vault
- Given a deployment carrying no demonstration marker
- When someone runs the demonstration installation
- Then the vault refuses and creates nothing
A marker that was set by accident is not a marker
- Given a deployment whose demonstration marker says only "true"
- When someone runs the demonstration installation
- Then the vault refuses and creates nothing
A vault that already holds work nobody demonstrated is emptied firststack
- Given a marked deployment whose vault already holds someone else's compartment
- When someone runs the demonstration installation
- Then the compartment that was already there is gone
- And the vault holds the demonstration and nothing else
Emptying the vault never erases the record of what happenedstack
- Given a marked deployment whose vault already holds someone else's compartment
- When someone runs the demonstration installation
- Then the audit trail still holds everything it held before
One command stands up the demonstration vaultstack
- Given a demonstration vault that has just been installed
- Then it holds the compartments hr and sales
- And it holds all six demonstration people, three who may file documents and three who may only ask
- And no demonstration account is asked to change its password
Each slice of the corpus is placed by the account that owns itstack
- Given a demonstration vault that has just been installed
- Then every corpus document is in the vault, split by category
- And the papers in both compartments were placed by the only account that can
An account cannot file a document into a compartment it cannot writestack
- Given a demonstration vault that has just been installed
- When user_hr tries to file a paper into sales
- Then the vault refuses and stores no part of that document
- And the refusal is recorded in the audit trail
A read-only account cannot file a document even into its own compartmentstack
- Given a demonstration vault that has just been installed
- When user_hr_ro tries to file a paper into the compartment it reads
- Then the vault refuses and stores no part of that document
- And the refusal is recorded in the audit trail
A read-only account signs in on the password alone, like its writing twinstack
- Given a demonstration vault that has just been installed
- When every demonstration account signs in with its password and nothing else
- Then each read-only account was let in exactly as its writing twin was, with no code asked of either
A read-only account reaches every document its writing twin reachesstack
- Given a demonstration vault that has just been installed
- Then each read-only account reaches exactly the documents its writing twin reaches
Each account sees a different slice of the same vaultstack
- Given a demonstration vault that has just been installed
- Then user_hr and user_sales each reach exactly their own slices
- And user_both reaches every document while the administrator reaches none
Asking after a document you cannot reach tells you nothingstack
- Given a demonstration vault that has just been installed
- When user_hr asks for a document that only sales can reach
- Then the answer is the same one an invented document id gets
Running it a second time converges instead of duplicatingstack
- Given a demonstration vault that has just been installed
- When the demonstration installation runs again
- Then the vault still holds the whole corpus and all six accounts
The presenter's script is one question asked by three accounts
- Given the presenter's page as the vault renders it
- Then it shows the same question asked by each of the accounts that may file documents
Every sample question says which documents it needs
- Given the presenter's page as the vault renders it
- Then every sample question names its documents and every account that may file documents
One sample question is answered the same way by every account
- Given the presenter's page as the vault renders it
- Then a question whose evidence both compartments hold is marked as the control
The page says which of its claims no test holds
- Given the presenter's page as the vault renders it
- Then it states that whether a question retrieves its evidence is not pinned