kei-typing-assistant 0.1.0__tar.gz

kei_typing_assistant-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sergei Konovalov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kei_typing_assistant-0.1.0/PKG-INFO

@@ -0,0 +1,249 @@
+Metadata-Version: 2.4
+Name: kei-typing-assistant
+Version: 0.1.0
+Summary: AI-powered desktop typing assistant with real-time ghost-text completions, personalized via local embeddings and semantic example retrieval
+Keywords: typing-assistant,ai,llm,autocomplete,productivity,ghost-text
+Author: Sergei Konovalov
+Author-email: Sergei Konovalov <l0kifs91@gmail.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: MacOS X
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Text Editors :: Text Processing
+Requires-Dist: anthropic>=0.112.0
+Requires-Dist: openai>=2.44.0
+Requires-Dist: llama-cpp-python>=0.3.0
+Requires-Dist: huggingface-hub>=1.21.0
+Requires-Dist: fastembed>=0.8.0
+Requires-Dist: pyqt6>=6.11.0
+Requires-Dist: pynput>=1.8.2
+Requires-Dist: qasync>=0.28.0
+Requires-Dist: typer>=0.9.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: sqlalchemy>=2.0.0
+Requires-Dist: alembic>=1.18.5
+Requires-Dist: pydantic-settings>=2.14.2
+Requires-Dist: loguru>=0.7.3
+Requires-Dist: pydantic>=2.13.4
+Requires-Dist: keyring>=25.7.0
+Requires-Python: >=3.12
+Project-URL: Homepage, https://github.com/l0kifs/kei-typing-assistant
+Project-URL: Repository, https://github.com/l0kifs/kei-typing-assistant
+Project-URL: Issues, https://github.com/l0kifs/kei-typing-assistant/issues
+Project-URL: Changelog, https://github.com/l0kifs/kei-typing-assistant/releases
+Description-Content-Type: text/markdown
+
+# Kei Typing Assistant
+
+An AI-powered desktop typing assistant that provides real-time text completions as ghost text via a floating overlay window, accessible from any application. Learns your writing style over time for increasingly personalized suggestions.
+
+## Features
+
+- Global hotkey opens a compact overlay window from any app; press it again to copy and close
+- Streaming AI suggestions appear as faint ghost text while you type
+- Accept a suggestion with `Tab`, dismiss with `Esc`
+- Three AI providers: local LLM (llama.cpp, runs fully offline), MiniMax, and OpenRouter
+- **Hybrid mode**: races the local model against a cloud provider and upgrades to the cloud result if it arrives first, within a configurable time window
+- Model warm-up loads the local model in the background at startup so the first suggestion isn't slowed by a cold start
+- Accepted suggestions are stored with semantic embeddings and retrieved as personalized few-shot context, with per-example search/shown counts tracked over time
+- Manage stored examples (view, search, add, delete) from a dedicated GUI window
+- Reusable, ordered **context fragments** — curated notes you can prepend to the AI system prompt — managed from their own GUI window
+- Mid-word suppression skips AI requests while the cursor sits inside a word
+- API keys stored securely in the system keychain
+- SQLite storage with Alembic-managed schema migrations
+
+## Requirements
+
+- Python 3.12+
+- macOS 12+ (primary), Windows 10/11, Linux supported
+- API key for [MiniMax](https://www.minimaxi.com) or [OpenRouter](https://openrouter.ai) (not required for the default local LLM provider)
+- macOS: Accessibility permission required for global hotkey
+
+## Quick Start
+
+### 1. Install
+
+```bash
+git clone https://github.com/l0kifs/kei-typing-assistant.git
+cd kei-typing-assistant
+uv sync
+```
+
+### 2. Configure (optional)
+
+Create a `.env` file in the project root to override defaults:
+
+```env
+KEI__AI_PROVIDER=local_llm      # local_llm | minimax | openrouter
+KEI__HOTKEY=ctrl+alt+space      # global hotkey
+KEI__FLAVOUR="Concise, formal"  # personalization hint for AI
+```
+
+All settings with defaults are documented in [src/kei_typing_assistant/config/settings.py](src/kei_typing_assistant/config/settings.py).
+
+### 3. Add your API key (cloud providers only)
+
+If using MiniMax or OpenRouter, open Settings from the tray icon and enter your API key. Keys are stored in the system keychain — never in plaintext. The default local LLM provider needs no API key; the model is downloaded from Hugging Face on first run.
+
+### 4. Grant Accessibility permission (macOS)
+
+**System Settings → Privacy & Security → Accessibility** — add the app or your terminal to allow global hotkey capture.
+
+### 5. Run
+
+```bash
+uv run kei
+```
+
+The app runs in the system tray. Press the hotkey (`Ctrl+Alt+Space` by default) to open the overlay.
+
+## Usage
+
+| Action | Key |
+|--------|-----|
+| Open overlay | `Ctrl+Alt+Space` (configurable) |
+| Accept suggestion | `Tab` |
+| Copy text & close | `Ctrl+Alt+Space` again |
+| Dismiss without copying | `Esc` |
+
+## AI Providers
+
+| Provider | Setting value | Notes |
+|----------|---------------|-------|
+| Local LLM | `local_llm` (default) | Runs fully offline via llama.cpp; GGUF model auto-downloaded from Hugging Face; GPU-accelerated via Metal/CUDA where available |
+| MiniMax | `minimax` | Cloud API, accessed via an Anthropic-compatible endpoint |
+| OpenRouter | `openrouter` | Cloud API, accessed via an OpenAI-compatible endpoint; free-tier models available |
+| Hybrid | enable `hybrid_mode` | Races the local model against a chosen cloud provider (MiniMax or OpenRouter) and swaps in the cloud result if it beats the local one within `hybrid_upgrade_window_s` |
+
+## Settings Window
+
+| Tab | Contents |
+|-----|----------|
+| General | Writing-style ("flavour") hint injected into the AI system prompt |
+| AI Model | Provider selection (Local LLM / MiniMax / OpenRouter / Hybrid) and per-provider configuration (model, API key, context window, GPU layers, sampling params) |
+| Behaviour | Suggestion length, temperature, debounce delay, mid-word suppression, include-context-fragments toggle |
+| Appearance | Theme, ghost-text opacity, font family/size, overlay position |
+| Hotkeys | Global hotkey binding |
+| Storage | Data directory location (models, database) |
+
+Two standalone windows, opened from the tray/settings menu, manage personalization data directly:
+
+- **Context Fragments** — add, edit, reorder, search, and delete reusable prompt snippets prepended to the AI system prompt when enabled
+- **Suggestion Examples** — browse, search, add, and delete the accepted (input → suggestion) pairs used for semantic few-shot retrieval, including how often each has been searched/shown
+
+## Configuration Reference
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `KEI__HOTKEY` | `ctrl+alt+space` | Global trigger hotkey |
+| `KEI__AI_PROVIDER` | `local_llm` | `local_llm`, `minimax`, or `openrouter` |
+| `KEI__AI_MAX_TOKENS` | `60` | Max suggestion length |
+| `KEI__AI_TEMPERATURE` | `0.8` | Sampling temperature |
+| `KEI__AI_DEBOUNCE_MS` | `300` | Delay before AI request (ms) |
+| `KEI__MID_WORD_SUPPRESSION` | `false` | Skip requests while the cursor is mid-word |
+| `KEI__INCLUDE_CONTEXT_FRAGMENTS` | `false` | Prepend saved context fragments to the AI system prompt |
+| `KEI__FLAVOUR` | `` | Writing style hint for AI |
+| `KEI__THEME` | `system` | `system`, `dark`, or `light` |
+| `KEI__HYBRID_MODE` | `false` | Race local LLM against a cloud provider |
+| `KEI__HYBRID_UPGRADE_WINDOW_S` | `1.5` | Seconds to wait for the cloud provider before keeping the local result |
+| `KEI__LOCAL_LLM_MODEL_ID` | `Qwen/Qwen2.5-3B-Instruct-GGUF` | Hugging Face repo for the local model |
+| `KEI__LOCAL_LLM_N_GPU_LAYERS` | `-1` | GPU layers to offload (`-1` = all, `0` = CPU only) |
+| `KEI__SEMANTIC_EXAMPLES_TOP_K` | `5` | Max similar accepted examples injected as few-shot context |
+| `KEI__DATA_DIR` | `~/.kei_typing_assistant` | Base directory for models, database, and settings |
+
+Full list of settings, defaults, and validation ranges: [src/kei_typing_assistant/config/settings.py](src/kei_typing_assistant/config/settings.py).
+
+## Development
+
+```bash
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=src/kei_typing_assistant
+
+# Lint & format
+ruff check .
+ruff format .
+```
+
+## CLI Reference
+
+`kei-cli` provides a command-line interface for testing suggestions, managing the semantic example store, local models, database migrations, and configuration.
+
+```bash
+uv run kei-cli [--verbose] COMMAND [ARGS]
+```
+
+### Suggestion commands
+
+| Command | Description |
+|---------|-------------|
+| `suggest TEXT` | Stream an AI suggestion for the given text |
+| `accept TEXT SUGGESTION` | Save an accepted (input, suggestion) pair to the semantic example store |
+| `test [--text TEXT]` | Full E2E flow: suggest → save accepted example |
+
+**Typical workflow:**
+
+```bash
+# 1. Get a suggestion
+uv run kei-cli suggest "The weather today is"
+#   → warm and sunny with clear skies
+
+# 2. Accept it — embeds and saves for future retrieval
+uv run kei-cli accept "The weather today is" "warm and sunny with clear skies"
+#   ✓ Saved: 'The weather today is' → 'warm and sunny with clear skies'
+
+# 3. Next suggest call retrieves similar stored examples as context
+uv run kei-cli suggest "The weather this morning is"
+```
+
+`suggest` options: `--flavour TEXT`, `--max-tokens INT`
+`test` options: `--text TEXT`, `--flavour TEXT`, `--max-tokens INT`
+
+### Local model
+
+```bash
+uv run kei-cli model list             # List downloaded models
+uv run kei-cli model status MODEL_ID  # Check if a model is downloaded
+uv run kei-cli model delete MODEL_ID  # Delete a downloaded model from disk
+```
+
+### Database
+
+```bash
+uv run kei-cli db upgrade   # Migrate the database to the latest schema revision
+uv run kei-cli db current   # Show the currently applied schema revision
+```
+
+### Configuration
+
+```bash
+uv run kei-cli config show      # Show current configuration
+```
+
+## Architecture
+
+The project follows Domain-Driven Design. See [docs/ddd-architecture-rules.md](docs/ddd-architecture-rules.md) for conventions and [docs/BRD.md](docs/BRD.md) for the business requirements behind it.
+
+```
+src/kei_typing_assistant/
+├── main.py          # Composition root: wiring, bootstrap, launch
+├── config/          # Settings & logging
+├── domains/         # Pure business logic (suggestion, context_fragments, local_model)
+├── infrastructure/  # AI provider clients, SQLite database + Alembic migrations, keychain
+└── entry_points/    # Qt GUI, hotkey listener, tray, CLI, background workers
+```
+
+Database schema changes are managed with Alembic; migrations run automatically at startup (`kei-cli db upgrade` for manual control).
+
+## Publishing
+
+See [docs/PUBLISHING.md](docs/PUBLISHING.md). Releases are published to PyPI automatically via GitHub Actions on tag push. See [CHANGELOG.md](CHANGELOG.md) for release history.

kei_typing_assistant-0.1.0/README.md

@@ -0,0 +1,207 @@
+# Kei Typing Assistant
+
+An AI-powered desktop typing assistant that provides real-time text completions as ghost text via a floating overlay window, accessible from any application. Learns your writing style over time for increasingly personalized suggestions.
+
+## Features
+
+- Global hotkey opens a compact overlay window from any app; press it again to copy and close
+- Streaming AI suggestions appear as faint ghost text while you type
+- Accept a suggestion with `Tab`, dismiss with `Esc`
+- Three AI providers: local LLM (llama.cpp, runs fully offline), MiniMax, and OpenRouter
+- **Hybrid mode**: races the local model against a cloud provider and upgrades to the cloud result if it arrives first, within a configurable time window
+- Model warm-up loads the local model in the background at startup so the first suggestion isn't slowed by a cold start
+- Accepted suggestions are stored with semantic embeddings and retrieved as personalized few-shot context, with per-example search/shown counts tracked over time
+- Manage stored examples (view, search, add, delete) from a dedicated GUI window
+- Reusable, ordered **context fragments** — curated notes you can prepend to the AI system prompt — managed from their own GUI window
+- Mid-word suppression skips AI requests while the cursor sits inside a word
+- API keys stored securely in the system keychain
+- SQLite storage with Alembic-managed schema migrations
+
+## Requirements
+
+- Python 3.12+
+- macOS 12+ (primary), Windows 10/11, Linux supported
+- API key for [MiniMax](https://www.minimaxi.com) or [OpenRouter](https://openrouter.ai) (not required for the default local LLM provider)
+- macOS: Accessibility permission required for global hotkey
+
+## Quick Start
+
+### 1. Install
+
+```bash
+git clone https://github.com/l0kifs/kei-typing-assistant.git
+cd kei-typing-assistant
+uv sync
+```
+
+### 2. Configure (optional)
+
+Create a `.env` file in the project root to override defaults:
+
+```env
+KEI__AI_PROVIDER=local_llm      # local_llm | minimax | openrouter
+KEI__HOTKEY=ctrl+alt+space      # global hotkey
+KEI__FLAVOUR="Concise, formal"  # personalization hint for AI
+```
+
+All settings with defaults are documented in [src/kei_typing_assistant/config/settings.py](src/kei_typing_assistant/config/settings.py).
+
+### 3. Add your API key (cloud providers only)
+
+If using MiniMax or OpenRouter, open Settings from the tray icon and enter your API key. Keys are stored in the system keychain — never in plaintext. The default local LLM provider needs no API key; the model is downloaded from Hugging Face on first run.
+
+### 4. Grant Accessibility permission (macOS)
+
+**System Settings → Privacy & Security → Accessibility** — add the app or your terminal to allow global hotkey capture.
+
+### 5. Run
+
+```bash
+uv run kei
+```
+
+The app runs in the system tray. Press the hotkey (`Ctrl+Alt+Space` by default) to open the overlay.
+
+## Usage
+
+| Action | Key |
+|--------|-----|
+| Open overlay | `Ctrl+Alt+Space` (configurable) |
+| Accept suggestion | `Tab` |
+| Copy text & close | `Ctrl+Alt+Space` again |
+| Dismiss without copying | `Esc` |
+
+## AI Providers
+
+| Provider | Setting value | Notes |
+|----------|---------------|-------|
+| Local LLM | `local_llm` (default) | Runs fully offline via llama.cpp; GGUF model auto-downloaded from Hugging Face; GPU-accelerated via Metal/CUDA where available |
+| MiniMax | `minimax` | Cloud API, accessed via an Anthropic-compatible endpoint |
+| OpenRouter | `openrouter` | Cloud API, accessed via an OpenAI-compatible endpoint; free-tier models available |
+| Hybrid | enable `hybrid_mode` | Races the local model against a chosen cloud provider (MiniMax or OpenRouter) and swaps in the cloud result if it beats the local one within `hybrid_upgrade_window_s` |
+
+## Settings Window
+
+| Tab | Contents |
+|-----|----------|
+| General | Writing-style ("flavour") hint injected into the AI system prompt |
+| AI Model | Provider selection (Local LLM / MiniMax / OpenRouter / Hybrid) and per-provider configuration (model, API key, context window, GPU layers, sampling params) |
+| Behaviour | Suggestion length, temperature, debounce delay, mid-word suppression, include-context-fragments toggle |
+| Appearance | Theme, ghost-text opacity, font family/size, overlay position |
+| Hotkeys | Global hotkey binding |
+| Storage | Data directory location (models, database) |
+
+Two standalone windows, opened from the tray/settings menu, manage personalization data directly:
+
+- **Context Fragments** — add, edit, reorder, search, and delete reusable prompt snippets prepended to the AI system prompt when enabled
+- **Suggestion Examples** — browse, search, add, and delete the accepted (input → suggestion) pairs used for semantic few-shot retrieval, including how often each has been searched/shown
+
+## Configuration Reference
+
+| Setting | Default | Description |
+|---------|---------|-------------|
+| `KEI__HOTKEY` | `ctrl+alt+space` | Global trigger hotkey |
+| `KEI__AI_PROVIDER` | `local_llm` | `local_llm`, `minimax`, or `openrouter` |
+| `KEI__AI_MAX_TOKENS` | `60` | Max suggestion length |
+| `KEI__AI_TEMPERATURE` | `0.8` | Sampling temperature |
+| `KEI__AI_DEBOUNCE_MS` | `300` | Delay before AI request (ms) |
+| `KEI__MID_WORD_SUPPRESSION` | `false` | Skip requests while the cursor is mid-word |
+| `KEI__INCLUDE_CONTEXT_FRAGMENTS` | `false` | Prepend saved context fragments to the AI system prompt |
+| `KEI__FLAVOUR` | `` | Writing style hint for AI |
+| `KEI__THEME` | `system` | `system`, `dark`, or `light` |
+| `KEI__HYBRID_MODE` | `false` | Race local LLM against a cloud provider |
+| `KEI__HYBRID_UPGRADE_WINDOW_S` | `1.5` | Seconds to wait for the cloud provider before keeping the local result |
+| `KEI__LOCAL_LLM_MODEL_ID` | `Qwen/Qwen2.5-3B-Instruct-GGUF` | Hugging Face repo for the local model |
+| `KEI__LOCAL_LLM_N_GPU_LAYERS` | `-1` | GPU layers to offload (`-1` = all, `0` = CPU only) |
+| `KEI__SEMANTIC_EXAMPLES_TOP_K` | `5` | Max similar accepted examples injected as few-shot context |
+| `KEI__DATA_DIR` | `~/.kei_typing_assistant` | Base directory for models, database, and settings |
+
+Full list of settings, defaults, and validation ranges: [src/kei_typing_assistant/config/settings.py](src/kei_typing_assistant/config/settings.py).
+
+## Development
+
+```bash
+# Run tests
+pytest
+
+# Run tests with coverage
+pytest --cov=src/kei_typing_assistant
+
+# Lint & format
+ruff check .
+ruff format .
+```
+
+## CLI Reference
+
+`kei-cli` provides a command-line interface for testing suggestions, managing the semantic example store, local models, database migrations, and configuration.
+
+```bash
+uv run kei-cli [--verbose] COMMAND [ARGS]
+```
+
+### Suggestion commands
+
+| Command | Description |
+|---------|-------------|
+| `suggest TEXT` | Stream an AI suggestion for the given text |
+| `accept TEXT SUGGESTION` | Save an accepted (input, suggestion) pair to the semantic example store |
+| `test [--text TEXT]` | Full E2E flow: suggest → save accepted example |
+
+**Typical workflow:**
+
+```bash
+# 1. Get a suggestion
+uv run kei-cli suggest "The weather today is"
+#   → warm and sunny with clear skies
+
+# 2. Accept it — embeds and saves for future retrieval
+uv run kei-cli accept "The weather today is" "warm and sunny with clear skies"
+#   ✓ Saved: 'The weather today is' → 'warm and sunny with clear skies'
+
+# 3. Next suggest call retrieves similar stored examples as context
+uv run kei-cli suggest "The weather this morning is"
+```
+
+`suggest` options: `--flavour TEXT`, `--max-tokens INT`
+`test` options: `--text TEXT`, `--flavour TEXT`, `--max-tokens INT`
+
+### Local model
+
+```bash
+uv run kei-cli model list             # List downloaded models
+uv run kei-cli model status MODEL_ID  # Check if a model is downloaded
+uv run kei-cli model delete MODEL_ID  # Delete a downloaded model from disk
+```
+
+### Database
+
+```bash
+uv run kei-cli db upgrade   # Migrate the database to the latest schema revision
+uv run kei-cli db current   # Show the currently applied schema revision
+```
+
+### Configuration
+
+```bash
+uv run kei-cli config show      # Show current configuration
+```
+
+## Architecture
+
+The project follows Domain-Driven Design. See [docs/ddd-architecture-rules.md](docs/ddd-architecture-rules.md) for conventions and [docs/BRD.md](docs/BRD.md) for the business requirements behind it.
+
+```
+src/kei_typing_assistant/
+├── main.py          # Composition root: wiring, bootstrap, launch
+├── config/          # Settings & logging
+├── domains/         # Pure business logic (suggestion, context_fragments, local_model)
+├── infrastructure/  # AI provider clients, SQLite database + Alembic migrations, keychain
+└── entry_points/    # Qt GUI, hotkey listener, tray, CLI, background workers
+```
+
+Database schema changes are managed with Alembic; migrations run automatically at startup (`kei-cli db upgrade` for manual control).
+
+## Publishing
+
+See [docs/PUBLISHING.md](docs/PUBLISHING.md). Releases are published to PyPI automatically via GitHub Actions on tag push. See [CHANGELOG.md](CHANGELOG.md) for release history.

kei_typing_assistant-0.1.0/pyproject.toml

@@ -0,0 +1,124 @@
+[project]
+name = "kei-typing-assistant"
+version = "0.1.0"
+description = "AI-powered desktop typing assistant with real-time ghost-text completions, personalized via local embeddings and semantic example retrieval"
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+authors = [
+    { name = "Sergei Konovalov", email = "l0kifs91@gmail.com" },
+]
+keywords = ["typing-assistant", "ai", "llm", "autocomplete", "productivity", "ghost-text"]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Environment :: MacOS X",
+    "Environment :: Win32 (MS Windows)",
+    "Environment :: X11 Applications :: Qt",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: MacOS",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: POSIX :: Linux",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Text Editors :: Text Processing",
+]
+requires-python = ">=3.12"
+dependencies = [
+    # LLM dependencies
+    "anthropic>=0.112.0",
+    "openai>=2.44.0",
+    "llama-cpp-python>=0.3.0",
+    "huggingface_hub>=1.21.0",
+    "fastembed>=0.8.0",
+    # GUI dependencies
+    "PyQt6>=6.11.0",
+    "pynput>=1.8.2",
+    "qasync>=0.28.0",
+    # CLI dependencies
+    "typer>=0.9.0",
+    "rich>=13.0.0",
+    # Database dependencies
+    "sqlalchemy>=2.0.0",
+    "alembic>=1.18.5",
+    # Other dependencies
+    "pydantic-settings>=2.14.2",
+    "loguru>=0.7.3",
+    "pydantic>=2.13.4",
+    "keyring>=25.7.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/l0kifs/kei-typing-assistant"
+Repository = "https://github.com/l0kifs/kei-typing-assistant"
+Issues = "https://github.com/l0kifs/kei-typing-assistant/issues"
+Changelog = "https://github.com/l0kifs/kei-typing-assistant/releases"
+
+[project.scripts]
+kei = "kei_typing_assistant.main:main"
+kei-cli = "kei_typing_assistant.entry_points.cli.app:cli"
+
+[dependency-groups]
+dev = [
+    {include-group = "test"},
+    {include-group = "lint"},
+]
+test = [
+    "pytest>=9.0.3",
+    "pytest-asyncio>=0.25.0",
+    "pytest-xdist>=3.6.1",
+    "pytest-cov>=7.1.0",
+]
+lint = [
+    "ruff>=0.15.11",
+    "ty>=0.0.32",
+    "vulture>=2.14",
+]
+
+[tool.uv]
+package = true
+
+[build-system]
+requires = ["uv_build>=0.11.25,<0.12.0"]
+build-backend = "uv_build"
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+python_files = ["test_*.py"]
+python_classes = ["Test*"]
+python_functions = ["test_*"]
+norecursedirs = [".venv", "__pycache__", ".git"]
+asyncio_mode = "auto"
+addopts = [
+  "--tb=short",
+  "-ra",
+  "--import-mode=importlib",
+]
+markers = [
+  "unit: isolated tests with all external dependencies stubbed",
+  "integration: service-level tests with real collaborators and real files",
+  "e2e: end-to-end tests requiring a running Docker Compose stack",
+]
+
+[tool.ruff]
+line-length = 120
+target-version = "py312"
+
+[tool.ruff.lint]
+select = [
+    "E",   # pycodestyle errors
+    "F",   # pyflakes
+    "W",   # pycodestyle warnings
+    "I",   # import sorting
+    "B",   # flake8-bugbear
+    "UP",  # pyupgrade
+    "RUF", # Ruff-specific rules
+]
+
+[tool.vulture]
+min_confidence = 80
+exclude = [".venv/"]
+ignore_names = ["file_secret_settings"]
+
+[tool.ty]
+
+[tool.ty.src]
+exclude = [".venv/**"]

kei_typing_assistant-0.1.0/src/kei_typing_assistant/__init__.py

@@ -0,0 +1,3 @@
+"""
+Project package root.
+"""

kei_typing_assistant-0.1.0/src/kei_typing_assistant/config/__init__.py

@@ -0,0 +1,9 @@
+"""
+Project configuration package.
+
+Rules:
+- Contains application settings, constants, and logging configuration.
+- No technical implementation details (database engines, clients, etc.).
+- No business logic.
+- Should not import from domains, infrastructure or entry_points.
+"""

kei_typing_assistant-0.1.0/src/kei_typing_assistant/config/logging.py

@@ -0,0 +1,25 @@
+import sys
+
+from loguru import logger
+
+
+def configure_logging(debug: bool = False, quiet: bool = False) -> None:
+    """Configure application logging.
+
+    quiet=True suppresses all output — intended for CLI use where stdout/stderr
+    must stay clean for machine-readable or streaming output.
+    """
+    logger.remove()
+    if quiet:
+        return
+    level = "DEBUG" if debug else "INFO"
+    logger.add(
+        sys.stderr,
+        level=level,
+        format=(
+            "<green>{time:YYYY-MM-DD HH:mm:ss}</green> | "
+            "<level>{level: <8}</level> | "
+            "<cyan>{name}</cyan>:<cyan>{function}</cyan>:<cyan>{line}</cyan> - "
+            "<level>{message}</level>"
+        ),
+    )