✨ feat: generic --filter passthrough on sessions list, on tapes-client 0.5

[yeazelm]

🧍

🤖

Related to PCC-1280.

--filter key=value on sessions list. Repeatable flag mapping to ?key=value through the sealed sessions method's claimed-filter seam (CoreClient::call_with_claimed). Param names are data, not contract — a cassette claims them at admission — so claimed params from any cassette work without recompiling, and the declared-parameter refusal stays intact. An integration test pins that the discovery-generated cassette surface drives a labels-like cassette with zero compiled-in knowledge; no label noun is added.

The tapes-client loan, repaid. The workspace's temporary path override onto the sibling checkout returns to the registry form: tapes-client = { version = "0.5", ... }, resolved to 0.5.0 from crates.io. check-tapes-pins.sh passes with no override notice.

Fallout from 0.5.0's breaking removals. The typed search/export/skills surfaces left the client with the contract re-pin to tapes v0.39.0. tapesctl search and tapesctl export keep their routes, requests, and output unchanged, but now issue their calls directly against the cassette routes the retired methods had been rerouting to, through the transport's described-call seam; the response models and --detail grains move into the two commands. The coverage tables shrink to the operations the contract still declares.

Also folds a third current-stable clippy site (the upgrade probe tests' reap-poll) into the existing gate-green chore.

[linear-code]

PCC-1280

[greptile-apps]

Greptile Summary

The PR upgrades tapes-client to 0.5 and adds repeatable generic session filters using the client’s claimed-parameter channel.

• Reimplements search and export over direct cassette transport calls after removal of their typed client methods.
• Adds local search response and export-detail models while preserving command output behavior.
• Adds binary-level coverage for generic filter forwarding and runtime cassette discovery.
• Updates command documentation, contract coverage tables, and stable-Clippy cleanup.

Confidence Score: 5/5

The PR appears safe to merge, with no concrete changed-code failure established.

The new filter path, direct search decoding, and streaming export reconstruction are covered by focused request, response, and error-path tests, and no accepted blocking or non-blocking defect remains.

Important Files Changed

Filename	Overview
crates/tapesctl/src/api/mod.rs	Adds filter grammar parsing and forwards ordered claimed parameters through the sealed sessions-list operation.
crates/tapesctl/src/cli.rs	Adds the repeatable --filter KEY=VALUE sessions-list argument and documents its deployment-defined semantics.
crates/tapesctl/src/ports/search.rs	Replaces the removed typed search method with a direct cassette call and command-owned response models.
crates/tapesctl/src/ports/export.rs	Replaces the removed typed export method with a direct streaming cassette call and local detail validation.
crates/tapesctl/tests/filter_passthrough_integration.rs	Exercises the real binary to verify repeated filter forwarding, untouched JSON output, and discovery-only cassette commands.
Cargo.toml	Upgrades the registry-backed tapes-client dependency from the 0.4 to 0.5 series.
Cargo.lock	Resolves tapes-client to registry release 0.5.0.

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart LR
    A[CLI arguments] --> B{Command}
    B -->|sessions list| C[Parse repeatable filters]
    C --> D[Core call with claimed parameters]
    B -->|search| E[Build cassette Call]
    E --> F[Decode local search model]
    B -->|export| G[Build streaming cassette Call]
    G --> H[Stdout or output file]
    D --> I[Read API]
    F --> I
    H --> I

Loading

_{Reviews (1): Last reviewed commit: "🧹 chore: repay the tapes-client loan — ..." | Re-trigger Greptile}