issue-core/CHANGELOG.md

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- Nothing yet

### Changed
- Nothing yet

### Deprecated
- Nothing yet

### Removed
- Nothing yet

### Fixed
- Nothing yet

### Security
- Nothing yet

## [1.0.0] - 2025-12-17

### Added - Architecture & Documentation
- **ReusableCapabilitiesArchitecture.md**: Complete specification (1,182 lines) defining how capabilities are organized, discovered, and integrated by devhumans and devagents
- **Feedback capability**: Lightweight, unstructured feedback collection system
  - `feedback/` directory for user submissions (visible, not hidden)
  - `.capability/feedback` CLI tool for submission and management
  - `feedback/README.md` comprehensive documentation (367 lines)
  - Support for text, file, and direct submission methods
  - Maintainer workflow (list, review, archive, create issues)
- **Detachment facility**: `.capability/detach` script for clean capability removal
  - Generates detachment manifest with re-integration guidance
  - Handles git submodules and directory-based integrations
  - Preserves git history and metadata

### Changed - Architecture Compliance
- **Directory visibility**: Renamed `.feedback/` → `feedback/` to make user interface visible
- **Explicit family declaration**: Renamed `CAPABILITY.yaml` → `CAPABILITY-issue-tracking.yaml`
- **Integration pattern**: Established `_<family>/<implementation>` directory structure
  - Supports family-based organization enabling multiple implementations
  - Underscore prefix signals "integrated capability, not core code"
  - Reduces directory tree depth (3 levels vs 6+ levels)

### Enhanced - Documentation
- **CLAUDE.md**: Added 155 lines documenting feedback system integration
  - User submission methods
  - Maintainer workflow
  - Reusable pattern documentation
- **README.md**: Complete rewrite (399 lines) focusing on agent coordination
  - Emphasis on natural language integration by AI coding agents
  - Use cases for multi-agent coordination
  - Current status and limitations clearly stated
- **CAPABILITY-issue-tracking.yaml**: Enhanced with feedback section
  - Submission methods documented
  - Integration notes for other capabilities
  - Maintainer workflow guidance
- **Examples**: Added `examples/feedback-example.md` (285 lines)
  - Multiple submission methods with examples
  - Feedback categories and best practices
  - What happens to feedback after submission

### Technical - Reference Updates
- Updated all documentation references from `.feedback/` to `feedback/`
- Updated all references from `CAPABILITY.yaml` to `CAPABILITY-issue-tracking.yaml`
- Fixed Makefile commands to use new paths
- Updated `.capability/feedback` script to use visible directory

### Infrastructure
- Established feedback as reusable pattern across all markitect capabilities
- Created migration path for hidden → visible user interfaces
- Documented capability family vs implementation distinction

## [0.9.0] - 2024-12-15

### Added
- Comprehensive Gitea integration tests
- GitLab backend groundwork
- Enhanced agent integration documentation

### Fixed
- ID mapping bugs in issue-facade
- Sync metadata handling
- Backend initialization edge cases

## [0.5.0] - 2024-11-10

### Added
- Capability Makefile for integration with markitect main project
- Development command aliases (install, test, lint)
- Integration targets for parent project

### Changed
- Improved capability isolation and composability
- Enhanced testing infrastructure

## [0.1.0] - 2024-10-06

### Added
- Initial extraction of issue-facade as standalone capability
- Core CRUD operations (create, read, update, delete issues)
- Gitea backend implementation (production-ready)
- Local SQLite backend (offline capability)
- Basic synchronization between backends
- CLI with JSON output for agent consumption
- Python programmatic API
- Comprehensive test suite (109 tests, 61% coverage)

### Architecture
- Facade pattern with plugin architecture
- Backend interface (ABC) for extensibility
- Core domain models (Issue, Label, User, Milestone, Comment)
- State management with backend-specific mapping

### Documentation
- README with usage examples
- AGENT_INTEGRATION.md for autonomous agents
- CLAUDE.md for development guidance
- ROADMAP.md with implementation phases

---

## Version History Summary

- **v1.0.0** (2025-12-17) - Architecture formalization, feedback capability, comprehensive documentation
- **v0.9.0** (2024-12-15) - Gitea integration tests, bug fixes
- **v0.5.0** (2024-11-10) - Capability Makefile, integration improvements
- **v0.1.0** (2024-10-06) - Initial extraction, core functionality

---

## Upgrade Notes

### Upgrading to v1.0.0

**Breaking Changes:**
- File paths updated (`.feedback/` → `feedback/`)
- Capability spec renamed (`CAPABILITY.yaml` → `CAPABILITY-issue-tracking.yaml`)

**Migration Steps:**
```bash
# If you have a clone/fork, update references:
find . -name "*.md" -exec sed -i 's/\.feedback\//feedback\//g' {} +
mv CAPABILITY.yaml CAPABILITY-issue-tracking.yaml

# Update any integration scripts to use new paths
```

**New Features:**
- Use `feedback/` directory for user feedback submissions
- Reference `CAPABILITY-issue-tracking.yaml` in integration code
- See `ReusableCapabilitiesArchitecture.md` for complete specification

**No API Changes:** All Python APIs and CLI commands remain backward compatible.

---

## Contributing

See the [ROADMAP](ROADMAP.md) for planned features and implementation timeline.

For development guidance, see [CLAUDE.md](CLAUDE.md).

To submit feedback, see [feedback/README.md](feedback/README.md).

---

## Links

- [Repository](http://92.205.130.254:32166/coulomb/issue-facade)
- [Issues](http://92.205.130.254:32166/coulomb/issue-facade/issues)
- [MarkiTect Project](https://github.com/markitect)