Changelog

1.1.1

Released: 23.03.2026

New features

  • License gate screen with expiry banner for clear license status visibility.

  • Activity feed and notification system with real-time updates.

  • API token management for machine-to-machine (CI/CD) authentication.

  • Automatic user provisioning on first OIDC login.

  • Configurable feature flags with admin API.

Improvements

  • Flexible CORS configuration for diverse deployment environments.

  • Configurable cookie security for HTTP and IP-based deployments.

  • Global license enforcement with expiry status handling.

Bug fixes

  • Fixed graph connector positions not matching layout direction.

  • Frontend stability improvements for sidebar, authentication, and loading states.

1.1.0

Released: 17.03.2026

New features

  • Full-text search with global search command palette (Ctrl+K / Cmd+K), deep linking to document sections, and typeahead suggestions.

  • Query builder UI components for custom dashboard analytics.

  • Streaming ingest endpoint for uploading documentation archives via HTTP.

  • Mermaid diagram rendering in the documentation viewer.

Improvements

  • Improved deployment documentation for new users.

  • Added installation instructions for ubt_sphinx and ubt_runtime.

Bug fixes

  • License status endpoint no longer requires authentication.

  • Fixed Mermaid diagrams not rendered in documentation viewer.

1.0.3

Released: 10.03.2026

