feat(partition): add :table mode for :processing_batch_size option

[cabol]

Allow passing the ETS table directly to the processor instead of reading and batching internally. When :processing_batch_size is set to :table, the processor receives the table name and has full control over how to read and process the data. The processor can optionally keep the table for later processing via :ets.rename/2 + :ets.give_away/3.

Also includes ASCII data flow diagrams in module docs, CI migration to GitHub Actions, and minor documentation fixes.

Closes #14

---

Note

Medium Risk
Changes the core partition processing path to optionally hand off the raw ETS table to user code and alters table-lifecycle semantics (including conditional deletion), which could affect processing correctness and resource cleanup if misused. CI and tooling updates are low risk but broaden supported Elixir/OTP versions and release metadata.

Overview
Adds a new :table mode for :processing_batch_size so processors can receive the handed-off ETS table name directly (instead of batched :ets.select results), enabling custom read/processing strategies and optional table retention via :ets.rename/2 + :ets.give_away/3.

Updates PartitionedBuffer.Partition to support the new mode and to only delete the handed-off table if it still exists under its original name, with new tests covering both Queue and Map behaviors.

Also bumps version to 0.4.0, expands option docs and module docs with ASCII flow diagrams, adds repo-specific agent/usage-rules files + usage_rules dev dependency, loosens the minimum Elixir requirement to ~> 1.17, and migrates CI from CircleCI to GitHub Actions (matrix across Elixir/OTP with caching, lint, coverage, and dialyzer).

^{Written by Cursor Bugbot for commit e0ec13f. This will update automatically on new commits. Configure here.}

[cursor]

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Bugbot Autofix prepared a fix for the issue found in the latest run.

• ✅ Fixed: Dialyzer step skipped when PLT cache exists
  • Updated the GitHub Actions condition so dialyzer runs whenever matrix.dialyzer is true while keeping PLT creation cache-gated.

Or push these changes by commenting:

@cursor push 17e96eaea8

Preview (17e96eaea8)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -121,4 +121,4 @@
 
       - name: Run dialyzer
         run: mix dialyzer --format github
-        if: ${{ matrix.dialyzer && steps.plt-cache.outputs.cache-hit != 'true' }}
+        if: ${{ matrix.dialyzer }}

_{This Bugbot Autofix run was free. To enable autofix for future PRs, go to the Cursor dashboard.}