Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

2.0.0 - 2026-07-07

This entry consolidates everything between 1.0.0 and the current HEAD — including the feature flags module, the production hardening pass, the four Batteries migrations to Arrea (PostgreSQL, Redis, Memory, Disk), the Botica.Runner.* / Botica.Repair.Fixer additions, and the dialyzer fix in Batteries.Redis. Earlier 0.x versions are no longer maintained and have been collapsed into this single canonical 2.0.0 entry.

Added

• Botica.Flags — feature flags with ETS backend and deterministic per-entity rollouts. See Botica.Flags for full API.
• Botica.Flags.Store — GenServer that owns the ETS table.
• Botica.Flags.Flag — struct with timestamps + Flag.new/2 factory that clamps rollout to 0..100.
• Botica.Application — new OTP application that starts the supervisor tree (Botica.Flags.Store).
• Botica.Doctor.flags_summary/0 — [:count, :flags] snapshot.
• Botica.Doctor.format_flags_summary/0 — formatted banner for the Doctor's diagnostic output:

  Flags (3 defined):
    ✓ beta_search     enabled  (default: true)
    ✗ new_dashboard   disabled (default: false)
    ~ rate_limiting   rollout 25% (default: false)

• 12 defdelegates on the top-level Botica facade.
• Botica.Runner.Executor, Botica.Runner.Sequencer — orchestrate and run check sequences, with @max_default_concurrency as a Task.async_stream cap (DoS hardening).
• Botica.Repair.Fixer — fix-step runner that pairs with each check's :fix callback.
• Botica.Batteries.PostgreSQL — health check migrated to Arrea (BOTI-101). Uses Command.execute/2 and validates against empty-output edge cases.
• Botica.Batteries.Redis — health check migrated to Arrea (BOTI-102). Prefers redis-cli when available, falls back to Apero.Network.port_open?/3 for raw TCP probes.
• Botica.Batteries.Memory — health check migrated to Arrea (BOTI-103).
• Botica.Batteries.Disk — health check migrated to Arrea (BOTI-104). Forces LC_ALL=C so df parser always sees English column headers regardless of host locale.

Fixed

• Botica.Runner.Executor: was unbounded — Task.async_stream with no concurrency cap could spawn hundreds of workers on a large check list. Now capped at @max_default_concurrency.
• Botica.Batteries.PostgreSQL.check_connection/3 was matching on empty output (stdout == "") as a success case, which is impossible for a real psql invocation. Removed the impossible clause.
• Botica.Batteries.Redis.start_service/0 — the with statement used :ok <- try_start_commands(), but try_start_commands/0 always returns a 2-tuple ({:ok, _} | {:error, _}), never the bare atom :ok. Dialyzer flagged this as pattern_match The pattern can never match the type. The success branch was therefore unreachable; in the failure case the else clause caught the tuple but the runtime path was broken. Changed to {:ok, _} <- try_start_commands(). start_service/0 now correctly returns {:ok, "Redis service started"} when the service was successfully started.
• Botica.Runner.Executor — removed self-referencing alias that broke compilation.
• Botica.Runner.Executor decoupled from Arrea (uses Alaja facade instead) to avoid the dep cycle.
• Botica.Doctor — Task supervisor production hardening: sudo permission check before systemctl calls, lower default concurrency.
• source_ref in mix.exs now points to the canonical 2.0.0 tag (was 1.0.0). The dangling v prefix in the CHANGELOG footer was also dropped.

CI

• Multi-stage CI: format → credo → sobelow → test+coverage → dialyzer.
• workflow_dispatch added for manual re-runs.
• Sobelow step dropped (Phoenix-only scanner, false positives on libs).
• Credo --strict relaxed to match apero/candil config.

Tests

• 27 tests in test/botica/flags_test.exs covering define/enable/ disable/set/delete, rollout bucketing (deterministic, uniform distribution, 0% / 100% edges, for: ignored when rollout is nil), all/0 sorting, count/0, Flag struct (rollout clamping), and Doctor integration.
• 35 tests in test/botica/batteries_test.exs covering all four Batteries (PostgreSQL, Redis, Memory, Disk) — check + start_service paths.

1.0.0 - 2026-06-10

Added

• Initial open source release: feature flags, task supervisor.

A note on history

The git history of this repository was rewritten as part of a deliberate cleanup effort. The commits you can read describe the codebase as it stands today — they do not preserve the original chronology of development.

Anything worth keeping from before the rewrite was carried forward as tagged releases with explicit CHANGELOG.md entries. Anything not preserved is, by the maintainer's choice, no longer part of the canonical development line.

Tag 1.0.0 points to the initial open-source cut-over; tag 2.0.0 points to the current HEAD and the canonical consolidated release. All versioned artifacts on Hex.pm and GitHub Releases follow this convention.