shabbot 0.1.0__tar.gz

shabbot-0.1.0/.claude/analysis.md

@@ -0,0 +1,135 @@
+# shabbot — Технический анализ и рекомендации
+
+> Дата: 2026-06-05. Полное чтение исходников.
+
+---
+
+## Архитектура
+
+```
+Telegram Update
+    ↓
+bot.py (handlers)
+    ├── text → DumbParser → create_task() → Todoist
+    └── voice → download OGG → Whisper (subprocess) → DumbParser → create_task()
+```
+
+**Task dataclass** (`task.py`):
+```python
+@dataclass
+class Task:
+    summary: str
+    date: date
+    description: str | None
+    location: str | None
+    reminder_minutes: int | None
+    raw_text: str
+```
+
+**DumbParser** — заглушка: весь текст как summary, дата = сегодня. `BaseParser` абстрактный класс существует, но только один наследник.
+
+---
+
+## Проблемы
+
+### 1. Parser — это placeholder
+`DumbParser` не парсит вообще ничего. Фраза "встреча в среду в 3" → summary="встреча в среду в 3", date=сегодня. Google Calendar синхронизация бесполезна без дат.
+
+**Следующий шаг:** LLM-парсер. Архитектура (`BaseParser`) уже готова для подключения.
+
+Вариант реализации:
+```python
+class LLMParser(BaseParser):
+    def parse(self, text: str) -> Task:
+        # Claude API: structured output с date/summary/location
+        ...
+```
+
+### 2. Whisper — хрупкий subprocess
+```python
+result = subprocess.run([WHISPER_BIN, ogg_path, "--model", WHISPER_MODEL, ...])
+```
+- Нет обработки отсутствия бинарника
+- Нет обработки timeout кроме Telegram download
+- Модель `large` — тяжёлая, медленно работает без GPU
+
+**Варианты улучшения:**
+- Проверять наличие `WHISPER_BIN` при старте
+- Добавить timeout для subprocess
+- Рассмотреть OpenAI Whisper API вместо локального (проще в Docker)
+
+### 3. Нет обработки ошибок Todoist API
+`create_task()` не оборачивается в try/except. При сетевой ошибке бот молчит и не отвечает пользователю.
+
+### 4. Нет тестов
+Parser, todoist client, task dataclass — всё легко тестируемо, но тестов нет.
+
+---
+
+## Релиз + Docker (план)
+
+### 1. Зарелизить
+```bash
+# pyproject.toml уже готов
+# Добавить [tool.bumpversion]
+# Добавить GitHub Release
+```
+
+### 2. Dockerfile
+```dockerfile
+FROM python:3.11-slim
+
+# Whisper зависимости
+RUN apt-get install -y ffmpeg
+
+# Whisper
+RUN pip install openai-whisper
+
+# shabbot
+COPY . /app
+RUN pip install /app
+
+CMD ["shabbot"]
+```
+
+### 3. docker-compose.yml
+```yaml
+services:
+  shabbot:
+    build: .
+    env_file: shabbot.env
+    restart: unless-stopped
+```
+
+**Проблема с Whisper в Docker:** модель `large` = 3GB, нужен volume для кэша:
+```yaml
+    volumes:
+      - whisper-cache:/root/.cache/whisper
+```
+
+Альтернатива: использовать OpenAI Whisper API — нет локального бинарника, нет GPU, проще Docker-образ.
+
+---
+
+## LLM-парсер (идея)
+
+```python
+class LLMParser(BaseParser):
+    """Парсит естественный язык через Claude API с structured output."""
+    
+    def parse(self, text: str) -> Task:
+        # Prompt: "Извлеки задачу: дату, время, суть, место"
+        # Response: JSON с полями Task
+        # Fallback: date=today если дата не найдена
+```
+
+Это закроет главный gap — Google Calendar синхронизация станет полезной.
+
+---
+
+## Итог по приоритетам
+
+1. **Сейчас:** дорелизить (pyproject.toml, версия, CHANGELOG)
+2. **Потом:** Docker (Dockerfile + compose)
+3. **После:** LLM-парсер (значительно увеличит полезность)
+4. **Всегда:** error handling в Todoist client

