No description
GitState (.core/git.yaml, .gitignored): - Per-repo sync timestamps (last pull/push), branch, ahead/behind - Agent heartbeats with active package lists - Stale agent detection, overlap queries, NeedsPull check WorkConfig (.core/work.yaml, checked in): - Sync policy: interval, auto_pull, auto_push, clone_missing - Agent policy: heartbeat interval, stale timeout, overlap warnings - Trigger list: on_activate, on_commit, scheduled Both use io.Medium for testability (MockMedium in all tests). Co-Authored-By: Virgil <virgil@lethean.io> Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> |
||
|---|---|---|
| .forgejo/workflows | ||
| agentci | ||
| cmd | ||
| collect | ||
| docs | ||
| forge | ||
| git | ||
| gitea | ||
| jobrunner | ||
| manifest | ||
| marketplace | ||
| plugin | ||
| repos | ||
| .editorconfig | ||
| .golangci.yml | ||
| CLAUDE.md | ||
| CONTRIBUTING.md | ||
| go.mod | ||
| go.sum | ||
| README.md | ||
go-scm
SCM integration, AgentCI dispatch automation, and data collection for the Lethean ecosystem. Provides a Forgejo API client and a Gitea client for the public mirror, multi-repo git operations with parallel status checks, the Clotho Protocol orchestrator for dual-run agent verification, a PR automation pipeline (poll → dispatch → journal) driven by epic issue task lists, and pluggable data collectors for BitcoinTalk, GitHub, market data, and research papers.
Module: forge.lthn.ai/core/go-scm
Licence: EUPL-1.2
Language: Go 1.25
Quick Start
import (
"forge.lthn.ai/core/go-scm/forge"
"forge.lthn.ai/core/go-scm/git"
"forge.lthn.ai/core/go-scm/jobrunner"
)
// Forgejo client
client, err := forge.NewFromConfig("", "")
// Multi-repo status
statuses := git.Status(ctx, git.StatusOptions{Paths: repoPaths})
// AgentCI dispatch loop
poller := jobrunner.NewPoller(jobrunner.PollerConfig{
Sources: []jobrunner.JobSource{forgejoSrc},
Handlers: []jobrunner.JobHandler{dispatch, tickParent},
PollInterval: 60 * time.Second,
})
poller.Run(ctx)
Documentation
- Architecture — package overview, AgentCI pipeline, Clotho Protocol, data collection
- Development Guide — building, testing, standards
- Project History — completed phases and known limitations
Build & Test
go test ./...
go test -race ./...
go build ./...
Licence
European Union Public Licence 1.2 — see LICENCE for details.