feat: add dedicated slow query logging to ClickHouse adapter

[lohanidamodar]

Summary

• Adds purpose-built slow query logging methods to the ClickHouse adapter with a dedicated slow_queries table schema
• Schema uses native ClickHouse types (UInt32 for duration, UInt16 for status code, LowCardinality(String) for method/action/plan) instead of stuffing everything into a generic audit data JSON blob
• Includes a minmax skip-index on durationMs for efficient threshold-based filtering

Changes

• src/Audit/Adapter/ClickHouse.php:
  • Added setupSlowQueries() — creates {namespace}_slow_queries table with the dedicated schema
  • Added createSlowQuery(array $data) — type-safe insert for a single slow query row
  • Added findSlowQueries(?DateTime, ?DateTime, limit, offset) — time-range query with tenant isolation
  • Added cleanupSlowQueries(DateTime $before) — deletes rows older than a given date
  • Removed the $table constructor parameter (replaced by dedicated methods instead of generic table-swapping)

Slow queries table schema

id          String
time        DateTime64(3)
durationMs  UInt32
method      LowCardinality(String)
action      LowCardinality(String)
path        String
uri         String
hostname    String
projectId   String
userId      String
statusCode  UInt16
plan        LowCardinality(String)
ip          String
userAgent   String
data        String
-- + tenant Nullable(UInt64) when sharedTables is enabled
-- INDEX idx_duration durationMs TYPE minmax GRANULARITY 4
-- ORDER BY (time, id), PARTITION BY toYYYYMM(time)

Verification

• PHPStan (composer check): No errors
• Lint (composer lint): Pass

Test plan

• Verify setupSlowQueries() creates console_slow_queries and projects_slow_queries tables in ClickHouse
• Verify createSlowQuery() inserts a row with correct types (durationMs as UInt32, statusCode as UInt16)
• Verify findSlowQueries() returns results filtered by time range and tenant
• Verify cleanupSlowQueries() deletes rows older than the given datetime
• Verify existing audit table methods (setup(), create(), find()) are unaffected

[greptile-apps]

Greptile Summary

This PR's title and description state it adds setTable()/getTable() methods, but the actual diff instead introduces a full slow-query logging subsystem: setupSlowQueries(), createSlowQuery(), findSlowQueries(), cleanupSlowQueries(), and the getSlowQueryTableName() helper. The test-plan checkboxes in the description (which reference setTable/getTable) are therefore testing functionality that was not added. No setTable() or getTable() methods appear anywhere in the changeset or in the existing file.

The new methods follow established patterns in the adapter (identifier escaping, tenant filtering, namespace prefixing) and the implementation looks functionally correct. The one minor inconsistency is that cleanupSlowQueries binds its datetime as {datetime:String} while the new findSlowQueries correctly uses {after:DateTime64(3)}/{before:DateTime64(3)} for the same column type.

Confidence Score: 4/5

Safe to merge functionally, but the PR description should be corrected to accurately reflect the slow-query logging feature that was actually implemented.

The implementation follows the adapter's existing patterns and is functionally correct. The score is 4 rather than 5 because the PR title and description completely misrepresent the changes (claiming setTable/getTable when slow-query logging was actually added), which makes the PR difficult to review or reason about historically.

src/Audit/Adapter/ClickHouse.php — verify the slow-query feature is what was intended, and update the PR title/description accordingly.

Important Files Changed

Filename	Overview
src/Audit/Adapter/ClickHouse.php	Adds a complete slow-query logging subsystem (setupSlowQueries, createSlowQuery, findSlowQueries, cleanupSlowQueries) — PR title/description incorrectly describes this as adding setTable/getTable methods; minor DateTime parameter-type inconsistency between findSlowQueries and cleanupSlowQueries.

_{Reviews (3): Last reviewed commit: "feat: add dedicated slow query logging m..." | Re-trigger Greptile}