stax
Command reference

stax build-source

Build a cacheable workspace source artifact

Build a cacheable workspace source artifact from a Git repo or prepared directory tree.

Usage

stax build-source ./repo
stax build-source ./repo --git-url https://github.com/acme/backend.git --commit abc123
stax build-source ./repo --sparse services/api --sparse packages/shared

Options

FlagDescription
--git-urlAssociate a Git remote URL
--commitAssociate a specific commit hash
--sparseInclude only specific paths (repeatable)

Behavior

A conforming implementation SHOULD:

  • Strip .git/ and other VCS metadata
  • Record source metadata in the source artifact config blob
  • Emit a deterministic source snapshot layer

On this page