feat: Update version to 0.8.11 and revise documentation references to AGENTS.md

This commit is contained in:
sha
2026-04-12 10:46:27 +03:00
parent 2e652ae58a
commit 3241f5d435
33 changed files with 116 additions and 65 deletions
+2
View File
@@ -9,3 +9,5 @@ wheels/
.venv
# Test-generated files
src/test/datasets/sample_mediafiles/
.pytest_cache/
.mypy_cache/
+13 -11
View File
@@ -1,7 +1,7 @@
# moma Engineering Guide
**Version**: 0.7.0-dev
**Last Updated**: 2026-01-01
**Version**: 0.8.11
**Last Updated**: 2026-04-11
**Python**: 3.11+
**Status**: Active Development
@@ -34,7 +34,7 @@ moma is a sophisticated Terminal User Interface (TUI) application for managing,
### Current Version
- **Version**: 0.7.0-dev (in development)
- **Version**: 0.8.11 (in development)
- **Python**: 3.11+
- **License**: Not specified
- **Repository**: `/Users/sha/Developer/sha.dev/moma`
@@ -386,12 +386,14 @@ Access via Ctrl+P:
- Safe for concurrent extractor access
- Memory cache synchronized with file cache
### 8. UI Screens (`src/screens.py`)
### 8. UI Screens (`src/views/`)
1. **OpenScreen**: Directory selection dialog with validation
2. **HelpScreen**: Comprehensive help with key bindings
3. **RenameConfirmScreen**: File rename confirmation with error handling
4. **SettingsScreen**: Settings configuration interface
1. **OpenScreen** (`open_screen.py`): Directory selection dialog with validation
2. **HelpScreen** (`help_screen.py`): Comprehensive help with key bindings
3. **RenameConfirmScreen** (`rename_confirm_screen.py`): File rename confirmation with error handling
4. **ConvertConfirmScreen** (`convert_confirm_screen.py`): AVI/MP4/WebM → MKV conversion confirmation
5. **DeleteConfirmScreen** (`delete_confirm_screen.py`): File deletion confirmation
6. **SettingsScreen** (`settings_screen.py`): Settings configuration interface
### 9. Settings System (`src/settings.py`)
@@ -933,12 +935,12 @@ Title (Year) [Resolution Source Edition].ext
- **INSTALL.md**: Installation methods
- **DEVELOP.md**: Developer setup and debugging
- **CHANGELOG.md**: Version history and changes
- **REFACTORING_PROGRESS.md**: Future refactoring plans
- **ToDo.md**: Current task list
- **docs/REFACTORING_PROGRESS.md**: Future refactoring plans
- **docs/ToDo.md**: Current task list
---
**Last Updated**: 2026-01-01
**Last Updated**: 2026-04-11
**Maintainer**: sha
**For**: AI Assistants and Developers
**Repository**: `/Users/sha/Developer/sha.dev/moma`
+61 -12
View File
@@ -10,15 +10,64 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
## [Unreleased]
### Future Plans
See [REFACTORING_PROGRESS.md](REFACTORING_PROGRESS.md) and [ToDo.md](ToDo.md) for upcoming features and improvements.
See [docs/REFACTORING_PROGRESS.md](docs/REFACTORING_PROGRESS.md) and [docs/ToDo.md](docs/ToDo.md) for upcoming features and improvements.
---
## [0.7.0-dev] - 2026-01-01
## [0.8.11] - 2026-04-11
### Changed
- Renamed project package from `renamer` to `moma`, CLI command is now `moma`
- Main app class renamed `RenamerApp``MomaApp`
- Package source directory renamed `renamer/``src/`
- Config path `~/.config/renamer/``~/.config/moma/`
- Cache path `~/.cache/renamer/``~/.cache/moma/`
- Migrated repository to GitHub: `git@github.com:shadoll/moma.git`
---
## [0.8.10] - 2026-04-10
### Added
- **OpenScreen**: Dedicated screen for directory input with validation
- **ConvertConfirmScreen**: Conversion confirmation for AVI/MP4/WebM → MKV
- **DeleteConfirmScreen**: File deletion confirmation screen
- **Singleton logging configuration** (`logging_config.py`)
### Fixed
- Improved scan commands and key bindings usability
- MP4 and WebM support in conversion service
---
## [0.7.10] - 2026-02-01
### Added
- **Poster rendering**: ASCII art, Viu, and RichPixels poster display options
- **HEVC encoding options**: configurable CRF and preset in settings
- **MPG/MPEG format support** in conversion service
- **Genre extraction** added to media properties panel
- **File icons** in directory tree
- **Delete file functionality** with confirmation
### Changed
- Refactored `FormatterApplier` class (removed, inlined)
- Consolidated text color decorators
- Improved scan type detection for interlaced content
- Updated bitrate calculation in `TrackFormatter`
- Replaced dots with spaces in title normalization
### Fixed
- Poster handling and rendering in catalog mode
- TMDB data retrieval improvements
---
## [0.7.0] - 2026-01-01
### Major Refactoring (Phases 1-3)
This development version represents a significant refactoring effort focused on code quality, architecture, and maintainability.
Significant refactoring focused on code quality, architecture, and maintainability.
---
@@ -122,18 +171,18 @@ This development version represents a significant refactoring effort focused on
### Documentation Improvements
#### Added
- **ENGINEERING_GUIDE.md**: Comprehensive 900+ line technical reference
- **AGENTS.md**: Comprehensive 900+ line technical reference
- **CHANGELOG.md**: This file
#### Changed
- **CLAUDE.md**: Streamlined to pointer to ENGINEERING_GUIDE.md
- **AI_AGENT.md**: Marked as deprecated, points to ENGINEERING_GUIDE.md
- **DEVELOP.md**: Streamlined with references to ENGINEERING_GUIDE.md
- **CLAUDE.md**: Streamlined to pointer to AGENTS.md
- **AI_AGENT.md**: Marked as deprecated, points to AGENTS.md
- **DEVELOP.md**: Streamlined with references to AGENTS.md
- **README.md**: Streamlined user guide with references
#### Removed
- Outdated version information from documentation files
- Duplicated content now in ENGINEERING_GUIDE.md
- Duplicated content now in AGENTS.md
---
@@ -216,10 +265,10 @@ This development version represents a significant refactoring effort focused on
## Links
- [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md) - Complete technical documentation
- [REFACTORING_PROGRESS.md](REFACTORING_PROGRESS.md) - Future refactoring plans
- [ToDo.md](ToDo.md) - Current task list
- [AGENTS.md](AGENTS.md) - Complete technical documentation
- [docs/REFACTORING_PROGRESS.md](docs/REFACTORING_PROGRESS.md) - Future refactoring plans
- [docs/ToDo.md](docs/ToDo.md) - Current task list
---
**Last Updated**: 2026-01-01
**Last Updated**: 2026-04-11
+6 -6
View File
@@ -1,13 +1,13 @@
# CLAUDE.md - AI Assistant Reference
**Version**: 0.7.0-dev
**Last Updated**: 2026-01-01
**Version**: 0.8.11
**Last Updated**: 2026-04-11
> **📘 All technical documentation has been moved to [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)**
> **📘 All technical documentation has been moved to [AGENTS.md](AGENTS.md)**
## For AI Assistants
Please read **[ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)** for complete project documentation including:
Please read **[AGENTS.md](AGENTS.md)** for complete project documentation including:
- Architecture overview
- Core components
@@ -27,7 +27,7 @@ uv run moma [dir] # Run
## Essential Principles
1. **Read [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md) first**
1. **Read [AGENTS.md](AGENTS.md) first**
2. Read files before modifying
3. Test everything (`uv run pytest`)
4. Follow existing patterns
@@ -35,4 +35,4 @@ uv run moma [dir] # Run
---
**Full Documentation**: [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)
**Full Documentation**: [AGENTS.md](AGENTS.md)
+9 -9
View File
@@ -1,9 +1,9 @@
# Developer Guide
**Version**: 0.7.0-dev
**Last Updated**: 2026-01-01
**Version**: 0.8.11
**Last Updated**: 2026-04-11
> **📘 For complete development documentation, see [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)**
> **📘 For complete development documentation, see [AGENTS.md](AGENTS.md)**
Quick reference for developers working on the moma project.
@@ -80,7 +80,7 @@ uv run pytest -xvs
uv run python src/test/fill_sample_mediafiles.py
```
See [ENGINEERING_GUIDE.md - Testing Strategy](ENGINEERING_GUIDE.md#testing-strategy)
See [AGENTS.md - Testing Strategy](AGENTS.md#testing-strategy)
---
@@ -100,19 +100,19 @@ uv tool install .
uv run moma /path/to/test/media
```
See [ENGINEERING_GUIDE.md - Release Process](ENGINEERING_GUIDE.md#release-process)
See [AGENTS.md - Release Process](AGENTS.md#release-process)
---
## Documentation
- **[ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)** - Complete technical reference
- **[AGENTS.md](AGENTS.md)** - Complete technical reference
- **[README.md](README.md)** - User guide
- **[INSTALL.md](INSTALL.md)** - Installation instructions
- **[CHANGELOG.md](CHANGELOG.md)** - Version history
- **[REFACTORING_PROGRESS.md](REFACTORING_PROGRESS.md)** - Future plans
- **[ToDo.md](ToDo.md)** - Current tasks
- **[docs/REFACTORING_PROGRESS.md](docs/REFACTORING_PROGRESS.md)** - Future plans
- **[docs/ToDo.md](docs/ToDo.md)** - Current tasks
---
**For complete documentation, see [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)**
**For complete documentation, see [AGENTS.md](AGENTS.md)**
+9 -11
View File
@@ -25,10 +25,10 @@ powershell -c "irm https://astral.sh/uv/install.sh | iex"
#### Install moma
```bash
# One-command install from remote wheel
uv tool install https://github.com/shadoll/moma/raw/branch/main/dist/moma-0.2.4-py3-none-any.whl
uv tool install https://github.com/shadoll/moma/raw/branch/main/dist/moma-0.8.11-py3-none-any.whl
# Or from local wheel (if downloaded)
uv tool install dist/moma-0.2.4-py3-none-any.whl
uv tool install dist/moma-0.8.11-py3-none-any.whl
# Or from PyPI (when published)
uv tool install moma
@@ -46,10 +46,10 @@ If you have the wheel file, you can install it with pip.
```bash
# Install the wheel
pip install dist/moma-0.2.0-py3-none-any.whl
pip install dist/moma-0.8.11-py3-none-any.whl
# Or install globally (may require sudo)
sudo pip install dist/moma-0.2.0-py3-none-any.whl
sudo pip install dist/moma-0.8.11-py3-none-any.whl
```
### Method 3: Development Installation
@@ -58,15 +58,15 @@ For development or if you want to run from source:
#### Clone and Setup
```bash
git clone <repository-url>
git clone git@github.com:shadoll/moma.git
cd moma
# Install dependencies
uv sync
# Run directly
uv run python main.py
uv run python main.py /path/to/directory
uv run python src/main.py
uv run python src/main.py /path/to/directory
```
#### Install in Development Mode
@@ -87,8 +87,8 @@ python3 --version
pip install textual mutagen pymediainfo python-magic langcodes
# Run the application
python3 main.py
python3 main.py /path/to/directory
python3 src/main.py
python3 src/main.py /path/to/directory
```
## System Requirements
@@ -121,8 +121,6 @@ After installation, verify it works:
```bash
moma --help
# or
python3 main.py --help
```
You should see the help text for the moma application.
+5 -5
View File
@@ -1,10 +1,10 @@
# moma - Media Manager, File Renamer and Metadata Viewer
**Version**: 0.7.0-dev
**Version**: 0.8.11
A powerful Terminal User Interface (TUI) for managing media collections. View detailed metadata, browse TMDB catalog with posters, and intelligently rename files.
> **📘 For complete documentation, see [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)**
> **📘 For complete documentation, see [AGENTS.md](AGENTS.md)**
---
@@ -133,7 +133,7 @@ src/
└── constants/ # Configuration constants
```
See [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md) for complete architecture documentation.
See [AGENTS.md](AGENTS.md) for complete architecture documentation.
---
@@ -156,7 +156,7 @@ See [DEVELOP.md](DEVELOP.md) for development documentation.
## Documentation
- **[ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)** - Complete technical reference
- **[AGENTS.md](AGENTS.md)** - Complete technical reference
- **[INSTALL.md](INSTALL.md)** - Installation instructions
- **[DEVELOP.md](DEVELOP.md)** - Development guide
- **[CHANGELOG.md](CHANGELOG.md)** - Version history
@@ -178,4 +178,4 @@ Not specified
---
**For complete documentation, see [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md)**
**For complete documentation, see [AGENTS.md](AGENTS.md)**
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Binary file not shown.
+6 -6
View File
@@ -1,11 +1,11 @@
# moma - Refactoring Roadmap
**Version**: 0.7.0-dev
**Last Updated**: 2026-01-01
**Version**: 0.8.11
**Last Updated**: 2026-04-11
> **📋 For completed work, see [CHANGELOG.md](CHANGELOG.md)**
This document tracks the future refactoring plan for moma v0.7.0+.
This document tracks the future refactoring plan for moma v0.8.x+.
---
@@ -220,7 +220,7 @@ grep -r "import src.decorators.caching" src/
**Status**: NOT STARTED
#### 6.1 Update Technical Documentation
-ENGINEERING_GUIDE.md created
-AGENTS.md created
- [ ] API documentation generation
- [ ] Architecture diagrams
- [ ] Component interaction flows
@@ -403,6 +403,6 @@ grep -r "import src.decorators.caching" src/
**See Also**:
- [CHANGELOG.md](CHANGELOG.md) - Completed work
- [ToDo.md](ToDo.md) - Future feature requests
- [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md) - Technical documentation
- [AGENTS.md](AGENTS.md) - Technical documentation
**Last Updated**: 2026-01-01
**Last Updated**: 2026-04-11
+5 -5
View File
@@ -1,7 +1,7 @@
# moma - Future Tasks
**Version**: 0.7.0-dev
**Last Updated**: 2026-01-01
**Version**: 0.8.11
**Last Updated**: 2026-04-11
> **📋 For completed work, see [CHANGELOG.md](CHANGELOG.md)**
>
@@ -165,12 +165,12 @@ See [REFACTORING_PROGRESS.md](REFACTORING_PROGRESS.md) for current limitations a
Before working on any task:
1. Check [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md) for architecture details
1. Check [AGENTS.md](AGENTS.md) for architecture details
2. Review [CHANGELOG.md](CHANGELOG.md) for recent changes
3. Read [DEVELOP.md](DEVELOP.md) for development setup
4. Run tests: `uv run pytest`
5. Follow code standards in [ENGINEERING_GUIDE.md](ENGINEERING_GUIDE.md#code-standards)
5. Follow code standards in [AGENTS.md](AGENTS.md#code-standards)
---
**Last Updated**: 2026-01-01
**Last Updated**: 2026-04-11