Add init operation for 30 package managers

README.md

@@ -4,7 +4,7 @@ A Go library that wraps package manager CLIs behind a common interface. Part of
 
 ## What it does
 
-Translates generic operations (install, add, remove, list, outdated, update, vendor, resolve) into the correct CLI commands for each package manager. Define what you want to do once, and the library figures out the right command for npm, bundler, cargo, go, or any other supported manager.
+Translates generic operations (init, install, add, remove, list, outdated, update, vendor, resolve) into the correct CLI commands for each package manager. Define what you want to do once, and the library figures out the right command for npm, bundler, cargo, go, or any other supported manager.
 
 ```go
 translator := managers.NewTranslator()
@@ -83,7 +83,7 @@ cmd, _ = translator.BuildCommand("bundler", "add", managers.CommandInput{
 | helm | helm | Chart.lock |
 | brew | homebrew | - |
 
-Most managers support: install, add, remove, list, outdated, update, resolve. Some also support vendor and path. Some managers (maven, gradle, sbt, lein) have limited CLI support for add/remove operations.
+Most managers support: init, install, add, remove, list, outdated, update, resolve. Some also support vendor and path. Some managers (maven, gradle, sbt, lein) have limited CLI support for add/remove operations. A few global installers (brew, gem, cpanm) and managers with interactive-only init (maven, pip, sbt) do not have init support.
 
 ## Installation
 
@@ -211,6 +211,7 @@ Built-in policies include AllowAllPolicy, DenyAllPolicy, and PackageBlocklistPol
 
 | Operation | Description |
 |-----------|-------------|
+| `init` | Initialize a new project with manifest file |
 | `install` | Install dependencies from lockfile |
 | `add` | Add a new dependency |
 | `remove` | Remove a dependency |
@@ -229,6 +230,18 @@ Built-in policies include AllowAllPolicy, DenyAllPolicy, and PackageBlocklistPol
 | `frozen` | Fail if lockfile would change (CI mode) |
 | `json` | Output in JSON format (where supported) |
 
+### Initializing projects
+
+The `init` operation creates a new project with the package manager's default manifest file. This is useful for creating temporary projects for dependency resolution or scaffolding new projects.
+
+```go
+manager, _ := managers.Detect("/path/to/empty/dir")
+result, _ := manager.Init(ctx)
+// Creates package.json (npm), Gemfile (bundler), Cargo.toml (cargo), etc.
+```
+
+**Managers with init support:** npm, pnpm, yarn, bun, bundler, cargo, gomod, uv, poetry, deno, composer, swift, pub, mix, nuget, gradle, helm, conan, conda, stack, lein, rebar3, cabal, cocoapods, nimble, opam, luarocks, shards, vcpkg, renv
+
 ### Getting package paths
 
 The `path` operation returns the filesystem path to an installed package, useful for source exploration or editor integration:

definitions/bun.yaml

@@ -18,6 +18,12 @@ detection:
   priority: 25  # Higher than npm/yarn/pnpm when bun lockfile present
 
 commands:
+  init:
+    base: [init, -y]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:
@@ -92,6 +98,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/bundler.yaml

@@ -18,6 +18,12 @@ version_detection:
   pattern: '(\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:
@@ -125,6 +131,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/cabal.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'cabal-install version (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init, -n, -p, resolve-tmp]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [build, --only-dependencies]
     flags:
@@ -63,6 +69,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - list
   - outdated

definitions/cargo.yaml

@@ -18,6 +18,12 @@ version_detection:
   pattern: 'cargo (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init, --lib]
+    exit_codes:
+      0: success
+      1: error
+
   # cargo fetch downloads dependencies without building
   # cargo build would also work but does more than just install
   install:
@@ -129,6 +135,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/cocoapods.yaml

@@ -17,6 +17,12 @@ detection:
   priority: 10
 
 commands:
+  init:
+    base: [init]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:

definitions/composer.yaml

@@ -17,6 +17,13 @@ detection:
   priority: 10
 
 commands:
+  init:
+    base: [init, -n]
+    default_flags: [--name, resolve/tmp]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:
@@ -91,6 +98,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - add
   - add_dev

definitions/conan.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'Conan version (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [new, resolve-tmp, -d, basic]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install, .]
     flags:
@@ -82,6 +88,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - add
   - remove

definitions/conda.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'conda (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [create, -n, resolve-tmp, --yes]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install, --yes]
     base_overrides:
@@ -96,6 +102,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/deno.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'deno (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     flags:
@@ -86,6 +92,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add

definitions/gomod.yaml

@@ -18,6 +18,12 @@ version_detection:
   pattern: 'go(\d+\.\d+(?:\.\d+)?)'
 
 commands:
+  init:
+    base: [mod, init, resolve-tmp]
+    exit_codes:
+      0: success
+      1: error
+
   # go mod download fetches dependencies
   install:
     base: [mod, download]
@@ -124,6 +130,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - add
   - remove

definitions/gradle.yaml

@@ -16,6 +16,12 @@ version_detection:
   pattern: 'Gradle (\d+\.\d+(?:\.\d+)?)'
 
 commands:
+  init:
+    base: [init, --type, java-library, --dsl, groovy]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [dependencies, --write-locks]
     flags:
@@ -77,6 +83,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - list
   - resolve

definitions/helm.yaml

@@ -15,6 +15,12 @@ version_detection:
   pattern: 'v(\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [create, resolve-tmp]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [dependency, build]
     flags:
@@ -74,6 +80,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - add
   - remove

definitions/lein.yaml

@@ -14,6 +14,12 @@ version_detection:
   pattern: 'Leiningen (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [new, resolve-tmp]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [deps]
     exit_codes:
@@ -67,6 +73,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - list
   - resolve

definitions/luarocks.yaml

@@ -14,6 +14,12 @@ version_detection:
   pattern: 'LuaRocks (\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init, resolve-tmp]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install, --deps-only, .]
     flags:
@@ -81,6 +87,7 @@ commands:
       pattern: 'Installed in:\s+(\S+)'
 
 capabilities:
+  - init
   - install
   - add
   - remove

definitions/mix.yaml

@@ -17,6 +17,12 @@ detection:
   priority: 10
 
 commands:
+  init:
+    base: [new, resolve_tmp]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [deps.get]
     flags:
@@ -86,6 +92,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - install_frozen
   - list

definitions/nimble.yaml

@@ -15,6 +15,12 @@ version_detection:
   pattern: 'nimble v(\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init, -y]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install, --depsOnly]
     flags:
@@ -79,6 +85,7 @@ commands:
       1: error
 
 capabilities:
+  - init
   - install
   - add
   - remove

definitions/npm.yaml

@@ -19,6 +19,12 @@ version_detection:
   pattern: '(\d+\.\d+\.\d+)'
 
 commands:
+  init:
+    base: [init, -y]
+    exit_codes:
+      0: success
+      1: error
+
   install:
     base: [install]
     base_overrides:
@@ -100,6 +106,7 @@ commands:
       1: partial
 
 capabilities:
+  - init
   - install
   - install_frozen
   - add