Veritheia Documentation

An environment for inquiry - complete documentation

View the Project on GitHub ZipThought/veritheia

User Model

1. Overview

This document specifies the user model for Veritheia, defining relationships between users, journeys, journals, and personas. The model implements journey-based knowledge work where insights accumulate into formation through structured engagement with source materials.

Core Concepts

User

The User represents an individual engaging with the epistemic infrastructure:

The User is the constant—their journeys and personas may vary, but their identity and growing understanding persist.

Journey

A Journey represents a specific instance of a user engaging with a process:

Journey = User + Persona + Process + Purpose + Time

Each journey is a unique intellectual endeavor, even when using the same process multiple times.

Persona

A Persona represents a domain-specific intellectual context:

Users naturally develop different vocabularies and approaches in different contexts. A student learning statistics uses different language than when they’re running their startup.

2.4 Journal

Journals provide structured narrative records within journeys. Four journal types capture different aspects of intellectual work: Research (findings and discoveries), Method (approaches and techniques), Decision (choices and rationales), and Reflection (insights and evolving understanding). Journals implement structured templates while preserving user voice, enabling edge-linking between entries and long-memory timeline navigation.

Relationships

One User → Many Personas

A user might have:

One User → Many Journeys

A researcher might have:

One Process → Many Journeys

The SystematicScreeningProcess might be used for:

One Journey → Multiple Journals

A systematic review journey might maintain:

Persona Evolution

The Persona is not a static profile but an evolving representation shaped by accumulated insights:

Components

Evolution Process

  1. Each journey generates insights through engagement
  2. Insights accumulate into formation
  3. Formation shapes how future journeys unfold
  4. Patterns across journeys reveal preferences
  5. Vocabulary stabilizes around core concepts
  6. Methods evolve through repeated practice

The persona captures this formation—the accumulated insights that constitute the user’s intellectual development without prescribing it.

Context Management

Context Assembly

When a process needs context, it assembles from:

  1. Journey purpose and current state
  2. Recent relevant journal entries
  3. Persona elements pertinent to the task
  4. Process-specific working memory

Context Constraints

Context must fit within processing limits:

Context Windows

Different deployments support different context sizes:

The environment works effectively at any context size, with richer capabilities at larger sizes.

Journey Patterns

Individual Journey (MVP)

The default pattern where one user owns and controls the journey:

Collaborative Journey (Future)

Multiple users contributing to shared understanding:

Participants contribute to shared journals while maintaining individual voices.

Journey Templates (Future)

Structured journeys that can be instantiated:

Templates provide structure while preserving individual journey.

Journey Observation (Future)

Supervised journeys for mentorship:

Observers can see without modifying the journey.

Journal Sharing (Post-MVP Future)

While journeys and insights remain personal and non-transferable, journals can be shared as fragments of the journey—representations of the process, not the insights themselves:

What Gets Shared

What Remains Sovereign

Sharing Principles

Journal Libraries

Collections of shared journals:

Data Model Implications

User Entity

User
- Id
- Identity (authentication)
- Personas (collection of domain contexts)
- Capabilities (process access)

Journey Entity

Journey
- Id
- UserId (owner)
- PersonaId (active context)
- ProcessType
- Purpose
- CreatedAt
- State
- Context (process-specific)

Persona Entity

Persona
- Id
- UserId
- Domain (Student, Researcher, etc.)
- IsActive
- ConceptualVocabulary
- Patterns
- LastEvolved

Journal Entity

Journal
- Id
- JourneyId
- Type (Research|Method|Decision|Reflection)
- Visibility (Private|Shareable)
- Entries (narrative records)

JournalEntry Entity

JournalEntry
- Id
- JournalId
- Timestamp
- Content (narrative text)
- Tags (for retrieval)
- Significance (for context assembly)

Process Integration

Processes interact with the user model by:

  1. Reading Context: Assembling relevant information from journals and persona
  2. Writing Journals: Recording significant moments and decisions
  3. Updating State: Progressing the journey
  4. Contributing to Persona: Patterns that might inform future journeys

Each process decides what to journal and when, maintaining the narrative flow.

Privacy and Ownership

MVP Principles

Future Sharing

Extension Considerations

Extensions should:

The user model provides the foundation for intellectual sovereignty while enabling community formation.