diff --git a/Home.md b/Home.md deleted file mode 100644 index 1b2ada6..0000000 --- a/Home.md +++ /dev/null @@ -1,38 +0,0 @@ -# go-scm - -**SCM/CI Platform** - -`go-scm` provides SCM integration, CI automation, and data collection for the Lethean ecosystem. It includes API clients for Forgejo and Gitea, a job runner with event-driven handlers, the AgentCI orchestrator for dispatching work to AI agents, and a data collection framework for GitHub, BitcoinTalk, academic papers, and market data. - -## Installation - -```bash -go get forge.lthn.ai/core/go-scm -``` - -## Package Map - -| Package | Purpose | -|---------|---------| -| `forge/` | Forgejo API client -- repos, issues, PRs, orgs, labels, webhooks, reviews | -| `gitea/` | Gitea API client -- repos, issues, meta | -| `jobrunner/` | CI job runner -- poller, journal, signal/handler pattern | -| `jobrunner/forgejo/` | Forgejo-specific job source (epic issue polling) | -| `jobrunner/handlers/` | Event handlers: dispatch, completion, auto-merge, dismiss reviews, fix commands, publish drafts, tick parent | -| `agentci/` | AgentCI orchestrator -- Clotho verified execution, agent config, security | -| `collect/` | Data collection -- GitHub, BitcoinTalk, academic papers, market data, excavation pipeline | -| `git/` | Git operations as a Core service -- status, push, pull, dirty/ahead detection | - -## Architecture Overview - -The system is built around three core patterns: - -1. **API Clients** ([[Forge-and-Gitea]]) -- Thin wrappers around the Forgejo and Gitea Go SDKs with layered config resolution (config file, env vars, flag overrides). - -2. **Job Runner** ([[AgentCI]]) -- A poll-dispatch loop that discovers `PipelineSignal` values from sources (e.g. Forgejo epic issues) and routes them to matching `JobHandler` implementations. Includes JSONL audit journalling. - -3. **Data Collection** ([[Data-Collection]]) -- A pluggable collector framework with the `Excavator` orchestrator for sequential, rate-limited, resumable data gathering. - -## Licence - -EUPL-1.2