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