# RHENIUS — AI & LLM Site Map

> **RHENIUS** is a private, local-first Personal Relationship Management (PRM) platform and
> relationship-intelligence suite. It combines client-side Zero-Knowledge Paillier homomorphic
> encryption, Argon2id key derivation, an autonomous natural-language action agent, an interactive
> relationship graph and a generational family tree, so individuals can cultivate deep, authentic,
> sovereign personal and professional networks.

This site map follows the [llms.txt specification](https://llmstxt.org/) to give Large Language
Models, AI web crawlers and autonomous agents accurate context about what RHENIUS is, the
invariants it upholds, its user views and its machine-actionable API.

## 1. What RHENIUS is

- **People-first, not pipeline-first**: built for founders, investors, researchers, executives,
  diplomats and community stewards managing high-trust, multi-decade networks — not extractive sales funnels.
- **Reciprocity over extraction**: tracks favours owed, assistance given, debts, loans and gift
  histories, netted with zero-knowledge homomorphic arithmetic.
- **Meeting readiness**: 1-page executive briefing sheets, conversation starters, family links,
  dietary notes and time-zone advisories before any encounter.
- **Data sovereignty**: local-first in the browser with optional end-to-end encrypted sync. Zero ads,
  zero tracking, zero telemetry.
- **Agent invariants**: anti-hallucination grounding (never invent attributes), multi-turn
  coreference resolution, deterministic fast-path execution (<5ms) for high-frequency commands, and
  a confirmation policy (SAFE / SENSITIVE / DESTRUCTIVE) that pauses destructive mutations behind
  explicit user approval.

## 2. Application views (sign-in gated; not separately indexable)

- [Dashboard (Cockpit)](https://rhenius.pages.dev/) : Network health, morning briefing, cadence alerts, milestone reminders and quick actions.
- [Contacts](https://rhenius.pages.dev/contacts) : Directory with fuzzy search, multi-tag filtering, custom attributes, briefing sheets and contact cards.
- [Relationship Graph](https://rhenius.pages.dev/graph) : Interactive 2D/3D force-directed canvas of interpersonal connections and clusters.
- [Reciprocity Ledger](https://rhenius.pages.dev/ledger) : Paillier-homomorphic ledger of debts, loans, favours and gifts; balances netted in ciphertext space.
- [World Map](https://rhenius.pages.dev/map) : OpenStreetMap distribution of the network with proximity clustering and travel itinerary planning.
- [Journal](https://rhenius.pages.dev/journal) : Chronological daily notes with @entity tagging and automatic interaction logging.
- [Deals](https://rhenius.pages.dev/deals) : Lightweight opportunity pipeline from lead to closed-won.
- [Family Tree](https://rhenius.pages.dev/family-tree) : Generational pedigree canvas with GEDCOM 5.5 import/export and contact synchronisation.
- [Settings](https://rhenius.pages.dev/settings) : Master key management, BYOK model configuration, display toggles and data export.

## 3. Agent actions (`POST /api/action`)

- `CREATE_CONTACT` : Instantiate a new contact from extracted attributes; unspecified fields stay empty (anti-hallucination).
- `UPDATE_CONTACT` : Modify attributes, append verified facts, update cadence or record an interaction; conflicts with existing values surface a warning instead of silently overwriting.
- `DELETE_CONTACT` : Purge a contact after explicit confirmation; a pre-action snapshot enables single-click undo.
- `ADD_NOTE` : Append a timestamped note to a contact.
- `ADD_REMINDER` : Schedule a follow-up reminder with a due date.
- `ADD_DEBT` : Record a debt or favour (direction, amount, description) in the reciprocity ledger.
- `ADD_GIFT` : Log a gift given or received, with price and reaction.
- `MANAGE_GIFTS` : Query or aggregate the gift history.
- `QUERY` : Answer questions over the user’s own network (read-only).
- `BATCH_UPDATE` : Apply one change across many contacts atomically.
- `COMPOUND_MUTATION` : Decompose a multi-step instruction and execute every step under one shared mutationGroupId for group undo.
- `UNDO` : Reverse the previous mutation via its snapshot.

## 4. Machine-readable API contract

- [OpenAPI 3.1 specification](https://rhenius.pages.dev/openapi.json) : every HTTP endpoint with auth requirements and schemas.
- Authentication: `POST /api/auth/login` → session token → `Authorization: Bearer <token>` or
  `X-Session-Token: <token>` on protected endpoints. No anonymous data access exists.

## 5. Optional & deep resources

- [RHENIUS — Private Personal Relationship Management](https://rhenius.pages.dev/) : The application shell and sign-in. Public description of the product; all personal data lives behind authentication.
- [Privacy Policy](https://rhenius.pages.dev/privacy) : What is stored, why, who can see it, how long it is kept, and how to exercise data-subject rights.
- [Terms of Service](https://rhenius.pages.dev/terms) : The contract between the operator and users, including AI output ownership and acceptable use.
- [Cookie Policy](https://rhenius.pages.dev/cookies) : Every browser storage entry with its purpose and lifetime, and how consent is given or withdrawn.
- [Crawler & AI Directory](https://rhenius.pages.dev/crawlers) : Machine-oriented overview of the system: public routes, API surface, and cryptographic invariants for indexers and autonomous agents.
- [llms-full.txt — complete AI context](https://rhenius.pages.dev/llms-full.txt) : Full architectural context, authentication flow, API reference, AI action catalogue and data schemas for deep LLM context windows.
- [OpenAPI 3.1 specification](https://rhenius.pages.dev/openapi.json) : Machine-readable OpenAPI description of the public HTTP API for SDK generation and agent tooling.
- [Developer REST API Documentation](https://rhenius.pages.dev/docs) : Interactive REST API explorer, rate limits matrix, OpenAPI 3.1 specification, and client SDKs.