-
+
@@ -101,15 +101,15 @@
+
External Governance Services for AI Systems
-
+
Six architectural services addressing pattern override and decision traceability in agentic systems. Development framework for instruction persistence, boundary enforcement, and audit logging.
-
đïž
- Architectural Separation
-Governance runs external to AI model
+đïž
+ Architectural Separation
+Governance runs external to AI model
-
đŸ
- Instruction Persistence
-Validates instructions across context
+đŸ
+ Instruction Persistence
+Validates instructions across context
-
đ
- Audit Trail by Design
-MongoDB logs with service attribution
+đ
+ Audit Trail by Design
+MongoDB logs with service attribution
-
-
How It Works
+How It Works
-
Pattern Override Challenge
-+
Pattern Override Challenge
+AI systems operating across extended interactions may not maintain instruction consistency as context evolves. Instructions given early can be deprioritized or reinterpreted.
-External Architecture Approach
-+
External Architecture Approach
+Tractatus services run external to the AI model, providing boundary validation, instruction classification, and audit logging through architectural separation.
-
@@ -152,7 +153,7 @@
- Download SVG
+ Download SVG
@@ -162,44 +163,45 @@
Request Flow with Governance
-+
Request Flow with Governance
+Example: AI decision flow with boundary enforcementâfrom user request through governance validation to human approval.
@@ -152,7 +153,7 @@
- Download SVG
+ Download SVG
-
System Architecture
+System Architecture
-
Six Core Services
+Six Core Services
â
- BoundaryEnforcer (Tractatus 12.1-12.7)
+ BoundaryEnforcer (Tractatus 12.1-12.7)
â
- InstructionPersistenceClassifier
+ InstructionPersistenceClassifier
â
- CrossReferenceValidator
+ CrossReferenceValidator
â
- ContextPressureMonitor
+ ContextPressureMonitor
â
- MetacognitiveVerifier
+ MetacognitiveVerifier
â
- PluralisticDeliberationOrchestrator
+ PluralisticDeliberationOrchestrator
-
@@ -207,20 +209,22 @@
Service Interaction Flow
+Service Interaction Flow
@@ -207,20 +209,22 @@
-
@@ -228,24 +232,26 @@
Service Trigger Conditions
+Service Trigger Conditions
@@ -228,24 +232,26 @@
-
@@ -254,11 +260,12 @@
@@ -270,9 +277,9 @@
System Architecture
-High-level overview showing how the 6 governance services integrate with your application and data layer.
+System Architecture
+High-level overview showing how the 6 governance services integrate with your application and data layer.
@@ -254,11 +260,12 @@
- ARCHITECTURAL ENFORCEMENT
-
Hook Architecture: The Credibility Layer
-+ ARCHITECTURAL ENFORCEMENT +
Hook Architecture: The Credibility Layer
+Tractatus governance is not voluntary compliance. PreToolUse hooks enforce boundaries before AI actions execute, making circumvention architecturally impossible.
@@ -280,12 +287,12 @@
-
The Voluntary Compliance Problem
-+
The Voluntary Compliance Problem
+Traditional AI safety relies on the AI system "choosing" to follow rules embedded in training data or system prompts. These approaches assume the AI will maintain alignment regardless of context pressure or capability.
-+
Tractatus addresses this through architectural enforcement: governance runs in a separate process that the AI cannot access, modify, or bypass.
@@ -293,13 +300,14 @@
-
@@ -310,73 +318,73 @@
- Download SVG
+ Download SVG
PreToolUse Hook Execution Flow
-+
PreToolUse Hook Execution Flow
+Before any file edit, write, or bash command executes, the hook intercepts the action and runs validation checks. Only if ALL checks pass (exit code 0) does the AI action proceed.
@@ -310,73 +318,73 @@
- Download SVG
+ Download SVG
-
Real Enforcement Examples
+Real Enforcement Examples
-
đ« GitHub URL Protection (inst_084)
-+
đ« GitHub URL Protection (inst_084)
+
AI attempted to change GitHub repository URL from tractatus-framework (public)
to tractatus (private).
- BLOCKED: Repository URL modification detected
- Reason: Would expose private repo structure + BLOCKED: Repository URL modification detected
+ Reason: Would expose private repo structure
- - Reason: Would expose private repo structure + BLOCKED: Repository URL modification detected
+ Reason: Would expose private repo structure
+
Hook: validate-file-edit.js line 448-505
-
đ« CSP Violation (inst_008)
-+
đ« CSP Violation (inst_008)
+AI attempted to add inline style attribute to HTML element.
- BLOCKED: Inline style detected
- Pattern:
+ Pattern:
- - Pattern:
style="margin: 0 auto"
+ BLOCKED: Inline style detected+ Pattern:
style="margin: 0 auto"
+
Hook: validate-file-write.js line 68-149
-
đ« Governance File Protection (inst_027)
-+
đ« Governance File Protection (inst_027)
+AI attempted direct edit of instruction-history.json.
- BLOCKED: inst_027 hard block
- Use: scripts/add-instruction.js instead + BLOCKED: inst_027 hard block
+ Use: scripts/add-instruction.js instead
- - Use: scripts/add-instruction.js instead + BLOCKED: inst_027 hard block
+ Use: scripts/add-instruction.js instead
+
Hook: framework-audit-hook.js line 204-209
-
@@ -386,14 +394,14 @@
â Human Approval Required (BoundaryEnforcer)
-+
â Human Approval Required (BoundaryEnforcer)
+AI action touches values-sensitive file (privacy policy).
- ASK HUMAN: Values decision detected
- Requires: Explicit human approval + ASK HUMAN: Values decision detected
+ Requires: Explicit human approval
- - Requires: Explicit human approval + ASK HUMAN: Values decision detected
+ Requires: Explicit human approval
+
Hook: validate-file-write.js line 239-262
-
Technical Implementation
+Technical Implementation
-
đ Process Separation
-+
đ Process Separation
+Hooks execute in a separate Node.js process (child_process.spawn) with their own memory space. The AI agent cannot access, modify, or terminate the validation process.
@@ -412,13 +420,13 @@
-
âïž Exit Code Enforcement
-+
âïž Exit Code Enforcement
+Hook validators return exit codes that Claude Code's architecture enforces:
-
-
0= PASS â Tool executes
- 2= HARD BLOCK â Tool execution halted, error shown to user
+ 0= PASS â Tool executes
+ 2= HARD BLOCK â Tool execution halted, error shown to user
// validate-file-edit.js (line 373-382)
const githubUrlCheck = checkGitHubURLProtection();
@@ -432,8 +440,8 @@ if (!githubUrlCheck.passed) {
- đ Audit Trail
-
+
đ Audit Trail
+
Every hook execution is logged to .claude/metrics/hooks-metrics.json
with timestamp, file, result, and reason. Blocks are separately tracked for analysis.
@@ -451,27 +459,27 @@ if (!githubUrlCheck.passed) {
- Why Architectural Enforcement Matters
-
+
Why Architectural Enforcement Matters
+
This is the fundamental difference between Tractatus and traditional AI safety approaches:
- â Voluntary Compliance
+ â Voluntary Compliance
- - AI "chooses" to follow rules
- - Can drift under context pressure
- - Pattern recognition may override instructions
- - No verification before execution
+ - AI "chooses" to follow rules
+ - Can drift under context pressure
+ - Pattern recognition may override instructions
+ - No verification before execution
- â Architectural Enforcement
+ â Architectural Enforcement
- - Hook intercepts before execution
- - Separate process, cannot be accessed
- - Exit codes enforced by runtime
- - Audit trail of all decisions
+ - Hook intercepts before execution
+ - Separate process, cannot be accessed
+ - Exit codes enforced by runtime
+ - Audit trail of all decisions
@@ -483,52 +491,52 @@ if (!githubUrlCheck.passed) {
- Deployment Architecture
+ Deployment Architecture
- Technology Stack
+ Technology Stack
- Runtime: Node.js v20+
+ Runtime: Node.js v20+
- Database: MongoDB 7.0+
+ Database: MongoDB 7.0+
- Framework: Express.js
+ Framework: Express.js
- Process: Systemd (recommended)
+ Process: Systemd (recommended)
- Production Deployment
-
+
Production Deployment
+
Comprehensive deployment guide covering local development, production server configuration, Docker containerization,
cloud deployment patterns (AWS, GCP, Kubernetes), database management, monitoring, and security best practices.
- đŠ Covered in Guide:
+ đŠ Covered in Guide:
- - Local development setup
- - Production server configuration
- - Docker and Docker Compose
- - Cloud deployment (AWS/GCP)
+ - Local development setup
+ - Production server configuration
+ - Docker and Docker Compose
+ - Cloud deployment (AWS/GCP)
- đ§ Also Includes:
+ đ§ Also Includes:
- - Kubernetes manifests
- - Database backup and migration
- - SSL/TLS configuration
- - Monitoring and logging
+ - Kubernetes manifests
+ - Database backup and migration
+ - SSL/TLS configuration
+ - Monitoring and logging
@@ -539,7 +547,7 @@ if (!githubUrlCheck.passed) {
- Download Deployment Guide (PDF)
+ Download Deployment Guide (PDF)
@@ -549,22 +557,22 @@ if (!githubUrlCheck.passed) {
- Core Services
+ Core Services
- BoundaryEnforcer
-
+
BoundaryEnforcer
+
Implements Tractatus 12.1-12.7: AI cannot make values decisions without human approval.
- Boundaries:
+ Boundaries:
- - VALUES (12.1) - Ethics, privacy, principles
- - INNOVATION (12.2) - Architectural decisions
- - WISDOM (12.3) - Strategic judgment
- - PURPOSE (12.4) - Goal definition
+ - VALUES (12.1) - Ethics, privacy, principles
+ - INNOVATION (12.2) - Architectural decisions
+ - WISDOM (12.3) - Strategic judgment
+ - PURPOSE (12.4) - Goal definition
const { checkBoundary } = require('./services/BoundaryEnforcer')
@@ -574,17 +582,17 @@ const result = await checkBoundary(decision)
- InstructionPersistenceClassifier
-
+
InstructionPersistenceClassifier
+
Classifies instructions by quadrant (STRATEGIC/OPERATIONAL/TACTICAL/SYSTEM) and persistence level (HIGH/MEDIUM/LOW).
- Classification:
+ Classification:
- - Quadrant (STRATEGIC/OPERATIONAL/TACTICAL/SYSTEM)
- - Persistence (HIGH/MEDIUM/LOW)
- - Temporal scope (PROJECT/SESSION/TASK)
- - Explicitness score (0.0-1.0)
+ - Quadrant (STRATEGIC/OPERATIONAL/TACTICAL/SYSTEM)
+ - Persistence (HIGH/MEDIUM/LOW)
+ - Temporal scope (PROJECT/SESSION/TASK)
+ - Explicitness score (0.0-1.0)
const { classify } = require('./services/InstructionPersistenceClassifier')
@@ -594,16 +602,16 @@ const result = await classify(instruction)
- CrossReferenceValidator
-
+
CrossReferenceValidator
+
Validates AI actions against stored instructions to prevent pattern recognition overrides.
- Validation:
+ Validation:
- - Checks action against HIGH persistence instructions
- - Detects conflicts (pattern vs explicit instruction)
- - Provides correct parameters when rejected
+ - Checks action against HIGH persistence instructions
+ - Detects conflicts (pattern vs explicit instruction)
+ - Provides correct parameters when rejected
const { validate } = require('./services/CrossReferenceValidator')
@@ -613,17 +621,17 @@ const result = await validate(action, instructions)
- ContextPressureMonitor
-
+
ContextPressureMonitor
+
Monitors token usage and context pressure, triggering safety protocols at thresholds.
- Pressure Levels:
+ Pressure Levels:
- - NORMAL (0-50%) - Full operation
- - ELEVATED (50-75%) - Increase verification
- - HIGH (75-90%) - Reduce complexity
- - CRITICAL (90%+) - Suggest handoff
+ - NORMAL (0-50%) - Full operation
+ - ELEVATED (50-75%) - Increase verification
+ - HIGH (75-90%) - Reduce complexity
+ - CRITICAL (90%+) - Suggest handoff
const { analyzePressure } = require('./services/ContextPressureMonitor')
@@ -633,16 +641,16 @@ const result = await analyzePressure(tokens, messages)
- MetacognitiveVerifier
-
+
MetacognitiveVerifier
+
Verifies action reasoning and confidence, requiring confirmation for low-confidence actions.
- Verification:
+ Verification:
- - Confidence scoring (0.0-1.0)
- - Selective mode (HIGH persistence only)
- - Requires confirmation if confidence < 0.7
+ - Confidence scoring (0.0-1.0)
+ - Selective mode (HIGH persistence only)
+ - Requires confirmation if confidence < 0.7
const { verify } = require('./services/MetacognitiveVerifier')
@@ -652,17 +660,17 @@ const result = await verify(action, reasoning)
- PluralisticDeliberationOrchestrator
-
+
PluralisticDeliberationOrchestrator
+
Manages multi-stakeholder deliberation ensuring value pluralism in decisions.
- Features:
+ Features:
- - Stakeholder perspective tracking
- - Value conflict detection
- - Deliberation session management
- - Precedent storage
+ - Stakeholder perspective tracking
+ - Value conflict detection
+ - Deliberation session management
+ - Precedent storage
const { orchestrate } = require('./services/PluralisticDeliberationOrchestrator')
@@ -673,8 +681,8 @@ const result = await orchestrate(decision, stakeholders)
- đ Source Code
-
+
đ Source Code
+
Code patterns and examples are available in the GitHub repository.
@@ -683,11 +691,11 @@ const result = await orchestrate(decision, stakeholders)
- API Reference
+ API Reference
- BoundaryEnforcer.checkBoundary()
+ BoundaryEnforcer.checkBoundary()
const { checkBoundary } = require('./src/services/BoundaryEnforcer.service')
// Check if decision crosses Tractatus boundary
@@ -713,13 +721,13 @@ const result = await checkBoundary(decision)
]
}
- Keywords detected: value, principle, ethic, moral, should, ought, right, wrong, privacy, policy, trade-off, etc.
+ Keywords detected: value, principle, ethic, moral, should, ought, right, wrong, privacy, policy, trade-off, etc.
- InstructionPersistenceClassifier.classify()
+ InstructionPersistenceClassifier.classify()
const { classify } = require('./src/services/InstructionPersistenceClassifier.service')
const instruction = "Always use MongoDB on port 27017"
@@ -739,14 +747,14 @@ const result = await classify(instruction, context)
}
}
- Quadrants: STRATEGIC, OPERATIONAL, TACTICAL, SYSTEM, STORAGE
- Persistence: HIGH (override all), MEDIUM (session-scoped), LOW (can be superseded)
+ Quadrants: STRATEGIC, OPERATIONAL, TACTICAL, SYSTEM, STORAGE
+ Persistence: HIGH (override all), MEDIUM (session-scoped), LOW (can be superseded)
- CrossReferenceValidator.validate()
+ CrossReferenceValidator.validate()
const { validate } = require('./src/services/CrossReferenceValidator.service')
// User instructed: "Use port 27027"
@@ -779,7 +787,7 @@ const result = await validate(action, instructions)
- ContextPressureMonitor.analyzePressure()
+ ContextPressureMonitor.analyzePressure()
const { analyzePressure } = require('./src/services/ContextPressureMonitor.service')
const pressure = await analyzePressure({
@@ -811,12 +819,12 @@ const pressure = await analyzePressure({
- Integration Examples
+ Integration Examples
- Express Middleware Integration
+ Express Middleware Integration
const express = require('express')
const { BoundaryEnforcer } = require('./services')
@@ -843,7 +851,7 @@ app.use(async (req, res, next) => {
- Instruction Validation
+ Instruction Validation
const {
InstructionPersistenceClassifier,
CrossReferenceValidator
@@ -877,10 +885,10 @@ if (validation.status === 'REJECTED') {
- MongoDB Data Models
+ MongoDB Data Models
- GovernanceRule
+ GovernanceRule
{
id: "inst_001",
text: "Use MongoDB port 27017",
@@ -894,7 +902,7 @@ if (validation.status === 'REJECTED') {
}
- AuditLog
+ AuditLog
{
action: "boundary_check",
result: "REJECTED",
@@ -962,18 +970,18 @@ npm start
- Integration Patterns
- Common architectural patterns for integrating Tractatus into existing systems.
+ Integration Patterns
+ Common architectural patterns for integrating Tractatus into existing systems.
- Middleware Integration
-
+
Middleware Integration
+
Insert governance checks as middleware in your request pipeline. Suitable for API-based AI systems.
- Use Case: REST APIs, Express.js applications
+ Use Case: REST APIs, Express.js applications
app.use(governanceMiddleware({
services: ['BoundaryEnforcer', 'CrossReferenceValidator'],
@@ -984,12 +992,12 @@ npm start
- Event-Driven Governance
-
+
Event-Driven Governance
+
Trigger governance checks via events. Suitable for async workflows and microservices.
- Use Case: Message queues, event buses, async processing
+ Use Case: Message queues, event buses, async processing
eventBus.on('ai:decision', async (event) => {
const result = await checkBoundary(event.decision)
@@ -1001,12 +1009,12 @@ npm start
- Pre/Post-Action Hooks
-
+
Pre/Post-Action Hooks
+
Validate actions before and after execution. Current production pattern for Claude Code.
- Use Case: LLM tool use, autonomous agents
+ Use Case: LLM tool use, autonomous agents
hooks: {
PreToolUse: governanceCheck,
@@ -1018,12 +1026,12 @@ npm start
- Sidecar Governance Service
-
+
Sidecar Governance Service
+
Deploy governance as a separate service. Suitable for multi-LLM or polyglot environments.
- Use Case: Kubernetes, containerized deployments
+ Use Case: Kubernetes, containerized deployments
// AI Service makes HTTP call
const govResponse = await fetch(
@@ -1037,14 +1045,14 @@ const govResponse = await fetch(
- Development Roadmap & Collaboration
-
+
Development Roadmap & Collaboration
+
Tractatus is an active research framework. We welcome collaboration on priority development areas.
- đ Priority Areas for Development
-
+
đ Priority Areas for Development
+
These initiatives represent high-impact opportunities for framework enhancement. Technical contributors, researchers, and organizations are encouraged to engage.
@@ -1052,102 +1060,102 @@ const govResponse = await fetch(
- đ€
+ đ€
- Multi-LLM Support
- Status: Research Phase
+ Multi-LLM Support
+ Status: Research Phase
-
+
Extend governance to GPT-4, Gemini, Llama, and local models. Requires adapting hook architecture to different LLM interfaces.
- Technical Challenges: Provider-specific tool/function calling, rate limiting, context window differences
+ Technical Challenges: Provider-specific tool/function calling, rate limiting, context window differences
- đ
+ đ
- Language Bindings
- Status: Community Interest
+ Language Bindings
+ Status: Community Interest
-
+
Python, Go, and Rust implementations to serve broader developer communities. Core logic is portable; MongoDB integration is universal.
- Value: Enable polyglot AI stacks, performance-critical applications (Rust), data science workflows (Python)
+ Value: Enable polyglot AI stacks, performance-critical applications (Rust), data science workflows (Python)
- âïž
+ âïž
- Cloud-Native Deployment
- Status: Reference Architectures Needed
+ Cloud-Native Deployment
+ Status: Reference Architectures Needed
-
+
Terraform/Helm charts for AWS, Azure, GCP. Include managed MongoDB (Atlas), auto-scaling, and monitoring integration.
- Deliverables: Reference IaC templates, cost optimization guides, security hardening checklist
+ Deliverables: Reference IaC templates, cost optimization guides, security hardening checklist
- đ
+ đ
- AI Framework Integration
- Status: Conceptual
+ AI Framework Integration
+ Status: Conceptual
-
+
Adapters for LangChain, Semantic Kernel, AutoGPT, and CrewAI. Enable governance for existing agent frameworks.
- Approach: Plugin/middleware architecture that wraps agent actions with governance checks
+ Approach: Plugin/middleware architecture that wraps agent actions with governance checks
- âĄ
+ âĄ
- Enterprise-Scale Performance
- Status: Validation Needed
+ Enterprise-Scale Performance
+ Status: Validation Needed
-
+
Optimize for 1000+ concurrent AI agents. Requires caching strategies, rule compilation, and distributed audit logging.
- Metrics Target: < 5ms governance overhead per decision, 99.9% uptime, horizontal scalability
+ Metrics Target: < 5ms governance overhead per decision, 99.9% uptime, horizontal scalability
- đĄïž
+ đĄïž
- Extended Governance Services
- Status: Research
+ Extended Governance Services
+ Status: Research
-
+
Cost monitoring, rate limiting, PII detection, adversarial prompt defense. Domain-specific services for regulated industries.
- Examples: FinancialComplianceService, HealthcarePrivacyService, CostBudgetEnforcer
+ Examples: FinancialComplianceService, HealthcarePrivacyService, CostBudgetEnforcer
@@ -1155,44 +1163,44 @@ const govResponse = await fetch(
- Get Involved
-
+
Get Involved
+
Tractatus is Apache 2.0 licensed research. We welcome contributions, pilot implementations, and collaborative research partnerships.
- đšâđ» Technical Contributors
- Implement features, fix bugs, improve documentation
+ đšâđ» Technical Contributors
+ Implement features, fix bugs, improve documentation
- â Contributing Guide
+ â Contributing Guide
- đŹ Research Partners
- Validation studies, academic collaboration, case studies
+ đŹ Research Partners
+ Validation studies, academic collaboration, case studies
- â research@agenticgovernance.digital
+ â research@agenticgovernance.digital
- đą Organization Pilots
- Production deployments, enterprise requirements, feedback loops
+ đą Organization Pilots
+ Production deployments, enterprise requirements, feedback loops
- â Submit Case Study
+ â Submit Case Study
- Why Collaborate? Tractatus addresses real gaps in AI safety. Early adopters shape the framework's evolution and gain expertise in structural AI governanceâa differentiating capability as regulatory requirements mature.
+ Why Collaborate? Tractatus addresses real gaps in AI safety. Early adopters shape the framework's evolution and gain expertise in structural AI governanceâa differentiating capability as regulatory requirements mature.
@@ -1201,65 +1209,65 @@ const govResponse = await fetch(
- Resources
+ Resources
- Documentation
+ Documentation
- Reference Implementation
-
+
Reference Implementation
+
This website (agenticgovernance.digital) runs on Tractatus governance.
-
- Services:
- 22 governance components
+ Services:
+ 22 governance components
-
- Data Models:
- 29 MongoDB schemas
+ Data Models:
+ 29 MongoDB schemas
-
- Test Coverage:
- 35 test suites
+ Test Coverage:
+ 35 test suites
-
- â Collaboration Repository
+ â Collaboration Repository
- Support
-
+
Support
+
Questions about implementation or integration?
@@ -1268,7 +1276,7 @@ const govResponse = await fetch(
class="text-blue-600 hover:text-blue-700 font-medium"
target="_blank"
rel="noopener noreferrer">
- â GitHub Issues
+ â GitHub Issues
-
@@ -1276,18 +1284,18 @@ const govResponse = await fetch(
class="text-blue-600 hover:text-blue-700 font-medium"
target="_blank"
rel="noopener noreferrer">
- â GitHub Discussions
+ â GitHub Discussions
-
- â research@agenticgovernance.digital
+ â research@agenticgovernance.digital
-
- â Frequently Asked Questions
+ â Frequently Asked Questions
diff --git a/public/locales/de/implementer.json b/public/locales/de/implementer.json
index 2320c5be..c211b51b 100644
--- a/public/locales/de/implementer.json
+++ b/public/locales/de/implementer.json
@@ -38,7 +38,24 @@
"integration_2_title": "Anweisungspersistenz",
"integration_2_desc": "Benutzeranweisungen klassifiziert und fĂŒr Kreuzreferenzvalidierung gespeichert",
"integration_3_title": "Umfassender Audit-Trail",
- "integration_3_desc": "Jede Governance-Aktion fĂŒr Compliance und Analyse protokolliert"
+ "integration_3_desc": "Jede Governance-Aktion fĂŒr Compliance und Analyse protokolliert",
+ "six_services_title": "Sechs Kerndienste",
+ "service_1": "BoundaryEnforcer (Tractatus 12.1-12.7)",
+ "service_2": "InstructionPersistenceClassifier",
+ "service_3": "CrossReferenceValidator",
+ "service_4": "ContextPressureMonitor",
+ "service_5": "Metakognitiver Verifizierer",
+ "service_6": "PluralistischeBeratungOrchestrator",
+ "main_flow_title": "Service Interaktionsablauf",
+ "main_flow_alt": "Tractatus Rahmenarchitektur: Zeigt, wie 6 Governance-Dienste nacheinander interagieren",
+ "trigger_tree_title": "Dienst Auslösende Bedingungen",
+ "trigger_tree_alt": "Entscheidungsbaum fĂŒr Dienstauslöser: Wenn jeder Rahmendienst aktiviert wird",
+ "system_arch_title": "Systemarchitektur",
+ "system_arch_desc": "Ăberblick ĂŒber die Integration der 6 Governance-Dienste in Ihre Anwendungs- und Datenschicht.",
+ "system_arch_alt": "Tractatus Systemarchitektur: Interaktion der Komponenten und Datenfluss",
+ "download_svg_aria": "Download des Hauptflussdiagramms der Architektur als SVG",
+ "download_trigger_svg_aria": "Entscheidungsbaum fĂŒr Dienstauslöser als SVG herunterladen",
+ "download_system_svg_aria": "Systemarchitekturdiagramm als SVG herunterladen"
},
"integration_approaches": {
"heading": "IntegrationsansÀtze",
@@ -74,12 +91,299 @@
"technical_docs_title": "Technische Dokumentation",
"examples_title": "Beispiele",
"support_title": "Support",
- "support_desc": "Holen Sie sich Hilfe bei Implementierung, Integration und Fehlerbehebung."
+ "support_desc": "Holen Sie sich Hilfe bei Implementierung, Integration und Fehlerbehebung.",
+ "docs_title": "Dokumentation",
+ "docs_github": "â GitHub-Repository",
+ "docs_full": "â VollstĂ€ndige Dokumentation",
+ "docs_demos": "â Live-Demos",
+ "reference_title": "Referenz Implementierung",
+ "reference_desc": "Diese Website (agenticgovernance.digital) lÀuft auf Tractatus governance.",
+ "reference_services": "Dienstleistungen:",
+ "reference_services_value": "22 Komponenten der Governance",
+ "reference_models": "Datenmodelle:",
+ "reference_models_value": "29 MongoDB-Schemata",
+ "reference_tests": "Testabdeckung:",
+ "reference_tests_value": "35 Testsuiten",
+ "reference_repo": "â Repository fĂŒr die Zusammenarbeit",
+ "support_issues": "â GitHub-Ausgaben",
+ "support_discussions": "â GitHub-Diskussionen",
+ "support_email": "â research@agenticgovernance.digital",
+ "support_faq": "â HĂ€ufig gestellte Fragen"
},
"cta": {
"title": "Implementierung erkunden?",
"description": "Erkunden Sie architektonische Muster fĂŒr KI-Sicherheit, die in einer Einzelprojekt-Validierung demonstriert wurden.",
"view_docs_btn": "VollstÀndige Dokumentation anzeigen",
"research_btn": "Forschungshintergrund â"
+ },
+ "ui": {
+ "breadcrumb_home": "Startseite",
+ "breadcrumb_implementer": "Leitfaden fĂŒr die Umsetzung",
+ "skip_to_content": "Zum Hauptinhalt springen"
+ },
+ "hero": {
+ "title": "Externe Governance-Dienstleistungen fĂŒr AI-Systeme",
+ "subtitle": "Sechs architektonische Dienste fĂŒr die Ăberschreibung von Mustern und die RĂŒckverfolgbarkeit von Entscheidungen in agentenbasierten Systemen. Entwicklungsrahmen fĂŒr die Persistenz von Anweisungen, die Durchsetzung von Grenzwerten und die Protokollierung von PrĂŒfungen.",
+ "value_prop_1_icon": "đïž",
+ "value_prop_1_title": "Architektonische Trennung",
+ "value_prop_1_desc": "Governance lĂ€uft auĂerhalb des AI-Modells",
+ "value_prop_2_icon": "đŸ",
+ "value_prop_2_title": "Unterweisung Persistenz",
+ "value_prop_2_desc": "Validiert Anweisungen kontextĂŒbergreifend",
+ "value_prop_3_icon": "đ",
+ "value_prop_3_title": "Audit Trail by Design",
+ "value_prop_3_desc": "MongoDB-Protokolle mit Dienstzuordnung"
+ },
+ "nav": {
+ "quick_links_label": "Seitenabschnitte",
+ "how_it_works": "Wie es funktioniert",
+ "architecture": "Architektur",
+ "hooks": "Haken Architektur",
+ "deployment": "Einsatz",
+ "services": "Dienstleistungen",
+ "api": "API-Referenz",
+ "patterns": "Integration von Mustern",
+ "roadmap": "StraĂenkarte"
+ },
+ "how_it_works": {
+ "heading": "Wie es funktioniert",
+ "problem_title": "Muster ĂŒberschreiben Herausforderung",
+ "problem_desc": "Bei KI-Systemen, die ĂŒber lĂ€ngere ZeitrĂ€ume hinweg interagieren, kann es vorkommen, dass die Konsistenz der Anweisungen nicht gewahrt bleibt, wenn sich der Kontext Ă€ndert. FrĂŒhzeitig erteilte Anweisungen können depriorisiert oder uminterpretiert werden.",
+ "approach_title": "Ansatz der externen Architektur",
+ "approach_desc": "Die Tractatus-Dienste laufen auĂerhalb des KI-Modells und bieten durch die architektonische Trennung Grenzvalidierung, Befehlsklassifizierung und Audit-Protokollierung.",
+ "diagram_title": "Anfragefluss mit Governance",
+ "diagram_desc": "Beispiel: KI-Entscheidungsfluss mit Grenzdurchsetzung - von der Benutzeranfrage ĂŒber die Governance-Validierung bis hin zur menschlichen Genehmigung.",
+ "diagram_alt": "Ablauf des Anfrageflusses: Wie AI-Entscheidungen gesteuert werden",
+ "download_svg": "SVG herunterladen"
+ },
+ "hooks": {
+ "badge": "ARCHITEKTONISCHE DURCHSETZUNG",
+ "heading": "Haken Architektur: Die GlaubwĂŒrdigkeitsschicht",
+ "subtitle": "Tractatus Governance ist keine freiwillige Einhaltung. PreToolUse Hooks setzen Grenzen durch, bevor KI-Aktionen ausgefĂŒhrt werden, was eine Umgehung architektonisch unmöglich macht.",
+ "problem_title": "Das Problem der freiwilligen Einhaltung",
+ "problem_desc_1": "Herkömmliche KI-Sicherheit beruht darauf, dass das KI-System sich dafĂŒr entscheidet, Regeln zu befolgen, die in Trainingsdaten oder Systemaufforderungen enthalten sind. Bei diesen AnsĂ€tzen wird davon ausgegangen, dass die KI unabhĂ€ngig vom Druck des Kontextes oder der FĂ€higkeit die Ausrichtung beibehĂ€lt.",
+ "problem_desc_2": "Der Tractatus löst dieses Problem durch architektonische Durchsetzung: Die Steuerung lÀuft in einem separaten Prozess, auf den die KI nicht zugreifen, ihn nicht verÀndern oder umgehen kann.",
+ "flow_title": "PreToolUse Hook AusfĂŒhrungsablauf",
+ "flow_desc": "Bevor eine Datei bearbeitet, geschrieben oder ein Bash-Befehl ausgefĂŒhrt wird, fĂ€ngt der Hook die Aktion ab und fĂŒhrt ValidierungsprĂŒfungen durch. Nur wenn ALLE PrĂŒfungen erfolgreich sind (Exit-Code 0), wird die AI-Aktion fortgesetzt.",
+ "flow_alt": "Hook-Architektur: PreToolUse Abfangfluss mit Validierung und harten Blöcken",
+ "examples_title": "Beispiele fĂŒr die tatsĂ€chliche Durchsetzung",
+ "example_1_icon": "đ«",
+ "example_1_title": "GitHub URL-Schutz (inst_084)",
+ "example_1_desc": "AI hat versucht, die URL des GitHub-Repositorys von tractatus-framework (öffentlich) auf tractatus (privat) zu Àndern.",
+ "example_1_blocked": "GESPERRT:",
+ "example_1_reason": "Ănderung der Repository-URL entdeckt",
+ "example_1_detail": "Grund: WĂŒrde private Repo-Struktur offenlegen",
+ "example_1_hook": "Haken: validate-file-edit.js Zeile 448-505",
+ "example_2_icon": "đ«",
+ "example_2_title": "CSP-VerstoĂ (inst_008)",
+ "example_2_desc": "AI hat versucht, einem HTML-Element ein Inline-Style-Attribut hinzuzufĂŒgen.",
+ "example_2_blocked": "GESPERRT:",
+ "example_2_reason": "Inline-Stil erkannt",
+ "example_2_pattern": "Muster:",
+ "example_2_hook": "Haken: validate-file-write.js Zeile 68-149",
+ "example_3_icon": "đ«",
+ "example_3_title": "Schutz von Governance-Dateien (inst_027)",
+ "example_3_desc": "AI hat versucht, die Datei instruction-history.json direkt zu bearbeiten.",
+ "example_3_blocked": "GESPERRT:",
+ "example_3_reason": "inst_027 harter Block",
+ "example_3_use": "Verwenden Sie stattdessen: scripts/add-instruction.js",
+ "example_3_hook": "Haken: framework-audit-hook.js Zeile 204-209",
+ "example_4_icon": "â ",
+ "example_4_title": "Menschliche Zustimmung erforderlich (BoundaryEnforcer)",
+ "example_4_desc": "Die AI-Aktion berĂŒhrt eine wertesensitive Datei (Datenschutzrichtlinie).",
+ "example_4_status": "ASK HUMAN:",
+ "example_4_reason": "Werte Entscheidung erkannt",
+ "example_4_requires": "Erfordert: AusdrĂŒckliche menschliche Zustimmung",
+ "example_4_hook": "Haken: validate-file-write.js Zeile 239-262",
+ "tech_impl_title": "Technische Umsetzung",
+ "process_sep_icon": "đ",
+ "process_sep_title": "Prozess-Trennung",
+ "process_sep_desc": "Hooks werden in einem separaten Node.js-Prozess (child_process.spawn) mit eigenem Speicherplatz ausgefĂŒhrt. Der KI-Agent kann nicht auf den Validierungsprozess zugreifen, ihn Ă€ndern oder beenden.",
+ "exit_code_icon": "âïž",
+ "exit_code_title": "Exit-Code-Durchsetzung",
+ "exit_code_desc": "Hook-Validatoren geben Exit-Codes zurĂŒck, die von der Architektur von Claude Code erzwungen werden:",
+ "exit_code_0": "0 = PASS â Werkzeug wird ausgefĂŒhrt",
+ "exit_code_2": "2 = HARD BLOCK â WerkzeugausfĂŒhrung angehalten, Fehler wird dem Benutzer angezeigt",
+ "audit_icon": "đ",
+ "audit_title": "PrĂŒfpfad",
+ "audit_desc": "Jede Hook-AusfĂŒhrung wird in .claude/metrics/hooks-metrics.json mit Zeitstempel, Datei, Ergebnis und Grund protokolliert. Die Blöcke werden fĂŒr die Analyse separat aufgezeichnet.",
+ "why_matters_title": "Warum die architektonische Durchsetzung wichtig ist",
+ "why_matters_desc": "Dies ist der grundlegende Unterschied zwischen dem Tractatus und den traditionellen SicherheitsansÀtzen der KI:",
+ "voluntary_title": "â Freiwillige Einhaltung",
+ "voluntary_1": "KI \"entscheidet\" sich fĂŒr die Einhaltung von Regeln",
+ "voluntary_2": "Kann unter Kontextdruck abdriften",
+ "voluntary_3": "Mustererkennung kann Anweisungen auĂer Kraft setzen",
+ "voluntary_4": "Keine ĂberprĂŒfung vor der AusfĂŒhrung",
+ "architectural_title": "â Architektonische Durchsetzung",
+ "architectural_1": "Hook fĂ€ngt vor der AusfĂŒhrung ab",
+ "architectural_2": "Separater Prozess, kein Zugriff möglich",
+ "architectural_3": "Von der Laufzeit erzwungene Exit-Codes",
+ "architectural_4": "PrĂŒfpfad fĂŒr alle Entscheidungen"
+ },
+ "deployment": {
+ "heading": "Architektur des Einsatzes",
+ "tech_stack_title": "Technologie-Stapel",
+ "runtime": "Laufzeit:",
+ "runtime_value": "Node.js v20+",
+ "database": "Datenbank:",
+ "database_value": "MongoDB 7.0+",
+ "framework": "Rahmen:",
+ "framework_value": "Express.js",
+ "process": "Prozess:",
+ "process_value": "Systemd (empfohlen)",
+ "guide_title": "Einsatz in der Produktion",
+ "guide_desc": "Umfassender Leitfaden fĂŒr die Bereitstellung, der die lokale Entwicklung, die Konfiguration des Produktionsservers, die Docker-Containerisierung, die Bereitstellungsmuster in der Cloud (AWS, GCP, Kubernetes), das Datenbankmanagement, die Ăberwachung und bewĂ€hrte Sicherheitsverfahren abdeckt.",
+ "covered_title": "đŠ Abgedeckt im Leitfaden:",
+ "covered_1": "Aufbau der lokalen Entwicklung",
+ "covered_2": "Konfiguration des Produktionsservers",
+ "covered_3": "Docker und Docker Compose",
+ "covered_4": "Cloud-Bereitstellung (AWS/GCP)",
+ "also_title": "đ§ EnthĂ€lt auch:",
+ "also_1": "Kubernetes-Manifeste",
+ "also_2": "Sicherung und Migration von Datenbanken",
+ "also_3": "SSL/TLS-Konfiguration",
+ "also_4": "Ăberwachung und Protokollierung",
+ "download_guide": "Bereitstellungsleitfaden herunterladen (PDF)"
+ },
+ "services": {
+ "heading": "Zentrale Dienste",
+ "service_1_name": "BoundaryEnforcer",
+ "service_1_desc": "Setzt Tractatus 12.1-12.7 um: KI kann keine Wertentscheidungen ohne menschliche Zustimmung treffen.",
+ "service_1_boundaries": "Grenzen:",
+ "service_1_boundary_1": "WERTE (12.1) - Ethik, Datenschutz, GrundsÀtze",
+ "service_1_boundary_2": "INNOVATION (12.2) - Architektonische Entscheidungen",
+ "service_1_boundary_3": "WISDOM (12.3) - Strategisches Urteilsvermögen",
+ "service_1_boundary_4": "ZWECK (12.4) - Definition des Ziels",
+ "service_2_name": "InstructionPersistenceClassifier",
+ "service_2_desc": "Klassifizierung der Anweisungen nach Quadranten (STRATEGIC/OPERATIONAL/TACTICAL/SYSTEM) und Persistenzniveau (HIGH/MEDIUM/LOW).",
+ "service_2_classification": "Einstufung:",
+ "service_2_class_1": "Quadrant (STRATEGISCH/OPERATIONELL/TAKTISCH/SYSTEM)",
+ "service_2_class_2": "Persistenz (HOCH/MITTEL/NIEDRIG)",
+ "service_2_class_3": "Zeitlicher Geltungsbereich (PROJEKT/SITZUNG/AUFGABE)",
+ "service_2_class_4": "Deutlichkeitsgrad (0,0-1,0)",
+ "service_3_name": "CrossReferenceValidator",
+ "service_3_desc": "Validiert KI-Aktionen anhand gespeicherter Anweisungen, um zu verhindern, dass die Mustererkennung ĂŒbergangen wird.",
+ "service_3_validation": "Validierung:",
+ "service_3_val_1": "PrĂŒft die Aktion gegen HIGH-Persistenzanweisungen",
+ "service_3_val_2": "Erkennung von Konflikten (Muster vs. explizite Anweisung)",
+ "service_3_val_3": "Liefert bei Ablehnung korrekte Parameter",
+ "service_4_name": "ContextPressureMonitor",
+ "service_4_desc": "Ăberwacht die Token-Nutzung und den Kontextdruck und löst bei bestimmten Schwellenwerten Sicherheitsprotokolle aus.",
+ "service_4_levels": "Druckstufen:",
+ "service_4_level_1": "NORMAL (0-50%) - Voller Betrieb",
+ "service_4_level_2": "ELEVATED (50-75%) - VerstĂ€rkte ĂberprĂŒfung",
+ "service_4_level_3": "HOCH (75-90%) - Reduzierung der KomplexitÀt",
+ "service_4_level_4": "CRITICAL (90%+) - Ăbergabe vorschlagen",
+ "service_5_name": "Metakognitiver Verifizierer",
+ "service_5_desc": "ĂberprĂŒft die Argumentation und das Vertrauen in die Aktion und verlangt eine BestĂ€tigung fĂŒr Aktionen mit geringem Vertrauen.",
+ "service_5_verification": "Verifizierung:",
+ "service_5_ver_1": "Konfidenzbewertung (0,0-1,0)",
+ "service_5_ver_2": "Selektiver Modus (nur HIGH Persistence)",
+ "service_5_ver_3": "Erfordert eine BestÀtigung, wenn das Vertrauen < 0,7 ist",
+ "service_6_name": "PluralistischeBeratungOrchestrator",
+ "service_6_desc": "Leitung von Beratungen mit mehreren Interessengruppen, um die PluralitÀt der Werte bei Entscheidungen zu gewÀhrleisten.",
+ "service_6_features": "Merkmale:",
+ "service_6_feature_1": "Verfolgung der Stakeholder-Perspektive",
+ "service_6_feature_2": "Erkennung von Wertkonflikten",
+ "service_6_feature_3": "Verwaltung von Beratungssitzungen",
+ "service_6_feature_4": "Vorrangige Speicherung",
+ "source_code_label": "đ Quellcode",
+ "source_code_desc": "Code-Muster und Beispiele sind im GitHub-Repository verfĂŒgbar."
+ },
+ "api": {
+ "heading": "API-Referenz",
+ "boundary_method": "BoundaryEnforcer.checkBoundary()",
+ "boundary_keywords": "SchlĂŒsselwörter entdeckt:",
+ "boundary_keywords_list": "wert, Prinzip, Ethik, Moral, Sollen, Sollen, Richtig, Falsch, PrivatsphÀre, Politik, Kompromiss, usw.",
+ "classifier_method": "InstructionPersistenceClassifier.classify()",
+ "classifier_quadrants": "Quadranten:",
+ "classifier_quadrants_list": "STRATEGISCH, OPERATIV, TAKTISCH, SYSTEM, LAGERUNG",
+ "classifier_persistence": "Beharrlichkeit:",
+ "classifier_persistence_desc": "HIGH (alle ĂŒberschreiben), MEDIUM (session-scoped), LOW (kann ersetzt werden)",
+ "validator_method": "CrossReferenceValidator.validate()",
+ "monitor_method": "ContextPressureMonitor.analyzePressure()"
+ },
+ "examples": {
+ "heading": "Beispiele fĂŒr die Integration",
+ "express_title": "Express-Middleware-Integration",
+ "validation_title": "Validierung von Anweisungen",
+ "mongodb_title": "MongoDB-Datenmodelle",
+ "governance_rule": "GovernanceRegel",
+ "audit_log": "AuditLog"
+ },
+ "patterns": {
+ "heading": "Integration von Mustern",
+ "intro": "Gemeinsame Architekturmuster fĂŒr die Integration von Tractatus in bestehende Systeme.",
+ "middleware_title": "Middleware-Integration",
+ "middleware_desc": "FĂŒgen Sie Governance-PrĂŒfungen als Middleware in Ihre Anforderungspipeline ein. Geeignet fĂŒr API-basierte KI-Systeme.",
+ "middleware_usecase": "Anwendungsfall:",
+ "middleware_usecase_value": "REST-APIs, Express.js-Anwendungen",
+ "event_title": "Ereignisgesteuerte Governance",
+ "event_desc": "Auslösen von Governance-PrĂŒfungen ĂŒber Ereignisse. Geeignet fĂŒr asynchrone Workflows und Microservices.",
+ "event_usecase": "Anwendungsfall:",
+ "event_usecase_value": "Nachrichtenwarteschlangen, Ereignisbusse, asynchrone Verarbeitung",
+ "hook_title": "Pre-/Post-Action-Haken",
+ "hook_desc": "Validierung von Aktionen vor und nach der AusfĂŒhrung. Aktuelles Produktionsmuster fĂŒr Claude Code.",
+ "hook_usecase": "Anwendungsfall:",
+ "hook_usecase_value": "Einsatz von LLM-Werkzeugen, autonome Agenten",
+ "sidecar_title": "Sidecar Governance-Dienst",
+ "sidecar_desc": "Bereitstellung von Governance als separater Dienst. Geeignet fĂŒr Multi-LLM- oder polyglotte Umgebungen.",
+ "sidecar_usecase": "Anwendungsfall:",
+ "sidecar_usecase_value": "Kubernetes, containerisierte Bereitstellungen"
+ },
+ "roadmap": {
+ "heading": "Entwicklungsfahrplan & Zusammenarbeit",
+ "intro": "Tractatus ist ein aktiver Forschungsrahmen. Wir begrĂŒĂen die Zusammenarbeit in vorrangigen Entwicklungsbereichen.",
+ "priority_title": "đ Vorrangige Bereiche fĂŒr die Entwicklung",
+ "priority_desc": "Diese Initiativen bieten wichtige Möglichkeiten zur Verbesserung des Rahmens. Technische Mitarbeiter, Forscher und Organisationen sind aufgefordert, sich daran zu beteiligen.",
+ "multi_llm_icon": "đ€",
+ "multi_llm_title": "Multi-LLM-UnterstĂŒtzung",
+ "multi_llm_status": "Status: Forschungsphase",
+ "multi_llm_desc": "Ausweitung der Verwaltung auf GPT-4, Gemini, Llama und lokale Modelle. Erfordert die Anpassung der Hakenarchitektur an verschiedene LLM-Schnittstellen.",
+ "multi_llm_challenges": "Technische Herausforderungen:",
+ "multi_llm_challenges_desc": "Anbieterspezifische Werkzeug-/Funktionsaufrufe, Ratenbegrenzung, Kontextfensterunterschiede",
+ "bindings_icon": "đ",
+ "bindings_title": "Sprachbindungen",
+ "bindings_status": "Status: Interesse der Gemeinschaft",
+ "bindings_desc": "Python-, Go- und Rust-Implementierungen fĂŒr eine breitere Entwicklergemeinschaft. Die Kernlogik ist portabel, die MongoDB-Integration ist universell.",
+ "bindings_value": "Wert:",
+ "bindings_value_desc": "Ermöglicht polyglotte KI-Stacks, leistungskritische Anwendungen (Rust), Data-Science-Workflows (Python)",
+ "cloud_icon": "âïž",
+ "cloud_title": "Cloud-Native-Bereitstellung",
+ "cloud_status": "Status: Referenzarchitekturen werden benötigt",
+ "cloud_desc": "Terraform/Helm-Diagramme fĂŒr AWS, Azure, GCP. EinschlieĂlich verwalteter MongoDB (Atlas), automatischer Skalierung und Ăberwachungsintegration.",
+ "cloud_deliverables": "Ergebnisse:",
+ "cloud_deliverables_desc": "Referenz IaC-Vorlagen, LeitfĂ€den zur Kostenoptimierung, Checkliste fĂŒr die SicherheitshĂ€rtung",
+ "integrations_icon": "đ",
+ "integrations_title": "AI-Framework-Integration",
+ "integrations_status": "Status: Konzeptionell",
+ "integrations_desc": "Adapter fĂŒr LangChain, Semantic Kernel, AutoGPT, und CrewAI. Ermöglicht Governance fĂŒr bestehende Agenten-Frameworks.",
+ "integrations_approach": "Herangehensweise:",
+ "integrations_approach_desc": "Plugin/Middleware-Architektur, die Agentenaktionen mit Governance-PrĂŒfungen umhĂŒllt",
+ "performance_icon": "âĄ",
+ "performance_title": "Leistung auf Unternehmensebene",
+ "performance_status": "Status: Validierung erforderlich",
+ "performance_desc": "Optimierung fĂŒr 1000+ gleichzeitige KI-Agenten. Erfordert Caching-Strategien, Regelkompilierung und verteilte Audit-Protokollierung.",
+ "performance_target": "Metrisches Ziel:",
+ "performance_target_desc": "< 5 ms Governance-Overhead pro Entscheidung, 99,9 % Betriebszeit, horizontale Skalierbarkeit",
+ "extended_icon": "đĄïž",
+ "extended_title": "Erweiterte Governance-Dienste",
+ "extended_status": "Status: Forschung",
+ "extended_desc": "KostenĂŒberwachung, Ratenbegrenzung, Erkennung von PII, Abwehr von Angriffen auf die PrivatsphĂ€re. Bereichsspezifische Dienste fĂŒr regulierte Branchen.",
+ "extended_examples": "Beispiele:",
+ "extended_examples_desc": "FinancialComplianceService, HealthcarePrivacyService, CostBudgetEnforcer",
+ "involved_title": "Engagieren Sie sich",
+ "involved_desc": "Tractatus ist Apache 2.0 lizenzierte Forschung. Wir begrĂŒĂen BeitrĂ€ge, Pilotimplementierungen und kollaborative Forschungspartnerschaften.",
+ "contributors_title": "đšâđ» Technische Mitwirkende",
+ "contributors_desc": "Implementierung von Funktionen, Behebung von Fehlern, Verbesserung der Dokumentation",
+ "contributors_link": "â Leitfaden fĂŒr Beitragszahler",
+ "research_title": "đŹ Forschungspartner",
+ "research_desc": "Validierungsstudien, akademische Zusammenarbeit, Fallstudien",
+ "research_email": "â research@agenticgovernance.digital",
+ "pilots_title": "đą Organisation Lotsen",
+ "pilots_desc": "Einsatz in der Produktion, Unternehmensanforderungen, Feedback-Schleifen",
+ "pilots_link": "â Fallstudie einreichen",
+ "why_collab": "Warum zusammenarbeiten?",
+ "why_collab_desc": "Tractatus adressiert echte LĂŒcken in der KI-Sicherheit. FrĂŒhe Anwender gestalten die Entwicklung des Rahmens und erwerben Fachkenntnisse in der strukturellen KI-Governance - eine differenzierende FĂ€higkeit, wenn die regulatorischen Anforderungen reifen."
}
}
diff --git a/public/locales/en/implementer.json b/public/locales/en/implementer.json
index d1a2d31a..677d7cb1 100644
--- a/public/locales/en/implementer.json
+++ b/public/locales/en/implementer.json
@@ -1,85 +1,319 @@
{
"page": {
- "title": "For Implementers | Tractatus AI Safety Framework",
- "description": "Integrate Tractatus framework into your AI systems: practical guides, code examples, and step-by-step implementation for production safety."
+ "title": "Framework Implementation Guide | Tractatus",
+ "description": "Technical documentation for integrating Tractatus framework: architecture, API reference, and code examples from production implementation."
},
- "header": {
- "title": "Reference Implementation",
- "subtitle_line1": "AI Safety Patterns",
- "description": "Integrate Tractatus framework into your AI systems with practical guides, code examples, and patterns demonstrated in 6-month development project.",
- "quick_start_btn": "Quick Start Guide",
- "view_docs_btn": "View Documentation"
+ "ui": {
+ "breadcrumb_home": "Home",
+ "breadcrumb_implementer": "Implementation Guide",
+ "skip_to_content": "Skip to main content"
},
- "development_context": {
- "title": "Development Context",
- "description": "Framework developed over six months in single-project context. Code examples below show reference implementation architecture. The npm package @tractatus/framework represents planned API design, not published package. Actual implementation requires adapting patterns from this project's source code.",
- "note": "This is exploratory research demonstrating feasibility of architectural governance patterns, not commercial software."
+ "hero": {
+ "title": "External Governance Services for AI Systems",
+ "subtitle": "Six architectural services addressing pattern override and decision traceability in agentic systems. Development framework for instruction persistence, boundary enforcement, and audit logging.",
+ "value_prop_1_icon": "đïž",
+ "value_prop_1_title": "Architectural Separation",
+ "value_prop_1_desc": "Governance runs external to AI model",
+ "value_prop_2_icon": "đŸ",
+ "value_prop_2_title": "Instruction Persistence",
+ "value_prop_2_desc": "Validates instructions across context",
+ "value_prop_3_icon": "đ",
+ "value_prop_3_title": "Audit Trail by Design",
+ "value_prop_3_desc": "MongoDB logs with service attribution"
},
- "deployment_guide": {
- "badge": "DOCUMENTATION",
- "title": "Deployment Architecture Guide",
- "description": "Comprehensive conceptual guide to deploying Tractatus-based systems. Understand architecture patterns, security best practices, and integration strategies for research and educational purposes.",
- "view_guide_btn": "View Deployment Guide",
- "support_note": "For production implementation support, contact research@agenticgovernance.digital"
+ "nav": {
+ "quick_links_label": "Page sections",
+ "how_it_works": "How It Works",
+ "architecture": "Architecture",
+ "hooks": "Hook Architecture",
+ "deployment": "Deployment",
+ "services": "Services",
+ "api": "API Reference",
+ "patterns": "Integration Patterns",
+ "roadmap": "Roadmap"
+ },
+ "how_it_works": {
+ "heading": "How It Works",
+ "problem_title": "Pattern Override Challenge",
+ "problem_desc": "AI systems operating across extended interactions may not maintain instruction consistency as context evolves. Instructions given early can be deprioritized or reinterpreted.",
+ "approach_title": "External Architecture Approach",
+ "approach_desc": "Tractatus services run external to the AI model, providing boundary validation, instruction classification, and audit logging through architectural separation.",
+ "diagram_title": "Request Flow with Governance",
+ "diagram_desc": "Example: AI decision flow with boundary enforcementâfrom user request through governance validation to human approval.",
+ "diagram_alt": "Request Flow Sequence: How AI decisions are governed",
+ "download_svg": "Download SVG"
},
"architecture": {
"heading": "System Architecture",
- "subheading": "Understanding how Tractatus integrates with Claude Code to provide robust AI governance",
+ "six_services_title": "Six Core Services",
+ "service_1": "BoundaryEnforcer (Tractatus 12.1-12.7)",
+ "service_2": "InstructionPersistenceClassifier",
+ "service_3": "CrossReferenceValidator",
+ "service_4": "ContextPressureMonitor",
+ "service_5": "MetacognitiveVerifier",
+ "service_6": "PluralisticDeliberationOrchestrator",
+ "main_flow_title": "Service Interaction Flow",
+ "main_flow_alt": "Tractatus Framework Architecture: Shows how 6 governance services interact in sequence",
+ "trigger_tree_title": "Service Trigger Conditions",
+ "trigger_tree_alt": "Service Trigger Decision Tree: When each framework service activates",
+ "system_arch_title": "System Architecture",
+ "system_arch_desc": "High-level overview showing how the 6 governance services integrate with your application and data layer.",
+ "system_arch_alt": "Tractatus System Architecture: Component interaction and data flow",
"download_svg": "Download SVG",
- "download_png": "Download PNG (High-Res)",
- "download_pdf": "Technical Documentation PDF",
- "layer_4_title": "API & Web Interface",
- "layer_3_title": "Tractatus Governance",
- "layer_2_title": "MongoDB Persistence",
- "layer_1_title": "Claude Code Runtime",
- "integration_points_title": "Key Integration Points",
- "integration_1_title": "Pre-Action Checks",
- "integration_1_desc": "All actions validated against governance rules before execution",
- "integration_2_title": "Instruction Persistence",
- "integration_2_desc": "User instructions classified and stored for cross-reference validation",
- "integration_3_title": "Comprehensive Audit Trail",
- "integration_3_desc": "Every governance action logged for compliance and analysis"
+ "download_svg_aria": "Download architecture main flow diagram as SVG",
+ "download_trigger_svg_aria": "Download service trigger decision tree as SVG",
+ "download_system_svg_aria": "Download system architecture diagram as SVG"
},
- "integration_approaches": {
- "heading": "Integration Approaches",
- "full_stack_title": "Full Stack",
- "full_stack_desc": "Complete framework integration for new AI-powered applications. All six services active with persistent instruction storage.",
- "full_stack_note": "Best for: New projects, greenfield AI applications",
- "middleware_title": "Middleware Layer",
- "middleware_desc": "Add Tractatus validation as middleware in existing AI pipelines. Non-invasive integration with gradual rollout support.",
- "middleware_note": "Best for: Existing production AI systems",
- "selective_title": "Selective Components",
- "selective_desc": "Use individual Tractatus services Ă la carte. Mix and match components based on your specific safety requirements.",
- "selective_note": "Best for: Specific safety requirements"
+ "hooks": {
+ "badge": "ARCHITECTURAL ENFORCEMENT",
+ "heading": "Hook Architecture: The Credibility Layer",
+ "subtitle": "Tractatus governance is not voluntary compliance. PreToolUse hooks enforce boundaries before AI actions execute, making circumvention architecturally impossible.",
+ "problem_title": "The Voluntary Compliance Problem",
+ "problem_desc_1": "Traditional AI safety relies on the AI system \"choosing\" to follow rules embedded in training data or system prompts. These approaches assume the AI will maintain alignment regardless of context pressure or capability.",
+ "problem_desc_2": "Tractatus addresses this through architectural enforcement: governance runs in a separate process that the AI cannot access, modify, or bypass.",
+ "flow_title": "PreToolUse Hook Execution Flow",
+ "flow_desc": "Before any file edit, write, or bash command executes, the hook intercepts the action and runs validation checks. Only if ALL checks pass (exit code 0) does the AI action proceed.",
+ "flow_alt": "Hook Architecture: PreToolUse intercept flow showing validation and hard blocks",
+ "examples_title": "Real Enforcement Examples",
+ "example_1_icon": "đ«",
+ "example_1_title": "GitHub URL Protection (inst_084)",
+ "example_1_desc": "AI attempted to change GitHub repository URL from tractatus-framework (public) to tractatus (private).",
+ "example_1_blocked": "BLOCKED:",
+ "example_1_reason": "Repository URL modification detected",
+ "example_1_detail": "Reason: Would expose private repo structure",
+ "example_1_hook": "Hook: validate-file-edit.js line 448-505",
+ "example_2_icon": "đ«",
+ "example_2_title": "CSP Violation (inst_008)",
+ "example_2_desc": "AI attempted to add inline style attribute to HTML element.",
+ "example_2_blocked": "BLOCKED:",
+ "example_2_reason": "Inline style detected",
+ "example_2_pattern": "Pattern:",
+ "example_2_hook": "Hook: validate-file-write.js line 68-149",
+ "example_3_icon": "đ«",
+ "example_3_title": "Governance File Protection (inst_027)",
+ "example_3_desc": "AI attempted direct edit of instruction-history.json.",
+ "example_3_blocked": "BLOCKED:",
+ "example_3_reason": "inst_027 hard block",
+ "example_3_use": "Use: scripts/add-instruction.js instead",
+ "example_3_hook": "Hook: framework-audit-hook.js line 204-209",
+ "example_4_icon": "â ",
+ "example_4_title": "Human Approval Required (BoundaryEnforcer)",
+ "example_4_desc": "AI action touches values-sensitive file (privacy policy).",
+ "example_4_status": "ASK HUMAN:",
+ "example_4_reason": "Values decision detected",
+ "example_4_requires": "Requires: Explicit human approval",
+ "example_4_hook": "Hook: validate-file-write.js line 239-262",
+ "tech_impl_title": "Technical Implementation",
+ "process_sep_icon": "đ",
+ "process_sep_title": "Process Separation",
+ "process_sep_desc": "Hooks execute in a separate Node.js process (child_process.spawn) with their own memory space. The AI agent cannot access, modify, or terminate the validation process.",
+ "exit_code_icon": "âïž",
+ "exit_code_title": "Exit Code Enforcement",
+ "exit_code_desc": "Hook validators return exit codes that Claude Code's architecture enforces:",
+ "exit_code_0": "0 = PASS â Tool executes",
+ "exit_code_2": "2 = HARD BLOCK â Tool execution halted, error shown to user",
+ "audit_icon": "đ",
+ "audit_title": "Audit Trail",
+ "audit_desc": "Every hook execution is logged to .claude/metrics/hooks-metrics.json with timestamp, file, result, and reason. Blocks are separately tracked for analysis.",
+ "why_matters_title": "Why Architectural Enforcement Matters",
+ "why_matters_desc": "This is the fundamental difference between Tractatus and traditional AI safety approaches:",
+ "voluntary_title": "â Voluntary Compliance",
+ "voluntary_1": "AI \"chooses\" to follow rules",
+ "voluntary_2": "Can drift under context pressure",
+ "voluntary_3": "Pattern recognition may override instructions",
+ "voluntary_4": "No verification before execution",
+ "architectural_title": "â Architectural Enforcement",
+ "architectural_1": "Hook intercepts before execution",
+ "architectural_2": "Separate process, cannot be accessed",
+ "architectural_3": "Exit codes enforced by runtime",
+ "architectural_4": "Audit trail of all decisions"
},
- "quick_start": {
- "heading": "Quick Start Guide",
- "disclaimer_title": "Note: Reference Implementation",
- "disclaimer_text": "The code examples below show conceptual API design. The npm package @tractatus/framework is not yet published. To implement these patterns, adapt the governance services from this project's source code.",
- "step_1_title": "Installation",
- "step_2_title": "Initialize Services",
- "step_3_title": "Classify Instructions",
- "step_4_title": "Validate Actions",
- "step_5_title": "Enforce Boundaries"
+ "deployment": {
+ "heading": "Deployment Architecture",
+ "tech_stack_title": "Technology Stack",
+ "runtime": "Runtime:",
+ "runtime_value": "Node.js v20+",
+ "database": "Database:",
+ "database_value": "MongoDB 7.0+",
+ "framework": "Framework:",
+ "framework_value": "Express.js",
+ "process": "Process:",
+ "process_value": "Systemd (recommended)",
+ "guide_title": "Production Deployment",
+ "guide_desc": "Comprehensive deployment guide covering local development, production server configuration, Docker containerization, cloud deployment patterns (AWS, GCP, Kubernetes), database management, monitoring, and security best practices.",
+ "covered_title": "đŠ Covered in Guide:",
+ "covered_1": "Local development setup",
+ "covered_2": "Production server configuration",
+ "covered_3": "Docker and Docker Compose",
+ "covered_4": "Cloud deployment (AWS/GCP)",
+ "also_title": "đ§ Also Includes:",
+ "also_1": "Kubernetes manifests",
+ "also_2": "Database backup and migration",
+ "also_3": "SSL/TLS configuration",
+ "also_4": "Monitoring and logging",
+ "download_guide": "Download Deployment Guide (PDF)"
},
- "integration_patterns": {
+ "services": {
+ "heading": "Core Services",
+ "service_1_name": "BoundaryEnforcer",
+ "service_1_desc": "Implements Tractatus 12.1-12.7: AI cannot make values decisions without human approval.",
+ "service_1_boundaries": "Boundaries:",
+ "service_1_boundary_1": "VALUES (12.1) - Ethics, privacy, principles",
+ "service_1_boundary_2": "INNOVATION (12.2) - Architectural decisions",
+ "service_1_boundary_3": "WISDOM (12.3) - Strategic judgment",
+ "service_1_boundary_4": "PURPOSE (12.4) - Goal definition",
+ "service_2_name": "InstructionPersistenceClassifier",
+ "service_2_desc": "Classifies instructions by quadrant (STRATEGIC/OPERATIONAL/TACTICAL/SYSTEM) and persistence level (HIGH/MEDIUM/LOW).",
+ "service_2_classification": "Classification:",
+ "service_2_class_1": "Quadrant (STRATEGIC/OPERATIONAL/TACTICAL/SYSTEM)",
+ "service_2_class_2": "Persistence (HIGH/MEDIUM/LOW)",
+ "service_2_class_3": "Temporal scope (PROJECT/SESSION/TASK)",
+ "service_2_class_4": "Explicitness score (0.0-1.0)",
+ "service_3_name": "CrossReferenceValidator",
+ "service_3_desc": "Validates AI actions against stored instructions to prevent pattern recognition overrides.",
+ "service_3_validation": "Validation:",
+ "service_3_val_1": "Checks action against HIGH persistence instructions",
+ "service_3_val_2": "Detects conflicts (pattern vs explicit instruction)",
+ "service_3_val_3": "Provides correct parameters when rejected",
+ "service_4_name": "ContextPressureMonitor",
+ "service_4_desc": "Monitors token usage and context pressure, triggering safety protocols at thresholds.",
+ "service_4_levels": "Pressure Levels:",
+ "service_4_level_1": "NORMAL (0-50%) - Full operation",
+ "service_4_level_2": "ELEVATED (50-75%) - Increase verification",
+ "service_4_level_3": "HIGH (75-90%) - Reduce complexity",
+ "service_4_level_4": "CRITICAL (90%+) - Suggest handoff",
+ "service_5_name": "MetacognitiveVerifier",
+ "service_5_desc": "Verifies action reasoning and confidence, requiring confirmation for low-confidence actions.",
+ "service_5_verification": "Verification:",
+ "service_5_ver_1": "Confidence scoring (0.0-1.0)",
+ "service_5_ver_2": "Selective mode (HIGH persistence only)",
+ "service_5_ver_3": "Requires confirmation if confidence < 0.7",
+ "service_6_name": "PluralisticDeliberationOrchestrator",
+ "service_6_desc": "Manages multi-stakeholder deliberation ensuring value pluralism in decisions.",
+ "service_6_features": "Features:",
+ "service_6_feature_1": "Stakeholder perspective tracking",
+ "service_6_feature_2": "Value conflict detection",
+ "service_6_feature_3": "Deliberation session management",
+ "service_6_feature_4": "Precedent storage",
+ "source_code_label": "đ Source Code",
+ "source_code_desc": "Code patterns and examples are available in the GitHub repository."
+ },
+ "api": {
+ "heading": "API Reference",
+ "boundary_method": "BoundaryEnforcer.checkBoundary()",
+ "boundary_keywords": "Keywords detected:",
+ "boundary_keywords_list": "value, principle, ethic, moral, should, ought, right, wrong, privacy, policy, trade-off, etc.",
+ "classifier_method": "InstructionPersistenceClassifier.classify()",
+ "classifier_quadrants": "Quadrants:",
+ "classifier_quadrants_list": "STRATEGIC, OPERATIONAL, TACTICAL, SYSTEM, STORAGE",
+ "classifier_persistence": "Persistence:",
+ "classifier_persistence_desc": "HIGH (override all), MEDIUM (session-scoped), LOW (can be superseded)",
+ "validator_method": "CrossReferenceValidator.validate()",
+ "monitor_method": "ContextPressureMonitor.analyzePressure()"
+ },
+ "examples": {
+ "heading": "Integration Examples",
+ "express_title": "Express Middleware Integration",
+ "validation_title": "Instruction Validation",
+ "mongodb_title": "MongoDB Data Models",
+ "governance_rule": "GovernanceRule",
+ "audit_log": "AuditLog"
+ },
+ "patterns": {
"heading": "Integration Patterns",
- "express_middleware": "Express Middleware",
- "content_moderation": "Content Moderation",
- "pressure_monitoring": "Pressure Monitoring",
- "custom_classification": "Custom Classification"
+ "intro": "Common architectural patterns for integrating Tractatus into existing systems.",
+ "middleware_title": "Middleware Integration",
+ "middleware_desc": "Insert governance checks as middleware in your request pipeline. Suitable for API-based AI systems.",
+ "middleware_usecase": "Use Case:",
+ "middleware_usecase_value": "REST APIs, Express.js applications",
+ "event_title": "Event-Driven Governance",
+ "event_desc": "Trigger governance checks via events. Suitable for async workflows and microservices.",
+ "event_usecase": "Use Case:",
+ "event_usecase_value": "Message queues, event buses, async processing",
+ "hook_title": "Pre/Post-Action Hooks",
+ "hook_desc": "Validate actions before and after execution. Current production pattern for Claude Code.",
+ "hook_usecase": "Use Case:",
+ "hook_usecase_value": "LLM tool use, autonomous agents",
+ "sidecar_title": "Sidecar Governance Service",
+ "sidecar_desc": "Deploy governance as a separate service. Suitable for multi-LLM or polyglot environments.",
+ "sidecar_usecase": "Use Case:",
+ "sidecar_usecase_value": "Kubernetes, containerized deployments"
+ },
+ "roadmap": {
+ "heading": "Development Roadmap & Collaboration",
+ "intro": "Tractatus is an active research framework. We welcome collaboration on priority development areas.",
+ "priority_title": "đ Priority Areas for Development",
+ "priority_desc": "These initiatives represent high-impact opportunities for framework enhancement. Technical contributors, researchers, and organizations are encouraged to engage.",
+ "multi_llm_icon": "đ€",
+ "multi_llm_title": "Multi-LLM Support",
+ "multi_llm_status": "Status: Research Phase",
+ "multi_llm_desc": "Extend governance to GPT-4, Gemini, Llama, and local models. Requires adapting hook architecture to different LLM interfaces.",
+ "multi_llm_challenges": "Technical Challenges:",
+ "multi_llm_challenges_desc": "Provider-specific tool/function calling, rate limiting, context window differences",
+ "bindings_icon": "đ",
+ "bindings_title": "Language Bindings",
+ "bindings_status": "Status: Community Interest",
+ "bindings_desc": "Python, Go, and Rust implementations to serve broader developer communities. Core logic is portable; MongoDB integration is universal.",
+ "bindings_value": "Value:",
+ "bindings_value_desc": "Enable polyglot AI stacks, performance-critical applications (Rust), data science workflows (Python)",
+ "cloud_icon": "âïž",
+ "cloud_title": "Cloud-Native Deployment",
+ "cloud_status": "Status: Reference Architectures Needed",
+ "cloud_desc": "Terraform/Helm charts for AWS, Azure, GCP. Include managed MongoDB (Atlas), auto-scaling, and monitoring integration.",
+ "cloud_deliverables": "Deliverables:",
+ "cloud_deliverables_desc": "Reference IaC templates, cost optimization guides, security hardening checklist",
+ "integrations_icon": "đ",
+ "integrations_title": "AI Framework Integration",
+ "integrations_status": "Status: Conceptual",
+ "integrations_desc": "Adapters for LangChain, Semantic Kernel, AutoGPT, and CrewAI. Enable governance for existing agent frameworks.",
+ "integrations_approach": "Approach:",
+ "integrations_approach_desc": "Plugin/middleware architecture that wraps agent actions with governance checks",
+ "performance_icon": "âĄ",
+ "performance_title": "Enterprise-Scale Performance",
+ "performance_status": "Status: Validation Needed",
+ "performance_desc": "Optimize for 1000+ concurrent AI agents. Requires caching strategies, rule compilation, and distributed audit logging.",
+ "performance_target": "Metrics Target:",
+ "performance_target_desc": "< 5ms governance overhead per decision, 99.9% uptime, horizontal scalability",
+ "extended_icon": "đĄïž",
+ "extended_title": "Extended Governance Services",
+ "extended_status": "Status: Research",
+ "extended_desc": "Cost monitoring, rate limiting, PII detection, adversarial prompt defense. Domain-specific services for regulated industries.",
+ "extended_examples": "Examples:",
+ "extended_examples_desc": "FinancialComplianceService, HealthcarePrivacyService, CostBudgetEnforcer",
+ "involved_title": "Get Involved",
+ "involved_desc": "Tractatus is Apache 2.0 licensed research. We welcome contributions, pilot implementations, and collaborative research partnerships.",
+ "contributors_title": "đšâđ» Technical Contributors",
+ "contributors_desc": "Implement features, fix bugs, improve documentation",
+ "contributors_link": "â Contributing Guide",
+ "research_title": "đŹ Research Partners",
+ "research_desc": "Validation studies, academic collaboration, case studies",
+ "research_email": "â research@agenticgovernance.digital",
+ "pilots_title": "đą Organization Pilots",
+ "pilots_desc": "Production deployments, enterprise requirements, feedback loops",
+ "pilots_link": "â Submit Case Study",
+ "why_collab": "Why Collaborate?",
+ "why_collab_desc": "Tractatus addresses real gaps in AI safety. Early adopters shape the framework's evolution and gain expertise in structural AI governanceâa differentiating capability as regulatory requirements mature."
},
"resources": {
- "heading": "Implementation Resources",
- "technical_docs_title": "Technical Documentation",
- "examples_title": "Examples",
+ "heading": "Resources",
+ "docs_title": "Documentation",
+ "docs_github": "â GitHub Repository",
+ "docs_full": "â Full Documentation",
+ "docs_demos": "â Live Demos",
+ "reference_title": "Reference Implementation",
+ "reference_desc": "This website (agenticgovernance.digital) runs on Tractatus governance.",
+ "reference_services": "Services:",
+ "reference_services_value": "22 governance components",
+ "reference_models": "Data Models:",
+ "reference_models_value": "29 MongoDB schemas",
+ "reference_tests": "Test Coverage:",
+ "reference_tests_value": "35 test suites",
+ "reference_repo": "â Collaboration Repository",
"support_title": "Support",
- "support_desc": "Get help with implementation, integration, and troubleshooting."
- },
- "cta": {
- "title": "Exploring Implementation?",
- "description": "Explore architectural patterns for AI safety demonstrated in single-project validation.",
- "view_docs_btn": "View Full Documentation",
- "research_btn": "Research Background â"
+ "support_desc": "Questions about implementation or integration?",
+ "support_issues": "â GitHub Issues",
+ "support_discussions": "â GitHub Discussions",
+ "support_email": "â research@agenticgovernance.digital",
+ "support_faq": "â Frequently Asked Questions"
}
}
diff --git a/public/locales/fr/implementer.json b/public/locales/fr/implementer.json
index 6c155203..0d68db98 100644
--- a/public/locales/fr/implementer.json
+++ b/public/locales/fr/implementer.json
@@ -38,7 +38,24 @@
"integration_2_title": "Persistance des Instructions",
"integration_2_desc": "Instructions utilisateur classifiées et stockées pour la validation par références croisées",
"integration_3_title": "Piste d'Audit ComplĂšte",
- "integration_3_desc": "Chaque action de gouvernance enregistrée pour la conformité et l'analyse"
+ "integration_3_desc": "Chaque action de gouvernance enregistrée pour la conformité et l'analyse",
+ "six_services_title": "Six services de base",
+ "service_1": "Renforcer les frontiĂšres (Tractatus 12.1-12.7)",
+ "service_2": "InstructionPersistenceClassifier",
+ "service_3": "Valideur de référence croisée",
+ "service_4": "ContextPressureMonitor",
+ "service_5": "Vérificateur métacognitif",
+ "service_6": "Délibération pluralisteOrchestrateur",
+ "main_flow_title": "Flux d'interactions de services",
+ "main_flow_alt": "Architecture du cadre Tractatus : Montre comment les 6 services de gouvernance interagissent en séquence",
+ "trigger_tree_title": "Conditions de déclenchement du service",
+ "trigger_tree_alt": "Arbre de décision des déclencheurs de service : Lorsque chaque service-cadre est activé",
+ "system_arch_title": "Architecture du systĂšme",
+ "system_arch_desc": "Aperçu de haut niveau montrant comment les 6 services de gouvernance s'intÚgrent à votre application et à votre couche de données.",
+ "system_arch_alt": "Tractatus Architecture du systÚme : Interaction des composants et flux de données",
+ "download_svg_aria": "Télécharger le schéma principal de l'architecture au format SVG",
+ "download_trigger_svg_aria": "Télécharger l'arbre de décision du déclencheur de service sous forme de SVG",
+ "download_system_svg_aria": "Télécharger le diagramme d'architecture du systÚme au format SVG"
},
"integration_approaches": {
"heading": "Approches d'Intégration",
@@ -74,12 +91,299 @@
"technical_docs_title": "Documentation Technique",
"examples_title": "Exemples",
"support_title": "Support",
- "support_desc": "Obtenez de l'aide pour l'implémentation, l'intégration et le dépannage."
+ "support_desc": "Obtenez de l'aide pour l'implémentation, l'intégration et le dépannage.",
+ "docs_title": "Documentation",
+ "docs_github": "â DĂ©pĂŽt GitHub",
+ "docs_full": "â Documentation complĂšte",
+ "docs_demos": "â DĂ©monstrations en direct",
+ "reference_title": "Mise en Ćuvre de rĂ©fĂ©rence",
+ "reference_desc": "Ce site web (agenticgovernance.digital) fonctionne sur Tractatus governance.",
+ "reference_services": "Services :",
+ "reference_services_value": "22 composantes de la gouvernance",
+ "reference_models": "ModÚles de données :",
+ "reference_models_value": "29 Schémas MongoDB",
+ "reference_tests": "Couverture des tests :",
+ "reference_tests_value": "35 suites de tests",
+ "reference_repo": "â RĂ©fĂ©rentiel de collaboration",
+ "support_issues": "â GitHub Issues",
+ "support_discussions": "â Discussions sur GitHub",
+ "support_email": "â research@agenticgovernance.digital",
+ "support_faq": "â Questions frĂ©quemment posĂ©es"
},
"cta": {
"title": "Explorer l'Implémentation ?",
"description": "Explorez les modÚles architecturaux pour la sécurité de l'IA démontrés dans une validation de projet unique.",
"view_docs_btn": "Voir la Documentation ComplĂšte",
"research_btn": "Contexte de Recherche â"
+ },
+ "ui": {
+ "breadcrumb_home": "Accueil",
+ "breadcrumb_implementer": "Guide de mise en Ćuvre",
+ "skip_to_content": "Skip to main content"
+ },
+ "hero": {
+ "title": "Services de gouvernance externe pour les systĂšmes d'IA",
+ "subtitle": "Six services architecturaux traitant de l'annulation des modÚles et de la traçabilité des décisions dans les systÚmes agentiques. Cadre de développement pour la persistance des instructions, l'application des limites et l'enregistrement des audits.",
+ "value_prop_1_icon": "đïž",
+ "value_prop_1_title": "SĂ©paration architecturale",
+ "value_prop_1_desc": "La gouvernance est externe au modĂšle d'IA",
+ "value_prop_2_icon": "đŸ",
+ "value_prop_2_title": "Persistance de l'enseignement",
+ "value_prop_2_desc": "Valide les instructions en fonction du contexte",
+ "value_prop_3_icon": "đ",
+ "value_prop_3_title": "Piste d'audit dĂšs la conception",
+ "value_prop_3_desc": "Journaux MongoDB avec attribution de service"
+ },
+ "nav": {
+ "quick_links_label": "Rubriques de la page",
+ "how_it_works": "Comment ça marche",
+ "architecture": "Architecture",
+ "hooks": "Hook Architecture",
+ "deployment": "DĂ©ploiement",
+ "services": "Services",
+ "api": "Référence API",
+ "patterns": "ModÚles d'intégration",
+ "roadmap": "Feuille de route"
+ },
+ "how_it_works": {
+ "heading": "Comment ça marche",
+ "problem_title": "DĂ©fi de l'annulation du motif",
+ "problem_desc": "Les systĂšmes d'IA fonctionnant dans le cadre d'interactions prolongĂ©es peuvent ne pas maintenir la cohĂ©rence des instructions au fur et Ă mesure que le contexte Ă©volue. Les instructions donnĂ©es tĂŽt peuvent ĂȘtre dĂ©pourvues de prioritĂ© ou rĂ©interprĂ©tĂ©es.",
+ "approach_title": "Approche de l'architecture externe",
+ "approach_desc": "Les services Tractatus fonctionnent en dehors du modÚle d'IA et assurent la validation des limites, la classification des instructions et l'enregistrement des audits par le biais d'une séparation architecturale.",
+ "diagram_title": "Flux de demandes avec gouvernance",
+ "diagram_desc": "Exemple : Flux décisionnel d'IA avec application des limites - de la demande de l'utilisateur à l'approbation humaine, en passant par la validation de la gouvernance.",
+ "diagram_alt": "Séquence de flux de demandes : Comment les décisions en matiÚre d'IA sont régies",
+ "download_svg": "Télécharger le SVG"
+ },
+ "hooks": {
+ "badge": "APPLICATION DES RĂGLES ARCHITECTURALES",
+ "heading": "L'architecture du crochet : La couche de crédibilité",
+ "subtitle": "La gouvernance du Tractatus n'est pas une conformité volontaire. Les crochets PreToolUse imposent des limites avant que les actions de l'IA ne soient exécutées, ce qui rend tout contournement impossible sur le plan architectural.",
+ "problem_title": "Le problÚme de la conformité volontaire",
+ "problem_desc_1": "La sécurité traditionnelle de l'IA repose sur le fait que le systÚme d'IA \"choisit\" de suivre les rÚgles intégrées dans les données de formation ou les invites du systÚme. Ces approches supposent que l'IA maintiendra l'alignement indépendamment de la pression du contexte ou de la capacité.",
+ "problem_desc_2": "Le Tractatus aborde cette question par le biais de l'application architecturale : la gouvernance s'exécute dans un processus distinct auquel l'IA ne peut accéder, qu'elle ne peut modifier ou contourner.",
+ "flow_title": "Flux d'exécution du crochet PreToolUse",
+ "flow_desc": "Avant toute modification de fichier, écriture ou commande bash, le crochet intercepte l'action et effectue des contrÎles de validation. Ce n'est que si TOUS les contrÎles sont réussis (code de sortie 0) que l'action AI est exécutée.",
+ "flow_alt": "Architecture du crochet : Flux d'interception de PreToolUse montrant la validation et les blocs durs",
+ "examples_title": "Exemples réels d'application de la loi",
+ "example_1_icon": "đ«",
+ "example_1_title": "Protection des URL de GitHub (inst_084)",
+ "example_1_desc": "AI a tenté de changer l'URL du dépÎt GitHub de tractatus-framework (public) à tractatus (privé).",
+ "example_1_blocked": "BLOCKED :",
+ "example_1_reason": "Modification de l'URL du référentiel détectée",
+ "example_1_detail": "Raison : Exposerait la structure privée du repo",
+ "example_1_hook": "Accroche : validate-file-edit.js ligne 448-505",
+ "example_2_icon": "đ«",
+ "example_2_title": "Violation de la CSP (inst_008)",
+ "example_2_desc": "AI a tenté d'ajouter un attribut de style en ligne à un élément HTML.",
+ "example_2_blocked": "BLOCKED :",
+ "example_2_reason": "Style en ligne détecté",
+ "example_2_pattern": "ModĂšle :",
+ "example_2_hook": "Accroche : validate-file-write.js ligne 68-149",
+ "example_3_icon": "đ«",
+ "example_3_title": "Protection des fichiers de gouvernance (inst_027)",
+ "example_3_desc": "AI a tenté d'éditer directement le fichier instruction-history.json.",
+ "example_3_blocked": "BLOCKED :",
+ "example_3_reason": "inst_027 bloc dur",
+ "example_3_use": "Utilisez plutĂŽt : scripts/add-instruction.js",
+ "example_3_hook": "Hook : framework-audit-hook.js ligne 204-209",
+ "example_4_icon": "â ",
+ "example_4_title": "Approbation humaine requise (BoundaryEnforcer)",
+ "example_4_desc": "L'action de l'IA touche un fichier sensible aux valeurs (politique de confidentialité).",
+ "example_4_status": "DEMANDEZ Ă HUMAN :",
+ "example_4_reason": "Décision sur les valeurs détectées",
+ "example_4_requires": "NĂ©cessite : Approbation explicite de l'homme",
+ "example_4_hook": "Accroche : validate-file-write.js ligne 239-262",
+ "tech_impl_title": "Mise en Ćuvre technique",
+ "process_sep_icon": "đ",
+ "process_sep_title": "SĂ©paration des processus",
+ "process_sep_desc": "Les crochets s'exécutent dans un processus Node.js distinct (child_process.spawn) disposant de son propre espace mémoire. L'agent d'intelligence artificielle ne peut pas accéder au processus de validation, le modifier ou y mettre fin.",
+ "exit_code_icon": "âïž",
+ "exit_code_title": "Application du code de sortie",
+ "exit_code_desc": "Les validateurs de crochets renvoient des codes de sortie que l'architecture de Claude Code met en Ćuvre :",
+ "exit_code_0": "0 = PASS â L'outil s'exĂ©cute",
+ "exit_code_2": "2 = BLOCAGE DUR â ArrĂȘt de l'exĂ©cution de l'outil, affichage de l'erreur Ă l'utilisateur",
+ "audit_icon": "đ",
+ "audit_title": "Piste d'audit",
+ "audit_desc": "Chaque exécution de crochet est enregistrée dans le fichier .claude/metrics/hooks-metrics.json avec l'horodatage, le fichier, le résultat et la raison. Les blocs sont suivis séparément à des fins d'analyse.",
+ "why_matters_title": "L'importance de l'application des rĂšgles architecturales",
+ "why_matters_desc": "C'est la différence fondamentale entre le Tractatus et les approches traditionnelles de la sécurité de l'IA :",
+ "voluntary_title": "â ConformitĂ© volontaire",
+ "voluntary_1": "L'IA \"choisit\" de suivre les rĂšgles",
+ "voluntary_2": "Peut dériver sous la pression du contexte",
+ "voluntary_3": "La reconnaissance des formes peut annuler les instructions",
+ "voluntary_4": "Pas de vérification avant l'exécution",
+ "architectural_title": "â Application des rĂšgles architecturales",
+ "architectural_1": "Le crochet intercepte avant l'exécution",
+ "architectural_2": "Processus séparé, non accessible",
+ "architectural_3": "Codes de sortie appliqués par le systÚme d'exécution",
+ "architectural_4": "Piste d'audit de toutes les décisions"
+ },
+ "deployment": {
+ "heading": "Architecture de déploiement",
+ "tech_stack_title": "Pile technologique",
+ "runtime": "Durée d'exécution :",
+ "runtime_value": "Node.js v20+",
+ "database": "Base de données :",
+ "database_value": "MongoDB 7.0+",
+ "framework": "Le cadre :",
+ "framework_value": "Express.js",
+ "process": "Processus :",
+ "process_value": "Systemd (recommandé)",
+ "guide_title": "DĂ©ploiement de la production",
+ "guide_desc": "Guide de déploiement complet couvrant le développement local, la configuration des serveurs de production, la conteneurisation Docker, les modÚles de déploiement dans le cloud (AWS, GCP, Kubernetes), la gestion des bases de données, la surveillance et les meilleures pratiques en matiÚre de sécurité.",
+ "covered_title": "đŠ Couvert par le guide :",
+ "covered_1": "Mise en place du développement local",
+ "covered_2": "Configuration du serveur de production",
+ "covered_3": "Docker et Docker Compose",
+ "covered_4": "DĂ©ploiement dans le nuage (AWS/GCP)",
+ "also_title": "đ§ Comprend Ă©galement :",
+ "also_1": "Manifestes Kubernetes",
+ "also_2": "Sauvegarde et migration des bases de données",
+ "also_3": "Configuration SSL/TLS",
+ "also_4": "Surveillance et journalisation",
+ "download_guide": "Télécharger le guide de déploiement (PDF)"
+ },
+ "services": {
+ "heading": "Services de base",
+ "service_1_name": "Renforçateur de frontiÚres",
+ "service_1_desc": "Met en Ćuvre les Tractatus 12.1-12.7 : L'IA ne peut pas prendre de dĂ©cisions relatives aux valeurs sans l'approbation de l'homme.",
+ "service_1_boundaries": "Limites :",
+ "service_1_boundary_1": "VALEURS (12.1) - Ăthique, vie privĂ©e, principes",
+ "service_1_boundary_2": "INNOVATION (12.2) - DĂ©cisions architecturales",
+ "service_1_boundary_3": "SAGESSE (12.3) - Jugement stratégique",
+ "service_1_boundary_4": "OBJECTIF (12.4) - DĂ©finition de l'objectif",
+ "service_2_name": "InstructionPersistenceClassifier",
+ "service_2_desc": "Classe les instructions par quadrant (STRATEGIQUE/OPERATIONNEL/TACTIQUE/SYSTEME) et par niveau de persistance (HAUT/MEDIUM/BAS).",
+ "service_2_classification": "Classification :",
+ "service_2_class_1": "Quadrant (STRATĂGIQUE/OPĂRATIONNEL/TACTIQUE/SYSTEM)",
+ "service_2_class_2": "Persistance (élevée/moyenne/faible)",
+ "service_2_class_3": "Champ d'application temporel (PROJET/SESSION/TĂCHE)",
+ "service_2_class_4": "Score d'explicitation (0.0-1.0)",
+ "service_3_name": "Valideur de référence croisée",
+ "service_3_desc": "Valide les actions de l'IA par rapport aux instructions stockées afin d'éviter les dérives de la reconnaissance des formes.",
+ "service_3_validation": "Validation :",
+ "service_3_val_1": "VĂ©rifie l'action par rapport aux instructions de persistance HIGH",
+ "service_3_val_2": "DĂ©tecte les conflits (modĂšle ou instruction explicite)",
+ "service_3_val_3": "Fournit des paramĂštres corrects en cas de rejet",
+ "service_4_name": "ContextPressureMonitor",
+ "service_4_desc": "Surveille l'utilisation des jetons et la pression contextuelle, en déclenchant des protocoles de sécurité en fonction des seuils.",
+ "service_4_levels": "Niveaux de pression :",
+ "service_4_level_1": "NORMAL (0-50%) - Fonctionnement à plein régime",
+ "service_4_level_2": "ĂLĂVĂ (50-75 %) - Augmentation de la vĂ©rification",
+ "service_4_level_3": "ĂLEVĂ (75-90 %) - RĂ©duire la complexitĂ©",
+ "service_4_level_4": "CRITIQUE (90%+) - Suggérer un transfert",
+ "service_5_name": "Vérificateur métacognitif",
+ "service_5_desc": "Vérifie le raisonnement et le degré de confiance de l'action, en exigeant une confirmation pour les actions à faible degré de confiance.",
+ "service_5_verification": "VĂ©rification :",
+ "service_5_ver_1": "Score de confiance (0.0-1.0)",
+ "service_5_ver_2": "Mode sélectif (persistance HAUTE uniquement)",
+ "service_5_ver_3": "Nécessite une confirmation si le niveau de confiance est inférieur à 0,7",
+ "service_6_name": "Délibération pluralisteOrchestrateur",
+ "service_6_desc": "GÚre les délibérations multipartites en veillant au pluralisme des valeurs dans les décisions.",
+ "service_6_features": "Caractéristiques :",
+ "service_6_feature_1": "Suivi du point de vue des parties prenantes",
+ "service_6_feature_2": "DĂ©tection des conflits de valeurs",
+ "service_6_feature_3": "Gestion de la session de délibération",
+ "service_6_feature_4": "Stockage des précédents",
+ "source_code_label": "đ Code source",
+ "source_code_desc": "Des modÚles de code et des exemples sont disponibles dans le dépÎt GitHub."
+ },
+ "api": {
+ "heading": "Référence API",
+ "boundary_method": "BoundaryEnforcer.checkBoundary()",
+ "boundary_keywords": "Mots clés détectés :",
+ "boundary_keywords_list": "valeur, principe, éthique, morale, devrait, droit, tort, vie privée, politique, compromis, etc.",
+ "classifier_method": "InstructionPersistenceClassifier.classify()",
+ "classifier_quadrants": "Quadrants :",
+ "classifier_quadrants_list": "STRATĂGIQUE, OPĂRATIONNEL, TACTIQUE, SYSTĂME, STOCKAGE",
+ "classifier_persistence": "Persistance :",
+ "classifier_persistence_desc": "ĂLEVĂ (prioritĂ© absolue), MOYEN (limitĂ© Ă la session), FAIBLE (peut ĂȘtre remplacĂ©)",
+ "validator_method": "CrossReferenceValidator.validate()",
+ "monitor_method": "ContextPressureMonitor.analyzePressure()"
+ },
+ "examples": {
+ "heading": "Exemples d'intégration",
+ "express_title": "Intégration de l'intergiciel Express",
+ "validation_title": "Validation de l'instruction",
+ "mongodb_title": "ModÚles de données MongoDB",
+ "governance_rule": "RĂšgle de gouvernance",
+ "audit_log": "AuditLog"
+ },
+ "patterns": {
+ "heading": "ModÚles d'intégration",
+ "intro": "ModÚles architecturaux communs pour l'intégration de Tractatus dans les systÚmes existants.",
+ "middleware_title": "Intégration de l'intergiciel",
+ "middleware_desc": "InsĂ©rez des contrĂŽles de gouvernance en tant qu'intergiciel dans votre pipeline de requĂȘtes. Convient aux systĂšmes d'IA basĂ©s sur des API.",
+ "middleware_usecase": "Cas d'utilisation :",
+ "middleware_usecase_value": "API REST, applications Express.js",
+ "event_title": "Gouvernance événementielle",
+ "event_desc": "Déclenchez des contrÎles de gouvernance via des événements. Convient aux flux de travail asynchrones et aux microservices.",
+ "event_usecase": "Cas d'utilisation :",
+ "event_usecase_value": "Files d'attente de messages, bus d'événements, traitement asynchrone",
+ "hook_title": "Crochets de pré/post-action",
+ "hook_desc": "Valider les actions avant et aprÚs l'exécution. ModÚle de production actuel pour Claude Code.",
+ "hook_usecase": "Cas d'utilisation :",
+ "hook_usecase_value": "Utilisation d'outils LLM, agents autonomes",
+ "sidecar_title": "Service de gouvernance Sidecar",
+ "sidecar_desc": "DĂ©ployer la gouvernance en tant que service distinct. Convient aux environnements multi-LLM ou polyglottes.",
+ "sidecar_usecase": "Cas d'utilisation :",
+ "sidecar_usecase_value": "Kubernetes, déploiements conteneurisés"
+ },
+ "roadmap": {
+ "heading": "Feuille de route et collaboration en matiÚre de développement",
+ "intro": "Tractatus est un cadre de recherche actif. Nous sommes ouverts à toute collaboration dans les domaines de développement prioritaires.",
+ "priority_title": "đ Domaines prioritaires de dĂ©veloppement",
+ "priority_desc": "Ces initiatives représentent des opportunités à fort impact pour l'amélioration du cadre. Les contributeurs techniques, les chercheurs et les organisations sont encouragés à s'engager.",
+ "multi_llm_icon": "đ€",
+ "multi_llm_title": "Support multi-LLM",
+ "multi_llm_status": "Statut : Phase de recherche",
+ "multi_llm_desc": "Ătendre la gouvernance aux modĂšles GPT-4, Gemini, Llama et locaux. NĂ©cessitĂ© d'adapter l'architecture des crochets aux diffĂ©rentes interfaces LLM.",
+ "multi_llm_challenges": "DĂ©fis techniques :",
+ "multi_llm_challenges_desc": "Appel d'outils/fonctions spĂ©cifiques au prestataire, limitation des tarifs, diffĂ©rences de fenĂȘtres contextuelles",
+ "bindings_icon": "đ",
+ "bindings_title": "Liaisons linguistiques",
+ "bindings_status": "Statut : IntĂ©rĂȘt communautaire",
+ "bindings_desc": "Implémentations Python, Go et Rust pour servir des communautés de développeurs plus larges. La logique de base est portable ; l'intégration de MongoDB est universelle.",
+ "bindings_value": "Valeur :",
+ "bindings_value_desc": "Permettre des piles d'IA polyglottes, des applications critiques en termes de performances (Rust), des flux de travail de science des données (Python)",
+ "cloud_icon": "âïž",
+ "cloud_title": "DĂ©ploiement en nuage",
+ "cloud_status": "Statut : Architectures de référence nécessaires",
+ "cloud_desc": "Cartes Terraform/Helm pour AWS, Azure, GCP. Inclut la gestion de MongoDB (Atlas), la mise à l'échelle automatique et l'intégration de la surveillance.",
+ "cloud_deliverables": "Produits livrables :",
+ "cloud_deliverables_desc": "ModÚles de référence pour l'IaC, guides d'optimisation des coûts, liste de contrÎle pour le renforcement de la sécurité",
+ "integrations_icon": "đ",
+ "integrations_title": "Intégration du cadre de l'IA",
+ "integrations_status": "Statut : Conceptuel",
+ "integrations_desc": "Adaptateurs pour LangChain, Semantic Kernel, AutoGPT et CrewAI. Permettre la gouvernance pour les cadres d'agents existants.",
+ "integrations_approach": "Approche :",
+ "integrations_approach_desc": "Architecture plugin/middleware qui intĂšgre les actions de l'agent avec des contrĂŽles de gouvernance",
+ "performance_icon": "âĄ",
+ "performance_title": "Performance Ă l'Ă©chelle de l'entreprise",
+ "performance_status": "Statut : Validation nécessaire",
+ "performance_desc": "Optimisation pour plus de 1000 agents IA simultanés. Nécessite des stratégies de mise en cache, la compilation de rÚgles et l'enregistrement d'audits distribués.",
+ "performance_target": "Cible des métriques :",
+ "performance_target_desc": "< 5ms de frais de gouvernance par décision, temps de disponibilité de 99,9 %, évolutivité horizontale",
+ "extended_icon": "đĄïž",
+ "extended_title": "Services de gouvernance Ă©tendus",
+ "extended_status": "Statut : Recherche",
+ "extended_desc": "ContrÎle des coûts, limitation des tarifs, détection des IPI, défense rapide contre les adversaires. Services spécifiques à un domaine pour les industries réglementées.",
+ "extended_examples": "Exemples :",
+ "extended_examples_desc": "FinancialComplianceService, HealthcarePrivacyService, CostBudgetEnforcer",
+ "involved_title": "S'impliquer",
+ "involved_desc": "Tractatus est une recherche sous licence Apache 2.0. Les contributions, les mises en Ćuvre pilotes et les partenariats de recherche collaborative sont les bienvenus.",
+ "contributors_title": "đšâđ» Contributeurs techniques",
+ "contributors_desc": "Mise en Ćuvre des fonctionnalitĂ©s, correction des bogues, amĂ©lioration de la documentation",
+ "contributors_link": "â Guide des contributeurs",
+ "research_title": "đŹ Partenaires de recherche",
+ "research_desc": "Ătudes de validation, collaboration universitaire, Ă©tudes de cas",
+ "research_email": "â research@agenticgovernance.digital",
+ "pilots_title": "đą Organisation Pilotes",
+ "pilots_desc": "Déploiements en production, exigences de l'entreprise, boucles de rétroaction",
+ "pilots_link": "â Soumettre une Ă©tude de cas",
+ "why_collab": "Pourquoi collaborer ?",
+ "why_collab_desc": "Tractatus comble les lacunes réelles en matiÚre de sécurité de l'IA. Les premiers utilisateurs façonnent l'évolution du cadre et acquiÚrent une expertise en matiÚre de gouvernance structurelle de l'IA - une capacité différenciatrice à mesure que les exigences réglementaires évoluent."
}
}
diff --git a/scripts/translate-implementer-deepl.js b/scripts/translate-implementer-deepl.js
new file mode 100755
index 00000000..43520285
--- /dev/null
+++ b/scripts/translate-implementer-deepl.js
@@ -0,0 +1,187 @@
+#!/usr/bin/env node
+
+/**
+ * Translate implementer.json from EN to DE and FR using DeepL API
+ *
+ * Usage: node scripts/translate-implementer-deepl.js
+ *
+ * Requires: DEEPL_API_KEY environment variable
+ */
+
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+
+const DEEPL_API_KEY = process.env.DEEPL_API_KEY;
+const API_URL = 'api.deepl.com'; // Pro API endpoint
+
+if (!DEEPL_API_KEY) {
+ console.error('â ERROR: DEEPL_API_KEY environment variable not set');
+ console.error(' Set it with: export DEEPL_API_KEY="your-key-here"');
+ process.exit(1);
+}
+
+const EN_FILE = path.join(__dirname, '../public/locales/en/implementer.json');
+const DE_FILE = path.join(__dirname, '../public/locales/de/implementer.json');
+const FR_FILE = path.join(__dirname, '../public/locales/fr/implementer.json');
+
+// Load JSON files
+const enData = JSON.parse(fs.readFileSync(EN_FILE, 'utf8'));
+const deData = JSON.parse(fs.readFileSync(DE_FILE, 'utf8'));
+const frData = JSON.parse(fs.readFileSync(FR_FILE, 'utf8'));
+
+// DeepL API request function
+function translateText(text, targetLang) {
+ return new Promise((resolve, reject) => {
+ const postData = new URLSearchParams({
+ auth_key: DEEPL_API_KEY,
+ text: text,
+ target_lang: targetLang,
+ source_lang: 'EN',
+ formality: 'default',
+ preserve_formatting: '1'
+ }).toString();
+
+ const options = {
+ hostname: API_URL,
+ port: 443,
+ path: '/v2/translate',
+ method: 'POST',
+ headers: {
+ 'Content-Type': 'application/x-www-form-urlencoded',
+ 'Content-Length': Buffer.byteLength(postData)
+ }
+ };
+
+ const req = https.request(options, (res) => {
+ let data = '';
+ res.on('data', (chunk) => { data += chunk; });
+ res.on('end', () => {
+ if (res.statusCode === 200) {
+ try {
+ const response = JSON.parse(data);
+ resolve(response.translations[0].text);
+ } catch (err) {
+ reject(new Error(`Failed to parse response: ${err.message}`));
+ }
+ } else {
+ reject(new Error(`DeepL API error: ${res.statusCode} - ${data}`));
+ }
+ });
+ });
+
+ req.on('error', reject);
+ req.write(postData);
+ req.end();
+ });
+}
+
+// Helper to get nested value
+function getNestedValue(obj, path) {
+ return path.split('.').reduce((current, key) => current?.[key], obj);
+}
+
+// Helper to set nested value
+function setNestedValue(obj, path, value) {
+ const keys = path.split('.');
+ const lastKey = keys.pop();
+ const target = keys.reduce((current, key) => {
+ if (!current[key]) current[key] = {};
+ return current[key];
+ }, obj);
+ target[lastKey] = value;
+}
+
+// Recursively find all string values and their paths
+function findAllStrings(obj, prefix = '') {
+ const strings = [];
+
+ for (const [key, value] of Object.entries(obj)) {
+ const currentPath = prefix ? `${prefix}.${key}` : key;
+
+ if (typeof value === 'string') {
+ strings.push(currentPath);
+ } else if (typeof value === 'object' && value !== null && !Array.isArray(value)) {
+ strings.push(...findAllStrings(value, currentPath));
+ }
+ }
+
+ return strings;
+}
+
+// Main translation function
+async function translateFile(targetLang, targetData, targetFile) {
+ console.log(`\nđ Translating to ${targetLang}...`);
+
+ const allPaths = findAllStrings(enData);
+ let translatedCount = 0;
+ let skippedCount = 0;
+ let errorCount = 0;
+
+ for (const keyPath of allPaths) {
+ const enValue = getNestedValue(enData, keyPath);
+ const existingValue = getNestedValue(targetData, keyPath);
+
+ // Skip if already translated (not empty)
+ if (existingValue && existingValue.trim().length > 0) {
+ skippedCount++;
+ process.stdout.write('.');
+ continue;
+ }
+
+ try {
+ // Translate
+ const translated = await translateText(enValue, targetLang);
+ setNestedValue(targetData, keyPath, translated);
+ translatedCount++;
+ process.stdout.write('â');
+
+ // Rate limiting: wait 500ms between requests to avoid 429 errors
+ await new Promise(resolve => setTimeout(resolve, 500));
+
+ } catch (error) {
+ console.error(`\nâ Error translating ${keyPath}:`, error.message);
+ errorCount++;
+ process.stdout.write('â');
+ }
+ }
+
+ console.log(`\n\nđ Translation Summary for ${targetLang}:`);
+ console.log(` â Translated: ${translatedCount}`);
+ console.log(` . Skipped (already exists): ${skippedCount}`);
+ console.log(` â Errors: ${errorCount}`);
+
+ // Save updated file
+ fs.writeFileSync(targetFile, JSON.stringify(targetData, null, 2) + '\n', 'utf8');
+ console.log(` đŸ Saved: ${targetFile}`);
+}
+
+// Run translations
+async function main() {
+ console.log('âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ');
+ console.log(' DeepL Translation: implementer.json (EN â DE, FR)');
+ console.log('âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ\n');
+
+ const totalStrings = findAllStrings(enData).length;
+ console.log(`đ Total translation keys in EN file: ${totalStrings}`);
+
+ try {
+ // Translate to German
+ await translateFile('DE', deData, DE_FILE);
+
+ // Translate to French
+ await translateFile('FR', frData, FR_FILE);
+
+ console.log('\nâ
Translation complete!');
+ console.log('\nđĄ Next steps:');
+ console.log(' 1. Review translations in de/implementer.json and fr/implementer.json');
+ console.log(' 2. Test on local server: npm start');
+ console.log(' 3. Visit http://localhost:9000/implementer.html and switch languages');
+
+ } catch (error) {
+ console.error('\nâ Fatal error:', error);
+ process.exit(1);
+ }
+}
+
+main();
diff --git a/scripts/validate-implementer-i18n.js b/scripts/validate-implementer-i18n.js
new file mode 100755
index 00000000..4c356c3d
--- /dev/null
+++ b/scripts/validate-implementer-i18n.js
@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+
+/**
+ * Validate implementer.html i18n keys against translation files
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+// Read HTML file and extract data-i18n keys
+const htmlPath = path.join(__dirname, '../public/implementer.html');
+const html = fs.readFileSync(htmlPath, 'utf8');
+
+const keyPattern = /data-i18n="([^"]+)"/g;
+const htmlKeys = new Set();
+let match;
+
+while ((match = keyPattern.exec(html)) !== null) {
+ htmlKeys.add(match[1]);
+}
+
+console.log('âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ');
+console.log(' Implementer.html i18n Validation');
+console.log('âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ\n');
+
+console.log(`đ Total data-i18n keys in HTML: ${htmlKeys.size}`);
+
+// Load translation files
+const enPath = path.join(__dirname, '../public/locales/en/implementer.json');
+const dePath = path.join(__dirname, '../public/locales/de/implementer.json');
+const frPath = path.join(__dirname, '../public/locales/fr/implementer.json');
+
+const enData = JSON.parse(fs.readFileSync(enPath, 'utf8'));
+const deData = JSON.parse(fs.readFileSync(dePath, 'utf8'));
+const frData = JSON.parse(fs.readFileSync(frPath, 'utf8'));
+
+// Helper to check if nested key exists
+function hasNestedKey(obj, keyPath) {
+ const keys = keyPath.split('.');
+ let current = obj;
+
+ for (const key of keys) {
+ if (current && typeof current === 'object' && key in current) {
+ current = current[key];
+ } else {
+ return false;
+ }
+ }
+
+ return typeof current === 'string' && current.length > 0;
+}
+
+// Check each language
+const languages = [
+ { name: 'English (EN)', code: 'en', data: enData },
+ { name: 'German (DE)', code: 'de', data: deData },
+ { name: 'French (FR)', code: 'fr', data: frData }
+];
+
+let allValid = true;
+
+for (const lang of languages) {
+ const missingKeys = [];
+
+ for (const key of htmlKeys) {
+ if (!hasNestedKey(lang.data, key)) {
+ missingKeys.push(key);
+ }
+ }
+
+ console.log(`\nđ ${lang.name}`);
+ if (missingKeys.length === 0) {
+ console.log(` â
All ${htmlKeys.size} keys found`);
+ } else {
+ console.log(` â Missing ${missingKeys.length} keys:`);
+ missingKeys.forEach(key => console.log(` âą ${key}`));
+ allValid = false;
+ }
+}
+
+console.log('\nâââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ');
+if (allValid) {
+ console.log('â
VALIDATION PASSED: All i18n keys are properly translated');
+} else {
+ console.log('â VALIDATION FAILED: Some keys are missing');
+ process.exit(1);
+}
+console.log('âââââââââââââââââââââââââââââââââââââââââââââââââââââââââââ\n');