Release v3.6.0: Context Window Optimization - Token-Aware Artifact Injection

Context Window Optimization - Token-Aware Artifact Injection (v3.6.0)

Added

• ArtifactContextBuilder with token estimation and priority ordering
• Token-aware artifact budgeting for workflow artifacts
• Configuration options: artifact_context_budget_tokens (default 4000)
• 24 comprehensive unit tests (22 passing)

Changed

• BuildOrchestrator refactored to use token budgets instead of character limits
• Smart artifact prioritization: spec → user_stories → architecture → api_design

Fixed

• Context overflow prevention in implementer steps
• Addresses root cause of 53 failed workflows

Documentation

• Updated CONFIGURATION.md
• Added implementation status tracking documents
• Complete implementation plan documentation

Impact: Prevents context window overflow, improves workflow success rate, reduces token waste through intelligent prioritization.

v3.5.41 - Workflow Error Handling Fix (BUG-003B)

🐛 Bug Fixes

BUG-003B: Workflow Error Handling & Recovery

Fixed critical workflow error handling issues:

• ✅ Failed steps now marked as FAILED (❌), not completed (✅)
• ✅ Workflows halt immediately when required steps fail
• ✅ Dependent steps skipped with clear reasons when dependencies fail
• ✅ Task status correctly updates to "blocked" on failure (not reset to "todo")
• ✅ Error messages include full stack traces and actionable information

Technical Changes

New: StepResult dataclass in tapps_agents/workflow/models.py

• Proper error tracking with success/failure status
• Error details and stack traces
• Artifacts and skip reasons
• JSON serialization support

Updated: cursor_executor.py

• Return StepResult instead of raising exceptions
• Added _can_execute_step() dependency validation
• Workflow halt logic for required step failures
• Graceful handling of optional step failures

Updated: task.py

• Set task status to "blocked" on workflow failure
• Proper status transitions: todo → in-progress → done/blocked

Quality Metrics

• Code Review Score: 93/100 ✅ (EXCELLENT)
• Test Coverage: Integration tests added
• Documentation: Complete implementation plan and bug resolution docs

Files Changed

• tapps_agents/workflow/models.py - New StepResult type
• tapps_agents/workflow/cursor_executor.py - Error handling refactor
• tapps_agents/cli/commands/task.py - Task status fixes
• tests/integration/test_workflow_error_handling.py - New test suite

---

Full Changelog: v3.5.40...v3.5.41

Release v3.5.35

[3.5.35] - 2026-01-30

Changed

• Release 3.5.35

Release v3.5.32

[3.5.32] - 2026-01-29

Added

• TROUBLESHOOTING_CLI_INSTALLATION.md - Dedicated guide for Windows PATH / user Scripts: why tapps-agents may not be found after pip install, and four options (module fallback, project venv, full path, add Scripts to PATH).

Changed

• README - Windows note after PyPI install: if tapps-agents not found, use venv or python -m tapps_agents.cli; link to troubleshooting doc.
• QUICK_START - Windows section recommends project venv and documents python -m tapps_agents.cli fallback; link to TROUBLESHOOTING_CLI_INSTALLATION.md.
• Release process: PyPI is published automatically when a GitHub release is created (workflow Publish to PyPI on Release).

Documentation

• New Troubleshooting CLI installation for PyPI installs on Windows (user Scripts not on PATH).

Release v3.5.31

[3.5.31] - 2026-01-29

Changed

• Version bump to 3.5.31

Release v3.5.30

[3.5.30] - 2026-01-24

Changed

• Version bump to 3.5.30

Release v3.5.29

Release 3.5.29 - 2026-01-23

Version Update

This release updates the version to 3.5.29.

Changed

• Version bump to 3.5.29

---

Full Changelog: https://github.com/wtthornton/TappsCodingAgents/blob/main/CHANGELOG.md#3529---2026-01-23

Release v3.5.28

Release 3.5.28 - 2026-01-24

Installation & Setup Experience Improvements

This release focuses on improving the installation and setup experience based on user feedback. Key improvements make it easier to get started with TappsCodingAgents, especially on Windows and when using the framework as a subdirectory.

Added

• Working directory detection for init - When run from the TappsCodingAgents framework directory (e.g. as a subdirectory), init warns and offers to initialize in the detected project root (is_framework_directory, detect_project_root).
• Pre-installation Python check - scripts/check_prerequisites.py checks for Python 3.13+; on Windows suggests py -3.13 -m pip install -e . when found.
• tapps-agents docs - Prints documentation URL; --open opens in the default browser.
• .gitattributes export-ignore - Excludes docs, tests, examples, demo, scripts, requirements, tools, and root meta files from git archive (MANIFEST.in unchanged for sdist).

Changed

• Init success messaging - Phased: "Core setup complete. Optional: Context7, Node.js, dev extras. Run 'tapps-agents doctor' for details." when only optional components are missing; MCP/npx no longer treated as hard errors.
• Init "What's next" - "Optional enhancements" block: CONTEXT7_API_KEY, pip install -e \".[dev]\", Node.js; MCP/npx described as optional.
• Context7 setup prompt - Brief explanation of library-docs benefit and that it is optional.
• MCP/Node messaging - "MCP optional features not configured" / "MCP servers are optional; the framework works without them" ( [WARN] instead of [ERROR] when only optional MCP/Node missing).
• Packaging - Removed broad "*" from [tool.setuptools.package-data]; tapps_agents now resources/**/*, experts/**/*. MANIFEST.in: global-exclude for AGENTS.md, CHANGELOG.md, CLAUDE.md, CLAUDE.local.example.md, CONTRIBUTING.md, SECURITY.md.

Documentation

• README / QUICK_START - Python 3.13+ and py -3.13 (Windows) / python3.13 (Linux/macOS); "run init from project root" with correct/wrong examples; check_prerequisites.py; "After installing, run tapps-agents doctor"; Windows and Linux/macOS install subsections.
• Init --help - Note: "Run init from your project root, not from the TappsCodingAgents framework directory."

---

Full Changelog: https://github.com/wtthornton/TappsCodingAgents/blob/main/CHANGELOG.md#3528---2026-01-24

Release v3.5.27

[3.5.27] - 2026-01-24

Changed

• Version bump to 3.5.27

Release v3.5.26

[3.5.26] - 2026-01-23

Changed

• Version bump to 3.5.26