Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[Unreleased]

[v1.47.1]

CLI

Fix header-only dependency handling in vix run

Fixed incorrect linking of header-only dependencies in auto-generated CMake

The CLI no longer attempts to link all inferred dependency aliases blindly.
Detect compiled dependencies using CMakeLists.txt

Only dependencies that define build targets are treated as compiled libraries.
Link only valid CMake targets

Uses if(TARGET ...) to ensure safe and correct linking during build.
Avoid linking header-only libraries

Header-only packages without CMake targets are no longer passed to target_link_libraries, preventing build errors.
Fixed runtime error

target_link_libraries(... gk::pdf) target not found

This restores full support for header-only packages while maintaining correct behavior for compiled dependencies.

[v1.47.0]

CLI

Improved dependency handling for compiled packages

Fixed vix run dependency handling for compiled libraries

Dependencies are now correctly integrated into CMake with proper add_subdirectory ordering, ensuring reliable builds.
Load dependencies from vix.lock

The CLI now uses the lockfile as the source of truth instead of relying on header-only detection, improving determinism and correctness.
Support for header-and-source packages

Packages that include both headers and source files are now treated as compiled libraries and handled correctly during build.
Improved initialization order for dependencies

Ensures correct build order for interdependent modules such as core, wal, store, and others.
Enhanced ScriptCMake reliability

Better handling of non header-only dependencies, making builds more robust across different package types.

[v1.46.0]

CLI

Improved command UX and dependency detection

Standardized help output across commands (add, remove, new, p2p)

All commands now follow a consistent structure with:
- clear usage
- practical examples
- explanation of what happens
Switched to product-style CLI help

Help messages are now easier to read and more developer-friendly, improving onboarding and daily usage.
Improved overall CLI readability and developer experience
- cleaner output
- more consistent formatting
- better command interactions
Fixed dependency install detection

The vix deps command no longer incorrectly reports "up to date" on first install.
Ensured consistent behavior across all CLI commands

[v1.45.0]

CLI

Improved install experience and cache management

Simplified and cleaner output for vix install
Reduced noise and improved readability during dependency installation
New vix cache command

Manage local cache directly from the CLI:

vix cache

This introduces better control over cached packages and improves developer workflows.

General UX improvements across CLI commands
More consistent output formatting
Better feedback during operations
Smoother command interactions

[v1.44.0]

Registry

Deterministic dependency installation

Introduced deterministic dependency resolution for vix install

Dependencies are now installed in a fully predictable and reproducible way, ensuring consistent builds across environments.
Improved registry integration
- Better handling of dependency graphs
- More reliable installs across machines and CI environments
Submodule synchronization improvements
- Ensures correct versions are resolved and linked during installation

[1.43.0] - 2026-03-14

Added

Add vix.json for all modules, enabling registry and package management.
Introduce universal header-and-source support for core modules.
New CLI utilities for publishing, syncing, and displaying tips in registry workflows.
Low-level async runtime improvements (scheduler, coroutines, timers, thread pool).
Enhanced HTTP caching engine with pluggable stores, policies, and keying strategies.
Extended crypto primitives: AEAD, HMAC, KDF, signatures, and random utilities.
DB module improvements: pool, drivers, transactions, migrations.
WebSocket & P2P enhancements: client/server support, edge sync, discovery, transport layers.
Middleware & P2P HTTP: routing, session, pipeline, and security modules.
Validation header-only improvements: schemas, rules, and error handling.

Changed

CLI Ui.hpp improved tip display formatting.
Core printing and reflection system refined for runtime debugging.
JSON module: release v1.10.0 with registry integration.
Minor API adjustments in ORM, sync, utils, and net modules.
Bug fixes and header/source consistency across modules.

Fixed

Registry publish errors: local registry tips added when pull --ff-only fails.
WebRPC and validation publishing conflicts resolved.
Various module header/source mismatches corrected.

Notes

Version 1.43.0 consolidates registry, package management, and module release workflow.
All modules now include a vix.json for Vix package system integration.
Developers should run vix registry sync before publishing new versions to avoid pull conflicts.

v1.42.0

Core

New universal printing system

Added a powerful type-aware printing engine inspired by Python's print().

The new vix::print module can render most common C++ types automatically:

STL containers (vector, map, set, etc.)
tuples and pairs
std::optional
std::variant
smart pointers
chrono types
filesystem paths
nested structures

Example:

#include <vix/print.hpp>

vix::print(42, "hello", std::vector{1,2,3});

Additional utilities:

vix::pprint() – multi-line pretty printing
vix::sprint() – format values to string
vix::print_each() – iterate and display ranges
vix::print_table() – map-style table display
vix::print_stats() – numeric container statistics
vix::print_diff() / vix::print_check() – debugging helpers

The system is extensible via:

operator<<
ADL vix_format(...)
vix::formatter<T> specialization

Examples

Added new printing examples:

examples/print/

v1.41.0

CLI

Improved interactive navigation

Interactive menus now support both arrow keys and Vim-style navigation.

Action	Keys
Up	`↑` or `k`
Down	`↓` or `j`
Confirm	`Enter` or `l`
Cancel	`Esc`, `h`, `q`
Toggle	`Space`
Toggle all	`a`

This improves usability on compact keyboards and Vim-style workflows.

v1.40.0

CLI

feat(cli): support vix new . (in-place project scaffold)

You can now scaffold a Vix project directly in the current directory:
```
vix new .
```
If the directory is not empty, Vix prompts before overwriting template files.
feat(cli): support npm-style scoped packages (@namespace/name)

Vix now supports scoped package names similar to npm:
```
vix add @vix/http
vix add @gaspardkirira/api_app
```
This enables clearer ecosystem organization and registry namespaces.

[v1.39.0]

CLI

Self-healing vix tests

vix tests now automatically configures and builds the project when CTest is not ready.

Changes

Automatically runs vix check --tests if the build directory does not exist
Automatically builds when CTestTestfile.cmake is missing
Re-resolves the preset build directory after auto-build
Preserves the selected preset to avoid mismatched build directories

Impact

vix tests works on fresh clones without requiring a manual vix check
Removes unnecessary friction in the test workflow
Improves overall CLI robustness

