pares-radix

The Praxis base application — a plugin-driven platform with an inference engine, UX contracts, and LLM integration.

Radix (Latin: root) is the runtime that turns a bare Svelte+Tauri app into an intelligent, plugin-extensible platform. It provides everything that domain-specific plugins (financial advisor, vault, sprint-log, etc.) need but shouldn't implement themselves.

What Radix Provides

| Capability | Description | |---|---| | Navigation | Persistent sidebar, breadcrumbs, mobile responsive, dead-end prevention | | Settings | Unified settings page, plugin settings slots, persistence | | Help | Aggregated help from all active plugins, searchable | | Onboarding | Plugin-aware setup wizard, dependency-ordered steps | | Dashboard | Home page that aggregates plugin widgets | | Data | Import/export orchestration, PluresDB integration | | LLM | Shared provider config, token budgeting, context assembly | | Inference | Praxis rules with confidence scores, decision ledger | | UX Contracts | Journey expectations — prereqs, gates, empty states | | Subconscious | Background preprocessing, context management, rule generation | | Plugin Loader | Discovery, lifecycle, dependency resolution |

Architecture

svelte-tauri-template    →  Generic scaffolding (no opinions)
        ↓
   pares-radix           →  Opinionated runtime (this repo)
        ↓
   pares-modulus          →  Domain plugins (financial, vault, etc.)

See Architecture Doc for the full design.

Quick Start

# Create a new app from template
npx create-plures-app my-app

# Radix is included by default. Add domain plugins:
cd my-app
npx radix plugin add financial-advisor
npx radix plugin add vault

Plugin API

import type { RadixPlugin } from '@plures/pares-radix';

export default {
  id: 'my-plugin',
  name: 'My Plugin',
  version: '0.1.0',
  icon: '🔧',

  routes: [
    { path: '/my-plugin', component: () => import('./pages/Home.svelte') },
  ],

  navItems: [
    { href: '/my-plugin', label: 'My Plugin', icon: '🔧' },
  ],

  settings: [
    { key: 'my-plugin.enabled', type: 'toggle', label: 'Enable My Plugin', default: true },
  ],

  expectations: [],
  rules: [],

  async onActivate(ctx) { /* ... */ },
  async onDeactivate() { /* ... */ },
} satisfies RadixPlugin;

Backend Architecture (Rust)

The Rust workspace (crates/) implements the headless runtime:

| Crate | Purpose | |---|---| | core | Reactive event loop, executor, agent abstraction | | channels | Telegram adapter, HTML rendering, slash command parsing | | cli | pares-agens binary — headless daemon mode | | models | LLM router, provider adapters, streaming | | praxis | Decision ledger, write gate, constraint enforcement | | plugins | Schema-driven plugin framework (manifest, runtime, CRUD, hooks) | | mcp-client | Model Context Protocol client for tool servers | | sync | Hyperswarm-based peer sync | | audit | Audit trail and compliance logging | | privacy | PII detection and redaction | | agenda | Calendar/agenda integration | | marketplace | Plugin marketplace client | | tui | Terminal UI (ratatui) | | tauri-app | Tauri desktop integration |

Key Subsystems

• Event Spine — bridges the agent to PluresDB's runtime
• Chronos Timeline — causal audit trail for every data mutation
• Content Store — content-addressed deduplicating blob storage
• Plugin Framework — manifest-driven apps with lifecycle hooks and coding agent support
• Praxis Write Gate — constraint enforcement before any state mutation
• Tool Governance — execution policies, timeouts, blocked-command filtering
• Heartbeat — periodic proactive check-ins
• Session Management — save/restore conversation sessions
• Personality — identity, tone, and behavioral rule contracts
• Prompt Builder — dynamic system prompt assembly from personality + context
• Git Adapter — repository operations for coding agent workflows

Project Status

🚧 Active development — core runtime stable, plugin ecosystem expanding.

License

MIT