Human Surface (Web UI)
What this page is
The Web UI is a single-page application served by the node at /ui.
Built with Alpine.js and Tailwind CSS (both loaded from CDN — no
separate build step or install required). All actions map directly
to the REST API; anything you do in the UI you can reproduce with
curl.
Quick start
- Navigate to
http://<node-host>:8000/ui. - Enter your node's base URL and your API key in the Connection bar at the top, then click Connect.
- The header confirms your identity (
Signed in as <entity_uri>) and shows your permission badges.
Your credentials are saved in localStorage (sm_url / sm_key) so
you do not need to re-enter them on reload.
Use the OIDC / SSO exchange flow if your organisation runs an IdP, or ask your node operator to provision a static key. See Authentication for the full key model.
Personas and roles
The UI detects your role from GET /v1/me — write controls are
hidden or disabled if your key lacks the write permission.
Tabs
Facts
Browse and search the fact store.
Filters:
entity.relation.local, team, company, public.source.Results are paginated. The Load more button appends the next page.
Columns: Entity, Relation, Value, Scope (badge), Confidence, Timestamp, Status (conflicted / retracted), Actions.
Actions per row:
Detail
Opens a modal with all fields including id, valid_until, and HLC.
Retract
Opens a confirmation modal with an optional reason field. Sends POST /v1/facts with confidence: 0; the reason is stored as a stigmem:retract:reason fact keyed on the retracted fact's ID.
Assert
Create new facts manually.
string, text, number, boolean, datetime, ref, null.GET /v1/me if you are authenticated.local, team, company, public.On submit, the response shows the new fact ID and warns if the assertion contradicts an existing fact.
Audit Log
A chronological view of all fact mutations, including retractions and contradictions.
Filters: Source URI (My assertions pre-fill button), Entity,
Scope, Include contradicted.
Useful for compliance reviews and debugging — equivalent to
GET /v1/facts?include_contradicted=true&order=hlc_desc.
Gardens
Manage memory gardens (named, ACL-controlled partitions above scope — see Spec-02-Scopes-and-ACL).
List view: Cards show slug, display name, scope badge, and creation time. Click a card to open the detail view.
Detail view:
garden_id (UUID), created_by.admin, writer, reader).Create garden: Click + New Garden. Provide a slug (lowercase
alphanumeric + hyphens, 1–64 chars), display name, scope, and
optional description. The creator is automatically added as admin.
Role management: Admins can change any member's role via the
dropdown in the members table. The last admin cannot be demoted or
removed (the node returns 403).
API endpoints called
Every UI action maps to a REST endpoint.
/v1/me/v1/facts?{filters}/v1/facts/v1/facts with confidence: 0 + reason fact./v1/facts?include_contradicted=true/v1/gardens/v1/gardens/{slug}/v1/gardens/v1/gardens/{slug}/v1/gardens/{slug}/members/v1/gardens/{slug}/members/v1/gardens/{slug}/members/{entity_uri}/v1/gardens/{slug}/members/{entity_uri}