core/go-scm
8
0
Fork 0
Code Issues 4 Pull requests Projects Releases Packages Wiki Activity Actions

Delete page "Home"

Virgil 2026-02-19 16:58:59 +00:00
parent 160bed0dcc
commit e7cfaf0672
1 changed files with 0 additions and 38 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

38
Home.md

@ -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