fix(exports): discriminate file-level from symbol-level consumer entries

[carlos-alm]

Summary

consumers[] entries returned by exportsData (used by the codegraph exports CLI and the file_exports MCP tool) conflated two different shapes under one struct:

• a real caller (calls edge — source is a function/method/class node, line is a genuine call-site), and
• a whole-file import type { X } reference (imports-type edge — source is the importing file node itself, line is always 0 since there's no calling symbol).

Renderers had no way to distinguish them, so a type-only import showed up looking like a real call-site, e.g. consumer.ts (consumer.ts:0) instead of someFunction (consumer.ts:42).

Deferred from #1814's review (originally raised by Greptile), tracked as #1830.

Fix

• src/domain/analysis/exports.ts — exportsData's consumer query now also selects the source node's kind; each consumers[] entry gets a consumerKind: 'file' | 'symbol' discriminator derived from it.
• src/types.ts — added FileExportConsumer documenting the two shapes; FileExportEntry.consumers now uses it.
• src/presentation/queries-cli/exports.ts — codegraph exports now renders file-level entries as <file> (type-only import) instead of fabricating a :0 call-site line.
• docs/examples/MCP.md — documented the new consumerKind field for file_exports.

Tests

• tests/integration/exports.test.ts — asserts real callers get consumerKind: 'symbol'; the existing import type regression (codegraph exports/dead-role consumer counting ignores type-only (import type) usages #1724) now also asserts consumerKind: 'file'.
• tests/presentation/queries-cli.test.ts — new case asserting the CLI renders consumer.ts (type-only import) and never a fabricated consumer.ts:0.

Out of scope

Filed #1973: the same imports-type/calls conflation exists in checkNoDeletedExportsInUse (src/features/check.ts / src/presentation/check.ts), a separate CI-predicate output surface — left for a follow-up PR.

Fixes #1830

Test plan

• npx vitest run tests/integration/exports.test.ts tests/presentation/queries-cli.test.ts — pass
• npm test — full suite green (228 test files, 3763 passed, 30 skipped, 2 todo)
• npm run lint / npx tsc --noEmit — clean
• codegraph diff-impact --staged -T — impact confined to exports.ts and its direct callers, as expected

[greptile-apps]

Greptile Summary

This PR separates file-level type imports from real symbol consumers in export reporting. The main changes are:

• Adds consumerKind to exportsData consumer entries.
• Renders type-only imports in the CLI without a fake :0 call-site.
• Updates exported types, MCP docs, and regression tests for both consumer shapes.

Confidence Score: 5/5

This looks safe to merge.

• No blocking issues found in the changed code.

Important Files Changed

Filename	Overview
src/domain/analysis/exports.ts	Adds sourceKind to the consumer query and maps it into the new consumerKind discriminator.
src/presentation/queries-cli/exports.ts	Formats file-level type imports separately from symbol-level call-site consumers.
src/types.ts	Adds the FileExportConsumer shape and uses it for FileExportEntry.consumers.
docs/examples/MCP.md	Documents the new consumerKind field in file_exports output.
tests/integration/exports.test.ts	Covers symbol-level callers and file-level import type consumers.
tests/presentation/queries-cli.test.ts	Checks that the CLI prints type-only imports without consumer.ts:0.

_{Reviews (1): Last reviewed commit: "fix(exports): discriminate file-level fr..." | Re-trigger Greptile}

[github-actions]

Codegraph Impact Analysis

11 functions changed → 9 callers affected across 3 files

• exportsFileImpl in src/domain/analysis/exports.ts:146 (3 transitive callers)
• buildSymbolResult in src/domain/analysis/exports.ts:206 (4 transitive callers)
• ExportConsumer.consumerKind in src/presentation/queries-cli/exports.ts:14 (0 transitive callers)
• formatConsumer in src/presentation/queries-cli/exports.ts:18 (6 transitive callers)
• printExportSymbols in src/presentation/queries-cli/exports.ts:73 (2 transitive callers)
• printReexportSymbol in src/presentation/queries-cli/exports.ts:98 (3 transitive callers)
• FileExportEntry.consumers in src/types.ts:2027 (0 transitive callers)
• FileExportConsumer.name in src/types.ts:2041 (0 transitive callers)
• FileExportConsumer.file in src/types.ts:2042 (0 transitive callers)
• FileExportConsumer.line in src/types.ts:2043 (0 transitive callers)
• FileExportConsumer.consumerKind in src/types.ts:2044 (0 transitive callers)