Skip to content

Releases: LangeVC/ops-engine

Ops Engine v0.1.0

20 May 23:10
@typelicious typelicious
v0.1.0
048bb1d

Choose a tag to compare

View all tags
Ops Engine v0.1.0 Latest
Latest

Initial Release: Ops Engine v0.1.0

We are proud to announce the initial open-source release of the LangeVC Ops Engine – a generic, rate-limited async webhook queue and orchestration framework for GitHub and Forgejo.

This release establishes the foundation for scalable organizational Git automation without the risk of API rate-limiting or CI/CD runner starvation (The Thundering Herd problem).

🚀 Core Architecture

  • Engine/Layover Pattern: Complete separation of infrastructure logic (the Engine) and organization-specific business rules (the Layover).
  • Config-Driven Design: All rules, thresholds, and target repositories are purely controlled via YAML/Pydantic, requiring zero hardcoded business logic.
  • Asynchronous Processing: Built on FastAPI and asyncio, the engine captures incoming webhooks instantly, preventing forge timeouts via HTTP 202 Accepted responses.

✨ Key Features

  • Rate Limit Queue (QueueManager): Processes all GitHub/Forgejo API interactions sequentially (e.g., 1 request/second) to guarantee strict adherence to API quotas.
  • Triage & Auto-Labeling (TriageHandler): Inspects newly opened PRs and Issues, applying appropriate labels based on title keywords (e.g., bug, feat) instantly.
  • Stale Cleanup (StaleManager): Centralized, cron-driven scanning across multiple repositories to mark and manage stale issues.
  • Cross-Repo Triggers (DependencyTriggerHandler): Automatically dispatches repository_dispatch events to downstream repositories whenever an upstream repository publishes a new release.
  • Centralized Dispatching (CronDispatcher): Replaces decentralized .github/workflows/ cron jobs, orchestrating heavy loads (like CodeQL) centrally and sequentially.

🛠️ Installation

pip install git+https://github.com/LangeVC/ops-engine.git@v0.1.0
Assets 2
Loading