dart-decimate 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (188) hide show
  1. package/Cargo.lock +572 -0
  2. package/Cargo.toml +41 -0
  3. package/LICENSE +21 -0
  4. package/README.md +617 -0
  5. package/assets/dart-decimate-banner.png +0 -0
  6. package/npm/bin/dart-decimate-mcp.js +48 -0
  7. package/npm/bin/dart-decimate.js +48 -0
  8. package/npm/scripts/postinstall.js +46 -0
  9. package/npm/scripts/test-npx-local.js +54 -0
  10. package/npm/scripts/test-npx-mcp-local.js +56 -0
  11. package/package.json +45 -0
  12. package/src/baseline.rs +643 -0
  13. package/src/bin/dart-decimate-mcp.rs +11 -0
  14. package/src/boundaries/tests.rs +60 -0
  15. package/src/boundaries.rs +317 -0
  16. package/src/changed_scope.rs +117 -0
  17. package/src/ci_template.rs +399 -0
  18. package/src/cli/analyze.rs +462 -0
  19. package/src/cli/analyzer_options.rs +82 -0
  20. package/src/cli/audit_run.rs +327 -0
  21. package/src/cli/boundary_args.rs +44 -0
  22. package/src/cli/ci_template_run.rs +196 -0
  23. package/src/cli/command_name.rs +20 -0
  24. package/src/cli/common_args.rs +167 -0
  25. package/src/cli/config_run.rs +78 -0
  26. package/src/cli/coverage_run.rs +393 -0
  27. package/src/cli/decision_surface_run.rs +99 -0
  28. package/src/cli/default_command.rs +69 -0
  29. package/src/cli/dupes_args.rs +150 -0
  30. package/src/cli/entry_points.rs +121 -0
  31. package/src/cli/error.rs +149 -0
  32. package/src/cli/error_output.rs +68 -0
  33. package/src/cli/explain_run.rs +72 -0
  34. package/src/cli/fix_run.rs +162 -0
  35. package/src/cli/flags_args.rs +23 -0
  36. package/src/cli/health_args.rs +200 -0
  37. package/src/cli/hooks_run.rs +191 -0
  38. package/src/cli/impact_run.rs +95 -0
  39. package/src/cli/init_run.rs +49 -0
  40. package/src/cli/inspect_args.rs +20 -0
  41. package/src/cli/inspect_run.rs +66 -0
  42. package/src/cli/issue_filter_args.rs +240 -0
  43. package/src/cli/list_run.rs +311 -0
  44. package/src/cli/mode_args.rs +72 -0
  45. package/src/cli/output_format.rs +62 -0
  46. package/src/cli/regression_args.rs +156 -0
  47. package/src/cli/request_args.rs +175 -0
  48. package/src/cli/schema_commands.rs +72 -0
  49. package/src/cli/scope_args.rs +174 -0
  50. package/src/cli/security_args.rs +175 -0
  51. package/src/cli/security_gate_run.rs +66 -0
  52. package/src/cli/security_summary_run.rs +43 -0
  53. package/src/cli/summary_args.rs +12 -0
  54. package/src/cli/tests.rs +516 -0
  55. package/src/cli/trace_args.rs +67 -0
  56. package/src/cli/trace_run.rs +131 -0
  57. package/src/cli/trace_tests.rs +235 -0
  58. package/src/cli/unsupported_run.rs +116 -0
  59. package/src/cli/watch_run.rs +153 -0
  60. package/src/cli.rs +603 -0
  61. package/src/config/boundary_config.rs +235 -0
  62. package/src/config/cache.rs +25 -0
  63. package/src/config/dependencies.rs +114 -0
  64. package/src/config/health.rs +237 -0
  65. package/src/config/jsonc.rs +66 -0
  66. package/src/config/policy.rs +91 -0
  67. package/src/config/rule_aliases.rs +487 -0
  68. package/src/config/rules.rs +339 -0
  69. package/src/config.rs +635 -0
  70. package/src/coverage.rs +469 -0
  71. package/src/dart_parser.rs +673 -0
  72. package/src/decision_surface.rs +405 -0
  73. package/src/dependencies/analyze.rs +218 -0
  74. package/src/dependencies/codegen.rs +118 -0
  75. package/src/dependencies/discovery.rs +60 -0
  76. package/src/dependencies/overrides.rs +76 -0
  77. package/src/dependencies/private_src_imports.rs +32 -0
  78. package/src/dependencies/pubspec_document.rs +86 -0
  79. package/src/dependencies/pubspec_entry.rs +96 -0
  80. package/src/dependencies/tests.rs +544 -0
  81. package/src/dependencies/usage.rs +33 -0
  82. package/src/dependencies.rs +553 -0
  83. package/src/dependency_scripts.rs +91 -0
  84. package/src/dupes/lex.rs +236 -0
  85. package/src/dupes/tests.rs +119 -0
  86. package/src/dupes.rs +625 -0
  87. package/src/explain.rs +692 -0
  88. package/src/extract/directives.rs +252 -0
  89. package/src/extract/error_tests.rs +25 -0
  90. package/src/extract/members.rs +210 -0
  91. package/src/extract/primary_constructors.rs +421 -0
  92. package/src/extract/references.rs +151 -0
  93. package/src/extract/routes.rs +691 -0
  94. package/src/extract/signatures.rs +266 -0
  95. package/src/extract/string_tests.rs +18 -0
  96. package/src/extract/strings.rs +107 -0
  97. package/src/extract/tests.rs +697 -0
  98. package/src/extract.rs +680 -0
  99. package/src/feature_flags/tests.rs +76 -0
  100. package/src/feature_flags.rs +453 -0
  101. package/src/finding_identity.rs +60 -0
  102. package/src/fix.rs +551 -0
  103. package/src/generated.rs +53 -0
  104. package/src/graph/augment_tests.rs +212 -0
  105. package/src/graph/conditionals.rs +74 -0
  106. package/src/graph/package_config_tests.rs +100 -0
  107. package/src/graph/parts.rs +248 -0
  108. package/src/graph/pubspec_tests.rs +119 -0
  109. package/src/graph/tests.rs +837 -0
  110. package/src/graph/uri_tests.rs +102 -0
  111. package/src/graph.rs +644 -0
  112. package/src/health/coverage.rs +309 -0
  113. package/src/health/ownership.rs +175 -0
  114. package/src/health/runtime_coverage.rs +616 -0
  115. package/src/health/runtime_intelligence.rs +511 -0
  116. package/src/health/scores.rs +296 -0
  117. package/src/health/tests.rs +240 -0
  118. package/src/health/threshold_types.rs +163 -0
  119. package/src/health/thresholds.rs +229 -0
  120. package/src/health/types.rs +636 -0
  121. package/src/health.rs +597 -0
  122. package/src/hooks/agent_settings.rs +175 -0
  123. package/src/hooks/templates.rs +51 -0
  124. package/src/hooks.rs +569 -0
  125. package/src/impact.rs +287 -0
  126. package/src/init.rs +237 -0
  127. package/src/inspect.rs +142 -0
  128. package/src/intelligence/tests.rs +232 -0
  129. package/src/intelligence.rs +305 -0
  130. package/src/lib.rs +198 -0
  131. package/src/main.rs +5 -0
  132. package/src/manifest/mcp.rs +565 -0
  133. package/src/manifest.rs +552 -0
  134. package/src/mcp/cli_args/value_args.rs +175 -0
  135. package/src/mcp/cli_args.rs +658 -0
  136. package/src/mcp/cli_args_tests.rs +522 -0
  137. package/src/mcp/code_execute.rs +671 -0
  138. package/src/mcp/tools.rs +660 -0
  139. package/src/mcp.rs +325 -0
  140. package/src/output/audit_risk.rs +135 -0
  141. package/src/output/dependency_findings.rs +327 -0
  142. package/src/output/duplication_findings.rs +114 -0
  143. package/src/output/feature_flag_findings.rs +122 -0
  144. package/src/output/format.rs +31 -0
  145. package/src/output/graph_findings.rs +461 -0
  146. package/src/output/health_findings.rs +612 -0
  147. package/src/output/human.rs +27 -0
  148. package/src/output/next_steps.rs +92 -0
  149. package/src/output/route_findings.rs +76 -0
  150. package/src/output/runtime_coverage.rs +515 -0
  151. package/src/output/scope.rs +183 -0
  152. package/src/output/security_findings.rs +390 -0
  153. package/src/output/security_sarif.rs +150 -0
  154. package/src/output/suppressions.rs +323 -0
  155. package/src/output/symbol_findings.rs +257 -0
  156. package/src/output/tests.rs +114 -0
  157. package/src/output/types.rs +604 -0
  158. package/src/output/widget_findings.rs +213 -0
  159. package/src/output.rs +682 -0
  160. package/src/package_map.rs +495 -0
  161. package/src/policy/packs.rs +232 -0
  162. package/src/policy/tests.rs +134 -0
  163. package/src/policy.rs +640 -0
  164. package/src/project_list.rs +376 -0
  165. package/src/report_schema/inventory.rs +418 -0
  166. package/src/report_schema.rs +488 -0
  167. package/src/routes.rs +354 -0
  168. package/src/scan/tests.rs +250 -0
  169. package/src/scan.rs +275 -0
  170. package/src/security/detect.rs +639 -0
  171. package/src/security/tests.rs +178 -0
  172. package/src/security.rs +373 -0
  173. package/src/security_gate.rs +555 -0
  174. package/src/symbols/path_filters.rs +27 -0
  175. package/src/symbols/private_type_leaks.rs +125 -0
  176. package/src/symbols/riverpod.rs +113 -0
  177. package/src/symbols/tests.rs +692 -0
  178. package/src/symbols.rs +693 -0
  179. package/src/trace/tests.rs +225 -0
  180. package/src/trace.rs +690 -0
  181. package/src/unsupported.rs +47 -0
  182. package/src/widgets/lifecycle.rs +484 -0
  183. package/src/widgets/params.rs +236 -0
  184. package/src/widgets/tests.rs +430 -0
  185. package/src/widgets/top_level.rs +110 -0
  186. package/src/widgets/unrendered.rs +374 -0
  187. package/src/widgets.rs +590 -0
  188. package/src/workspace_scope.rs +358 -0