[v1.38.0]

Vix now supports automatic version resolution when adding packages.

You can run:

vix add namespace/name

and Vix will resolve the latest version automatically. This release also improves transitive dependency installation and ensures vix.lock correctly pins the resolved commit for deterministic builds.

[v1.37.0] 🚀 New: `--auto-deps` for single-file C++ (script mode)

You can now use libraries installed from the Vix registry directly inside a single .cpp file:

vix run server.cpp --auto-deps

Automatically detects installed dependencies in .vix/deps
Injects the correct -I include paths
Avoids duplicate include flags
No CMakeLists.txt required

🔼 New: `--auto-deps=up`

vix run src/server.cpp --auto-deps=up

In addition to the script directory, Vix can now search for .vix/deps in parent directories. Useful for nested layouts and running scripts from subfolders.

🧠 Improvements

Introduced AutoDepsMode (None, Local, Up)
Proper validation and error handling for invalid --auto-deps values
Improved vix run --help documentation
Cleaner separation between runtime args (--args) and compiler flags (--)

[v1.36.3] - 2026-02-19

Improved

CLI – `vix publish`

Generate a rich registry entry when publishing a new package:
- Adds structured api metadata (format, generatedBy, updatedAt)
- Includes constraints, dependencies, exports, maintainers, and quality
- Derives defaults from vix.json when available
Automatically refreshes api.updatedAt on every publish
Keeps backward compatibility with existing registry entries
Ensures versions is always a valid object before insertion

Why this matters

Registry entries are now:

More consistent
Self-describing
Future-proof for tooling and validation
Closer to production-grade metadata from first publish

v1.36.2

Fix

publish: always include published version (tag + commit) inside registry entry versions field

Why

Registry validation requires a non-empty versions object.

Previously, vix publish created a registry entry with:

{
  "versions": {}
}

This caused the validate_registry_pr workflow to fail before auto-merge.

Result

Registry PRs are now immediately valid
Auto-merge works reliably without manual intervention
No need to manually patch index/*.json
registry_index_from_tags remains compatible

Impact

Publishing a new library version is now fully automated and stable.

v1.36.1

Improvements

CLI: improve vix publish messaging when triggering registry index updates
Better feedback after tag push and registry workflow trigger
Clearer output when version is already registered

Registry

Confirmed fully automatic tag-driven registry workflow
Auto PR creation + auto-merge stabilized using bot token

Internal

Minor CLI output refinements
No breaking changes

v1.36.0

✨ Added

vix unpublish command Allows package owners to remove an existing registry entry in a controlled way.
Full CLI integration for unpublish flow (dispatch + command wiring).
Tag-driven registry compatibility (CLI aligned with automated index_from_tags workflow).

🔄 Improved

Registry sync stability (vix registry sync) with stricter reset and checkout handling.
Publish / remove flows aligned with Git tag–based version indexing.
CLI registry commands hardened for consistency with automated GitHub Actions pipeline.

🛠 Internal

Registry index now derives owner/repo from repo.url instead of namespace.
Improved compatibility with automated registry version generation from Git tags.
CLI prepared for fully automated registry maintenance workflow.

This release strengthens the reliability of the Vix Registry and completes the tag-driven publication lifecycle.

v1.35.3

Changed

CLI (new) : Generate modern vix.json for header-only libraries.
Replace deprecated repo field with repository.
Set type to "header-only" for --lib template.
Add include, keywords, and authors fields to generated manifest.

Notes

This is a patch release improving CLI scaffolding consistency with the Vix Registry specification. No runtime behavior changes.

v1.35.2

Fixed

CLI (Doctor): Fix MSVC build failure (which_vix not declared on Windows).
Removed duplicate <vix/utils/Env.hpp> include.
Added missing <cstdio> include for _popen / popen usage.
Minor MSVC compatibility adjustments.

Notes

This is a patch release focused on Windows/MSVC build stability. No runtime behavior changes.

[v1.35.1] - 2026-02-14

Fixed

Silenced MSVC warnings in CLI module:
- C4505 (unreferenced static functions removed)
- C4189 (unused local variable)
Scoped Unix-only helpers under #ifndef _WIN32 to avoid Windows-only compilation warnings.
Removed deprecated std::getenv usage in CLI commands in favor of vix::utils::vix_getenv (MSVC C4996 clean).

Improved

Cleaner cross-platform compilation (Windows + Linux/macOS).
More deterministic Windows builds (no internal linkage noise).
Safer environment variable handling in doctor, upgrade, and uninstall.

Internal

Minor CLI refactoring to ensure functions are only compiled where used.
No behavioral changes.

v1.35.0

CLI --- Install Lifecycle & Environment Diagnostics

This release introduces a complete install lifecycle for the Vix CLI, including environment diagnostics, secure upgrades, uninstall logic, and install metadata tracking.

✨ New

`vix doctor`

Environment and install health checker.

Detects OS and architecture
Detects current binary location
Reads install.json metadata
Checks PATH consistency
Verifies required tools (curl/wget, tar, sha256, etc.)
Optional GitHub latest release check (--online)
JSON output mode (--json)
Proper exit codes for CI usage

Example:

vix doctor
vix doctor --online
vix doctor --json --online

`vix upgrade`

Secure binary upgrade mechanism.

Resolves latest tag from GitHub
Verifies sha256
Verifies minisign (when available)
Atomic install (tmp + move)
Writes structured install.json metadata
Preserves install directory

Example:

vix upgrade

`vix uninstall`

Robust uninstall command.

Removes current binary
Supports --all to remove all detected binaries in PATH
Supports --purge to delete local store/cache
Gracefully handles permission errors
Provides sudo hint when required
Post-check detects remaining binaries in PATH

Example:

vix uninstall
vix uninstall --all --purge

🔐 Install Metadata (`install.json`)

Upgrades now generate structured metadata:

{
  "repo": "vixcpp/vix",
  "version": "v1.35.0",
  "installed_version": "v1.35.0",
  "installed_at": "...",
  "os": "linux",
  "arch": "x86_64",
  "install_dir": "...",
  "download_bytes": 0,
  "asset_url": "..."
}

This enables:

Reliable diagnostics (doctor)
PATH validation
Upgrade comparison
Future telemetry-safe tooling

🎯 Help Output Improvements

The CLI help output is now structured and linked:

Section-based layout
Quick start block
Install lifecycle commands surfaced
Documentation links included
Registry link added

Improves discoverability and developer experience.

Stability

This release does not modify runtime modules.
Changes are isolated to the CLI module.

Vix.cpp continues to move toward a fully self-managed, production-grade runtime.

v1.22.13: sync cli/middleware/p2p and extend middleware example

update submodules: cli, middleware, p2p
tweak umbrella CMakeLists for module sync/build stability
update examples/mega_middleware_routes.cpp

Changelog

v1.22.4

Fixed

Fixed release and CI failures caused by missing spdlog::spdlog_header_only on clean environments.
Added a robust FetchContent fallback for header-only spdlog to ensure reproducible builds.
Stabilized cross-compilation and GitHub Actions release workflows.

Build

Utils module now auto-fetches spdlog in header-only mode when not provided by the system.
Preserved ABI safety by enforcing header-only logging dependencies.

Notes

No runtime behavior changes.
No API breakage.
This release only improves build reliability and release stability.

v1.22.3 — 2026-01-27

Fixed

cmake(umbrella): fix Asio detection and fallback handling
- Ensure standalone Asio is correctly detected from third_party/asio
- Prevent hard failure when Asio is missing on CI runners
- Centralize Asio include path via vix::thirdparty_asio interface target
- Stabilize P2P build by fixing Asio integration at umbrella level

v1.22.2 — 2026-01-27

Fixed

p2p: fix Asio integration
- Asio is now strictly provided by the umbrella build
- Remove implicit <asio.hpp> includes and non-deterministic paths
- Reliable builds in local, CI, and downstream projects
core: fix header guard in Request.hpp
- Prevent collisions and undefined behavior in modular builds

Build

Clarify umbrella vs standalone responsibilities
Deterministic and reproducible CMake configuration

v1.22.1 — 2026-01-25

Changed

core: unify core modules and clarify responsibilities
build: harmonize CMake and package configuration
modules: sync cache, cli, db, net, p2p, and sync

Added

GitHub release workflow
Security layout structure
Advanced middleware routing example

Docs

Clarify scope and non-goals
Document Vix Console contract and logging separation

v1.22.0 — Runtime Console & DX Stabilization

Release focus: developer experience, runtime safety, and clear separation between dev console and production logging.

✨ New

Vix Console (core)

Introduces a Node.js–inspired, zero-config runtime console available directly via:

#include <vix/console.hpp>

vix::console.log("Hello");

Designed for developer-facing output with strict runtime guarantees.

🧠 Design & Runtime Guarantees

Zero configuration by default

Console works immediately after #include
No init calls
No setup required

Safe defaults

Default level: info
debug OFF by default
log == info
warn / error → stderr
log / info / debug → stdout

Performance contract

If a level is filtered, the call is near-zero cost
- No message construction
- No allocation
- No lock
- No I/O

Thread-safe, atomic output

Each console call emits a single atomic line

Stable environment configuration

Supports:
- VIX_CONSOLE_LEVEL
- NO_COLOR
- VIX_COLOR
Environment is read once (startup / first use)
Behavior is fixed afterward

Minimal anti-spam protection

Prevents accidental performance collapse from excessive log / info usage
warn and error are never suppressed

📖 Documentation

New documentation: Vix Console

Clearly defines:
- Scope
- Guarantees
- Constraints
- Non-goals

Explicit separation

vix::console → runtime / developer output
vix::utils::Logger → production logging, structured output

Clarified non-goals

No console.table
No console.group
No console.time
No console.count

Advanced debugging and observability belong to vix::utils::Logger.

🔒 Philosophy Clarification

Vix Console is intentionally not a production logger
Borrows Node.js developer trust
Enforces C++ runtime discipline
Designed to be safe even if developers do not read documentation

🔗 Commits

docs(core): document Vix Console contract and integrate core console module
docs(console): clarify scope, non-goals, and logger separation

v1.21.1

chore(cli): bump CLI submodule to v1.19.12 (cleaner sanitizer output, unified timeout logic, refined code frames)
docs/examples: add examples/vix_routes_showcase.cpp (HTTP routes + query params showcase)

Vix.cpp v1.21.0

This release stabilizes the new DB core module, improves CLI runtime output, and fixes several build/link issues across modules.

Highlights

DB/ORM separation is now fully aligned: vix::db is the low-level core layer, vix::orm remains optional sugar on top.
CLI runtime output and error UX were refined to be clearer and less noisy.
Improved reliability for MySQL detection/linking in diverse environments.

CLI (modules/cli)

Fix: prevent duplicate runtime logs in some failure paths.
Improve: runtime error detectors and diagnostics formatting.
Improve: UX cleanup for run/dev flows (clearer output, less noise).

DB Core (modules/db)

Fix: CMake/source/linkage issues across DB drivers.
Fix: MySQL Connector/C++ discovery via fallback alias target (more robust CI/local setups).
Improve: driver linkage consistency and feature flag reporting.

Umbrella / Modules

Introduced vix::db as a core module and decoupled ORM tooling/drivers accordingly.
Synced submodules after DB/ORM compatibility fixes.

Upgrade notes

If you enable ORM, it automatically implies DB.
If MySQL is enabled, ensure Connector/C++ is available (the fallback alias helps when CMake configs are missing).

v1.20.1 — Improved CLI Error UX & Build Feedback

✨ CLI — Error reporting & diagnostics

Introduce Python-like compiler error rendering with code frames (file:line:column + surrounding context)
Highlight only the faulty line with a red caret (^) for instant readability
Safely truncate very long lines with UTF-8–aware ellipsis
Add precise, Vix-style hints for common mistakes (e.g. Response::json() misuse)
Hide verbose alternative diagnostics unless log level is debug or trace
Improve run / script error reporting for clearer, actionable diagnostics

🔨 CLI — Build output & Ninja integration

Restore live Ninja progress output ([x/y %]) during builds
Filter noisy compiler command output in live mode
Keep full raw build logs in build.log for post-mortem diagnostics
Let ErrorHandler display structured, human-readable errors on failure
Introduce progress-only build output mode
Fix unused variables and header warnings in build pipeline

🧩 Internal

Minor internal cleanups to support improved error UX
No breaking changes

v1.20.0 — Modules, Registry & Dependency Workflow (Latest)

✨ Nouveautés majeures

CLI modules overhaul

Introduction d’un layout app-first pour les modules Vix :

Includes explicites et sûrs
Règles de linkage claires et déterministes
Préparation à un écosystème modulaire stable et scalable

Workflow Registry & Dépendances amélioré

Nouveau vix deps command pour inspecter et gérer les dépendances
Correction du flux registry pour les dépendances transitives
Meilleure cohérence entre registry local, store projet et modules

🧰 CLI

Registry plus robuste pour les projets multi-modules
Amélioration UX des commandes liées aux dépendances
Base solide pour le futur workflow registry publish / consume

🧱 Architecture

Clarification nette entre :

Modules applicatifs
Modules système
Dépendances registry
Réduction des comportements implicites (includes / link automatiques)

v1.19.2

✨ Nouveautés

CLI : deps command
Inspection claire des dépendances projet
Support du registry dans le graphe de dépendances

🐛 Correctifs

Correction du workflow de résolution des dépendances registry
Stabilisation du store projet lors des ajouts / suppressions de deps

v1.19.1

✨ Nouveautés

Registry publish workflow
Commande CLI dédiée pour publier vers le registry Vix
Préparation du pipeline : développeur → registry → consommateurs

🔧 Maintenance

Bump CLI pour intégrer le workflow registry publish
Nettoyage interne du flux release

v1.19.0

✨ Nouveautés majeures

Registry Git-based (V1)

sync, search, add
Fonctionnement 100 % offline-first après synchronisation

Project-scoped store

Dépendances isolées par projet
Nettoyage et GC du store

Améliorations UI CLI

Couleurs unifiées
Helpers UI partagés
Sorties plus lisibles et cohérentes

v1.18.2

🐛 Correctifs

Ajustements release et tooling
Stabilisation du pipeline de versioning

v1.18.1

🛠 Correctifs critiques

Suivi correct des vendored CMake deps
Correction des erreurs d’installation chez les développeurs
Bump CLI associé

v1.18.0 — Modular networking & secure P2P foundation

Highlights

Major architectural cleanup and modular extraction
P2P stack now fully decoupled from core
Cache, net, and sync promoted to first-class modules
Clear dependency layering across the ecosystem

🧩 New Modules

net Low-level networking primitives and reachability utilities (connectivity probing, network helpers).
cache Standalone HTTP cache engine with pluggable stores (memory, LRU, file-based).
sync Offline-first synchronization engine (WAL, outbox, retries, sync workers).

🧠 Core

Removed embedded cache and sync implementations
Core now focuses strictly on:
- HTTP server
- routing
- request / response lifecycle
- sessions & configuration
Much cleaner public surface and faster compile times

🧱 Middleware

Explicit dependency on cache (no implicit coupling)
JSON and utils remain optional
Scoped strictly to HTTP middleware pipeline
Extensive smoke test coverage restored and stabilized

🌐 P2P

Integrated v0.5.1 (latest)

P2P v0.5.1 — Latest

Removed dependency on vix::core
Requires vix::net only
sync, cache, and utils are optional
Cleaner, modular build
Internal refactors (discovery, node, router)

P2P v0.5.0

Complete secure transport layer (Phase 6)
Encrypted envelopes with AEAD
Per-peer session keys derived from handshake
Replay protection using nonce counters
Decrypt-before-dispatch logic
Handshake & control messages kept plaintext
Foundation for secure WAL / Outbox sync (Phase 6.6)

P2P v0.4.0

AEAD support (encrypt + authenticate)
Extended envelope format (nonce + auth tag)
Session key storage per peer
Secure channels with nonce tracking
NullCrypto implementation for development

P2P v0.3.0

HTTP bootstrap service for peer discovery
Bootstrap.hpp and BootstrapHttp.cpp
Extended node lifecycle for bootstrap integration
Manual test registry added

net ├─ cache ├─ sync └─ p2p └─ (optional sync integration)

core └─ middleware └─ cache (required)

This release establishes a clean, scalable foundation for:

offline-first sync
secure edge routing
future P2P + WAL integration
long-term maintainability

📐 Architectural State (v1.18.0)

v1.17.7 — Build & Run Reliability Improvements

🐛 Fixed

CLI (run): Reuse the last successful build preset instead of defaulting to dev-ninja, ensuring consistent behavior between vix build and vix run.
CLI (run): Cleaned up script build error handling to provide clearer and more actionable diagnostics.
CLI (run): Improved logging of environment declarations during script execution for better debugging and transparency.

🛠 Improvements

More predictable run flow after builds across presets.
Smoother iterative workflows (build → run) with fewer surprises.

✅ Notes

No breaking changes. This release focuses on stability and correctness of the CLI build/run pipeline.

v1.17.6 — CLI Stability & Toolchain Fixes

🐛 Fixed

CLI: Fixed --linker lld|mold integration.
- Fast linker flags are now applied via CMAKE_*_LINKER_FLAGS (EXE, SHARED, MODULE) to ensure the selected linker is reliably used at link time.
- Removed incorrect propagation of linker flags through CMAKE_C_FLAGS / CMAKE_CXX_FLAGS, preventing CMake “unused variables” warnings and inconsistent behavior.
CLI: Improved run / build flow integration.
- Unified preset and build-directory resolution across RunDetail, RunFlow, and RunCommand.
- Fixed edge cases that could lead to missing helper symbols or mismatched build state during execution.

🛠 Internal

Cleaner and more predictable linker configuration under CMake.
Improved robustness of the CLI execution pipeline.
No breaking changes.

✅ Notes

This release focuses on CLI correctness, toolchain reliability, and a more stable execution model when using fast linkers and advanced build configurations.

v1.17.5 — Performance & CLI Stability Release

🚀 Performance

core: remove logger context and console synchronization from HTTP access logs, reducing contention under load
utils: snapshot spdlog logger instances to avoid global mutex contention and improve logging throughput

🖥️ CLI & Tooling

cli(run): remove capture-based configure phase and switch to live execution for more predictable runtime behavior
cli: clean and stabilize CMake output during configure while keeping build and run steps intact
cli: remove dead helpers left after the build UX rewrite

🧹 Maintenance

Internal cleanup across cli, core, and utils modules
No breaking changes

✅ Notes

This release focuses on runtime performance, log scalability, and CLI robustness, especially under high load and iterative development workflows.

v1.17.4 — 2026-01-02

🔧 Fixed

CMake / Packaging
- Fixed find_package(Vix) failures caused by missing Boost::filesystem / Boost::system targets.
- Ensured all required dependencies are resolved before loading VixTargets.cmake.
- Removed deprecated FindBoost behavior in exported configs (CMP0167-safe).
- Stabilized consumer builds on macOS (AppleClang + Homebrew Boost) and Linux.
Core
- Removed Boost::filesystem from vix::core public link interface.
- Restricted Boost dependency to Boost::system only (Asio / Beast).
- Updated HTTP server internals and headers accordingly.
- Prevented Boost symbols from leaking into consumer CMake targets.
WebSocket
- Cleaned vix::websocket exported link interface.
- Fixed missing Boost::system target errors in downstream applications.
- Improved module behavior with modern CMake dependency resolution.

✨ Improved

More robust umbrella CMake configuration for multi-module installs.
Clearer separation between internal dependencies and public API surface.
Better cross-platform developer experience when using:
```
find_package(Vix CONFIG REQUIRED)
```

v1.17.3

Added

vix build --target <triple>: cross-compilation support with auto-generated CMake toolchain.
- Automatically generates vix-toolchain.cmake
- Passes CMAKE_TOOLCHAIN_FILE and VIX_TARGET_TRIPLE
- Cache-safe: reuses build directories when configuration is unchanged
- Compatible with --preset, --static, --clean
Optional --sysroot <path> support for cross builds
- Enables proper discovery of target libraries (e.g. zlib)
- Designed for real cross environments (ARM, embedded, SBCs)

Improved

Smarter build directory reuse via configuration signatures
More explicit error messages when cross toolchains or sysroots are missing

v1.17.0

Added

vix install command to install/setup a Vix project or .vixpkg artifact.
Middleware integrated into the default Vix runtime (works out-of-the-box).
A full set of middleware-focused examples:
- Auth (API key, JWT, RBAC)
- CORS (basic/strict)
- CSRF (strict + demos)
- Rate limiting (servers + pipeline demos)
- IP filtering (servers + pipeline demos)
- Body limit
- Compression
- HTTP cache
- ETag
- Security headers
- Static files
- JSON/form/multipart parsing
- Group builder examples

Changed

Updated CMake configuration and VixConfig.cmake to expose the middleware stack correctly for downstream projects.
Updated README/docs to reflect the new install workflow and middleware usage.

Notes

No breaking changes expected.

v1.16.1 — REPL Isolation & Stability

✨ Improvements

Fully isolated the REPL from CLI commands (build, run, check, tests, verify)
Disabled execution of CLI commands and flags inside the REPL
Removed CLI flags from REPL autocompletion to avoid misleading suggestions
Disabled help <command> and CLI command listing inside the REPL
Improved REPL UX consistency with a sandboxed, Bun/Deno-like experience

🧠 Behavior Changes

The REPL is now a pure interactive sandbox for:
- math expressions
- variables
- JSON literals
- print / println
- Vix API (cd, cwd, env, args, exit, etc.)
All project-related CLI commands must now be executed outside the REPL

🛠 Internal

Removed remaining runtime dependencies between the REPL and the CLI dispatcher
Simplified REPL command completion logic

1.16.0 — 2025-01-XX

🚀 Highlights

REPL is now the default mode Running vix starts the interactive shell automatically (no more vix repl).
Modern runtime experience Behavior aligned with Python, Node.js, and Deno.

✨ Added

Default interactive REPL when running vix
Dedicated README_REPL.md with:
- Math expressions
- Variables
- JSON usage
- print / println
- Built-in Vix API examples
Improved CLI documentation (docs/modules/cli.md)

🧠 Improved

REPL argument evaluation:
- Correct handling of string literals
- Math expressions with variables
- Mixed arguments (println("x =", x+1))
REPL execution flow stability
Error messages clarity in interactive mode
Overall CLI UX consistency

🧹 Changed

Removed vix repl as a required entry point
REPL is now the primary interaction mode
CLI documentation updated to reflect new behavior

🔧 Internal

REPL flow refactoring and cleanup
Better separation between CLI dispatcher and REPL runtime
Documentation structure improvements

⚠️ Notes

JSON literals must be strictly valid JSON ({"key":"value"}, not {key, value})

[1.15.0] - 2025-12-20

Added

Changed

Removed

v1.15.0 — 2025-12-20

Added

vix check: validate a project or compile a single .cpp file without execution.
vix tests: run project tests (alias of vix check --tests).
vix verify: verify packaged artifacts and signatures.
CLI reference documentation (docs/vix-cli-help.md).
Pull Request template to standardize contributions.

Changed

Improved global CLI help output formatting and readability.
Updated README with clearer CLI usage and script mode examples.
Updated security testing documentation with realistic, tool-based practices.
Improved contributing guidelines and code of conduct.

Removed

Deprecated SECURITY.md in favor of a more accurate security testing guide.

Notes

This release significantly improves CLI usability, testing workflow, and project governance.
Recommended upgrade for all users relying on the Vix CLI.

[1.14.7] - 2025-12-19

Added

Changed

Removed

v1.14.7 — CLI Packaging Stability Update

Fixed

Fixed vix pack potentially blocking when minisign required interactive input.
Prevented unintended blocking behavior when signing is auto-detected.

Added

Integrated new CLI signing modes from vix-cli v1.9.2:
- --sign=auto (default, non-blocking)
- --sign=never
- --sign=required (fail-fast, explicit)

Improved

More predictable and professional packaging workflow.
Clear separation between optional and mandatory cryptographic signing.
Improved developer experience for CI/CD and non-interactive environments.

[1.14.6] - 2025-12-19

Added

Changed

Removed

1.14.6 — 2025-XX-XX

CLI

Updated modules/cli to the latest version.
Improved vix pack user experience:
- Minisign password prompt is now visible when --verbose is enabled.
- Prevents silent blocking during package signing.
Added vix verify command:
- Manifest v2 validation.
- Payload digest verification.
- Optional minisign signature verification.
- Auto-detection of dist/<name>@<version> packages.
Improved CLI help output:
- Clearer command grouping.
- Better descriptions for pack and verify.
- More practical usage examples.

Packaging & Security

Clear separation between signed and unsigned packages.
Environment-based key discovery:
- VIX_MINISIGN_SECKEY for package signing.
- VIX_MINISIGN_PUBKEY for signature verification.
More robust verification feedback and strict modes.

Developer Experience

Smoother packaging and verification workflow.
More predictable CLI behavior with explicit output.
Improved diagnostics in verbose mode.

This release focuses on polishing the CLI, strengthening package security, and delivering a professional packaging & verification workflow for Vix.

[1.14.5] - 2025-12-19

Added

Changed

Removed

v1.14.5 — 2025-01-18

Added

New CLI command: vix pack.
Package a Vix project into dist/<name>@<version>/.
Optional .vixpkg archive generation.
Manifest v2 (vix.manifest.v2) with:
- Package metadata (name, version, kind, license).
- ABI detection (OS, architecture).
- Toolchain information (C++ compiler, standard, CMake).
- Layout flags (include, src, lib, modules, README).
- Exports and dependencies from vix.toml.

Security

Payload integrity via SHA256 content digest.
Stable payload hashing excluding generated files.
Optional Ed25519 signature using minisign:
- meta/payload.digest
- meta/payload.digest.minisig
- Secret key via VIX_MINISIGN_SECKEY.

Changed

CLI help updated to include vix pack.
Internal CLI and middleware refactoring to support packaging flow.

Notes

Signing is optional and enabled only when minisign is available.
Manifest generation avoids self-referential hashing.

[1.14.4] - 2025-12-17

Added

Changed

Removed

v1.14.4

Fixed

Fixed ORM migrator build after driver abstraction refactor.
Replaced deprecated MySQL connection APIs with the factory-based Connection interface.
Fixed CI failures caused by abstract Connection instantiation.
Ensured the migrator compiles correctly when database drivers are disabled.

[1.14.3] - 2025-12-17

Added

Changed

Removed

v1.14.3 — 2025-12-17

Fixed

Fixed JSON umbrella integration: <vix.hpp> now reliably exposes vix::json builders (o, a, kv).
Fixed missing OrderedJson type in core RequestHandler.
Fixed compilation errors in examples relying on implicit JSON availability.
Fixed vix_json CMake include paths for both build-tree and install-tree usage.

Internal

Improved Core ↔ JSON module boundary consistency.
Stabilized umbrella build (vix::vix) dependency propagation.

Compatibility

No breaking API changes.
Existing applications continue to work without modification.

[1.14.2] - 2025-12-17

Added

Changed

Removed

v1.14.2 — 2025-12-17

Fixed

core/http: fixed RequestHandler build failures by using the local OrderedJson alias and preventing name lookup from resolving to POSIX ::send() (now uses this->send() internally).
json: improved unified include header vix/json.hpp and ensured OrderedJson exposure is consistent across the JSON module.

[1.14.1] - 2025-12-17

Added

Changed

Removed

v1.14.1 — Stability, Cache & Build Hygiene Release

Release date: 2025-12-17

✨ Highlights

Finalized HTTP GET cache system across core and middleware.
Integrated cache as a first-class middleware in the request pipeline.
Added comprehensive cache and middleware tests.
Achieved strict warning-free builds (-Weffc++) across all modules.

🧱 Core & Middleware

Completed HTTP cache implementation (Memory, File, LRU stores).
Introduced cache utilities (CacheKey, HTTP header helpers).
Clean integration with HTTPServer, Router, and Session.
Added HTTP cache middleware for transparent GET caching.
Added periodic middleware support for timed/background tasks.
Middleware pipeline refined and stabilized.

🛠️ Build & Quality

Enforced strict warning hygiene with -Weffc++.
Fixed:
- sign-conversion warnings
- ignored return values (chdir, setenv, etc.)
- [[nodiscard]] API misuse in examples
Isolated GCC/libstdc++ false positives (std::regex) without masking project warnings.
Improved and unified CMake configuration across all modules.

🧪 Tests

Added and stabilized HTTP cache smoke tests.
Added middleware-level tests validating cache behavior.
Improved test CMake configuration for consistency.

📦 Modules Updated

core
middleware
cli
websocket
orm
utils
json

🔒 Stability & Compatibility

No breaking API changes.
Focus on correctness, performance, and long-term maintainability.
Stable foundation for upcoming offline-first and sync/WAL features.

[1.14.0] - 2025-12-14

Added

Changed

Removed

ORM Migrations & CLI Stabilization

Added

New ORM migrations engine with file-based .up.sql / .down.sql support
Internal migrator tool (vix_orm_migrator) used by the CLI
vix orm command with subcommands:
- migrate
- rollback
- status
Support for CLI flags:
- --db, --dir, --host, --user, --pass, --steps
Environment-based configuration via VIX_ORM_*
Automatic project root and migrations directory detection
New ORM documentation:
- Migrations overview
- Batch insert
- Repository & QueryBuilder examples
Application-level ORM workflow (no longer tied to ORM module paths)

Changed

ORM examples moved from source tree to documentation
ORM usage clarified to always target application databases
CLI help improved with full ORM usage examples
README updated to reflect new ORM & CLI capabilities

Fixed

Logger initialization issues (static auto& logger) across:
- core
- utils
- middleware
- websocket
CMake linkage inconsistencies between modules
Incorrect default database usage during migrations (vixdb vs app DB)
Rollback failures caused by mismatched migration directories

Removed

Legacy ORM example source files
Deprecated ORM documentation pages
Old migrate_init example binaries

Notes

Databases must be created manually before running migrations
Migrations are now strictly application-scoped

[1.13.3] - 2025-12-12

Added

Changed

Removed

v1.13.3 — Patch Release

Fixed

Fixed SQLite integration in WebSocket module (missing includes, symbols, WAL usage).
Fixed SqliteMessageStore compilation errors with proper sqlite3.h usage.
Split WebSocket router implementation into .cpp (no implementation in headers).
Fixed Long Polling and WebSocket bridge consistency.

Build / CMake

ORM examples are now automatically disabled when MySQL support is OFF.
Prevented MySQL-dependent ORM examples from breaking default builds.
Improved umbrella CMake example filtering logic.
Safer linking of optional modules (ORM, WebSocket).

Internal

Reduced header coupling and improved compile hygiene.
More robust optional-feature handling (SQLite / MySQL / ORM).

[1.13.2] - 2025-12-12

Added

Changed

Removed

WebSocket

Add SQLite-based message store with WAL support (SqliteMessageStore)
Introduce long-polling fallback for unstable or offline-first environments
Improve WebSocket client lifecycle (reconnect, heartbeat, write queue)
Fix header/source separation issues (remove cpp logic from headers)
Normalize message payload handling using typed JSON { type, payload }
Improve router and server API consistency
Internal cleanup and error-handling improvements

ORM

Fix CMake integration issues when used from umbrella Vix project
Ensure ORM targets are correctly exported and linkable by Vix apps
Minor build-system cleanups

Internal

Synchronize websocket and orm modules with umbrella repository
Improve build stability and warning cleanup

[1.13.1] - 2025-12-12

Added

Changed

Removed

[1.13.0] - 2025-12-12

Added

Changed

Removed

🚀 Highlights

Stable ORM support: vix::orm is now cleanly exported and linkable from external applications.
Simplified application CMake: apps only link what they use (vix::vix, vix::orm).
Improved developer experience with vix new, vix build, and vix dev.

✨ Added

Exported vix::orm target via the main VixTargets umbrella.
Robust MySQL Connector/C++ detection with fallback imported target.
Cleaner README template generated by vix new.
Explicit ORM opt-in in application CMake (target_link_libraries(app PRIVATE vix::orm)).

🔧 Changed

ORM no longer forces MySQL dependencies on core-only applications.
Application CMake templates are now minimal and predictable.
CLI scaffolding aligns with real-world usage (vix dev, ORM optional).
Internal CMake logic cleaned and normalized across modules.

🐛 Fixed

Undefined references to sql::mysql::get_driver_instance().
Broken CMake detection when MySQL is installed without config files.
Incorrect or obsolete ORM CMake config exports.
Inconsistent ORM behavior between installed and local builds.

🧹 Removed

Obsolete VixOrmConfig.cmake.in.
Redundant MySQL pre-seeding logic in generated applications.

[1.12.5] - 2025-12-11

Added

Changed

Removed

feat(orm): full ORM integration into Vix build system for v1.12.4

Connected vix::orm to the top-level CMakeLists for correct package export.
Updated VixConfig.cmake.in to export ORM targets (vix::orm, drivers, includes).
Refreshed ORM examples: batch_insert_tx, transactions, migrations, querybuilder, error handling.
Updated CLI generator (vix new) to support ORM-ready application templates.
Synced new commits across modules/orm and modules/cli to match the 1.12.4 API.

[1.12.4] - 2025-12-11

Added

Changed

Removed

v1.12.4: major examples overhaul + core/cli/websocket sync

• Examples refactor: - Removed outdated examples (CRUD, ORM demos, legacy error-handling, trace_route, etc.) - Introduced new structured example layout: examples/http/ examples/http_crud/ examples/http_ws/ examples/orm/ examples/websocket/ - Added EXAMPLES_README.md and WebSocket example readme - Updated main.cpp with new Request/Response API

• WebSocket module: - Updated advanced + simple examples to new Runtime API - Added chat_room, simple_server, simple_client - Updated examples/websocket CMakeLists

• Core updates: - Improved Request/Response facade - Updated App.cpp, RequestHandler, Config, and umbrella headers - Synced module changes with the new HTTP DX

• CLI updates: - Integrated core/websocket changes for dev/run modes

• Root project: - Updated top-level CMakeLists.txt - Cleaned README for v1.12.4

This version brings a unified example structure and prepares Vix for the new DX-first API.

[1.12.3] - 2025-12-10

Added

Changed

Removed

[v1.12.3] – Added Dev Mode for Projects

Added

New vix dev workflow for full applications (not only single-file scripts).
Automatic project hot-reload using run_project_watch for CMake-based Vix apps.
Brand-new DevCommand (vix dev) integrated into the CLI.
Spinner-based progress indicators for Configure / Build steps.
Improved detection between script mode and project mode.

Changed

RunCommand routing now supports watch mode for full project runs.
Unified dev experience: vix dev now forwards to the correct execution flow with consistent UX.
Cleaner CLI output and improved developer hints/messages.

Fixed

Watcher not triggering correctly for some CMake-based projects.
Missing includes and namespace issues inside the CLI module.
Several small UX inconsistencies (e.g., duplicate “Ctrl+C” messages).

[1.12.2] - 2025-12-09

Added

Changed

Removed

chore: prepare v1.12.2 (stdout auto-config, CLI refinements, submodule bumps)

This release improves stdout behavior, developer experience, and aligns all submodules with the latest work.

🧩 Core

Added StdoutConfig (automatic stdout line-buffering via VIX_STDOUT_MODE)
Apps launched via Vix runtime now default to line-buffered stdout
Ensures consistent server log flushing across all HTTP/WebSocket apps

🧩 CLI

Improved RunCommand: unified stdout export for presets/fallback/script mode
More robust command runner with filtered live output + proper ErrorHandler usage
Updated README and build configuration
Ensures deterministic behavior for all build/run workflows

🔧 Umbrella (root)

Updated CMakeLists.txt and README.md
Bumped submodules: • modules/cli → latest dev commit • modules/core → latest dev commit
Synced submodule pointers to match development branches

Version: v1.12.2

[1.12.1] - 2025-12-08

Added

Improved CLI UX for vix run: cleaner output flow, removal of unwanted help banner at the end.
More robust app detection during vix run to correctly handle root-level and nested applications.
Additional CMake configuration flags exported for external consumers (VIX_WITH_JSON, VIX_WITH_OPENSSL, VIX_WITH_BOOST_FS, VIX_WITH_MYSQL, VIX_HAS_ORM).

Changed

Major cleanup and restructuring of cmake/VixConfig.cmake.in:
- find_dependency(...) now used instead of leaking unknown imported targets.
- Exported targets now properly grouped under vix::vix for external linking.
- Installation layout aligned with modern CMake packaging flow.
Updated root CMakeLists.txt to correctly install umbrella exports, avoiding missing-target errors during find_package(Vix CONFIG).
Synchronized all submodules to the latest development commits (core, utils, cli).

Fixed

Fixed application linking errors caused by missing transitive exports in v1.12.0.
Fixed CLI module not exporting correct symbols for app execution.
Fixed a regression where Vix runtime installs failed when JSON/backend options changed.
Fixed configuration issues where external apps (using the generated config package) could not resolve dependencies.

Removed

Deprecated internal export macros that are no longer necessary with the new generated config.

[1.12.0] - 2025-12-08

Added

Changed

Removed

[1.10.5] - 2025-12-06

Added

Changed

Removed

[1.10.4] - 2025-12-06

Added

Changed

Removed

[1.10.2] - 2025-12-06

Added

Changed

Removed

[0.10.2] - 2025-11-07

Added

Changed

Removed

[1.10.1] - 2025-11-01

Added

Changed

Removed

[1.10.0] - 2025-11-01

Added

Changed

Removed

[1.9.3] - 2025-10-27

Added

Changed

Removed

[1.9.2] - 2025-10-27

Added

Changed

Removed

[1.9.1] - 2025-10-27

Added

Changed

Removed

[1.9.0] - 2025-10-26

Added

Changed

Removed

[1.8.4] - 2025-10-26

Added

Changed

Removed

[1.8.3] - 2025-10-26

Added

Changed

Removed

[1.8.2] - 2025-10-26

Added

Changed

Removed

[1.8.0] - 2025-10-25

Added

Changed

Removed

[1.7.1] - 2025-10-23

Added

Changed

Removed

[1.7.0] - 2025-10-13

Added

Changed

Removed

[1.6.0] - 2025-10-12

Added

Changed

Removed

[1.5.1] - 2025-10-11

Added

Changed

Removed

[1.5.0] - 2025-10-10

Added

Changed

Removed

[1.4.0] - 2025-10-10

Added

Changed

Removed

[1.3.3] - 2025-10-09

Added

Changed

Removed

[1.3.2] - 2025-10-09

Added

Changed

Removed

[1.3.1] - 2025-10-09

Added

Changed

Removed

[1.3.0] - 2025-10-09

Added

Changed

Removed

[1.2.0] - 2025-10-08

Added

Changed

Removed

[1.1.1] - 2025-10-07

Added

Changed

Removed

[1.1.0] - 2025-10-07

Added

Changed

Removed

[1.0.2] - 2025-10-06

Added

Changed

Removed

[1.0.1] - 2025-10-06

Added

Changed

Removed

[1.0.0] - 2025-10-06

Added

Changed

Removed

[0.1.2] - 2025-10-06

Added

Changed

Removed

[0.1.1] - 2025-10-06

Added

Changed

Removed

Added

Modular C++ framework structure with core, orm, cli, docs, middleware, websocket, devtools, examples.
App class for simplified HTTP server setup.
Router system supporting dynamic route parameters (/users/{id} style).
JSON response wrapper using nlohmann::json.
Middleware system for request handling.
Example endpoints /hello, /ping, and /users/{id}.
Thread-safe signal handling for graceful shutdown.
Basic configuration system (Config class) to manage JSON config files.

Changed

Logger integrated using spdlog with configurable log levels.
Improved request parameter extraction for performance.

Fixed

Path parameter extraction to correctly handle string_view types.
Fixed default response for unmatched routes (404 JSON message).

[0.1.0] - 2025-10-06

Added

Initial release of core module with working HTTP server.
Basic routing system and request handlers.
Simple example endpoints demonstrating JSON and text responses.
Thread-safe server shutdown handling.
Integration of performance measurement scripts (FlameGraph ready).

Changed

Optimized route parameter parsing to avoid boost::regex overhead.

Fixed

Compilation errors due to string_view mismatch in request handler.
Minor bug fixes in App initialization and signal handling.

[0.0.1] - Draft

Project skeleton created.
Basic CMake setup and folder structure.
Placeholder modules for core, orm, and examples.

FilesExpand file tree

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

Changelog

[Unreleased]

[v1.47.1]

CLI

[v1.47.0]

CLI

[v1.46.0]

CLI

[v1.45.0]

CLI

[v1.44.0]

Registry

[1.43.0] - 2026-03-14

Added

Changed

Fixed

Notes

v1.42.0

Core

Examples

v1.41.0

CLI

v1.40.0

CLI

[v1.39.0]

CLI

Self-healing vix tests

Changes

Impact

[v1.38.0]

You can run:

[v1.37.0] 🚀 New: --auto-deps for single-file C++ (script mode)

🔼 New: --auto-deps=up

🧠 Improvements

[v1.36.3] - 2026-02-19

Improved

CLI – vix publish

Why this matters

v1.36.2

Fix

Why

Result

Impact

v1.36.1

Improvements

Registry

Internal

v1.36.0

✨ Added

🔄 Improved

🛠 Internal

v1.35.3

Changed

Notes

v1.35.2

Fixed

Notes

[v1.35.1] - 2026-02-14

Fixed

Improved

Internal

v1.35.0

CLI --- Install Lifecycle & Environment Diagnostics

✨ New

vix doctor

vix upgrade

vix uninstall

🔐 Install Metadata (install.json)

🎯 Help Output Improvements

Stability

Changelog

v1.22.4

Fixed

Build

[v1.37.0] 🚀 New: `--auto-deps` for single-file C++ (script mode)

🔼 New: `--auto-deps=up`

CLI – `vix publish`

`vix doctor`

`vix upgrade`

`vix uninstall`

🔐 Install Metadata (`install.json`)