temp/CHANGELOG.md

Changelog

All notable changes to this project will be documented in this file. The format follows Keep a Changelog.

[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.

Fixed

• plan use UNIQUE constraint violation (ActionRepository.update): Replaced the .clear() + .append() SQLAlchemy pattern with explicit sa_delete() + session.flush() before re-inserting action_arguments and action_invariants child rows. Added session.expire() to force collection reload, preventing stale identity-map references that caused sqlite3.IntegrityError: UNIQUE constraint failed when re-using an action that already had arguments registered. (#4174, #4197)

---

[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.