diff --git a/public/docs/diagrams/deployment-architecture.svg b/public/docs/diagrams/deployment-architecture.svg new file mode 100644 index 00000000..7f2ceaf4 --- /dev/null +++ b/public/docs/diagrams/deployment-architecture.svg @@ -0,0 +1,73 @@ + diff --git a/public/docs/diagrams/request-flow-sequence.svg b/public/docs/diagrams/request-flow-sequence.svg new file mode 100644 index 00000000..fb664aeb --- /dev/null +++ b/public/docs/diagrams/request-flow-sequence.svg @@ -0,0 +1,116 @@ + diff --git a/public/docs/diagrams/system-architecture.svg b/public/docs/diagrams/system-architecture.svg new file mode 100644 index 00000000..72d2f57f --- /dev/null +++ b/public/docs/diagrams/system-architecture.svg @@ -0,0 +1,91 @@ + diff --git a/public/implementer.html b/public/implementer.html index 2668f63d..5ee64aca 100644 --- a/public/implementer.html +++ b/public/implementer.html @@ -81,6 +81,8 @@ API Reference Code Examples Deployment + Integration Patterns + Roadmap @@ -131,6 +133,72 @@ + + +
High-level overview showing how the 6 governance services integrate with your application and data layer.
+Typical AI decision flow with governance enforcement: from user request through boundary checking to human approval.
+Production deployment reference showing Node.js application, MongoDB, and monitoring stack configuration.
+Common architectural patterns for integrating Tractatus into existing systems.
+ ++ Insert governance checks as middleware in your request pipeline. Suitable for API-based AI systems. +
+Use Case: REST APIs, Express.js applications
+app.use(governanceMiddleware({
+ services: ['BoundaryEnforcer', 'CrossReferenceValidator'],
+ mode: 'strict',
+ auditAll: true
+}))
+ + Trigger governance checks via events. Suitable for async workflows and microservices. +
+Use Case: Message queues, event buses, async processing
+eventBus.on('ai:decision', async (event) => {
+ const result = await checkBoundary(event.decision)
+ if (!result.allowed) {
+ await requestHumanApproval(event, result)
+ }
+})
+ + Validate actions before and after execution. Current production pattern for Claude Code. +
+Use Case: LLM tool use, autonomous agents
+hooks: {
+ PreToolUse: governanceCheck,
+ PostToolUse: auditLog,
+ SessionStart: loadInstructions,
+ SessionEnd: cleanup
+}
+ + Deploy governance as a separate service. Suitable for multi-LLM or polyglot environments. +
+Use Case: Kubernetes, containerized deployments
+// AI Service makes HTTP call
+const govResponse = await fetch(
+ 'http://governance-sidecar:8080/check',
+ { method: 'POST', body: JSON.stringify(decision) }
+)
+ + Tractatus is an active research framework. We welcome collaboration on priority development areas. +
+ ++ These initiatives represent high-impact opportunities for framework enhancement. Technical contributors, researchers, and organizations are encouraged to engage. +
+ +Status: Research Phase
++ Extend governance to GPT-4, Gemini, Llama, and local models. Requires adapting hook architecture to different LLM interfaces. +
+Status: Community Interest
++ Python, Go, and Rust implementations to serve broader developer communities. Core logic is portable; MongoDB integration is universal. +
+Status: Reference Architectures Needed
++ Terraform/Helm charts for AWS, Azure, GCP. Include managed MongoDB (Atlas), auto-scaling, and monitoring integration. +
+Status: Conceptual
++ Adapters for LangChain, Semantic Kernel, AutoGPT, and CrewAI. Enable governance for existing agent frameworks. +
+Status: Validation Needed
++ Optimize for 1000+ concurrent AI agents. Requires caching strategies, rule compilation, and distributed audit logging. +
+Status: Research
++ Cost monitoring, rate limiting, PII detection, adversarial prompt defense. Domain-specific services for regulated industries. +
++ Tractatus is Apache 2.0 licensed research. We welcome contributions, pilot implementations, and collaborative research partnerships. +
+ +Implement features, fix bugs, improve documentation
+ + → Contributing Guide + +Validation studies, academic collaboration, case studies
+ + → research@agenticgovernance.digital + +Production deployments, enterprise requirements, feedback loops
+ + → 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. +
+