From 348f1058488dff611db05512717a88a27599a863 Mon Sep 17 00:00:00 2001
From: kryptobaseddev <95310582+kryptobaseddev@users.noreply.github.com>
Date: Fri, 30 Jan 2026 18:50:21 +0000
Subject: [PATCH] docs(changelog): Auto-regenerate Mintlify changelog
Triggered by changes to CHANGELOG.md
---
docs/changelog/overview.mdx | 191 ++++++++++++++++++++++++++++++++++++
1 file changed, 191 insertions(+)
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: