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

0.1.0 - 2026-01-28

Added

Core Assembly System

• Assembler - Core prompt assembly orchestration with keyword-triggered context injection
• Matcher - Keyword trigger detection supporting wildcards (auth*), phrases ("two words"), word boundaries, and semantic similarity foundation
• Budget - Token constraint fitting using priority-based greedy selection algorithm
• Budget.Planner - Intelligent section budget allocation (default: system 10%, pre_history 30%, history 40%, post_history 20%)

Template Engine

• Template rendering via Mustache engines (BbMustache and ExMustache support)
• YAML frontmatter parsing for prompt metadata
• Template loader with validation
• Prompt catalog system with persistent_term caching for performance
• File system watcher for automatic prompt reloading during development
• Prompt override system for runtime customization

Protocol & Pipeline

• ALF-based assembly pipeline for composable prompt processing
• Protocol packet format for canonical assembly output
• LLM Core adapter for seamless integration with llm_core library
• Provider message conversion supporting multiple LLM formats

Storage Adapters

• InMemory - Fast in-memory storage for testing and development
• EctoAdapter - Generic Ecto-based storage for production use
• DevMan - SQLite-backed storage adapter for DevMan workflow integration
• HuMan - PostgreSQL-backed storage adapter for HuMan reasoning infrastructure

Methodologies System

• YAML-based methodology definitions for reusable prompt packs
• Built-in methodologies:
  • bug_triage - Structured bug analysis and prioritization framework
  • root_cause - Root cause analysis methodology
• Methodology composition and filtering (e.g., "bug_triage#step-1")
• Support for tags, sections, and priority configuration

Semantic Matching

• Semantic matching adapter interface for extensible similarity detection
• Simple semantic matcher implementation as baseline
• Foundation for ML-based semantic search integration

Mix Tasks (CLI)

• mix comm_bus.entries - List and filter entries by storage, mode, enabled state
• mix comm_bus.budget - Simulate budget allocation for conversation/entries YAML files
• mix comm_bus.simulate - Full assembly simulation with detailed output
• mix comm_bus.compare_engines - Compare BbMustache vs ExMustache rendering
• mix comm_bus.sync_fixtures - Synchronize golden test fixtures

Testing & Fixtures

• Comprehensive test suite with 100+ tests
• Golden template fixtures for DevMan and HuMan adapters
• Property-based testing with StreamData
• Assembly integration tests
• Template consistency validation

Observability

• Telemetry integration for assembly operations
• Event emissions for:
  • Assembly start/stop/exception
  • Budget planning
  • Template rendering
  • Storage operations
• Telemetry metrics support

Data Structures

• Entry - Injectable context with keywords, priority, weight, section, and mode
• Message - OpenAI-compatible message format (system/user/assistant/tool roles)
• Conversation - Session state with message history, depth, and metadata
• Packet - Assembly output with sectioned messages, token usage, and exclusion details
• Context - Rich context structure for template rendering

Documentation

• Module documentation with @moduledoc for all public modules
• Function specifications with @spec for type safety
• Inline examples and usage patterns
• CLAUDE.md internal reference guide