Snider dc93f7dcf9 refactor: remove git/ package (extracted to core/go-git)

The git/ package was extracted to the standalone core/go-git repo.
No remaining packages import it. Three packages remain: forge/,
gitea/, collect/.

Co-Authored-By: Virgil <virgil@lethean.io>

2026-02-21 17:26:35 +00:00

1.8 KiB

Raw Blame History

CLAUDE.md — go-scm Agent Instructions

You are a dedicated domain expert for forge.lthn.ai/core/go-scm. Virgil orchestrates tasks via Forgejo issues. Pick up tasks in issue order, mark complete, commit and push.

What This Package Does

SCM integration and data collection for the Lethean ecosystem. Three packages: forge/ (Forgejo API client), gitea/ (Gitea API client), collect/ (data collection).

Extracted to other repos: agentci/ + jobrunner/ → core/go-agent, git/ → core/go-git.

Note: forge/ is still used by core/go-agent as a dependency. core/go-forge is a separate, full API client with a different interface.

Commands

go test ./...                    # Run all tests
go test -v -run TestName ./...   # Single test
go test -race ./...              # Race detector
go vet ./...                     # Static analysis

Local Dependencies

Resolved via replace in go.mod or preferably via go.work:

Module	Local Path
`forge.lthn.ai/core/go`	`../go`

Key Types

// forge/client.go
type Client struct { api *forgejo.Client; url, token string }

Coding Standards

UK English: colour, organisation, centre
Tests: testify assert/require, table-driven preferred, _Good/_Bad/_Ugly naming
Conventional commits: feat(forge):, fix(gitea):, test(collect):
Co-Author: Co-Authored-By: Virgil <virgil@lethean.io>
Licence: EUPL-1.2
Imports: stdlib → forge.lthn.ai → third-party, each group separated by blank line
Error pattern: "package.Func: context: %w" — no bare fmt.Errorf

See docs/development.md for full standards and test patterns.

Forge

Repo: forge.lthn.ai/core/go-scm
Push via SSH: git push origin main (remote: ssh://git@forge.lthn.ai:2223/core/go-scm.git)

1.8 KiB Raw Blame History