Architecture

Ecosystem Overview

The Joyint ecosystem consists of multiple products that work together. At the center is joy-core, a shared Rust library that provides the data model, YAML I/O, status logic, and Git integration used by all CLI tools and services.

Products at a Glance

Product	License	Purpose
Joy	MIT	Git-native product management for teams
Jot	MIT	Personal task management with recurrence
Jon	MIT	Natural language interface for Joy and Jot
Platform	Commercial	Sync, CalDAV, notifications, forge integration
App	Commercial	Desktop, mobile, and web apps via Tauri
Judge	MIT	Post-hoc audit, compliance, anomaly detection
Crypt	MIT	E2E encryption and key management
JOYC	Commercial	IOTA-based settlement layer

Data Flow

Data flows from user input through the CLI into local files, then through Git to team members and the platform.

How It Works

The user runs CLI commands to create and manage items.
Changes are written as YAML files in the .joy/ or .jot/ directory.
Standard Git operations (commit, push, pull) distribute changes.
The platform provides optional sync for web access and mobile apps.
Every action is recorded in the event log for audit by Judge.

Trust Model

Joy's AI Governance architecture is built on five pillars that together form the Trust Model. The model scales from implicit trust (solo developer, no configuration) through explicit trust (team with capabilities) to verified trust (enterprise with gates, cost limits, and audit trails).

The Five Pillars

Pillar	Question	What it covers
Trustship	Who do I trust?	Authentication, identity, delegation tokens, capabilities, generated agent definitions
Guardianship	What do I protect against?	Gates, `allow_ai` flags, Guard (runtime protection), Crypt (encryption), sandbox environments
Orchestration	How do I steer work?	Dispatcher, Jobs, interaction modes, joy-executor, bring-your-own-executor
Traceability	What happened?	Event log, audit trail, Judge (post-hoc audit, compliance, anomaly detection)
Settlement	What did it cost?	Cost tracking per AI tool, budgets, JOYC on-chain settlement

Trust Levels

The Trust Model supports three levels that projects grow into naturally:

Implicit trust - Solo developer, no governance configuration needed. Everything works out of the box.
Explicit trust - Team with defined members, capabilities, and delegation. AI tools have identity and limits.
Verified trust - Enterprise with gates, mandatory reviews, cost controls, and full audit trails via Judge.