workspace

type AliasConflictError struct {
	Alias        string
	ExistingPath string
}

type BitbucketGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type Candidate struct {
	Path              string `json:"path"`
	Name              string `json:"name"`
	GitRemote         string `json:"git_remote,omitempty"`
	GithubURL         string `json:"github_url,omitempty"`
	HasBC             bool   `json:"has_bc"`
	AlreadyRegistered bool   `json:"already_registered"`
}

type Config struct {
	User      UserConfig      `json:"user"`
	Providers ProvidersConfig `json:"providers"`
	Gateways  GatewaysConfig  `json:"gateways"`
	Runtime   RuntimeConfig   `json:"runtime"`
	Storage   StorageConfig   `json:"storage"`
	Server    ServerConfig    `json:"server"`
	Cron      CronConfig      `json:"cron"`
	Logs      LogsConfig      `json:"logs"`
	UI        UIConfig        `json:"ui"`
	Version   int             `json:"version"`
}

type CronConfig struct {
	PollIntervalSeconds int `json:"poll_interval_seconds"`
	JobTimeoutSeconds   int `json:"job_timeout_seconds"`
}

type DatadogGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type DiscordGatewayConfig struct {
	BotToken string `json:"bot_token"`
	Enabled  bool   `json:"enabled"`
}

type DiscoverOptions struct {
	// ScanPaths additional paths to scan for workspaces
	ScanPaths []string
	// MaxDepth maximum directory depth to scan (default 3)
	MaxDepth int
	// IncludeCached includes workspaces from the global registry (~/.bc/workspaces.json)
	IncludeCached bool
	// ScanHome scans ~/Projects and ~/Developer directories
	ScanHome bool
}

type DiscoveredWorkspace struct {
	Path      string // Absolute path to workspace root
	Name      string // Workspace name (from config or directory name)
	IsV2      bool   // True if v2 (TOML) workspace
	FromCache bool   // True if found in registry (not disk scan)
}

type DockerRuntimeConfig struct {
	ExtraMounts      []string `json:"extra_mounts"`
	Image            string   `json:"image"`
	Network          string   `json:"network"`
	DockerSocketPath string   `json:"docker_socket_path"`
	MemoryMB         int64    `json:"memory_mb"`
	CPUs             float64  `json:"cpus"`
}

type FeishuGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type GatewaysConfig struct {
	// Telegram is the single default Telegram bot (key "telegram").
	// Deprecated: prefer Telegrams map for multi-bot setups.
	Telegram *TelegramGatewayConfig `json:"-"`
	Discord  *DiscordGatewayConfig  `json:"discord,omitempty"`
	Slack    *SlackGatewayConfig    `json:"slack,omitempty"`
	// Telegrams holds zero or more Telegram bots keyed by label.
	// A plain "telegram" key is stored under label "".
	Telegrams map[string]*TelegramGatewayConfig `json:"-"`
	// GitHubs holds zero or more GitHub webhook configs keyed by label.
	// A plain "github" key is stored under label "".
	GitHubs map[string]*GitHubGatewayConfig `json:"-"`
	// Webhooks holds zero or more generic webhook configs keyed by label.
	// A plain "webhook" key is stored under label "".
	Webhooks map[string]*WebhookGatewayConfig `json:"-"`
	// RSSFeeds holds zero or more RSS/Atom feed configs keyed by label.
	// A plain "rss" key is stored under label "".
	RSSFeeds map[string]*RSSGatewayConfig `json:"-"`
	// GitLabs holds zero or more GitLab webhook configs keyed by label.
	GitLabs map[string]*GitLabGatewayConfig `json:"-"`
	// Jiras holds zero or more Jira webhook configs keyed by label.
	Jiras map[string]*JiraGatewayConfig `json:"-"`
	// Linears holds zero or more Linear webhook configs keyed by label.
	Linears map[string]*LinearGatewayConfig `json:"-"`
	// Sentries holds zero or more Sentry webhook configs keyed by label.
	Sentries map[string]*SentryGatewayConfig `json:"-"`
	// Stripes holds zero or more Stripe webhook configs keyed by label.
	Stripes map[string]*StripeGatewayConfig `json:"-"`
	// Bitbuckets holds zero or more Bitbucket webhook configs keyed by label.
	Bitbuckets map[string]*BitbucketGatewayConfig `json:"-"`
	// PagerDuties holds zero or more PagerDuty webhook configs keyed by label.
	PagerDuties map[string]*PagerDutyGatewayConfig `json:"-"`
	// Datadogs holds zero or more Datadog webhook configs keyed by label.
	Datadogs map[string]*DatadogGatewayConfig `json:"-"`
	// Grafanas holds zero or more Grafana webhook configs keyed by label.
	Grafanas map[string]*GrafanaGatewayConfig `json:"-"`
	// Vercels holds zero or more Vercel webhook configs keyed by label.
	Vercels map[string]*VercelGatewayConfig `json:"-"`
	// Netlifys holds zero or more Netlify webhook configs keyed by label.
	Netlifys map[string]*NetlifyGatewayConfig `json:"-"`
	// Notions holds zero or more Notion poll configs keyed by label.
	Notions map[string]*NotionGatewayConfig `json:"-"`
	// WhatsApps holds zero or more WhatsApp webhook configs keyed by label.
	WhatsApps map[string]*WhatsAppGatewayConfig `json:"-"`
	// Signals holds zero or more Signal poll configs keyed by label.
	Signals map[string]*SignalGatewayConfig `json:"-"`
	// Matrices holds zero or more Matrix poll configs keyed by label.
	Matrices map[string]*MatrixGatewayConfig `json:"-"`
	// MSTeams holds zero or more MS Teams webhook configs keyed by label.
	MSTeams map[string]*MSTeamsGatewayConfig `json:"-"`
	// GoogleChats holds zero or more Google Chat webhook configs keyed by label.
	GoogleChats map[string]*GoogleChatGatewayConfig `json:"-"`
	// Lines holds zero or more LINE webhook configs keyed by label.
	Lines map[string]*LineGatewayConfig `json:"-"`
	// Feishus holds zero or more Feishu webhook configs keyed by label.
	Feishus map[string]*FeishuGatewayConfig `json:"-"`
	// Mattermosts holds zero or more Mattermost webhook configs keyed by label.
	Mattermosts map[string]*MattermostGatewayConfig `json:"-"`
	// IRCs holds zero or more IRC socket configs keyed by label.
	IRCs map[string]*IRCGatewayConfig `json:"-"`
	// Nostrs holds zero or more Nostr socket configs keyed by label.
	Nostrs map[string]*NostrGatewayConfig `json:"-"`
	// Twitches holds zero or more Twitch webhook configs keyed by label.
	Twitches map[string]*TwitchGatewayConfig `json:"-"`
	// IMessages holds zero or more iMessage poll configs keyed by label.
	IMessages map[string]*IMessageGatewayConfig `json:"-"`
	// MQTTs holds zero or more MQTT socket configs keyed by label.
	MQTTs map[string]*MQTTGatewayConfig `json:"-"`
	// Twitters holds zero or more Twitter poll configs keyed by label.
	Twitters map[string]*TwitterGatewayConfig `json:"-"`
	// Reddits holds zero or more Reddit poll configs keyed by label.
	Reddits map[string]*RedditGatewayConfig `json:"-"`
	// HomeAssistants holds zero or more Home Assistant socket configs keyed by label.
	HomeAssistants map[string]*HomeAssistantGatewayConfig `json:"-"`
}

type GitHubGatewayConfig struct {
	Secret  string `json:"secret"`
	Enabled bool   `json:"enabled"`
}

type GitLabGatewayConfig struct {
	Token   string `json:"token"`
	Enabled bool   `json:"enabled"`
}

type GoogleChatGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type GrafanaGatewayConfig struct {
	Token   string `json:"token,omitempty"`
	Enabled bool   `json:"enabled"`
}

type HomeAssistantGatewayConfig struct {
	URL     string `json:"url"`
	Token   string `json:"token"`
	Enabled bool   `json:"enabled"`
}

type IMessageGatewayConfig struct {
	APIURL   string `json:"api_url"`
	Password string `json:"password"`
	Interval int    `json:"interval"` // seconds, default 10
	Enabled  bool   `json:"enabled"`
}

type IRCGatewayConfig struct {
	Server  string `json:"server"`
	Enabled bool   `json:"enabled"`
}

type JiraGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type LineGatewayConfig struct {
	Secret  string `json:"secret"`
	Enabled bool   `json:"enabled"`
}

type LinearGatewayConfig struct {
	Secret  string `json:"secret"`
	Enabled bool   `json:"enabled"`
}

type LogsConfig struct {
	Path     string `json:"path"`
	MaxBytes int64  `json:"max_bytes"`
}

type MQTTGatewayConfig struct {
	BrokerURL string `json:"broker_url"`
	Topic     string `json:"topic,omitempty"`
	Enabled   bool   `json:"enabled"`
}

type MSTeamsGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type MatrixGatewayConfig struct {
	Homeserver string `json:"homeserver"`
	Token      string `json:"token"`
	Interval   int    `json:"interval"` // seconds, default 10
	Enabled    bool   `json:"enabled"`
}

type MattermostGatewayConfig struct {
	Token   string `json:"token,omitempty"`
	Enabled bool   `json:"enabled"`
}

type NetlifyGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type NostrGatewayConfig struct {
	RelayURL string `json:"relay_url"`
	Enabled  bool   `json:"enabled"`
}

type NotionGatewayConfig struct {
	Token    string `json:"token"`
	Interval int    `json:"interval"` // seconds, default 300
	Enabled  bool   `json:"enabled"`
}

type PagerDutyGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type ProviderConfig struct {
	Command string `json:"command"`
}

type ProvidersConfig struct {
	Default   string                    `json:"default"`
	Providers map[string]ProviderConfig `json:"providers,omitempty"`
}

type RSSGatewayConfig struct {
	URL      string `json:"url"`
	Interval int    `json:"interval"` // seconds, default 300
	Enabled  bool   `json:"enabled"`
}

type RedditGatewayConfig struct {
	Subreddit   string `json:"subreddit"`
	BearerToken string `json:"bearer_token"`
	Interval    int    `json:"interval"` // seconds, default 60
	Enabled     bool   `json:"enabled"`
}

type Registry struct {
	Active     string          `json:"active,omitempty"` // Path or alias of active workspace
	Workspaces []RegistryEntry `json:"workspaces"`

	Version int `json:"version,omitempty"`
	// contains filtered or unexported fields
}

type RegistryEntry struct {
	CreatedAt      time.Time `json:"created_at"`
	LastAccessed   time.Time `json:"last_accessed,omitempty"` // legacy — mirrors LastUsedAt for backwards compat
	LastUsedAt     time.Time `json:"last_used_at,omitempty"`  // canonical timestamp (v2+)
	ID             string    `json:"id,omitempty"`            // stable 12-char hash of abs path (v2+)
	Path           string    `json:"path"`                    // project root (pristine git repo)
	DataDir        string    `json:"data_dir,omitempty"`      // runtime state dir (~/.bc/workspaces/<id>/); M11+
	Name           string    `json:"name"`
	Alias          string    `json:"alias,omitempty"`            // Short alias for quick access (#1218)
	GithubURL      string    `json:"github_url,omitempty"`       // Optional GitHub remote URL (v2+)
	GithubFullName string    `json:"github_full_name,omitempty"` // Optional GitHub owner/repo (v2+)
}

