diff --git a/docs/changelog/overview.mdx b/docs/changelog/overview.mdx index 990a32b..36d42a8 100644 --- a/docs/changelog/overview.mdx +++ b/docs/changelog/overview.mdx @@ -363,6 +363,197 @@ This changelog is auto-generated from [CHANGELOG.md](https://github.com/kryptoba [View full release notes](https://github.com/kryptobaseddev/cleo/releases/tag/v0.73.2) + +## Test Coverage + + +**Added** +- **Epic T2431: Skill System Enhancement & Dynamic Skill Discovery** + - **Dynamic Agent Registry System** (T2442, T2447, T2448): + - `templates/agent-registry.json`: Central registry for 16 LLM coding agents + - Supported agents: claude-code, cursor, windsurf, codex, gemini-cli, github-copilot, opencode, cline, kimi, roo, continue, antigravity, goose, kiro-cli, amp, trae + - Priority tiers: tier1 (claude-code, cursor, windsurf), tier2 (5 agents), tier3 (8 agents) + - No more hardcoded arrays - all agent data loaded dynamically from JSON + - `lib/agent-registry.sh`: New registry API (`ar_*` functions) + - `lib/agent-config.sh`: Refactored to use dynamic registry + - **Skill Taxonomy System** (T2432, T2434): + - `docs/specs/SKILL-TAXONOMY-SPEC.md`: 4-tier hierarchy (0-3) + - 9 functional categories: orchestration, research, design, implementation, testing, documentation, validation, integration, utility + - Dispatch matrix with category-based, keyword, label, and type matching + - **Dynamic Skill Discovery** (T2435, T2436): + - `docs/designs/DYNAMIC-SKILL-REGISTRATION.md`: Registration system design + - `lib/skill-discovery.sh`: Auto-discovery of skills in `skills/` directory + - Functions: `discover_skills()`, `validate_skill()`, `register_skill()`, `sync_manifest()` + - **Skill CLI Command** (T2440): + - `scripts/skills.sh`: New command group `cleo skills` + - Subcommands: `list`, `discover`, `validate`, `info`, `install` + - **Dispatch Matrix Enhancement** (T2437): + - Category-based dispatch: `skill_dispatch_by_category()` + - Tier functions: `skill_get_tier()`, `skill_is_tier()` + - 10 skill categories with explicit mappings + - **Test Coverage** (T2438): 31 unit tests in `tests/unit/skill-discovery.bats` + - **Documentation** (T2439): Updated `docs/CLEO-SKILLS-INVENTORY.md`, `docs/guides/skill-development.md` + - **Global Injection Update** (T2443, T2444): + - `installer/lib/link.sh`: Uses dynamic registry for all agent setup + - RFC 2119 time estimates prohibition block in global injection +- **Epic T2089: Claude CLI Aliases - Cross-Platform Support Complete** + - **Windows Support** (T2111): + - `normalize_windows_path()`: Path separator conversion for Windows + - `get_windows_documents_path()`: Localized Documents folder detection via PowerShell + - `ensure_powershell_profile_dir()`: PowerShell profile directory creation with Windows fallback + - `setup_cmd_autorun()`: CMD.exe registry AutoRun configuration + - `check_cmd_autorun()`: Registry query for current AutoRun status + - New CLI flag: `--cmd-autorun` for automatic CMD alias loading + - **Collision Detection** (T2119): + - `detect_existing_aliases()`: Find aliases/functions matching our names + - `detect_legacy_claude_aliases()`: Recognize function-based patterns + - `check_alias_collisions()`: Report non-Claude collisions + - Doctor integration with legacy detection and `--force` suggestion + - **Test Coverage**: 78 unit tests for claude-aliases library + - **Supported Shells**: bash, zsh, PowerShell (cross-platform), CMD.exe + +**Fixed** +- **Doctor Command Bug Fixes** (T1469 HITL Testing): + - **T1965**: Fixed schema version comparison - was comparing object instead of `.version` subfield from `project-info.json`, causing false "Outdated schemas" warnings + - **T1966**: Fixed `--clean-temp` showing stale counts - moved cleanup to Phase 1b (before validation) so health check shows accurate post-cleanup data + - **T1968**: Fixed double counting of orphaned and temp projects - orphan check now runs before temp check to prevent increment of both counters + - **T1964**: Verified ISSUES column truncation already fixed (shows full text) + - **T1967**: Verified agent config registry working correctly + +**Validated** +- **Migration Automation System** (T1482-T1485): + - Pre-commit hook exists with PATCH/MINOR/MAJOR auto-generation logic + - Developer mode bypass and runtime protection working correctly + - Agent documentation sanitization verified - no low-level `migrate` command references + + +[View full release notes](https://github.com/kryptobaseddev/cleo/releases/tag/v0.73.1) + + + +## Bash 5.3+ brace expansion bug + + +**Fixed** +- **Bash 5.3+ brace expansion bug**: Fixed jq parse errors ("Unmatched '}' at line 1, column 3") when ending sessions + - Root cause: Bash 5.3+ incorrectly handles `${N:-{}}` parameter defaults, appending extra `}` to values + - Affected functions: `capture_session_end_metrics`, `contribution_*`, `score_subagent_with_tokens`, `cache_validation_result` + - Fix: Changed `${N:-{}}` to `${N:-'{}'}` (quoted default) in 6 locations across 4 library files + - Files: `lib/metrics-aggregation.sh`, `lib/contribution-protocol.sh`, `lib/compliance-check.sh`, `lib/doctor-project-cache.sh` + + +[View full release notes](https://github.com/kryptobaseddev/cleo/releases/tag/v0.72.1) + + + +## 2-Tier System Implementation + + +**Added** +- **Epic T2392: CLEO Universal Subagent Architecture** + - **2-Tier System Implementation**: Replaced per-skill agent spawning with unified architecture + - **Tier 0**: ct-orchestrator (HITL coordinator, delegates ALL work) + - **Tier 1**: cleo-subagent (universal executor with skill injection) + - **cleo-subagent agent file** (T2403): `.claude/agents/cleo-subagent.md` + - Registered with Claude Code agent discovery + - Tools: Read, Write, Edit, Bash, Glob, Grep + - Follows BASE protocol (BASE-001 through BASE-007) + - **Protocol stack system** (T2401, T2404): 7 protocols in `protocols/` directory + - `research.md`: Research and investigation tasks + - `decomposition.md`: Epic planning and task breakdown + - `implementation.md`: Code implementation tasks + - `specification.md`: RFC-style spec writing + - `contribution.md`: Contribution recording + - `consensus.md`: Multi-agent voting/decisions + - `release.md`: Version and changelog management + - **Skill dispatch enhancements** (T2405): `lib/skill-dispatch.sh` + - `skill_auto_dispatch()`: Auto-detect protocol from task metadata + - `skill_prepare_spawn()`: Full token pre-resolution before spawn + - Protocol composition: base + conditional protocols combined + - **Token injection system** (T2405): `lib/token-inject.sh` + - All placeholders resolved before subagent spawn + - `tokenResolution.fullyResolved` validation + - **Documentation updates**: + - `docs/architecture/CLEO-SUBAGENT.md`: Full 2-tier architecture reference + - `docs/CLEO-INJECTION.md`: Global injection for all agents + - `docs/guides/ORCHESTRATOR-PROTOCOL.md`: Updated for 2-tier system + - `docs/specs/CLEO-SUBAGENT-PROTOCOL-v1.md`: RFC 2119 protocol spec + - `docs/guides/SUBAGENT-MIGRATION.md`: Migration guide + - **Test suites**: + - `tests/unit/cleo-subagent.bats`: 66 tests for base protocol + - `tests/integration/protocol-stack.bats`: 81 tests for protocol composition + - `tests/integration/migration-validation.bats`: 42 tests for migration paths + - **E2E validation** (T2429): Verified cleo-subagent spawnable via Task tool + - **Manifest deprecation** (T2415): Added `deprecatedFields` to `skills/manifest.json` + - `compatible_subagent_types`: Marked deprecated (historical reference only) + +**Changed** +- **Skill system architecture**: Skills are now protocol identifiers, NOT separate agent types + - All spawns use `subagent_type: "cleo-subagent"` with skill as context injection + - Dispatch matrix maps task types/keywords to skill NAMES for protocol selection +- **ct-orchestrator protocol** (T2407): Updated for cleo-subagent spawning + - ORC constraints enforced (ORC-001 through ORC-008) + - Spawn workflow uses `skill_prepare_spawn()` with full token resolution + +**Deprecated** +- **Skill-specific agent spawning**: Old pattern of spawning different agent types per skill + - Use `cleo-subagent` with protocol injection instead + - `compatible_subagent_types` field retained for backwards compatibility only + + +[View full release notes](https://github.com/kryptobaseddev/cleo/releases/tag/v0.72.0) + + + +## v0.71.1 Release + + +**Added** +- **Epic T2419: Backup System Assessment & Consolidation** + - **Pre-write schema validation** (T2427): Added to `lib/file-ops.sh` + - New functions: `_fo_get_schema_type()`, `_fo_validate_json_content()` + - New exit code: `FO_SCHEMA_VALIDATION_FAILED=9` + - Environment controls: `CLEO_SKIP_SCHEMA_VALIDATION`, `CLEO_SCHEMA_VALIDATION_STRICT` + - Validates todo.json, config.json, sessions.json, archive, log structures before write + - **Backup architecture documentation** (T2426): `docs/concepts/backup-system.mdx` + - Four-layer architecture explanation with Mermaid diagrams + - Layer 1: Atomic Operations (per-write safety) + - Layer 2: Recovery Backups (snapshots, safety, archive, migration) + - Layer 3: Schema Validation (now with pre-write prevention) + - Layer 4: Git Version Control (project history) + - Recovery procedures and best practices + - **Mintlify docs navigation** (T2428): Added backup-system to Concepts > Architecture + + +[View full release notes](https://github.com/kryptobaseddev/cleo/releases/tag/v0.71.1) + + + +## `.cleo/` files now git-tracked + + +**Added** +- **Epic T2190: Hierarchical Discovery System for graph-rag.sh** + - **`_find_lca()`** (T2192): Find lowest common ancestor of two tasks in hierarchy tree + - **`_tree_distance()`** (T2193): Calculate tree distance between tasks (0=same, 2=siblings, 4=cousins) + - **`_get_hierarchical_context()`** (T2194): Get task description with parent context using 0.5/0.25 decay weights + - **`_discover_by_hierarchy()`** (T2195): Discover siblings (+0.15 boost) and cousins (+0.08 boost) + - **`discover_related_tasks()` integration** (T2196): Added `hierarchy` method and auto-mode boosting + - **Test suite** (T2197): `tests/unit/graph-rag-hierarchy.bats` with 23 passing tests + - **Documentation** (T2198): `docs/commands/graph-rag.md` with full API reference + - **Config schema** (T2417): Added `graphRag` section to `schemas/config.schema.json` + - `hierarchyBoost`: sibling/cousin/ancestor boost values + - `contextPropagation`: maxDepth and decayFactor settings + - `minScore`: threshold for discovery results + - **Benchmark** (T2418): ~60-105ms/call for hierarchy functions (563 task project) + +**Changed** +- **`.cleo/` files now git-tracked**: Core task files (todo.json, sessions.json, config.json, todo-archive.json) are now tracked by git for data integrity and backup + + +[View full release notes](https://github.com/kryptobaseddev/cleo/releases/tag/v0.71.0) + + ## Earlier Releases For the complete release history, see: