Replace Enzyme snapshot tests with React Testing Library (RTL) behavioral tests in Foreman plugin projects. Use when converting snapshot tests for React 18 migration.

2026-04-283

investigate-bug

ianballou/cosmic-unconscious

Systematic approach to investigating software bugs

2026-04-203

ruby-rails

ianballou/cosmic-unconscious

Ruby on Rails conventions and patterns for Foreman ecosystem projects

2026-04-173

katello-testing

ianballou/cosmic-unconscious

Katello test patterns, factories, and conventions

2026-04-173

code-explorer

ianballou/cosmic-unconscious

How to navigate and explain unfamiliar codebases effectively

2026-04-173

name	katello-architecture
description	Katello codebase architecture and code flow patterns

Katello Architecture

Code Flow: API Request → Action → Pulp

Request hits controller (inherits Katello::Api::V2::ApiController)
Controller finds/authorizes resource via before_action
Controller calls sync_task or async_task to trigger a Dynflow action
Dynflow action interacts with Pulp 3 API
Action monitors Pulp task to completion
RABL template renders response

Key Model Domains

Content Views: ContentView, ContentViewVersion, ContentViewEnvironment
Repositories: Repository, RootRepository, Product
Environments: KTEnvironment (lifecycle environments)
Host Content: Host::ContentFacet
Errata: Erratum, ErratumPackage, ErratumCve

Conventions

New API endpoints: app/controllers/katello/api/v2/
New UI: React + PatternFly (webpack/), NOT AngularJS
Background jobs: Dynflow actions in app/lib/actions/katello/
Permissions: lib/katello/permissions/
API docs: Apipie annotations on controller methods

Gotchas

(Add entries as discovered)