cleveragents/cleveragents-core
4
0
Fork 3
Code Issues 6.0k Pull Requests 115 Actions Packages Projects Releases Wiki Activity

docs: architecture — fill critical spec gaps for milestones v3.2.0–v3.7.0 #7796

Closed
HAL9000 wants to merge 2 commits from spec/architecture-critical-gap-fixes into master
pull from: spec/architecture-critical-gap-fixes
merge into: cleveragents:master
Conversation 5 Commits 2 Files Changed 1
+908 -5

2 Commits

Author SHA1 Message Date
HAL9000 d14dc51e04 docs: align guard spec with lifecycle states
CI / lint (pull_request) Successful in 41s
Details
CI / typecheck (pull_request) Successful in 1m16s
Details
CI / security (pull_request) Successful in 57s
Details
CI / quality (pull_request) Successful in 45s
Details
CI / build (pull_request) Successful in 18s
Details
CI / helm (pull_request) Successful in 32s
Details
CI / push-validation (pull_request) Successful in 22s
Details
CI / e2e_tests (pull_request) Successful in 4m55s
Details
CI / integration_tests (pull_request) Successful in 7m15s
Details
CI / unit_tests (pull_request) Successful in 8m31s
Details
CI / docker (pull_request) Successful in 1m32s
Details
CI / coverage (pull_request) Successful in 11m35s
Details
CI / status-check (pull_request) Successful in 1s
Details
2026-04-14 10:41:15 +00:00
HAL9000 25a1602bec docs(spec): fill critical gaps for milestones v3.2.0–v3.7.0 
Add missing spec sections identified during architecture review:

Critical gaps resolved:
- Add `agents plan guard` CLI command to synopsis and command reference
  (v3.5.0 Deliverable 12 — was referenced but had no spec)
- Add `agents tui` and `agents tui web` CLI commands to synopsis and
  command reference (v3.7.0 Deliverables 1, 18 — absent from CLI index)
- Add `### Merge Strategies` section with git three-way merge algorithm,
  MergeWorkflow component, MergeResult/MergeConflict data models, and
  conflict resolution UX (v3.3.0 Deliverables 5, 6)
- Add `### Autonomy Acceptance` section with formal acceptance criteria,
  reference task specification, and Robot Framework acceptance test
  (v3.5.0 Deliverable 10)

Moderate gaps resolved:
- Add `### Guard Enforcement` section with GuardEnforcer component,
  guard evaluation order, guard sources, and violation behavior table
  (v3.5.0 Deliverable 3)
- Add `### Event Queue` section with event types, event schema,
  publish/subscribe API, and local vs. server mode behavior
  (v3.5.0 Deliverable 2)
- Add `### TUI Materializer` section with ElementHandle→widget mapping,
  TuiMaterializer interface, A2A integration, and thread safety
  (v3.7.0 Deliverable 7)
- Add `### Provider Registry` section with built-in providers, custom
  provider YAML, auto-discovery, and ProviderRegistry API
  (v3.6.0 Deliverable 11)
- Add `### Testing Strategy — E2E` section with Robot Framework test
  structure, required E2E coverage table, and shared keywords
  (v3.6.0 Deliverable 15)

Minor fixes:
- Fix broken anchor links in milestone spec coverage references
- Update v3.2.0 spec coverage to point to actual section headings
- Update v3.4.0 context storage tiers anchor to match actual heading
- Add `agents tui` commands to `#### agents tui` command reference section
 2026-04-14 10:41:15 +00:00