Documentation
¶
Index ¶
- func LookupHomeEnv() (string, error)
- type Paths
- func (p *Paths) CLILog() string
- func (p *Paths) ConfigFile() string
- func (p *Paths) DB() string
- func (p *Paths) DaemonBootstrapLog() string
- func (p *Paths) DaemonLog() string
- func (p *Paths) EnsureDirs() error
- func (p *Paths) EvalDir() string
- func (p *Paths) EvidenceDir() string
- func (p *Paths) EvidenceRoot(configured string) string
- func (p *Paths) LaneHealthFile() string
- func (p *Paths) LockFile() string
- func (p *Paths) LogsDir() string
- func (p *Paths) ManagedServerLog() string
- func (p *Paths) PIDFile() string
- func (p *Paths) ProcTreesDir() string
- func (p *Paths) RepoDir(repoID string) string
- func (p *Paths) ReposDir() string
- func (p *Paths) Root() string
- func (p *Paths) RunEvidenceDir(configured, runID string) string
- func (p *Paths) RunLogDir(runID string) string
- func (p *Paths) ServerPIDsDir() string
- func (p *Paths) Socket() string
- func (p *Paths) TelemetryGateFile() string
- func (p *Paths) UpdateCheckFile() string
- func (p *Paths) ValidateEvidenceRoot(configured string) error
- func (p *Paths) WorktreeDir(repoID, runID string) string
- func (p *Paths) WorktreesDir() string
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func LookupHomeEnv ¶
Types ¶
type Paths ¶
type Paths struct {
// contains filtered or unexported fields
}
Paths provides access to all no-slop filesystem locations. The root defaults to ~/.no-mistakes but can be overridden via NS_HOME or its NM_HOME compatibility alias or by using WithRoot (for testing).
func (*Paths) ConfigFile ¶
func (*Paths) DaemonBootstrapLog ¶
DaemonBootstrapLog captures service-manager output before the daemon logger is ready, plus crash diagnostics written directly to stdout or stderr.
func (*Paths) EnsureDirs ¶
EnsureDirs creates all required directories under root.
func (*Paths) EvalDir ¶
EvalDir holds automatically collected local evaluation cases, shared object pools, and their separate registry. EnsureDirs leaves creation to collection and eval commands so disabling provenance and auto-capture creates no state.
func (*Paths) EvidenceDir ¶
EvidenceDir is the default root for test-evidence artifacts, keyed by run ID.
func (*Paths) EvidenceRoot ¶
EvidenceRoot resolves where run evidence is written, honoring an absolute test.evidence.local_root override.
func (*Paths) LaneHealthFile ¶
LaneHealthFile persists which configured agent lanes are quota-exhausted and when each recovers, so concurrent runs and later runs skip a dead lane instead of each paying an agent spawn to rediscover it.
func (*Paths) LockFile ¶
LockFile is the OS-level advisory lock used to enforce a single live daemon per NS_HOME (see the singleton lock in internal/daemon). Distinct from PIDFile, which is an informational record a live daemon writes for CLI/status consumers: LockFile is what actually prevents two daemons from ever running startup recovery or binding the socket concurrently for the same root.
func (*Paths) ManagedServerLog ¶
ManagedServerLog holds raw output from daemon-managed agent servers.
func (*Paths) ProcTreesDir ¶
ProcTreesDir holds one record per live command leader so a freshly started daemon can reap process trees a crashed predecessor left running.
This is the step/agent-subprocess counterpart to ServerPIDsDir, which only covers long-lived managed servers that write a PID file of their own.
func (*Paths) RunEvidenceDir ¶
RunEvidenceDir is the evidence directory for a single run.
func (*Paths) ServerPIDsDir ¶
ServerPIDsDir holds PID-tracking files for managed agent servers (opencode, rovodev) so a freshly started daemon can reap orphans left behind by a crashed predecessor.
func (*Paths) TelemetryGateFile ¶
TelemetryGateFile persists the read-surface telemetry dedupe state so high-frequency status polling stays rate-limited across CLI processes.
func (*Paths) UpdateCheckFile ¶
func (*Paths) ValidateEvidenceRoot ¶
ValidateEvidenceRoot rejects configured evidence roots inside managed worktrees.