Detect package managers from filesystem trees

README.md

@@ -51,10 +51,10 @@ cmd, _ = translator.BuildCommand("bundler", "add", managers.CommandInput{
 | yarn | npm | yarn.lock |
 | bun | npm | bun.lock |
 | deno | deno | deno.lock |
-| bundler | gem | Gemfile.lock |
-| gem | gem | - |
+| bundler | rubygems | Gemfile.lock |
+| gem | rubygems | - |
 | cargo | cargo | Cargo.lock |
-| gomod | go | go.sum |
+| gomod | go | - |
 | pip | pypi | requirements.txt |
 | uv | pypi | uv.lock |
 | poetry | pypi | poetry.lock |
@@ -65,7 +65,7 @@ cmd, _ = translator.BuildCommand("bundler", "add", managers.CommandInput{
 | pub | pub | pubspec.lock |
 | cocoapods | cocoapods | Podfile.lock |
 | swift | swift | Package.resolved |
-| nuget | nuget | packages.lock.json |
+| nuget | nuget | packages.lock.json, project.assets.json |
 | maven | maven | - |
 | gradle | maven | gradle.lockfile |
 | sbt | maven | - |
@@ -77,14 +77,16 @@ cmd, _ = translator.BuildCommand("bundler", "add", managers.CommandInput{
 | shards | shards | shard.lock |
 | cpanm | cpan | cpanfile.snapshot |
 | lein | clojars | - |
-| vcpkg | vcpkg | vcpkg.json |
+| vcpkg | vcpkg | - |
 | conan | conan | conan.lock |
 | renv | cran | renv.lock |
 | helm | helm | Chart.lock |
 | brew | homebrew | - |
 
 Most managers support: install, add, remove, list, outdated, update, resolve. Some also support init, vendor and path. Some managers (maven, gradle, sbt, lein) have limited CLI support for add/remove operations.
 
+Detection-only definitions are available for Julia Pkg, Carthage, Elm, Dub, Haxelib and Nix. These definitions identify project files but do not define commands.
+
 ## Installation
 
 ```bash
@@ -132,6 +134,32 @@ func main() {
 }
 ```
 
+### Detecting managers from files
+
+`DetectFS` and `DetectAllFS` accept any `fs.FS`, including an on-disk directory, a Git tree or an in-memory test filesystem. Detection does not execute package manager commands.
+
+```go
+detector := managers.NewDetector(translator, runner)
+for _, def := range defs {
+    detector.Register(def)
+}
+
+detections, err := detector.DetectAllFS(repoFS, ".", managers.FileDetectOptions{
+    OnConflict: managers.ConflictUseFirst,
+})
+```
+
+`GitPkgsFileDetectionPolicy` preserves the filenames, manager priority and result order used by the git-pkgs CLI. Leave `Policy` unset to detect every registered definition.
+
+```go
+detections, err := detector.DetectAllFS(repoFS, ".", managers.FileDetectOptions{
+    OnConflict: managers.ConflictUseFirst,
+    Policy:     managers.GitPkgsFileDetectionPolicy(),
+})
+```
+
+History scanners can call `AffectedDirectories` for a changed path, then rerun detection only in the returned project directories.
+
 ### Command chaining
 
 Some operations require multiple commands. Use `BuildCommands` to get all of them:

definitions/bun.yaml

@@ -15,6 +15,7 @@ detection:
     - bun.lockb
   manifests:
     - package.json
+  ecosystem_order: 10
   priority: 25  # Higher than npm/yarn/pnpm when bun lockfile present
 
 commands:

definitions/bundler.yaml

@@ -1,5 +1,5 @@
 name: bundler
-ecosystem: gem
+ecosystem: rubygems
 binary: bundle
 version: ">=2.0.0"
 status: current
@@ -11,6 +11,8 @@ detection:
     - Gemfile.lock
   manifests:
     - Gemfile
+  default: true
+  ecosystem_order: 20
   priority: 10
 
 version_detection:

definitions/cabal.yaml

@@ -9,7 +9,9 @@ detection:
   manifests:
     - "*.cabal"
     - cabal.project
-  priority: 10
+  default: true
+  ecosystem_order: 140
+  priority: 20
 
 version_detection:
   command: [--version]

definitions/cargo.yaml

@@ -11,6 +11,8 @@ detection:
     - Cargo.lock
   manifests:
     - Cargo.toml
+  default: true
+  ecosystem_order: 30
   priority: 10
 
 version_detection:

definitions/carthage.yaml

@@ -0,0 +1,17 @@
+name: carthage
+ecosystem: carthage
+binary: carthage
+status: detection-only
+
+detection:
+  lockfiles:
+    - Cartfile.resolved
+  manifests:
+    - Cartfile
+    - Cartfile.private
+  default: true
+  ecosystem_order: 190
+  priority: 10
+
+commands: {}
+capabilities: []

definitions/cocoapods.yaml

@@ -14,6 +14,8 @@ detection:
     - Podfile.lock
   manifests:
     - Podfile
+  default: true
+  ecosystem_order: 90
   priority: 10
 
 commands:

definitions/composer.yaml

@@ -14,6 +14,8 @@ detection:
     - composer.lock
   manifests:
     - composer.json
+  default: true
+  ecosystem_order: 60
   priority: 10
 
 commands:

definitions/conan.yaml

@@ -9,6 +9,8 @@ detection:
   manifests:
     - conanfile.txt
     - conanfile.py
+  default: true
+  ecosystem_order: 170
   priority: 10
 
 version_detection:

definitions/conda.yaml

@@ -9,6 +9,8 @@ detection:
   manifests:
     - environment.yml
     - environment.yaml
+  default: true
+  ecosystem_order: 270
   priority: 10
 
 version_detection:

definitions/cpanm.yaml

@@ -10,6 +10,8 @@ detection:
     - cpanfile
     - Makefile.PL
     - Build.PL
+  default: true
+  ecosystem_order: 200
   priority: 10
 
 version_detection:

definitions/deno.yaml

@@ -9,6 +9,8 @@ detection:
   manifests:
     - deno.json
     - deno.jsonc
+  default: true
+  ecosystem_order: 130
   priority: 10
 
 version_detection:

definitions/dub.yaml

@@ -0,0 +1,15 @@
+name: dub
+ecosystem: dub
+binary: dub
+status: detection-only
+
+detection:
+  manifests:
+    - dub.json
+    - dub.sdl
+  default: true
+  ecosystem_order: 240
+  priority: 10
+
+commands: {}
+capabilities: []

definitions/elm.yaml

@@ -0,0 +1,14 @@
+name: elm
+ecosystem: elm
+binary: elm
+status: detection-only
+
+detection:
+  manifests:
+    - elm.json
+  default: true
+  ecosystem_order: 230
+  priority: 10
+
+commands: {}
+capabilities: []

definitions/gem.yaml

@@ -7,6 +7,7 @@ detection:
   lockfiles: []
   manifests:
     - "*.gemspec"
+  ecosystem_order: 20
   priority: 5
 
 version_detection:

definitions/gomod.yaml

@@ -1,16 +1,16 @@
 name: gomod
-ecosystem: golang
+ecosystem: go
 binary: go
 version: ">=1.18"
 status: current
 min_tested: "1.18"
 max_tested: "1.24.0"
 
 detection:
-  lockfiles:
-    - go.sum
   manifests:
     - go.mod
+  default: true
+  ecosystem_order: 40
   priority: 10
 
 version_detection:

definitions/gradle.yaml

@@ -9,6 +9,7 @@ detection:
   manifests:
     - build.gradle
     - build.gradle.kts
+  ecosystem_order: 100
   priority: 10
 
 version_detection:

definitions/haxelib.yaml

@@ -0,0 +1,14 @@
+name: haxelib
+ecosystem: haxelib
+binary: haxelib
+status: detection-only
+
+detection:
+  manifests:
+    - haxelib.json
+  default: true
+  ecosystem_order: 250
+  priority: 10
+
+commands: {}
+capabilities: []

definitions/lein.yaml

@@ -7,6 +7,8 @@ detection:
   lockfiles: []
   manifests:
     - project.clj
+  default: true
+  ecosystem_order: 220
   priority: 10
 
 version_detection:

definitions/maven.yaml

@@ -7,6 +7,8 @@ detection:
   lockfiles: []
   manifests:
     - pom.xml
+  default: true
+  ecosystem_order: 100
   priority: 10
 
 version_detection:

definitions/mix.yaml

@@ -14,6 +14,8 @@ detection:
     - mix.lock
   manifests:
     - mix.exs
+  default: true
+  ecosystem_order: 70
   priority: 10
 
 commands:

definitions/nix.yaml

@@ -0,0 +1,16 @@
+name: nix
+ecosystem: nix
+binary: nix
+status: detection-only
+
+detection:
+  lockfiles:
+    - flake.lock
+  manifests:
+    - flake.nix
+  default: true
+  ecosystem_order: 260
+  priority: 10
+
+commands: {}
+capabilities: []

definitions/npm.yaml

@@ -12,6 +12,8 @@ detection:
     - npm-shrinkwrap.json
   manifests:
     - package.json
+  default: true
+  ecosystem_order: 10
   priority: 10
 
 version_detection:

definitions/nuget.yaml

@@ -6,10 +6,14 @@ version: ">=6.0.0"
 detection:
   lockfiles:
     - packages.lock.json
+    - project.assets.json
   manifests:
     - "*.csproj"
     - "*.fsproj"
     - "*.vbproj"
+    - packages.config
+  default: true
+  ecosystem_order: 110
   priority: 10
 
 version_detection:

definitions/pip.yaml

@@ -10,6 +10,7 @@ detection:
     - requirements.in
     - setup.py
     - setup.cfg
+  ecosystem_order: 50
   priority: 5
 
 version_detection:

definitions/pkg.yaml

@@ -0,0 +1,16 @@
+name: pkg
+ecosystem: julia
+binary: julia
+status: detection-only
+
+detection:
+  lockfiles:
+    - Manifest.toml
+  manifests:
+    - Project.toml
+  default: true
+  ecosystem_order: 160
+  priority: 10
+
+commands: {}
+capabilities: []

definitions/pnpm.yaml

@@ -11,6 +11,7 @@ detection:
     - pnpm-lock.yaml
   manifests:
     - package.json
+  ecosystem_order: 10
   priority: 20  # higher than npm when pnpm-lock.yaml present
 
 version_detection:

definitions/poetry.yaml

@@ -16,8 +16,9 @@ detection:
     - pyproject.toml
   file_checks:
     - file: pyproject.toml
-      contains: "[tool.poetry]"
-  priority: 20  # Higher than uv for poetry-specific projects
+      match: '\[tool\.poetry\]'
+  ecosystem_order: 50
+  priority: 20
 
 commands:
   init:

definitions/pub.yaml

@@ -14,6 +14,8 @@ detection:
     - pubspec.lock
   manifests:
     - pubspec.yaml
+  default: true
+  ecosystem_order: 80
   priority: 10
 
 commands: