Add workflow column filtering to cards

[robzolkos]

Summary

This adds column_ids[] filtering to GET /:account_slug/cards so API clients can ask the cards endpoint for cards in one or more workflow columns.

What wasn't possible before

Before this change, clients could:

• list cards from GET /:account_slug/cards and filter by board, tag, assignee, creator, search terms, etc.
• list cards from a single workflow column via GET /:account_slug/boards/:board_id/columns/:column_id/cards

But they could not ask the global cards endpoint for cards in specific workflow columns.

That meant clients wanting workflow-column filtering through /cards had to either:

• fetch a broader /cards result set and filter by column_id client-side, or
• switch to the board-scoped column endpoint, which is a different path shape and doesn't combine as cleanly with the general /cards filtering interface.

What this PR adds

• support column_ids[] on GET /:account_slug/cards
• apply column_ids[] when building the cards query
• document the new API behavior
• add model and controller coverage

Examples

• GET /:account_slug/cards?column_ids[]=03f...
• GET /:account_slug/cards?board_ids[]=...&column_ids[]=03f...
• GET /:account_slug/cards?column_ids[]=03f...&column_ids[]=03g...

[claude]

Claude Code Review

This pull request is from a fork — automated review is disabled. A repository maintainer can comment @claude review to run a one-time review.

[Copilot]

Pull request overview

This PR adds column_keys[] filtering support to cards, enabling CLI clients and API consumers to fetch cards from specific workflow columns or pseudo-columns (maybe, not_now, done) without downloading all cards client-side. The feature includes:

Changes:

• Add column_keys[] as a supported query parameter with support for workflow column IDs and pseudo-column aliases
• Normalize common aliases (e.g., maybe? → maybe, not-now → not_now, closed → done)
• OR multiple column_keys together while keeping other filters combined with AND
• Include column selections in filter summaries
• Normalize saved-filter parameters to ensure aliased and reordered column_keys resolve to equivalent filters
• Document the new API parameter and behavior
• Add comprehensive test coverage for model and controller behavior

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated no comments.

Show a summary per file

File	Description
app/models/filter/fields.rb	Added COLUMN_KEY_ALIASES mapping and normalize_column_key() class method; added column_keys store accessor with getter/setter for normalization
app/models/filter/params.rb	Extended PERMITTED_PARAMS to include column_keys; added normalize_param() to handle column key normalization with sorting/deduplication for filter equivalence
app/models/filter.rb	Added filter_by_column_keys() method to handle ORing of column key filters; updated include_closed_cards?() and include_not_now_cards?() to account for column key filters
app/models/filter/summarized.rb	Added SPECIAL_COLUMN_NAMES mapping and column_summary() method; added workflow_column_names_by_id() to fetch column names for display in filter summaries
docs/API.md	Documented new column_keys[] query parameter with supported values and examples
test/models/filter_test.rb	Added tests for column key filtering, normalization, aliasing, and filter equivalence
test/controllers/cards_controller_test.rb	Added integration tests for JSON API column key filtering

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.