-
Notifications
You must be signed in to change notification settings - Fork 1
Module ethics ai Architecture
The ethics_ai module composes philosophy profile ingestion, argument persistence, discourse orchestration, context assembly, evaluation, and plugin lifecycle wiring into a coherent ethics reasoning runtime for ThemisDB.
The current production mode is SELECTION_ONLY (Top-N school pre-selection via
EthicsSelectionRouter). The Layered Discourse Model (LDM) adds
LAYERED_FULL and LAYERED_FAST modes that satisfy Habermas participatory fairness
while remaining computationally tractable. See FUTURE_ENHANCEMENTS.md and
docs/research/ethics_discourse_process_equality.md for design details.
- profile loading, validation, and registry/index operations
- philosophy selection and routing across school sets
-
LDM extension:
DiscourseModeselection;DiscourseOrchestratorPlangeneration assigning all N schools to Ebene-1 with equal initial weightwβ = 1/N
- debate initialization/continuation and decision generation
- cross-school tension resolution and synthesis support
-
LDM extension (Ebene-1): parallel equal-weight initial scoring for all N schools;
verdict β {PROHIBIT, PERMIT, CONDITIONAL, ABSTAIN}per school - LDM extension (Ebene-2): taxonomy-class cluster discourse (Kβ€6 clusters) along four structural tension axes; O(KΒ²Β·R) instead of O(NΒ²Β·R)
-
LDM extension (Ebene-3): convergence-counting
MetaVerdictwithcross_cultural_flag,minority_dissent[], and positivrechtlichem Legal-DB-Grounding
- argument and decision storage/retrieval contracts
- RAG context assembly, prior-round compression, and matrix synthesis
-
LDM extension:
ClusterPositionpersistence per Ebene-2 cluster;EpisodicMemoryEntryfor inter-cluster tension outcomes
- ethics scoring and metrics emission
- plugin lifecycle integration and runtime observability behavior
-
LDM extension: MetaVerdict audit fields (
participating_schools,convergence_score,discourse_mode) for EU AI Act Art. 13 transparency compliance
- non-western schools (islamische_ethik, konfuzianismus, buddhistische_ethik, juedische_bioethik) participate as structural self-reflection mirrors
- activated per-domain via
cross_cultural_sensitivitypolicy - output:
minority_dissent[]in MetaVerdict β always present in audit trail - cost: β€ 1 LLM inference step per mirror school (parallel to Ebene-2)
| Contract | Behavior |
|---|---|
| profile contract | explicit profile validation/load and lookup behavior |
| discourse contract | deterministic debate and decision orchestration semantics |
| process equality contract (LDM) | all N schools participate in Ebene-1 with equal initial weight |
| audit completeness contract (LDM) | MetaVerdict lists all N schools incl. ABSTAIN |
| context contract | bounded argument memory and context retrieval behavior |
| evaluation/ops contract | explicit scoring, metrics, and plugin lifecycle surfaces |
| legal grounding contract | MetaVerdict grounding uses DB citations, never LLM paraphrase |
DiscourseMode::SELECTION_ONLY (current production)
ββ EthicsSelectionRouter: Top-N pre-selection
ββ Discourse: top_n schools only
ββ MetaVerdict: weighted aggregate
DiscourseMode::LAYERED_FULL (implemented)
ββ Ebene-1: all N schools, parallel, equal wβ=1/N O(N)
ββ Ebene-2: Kβ€6 clusters Γ 3 rounds, tension-axis routing O(KΒ²Β·R)
ββ Ebene-3: convergence-count + legal-DB grounding O(1)+lookup
ββ Mirror: non-western schools, 1 step parallel to Ebene-2
ββ MetaVerdict: convergence_score + cross_cultural_flag + minority_dissent
DiscourseMode::LAYERED_FAST (implemented)
ββ Ebene-1: all N schools parallel (identical to LAYERED_FULL)
ββ Ebene-2: axis-1 only (KantβUtilitarismus) + domain-relevant cluster
ββ Ebene-3: MetaVerdict from Ebene-1 convergence + legal-DB
ββ Target: P95 β€ 1.2 s end-to-end
- invalid profile or school selection paths fail with structured status/error states.
- missing storage/context inputs produce explicit non-silent failure behavior.
- lifecycle misuse (uninitialized plugin paths) fails deterministically.
-
LDM: LLM timeout in Ebene-1 β school receives
ABSTAIN(fail-closed); never silent drop. - LDM: Legal-DB unavailable β MetaVerdict emitted without grounding with explicit observable flag.
-
LDM: All N schools ABSTAIN β
DISSENTMetaVerdict; never silently promoted toSELECTION_ONLY.
- Verified files:
- src/ethics_ai/ethics_ai_plugin.cpp
- src/ethics_ai/discourse_engine.cpp
- src/ethics_ai/argument_store.cpp
- src/ethics_ai/philosophy_loader.cpp
- src/ethics_ai/rag_context_engine.cpp
- src/ethics_ai/ethics_evaluator.cpp
- src/ethics_ai/ethics_profile_registry.cpp
- src/ethics_ai/ethics_selection_router.cpp
- src/ethics_ai/discourse_orchestrator.cpp (DiscourseMode + DiscourseOrchestratorPlan)
- src/ethics_ai/cluster_discourse_engine.cpp (Ebene-2 cluster routing)
- src/ethics_ai/meta_verdict_builder.cpp (Ebene-3 convergence-count + legal grounding)
- src/ethics_ai/mirror_school_handler.cpp (Mirror-School-Modus)
- Verified architecture claims:
- explicit profile/discourse/context/evaluation planes
- bounded deterministic failure behavior in lifecycle and profile paths
- module-local orchestration for ethics reasoning runtime flows
- LDM Ebene-1/2/3 and Mirror-School-Modus implemented and verified
ThemisDB 1.9.0-beta Β· Home Β· Module-Index Β· GitHub Β· Issues
ThemisDB 1.9.0-beta Β· Home Β· Wiki-Index Β· Module-Index Β· FAQ Β· Quick-Reference Β· GitHub Β· Issues Β· Discussions Β· License
- Batch Operations
- Best Practices
- CRUD Tutorial
- Custom Document Ingestion
- Getting Started Tutorial
- Interactive Examples
- Schema Design
- Video Tutorials
- AQL Reference
- AQL Examples
- AQL Overview
- AQL Feature Roadmap
- AQL Geospatial Guide
- AQL LLM Migration Guide
- AQL API
- AQL Grammar (EBNF)
- AQL Root Overview
- AQL Examples (root)
- API Reference
- API Module README
- OpenAPI Overview
- Client SDK Overview
- SDK Overview
- Operations
- Operations Overview
- Operations Runbook
- Operations Handbook
- ThemisCtl Admin Guide
- Pipeline E2E SOPs
- Deploy Overview
- Docker Overview
- Docker Hub README
- Helm Overview
- Packaging Overview
- Operator Overview
- Security Policy
- Production Hardening Checklist
- Security Hardening Guide
- Encryption Key Management
- Access Control Framework
- Zero Trust Policy
- API Authentication & Authorization
- HSM Production Setup
- PKCS11 Integration
- DSGVO / SOC2 Checklist
- Access Model Runbooks
- Access Model Dashboard
- Maturity Automation Runbook
- Access Review Automation
- Access Model Dashboard
- Access Model Runbooks
- Rights Revocation
- Dr Checklists
- Dr Testing
- Incident Response Playbook
- Incident Response Testing
- GPU Oom Recovery
- Grammar Debugging
- Metrics Scrape Troubleshooting
- Model Swap Procedure
- Quota Tuning
- Subagent Deployment
- Logging Configuration
- Content Model
- Crypto & Keys
- Feature Flags Reference
- Modular Architecture Roadmap
- Modularization Guide
- Module Architecture Index
- PostgreSQL Wire Protocol
- Query Scheduling
- Raft Consensus Design
- Resource Pooling
- Source Directory Guide
- Unified Access Model
- E1 001 Layered Retrieval Design
- E1 002 Ann Abstraction Strategy
- E1 003 Tensor Summary Types
- E1 004 Lora Package Distinction
- E1 005 Model Switch Compatibility
- E1 006 Federated Tensor Summaries
- E2 001 Evaluation Framework Design
- E2 002 Hardware Profile Strategy
- E2 003 Query Planner Routing Model
- E2 004 Approximation Governance Rules
- E2 005 Cross Layer Fallback Confidence Policy
- E3 001 Distributed Tensor Design
- E3 002 Manifest Coordination Strategy
- E3 003 Recovery And Erasure Choice
- E3 004 Tensor Fabric Infrastructure
- Contributing
- Contributing (root)
- Code of Conduct
- Support
- Maintainers
- CTest Guide
- Build Quick Reference
- Developer Wiki Index
- Build / Test / CI
- Module Index
- Branching Strategy
- Disabled Stub Policy
- Docs PR Policy
- GA Promotion Sign Off
- Github Milestones Setup
- Maturity Claim Verification Checklist
- Maturity Evidence Registry
- Merge Gate Bot Config
- Merge Gate Status Live
- Phase 1 Closure Report
- Phase Closure Policy
- Phase Dependency Graph
- Phase3 Enforcement Runbook
- Plugin Submodule Rollback
- PR Version Targeting
- PR Version Targeting Backfill
- Production Ready 2026 Delivery Plan
- Query Module Status
- Readme
- Release Promotion Gate Policy
- Release Validation Checklist
- Security Module 5671 Evidence Summary
- Sharding P6 Residual Risk Acceptance
- Sourcecode Compliance Governance
- Updates Development Status Sign Off
- Wave C Implementation Complete
- Blob Storage
- Cuda
- Ethics Ai
- Exporters
- Huggingface
- Image Analysis
- Importers
- RPC
- Scraper
- Themisdb Ai Watermark Detector
- User Storage Encrypted
- Chimera Architecture
- Chimera Future
- Chimera Readme
- Chimera Roadmap
- Covina Fastapi Ingestion Architecture
- Covina Fastapi Ingestion Future
- Covina Fastapi Ingestion Roadmap
- Vcc Base Architecture
- Vcc Base Future
- Vcc Base Roadmap
- Vcc Clara Ingestion Architecture
- Vcc Clara Ingestion Future
- Vcc Clara Ingestion Roadmap
- Vcc Veritas Architecture
- Vcc Veritas Future
- Vcc Veritas Roadmap
- 01 Hello World
- 02 Todo App
- 03 Contact Manager
- 04 Inventory System
- 05 Time Series Monitor
- 06 Graph Social Network
- 07 Vector Search Documents
- 08 Dms Erp System
- 09 Iot Sensor Network
- 10 Drone Image Analysis
- 11 Blog Wiki
- 12 Expense Tracker
- 13 Recipe Manager
- 14 Ecommerce Catalog
- 15 Event Management
- 16 Kanban Board
- 17 Crm
- 18 Realtime Chat
- 19 Recommendation Engine
- 20 Smart Home
- 21 Coding Platform
- 22 AQL Diagram Tool
- 23 Traveling Salesman
- 24 Moral Philosophy Debates
- API Versioning
- Distributed Sharding
- Feedback Plugins
- Geo
- Gnn
- Image Analysis
- Legal Lora Training
- LLM
- Lora Sync
- Migration
- Nlp
- Performance
- Railway
- Replication
- Rope Visualization
- Sample Product Config
- Security
- Client SDK Overview
- Quickstart
- Sdk Enhancements
- Sdk Implementation Summary
- Test Suite Readme
- Go
- Java
- Javascript
- Php
- Python
- Ruby
- Rust
- Typescript
- 01 Grundlegende Operationen
- 02 AQL Queries
- 03 Graph Daten
- 04 Multimodell Anwendung
- 01 Quickstart Guide
- 02 AQL Referenz Kurzuebersicht
- 03 Datenmodellierung Guide
- 04 Uebungsaufgaben
- 05 Best Practices Guide
- Training Documents
- Training Overview
- 01 Einfuehrung Und Uebersicht
- 02 Datenmodelle Und Architektur
- 03 AQL Abfragesprache
- 04 Installation Und Setup
- 05 Anwendungsbeispiele
- Training Presentations
- Dependencies Readme
- Processmonitor Readme
- Themis.admintools.shared Readme
- Themis.aqlquerybuilder Readme
- Themis.aqlquerybuilder Roadmap
- Themis.auditlogviewer Readme
- Themis.auditlogviewer Roadmap
- Themis.classificationdashboard Readme
- Themis.classificationdashboard Roadmap
- Themis.compliancereports Readme
- Themis.compliancereports Roadmap
- Themis.gisviewer.controlpanel Readme
- Themis.gisviewer.controlpanel Roadmap
- Themis.impactanalysisviewer Readme
- Themis.impactanalysisviewer Roadmap
- Themis.ingestiontool Readme
- Themis.ingestiontool Roadmap
- Themis.keyrotationdashboard Readme
- Themis.keyrotationdashboard Roadmap
- Themis.piimanager Readme
- Themis.piimanager Roadmap
- Themis.retentionmanager Readme
- Themis.retentionmanager Roadmap
- Themis.sagaverifier Readme
- Themis.sagaverifier Roadmap
- Themis.usbadmintool Readme
- Themis.usbadmintool Roadmap
- CI Readme
- CI Roadmap
- Compiler Diagnostics Readme
- Compiler Diagnostics Roadmap
- Completion Readme
- Copilot Ollama Router Readme
- Copilot Ollama Router Roadmap
- Gnn Readme
- Gnn Roadmap
- Rope Visualizer Readme
- Rope Visualizer Roadmap
- Tco Calculator Readme
- Tco Calculator Roadmap
- Tests Readme
- Tests Roadmap
- Themis Config Wx Readme
- Themis Docs Builder Readme
- Wikipedia Ingestion Readme