aube deploy

• Usage: aube deploy [FLAGS] <TARGET>
• Effect: modifies state

Deploy a workspace package into a target directory with deps inlined

Arguments

• <TARGET> — Target directory to deploy into.

  Must be empty or not yet exist.

Flags

• -D --dev — Install only devDependencies.

  Implemented by stripping dependencies and optionalDependencies from the deployed package.json before install runs.

• --no-optional — Skip optionalDependencies

• -P --prod — Install only production dependencies (default).

  Accepted for pnpm compatibility.

  Aliases: --production

• --no-prod — Deploy every dependency kind (production + dev + optional).

  Opts out of the implicit --prod deploy default. Useful when a deployed package needs its devDependencies at runtime (test harnesses, build-step deploys). Combine with --no-optional to drop optionals while keeping prod + dev. Mutually exclusive with --prod and --dev.

• --offline — Fail if any metadata or tarball isn't already in the local cache.

  Never hits the network. Useful in multi-stage Dockerfiles where an earlier aube install already populated the store: deploy then reproduces a prod-only tree without re-fetching anything.

• --prefer-offline — Prefer cached metadata over revalidation; only hit the network on a miss.

• -h --help — Print help

Lockfile

• --frozen-lockfile — Error if the lockfile drifts from package.json.
• --no-frozen-lockfile — Always re-resolve, even if the lockfile is up to date.
• --prefer-frozen-lockfile — Use the lockfile when fresh, re-resolve when stale.

Network

• --fetch-retries <N> — Number of retry attempts for failed registry fetches.

  Overrides fetchRetries / fetch-retries from .npmrc / aube-workspace.yaml when set. Pair with --fetch-timeout to fail fast in scripted test runs.

• --fetch-retry-factor <N> — Exponential backoff factor between retry attempts.

  Overrides fetchRetryFactor / fetch-retry-factor from .npmrc / aube-workspace.yaml when set. Integer-only; fractional values like 1.5 are rejected.

• --fetch-retry-maxtimeout <MS> — Upper bound (ms) on the computed retry backoff.

  Overrides fetchRetryMaxtimeout / fetch-retry-maxtimeout from .npmrc / aube-workspace.yaml when set.

• --fetch-retry-mintimeout <MS> — Lower bound (ms) on the computed retry backoff.

  Overrides fetchRetryMintimeout / fetch-retry-mintimeout from .npmrc / aube-workspace.yaml when set.

• --fetch-timeout <MS> — Per-request HTTP timeout in milliseconds.

  Overrides fetchTimeout / fetch-timeout from .npmrc / aube-workspace.yaml when set. Covers the whole request (headers and body together).

• --registry <URL> — Override the default registry URL for this invocation.

  Use this npm registry URL for package metadata, tarballs, audit requests, dist-tags, and registry writes.

Virtual store

• --disable-global-virtual-store — Force the shared global virtual store off for this invocation.

  Packages are materialized inside the project's virtual store instead of symlinked from the shared tree under <cacheDir>/virtual-store/v1/ (by default ~/.cache/aube/virtual-store/v1/).

  Aliases: --disable-gvs

• --enable-global-virtual-store — Force the shared global virtual store on for this invocation.

  Overrides CI's default per-project materialization and the disableGlobalVirtualStoreForPackages auto-disable heuristic.

  Aliases: --enable-gvs