@@ -0,0 +1,358 @@
1
+ use std::collections::BTreeSet;
2
+ use std::path::{Path, PathBuf};
3
+
4
+ use glob::Pattern;
5
+ use thiserror::Error;
6
+
7
+ use crate::graph::normalize_path;
8
+ use crate::{LocalPubPackage, ScannedProject};
9
+
10
+ /// Errors returned while applying a pub workspace selector.
11
+ #[derive(Debug, Error)]
12
+ pub enum WorkspaceScopeError {
13
+ /// A workspace selector glob was invalid.
14
+ #[error("invalid workspace pattern {pattern:?}: {source}")]
15
+ Pattern {
16
+ /// Raw selector pattern.
17
+ pattern: String,
18
+ /// Underlying glob parse error.
19
+ source: glob::PatternError,
20
+ },
21
+ /// No local packages matched the requested selector.
22
+ #[error("no local pub packages matched workspace selector {patterns:?}")]
23
+ NoMatches {
24
+ /// Raw selector values.
25
+ patterns: Vec<String>,
26
+ },
27
+ }
28
+
29
+ /// Return root-normalized files belonging to selected local pub packages.
30
+ ///
31
+ /// Selectors match package names and package roots relative to the scan root.
32
+ /// Values may contain comma-separated patterns, and `!pattern` excludes matches.
33
+ /// When only excludes are provided, every local package starts selected.
34
+ ///
35
+ /// # Errors
36
+ ///
37
+ /// Returns [`WorkspaceScopeError`] for invalid glob syntax or empty selection.
38
+ pub fn workspace_file_scope(
39
+ project: &ScannedProject,
40
+ packages: &[LocalPubPackage],
41
+ patterns: &[String],
42
+ ) -> Result<Vec<PathBuf>, WorkspaceScopeError> {
43
+ let selectors = WorkspaceSelectors::parse(patterns)?;
44
+ let selected_roots = selectors.selected_roots(&project.root, packages)?;
45
+ Ok(file_scope_for_roots(project, packages, &selected_roots))
46
+ }
47
+
48
+ /// Return root-normalized files belonging to packages touched by changed paths.
49
+ ///
50
+ /// Non-Dart files inside a package still select that package. If no changed
51
+ /// paths belong to a local package, the returned scope is empty.
52
+ #[must_use]
53
+ pub fn changed_workspace_file_scope(
54
+ project: &ScannedProject,
55
+ packages: &[LocalPubPackage],
56
+ changed_paths: &[PathBuf],
57
+ ) -> Vec<PathBuf> {
58
+ let all_roots = packages
59
+ .iter()
60
+ .map(|package| package.root.clone())
61
+ .collect::<Vec<_>>();
62
+ let selected_roots = changed_paths
63
+ .iter()
64
+ .filter_map(|path| owning_root(&all_roots, path))
65
+ .cloned()
66
+ .collect::<BTreeSet<_>>();
67
+
68
+ file_scope_for_roots(project, packages, &selected_roots)
69
+ }
70
+
71
+ fn file_scope_for_roots(
72
+ project: &ScannedProject,
73
+ packages: &[LocalPubPackage],
74
+ selected_roots: &BTreeSet<PathBuf>,
75
+ ) -> Vec<PathBuf> {
76
+ let all_roots = packages
77
+ .iter()
78
+ .map(|package| package.root.clone())
79
+ .collect::<Vec<_>>();
80
+ let mut scope = BTreeSet::new();
81
+
82
+ for file in &project.files {
83
+ let Some(owner) = owning_root(&all_roots, &file.path) else {
84
+ continue;
85
+ };
86
+ if selected_roots.contains(owner) {
87
+ scope.insert(file.path.clone());
88
+ }
89
+ }
90
+
91
+ for package in packages {
92
+ if selected_roots.contains(&package.root) {
93
+ scope.insert(package.pubspec_path.clone());
94
+ }
95
+ }
96
+
97
+ scope.into_iter().collect()
98
+ }
99
+
100
+ struct WorkspaceSelectors {
101
+ include: Vec<WorkspacePattern>,
102
+ exclude: Vec<WorkspacePattern>,
103
+ raw: Vec<String>,
104
+ }
105
+
106
+ impl WorkspaceSelectors {
107
+ fn parse(values: &[String]) -> Result<Self, WorkspaceScopeError> {
108
+ let mut include = Vec::new();
109
+ let mut exclude = Vec::new();
110
+ let mut raw = Vec::new();
111
+
112
+ for value in values {
113
+ for item in value
114
+ .split(',')
115
+ .map(str::trim)
116
+ .filter(|item| !item.is_empty())
117
+ {
118
+ let (negated, pattern) = item
119
+ .strip_prefix('!')
120
+ .map_or((false, item), |pattern| (true, pattern.trim()));
121
+ let pattern = trim_path_pattern(pattern);
122
+ if pattern.is_empty() {
123
+ continue;
124
+ }
125
+ raw.push(item.to_owned());
126
+ let selector = WorkspacePattern::new(pattern)?;
127
+ if negated {
128
+ exclude.push(selector);
129
+ } else {
130
+ include.push(selector);
131
+ }
132
+ }
133
+ }
134
+
135
+ Ok(Self {
136
+ include,
137
+ exclude,
138
+ raw,
139
+ })
140
+ }
141
+
142
+ fn selected_roots(
143
+ &self,
144
+ root: &Path,
145
+ packages: &[LocalPubPackage],
146
+ ) -> Result<BTreeSet<PathBuf>, WorkspaceScopeError> {
147
+ let mut selected = packages
148
+ .iter()
149
+ .filter(|package| {
150
+ self.include.is_empty()
151
+ || self
152
+ .include
153
+ .iter()
154
+ .any(|pattern| pattern.matches(root, package))
155
+ })
156
+ .filter(|package| {
157
+ !self
158
+ .exclude
159
+ .iter()
160
+ .any(|pattern| pattern.matches(root, package))
161
+ })
162
+ .map(|package| package.root.clone())
163
+ .collect::<BTreeSet<_>>();
164
+
165
+ if selected.is_empty() {
166
+ return Err(WorkspaceScopeError::NoMatches {
167
+ patterns: self.raw.clone(),
168
+ });
169
+ }
170
+
171
+ selected = selected
172
+ .into_iter()
173
+ .map(|path| normalize_path(&path))
174
+ .collect();
175
+ Ok(selected)
176
+ }
177
+ }
178
+
179
+ struct WorkspacePattern {
180
+ glob: Pattern,
181
+ }
182
+
183
+ impl WorkspacePattern {
184
+ fn new(pattern: &str) -> Result<Self, WorkspaceScopeError> {
185
+ Ok(Self {
186
+ glob: Pattern::new(pattern).map_err(|source| WorkspaceScopeError::Pattern {
187
+ pattern: pattern.to_owned(),
188
+ source,
189
+ })?,
190
+ })
191
+ }
192
+
193
+ fn matches(&self, root: &Path, package: &LocalPubPackage) -> bool {
194
+ package_candidates(root, package)
195
+ .iter()
196
+ .any(|candidate| self.glob.matches(candidate))
197
+ }
198
+ }
199
+
200
+ fn package_candidates(root: &Path, package: &LocalPubPackage) -> Vec<String> {
201
+ let relative = display_path(root, &package.root);
202
+ let relative = if relative.is_empty() {
203
+ ".".to_owned()
204
+ } else {
205
+ relative
206
+ };
207
+ let absolute = display_path(Path::new(""), &package.root);
208
+ [package.name.clone(), relative, absolute]
209
+ .into_iter()
210
+ .collect()
211
+ }
212
+
213
+ fn owning_root<'root>(roots: &'root [PathBuf], path: &Path) -> Option<&'root PathBuf> {
214
+ roots
215
+ .iter()
216
+ .filter(|root| path.starts_with(root))
217
+ .max_by_key(|root| root.components().count())
218
+ }
219
+
220
+ fn trim_path_pattern(pattern: &str) -> &str {
221
+ pattern.trim().trim_end_matches('/')
222
+ }
223
+
224
+ fn display_path(root: &Path, path: &Path) -> String {
225
+ path.strip_prefix(root)
226
+ .unwrap_or(path)
227
+ .components()
228
+ .filter_map(|component| match component {
229
+ std::path::Component::Normal(value) => value.to_str(),
230
+ std::path::Component::RootDir => Some(""),
231
+ _ => None,
232
+ })
233
+ .collect::<Vec<_>>()
234
+ .join("/")
235
+ }
236
+
237
+ #[cfg(test)]
238
+ mod tests {
239
+ use super::*;
240
+
241
+ fn scan_fixture(files: &[&str]) -> Result<ScannedProject, Box<dyn std::error::Error>> {
242
+ let fixture = tempfile::tempdir()?;
243
+ write(&fixture, "packages/app/pubspec.yaml", "name: app\n")?;
244
+ write(&fixture, "packages/shared/pubspec.yaml", "name: shared\n")?;
245
+ write(
246
+ &fixture,
247
+ "packages/app/example/pubspec.yaml",
248
+ "name: example\n",
249
+ )?;
250
+ for file in files {
251
+ write(&fixture, file, "void value() {}\n")?;
252
+ }
253
+ Ok(crate::scan_project(fixture.path())?)
254
+ }
255
+
256
+ fn package(root: &Path, name: &str, path: &str) -> LocalPubPackage {
257
+ LocalPubPackage {
258
+ name: name.to_owned(),
259
+ root: root.join(path),
260
+ pubspec_path: root.join(path).join("pubspec.yaml"),
261
+ }
262
+ }
263
+
264
+ fn write(fixture: &tempfile::TempDir, path: &str, source: &str) -> Result<(), std::io::Error> {
265
+ let path = fixture.path().join(path);
266
+ if let Some(parent) = path.parent() {
267
+ std::fs::create_dir_all(parent)?;
268
+ }
269
+ std::fs::write(path, source)
270
+ }
271
+
272
+ #[test]
273
+ fn matches_name_path_glob_and_excludes() -> Result<(), Box<dyn std::error::Error>> {
274
+ let project = scan_fixture(&[
275
+ "packages/app/lib/main.dart",
276
+ "packages/shared/lib/shared.dart",
277
+ ])?;
278
+ let root = project.root.clone();
279
+ let packages = vec![
280
+ package(&root, "app", "packages/app"),
281
+ package(&root, "shared", "packages/shared"),
282
+ ];
283
+
284
+ let scope =
285
+ workspace_file_scope(&project, &packages, &[String::from("packages/*,!shared")])?;
286
+
287
+ assert_eq!(
288
+ scope,
289
+ vec![
290
+ root.join("packages/app/lib/main.dart"),
291
+ root.join("packages/app/pubspec.yaml"),
292
+ ]
293
+ );
294
+ Ok(())
295
+ }
296
+
297
+ #[test]
298
+ fn uses_longest_package_root_for_nested_packages() -> Result<(), Box<dyn std::error::Error>> {
299
+ let project = scan_fixture(&[
300
+ "packages/app/lib/main.dart",
301
+ "packages/app/example/lib/main.dart",
302
+ ])?;
303
+ let root = project.root.clone();
304
+ let packages = vec![
305
+ package(&root, "app", "packages/app"),
306
+ package(&root, "example", "packages/app/example"),
307
+ ];
308
+
309
+ let scope = workspace_file_scope(&project, &packages, &[String::from("app")])?;
310
+
311
+ assert!(scope.contains(&root.join("packages/app/lib/main.dart")));
312
+ assert!(!scope.contains(&root.join("packages/app/example/lib/main.dart")));
313
+ Ok(())
314
+ }
315
+
316
+ #[test]
317
+ fn errors_when_no_package_matches() -> Result<(), Box<dyn std::error::Error>> {
318
+ let project = scan_fixture(&["packages/app/lib/main.dart"])?;
319
+ let root = project.root.clone();
320
+ let packages = vec![package(&root, "app", "packages/app")];
321
+
322
+ let Err(error) = workspace_file_scope(&project, &packages, &[String::from("missing")])
323
+ else {
324
+ panic!("missing selector should error");
325
+ };
326
+
327
+ assert!(matches!(error, WorkspaceScopeError::NoMatches { .. }));
328
+ Ok(())
329
+ }
330
+
331
+ #[test]
332
+ fn changed_paths_select_owning_workspace() -> Result<(), Box<dyn std::error::Error>> {
333
+ let project = scan_fixture(&[
334
+ "packages/app/lib/main.dart",
335
+ "packages/shared/lib/shared.dart",
336
+ ])?;
337
+ let root = project.root.clone();
338
+ let packages = vec![
339
+ package(&root, "app", "packages/app"),
340
+ package(&root, "shared", "packages/shared"),
341
+ ];
342
+
343
+ let scope = changed_workspace_file_scope(
344
+ &project,
345
+ &packages,
346
+ &[root.join("packages/shared/README.md")],
347
+ );
348
+
349
+ assert_eq!(
350
+ scope,
351
+ vec![
352
+ root.join("packages/shared/lib/shared.dart"),
353
+ root.join("packages/shared/pubspec.yaml"),
354
+ ]
355
+ );
356
+ Ok(())
357
+ }
358
+ }