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