Description
The code path likely does more repeated computation or I/O than it should. src/routes/read.ts owns cursor-based reads and record ordering, but the current behavior does not yet define the contract tightly enough for safe maintenance. Design the change so the runtime path, tests, and docs all describe the same behavior.
Requirements and context
- Keep the contract specific to
src/routes/read.ts and its existing callers.
- Add coverage for the success path and the failure or boundary path relevant to this issue.
- Preserve compatibility where older callers or existing tests already rely on the current shape.
- Keep the change easy to review and small enough for one focused PR.
Suggested execution
Fork the repo and create a branch
git checkout -b read-contract-performance-16
Implement changes
- Update/Write:
src/routes/read.ts
- Write comprehensive tests:
src/routes/read.test.ts
- Add documentation:
docs/routes/read.md
- Keep any new helper names consistent with the rest of
src/
Test and commit
- Run
pnpm test
- Run
pnpm lint
- Add a note for any edge cases that are intentionally out of scope
Example commit message
perf: reduce repeated work in backend path
Guidelines
- WCAG 2.1 AA is not relevant here; keep the focus on correctness and maintainability.
- Prefer a narrow, well-documented fix over a broad refactor.
- Timeframe: 96 hours
Description
The code path likely does more repeated computation or I/O than it should.
src/routes/read.tsowns cursor-based reads and record ordering, but the current behavior does not yet define the contract tightly enough for safe maintenance. Design the change so the runtime path, tests, and docs all describe the same behavior.Requirements and context
src/routes/read.tsand its existing callers.Suggested execution
Fork the repo and create a branch
Implement changes
src/routes/read.tssrc/routes/read.test.tsdocs/routes/read.mdsrc/Test and commit
pnpm testpnpm lintExample commit message
perf: reduce repeated work in backend pathGuidelines