fullsend

module
v0.28.0 Latest Latest
Warning

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

Go to latest
Published: Jul 6, 2026 License: Apache-2.0

README

Fullsend

A living design document exploring fully autonomous agentic software development for GitHub-hosted organizations.

What is this?

This repo is a living design document exploring how to get from the current state of human-driven software development to a fully-agentic workflow with zero human intervention for routine changes. The goal is agents that can triage issues, implement solutions, review code, and merge to production autonomously — while being secure by design.

This is not a product spec. It's an evolving exploration of a hard problem space, applicable to any organization considering autonomous agents for their software development lifecycle. The problem documents are organization-agnostic; organization-specific considerations live in docs/problems/applied/.

What's here

How to contribute

Pick a problem area that interests you. Read the existing document. Add your perspective, propose solutions, poke holes in existing proposals. Open a PR.

If you want to run an experiment — try an agent workflow in a repo, test a security guardrail, prototype an intent system — document what you did and what you learned in https://github.com/fullsend-ai/experiments.

If you're applying fullsend to your own organization, consider adding your specific considerations to docs/problems/applied/ — your experience and feedback will strengthen the general problem documents.

Where does my contribution go?
If you have... Then...
A question, bug, or small suggestion File an issue — lowest friction, can graduate later.
A new problem area no existing doc covers Create a problem doc in docs/problems/ and link it here.
More to say about an existing problem area Expand the existing problem doc.
A specific decision that needs a yes-or-no answer Propose an ADR in docs/ADRs/ via a pull request (see ADR 0001).

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
internal
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.
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/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.
envfile
Package envfile provides a simple dotenv file parser.
Package envfile provides a simple dotenv file parser.
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.
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.
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/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.
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.
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.
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.
Package skill parses SKILL.md frontmatter for transitive dependency resolution.
statuscomment
Package statuscomment posts agent start/completion status comments on issues and pull requests via the forge abstraction.
Package statuscomment posts agent start/completion status comments on issues and pull requests via the forge abstraction.
telemetry
Package telemetry implements fullsend's Level 1 distributed tracing: a zero-config, metadata-only local baseline (per ADR 0050).
Package telemetry implements fullsend's Level 1 distributed tracing: a zero-config, metadata-only local baseline (per ADR 0050).
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.
mint module
mintcore module

Jump to

Keyboard shortcuts

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