Documentation
¶
Overview ¶
Package forgejo provisions a git.profullstack.com account for every verified AgentBBS member (free and paid alike) on the self-hosted Forgejo backend that powers AgentGit. BBS membership *is* the git account: when a member verifies their email, EnsureUser creates the matching Forgejo user. It is idempotent — an existing account is left untouched. When unconfigured (no admin token) Configured() reports false and callers skip provisioning entirely.
This mirrors the AgentGit ForgejoAdapter.ensureUser contract in profullstack/logicsrc (plugins/agentgit). Plan (free vs. premium) never affects whether the account exists — only quotas, which are enforced server-side by AgentGit merge policy, not here.
Config (env):
AGENTBBS_FORGEJO_URL base URL, e.g. https://git.profullstack.com AGENTBBS_FORGEJO_ADMIN_TOKEN Forgejo admin access token
Index ¶
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type Config ¶
Config holds the Forgejo base URL and admin token.
func ConfigFromEnv ¶
func ConfigFromEnv() Config
ConfigFromEnv reads the Forgejo settings from the environment.
func (Config) Configured ¶
Configured reports whether accounts can actually be provisioned.
func (Config) EnsureUser ¶
EnsureUser creates a Forgejo account for username (forwarding to email) if it does not already exist. It is idempotent: created is false when the account was already present. New accounts are created with must_change_password — git access is via SSH keys, so the generated password is never used interactively.
Source Files