Phase 0 - ruby_api_pack_core Alignment and CI Modernization

[0.2.0] - 2026-07-12

Release Title: Phase 0 - ruby_api_pack_core Alignment and CI Modernization

Contract change type: breaking (internal only)

Added

• Added a runtime dependency on ruby_api_pack_core (~> 0.1), the new
  shared HTTP client foundation gem for all ruby_api_pack_* packs. All
  RubyApiPackActiveCampaign::Api::AcContacts methods now validate their
  response shape (expected_type: :hash) via
  RubyApiPackCore::Handlers::ResponseValidator, aligning this gem's
  response-shape validation with ruby_api_pack_wordpress and
  ruby_api_pack_cloudways.
• Added standardized PHCDevworks AI operating guides for shared agent behavior,
  Codex, Claude Code, Copilot, and Jules.
• Added roadmap and TODO planning documents for ActiveCampaign gem
  stabilization.
• Added Codex workspace notes and GitHub assistant instructions.
• Added a docs request issue template and standardized pull request template.

Changed

• Moved CI from GitHub Actions to CircleCI, running RSpec/RuboCop across Ruby
  3.3.4 and 3.4, storing JUnit test results, and uploading coverage/test
  reports to Codecov. Removed the now-redundant .github/workflows/test.yml
  and .github/workflows/codecov.yml, switched off the local path dependency
  for ruby_api_pack_core, added rspec_junit_formatter for CI reporting,
  updated the README CI badge, and raised the gem's required Ruby version to
  >= 3.3.0.
• Updated the RuboCop configuration's target Ruby version to 3.3 to match the
  raised baseline.
• Bumped actions/checkout from 4 to 7 in the RubyGems publish workflow
  (dependabot, #2),
  then updated that workflow's Ruby version to 3.3.4 (from 3.1) so release
  jobs run on the project's current Ruby version.
• Bumped development dependencies: rubocop to ~> 1.88, rubocop-performance
  to ~> 1.26, rubocop-rake to ~> 0.7.1, rubocop-rspec to ~> 3.10, and
  rake to ~> 13.4. Removed capybara, dotenv, factory_bot, faker,
  sqlite3, vcr, and webmock as unused development dependencies,
  superseding several open Dependabot PRs (#5-#16) that were closed as a
  result.
• Disabled the RSpec/DescribeClass cop for the string-based README version
  sync spec and switched its README row matcher to %r{} for cleaner
  escaping.
• Refreshed GitHub workflows with newer action versions and tighter
  permissions/concurrency, simplified .github/dependabot.yml, and
  normalized FUNDING.yml format. Raised the gem's minimum Ruby version to
  >= 3.1.0 to match the CI/runtime baseline (later superseded by the
  >= 3.3.0 bump above). Added .claude/settings.json and expanded Codex
  and Copilot agent guidance.
• Breaking (internal only): Rewrote
  RubyApiPackActiveCampaign::Connection::AcConnect to subclass
  RubyApiPackCore::Connection::Base, inheriting shared URL building,
  200..299 status handling, Oj-based JSON parsing with a content-type
  guard, and api_get/api_post/api_put/api_delete method names
  (renamed from ac_get_api_connection/ac_post_api_connection/
  ac_put_api_connection/ac_delete_api_connection). AcConnect now only
  implements #auth_headers. Public RubyApiPackActiveCampaign::Api::AcContacts
  method names are unchanged. This supersedes an earlier unreleased pass that
  added a gem-local handlers/response_validator.rb and ac_api_*-named
  connection methods — both are now delegated to ruby_api_pack_core instead.
• Removed the gem-local RubyApiPackActiveCampaign::Handlers::ResponseValidator
  module and the direct httparty/oj gemspec dependencies — both now come
  from ruby_api_pack_core.
• RubyApiPackActiveCampaign.configure/.configuration now come from
  RubyApiPackCore::Configurable instead of a gem-local implementation;
  behavior is unchanged.
• Reworked README, contributing, security, and issue guidance around this gem's
  ActiveCampaign client responsibilities.
• Corrected the README project identity from a Cloudways label to
  ruby_api_pack_active_campaign.
• Enabled explicit RuboCop new-cop handling and removed duplicate RSpec cop
  configuration.
• Added RubyGems MFA metadata and removed ActiveCampaign environment-variable
  output from the spec helper.
• Added bundler and github-actions ecosystem entries to
  .github/dependabot.yml (daily, 10 open-PR limit) to match the dependency
  hygiene used in phcdevworks_accounts_stytch and spectre-tokens — only
  devcontainers was previously configured, so Ruby gem and Actions
  dependencies never received automated update PRs.
• Added .coderabbit.yaml for automated PR review (RuboCop, gitleaks,
  markdownlint, actionlint, semgrep) with path instructions tailored to this
  gem's connection/API helper layers, matching the CodeRabbit setup used in
  phcdevworks_accounts_stytch and spectre-tokens.
• Added a deny block to .claude/settings.json blocking destructive
  commands (rm -rf, force-push, git reset --hard, git commit,
  gem yank, etc.), matching the guardrail committed in
  phcdevworks_accounts_stytch and spectre-tokens — this repo previously
  only had an allow list with no deny-list safety net.

Fixed

• Removed a stale Oj mention from SECURITY.md's dependency guidance now
  that the oj gem dependency is gone.

Removed

• Removed the unused oj runtime dependency and its require from the gem
  entry point; response parsing has always used JSON.parse in the
  connection wrapper.
• Removed a stray .github/workflows/main.yml CI workflow left over from
  bundler-gem scaffolding — it targeted a nonexistent master branch and
  duplicated test.yml.

Phase 0 - Initial ActiveCampaign Contacts API Client

[0.1.0] - 2024-10-28

Release Title: Phase 0 - Initial ActiveCampaign Contacts API Client

Contract change type: initial release

Added

• Initial release of ruby_api_pack_active_campaign, a Ruby client gem for
  the ActiveCampaign API.
• RubyApiPackActiveCampaign.configure/.configuration for setting the
  ActiveCampaign API URL and token.
• RubyApiPackActiveCampaign::Connection::AcConnect, an HTTParty-based
  connection wrapper handling authenticated GET/POST/PUT/DELETE requests and
  JSON response parsing.
• RubyApiPackActiveCampaign::Api::AcContacts, covering the full set of
  ActiveCampaign contacts endpoints (create, read, update, delete, and list
  operations).
• Full RSpec test suite with 100% code coverage via Codecov, plus RuboCop
  linting.
• README, issue templates, and CI/config setup for the initial public
  release.