type Repo struct {
	FullName      string `json:"full_name"`
	Name          string `json:"name"`
	CloneURL      string `json:"clone_url"`
	SSHURL        string `json:"ssh_url"`
	HTMLURL       string `json:"html_url"`
	DefaultBranch string `json:"default_branch"`
	Description   string `json:"description,omitempty"`
	Private       bool   `json:"private"`
}

type ResolvedRole struct {
	Settings     map[string]any    // Merged settings (child overrides parent)
	Rules        map[string]string // Merged rule files (child overrides parent)
	Agents       map[string]string // Merged agent templates
	Skills       map[string]string // Merged skill files
	Commands     map[string]string // Merged command files
	PromptStart  string            // Lifecycle: sent on agent start/restart
	Name         string            // Role name
	PromptStop   string            // Lifecycle: sent on agent stop
	PromptDelete string            // Lifecycle: sent on agent delete
	PromptCreate string            // Lifecycle: sent on agent create
	Prompt       string            // Merged prompt body (child + parent)
	Review       string            // REVIEW.md content
	Plugins      []string          // Unioned plugins from all ancestors
	Secrets      []string          // Unioned secret names from all ancestors
	MCPServers   []string          // Unioned MCP servers from all ancestors
	CLITools     []string          // Unioned CLI tools from all ancestors
	Description  string            // Human-readable role description
}

type Role struct {
	FilePath string       // Path to the role file
	Prompt   string       // Markdown body after frontmatter
	Metadata RoleMetadata // Parsed YAML frontmatter
}

type RoleManager struct {
	// contains filtered or unexported fields
}

type RoleMetadata struct {
	Settings     map[string]any    `yaml:"settings,omitempty"`      // Claude settings overrides (e.g., model, permissions)
	Rules        map[string]string `yaml:"rules,omitempty"`         // Rule files written to .claude/rules/*.md
	Agents       map[string]string `yaml:"agents,omitempty"`        // Agent templates written to .claude/agents/*.md
	Skills       map[string]string `yaml:"skills,omitempty"`        // Skill files written to .claude/skills/*.md
	Commands     map[string]string `yaml:"commands,omitempty"`      // Command files written to .claude/commands/*.md
	PromptStop   string            `yaml:"prompt_stop,omitempty"`   // Sent when agent is stopped
	PromptCreate string            `yaml:"prompt_create,omitempty"` // Sent when agent is created
	PromptStart  string            `yaml:"prompt_start,omitempty"`  // Sent when agent is started/restarted
	Name         string            `yaml:"name"`                    // Role name (e.g., "engineer", "manager")
	PromptDelete string            `yaml:"prompt_delete,omitempty"` // Sent when agent is deleted
	Description  string            `yaml:"description,omitempty"`   // Human-readable role description
	Review       string            `yaml:"review,omitempty"`        // REVIEW.md content for the role
	Plugins      []string          `yaml:"plugins,omitempty"`       // Claude Code plugins to install on agent start
	Secrets      []string          `yaml:"secrets,omitempty"`       // Secret names needed by MCP env vars
	MCPServers   []string          `yaml:"mcp_servers,omitempty"`   // MCP servers available to this role
	ParentRoles  []string          `yaml:"parent_roles,omitempty"`  // Roles to inherit from (capabilities, prompts)
	CLITools     []string          `yaml:"cli_tools,omitempty"`     // CLI tools expected in agent PATH (e.g., gh, aws, wrangler)
}

type RoleStore struct {
	// contains filtered or unexported fields
}

type RuntimeConfig struct {
	K8s     json.RawMessage     `json:"k8s,omitempty"` // future
	Default string              `json:"default"`       // "tmux" or "docker"
	Docker  DockerRuntimeConfig `json:"docker"`
	Tmux    TmuxRuntimeConfig   `json:"tmux"`
}

type SQLiteStorageConfig struct {
	Path string `json:"path"`
}

