Skip to content

Known limitations in VAMOS 1.0.0

These limitations are part of the first public release scope. They describe unsupported behavior rather than future compatibility promises.

Algorithms and numerical behavior

  • VAMOS minimizes every objective. Users must transform maximization objectives themselves.
  • A valid population size may depend on an algorithm's reference directions or weight lattice. Incompatible sizes fail instead of being adjusted silently.
  • The strict evaluation budget must be at least the resolved population size.
  • Deterministic same-environment runs do not imply bitwise equality across different kernels, BLAS implementations, operating systems, architectures, or optional third-party engines.

Backends and optional dependencies

  • NumPy is the reference path. Numba accelerates selected kernels rather than every operation; MooCore accelerates selected indicators rather than whole algorithms.
  • Explicitly selecting an unavailable backend is an error. VAMOS does not install dependencies during a run, verification, or replay.
  • Optional research frameworks and model-based tuning packages have their own Python and operating-system constraints.
  • The release CI claims Python 3.10, 3.11, and 3.12 on Linux, and Python 3.12 on Windows and macOS. Other interpreter/platform combinations are unclaimed.

Run artifacts and replay

  • Public readers support the 1.0.0 run schema. Internal pre-public formats are unsupported and must be regenerated.
  • Exact replay is available only for reconstructable registered built-in components with exact material environment compatibility.
  • Custom Python, plugins, cross-backend execution, and best-effort environment matches are not exact-replay targets.
  • SHA-256 evidence detects modification; it is not an authenticity signature.

Durable studies

  • Study mutation is single-owner. Do not run, resume, or retry the same study concurrently from multiple processes.
  • Study execution is sequential in 1.0.0. Distributed workers, multiprocess ownership, and cross-process cancellation are unsupported.
  • Cancellation is cooperative and local to the process that owns execution.

Analysis and tuning

  • Statistical analysis, visualization, MCDM helpers, tuning, and racing APIs remain experimental and may change in a minor release.
  • Users are responsible for selecting indicators, reference points, sample sizes, and statistical tests appropriate for their scientific claim.

Studio and generated code

  • Studio is experimental and is intended for trusted local use. It is not a multi-user hosted service.
  • AST checks, restricted builtins, process isolation, resource limits, and timeouts are best-effort controls, not a security sandbox.
  • Reviewed Python executes with the current operating-system user's permissions. Remote binding increases exposure and requires explicit opt-in.
  • LLM-generated code is displayed for review and is never executed automatically.

Plugins and providers

  • Plugin descriptors, custom component interfaces, and LLM-provider integrations are experimental and are not covered by the 1.x stable API.
  • Loading and verification never import recorded plugins or contact providers.

Static typing

  • The stable API and strict release scope pass mypy. Full-source typing still has a frozen diagnostic ratchet and is not yet zero-error; new or increased diagnostics fail the release gate.