a39805aa89
Empty cli/ Go module with Factory + Options skeleton that all v0.x commands plug into. Foundation packages (10 internal/): - cmdutil: Factory(3 closure: Config/Client/Prompter) + Options + Errors with namespaced ErrorCode + typed predicates (IsAuthError / IsNotFound / IsTransient / IsAuthExpired) + Exporter + AddJSONFlags + ExitCode/PrintError - iostreams: package singleton with TTY detection; ColorEnabled honors NO_COLOR / TERM=dumb on demand - agent: mode + detect + annotations (Stripe pkg/useragent pattern; CLAUDECODE / CURSOR_AGENT / CODEX_* / AIDER_* / CONTINUE_* / OPENCODE_* / GEMINICODER env detection) - build: ldflags-injected version/commit/date - safepaths: separator-aware path-traversal protection - config: yaml.v3 schema + atomic save 0600 (XDG-style) - format: success/failure envelope (code/hint/request_id/risk/retryable/ console_url) with typed RiskLevel - prompt: Prompter interface + AgentPrompter (rejects in agent mode) - secrets: file 0600 store with weknora:<context>:<key> namespace - testutil: XDGTempDir(t) test helper Smoke command: weknora version (-/--json). Build/test/vet matrix in .github/workflows/cli.yml across linux x macos x windows x Go 1.24. Factory.Client returns CodeLocalUnimplemented until PR-3 wires the SDK adapter; PR-1 commands (version) don't need it.
107 lines
3.4 KiB
Go
107 lines
3.4 KiB
Go
// Package config reads and writes the user-level config at
|
|
// $XDG_CONFIG_HOME/weknora/config.yaml. yaml.v3 directly; viper is intentionally
|
|
// not used (see ADR-2).
|
|
//
|
|
// v0.0 supports only Load/Save with multi-host context map; project link
|
|
// (.weknora/project.toml) is wired in v0.2 (ADR-16).
|
|
package config
|
|
|
|
import (
|
|
"errors"
|
|
"fmt"
|
|
"os"
|
|
"path/filepath"
|
|
|
|
"gopkg.in/yaml.v3"
|
|
)
|
|
|
|
// Config is the on-disk schema. Empty zero-value is valid (returned when the
|
|
// file does not exist) so commands like --help / version don't fail.
|
|
type Config struct {
|
|
CurrentContext string `yaml:"current_context,omitempty"`
|
|
Contexts map[string]Context `yaml:"contexts,omitempty"`
|
|
|
|
// Defaults holds CLI-wide defaults; fields opt-in.
|
|
Defaults struct {
|
|
Format string `yaml:"format,omitempty"`
|
|
NoVersionCheck bool `yaml:"no_version_check,omitempty"`
|
|
RequestIDPrefix string `yaml:"request_id_prefix,omitempty"`
|
|
} `yaml:"defaults,omitempty"`
|
|
}
|
|
|
|
// Context is one named connection target (host + tenant + credential reference).
|
|
type Context struct {
|
|
Host string `yaml:"host"`
|
|
TenantID uint64 `yaml:"tenant_id,omitempty"`
|
|
User string `yaml:"user,omitempty"`
|
|
APIKeyRef string `yaml:"api_key_ref,omitempty"` // keychain://... or file://...
|
|
TokenRef string `yaml:"token_ref,omitempty"` // keychain://... or file://...
|
|
RefreshRef string `yaml:"refresh_token_ref,omitempty"`
|
|
DefaultKBID string `yaml:"default_kb_id,omitempty"`
|
|
}
|
|
|
|
// ErrCorrupt is returned by Load when the file exists but cannot be parsed.
|
|
// Callers should map this to error code "local.config_corrupt".
|
|
var ErrCorrupt = errors.New("config: file is malformed")
|
|
|
|
// Path returns the absolute config file path.
|
|
//
|
|
// We honor XDG_CONFIG_HOME on every OS (CLI convention — gh, kubectl, helm
|
|
// all do this even on macOS, where os.UserConfigDir would otherwise return
|
|
// ~/Library/Application Support). Falls back to ~/.config/weknora.
|
|
func Path() (string, error) {
|
|
if x := os.Getenv("XDG_CONFIG_HOME"); x != "" {
|
|
return filepath.Join(x, "weknora", "config.yaml"), nil
|
|
}
|
|
home, err := os.UserHomeDir()
|
|
if err != nil {
|
|
return "", fmt.Errorf("locate home dir: %w", err)
|
|
}
|
|
return filepath.Join(home, ".config", "weknora", "config.yaml"), nil
|
|
}
|
|
|
|
// Load reads the config file. If it does not exist, returns a zero-value
|
|
// Config with no error (commands like `version` and `--help` must not fail
|
|
// just because the user has not run `auth login` yet).
|
|
func Load() (*Config, error) {
|
|
p, err := Path()
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
data, err := os.ReadFile(p)
|
|
if errors.Is(err, os.ErrNotExist) {
|
|
return &Config{}, nil
|
|
}
|
|
if err != nil {
|
|
return nil, fmt.Errorf("read config: %w", err)
|
|
}
|
|
var c Config
|
|
if err := yaml.Unmarshal(data, &c); err != nil {
|
|
return nil, fmt.Errorf("%w: %v", ErrCorrupt, err)
|
|
}
|
|
return &c, nil
|
|
}
|
|
|
|
// Save writes the config atomically (write temp + rename) with mode 0600.
|
|
func Save(c *Config) error {
|
|
p, err := Path()
|
|
if err != nil {
|
|
return err
|
|
}
|
|
if err := os.MkdirAll(filepath.Dir(p), 0o700); err != nil {
|
|
return fmt.Errorf("mkdir config dir: %w", err)
|
|
}
|
|
data, err := yaml.Marshal(c)
|
|
if err != nil {
|
|
return fmt.Errorf("marshal config: %w", err)
|
|
}
|
|
tmp := p + ".tmp"
|
|
if err := os.WriteFile(tmp, data, 0o600); err != nil {
|
|
return fmt.Errorf("write config: %w", err)
|
|
}
|
|
if err := os.Rename(tmp, p); err != nil {
|
|
return fmt.Errorf("rename config: %w", err)
|
|
}
|
|
return nil
|
|
}
|