Starstruk Logo MarkStarstruk

v0.1.2

mahimailabs/voicegatewayv0.1.2May 11, 2026by mahimairaja

AI Summary

A housekeeping release focused on code organization and standardization, consolidating Dockerfiles, refactoring modules into subpackages, and establishing strict public API contracts via `__all__` declarations.

Key Highlights

  • Consolidation of Dockerfiles under a `docker/` directory.
  • Refactoring of top-level modules into subpackages with re-export shims.
  • Establishment of standard root metadata files (CHANGELOG, CONTRIBUTING, SECURITY).
  • Enforcement of code style conventions using linters like ruff and mypy.

Breaking Changes

  • `voicegateway.combined_server` import path is deprecated; callers must migrate to `voicegateway.server.combined` before v0.2.0.

New Features

  • Code reorganization into subpackages
  • Docker consolidation
  • API contract definition via `__all__`
  • Linter enforcement for code style

Full Release Notes

**v0.1.2 — Project polish**

Housekeeping pass before v0.2.0 metrics work begins. No buyer-facing behavior changes, no new features, no breaking imports. The repo tree resets to a clean baseline: tests live where you expect them, Dockerfiles consolidated under `docker/`, scripts use underscore convention, three top-level modules folded into subpackages with re-export shims, standard root metadata in place, public-API contract via `__all__` declared on every subpackage, code-style conventions documented with linter audits.

**Highlights**

- **REQ-VG-POLISH-001** — 9 loose root tests moved into `tests/{cli,integration,providers,middleware}/` subdirs; `tests/integration/` is the new home for cross-cutting tests.
- **REQ-VG-POLISH-002** — Dockerfiles consolidated under `docker/` (`voicegateway.Dockerfile`, `dashboard.Dockerfile`); compose, CI, fly deploy, and doc examples updated.
- **REQ-VG-POLISH-003** — `scripts/record-streaming-fixtures.py` and `scripts/smoke-v005-inference.py` renamed to underscore convention; 15 reference sites updated.
- **REQ-VG-POLISH-004** — `voicegateway/{server,combined_server,reconcile}.py` folded into subpackages with re-export shims; every v0.1.x import path keeps working.
- **REQ-VG-POLISH-005** — root `CHANGELOG.md`, `CONTRIBUTING.md`, `SECURITY.md`, `.editorconfig` added. CHANGELOG is canonical; docs site mirrors it at build time.
- **REQ-VG-POLISH-006** — `__all__` declared on all 18 `voicegateway/**/__init__.py` files; 73-test parametrized contract enforces the surface.
- **REQ-VG-POLISH-007** — `docs/contributing/code-style.md` names every convention; ruff selectors carry inline rationale; mypy tightened with three flags and 8 dead `# type: ignore` comments cleaned up.

**Migration notes**

`voicegateway/combined_server.py` is now a temporary re-export shim flagged for removal in v0.2.0. Downstream callers using `from voicegateway.combined_server import build_combined_app` should plan to migrate to `from voicegateway.server.combined import build_combined_app` before v0.2.0. No other v0.1.x import paths break; the new contract tests enforce this on every PR.

**Refinery and Foundry**

- Refinery: https://linear.app/mahimairaja/document/v012-project-polish-refinery-a7db34a7f039
- Foundry: https://linear.app/mahimairaja/document/v012-project-polish-foundry-blueprint-b10f71c25e21