Improvements

  • Updated ubt_sphinx status from Alpha to Beta (#861).

Bug fixes

  • Builder guard for git data collection – skip when not using ubtrace builder (#821).

  • Removed ubtrace_server.toml dependency from worker pipeline (#854).

Security

  • Resolved Dependabot vulnerabilities in direct dependencies (#832).

  • Major update of jsdom (22 → 28) to address security advisories (#852).

1.0.2

Released: 10.03.2026

New features

  • Docker strip profile for IP protection (#761) – optional build profile that strips workspace package source files from Docker images, with compose build arg support.

  • System Requirements documentation (#647) – new docs page covering hardware, software, and network requirements.

  • Git worktree scripts – helper scripts for parallel feature development with automatic port collision avoidance.

Security

  • Elasticsearch authentication (#770) – enable username/password auth for Elasticsearch connections. Both ELASTICSEARCH_USERNAME and ELASTICSEARCH_PASSWORD must be set (or both omitted).

  • Avoid leaking Elasticsearch password in Docker health check output.

  • Patch security vulnerabilities in direct npm dependencies.

Bug fixes

  • make clean now preserves imported input data (#815).

  • Exclude macOS resource fork files from offline bundle.

  • Remove keycloak-data volume to fix startup race condition.

  • Suppress duplicate warnings for missing html_favicon/html_logo in builder (#806).

Internal

  • Cleanup ubt_sphinx package (#805).

  • Regenerate package-lock.json with npm 11 for CI compatibility.

  • Skip Release packages job on ubTrace v* tag pushes.

1.0.1

Released: 05.03.2026

New features

  • Worker Pipeline (ub-worker) (#780)

    • Background NestJS service with scheduler, processor, and loaders

    • Scans input_build/ and input_src_build/ for new/changed versions

    • Runs Rust preprocessing (ubt-coverage), generates NDJSON, and loads data into PostgreSQL + Elasticsearch

Improvements

  • Unified Docker Compose service names across all environments (#769)

  • Upgraded Node.js 20 to 22 LTS (#771)

  • Use bind mounts for input_src and input_build volumes

  • Improved README-offline.md and docker-compose-prod.yml for customers (#772)

  • Updated brand logos and favicons (#791)

  • Pass UBTRACE_BUILD_VERSION to frontend in local Docker Compose

Bug fixes

  • Fixed hardcoded version in footer – replaced with dynamic useBuildInfo hook (#776)

  • Switched Keycloak clients to confidential mode (#785)

  • Restored Keycloak client Credentials tab and improved realm navigation docs (#775)

  • Hidden non-functional top bar search input (#779)

  • Replaced placeholder logo with brand SVGs, fixed theme label casing

  • Invalidate Redis license cache on startup (#758)

  • Fixed CI backmerge workflow and release job

  • Fixed smoke-test: re-added ubtrace-worker health check, pull native arm64 Elasticsearch on ARM Macs

1.0.0

Released: 27.02.2026

Breaking changes

  • KuzuDB replaced by PostgreSQL + Elasticsearch – all Sphinx-Needs data, analytics, and statistics are now stored in PostgreSQL with Elasticsearch indexing for search and filtering. KuzuDB is no longer used or required.

  • Elasticsearch is now required – the ELASTICSEARCH_ENABLED environment variable has been removed. Elasticsearch is always started alongside the backend.

  • NDJSON-only data format – the JSON fallback for bootstrap loading has been removed. All data interchange uses NDJSON files generated by the ubt-coverage Rust CLI.

  • Legacy js/ folder removed – the old Svelte-based frontend (js/ubt, js/vis-tree) has been replaced by the Next.js frontend. The docker-compose-local.yml file has also been removed.

New features

  • Next.js Frontend

    • Complete rewrite of the frontend using Next.js (React) with TypeScript

    • Design system with shadcn/ui components and Storybook

    • Branded Keycloak login theme with automatic dark mode sync

    • Coming Soon placeholders for in-progress pages

  • Schema Validation Report (#639)

    • Server-side pagination and filtering for schema violations

    • Expandable rows for nested violation children

    • Need type colors and action tooltips

    • Skeleton loading states

  • Analytics Dashboard

    • Pie chart widget for need type distribution with version selector

    • Text widget with Markdown and RST rendering support

    • Version analytics with configurable property breakdowns

    • Scoring and tier classification for artifact statistics

  • Coverage Analysis

    • Traceability coverage metrics via the ubt-coverage Rust CLI

    • Per-need and aggregate coverage reports in NDJSON format

    • Reports/coverage page in the frontend (Coming Soon)

  • Unified Builder (ub-builder) (#700)

    • Single Docker image for both Sphinx builds and NDJSON post-processing

    • Replaces the separate Sphinx builder and coverage pipeline containers

    • Supports flat input structure (without source/ subdirectory)

  • Offline / Air-Gapped Deployment (#654)

    • Pre-built offline bundle with all Docker images (tar.gz)

    • Customer-facing Makefile with make init, make up, make build-docs

    • .env.example with all 27 customer-facing environment variables

    • README-offline.md deployment guide

    • offline-load.sh and offline-verify.sh helper scripts

    • Smoke test target (make offline-smoke-test)

  • Secrets Management (dotenvx)

    • Encrypted .env files committed to git via dotenvx

    • Per-project encryption (backend, backend-e2e, frontend, root Docker Compose)

    • env-init, env-encrypt, env-decrypt, env-diff Nx targets

    • Pre-commit hook prevents committing unencrypted secrets

  • Release Automation

    • make release-bump – bump VERSION + published compose defaults + env drift check

    • make release-verify-images – verify all GHCR images exist for a tag

    • make offline-bundle – build air-gapped customer bundle

    • .env template drift detection (check_env_template.py)

Improvements

  • Docker & Infrastructure

    • Unified backend and frontend into single app Dockerfile

    • GHCR image publishing for backend, frontend, and keycloak-theme

    • Elasticsearch 9.3.0 in Docker stack

    • Full-stack make targets (make stack, make stack-dev, make prod)

    • Deprecated legacy OIDC and api-server-custom-oidc services

  • Backend (NestJS)

    • Rate limiting infrastructure with per-endpoint configuration

    • Guard array pattern for feature modules

    • Dashboard DB tables/indexes renamed to UpperCamelCase

    • Artifact schema feature module with validation endpoints

    • Artifact analytics endpoints with scope-based queries

    • Need property name mapping to Elasticsearch field names

  • Build Pipeline

    • Rust checks (cargo fmt, clippy, test) in pre-commit hook

    • Gitflow branching strategy with develop as integration branch

    • Dynamic base branch detection in pre-commit hook

    • Nx generators for feature-backend, feature-types, shared-backend, shared-types, feature-widget, and ui-wrapper

  • Documentation

    • All docs/source/ pages updated to reflect current architecture

    • C4 architecture diagrams added

    • README.md restructured as enterprise landing page

Bug fixes

  • Fixed dark mode flash after login/logout

  • Fixed search debounce resetting pagination on mount

  • Fixed horizontal scroll on mobile pagination

  • Fixed RST table formatting in text widget

  • Fixed API server health check path

  • Fixed analytics cache key collision – different query parameters (filters, versions) now produce distinct cache keys via SHA-256 hashing (#653)

  • Fixed Docker permission management for output volumes

  • Fixed NX environment variable pollution with dotenvx

  • Fixed macOS pipe buffer truncation in dotenvx scripts

  • Resolved formatting conflicts in markdown tables

0.6.0

Released: 28.11.2025

New features

  • AI Chatbot Integration

    • Basic chatbot support for documentation

    • Workaround against LLM HTML output issues

  • Sphinx-Needs Preview & Navigation

    • Preview feature for Sphinx-Needs object links in docs and reports

    • Root index page link added to TOC tree

  • MCP (Model Context Protocol) Server

    • 8 specialized tools for querying and exploring Sphinx-Needs documentation

    • Automatic database discovery and registration (org/project/version structure)

    • Support for multiple transport protocols (stdio, http, sse)

    • Tools: get_toc, get_file_sections, get_needs_schema, enumerate_attribute_values, find_needs, get_need_links, get_rendered_content, get_need_source

    • Integration with Kuzu graph database for efficient queries

    • Multi-project support with centralized database management

  • KuzuDB Integration

    • Content stored in Kuzu graph database by ubTrace Builder

    • KuzuDB build process implemented into ubTrace-Sphinx

    • Improved database queries with better performance

  • Frontend Improvements

    • Svelte 5 migration completed

    • Inline document comparison in diff viewer

    • Refactored browser history navigation handling

    • Special table view handling in diff viewer

Improvements

  • Streamlined development environment setup

  • Robust Docker permission management

  • Improved startup sequence for Docker environments

  • Better mcp_servers package structure

  • Fixed circular dependencies

Bug fixes

  • Increased unique ID length for section and directory generation

  • Fixed workaround against LLM HTML output

  • Fixed various frontend issues

  • Fixed mcp_servers package structure

  • Fixed sync metadata pre-commit hook

  • Added missing bs4 dependency

  • Fixed ubTrace Server test cases

  • Fixed local OIDC server token response internals

  • Fixed Nx checks to run only for relevant source or config changes

  • Fixed node_modules missing check for Nx commands

  • Fixed UBTRACE_SERVER_SIDEBAR_APPS_CONFIG usage

  • Fixed user info response according to OIDC server JWT payload changes

  • Fixed API server build dependencies

  • Resolved formatting conflicts

0.5.0

Released: 10.09.2025

New features

  • Schema validation report

0.4.0

Released: 08.09.2025

New features

  • Git history collection and display system for documents

  • Diff traceability analysis with expandable table rows and property comparison

  • Dark theme support with LightSwitch component

  • Code links integration for showcase project

  • Deathstar scenario showcase data

Improvements

  • Enhanced directory structure creation in builder

  • Improved documentation with clearer builder and server configuration references

  • Better project search ID handling with clearer selected options behavior

  • Reports page refactored to use Svelte instead of server-rendered HTML

  • Improved image representation in complex need layouts

  • Enhanced documentation app links

  • Better reactive search functionality in search modal

  • Scrollable tables with maximum height limits

Bug fixes

  • Fixed showcase build of ubtrace package

  • Fixed CSS alignment for centered images

  • Fixed Vis-Tree button injection on document navigation

  • Fixed dark mode styling issues

  • Fixed need ID background size

  • Fixed pagination buttons and table styling

  • Fixed column filters to search in subrows

  • Fixed table colors and hover colors

  • Logo display fixes

Technical improvements

  • Enhanced filtering with complex custom subrows support

  • Improved pagination with better button wrapping

  • Better state preservation when switching pages

0.3.2

Released:

19.08.2025

  • Reporting

  • Traceability-Tree

  • Dashboard

  • Home / Welcome page

0.1.0

Released:

21.03.2025

Initial release of ubTrace components.