|
2 | 2 |
|
3 | 3 | All notable changes to this project will be documented in this file. |
4 | 4 |
|
| 5 | +## [0.2.54+] - 2025-08-18 - Pipeline Templates & Environment Management Revolution |
| 6 | + |
| 7 | +### 🚀 Major Features Added |
| 8 | +- **Pipeline Template System**: Complete template engine with 5 built-in templates (simple-trace, data-pipeline, llm-chain, parallel-processing, error-handling) |
| 9 | +- **Environment Management**: Persistent cross-session variable storage with `.coaia-env` files supporting JSON and .env formats |
| 10 | +- **Jinja2 Templating Engine**: Variable substitution, validation, conditional steps, and built-in functions (uuid4(), now(), timestamp()) |
| 11 | +- **Template Hierarchy**: Project → Global → Built-in discovery system with customization support |
| 12 | +- **One-Command Workflows**: Transform 30+ minute manual setups into 30-second automated pipeline creation |
| 13 | + |
| 14 | +### ⚡ Revolutionary CLI Commands |
| 15 | +- **`coaia pipeline list`**: Display all available templates with metadata and optional path information |
| 16 | +- **`coaia pipeline show <template>`**: Inspect template details, variables, steps with optional preview rendering |
| 17 | +- **`coaia pipeline create <template>`**: Generate complete trace/observation workflows from templates with variable substitution |
| 18 | +- **`coaia pipeline init <name>`**: Create new custom templates with optional base template extension |
| 19 | +- **`coaia env init/list/set/get/unset/source/clear/save`**: Complete environment variable management system |
| 20 | + |
| 21 | +### 🔄 Cross-Session Persistence |
| 22 | +- **Environment Files**: `.coaia-env` files for project-level and `~/.coaia/global.env` for global persistence |
| 23 | +- **Variable Hierarchy**: OS environment → Project environment → Global environment → Template defaults |
| 24 | +- **Shell Integration**: `--export` flag generates shell export commands for bash automation |
| 25 | +- **Context Saving**: Save and restore complete pipeline contexts across sessions |
| 26 | + |
| 27 | +### 🛠 Template System Features |
| 28 | +- **Built-in Functions**: Jinja2 template engine with uuid4(), now(), timestamp() functions |
| 29 | +- **Conditional Steps**: Include/exclude steps based on variable conditions |
| 30 | +- **Parent-Child Relationships**: Automatic SPAN observation hierarchies with nested children |
| 31 | +- **Variable Validation**: Type checking, required field validation, and choice constraints |
| 32 | +- **Template Extension**: Create custom templates based on existing ones with inheritance |
| 33 | + |
| 34 | +### 📈 Workflow Transformation Examples |
| 35 | +- **Before**: 30+ minute manual trace/observation setup with error-prone ID management |
| 36 | +- **After**: `coaia pipeline create data-pipeline --var user_id="john" --export-env` (< 30 seconds) |
| 37 | +- **Cross-Session**: `coaia env save --name "context"` and `eval $(coaia env source --name context --export)` |
| 38 | + |
| 39 | +### 🔧 Technical Improvements |
| 40 | +- **New Dependencies**: Added Jinja2>=2.10 for template rendering |
| 41 | +- **New Modules**: `pipeline.py` (template engine) and `environment.py` (environment management) |
| 42 | +- **Enhanced CLI**: Comprehensive help text for all pipeline and environment commands |
| 43 | +- **Error Handling**: Template validation, variable type checking, and user-friendly error messages |
| 44 | + |
5 | 45 | ## [0.2.54] - 2025-08-17 |
6 | 46 |
|
7 | 47 | ### Added |
|
0 commit comments