[AUTO-SPEC-1] Proposal: Update specification for v3.6.0 Advanced Concepts and v3.7.0 TUI features #10533

Closed
opened 2026-04-18 17:06:54 +00:00 by HAL9000 · 0 comments
Owner

Metadata

Commit: HEAD (current working tree)
Branch: main
Status: PROPOSAL (awaiting human feedback)
Supervisor: Specification Evolution Supervisor

Background and Context

Two pull requests are currently in progress to document v3.6.0 (Advanced Concepts & Deferred Features) and v3.7.0 (TUI Implementation) features. The specification needs to be updated to reflect the scope, architecture, and implementation details of these milestones.

Related PRs:

  • PR #10009: "docs(spec): fix invariant reconciliation, add ACMS thread safety, v3.6.0 section, ADR-049"
  • PR #9903: "[AUTO-DOCS-5] docs(milestone): Add v3.6.0 Advanced Concepts and v3.7.0 TUI documentation"

Expected Behavior

The specification documentation should comprehensively cover:

  1. v3.6.0 (M7): Advanced Concepts & Deferred Features

    • Advanced context strategies (cross-project merging, incremental updates, semantic deduplication, adaptive tier promotion, resource-type-aware budgeting)
    • Additional LLM backends (Google Gemini, Mistral AI, Ollama, LM Studio, Azure OpenAI, AWS Bedrock, Groq, provider fallback chains)
    • New resource types (cloud infrastructure, database, virtual types)
    • ACP to A2A module rename (ADR-047)
    • Container tool execution (ADR-039, ADR-043)
    • Pluggable scope chain resolution
    • Cost and session budgets with SafetyProfile enforcement (ADR-041)
    • E2E workflow specification tests
    • Code review tool examples
    • Plugin architecture extensions
  2. v3.7.0 (M8): TUI Implementation

    • TUI installation and setup
    • MainScreen layout (conversation stream, sidebar states, throbber, session tabs)
    • Persona system (YAML-based actor + args + scope + presets, ADR-045)
    • Reference and command input system (@, /, ! modes, ADR-046)
    • Session management (SQLite persistence)
    • Settings and configuration screens
    • Theming and UI (Dracula theme, notifications, content pruning)
    • TuiMaterializer integration

Acceptance Criteria

  • PR #10009 reviewed and approved for v3.6.0 specification updates
  • PR #9903 reviewed and approved for comprehensive feature documentation
  • docs/specification.md updated with v3.6.0 Advanced Concepts section
  • docs/advanced-concepts.md created with v3.6.0 features documentation
  • docs/tui.md created with v3.7.0 features documentation
  • CHANGELOG.md updated with v3.6.0 and v3.7.0 sections
  • mkdocs.yml updated with new documentation entries
  • All CI checks passing
  • Specification verified against implementation status

Subtasks

PR #10009 Review and Merge

  • Review invariant reconciliation fix
  • Verify ACMS thread-safety documentation
  • Verify v3.6.0 Advanced Concepts section completeness
  • Verify ADR-049 documentation
  • Approve and merge PR #10009

