docs(agents): clarify internal import ordering rule#9172
Conversation
Overall package sizeSelf size: 6.43 MB Dependency sizes| name | version | self size | total size | |------|---------|-----------|------------| | import-in-the-middle | 3.2.0 | 104.26 kB | 843.44 kB | | opentracing | 0.14.7 | 194.81 kB | 194.81 kB | | dc-polyfill | 0.1.11 | 25.74 kB | 25.74 kB |🤖 This report was automatically generated by heaviest-objects-in-the-universe |
|
BenchmarksBenchmark execution time: 2026-07-01 12:30:58 Comparing candidate commit 71c44c8 in PR branch Found 0 performance improvements and 0 performance regressions! Performance is the same for 2266 metrics, 20 unstable metrics.
|
Codecov Report✅ All modified and coverable lines are covered by tests. Additional details and impacted files@@ Coverage Diff @@
## master #9172 +/- ##
=======================================
Coverage 93.71% 93.72%
=======================================
Files 895 895
Lines 51324 51324
Branches 11947 11947
=======================================
+ Hits 48100 48101 +1
+ Misses 3224 3223 -1 Flags with carried forward coverage won't be shown. Click here to find out more. ☔ View full report in Codecov by Harness. 🚀 New features to boost your workflow:
|
What does this PR do?
Clarifies the internal import ordering rule in
AGENTS.md. The previous wording ("by path proximity, then alpha") was ambiguous, it didn't specify whether proximity meant closer-first or furthest-first, which is the opposite of what theimport/orderESLint rule enforces.Motivation
The ambiguity caused a lint failure in a separate PR: imports were written closer-first following an intuitive reading of "proximity", but the linter requires furthest-first. The updated wording makes the direction explicit and aligns with the actual ESLint configuration.
Additional Notes
The authoritative source remains ESLint configuration: the
import/orderrule groups parent paths (../) before sibling paths (./) by default, which is what "furthest first" reflects in practice.