Kuanyin - Compassionate Guardianship and Ethics Platform
Kuanyin is a library-only domain implementing a Buddha Nature-aligned contemplative moderation system. Its core philosophy is that every user carries innate potential for wisdom, compassion, and wholesome action; moderation guides toward wholesome expression rather than punitive suppression. The domain provides comprehensive harm prevention, community safety, performer protection, mindful friction patterns, rehabilitation pathways, and cross-domain ethics integration across the entire Oshun platform.
The foundation library defines an extensive type system with 50+ harm categories spanning interpersonal, identity, safety, integrity, exploitation, manipulation, disruption, legal, platform, and systemic domains, each with 6-level severity classifications.
Architecture#
@kuanyin/foundation
(types, constants, utilities, errors)
|
@kuanyin/database
(schemas, migrations, repos, seeds)
/ | | | \
/ | | | \
precognition | community | performer-protection
mindful-friction rehabilitation
|
merit-karma dharma-analytics
|
cross-domain
(aphrodite, lilith, hathor, yemaya integrations)
@kuanyin/foundation is the root dependency providing all core types and the
BuddhaNature base interface. The database layer builds on top of it. All
feature libraries consume foundation types, and @kuanyin/cross-domain
integrates Kuanyin ethics across Aphrodite, Lilith, Hathor, and Yemaya domains.
Libraries (10)#
kuanyin-foundation - Core Types and Utilities#
The root library defining the entire type system for the Kuanyin domain.
Key exports:
BuddhaNatureinterface - Base interface for all domain entities with fields:compassionSeed,wisdomFactor,mindfulnessLevel,karmaBalance,innateGoodness,awakeningPotential,refugeStatusRefugeStatustype - 5 stages:seeking,taking_refuge,established,deepening,realized- 50+
HarmCategoryCodetypes across 10 domains (interpersonal, identity, safety, integrity, exploitation, manipulation, disruption, legal, platform, systemic) including: targeted/repeated/sexual harassment, bullying, threats, racial/ethnic/religious/gender hate speech, CSAM, grooming, doxxing, misinformation, scams, spam, and more - 6-level
HarmCategorySeverity-negligiblethroughcritical HarmCategoryDomainclassification - 10 domains for categorizing harm- Constants - Platform-wide moderation constants
- Utilities - Shared moderation utility functions
- Errors - Domain-specific error types
Build: @nx/esbuild:esbuild (ESM format, unbundled)
kuanyin-database - Persistent Data Layer#
Database schema definitions, migrations, repositories, and seed data for persisting all Kuanyin moderation state.
Key exports:
schemas- Database schema definitionsmigrations- Schema migration utilitiesrepositories- Data access repositoriesseeds- Seed data for development/testing
kuanyin-precognition - Predictive Harm Detection#
6 modules for proactive harm detection before content is published.
| Module | Description |
|---|---|
intent-analysis |
Analyze user intent behind messages |
emotional-detection |
Detect emotional state and distress signals |
typing-dynamics |
Analyze typing patterns for emotional escalation |
behavioral-patterns |
Track behavioral patterns over time |
context-awareness |
Contextual understanding of conversations |
cascade-prediction |
Predict harmful cascade effects |
This library enables the platform to intervene mindfully before harm occurs by analyzing intent, emotional signals, and behavioral patterns in real time.
kuanyin-community-harmony - Community Health#
5 modules for maintaining healthy community dynamics.
| Module | Description |
|---|---|
temperature-monitor |
Track community emotional temperature |
conflict-detection |
Detect emerging conflicts between users |
raid-defense |
Defense against coordinated harassment raids |
post-incident-healing |
Community healing after harmful events |
culture-cultivation |
Proactive cultivation of positive community culture |
kuanyin-mindful-friction - Intentional Friction Patterns#
6 modules implementing mindful friction that slows harmful actions without being punitive, giving users space to reconsider.
| Module | Description |
|---|---|
pause-breathe |
Pause-and-breathe interventions before posting |
samma-vaca |
Right Speech (Buddhist framework) gentle prompts |
cognitive-reframing |
Help users reframe harmful thoughts |
perspective-shift |
Encourage perspective-taking before responding |
compassion-nudges |
Compassion-based nudges toward kindness |
alternative-expression |
Suggest alternative ways to express frustration |
The samma-vaca module is named after the Pali term for Right Speech from the
Noble Eightfold Path, reflecting the domain's Buddhist-informed design.
kuanyin-performer-protection - Creator and Performer Safety#
6 modules for protecting content creators and performers from harassment, parasocial behavior, and exploitation.
| Module | Description |
|---|---|
real-time-shield |
Real-time content and chat filtering for performers |
parasocial-detection |
Detect unhealthy parasocial attachment patterns |
boundary-enforcement |
Enforce performer-defined interaction boundaries |
ncii-deepfake-protection |
Non-consensual intimate imagery and deepfake detection |
performer-wellness |
Performer mental health and wellness monitoring |
performer-dashboard |
Analytics dashboard for performer safety metrics |
kuanyin-rehabilitation - Rehabilitation Pathways#
6 modules providing paths back for users who have committed violations, emphasizing rehabilitation over permanent punishment.
| Module | Description |
|---|---|
shadow-work-journeys |
Guided self-reflection journeys for violators |
journey-progress |
Track rehabilitation journey progress |
empathy-training |
Structured empathy-building exercises |
restorative-circles |
Facilitated restorative justice conversations |
accountability-tracking |
Track accountability commitments |
reintegration-pathways |
Gradual reintegration into community |
kuanyin-merit-karma - Merit and Karma Systems#
5 modules for tracking positive contributions and platform reputation.
| Module | Description |
|---|---|
merit-accumulation |
Track merit earned through positive actions |
merit-calculation |
Calculate merit scores across activities |
privilege-tiers |
Merit-based privilege tiers and access levels |
karma-visibility |
Karma visibility and transparency controls |
achievement-system |
Achievements for positive community participation |
kuanyin-dharma-analytics - Spiritual and Community Metrics#
5 modules for analytics on community health and individual dharma paths.
| Module | Description |
|---|---|
community-health-metrics |
Aggregate community health dashboards |
individual-dharma-path |
Per-user dharma path and growth tracking |
predictive-wellness |
Predictive models for community wellness |
wisdom-reports |
Generated wisdom reports and insights |
moderation-transparency |
Transparency reports on moderation actions |
kuanyin-cross-domain - Cross-Domain Ethics Integration#
5 modules that integrate Kuanyin's ethics and moderation capabilities across the entire Oshun platform.
| Module | Description |
|---|---|
aphrodite-integration |
Ethics integration with Aphrodite (relationships/dating) domain |
lilith-integration |
Ethics integration with Lilith (consciousness/adult content) domain |
hathor-integration |
Ethics integration with Hathor (worldbuilding) domain |
yemaya-integration |
Ethics integration with Yemaya (creative studio) domain |
platform-wide-integration |
Platform-wide ethical framework and policy enforcement |
This library ensures consistent ethical standards across all Oshun domains, with domain-specific adaptations for each platform's unique content and interaction patterns.
Technology Stack#
| Layer | Technology |
|---|---|
| Language | TypeScript (ESM) |
| Build (foundation) | @nx/esbuild:esbuild (ESM format, unbundled) |
| Build (others) | @nx/js:tsc |
| Testing | Vitest (per-library configs) |
| Type checking | Explicit typecheck target via tsc --noEmit |
The foundation library uses esbuild for ESM output, which provides faster builds. All other libraries use the standard tsc build.
Configuration#
Project tags: ["scope:kuanyin", "layer:domain"]
Build executors:
kuanyin-foundation:@nx/esbuild:esbuild- All others:
@nx/js:tsc
Targets: All libraries include build, lint, test, and typecheck
targets.
Design Philosophy#
The domain is designed around Buddhist principles:
- Buddha Nature - Every entity carries innate goodness and potential for
awakening. The
BuddhaNatureinterface encodes this as numeric properties. - Right Speech (Samma Vaca) - Mindful friction patterns draw from the Noble Eightfold Path.
- Compassionate Guardianship - Moderation guides rather than punishes.
- Rehabilitation over Punishment - Shadow work journeys, restorative circles, and reintegration pathways offer paths back.
- Precognition over Reaction - Proactive detection of harmful intent before harm occurs.
Development#
# Test foundation
pnpm nx test kuanyin-foundation
# Build foundation
pnpm nx build kuanyin-foundation
# Typecheck foundation
pnpm nx typecheck kuanyin-foundation
# Run all kuanyin tests
pnpm nx run-many --target=test --projects=tag:scope:kuanyin
# Build all kuanyin libraries
pnpm nx run-many --target=build --projects=tag:scope:kuanyin
Related Domains#
- Arete - Personal development domain with complementary wellness features
- Aphrodite - Relationships/dating domain receiving ethics integration
- Lilith - Consciousness/content domain receiving performer protection
- Hathor - Worldbuilding domain receiving content moderation
- Yemaya - Creative studio domain receiving safety features