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

docs-to-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