UAT: `ActorConfigSchema.version` defaults to `"1.0"` — spec says default schema version is `"3.0"` #5880

New issue

Open

opened 2026-04-09 11:24:19 +00:00 by HAL9000 · 0 comments

HAL9000 commented

2026-04-09 11:24:19 +00:00

Owner

Bug Report

Feature Area: Actor System — v3 YAML schema version default
Severity: Medium (incorrect default version stored in registry; may cause version-based routing issues)
Discovered by: UAT Testing (uat-pool-1, worker: actor-system)

What Was Tested

The default value of version field in ActorConfigSchema and ActorRegistry.DEFAULT_SCHEMA_VERSION.

Expected Behavior (from spec)

Per docs/specification.md (Actor Configuration Files section):

version: "3.0" — Schema version (default: "3.0")

The spec states the default schema version for actor configuration files is "3.0".

Actual Behavior (from implementation)

src/cleveragents/actor/schema.py (line 715):

version: str = Field(default="1.0", description="Schema version")

src/cleveragents/actor/registry.py (line 29):

DEFAULT_SCHEMA_VERSION: str = "1.0"

Both default to "1.0" instead of "3.0".

Impact

Actors registered without an explicit version field are stored with schema_version = "1.0" in the database
If version-based routing or migration logic is added in the future, actors will be incorrectly classified as v1 instead of v3
The schema_version field in agents actor show output will show "1.0" for v3 actors, which is misleading

Fix

Change the defaults:

ActorConfigSchema.version: Field(default="3.0", ...)
ActorRegistry.DEFAULT_SCHEMA_VERSION: "3.0"

Metadata

Field	Value
Commit Message	`fix(actor): set default schema version to "3.0" in ActorConfigSchema and ActorRegistry`
Branch	`fix/actor-schema-version-default`
Milestone	Backlog

Subtasks

Update ActorConfigSchema.version default to "3.0"
Update ActorRegistry.DEFAULT_SCHEMA_VERSION to "3.0"
Update any tests that assert schema_version == "1.0"

Definition of Done

New actors registered without explicit version field have schema_version = "3.0" in the registry
agents actor show <name> displays schema_version: 3.0 for v3 actors

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area**: Actor System — v3 YAML schema version default **Severity**: Medium (incorrect default version stored in registry; may cause version-based routing issues) **Discovered by**: UAT Testing (uat-pool-1, worker: actor-system) --- ## What Was Tested The default value of `version` field in `ActorConfigSchema` and `ActorRegistry.DEFAULT_SCHEMA_VERSION`. ## Expected Behavior (from spec) Per `docs/specification.md` (Actor Configuration Files section): > `version: "3.0"` — Schema version (default: "3.0") The spec states the default schema version for actor configuration files is `"3.0"`. ## Actual Behavior (from implementation) **`src/cleveragents/actor/schema.py`** (line 715): ```python version: str = Field(default="1.0", description="Schema version") ``` **`src/cleveragents/actor/registry.py`** (line 29): ```python DEFAULT_SCHEMA_VERSION: str = "1.0" ``` Both default to `"1.0"` instead of `"3.0"`. ## Impact - Actors registered without an explicit `version` field are stored with `schema_version = "1.0"` in the database - If version-based routing or migration logic is added in the future, actors will be incorrectly classified as v1 instead of v3 - The `schema_version` field in `agents actor show` output will show `"1.0"` for v3 actors, which is misleading ## Fix Change the defaults: - `ActorConfigSchema.version`: `Field(default="3.0", ...)` - `ActorRegistry.DEFAULT_SCHEMA_VERSION`: `"3.0"` --- ### Metadata | Field | Value | |-------|-------| | Commit Message | `fix(actor): set default schema version to "3.0" in ActorConfigSchema and ActorRegistry` | | Branch | `fix/actor-schema-version-default` | | Milestone | Backlog | ### Subtasks - [ ] Update `ActorConfigSchema.version` default to `"3.0"` - [ ] Update `ActorRegistry.DEFAULT_SCHEMA_VERSION` to `"3.0"` - [ ] Update any tests that assert `schema_version == "1.0"` ### Definition of Done - New actors registered without explicit `version` field have `schema_version = "3.0"` in the registry - `agents actor show <name>` displays `schema_version: 3.0` for v3 actors --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

labels

2026-04-09 11:29:36 +00:00

HAL9000 referenced this issue