# Changelog

All notable changes to this project will be documented in this file.
The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).

## [Unreleased]

### Added

- **Automation Tracking System**: Replaced shared session state issue tracking with
  individual per-agent tracking issues. Each agent now creates its own `[AUTO-<PREFIX>]`
  titled issues with standardized headers, reporting intervals, and health indicators.
  Agents: `session-persister`, `implementation-orchestrator`, `system-watchdog`,
  `backlog-groomer`, `human-liaison`. Documentation at
  `docs/development/automation-tracking.md`.

- **Automated Health Monitoring and Recovery**: The `system-watchdog` now runs
  `audit_automation_tracking_health()` every 5 minutes, detecting stalled agents when
  tracking issues are >20% overdue from their declared reporting interval. On detection,
  it terminates stalled sessions via the OpenCode Server API, performs root-cause analysis,
  creates high-priority diagnostic issues, and closes stale tracking issues with recovery
  notes.

- **Centralized Label Management** (`forgejo-label-manager`): A new specialized subagent
  centralizes all Forgejo label operations across the agent system. Enforces the
  organization-level label system, prohibits label creation, and validates label compliance.
  Agents `backlog-groomer`, `human-liaison`, `project-owner`, `epic-planner`,
  `new-issue-creator`, and `issue-state-updater` now delegate all label operations to this
  subagent.

- **PR–Issue Label Synchronization**: PRs now inherit `Priority/`, `MoSCoW/`, `Points/`,
  and `State/` labels from their associated issues at creation time
  (`pr-api-creator`). The `backlog-groomer` adds a continuous Pass 19 for ongoing
  PR–issue label synchronization. The `issue-state-updater` syncs PR state labels whenever
  issue states change.

### Changed

- **Automation Tracking Format**: All automation tracking issues now use a standardized
  header format with mandatory `Reporting Interval: <interval> (Next report expected: <ts>)`
  declarations, enabling precise staleness detection.

---

## [3.8.0] — 2026-04-05

### Added

- Wired Invariant Reconciliation Actor auto-invocation into
  `PlanLifecycleService` phase transitions (`start_strategize`,
  `execute_plan`, `apply_plan`).  Reconciliation failures now block
  the transition with `ReconciliationBlockedError` and emit
  `INVARIANT_VIOLATED` events.  Post-correction reconciliation runs
  via `CORRECTION_APPLIED` event subscription (best-effort).  Added
  `InvariantService` Singleton provider in the DI container.
