feat: add filters and sorting to project insights

[gaspergrom]

Note

Medium Risk
Introduces dynamic ordering and pagination on a production query, which can change result ordering/shape and impact performance or error behavior if callers pass unexpected sort columns/values.

Overview
project_insights.pipe now supports an optional isLF filter and adds query-time sorting and pagination via new orderBy, orderDirection, pageSize, and page parameters.

The SQL adds a dynamic ORDER BY (defaulting to contributorCount) and applies LIMIT/OFFSET so callers can page through multi-project results instead of always returning the full set.

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

[github-actions]

⚠️ Jira Issue Key Missing

Your PR title doesn't contain a Jira issue key. Consider adding it for better traceability.

Example:

• feat: add user authentication (CM-123)
• feat: add user authentication (IN-123)

Projects:

• CM: Community Data Platform
• IN: Insights

Please add a Jira issue key to your PR title.

[github-actions]

⚠️ Jira Issue Key Missing

Your PR title doesn't contain a Jira issue key. Consider adding it for better traceability.

Example:

• feat: add user authentication (CM-123)
• feat: add user authentication (IN-123)

Projects:

• CM: Community Data Platform
• IN: Insights

Please add a Jira issue key to your PR title.

[github-actions]

⚠️ Jira Issue Key Missing

Your PR title doesn't contain a Jira issue key. Consider adding it for better traceability.

Example:

• feat: add user authentication (CM-123)
• feat: add user authentication (IN-123)

Projects:

• CM: Community Data Platform
• IN: Insights

Please add a Jira issue key to your PR title.

[CLAassistant]

Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
_{You have signed the CLA already but the status is still pending? Let us recheck it.}

[Copilot]

Pull request overview

Adds filtering, sorting, and pagination capabilities to the Tinybird project_insights endpoint to support more flexible querying of project insights data.

Changes:

• Added isLF filter parameter.
• Added dynamic orderBy / orderDirection sorting support.
• Added pageSize / page pagination via LIMIT and OFFSET.

---

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

[Copilot]

Pagination is now supported via LIMIT/OFFSET, but the ORDER BY only uses the user-selected sort column. If many rows share the same value for that column (e.g., contributorCount), page boundaries can be unstable/non-deterministic across requests. Consider adding a deterministic tiebreaker (e.g., slug or id) after the primary sort key so pagination is consistent.

Suggested change

	{% end %}
	{% end %},
	id ASC

[Copilot]

The DESCRIPTION says orderBy can sort by “any column”, and the query passes the request value directly into column(orderBy, ...). If a client supplies a non-existent or non-orderable column, the endpoint will error at runtime. Consider documenting an explicit list of supported orderBy values (like other list endpoints do) and/or enforcing an allowlist/fallback to the default when an unsupported value is provided.