fullsend

module
v0.57.1-rc.1 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Nov 20, 2026 License: Apache-2.0

README

Fullsend

Autonomous agentic software development for Git-hosted organizations (GitHub, GitLab, Forgejo).

Fullsend agents triage issues, implement solutions, review code, and merge to production autonomously — while being secure by design.

Documentation

Visit fullsend.sh for the full documentation, including getting started guides, agent reference, architecture decisions, and design documents.

How to contribute

See CONTRIBUTING.md for the contribution workflow, vouch process, and commit conventions.

When in doubt, start with an issue.

License

This project is licensed under the Apache License, Version 2.0.

Directories

Path Synopsis
cmd
fullsend command
e2e
hack
prove-otlp-scores command
Command prove-otlp-scores scores a real run-telemetry.jsonl and asserts portable OTLP gen_ai.evaluation.result events arrive at a local sink.
Command prove-otlp-scores scores a real run-telemetry.jsonl and asserts portable OTLP gen_ai.evaluation.result events arrive at a local sink.
internal
actorcache
Package actorcache implements the bounded actor-verdict cache that ADR 0148 permits for entity-source CEL.
Package actorcache implements the bounded actor-verdict cache that ADR 0148 permits for entity-source CEL.
appsetup
Package appsetup handles creating and installing per-role GitHub Apps using the manifest flow.
Package appsetup handles creating and installing per-role GitHub Apps using the manifest flow.
artifacts
Package artifacts builds the copy of a run's output directory that CI uploads as the run artifact (ADR 0161).
Package artifacts builds the copy of a run's output directory that CI uploads as the run artifact (ADR 0161).
behaviourfail
Package behaviourfail classifies behaviour-suite failures as infrastructure (environment: setup, provisioning, rate limits, quotas) or scenario (the assertion itself) failures.
Package behaviourfail classifies behaviour-suite failures as infrastructure (environment: setup, provisioning, rate limits, quotas) or scenario (the assertion itself) failures.
botidentity
Package botidentity resolves the provider-registered Fullsend identity of bot actors (ADR 0107).
Package botidentity resolves the provider-registered Fullsend identity of bot actors (ADR 0107).
buildinfo
Package buildinfo holds build metadata stamped into the fullsend CLI at link time via -ldflags -X. It is a dependency-free leaf package so any internal package can read the version without importing internal/cli (which would pull in cobra and every subcommand, or create an import cycle).
Package buildinfo holds build metadata stamped into the fullsend CLI at link time via -ldflags -X. It is a dependency-free leaf package so any internal package can read the version without importing internal/cli (which would pull in cobra and every subcommand, or create an import cycle).
celtrigger
Package celtrigger compiles and evaluates agent trigger expressions: CEL booleans over a NormalizedEvent bound to the root variable event (ADR 0061).
Package celtrigger compiles and evaluates agent trigger expressions: CEL booleans over a NormalizedEvent bound to the root variable event (ADR 0061).
cli
dispatch
Package dispatch defines the Dispatcher interface for provisioning dispatch infrastructure during install.
Package dispatch defines the Dispatcher interface for provisioning dispatch infrastructure during install.
dispatch/cf
Package cf implements the dispatch.Dispatcher interface using a Cloudflare Worker as the token mint.
Package cf implements the dispatch.Dispatcher interface using a Cloudflare Worker as the token mint.
dispatch/cf/workersrc
Package workersrc exposes the Worker's npm manifest and lock file to Go callers.
Package workersrc exposes the Worker's npm manifest and lock file to Go callers.
dispatch/gcf
Package gcf implements the dispatch.Dispatcher interface using a GCP Cloud Function as the token mint.
Package gcf implements the dispatch.Dispatcher interface using a GCP Cloud Function as the token mint.
entitycache
Package entitycache implements a revisioned cache for partially acquired normalized entities.
Package entitycache implements a revisioned cache for partially acquired normalized entities.
entitycel
Package entitycel binds a normalized entity (normalized-entity v1) to CEL and evaluates entity-source harness predicates over a required `entity` and a nullable `event` (ADR 0098, ADR 0147).
Package entitycel binds a normalized entity (normalized-entity v1) to CEL and evaluates entity-source harness predicates over a required `entity` and a nullable `event` (ADR 0098, ADR 0147).
envfile
Package envfile provides a simple dotenv file parser.
Package envfile provides a simple dotenv file parser.
envmanifest
Package envmanifest models the sandbox environment-variable contract: which variables the runner injects into the sandbox, under what conditions, per which runtime, which are delivered by stock harness configuration rather than the runner, which are reserved from harness override, and which are deprecated.
Package envmanifest models the sandbox environment-variable contract: which variables the runner injects into the sandbox, under what conditions, per which runtime, which are delivered by stock harness configuration rather than the runner, which are reserved from harness override, and which are deprecated.
evalmeasure
Package evalmeasure scores agent run traces for online eval measurements.
Package evalmeasure scores agent run traces for online eval measurements.
fetch
Package fetch provides an SSRF-hardened HTTP client for safely retrieving content from external URLs.
Package fetch provides an SSRF-hardened HTTP client for safely retrieving content from external URLs.
fetchsvc
Package fetchsvc provides a runtime skill fetch service for agents running in sandboxes.
Package fetchsvc provides a runtime skill fetch service for agents running in sandboxes.
forge
Package forge defines the interface for interacting with git forges (GitHub, GitLab, Forgejo).
Package forge defines the interface for interacting with git forges (GitHub, GitLab, Forgejo).
forge/github
Package github implements forge.Client for the GitHub REST API.
Package github implements forge.Client for the GitHub REST API.
forge/gitlab
Package gitlab implements forge.Client for the GitLab REST API v4.
Package gitlab implements forge.Client for the GitLab REST API v4.
forge/jira
Package jira implements an HTTP client for the Jira Cloud REST API v3.
Package jira implements an HTTP client for the Jira Cloud REST API v3.
gcp
Package gcp provides authenticated HTTP access to GCP APIs using Application Default Credentials.
Package gcp provides authenticated HTTP access to GCP APIs using Application Default Credentials.
gitfetch
Package gitfetch fetches directory trees from git repositories using sparse checkout, providing a forge-agnostic alternative to REST API directory listing.
Package gitfetch fetches directory trees from git repositories using sparse checkout, providing a forge-agnostic alternative to REST API directory listing.
gitlablifecycle
Package gitlablifecycle implements GitLab-specific role ownership, credential attribution and trigger-owner transport.
Package gitlablifecycle implements GitLab-specific role ownership, credential attribution and trigger-owner transport.
gitlabroles
Package gitlabroles defines the GitLab role-credential contract (#7497, #7559, #7782).
Package gitlabroles defines the GitLab role-credential contract (#7497, #7559, #7782).
inference
Package inference defines the interface for provisioning inference provider credentials during fullsend installation.
Package inference defines the interface for provisioning inference provider credentials during fullsend installation.
inference/actionsoidc
Package actionsoidc fetches a GitHub Actions OIDC assertion (a JWT) from the runner's token service.
Package actionsoidc fetches a GitHub Actions OIDC assertion (a JWT) from the runner's token service.
inference/openaiwif
Package openaiwif exchanges a GitHub Actions OIDC JWT for an OpenAI access token via OpenAI's Workload Identity Federation endpoint.
Package openaiwif exchanges a GitHub Actions OIDC JWT for an OpenAI access token via OpenAI's Workload Identity Federation endpoint.
inference/vertex
Package vertex implements the inference.Provider interface for Google Cloud Vertex AI using Workload Identity Federation with GitHub OIDC.
Package vertex implements the inference.Provider interface for Google Cloud Vertex AI using Workload Identity Federation with GitHub OIDC.
inference/vertexauth
Package vertexauth prepares GitHub Actions Workload Identity Federation credentials for a single Vertex inference run.
Package vertexauth prepares GitHub Actions Workload Identity Federation credentials for a single Vertex inference run.
jiradispatch
Package jiradispatch holds the Jira dispatch core shared by the production jira-poll driver (internal/cli) and the behaviour scenarios (pkg/behaviourtest): the CEL trigger matcher that turns a normalized event into jirapoll dispatch records, and the GitLab record dispatcher that recovers the embedded normalized event and starts the agent pipeline.
Package jiradispatch holds the Jira dispatch core shared by the production jira-poll driver (internal/cli) and the behaviour scenarios (pkg/behaviourtest): the CEL trigger matcher that turns a normalized event into jirapoll dispatch records, and the GitLab record dispatcher that recovers the embedded normalized event and starts the agent pipeline.
jirapoll
Package jirapoll implements a polling-based input driver for Jira, converting issue comments, label changes, and status transitions into NormalizedEvents per ADR 0063's write-then-verify coordination protocol.
Package jirapoll implements a polling-based input driver for Jira, converting issue comments, label changes, and status transitions into NormalizedEvents per ADR 0063's write-then-verify coordination protocol.
lock
Package lock reads and writes .fullsend/lock.yaml files that pin all resolved remote dependencies (URLs and integrity hashes) for reproducible harness execution.
Package lock reads and writes .fullsend/lock.yaml files that pin all resolved remote dependencies (URLs and integrity hashes) for reproducible harness execution.
netutil
Package netutil provides shared network utilities for IP classification.
Package netutil provides shared network utilities for IP classification.
normentity
Package normentity defines the in-memory Go model of the normalized entity (normalized-entity v1) that harness CEL predicates evaluate over (ADR 0098, ADR 0147).
Package normentity defines the in-memory Go model of the normalized entity (normalized-entity v1) that harness CEL predicates evaluate over (ADR 0098, ADR 0147).
normevent
Package normevent defines forge-neutral NormalizedEvent types for harness CEL dispatch (ADR 0061).
Package normevent defines forge-neutral NormalizedEvent types for harness CEL dispatch (ADR 0061).
pluginformat
Package pluginformat decides which runtime loads a `plugins:` entry.
Package pluginformat decides which runtime loads a `plugins:` entry.
poll
Package poll implements the GitLab cron-polling event dispatch loop.
Package poll implements the GitLab cron-polling event dispatch loop.
prescript
Package prescript implements the pre-script output protocol (issue #4718).
Package prescript implements the pre-script output protocol (issue #4718).
preset
Package preset loads and installs layered-configuration presets independently of any forge.
Package preset loads and installs layered-configuration presets independently of any forge.
randutil
Package randutil provides cryptographically secure random number utilities.
Package randutil provides cryptographically secure random number utilities.
repos
Package repos provides reusable per-repo installation logic for fullsend.
Package repos provides reusable per-repo installation logic for fullsend.
security
Package security provides input sanitization and output scanning for fullsend's agent entrypoints.
Package security provides input sanitization and output scanning for fullsend's agent entrypoints.
selfupdate
Package selfupdate replaces the running fullsend CLI binary with a release from GitHub Releases.
Package selfupdate replaces the running fullsend CLI binary with a release from GitHub Releases.
sentencetoken
Package sentencetoken splits text into sentences using the Punkt algorithm.
Package sentencetoken splits text into sentences using the Punkt algorithm.
skill
Package skill parses SKILL.md frontmatter for transitive dependency resolution and the sandbox directory name a skill occupies.
Package skill parses SKILL.md frontmatter for transitive dependency resolution and the sandbox directory name a skill occupies.
statuscomment
Package statuscomment posts agent start/completion status comments on issues and pull requests via the tracker abstraction.
Package statuscomment posts agent start/completion status comments on issues and pull requests via the tracker abstraction.
telemetry
Package telemetry implements fullsend's distributed tracing (ADR 0050).
Package telemetry implements fullsend's distributed tracing (ADR 0050).
telemetry/tracecontext
Package tracecontext implements the versioned immutable work-item identity and signed trace-context envelope contract from ADR 0154.
Package tracecontext implements the versioned immutable work-item identity and signed trace-context envelope contract from ADR 0154.
tracker
Package tracker defines a narrow, forge-agnostic interface for reading and writing issue content (title, body, comments), keyed by (project string, number int) rather than the (owner, repo string, number int) shape used by forge.Client.
Package tracker defines a narrow, forge-agnostic interface for reading and writing issue content (title, body, comments), keyed by (project string, number int) rather than the (owner, repo string, number int) shape used by forge.Client.
ui
urlutil
Package urlutil provides URL validation and integrity-hash utilities shared by config (agent entry validation) and harness (remote resource resolution) packages.
Package urlutil provides URL validation and integrity-hash utilities shared by config (agent entry validation) and harness (remote resource resolution) packages.
vaultsecrets
Package vaultsecrets resolves Fullsend runner secrets from HashiCorp Vault KV v2 through the job's workload identity (ADR 0155).
Package vaultsecrets resolves Fullsend runner secrets from HashiCorp Vault KV v2 through the job's workload identity (ADR 0155).
wranglerprep
Package wranglerprep installs the pinned Wrangler once and tells child processes where it is.
Package wranglerprep installs the pinned Wrangler once and tells child processes where it is.
mint module
mintcore module
pkg
behaviourtest
Package behaviourtest is the public entry point for running Gherkin behaviour tests against fullsend.
Package behaviourtest is the public entry point for running Gherkin behaviour tests against fullsend.
behaviourtest/drivers
Package drivers holds definitions shared by the behaviour-test driver packages (scm, ci, install).
Package drivers holds definitions shared by the behaviour-test driver packages (scm, ci, install).
behaviourtest/drivers/ci/forgejoactions
Package forgejoactions is the Forgejo Actions ci.Driver for behaviour tests.
Package forgejoactions is the Forgejo Actions ci.Driver for behaviour tests.
behaviourtest/drivers/install
Package install provides pool-repo lifecycle management for behaviour tests: cross-org repo slot leasing (slotpool.go), per-org mint deployment, fullsend installation, and teardown.
Package install provides pool-repo lifecycle management for behaviour tests: cross-org repo slot leasing (slotpool.go), per-org mint deployment, fullsend installation, and teardown.
behaviourtest/drivers/jiramock
Package jiramock provides a stateful mock Jira REST API server for behaviour tests.
Package jiramock provides a stateful mock Jira REST API server for behaviour tests.
behaviourtest/drivers/scm/forgejo
Package forgejo is the Forgejo scm.Driver for behaviour tests.
Package forgejo is the Forgejo scm.Driver for behaviour tests.
behaviourtest/failclass
Package failclass classifies behaviour-suite failure errors as infrastructure (environment) or scenario (assertion) failures.
Package failclass classifies behaviour-suite failure errors as infrastructure (environment) or scenario (assertion) failures.
behaviourtest/retryselect
Package retryselect chooses which feature paths a retried behaviour run executes.
Package retryselect chooses which feature paths a retried behaviour run executes.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL