state

Documentation

Index

• func BaseDir(homeDir string) string
• func ClearInstallStatus(homeDir string) error
• func CommunitySkillsDir(homeDir string) string
• func EnsureDir(homeDir string) error
• func InstallStatusPath(homeDir string) string
• func ListCommunitySkills(homeDir string) []string
• func LoadOpenCodeModels(homeDir string) (model.OpenCodeModelAssignments, error)
• func LoadProfiles(homeDir string) ([]model.Profile, error)
• func LockPath(homeDir string) string
• func ProfilesPath(homeDir string) string
• func Save(homeDir string, s State) error
• func SaveInstallStatus(homeDir string, status InstallStatus) error
• func SaveLock(homeDir string, lock Lockfile) error
• func SaveOpenCodeModels(homeDir string, assignments model.OpenCodeModelAssignments) error
• func SaveProfiles(homeDir string, profiles []model.Profile) error
• func SharedPromptsDir(homeDir string) string
• func SharedSkillsDir(homeDir string) string
• func StatePath(homeDir string) string
• type InstallStatus
  • func LoadInstallStatus(homeDir string) (*InstallStatus, error)
• type Lockfile
  • func LoadLock(homeDir string) (Lockfile, error)
• type State
  • func Load(homeDir string) (State, error)

Functions

func BaseDir

func BaseDir(homeDir string) string

BaseDir returns the path to the cortex-ia home directory (~/.cortex-ia/).

func ClearInstallStatus

func ClearInstallStatus(homeDir string) error

ClearInstallStatus removes the install status file, indicating a clean state.

func CommunitySkillsDir

func CommunitySkillsDir(homeDir string) string

CommunitySkillsDir returns the path to community skills.

func EnsureDir

func EnsureDir(homeDir string) error

EnsureDir creates the cortex-ia base directory and its core subdirectories (skills, prompts) if they do not already exist.

func InstallStatusPath

func InstallStatusPath(homeDir string) string

InstallStatusPath returns the path to the install status file.

func ListCommunitySkills

func ListCommunitySkills(homeDir string) []string

ListCommunitySkills returns the names of installed community skills. A directory is considered a skill if it contains a SKILL.md file.

func LoadOpenCodeModels

func LoadOpenCodeModels(homeDir string) (model.OpenCodeModelAssignments, error)

LoadOpenCodeModels reads OpenCode model assignments from ~/.cortex-ia/opencode-models.json.

func LoadProfiles

func LoadProfiles(homeDir string) ([]model.Profile, error)

LoadProfiles reads saved profiles from disk. Returns nil, nil when the file does not exist yet.

func LockPath

func LockPath(homeDir string) string

LockPath returns the path to the lock file.

func ProfilesPath

func ProfilesPath(homeDir string) string

ProfilesPath returns the path to the profiles file.

func Save

func Save(homeDir string, s State) error

Save writes the state file.

func SaveInstallStatus

func SaveInstallStatus(homeDir string, status InstallStatus) error

SaveInstallStatus writes the install status file.

func SaveLock

func SaveLock(homeDir string, lock Lockfile) error

SaveLock writes the lock file.

func SaveOpenCodeModels

func SaveOpenCodeModels(homeDir string, assignments model.OpenCodeModelAssignments) error

SaveOpenCodeModels writes OpenCode model assignments to ~/.cortex-ia/opencode-models.json.

func SaveProfiles

func SaveProfiles(homeDir string, profiles []model.Profile) error

SaveProfiles writes profiles to disk, creating the directory if needed.

func SharedPromptsDir

func SharedPromptsDir(homeDir string) string

SharedPromptsDir returns the shared prompts directory (~/.cortex-ia/prompts/).

func SharedSkillsDir

func SharedSkillsDir(homeDir string) string

SharedSkillsDir returns the shared skills directory for all agents (~/.cortex-ia/skills/).

func StatePath

func StatePath(homeDir string) string

StatePath returns the path to the state file.

Types

type InstallStatus

type InstallStatus struct {
	Status    string `json:"status"`              // "in-progress" or "complete"
	StartedAt string `json:"started_at"`          // RFC3339 timestamp
	BackupID  string `json:"backup_id,omitempty"` // backup created before this install
}

InstallStatus tracks whether an installation completed cleanly. If the process crashes or a component fails mid-way, the status remains "in-progress" so that doctor/repair can detect it.

func LoadInstallStatus

func LoadInstallStatus(homeDir string) (*InstallStatus, error)

LoadInstallStatus reads the install status file. Returns nil if the file does not exist (meaning no install is in progress and none was left dirty).

type Lockfile

type Lockfile struct {
	InstalledAgents []model.AgentID     `json:"installed_agents"`
	Preset          model.PresetID      `json:"preset,omitempty"`
	Components      []model.ComponentID `json:"components,omitempty"`
	Files           []string            `json:"files,omitempty"`
	GeneratedAt     time.Time           `json:"generated_at"`
	LastBackupID    string              `json:"last_backup_id,omitempty"`
	Version         string              `json:"version,omitempty"`
}

Lockfile captures the concrete installed artifact set for verification and repair.

func LoadLock

func LoadLock(homeDir string) (Lockfile, error)

LoadLock reads the lock file. Returns empty lock if not found.

type State

type State struct {
	InstalledAgents []model.AgentID     `json:"installed_agents"`
	Preset          model.PresetID      `json:"preset,omitempty"`
	Components      []model.ComponentID `json:"components,omitempty"`
	LastInstall     time.Time           `json:"last_install"`
	LastBackupID    string              `json:"last_backup_id,omitempty"`
	Version         string              `json:"version,omitempty"`
	LastProfile     string              `json:"last_profile,omitempty"`
	StrictTDD       bool                `json:"strict_tdd,omitempty"`
}

State tracks what cortex-ia has installed.

func Load

func Load(homeDir string) (State, error)

Load reads the state file. Returns empty state if not found.