kb

type Bubble struct {
	// KBID is the immutable kb identifier from /api/v1/kb. Empty for
	// legacy rows that haven't been migrated into the kb table yet.
	KBID string

	// Type is the kb_type bucket. Legacy team rows synthesize KBTypeTeam;
	// legacy ledger rows synthesize KBTypeRepo. Unknown server values are
	// already collapsed to KBTypeUnknown by the kb client.
	Type api.KBType

	// Slug is the human-readable slug (kebab-case). Used as the secondary
	// dedup key together with Endpoint when neither KBID nor RepoID matches.
	Slug string

	// Name is the display name.
	Name string

	// ViewerRole is the caller's role on this bubble ("owner", "member",
	// "viewer"). Only kb-API rows populate this today.
	ViewerRole string

	// LocalPath is the on-disk checkout path. For kb-API rows this is the
	// canonical KBDir(kb_id); for legacy rows it's whatever path the
	// synthesizer reports (team context dir or ledger dir).
	LocalPath string

	// RepoURL is the git clone URL when known.
	RepoURL string

	// RepoID is the SageOx repo_id, populated for legacy ledger rows and
	// for kb-API rows when the server supplies it. Used as the secondary
	// dedup key.
	RepoID string

	// Endpoint is the SageOx API endpoint this row belongs to (normalized
	// via endpoint.NormalizeEndpoint). Used together with Slug as the
	// tertiary dedup key.
	Endpoint string

	// Source identifies which fan-out branch produced this row.
	Source Source

	// Legacy is true for synthesized rows from /api/v1/cli/repos and the
	// local ledger registry. kb-API rows have Legacy=false.
	Legacy bool
}

type KBSource interface {
	ListBubbles(ctx context.Context) ([]api.KB, error)
}

type LedgerSource interface {
	ListLedgers(ctx context.Context) ([]LegacyLedgerRow, error)
}

type LegacyLedgerRow struct {
	RepoID   string // SageOx repo_id (extracted from path or project config)
	Name     string // display name (typically the host repo's name)
	Slug     string // optional kebab-case slug
	LocalDir string // on-disk ledger checkout path
	Endpoint string // SageOx API endpoint this ledger is bound to
	URL      string // git clone URL when known (rare for legacy ledgers)
}

type LegacyTeamRow struct {
	TeamID   string // team_xxx — used as RepoID-equivalent for dedup
	Name     string
	Slug     string
	URL      string // git clone URL
	LocalDir string // on-disk team-context checkout (may be empty if not yet cloned)
}

type LegacyTeamSource interface {
	ListTeamContexts(ctx context.Context) (rows []LegacyTeamRow, endpoint string, err error)
}

type MergeResult struct {
	Bubbles  []Bubble
	Warnings []SourceWarning
}

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

type Source string

type SourceWarning struct {
	Source Source
	Err    string
}