v0.9.3

[0.9.3] — 2026-05-23

UX hotfix for first-time users. Removes every cryptic "module not
found" error from the install → init → dev path: every failure now
prints an actionable upgrade command, and the README leads with the
install that actually makes admina dev work.

Fixed

• admina dev no longer crashes with ModuleNotFoundError: uvicorn
  when the [proxy] extra is missing. Local-mode dev now does an
  early check and prints an actionable message: which extras to
  install, or how to fall back to the Docker stack. No traceback.
• admina doctor no longer reports "All checks passed" when
  admina dev is guaranteed to fail. Missing [proxy] is now a
  surfaced issue with the exact upgrade command.
• admina doctor extras table fixed. numpy and scikit-learn
  are now correctly grouped under [proxy] (where they actually
  belong since 0.9.2), not [nlp].
• admina doctor spaCy diagnostic is venv-safe. Previously
  suggested python -m spacy download en_core_web_sm, which on uv
  managed virtualenvs silently installs into a different interpreter
  (the one that owns pip on PATH). The new message points at the
  canonical python -m spacy download command and the direct
  wheel URL (uv pip install <github-url>) so users on either tool
  have a path that lands the model in the right venv. The missing
  model is now a soft warning (PII redaction still works in
  regex-only mode), not a doctor failure.
• admina init "Next steps" adapts to the install. Only suggests
  admina dev when [proxy] is installed; only suggests admina dev --stack when Docker is on PATH. Missing prerequisites are surfaced
  inline with the upgrade command. python main.py is always shown
  because the SDK works with any install.

Docs

• README Quick Start leads with pip install "admina-framework[proxy]" (the install that makes admina dev
  work). pip install admina-framework (SDK only) is demoted to an
  "Advanced" footnote for users embedding the SDK without the local
  dev server.

---

v0.9.2

[0.9.2] — 2026-05-22

Hotfix release. Fixes three day-one bugs that prevented new users from
seeing a working admina dev after pip install.

Fixed

• admina dev now boots with [proxy] only. Previous versions
  crashed at startup with ModuleNotFoundError: No module named 'spacy'
  unless the [nlp] extra was also installed. spaCy is now imported
  lazily; without it, PII redaction runs in regex-only mode (still
  covers email, phone, SSN, IBAN, IP, credit card and EU national IDs).
• numpy and scikit-learn moved from [nlp] to [proxy]. They
  are core dependencies of the LoopBreaker (proxy guardrail), not
  NLP-specific. pip install admina-framework[proxy] now installs
  everything the proxy actually needs.
• Dashboard no longer blanks out when one endpoint fails.
  /api/dashboard/infra previously returned HTTP 500 when
  UPSTREAM_MCP_URL was empty or unreachable, which (via Promise.all
  in the SPA) blanked every widget. The endpoint now reports
  not_configured / unreachable cleanly, and the dashboard uses
  Promise.allSettled so a single failing endpoint never wipes the
  rest of the UI.
• admina doctor no longer prints tracebacks for missing optional
  plugin dependencies. A plugin whose import fails because of a
  missing optional dep now logs a single Skipping plugin … — optional dependency '…' not installed line. Real plugin bugs still log a full
  traceback.

Internal

• Funding link in .github/FUNDING.yml points to the dedicated sponsor
  landing page (https://admina.org/sponsor/).
• admina-core bumped to 0.9.2 (sync release) — no Rust changes,
  but the crate / wheel / sdist versions now track admina-framework so
  the two artefacts always carry the same number on PyPI, crates.io,
  and ghcr.io. From this release on, every published artefact in the
  monorepo (admina-framework, admina-core, admina-proxy image,
  admina-dashboard image) ships with the same version. A new CI job
  (scripts/check-versions.py) blocks PRs that drift the manifests
  out of alignment.

---

v0.9.1

[0.9.1] — 2026-05-21

Hotfix release.

Fixed

• admina-core: now ships as a single abi3-py311 wheel and uses
  dynamic_lookup on macOS, so the same artefact loads cleanly on any
  Python 3.11+ interpreter.
• admina-framework[nlp]: the en_core_web_sm spaCy model is no
  longer declared as a direct dependency (PyPI does not accept URL-pinned
  deps in published wheels). After installing the [nlp] extra, run:
  python -m spacy download en_core_web_sm.
• Release pipeline: admina-core wheel matrix temporarily excludes
  Intel Mac (macos-13) to avoid multi-hour runner queues. Intel Mac
  users install from sdist.

Notes

• admina-core 0.9.0 is yanked; install admina-core 0.9.1 or later.
• admina-framework 0.9.0 continues to work standalone (pure-Python
  governance pipeline) — upgrade is only required if you also install
  admina-core.