cli_main

---

iso_doc_type: "Specification" iso_viewpoint: "ComponentView" type: "module" title: "factory-cli — Command Line Interface" source_path: "crates/factory-cli/src/main.rs" description: "ISO 42010 ComponentView / ISO 15289 Specification documentation for factory-cli — Command Line Interface." tags: ['iso42010', 'okf', 'component_view', 'rust', 'ast'] timestamp: "2026-10-01T14:00:00Z" generated: "agent:okf-professional-documenter" verified: "true" last_verified_commit: "fbdc5848"

factory-cli — Command Line Interface

Source: crates/factory-cli/src/main.rs
Layer: Interface
Role: Primary operational binary providing execution daemons, background workers, OSR validation, and GitLab environment verifiers.

---

Architecture & Subcommands

graph TB
    CLI["factory-cli"] --> W["worker<br/>Hatchet worker & Kafka consumer"]
    CLI --> P["poller<br/>Outbound poller for GitHub & GitLab"]
    CLI --> VOSR["verify-osr<br/>Out-of-Sync Rate checker"]
    CLI --> GV["gitlab-verify<br/>GitLab connectivity verifier"]

    style CLI fill:#9C27B0,stroke:#6A1B9A,color:#fff
    style W fill:#2196F3,stroke:#1565C0,color:#fff
    style P fill:#4CAF50,stroke:#2E7D32,color:#fff

Loading

Available Subcommands

1. worker

Starts the Hatchet mission worker and listens on the Kafka mission-input topic:

cargo run --bin factory-cli -- worker \
    --mcp-url http://localhost:8100 \
    --r2r-url http://localhost:8000 \
    --kafka-brokers localhost:9092

2. poller

Runs the continuous outbound polling daemon checking for issues labeled autonomous-mission / dark-gravity and PR comments across configured GitHub and GitLab repositories:

cargo run --bin factory-cli -- poller \
    --github-repos lgcorzo/rust_CACD_autonomous_factory,lgcorzo/mlops-python-package \
    --gitlab-projects lgcorzo-lab/autonomous_factory \
    --interval-secs 30

3. gitlab-verify

Performs comprehensive end-to-end authentication and API checks against GitLab instances:

cargo run --bin factory-cli -- gitlab-verify \
    --gitlab-url https://gitlab.com \
    --target-projects lgcorzo-lab/autonomous_factory

4. verify-osr

Validates the Out-of-Sync Rate (OSR) of generated documentation against the current R2R knowledge base:

cargo run --bin factory-cli -- verify-osr --r2r-url http://localhost:8000

Binary Targets in crates/factory-cli/src/bin/

• trigger_mission: Manually triggers an autonomous mission with custom resource constraints.
• run_functional_suite: Executes the complete end-to-end integration and functional test suite.
• trigger_deep_search: Triggers asynchronous deep research tasks over Hatchet.

---

Related: Tactical Design · User Manual