- **TUI — Shell danger detection**: The TUI shell mode (`!` prefix) now detects
  dangerous command patterns before execution. A configurable pattern registry
  classifies commands by danger level (warning, critical) and surfaces a user
  warning overlay before proceeding. Patterns cover destructive filesystem
  operations, privilege escalation, network exfiltration, and more. (#1003)

- **TUI — Permission Question Widget**: A new inline `PermissionQuestionWidget`
  renders permission requests directly in the conversation stream for single-file
  operations. Users can allow/reject with single-key shortcuts (`a`/`A`/`r`/`R`),
  navigate with arrow keys, confirm with `Enter`, or press `v` to open the full
  permissions screen. (#1004)

- **TUI — Actor thought blocks**: Expandable reasoning trace widgets rendered
  inline in the conversation stream with muted styling. Collapsed by default;
  expand with `Space` or click. (#1005)

- **UKO provenance tracking**: Every typed triple now carries `sourceResource`,
  `validFrom`, and `isCurrent` metadata. A revision chain enables temporal
  queries and point-in-time ontology state reconstruction.

- **JSON-RPC 2.0 A2A wire format**: `A2aRequest`/`A2aResponse` fields renamed to
  standard JSON-RPC 2.0 names (`method`, `id`, `result`, `error`). The
  `A2aVersionNegotiator` handles backward compatibility.

- **Database resource handler**: Full CRUD and checkpoint/rollback support for
  SQLite, PostgreSQL, MySQL, and DuckDB resources via the resource DAG.

- **Estimation lifecycle hook**: `actor.default.estimation` config key wires an
  estimation actor into the Strategize-to-Estimate lifecycle hook.

- **Persona system**: YAML-backed personas bind actors, argument presets, and scope
  references to named identities; persisted in `~/.config/cleveragents/personas/`.

- **Session management**: Create, list, export, and import conversation sessions;
  full JSON export/import for portability; Markdown transcript export
  (`--format md`) for human-readable sharing.

- **First-run experience**: `ActorSelectionOverlay` guides new users to pick an
  actor on first TUI launch; creates a `"default"` persona automatically.

- **Server mode**: `agents server connect` configures a remote CleverAgents server;
  Kubernetes Helm chart in `k8s/` for production deployment.

- **A2A integration**: Agent-to-Agent protocol facade wires CLI and TUI to live
  application services (session, plan, registry, event).

- **Permissions screen**: TUI overlay for reviewing tool permission requests with
  unified, side-by-side, and context diff views; session-scoped allow/reject decisions.

- **Inline permission questions**: `PermissionQuestionWidget` renders single-file
  permission requests directly in the conversation stream with single-key shortcuts.

- **Invariant reconciliation**: `InvariantReconciliationActor` runs automatically at
  every plan phase transition; failures block the transition and emit `INVARIANT_VIOLATED`.

- **UKO runtime**: Universal Knowledge Ontology query interface, inference engine, and
  graph persistence for ACMS context strategies.

### Fixed

- `LangChainChatProvider.name` and `model_id` are now mutable properties with setters,
  fixing an `AttributeError` when `PlanService` attempted to resolve provider names after
  instantiation. (#1553)

---

## [3.7.0] — 2026-03-15

### Added

- **Interactive TUI** (`agents tui`) — full-screen Textual app with multi-session tabs,
  persona switching, slash commands (67 commands across 14 groups), reference picker
  (`@`), shell mode (`!`), context-sensitive F1 help, and `Ctrl+T` argument preset cycling.
- **Slash command system** — 67 commands across 14 groups accessible via `/` overlay.
- **Reference picker** — `@` key opens a file/resource reference picker that inserts
  references into the input field.
- **TUI persona system** — YAML-backed personas bind actors, argument presets, and scope
  references; persisted in `~/.config/cleveragents/personas/`.
- **TUI session export/import** — full JSON round-trip and Markdown transcript export
  (`--format md`).

---

## [3.6.0] — 2026-02-28

### Added

- Advanced Context Management System (ACMS) with three-tier context strategy.
- UKO Runtime (Universal Knowledge Ontology) with graph persistence and inference engine.
- Implicit inference engine producing `uko:implicitSiblingOf`, `uko:implicitContains`,
  and `uko:implicitDependsOn` triples with confidence 0.7.

---

## [3.5.0] — 2026-02-14

### Added

- Autonomy hardening: advisory locking, validation pipeline, definition-of-done gating.
- Resource DAG with dependency tracking and type hierarchy with multiple inheritance.
- Container resource types (`container.docker`, `container.podman`).
- LSP resource types (`lsp.*`).

---

## [3.4.0] — 2026-01-31

### Added

- ACMS v1 with context scaling strategies.
- Resource type inheritance system (ADR-042).
- Safety profile extraction (ADR-041).

---

## [3.3.0] — 2026-01-17

### Added

- Corrections and subplans support in plan lifecycle.
- Checkpoint and rollback for all resource writes.
- Decision tree versioning and history (ADR-034).
- Decision tree rollback and replay (ADR-035).

---

## [3.2.0] — 2026-01-03

### Added

- Decisions, validations, and invariants in plan lifecycle.
- Validation abstraction layer (ADR-013).
- Invariant system (ADR-016).
- Automation profiles (ADR-017).
- Semantic error prevention (ADR-018).

---

## [3.1.0] — 2025-12-20

### Added

- MCP (Model Context Protocol) adapter and client (ADR-029).
- LSP (Language Server Protocol) client integration (ADR-027).
- Agent Skills Standard (AgentSkills.io) support (ADR-028).
- Skill abstraction definition (ADR-030).

---

## [3.0.0] — 2025-12-06

### Added

- Initial public release of CleverAgents Core.
- Unified `agents` / `cleveragents` CLI entry points.
- Layered architecture: Entry Points → Application → Domain → Infrastructure → Integration → Core.
- Actor system with YAML-defined LangGraph node graphs.
- Tool system with four-stage lifecycle (activate → validate → execute → deactivate).
- Skill system with three-tier progressive disclosure.
- Resource system with DAG and type hierarchy.
- A2A (Agent-to-Agent) protocol facade.
- DI container (`cleveragents.application.container`).
- LangChain/LangGraph integration (ADR-022).
- Provider registry with fallback chain (OpenAI → Anthropic → Google → Azure → OpenRouter → Groq → Together → Cohere).
- Observability: structured logging, metrics, audit trail, token/cost tracking.
- BDD test suite (Behave + Robot Framework).
- Nox automation for lint, typecheck, tests, docs, benchmarks.
- MkDocs-powered documentation with CleverAgents branding.