config

package
v0.3.2 Latest Latest
Warning

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

Go to latest
Published: Sep 30, 2026 License: MIT Imports: 7 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

func GlobalPath

func GlobalPath() (string, error)

GlobalPath returns the user-level config path. XDG_CONFIG_HOME is honored when set (including on macOS); otherwise os.UserConfigDir is used, which gives %AppData% on Windows and ~/Library/Application Support on macOS.

Types

type Agent

type Agent struct {
	Command  []string `toml:"command"`
	Delivery string   `toml:"delivery"`
	Env      []string `toml:"env"`
}

Agent configures how prompts reach the agent process. Empty array/string means "not set" — later files cannot unset earlier values.

type Config

type Config struct {
	Spec         string        `toml:"spec"`
	SpecFiles    []string      `toml:"spec_files"`
	Notes        string        `toml:"notes"`
	Editor       []string      `toml:"editor"`
	Pager        []string      `toml:"pager"`
	AgentTimeout time.Duration `toml:"-"`
	Agent        Agent         `toml:"agent"`
	Prompts      Prompts       `toml:"prompts"`
	Verify       Verify        `toml:"verify"`
}

Config is the root configuration schema: spec file, agent settings, verification commands, and prompt overrides.

func Defaults

func Defaults() Config

Defaults returns the built-in configuration.

func Load

func Load(globalPath, projectPath string) (Config, error)

Load merges global (optional) then project (optional) files over Defaults: top-level keys from later files win; [agent]/[prompts]/[verify] keys merge individually; arrays replace wholesale. Missing files are skipped. An empty array/string means "not set" — later files cannot unset earlier values. Unknown keys are a parse error.

type Prompts

type Prompts struct {
	Draft    string `toml:"draft"`
	Baseline string `toml:"baseline"`
	Refine   string `toml:"refine"`
	Apply    string `toml:"apply"`
	Verify   string `toml:"verify"`
}

Prompts holds per-stage prompt overrides. Empty string means "not set" — later files cannot unset earlier values.

type Verify added in v0.2.0

type Verify struct {
	Commands [][]string    `toml:"commands"`
	Timeout  time.Duration `toml:"-"`
	Env      []string      `toml:"env"`
	Audit    bool          `toml:"audit"`
}

Verify configures the conformance checks run by `respex verify` and after `respex apply`. Empty Commands means "not set" — later files cannot unset earlier values, and with no commands and audit disabled verification is off. Audit makes the configured agent audit conformance against the committed spec after the command checks pass; it is also off by default.

Jump to

Keyboard shortcuts

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