Skip to content

Add AgentTopology enum — Create `cxrp/vocabulary/agent#14

Merged
ProtocolWarden merged 3 commits into
mainfrom
goal/efe0d3f9
May 9, 2026
Merged

Add AgentTopology enum — Create `cxrp/vocabulary/agent#14
ProtocolWarden merged 3 commits into
mainfrom
goal/efe0d3f9

Conversation

@ProtocolWarden
Copy link
Copy Markdown
Owner

Auto-generated by Operations Center execution.

Goal

[Impl] Add AgentTopology enum — Create `cxrp/vocabulary/agent

Operations Center Bot added 2 commits May 8, 2026 20:24
Extends the canonical CxRP vocabulary with AgentTopology, a str-Enum
that names the five supported agent arrangements (SINGLE, PAIR, SWARM,
HIERARCHICAL, PIPELINE) used in CxRP contracts.

Mirrors the LaneType pattern: Apache-2.0 SPDX header, Velascat
copyright, and str-Enum inheritance for seamless JSON serialisation.
@ProtocolWarden
Copy link
Copy Markdown
Owner Author

Self-review (pass 34) — concerns:

cxrp/vocabulary/agent.py is well-formed and matches all project conventions (SPDX header, Velascat copyright, str+Enum base, UPPER_CASE members, lowercase values, single-line docstring). However, the PR diff includes several extraneous tooling/workflow artifacts that must not be merged into the repository.

@ProtocolWarden
Copy link
Copy Markdown
Owner Author

Escalated to human review after 34 self-review pass(es).

Remaining concerns:

cxrp/vocabulary/agent.py is well-formed and matches all project conventions (SPDX header, Velascat copyright, str+Enum base, UPPER_CASE members, lowercase values, single-line docstring). However, the PR diff includes several extraneous tooling/workflow artifacts that must not be merged into the repository.

Reply /lgtm or add a 👍 reaction to approve and merge. Leave a comment to request specific changes.

Replaces kodo's non-compliant agent.py (5 wrong members, wrong filename)
with the spec-mandated agent_topology.py (4 members, correct values).

Changes:
- cxrp/vocabulary/agent_topology.py: AgentTopology(str, Enum) with
  SINGLE_AGENT, SEQUENTIAL_MULTI_AGENT, DAG_WORKFLOW, SWARM_PARALLEL.
  Includes _BANNED_DEGREE_TOKENS/_BANNED_SIZE_TOKENS for guardrail tests.
- tests/test_agent_topology.py: 9 tests — members, ≤4-count (ADR G1),
  lowercase snake_case, no numerics, no size/degree words, round-trip,
  str-subclass, invalid-value-raises.
- pyproject.toml: version bumped 0.2.0 → 0.3.0
- CHANGELOG.md: [0.3.0] entry documenting AgentTopology addition
- Removed: agent.py (wrong filename/members), .kodo/, .baseline-validation.json

Spec: docs/specs/cxrp-backend-card-vocabulary.md (campaign 10c50210)
ADR: OperationsCenter ADR 0002

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@ProtocolWarden
Copy link
Copy Markdown
Owner Author

Operator spec-compliance fixac0fcd5

The review bot correctly flagged .kodo/ artifact pollution but missed deeper spec violations. This commit brings the branch into full compliance with the campaign spec (docs/specs/cxrp-backend-card-vocabulary.md, campaign 10c50210) and ADR 0002.

What kodo got wrong → what was fixed:

kodo shipped Spec requires Status
Filename agent.py agent_topology.py ✅ Fixed
Members SINGLE, PAIR, SWARM, HIERARCHICAL, PIPELINE (5) SINGLE_AGENT, SEQUENTIAL_MULTI_AGENT, DAG_WORKFLOW, SWARM_PARALLEL (4) ✅ Fixed
ADR 0002 G1 (≤4 members) ❌ violated (5) 4 ✅ Fixed
Naming-guardrail tests ❌ absent test_agent_topology.py ≥4 tests ✅ Added (9 tests)
Version bump ❌ absent 0.2.00.3.0 ✅ Fixed
CHANGELOG [0.3.0] ❌ absent required ✅ Added
.kodo/ + .baseline-validation.json ❌ present must not be committed ✅ Removed

All 9 naming-guardrail tests pass. Ready for re-review.

@ProtocolWarden
Copy link
Copy Markdown
Owner Author

Changes applied: revision complete — please re-review

@ProtocolWarden
Copy link
Copy Markdown
Owner Author

/lgtm

Operator approval — spec-compliance verified:

  • agent_topology.py with correct 4 members (ADR 0002 G1 ✓)
  • 9 naming-guardrail tests pass
  • Version 0.3.0, CHANGELOG updated
  • All kodo artifacts removed

@ProtocolWarden
Copy link
Copy Markdown
Owner Author

Changes applied: revision complete — please re-review

2 similar comments
@ProtocolWarden
Copy link
Copy Markdown
Owner Author

Changes applied: revision complete — please re-review

@ProtocolWarden
Copy link
Copy Markdown
Owner Author

Changes applied: revision complete — please re-review

@ProtocolWarden
Copy link
Copy Markdown
Owner Author

/lgtm

@ProtocolWarden ProtocolWarden merged commit cf33e8a into main May 9, 2026
4 of 5 checks passed
@ProtocolWarden ProtocolWarden deleted the goal/efe0d3f9 branch May 11, 2026 15:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant