Testing workflow changes

This guide explains how to test changes to Fullsend's GitHub Actions workflows, composite actions, and the CLI itself.

References

There are independent version reference inputs that control different parts of the system:

Input	Controls	Where set
@<ref> on uses:	Which reusable workflow YAML runs	The uses: line in the caller workflow
fullsend_version	Which fullsend CLI binary is installed	Passed as a with: input

When no release exists for fullsend_version, action.yml falls back to cloning and building from source at that ref (see the install-method=source path).

The standalone prioritize workflow normally leaves inference credential preparation to the CLI. With an explicit fullsend_version override and both GCP credentials supplied, it also runs GCP preparation for compatibility with older Vertex CLIs. OpenAI-only callers without GCP credentials skip this step.

If uses: and fullsend_version diverge, the workflows/agents and CLI diverge, potentially causing mismatch in behavior and failures.

Vendored installs (recommended for PR testing)

Install or re-install a test repository with --vendor to copy reusable workflows, actions, agent definitions, and the CLI binary from your checkout into its .fullsend/ directory:

go run ./cmd/fullsend github setup "$OWNER/$REPO" \
  --vendor \
  --fullsend-source "$PWD" \
  --mint-url "$MINT_URL"

After changing reusable workflows or agent content, re-run the same go run ./cmd/fullsend github setup "$OWNER/$REPO" command above, including --vendor and --fullsend-source "$PWD", to refresh the target repository's vendored files and workflow callers.

Runtime skips the upstream sparse checkout when .defaults/action.yml is present (vendored install) and stages content from .defaults/ instead.

See ADR 0047 for the full distribution model.

Layered installs: pin upstream ref

In layered mode (default), thin callers reference upstream reusable workflows at fullsend-ai/fullsend@main. To test a specific upstream ref without vendoring, change the uses: ref and matching with: inputs in the thin caller workflows.

Note: for forks, change the fullsend-ai/fullsend portion to point to your fork.

In your repository modify the dispatch job at .github/workflows/fullsend.yaml:

# .github/workflows/fullsend.yaml
jobs:
  dispatch:
    # [...]
    uses: fullsend-ai/fullsend/.github/workflows/reusable-dispatch.yml@<YOUR_BRANCH>
    with:
      # [...]
      fullsend_version: <YOUR_BRANCH>
      # [...]

Push the change and trigger a Fullsend action on the test repository: /fs-triage, /fs-code, or another agent command. Revert the references to the desired release or branch before deleting or rewriting the test ref.