shabbot-0.1.0/.github/workflows/integration.yml

@@ -0,0 +1,87 @@
+name: Integration
+
+on:
+  pull_request:
+    branches:
+      - master
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.11", "3.12", "3.13", "3.x"]
+      fail-fast: false
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v6
+        with:
+          python-version: ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: pip install -e ".[test]"
+
+      - name: Run tests
+        shell: bash
+        run: pytest || [ $? -eq 5 ]
+
+  integration:
+    needs: test
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          ref: ${{ github.head_ref }}
+          fetch-depth: 0
+
+      - name: Merge master
+        run: |
+          git config user.name "bot@djachenko[bot]"
+          git config user.email "2991967+bot@djachenko[bot]@users.noreply.github.com"
+          git merge origin/master --no-edit
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Install dependencies
+        run: pip install ".[release]"
+
+      - name: Bump version (no commit)
+        run: semantic-release version --no-commit --no-tag --no-push --no-changelog
+
+      - name: Patch dev suffix
+        run: |
+          python -c "
+          import tomllib, pathlib, os
+          with open('pyproject.toml', 'rb') as f:
+              v = tomllib.load(f)['project']['version']
+          p = pathlib.Path('pyproject.toml')
+          p.write_text(p.read_text().replace(f'version = \"{v}\"', f'version = \"{v}.dev{os.environ[\"GITHUB_RUN_NUMBER\"]}\"'))
+          "
+
+      - name: Build
+        run: python -m build
+
+      - name: Publish to TestPyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        with:
+          repository-url: https://test.pypi.org/legacy/
+
+      - name: Smoke test
+        run: |
+          VERSION=$(python -c "
+          import tomllib
+          with open('pyproject.toml', 'rb') as f:
+              print(tomllib.load(f)['project']['version'])
+          ")
+          pip install --index-url https://test.pypi.org/simple/ --no-deps shabbot==$VERSION
+          shabbot --help

shabbot-0.1.0/.github/workflows/release.yml

@@ -0,0 +1,74 @@
+name: Release
+
+on:
+  push:
+    branches:
+      - master
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    concurrency: release
+    permissions:
+      id-token: write
+      contents: write
+
+    steps:
+      - uses: actions/create-github-app-token@v1
+        id: app-token
+        with:
+          app-id: ${{ secrets.APP_ID }}
+          private-key: ${{ secrets.APP_PRIVATE_KEY }}
+
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          token: ${{ steps.app-token.outputs.token }}
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Install dependencies
+        run: pip install ".[release]"
+
+      - name: Configure git
+        run: |
+          git config user.name "bot@djachenko[bot]"
+          git config user.email "2991967+bot@djachenko[bot]@users.noreply.github.com"
+
+      - name: Run semantic release
+        id: release
+        env:
+          GH_TOKEN: ${{ steps.app-token.outputs.token }}
+        run: |
+          NEXT=$(semantic-release version --print 2>/dev/null || echo "")
+          if [ -n "$NEXT" ]; then
+            semantic-release version
+            echo "released=true" >> $GITHUB_OUTPUT
+            echo "version=$NEXT" >> $GITHUB_OUTPUT
+          else
+            echo "released=false" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Build
+        if: steps.release.outputs.released == 'true'
+        run: python -m build
+
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
+        if: steps.release.outputs.released == 'true'
+
+      - name: Smoke test (PyPI)
+        if: steps.release.outputs.released == 'true'
+        run: |
+          VERSION=${{ steps.release.outputs.version }}
+
+          for i in {1..5}; do
+            pip install shabbot==$VERSION && break
+            echo "Attempt $i failed, retrying in 10s..."
+            sleep 10
+          done
+
+          shabbot --help

shabbot-0.1.0/.github/workflows/tests.yml

@@ -0,0 +1,28 @@
+name: Tests
+
+on:
+  push:
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+
+      - name: Install dependencies
+        run: pip install -e ".[test]"
+
+      - name: Run tests
+        run: pytest || [ $? -eq 5 ]
+
+      - name: Lint
+        run: ruff check
+
+      - name: Type check
+        run: mypy shabbot/

shabbot-0.1.0/.gitignore

@@ -0,0 +1,20 @@
+# env
+shabbot.env
+*.env
+
+# python
+__pycache__/
+*.pyc
+*.pyo
+*.pyd
+.venv/
+*.egg-info/
+dist/
+build/
+
+# ide
+.idea/
+.vscode/
+
+# os
+.DS_Store

shabbot-0.1.0/CHANGELOG.md

@@ -0,0 +1,78 @@
+# CHANGELOG
+
+<!-- version list -->
+
+## v0.1.0 (2026-06-09)
+
+### Bug Fixes
+
+- Add shell: bash to pytest step for Windows compatibility
+  ([`500a8f0`](https://github.com/djachenko/shabbot/commit/500a8f070b8e0f6d72fea4c24d19d431f54c875c))
+
+- Add test extras and fix mypy path in CI
+  ([`738e924`](https://github.com/djachenko/shabbot/commit/738e9244d8bc0660c2941ce0db9c6e5e41e89793))
+
+- Configure git identity before merge in integration workflow
+  ([`013f6a0`](https://github.com/djachenko/shabbot/commit/013f6a0757b398b99f30a5557825bdeefb6e9c0c))
+
+- Disable major bump on 0.x in semantic release config
+  ([`66764a3`](https://github.com/djachenko/shabbot/commit/66764a37c1fa052185767cb1e2707ab80f630f75))
+
+- Handle --help in main via argparse for smoke test
+  ([`196e1ff`](https://github.com/djachenko/shabbot/commit/196e1ff6e707b1dc5df7ba26552c494fe4da839f))
+
+- Lower requires-python to 3.10, add release extras, add parser tests
+  ([`561b660`](https://github.com/djachenko/shabbot/commit/561b66084295a6f6f4bb591c8e0a7f53c4305f34))
+
+- Resolve mypy type errors in bot and todoist client
+  ([`52067da`](https://github.com/djachenko/shabbot/commit/52067dacf08ba8cc188063bdea1ab702648e035a))
+
+- Retry voice file download on TimedOut
+  ([`75e5344`](https://github.com/djachenko/shabbot/commit/75e5344a548d9f16f84f7b97bfc4a4dc476d3575))
+
+- Set whisper transcription language to ru
+  ([`4974d03`](https://github.com/djachenko/shabbot/commit/4974d03c049132cbbb4f4a2d2fc23d170aeef59a))
+
+- Simplify CI matrix, remove windows and python 3.10
+  ([`da9beaa`](https://github.com/djachenko/shabbot/commit/da9beaaea90ba64a38659f3ca5c58d27cde0c6ad))
+
+- Use bot identity for git merge in integration workflow
+  ([`ce516ae`](https://github.com/djachenko/shabbot/commit/ce516aef09ba01d3a9e1e99850dedda023c3bdd7))
+
+### Chores
+
+- Add session memory
+  ([`6b45358`](https://github.com/djachenko/shabbot/commit/6b45358dffc9e9870f5a3d2ddedcc2bdf0cec557))
+
+- Project config
+  ([`41f5b14`](https://github.com/djachenko/shabbot/commit/41f5b14dd1ce92be042f336d7a15cbfd9c6a93e1))
+
+- Repokit setup
+  ([`f9d2e10`](https://github.com/djachenko/shabbot/commit/f9d2e10a735b100cd7ef4df242f99bbd1deca1e9))
+
+- Reset version to 0.0.0 for PSR baseline
+  ([`8a3189c`](https://github.com/djachenko/shabbot/commit/8a3189c1036781233f6d69773258041a14381e5b))
+
+- Update project memory and claude context
+  ([`f20db20`](https://github.com/djachenko/shabbot/commit/f20db20d8e4dd0d8401668036d4e25a8196133d4))
+
+### Continuous Integration
+
+- Configure release pipeline with GitHub App auth
+  ([`a086762`](https://github.com/djachenko/shabbot/commit/a0867624dd4b23a5e04b06056dfb816ce30a9f07))
+
+- Switch release to direct PSR CLI, allow zero versions
+  ([`6149dd3`](https://github.com/djachenko/shabbot/commit/6149dd3fc03c5ada22a55705f5e6b246d3399a48))
+
+### Documentation
+
+- Add README
+  ([`725b885`](https://github.com/djachenko/shabbot/commit/725b885bf17e05fccfa9e67524df57e393f83094))
+
+- Add whisper install and model pre-download to README
+  ([`7285e11`](https://github.com/djachenko/shabbot/commit/7285e110f30957e122b1f4eb41fc77309326f559))
+
+
+## v1.0.0 (2026-06-09)
+
+- Initial Release

shabbot-0.1.0/CLAUDE.md

@@ -0,0 +1,59 @@
+# shabbot — Project Guide
+
+## Что это
+
+Telegram-бот для захвата задач с минимальным трением. Отправляешь текст или голос — задача появляется в Todoist, синхронизируется в Google Calendar.
+
+Личный инструмент продуктивности, не связан с фотопайплайном.
+
+---
+
+## Как работает
+
+- **Текст** → задача в Todoist с due date = сегодня
+- **Голос** → транскрипция через Whisper → задача в Todoist
+
+---
+
+## Стек
+
+- Python 3.11+, `python-telegram-bot`, `todoist-api-python`
+- Whisper (openai-whisper) — запускается как внешний процесс через subprocess
+- Переменные окружения через `shabbot.env` (не в репо)
+
+---
+
+## Запуск
+
+```bash
+source shabbot.env && shabbot
+```
+
+Переменные:
+- `SHABBOT_TOKEN` — Telegram bot token
+- `TODOIST_TOKEN` — Todoist API token
+- `WHISPER_MODEL` — модель (default: `large`)
+- `WHISPER_BIN` — путь к whisper (default: `~/.local/bin/whisper`)
+
+---
+
+## Текущее состояние
+
+- Базовая функциональность работает
+- 1 незакоммиченный файл (`bot.py`) — активная доработка
+- Ещё не зарелизен
+
+---
+
+## Что нужно сделать
+
+1. **Зарелизить**: оформить как нормальный релиз (версия, changelog)
+2. **Docker**: упаковать в контейнер чтобы запускать на сервере без зависимостей от локальной среды
+3. Возможно: LLM-парсер для естественного языка в дату (`parser/base.py` — уже есть заготовка `DumbParser`)
+
+---
+
+## Git
+
+Semantic commits: `feat:`, `fix:`, `refactor:`, `chore:`  
+Ветки: `feat/llm-parser`, `fix/whisper-timeout`, `refactor/todoist-client`

shabbot-0.1.0/PKG-INFO

@@ -0,0 +1,13 @@
+Metadata-Version: 2.4
+Name: shabbot
+Version: 0.1.0
+Requires-Python: >=3.10
+Requires-Dist: python-telegram-bot>=21.0
+Requires-Dist: todoist-api-python>=2.0
+Provides-Extra: release
+Requires-Dist: build; extra == 'release'
+Requires-Dist: python-semantic-release; extra == 'release'
+Provides-Extra: test
+Requires-Dist: mypy; extra == 'test'
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: ruff; extra == 'test'

shabbot-0.1.0/README.md

@@ -0,0 +1,47 @@
+# shabbot
+
+Telegram bot for capturing tasks with minimal friction. Send text or voice — task appears in Todoist, syncs to Google Calendar.
+
+## How it works
+
+- **Text message** → task in Todoist with due date = today
+- **Voice message** → transcribed via Whisper → task in Todoist
+
+## Requirements
+
+- Python 3.11+
+- [openai-whisper](https://github.com/openai/whisper) installed via pipx
+- Telegram bot token from [@BotFather](https://t.me/BotFather)
+- Todoist API token from [Settings → Integrations → Developer](https://todoist.com/app/settings/integrations/developer)
+
+## Setup
+
+```bash
+pipx install openai-whisper
+pipx install -e .
+```
+
+Pre-download the Whisper model (avoids a 1.5 GB download on first voice message):
+
+```bash
+python -c "import whisper; whisper.load_model('large-v3-turbo')"
+```
+
+Create a `shabbot.env` file:
+
+```bash
+export SHABBOT_TOKEN=your_telegram_bot_token
+export TODOIST_TOKEN=your_todoist_api_token
+export WHISPER_MODEL=large-v3-turbo  # optional, default: large
+export WHISPER_BIN=~/.local/bin/whisper  # optional
+```
+
+## Run
+
+```bash
+source shabbot.env && shabbot
+```
+
+## Google Calendar sync
+
+Tasks sync to Google Calendar via the native Todoist ↔ Google Calendar integration. To make all-day tasks (no time set) appear in the calendar, enable **Sync all-day tasks** in Todoist → Settings → Integrations → Google Calendar.

shabbot-0.1.0/memory/decisions.md

@@ -0,0 +1,25 @@
+# decisions — Архитектурные решения capturebot
+
+### Автозапуск: launchd, не Docker (пересмотрено 2026-06-09)
+Docker перебор для личного инструмента на одной машине. launchd — нативный macOS, pipx install достаточно для изоляции. Переносимость на сервер не актуальна — бот работает локально на MacBook. Docker остаётся в списке как опция если понадобится развернуть где-то ещё.
+
+### Whisper модель: large-v3-turbo
+`large` маппится на `large-v3`, которого не было локально — whisper начинал скачивать 2.88 GB в runtime. `large-v3-turbo` уже был скачан (~1.5 GB), качество сопоставимо, быстрее.
+
+### Polling, не webhook
+Нет сервера с постоянным аптаймом. Telegram хранит непрочитанные сообщения и отдаёт при следующем polling — ничего не теряется пока MacBook выключен.
+
+### Todoist, не Google Calendar напрямую
+Todoist ↔ Google Calendar уже синхронизированы. Через Todoist API — один токен. Через Google Calendar API — OAuth consent screen, credentials.json, token refresh.
+
+### DumbParser сейчас, BaseParser interface для будущего
+Текст as-is → summary, date = today. Когда появится Ollama — создаётся OllamaParser(BaseParser), в bot.py меняется одна строка.
+
+### PSR: версия читается из git тегов, не из pyproject.toml
+`version_toml` говорит PSR только **куда писать** результат. Текущую версию PSR читает из последнего git тега. Без тега поведение непредсказуемо (может выдать 1.0.0 вместо 0.1.0). Чтобы PSR знал откуда считать — нужен начальный тег `v0.0.0` на первом коммите. Порядок работы PSR: читает последний тег → считает bump по коммитам → пишет новую версию в pyproject.toml → коммит + тег → push → build → publish.
+
+### Будущее: dotfiles-репо + централизованная Claude memory
+Идея: `~/dotfiles/` с симлинками на `~/.claude/`, `.gitconfig`, `.zshrc` и т.д. Claude memory хранится в `~/dotfiles/claude/memory/<project>/`, в каждом проекте симлинк `memory → ~/dotfiles/claude/memory/<project>`. Не делать пока не закончены текущие приоритеты.
+
+### TimedOut при скачивании голоса: retry 3 раза
+Первый `TimedOut` = временный сбой сети, не ошибка пользователя. Retry 3 попытки с 2s паузой — после этого user-facing error. Не глотать молча (первый баг: сообщение просто пропадало без ответа).

shabbot-0.1.0/memory/feat-initial-setup.md

@@ -0,0 +1,16 @@
+# feat-initial-setup — Бот shabbot готов к использованию, незакоммиченные правки в bot.py
+
+<!-- Telegram-бот shabbot установлен через pipx, текстовые и голосовые сообщения создают задачи в Todoist. -->
+
+### 2026-06-09 — Переименование, retry на таймаут, язык whisper, git history
+
+Проект переименован capturebot → shabbot. В `bot.py` добавлены: retry при `TimedOut` во время загрузки голосового файла (3 попытки, 2s задержка, потом user-facing error), флаг `--language ru` для whisper (по умолчанию определял украинский), pathlib вместо строк для путей, восстановлен `~filters.COMMAND` фильтр. В `client.py` рефактор: `description or None` заменён на `parts: list[str]`. Создан git-репо с semantic commits, README, CLAUDE.md с конвенциями. **Остаток: `shabbot/bot.py` ещё не закоммичен** (retry + language + pathlib).
+
+### 2026-06-03 — Первый запуск capturebot, отладка, проверка голоса
+
+Создана вся структура проекта (capturebot/bot.py, parser/base.py, todoist/client.py, pyproject.toml) и установлена через `pipx install -e .`. Токены хранятся в `shabbot.env` с `export` — без этого дочерние процессы не видят переменные. Бот запускается командой `pkill -f capturebot; source shabbot.env && capturebot` (точка с запятой перед source обязательна — pkill возвращает 1 если процесс не найден, и `&&` обрывает цепь). Голосовые сообщения транскрибируются через whisper, модель `large-v3-turbo` (~1.5 GB, уже была скачана); `large` маппится на `large-v3` которого не было и он начинал скачиваться. Добавлен pulse-индикатор в Telegram пока whisper думает. Задачи без времени не появляются в Google Calendar по умолчанию — нужно включить "Sync all-day tasks" в Todoist → Settings → Integrations → Google Calendar.
+
+#### Что осталось
+- Автозапуск (решено делать через Docker, не launchd)
+- LLM-парсер для извлечения даты/локации из текста (Ollama, когда появится Mac Mini)
+- Метки/проекты Todoist — накопить задачи, потом разметить

shabbot-0.1.0/memory/feat-release-v1.md

@@ -0,0 +1,15 @@
+# feat-release-v1 — план финального выпуска: install.sh + launchd + пинед версии
+
+<!-- Эта строка читается всегда. Остальное — только когда тема релевантна. -->
+
+### 2026-06-09 — спланировали финальный выпуск shabbot v1.0.0
+
+Решили не делать Docker — слишком тяжело для личного инструмента на одном MacBook. Вместо него: launchd (нативный macOS) + `install.sh` который делает всё за один запуск. Шаги: создаёт `shabbot.env` с заглушками если его нет, ставит `openai-whisper` через pipx, ставит сам shabbot через pipx, скачивает модель (`python -c "import whisper; whisper.load_model(...)"`) чтобы не было сюрприза при первом голосовом, копирует `.plist` в `~/Library/LaunchAgents/` и регистрирует через `launchctl load`. Итого юзер делает три вещи: `./install.sh` → вписывает токены в `.env` → `launchctl start shabbot`. Ещё нужно запинить зависимости в `pyproject.toml` и поставить тег `v1.0.0`.
+
+Осталось сделать:
+- [ ] `install.sh` (создание env-заглушки, pipx, модель, launchd)
+- [ ] `shabbot.plist` для launchd
+- [ ] запинить версии в `pyproject.toml`
+- [ ] обновить README под новый флоу
+- [ ] прогон от начала до конца на чистом окружении
+- [ ] тег `v1.0.0` + GitHub-релиз

shabbot-0.1.0/memory/index.md

@@ -0,0 +1,5 @@
+# memory index
+
+- [feat-initial-setup](feat-initial-setup.md) — Бот shabbot готов: rename, retry на таймаут, --language ru, незакоммиченный bot.py
+- [feat-release-v1](feat-release-v1.md) — план финального выпуска: install.sh + launchd + пинед версии (2026-06-09)
+- [decisions](decisions.md) — Почему launchd (не Docker), large-v3-turbo, polling, Todoist вместо GCal, DumbParser

shabbot-0.1.0/pyproject.toml

@@ -0,0 +1,25 @@
+[project]
+name = "shabbot"
+version = "0.1.0"
+requires-python = ">=3.10"
+dependencies = [
+    "python-telegram-bot>=21.0",
+    "todoist-api-python>=2.0",
+]
+
+[project.optional-dependencies]
+test = ["pytest", "ruff", "mypy"]
+release = ["python-semantic-release", "build"]
+
+[project.scripts]
+shabbot = "shabbot.bot:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.semantic_release]
+version_toml = ["pyproject.toml:project.version"]
+branch = "master"
+major_on_zero = false
+allow_zero_version = true

shabbot-0.1.0/shabbot/bot.py

@@ -0,0 +1,128 @@
+import asyncio
+import logging
+import os
+import subprocess
+from pathlib import Path
+from tempfile import TemporaryDirectory
+
+from telegram import Update
+from telegram.error import TimedOut
+from telegram.ext import ApplicationBuilder, ContextTypes, MessageHandler, filters
+
+from shabbot.parser.base import DumbParser
+from shabbot.todoist.client import create_task
+
+logging.basicConfig(level=logging.INFO, format="%(asctime)s %(levelname)s %(message)s")
+log = logging.getLogger(__name__)
+
+WHISPER_BIN = Path(os.environ.get("WHISPER_BIN", "~/.local/bin/whisper")).expanduser()
+WHISPER_MODEL = os.environ.get("WHISPER_MODEL", "large")
+
+parser = DumbParser()
+
+
+async def transcribe_voice(update: Update, context: ContextTypes.DEFAULT_TYPE) -> str | None:
+    assert update.message is not None
+    voice = update.message.voice
+    assert voice is not None
+    file = await context.bot.get_file(voice.file_id)
+
+    with TemporaryDirectory() as tmp_dir:
+        tmp = Path(tmp_dir)
+
+        ogg_path = tmp / "voice.ogg"
+        for attempt in range(3):
+            try:
+                await file.download_to_drive(ogg_path)
+                break
+            except TimedOut:
+                if attempt == 2:
+                    raise
+                log.warning("download timed out, retrying (%d/3)", attempt + 1)
+                await asyncio.sleep(2)
+
+        result = subprocess.run(
+            [WHISPER_BIN, ogg_path, "--model", WHISPER_MODEL, "--language", "ru", "--output_format", "txt", "--output_dir", tmp],
+            capture_output=True,
+            text=True,
+        )
+
+        if result.returncode != 0:
+            log.error("whisper error: %s", result.stderr)
+
+            return None
+
+        txt_path = tmp / "voice.txt"
+
+        if not txt_path.exists():
+            return None
+
+        return txt_path.read_text().strip()
+
+
+async def handle_text(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+    assert update.message is not None
+    assert update.effective_user is not None
+    log.info("text from %s: %r", update.effective_user.username, update.message.text)
+    await _process(update, update.message.text or "")
+
+
+async def handle_voice(update: Update, context: ContextTypes.DEFAULT_TYPE) -> None:
+    assert update.message is not None
+    assert update.effective_user is not None
+    log.info("voice from %s", update.effective_user.username)
+    status = await update.message.reply_text("🎙 Транскрибирую")
+
+    async def pulse() -> None:
+        dots = 1
+
+        while True:
+            await asyncio.sleep(3)
+            await status.edit_text("🎙 Транскрибирую" + "." * dots)
+
+            dots = dots % 5 + 1
+
+    pulse_task = asyncio.create_task(pulse())
+
+    try:
+        text = await transcribe_voice(update, context)
+    except TimedOut:
+        pulse_task.cancel()
+        log.error("timed out downloading voice file")
+        await status.edit_text("❌ Таймаут при загрузке файла, попробуй ещё раз")
+        return
+    finally:
+        pulse_task.cancel()
+
+    if not text:
+        log.error("whisper returned empty result")
+        await status.edit_text("❌ Не удалось распознать голос")
+
+        return
+
+    log.info("transcribed: %r", text)
+    await status.edit_text(f"📝 Распознал: «{text}»")
+
+    await _process(update, text)
+
+
+async def _process(update: Update, text: str) -> None:
+    assert update.message is not None
+    task = parser.parse(text)
+
+    log.info("creating todoist task: %r", task.summary)
+    result = create_task(task)
+    log.info("created task id=%s", result.id)
+
+    await update.message.reply_text(f"✅ Добавил: «{task.summary}»\nhttps://todoist.com/app/task/{result.id}")
+
+
+def main() -> None:
+    import argparse
+
+    argparse.ArgumentParser(description="Telegram bot for capturing tasks to Todoist.").parse_known_args()
+
+    app = ApplicationBuilder().token(os.environ["SHABBOT_TOKEN"]).build()
+    app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, handle_text))
+    app.add_handler(MessageHandler(filters.VOICE, handle_voice))
+    app.run_polling()

shabbot-0.1.0/shabbot/parser/base.py

@@ -0,0 +1,20 @@
+from abc import ABC, abstractmethod
+from datetime import date
+
+from shabbot.task import Task
+
+
+class BaseParser(ABC):
+    @abstractmethod
+    def parse(self, text: str) -> Task: ...
+
+
+class DumbParser(BaseParser):
+    """Naive: весь текст → summary, date = today."""
+
+    def parse(self, text: str) -> Task:
+        return Task(
+            summary=text.strip(),
+            date=date.today(),
+            raw_text=text,
+        )

shabbot-0.1.0/shabbot/task.py

@@ -0,0 +1,12 @@
+from dataclasses import dataclass
+from datetime import date
+
+
+@dataclass
+class Task:
+    summary: str
+    date: date
+    description: str | None = None
+    location: str | None = None
+    reminder_minutes: int = 30
+    raw_text: str | None = None

shabbot-0.1.0/shabbot/todoist/client.py

@@ -0,0 +1,25 @@
+import os
+
+from todoist_api_python.api import TodoistAPI
+from todoist_api_python.models import Task as TodoistTask
+
+from shabbot.task import Task
+
+
+def create_task(task: Task) -> TodoistTask:
+    api = TodoistAPI(os.environ["TODOIST_TOKEN"])
+
+    parts: list[str] = []
+
+    if task.description:
+        parts.append(task.description)
+    if task.location:
+        parts.append(f"📍 {task.location}")
+    if task.raw_text and task.raw_text != task.summary:
+        parts.append(f"🎙 {task.raw_text}")
+
+    return api.add_task(
+        content=task.summary,
+        description="\n\n".join(parts) if parts else None,
+        due_string="today",
+    )

shabbot-0.1.0/tests/test_parser.py

@@ -0,0 +1,15 @@
+from datetime import date
+
+from shabbot.parser.base import DumbParser
+
+
+def test_dumb_parser_summary() -> None:
+    parser = DumbParser()
+    task = parser.parse("Buy milk")
+    assert task.summary == "Buy milk"
+
+
+def test_dumb_parser_date_today() -> None:
+    parser = DumbParser()
+    task = parser.parse("anything")
+    assert task.date == date.today()