Files
jhonny-editor/code/docs/recommendations/2026-08-18/15-paginated-project-discovery.md
T
João Henrique b541f502ba feat: initial commit - Jhonny Editor
- Adicionado estrutura completa do projeto
- Configurado MCP server para Premiere Pro
- Adicionado documentação e skills
- Configurado Gitignore para o projeto
2026-09-08 09:59:31 -04:00

1.1 KiB
Executable File

Recommendation 15: paginated project discovery

Evidence

Large Premiere projects can contain thousands of items. Returning an entire tree in one tool response increases host traversal time, MCP payload size, and model context. Adobe's Project API provides stable items; MCP tools can expose bounded cursors.

Proposed improvement

Add cursor-based, revision-locked project-item discovery with explicit page and field limits. Cursors should be opaque, authorization-scoped, short-lived, and invalidated when the project-index revision changes. Default fields exclude native paths.

Acceptance

  • Page size, response bytes, traversal time, and cursor count are bounded.
  • Changed projects return refresh_required rather than mixed-revision pages.
  • Duplicate names retain stable IDs and parent identity.
  • Tests cover expired, forged, cross-project, and cross-credential cursors.

Pagination depends on stable identity but not on undocumented QE behavior.