Home - lgcorzo/rust_CACD_autonomous_factory GitHub Wiki
iso_doc_type: "Description" iso_viewpoint: "ComponentView" type: "module" title: "Dark Gravity CA/CD Autonomous Factory — Wiki" description: "ISO 42010 ComponentView / ISO 15289 Description documentation for Dark Gravity CA/CD Autonomous Factory — Wiki." tags: ['iso42010', 'okf'] timestamp: "2026-10-01T14:00:00Z" generated: "agent:okf-professional-documenter" verified: "true" last_verified_commit: "fbdc5848"
Dark Gravity CA/CD Autonomous Factory — Wiki
Welcome to the Dark Gravity Autonomous Factory professional enterprise wiki. This documentation provides a comprehensive, C4-model-driven view of the CA/CD (Continuous Agentic / Continuous Deployment) platform — from executive business context through to deep tactical code-level UML diagrams.
🏠 Quick Navigation
| Section | Description |
|---|---|
| 📋 Business Context | CA/CD vision, Hazitek 2026, ROI, KPIs |
| 🏗️ Strategic Design | C4 Context & Container diagrams, Bounded Contexts, Onion Architecture |
| ⚙️ Tactical Design | C4 Component diagrams, 5-crate mapping, DAG phases |
| 🤖 Agent Specifications | Rustant, ZeroClaw, Auditor, FinOps, QAObserver, DocAgent |
| 🔄 Experiment Lifecycle | 6-phase Hatchet DAG, Spec-Kit SDD workflows |
| 🔌 Infrastructure Adapters | Kafka, R2R GraphRAG, OpenZiti, Vault, Sentry |
| ✅ Verification Triad | Logical, Architectural, Security gates |
| 🚀 Production Operations | FluxCD GitOps, K8s topology, LiteLLM, troubleshooting |
| 📖 User Manual | CLI usage, environment config, interactive directives |
| 🔒 Security Architecture | Zero Trust, Ed25519 NHI, gVisor sandbox isolation |
| 🏛️ HITL Governance | 4-Vertex governance mesh, human oversight model |
| 📜 Compliance & Audit | Hazitek 2026, EU AI Act, R&D telemetry packaging |
| 📚 Glossary | DDD ubiquitous language, acronyms, domain terms |
| 📑 Master Index | Complete file listing with categories |
🔧 Crate Reference (OKF Source Maps)
Each crate in the workspace has per-module OKF documentation pages:
| Crate | Layer | Pages |
|---|---|---|
factory-core |
Domain | 5 |
factory-application |
Application | 20+ |
factory-infrastructure |
Infrastructure | 15+ |
factory-mcp-server |
Interface (MCP) | 20+ |
factory-cli |
CLI | 3 |
📊 Architecture at a Glance
C4Context
title Dark Gravity CA/CD Autonomous Factory — System Context (C1)
Person(po, "Product Owner", "Creates Epics tagged autonomous-plan")
Person(techlead, "Tech Lead", "Approves Spec-Kit task decomposition")
Person(architect, "Architect", "Resolves Agent-Stuck deadlocks")
Person(reviewer, "Senior Reviewer", "Reviews design & merges PR/MR")
System(factory, "Dark Gravity Factory", "Autonomous CA/CD platform")
System_Ext(github, "GitHub", "Source code, PRs, Actions CI")
System_Ext(gitlab, "GitLab", "MRs, CI pipelines")
System_Ext(jira, "Jira", "Issue tracking, Sprint boards")
System_Ext(fluxcd, "FluxCD", "GitOps Kubernetes deployment")
System_Ext(hatchet, "Hatchet", "Workflow DAG orchestration")
System_Ext(kafka, "Kafka KRaft", "Event streaming bus")
System_Ext(litellm, "LiteLLM", "Multi-provider LLM routing")
System_Ext(ziti, "OpenZiti", "Zero Trust overlay network")
Rel(po, factory, "Creates autonomous missions")
Rel(techlead, factory, "Approves task plans")
Rel(architect, factory, "Overrides stuck agents")
Rel(reviewer, factory, "Merges PRs (HITL gate)")
Rel(factory, github, "Polls issues/PRs, pushes code")
Rel(factory, gitlab, "Polls MRs, pushes fixes")
Rel(factory, jira, "Searches issues, syncs tasks")
Rel(factory, hatchet, "Dispatches 6-phase DAGs")
Rel(factory, kafka, "Publishes/consumes mission events")
Rel(factory, litellm, "Routes LLM inference requests")
Rel(factory, ziti, "Secure agent-to-service tunnels")
Rel(fluxcd, factory, "Deploys factory to K8s")
📄 Documentation Standards
- Diagrams: All architectural diagrams use Mermaid.js for portable, text-based rendering
- Format: Follows the Open Knowledge Format (OKF) / OpenWiki standard
- Quality Gate: Orphan Symbol Rate (OSR) < 5% — every public Rust AST symbol is documented
- Sync: Documentation auto-syncs via
.github/workflows/docs-to-wiki.yml
Generated for the Dark Gravity CA/CD Autonomous Factory — Professional Enterprise Wiki Branch:
007-professional-wiki-docs| Last updated: 2026-09-30