index - lgcorzo/rust_CACD_autonomous_factory GitHub Wiki
iso_doc_type: "Description" iso_viewpoint: "ArchitectureDescription" type: "architecture" title: "Master Wiki Index โ ISO Architecture Description" description: "Master index of the Dark Gravity CA/CD Autonomous Factory documentation under ISO/IEC/IEEE 42010 and 15289 standards." tags: ["iso42010", "iso15289", "index", "architecture_description"] timestamp: "2026-10-01T14:00:00Z" generated: "agent:okf-professional-documenter" verified: "true" last_verified_commit: "fbdc5848"
Master Documentation Index โ Dark Gravity CA/CD Autonomous Factory
Standards Compliance: ISO/IEC/IEEE 42010:2022 (Architecture Descriptions) & ISO/IEC/IEEE 15289:2019 (Life Cycle Information Items).
Navigation & Entry Points
1. Architecture Viewpoints (ISO 42010)
| Viewpoint | Document | Description |
|---|---|---|
| ContextView | Business Context | Problem statement, ROI, KPIs, autonomous paradigm |
| ContextView | Strategic Design | C4 Level 1-2, Onion Architecture, Bounded Contexts |
| ComponentView | Tactical Design | C4 Level 3, Hatchet DAG mapping, tool registry |
| ComponentView | Agent Specifications | Specification of all 6 agents, shared trait, tool matrix |
| SequenceView | Runtime Sequences | 6-Phase Hatchet DAG execution, agent thought streaming |
| ComponentView | Infrastructure Adapters | Kafka, R2R GraphRAG, OpenZiti, Vault, Sentry, S3, Semantica |
| ComponentView | Mission Data Model | Event schemas, protobufs, JSON data contracts |
2. Security & Governance (ISO 42010 SecurityView & Policy)
| Topic | Document | Description |
|---|---|---|
| SecurityView | Security Architecture | Zero Trust, NHI Ed25519, gVisor isolation, STRIDE threat model |
| Policy | HITL Governance | 4-Vertex Human-in-the-Loop governance mesh & enforcement |
| Policy | Verification Triad | Logical, Architectural, and Security quality gates |
| Report | Compliance & Audit | Hazitek 2026, EU AI Act conformity assessment |
3. Operations & Deployment (ISO 42010 DeploymentView & Procedures)
| Topic | Document | Description |
|---|---|---|
| Procedure | User Manual | Step-by-step guides for mission creation, PR directives, CLI |
| DeploymentView | Production Operations | FluxCD GitOps, K8s namespace topology, LiteLLM proxy, runbook |
| Report | Experiment Logs | Telemetry schema, Kafka event topics, Prometheus metrics |
| Lab Notebook | EXP-2026-006 Recovery | Interrupted mission recovery & side-effect idempotency validation |
| Lab Notebook | EXP-2026-007 Security | Adversarial security & gVisor sandbox isolation validation |
| Lab Notebook | EXP-2026-009 AST Graph | AST context efficiency benchmark (Graphify/R2R vs Grep) |
| Lab Notebook | EXP-2026-010 Memory Bounding | Resource governance & gVisor memory bounding (512Mi) validation |
4. Software Quality & Testing (ISO 25010 & ISO 29119)
| Topic | Document | Description |
|---|---|---|
| QualityView | Test Plan & Report | Test pyramid, 18 integration suites, Criterion benchmarks |
5. Module Architecture & Codebase Mirror (ISO 42010 ComponentView)
factory-core (Domain Layer)
- lib.md โ Core domain entities, mission & task models
- config.md โ Model configuration & LiteLLM resolution
- error.md โ
FactoryErrorenum variants - executor.md โ
CodeSurgeryExecutortrait - security.md โ Security primitives & sandbox constraints
- security_nhi.md โ Ed25519 Non-Human Identity credentials
factory-application (Application Layer)
- lib.md โ Application crate overview &
Agenttrait - gitlab_verifier.md โ GitLab connectivity & token verifier
- poller_service.md โ Outbound GitHub/GitLab poller daemon
- telemetry_export.md โ Metrics & telemetry exporter
- Agents (
modules/application/agents/):- mod.md โ Agent dispatch registry
- rustant.md โ Product Owner & Planner agent
- zeroclaw.md โ Developer & Code Surgery agent
- auditor.md โ Security Auditor agent
- finops.md โ Budget & Token Cost agent
- qa_observer.md โ Quality Gate & Coverage agent
- doc_agent.md โ Documentation & OSR agent
- Workflows (
modules/application/workflows/):- mod.md โ Workflow registry
- autonomous_mission.md โ 6-Phase Hatchet DAG
- circuit_breaker.md โ Aethelgard loop breaker
- comment_control.md โ PR/MR directive handler
- deep_research.md โ Multi-step research DAG
- develop_task.md โ ZeroClaw TDD execution
- pipeline_remediation.md โ CI failure healer
- Bridge (
modules/application/bridge/):- mod.md โ Bridge abstractions
- adk_driver.md โ Agent Development Kit bridge
- kafka_bridge.md โ Kafka bidirectional bridge
- semantica_bridge.md โ Semantica decision recorder
- state.md โ Checkpoint state tracking
- Utils (
modules/application/utils/):
factory-infrastructure (Infrastructure Layer)
- lib.md โ Adapter registry & traits
- github.md โ GitHub REST API adapter
- gitlab.md โ GitLab API adapter
- jira.md โ Atlassian Jira Cloud adapter
- kafka.md โ KRaft Kafka producer/consumer
- ziti.md โ OpenZiti zero-trust overlay
- vault.md โ HashiCorp Vault secrets adapter
- r2r.md โ R2R GraphRAG vector client
- semantica.md โ Semantica decision & conflict client
- aethalgard.md โ Circuit breaker adapter
- mcp_client.md โ Model Context Protocol client
- pipeline_classifier.md โ CI/CD error taxonomy
- s3.md โ MinIO / S3 artifact storage
- sentry.md โ Error tracking & diagnostics
- security_validator.md โ Ed25519 signature validator
- cursor_store.md โ Event cursor store (In-memory & Postgres)
- git_poller.md โ Change detection daemon
factory-mcp-server (Interface Layer)
- lib.md โ Axum MCP server core
- main.md โ Server entry point & CLI flags
- protocol.md โ JSON-RPC 2.0 framing & SSE
- sandbox.md โ gVisor K8s Job sandbox lifecycle
- scratch.md โ Scratchpad filesystem manager
- feedback_route.md โ External webhook ingress
- github_webhook.md โ HMAC-SHA256 GitHub event listener
- Skills (
modules/mcp_server/skills/):- mod.md โ Skill registry
- context.md โ Spec-Kit execution context
- spec_kit_tool.md โ SDD Spec-Kit bridge
- Tools (
modules/mcp_server/tools/):- mod.md โ Tool registry (17 tools)
- bridge.md โ Bridge communication tool
- deep_research_tool.md โ Deep research tool
- execute_code.md โ Code surgery tool
- get_factory_status.md โ Factory status tool
- index_code.md โ Code indexing tool
- inspect_kafka_topic.md โ Kafka inspector tool
- launch_sandbox_pod.md โ Sandbox launcher tool
- list_minio_buckets.md โ Bucket discovery tool
- list_minio_objects.md โ Object listing tool
- plan_mission.md โ Mission planner tool
- retrieve_context.md โ R2R context retrieval tool
- run_tests.md โ Test runner tool
- search_jira.md โ Jira query tool
- security_review.md โ SAST security gate tool
- spec_kit_tasks_to_issues.md โ Task-to-issue tool
- spec_kit_tool.md โ Spec Kit CLI tool
- update_mission_status.md โ Mission status updater
factory-cli (Interface Layer)
- main.md โ CLI entry point & subcommands (
worker,poller,gitlab-verify,verify-osr) - trigger_mission.md โ Manual mission trigger binary
- run_functional_suite.md โ Functional E2E test runner binary
- trigger_deep_search.md โ Deep research trigger binary