Import the type, never the namespace

[StylianosGakis]

A structured way to catch these #3130 problems, by enforcing the import rule through a ktlint rule.

🤖 AI description:

States the import rule in CLAUDE.md and enforces it with a ktlint rule. #3130 below has already fixed every existing violation, so the tree is clean when this lands.

The rule. Import the type, never the namespace. An import may shorten a qualified reference only when the short name still says what it is to someone reading that line cold. HomeUiState.Success and Duration.Companion.seconds pass. Res.string and Clock.System do not: string.FOO names nothing, and System.now() reads as java.lang.System. The rule also bans import-only changes to lines you are not otherwise editing.

Why it needs writing down. PR #3100 was one screen refactor in one file, and most of its +250/-139 was not the refactor: 29 new imports and around 60 rewritten call sites shortening Res.string.FOO into string.FOO. The real change was buried under the churn, and the shortened forms read worse than what they replaced.

The check. A ktlint custom ruleset in the new hedvig-ktlint module, RuleSetProviderV3 against ktlint 1.8.0, the version kotlinter 5.6.0 bundles. Wired into every module through kotlinter's ktlint configuration, so it runs on every source set. Verified by planting a violation in design-system-hedvig: it reports in commonMain and iosMain, not only on Android and JVM modules.

Why ktlint rather than Android Lint. Android Lint would resolve the owner instead of inferring it from the shape of the import path, but it cannot see a KMP module at all, since AGP registers no lint task there (246751841), and the design system is where 19 of the violations lived. The commit message records the four workarounds tried before giving up on it. #3123 added Lint as a second mechanism and was closed as not worth maintaining the same policy twice.

The limitation is precision, not reach. Without type resolution, CAPITALIZED_PACKAGES has to exclude Kotlin/Native interop packages by prefix, because platform.Foundation.systemLocale is shaped exactly like a member import. That costs nothing today: platform.* appears in 8 files, all nativeMain, and the repo has no other capitalized-package member imports. The rule's KDoc records what a permanent fix would need, an analyzer that both resolves types and runs on every source set.

Star imports are deliberately not handled here; ktlint's own standard:no-wildcard-imports already owns them.

ktlintCheck reports zero namespace-import hits across every module and source set, and ./gradlew lint passes.