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