Skip to main content

fallow_types/
issue_meta.rs

1//! Shared issue-type contract metadata.
2
3use std::sync::LazyLock;
4
5use crate::suppress::IssueKind;
6#[path = "issue_meta_derived.rs"]
7mod derived;
8use derived::{dead_code_filter_flags_from_meta, known_issue_kind_names_from_meta};
9
10#[path = "issue_meta_kind_methods.rs"]
11mod kind_methods;
12
13/// Shared contract facts for issue-like diagnostics.
14///
15/// Curated prose stays with the surface that owns it. This table is only for
16/// stable machine-facing facts that otherwise drift across CLI schema, LSP,
17/// MCP, and suppression helpers.
18#[derive(Debug, Clone, Copy, PartialEq, Eq)]
19pub struct IssueKindMeta {
20    /// Backing suppression issue kind, when this row maps to one.
21    pub kind: Option<IssueKind>,
22    /// Canonical issue code used in output and diagnostic codes.
23    pub code: &'static str,
24    /// Accepted aliases for config, suppression, or migration compatibility.
25    pub aliases: &'static [&'static str],
26    /// User-facing label for editor and capability surfaces.
27    pub label: &'static str,
28    /// Canonical `[rules]` key when the issue is configurable.
29    pub config_key: Option<&'static str>,
30    /// Dead-code CLI filter flag, when one exists.
31    pub filter_flag: Option<&'static str>,
32    /// MCP `issue_types` selector, when this issue can be selected there.
33    pub mcp_issue_type: Option<&'static str>,
34    /// Suppression token agents should emit, when suppressible.
35    pub suppress_token: Option<&'static str>,
36    /// Whether the suppression comment should use `fallow-ignore-file`.
37    pub suppress_file_level: bool,
38    /// Whether the LSP exposes this row through initialization options and
39    /// `fallow/issueTypes`.
40    pub lsp: bool,
41    /// Broad documentation category for authoring and generated manifests.
42    pub docs_category: &'static str,
43}
44
45/// All shared issue metadata rows.
46pub const ISSUE_KIND_META: &[IssueKindMeta] = &[
47    IssueKindMeta {
48        kind: Some(IssueKind::CodeDuplication),
49        code: "code-duplication",
50        aliases: &[],
51        label: "Code Duplication",
52        config_key: None,
53        filter_flag: None,
54        mcp_issue_type: None,
55        suppress_token: Some("code-duplication"),
56        suppress_file_level: false,
57        lsp: true,
58        docs_category: "dupes",
59    },
60    IssueKindMeta {
61        kind: Some(IssueKind::UnusedFile),
62        code: "unused-file",
63        aliases: &[],
64        label: "Unused Files",
65        config_key: Some("unused-files"),
66        filter_flag: Some("--unused-files"),
67        mcp_issue_type: Some("unused-files"),
68        suppress_token: Some("unused-file"),
69        suppress_file_level: true,
70        lsp: true,
71        docs_category: "source",
72    },
73    IssueKindMeta {
74        kind: Some(IssueKind::UnusedExport),
75        code: "unused-export",
76        aliases: &[],
77        label: "Unused Exports",
78        config_key: Some("unused-exports"),
79        filter_flag: Some("--unused-exports"),
80        mcp_issue_type: Some("unused-exports"),
81        suppress_token: Some("unused-export"),
82        suppress_file_level: false,
83        lsp: true,
84        docs_category: "source",
85    },
86    IssueKindMeta {
87        kind: Some(IssueKind::UnusedType),
88        code: "unused-type",
89        aliases: &[],
90        label: "Unused Types",
91        config_key: Some("unused-types"),
92        filter_flag: Some("--unused-types"),
93        mcp_issue_type: Some("unused-types"),
94        suppress_token: Some("unused-type"),
95        suppress_file_level: false,
96        lsp: true,
97        docs_category: "source",
98    },
99    IssueKindMeta {
100        kind: Some(IssueKind::PrivateTypeLeak),
101        code: "private-type-leak",
102        aliases: &[],
103        label: "Private Type Leaks",
104        config_key: Some("private-type-leaks"),
105        filter_flag: Some("--private-type-leaks"),
106        mcp_issue_type: Some("private-type-leaks"),
107        suppress_token: Some("private-type-leak"),
108        suppress_file_level: false,
109        lsp: true,
110        docs_category: "source",
111    },
112    IssueKindMeta {
113        kind: Some(IssueKind::DeprecatedExportInUse),
114        code: "deprecated-export-in-use",
115        aliases: &[],
116        label: "Deprecated Exports in Use",
117        config_key: Some("deprecated-exports-in-use"),
118        filter_flag: Some("--deprecated-exports-in-use"),
119        mcp_issue_type: Some("deprecated-exports-in-use"),
120        suppress_token: Some("deprecated-export-in-use"),
121        suppress_file_level: false,
122        lsp: false,
123        docs_category: "source",
124    },
125    IssueKindMeta {
126        kind: Some(IssueKind::UnusedDependency),
127        code: "unused-dependency",
128        aliases: &[],
129        label: "Unused Dependencies",
130        config_key: Some("unused-dependencies"),
131        filter_flag: Some("--unused-deps"),
132        mcp_issue_type: Some("unused-deps"),
133        suppress_token: None,
134        suppress_file_level: false,
135        lsp: true,
136        docs_category: "dependency",
137    },
138    IssueKindMeta {
139        kind: Some(IssueKind::UnusedDevDependency),
140        code: "unused-dev-dependency",
141        aliases: &["unused-dev-deps", "unused-dev-dependencies"],
142        label: "Unused Dev Dependencies",
143        config_key: Some("unused-dev-dependencies"),
144        filter_flag: Some("--unused-deps"),
145        mcp_issue_type: None,
146        suppress_token: None,
147        suppress_file_level: false,
148        lsp: true,
149        docs_category: "dependency",
150    },
151    IssueKindMeta {
152        kind: None,
153        code: "unused-optional-dependency",
154        aliases: &["unused-optional-deps", "unused-optional-dependencies"],
155        label: "Unused Optional Dependencies",
156        config_key: Some("unused-optional-dependencies"),
157        filter_flag: Some("--unused-deps"),
158        mcp_issue_type: None,
159        suppress_token: None,
160        suppress_file_level: false,
161        lsp: true,
162        docs_category: "dependency",
163    },
164    IssueKindMeta {
165        kind: Some(IssueKind::UnusedEnumMember),
166        code: "unused-enum-member",
167        aliases: &[],
168        label: "Unused Enum Members",
169        config_key: Some("unused-enum-members"),
170        filter_flag: Some("--unused-enum-members"),
171        mcp_issue_type: Some("unused-enum-members"),
172        suppress_token: Some("unused-enum-member"),
173        suppress_file_level: false,
174        lsp: true,
175        docs_category: "source",
176    },
177    IssueKindMeta {
178        kind: Some(IssueKind::UnusedClassMember),
179        code: "unused-class-member",
180        aliases: &[],
181        label: "Unused Class Members",
182        config_key: Some("unused-class-members"),
183        filter_flag: Some("--unused-class-members"),
184        mcp_issue_type: Some("unused-class-members"),
185        suppress_token: Some("unused-class-member"),
186        suppress_file_level: false,
187        lsp: true,
188        docs_category: "source",
189    },
190    IssueKindMeta {
191        kind: Some(IssueKind::UnusedNamespaceMember),
192        code: "unused-namespace-member",
193        aliases: &["unused-namespace-members"],
194        label: "Unused Namespace Members",
195        config_key: Some("unused-namespace-members"),
196        filter_flag: Some("--unused-namespace-members"),
197        mcp_issue_type: Some("unused-namespace-members"),
198        suppress_token: Some("unused-namespace-member"),
199        suppress_file_level: false,
200        lsp: true,
201        docs_category: "source",
202    },
203    IssueKindMeta {
204        kind: Some(IssueKind::UnusedStoreMember),
205        code: "unused-store-member",
206        aliases: &["unused-store-members"],
207        label: "Unused Store Members",
208        config_key: Some("unused-store-members"),
209        filter_flag: Some("--unused-store-members"),
210        mcp_issue_type: Some("unused-store-members"),
211        suppress_token: Some("unused-store-member"),
212        suppress_file_level: false,
213        lsp: true,
214        docs_category: "framework",
215    },
216    IssueKindMeta {
217        kind: Some(IssueKind::UnresolvedImport),
218        code: "unresolved-import",
219        aliases: &[],
220        label: "Unresolved Imports",
221        config_key: Some("unresolved-imports"),
222        filter_flag: Some("--unresolved-imports"),
223        mcp_issue_type: Some("unresolved-imports"),
224        suppress_token: Some("unresolved-import"),
225        suppress_file_level: false,
226        lsp: true,
227        docs_category: "dependency",
228    },
229    IssueKindMeta {
230        kind: Some(IssueKind::UnlistedDependency),
231        code: "unlisted-dependency",
232        aliases: &[],
233        label: "Unlisted Dependencies",
234        config_key: Some("unlisted-dependencies"),
235        filter_flag: Some("--unlisted-deps"),
236        mcp_issue_type: Some("unlisted-deps"),
237        suppress_token: None,
238        suppress_file_level: false,
239        lsp: true,
240        docs_category: "dependency",
241    },
242    IssueKindMeta {
243        kind: Some(IssueKind::UnlistedBinary),
244        code: "unlisted-binary",
245        aliases: &[],
246        label: "Unlisted Binaries",
247        config_key: Some("unlisted-binaries"),
248        filter_flag: Some("--unlisted-binaries"),
249        mcp_issue_type: Some("unlisted-binaries"),
250        suppress_token: None,
251        suppress_file_level: false,
252        lsp: true,
253        docs_category: "dependency",
254    },
255    IssueKindMeta {
256        kind: Some(IssueKind::DuplicateExport),
257        code: "duplicate-export",
258        aliases: &[],
259        label: "Duplicate Exports",
260        config_key: Some("duplicate-exports"),
261        filter_flag: Some("--duplicate-exports"),
262        mcp_issue_type: Some("duplicate-exports"),
263        suppress_token: Some("duplicate-export"),
264        suppress_file_level: true,
265        lsp: true,
266        docs_category: "source",
267    },
268    IssueKindMeta {
269        kind: Some(IssueKind::DuplicateExportAlias),
270        code: "duplicate-export-alias",
271        aliases: &["duplicate-export-aliases"],
272        label: "Duplicate Export Aliases",
273        config_key: Some("duplicate-export-aliases"),
274        filter_flag: Some("--duplicate-export-aliases"),
275        mcp_issue_type: Some("duplicate-export-aliases"),
276        suppress_token: Some("duplicate-export-alias"),
277        suppress_file_level: true,
278        lsp: true,
279        docs_category: "source",
280    },
281    IssueKindMeta {
282        kind: Some(IssueKind::TypeOnlyDependency),
283        code: "type-only-dependency",
284        aliases: &[],
285        label: "Type-Only Dependencies",
286        config_key: Some("type-only-dependencies"),
287        filter_flag: Some("--unused-deps"),
288        mcp_issue_type: None,
289        suppress_token: None,
290        suppress_file_level: false,
291        lsp: true,
292        docs_category: "dependency",
293    },
294    IssueKindMeta {
295        kind: Some(IssueKind::TestOnlyDependency),
296        code: "test-only-dependency",
297        aliases: &[],
298        label: "Test-Only Dependencies",
299        config_key: Some("test-only-dependencies"),
300        filter_flag: Some("--unused-deps"),
301        mcp_issue_type: None,
302        suppress_token: None,
303        suppress_file_level: false,
304        lsp: true,
305        docs_category: "dependency",
306    },
307    IssueKindMeta {
308        kind: Some(IssueKind::DevDependencyInProduction),
309        code: "dev-dependency-in-production",
310        aliases: &[],
311        label: "Dev Dependencies Used in Production",
312        config_key: Some("dev-dependencies-in-production"),
313        filter_flag: Some("--unused-deps"),
314        mcp_issue_type: None,
315        suppress_token: None,
316        suppress_file_level: false,
317        lsp: true,
318        docs_category: "dependency",
319    },
320    IssueKindMeta {
321        kind: Some(IssueKind::CircularDependency),
322        code: "circular-dependency",
323        aliases: &["circular-dependencies"],
324        label: "Circular Dependencies",
325        config_key: Some("circular-dependencies"),
326        filter_flag: Some("--circular-deps"),
327        mcp_issue_type: Some("circular-deps"),
328        suppress_token: Some("circular-dependency"),
329        suppress_file_level: false,
330        lsp: true,
331        docs_category: "architecture",
332    },
333    IssueKindMeta {
334        kind: Some(IssueKind::ReExportCycle),
335        code: "re-export-cycle",
336        aliases: &["re-export-cycles", "reexport-cycle", "reexport-cycles"],
337        label: "Re-Export Cycles",
338        config_key: Some("re-export-cycle"),
339        filter_flag: Some("--re-export-cycles"),
340        mcp_issue_type: Some("re-export-cycles"),
341        suppress_token: Some("re-export-cycle"),
342        suppress_file_level: true,
343        lsp: true,
344        docs_category: "architecture",
345    },
346    IssueKindMeta {
347        kind: Some(IssueKind::PackageCycle),
348        code: "package-cycle",
349        aliases: &["package-cycles"],
350        label: "Package Cycles",
351        config_key: Some("package-cycle"),
352        filter_flag: Some("--package-cycles"),
353        mcp_issue_type: Some("package-cycles"),
354        suppress_token: Some("package-cycle"),
355        suppress_file_level: false,
356        lsp: true,
357        docs_category: "architecture",
358    },
359    IssueKindMeta {
360        kind: Some(IssueKind::BoundaryViolation),
361        code: "boundary-violation",
362        aliases: &[],
363        label: "Boundary Violations",
364        config_key: Some("boundary-violation"),
365        filter_flag: Some("--boundary-violations"),
366        mcp_issue_type: Some("boundary-violations"),
367        suppress_token: Some("boundary-violation"),
368        suppress_file_level: false,
369        lsp: true,
370        docs_category: "architecture",
371    },
372    IssueKindMeta {
373        kind: None,
374        code: "boundary-coverage",
375        aliases: &["boundary-coverage-violations"],
376        label: "Boundary Coverage",
377        config_key: Some("boundary-violation"),
378        filter_flag: Some("--boundary-violations"),
379        mcp_issue_type: None,
380        suppress_token: Some("boundary-violation"),
381        suppress_file_level: true,
382        lsp: false,
383        docs_category: "architecture",
384    },
385    IssueKindMeta {
386        kind: Some(IssueKind::BoundaryViolation),
387        code: "boundary-call-violation",
388        aliases: &["boundary-calls", "boundary-call-violations"],
389        label: "Boundary Call Violations",
390        config_key: Some("boundary-violation"),
391        filter_flag: Some("--boundary-violations"),
392        mcp_issue_type: None,
393        suppress_token: Some("boundary-call-violation"),
394        suppress_file_level: false,
395        lsp: false,
396        docs_category: "architecture",
397    },
398    IssueKindMeta {
399        kind: Some(IssueKind::PolicyViolation),
400        code: "policy-violation",
401        aliases: &["policy-violations"],
402        label: "Policy Violations",
403        config_key: Some("policy-violation"),
404        filter_flag: Some("--policy-violations"),
405        mcp_issue_type: Some("policy-violations"),
406        suppress_token: Some("policy-violation"),
407        suppress_file_level: false,
408        lsp: true,
409        docs_category: "architecture",
410    },
411    IssueKindMeta {
412        kind: Some(IssueKind::InvalidClientExport),
413        code: "invalid-client-export",
414        aliases: &["invalid-client-exports"],
415        label: "Invalid Client Exports",
416        config_key: Some("invalid-client-export"),
417        filter_flag: None,
418        mcp_issue_type: None,
419        suppress_token: Some("invalid-client-export"),
420        suppress_file_level: false,
421        lsp: true,
422        docs_category: "framework",
423    },
424    IssueKindMeta {
425        kind: Some(IssueKind::MixedClientServerBarrel),
426        code: "mixed-client-server-barrel",
427        aliases: &["mixed-client-server-barrels"],
428        label: "Mixed Client/Server Barrels",
429        config_key: Some("mixed-client-server-barrel"),
430        filter_flag: None,
431        mcp_issue_type: None,
432        suppress_token: Some("mixed-client-server-barrel"),
433        suppress_file_level: false,
434        lsp: true,
435        docs_category: "framework",
436    },
437    IssueKindMeta {
438        kind: Some(IssueKind::MisplacedDirective),
439        code: "misplaced-directive",
440        aliases: &["misplaced-directives"],
441        label: "Misplaced Directives",
442        config_key: Some("misplaced-directive"),
443        filter_flag: None,
444        mcp_issue_type: None,
445        suppress_token: Some("misplaced-directive"),
446        suppress_file_level: false,
447        lsp: true,
448        docs_category: "framework",
449    },
450    IssueKindMeta {
451        kind: Some(IssueKind::UnprovidedInject),
452        code: "unprovided-inject",
453        aliases: &["unprovided-injects"],
454        label: "Unprovided Injects",
455        config_key: Some("unprovided-injects"),
456        filter_flag: Some("--unprovided-injects"),
457        mcp_issue_type: Some("unprovided-injects"),
458        suppress_token: Some("unprovided-inject"),
459        suppress_file_level: false,
460        lsp: true,
461        docs_category: "framework",
462    },
463    IssueKindMeta {
464        kind: Some(IssueKind::UnrenderedComponent),
465        code: "unrendered-component",
466        aliases: &["unrendered-components"],
467        label: "Unrendered Components",
468        config_key: Some("unrendered-components"),
469        filter_flag: Some("--unrendered-components"),
470        mcp_issue_type: Some("unrendered-components"),
471        suppress_token: Some("unrendered-component"),
472        suppress_file_level: false,
473        lsp: true,
474        docs_category: "framework",
475    },
476    IssueKindMeta {
477        kind: Some(IssueKind::UnusedComponentProp),
478        code: "unused-component-prop",
479        aliases: &["unused-component-props"],
480        label: "Unused Component Props",
481        config_key: Some("unused-component-props"),
482        filter_flag: Some("--unused-component-props"),
483        mcp_issue_type: Some("unused-component-props"),
484        suppress_token: Some("unused-component-prop"),
485        suppress_file_level: false,
486        lsp: true,
487        docs_category: "framework",
488    },
489    IssueKindMeta {
490        kind: Some(IssueKind::AbsentComponentProp),
491        code: "absent-component-prop",
492        aliases: &["absent-component-props"],
493        label: "Absent Optional Component Props",
494        config_key: Some("absent-component-props"),
495        filter_flag: Some("--absent-component-props"),
496        mcp_issue_type: Some("absent-component-props"),
497        suppress_token: Some("absent-component-prop"),
498        suppress_file_level: false,
499        lsp: true,
500        docs_category: "framework",
501    },
502    IssueKindMeta {
503        kind: Some(IssueKind::UnusedComponentEmit),
504        code: "unused-component-emit",
505        aliases: &["unused-component-emits"],
506        label: "Unused Component Emits",
507        config_key: Some("unused-component-emits"),
508        filter_flag: Some("--unused-component-emits"),
509        mcp_issue_type: Some("unused-component-emits"),
510        suppress_token: Some("unused-component-emit"),
511        suppress_file_level: false,
512        lsp: true,
513        docs_category: "framework",
514    },
515    IssueKindMeta {
516        kind: Some(IssueKind::UnusedComponentInput),
517        code: "unused-component-input",
518        aliases: &["unused-component-inputs"],
519        label: "Unused Component Inputs",
520        config_key: Some("unused-component-inputs"),
521        filter_flag: Some("--unused-component-inputs"),
522        mcp_issue_type: Some("unused-component-inputs"),
523        suppress_token: Some("unused-component-input"),
524        suppress_file_level: false,
525        lsp: true,
526        docs_category: "framework",
527    },
528    IssueKindMeta {
529        kind: Some(IssueKind::UnusedComponentOutput),
530        code: "unused-component-output",
531        aliases: &["unused-component-outputs"],
532        label: "Unused Component Outputs",
533        config_key: Some("unused-component-outputs"),
534        filter_flag: Some("--unused-component-outputs"),
535        mcp_issue_type: Some("unused-component-outputs"),
536        suppress_token: Some("unused-component-output"),
537        suppress_file_level: false,
538        lsp: true,
539        docs_category: "framework",
540    },
541    IssueKindMeta {
542        kind: Some(IssueKind::UnusedSvelteEvent),
543        code: "unused-svelte-event",
544        aliases: &["unused-svelte-events"],
545        label: "Unused Svelte Events",
546        config_key: Some("unused-svelte-events"),
547        filter_flag: Some("--unused-svelte-events"),
548        mcp_issue_type: Some("unused-svelte-events"),
549        suppress_token: Some("unused-svelte-event"),
550        suppress_file_level: false,
551        lsp: true,
552        docs_category: "framework",
553    },
554    IssueKindMeta {
555        kind: Some(IssueKind::UnusedServerAction),
556        code: "unused-server-action",
557        aliases: &["unused-server-actions"],
558        label: "Unused Server Actions",
559        config_key: Some("unused-server-actions"),
560        filter_flag: Some("--unused-server-actions"),
561        mcp_issue_type: Some("unused-server-actions"),
562        suppress_token: Some("unused-server-action"),
563        suppress_file_level: false,
564        lsp: true,
565        docs_category: "framework",
566    },
567    IssueKindMeta {
568        kind: Some(IssueKind::UnusedLoadDataKey),
569        code: "unused-load-data-key",
570        aliases: &["unused-load-data-keys"],
571        label: "Unused Load Data Keys",
572        config_key: Some("unused-load-data-keys"),
573        filter_flag: Some("--unused-load-data-keys"),
574        mcp_issue_type: Some("unused-load-data-keys"),
575        suppress_token: Some("unused-load-data-key"),
576        suppress_file_level: false,
577        lsp: true,
578        docs_category: "framework",
579    },
580    IssueKindMeta {
581        kind: Some(IssueKind::UnusedEffectLayer),
582        code: "unused-effect-layer",
583        aliases: &["unused-effect-layers"],
584        label: "Unused Effect Layers",
585        config_key: Some("unused-effect-layers"),
586        filter_flag: Some("--unused-effect-layers"),
587        mcp_issue_type: Some("unused-effect-layers"),
588        suppress_token: Some("unused-effect-layer"),
589        suppress_file_level: false,
590        lsp: true,
591        docs_category: "framework",
592    },
593    IssueKindMeta {
594        kind: Some(IssueKind::UnusedTaggedError),
595        code: "unused-tagged-error",
596        aliases: &["unused-tagged-errors"],
597        label: "Unused Tagged Errors",
598        config_key: Some("unused-tagged-errors"),
599        filter_flag: Some("--unused-tagged-errors"),
600        mcp_issue_type: Some("unused-tagged-errors"),
601        suppress_token: Some("unused-tagged-error"),
602        suppress_file_level: false,
603        lsp: true,
604        docs_category: "framework",
605    },
606    IssueKindMeta {
607        kind: Some(IssueKind::UnproducedCatchTag),
608        code: "unproduced-catch-tag",
609        aliases: &["unproduced-catch-tags"],
610        label: "Unproduced Catch Tags",
611        config_key: Some("unproduced-catch-tags"),
612        filter_flag: Some("--unproduced-catch-tags"),
613        mcp_issue_type: Some("unproduced-catch-tags"),
614        suppress_token: Some("unproduced-catch-tag"),
615        suppress_file_level: false,
616        lsp: true,
617        docs_category: "framework",
618    },
619    IssueKindMeta {
620        kind: Some(IssueKind::RouteCollision),
621        code: "route-collision",
622        aliases: &["route-collisions"],
623        label: "Route Collisions",
624        config_key: Some("route-collision"),
625        filter_flag: None,
626        mcp_issue_type: None,
627        suppress_token: Some("route-collision"),
628        suppress_file_level: true,
629        lsp: true,
630        docs_category: "framework",
631    },
632    IssueKindMeta {
633        kind: Some(IssueKind::DynamicSegmentNameConflict),
634        code: "dynamic-segment-name-conflict",
635        aliases: &["dynamic-segment-name-conflicts"],
636        label: "Dynamic Segment Conflicts",
637        config_key: Some("dynamic-segment-name-conflict"),
638        filter_flag: None,
639        mcp_issue_type: None,
640        suppress_token: Some("dynamic-segment-name-conflict"),
641        suppress_file_level: true,
642        lsp: true,
643        docs_category: "framework",
644    },
645    IssueKindMeta {
646        kind: Some(IssueKind::StaleSuppression),
647        code: "stale-suppression",
648        aliases: &[],
649        label: "Stale Suppressions",
650        config_key: Some("stale-suppressions"),
651        filter_flag: Some("--stale-suppressions"),
652        mcp_issue_type: Some("stale-suppressions"),
653        suppress_token: None,
654        suppress_file_level: false,
655        lsp: true,
656        docs_category: "source",
657    },
658    IssueKindMeta {
659        kind: Some(IssueKind::StaleSuppression),
660        code: "missing-suppression-reason",
661        aliases: &["missing-suppression-reasons"],
662        label: "Missing Suppression Reasons",
663        config_key: Some("require-suppression-reason"),
664        filter_flag: Some("--stale-suppressions"),
665        mcp_issue_type: None,
666        suppress_token: None,
667        suppress_file_level: false,
668        lsp: false,
669        docs_category: "source",
670    },
671    IssueKindMeta {
672        kind: Some(IssueKind::PnpmCatalogEntry),
673        code: "unused-catalog-entry",
674        aliases: &["catalog", "unused-catalog-entries"],
675        label: "Unused Catalog Entries",
676        config_key: Some("unused-catalog-entries"),
677        filter_flag: Some("--unused-catalog-entries"),
678        mcp_issue_type: Some("unused-catalog-entries"),
679        suppress_token: None,
680        suppress_file_level: false,
681        lsp: true,
682        docs_category: "dependency",
683    },
684    IssueKindMeta {
685        kind: Some(IssueKind::EmptyCatalogGroup),
686        code: "empty-catalog-group",
687        aliases: &["empty-catalog", "empty-catalog-groups"],
688        label: "Empty Catalog Groups",
689        config_key: Some("empty-catalog-groups"),
690        filter_flag: Some("--empty-catalog-groups"),
691        mcp_issue_type: Some("empty-catalog-groups"),
692        suppress_token: None,
693        suppress_file_level: false,
694        lsp: true,
695        docs_category: "dependency",
696    },
697    IssueKindMeta {
698        kind: Some(IssueKind::UnresolvedCatalogReference),
699        code: "unresolved-catalog-reference",
700        aliases: &["unresolved-catalog", "unresolved-catalog-references"],
701        label: "Unresolved Catalog References",
702        config_key: Some("unresolved-catalog-references"),
703        filter_flag: Some("--unresolved-catalog-references"),
704        mcp_issue_type: Some("unresolved-catalog-references"),
705        suppress_token: None,
706        suppress_file_level: false,
707        lsp: true,
708        docs_category: "dependency",
709    },
710    IssueKindMeta {
711        kind: Some(IssueKind::UnusedDependencyOverride),
712        code: "unused-dependency-override",
713        aliases: &[
714            "unused-dependency-overrides",
715            "unused-override",
716            "unused-overrides",
717        ],
718        label: "Unused Dependency Overrides",
719        config_key: Some("unused-dependency-overrides"),
720        filter_flag: Some("--unused-dependency-overrides"),
721        mcp_issue_type: Some("unused-dependency-overrides"),
722        suppress_token: None,
723        suppress_file_level: false,
724        lsp: true,
725        docs_category: "dependency",
726    },
727    IssueKindMeta {
728        kind: Some(IssueKind::MisconfiguredDependencyOverride),
729        code: "misconfigured-dependency-override",
730        aliases: &[
731            "misconfigured-dependency-overrides",
732            "misconfigured-override",
733            "misconfigured-overrides",
734        ],
735        label: "Misconfigured Dependency Overrides",
736        config_key: Some("misconfigured-dependency-overrides"),
737        filter_flag: Some("--misconfigured-dependency-overrides"),
738        mcp_issue_type: Some("misconfigured-dependency-overrides"),
739        suppress_token: None,
740        suppress_file_level: false,
741        lsp: true,
742        docs_category: "dependency",
743    },
744    IssueKindMeta {
745        kind: Some(IssueKind::SecuritySink),
746        code: "security-sink",
747        aliases: &[],
748        label: "Security Sink Candidates",
749        config_key: Some("security-sink"),
750        filter_flag: None,
751        mcp_issue_type: None,
752        suppress_token: Some("security-sink"),
753        suppress_file_level: false,
754        lsp: true,
755        docs_category: "security",
756    },
757    IssueKindMeta {
758        kind: Some(IssueKind::SecurityClientServerLeak),
759        code: "security-client-server-leak",
760        aliases: &[],
761        label: "Security Client-Server Leaks",
762        config_key: Some("security-client-server-leak"),
763        filter_flag: None,
764        mcp_issue_type: None,
765        suppress_token: Some("security-client-server-leak"),
766        suppress_file_level: true,
767        lsp: true,
768        docs_category: "security",
769    },
770    IssueKindMeta {
771        kind: Some(IssueKind::CoverageGaps),
772        code: "coverage-gaps",
773        aliases: &[],
774        label: "Coverage Gaps",
775        config_key: Some("coverage-gaps"),
776        filter_flag: None,
777        mcp_issue_type: None,
778        suppress_token: Some("coverage-gaps"),
779        suppress_file_level: true,
780        lsp: false,
781        docs_category: "health",
782    },
783    IssueKindMeta {
784        kind: Some(IssueKind::FeatureFlag),
785        code: "feature-flag",
786        aliases: &[],
787        label: "Feature Flags",
788        config_key: Some("feature-flags"),
789        filter_flag: None,
790        mcp_issue_type: None,
791        suppress_token: Some("feature-flag"),
792        suppress_file_level: false,
793        lsp: false,
794        docs_category: "flags",
795    },
796    IssueKindMeta {
797        kind: Some(IssueKind::Complexity),
798        code: "complexity",
799        aliases: &[],
800        label: "Complexity",
801        config_key: None,
802        filter_flag: None,
803        mcp_issue_type: None,
804        suppress_token: Some("complexity"),
805        suppress_file_level: false,
806        lsp: false,
807        docs_category: "health",
808    },
809    IssueKindMeta {
810        kind: Some(IssueKind::PropDrilling),
811        code: "prop-drilling",
812        aliases: &[],
813        label: "Prop Drilling",
814        config_key: Some("prop-drilling"),
815        filter_flag: None,
816        mcp_issue_type: None,
817        suppress_token: Some("prop-drilling"),
818        suppress_file_level: false,
819        lsp: true,
820        docs_category: "source",
821    },
822    IssueKindMeta {
823        kind: Some(IssueKind::ThinWrapper),
824        code: "thin-wrapper",
825        aliases: &["thin-wrappers"],
826        label: "Thin Wrappers",
827        config_key: Some("thin-wrapper"),
828        filter_flag: None,
829        mcp_issue_type: None,
830        suppress_token: Some("thin-wrapper"),
831        suppress_file_level: false,
832        lsp: true,
833        docs_category: "source",
834    },
835    IssueKindMeta {
836        kind: Some(IssueKind::DuplicatePropShape),
837        code: "duplicate-prop-shape",
838        aliases: &["duplicate-prop-shapes"],
839        label: "Duplicate Prop Shapes",
840        config_key: Some("duplicate-prop-shape"),
841        filter_flag: None,
842        mcp_issue_type: None,
843        suppress_token: Some("duplicate-prop-shape"),
844        suppress_file_level: false,
845        lsp: true,
846        docs_category: "source",
847    },
848    IssueKindMeta {
849        kind: Some(IssueKind::CssTokenDrift),
850        code: "css-token-drift",
851        aliases: &[],
852        label: "CSS Token Drift",
853        config_key: Some("css-token-drift"),
854        filter_flag: None,
855        mcp_issue_type: None,
856        suppress_token: Some("css-token-drift"),
857        suppress_file_level: false,
858        lsp: false,
859        docs_category: "health",
860    },
861    IssueKindMeta {
862        kind: Some(IssueKind::CssDuplicateBlock),
863        code: "css-duplicate-block",
864        aliases: &[],
865        label: "CSS Duplicate Block",
866        config_key: Some("css-duplicate-block"),
867        filter_flag: None,
868        mcp_issue_type: None,
869        suppress_token: Some("css-duplicate-block"),
870        suppress_file_level: false,
871        lsp: false,
872        docs_category: "health",
873    },
874    IssueKindMeta {
875        kind: Some(IssueKind::CssSelectorComplexity),
876        code: "css-selector-complexity",
877        aliases: &[],
878        label: "CSS Selector Complexity",
879        config_key: Some("css-selector-complexity"),
880        filter_flag: None,
881        mcp_issue_type: None,
882        suppress_token: Some("css-selector-complexity"),
883        suppress_file_level: false,
884        lsp: false,
885        docs_category: "health",
886    },
887    IssueKindMeta {
888        kind: Some(IssueKind::CssDeadSurface),
889        code: "css-dead-surface",
890        aliases: &[],
891        label: "CSS Dead Surface",
892        config_key: Some("css-dead-surface"),
893        filter_flag: None,
894        mcp_issue_type: None,
895        suppress_token: Some("css-dead-surface"),
896        suppress_file_level: false,
897        lsp: false,
898        docs_category: "health",
899    },
900    IssueKindMeta {
901        kind: Some(IssueKind::CssBrokenReference),
902        code: "css-broken-reference",
903        aliases: &[],
904        label: "CSS Broken Reference",
905        config_key: Some("css-broken-reference"),
906        filter_flag: None,
907        mcp_issue_type: None,
908        suppress_token: Some("css-broken-reference"),
909        suppress_file_level: false,
910        lsp: false,
911        docs_category: "health",
912    },
913    IssueKindMeta {
914        kind: Some(IssueKind::WeakenedTests),
915        code: "weakened-tests",
916        aliases: &[],
917        label: "Weakened Tests",
918        config_key: Some("weakened-tests"),
919        filter_flag: None,
920        mcp_issue_type: None,
921        suppress_token: Some("weakened-tests"),
922        suppress_file_level: false,
923        lsp: false,
924        docs_category: "audit",
925    },
926    IssueKindMeta {
927        kind: Some(IssueKind::AddedSuppression),
928        code: "added-suppression",
929        aliases: &[],
930        label: "Added Suppressions",
931        config_key: Some("added-suppression"),
932        filter_flag: None,
933        mcp_issue_type: None,
934        suppress_token: Some("added-suppression"),
935        suppress_file_level: false,
936        lsp: false,
937        docs_category: "audit",
938    },
939    IssueKindMeta {
940        kind: Some(IssueKind::TestOnlyBranch),
941        code: "test-only-branch",
942        aliases: &[],
943        label: "Test-Only Branches",
944        config_key: Some("test-only-branch"),
945        filter_flag: None,
946        mcp_issue_type: None,
947        suppress_token: Some("test-only-branch"),
948        suppress_file_level: false,
949        lsp: false,
950        docs_category: "audit",
951    },
952    IssueKindMeta {
953        kind: Some(IssueKind::DivergedCloneSibling),
954        code: "diverged-clone-sibling",
955        aliases: &[],
956        label: "Diverged Clone Siblings",
957        config_key: Some("diverged-clone-sibling"),
958        filter_flag: None,
959        mcp_issue_type: None,
960        suppress_token: Some("diverged-clone-sibling"),
961        suppress_file_level: false,
962        lsp: false,
963        docs_category: "audit",
964    },
965    IssueKindMeta {
966        kind: Some(IssueKind::AddedDependency),
967        code: "added-dependency",
968        aliases: &[],
969        label: "Added Dependencies",
970        config_key: Some("added-dependency"),
971        filter_flag: None,
972        mcp_issue_type: None,
973        // `package.json` cannot hold a comment, so the only suppression is
974        // an `overrides` entry that sets the rule to `off`.
975        suppress_token: None,
976        suppress_file_level: false,
977        lsp: false,
978        docs_category: "audit",
979    },
980];
981
982/// Shared contract facts for serialized `AnalysisResults` arrays.
983#[derive(Debug, Clone, Copy, PartialEq, Eq)]
984#[non_exhaustive]
985pub struct IssueResultMeta {
986    /// Canonical issue code that owns this result array.
987    pub code: &'static str,
988    /// Short SARIF rule description.
989    pub sarif_description: &'static str,
990    /// Explanation emitted in dead-code `_meta.rules`.
991    pub meta_description: &'static str,
992    /// Documentation path emitted in dead-code `_meta.rules`.
993    pub meta_docs_path: &'static str,
994    /// Human-readable name emitted in dead-code `_meta.rules`.
995    pub meta_name: &'static str,
996    /// Label used by CI summary tables.
997    pub summary_label: &'static str,
998    /// Documentation anchor under `/explanations/dead-code`.
999    pub docs_anchor: &'static str,
1000    /// Serialized `AnalysisResults` array key that carries this issue row.
1001    pub result_key: &'static str,
1002    /// Whether `result_key` can contribute to `AnalysisResults::total_issues()`.
1003    /// Prop-drilling contributes only when its saved severity is `error`.
1004    pub counts_in_total: bool,
1005}
1006
1007/// TypeScript backwards-compat alias emitted for a dead-code result row.
1008#[derive(Debug, Clone, Copy, PartialEq, Eq)]
1009pub struct TsAliasMeta {
1010    /// Bare alias name kept available from the published `fallow/types` subpath.
1011    pub name: &'static str,
1012    /// Generated `*Finding` wrapper type the alias resolves to.
1013    pub parent: &'static str,
1014}
1015
1016/// TypeScript backwards-compat alias row for a dead-code result code.
1017#[derive(Debug, Clone, Copy, PartialEq, Eq)]
1018pub struct IssueTsAliasMeta {
1019    /// Canonical issue code that owns this alias.
1020    pub code: &'static str,
1021    /// Published TypeScript alias policy.
1022    pub alias: TsAliasMeta,
1023}
1024
1025/// Published TypeScript backwards-compat aliases.
1026pub const ISSUE_TS_ALIAS_META: &[IssueTsAliasMeta] = &[
1027    IssueTsAliasMeta {
1028        code: "unused-file",
1029        alias: TsAliasMeta {
1030            name: "UnusedFile",
1031            parent: "UnusedFileFinding",
1032        },
1033    },
1034    IssueTsAliasMeta {
1035        code: "unused-export",
1036        alias: TsAliasMeta {
1037            name: "UnusedExport",
1038            parent: "UnusedExportFinding",
1039        },
1040    },
1041    IssueTsAliasMeta {
1042        code: "private-type-leak",
1043        alias: TsAliasMeta {
1044            name: "PrivateTypeLeak",
1045            parent: "PrivateTypeLeakFinding",
1046        },
1047    },
1048    IssueTsAliasMeta {
1049        code: "deprecated-export-in-use",
1050        alias: TsAliasMeta {
1051            name: "DeprecatedExportInUse",
1052            parent: "DeprecatedExportInUseFinding",
1053        },
1054    },
1055    IssueTsAliasMeta {
1056        code: "unused-dependency",
1057        alias: TsAliasMeta {
1058            name: "UnusedDependency",
1059            parent: "UnusedDependencyFinding",
1060        },
1061    },
1062    IssueTsAliasMeta {
1063        code: "unused-dev-dependency",
1064        alias: TsAliasMeta {
1065            name: "UnusedDependency",
1066            parent: "UnusedDevDependencyFinding",
1067        },
1068    },
1069    IssueTsAliasMeta {
1070        code: "unused-optional-dependency",
1071        alias: TsAliasMeta {
1072            name: "UnusedDependency",
1073            parent: "UnusedOptionalDependencyFinding",
1074        },
1075    },
1076    IssueTsAliasMeta {
1077        code: "unused-enum-member",
1078        alias: TsAliasMeta {
1079            name: "UnusedMember",
1080            parent: "UnusedEnumMemberFinding",
1081        },
1082    },
1083    IssueTsAliasMeta {
1084        code: "unused-class-member",
1085        alias: TsAliasMeta {
1086            name: "UnusedMember",
1087            parent: "UnusedClassMemberFinding",
1088        },
1089    },
1090    IssueTsAliasMeta {
1091        code: "unused-namespace-member",
1092        alias: TsAliasMeta {
1093            name: "UnusedMember",
1094            parent: "UnusedNamespaceMemberFinding",
1095        },
1096    },
1097    IssueTsAliasMeta {
1098        code: "unused-store-member",
1099        alias: TsAliasMeta {
1100            name: "UnusedMember",
1101            parent: "UnusedStoreMemberFinding",
1102        },
1103    },
1104    IssueTsAliasMeta {
1105        code: "unresolved-import",
1106        alias: TsAliasMeta {
1107            name: "UnresolvedImport",
1108            parent: "UnresolvedImportFinding",
1109        },
1110    },
1111    IssueTsAliasMeta {
1112        code: "unlisted-dependency",
1113        alias: TsAliasMeta {
1114            name: "UnlistedDependency",
1115            parent: "UnlistedDependencyFinding",
1116        },
1117    },
1118    IssueTsAliasMeta {
1119        code: "unlisted-binary",
1120        alias: TsAliasMeta {
1121            name: "UnlistedBinary",
1122            parent: "UnlistedBinaryFinding",
1123        },
1124    },
1125    IssueTsAliasMeta {
1126        code: "duplicate-export",
1127        alias: TsAliasMeta {
1128            name: "DuplicateExport",
1129            parent: "DuplicateExportFinding",
1130        },
1131    },
1132    IssueTsAliasMeta {
1133        code: "duplicate-export-alias",
1134        alias: TsAliasMeta {
1135            name: "DuplicateExportAlias",
1136            parent: "DuplicateExportAliasFinding",
1137        },
1138    },
1139    IssueTsAliasMeta {
1140        code: "type-only-dependency",
1141        alias: TsAliasMeta {
1142            name: "TypeOnlyDependency",
1143            parent: "TypeOnlyDependencyFinding",
1144        },
1145    },
1146    IssueTsAliasMeta {
1147        code: "test-only-dependency",
1148        alias: TsAliasMeta {
1149            name: "TestOnlyDependency",
1150            parent: "TestOnlyDependencyFinding",
1151        },
1152    },
1153    IssueTsAliasMeta {
1154        code: "dev-dependency-in-production",
1155        alias: TsAliasMeta {
1156            name: "DevDependencyInProduction",
1157            parent: "DevDependencyInProductionFinding",
1158        },
1159    },
1160    IssueTsAliasMeta {
1161        code: "circular-dependency",
1162        alias: TsAliasMeta {
1163            name: "CircularDependency",
1164            parent: "CircularDependencyFinding",
1165        },
1166    },
1167    IssueTsAliasMeta {
1168        code: "re-export-cycle",
1169        alias: TsAliasMeta {
1170            name: "ReExportCycle",
1171            parent: "ReExportCycleFinding",
1172        },
1173    },
1174    IssueTsAliasMeta {
1175        code: "package-cycle",
1176        alias: TsAliasMeta {
1177            name: "PackageCycle",
1178            parent: "PackageCycleFinding",
1179        },
1180    },
1181    IssueTsAliasMeta {
1182        code: "boundary-violation",
1183        alias: TsAliasMeta {
1184            name: "BoundaryViolation",
1185            parent: "BoundaryViolationFinding",
1186        },
1187    },
1188    IssueTsAliasMeta {
1189        code: "unused-catalog-entry",
1190        alias: TsAliasMeta {
1191            name: "UnusedCatalogEntry",
1192            parent: "UnusedCatalogEntryFinding",
1193        },
1194    },
1195    IssueTsAliasMeta {
1196        code: "empty-catalog-group",
1197        alias: TsAliasMeta {
1198            name: "EmptyCatalogGroup",
1199            parent: "EmptyCatalogGroupFinding",
1200        },
1201    },
1202    IssueTsAliasMeta {
1203        code: "unresolved-catalog-reference",
1204        alias: TsAliasMeta {
1205            name: "UnresolvedCatalogReference",
1206            parent: "UnresolvedCatalogReferenceFinding",
1207        },
1208    },
1209    IssueTsAliasMeta {
1210        code: "unused-dependency-override",
1211        alias: TsAliasMeta {
1212            name: "UnusedDependencyOverride",
1213            parent: "UnusedDependencyOverrideFinding",
1214        },
1215    },
1216    IssueTsAliasMeta {
1217        code: "misconfigured-dependency-override",
1218        alias: TsAliasMeta {
1219            name: "MisconfiguredDependencyOverride",
1220            parent: "MisconfiguredDependencyOverrideFinding",
1221        },
1222    },
1223];
1224
1225/// All shared issue-to-result metadata rows.
1226pub const ISSUE_RESULT_META: &[IssueResultMeta] = &[
1227    IssueResultMeta {
1228        code: "unused-file",
1229        sarif_description: "File is not reachable from any entry point",
1230        meta_description: "Source files that are not imported by any other module and are not entry points. Detection uses graph reachability from configured entry points.",
1231        meta_docs_path: "explanations/dead-code#unused-files",
1232        meta_name: "Unused Files",
1233        summary_label: "Unused files",
1234        docs_anchor: "unused-files",
1235        result_key: "unused_files",
1236        counts_in_total: true,
1237    },
1238    IssueResultMeta {
1239        code: "unused-export",
1240        sarif_description: "Export is never imported",
1241        meta_description: "Named exports that are never imported by any other module in the project, including direct exports and re-exports through barrel files.",
1242        meta_docs_path: "explanations/dead-code#unused-exports",
1243        meta_name: "Unused Exports",
1244        summary_label: "Unused exports",
1245        docs_anchor: "unused-exports",
1246        result_key: "unused_exports",
1247        counts_in_total: true,
1248    },
1249    IssueResultMeta {
1250        code: "unused-type",
1251        sarif_description: "Type export is never imported",
1252        meta_description: "Type-only exports that are never imported. These do not generate runtime code but add maintenance burden.",
1253        meta_docs_path: "explanations/dead-code#unused-types",
1254        meta_name: "Unused Type Exports",
1255        summary_label: "Unused types",
1256        docs_anchor: "unused-types",
1257        result_key: "unused_types",
1258        counts_in_total: true,
1259    },
1260    IssueResultMeta {
1261        code: "private-type-leak",
1262        sarif_description: "Exported signature references a private type",
1263        meta_description: "Exported values or types whose public TypeScript signature references a same-file type declaration that is not exported.",
1264        meta_docs_path: "explanations/dead-code#private-type-leaks",
1265        meta_name: "Private Type Leaks",
1266        summary_label: "Private type leaks",
1267        docs_anchor: "private-type-leaks",
1268        result_key: "private_type_leaks",
1269        counts_in_total: true,
1270    },
1271    IssueResultMeta {
1272        code: "deprecated-export-in-use",
1273        sarif_description: "Export marked @deprecated is still referenced",
1274        meta_description: "Exports whose leading JSDoc carries @deprecated and that still have at least one consumer in a reachable file. Each finding lists the consumer count and a capped consumer sample.",
1275        meta_docs_path: "explanations/dead-code#deprecated-exports-in-use",
1276        meta_name: "Deprecated Exports in Use",
1277        summary_label: "Deprecated exports in use",
1278        docs_anchor: "deprecated-exports-in-use",
1279        result_key: "deprecated_exports_in_use",
1280        counts_in_total: true,
1281    },
1282    IssueResultMeta {
1283        code: "unused-dependency",
1284        sarif_description: "Dependency listed but never imported",
1285        meta_description: "Packages listed in dependencies that are never imported or required by any source file.",
1286        meta_docs_path: "explanations/dead-code#unused-dependencies",
1287        meta_name: "Unused Dependencies",
1288        summary_label: "Unused dependencies",
1289        docs_anchor: "unused-dependencies",
1290        result_key: "unused_dependencies",
1291        counts_in_total: true,
1292    },
1293    IssueResultMeta {
1294        code: "unused-dev-dependency",
1295        sarif_description: "Dev dependency listed but never imported",
1296        meta_description: "Packages listed in devDependencies that are never imported by test files, config files, or scripts.",
1297        meta_docs_path: "explanations/dead-code#unused-devdependencies",
1298        meta_name: "Unused Dev Dependencies",
1299        summary_label: "Unused devDependencies",
1300        docs_anchor: "unused-dependencies",
1301        result_key: "unused_dev_dependencies",
1302        counts_in_total: true,
1303    },
1304    IssueResultMeta {
1305        code: "unused-optional-dependency",
1306        sarif_description: "Optional dependency listed but never imported",
1307        meta_description: "Packages listed in optionalDependencies that are never imported.",
1308        meta_docs_path: "explanations/dead-code#unused-optionaldependencies",
1309        meta_name: "Unused Optional Dependencies",
1310        summary_label: "Unused optionalDependencies",
1311        docs_anchor: "unused-dependencies",
1312        result_key: "unused_optional_dependencies",
1313        counts_in_total: true,
1314    },
1315    IssueResultMeta {
1316        code: "unused-enum-member",
1317        sarif_description: "Enum member is never referenced",
1318        meta_description: "Enum members that are never referenced in the codebase.",
1319        meta_docs_path: "explanations/dead-code#unused-enum-members",
1320        meta_name: "Unused Enum Members",
1321        summary_label: "Unused enum members",
1322        docs_anchor: "unused-enum-members",
1323        result_key: "unused_enum_members",
1324        counts_in_total: true,
1325    },
1326    IssueResultMeta {
1327        code: "unused-class-member",
1328        sarif_description: "Class member is never referenced",
1329        meta_description: "Class methods and properties that are never referenced outside the class.",
1330        meta_docs_path: "explanations/dead-code#unused-class-members",
1331        meta_name: "Unused Class Members",
1332        summary_label: "Unused class members",
1333        docs_anchor: "unused-class-members",
1334        result_key: "unused_class_members",
1335        counts_in_total: true,
1336    },
1337    IssueResultMeta {
1338        code: "unused-namespace-member",
1339        sarif_description: "Namespace member is never referenced",
1340        meta_description: "Exported members of an exported TypeScript namespace that no code reads.",
1341        meta_docs_path: "explanations/dead-code#unused-namespace-members",
1342        meta_name: "Unused Namespace Members",
1343        summary_label: "Unused namespace members",
1344        docs_anchor: "unused-namespace-members",
1345        result_key: "unused_namespace_members",
1346        counts_in_total: true,
1347    },
1348    IssueResultMeta {
1349        code: "unused-store-member",
1350        sarif_description: "Store member is never accessed by any consumer",
1351        meta_description: "Pinia store members declared but never accessed by any consumer project-wide.",
1352        meta_docs_path: "explanations/dead-code#unused-store-members",
1353        meta_name: "Unused Store Members",
1354        summary_label: "Unused store members",
1355        docs_anchor: "unused-store-members",
1356        result_key: "unused_store_members",
1357        counts_in_total: true,
1358    },
1359    IssueResultMeta {
1360        code: "unresolved-import",
1361        sarif_description: "Import could not be resolved",
1362        meta_description: "Import specifiers that could not be resolved to a file on disk.",
1363        meta_docs_path: "explanations/dead-code#unresolved-imports",
1364        meta_name: "Unresolved Imports",
1365        summary_label: "Unresolved imports",
1366        docs_anchor: "unresolved-imports",
1367        result_key: "unresolved_imports",
1368        counts_in_total: true,
1369    },
1370    IssueResultMeta {
1371        code: "unlisted-dependency",
1372        sarif_description: "Dependency used but not in package.json",
1373        meta_description: "Packages imported in source code but not listed in package.json.",
1374        meta_docs_path: "explanations/dead-code#unlisted-dependencies",
1375        meta_name: "Unlisted Dependencies",
1376        summary_label: "Unlisted dependencies",
1377        docs_anchor: "unlisted-dependencies",
1378        result_key: "unlisted_dependencies",
1379        counts_in_total: true,
1380    },
1381    IssueResultMeta {
1382        code: "unlisted-binary",
1383        sarif_description: "Binary used but provided by no installed package",
1384        meta_description: "Binaries that package.json scripts or process calls run, but that no installed or listed package provides.",
1385        meta_docs_path: "explanations/dead-code#unlisted-binaries",
1386        meta_name: "Unlisted Binaries",
1387        summary_label: "Unlisted binaries",
1388        docs_anchor: "unlisted-binaries",
1389        result_key: "unlisted_binaries",
1390        counts_in_total: true,
1391    },
1392    IssueResultMeta {
1393        code: "duplicate-export",
1394        sarif_description: "Export name appears in multiple modules",
1395        meta_description: "The same export name is defined in multiple modules.",
1396        meta_docs_path: "explanations/dead-code#duplicate-exports",
1397        meta_name: "Duplicate Exports",
1398        summary_label: "Duplicate exports",
1399        docs_anchor: "duplicate-exports",
1400        result_key: "duplicate_exports",
1401        counts_in_total: true,
1402    },
1403    IssueResultMeta {
1404        code: "duplicate-export-alias",
1405        sarif_description: "One module exports one binding under two or more names",
1406        meta_description: "One module exports the same binding under two or more names, for example a named export and a default export of one const.",
1407        meta_docs_path: "explanations/dead-code#duplicate-export-aliases",
1408        meta_name: "Duplicate Export Aliases",
1409        summary_label: "Duplicate export aliases",
1410        docs_anchor: "duplicate-export-aliases",
1411        result_key: "duplicate_export_aliases",
1412        counts_in_total: true,
1413    },
1414    IssueResultMeta {
1415        code: "type-only-dependency",
1416        sarif_description: "Production dependency only used via type-only imports",
1417        meta_description: "Production dependencies that are only imported via type-only imports.",
1418        meta_docs_path: "explanations/dead-code#type-only-dependencies",
1419        meta_name: "Type-only Dependencies",
1420        summary_label: "Type-only dependencies",
1421        docs_anchor: "type-only-dependencies",
1422        result_key: "type_only_dependencies",
1423        counts_in_total: true,
1424    },
1425    IssueResultMeta {
1426        code: "test-only-dependency",
1427        sarif_description: "Production dependency only imported by test files",
1428        meta_description: "Production dependencies that are only imported from test files.",
1429        meta_docs_path: "explanations/dead-code#test-only-dependencies",
1430        meta_name: "Test-only Dependencies",
1431        summary_label: "Test-only dependencies",
1432        docs_anchor: "test-only-dependencies",
1433        result_key: "test_only_dependencies",
1434        counts_in_total: true,
1435    },
1436    IssueResultMeta {
1437        code: "dev-dependency-in-production",
1438        sarif_description: "devDependency imported by production code with a runtime import",
1439        meta_description: "devDependencies imported by production source code via a runtime/value import; they should be promoted to dependencies.",
1440        meta_docs_path: "explanations/dead-code#dev-dependencies-in-production",
1441        meta_name: "Dev Dependencies Used in Production",
1442        summary_label: "Dev dependencies used in production",
1443        docs_anchor: "dev-dependencies-in-production",
1444        result_key: "dev_dependencies_in_production",
1445        counts_in_total: true,
1446    },
1447    IssueResultMeta {
1448        code: "circular-dependency",
1449        sarif_description: "Circular dependency chain detected",
1450        meta_description: "A cycle in the module import graph.",
1451        meta_docs_path: "explanations/dead-code#circular-dependencies",
1452        meta_name: "Circular Dependencies",
1453        summary_label: "Circular dependencies",
1454        docs_anchor: "circular-dependencies",
1455        result_key: "circular_dependencies",
1456        counts_in_total: true,
1457    },
1458    IssueResultMeta {
1459        code: "re-export-cycle",
1460        sarif_description: "Two or more barrel files re-export from each other in a loop",
1461        meta_description: "A barrel file re-exports from another barrel that ultimately re-exports back.",
1462        meta_docs_path: "explanations/dead-code#re-export-cycles",
1463        meta_name: "Re-Export Cycles",
1464        summary_label: "Re-export cycles",
1465        docs_anchor: "re-export-cycles",
1466        result_key: "re_export_cycles",
1467        counts_in_total: true,
1468    },
1469    IssueResultMeta {
1470        code: "package-cycle",
1471        sarif_description: "Two or more workspace packages import each other in a loop",
1472        meta_description: "Workspace packages whose resolved imports form a cycle, even when no file-level cycle exists.",
1473        meta_docs_path: "explanations/dead-code#package-cycles",
1474        meta_name: "Package Cycles",
1475        summary_label: "Package cycles",
1476        docs_anchor: "package-cycles",
1477        result_key: "package_cycles",
1478        counts_in_total: true,
1479    },
1480    IssueResultMeta {
1481        code: "boundary-violation",
1482        sarif_description: "Import crosses a configured architecture boundary",
1483        meta_description: "A module imports from a zone that its configured boundary rules do not allow.",
1484        meta_docs_path: "explanations/dead-code#boundary-violations",
1485        meta_name: "Boundary Violations",
1486        summary_label: "Boundary violations",
1487        docs_anchor: "boundary-violations",
1488        result_key: "boundary_violations",
1489        counts_in_total: true,
1490    },
1491    IssueResultMeta {
1492        code: "boundary-coverage",
1493        sarif_description: "Source file matches no configured architecture boundary zone",
1494        meta_description: "A reachable source file is not assigned to any configured boundary zone while boundary coverage is required.",
1495        meta_docs_path: "explanations/dead-code#boundary-violations",
1496        meta_name: "Boundary Coverage",
1497        summary_label: "Boundary coverage",
1498        docs_anchor: "boundary-violations",
1499        result_key: "boundary_coverage_violations",
1500        counts_in_total: true,
1501    },
1502    IssueResultMeta {
1503        code: "boundary-call-violation",
1504        sarif_description: "Zoned file calls a callee its zone forbids",
1505        meta_description: "A file classified into a boundary zone calls a callee matching one of the zone's forbidden call patterns.",
1506        meta_docs_path: "explanations/dead-code#boundary-violations",
1507        meta_name: "Boundary Call Violation",
1508        summary_label: "Boundary calls",
1509        docs_anchor: "boundary-violations",
1510        result_key: "boundary_call_violations",
1511        counts_in_total: true,
1512    },
1513    IssueResultMeta {
1514        code: "policy-violation",
1515        sarif_description: "Usage violates a configured rule-pack policy",
1516        meta_description: "A call, import, export, catalogue-derived effect, or graph-resolved GDP proof producer violates a configured rule pack rule.",
1517        meta_docs_path: "explanations/dead-code#policy-violations",
1518        meta_name: "Policy Violation",
1519        summary_label: "Policy violations",
1520        docs_anchor: "policy-violations",
1521        result_key: "policy_violations",
1522        counts_in_total: true,
1523    },
1524    IssueResultMeta {
1525        code: "invalid-client-export",
1526        sarif_description: "\"use client\" file exports a server-only / route-config name",
1527        meta_description: "A file carrying the use client directive also exports a Next.js server-only or route-segment config name.",
1528        meta_docs_path: "explanations/dead-code#invalid-client-exports",
1529        meta_name: "Invalid client export",
1530        summary_label: "Invalid client exports",
1531        docs_anchor: "invalid-client-exports",
1532        result_key: "invalid_client_exports",
1533        counts_in_total: true,
1534    },
1535    IssueResultMeta {
1536        code: "mixed-client-server-barrel",
1537        sarif_description: "Barrel re-exports both a \"use client\" module and a server-only module",
1538        meta_description: "A barrel file forwards a name from a use client module alongside a name from a server-only module.",
1539        meta_docs_path: "explanations/dead-code#mixed-client-server-barrels",
1540        meta_name: "Mixed client/server barrel",
1541        summary_label: "Mixed client/server barrels",
1542        docs_anchor: "mixed-client-server-barrels",
1543        result_key: "mixed_client_server_barrels",
1544        counts_in_total: true,
1545    },
1546    IssueResultMeta {
1547        code: "misplaced-directive",
1548        sarif_description: "\"use client\" / \"use server\" directive is not in the leading position and is ignored",
1549        meta_description: "A use client or use server directive string appears after a non-directive statement and is ignored.",
1550        meta_docs_path: "explanations/dead-code#misplaced-directives",
1551        meta_name: "Misplaced directive",
1552        summary_label: "Misplaced directives",
1553        docs_anchor: "misplaced-directives",
1554        result_key: "misplaced_directives",
1555        counts_in_total: true,
1556    },
1557    IssueResultMeta {
1558        code: "unprovided-inject",
1559        sarif_description: "inject() / getContext() reads a key that no provide() / setContext() supplies",
1560        meta_description: "A Vue inject or Svelte getContext reads a dependency-injection key that no matching provider supplies.",
1561        meta_docs_path: "explanations/dead-code#unprovided-injects",
1562        meta_name: "Unprovided injects",
1563        summary_label: "Unprovided injects",
1564        docs_anchor: "unprovided-injects",
1565        result_key: "unprovided_injects",
1566        counts_in_total: true,
1567    },
1568    IssueResultMeta {
1569        code: "unrendered-component",
1570        sarif_description: "A Vue / Svelte component is reachable through a barrel but rendered nowhere",
1571        meta_description: "A Vue or Svelte single-file component is reachable through the graph but rendered nowhere in the project.",
1572        meta_docs_path: "explanations/dead-code#unrendered-components",
1573        meta_name: "Unrendered components",
1574        summary_label: "Unrendered components",
1575        docs_anchor: "unrendered-components",
1576        result_key: "unrendered_components",
1577        counts_in_total: true,
1578    },
1579    IssueResultMeta {
1580        code: "unused-component-prop",
1581        sarif_description: "A Vue, Svelte, or React component prop is referenced nowhere in its own component",
1582        meta_description: "A declared Vue, Svelte, React, or Preact component prop is referenced nowhere inside its own component.",
1583        meta_docs_path: "explanations/dead-code#unused-component-props",
1584        meta_name: "Unused component props",
1585        summary_label: "Unused component props",
1586        docs_anchor: "unused-component-props",
1587        result_key: "unused_component_props",
1588        counts_in_total: true,
1589    },
1590    IssueResultMeta {
1591        code: "absent-component-prop",
1592        sarif_description: "Known reachable callers do not supply this used optional input; review defaults and API intent manually.",
1593        meta_description: "Known reachable callers do not supply this used optional input; review defaults and API intent manually.",
1594        meta_docs_path: "explanations/dead-code#absent-component-props",
1595        meta_name: "Absent optional component props",
1596        summary_label: "Absent optional component props",
1597        docs_anchor: "absent-component-props",
1598        result_key: "absent_component_props",
1599        counts_in_total: true,
1600    },
1601    IssueResultMeta {
1602        code: "unused-component-emit",
1603        sarif_description: "A Vue <script setup> defineEmits event is emitted nowhere in its own component",
1604        meta_description: "A Vue script setup defineEmits event is emitted nowhere in its own component.",
1605        meta_docs_path: "explanations/dead-code#unused-component-emits",
1606        meta_name: "Unused component emits",
1607        summary_label: "Unused component emits",
1608        docs_anchor: "unused-component-emits",
1609        result_key: "unused_component_emits",
1610        counts_in_total: true,
1611    },
1612    IssueResultMeta {
1613        code: "unused-component-input",
1614        sarif_description: "An Angular @Input() / signal input() / model() input is read nowhere in its own component",
1615        meta_description: "An Angular input is read nowhere in its own component.",
1616        meta_docs_path: "explanations/dead-code#unused-component-inputs",
1617        meta_name: "Unused component inputs",
1618        summary_label: "Unused component inputs",
1619        docs_anchor: "unused-component-inputs",
1620        result_key: "unused_component_inputs",
1621        counts_in_total: true,
1622    },
1623    IssueResultMeta {
1624        code: "unused-component-output",
1625        sarif_description: "An Angular @Output() / signal output() output is emitted nowhere in its own component",
1626        meta_description: "An Angular output is emitted nowhere in its own component.",
1627        meta_docs_path: "explanations/dead-code#unused-component-outputs",
1628        meta_name: "Unused component outputs",
1629        summary_label: "Unused component outputs",
1630        docs_anchor: "unused-component-outputs",
1631        result_key: "unused_component_outputs",
1632        counts_in_total: true,
1633    },
1634    IssueResultMeta {
1635        code: "unused-svelte-event",
1636        sarif_description: "A Svelte component dispatches a createEventDispatcher event whose name is listened to nowhere in the project",
1637        meta_description: "A Svelte component dispatches a custom event whose name is listened to nowhere in the analyzed project.",
1638        meta_docs_path: "explanations/dead-code#unused-svelte-events",
1639        meta_name: "Unused Svelte events",
1640        summary_label: "Unused Svelte events",
1641        docs_anchor: "unused-svelte-events",
1642        result_key: "unused_svelte_events",
1643        counts_in_total: true,
1644    },
1645    IssueResultMeta {
1646        code: "unused-server-action",
1647        sarif_description: "A Next.js Server Action exported from a \"use server\" file is referenced by no code in the project",
1648        meta_description: "A Next.js Server Action exported from a use server file is referenced by no code in the project.",
1649        meta_docs_path: "explanations/dead-code#unused-server-actions",
1650        meta_name: "Unused server actions",
1651        summary_label: "Unused server actions",
1652        docs_anchor: "unused-server-actions",
1653        result_key: "unused_server_actions",
1654        counts_in_total: true,
1655    },
1656    IssueResultMeta {
1657        code: "unused-load-data-key",
1658        sarif_description: "A SvelteKit load() return-object key is read by no consumer",
1659        meta_description: "A SvelteKit load return-object key is read by no route or project-wide consumer.",
1660        meta_docs_path: "explanations/dead-code#unused-load-data-keys",
1661        meta_name: "Unused load data keys",
1662        summary_label: "Unused load data keys",
1663        docs_anchor: "unused-load-data-keys",
1664        result_key: "unused_load_data_keys",
1665        counts_in_total: true,
1666    },
1667    IssueResultMeta {
1668        code: "unused-effect-layer",
1669        sarif_description: "An Effect layer is composed only into layers that nothing uses",
1670        meta_description: "An Effect layer is composed only into other layers that nothing in the project uses.",
1671        meta_docs_path: "explanations/dead-code#unused-effect-layers",
1672        meta_name: "Unused Effect layers",
1673        summary_label: "Unused Effect layers",
1674        docs_anchor: "unused-effect-layers",
1675        result_key: "unused_effect_layers",
1676        counts_in_total: true,
1677    },
1678    IssueResultMeta {
1679        code: "unused-tagged-error",
1680        sarif_description: "An Effect tagged error class is referenced only as a type or a catchTag string, and no code constructs or fails with it",
1681        meta_description: "An Effect tagged error class is referenced only as a type or a catchTag string. No code constructs or fails with it.",
1682        meta_docs_path: "explanations/dead-code#unused-tagged-errors",
1683        meta_name: "Unused tagged errors",
1684        summary_label: "Unused tagged errors",
1685        docs_anchor: "unused-tagged-errors",
1686        result_key: "unused_tagged_errors",
1687        counts_in_total: true,
1688    },
1689    IssueResultMeta {
1690        code: "unproduced-catch-tag",
1691        sarif_description: "A catchTag handler names a project error tag that no code produces",
1692        meta_description: "A catchTag or catchTags handler names a project error tag that no code in the project produces.",
1693        meta_docs_path: "explanations/dead-code#unproduced-catch-tags",
1694        meta_name: "Unproduced catch tags",
1695        summary_label: "Unproduced catch tags",
1696        docs_anchor: "unproduced-catch-tags",
1697        result_key: "unproduced_catch_tags",
1698        counts_in_total: true,
1699    },
1700    IssueResultMeta {
1701        code: "route-collision",
1702        sarif_description: "Two or more Next.js App Router route files resolve to the same URL",
1703        meta_description: "Two or more Next.js App Router route files resolve to the same URL within one app root.",
1704        meta_docs_path: "explanations/dead-code#route-collisions",
1705        meta_name: "Route collision",
1706        summary_label: "Route collisions",
1707        docs_anchor: "route-collisions",
1708        result_key: "route_collisions",
1709        counts_in_total: true,
1710    },
1711    IssueResultMeta {
1712        code: "dynamic-segment-name-conflict",
1713        sarif_description: "Sibling Next.js dynamic route segments use different slug names at the same position",
1714        meta_description: "Sibling Next.js dynamic route segments use different slug names at the same position.",
1715        meta_docs_path: "explanations/dead-code#dynamic-segment-name-conflicts",
1716        meta_name: "Dynamic segment name conflict",
1717        summary_label: "Dynamic segment conflicts",
1718        docs_anchor: "dynamic-segment-name-conflicts",
1719        result_key: "dynamic_segment_name_conflicts",
1720        counts_in_total: true,
1721    },
1722    IssueResultMeta {
1723        code: "stale-suppression",
1724        sarif_description: "Suppression comment or tag no longer matches any issue",
1725        meta_description: "A fallow suppression comment or tag no longer matches any active issue.",
1726        meta_docs_path: "explanations/dead-code#stale-suppressions",
1727        meta_name: "Stale Suppressions",
1728        summary_label: "Stale suppressions",
1729        docs_anchor: "stale-suppressions",
1730        result_key: "stale_suppressions",
1731        counts_in_total: true,
1732    },
1733    IssueResultMeta {
1734        code: "unused-catalog-entry",
1735        sarif_description: "Catalog entry not referenced by any workspace package",
1736        meta_description: "A package manager catalog entry is not referenced by any workspace package.json.",
1737        meta_docs_path: "explanations/dead-code#unused-catalog-entries",
1738        meta_name: "Unused catalog entry",
1739        summary_label: "Unused catalog entries",
1740        docs_anchor: "unused-catalog-entries",
1741        result_key: "unused_catalog_entries",
1742        counts_in_total: true,
1743    },
1744    IssueResultMeta {
1745        code: "empty-catalog-group",
1746        sarif_description: "Named catalog group has no entries",
1747        meta_description: "A named package manager catalog group has no package entries.",
1748        meta_docs_path: "explanations/dead-code#empty-catalog-groups",
1749        meta_name: "Empty catalog group",
1750        summary_label: "Empty catalog groups",
1751        docs_anchor: "empty-catalog-groups",
1752        result_key: "empty_catalog_groups",
1753        counts_in_total: true,
1754    },
1755    IssueResultMeta {
1756        code: "unresolved-catalog-reference",
1757        sarif_description: "package.json references a catalog that does not declare the package",
1758        meta_description: "A workspace package.json uses a catalog protocol reference that no catalog declares.",
1759        meta_docs_path: "explanations/dead-code#unresolved-catalog-references",
1760        meta_name: "Unresolved catalog reference",
1761        summary_label: "Unresolved catalog references",
1762        docs_anchor: "unresolved-catalog-references",
1763        result_key: "unresolved_catalog_references",
1764        counts_in_total: true,
1765    },
1766    IssueResultMeta {
1767        code: "unused-dependency-override",
1768        sarif_description: "Package-manager override target is not declared or resolved",
1769        meta_description: "A dependency override targets a package not declared by any workspace package and not present in the active readable lockfile.",
1770        meta_docs_path: "explanations/dead-code#unused-dependency-overrides",
1771        meta_name: "Unused dependency override",
1772        summary_label: "Unused dependency overrides",
1773        docs_anchor: "unused-dependency-overrides",
1774        result_key: "unused_dependency_overrides",
1775        counts_in_total: true,
1776    },
1777    IssueResultMeta {
1778        code: "misconfigured-dependency-override",
1779        sarif_description: "Package-manager override has an unparsable key or value",
1780        meta_description: "A dependency override key or value does not parse according to its package manager's grammar.",
1781        meta_docs_path: "explanations/dead-code#misconfigured-dependency-overrides",
1782        meta_name: "Misconfigured dependency override",
1783        summary_label: "Misconfigured dependency overrides",
1784        docs_anchor: "misconfigured-dependency-overrides",
1785        result_key: "misconfigured_dependency_overrides",
1786        counts_in_total: true,
1787    },
1788    IssueResultMeta {
1789        code: "prop-drilling",
1790        sarif_description: "A React/Preact prop is forwarded unchanged through 3+ pass-through components to a distant consumer",
1791        meta_description: "A React or Preact prop is forwarded unchanged through multiple pass-through components to a distant consumer.",
1792        meta_docs_path: "explanations/dead-code#prop-drilling",
1793        meta_name: "Prop drilling",
1794        summary_label: "Prop drilling",
1795        docs_anchor: "prop-drilling",
1796        result_key: "prop_drilling_chains",
1797        counts_in_total: true,
1798    },
1799    IssueResultMeta {
1800        code: "thin-wrapper",
1801        sarif_description: "A React/Preact component whose whole body is a single spread-forwarded child render (a candidate for inlining)",
1802        meta_description: "A React or Preact component is structural indirection around a single spread-forwarded child render.",
1803        meta_docs_path: "explanations/dead-code#thin-wrapper",
1804        meta_name: "Thin wrapper",
1805        summary_label: "Thin wrappers",
1806        docs_anchor: "thin-wrapper",
1807        result_key: "thin_wrappers",
1808        counts_in_total: true,
1809    },
1810    IssueResultMeta {
1811        code: "duplicate-prop-shape",
1812        sarif_description: "Three or more React/Preact components across two or more files declare an identical prop-name set (a missing shared Props type)",
1813        meta_description: "Multiple React or Preact components declare an identical significant prop-name set.",
1814        meta_docs_path: "explanations/dead-code#duplicate-prop-shape",
1815        meta_name: "Duplicate prop shape",
1816        summary_label: "Duplicate prop shapes",
1817        docs_anchor: "duplicate-prop-shape",
1818        result_key: "duplicate_prop_shapes",
1819        counts_in_total: true,
1820    },
1821];
1822
1823/// Canonical names and aliases accepted by `IssueKind::parse`.
1824pub static KNOWN_ISSUE_KIND_NAMES: LazyLock<Vec<&'static str>> =
1825    LazyLock::new(known_issue_kind_names_from_meta);
1826
1827/// CLI filter flags on `fallow dead-code` that scope output to one issue family.
1828pub static DEAD_CODE_FILTER_FLAGS: LazyLock<Vec<&'static str>> =
1829    LazyLock::new(dead_code_filter_flags_from_meta);
1830
1831/// MCP issue selector names mapped to dead-code CLI flags.
1832pub static MCP_ISSUE_TYPE_FLAGS: LazyLock<Vec<(&'static str, &'static str)>> =
1833    LazyLock::new(mcp_issue_type_flags_from_meta);
1834
1835/// Result issue codes emitted by the dead-code CodeClimate formatter.
1836pub static CODECLIMATE_RESULT_CODES: LazyLock<Vec<&'static str>> =
1837    LazyLock::new(codeclimate_result_codes_from_meta);
1838
1839fn mcp_issue_type_flags_from_meta() -> Vec<(&'static str, &'static str)> {
1840    ISSUE_KIND_META
1841        .iter()
1842        .filter_map(|meta| meta.mcp_pair())
1843        .collect()
1844}
1845
1846fn codeclimate_result_codes_from_meta() -> Vec<&'static str> {
1847    ISSUE_RESULT_META
1848        .iter()
1849        .filter(|meta| meta.counts_in_total)
1850        .map(|meta| meta.code)
1851        .collect()
1852}
1853
1854fn push_unique<T: Copy + PartialEq>(items: &mut Vec<T>, item: T) {
1855    if !items.contains(&item) {
1856        items.push(item);
1857    }
1858}
1859
1860/// Lookup metadata by canonical code.
1861#[must_use]
1862pub fn issue_meta_by_code(code: &str) -> Option<&'static IssueKindMeta> {
1863    ISSUE_KIND_META.iter().find(|meta| meta.code == code)
1864}
1865
1866/// Lookup metadata by canonical code or alias.
1867#[must_use]
1868pub fn issue_meta_for_token(token: &str) -> Option<&'static IssueKindMeta> {
1869    ISSUE_KIND_META
1870        .iter()
1871        .find(|meta| meta.code == token || meta.aliases.contains(&token))
1872}
1873
1874/// Lookup metadata by any shared contract token: canonical code, alias,
1875/// config key, MCP selector, suppression token, or CLI filter flag.
1876#[must_use]
1877pub fn issue_meta_for_contract_token(token: &str) -> Option<&'static IssueKindMeta> {
1878    let normalized = token.trim().trim_start_matches("--").replace('_', "-");
1879    ISSUE_KIND_META
1880        .iter()
1881        .find(|meta| issue_meta_matches_contract_token(meta, &normalized))
1882}
1883
1884/// Whether a metadata row owns the provided shared contract token.
1885#[must_use]
1886pub fn issue_meta_matches_contract_token(meta: &IssueKindMeta, token: &str) -> bool {
1887    let normalized = token.trim().trim_start_matches("--").replace('_', "-");
1888    meta.code == normalized
1889        || meta.aliases.contains(&normalized.as_str())
1890        || meta.config_key == Some(normalized.as_str())
1891        || meta.mcp_issue_type == Some(normalized.as_str())
1892        || meta.suppress_token == Some(normalized.as_str())
1893        || meta.filter_flag.map(|flag| flag.trim_start_matches("--")) == Some(normalized.as_str())
1894}
1895
1896/// Lookup metadata by backing issue kind.
1897#[must_use]
1898pub fn issue_meta_by_kind(kind: IssueKind) -> Option<&'static IssueKindMeta> {
1899    ISSUE_KIND_META.iter().find(|meta| meta.kind == Some(kind))
1900}
1901
1902/// Lookup serialized result metadata by canonical issue code.
1903#[must_use]
1904pub fn issue_result_meta_by_code(code: &str) -> Option<&'static IssueResultMeta> {
1905    ISSUE_RESULT_META.iter().find(|meta| meta.code == code)
1906}
1907
1908/// SARIF rule ids used by CI formatters for a canonical issue code.
1909#[must_use]
1910pub fn issue_sarif_rule_ids(code: &str) -> Vec<String> {
1911    let mut ids = vec![format!("fallow/{code}")];
1912    if code == "stale-suppression" {
1913        ids.push("fallow/missing-suppression-reason".to_string());
1914    }
1915    ids
1916}
1917
1918/// Short SARIF rule description for a rule id emitted by dead-code output.
1919#[must_use]
1920pub fn issue_sarif_rule_description(rule_id: &str) -> Option<&'static str> {
1921    let code = rule_id.strip_prefix("fallow/")?;
1922    if code == "missing-suppression-reason" {
1923        return Some("Suppression comment omits a required reason");
1924    }
1925    issue_result_meta_by_code(code).map(|meta| meta.sarif_description)
1926}
1927
1928/// CodeClimate check names used by CI formatters for a canonical issue code.
1929#[must_use]
1930pub fn issue_codeclimate_check_names(code: &str) -> Vec<String> {
1931    if !CODECLIMATE_RESULT_CODES.contains(&code) {
1932        return Vec::new();
1933    }
1934    issue_sarif_rule_ids(code)
1935}
1936
1937/// Documentation anchor under `/explanations/dead-code` for a canonical issue
1938/// code.
1939#[must_use]
1940pub fn issue_docs_anchor(code: &str) -> Option<&'static str> {
1941    issue_result_meta_by_code(code).map(|meta| meta.docs_anchor)
1942}
1943
1944/// Published TypeScript alias policy for backwards-compatible bare names.
1945#[must_use]
1946pub fn issue_ts_alias(code: &str) -> Option<TsAliasMeta> {
1947    ISSUE_TS_ALIAS_META
1948        .iter()
1949        .find(|meta| meta.code == code)
1950        .map(|meta| meta.alias)
1951}
1952
1953/// Rows exposed by the LSP issue-type capability.
1954pub fn diagnostic_issue_metas() -> impl Iterator<Item = &'static IssueKindMeta> {
1955    ISSUE_KIND_META.iter().filter(|meta| meta.lsp)
1956}
1957
1958/// Rows that map to a serialized `AnalysisResults` array.
1959pub fn result_issue_metas() -> impl Iterator<Item = &'static IssueResultMeta> {
1960    ISSUE_RESULT_META.iter()
1961}
1962
1963/// Rows whose serialized `AnalysisResults` array contributes to `total_issues`.
1964pub fn counted_result_issue_metas() -> impl Iterator<Item = &'static IssueResultMeta> {
1965    result_issue_metas().filter(|meta| meta.counts_in_total)
1966}
1967
1968/// Canonical issue codes `fallow fix` can rewrite automatically. Shared by the
1969/// `fallow schema` `issue_types` rows (`fixable`) and the `fallow://issue-types`
1970/// MCP resource so the two surfaces never disagree on fixability.
1971pub const FIXABLE_ISSUE_CODES: &[&str] = &[
1972    "unused-export",
1973    "unused-enum-member",
1974    "unused-dependency",
1975    "unused-dev-dependency",
1976    "unused-optional-dependency",
1977    "unused-catalog-entry",
1978];
1979
1980/// Whether `fallow fix` can rewrite findings of a canonical issue code.
1981#[must_use]
1982pub fn issue_is_fixable(code: &str) -> bool {
1983    FIXABLE_ISSUE_CODES.contains(&code)
1984}
1985
1986#[cfg(test)]
1987#[path = "issue_meta_tests.rs"]
1988mod tests;