type ScanOptions struct {
	// SkipDirs additional directory basenames to exclude, merged with the
	// default SkipDirs list.
	SkipDirs map[string]struct{}
	// Root is the absolute directory to scan. Required.
	Root string
	// Depth bounds recursion relative to Root. Values <=0 use defaultDepth.
	// Values > maxDepth are clamped.
	Depth int
}

type SentryGatewayConfig struct {
	Secret  string `json:"secret"`
	Enabled bool   `json:"enabled"`
}

type ServerConfig struct {
	Host       string `json:"host"`
	CORSOrigin string `json:"cors_origin"`
	Port       int    `json:"port"`
}

type SignalGatewayConfig struct {
	APIURL   string `json:"api_url"`
	Interval int    `json:"interval"` // seconds, default 10
	Enabled  bool   `json:"enabled"`
}

type SlackGatewayConfig struct {
	BotToken string `json:"bot_token"`
	AppToken string `json:"app_token"`
	Mode     string `json:"mode"`
	Enabled  bool   `json:"enabled"`
}

type StorageConfig struct {
	Default   string                 `json:"default"` // "sqlite" or "timescale"
	SQLite    SQLiteStorageConfig    `json:"sqlite"`
	Timescale TimescaleStorageConfig `json:"timescale"`
}

type StripeGatewayConfig struct {
	Secret  string `json:"secret"`
	Enabled bool   `json:"enabled"`
}

type TelegramGatewayConfig struct {
	BotToken string `json:"bot_token"`
	Mode     string `json:"mode"`
	Enabled  bool   `json:"enabled"`
}

type TimescaleStorageConfig struct {
	Host     string `json:"host"`
	User     string `json:"user"`
	Password string `json:"password"`
	Database string `json:"database"`
	Port     int    `json:"port"`
}

type TmuxRuntimeConfig struct {
	SessionPrefix string `json:"session_prefix"`
	DefaultShell  string `json:"default_shell"`
	HistoryLimit  int    `json:"history_limit"`
}

type TwitchGatewayConfig struct {
	Secret  string `json:"secret"`
	Enabled bool   `json:"enabled"`
}

type TwitterGatewayConfig struct {
	BearerToken string `json:"bearer_token"`
	UserID      string `json:"user_id"`
	Interval    int    `json:"interval"` // seconds, default 60
	Enabled     bool   `json:"enabled"`
}

type UIConfig struct {
	Theme       string `json:"theme"`
	Mode        string `json:"mode"`
	DefaultView string `json:"default_view"`
}

type UserConfig struct {
	Name string `json:"name"`
}

type UserRCConfig struct {
	User     UserRCUserConfig     `json:"user"`
	Defaults UserRCDefaultsConfig `json:"defaults"`
	Tools    UserRCToolsConfig    `json:"tools"`
}

type UserRCDefaultsConfig struct {
	DefaultRole   string `json:"default_role,omitempty"`
	AutoStartRoot bool   `json:"auto_start_root,omitempty"`
}

type UserRCToolsConfig struct {
	Preferred []string `json:"preferred,omitempty"`
}

type UserRCUserConfig struct {
	Nickname string `json:"nickname,omitempty"`
}

type VercelGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type WebhookGatewayConfig struct {
	Secret  string `json:"secret,omitempty"`
	Enabled bool   `json:"enabled"`
}

type WhatsAppGatewayConfig struct {
	VerifyToken string `json:"verify_token"`
	Enabled     bool   `json:"enabled"`
}

type Workspace struct {
	Config      *Config      // JSON config
	RoleManager *RoleManager // Role file manager
	RootDir     string       // Project root directory (pristine git repo)
	DataDir     string       // Runtime state dir (~/.bc/workspaces/<id>/); set for M11+ layouts
	// contains filtered or unexported fields
}

type WorkspaceNotFoundError struct {
	Identifier string
}