Mira v1.2.0
Phase 0 of the roadmap, as far as it can go without hardware: the project has an automated
test suite for the first time, and the roadmap itself now lives in the repository.
Added
- Test suite (
npm test) — the project had none before this release- 55 unit tests over the pure logic that has historically broken: input sanitization,
keyword splitting (both,and the Persian،), the AI confidence parse and its
fail-safe hand-off, permission resolution, business hours in the Tehran timezone, and
user-agent parsing - 27 integration tests against real Postgres + Redis service containers in CI —
migrations, schema shape, multi-tenantsiteIdisolation, and message idempotency.
They self-skip withoutTEST_DATABASE_URL, sonpm teststays green on any machine - A
Testsjob in CI, running both as a required check
- 55 unit tests over the pure logic that has historically broken: input sanitization,
ROADMAP.md/ROADMAP.fa.md— the seven-phase enterprise
roadmap, checked line by line against the code before being committeddocs/PHASE0-RUNBOOK.md— step-by-step instructions for the
three Phase 0 tasks that need real hardware (WordPress install, Debian deployment,
production dashboard image), each with pass criteria
Changed
parseModelOutputmoved out ofbot-reply.tsintoapps/worker/src/ai/parse-model-output.ts
and the automation keyword splitter intosplitKeywords()inpackages/shared-types—
both were unreachable from a test before. Behaviour is unchangedAGENTS.md§9 now describes the test suite honestly: unit and integration coverage
exists, browser E2E does not
Notes
Three claims in the roadmap draft did not survive checking against the code and were
corrected before commit: the seed script contains no placeholder knowledge-base document or
offlineMessage (those are rows in a local dev database, not code), a non-default admin
password is already enforced, and the phase tags were realigned to the real version line.
The dead AI_MAX_TOKENS_PER_CONVERSATION config was confirmed real and stays scheduled for
Phase 2.
Install on a Debian/Ubuntu server
sudo dpkg -i mira_*_all.deb || sudo apt -f install
sudo mira setup && sudo mira startFull guide (all distributions, WordPress, troubleshooting):
package/INSTALL.md
— also available in Persian:
package/INSTALL.fa.md
WordPress plugin: install mira-wordpress-plugin.zip from the WordPress admin.
Docker images
ghcr.io/hami9/mira-api
ghcr.io/hami9/mira-worker
ghcr.io/hami9/mira-dashboard