Retracted: v0.1.0 published no binaries: its release run failed on macOS and Windows, and the publish job was correctly gated behind that failure. The tag is installable, but the release/release-decision.md inside it describes those two platforms as gated-but-not-yet-observed when the run that observed them had already failed. Retracted so a false platform claim is not selectable. The code itself is sound on linux/amd64. Use v0.1.1.

verify

package

v0.1.0 Latest Latest Go to latest Published: Aug 1, 2026 License: MIT Imports: 16 Imported by: 0

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/0xkhdr/specd-cli

Links

Open Source Insights

Documentation ¶

Rendered for

Index ¶

Constants
func CommandDigest(request Request) (string, error)
type Request
- func ParseCommand(authored string) (Request, error)
type Result
- func Run(ctx context.Context, request Request) (Result, error)

Constants ¶

View Source

const (
	DefaultTimeout     = 2 * time.Minute
	MaximumTimeout     = 10 * time.Minute
	DefaultOutputLimit = 32 * 1024
	MaximumOutputLimit = 1024 * 1024

	TimeoutExitCode     = 124
	ZeroMatchExitCode   = 126
	InterruptedExitCode = 130
)

Variables ¶

This section is empty.

Functions ¶

func CommandDigest ¶

func CommandDigest(request Request) (string, error)

CommandDigest returns the canonical identity of the exact argv or explicit shell command that Run will execute.

Types ¶

type Request ¶

type Request struct {
	Dir         string
	Argv        []string
	Shell       string
	Timeout     time.Duration
	OutputLimit int
}

func ParseCommand ¶

func ParseCommand(authored string) (Request, error)

ParseCommand preserves authored argv unless shell semantics are explicit.

type Result ¶

type Result struct {
	CommandDigest   string `json:"command_digest"`
	StartedAt       string `json:"started_at"`
	EndedAt         string `json:"ended_at"`
	ExitCode        int    `json:"exit_code"`
	Passed          bool   `json:"passed"`
	TimedOut        bool   `json:"timed_out"`
	Interrupted     bool   `json:"interrupted"`
	NonVacuous      bool   `json:"non_vacuous"`
	GoRunSelector   bool   `json:"go_run_selector"`
	ZeroMatch       bool   `json:"zero_match"`
	StdoutDigest    string `json:"stdout_digest"`
	StderrDigest    string `json:"stderr_digest"`
	StdoutExcerpt   string `json:"stdout_excerpt,omitempty"`
	StderrExcerpt   string `json:"stderr_excerpt,omitempty"`
	StdoutTruncated bool   `json:"stdout_truncated"`
	StderrTruncated bool   `json:"stderr_truncated"`
}

func Run ¶

func Run(ctx context.Context, request Request) (Result, error)

Source Files ¶

View all Source files

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