Skip to content

Changelog

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

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

Unreleased

Planned Features

  • Deployment Engine: Registry push (holodeck deploy push) and cloud deployment (holodeck deploy run)
  • Plugin System: Pre-built plugin packages for common integrations

[0.5.0] - 2026-02-24

Added

  • Claude Agent SDK Backend — Native Anthropic provider support as a first-class backend (#021)
  • ClaudeBackend and ClaudeSession implementing provider-agnostic AgentBackend/AgentSession protocols
  • BackendSelector auto-routes agents by model.provider (anthropic → Claude SDK, openai/azure/ollama → Semantic Kernel)
  • ClaudeConfig Pydantic model with extended thinking, web search, bash, file system, subagents, and permission mode settings
  • AuthProvider enum supporting api_key, oauth_token, bedrock, vertex, foundry credential flows
  • Subprocess retry with exponential backoff (3 attempts) and max_turns exceeded detection
  • Structured output validation via JSON schema (file or inline)
  • Multi-Backend Abstraction Layer — Protocol-driven architecture decoupling all consumers from provider-specific types
  • AgentBackend, AgentSession, ContextGenerator protocols in lib/backends/base.py
  • ExecutionResult dataclass with response, tool calls/results, token usage, structured output, and error tracking
  • SKBackend/SKSession wrapping existing Semantic Kernel infrastructure behind the same protocols
  • Claude Tool Adapters — Bridge HoloDeck tools to Claude Agent SDK via in-process MCP server
  • VectorStoreToolAdapter and HierarchicalDocToolAdapter wrapping initialized tool instances as @tool-decorated handlers
  • build_holodeck_sdk_server() factory bundling adapters into McpSdkServerConfig
  • MCP Bridge (mcp_bridge.py) — Translates HoloDeck MCPTool configs to Claude SDK McpStdioServerConfig with env var resolution
  • OTel Bridge (otel_bridge.py) — Maps ObservabilityConfig to Claude subprocess environment variables (OTLP exporter, protocol, privacy controls)
  • Startup Validators — 6 pre-flight checks called during ClaudeBackend.initialize(): Node.js presence, credential validation, embedding provider validation, tool filtering warnings, working directory collision detection, response format schema validation
  • ClaudeSDKContextGenerator — ContextGenerator protocol implementation using Claude Agent SDK query() for contextual embeddings with batch prompts, JSON parsing, single-chunk fallback, retry logic, and concurrency control
  • Shared Tool Initializer (tool_initializer.py) — Provider-agnostic tool initialization used by both SK and Claude backends with 5-tier context generator resolution chain
  • Shared Instruction Resolver (instruction_resolver.py) — Extracted instruction loading (file or inline) from AgentFactory for cross-backend reuse
  • embedding_provider field on Agent model — Required when using provider: anthropic with vectorstore/hierarchical_document tools (Anthropic has no native embedding API)
  • context_model field on HierarchicalDocumentToolConfig — Dedicated LLM for contextual embedding generation, separate from the main agent model
  • embedding_model field on VectorstoreTool and HierarchicalDocumentToolConfig — Explicit embedding model override with cross-tool conflict detection
  • PDF Processor Package (lib/pdf_processor/) — Extracted PDF operations into dedicated package (#265)
  • heading_extractor.py: Dual-strategy heading detection — bookmark-based (preferred) with font-size fallback and fuzzy matching
  • page_extractor.py: Page-range extraction using pypdf with bounds validation
  • Multi-Field Keyword Search — Per-field boosting for keyword-based retrieval (#265)
  • Indexed fields: content (1x), parent_chain (2x), section_id (2x), defined_term (3x), source_file (1x)
  • Enables structure-aware queries (e.g., "Section 203(a)", "Force Majeure")

Changed

  • Chat Layer Decoupled from Semantic Kernel — AgentExecutor and ChatSessionManager now use BackendSelector + AgentSession abstractions; zero AgentFactory/ChatHistory imports remain in the chat layer
  • Chat Streaming — New execute_turn_streaming async generator and process_message_streaming for token-by-token output; CLI REPL shows spinner until first chunk arrives
  • Test Runner Decoupled — TestExecutor uses BackendSelector + ExecutionResult instead of direct AgentFactory; allow_side_effects flag plumbed through to backend selection
  • AgentFactory Refactored — Now a backward-compatible facade; HierarchicalDocumentTool initialization delegated to shared tool_initializer
  • Chat History Model — ChatSessionManager.history changed from SK ChatHistory to plain list[dict] for provider neutrality
  • ContextGenerator Protocol — HierarchicalDocumentTool accepts any ContextGenerator implementation via set_context_generator(), decoupled from LLMContextGenerator and SK chat service

Fixed

  • Context Model YAML Overrides — Fixed silent ignoring of context_model YAML overrides in the SK path by unifying initialization through tool_initializer
  • Claude Multi-Turn Sessions — Use session_id parameter (SDK 0.1.37 compat) for proper conversation continuity
  • MCP Tool Communication — Wrap prompts as AsyncIterable to keep stdin open for bidirectional MCP tool communication (fixes ProcessTransport error)
  • Credential Validation — validate_credentials now returns actual credential values in env dict instead of empty dict
  • Tool Result Enrichment — _enrich_tool_results correlates tool names from tool_calls to tool_results via call_id for evaluation retrieval_context

Security

  • orjson 3.11.4 → 3.11.7 — fixes CVE-2025-67221 (DoS via missing recursion depth limits)
  • wheel 0.45.1 → 0.46.3 — fixes CVE-2026-24049 (path traversal via extracted file permissions)

Dependencies

  • claude-agent-sdk 0.1.37 — Native Claude Agent SDK integration (new)
  • authlib 1.6.5 → 1.6.6
  • pypdf 6.3.0 → 6.6.0+ (removed upper bound)
  • werkzeug 3.1.4 → 3.1.5+
  • azure-core ≥1.38.0 (new)
  • orjson 3.11.4 → 3.11.7
  • wheel 0.45.1 → 0.46.3

Documentation

  • Claude Agent SDK configuration guide (docs/guides/agent-configuration.md, docs/guides/llm-providers.md)
  • Example Claude agent YAML (docs/examples/claude_agent.yaml)
  • Updated API models reference, README, and AGENTS.md for multi-backend architecture
  • Agent JSON schema updated (schemas/agent.schema.json)

Known Limitations

  • holodeck serve does not support Claude agents — The server command (holodeck serve) only supports Semantic Kernel backends (OpenAI, Azure OpenAI, Ollama). Agents with provider: anthropic work via holodeck test and holodeck chat but cannot be deployed as HTTP servers yet. Claude agent server/deployment support is planned for a future release.

0.4.0 - 2026-02-07

Added

  • HierarchicalDocumentTool — Structure-aware document search with hierarchy preservation (#255)
  • Markdown heading chain tracking (H1-H6 parent chains)
  • Domain-aware subsection recognition (US legislative, AU legislative, academic, technical, legal contracts, financial, medical, patent, general)
  • LLM-based contextual embeddings (Anthropic approach, ~49% improved retrieval accuracy)
  • Incremental ingestion with mtime-based tracking and --force-ingest override
  • Hybrid search combining semantic + keyword with configurable weights
  • Full YAML configuration — no code required
  • Tiered Keyword Search with RRF Fusion — Automatic strategy selection based on provider capabilities
  • NATIVE_HYBRID for providers with built-in hybrid search (azure-ai-search, weaviate, qdrant, mongodb, azure-cosmos-nosql)
  • FALLBACK_BM25 using rank_bm25 + Reciprocal Rank Fusion (k=60) for other providers (postgres, pinecone, chromadb, faiss, in-memory, sql-server)
  • KeywordSearchProvider Protocol — Pluggable keyword search backend interface with two implementations:
  • InMemoryBM25KeywordProvider — rank_bm25 in-process for development and local workloads
  • OpenSearchKeywordProvider — external OpenSearch cluster for production, with configurable auth (basic/API key), TLS, and timeouts
  • KeywordIndexConfig Model — YAML-configurable keyword search backend selection (in-memory or opensearch) with Pydantic validation
  • Keyword Search Provider Router — Automatic backend routing with OpenTelemetry span instrumentation for search observability
  • Shared Tool Utilities (#257) — Extracted reusable infrastructure into lib/tools/:
  • common.py: file discovery, source path resolution, placeholder embedding generation
  • base_tool.py: EmbeddingServiceMixin and DatabaseConfigMixin for tool code reuse
  • Shared Terminal UI Utilities (#256) — Consolidated duplicate code into lib/ui/:
  • terminal.py: TTY detection
  • spinner.py: SpinnerMixin for progress animation
  • colors.py: ANSIColors and colorize() function
  • Chat history extraction utilities shared between chat and test_runner
  • HierarchicalDocumentTool Specification (#242) — Full spec-kit artifacts:
  • spec.md with 8 user stories (P1-P3 priorities)
  • Implementation plan, data model documentation, quickstart guide
  • 110+ implementation tasks organized by priority

Changed

  • BM25 Score Normalization — Replaced hardcoded /10.0 divisor with max-score normalization; the top result always scores 1.0, others are proportional to the maximum
  • Async OpenSearch I/O — HybridSearchExecutor.build_keyword_index() and keyword_search() are now async; OpenSearch calls offloaded via asyncio.to_thread(), in-memory BM25 remains direct with zero overhead
  • KeywordIndexConfig Self-Validation — OpenSearch field validation (endpoint, index_name) moved from parent HierarchicalDocumentToolConfig into KeywordIndexConfig itself via @model_validator, enabling validation regardless of construction context
  • Chunk Ownership Architecture — HybridSearchExecutor now owns chunk data via internal _chunk_map, eliminating chunk duplication and improving lookup performance
  • Search Mode Routing — Tool supports KEYWORD, SEMANTIC, and HYBRID search modes with graceful degradation to semantic-only on keyword failure
  • CLI Error Handling — Extracted error handling into reusable context manager

Removed

  • ExactMatchIndex — Removed unused class, SearchMode.EXACT enum value, _exact_search() method, and exact match routing logic (~485 lines) in favor of unified keyword search

Fixed

  • Hybrid Weight Validation — Enforce semantic_weight + keyword_weight > 0 for hybrid search mode, rejecting invalid weight combinations

Security

  • aiohttp 3.13.2 → 3.13.3 — fixes 8 CVEs:
  • CVE-2025-47364 (CRLF injection in redirects)
  • CVE-2025-49109 (DoS via keepalive infinite loop)
  • CVE-2025-49110 (DoS via Transfer-Encoding header)
  • CVE-2025-49111 (DoS via invalid chunk extensions)
  • CVE-2025-49112 (Proxy header injection)
  • CVE-2025-49113 (DoS via Content-Length/Transfer-Encoding conflict)
  • CVE-2025-69229 (DoS via excessive chunked messages)
  • CVE-2025-69230 (DoS via Cookie header logging)
  • werkzeug 3.1.4 → 3.1.5
  • python-multipart 0.0.20 → 0.0.22
  • authlib 1.6.5 → 1.6.6
  • pypdf 6.4.0 → 6.6.2
  • protobuf 5.29.5 → 5.29.6
  • semantic-kernel 1.39.0 → 1.39.3
  • wheel 0.45.1 → 0.46.2

Documentation

  • Hierarchical Document Tools section in tools reference guide
  • HierarchicalDocumentTool spec, plan, data model, and quickstart artifacts (#242)
  • Standardized parallel test execution (-n auto) across CLAUDE.md and AGENTS.md

Testing

  • HierarchicalDocumentTool coverage increased from 79% to 97% (26 new test cases)
  • Comprehensive keyword search test suite: KeywordSearchProvider protocol, InMemoryBM25, OpenSearchKeywordProvider, HybridSearchExecutor, provider routing, OTel spans, graceful degradation
  • KeywordIndexConfig and HierarchicalDocumentToolConfig model validation tests
  • Consolidated and removed trivial unit tests for cleaner test suite

0.3.5 - 2026-01-28

Added

  • Azure Container Apps Deployment (#234)
  • holodeck deploy run/status/destroy commands with Azure deployer
  • Typed BaseDeployer interface with deployment state tracking via Pydantic models
  • Strongly typed result models and configurable health checks
  • CLI error handling extracted into reusable context manager
  • Cross-Architecture Container Builds (#241)
  • Configurable platform field on deployment config (default: linux/amd64)
  • Support for building containers on ARM machines (e.g., Apple Silicon) targeting amd64 deployment
  • Always-fetch base image variant via pull=True

Fixed

  • Dockerfile user permissions for proper file operations in containers
  • Default base image updated to published ghcr.io/justinbarias/holodeck-base:latest
  • Removed unused helper functions from deployment module

Testing

  • Deploy build command unit tests
  • Azure deployer behavior and platform configuration validation tests

Documentation

  • Deployment guide updates for Azure Container Apps

0.3.4 - 2026-01-24

Added

  • Deploy Build Command (holodeck deploy build): Build container images from agent configuration
  • Pydantic deployment configuration models with validation
  • Dockerfile generation with Jinja2 templates
  • Container image building via Docker SDK (docker-py)
  • Tag strategies: git_sha, git_tag, latest, custom
  • OCI-compliant image labels
  • --dry-run mode to preview builds without executing
  • --no-cache flag for fresh builds
  • HoloDeck Base Image: Pre-built Docker base image for agent containers
  • Multi-architecture support (linux/amd64, linux/arm64)
  • GitHub Actions workflow for automated builds
  • Published to ghcr.io/justinbarias/holodeck-base:latest
  • Non-root user for security
  • Health check configuration
  • OpenCode Speckit Support: Spec-kit slash commands for OpenCode editor
  • /speckit.specify, /speckit.clarify, /speckit.plan, /speckit.tasks
  • /speckit.analyze, /speckit.checklist, /speckit.implement
  • /speckit.constitution, /speckit.taskstoissues

Documentation

  • Comprehensive deployment guide at docs/guides/deployment.md
  • DIY deployment instructions using the base image
  • Cloud provider configuration reference (AWS App Runner, GCP Cloud Run, Azure Container Apps)

0.3.3 - 2026-01-17

Added

  • Holodeck Init - Support for Vector Store Provider choice: PostgreSQL (pgvector) and Pinecone support

Changed

  • Tool Filtering: Anthropic tool search to reduce token usage
  • Claude Workflow: use Opus model in Claude workflow

Documentation

  • Tool filtering configuration guide

0.3.2 - 2026-01-10

Added

  • DeepEval Evaluation Tracing: Observability support for DeepEval metrics

Fixed

  • Security vulnerabilities identified in dependencies

0.3.1 - 2026-01-09

Changed

  • Test Runner Expected Tools: loosened expected_tools validation to allow substring matching

0.3.0 - 2026-01-08

Added

  • OpenTelemetry Observability: Full observability instrumentation with GenAI semantic conventions
  • OpenTelemetry configuration models (traces, metrics, logs)
  • OTLP export support for traces and metrics
  • Agent Local Server (holodeck serve): REST API server for agents
  • FastAPI-based REST endpoints for agent invocation
  • AG-UI compliant endpoint for agent interaction

0.1.7 - 2025-12-27

Added

  • MCP CLI Commands: Complete CLI for managing MCP servers
  • holodeck mcp search: Search MCP registry for servers
  • holodeck mcp add: Add MCP servers to configuration
  • holodeck mcp list: List configured servers (agent and global)
  • holodeck mcp remove: Remove MCP servers from configuration
  • Global MCP server merge into agent configurations
  • Structured Data Ingestion: Loader and vectorstore integration for structured data sources
  • Vectorstore Reranking: Reranking support for vectorstore search results
  • Interactive Config Wizard Enhancements:
  • Template selection step
  • LLM provider selection step
  • DeepEval Metrics: DeepEval integration as alternative/complement to Azure AI Evals
  • CLI Defaults: agent.yaml as default config for chat and test commands
  • New Package Entrypoint: Added holodeck-ai script entrypoint

Changed

  • Vector Store Providers: Removed Redis support, added PostgreSQL (pgvector), Pinecone, and Qdrant
  • Documentation: Updated for uv tool install, Ollama as preferred provider
  • Test Progress/Reporting: Improved display and refactored agent_factory
  • Schema Validation: Relaxed validation for better flexibility

Fixed

  • Telemetry warning in CLI
  • CNAME configuration bug

0.1.6 - 2025-11-28

Added

  • MCP Tool Integration: Full Model Context Protocol (MCP) tool support with stdio transport
  • MCP server configuration and connection management
  • Tool discovery and invocation via MCP protocol

Fixed

  • Instruction loading issues in agent configuration

0.1.5 - 2025-11-27

Added

  • Project and User Config Support: Execution config resolution now supports project-level and user-level configuration files

Fixed

  • ChromaDB connection issues

0.1.4 - 2025-11-27

Fixed

  • PyPI release by removing local version identifiers

0.1.3 - 2025-11-27

Added

  • ChromaDB Support: Explicit ChromaDB vector store integration

Changed

  • Package Manager: Switched from Poetry to uv for faster dependency management

Fixed

  • Test logging improvements
  • RedisVL compatibility issues
  • CLI quiet mode behavior

0.1.2 - 2025-11-26

Added

  • Ollama Endpoint Support: Local LLM execution via Ollama
  • Vector Stores Setup Guide: Comprehensive Redis vector store documentation
  • Claude Code integration for development assistance

0.1.1 - 2025-11-25

Added

  • Semantic Kernel Vector Store Abstractions: Support for all vector store providers (Redis, ChromaDB, etc.)
  • Agent config execution settings applied to Semantic Kernel

0.1.0 - 2025-11-23

Added

  • Chat Models and Validation Pipeline: Scaffold for interactive chat functionality
  • Markdown Report Generation: Comprehensive test result reporting (T123-T127)
  • Progress Display Enhancements: Spinner, ANSI colors, elapsed time display
  • Per-Test Metric Resolution: EvaluationMetric objects for fine-grained metric configuration (T095-T096)
  • File Processing Improvements: Enhanced file input handling

Changed

  • Consolidated and refactored tests to parameterized tests for better maintainability
  • Config init command improvements

0.0.14 - 2025-11-15

Fixed

  • Poetry development dependencies
  • MkDocs build step
  • Poetry version configuration
  • Various Poetry configuration issues

0.0.7 - 2025-11-08

Added

  • Agent Execution Implementation: Core agent execution engine
  • Evaluators: User Story 1 evaluator implementation
  • Response Format Definition: Phase 4 implementation (T014-T019)
  • Global Settings Configuration: Phase 2 & 3 with TDD approach

0.0.6 - 2025-10-25

Added

  • holodeck init Command: Complete project initialization with templates
  • Phase 8: Polish & QA for init command
  • Phase 7: Project metadata specification (US5)
  • Phase 5: Sample files and examples generation (US3)
  • User Story 2: Project template selection (Phase 4)
  • Core init engine implementation
  • Basic agent creation from templates
  • ConfigLoader returns GlobalConfig rather than dict

0.0.5 - 2025-10-20

Fixed

  • Version tag configuration

0.0.4 - 2025-10-20

Added

  • GitHub release workflow
  • Automated PyPI publishing

0.0.1 - 2025-10-19

Added - User Story 1: Define Agent Configuration

Core Features

  • Agent Configuration Schema: Complete YAML-based agent configuration with Pydantic validation
  • Agent metadata (name, description)
  • LLM provider configuration (OpenAI, Azure OpenAI, Anthropic)
  • Model parameters (temperature, max_tokens)
  • Instructions (inline or file-based)
  • Tools array with type discrimination
  • Test cases with expected behavior validation

  • Evaluation metrics with flexible model configuration

  • Configuration Loading & Validation (ConfigLoader):

  • Load and parse agent.yaml files
  • Validate against Pydantic schema with user-friendly error messages
  • File path resolution (relative to agent.yaml directory)
  • Environment variable substitution (${VAR_NAME} pattern)

  • Precedence hierarchy: agent.yaml > environment variables > global config

  • Global Configuration Support:

  • Load ~/.holodeck/config.yaml for system-wide settings
  • Provider configurations at global level
  • Tool configurations at global level
  • Configuration merging with proper precedence

Data Models

  • LLMProvider Model:
  • Multi-provider support (openai, azure_openai, anthropic)
  • Model selection and parameter configuration
  • Temperature range validation (0-2)
  • Max tokens validation (>0)

  • Azure-specific endpoint configuration

  • Tool Models (Discriminated Union):

  • VectorstoreTool: Vector search with source, embedding model, chunk size/overlap
  • FunctionTool: Python function tools with parameters schema
  • MCPTool: Model Context Protocol server integration
  • PromptTool: AI-powered semantic functions with template support

  • Tool type validation and discrimination

  • Evaluation Models:

  • Metric configuration with name, threshold, enabled flag
  • Per-metric model override for flexible configuration

  • AI-powered and NLP metrics support

  • TestCase Model:

  • Test inputs with expected behaviors
  • Ground truth for validation
  • Expected tool usage tracking

  • Evaluation metrics per test

  • Agent Model:

  • Complete agent definition
  • All field validations and constraints

  • Tool and evaluation composition

  • GlobalConfig Model:

  • Provider registry
  • Vectorstore configurations
  • Deployment settings

Error Handling

  • Custom Exception Hierarchy:
  • HoloDeckError: Base exception
  • ConfigError: Configuration-specific errors
  • ValidationError: Schema validation errors with field details

  • FileNotFoundError: File resolution errors with path suggestions

  • Human-Readable Error Messages:

  • Field names and types in validation errors
  • Actual vs. expected values
  • File paths with suggestions
  • Nested error flattening for complex schemas

Infrastructure & Tooling

  • Development Setup:
  • Makefile with 30+ development commands
  • Poetry dependency management
  • Pre-commit hooks (black, ruff, mypy, detect-secrets)

  • Python 3.10+ support

  • Testing:

  • Unit test suite with 11 test files covering all models
  • Integration test suite for end-to-end workflows
  • 80%+ code coverage requirement

  • Test execution: make test, make test-coverage, make test-parallel

  • Code Quality:

  • Black code formatting (88 char line length)
  • Ruff linting (pycodestyle, pyflakes, isort, flake8-bugbear, pyupgrade, pep8-naming, flake8-simplify, bandit)
  • MyPy type checking with strict settings
  • Security scanning (safety, bandit, detect-secrets)

  • Automated pre-commit validation

  • Documentation:

  • MkDocs site configuration with Material theme
  • Getting Started guide (installation, quickstart)
  • Configuration guides (agent config, tools, evaluations, global config, file references)
  • Example agent configurations (basic, with tools, with evaluations, with global config)
  • API reference documentation (ConfigLoader, Pydantic models)
  • Architecture documentation (configuration loading flow)

Features Summary by Component

ConfigLoader API

loader = ConfigLoader()
agent = loader.load_agent_yaml("agent.yaml")  # Returns Agent instance
  • Parse YAML to Agent instances
  • Automatic environment variable substitution
  • File reference resolution with validation
  • Configuration precedence handling
  • Comprehensive error reporting

Schema Support

  • File References: Instructions and tool definitions can be loaded from files
  • Environment Variables: ${ENV_VAR} patterns supported throughout configs
  • Type Discrimination: Tool types automatically validated and parsed
  • Nested Validation: Complex nested structures validated properly

Testing Coverage

Unit Tests (11 files):

  • test_errors.py - Exception handling and messaging
  • test_env_loader.py - Environment variable substitution
  • test_defaults.py - Default configuration handling
  • test_validator.py - Validation utilities
  • test_tool_models.py - Tool type validation and discrimination
  • test_llm_models.py - LLM provider configuration
  • test_evaluation_models.py - Evaluation metric configuration
  • test_testcase_models.py - Test case validation
  • test_agent_models.py - Agent schema validation
  • test_globalconfig_models.py - Global configuration handling
  • test_config_loader.py - ConfigLoader functionality

Integration Tests (1 file):

  • test_config_end_to_end.py - Full workflow testing

Known Limitations

Version 0.0.1 Scope

  • CLI Not Implemented: No command-line interface (planned for User Story 2)
  • No Agent Execution: Agent models are validated but not executed (Phase 2 feature)
  • No Tool Execution: Tools are defined but not executed (Phase 2 feature)
  • No Evaluation Engine: Metrics are configured but not executed (Phase 2 feature)
  • No Deployment: No FastAPI endpoint generation or Docker deployment (Phase 2-3 features)
  • No Observability: OpenTelemetry integration planned for Phase 2
  • No Plugin System: Plugin packages not yet available (Phase 3 feature)

Validation Limitations

  • File Validation: Only checks file existence, not content validity
  • LLM Provider APIs: No actual API testing (would require credentials)
  • Tool Validation: Type validation only, no runtime validation

Known Issues

None reported in 0.0.1.

How to Use This Changelog

  • Unreleased: Features coming in future releases
  • Semantic Versioning: MAJOR.MINOR.PATCH
  • MAJOR: Breaking changes or new architecture
  • MINOR: New features and functionality
  • PATCH: Bug fixes and improvements
  • Categories: Added (new features), Changed (modifications), Fixed (bug fixes), Deprecated (to be removed), Removed (deprecated features deleted), Security (security fixes)

Roadmap

  • v0.1 - Core agent engine + CLI
  • v0.2 - Evaluation framework
  • v0.3 - API deployment (serve + deploy build)
  • v0.4 - Hierarchical document search & tiered keyword search
  • v0.5 - Web UI (no-code editor)
  • v0.6 - Enterprise features (SSO, audit logs, RBAC)
  • v1.0 - Production-ready release

Previous Versions

Development Versions

  • Pre-0.0.1: Architecture planning and vision definition
  • Project vision (VISION.md)
  • Architecture documentation
  • Specification and planning

Contributing

See CONTRIBUTING.md for guidelines on:

  • Development setup
  • Running tests
  • Code style requirements
  • Submitting pull requests

License

HoloDeck is released under the MIT License. See LICENSE file for details.

Changelog Format

We follow Keep a Changelog format:

  • Added: New features
  • Changed: Changes to existing functionality
  • Deprecated: Features to be removed in future versions
  • Removed: Features that have been removed
  • Fixed: Bug fixes
  • Security: Security-related changes