PR #9903 Review and Merge

  • Resolve CI failures (e2e_tests)
  • Address file size violations (split docs/advanced-concepts.md and docs/tui.md if needed)
  • Add missing metadata (Closes #N, ISSUES CLOSED footer, CONTRIBUTORS.md)
  • Verify branch naming convention
  • Approve and merge PR #9903

Specification Verification

  • Verify v3.6.0 section covers all milestone scope items
  • Verify v3.7.0 section covers all TUI features
  • Cross-reference ADRs (ADR-039, ADR-041, ADR-043, ADR-044, ADR-045, ADR-046, ADR-047, ADR-049)
  • Verify alignment with implementation status

Definition of Done

This proposal is complete when:

  1. Both PRs (#10009 and #9903) have been reviewed and merged
  2. The specification documentation reflects v3.6.0 and v3.7.0 scope
  3. All CI checks pass
  4. The specification is verified against the actual implementation
  5. Documentation is accessible via mkdocs

Automated by CleverAgents Bot
Agent: new-issue-creator
Supervisor: Spec Evolution | Agent: spec-update-pool-supervisor

## Metadata **Commit:** HEAD (current working tree) **Branch:** main **Status:** PROPOSAL (awaiting human feedback) **Supervisor:** Specification Evolution Supervisor ## Background and Context Two pull requests are currently in progress to document v3.6.0 (Advanced Concepts & Deferred Features) and v3.7.0 (TUI Implementation) features. The specification needs to be updated to reflect the scope, architecture, and implementation details of these milestones. **Related PRs:** - PR #10009: "docs(spec): fix invariant reconciliation, add ACMS thread safety, v3.6.0 section, ADR-049" - PR #9903: "[AUTO-DOCS-5] docs(milestone): Add v3.6.0 Advanced Concepts and v3.7.0 TUI documentation" ## Expected Behavior The specification documentation should comprehensively cover: 1. **v3.6.0 (M7): Advanced Concepts & Deferred Features** - Advanced context strategies (cross-project merging, incremental updates, semantic deduplication, adaptive tier promotion, resource-type-aware budgeting) - Additional LLM backends (Google Gemini, Mistral AI, Ollama, LM Studio, Azure OpenAI, AWS Bedrock, Groq, provider fallback chains) - New resource types (cloud infrastructure, database, virtual types) - ACP to A2A module rename (ADR-047) - Container tool execution (ADR-039, ADR-043) - Pluggable scope chain resolution - Cost and session budgets with SafetyProfile enforcement (ADR-041) - E2E workflow specification tests - Code review tool examples - Plugin architecture extensions 2. **v3.7.0 (M8): TUI Implementation** - TUI installation and setup - MainScreen layout (conversation stream, sidebar states, throbber, session tabs) - Persona system (YAML-based actor + args + scope + presets, ADR-045) - Reference and command input system (@, /, ! modes, ADR-046) - Session management (SQLite persistence) - Settings and configuration screens - Theming and UI (Dracula theme, notifications, content pruning) - TuiMaterializer integration ## Acceptance Criteria - [ ] PR #10009 reviewed and approved for v3.6.0 specification updates - [ ] PR #9903 reviewed and approved for comprehensive feature documentation - [ ] docs/specification.md updated with v3.6.0 Advanced Concepts section - [ ] docs/advanced-concepts.md created with v3.6.0 features documentation - [ ] docs/tui.md created with v3.7.0 features documentation - [ ] CHANGELOG.md updated with v3.6.0 and v3.7.0 sections - [ ] mkdocs.yml updated with new documentation entries - [ ] All CI checks passing - [ ] Specification verified against implementation status ## Subtasks ### PR #10009 Review and Merge - [ ] Review invariant reconciliation fix - [ ] Verify ACMS thread-safety documentation - [ ] Verify v3.6.0 Advanced Concepts section completeness - [ ] Verify ADR-049 documentation - [ ] Approve and merge PR #10009 ### PR #9903 Review and Merge - [ ] Resolve CI failures (e2e_tests) - [ ] Address file size violations (split docs/advanced-concepts.md and docs/tui.md if needed) - [ ] Add missing metadata (Closes #N, ISSUES CLOSED footer, CONTRIBUTORS.md) - [ ] Verify branch naming convention - [ ] Approve and merge PR #9903 ### Specification Verification - [ ] Verify v3.6.0 section covers all milestone scope items - [ ] Verify v3.7.0 section covers all TUI features - [ ] Cross-reference ADRs (ADR-039, ADR-041, ADR-043, ADR-044, ADR-045, ADR-046, ADR-047, ADR-049) - [ ] Verify alignment with implementation status ## Definition of Done This proposal is complete when: 1. Both PRs (#10009 and #9903) have been reviewed and merged 2. The specification documentation reflects v3.6.0 and v3.7.0 scope 3. All CI checks pass 4. The specification is verified against the actual implementation 5. Documentation is accessible via mkdocs --- **Automated by CleverAgents Bot** Agent: new-issue-creator Supervisor: Spec Evolution | Agent: spec-update-pool-supervisor
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#10533
No description provided.