commit feca79da75ac1379e65033776e239bf965f53785 Author: xiaowei Date: Sun May 24 16:58:31 2026 +0800 Initial commit: agent-second-brain (vault storage, session management) diff --git a/.claude/settings.local.example.json b/.claude/settings.local.example.json new file mode 100644 index 0000000..e93b21b --- /dev/null +++ b/.claude/settings.local.example.json @@ -0,0 +1,8 @@ +{ + "permissions": { + "allow": [ + "Bash(git push origin main)", + "Bash(mcp-cli :*)" + ] + } +} diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..7366f78 --- /dev/null +++ b/.env.example @@ -0,0 +1,14 @@ +# Telegram Bot API token from @BotFather +TELEGRAM_BOT_TOKEN= + +# Deepgram API key for voice transcription +DEEPGRAM_API_KEY= + +# Todoist API key for task management +TODOIST_API_KEY= + +# Path to Obsidian vault directory +VAULT_PATH=./vault + +# JSON array of Telegram user IDs allowed to use the bot (empty = allow all) +ALLOWED_USER_IDS=[123456789] diff --git a/.github/workflows/python-publish.yml b/.github/workflows/python-publish.yml new file mode 100644 index 0000000..82f8dbd --- /dev/null +++ b/.github/workflows/python-publish.yml @@ -0,0 +1,70 @@ +# This workflow will upload a Python Package to PyPI when a release is created +# For more information see: https://docs.github.com/en/actions/automating-builds-and-tests/building-and-testing-python#publishing-to-package-registries + +# This workflow uses actions that are not certified by GitHub. +# They are provided by a third-party and are governed by +# separate terms of service, privacy policy, and support +# documentation. + +name: Upload Python Package + +on: + release: + types: [published] + +permissions: + contents: read + +jobs: + release-build: + runs-on: ubuntu-latest + + steps: + - uses: actions/checkout@v4 + + - uses: actions/setup-python@v5 + with: + python-version: "3.x" + + - name: Build release distributions + run: | + # NOTE: put your own distribution build steps here. + python -m pip install build + python -m build + + - name: Upload distributions + uses: actions/upload-artifact@v4 + with: + name: release-dists + path: dist/ + + pypi-publish: + runs-on: ubuntu-latest + needs: + - release-build + permissions: + # IMPORTANT: this permission is mandatory for trusted publishing + id-token: write + + # Dedicated environments with protections for publishing are strongly recommended. + # For more information, see: https://docs.github.com/en/actions/deployment/targeting-different-environments/using-environments-for-deployment#deployment-protection-rules + environment: + name: pypi + # OPTIONAL: uncomment and update to include your PyPI project URL in the deployment status: + # url: https://pypi.org/p/YOURPROJECT + # + # ALTERNATIVE: if your GitHub Release name is the PyPI project version string + # ALTERNATIVE: exactly, uncomment the following line instead: + # url: https://pypi.org/project/YOURPROJECT/${{ github.event.release.name }} + + steps: + - name: Retrieve release distributions + uses: actions/download-artifact@v4 + with: + name: release-dists + path: dist/ + + - name: Publish release distributions to PyPI + uses: pypa/gh-action-pypi-publish@release/v1 + with: + packages-dir: dist/ diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..cfd5190 --- /dev/null +++ b/.gitignore @@ -0,0 +1,37 @@ +# Environment files (ВАЖНО: секреты!) +.env +.env.local +.env.*.local + +# Python +__pycache__/ +*.py[cod] +*$py.class +.venv/ +venv/ +.Python + +# Node +node_modules/ + +# IDE +.idea/ +.vscode/ +*.swp +*.swo +*~ + +# OS +.DS_Store +Thumbs.db + +# Vault personal data (never commit these) +vault/daily/ +vault/contacts/ +vault/finances/ +vault/attachments/ +vault/.session/ +vault/.graph/ +vault/business/ +vault/projects/ +vault/thoughts/ diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..3127e52 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Serge Shima + +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. diff --git a/README.md b/README.md new file mode 100644 index 0000000..9dfe022 --- /dev/null +++ b/README.md @@ -0,0 +1,223 @@ +# Agent Second Brain + +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) +[![Stars](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fsmixs%2Fagent-second-brain&query=%24.stargazers_count&label=stars&logo=github&color=blue)](https://github.com/smixs/agent-second-brain/stargazers) +[![Forks](https://img.shields.io/github/forks/smixs/agent-second-brain?style=flat&logo=github)](https://github.com/smixs/agent-second-brain/forks) + +

+ Agent Second Brain +

+ +**Send a voice note to Telegram. Get an organized knowledge base, completed tasks, and a daily report back.** That's it. That's the whole idea. + +[🇷🇺 Читать на русском](README.ru.md) + +--- + +## The problem + +Every productivity system dies the same way. You set it up on a Sunday, use it for two weeks, then slowly stop because the overhead of maintaining it is more work than the work itself. + +You have notes everywhere. Voice memos you never re-listen to. Ideas that disappear into chat history. Tasks you forget to write down. And even when you do capture something, it sits in a folder you'll never open again. + +The real issue: organizing takes more effort than thinking. So the thinking never gets organized. + +## What this actually does + +You talk to a Telegram bot. Voice, text, photos, forwarded messages - whatever is natural. You don't think about categories, tags, or where things go. + +The agent handles everything else: + +- **Transcribes** your voice notes (Deepgram, takes seconds) +- **Classifies** each entry - task, idea, client note, goal update, random thought +- **Creates tasks** in Todoist with the right priority and due date +- **Saves everything** to an Obsidian vault with proper links and tags +- **Sends you a daily report** at 9pm - what happened, what got done, what's still hanging +- **Remembers what matters, forgets what doesn't** - memory fades over time like a real brain + +The bot runs 24/7 on a $5 VPS. You don't maintain it. You just talk to it. + +## Talk to it like a person + +This isn't a button-pressing bot. You have a conversation. + +> **You:** what did I write about the marketing project last week? +> +> **Bot:** *finds and shows relevant entries* +> +> **You:** turn the second idea into a task for Monday +> +> **Bot:** *creates the task in Todoist* +> +> **You:** actually make it high priority and add a subtask for the presentation +> +> **Bot:** *updates the task* + +It has access to your entire vault, all your goals, and your Todoist. Ask it anything about your own notes, and it'll find the answer. + +## Memory that works like memory + +Most AI systems either remember everything forever (drowning you in noise) or forget everything between sessions. + +Agent Second Brain uses the Ebbinghaus forgetting curve - the same model that describes how human memory works. Every piece of information starts strong and gradually fades unless you access it again. + +Five tiers, from always-on to nearly forgotten: + +| Tier | What happens | +|------|-------------| +| **Core** | Always in context. Your current projects, active clients, key goals. | +| **Active** | Checked regularly. Recent ideas, ongoing conversations. | +| **Warm** | Found when you search. Last month's notes, past decisions. | +| **Cold** | Only surfaces in deep searches. Old projects, archived plans. | +| **Archive** | Almost gone - but sometimes randomly recalled for creative connections. | + +The archive tier is the interesting one. Occasionally, the agent pulls a random old memory and connects it to something current. Sometimes it's noise. Sometimes it's the best idea you forgot you had. + +## Vault health - your notes maintain themselves + +Over time, note systems rot. Links break. Files become orphans. Tags diverge. You end up with a graveyard of markdown files that nobody, including you, can navigate. + +The vault-health system runs automatically: + +- Scores your vault on a 100-point scale +- Finds orphan notes (no links in or out) and suggests connections +- Repairs broken wiki-links +- Generates Maps of Content (MOCs) for each domain +- Flags files missing descriptions + +You don't run maintenance. The agent does. + +## What you send, what happens + +| You send | Agent does | +|----------|-----------| +| Voice note about a client call | Transcribes, creates CRM card, adds follow-up task | +| Quick text: "idea for the Q2 campaign" | Saves to ideas folder, links to related notes | +| Forwarded article from a chat | Saves with source, extracts key points | +| Photo of a whiteboard | Saves with AI-generated description | +| "Process" button | Runs the full pipeline right now | +| "What are my priorities this week?" | Reads your goals and Todoist, gives you a straight answer | + +## How it works (for the curious) + +The daily processing runs in three phases: + +1. **Capture** - reads today's entries, classifies each one (task? idea? CRM update? goal progress?) +2. **Execute** - creates Todoist tasks, writes vault files, updates cards +3. **Reflect** - generates a summary report, updates long-term memory, sends it to Telegram + +Each phase produces a clean JSON that the next phase picks up. If something breaks, you can see exactly where and why. + +``` +Telegram → Deepgram → Claude Code → Todoist + Obsidian vault → Telegram report +``` + +## What it costs + +| Service | Cost | +|---------|------| +| Claude Pro | $20/mo | +| VPS (any cheap one works) | ~$5/mo | +| Deepgram | Free tier ($200 credit) | +| Todoist | Free plan works | +| **Total** | **~$25/mo** | + +$25/month for a personal assistant that organizes your life, never sleeps, and gets better the more you use it. + +## Quick start + +### 1. Fork this repo + +Click **Fork** at the top of this page. Make it **private** - it will contain your personal data. + +### 2. Clone it + +```bash +git clone https://github.com/YOUR_USERNAME/agent-second-brain.git +cd agent-second-brain +``` + +### 3. Fill in your info + +Open these files and replace the placeholders: + +- `vault/goals/` - your vision, yearly goals, monthly priorities, weekly focus +- `vault/.claude/skills/dbrain-processor/references/about.md` - tell the agent about yourself +- `vault/.claude/skills/dbrain-processor/references/classification.md` - how you want entries sorted + +### 4. Get four API keys + +| What | Where | Time | +|------|-------|------| +| Telegram Bot Token | [@BotFather](https://t.me/BotFather) | 2 min | +| Your Telegram ID | [@userinfobot](https://t.me/userinfobot) | 30 sec | +| Deepgram API Key | [console.deepgram.com](https://console.deepgram.com/) | 3 min | +| Todoist API Token | Todoist → Settings → Integrations → Developer | 1 min | + +### 5. Deploy + +Follow the [VPS setup guide](docs/vps-setup.md), or run: + +```bash +ssh root@YOUR_SERVER_IP +curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/agent-second-brain/main/bootstrap.sh | bash +``` + +That's it. The bot starts, you send it a message, and the system is alive. + +--- + +## Vault structure + +``` +vault/ +├── daily/ # Your daily entries (voice, text, photos) +├── goals/ # Vision → yearly → monthly → weekly +├── business/ +│ ├── crm/ # Client cards +│ └── network/ # Professional contacts +├── projects/ # Client work, leads, pipeline +├── thoughts/ +│ ├── ideas/ # Ideas and brainstorms +│ ├── learnings/ # Lessons learned +│ └── reflections/ # Personal reflections +├── MOC/ # Maps of Content (auto-generated) +└── MEMORY.md # Agent's long-term memory +``` + +## Skills + +The agent has five built-in skills: + +| Skill | What it does | +|-------|-------------| +| **dbrain-processor** | Classifies entries, creates tasks, saves notes | +| **agent-memory** | Ebbinghaus decay engine - remembers, forgets, recalls | +| **vault-health** | Scores vault health, fixes links, generates MOCs | +| **graph-builder** | Maps relationships between notes, finds clusters | +| **todoist-ai** | Manages tasks, projects, priorities | + +Want just the memory engine? See [agent-memory-skill](https://github.com/smixs/agent-memory-skill) - works standalone, no dependencies. + +## Configuration + +| File | What it controls | +|------|-----------------| +| `.env` | API tokens (copy from `.env.example`) | +| `.memory-config.json` | How fast memories decay, tier boundaries | +| `mcp-config.json` | External tool connections | +| `vault/.claude/CLAUDE.md` | Agent personality and rules | + +All secrets stay in `.env`, which is gitignored. Don't commit tokens. + +--- + +## Built by + +[Serge Shima](https://shima.me) - 20 years in marketing (BBDO, Publicis), now running an AI creative agency in Central Asia and teaching businesses how to work with AI at [aimasters.me](https://aimasters.me). + +This system runs my actual life. 1,100+ vault cards, 5 AI agents, daily reports. It started as a weekend project and became infrastructure. + +## License + +[MIT](LICENSE) - do whatever you want with it. diff --git a/README.ru.md b/README.ru.md new file mode 100644 index 0000000..b41d2a3 --- /dev/null +++ b/README.ru.md @@ -0,0 +1,221 @@ +# Agent Second Brain + +[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE) +[![Stars](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2Fsmixs%2Fagent-second-brain&query=%24.stargazers_count&label=stars&logo=github&color=blue)](https://github.com/smixs/agent-second-brain/stargazers) +[![Forks](https://img.shields.io/github/forks/smixs/agent-second-brain?style=flat&logo=github)](https://github.com/smixs/agent-second-brain/forks) + +

+ Agent Second Brain +

+ +**Отправь голосовое в Telegram - получи организованную базу знаний, выполненные задачи и дневной отчёт.** Всё. Вся идея в одном предложении. + +[🇬🇧 Read in English](README.md) + +--- + +## Проблема + +Любая система продуктивности умирает одинаково. Настраиваешь в воскресенье, пользуешься две недели, потом бросаешь - потому что поддержка системы отнимает больше сил, чем сама работа. + +Заметки раскиданы везде. Голосовые, которые никогда не переслушаешь. Идеи, утонувшие в истории чатов. Задачи, которые забыл записать. А если записал - они лежат в папке, которую ты больше не откроешь. + +Корень проблемы: организовывать сложнее, чем думать. Поэтому мысли остаются неорганизованными. + +## Что делает эта штука + +Ты пишешь боту в Telegram. Голосовые, текст, фото, пересланные сообщения - как удобно. Не думаешь про категории, теги или куда что положить. + +Агент разбирается сам: + +- **Расшифровывает** голосовые (Deepgram, пара секунд) +- **Классифицирует** каждую запись - задача, идея, заметка о клиенте, прогресс по цели, случайная мысль +- **Создаёт задачи** в Todoist с нужным приоритетом и датой +- **Сохраняет всё** в Obsidian-хранилище с правильными ссылками и тегами +- **Присылает дневной отчёт** в 21:00 - что произошло, что сделано, что висит +- **Помнит важное, забывает ненужное** - память угасает со временем, как у живого человека + +Бот работает 24/7 на сервере за $5. Ты его не обслуживаешь. Ты просто с ним разговариваешь. + +## Разговаривай как с человеком + +Это не бот с кнопками. Это разговор. + +> **Ты:** что я писал про маркетинговый проект на прошлой неделе? +> +> **Бот:** *находит и показывает записи* +> +> **Ты:** вторую идею превращай в задачу на понедельник +> +> **Бот:** *создаёт задачу в Todoist* +> +> **Ты:** сделай высокий приоритет и добавь подзадачу на презентацию +> +> **Бот:** *обновляет задачу* + +У агента доступ ко всему хранилищу, всем целям и Todoist. Спроси что угодно про свои записи - найдёт. + +## Память, которая работает как память + +Большинство AI-систем либо помнят всё навсегда (утопая в шуме), либо забывают всё между сессиями. + +Agent Second Brain использует кривую забывания Эббингауза - ту же модель, что описывает работу человеческой памяти. Каждая запись начинает с максимальной «яркости» и постепенно тускнеет, если к ней не возвращаются. + +Пять уровней - от «всегда под рукой» до «почти забыто»: + +| Уровень | Что происходит | +|---------|---------------| +| **Ядро** | Всегда в контексте. Текущие проекты, активные клиенты, ключевые цели. | +| **Активные** | Проверяются регулярно. Свежие идеи, текущие разговоры. | +| **Тёплые** | Находятся при поиске. Заметки за прошлый месяц, принятые решения. | +| **Холодные** | Всплывают только при глубоком поиске. Старые проекты, архивные планы. | +| **Архив** | Почти забытые - но иногда случайно вспоминаются для неожиданных связей. | + +Архив - самое интересное. Иногда агент достаёт случайную старую запись и связывает с чем-то текущим. Бывает - мимо. А бывает - это лучшая идея, которую ты забыл. + +## Здоровье хранилища - заметки сами себя чинят + +Со временем любая система заметок гниёт. Ссылки ломаются. Файлы становятся сиротами. Теги расползаются. В итоге - кладбище маркдаун-файлов, по которому не может пройти никто. + +Система здоровья работает автоматически: + +- Оценивает хранилище по 100-балльной шкале +- Находит сироты (файлы без связей) и предлагает ссылки +- Чинит сломанные вики-линки +- Генерирует карты содержимого (MOC) для каждой области +- Отмечает файлы без описаний + +Ты не занимаешься обслуживанием. Агент занимается. + +## Что отправляешь - что получаешь + +| Ты отправляешь | Агент делает | +|----------------|-------------| +| Голосовое о звонке с клиентом | Расшифровывает, создаёт CRM-карточку, добавляет follow-up задачу | +| Текст: «идея для Q2 кампании» | Сохраняет в папку идей, связывает с похожими заметками | +| Пересланная статья из чата | Сохраняет с источником, вытаскивает ключевые мысли | +| Фото доски | Сохраняет с AI-описанием | +| Кнопка «Process» | Запускает полный цикл обработки прямо сейчас | +| «Какие приоритеты на эту неделю?» | Читает цели и Todoist, даёт прямой ответ | + +## Как это работает (для любопытных) + +Ежедневная обработка идёт в три фазы: + +1. **Захват** - читает записи за день, классифицирует каждую (задача? идея? обновление CRM? прогресс по цели?) +2. **Исполнение** - создаёт задачи в Todoist, пишет файлы в хранилище, обновляет карточки +3. **Рефлексия** - генерирует сводный отчёт, обновляет долговременную память, отправляет в Telegram + +Каждая фаза создаёт чистый JSON, который подхватывает следующая. Если что-то ломается - видно где именно и почему. + +``` +Telegram → Deepgram → Claude Code → Todoist + Obsidian → Telegram отчёт +``` + +## Сколько стоит + +| Сервис | Цена | +|--------|------| +| Claude Pro | $20/мес | +| VPS (любой дешёвый) | ~$5/мес | +| Deepgram | Бесплатно ($200 кредит) | +| Todoist | Бесплатный план работает | +| **Итого** | **~$25/мес** | + +$25 в месяц за личного ассистента, который организует твою жизнь, никогда не спит и становится лучше с каждым днём использования. + +## Быстрый старт + +### 1. Форкни репо + +Нажми **Fork** вверху страницы. Сделай форк **приватным** - в нём будут твои личные данные. + +### 2. Склонируй + +```bash +git clone https://github.com/YOUR_USERNAME/agent-second-brain.git +cd agent-second-brain +``` + +### 3. Заполни свою информацию + +Открой эти файлы и замени шаблоны на свои данные: + +- `vault/goals/` - видение, годовые цели, месячные приоритеты, фокус недели +- `vault/.claude/skills/dbrain-processor/references/about.md` - расскажи агенту о себе +- `vault/.claude/skills/dbrain-processor/references/classification.md` - как сортировать записи + +### 4. Получи четыре API-ключа + +| Что | Где взять | Время | +|-----|----------|-------| +| Telegram Bot Token | [@BotFather](https://t.me/BotFather) | 2 мин | +| Твой Telegram ID | [@userinfobot](https://t.me/userinfobot) | 30 сек | +| Deepgram API Key | [console.deepgram.com](https://console.deepgram.com/) | 3 мин | +| Todoist API Token | Todoist → Settings → Integrations → Developer | 1 мин | + +### 5. Разверни + +Следуй [инструкции по настройке VPS](docs/vps-setup.md), или: + +```bash +ssh root@YOUR_SERVER_IP +curl -fsSL https://raw.githubusercontent.com/YOUR_USERNAME/agent-second-brain/main/bootstrap.sh | bash +``` + +Бот запускается, ты отправляешь ему сообщение - система живёт. + +--- + +## Структура хранилища + +``` +vault/ +├── daily/ # Дневные записи (голосовые, текст, фото) +├── goals/ # Видение → год → месяц → неделя +├── business/ +│ ├── crm/ # Карточки клиентов +│ └── network/ # Профессиональные контакты +├── projects/ # Клиентские проекты, лиды, пайплайн +├── thoughts/ +│ ├── ideas/ # Идеи и мозговые штурмы +│ ├── learnings/ # Уроки +│ └── reflections/ # Рефлексии +├── MOC/ # Карты содержимого (генерируются автоматически) +└── MEMORY.md # Долговременная память агента +``` + +## Навыки агента + +| Навык | Что делает | +|-------|-----------| +| **dbrain-processor** | Классифицирует записи, создаёт задачи, сохраняет заметки | +| **agent-memory** | Движок памяти Эббингауза - помнит, забывает, вспоминает | +| **vault-health** | Оценка здоровья, починка ссылок, генерация MOC | +| **graph-builder** | Карта связей между заметками, поиск кластеров | +| **todoist-ai** | Управление задачами, проектами, приоритетами | + +Нужен только движок памяти? Смотри [agent-memory-skill](https://github.com/smixs/agent-memory-skill) - работает отдельно, без зависимостей. + +## Конфигурация + +| Файл | За что отвечает | +|------|----------------| +| `.env` | API-токены (скопируй из `.env.example`) | +| `.memory-config.json` | Скорость угасания памяти, границы уровней | +| `mcp-config.json` | Подключения к внешним инструментам | +| `vault/.claude/CLAUDE.md` | Личность и правила агента | + +Все секреты в `.env`, который в gitignore. Не коммить токены. + +--- + +## Кто сделал + +[Сергей Шима](https://shima.me) - 20 лет в маркетинге (BBDO, Publicis), сейчас руководит AI-креативным агентством в Центральной Азии и учит бизнес работать с AI на [aimasters.me](https://aimasters.me). + +Эта система работает в моей реальной жизни. 1,100+ карточек в хранилище, 5 AI-агентов, ежедневные отчёты. Начиналось как проект на выходных - стало инфраструктурой. + +## Лицензия + +[MIT](LICENSE) - делай с этим что хочешь. diff --git a/bootstrap.sh b/bootstrap.sh new file mode 100755 index 0000000..12a4de3 --- /dev/null +++ b/bootstrap.sh @@ -0,0 +1,62 @@ +#!/bin/bash + +# ============================================================================= +# Agent Second Brain - Bootstrap Script +# ============================================================================= +# Downloads setup.sh and runs it properly (not via pipe) +# +# Usage: +# curl -fsSL https://raw.githubusercontent.com/smixs/agent-second-brain/main/bootstrap.sh | bash +# ============================================================================= + +set -e + +RED='\033[0;31m' +GREEN='\033[0;32m' +CYAN='\033[0;36m' +NC='\033[0m' + +echo "" +echo -e "${CYAN}Agent Second Brain - Bootstrap${NC}" +echo "" + +# Check if running as root +if [ "$EUID" -eq 0 ]; then + echo -e "${RED}[X] Do not run as root!${NC}" + echo " Create a user first: adduser myuser && usermod -aG sudo myuser" + echo " Then: su - myuser" + exit 1 +fi + +# Always download from original repo +SETUP_URL="https://raw.githubusercontent.com/smixs/agent-second-brain/main/setup.sh" + +echo "Downloading setup script..." + +# Create temp file +TEMP_SCRIPT=$(mktemp /tmp/setup-XXXXXX.sh) + +# Download setup script +if command -v curl &> /dev/null; then + curl -fsSL "$SETUP_URL" -o "$TEMP_SCRIPT" +elif command -v wget &> /dev/null; then + wget -q "$SETUP_URL" -O "$TEMP_SCRIPT" +else + echo -e "${RED}[X] Neither curl nor wget found${NC}" + echo " Install: sudo apt install curl" + exit 1 +fi + +if [ ! -s "$TEMP_SCRIPT" ]; then + echo -e "${RED}[X] Failed to download setup script${NC}" + rm -f "$TEMP_SCRIPT" + exit 1 +fi + +echo -e "${GREEN}[OK] Downloaded${NC}" +echo "" + +# Make executable and run PROPERLY (not via pipe!) +# exec replaces current process, so stdin works normally +chmod +x "$TEMP_SCRIPT" +exec bash "$TEMP_SCRIPT" diff --git a/deploy/d-brain-bot.service b/deploy/d-brain-bot.service new file mode 100644 index 0000000..81d8c3d --- /dev/null +++ b/deploy/d-brain-bot.service @@ -0,0 +1,15 @@ +[Unit] +Description=d-brain Telegram Bot +After=network.target + +[Service] +Type=simple +User=shima +WorkingDirectory=/home/shima/projects/dbrain +ExecStart=/home/shima/.local/bin/uv run python -m d_brain +Restart=always +RestartSec=10 +Environment=PYTHONUNBUFFERED=1 + +[Install] +WantedBy=multi-user.target diff --git a/deploy/d-brain-process.service b/deploy/d-brain-process.service new file mode 100644 index 0000000..6840b33 --- /dev/null +++ b/deploy/d-brain-process.service @@ -0,0 +1,9 @@ +[Unit] +Description=d-brain Daily Processing + +[Service] +Type=oneshot +User=shima +WorkingDirectory=/home/shima/projects/agent-second-brain +ExecStart=/home/shima/projects/agent-second-brain/scripts/process.sh +Environment=PYTHONUNBUFFERED=1 diff --git a/deploy/d-brain-process.timer b/deploy/d-brain-process.timer new file mode 100644 index 0000000..8802982 --- /dev/null +++ b/deploy/d-brain-process.timer @@ -0,0 +1,9 @@ +[Unit] +Description=Run d-brain processing daily at 21:00 + +[Timer] +OnCalendar=*-*-* 21:00:00 +Persistent=true + +[Install] +WantedBy=timers.target diff --git a/deploy/d-brain-weekly.service b/deploy/d-brain-weekly.service new file mode 100644 index 0000000..d0baf90 --- /dev/null +++ b/deploy/d-brain-weekly.service @@ -0,0 +1,12 @@ +[Unit] +Description=d-brain Weekly Digest +After=network.target + +[Service] +Type=oneshot +User=shima +WorkingDirectory=/home/shima/projects/agent-second-brain +ExecStart=/home/shima/.local/bin/uv run python scripts/weekly.py +EnvironmentFile=/home/shima/projects/agent-second-brain/.env +StandardOutput=journal +StandardError=journal diff --git a/deploy/d-brain-weekly.timer b/deploy/d-brain-weekly.timer new file mode 100644 index 0000000..8b2c30f --- /dev/null +++ b/deploy/d-brain-weekly.timer @@ -0,0 +1,9 @@ +[Unit] +Description=Run d-brain weekly digest Friday morning + +[Timer] +OnCalendar=Fri 06:00 +Persistent=true + +[Install] +WantedBy=timers.target diff --git a/docs/full-setup-guide-v1.md b/docs/full-setup-guide-v1.md new file mode 100644 index 0000000..48fe259 --- /dev/null +++ b/docs/full-setup-guide-v1.md @@ -0,0 +1,1120 @@ +# Agent Second Brain + +

+ telegram-cloud-photo-size-2-5332708313742904084-y +

+ +**Персональный AI-ассистент с долговременной памятью** + +Записывайте голосовые в Telegram — агент сам разберётся что с ними делать: создаст задачи, сохранит мысли, обновит прогресс по целям. + +

+ Telegram_27_December_2025_ALVR9dWM +

+ +--- + +## Главное перед началом + +| Параметр | Значение | +|----------|----------| +| **Время на настройку** | **2–3 часа тишины.** Не торопитесь — лучше один раз сделать правильно. | +| **Стоимость** | ~$25/мес (Claude Pro $20 + VPS $5) | +| **Приватность** | **Это ваш личный сервер. Никто, кроме вас, не имеет доступа к вашим мыслям и задачам.** | + +--- + +## Оглавление + +- [Зачем это нужно](#зачем-это-нужно) +- [Как это работает](#как-это-работает) +- [Словарь терминов](#словарь-терминов) +- [Что понадобится](#что-понадобится) +- **Часть 1: Подготовка на компьютере** ⏱ 30–50 мин + - [1.1 Установите Git и VS Code](#11-установите-git-и-vs-code) + - [1.2 Создайте аккаунт на GitHub](#12-создайте-аккаунт-на-github) + - [1.3 Сделайте Fork проекта](#13-сделайте-fork-проекта) + - [1.4 Клонируйте Fork на компьютер](#14-клонируйте-fork-на-компьютер) + - [1.5 Заполните ваши цели](#15-заполните-ваши-цели) + - [1.6 Настройте профиль](#16-настройте-профиль) + - [1.7 Настройте систему под себя](#17-настройте-систему-под-себя) + - [1.8 Сохраните изменения в GitHub](#18-сохраните-изменения-в-github) +- **Часть 2: Получите ключи** ⏱ 15 мин + - [2.1 Telegram Bot Token](#21-telegram-bot-token) + - [2.2 Ваш Telegram ID](#22-ваш-telegram-id) + - [2.3 Deepgram API Key](#23-deepgram-api-key) + - [2.4 Todoist API Token](#24-todoist-api-token) +- **Часть 3: Настройка сервера** ⏱ 40–70 мин + - [3.1 Купите VPS и подключитесь](#31-купите-vps-и-подключитесь) + - [3.2 Создайте пользователя](#32-создайте-пользователя) + - [3.3 Установите всё необходимое](#33-установите-всё-необходимое) + - [Запуск бота](#запуск-бота) +- [Часть 4: Использование](#часть-4-использование) +- [Часть 5: Синхронизация](#часть-5-синхронизация) +- [Помощь](#помощь) + +--- + +## Зачем это нужно + +Это система управления задачами и мыслями «на стероидах». Один раз настроите — и у вас всегда под рукой понимание, что происходит в жизни. + +**Кидайте туда вообще всё:** +- Интересные посты из Telegram — пересылайте боту +- Скриншоты — отправляйте +- После встречи — надиктуйте голосом что было и какие решения +- Эмоции, мысли, идеи — всё записывайте +- Ссылки, цитаты, заметки — абсолютно всё + +### Самая крутая кнопка — «Запрос» + +Это **полноценный AI-агент**, которому можно сказать что угодно — и он сам разберётся что делать. + +**Примеры того, что можно попросить:** + +| Запрос | Что сделает агент | +|--------|-------------------| +| «Найди ту идею про маркетинг, которую я записывал на прошлой неделе» | Найдёт в ваших заметках и покажет | +| «Что я делал вчера?» | Даст отчёт по вчерашним записям и задачам | +| «Перенеси все просроченные задачи на понедельник» | Найдёт в Todoist и перенесёт | +| «Поставь повторяющуюся задачу: каждый день в 9 утра — зарядка» | Создаст в Todoist | +| «Обнови мои недельные цели» | Откроет файл целей и поможет обновить | +| «Какие задачи на этой неделе не сделаны?» | Покажет список из Todoist | +| «Посоветуй, на чём сфокусироваться сегодня» | Проанализирует цели и задачи, даст совет | + +Вы общаетесь с ним как с настоящим ассистентом. Он сам найдёт нужные файлы, обновит структуру, создаст задачи — всё автоматически. + +--- + +Чем больше вы делитесь информацией и чем лучше заполните цели и карточку о себе — тем лучше агент понимает ваш контекст и тем точнее расставляет приоритеты. + +**Про Claude Code — не бойтесь названия.** Да, он называется «Code», но это универсальный AI-агент, который отлично помогает в жизни. У него чёткие инструкции как действовать с вашими записями — создавать задачи, сохранять мысли, следить за целями. Он просто работает. + +--- + +> **Если вы запутались на каком-то шаге** +> +> Не переживайте! Откройте [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) и напишите: +> «Помоги разобраться с этой инструкцией, я застрял на шаге [номер шага]. Вот ссылка: https://github.com/ВАШ_ЛОГИН/agent-second-brain» +> +> Он прочитает инструкцию и поможет вам пошагово. + +--- + +## Как это работает + +

+как это работает +

+ +1. Вы отправляете голосовое/текст/фото в **Telegram** +2. **Бот на сервере** сохраняет всё в файл +3. **Claude Code** анализирует записи +4. Создаёт задачи в **Todoist**, сохраняет мысли в **Obsidian** +5. Отправляет отчёт обратно в **Telegram** +6. Всё синхронизируется в **GitHub** + +--- + +## Словарь терминов + +Если какие-то слова незнакомы — вот короткий словарь: + +| Термин | Что это значит | +|--------|----------------| +| **VPS** | Удалённый мини-компьютер в интернете. Как ваш ПК, но работает 24/7 и находится в дата-центре | +| **SSH** | Способ подключиться к VPS через чёрное окно с текстом (терминал). Как удалённый рабочий стол, но текстом | +| **Token** | Секретный код для сервиса. Длинная строка букв и цифр, которую нельзя никому показывать | +| **Repo** | Репозиторий — папка проекта на GitHub. Там хранятся все файлы и история изменений | +| **.env** | Файл с секретами и настройками. Лежит только на сервере, никуда не публикуется | +| **Fork** | Ваша личная копия проекта. Можете менять как хотите, оригинал не затронете | +| **Clone** | Скачать проект на компьютер. После этого можете открыть его в VS Code | + +--- + +## Что понадобится + +| Компонент | Зачем | Стоимость | +|-----------|-------|-----------| +| **Claude Pro/Max** | AI-агент, который обрабатывает ваши записи | $20/мес | +| **VPS-сервер** | Чтобы бот работал круглосуточно | ~$5/мес | +| **GitHub** | Хранение и синхронизация всех ваших записей | бесплатно | +| **Deepgram** | Превращение голосовых сообщений в текст | бесплатно ($200 на старт) | +| **Todoist** | Хранение задач в одном месте | бесплатно / $4/мес Pro | + +**Итого: ~$25/мес** + +### Где взять VPS + +Нужен сервер НЕ в России/Беларуси — там блокировка Claude по территории. + +- [Contabo](https://contabo.com) — $4.96/мес, работает с белорусскими картами +- [OVH](https://ovhcloud.com) — $5/мес, тоже работает с белорусскими картами + +--- + +# Часть 1: Подготовка на компьютере ⏱ 30–50 мин + +### 1.1 Установите Git и VS Code + +**Что это такое:** +- **Git** — программа для скачивания и синхронизации проектов +- **VS Code** — бесплатный редактор файлов (как Word, но для настроек и кода) + +--- + +**Если у вас Windows:** + +1. Откройте браузер и перейдите по ссылке: [git-scm.com/download/win](https://git-scm.com/download/win) +2. Скачивание начнётся автоматически. Дождитесь окончания. +3. Откройте папку «Загрузки» на вашем компьютере +4. Найдите скачанный файл (называется что-то вроде `Git-2.xx.x-64-bit.exe`) +5. Дважды щёлкните по нему мышкой +6. Если появится окно «Разрешить этому приложению вносить изменения?» — нажмите **Да** +7. Откроется окно установки. Нажимайте кнопку **Next** (Далее) внизу окна +8. Продолжайте нажимать **Next** до тех пор, пока не появится кнопка **Install** — нажмите её +9. Дождитесь завершения установки и нажмите **Finish** + +Теперь установите VS Code: + +1. Откройте браузер и перейдите по ссылке: [code.visualstudio.com](https://code.visualstudio.com/) +2. Нажмите большую синюю кнопку **Download for Windows** +3. Откройте папку «Загрузки» +4. Найдите скачанный файл (называется что-то вроде `VSCodeUserSetup-x64-1.xx.x.exe`) +5. Дважды щёлкните по нему +6. Если появится окно «Разрешить этому приложению?» — нажмите **Да** +7. Нажимайте **Next** до кнопки **Install**, затем нажмите **Install** +8. Дождитесь завершения и нажмите **Finish** +9. VS Code запустится автоматически. Если нет — найдите его в меню «Пуск» + +--- + +**Если у вас Mac:** + +1. Нажмите клавиши `Cmd + Пробел` одновременно (появится строка поиска) +2. Напечатайте слово `Terminal` и нажмите Enter +3. Откроется чёрное окно — это терминал +4. Напечатайте команду `git --version` и нажмите Enter +5. Если появится окно «Установить инструменты разработчика?» — нажмите кнопку **Установить** +6. Дождитесь завершения установки + +Теперь установите VS Code: + +1. Откройте браузер и перейдите по ссылке: [code.visualstudio.com](https://code.visualstudio.com/) +2. Нажмите большую кнопку **Download for Mac** +3. Откройте папку «Загрузки» (Downloads) +4. Найдите файл `VSCode-darwin-universal.zip` +5. Дважды щёлкните по нему — он распакуется в приложение +6. Перетащите появившийся значок **Visual Studio Code** в папку **Программы** (Applications) +7. Откройте папку «Программы» и дважды щёлкните на **Visual Studio Code** + +--- + +**Как проверить, что всё установилось:** + +После запуска VS Code вы увидите тёмное окно с надписью «Welcome». Это значит, что всё установлено правильно. + +

+ Ghostty_27_December_2025_vPEZpgCt +

+ +--- + +### 1.2 Создайте аккаунт на GitHub + +**Что такое GitHub:** +GitHub — это сайт, где хранятся ваши файлы и записи. Как облачное хранилище, но для проектов. + +**Как создать аккаунт:** + +1. Откройте браузер и перейдите на сайт [github.com](https://github.com) +2. В правом верхнем углу найдите кнопку **Sign up** и нажмите её +3. Введите ваш email (электронную почту) +4. Придумайте пароль (запишите его, чтобы не забыть!) +5. Придумайте имя пользователя (логин) — это будет ваш адрес на GitHub + +> **Важно:** Запомните или запишите ваш логин! Везде далее в инструкции, где написано `ВАШ_ЛОГИН`, вам нужно будет вписывать именно это имя. + +6. Нажмите **Create account** +7. Пройдите проверку «Я не робот» +8. Откройте вашу почту и найдите письмо от GitHub +9. Нажмите на ссылку в письме для подтверждения + +

+ Arc_27_December_2025_bAQJJGoP +

+ +--- + +### 1.3 Сделайте Fork проекта + +**Что такое Fork:** +Fork — это ваша личная копия проекта. Все ваши записи будут храниться только у вас. + +**Как сделать Fork:** + +1. Убедитесь, что вы вошли в свой аккаунт на GitHub (в правом верхнем углу должен быть ваш аватар) +2. Откройте в браузере ссылку на оригинальный проект (попросите её у того, кто дал вам эту инструкцию) +3. В правом верхнем углу страницы найдите кнопку **Fork** (она выглядит как значок вилки) +4. Нажмите на неё +5. Откроется новая страница с заголовком «Create a new fork» +6. Ничего не меняйте и нажмите зелёную кнопку **Create fork** внизу +7. Подождите несколько секунд — вас перенаправит на вашу копию проекта + +

+ Arc_27_December_2025_Uw5hbtiu +

+ +Теперь у вас есть своя копия по адресу: `https://github.com/ВАШ_ЛОГИН/agent-second-brain` + +> ⚠️ **ВАЖНО: Сделайте репозиторий приватным!** +> +> Ваш форк сейчас **публичный** — все ваши цели и записи будут видны всему интернету! +> +> **Как закрыть:** +> 1. Откройте ваш репозиторий на GitHub +> 2. **Settings** → прокрутите вниз до **Danger Zone** +> 3. Нажмите **Change visibility** → выберите **Private** +> +> Или создайте новый приватный репозиторий и скопируйте туда файлы. + +> **Где посмотреть свой логин:** +> Нажмите на свой аватар в правом верхнем углу GitHub — там будет написано ваше имя пользователя. + +--- + +### 1.4 Клонируйте Fork на компьютер + +**Что значит «клонировать»:** +Это значит скачать проект с GitHub на ваш компьютер, чтобы вы могли редактировать файлы. + +**Шаг 1: Откройте VS Code** +- На Windows: нажмите кнопку «Пуск» в левом нижнем углу экрана, напечатайте `VS Code`, нажмите Enter +- На Mac: нажмите `Cmd + Пробел`, напечатайте `VS Code`, нажмите Enter + +**Шаг 2: Откройте командную панель** +- На Windows: нажмите одновременно три клавиши `Ctrl + Shift + P` +- На Mac: нажмите одновременно три клавиши `Cmd + Shift + P` + +Сверху окна появится строка для ввода команд. + +**Шаг 3: Введите команду клонирования** + +1. В появившейся строке напечатайте `Git: Clone` и нажмите Enter +2. Появится строка «Provide repository URL» (введите адрес репозитория) +3. Напечатайте адрес вашего репозитория: + +``` +https://github.com/ВАШ_ЛОГИН/agent-second-brain.git +``` + +> **Важно:** Замените `ВАШ_ЛОГИН` на ваш реальный логин GitHub! +> Например, если ваш логин `ivan_petrov`, введите: +> `https://github.com/ivan_petrov/agent-second-brain.git` + +4. Нажмите Enter +5. Откроется окно выбора папки. Выберите папку «Документы» (Documents) и нажмите **Select as Repository Destination** +6. Дождитесь, пока проект скачается (появится индикатор загрузки) +7. Появится вопрос «Would you like to open?» — нажмите кнопку **Open** + +**Что произошло:** +VS Code скачал проект на ваш компьютер и открыл его. Слева вы увидите список папок и файлов проекта. + +

+ Code_27_December_2025_mBvxd2PN +

+ +> **Если случайно закрыли VS Code:** +> 1. Откройте VS Code снова +> 2. Нажмите меню **File** (Файл) в верхнем левом углу +> 3. Выберите **Open Folder** (Открыть папку) +> 4. Найдите папку `agent-second-brain` в папке «Документы» +> 5. Выберите её и нажмите **Open** (Открыть) + +--- + +### 1.5 Заполните ваши цели + +> **ЭТО САМЫЙ ВАЖНЫЙ ШАГ** +> +> Бот использует ваши цели, чтобы понимать, что для вас важно. Без целей он не сможет правильно расставлять приоритеты. + +В левой части VS Code найдите папку `vault`, нажмите на стрелочку слева от неё, чтобы раскрыть. Внутри найдите папку `goals`. В ней лежат 4 файла: + +- `0-vision-3y.md` — видение на 3 года +- `1-yearly-2025.md` — цели на год +- `2-monthly.md` — приоритеты на месяц +- `3-weekly.md` — фокус на неделю + +**Как заполнить с помощью ChatGPT или Claude:** + +1. В левой панели VS Code нажмите на файл `vault/goals/0-vision-3y.md`, чтобы открыть его +2. Нажмите `Ctrl+A` (на Mac: `Cmd+A`), чтобы выделить весь текст +3. Нажмите `Ctrl+C` (на Mac: `Cmd+C`), чтобы скопировать +4. Откройте в браузере [claude.ai](https://claude.ai) или [chat.openai.com](https://chat.openai.com) +5. Вставьте скопированный текст (нажмите `Ctrl+V` или `Cmd+V`) +6. Добавьте после текста: + +``` +Это шаблон моего 3-летнего видения. Помоги мне его заполнить. + +Правила: +1. Задавай вопросы ПО ОДНОМУ +2. Жди мой ответ, потом задавай следующий +3. Копай глубже — если отвечаю размыто, уточняй +4. В конце сформируй заполненный документ в том же формате + +Начни с первого вопроса о карьере. +``` + +7. Отправьте сообщение и отвечайте на вопросы +8. Когда получите готовый заполненный документ — скопируйте его +9. Вернитесь в VS Code +10. В файле `0-vision-3y.md` нажмите `Ctrl+A` (выделить всё), затем `Ctrl+V` (вставить) +11. **Обязательно сохраните файл:** нажмите `Ctrl+S` (на Mac: `Cmd+S`) + +> **Важно:** Если на вкладке файла рядом с названием горит белый кружочек — файл не сохранён! Обязательно нажмите `Ctrl+S` / `Cmd+S`. + +

+ Code_27_December_2025_iTpZrkVd +

+ +**Повторите для остальных файлов.** + +Промпты для них: + +**Для `1-yearly-2025.md`:** +``` +Это шаблон годовых целей. На основе моего 3-летнего видения +помоги поставить цели на 2025 год. Задавай вопросы по одному. +``` + +**Для `2-monthly.md`:** +``` +Какие 3 главных приоритета на этот месяц? Задавай вопросы по одному. +``` + +**Для `3-weekly.md`:** +``` +Самое важное — секция "ONE Big Thing". Это одна главная задача на неделю. +Помоги определить её. Задавай вопросы. +``` + +> **Не забывайте сохранять каждый файл после изменений:** `Ctrl+S` / `Cmd+S` + +--- + +### 1.6 Настройте профиль + +Откройте файл с информацией о себе. Есть два способа: + +**Быстрый способ:** +1. Нажмите `Ctrl+P` (на Mac: `Cmd+P`) +2. В появившейся строке напечатайте `about.md` +3. Нажмите Enter + +**Или вручную:** +В левой панели VS Code раскройте папки по пути: +`vault` → `.claude` → `skills` → `dbrain-processor` → `references` → `about.md` + +В этом файле замените информацию на свою: +- Ваше имя +- Чем занимаетесь +- Основные проекты +- Приоритеты + +Это поможет боту понимать контекст ваших записей. + +**Сохраните файл:** `Ctrl+S` / `Cmd+S` + +--- + +### 1.7 Настройте систему под себя + +> **Важно:** Помимо `about.md`, в папке `vault/.claude/skills/dbrain-processor/references/` есть ещё несколько файлов, которые нужно настроить под себя. + +**Какие файлы нужно обновить:** + +| Файл | Что там настраивается | +|------|----------------------| +| `about.md` | Ваш профиль, цели, стиль работы | +| `classification.md` | Категории задач, имена клиентов/проектов | +| `todoist.md` | Проекты в Todoist, приоритеты | + +

+Antigravity_27_December_2025_POjAbCgi +

+ +> Может, у вас нет клиентов — вы работаете на производстве, в офисе, или фрилансер. Это нормально! Замените примеры на свои реалии: проекты, отделы, направления работы. + +**Самый простой способ настроить:** + +1. В левой панели VS Code найдите папку `vault/.claude/skills/dbrain-processor/` +2. Нажмите на неё правой кнопкой мыши +3. Выберите **Reveal in Finder** (Mac) или **Open in File Explorer** (Windows) +4. Заархивируйте эту папку в ZIP +5. Отправьте архив в [ChatGPT](https://chat.openai.com) или [Claude](https://claude.ai) с текстом: + +``` +Это настройки моего AI-ассистента. +Задавай мне вопросы по одному, чтобы заполнить все файлы под меня. +Когда закончим — верни мне обновлённый ZIP-архив. +``` + +6. Ответьте на все вопросы +7. Скачайте готовый архив +8. Разархивируйте и положите файлы обратно в ту же папку, заменив старые + +**Или вручную:** +Откройте каждый файл в папке `references/` и замените примеры `[Your ...]` на свою информацию. В каждом файле есть подсказки. + +--- + +### 1.8 Сохраните изменения в GitHub + +Теперь нужно отправить все ваши изменения обратно на GitHub. + +1. В левой части VS Code найдите третью иконку сверху — она выглядит как разветвление (три точки, соединённые линиями). Нажмите на неё. +2. Вы увидите раздел **Source Control** со списком изменённых файлов +3. Над списком файлов есть поле для ввода сообщения «Message» +4. Напечатайте в нём: `Initial setup with my goals` +5. Нажмите кнопку **Commit** (галочка сверху) +6. Если появится вопрос «Stage all changes?» — нажмите **Yes** +7. Затем нажмите кнопку **Sync Changes** или **Publish Branch** +8. Если спросит логин — введите ваш логин и пароль от GitHub + +

+ Antigravity_27_December_2025_2DT3p7IR +

+ +Готово! Ваш проект с вашими целями теперь сохранён в вашем репозитории на GitHub. + +--- + +### Контрольная точка: Часть 1 завершена + +| Что проверить | Ожидаемый результат | +|---------------|---------------------| +| У вас есть свой репозиторий | Откройте `github.com/ВАШ_ЛОГИН/agent-second-brain` — видите свои файлы | +| На компьютере есть папка проекта | В VS Code слева видны папки `vault`, `src` и файлы | +| Цели заполнены | Откройте `vault/goals/` — там ваши цели, не шаблон | +| Изменения в GitHub | На сайте github.com видны ваши изменения | + +--- + +# Часть 2: Получите ключи ⏱ 15 мин + +**Что нужно собрать:** +Вам понадобятся 4 секретных кода (токена). Соберите их все заранее и сохраните в надёжное место — блокнот, заметки или менеджер паролей. + +| Токен | Откуда взять | Как выглядит | +|-------|--------------|--------------| +| Telegram Bot Token | @BotFather в Telegram | `7123456789:AAH...` | +| Ваш Telegram ID | @userinfobot в Telegram | `123456789` | +| Deepgram API Key | console.deepgram.com | Длинная строка | +| Todoist API Token | todoist.com → Settings | 40 символов | + +--- + +### 2.1 Telegram Bot Token + +1. Откройте приложение Telegram на телефоне или компьютере +2. В строке поиска напечатайте `@BotFather` +3. Откройте чат с BotFather (у него синяя галочка верификации) +4. Напечатайте и отправьте сообщение: `/newbot` +5. Бот спросит имя — напечатайте: `My Second Brain` +6. Бот спросит username — придумайте уникальное имя, которое заканчивается на `bot` + Например: `my_brain_777_bot` или `mysb_12345_bot` +7. После создания бот пришлёт вам длинный код — это и есть токен +8. **Скопируйте его сразу и сохраните!** Он выглядит примерно так: `7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx` + +

+ Telegram_27_December_2025_QyxHhZBg +

+ +--- + +### 2.2 Ваш Telegram ID + +1. В Telegram в строке поиска напечатайте `@userinfobot` +2. Откройте чат с этим ботом +3. Отправьте ему любое сообщение (например, «привет») +4. Бот ответит информацией о вас. Найдите строку **Id:** и скопируйте число после неё +5. Это ваш Telegram ID, например: `123456789` + +--- + +### 2.3 Deepgram API Key + +1. Откройте в браузере сайт [console.deepgram.com](https://console.deepgram.com/) +2. Нажмите **Sign Up** и зарегистрируйтесь (можно через Google) +3. После входа в левом меню найдите **Settings** (Настройки) +4. Выберите **API Keys** (Ключи API) +5. Нажмите кнопку **Create API Key** (Создать ключ) +6. Придумайте любое название (например, `second-brain`) +7. **Важно:** Ключ показывается только один раз! Скопируйте его сразу и сохраните. + +> **Предупреждение:** Если вы закроете окно, не скопировав ключ — он исчезнет навсегда и придётся создавать новый. + +

+ Arc_27_December_2025_yTuxiFSA +

+ +--- + +### 2.4 Todoist API Token + +1. Откройте в браузере сайт [todoist.com](https://todoist.com) +2. Войдите в свой аккаунт или зарегистрируйтесь +3. Нажмите на свой аватар в левом верхнем углу +4. Выберите **Settings** (Настройки) +5. В левом меню найдите **Integrations** (Интеграции) +6. Прокрутите вниз до раздела **Developer** +7. Скопируйте **API token** + +

+ Arc_27_December_2025_FlpSkZgR +

+ +--- + +### Контрольная точка: Часть 2 завершена + +| Что проверить | Ожидаемый результат | +|---------------|---------------------| +| Telegram Bot Token | Строка вида `7123456789:AAH...` | +| Ваш Telegram ID | Число вида `123456789` | +| Deepgram API Key | Длинная строка букв и цифр | +| Todoist API Token | Строка из 40 символов | + +> **Сохраните все токены** в надёжное место. Они понадобятся при настройке сервера. + +--- + +# Часть 3: Настройка сервера ⏱ 40–70 мин + +### 3.1 Купите VPS и подключитесь + +**Шаг 1: Купите сервер** + +1. Откройте сайт [Contabo](https://contabo.com/en/vps/) или [OVH](https://ovhcloud.com/en/vps/) +2. Выберите самый дешёвый тариф (хватит с запасом) +3. **Важно:** При выборе операционной системы выберите **Ubuntu 22.04** — это база +4. Завершите покупку и оплату +5. На вашу почту придёт письмо с данными для входа: IP-адрес и пароль + +

+ Arc_27_December_2025_XNzzknIo +

+ +

+ Arc_27_December_2025_a5D7KnnM +

+ +

+ Arc_27_December_2025_tvjyMe08 +

+ +

+ Spark Desktop_27_December_2025_sltZRiMZ +

+ +**Шаг 2: Подключитесь к серверу** + +На Windows: +1. Нажмите кнопку **Пуск** в левом нижнем углу +2. Напечатайте `cmd` и нажмите Enter +3. Откроется чёрное окно — это командная строка + +На Mac: +1. Нажмите `Cmd + Пробел` +2. Напечатайте `Terminal` и нажмите Enter + +В открывшемся окне напечатайте команду (замените `ВАШ_IP_АДРЕС` на IP из письма): + +```bash +ssh root@ВАШ_IP_АДРЕС +``` + +Например: `ssh root@185.123.45.67` + +Нажмите Enter. + +Если спросит «Are you sure you want to continue?» — напечатайте `yes` и нажмите Enter. + +> **Важно о пароле:** +> **Когда вы вводите пароль, в чёрном окне ничего не печатается — это нормально!** Это не зависание. Просто введите пароль из письма и нажмите Enter. Буквы не видно в целях безопасности. + +

+ Ghostty_27_December_2025_OwCbt58A +

+ +--- + +### 3.2 Создайте пользователя + +Работать под пользователем root небезопасно. Создайте обычного пользователя. + +Напечатайте эти команды **по одной**, нажимая Enter после каждой: + +```bash +adduser myuser +``` + +Система попросит придумать пароль — придумайте и запомните его. На остальные вопросы просто нажимайте Enter. + +```bash +usermod -aG sudo myuser +``` + +```bash +su - myuser +``` + +Теперь вы работаете под пользователем `myuser`. + +

+ Ghostty_27_December_2025_4iOcEzsO +

+ +--- + +### 3.3 Установите всё необходимое + +Скопируйте и вставьте эти команды **по одной** (после каждой нажимайте Enter и ждите завершения): + +```bash +sudo apt update && sudo apt upgrade -y +``` + +```bash +sudo apt install -y git curl wget build-essential +``` + +```bash +sudo apt install -y software-properties-common +``` + +```bash +sudo add-apt-repository -y ppa:deadsnakes/ppa +``` + +```bash +sudo apt update +``` + +```bash +sudo apt install -y python3.12 python3.12-venv python3.12-dev +``` + +```bash +curl -LsSf https://astral.sh/uv/install.sh | sh +``` + +```bash +source ~/.bashrc +``` + +```bash +curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - +``` + +```bash +sudo apt install -y nodejs +``` + +```bash +npm install -g @anthropic-ai/claude-code +``` + +```bash +claude auth login +``` + +Последняя команда откроет ссылку для авторизации — следуйте инструкциям на экране. + +

+ Ghostty_27_December_2025_gAcpHg2c +

+ +--- + +### Контрольная точка: Часть 3.3 завершена + +| Что проверить | Как проверить | +|---------------|---------------| +| Подключение к серверу | Команда `ssh myuser@ВАШ_IP` работает без ошибок | +| Claude установлен | Команда `claude --version` показывает номер версии | +| Claude авторизован | Команда `claude auth status` показывает `Logged in` | + +--- + +## Запуск бота + +**Вы установили Claude Code и авторизовались — отлично!** + +Теперь просто вставьте эту команду и следуйте подсказкам на экране: + +```bash +curl -fsSL https://raw.githubusercontent.com/ВАШ_ЛОГИН/agent-second-brain/main/bootstrap.sh | bash +``` + +> **Замените `ВАШ_ЛОГИН`** на ваш логин GitHub! + +Скрипт сам: +- Скачает ваш проект +- Спросит у вас все токены (Telegram, Deepgram, Todoist) +- Создаст файл с настройками +- Настроит автозапуск +- Запустит бота +- Покажет статус + +**Если команда не сработала**, выполните вручную: + +```bash +cd ~ +git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git +cd agent-second-brain +bash setup.sh +``` + +--- + +### Контрольная точка: Бот работает + +| Что проверить | Ожидаемый результат | +|---------------|---------------------| +| Бот отвечает на /start | В Telegram видны кнопки меню | +| Голосовые распознаются | Бот отвечает текстом на голосовое сообщение | +| Бот работает после перезагрузки | Перезагрузите сервер, бот снова отвечает | + +--- + +# Часть 4: Использование + +### Кнопки бота + +``` +┌─────────────────────────────────────────┐ +│ [📊 Статус] [⚙️ Обработать] [📅 Неделя] │ +│ [✨ Запрос] [❓ Помощь] │ +└─────────────────────────────────────────┘ +``` + +| Кнопка | Что делает | +|--------|------------| +| 📊 Статус | Показывает сколько записей сегодня | +| ⚙️ Обработать | Запускает обработку всех записей | +| 📅 Неделя | Показывает недельный дайджест | +| ✨ Запрос | Можно попросить что-то сделать (самая крутая!) | +| ❓ Помощь | Показывает справку | + +--- + +### Что можно отправлять + +**Голосовые** — основной способ: +- «Надо написать Пете по проекту» +- «Идея: сделать лендинг с калькулятором» + +**Текст** — ссылки, цитаты, быстрые мысли + +**Фото** — скриншоты, фото досок + +**Пересланные сообщения** — из других чатов + +--- + +### Кнопка «✨ Запрос» + +1. Нажмите **✨ Запрос** +2. Бот спросит «Что сделать?» +3. Отправьте голосовое или текст + +Примеры: +- «покажи задачи на сегодня» +- «перенеси просроченные на понедельник» +- «создай задачу: позвонить в банк» + +--- + +# Часть 5: Синхронизация + +Ваши записи хранятся в папке `vault/`. Есть несколько способов их просматривать: + +### Способ 1: Obsidian (рекомендуем) + +**Что такое Obsidian:** +Это бесплатное приложение для просмотра заметок с красивыми связями между ними. Вы сможете видеть все свои мысли, задачи и цели в удобном интерфейсе. + +

+ image +

+ +**На компьютере:** +1. Откройте браузер и перейдите на [obsidian.md](https://obsidian.md) +2. Скачайте приложение для вашей системы и установите его +3. Откройте Obsidian +4. Нажмите **Open folder as vault** +5. Найдите папку `agent-second-brain` (там, куда вы скачивали проект в Части 1) +6. Внутри неё выберите папку `vault` +7. Нажмите **Open** + +Теперь вы видите все свои заметки, цели и мысли в красивом интерфейсе. + +**На iPhone/iPad:** +1. На компьютере переместите папку `vault` в iCloud Drive +2. На iPhone скачайте Obsidian из App Store +3. В приложении «Файлы» найдите папку `vault` в iCloud +4. В Obsidian нажмите «Open folder as vault» → выберите эту папку + +**На Android:** +1. Установите [GitJournal](https://play.google.com/store/apps/details?id=io.gitjournal.gitjournal) +2. Подключите ваш GitHub репозиторий +3. Все заметки будут синхронизироваться автоматически + +--- + +### Способ 2: GitHub напрямую + +Все файлы хранятся в вашем репозитории на GitHub по адресу: +``` +https://github.com/ВАШ_ЛОГИН/agent-second-brain +``` + +Вы можете: +- Просматривать заметки прямо на сайте +- Редактировать файлы через веб-интерфейс +- Скачивать обновления командой `git pull` + +--- + +### Способ 3: Кнопка «✨ Запрос» + +Самый простой способ — спросить бота напрямую: +- «Что я записал вчера?» +- «Покажи мои цели на неделю» +- «Какие задачи на сегодня?» +- «Найди заметку про [тема]» + +Бот найдёт и покажет всё что нужно прямо в Telegram. + +--- + +# Помощь + +### Если что-то пошло не так + +Самый простой способ решить проблему — запустить программу `claude` прямо в чёрном окне сервера. + +1. Подключитесь к серверу (как в Части 3) +2. Перейдите в папку проекта: + ```bash + cd ~/agent-second-brain + ``` +3. Запустите Claude: + ```bash + claude + ``` +4. Напишите ему: + ``` + Я настраиваю бота, у меня возникла ошибка: [опишите что случилось] + Что мне сделать? + ``` + +Claude прочитает файлы проекта и поможет решить проблему. + +--- + +### Частые проблемы + +**Бот не отвечает в Telegram:** +Проверьте, работает ли он. Подключитесь к серверу и выполните: +```bash +sudo systemctl status d-brain-bot +``` +Должно показать `active (running)`. + +**Голосовые не распознаются:** +Проверьте, правильно ли вы ввели ключ Deepgram при настройке. + +**Claude не работает:** +Проверьте авторизацию: +```bash +claude auth status +``` +Если нужно авторизоваться заново: +```bash +claude auth login +``` + +--- + +
+Технические детали (для продвинутых) + +### Автоматизация + +Система включает автоматическую обработку записей: + +**Ежедневная обработка (21:00):** +- Скрипт `scripts/process.sh` запускает Claude с dbrain-processor skill +- Классифицирует записи, создаёт задачи в Todoist +- Отправляет отчёт в Telegram +- Коммитит изменения в Git + +**Недельный дайджест (воскресенье 20:00):** +- Скрипт `scripts/weekly.py` генерирует сводку за неделю +- Анализирует прогресс по целям +- Отправляет в Telegram + +**Session Persistence (JSONL):** +- Все взаимодействия сохраняются в `vault/sessions/YYYY-MM-DD.jsonl` +- Append-only формат для надёжности +- Методы API: `append()`, `get_today()`, `get_recent()`, `get_stats()` + +### Полезные команды + +```bash +# Посмотреть логи бота +sudo journalctl -u d-brain-bot -f + +# Перезапустить бота +sudo systemctl restart d-brain-bot + +# Остановить бота +sudo systemctl stop d-brain-bot + +# Запустить бота +sudo systemctl start d-brain-bot +``` + +### MCP-серверы + +Эта система использует **MCP (Model Context Protocol)** — открытый стандарт от Anthropic для подключения AI к внешним сервисам. По умолчанию настроен Todoist, но вы можете подключить любой сервис, для которого есть MCP-сервер: + +| Сервис | MCP-сервер | Что можно делать | +|--------|------------|------------------| +| **Todoist** | [@doist/todoist-ai](https://github.com/Doist/todoist-ai) | Задачи, проекты, приоритеты *(уже настроен)* | +| **Google Workspace** | [google_workspace_mcp](https://github.com/taylorwilsdon/google_workspace_mcp) | Gmail, Calendar, Drive | +| **Notion** | [notion-mcp-server](https://github.com/makenotion/notion-mcp-server) | Страницы, базы данных | +| **Things 3** | [things-mcp](https://github.com/hald/things-mcp) | Задачи на macOS/iOS | +| **GitHub** | [github-mcp-server](https://github.com/github/github-mcp-server) | Issues, PR, репозитории | + +Полный список: [github.com/modelcontextprotocol/servers](https://github.com/modelcontextprotocol/servers) + +### Настройка systemd вручную + +Если автоматический скрипт не создал сервис: + +```bash +sudo nano /etc/systemd/system/d-brain-bot.service +``` + +Вставьте (замените `myuser` на ваше имя пользователя): + +```ini +[Unit] +Description=d-brain Telegram Bot +After=network.target + +[Service] +Type=simple +User=myuser +WorkingDirectory=/home/myuser/agent-second-brain +ExecStart=/home/myuser/.local/bin/uv run python -m d_brain +Restart=always +RestartSec=10 + +[Install] +WantedBy=multi-user.target +``` + +Сохраните (`Ctrl+O`, Enter, `Ctrl+X`) и выполните: + +```bash +sudo systemctl daemon-reload +sudo systemctl enable d-brain-bot +sudo systemctl start d-brain-bot +``` + +
+ +--- + +
+Инструкция для Claude Code (читает Claude, не вы) + +### Команды с sudo + +Claude Code не может выполнять команды с `sudo` — они требуют ввода пароля. + +Когда нужно выполнить команду с sudo, попроси пользователя: + +``` +Мне нужно выполнить команду с sudo, но я не могу ввести пароль. + +Пожалуйста, сделайте следующее: + +1. Откройте новую вкладку терминала (Ctrl+Shift+T или Cmd+T) +2. Подключитесь к серверу: + ssh ВАШ_ПОЛЬЗОВАТЕЛЬ@ВАШ_IP_АДРЕС + +3. Выполните эту команду: + sudo [КОМАНДА] + +4. Введите пароль когда попросят +5. Вернитесь ко мне и скажите что готово +``` + +### Ручные шаги настройки + +**Проверка MCP Todoist:** +```bash +npx -y @doist/todoist-ai --help +``` + +**Клонирование репозитория:** +```bash +cd ~ +mkdir -p projects +cd projects +git clone https://github.com/ВАШ_ЛОГИН/agent-second-brain.git +cd agent-second-brain +uv sync +``` + +**Создание .env:** +```bash +nano .env +``` + +Содержимое: +```bash +TELEGRAM_BOT_TOKEN=7123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxx +DEEPGRAM_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +TODOIST_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx +VAULT_PATH=./vault +ALLOWED_USER_IDS=[123456789] +``` + +> В `ALLOWED_USER_IDS` обязательно сохраняйте квадратные скобки! + +**Тестовый запуск:** +```bash +uv run python -m d_brain +``` + +**Настройка Git push:** +```bash +git config user.name "My Bot" +git config user.email "your@email.com" +``` + +Создайте Personal Access Token на GitHub: Settings → Developer settings → Personal access tokens → Tokens (classic) → Generate new token (scope: repo) + +```bash +git remote set-url origin https://ТОКЕН@github.com/ВАШ_ЛОГИН/agent-second-brain.git +``` + +
diff --git a/docs/mcp-cli-setup.md b/docs/mcp-cli-setup.md new file mode 100644 index 0000000..c91adae --- /dev/null +++ b/docs/mcp-cli-setup.md @@ -0,0 +1,194 @@ +# MCP через mcp-cli + +Стабильное подключение к MCP серверам через mcp-cli вместо прямого протокола. + +## Зачем это нужно + +MCP протокол напрямую иногда отваливается. mcp-cli решает эту проблему: + +- **Connection pooling** - daemon держит соединения +- **Auto-retry** - автоматические повторы при сетевых ошибках +- **Стабильность** - работа через bash надёжнее чем MCP протокол напрямую + +## Как это работает + +``` +До: +Claude → MCP Protocol → Todoist MCP Server → Todoist API + (отваливается) + +После: +Claude → Bash → mcp-cli → Todoist MCP Server → Todoist API + (daemon, retry, pooling) +``` + +--- + +## Установка + +### 1. Установите mcp-cli + +```bash +curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash +``` + +Проверка: +```bash +~/.local/bin/mcp-cli --version +# mcp-cli v0.3.0 +``` + +### 2. Создайте конфиг + +```bash +mkdir -p ~/.config/mcp +cat > ~/.config/mcp/mcp_servers.json << 'EOF' +{ + "mcpServers": { + "todoist": { + "command": "npx", + "args": ["-y", "@doist/todoist-ai"], + "env": { + "TODOIST_API_KEY": "${TODOIST_API_KEY}" + } + } + } +} +EOF +``` + +### 3. Добавьте токены в shell + +```bash +# Добавить в ~/.bashrc +echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc +echo 'export TODOIST_API_KEY="ваш_токен"' >> ~/.bashrc +source ~/.bashrc +``` + +### 4. Уберите прямое MCP подключение из Claude + +```bash +# Удалить прямое MCP подключение +claude mcp remove todoist +``` + +Проверить что удалено: +```bash +claude mcp list +# todoist НЕ должен быть в списке +``` + +Теперь Claude работает через mcp-cli (bash), а не через MCP протокол напрямую. + +--- + +## Проверка + +```bash +# Список инструментов (24 шт) +mcp-cli info todoist + +# Тест - задачи на сегодня +mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}' + +# Обзор всех проектов +mcp-cli call todoist get-overview '{}' +``` + +--- + +## Todoist Tools (24) + +### Задачи + +| Tool | Описание | +|------|----------| +| `add-tasks` | Создать задачи | +| `update-tasks` | Обновить задачи | +| `complete-tasks` | Завершить задачи | +| `find-tasks` | Поиск по тексту/проекту/label | +| `find-tasks-by-date` | Задачи по дате | +| `find-completed-tasks` | Завершённые задачи | + +### Проекты и секции + +| Tool | Описание | +|------|----------| +| `add-projects` | Создать проекты | +| `update-projects` | Обновить проекты | +| `find-projects` | Поиск проектов | +| `add-sections` | Создать секции | +| `update-sections` | Обновить секции | +| `find-sections` | Секции проекта | + +### Комментарии и коллаборация + +| Tool | Описание | +|------|----------| +| `add-comments` | Добавить комментарии | +| `update-comments` | Обновить комментарии | +| `find-comments` | Найти комментарии | +| `find-project-collaborators` | Участники проекта | +| `manage-assignments` | Bulk назначение | + +### Общее + +| Tool | Описание | +|------|----------| +| `get-overview` | Обзор (markdown) | +| `find-activity` | Лог активности | +| `delete-object` | Удалить объект | +| `fetch-object` | Получить объект | +| `user-info` | Инфо о пользователе | +| `search` | Универсальный поиск | +| `fetch` | Получить по ID | + +--- + +## Примеры команд + +### Задачи на сегодня +```bash +mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}' +``` + +### Создать задачу +```bash +mcp-cli call todoist add-tasks '{"tasks": [{"content": "Тест задача", "dueString": "tomorrow", "priority": 2}]}' +``` + +### Завершить задачу +```bash +mcp-cli call todoist complete-tasks '{"ids": ["task_id_here"]}' +``` + +### Поиск задач +```bash +mcp-cli call todoist find-tasks '{"searchText": "проект"}' +``` + +### Обзор проекта +```bash +mcp-cli call todoist get-overview '{"projectId": "project_id"}' +``` + +### Найти проекты +```bash +mcp-cli call todoist find-projects '{"search": "Work"}' +``` + +--- + +## Отладка + +```bash +MCP_DEBUG=1 mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}' +``` + +--- + +## Требования + +- Node.js 18+ (для npx) +- Todoist API Token (Settings → Integrations → Developer) diff --git a/docs/vps-setup.md b/docs/vps-setup.md new file mode 100644 index 0000000..bb1f4d9 --- /dev/null +++ b/docs/vps-setup.md @@ -0,0 +1,515 @@ +# VPS Setup Guide + +Run Agent Second Brain 24/7 on a virtual private server. + +## Requirements + +- VPS with Ubuntu 22.04+ (minimum 1GB RAM, recommended 2GB) +- Root or sudo access +- SSH client + +## Recommended VPS Providers + +| Provider | Price | Region | +|----------|-------|--------| +| Contabo | from $5/mo | Europe | +| Hetzner | from $4/mo | Europe | +| DigitalOcean | from $6/mo | Global | +| Vultr | from $5/mo | Global | + +--- + +## Step 1: Connect to Server + +After purchasing VPS, you'll get: +- IP address (e.g., `162.55.123.45`) +- Root password + +Connect via SSH: + +```bash +ssh root@162.55.123.45 +``` + +Enter password (characters won't display — that's normal). + +--- + +## Step 2: Create User + +Never work as root. Create a regular user: + +```bash +# Create user (replace "myuser" with your name) +adduser myuser + +# Follow prompts: +# - Enter password (twice) +# - Other fields can be skipped (Enter) + +# Grant sudo rights +usermod -aG sudo myuser + +# Switch to new user +su - myuser +``` + +--- + +## Step 3: Update System + +```bash +sudo apt update && sudo apt upgrade -y +``` + +--- + +## Step 4: Install Base Tools + +```bash +# Git +sudo apt install -y git + +# Curl and wget +sudo apt install -y curl wget + +# Build tools +sudo apt install -y build-essential + +# Verify +git --version +``` + +--- + +## Step 5: Install Python 3.12 + +```bash +sudo apt install -y software-properties-common +sudo add-apt-repository -y ppa:deadsnakes/ppa +sudo apt update +sudo apt install -y python3.12 python3.12-venv python3.12-dev + +# Verify +python3.12 --version +``` + +--- + +## Step 6: Install uv + +```bash +curl -LsSf https://astral.sh/uv/install.sh | sh +source ~/.bashrc + +# Verify +uv --version +``` + +--- + +## Step 7: Install Node.js + +Required for MCP servers (Todoist integration): + +```bash +curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - +sudo apt install -y nodejs + +# Verify +node --version +npm --version +``` + +--- + +## Step 8: Install Claude CLI + +```bash +npm install -g @anthropic-ai/claude-code + +# Verify +which claude +claude --version + +# Authenticate +claude auth login +``` + +After `claude auth login`: +1. A URL appears +2. Copy and open it in browser on your computer +3. Log in to Anthropic account +4. Authorize access +5. Return to terminal — it will confirm + +--- + +## Step 9: Clone Project + +```bash +cd ~ +mkdir -p projects +cd projects + +git clone https://github.com/smixs/agent-second-brain.git +cd agent-second-brain + +ls -la +``` + +--- + +## Step 10: Install Dependencies + +```bash +uv sync + +# Verify +uv run python -c "import aiogram; print('aiogram OK')" +``` + +--- + +## Step 11: Get Tokens + +### Telegram Bot Token + +1. Open Telegram +2. Find `@BotFather` +3. Send `/newbot` +4. Enter bot name and username +5. Copy the token + +### Your Telegram User ID + +1. Find `@userinfobot` in Telegram +2. Send any message +3. Copy the ID number + +### Deepgram API Key + +1. Go to https://console.deepgram.com/ +2. Sign up (free $200 credit) +3. Settings → API Keys +4. Create key and copy + +### Todoist API Token (optional) + +1. Go to https://todoist.com/ +2. Settings → Integrations → Developer +3. Copy API token + +--- + +## Step 12: Configure Environment + +```bash +nano ~/projects/agent-second-brain/.env +``` + +Paste (replace with your values): + +```bash +TELEGRAM_BOT_TOKEN=7123456789:AAHdN8J2K4m5N6o7P8q9R0s1T2u3V4w5X6y +DEEPGRAM_API_KEY=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8s9t0 +TODOIST_API_KEY= +VAULT_PATH=./vault +ALLOWED_USER_IDS=[123456789] +``` + +Save: `Ctrl+O`, `Enter`, `Ctrl+X` + +--- + +## Step 13: Clean Vault Examples + +```bash +cd ~/projects/agent-second-brain + +rm -rf vault/daily/* +rm -rf vault/thoughts/ideas/* +rm -rf vault/thoughts/projects/* +rm -rf vault/thoughts/learnings/* +rm -rf vault/thoughts/reflections/* +rm -rf vault/summaries/* +rm -rf vault/attachments/* +``` + +--- + +## Step 14: Customize Goals + +Edit goals to match yours: + +```bash +nano vault/goals/0-vision-3y.md # 3-year vision +nano vault/goals/1-yearly-2026.md # Yearly goals +nano vault/goals/2-monthly.md # Monthly priorities +nano vault/goals/3-weekly.md # Weekly focus +``` + +--- + +## Step 15: Test Run + +```bash +cd ~/projects/agent-second-brain +uv run python -m d_brain +``` + +Should show: +``` +INFO:aiogram.dispatcher:Start polling +INFO:aiogram.dispatcher:Run polling for bot @your_bot_name +``` + +Test in Telegram: +- Find your bot +- Send `/start` +- Send a voice message + +Stop with `Ctrl+C`. + +--- + +## Step 16: Setup Autostart (systemd) + +### Bot Service + +```bash +sudo nano /etc/systemd/system/d-brain-bot.service +``` + +Paste (replace `myuser`): + +```ini +[Unit] +Description=d-brain Telegram Bot +After=network.target + +[Service] +Type=simple +User=myuser +WorkingDirectory=/home/myuser/projects/agent-second-brain +ExecStart=/home/myuser/.local/bin/uv run python -m d_brain +Restart=always +RestartSec=10 +Environment=PYTHONUNBUFFERED=1 + +[Install] +WantedBy=multi-user.target +``` + +Enable and start: + +```bash +sudo systemctl daemon-reload +sudo systemctl start d-brain-bot +sudo systemctl enable d-brain-bot + +# Check status +sudo systemctl status d-brain-bot +``` + +--- + +## Step 17: Daily Processing Timer (optional) + +Automatically process entries at 21:00 daily. + +### Edit process script + +```bash +nano ~/projects/agent-second-brain/scripts/process.sh +``` + +Update paths at the top: +```bash +export HOME="/home/myuser" +PROJECT_DIR="/home/myuser/projects/agent-second-brain" +``` + +Make executable: +```bash +chmod +x ~/projects/agent-second-brain/scripts/process.sh +``` + +### Create timer + +```bash +sudo nano /etc/systemd/system/d-brain-process.timer +``` + +```ini +[Unit] +Description=Run d-brain processing daily at 21:00 + +[Timer] +OnCalendar=*-*-* 21:00:00 +Persistent=true + +[Install] +WantedBy=timers.target +``` + +### Create service + +```bash +sudo nano /etc/systemd/system/d-brain-process.service +``` + +```ini +[Unit] +Description=d-brain Daily Processing + +[Service] +Type=oneshot +User=myuser +WorkingDirectory=/home/myuser/projects/agent-second-brain +ExecStart=/home/myuser/projects/agent-second-brain/scripts/process.sh +Environment=PYTHONUNBUFFERED=1 +``` + +### Enable + +```bash +sudo systemctl daemon-reload +sudo systemctl enable d-brain-process.timer +sudo systemctl start d-brain-process.timer + +# Check timer +sudo systemctl list-timers | grep d-brain +``` + +--- + +## Step 18: Git Configuration + +```bash +cd ~/projects/agent-second-brain + +git config user.email "your@email.com" +git config user.name "Your Name" +``` + +### Create your own repository + +1. GitHub → "+" → "New repository" +2. Name: `my-second-brain` +3. Leave empty (no README) +4. Create + +### Change remote + +```bash +git remote set-url origin https://github.com/YOUR_USERNAME/my-second-brain.git +git remote -v +git push -u origin main +``` + +If prompted for password, use Personal Access Token: +- GitHub → Settings → Developer settings → Personal access tokens + +--- + +## Useful Commands + +```bash +# Bot status +sudo systemctl status d-brain-bot + +# Restart bot +sudo systemctl restart d-brain-bot + +# Stop bot +sudo systemctl stop d-brain-bot + +# Real-time logs +sudo journalctl -u d-brain-bot -f + +# Last 100 log lines +sudo journalctl -u d-brain-bot -n 100 + +# All d-brain services +sudo systemctl status 'd-brain-*' + +# List timers +sudo systemctl list-timers + +# Manual processing +cd ~/projects/agent-second-brain +./scripts/process.sh + +# Update code +cd ~/projects/agent-second-brain +git pull +uv sync +sudo systemctl restart d-brain-bot +``` + +--- + +## Troubleshooting + +### Bot doesn't respond + +```bash +sudo systemctl status d-brain-bot +sudo journalctl -u d-brain-bot -n 100 +cat ~/projects/agent-second-brain/.env | grep TELEGRAM_BOT_TOKEN +sudo systemctl restart d-brain-bot +``` + +### Voice not transcribing + +```bash +cat ~/projects/agent-second-brain/.env | grep DEEPGRAM +sudo journalctl -u d-brain-bot | grep -i error +``` + +### Processing errors + +```bash +claude --version +claude auth status +claude auth login # if needed +``` + +### Todoist not working + +```bash +cat ~/projects/agent-second-brain/.env | grep TODOIST +mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}' +``` + +### Permission errors + +```bash +sudo chown -R myuser:myuser ~/projects/agent-second-brain +chmod -R 755 ~/projects/agent-second-brain +``` + +### Git push fails + +```bash +git remote -v +git status +git config --global credential.helper store +git push +``` + +--- + +## Sync with Local Computer + +See main [README](../README.md) for Obsidian sync options. + +--- + +## Security Tips + +- Use SSH keys instead of passwords +- Keep system updated: `sudo apt update && sudo apt upgrade` +- `.env` is in `.gitignore` — never commit tokens +- Consider setting up firewall: `sudo ufw enable` diff --git a/install.sh b/install.sh new file mode 100755 index 0000000..3567ecd --- /dev/null +++ b/install.sh @@ -0,0 +1,525 @@ +#!/bin/bash +# Agent Second Brain — One-command installer +# Works on Mac and Windows WSL +# https://github.com/smixs/agent-second-brain + +set -e + +# Colors +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +BLUE='\033[0;34m' +NC='\033[0m' # No Color + +# Config +REPO_URL="https://github.com/smixs/agent-second-brain.git" +INSTALL_DIR="$HOME/agent-second-brain" + +####################################### +# Print colored message +####################################### +info() { echo -e "${BLUE}ℹ${NC} $1"; } +success() { echo -e "${GREEN}✓${NC} $1"; } +warn() { echo -e "${YELLOW}⚠${NC} $1"; } +error() { echo -e "${RED}✗${NC} $1"; exit 1; } + +####################################### +# Detect OS +####################################### +detect_os() { + if [[ "$OSTYPE" == "darwin"* ]]; then + OS="mac" + info "Detected: macOS" + elif grep -q Microsoft /proc/version 2>/dev/null; then + OS="wsl" + info "Detected: Windows WSL" + elif [[ "$OSTYPE" == "linux-gnu"* ]]; then + OS="linux" + info "Detected: Linux" + else + error "Unsupported OS. This script works on Mac and Windows WSL only." + fi +} + +####################################### +# Check if command exists +####################################### +has_command() { + command -v "$1" &> /dev/null +} + +####################################### +# Install Homebrew (Mac only) +####################################### +install_homebrew() { + if [[ "$OS" != "mac" ]]; then return; fi + + if has_command brew; then + success "Homebrew already installed" + else + info "Installing Homebrew..." + /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" + + # Add to PATH for current session + if [[ -f /opt/homebrew/bin/brew ]]; then + eval "$(/opt/homebrew/bin/brew shellenv)" + elif [[ -f /usr/local/bin/brew ]]; then + eval "$(/usr/local/bin/brew shellenv)" + fi + + success "Homebrew installed" + fi +} + +####################################### +# Install dependencies +####################################### +install_dependencies() { + info "Installing dependencies..." + + if [[ "$OS" == "mac" ]]; then + # Node.js + if ! has_command node; then + info "Installing Node.js..." + brew install node + fi + success "Node.js $(node --version)" + + # Python 3.12 + if ! has_command python3.12; then + info "Installing Python 3.12..." + brew install python@3.12 + fi + success "Python $(python3.12 --version)" + + # Git + if ! has_command git; then + info "Installing Git..." + brew install git + fi + success "Git $(git --version | head -1)" + + elif [[ "$OS" == "wsl" ]] || [[ "$OS" == "linux" ]]; then + info "Updating apt packages..." + sudo apt update && sudo apt upgrade -y + + # Node.js 20 + if ! has_command node; then + info "Installing Node.js..." + curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - + sudo apt install -y nodejs + fi + success "Node.js $(node --version)" + + # Python 3.12 + if ! has_command python3.12; then + info "Installing Python 3.12..." + sudo apt install -y software-properties-common + sudo add-apt-repository -y ppa:deadsnakes/ppa + sudo apt update + sudo apt install -y python3.12 python3.12-venv python3.12-dev + fi + success "Python $(python3.12 --version)" + + # Git + if ! has_command git; then + info "Installing Git..." + sudo apt install -y git curl wget + fi + success "Git $(git --version | head -1)" + fi +} + +####################################### +# Install uv (Python package manager) +####################################### +install_uv() { + if has_command uv; then + success "uv already installed: $(uv --version)" + else + info "Installing uv..." + curl -LsSf https://astral.sh/uv/install.sh | sh + + # Add to PATH for current session + export PATH="$HOME/.local/bin:$PATH" + + success "uv installed: $(uv --version)" + fi +} + +####################################### +# Install Claude Code CLI +####################################### +install_claude() { + if has_command claude; then + success "Claude Code already installed: $(claude --version)" + else + info "Installing Claude Code CLI..." + npm install -g @anthropic-ai/claude-code + success "Claude Code installed" + fi +} + +####################################### +# Clone repository +####################################### +clone_repo() { + if [[ -d "$INSTALL_DIR" ]]; then + warn "Directory $INSTALL_DIR already exists" + read -p "Overwrite? (y/n): " -n 1 -r < /dev/tty + echo + if [[ $REPLY =~ ^[Yy]$ ]]; then + rm -rf "$INSTALL_DIR" + else + error "Installation cancelled" + fi + fi + + info "Cloning repository..." + git clone "$REPO_URL" "$INSTALL_DIR" + success "Repository cloned to $INSTALL_DIR" +} + +####################################### +# Prompt for token +####################################### +prompt_token() { + local name="$1" + local desc="$2" + local url="$3" + local var_name="$4" + local optional="${5:-false}" + + echo + echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}" + echo -e "${YELLOW}$name${NC}" + echo "$desc" + echo -e "Get it here: ${GREEN}$url${NC}" + echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}" + + if [[ "$optional" == "true" ]]; then + read -p "Enter token (or press Enter to skip): " token < /dev/tty + else + while true; do + read -p "Enter token: " token < /dev/tty + if [[ -n "$token" ]]; then + break + fi + warn "This token is required" + done + fi + + eval "$var_name=\"$token\"" +} + +####################################### +# Collect tokens interactively +####################################### +collect_tokens() { + echo + echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}" + echo -e "${GREEN}║ TOKEN CONFIGURATION ║${NC}" + echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}" + echo + echo "You'll need to provide 4 tokens. Instructions for each below." + + # Telegram Bot Token + prompt_token \ + "1/4: Telegram Bot Token" \ + "Create a bot via @BotFather in Telegram: +1. Open Telegram and search for @BotFather +2. Send /newbot +3. Follow instructions to create your bot +4. Copy the token (looks like: 7123456789:AAHd...)" \ + "https://t.me/BotFather" \ + "TELEGRAM_BOT_TOKEN" + + # Telegram User ID + prompt_token \ + "2/4: Your Telegram User ID" \ + "Get your ID via @userinfobot: +1. Search for @userinfobot in Telegram +2. Send any message +3. Copy your ID (just the number)" \ + "https://t.me/userinfobot" \ + "TELEGRAM_USER_ID" + + # Deepgram API Key + prompt_token \ + "3/4: Deepgram API Key" \ + "For voice transcription (free \$200 credit): +1. Sign up at console.deepgram.com +2. Go to Settings → API Keys +3. Create new key and copy it" \ + "https://console.deepgram.com/" \ + "DEEPGRAM_API_KEY" + + # Todoist API Token (optional) + prompt_token \ + "4/4: Todoist API Token (optional)" \ + "For task management: +1. Log in to todoist.com +2. Settings → Integrations → Developer +3. Copy the API token" \ + "https://todoist.com/app/settings/integrations/developer" \ + "TODOIST_API_KEY" \ + "true" +} + +####################################### +# Create .env file +####################################### +create_env() { + info "Creating .env file..." + + cat > "$INSTALL_DIR/.env" << EOF +# Telegram Bot Token (from @BotFather) +TELEGRAM_BOT_TOKEN=$TELEGRAM_BOT_TOKEN + +# Deepgram API Key (from console.deepgram.com) +DEEPGRAM_API_KEY=$DEEPGRAM_API_KEY + +# Todoist API Token (optional) +TODOIST_API_KEY=$TODOIST_API_KEY + +# Path to vault (don't change) +VAULT_PATH=./vault + +# Your Telegram ID (bot responds only to you) +ALLOWED_USER_IDS=[$TELEGRAM_USER_ID] +EOF + + success ".env file created" +} + +####################################### +# Install Python dependencies +####################################### +install_python_deps() { + info "Installing Python dependencies..." + cd "$INSTALL_DIR" + uv sync + success "Python dependencies installed" +} + +####################################### +# Install mcp-cli +####################################### +install_mcp_cli() { + if has_command mcp-cli; then + success "mcp-cli already installed" + else + info "Installing mcp-cli..." + curl -fsSL https://raw.githubusercontent.com/philschmid/mcp-cli/main/install.sh | bash + export PATH="$HOME/.local/bin:$PATH" + success "mcp-cli installed" + fi + + # Configure mcp-cli for Todoist if token provided + if [[ -n "$TODOIST_API_KEY" ]]; then + info "Configuring mcp-cli for Todoist..." + mkdir -p ~/.config/mcp + cat > ~/.config/mcp/mcp_servers.json << EOF +{ + "mcpServers": { + "todoist": { + "command": "npx", + "args": ["-y", "@doist/todoist-ai"], + "env": { + "TODOIST_API_KEY": "$TODOIST_API_KEY" + } + } + } +} +EOF + success "mcp-cli configured" + fi +} + +####################################### +# Authenticate Claude +####################################### +auth_claude() { + echo + echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}" + echo -e "${YELLOW}Claude Authentication${NC}" + echo "You need Claude Pro subscription (\$20/month) for this to work." + echo -e "${YELLOW}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}" + echo + + if claude auth status &>/dev/null; then + success "Claude already authenticated" + else + info "Starting Claude authentication..." + echo "A browser window will open. Log in with your Anthropic account." + echo + claude auth login + success "Claude authenticated" + fi +} + +####################################### +# Setup autostart (optional) +####################################### +setup_autostart() { + echo + read -p "Configure autostart (bot runs when computer starts)? (y/n): " -n 1 -r < /dev/tty + echo + + if [[ ! $REPLY =~ ^[Yy]$ ]]; then + info "Skipping autostart configuration" + return + fi + + if [[ "$OS" == "mac" ]]; then + setup_launchd + else + setup_systemd + fi +} + +####################################### +# Setup launchd (Mac) +####################################### +setup_launchd() { + info "Configuring launchd..." + + mkdir -p ~/Library/LaunchAgents + + cat > ~/Library/LaunchAgents/com.agent-second-brain.plist << EOF + + + + + Label + com.agent-second-brain + ProgramArguments + + $HOME/.local/bin/uv + run + python + -m + d_brain + + WorkingDirectory + $INSTALL_DIR + RunAtLoad + + KeepAlive + + StandardOutPath + $INSTALL_DIR/logs/bot.log + StandardErrorPath + $INSTALL_DIR/logs/bot-error.log + + +EOF + + mkdir -p "$INSTALL_DIR/logs" + launchctl load ~/Library/LaunchAgents/com.agent-second-brain.plist + + success "Autostart configured (launchd)" + info "Bot will start automatically on login" +} + +####################################### +# Setup systemd (Linux/WSL) +####################################### +setup_systemd() { + info "Configuring systemd..." + + mkdir -p ~/.config/systemd/user + + cat > ~/.config/systemd/user/agent-second-brain.service << EOF +[Unit] +Description=Agent Second Brain Telegram Bot +After=network.target + +[Service] +Type=simple +WorkingDirectory=$INSTALL_DIR +ExecStart=$HOME/.local/bin/uv run python -m d_brain +Restart=always +RestartSec=10 +Environment=PYTHONUNBUFFERED=1 + +[Install] +WantedBy=default.target +EOF + + systemctl --user daemon-reload + systemctl --user enable agent-second-brain + systemctl --user start agent-second-brain + + success "Autostart configured (systemd)" + info "Bot is running now and will start on boot" +} + +####################################### +# Start bot manually +####################################### +start_bot() { + echo + echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}" + echo -e "${GREEN}║ INSTALLATION COMPLETE! ║${NC}" + echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}" + echo + + if [[ "$OS" == "mac" ]] && [[ -f ~/Library/LaunchAgents/com.agent-second-brain.plist ]]; then + echo "Bot is running in background." + echo + echo "Commands:" + echo " Stop: launchctl unload ~/Library/LaunchAgents/com.agent-second-brain.plist" + echo " Start: launchctl load ~/Library/LaunchAgents/com.agent-second-brain.plist" + echo " Logs: tail -f $INSTALL_DIR/logs/bot.log" + elif systemctl --user is-active --quiet agent-second-brain 2>/dev/null; then + echo "Bot is running in background." + echo + echo "Commands:" + echo " Stop: systemctl --user stop agent-second-brain" + echo " Start: systemctl --user start agent-second-brain" + echo " Logs: journalctl --user -u agent-second-brain -f" + else + echo "To start the bot manually:" + echo + echo -e " ${GREEN}cd $INSTALL_DIR && uv run python -m d_brain${NC}" + echo + read -p "Start bot now? (y/n): " -n 1 -r < /dev/tty + echo + if [[ $REPLY =~ ^[Yy]$ ]]; then + cd "$INSTALL_DIR" + info "Starting bot... (Ctrl+C to stop)" + uv run python -m d_brain + fi + fi +} + +####################################### +# Main +####################################### +main() { + echo + echo -e "${GREEN}╔════════════════════════════════════════════════╗${NC}" + echo -e "${GREEN}║ AGENT SECOND BRAIN INSTALLER ║${NC}" + echo -e "${GREEN}║ ║${NC}" + echo -e "${GREEN}║ Voice-first AI assistant with memory ║${NC}" + echo -e "${GREEN}╚════════════════════════════════════════════════╝${NC}" + echo + + detect_os + install_homebrew + install_dependencies + install_uv + install_claude + clone_repo + collect_tokens + create_env + install_python_deps + install_mcp_cli + auth_claude + setup_autostart + start_bot +} + +main "$@" diff --git a/mcp-config.json b/mcp-config.json new file mode 100644 index 0000000..24fe555 --- /dev/null +++ b/mcp-config.json @@ -0,0 +1,9 @@ +{ + "mcpServers": { + "todoist": { + "type": "stdio", + "command": "npx", + "args": ["-y", "@doist/todoist-ai"] + } + } +} diff --git a/pyproject.toml b/pyproject.toml new file mode 100644 index 0000000..769bb76 --- /dev/null +++ b/pyproject.toml @@ -0,0 +1,52 @@ +[project] +name = "agent-second-brain" +version = "1.0.0" +description = "Voice-first personal assistant for Telegram with Obsidian and Todoist integration" +readme = "README.md" +authors = [ + { name = "smixs", email = "mixshima@gmail.com" } +] +requires-python = ">=3.12" +dependencies = [ + "aiogram>=3.0", + "deepgram-sdk", + "httpx", + "pydantic>=2.0", + "pydantic-settings", + "todoist-api-python>=3.1.0", +] + +[project.optional-dependencies] +dev = [ + "pytest", + "pytest-asyncio", + "ruff", + "mypy", +] + +[build-system] +requires = ["uv_build>=0.9.7,<0.10.0"] +build-backend = "uv_build" + +[tool.uv.build-backend] +module-name = "d_brain" + +[tool.ruff] +line-length = 88 +target-version = "py312" + +[tool.ruff.lint] +select = ["E", "F", "I", "B", "UP"] + +[tool.mypy] +python_version = "3.12" +strict = true + +[tool.pytest.ini_options] +asyncio_mode = "auto" + +[dependency-groups] +dev = [ + "pytest>=9.0.2", + "pytest-asyncio>=1.3.0", +] diff --git a/scripts/process.sh b/scripts/process.sh new file mode 100755 index 0000000..5bf8fb5 --- /dev/null +++ b/scripts/process.sh @@ -0,0 +1,213 @@ +#!/bin/bash +set -e + +# PATH for systemd (claude, uv, npx, node) +export PATH="$HOME/.local/bin:$HOME/.nvm/versions/node/$(ls "$HOME/.nvm/versions/node/" 2>/dev/null | tail -1)/bin:/usr/local/bin:/usr/bin:/bin:$PATH" + +# Paths — auto-detect from script location +PROJECT_DIR="$(cd "$(dirname "$0")/.." && pwd)" +VAULT_DIR="$PROJECT_DIR/vault" +ENV_FILE="$PROJECT_DIR/.env" + +# Load environment variables +if [ -f "$ENV_FILE" ]; then + export $(grep -v '^#' "$ENV_FILE" | xargs) +fi + +# Check token +if [ -z "$TELEGRAM_BOT_TOKEN" ]; then + echo "ERROR: TELEGRAM_BOT_TOKEN not set" + exit 1 +fi + +# Timezone (configure in .env: TZ=Your/Timezone) +export TZ="${TZ:-UTC}" + +# Date and chat_id +TODAY=$(date +%Y-%m-%d) +CHAT_ID="${ALLOWED_USER_IDS//[\[\]]/}" # remove brackets from [123456] + +echo "=== d-brain processing for $TODAY ===" + +# ── ORIENT PHASE: pre-flight checks ── +DAILY_FILE="$VAULT_DIR/daily/$TODAY.md" +HANDOFF_FILE="$VAULT_DIR/.session/handoff.md" +GRAPH_FILE="$VAULT_DIR/.graph/vault-graph.json" + +# Check daily file exists and has content +if [ ! -f "$DAILY_FILE" ]; then + echo "ORIENT: daily/$TODAY.md not found — creating empty file" + echo "# $TODAY" > "$DAILY_FILE" +fi + +DAILY_SIZE=$(wc -c < "$DAILY_FILE" 2>/dev/null || echo "0") +if [ "$DAILY_SIZE" -lt 50 ]; then + echo "ORIENT: daily/$TODAY.md is empty ($DAILY_SIZE bytes) — skipping Claude processing" + echo "ORIENT: Running graph rebuild only" + + # Still rebuild graph and commit + cd "$VAULT_DIR" + uv run .claude/skills/graph-builder/scripts/analyze.py || echo "Graph rebuild failed (non-critical)" + cd "$PROJECT_DIR" + + git add -A + git commit -m "chore: process daily $TODAY" || true + git push || true + echo "=== Done (empty daily, graph-only) ===" + exit 0 +fi + +# Check handoff exists +if [ ! -f "$HANDOFF_FILE" ]; then + echo "ORIENT: handoff.md not found — creating stub" + mkdir -p "$VAULT_DIR/.session" + echo -e "---\nupdated: $(date -Iseconds)\n---\n\n## Last Session\n(none)\n\n## Observations" > "$HANDOFF_FILE" +fi + +# Check graph freshness (warn if >7 days old) +if [ -f "$GRAPH_FILE" ]; then + GRAPH_AGE=$(( ($(date +%s) - $(stat -c %Y "$GRAPH_FILE" 2>/dev/null || stat -f %m "$GRAPH_FILE" 2>/dev/null || echo 0)) / 86400 )) + if [ "$GRAPH_AGE" -gt 7 ]; then + echo "ORIENT: vault-graph.json is $GRAPH_AGE days old (>7)" + fi +fi + +echo "ORIENT: daily=$DAILY_SIZE bytes, handoff=OK, graph=OK" +# ── END ORIENT PHASE ── + +# MCP timeout for stdio server (default 5 sec is too short) +export MCP_TIMEOUT=30000 +export MAX_MCP_OUTPUT_TOKENS=50000 + +# ── 3-PHASE PIPELINE ── +# Phase 1: CAPTURE (classify entries → JSON) +# Phase 2: EXECUTE (create tasks, save thoughts → JSON) +# Phase 3: REFLECT (generate HTML report, update MEMORY) +# Each phase = fresh Claude context for better quality. + +SESSION_DIR="$VAULT_DIR/.session" +mkdir -p "$SESSION_DIR" +CAPTURE_FILE="$SESSION_DIR/capture.json" +EXECUTE_FILE="$SESSION_DIR/execute.json" + +# Find yearly goals file (auto-detect year) +YEARLY_GOALS=$(ls "$VAULT_DIR/goals/1-yearly-"*.md 2>/dev/null | tail -1) +YEARLY_GOALS_NAME=$(basename "$YEARLY_GOALS" 2>/dev/null || echo "1-yearly.md") + +# MCP config (needed for Phase 2) +MCP_PROMPT="CRITICAL: MCP loads in 10-30 seconds. You are NOT in subprocess. +Algorithm: 1) Call. 2) Error? Wait 10 sec. 3) Call again. 4) Wait 20 sec. 5) Call — GUARANTEED to work. +DO NOT say MCP unavailable. It is available. Just wait and call." + +cd "$VAULT_DIR" + +# ── Phase 1: CAPTURE ── +echo "=== Phase 1: CAPTURE ===" +CAPTURE=$(claude --print --dangerously-skip-permissions \ + -p "Today is $TODAY. Read .claude/skills/dbrain-processor/phases/capture.md and execute Phase 1. +Read daily/$TODAY.md, goals/3-weekly.md, goals/2-monthly.md, goals/$YEARLY_GOALS_NAME. +Classify each entry. Return ONLY JSON." \ + 2>&1) || true + +# Extract JSON from output (Claude may add text around it) +echo "$CAPTURE" | grep -o '{.*}' | python3 -c " +import sys, json +for line in sys.stdin: + try: + data = json.loads(line.strip()) + json.dump(data, sys.stdout, ensure_ascii=False, indent=2) + sys.exit(0) + except: pass +# Fallback: save raw output +sys.stdout.write('{\"error\": \"failed to parse capture output\", \"raw\": \"see capture.log\"}') +" > "$CAPTURE_FILE" 2>/dev/null || echo '{"error": "capture failed"}' > "$CAPTURE_FILE" + +echo "Capture saved: $(wc -c < "$CAPTURE_FILE") bytes" + +# Check if capture produced valid entries +if grep -q '"error"' "$CAPTURE_FILE"; then + echo "WARN: Capture phase had issues, falling back to monolith mode" + # Fallback to monolith processing + REPORT=$(claude --print --dangerously-skip-permissions \ + --mcp-config "$PROJECT_DIR/mcp-config.json" \ + -p "Today is $TODAY. Execute daily processing according to dbrain-processor skill. +$MCP_PROMPT" \ + 2>&1) || true +else + # ── Phase 2: EXECUTE ── + echo "=== Phase 2: EXECUTE ===" + EXECUTE=$(claude --print --dangerously-skip-permissions \ + --mcp-config "$PROJECT_DIR/mcp-config.json" \ + -p "Today is $TODAY. Read .claude/skills/dbrain-processor/phases/execute.md and execute Phase 2. +Read .session/capture.json for input data. +Read business/_index.md and projects/_index.md for context. +Create tasks in Todoist, save thoughts, update CRM. Return ONLY JSON. +$MCP_PROMPT" \ + 2>&1) || true + + echo "$EXECUTE" | grep -o '{.*}' | python3 -c " +import sys, json +for line in sys.stdin: + try: + data = json.loads(line.strip()) + json.dump(data, sys.stdout, ensure_ascii=False, indent=2) + sys.exit(0) + except: pass +sys.stdout.write('{\"error\": \"failed to parse execute output\"}') +" > "$EXECUTE_FILE" 2>/dev/null || echo '{"error": "execute failed"}' > "$EXECUTE_FILE" + + echo "Execute saved: $(wc -c < "$EXECUTE_FILE") bytes" + + # ── Phase 3: REFLECT ── + echo "=== Phase 3: REFLECT ===" + REPORT=$(claude --print --dangerously-skip-permissions \ + -p "Today is $TODAY. Read .claude/skills/dbrain-processor/phases/reflect.md and execute Phase 3. +Read .session/capture.json and .session/execute.json for input data. +Read MEMORY.md, .session/handoff.md, .graph/health-history.json. +Generate HTML report, update MEMORY, record observations. +Return ONLY RAW HTML (for Telegram)." \ + 2>&1) || true +fi + +cd "$PROJECT_DIR" + +echo "=== Claude output ===" +echo "$REPORT" +echo "====================" + +# Remove HTML comments (break Telegram HTML parser) +REPORT_CLEAN=$(echo "$REPORT" | sed '//d') + +# Rebuild vault graph (keeps structure up to date) +echo "=== Rebuilding vault graph ===" +cd "$VAULT_DIR" +uv run .claude/skills/graph-builder/scripts/analyze.py || echo "Graph rebuild failed (non-critical)" + +# Memory decay (update relevance scores and tiers) +echo "=== Memory decay ===" +uv run .claude/skills/agent-memory/scripts/memory-engine.py decay . || echo "Memory decay failed (non-critical)" +cd "$PROJECT_DIR" + +# Git commit +git add -A +git commit -m "chore: process daily $TODAY" || true +git push || true + +# Send to Telegram +if [ -n "$REPORT_CLEAN" ] && [ -n "$CHAT_ID" ]; then + echo "=== Sending to Telegram ===" + RESULT=$(curl -s -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage" \ + -d "chat_id=$CHAT_ID" \ + -d "text=$REPORT_CLEAN" \ + -d "parse_mode=HTML") + + # If HTML failed, send without formatting + if echo "$RESULT" | grep -q '"ok":false'; then + echo "HTML failed: $RESULT" + curl -s -X POST "https://api.telegram.org/bot$TELEGRAM_BOT_TOKEN/sendMessage" \ + -d "chat_id=$CHAT_ID" \ + -d "text=$REPORT_CLEAN" + fi +fi + +echo "=== Done ===" diff --git a/scripts/weekly.py b/scripts/weekly.py new file mode 100644 index 0000000..2b128d3 --- /dev/null +++ b/scripts/weekly.py @@ -0,0 +1,69 @@ +#!/usr/bin/env python +"""Weekly digest script - generates and sends to Telegram.""" + +import asyncio +import logging +import sys +from pathlib import Path + +# Add project root to path +sys.path.insert(0, str(Path(__file__).parent.parent / "src")) + +from aiogram import Bot +from aiogram.client.default import DefaultBotProperties +from aiogram.enums import ParseMode + +from d_brain.config import get_settings +from d_brain.services.git import VaultGit +from d_brain.services.processor import ClaudeProcessor + +logging.basicConfig( + level=logging.INFO, + format="%(asctime)s - %(name)s - %(levelname)s - %(message)s", +) +logger = logging.getLogger(__name__) + + +async def main() -> None: + """Generate weekly digest and send to Telegram.""" + settings = get_settings() + processor = ClaudeProcessor(settings.vault_path, settings.todoist_api_key) + git = VaultGit(settings.vault_path) + + logger.info("Starting weekly digest generation...") + + result = processor.generate_weekly() + + if "error" in result: + report = f"Error: {result['error']}" + logger.error("Weekly digest failed: %s", result["error"]) + else: + report = result.get("report", "No output") + logger.info("Weekly digest generated successfully") + # Commit any changes + git.commit_and_push("chore: weekly digest") + + # Send to Telegram + bot = Bot( + token=settings.telegram_bot_token, + default=DefaultBotProperties(parse_mode=ParseMode.HTML), + ) + try: + user_id = settings.allowed_user_ids[0] if settings.allowed_user_ids else None + if not user_id: + logger.error("No allowed user IDs configured") + return + + try: + await bot.send_message(chat_id=user_id, text=report) + except Exception: + # Fallback: send without HTML parsing + await bot.send_message(chat_id=user_id, text=report, parse_mode=None) + + logger.info("Weekly digest sent to user %s", user_id) + finally: + await bot.session.close() + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/setup.sh b/setup.sh new file mode 100755 index 0000000..22a9c6e --- /dev/null +++ b/setup.sh @@ -0,0 +1,641 @@ +#!/bin/bash + +# ============================================================================= +# Agent Second Brain - VPS Setup Script +# ============================================================================= +# One-command setup for your personal AI assistant +# Usage: curl -fsSL https://raw.githubusercontent.com/YOUR_USER/agent-second-brain/main/setup.sh | bash +# Or: bash setup.sh +# ============================================================================= + +set -e + +# Colors +RED='\033[0;31m' +GREEN='\033[0;32m' +YELLOW='\033[1;33m' +BLUE='\033[0;34m' +PURPLE='\033[0;35m' +CYAN='\033[0;36m' +NC='\033[0m' # No Color +BOLD='\033[1m' + +# Emojis (safe for most terminals) +CHECK="[OK]" +CROSS="[X]" +WARN="[!]" +ARROW="-->" +GEAR="[*]" + +# ============================================================================= +# Helper functions +# ============================================================================= + +print_banner() { + echo "" + echo -e "${PURPLE}${BOLD}" + echo " ╔═══════════════════════════════════════════════════════════╗" + echo " ║ ║" + echo " ║ AGENT SECOND BRAIN - VPS SETUP ║" + echo " ║ ║" + echo " ║ Personal AI Assistant with Long-term Memory ║" + echo " ║ ║" + echo " ╚═══════════════════════════════════════════════════════════╝" + echo -e "${NC}" + echo "" +} + +info() { + echo -e "${BLUE}${GEAR}${NC} $1" +} + +success() { + echo -e "${GREEN}${CHECK}${NC} $1" +} + +warn() { + echo -e "${YELLOW}${WARN}${NC} $1" +} + +error() { + echo -e "${RED}${CROSS}${NC} $1" +} + +step() { + echo "" + echo -e "${CYAN}${BOLD}${ARROW} $1${NC}" + echo -e "${CYAN}$(printf '%.0s─' {1..60})${NC}" +} + +ask() { + echo -e "${YELLOW}?${NC} $1" +} + +# ============================================================================= +# Validation functions +# ============================================================================= + +validate_telegram_token() { + local token="$1" + # Telegram bot token format: 123456789:ABC-DEF1234ghIkl-zyx57W2v1u123ew11 + if [[ $token =~ ^[0-9]+:[A-Za-z0-9_-]+$ ]]; then + return 0 + fi + return 1 +} + +validate_telegram_id() { + local id="$1" + # Telegram ID is a positive integer + if [[ $id =~ ^[0-9]+$ ]] && [ "$id" -gt 0 ]; then + return 0 + fi + return 1 +} + +validate_deepgram_key() { + local key="$1" + # Deepgram key is alphanumeric, typically 40+ chars + if [[ $key =~ ^[A-Za-z0-9]+$ ]] && [ ${#key} -ge 20 ]; then + return 0 + fi + return 1 +} + +validate_todoist_key() { + local key="$1" + # Todoist API token is alphanumeric, 40 chars + if [[ $key =~ ^[A-Za-z0-9]+$ ]] && [ ${#key} -ge 30 ]; then + return 0 + fi + return 1 +} + +# ============================================================================= +# Check functions +# ============================================================================= + +check_root() { + if [ "$EUID" -eq 0 ]; then + error "Do not run this script as root!" + echo " Create a regular user first: adduser myuser && usermod -aG sudo myuser" + echo " Then run: su - myuser && bash setup.sh" + exit 1 + fi +} + +check_os() { + if [ -f /etc/os-release ]; then + . /etc/os-release + if [[ "$ID" != "ubuntu" && "$ID" != "debian" ]]; then + warn "This script is tested on Ubuntu/Debian. You're running: $ID" + read -p "Continue anyway? (y/N): " -r REPLY + if [[ ! $REPLY =~ ^[Yy]$ ]]; then + exit 1 + fi + fi + fi +} + +check_command() { + command -v "$1" &> /dev/null +} + +# ============================================================================= +# Installation functions +# ============================================================================= + +install_system_deps() { + step "Installing system dependencies" + + info "Updating package list..." + sudo apt-get update -qq + + info "Installing git, curl, wget, build-essential..." + sudo apt-get install -y -qq git curl wget build-essential software-properties-common + + success "System dependencies installed" +} + +install_python() { + step "Installing Python 3.12" + + if check_command python3.12; then + success "Python 3.12 already installed" + return + fi + + info "Adding deadsnakes PPA..." + sudo add-apt-repository -y ppa:deadsnakes/ppa + sudo apt-get update -qq + + info "Installing Python 3.12..." + sudo apt-get install -y -qq python3.12 python3.12-venv python3.12-dev + + success "Python 3.12 installed" +} + +install_uv() { + step "Installing uv (Python package manager)" + + if check_command uv; then + success "uv already installed" + return + fi + + info "Downloading and installing uv..." + curl -LsSf https://astral.sh/uv/install.sh | sh + + # Add to current session + export PATH="$HOME/.local/bin:$PATH" + + # Add to .bashrc if not already there + if ! grep -q 'export PATH="$HOME/.local/bin:$PATH"' ~/.bashrc 2>/dev/null; then + echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc + fi + + success "uv installed" +} + +install_nodejs() { + step "Installing Node.js 20" + + if check_command node; then + NODE_VERSION=$(node --version | cut -d'v' -f2 | cut -d'.' -f1) + if [ "$NODE_VERSION" -ge 18 ]; then + success "Node.js $(node --version) already installed" + return + fi + fi + + info "Adding NodeSource repository..." + curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - + + info "Installing Node.js..." + sudo apt-get install -y -qq nodejs + + success "Node.js $(node --version) installed" +} + +install_claude_cli() { + step "Installing Claude CLI" + + if check_command claude; then + success "Claude CLI already installed: $(claude --version 2>/dev/null || echo 'version unknown')" + return + fi + + info "Installing @anthropic-ai/claude-code globally..." + sudo npm install -g @anthropic-ai/claude-code + + success "Claude CLI installed" +} + +# ============================================================================= +# Configuration functions +# ============================================================================= + +clone_repository() { + step "Setting up project" + + PROJECTS_DIR="$HOME/projects" + PROJECT_DIR="$PROJECTS_DIR/agent-second-brain" + + mkdir -p "$PROJECTS_DIR" + + if [ -d "$PROJECT_DIR" ]; then + warn "Project directory already exists: $PROJECT_DIR" + read -p "Remove and re-clone? (y/N): " -r REPLY + if [[ $REPLY =~ ^[Yy]$ ]]; then + rm -rf "$PROJECT_DIR" + else + cd "$PROJECT_DIR" + success "Using existing directory" + return + fi + fi + + ask "Enter your GitHub username (the one where you forked the repo):" + read -r GITHUB_USER + + if [ -z "$GITHUB_USER" ]; then + error "GitHub username cannot be empty" + exit 1 + fi + + REPO_URL="https://github.com/$GITHUB_USER/agent-second-brain.git" + + info "Cloning from $REPO_URL..." + + if ! git clone "$REPO_URL" "$PROJECT_DIR" 2>/dev/null; then + error "Failed to clone repository!" + echo " Make sure you've forked the repo and the username is correct" + exit 1 + fi + + cd "$PROJECT_DIR" + success "Repository cloned to $PROJECT_DIR" + + # Save GitHub user for later + echo "$GITHUB_USER" > .github_user +} + +collect_tokens() { + step "Collecting API tokens" + echo "" + echo "You'll need these tokens (get them from the services):" + echo " - Telegram Bot Token (from @BotFather)" + echo " - Your Telegram ID (from @userinfobot)" + echo " - Deepgram API Key (from console.deepgram.com)" + echo " - Todoist API Token (from Todoist Settings > Integrations > Developer)" + echo "" + + # Telegram Bot Token + while true; do + ask "Telegram Bot Token (from @BotFather):" + read -r TELEGRAM_BOT_TOKEN + if validate_telegram_token "$TELEGRAM_BOT_TOKEN"; then + success "Token format valid" + break + else + error "Invalid token format. Should be like: 123456789:ABC-DEF1234ghIkl-zyx57W2v" + fi + done + + # Telegram User ID + while true; do + ask "Your Telegram User ID (from @userinfobot):" + read -r TELEGRAM_USER_ID + if validate_telegram_id "$TELEGRAM_USER_ID"; then + success "User ID valid" + break + else + error "Invalid User ID. Should be a number like: 123456789" + fi + done + + # Deepgram API Key + while true; do + ask "Deepgram API Key (from console.deepgram.com):" + read -r DEEPGRAM_API_KEY + if validate_deepgram_key "$DEEPGRAM_API_KEY"; then + success "API Key format valid" + break + else + error "Invalid API key format. Should be alphanumeric, 20+ characters" + fi + done + + # Todoist API Token + while true; do + ask "Todoist API Token (from Settings > Integrations > Developer):" + read -r TODOIST_API_KEY + if validate_todoist_key "$TODOIST_API_KEY"; then + success "API Token format valid" + break + else + error "Invalid API token format. Should be alphanumeric, 30+ characters" + fi + done +} + +create_env_file() { + step "Creating .env file" + + ENV_FILE="$PROJECT_DIR/.env" + + if [ -f "$ENV_FILE" ]; then + warn ".env file already exists" + read -p "Overwrite? (y/N): " -r REPLY + if [[ ! $REPLY =~ ^[Yy]$ ]]; then + success "Keeping existing .env" + return + fi + fi + + cat > "$ENV_FILE" << EOF +# Telegram Bot API token from @BotFather +TELEGRAM_BOT_TOKEN=$TELEGRAM_BOT_TOKEN + +# Deepgram API key for voice transcription +DEEPGRAM_API_KEY=$DEEPGRAM_API_KEY + +# Todoist API key for task management +TODOIST_API_KEY=$TODOIST_API_KEY + +# Path to Obsidian vault directory +VAULT_PATH=./vault + +# JSON array of Telegram user IDs allowed to use the bot +ALLOWED_USER_IDS=[$TELEGRAM_USER_ID] +EOF + + chmod 600 "$ENV_FILE" + success ".env file created (permissions: 600)" +} + +install_dependencies() { + step "Installing Python dependencies" + + cd "$PROJECT_DIR" + + info "Running uv sync..." + "$HOME/.local/bin/uv" sync + + success "Dependencies installed" +} + +configure_systemd() { + step "Configuring systemd service" + + SERVICE_FILE="/etc/systemd/system/d-brain-bot.service" + SERVICE_NAME="d-brain-bot" + + # Generate service file content + SERVICE_CONTENT="[Unit] +Description=d-brain Telegram Bot +After=network.target + +[Service] +Type=simple +User=$USER +WorkingDirectory=$PROJECT_DIR +ExecStart=$HOME/.local/bin/uv run python -m d_brain +Restart=always +RestartSec=10 +Environment=PYTHONUNBUFFERED=1 + +[Install] +WantedBy=multi-user.target" + + info "Creating systemd service..." + echo "$SERVICE_CONTENT" | sudo tee "$SERVICE_FILE" > /dev/null + + info "Reloading systemd daemon..." + sudo systemctl daemon-reload + + info "Enabling service to start on boot..." + sudo systemctl enable "$SERVICE_NAME" + + info "Starting service..." + sudo systemctl start "$SERVICE_NAME" + + # Wait a moment for service to start + sleep 2 + + success "Systemd service configured" +} + +configure_git_remote() { + step "Configuring Git for push access" + + cd "$PROJECT_DIR" + + # Set git config + git config user.name "Agent Second Brain Bot" + git config user.email "bot@localhost" + + ask "Do you want to configure GitHub push access? (for auto-sync)" + read -p "(y/N): " -r REPLY + + if [[ ! $REPLY =~ ^[Yy]$ ]]; then + warn "Skipping GitHub push configuration" + return + fi + + echo "" + echo "Create a Personal Access Token on GitHub:" + echo " 1. Go to: github.com > Settings > Developer settings > Personal access tokens > Tokens (classic)" + echo " 2. Generate new token with 'repo' scope" + echo " 3. Copy the token" + echo "" + + ask "Enter your GitHub Personal Access Token:" + read -rs GITHUB_TOKEN + echo "" + + if [ -z "$GITHUB_TOKEN" ]; then + warn "No token provided, skipping" + return + fi + + GITHUB_USER=$(cat .github_user 2>/dev/null || echo "") + + if [ -z "$GITHUB_USER" ]; then + ask "Enter your GitHub username:" + read -r GITHUB_USER + fi + + git remote set-url origin "https://$GITHUB_TOKEN@github.com/$GITHUB_USER/agent-second-brain.git" + + success "Git remote configured for push" +} + +# ============================================================================= +# Status and verification +# ============================================================================= + +check_status() { + step "Final status check" + + ERRORS=() + WARNINGS=() + + echo "" + + # Check Python + if check_command python3.12; then + success "Python 3.12: $(python3.12 --version)" + else + ERRORS+=("Python 3.12 not found") + fi + + # Check uv + if check_command uv || [ -f "$HOME/.local/bin/uv" ]; then + success "uv: $($HOME/.local/bin/uv --version 2>/dev/null || uv --version)" + else + ERRORS+=("uv not found") + fi + + # Check Node.js + if check_command node; then + success "Node.js: $(node --version)" + else + ERRORS+=("Node.js not found") + fi + + # Check Claude CLI + if check_command claude; then + success "Claude CLI: installed" + else + WARNINGS+=("Claude CLI not found (needed for AI processing)") + fi + + # Check .env + if [ -f "$PROJECT_DIR/.env" ]; then + success ".env file: exists" + else + ERRORS+=(".env file not found") + fi + + # Check systemd service + if systemctl is-active --quiet d-brain-bot; then + success "Bot service: running" + else + STATUS=$(systemctl is-active d-brain-bot 2>/dev/null || echo "unknown") + ERRORS+=("Bot service not running (status: $STATUS)") + fi + + echo "" + + # Summary + if [ ${#ERRORS[@]} -eq 0 ] && [ ${#WARNINGS[@]} -eq 0 ]; then + echo -e "${GREEN}${BOLD}" + echo " ╔═══════════════════════════════════════════════════════════╗" + echo " ║ ║" + echo " ║ SETUP COMPLETE! ║" + echo " ║ ║" + echo " ╚═══════════════════════════════════════════════════════════╝" + echo -e "${NC}" + echo "" + echo " Next steps:" + echo " 1. Open Telegram and find your bot" + echo " 2. Send /start to test" + echo " 3. Send a voice message!" + echo "" + echo " Useful commands:" + echo " - View logs: sudo journalctl -u d-brain-bot -f" + echo " - Restart bot: sudo systemctl restart d-brain-bot" + echo " - Stop bot: sudo systemctl stop d-brain-bot" + echo "" + else + if [ ${#ERRORS[@]} -gt 0 ]; then + echo -e "${RED}${BOLD}ERRORS:${NC}" + for err in "${ERRORS[@]}"; do + error "$err" + done + echo "" + fi + + if [ ${#WARNINGS[@]} -gt 0 ]; then + echo -e "${YELLOW}${BOLD}WARNINGS:${NC}" + for wrn in "${WARNINGS[@]}"; do + warn "$wrn" + done + echo "" + fi + + echo "Troubleshooting:" + echo " - Check logs: sudo journalctl -u d-brain-bot -n 50" + echo " - Check .env: cat $PROJECT_DIR/.env" + echo " - Manual start: cd $PROJECT_DIR && uv run python -m d_brain" + echo "" + fi +} + +authorize_claude() { + step "Claude CLI Authorization" + + if claude auth status 2>/dev/null | grep -q "Logged in"; then + success "Claude CLI already authorized" + return + fi + + warn "Claude CLI needs authorization" + echo "" + echo "Run this command manually:" + echo -e " ${CYAN}claude auth login${NC}" + echo "" + echo "This will open a browser for authentication." + echo "After authorizing, the bot will be able to use Claude for AI processing." + echo "" +} + +# ============================================================================= +# Main script +# ============================================================================= + +main() { + print_banner + + check_root + check_os + + echo "This script will:" + echo " 1. Install required software (Python, Node.js, uv, Claude CLI)" + echo " 2. Clone your fork of the repository" + echo " 3. Ask for your API tokens" + echo " 4. Create configuration files" + echo " 5. Set up auto-start service" + echo "" + + read -p "Ready to start? (Y/n): " -r REPLY + if [[ $REPLY =~ ^[Nn]$ ]]; then + echo "Setup cancelled." + exit 0 + fi + + # Installation + install_system_deps + install_python + install_uv + install_nodejs + install_claude_cli + + # Configuration + clone_repository + collect_tokens + create_env_file + install_dependencies + configure_systemd + configure_git_remote + authorize_claude + + # Final check + check_status +} + +# Run main if script is executed (not sourced) +if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then + main "$@" +fi diff --git a/src/d_brain/__init__.py b/src/d_brain/__init__.py new file mode 100644 index 0000000..2a373df --- /dev/null +++ b/src/d_brain/__init__.py @@ -0,0 +1,3 @@ +"""d-brain: Voice-first system for capturing thoughts and tasks.""" + +__version__ = "0.1.0" diff --git a/src/d_brain/__main__.py b/src/d_brain/__main__.py new file mode 100644 index 0000000..5fad375 --- /dev/null +++ b/src/d_brain/__main__.py @@ -0,0 +1,28 @@ +"""Entry point for running d-brain as a module.""" + +import asyncio +import logging + +logging.basicConfig( + level=logging.INFO, + format="%(asctime)s - %(name)s - %(levelname)s - %(message)s", +) + +logger = logging.getLogger(__name__) + + +async def main() -> None: + """Main entry point.""" + from d_brain.bot.main import run_bot + from d_brain.config import get_settings + + settings = get_settings() + logger.info("d-brain starting...") + logger.info("Vault path: %s", settings.vault_path) + logger.info("Allowed users: %s", settings.allowed_user_ids or "all") + + await run_bot(settings) + + +if __name__ == "__main__": + asyncio.run(main()) diff --git a/src/d_brain/bot/__init__.py b/src/d_brain/bot/__init__.py new file mode 100644 index 0000000..068a8d9 --- /dev/null +++ b/src/d_brain/bot/__init__.py @@ -0,0 +1 @@ +"""Telegram bot module.""" diff --git a/src/d_brain/bot/formatters.py b/src/d_brain/bot/formatters.py new file mode 100644 index 0000000..298d943 --- /dev/null +++ b/src/d_brain/bot/formatters.py @@ -0,0 +1,202 @@ +"""Report formatters for Telegram messages.""" + +import html +import re +from typing import Any + + +# Allowed HTML tags in Telegram +ALLOWED_TAGS = {"b", "i", "code", "pre", "a", "s", "u"} + + +def sanitize_telegram_html(text: str) -> str: + """Sanitize HTML for Telegram, keeping only allowed tags. + + Telegram supports: , , ,
, , , 
+
+    Args:
+        text: Raw HTML text from Claude
+
+    Returns:
+        Sanitized HTML safe for Telegram
+    """
+    if not text:
+        return ""
+
+    # First, escape any raw < > that are not part of tags
+    # This regex matches < or > not followed/preceded by tag patterns
+    result = []
+    i = 0
+    while i < len(text):
+        if text[i] == "<":
+            # Check if this looks like a valid tag
+            tag_match = re.match(r"]*)?>", text[i:])
+            if tag_match:
+                tag_name = tag_match.group(1).lower()
+                if tag_name in ALLOWED_TAGS:
+                    # Keep the allowed tag
+                    result.append(tag_match.group(0))
+                    i += len(tag_match.group(0))
+                    continue
+                else:
+                    # Escape disallowed tag
+                    result.append("<")
+                    i += 1
+                    continue
+            else:
+                # Not a valid tag pattern, escape
+                result.append("<")
+                i += 1
+                continue
+        elif text[i] == ">":
+            # Standalone > should be escaped
+            result.append(">")
+            i += 1
+        elif text[i] == "&":
+            # Check if already escaped
+            entity_match = re.match(r"&(amp|lt|gt|quot|#\d+|#x[0-9a-fA-F]+);", text[i:])
+            if entity_match:
+                result.append(entity_match.group(0))
+                i += len(entity_match.group(0))
+            else:
+                result.append("&")
+                i += 1
+        else:
+            result.append(text[i])
+            i += 1
+
+    return "".join(result)
+
+
+def validate_telegram_html(text: str) -> bool:
+    """Validate that HTML tags are properly closed.
+
+    Args:
+        text: HTML text to validate
+
+    Returns:
+        True if valid, False otherwise
+    """
+    tag_stack = []
+    tag_pattern = re.compile(r"<(/?)([a-zA-Z]+)(?:\s[^>]*)?>")
+
+    for match in tag_pattern.finditer(text):
+        is_closing = match.group(1) == "/"
+        tag_name = match.group(2).lower()
+
+        if tag_name not in ALLOWED_TAGS:
+            continue
+
+        if is_closing:
+            if not tag_stack or tag_stack[-1] != tag_name:
+                return False
+            tag_stack.pop()
+        else:
+            tag_stack.append(tag_name)
+
+    return len(tag_stack) == 0
+
+
+def truncate_html(text: str, max_length: int = 4096) -> str:
+    """Truncate HTML text while keeping tags balanced.
+
+    Args:
+        text: HTML text
+        max_length: Maximum length (Telegram limit is 4096)
+
+    Returns:
+        Truncated text with balanced tags
+    """
+    if len(text) <= max_length:
+        return text
+
+    # Find a safe cut point
+    cut_point = max_length - 50  # Leave room for closing tags and ellipsis
+
+    # Don't cut in the middle of a tag
+    last_open = text.rfind("<", 0, cut_point)
+    last_close = text.rfind(">", 0, cut_point)
+
+    if last_open > last_close:
+        # We're in the middle of a tag, cut before it
+        cut_point = last_open
+
+    truncated = text[:cut_point]
+
+    # Close any open tags
+    tag_pattern = re.compile(r"<(/?)([a-zA-Z]+)(?:\s[^>]*)?>")
+    open_tags = []
+
+    for match in tag_pattern.finditer(truncated):
+        is_closing = match.group(1) == "/"
+        tag_name = match.group(2).lower()
+
+        if tag_name not in ALLOWED_TAGS:
+            continue
+
+        if is_closing and open_tags and open_tags[-1] == tag_name:
+            open_tags.pop()
+        elif not is_closing:
+            open_tags.append(tag_name)
+
+    # Add closing tags in reverse order
+    closing_tags = "".join(f"" for tag in reversed(open_tags))
+
+    return truncated + "..." + closing_tags
+
+
+def format_process_report(report: dict[str, Any]) -> str:
+    """Format processing report for Telegram HTML.
+
+    The report from Claude is expected to be in HTML format.
+    We sanitize it to ensure only Telegram-safe tags are used.
+
+    Args:
+        report: Processing report from ClaudeProcessor
+
+    Returns:
+        Formatted HTML message for Telegram
+    """
+    if "error" in report:
+        error_msg = html.escape(str(report["error"]))
+        return f"❌ Ошибка: {error_msg}"
+
+    if "report" in report:
+        raw_report = report["report"]
+
+        # Sanitize HTML, keeping allowed tags
+        sanitized = sanitize_telegram_html(raw_report)
+
+        # Validate tag balance
+        if not validate_telegram_html(sanitized):
+            # Fall back to plain text if tags are broken
+            return html.escape(raw_report)
+
+        # Truncate if too long
+        return truncate_html(sanitized, max_length=4096)
+
+    return "✅ Обработка завершена"
+
+
+def format_error(error: str) -> str:
+    """Format error message for Telegram.
+
+    Args:
+        error: Error message
+
+    Returns:
+        Formatted HTML error message
+    """
+    return f"❌ Ошибка: {html.escape(error)}"
+
+
+def format_empty_daily() -> str:
+    """Format message for empty daily file.
+
+    Returns:
+        Formatted HTML message
+    """
+    return (
+        "📭 Нет записей для обработки\n\n"
+        "Добавьте голосовые сообщения или текст в течение дня"
+    )
diff --git a/src/d_brain/bot/handlers/__init__.py b/src/d_brain/bot/handlers/__init__.py
new file mode 100644
index 0000000..334ef9c
--- /dev/null
+++ b/src/d_brain/bot/handlers/__init__.py
@@ -0,0 +1,25 @@
+"""Bot message handlers."""
+
+from d_brain.bot.handlers import (
+    buttons,
+    commands,
+    do,
+    forward,
+    photo,
+    process,
+    text,
+    voice,
+    weekly,
+)
+
+__all__ = [
+    "buttons",
+    "commands",
+    "do",
+    "forward",
+    "photo",
+    "process",
+    "text",
+    "voice",
+    "weekly",
+]
diff --git a/src/d_brain/bot/handlers/buttons.py b/src/d_brain/bot/handlers/buttons.py
new file mode 100644
index 0000000..7106a45
--- /dev/null
+++ b/src/d_brain/bot/handlers/buttons.py
@@ -0,0 +1,51 @@
+"""Button handlers for reply keyboard."""
+
+from aiogram import F, Router
+from aiogram.fsm.context import FSMContext
+from aiogram.types import Message
+
+from d_brain.bot.states import DoCommandState
+
+router = Router(name="buttons")
+
+
+@router.message(F.text == "📊 Статус")
+async def btn_status(message: Message) -> None:
+    """Handle Status button."""
+    from d_brain.bot.handlers.commands import cmd_status
+
+    await cmd_status(message)
+
+
+@router.message(F.text == "⚙️ Обработать")
+async def btn_process(message: Message) -> None:
+    """Handle Process button."""
+    from d_brain.bot.handlers.process import cmd_process
+
+    await cmd_process(message)
+
+
+@router.message(F.text == "📅 Неделя")
+async def btn_weekly(message: Message) -> None:
+    """Handle Weekly button."""
+    from d_brain.bot.handlers.weekly import cmd_weekly
+
+    await cmd_weekly(message)
+
+
+@router.message(F.text == "✨ Запрос")
+async def btn_do(message: Message, state: FSMContext) -> None:
+    """Handle Do button - set state and wait for input."""
+    await state.set_state(DoCommandState.waiting_for_input)
+    await message.answer(
+        "🎯 Что сделать?\n\n"
+        "Отправь голосовое или текстовое сообщение с запросом."
+    )
+
+
+@router.message(F.text == "❓ Помощь")
+async def btn_help(message: Message) -> None:
+    """Handle Help button."""
+    from d_brain.bot.handlers.commands import cmd_help
+
+    await cmd_help(message)
diff --git a/src/d_brain/bot/handlers/commands.py b/src/d_brain/bot/handlers/commands.py
new file mode 100644
index 0000000..d423565
--- /dev/null
+++ b/src/d_brain/bot/handlers/commands.py
@@ -0,0 +1,102 @@
+"""Command handlers for /start, /help, /status."""
+
+from datetime import date
+
+from aiogram import Router
+from aiogram.filters import Command
+from aiogram.types import Message
+
+from d_brain.bot.keyboards import get_main_keyboard
+from d_brain.config import get_settings
+from d_brain.services.session import SessionStore
+from d_brain.services.storage import VaultStorage
+
+router = Router(name="commands")
+
+
+@router.message(Command("start"))
+async def cmd_start(message: Message) -> None:
+    """Handle /start command."""
+    await message.answer(
+        "d-brain - твой голосовой дневник\n\n"
+        "Отправляй мне:\n"
+        "🎤 Голосовые сообщения\n"
+        "💬 Текст\n"
+        "📷 Фото\n"
+        "↩️ Пересланные сообщения\n\n"
+        "Всё будет сохранено и обработано.\n\n"
+        "Команды:\n"
+        "/status - статус сегодняшнего дня\n"
+        "/process - обработать записи\n"
+        "/do - выполнить произвольный запрос\n"
+        "/weekly - недельный дайджест\n"
+        "/help - справка",
+        reply_markup=get_main_keyboard(),
+    )
+
+
+@router.message(Command("help"))
+async def cmd_help(message: Message) -> None:
+    """Handle /help command."""
+    await message.answer(
+        "Как использовать d-brain:\n\n"
+        "1. Отправь голосовое — я транскрибирую и сохраню\n"
+        "2. Отправь текст — сохраню как есть\n"
+        "3. Отправь фото — сохраню в attachments\n"
+        "4. Перешли сообщение — сохраню с источником\n\n"
+        "Вечером используй /process для обработки:\n"
+        "Мысли → Obsidian, Задачи → Todoist\n\n"
+        "Команды:\n"
+        "/status - сколько записей сегодня\n"
+        "/process - обработать записи\n"
+        "/do - выполнить произвольный запрос\n"
+        "/weekly - недельный дайджест\n\n"
+        "Пример: /do перенеси просроченные задачи на понедельник"
+    )
+
+
+@router.message(Command("status"))
+async def cmd_status(message: Message) -> None:
+    """Handle /status command."""
+    user_id = message.from_user.id if message.from_user else 0
+    settings = get_settings()
+    storage = VaultStorage(settings.vault_path)
+
+    # Log command
+    session = SessionStore(settings.vault_path)
+    session.append(user_id, "command", cmd="/status")
+
+    today = date.today()
+    content = storage.read_daily(today)
+
+    if not content:
+        await message.answer(f"📅 {today}\n\nЗаписей пока нет.")
+        return
+
+    lines = content.strip().split("\n")
+    entries = [line for line in lines if line.startswith("## ")]
+
+    voice_count = sum(1 for e in entries if "[voice]" in e)
+    text_count = sum(1 for e in entries if "[text]" in e)
+    photo_count = sum(1 for e in entries if "[photo]" in e)
+    forward_count = sum(1 for e in entries if "[forward from:" in e)
+
+    total = len(entries)
+
+    # Get weekly stats from session
+    week_stats = ""
+    stats = session.get_stats(user_id, days=7)
+    if stats:
+        week_stats = "\n\nЗа 7 дней:"
+        for entry_type, count in sorted(stats.items()):
+            week_stats += f"\n• {entry_type}: {count}"
+
+    await message.answer(
+        f"📅 {today}\n\n"
+        f"Всего записей: {total}\n"
+        f"- 🎤 Голосовых: {voice_count}\n"
+        f"- 💬 Текстовых: {text_count}\n"
+        f"- 📷 Фото: {photo_count}\n"
+        f"- ↩️ Пересланных: {forward_count}"
+        f"{week_stats}"
+    )
diff --git a/src/d_brain/bot/handlers/do.py b/src/d_brain/bot/handlers/do.py
new file mode 100644
index 0000000..bb07208
--- /dev/null
+++ b/src/d_brain/bot/handlers/do.py
@@ -0,0 +1,122 @@
+"""Handler for /do command - arbitrary Claude requests."""
+
+import asyncio
+import logging
+
+from aiogram import Bot, Router
+from aiogram.filters import Command, CommandObject
+from aiogram.fsm.context import FSMContext
+from aiogram.types import Message
+
+from d_brain.bot.formatters import format_process_report
+from d_brain.bot.states import DoCommandState
+from d_brain.config import get_settings
+from d_brain.services.processor import ClaudeProcessor
+from d_brain.services.transcription import DeepgramTranscriber
+
+router = Router(name="do")
+logger = logging.getLogger(__name__)
+
+
+@router.message(Command("do"))
+async def cmd_do(message: Message, command: CommandObject, state: FSMContext) -> None:
+    """Handle /do command."""
+    user_id = message.from_user.id if message.from_user else 0
+
+    # Check for inline text: /do move overdue tasks
+    if command.args:
+        await process_request(message, command.args, user_id)
+        return
+
+    # Otherwise, wait for next message
+    await state.set_state(DoCommandState.waiting_for_input)
+    await message.answer(
+        "🎯 Что сделать?\n\n"
+        "Отправь голосовое или текстовое сообщение с запросом."
+    )
+
+
+@router.message(DoCommandState.waiting_for_input)
+async def handle_do_input(message: Message, bot: Bot, state: FSMContext) -> None:
+    """Handle voice/text input after /do command."""
+    await state.clear()  # Clear state immediately
+
+    prompt = None
+
+    # Handle voice input
+    if message.voice:
+        await message.chat.do(action="typing")
+        settings = get_settings()
+        transcriber = DeepgramTranscriber(settings.deepgram_api_key)
+
+        try:
+            file = await bot.get_file(message.voice.file_id)
+            if not file.file_path:
+                await message.answer("❌ Не удалось скачать голосовое")
+                return
+
+            file_bytes = await bot.download_file(file.file_path)
+            if not file_bytes:
+                await message.answer("❌ Не удалось скачать голосовое")
+                return
+
+            audio_bytes = file_bytes.read()
+            prompt = await transcriber.transcribe(audio_bytes)
+        except Exception as e:
+            logger.exception("Failed to transcribe voice for /do")
+            await message.answer(f"❌ Не удалось транскрибировать: {e}")
+            return
+
+        if not prompt:
+            await message.answer("❌ Не удалось распознать речь")
+            return
+
+        # Echo transcription to user
+        await message.answer(f"🎤 {prompt}")
+
+    # Handle text input
+    elif message.text:
+        prompt = message.text
+
+    else:
+        await message.answer("❌ Отправь текст или голосовое сообщение")
+        return
+
+    user_id = message.from_user.id if message.from_user else 0
+    await process_request(message, prompt, user_id)
+
+
+async def process_request(message: Message, prompt: str, user_id: int = 0) -> None:
+    """Process the user's request with Claude."""
+    status_msg = await message.answer("⏳ Выполняю...")
+
+    settings = get_settings()
+    processor = ClaudeProcessor(settings.vault_path, settings.todoist_api_key)
+
+    async def run_with_progress() -> dict:
+        task = asyncio.create_task(
+            asyncio.to_thread(processor.execute_prompt, prompt, user_id)
+        )
+
+        elapsed = 0
+        while not task.done():
+            await asyncio.sleep(30)
+            elapsed += 30
+            if not task.done():
+                try:
+                    await status_msg.edit_text(
+                        f"⏳ Выполняю... ({elapsed // 60}m {elapsed % 60}s)"
+                    )
+                except Exception:
+                    pass
+
+        return await task
+
+    report = await run_with_progress()
+
+    formatted = format_process_report(report)
+    try:
+        await status_msg.edit_text(formatted)
+    except Exception:
+        # Fallback: send without HTML parsing
+        await status_msg.edit_text(formatted, parse_mode=None)
diff --git a/src/d_brain/bot/handlers/forward.py b/src/d_brain/bot/handlers/forward.py
new file mode 100644
index 0000000..e9320a3
--- /dev/null
+++ b/src/d_brain/bot/handlers/forward.py
@@ -0,0 +1,58 @@
+"""Forwarded message handler."""
+
+import logging
+from datetime import datetime
+
+from aiogram import Router
+from aiogram.types import Message
+
+from d_brain.config import get_settings
+from d_brain.services.session import SessionStore
+from d_brain.services.storage import VaultStorage
+
+router = Router(name="forward")
+logger = logging.getLogger(__name__)
+
+
+@router.message(lambda m: m.forward_origin is not None)
+async def handle_forward(message: Message) -> None:
+    """Handle forwarded messages."""
+    if not message.from_user:
+        return
+
+    settings = get_settings()
+    storage = VaultStorage(settings.vault_path)
+
+    # Determine source name
+    source_name = "Unknown"
+    origin = message.forward_origin
+
+    if hasattr(origin, "sender_user") and origin.sender_user:
+        user = origin.sender_user
+        source_name = user.full_name
+    elif hasattr(origin, "sender_user_name") and origin.sender_user_name:
+        source_name = origin.sender_user_name
+    elif hasattr(origin, "chat") and origin.chat:
+        chat = origin.chat
+        source_name = f"@{chat.username}" if chat.username else chat.title or "Channel"
+    elif hasattr(origin, "sender_name") and origin.sender_name:
+        source_name = origin.sender_name
+
+    content = message.text or message.caption or "[media]"
+    msg_type = f"[forward from: {source_name}]"
+
+    timestamp = datetime.fromtimestamp(message.date.timestamp())
+    storage.append_to_daily(content, timestamp, msg_type)
+
+    # Log to session
+    session = SessionStore(settings.vault_path)
+    session.append(
+        message.from_user.id,
+        "forward",
+        text=content,
+        source=source_name,
+        msg_id=message.message_id,
+    )
+
+    await message.answer(f"✓ Сохранено (от {source_name})")
+    logger.info("Forwarded message saved from: %s", source_name)
diff --git a/src/d_brain/bot/handlers/photo.py b/src/d_brain/bot/handlers/photo.py
new file mode 100644
index 0000000..9d75c85
--- /dev/null
+++ b/src/d_brain/bot/handlers/photo.py
@@ -0,0 +1,78 @@
+"""Photo message handler."""
+
+import logging
+from datetime import datetime
+
+from aiogram import Bot, Router
+from aiogram.types import Message
+
+from d_brain.config import get_settings
+from d_brain.services.session import SessionStore
+from d_brain.services.storage import VaultStorage
+
+router = Router(name="photo")
+logger = logging.getLogger(__name__)
+
+
+@router.message(lambda m: m.photo is not None)
+async def handle_photo(message: Message, bot: Bot) -> None:
+    """Handle photo messages."""
+    if not message.photo or not message.from_user:
+        return
+
+    settings = get_settings()
+    storage = VaultStorage(settings.vault_path)
+
+    # Get largest photo
+    photo = message.photo[-1]
+
+    try:
+        file = await bot.get_file(photo.file_id)
+        if not file.file_path:
+            await message.answer("Failed to download photo")
+            return
+
+        file_bytes = await bot.download_file(file.file_path)
+        if not file_bytes:
+            await message.answer("Failed to download photo")
+            return
+
+        timestamp = datetime.fromtimestamp(message.date.timestamp())
+        photo_bytes = file_bytes.read()
+
+        # Determine extension from file path
+        extension = "jpg"
+        if file.file_path and "." in file.file_path:
+            extension = file.file_path.rsplit(".", 1)[-1]
+
+        # Save photo and get relative path
+        relative_path = storage.save_attachment(
+            photo_bytes,
+            timestamp.date(),
+            timestamp,
+            extension,
+        )
+
+        # Create content with Obsidian embed
+        content = f"![[{relative_path}]]"
+        if message.caption:
+            content += f"\n\n{message.caption}"
+
+        storage.append_to_daily(content, timestamp, "[photo]")
+
+        # Log to session
+        session = SessionStore(settings.vault_path)
+        session.append(
+            message.from_user.id,
+            "photo",
+            path=relative_path,
+            caption=message.caption,
+            msg_id=message.message_id,
+        )
+
+        await message.answer("📷 ✓ Сохранено")
+        logger.info("Photo saved: %s", relative_path)
+
+    except Exception as e:
+        logger.exception("Error processing photo")
+        await message.answer(f"Error: {e}")
diff --git a/src/d_brain/bot/handlers/process.py b/src/d_brain/bot/handlers/process.py
new file mode 100644
index 0000000..d3d12cc
--- /dev/null
+++ b/src/d_brain/bot/handlers/process.py
@@ -0,0 +1,65 @@
+"""Process command handler."""
+
+import asyncio
+import logging
+from datetime import date
+
+from aiogram import Router
+from aiogram.filters import Command
+from aiogram.types import Message
+
+from d_brain.bot.formatters import format_process_report
+from d_brain.config import get_settings
+from d_brain.services.git import VaultGit
+from d_brain.services.processor import ClaudeProcessor
+
+router = Router(name="process")
+logger = logging.getLogger(__name__)
+
+
+@router.message(Command("process"))
+async def cmd_process(message: Message) -> None:
+    """Handle /process command - trigger Claude processing."""
+    user_id = message.from_user.id if message.from_user else "unknown"
+    logger.info("Process command triggered by user %s", user_id)
+
+    status_msg = await message.answer("⏳ Processing... (may take up to 10 min)")
+
+    settings = get_settings()
+    processor = ClaudeProcessor(settings.vault_path, settings.todoist_api_key)
+    git = VaultGit(settings.vault_path)
+
+    # Run subprocess in thread to avoid blocking event loop
+    async def process_with_progress() -> dict:
+        task = asyncio.create_task(
+            asyncio.to_thread(processor.process_daily, date.today())
+        )
+
+        elapsed = 0
+        while not task.done():
+            await asyncio.sleep(30)
+            elapsed += 30
+            if not task.done():
+                try:
+                    await status_msg.edit_text(
+                        f"⏳ Processing... ({elapsed // 60}m {elapsed % 60}s)"
+                    )
+                except Exception:
+                    pass  # Ignore edit errors
+
+        return await task
+
+    report = await process_with_progress()
+
+    # Commit and push changes
+    if "error" not in report:
+        today = date.today().isoformat()
+        await asyncio.to_thread(git.commit_and_push, f"chore: process daily {today}")
+
+    # Format and send report
+    formatted = format_process_report(report)
+    try:
+        await status_msg.edit_text(formatted)
+    except Exception:
+        # Fallback: send without HTML parsing
+        await status_msg.edit_text(formatted, parse_mode=None)
diff --git a/src/d_brain/bot/handlers/text.py b/src/d_brain/bot/handlers/text.py
new file mode 100644
index 0000000..e0e7cb0
--- /dev/null
+++ b/src/d_brain/bot/handlers/text.py
@@ -0,0 +1,39 @@
+"""Text message handler."""
+
+import logging
+from datetime import datetime
+
+from aiogram import Router
+from aiogram.types import Message
+
+from d_brain.config import get_settings
+from d_brain.services.session import SessionStore
+from d_brain.services.storage import VaultStorage
+
+router = Router(name="text")
+logger = logging.getLogger(__name__)
+
+
+@router.message(lambda m: m.text is not None and not m.text.startswith("/"))
+async def handle_text(message: Message) -> None:
+    """Handle text messages (excluding commands)."""
+    if not message.text or not message.from_user:
+        return
+
+    settings = get_settings()
+    storage = VaultStorage(settings.vault_path)
+
+    timestamp = datetime.fromtimestamp(message.date.timestamp())
+    storage.append_to_daily(message.text, timestamp, "[text]")
+
+    # Log to session
+    session = SessionStore(settings.vault_path)
+    session.append(
+        message.from_user.id,
+        "text",
+        text=message.text,
+        msg_id=message.message_id,
+    )
+
+    await message.answer("✓ Сохранено")
+    logger.info("Text message saved: %d chars", len(message.text))
diff --git a/src/d_brain/bot/handlers/voice.py b/src/d_brain/bot/handlers/voice.py
new file mode 100644
index 0000000..64cb972
--- /dev/null
+++ b/src/d_brain/bot/handlers/voice.py
@@ -0,0 +1,66 @@
+"""Voice message handler."""
+
+import logging
+from datetime import datetime
+
+from aiogram import Bot, Router
+from aiogram.types import Message
+
+from d_brain.config import get_settings
+from d_brain.services.session import SessionStore
+from d_brain.services.storage import VaultStorage
+from d_brain.services.transcription import DeepgramTranscriber
+
+router = Router(name="voice")
+logger = logging.getLogger(__name__)
+
+
+@router.message(lambda m: m.voice is not None)
+async def handle_voice(message: Message, bot: Bot) -> None:
+    """Handle voice messages."""
+    if not message.voice or not message.from_user:
+        return
+
+    await message.chat.do(action="typing")
+
+    settings = get_settings()
+    storage = VaultStorage(settings.vault_path)
+    transcriber = DeepgramTranscriber(settings.deepgram_api_key)
+
+    try:
+        file = await bot.get_file(message.voice.file_id)
+        if not file.file_path:
+            await message.answer("Failed to download voice message")
+            return
+
+        file_bytes = await bot.download_file(file.file_path)
+        if not file_bytes:
+            await message.answer("Failed to download voice message")
+            return
+
+        audio_bytes = file_bytes.read()
+        transcript = await transcriber.transcribe(audio_bytes)
+
+        if not transcript:
+            await message.answer("Could not transcribe audio")
+            return
+
+        timestamp = datetime.fromtimestamp(message.date.timestamp())
+        storage.append_to_daily(transcript, timestamp, "[voice]")
+
+        # Log to session
+        session = SessionStore(settings.vault_path)
+        session.append(
+            message.from_user.id,
+            "voice",
+            text=transcript,
+            duration=message.voice.duration,
+            msg_id=message.message_id,
+        )
+
+        await message.answer(f"🎤 {transcript}\n\n✓ Сохранено")
+        logger.info("Voice message saved: %d chars", len(transcript))
+
+    except Exception as e:
+        logger.exception("Error processing voice message")
+        await message.answer(f"Error: {e}")
diff --git a/src/d_brain/bot/handlers/weekly.py b/src/d_brain/bot/handlers/weekly.py
new file mode 100644
index 0000000..84f948c
--- /dev/null
+++ b/src/d_brain/bot/handlers/weekly.py
@@ -0,0 +1,60 @@
+"""Weekly digest command handler."""
+
+import asyncio
+import logging
+
+from aiogram import Router
+from aiogram.filters import Command
+from aiogram.types import Message
+
+from d_brain.bot.formatters import format_process_report
+from d_brain.config import get_settings
+from d_brain.services.git import VaultGit
+from d_brain.services.processor import ClaudeProcessor
+
+router = Router(name="weekly")
+logger = logging.getLogger(__name__)
+
+
+@router.message(Command("weekly"))
+async def cmd_weekly(message: Message) -> None:
+    """Handle /weekly command - generate weekly digest."""
+    user_id = message.from_user.id if message.from_user else "unknown"
+    logger.info("Weekly digest triggered by user %s", user_id)
+
+    status_msg = await message.answer("⏳ Генерирую недельный дайджест...")
+
+    settings = get_settings()
+    processor = ClaudeProcessor(settings.vault_path, settings.todoist_api_key)
+    git = VaultGit(settings.vault_path)
+
+    async def run_with_progress() -> dict:
+        task = asyncio.create_task(
+            asyncio.to_thread(processor.generate_weekly)
+        )
+
+        elapsed = 0
+        while not task.done():
+            await asyncio.sleep(30)
+            elapsed += 30
+            if not task.done():
+                try:
+                    await status_msg.edit_text(
+                        f"⏳ Генерирую дайджест... ({elapsed // 60}m {elapsed % 60}s)"
+                    )
+                except Exception:
+                    pass
+
+        return await task
+
+    report = await run_with_progress()
+
+    # Commit any changes (weekly goal updates, etc)
+    if "error" not in report:
+        await asyncio.to_thread(git.commit_and_push, "chore: weekly digest")
+
+    formatted = format_process_report(report)
+    try:
+        await status_msg.edit_text(formatted)
+    except Exception:
+        await status_msg.edit_text(formatted, parse_mode=None)
diff --git a/src/d_brain/bot/keyboards.py b/src/d_brain/bot/keyboards.py
new file mode 100644
index 0000000..016e4f5
--- /dev/null
+++ b/src/d_brain/bot/keyboards.py
@@ -0,0 +1,18 @@
+"""Reply keyboards for Telegram bot."""
+
+from aiogram.types import ReplyKeyboardMarkup
+from aiogram.utils.keyboard import ReplyKeyboardBuilder
+
+
+def get_main_keyboard() -> ReplyKeyboardMarkup:
+    """Main reply keyboard with common commands."""
+    builder = ReplyKeyboardBuilder()
+    # First row: main commands
+    builder.button(text="📊 Статус")
+    builder.button(text="⚙️ Обработать")
+    builder.button(text="📅 Неделя")
+    # Second row: additional
+    builder.button(text="✨ Запрос")
+    builder.button(text="❓ Помощь")
+    builder.adjust(3, 2)  # 3 in first row, 2 in second
+    return builder.as_markup(resize_keyboard=True, is_persistent=True)
diff --git a/src/d_brain/bot/main.py b/src/d_brain/bot/main.py
new file mode 100644
index 0000000..022a419
--- /dev/null
+++ b/src/d_brain/bot/main.py
@@ -0,0 +1,95 @@
+"""Telegram bot initialization and polling."""
+
+import logging
+from collections.abc import Awaitable, Callable
+from typing import Any
+
+from aiogram import Bot, Dispatcher
+from aiogram.client.default import DefaultBotProperties
+from aiogram.enums import ParseMode
+from aiogram.fsm.storage.memory import MemoryStorage
+from aiogram.types import Update
+
+from d_brain.config import Settings
+
+logger = logging.getLogger(__name__)
+
+
+def create_bot(settings: Settings) -> Bot:
+    """Create and configure the Telegram bot."""
+    return Bot(
+        token=settings.telegram_bot_token,
+        default=DefaultBotProperties(parse_mode=ParseMode.HTML),
+    )
+
+
+def create_dispatcher() -> Dispatcher:
+    """Create and configure the dispatcher with routers."""
+    from d_brain.bot.handlers import buttons, commands, do, forward, photo, process, text, voice, weekly
+
+    # Use memory storage for FSM (required for /do command state)
+    dp = Dispatcher(storage=MemoryStorage())
+
+    # Register routers - ORDER MATTERS
+    dp.include_router(commands.router)
+    dp.include_router(process.router)
+    dp.include_router(weekly.router)
+    dp.include_router(do.router)  # Before voice/text to catch FSM state
+    dp.include_router(buttons.router)  # Reply keyboard buttons
+    dp.include_router(voice.router)
+    dp.include_router(photo.router)
+    dp.include_router(forward.router)
+    dp.include_router(text.router)  # Must be last (catch-all for text)
+    return dp
+
+
+MiddlewareHandler = Callable[[Update, dict[str, Any]], Awaitable[Any]]
+MiddlewareType = Callable[[MiddlewareHandler, Update, dict[str, Any]], Awaitable[Any]]
+
+
+def create_auth_middleware(settings: Settings) -> MiddlewareType:
+    """Create middleware to check user authorization."""
+
+    async def auth_middleware(
+        handler: Callable[[Update, dict[str, Any]], Awaitable[Any]],
+        event: Update,
+        data: dict[str, Any],
+    ) -> Any:
+        # If explicitly allowed all users, just bypass check
+        if settings.allow_all_users:
+            return await handler(event, data)
+
+        user = None
+        if event.message:
+            user = event.message.from_user
+        elif event.callback_query:
+            user = event.callback_query.from_user
+
+        # If no users allowed and not allow_all_users -> deny everyone
+        if not settings.allowed_user_ids:
+            logger.warning("Access denied: no allowed_user_ids configured and allow_all_users is False")
+            return None
+
+        # Check if user is in allowed list
+        if user and user.id not in settings.allowed_user_ids:
+            logger.warning("Unauthorized access attempt from user %s", user.id)
+            return None
+
+        return await handler(event, data)
+
+    return auth_middleware
+
+
+async def run_bot(settings: Settings) -> None:
+    """Run the bot with polling."""
+    bot = create_bot(settings)
+    dp = create_dispatcher()
+
+    # Always add auth middleware for security (it handles allow_all_users internally)
+    dp.update.middleware(create_auth_middleware(settings))
+
+    logger.info("Starting bot polling...")
+    try:
+        await dp.start_polling(bot, allowed_updates=dp.resolve_used_update_types())
+    finally:
+        await bot.session.close()
diff --git a/src/d_brain/bot/states.py b/src/d_brain/bot/states.py
new file mode 100644
index 0000000..961fd41
--- /dev/null
+++ b/src/d_brain/bot/states.py
@@ -0,0 +1,9 @@
+"""Bot FSM states."""
+
+from aiogram.fsm.state import State, StatesGroup
+
+
+class DoCommandState(StatesGroup):
+    """States for /do command flow."""
+
+    waiting_for_input = State()  # Waiting for voice or text after /do
diff --git a/src/d_brain/config.py b/src/d_brain/config.py
new file mode 100644
index 0000000..eb8836a
--- /dev/null
+++ b/src/d_brain/config.py
@@ -0,0 +1,52 @@
+"""Application configuration using Pydantic Settings."""
+
+from pathlib import Path
+
+from pydantic import Field
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+
+class Settings(BaseSettings):
+    """Application settings loaded from environment variables."""
+
+    model_config = SettingsConfigDict(
+        env_file=".env",
+        env_file_encoding="utf-8",
+        extra="ignore",
+    )
+
+    telegram_bot_token: str = Field(description="Telegram Bot API token")
+    deepgram_api_key: str = Field(description="Deepgram API key for transcription")
+    todoist_api_key: str = Field(default="", description="Todoist API key for tasks")
+    vault_path: Path = Field(
+        default=Path("./vault"),
+        description="Path to Obsidian vault directory",
+    )
+    allowed_user_ids: list[int] = Field(
+        default_factory=list,
+        description="List of Telegram user IDs allowed to use the bot",
+    )
+    allow_all_users: bool = Field(
+        default=False,
+        description="Whether to allow access to all users (security risk!)",
+    )
+
+    @property
+    def daily_path(self) -> Path:
+        """Path to daily notes directory."""
+        return self.vault_path / "daily"
+
+    @property
+    def attachments_path(self) -> Path:
+        """Path to attachments directory."""
+        return self.vault_path / "attachments"
+
+    @property
+    def thoughts_path(self) -> Path:
+        """Path to thoughts directory."""
+        return self.vault_path / "thoughts"
+
+
+def get_settings() -> Settings:
+    """Get application settings instance."""
+    return Settings()
diff --git a/src/d_brain/services/__init__.py b/src/d_brain/services/__init__.py
new file mode 100644
index 0000000..de2060f
--- /dev/null
+++ b/src/d_brain/services/__init__.py
@@ -0,0 +1 @@
+"""Business logic services."""
diff --git a/src/d_brain/services/git.py b/src/d_brain/services/git.py
new file mode 100644
index 0000000..3c980c4
--- /dev/null
+++ b/src/d_brain/services/git.py
@@ -0,0 +1,88 @@
+"""Git automation service for vault."""
+
+import logging
+import subprocess
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+
+class VaultGit:
+    """Service for git operations on vault."""
+
+    def __init__(self, vault_path: Path) -> None:
+        self.vault_path = Path(vault_path)
+
+    def _run_git(self, *args: str) -> subprocess.CompletedProcess[str]:
+        """Run git command in vault directory."""
+        return subprocess.run(
+            ["git", *args],
+            cwd=self.vault_path,
+            capture_output=True,
+            text=True,
+            check=False,
+        )
+
+    def get_status(self) -> str:
+        """Get git status."""
+        result = self._run_git("status", "--porcelain")
+        return result.stdout
+
+    def has_changes(self) -> bool:
+        """Check if there are uncommitted changes."""
+        return bool(self.get_status().strip())
+
+    def commit_changes(self, message: str) -> bool:
+        """Stage all changes and commit.
+
+        Args:
+            message: Commit message
+
+        Returns:
+            True if commit was made, False otherwise
+        """
+        if not self.has_changes():
+            logger.info("No changes to commit")
+            return False
+
+        # Stage all changes
+        add_result = self._run_git("add", "-A")
+        if add_result.returncode != 0:
+            logger.error("Git add failed: %s", add_result.stderr)
+            return False
+
+        # Commit
+        commit_result = self._run_git("commit", "-m", message)
+        if commit_result.returncode != 0:
+            logger.error("Git commit failed: %s", commit_result.stderr)
+            return False
+
+        logger.info("Committed: %s", message)
+        return True
+
+    def push(self) -> bool:
+        """Push to remote.
+
+        Returns:
+            True if push was successful
+        """
+        result = self._run_git("push")
+        if result.returncode != 0:
+            logger.error("Git push failed: %s", result.stderr)
+            return False
+
+        logger.info("Pushed to remote")
+        return True
+
+    def commit_and_push(self, message: str) -> bool:
+        """Commit all changes and push.
+
+        Args:
+            message: Commit message
+
+        Returns:
+            True if successful
+        """
+        if self.commit_changes(message):
+            return self.push()
+        return True  # No changes is not an error
diff --git a/src/d_brain/services/processor.py b/src/d_brain/services/processor.py
new file mode 100644
index 0000000..41bd0da
--- /dev/null
+++ b/src/d_brain/services/processor.py
@@ -0,0 +1,405 @@
+"""Claude processing service."""
+
+import logging
+import os
+import subprocess
+from datetime import date
+from pathlib import Path
+from typing import Any
+
+from d_brain.services.session import SessionStore
+
+logger = logging.getLogger(__name__)
+
+DEFAULT_TIMEOUT = 1200  # 20 minutes
+
+
+class ClaudeProcessor:
+    """Service for triggering Claude Code processing."""
+
+    def __init__(self, vault_path: Path, todoist_api_key: str = "") -> None:
+        self.vault_path = Path(vault_path)
+        self.todoist_api_key = todoist_api_key
+        self._mcp_config_path = (self.vault_path.parent / "mcp-config.json").resolve()
+
+    def _load_skill_content(self) -> str:
+        """Load dbrain-processor skill content for inclusion in prompt.
+
+        NOTE: @vault/ references don't work in --print mode,
+        so we must include skill content directly in the prompt.
+        """
+        skill_path = self.vault_path / ".claude/skills/dbrain-processor/SKILL.md"
+        if skill_path.exists():
+            return skill_path.read_text()
+        return ""
+
+    def _load_todoist_reference(self) -> str:
+        """Load Todoist reference for inclusion in prompt."""
+        ref_path = self.vault_path / ".claude/skills/dbrain-processor/references/todoist.md"
+        if ref_path.exists():
+            return ref_path.read_text()
+        return ""
+
+    def _get_session_context(self, user_id: int) -> str:
+        """Get today's session context for Claude.
+
+        Args:
+            user_id: Telegram user ID
+
+        Returns:
+            Recent session entries formatted for inclusion in prompt.
+        """
+        if user_id == 0:
+            return ""
+
+        session = SessionStore(self.vault_path)
+        today_entries = session.get_today(user_id)
+        if not today_entries:
+            return ""
+
+        lines = ["=== TODAY'S SESSION ==="]
+        for entry in today_entries[-10:]:
+            ts = entry.get("ts", "")[11:16]  # HH:MM from ISO
+            entry_type = entry.get("type", "unknown")
+            text = entry.get("text", "")[:80]
+            if text:
+                lines.append(f"{ts} [{entry_type}] {text}")
+        lines.append("=== END SESSION ===\n")
+        return "\n".join(lines)
+
+    def _html_to_markdown(self, html: str) -> str:
+        """Convert Telegram HTML to Obsidian Markdown."""
+        import re
+
+        text = html
+        # text → **text**
+        text = re.sub(r"(.*?)", r"**\1**", text)
+        # text → *text*
+        text = re.sub(r"(.*?)", r"*\1*", text)
+        # text → `text`
+        text = re.sub(r"(.*?)", r"`\1`", text)
+        # text → ~~text~~
+        text = re.sub(r"(.*?)", r"~~\1~~", text)
+        # Remove  (no Markdown equivalent, just keep text)
+        text = re.sub(r"", "", text)
+        # text → [text](url)
+        text = re.sub(r'([^<]+)', r"[\2](\1)", text)
+
+        return text
+
+    def _save_weekly_summary(self, report_html: str, week_date: date) -> Path:
+        """Save weekly summary to vault/summaries/YYYY-WXX-summary.md."""
+        # Calculate ISO week number
+        year, week, _ = week_date.isocalendar()
+        filename = f"{year}-W{week:02d}-summary.md"
+        summary_path = self.vault_path / "summaries" / filename
+
+        # Convert HTML to Markdown for Obsidian
+        content = self._html_to_markdown(report_html)
+
+        # Add frontmatter
+        frontmatter = f"""---
+date: {week_date.isoformat()}
+type: weekly-summary
+week: {year}-W{week:02d}
+---
+
+"""
+        summary_path.write_text(frontmatter + content)
+        logger.info("Weekly summary saved to %s", summary_path)
+        return summary_path
+
+    def _update_weekly_moc(self, summary_path: Path) -> None:
+        """Add link to new summary in MOC-weekly.md."""
+        moc_path = self.vault_path / "MOC" / "MOC-weekly.md"
+        if moc_path.exists():
+            content = moc_path.read_text()
+            link = f"- [[summaries/{summary_path.name}|{summary_path.stem}]]"
+            # Insert after "## Previous Weeks" if not already there
+            if summary_path.stem not in content:
+                content = content.replace(
+                    "## Previous Weeks\n",
+                    f"## Previous Weeks\n\n{link}\n",
+                )
+                moc_path.write_text(content)
+                logger.info("Updated MOC-weekly.md with link to %s", summary_path.stem)
+
+    def process_daily(self, day: date | None = None) -> dict[str, Any]:
+        """Process daily file with Claude.
+
+        Args:
+            day: Date to process (default: today)
+
+        Returns:
+            Processing report as dict
+        """
+        if day is None:
+            day = date.today()
+
+        daily_file = self.vault_path / "daily" / f"{day.isoformat()}.md"
+
+        if not daily_file.exists():
+            logger.warning("No daily file for %s", day)
+            return {
+                "error": f"No daily file for {day}",
+                "processed_entries": 0,
+            }
+
+        # Load skill content directly (@ references don't work in --print mode)
+        skill_content = self._load_skill_content()
+
+        prompt = f"""Сегодня {day}. Выполни ежедневную обработку.
+
+=== SKILL INSTRUCTIONS ===
+{skill_content}
+=== END SKILL ===
+
+ПЕРВЫМ ДЕЛОМ: вызови mcp__todoist__user-info чтобы убедиться что MCP работает.
+
+CRITICAL MCP RULE:
+- ТЫ ИМЕЕШЬ ДОСТУП к mcp__todoist__* tools — ВЫЗЫВАЙ ИХ НАПРЯМУЮ
+- НИКОГДА не пиши "MCP недоступен" или "добавь вручную"
+- Для задач: вызови mcp__todoist__add-tasks tool
+- Если tool вернул ошибку — покажи ТОЧНУЮ ошибку в отчёте
+
+CRITICAL OUTPUT FORMAT:
+- Return ONLY raw HTML for Telegram (parse_mode=HTML)
+- NO markdown: no **, no ## , no ```, no tables
+- Start directly with 📊 Обработка за {day}
+- Allowed tags: , , , , 
+- If entries already processed, return status report in same HTML format"""
+
+        try:
+            # Pass TODOIST_API_KEY to Claude subprocess
+            env = os.environ.copy()
+            if self.todoist_api_key:
+                env["TODOIST_API_KEY"] = self.todoist_api_key
+
+            result = subprocess.run(
+                [
+                    "claude",
+                    "--print",
+                    "--dangerously-skip-permissions",
+                    "--mcp-config",
+                    str(self._mcp_config_path),
+                    "-p",
+                    prompt,
+                ],
+                cwd=self.vault_path.parent,
+                capture_output=True,
+                text=True,
+                timeout=DEFAULT_TIMEOUT,
+                check=False,
+                env=env,
+            )
+
+            if result.returncode != 0:
+                logger.error("Claude processing failed: %s", result.stderr)
+                return {
+                    "error": result.stderr or "Claude processing failed",
+                    "processed_entries": 0,
+                }
+
+            # Return human-readable output
+            output = result.stdout.strip()
+            return {
+                "report": output,
+                "processed_entries": 1,  # успешно обработано
+            }
+
+        except subprocess.TimeoutExpired:
+            logger.error("Claude processing timed out")
+            return {
+                "error": "Processing timed out",
+                "processed_entries": 0,
+            }
+        except FileNotFoundError:
+            logger.error("Claude CLI not found")
+            return {
+                "error": "Claude CLI not installed",
+                "processed_entries": 0,
+            }
+        except Exception as e:
+            logger.exception("Unexpected error during processing")
+            return {
+                "error": str(e),
+                "processed_entries": 0,
+            }
+
+    def execute_prompt(self, user_prompt: str, user_id: int = 0) -> dict[str, Any]:
+        """Execute arbitrary prompt with Claude.
+
+        Args:
+            user_prompt: User's natural language request
+            user_id: Telegram user ID for session context
+
+        Returns:
+            Execution report as dict
+        """
+        today = date.today()
+
+        # Load context
+        todoist_ref = self._load_todoist_reference()
+        session_context = self._get_session_context(user_id)
+
+        prompt = f"""Ты - персональный ассистент d-brain.
+
+CONTEXT:
+- Текущая дата: {today}
+- Vault path: {self.vault_path}
+
+{session_context}=== TODOIST REFERENCE ===
+{todoist_ref}
+=== END REFERENCE ===
+
+ПЕРВЫМ ДЕЛОМ: вызови mcp__todoist__user-info чтобы убедиться что MCP работает.
+
+CRITICAL MCP RULE:
+- ТЫ ИМЕЕШЬ ДОСТУП к mcp__todoist__* tools — ВЫЗЫВАЙ ИХ НАПРЯМУЮ
+- НИКОГДА не пиши "MCP недоступен" или "добавь вручную"
+- Если tool вернул ошибку — покажи ТОЧНУЮ ошибку в отчёте
+
+USER REQUEST:
+{user_prompt}
+
+CRITICAL OUTPUT FORMAT:
+- Return ONLY raw HTML for Telegram (parse_mode=HTML)
+- NO markdown: no **, no ##, no ```, no tables, no -
+- Start with emoji and header
+- Allowed tags: , , , , 
+- Be concise - Telegram has 4096 char limit
+
+EXECUTION:
+1. Analyze the request
+2. Call MCP tools directly (mcp__todoist__*, read/write files)
+3. Return HTML status report with results"""
+
+        try:
+            env = os.environ.copy()
+            if self.todoist_api_key:
+                env["TODOIST_API_KEY"] = self.todoist_api_key
+
+            result = subprocess.run(
+                [
+                    "claude",
+                    "--print",
+                    "--dangerously-skip-permissions",
+                    "--mcp-config",
+                    str(self._mcp_config_path),
+                    "-p",
+                    prompt,
+                ],
+                cwd=self.vault_path.parent,
+                capture_output=True,
+                text=True,
+                timeout=DEFAULT_TIMEOUT,
+                check=False,
+                env=env,
+            )
+
+            if result.returncode != 0:
+                logger.error("Claude execution failed: %s", result.stderr)
+                return {
+                    "error": result.stderr or "Claude execution failed",
+                    "processed_entries": 0,
+                }
+
+            return {
+                "report": result.stdout.strip(),
+                "processed_entries": 1,
+            }
+
+        except subprocess.TimeoutExpired:
+            logger.error("Claude execution timed out")
+            return {"error": "Execution timed out", "processed_entries": 0}
+        except FileNotFoundError:
+            logger.error("Claude CLI not found")
+            return {"error": "Claude CLI not installed", "processed_entries": 0}
+        except Exception as e:
+            logger.exception("Unexpected error during execution")
+            return {"error": str(e), "processed_entries": 0}
+
+    def generate_weekly(self) -> dict[str, Any]:
+        """Generate weekly digest with Claude.
+
+        Returns:
+            Weekly digest report as dict
+        """
+        today = date.today()
+
+        prompt = f"""Сегодня {today}. Сгенерируй недельный дайджест.
+
+ПЕРВЫМ ДЕЛОМ: вызови mcp__todoist__user-info чтобы убедиться что MCP работает.
+
+CRITICAL MCP RULE:
+- ТЫ ИМЕЕШЬ ДОСТУП к mcp__todoist__* tools — ВЫЗЫВАЙ ИХ НАПРЯМУЮ
+- НИКОГДА не пиши "MCP недоступен" или "добавь вручную"
+- Для выполненных задач: вызови mcp__todoist__find-completed-tasks tool
+- Если tool вернул ошибку — покажи ТОЧНУЮ ошибку в отчёте
+
+WORKFLOW:
+1. Собери данные за неделю (daily файлы в vault/daily/, completed tasks через MCP)
+2. Проанализируй прогресс по целям (goals/3-weekly.md)
+3. Определи победы и вызовы
+4. Сгенерируй HTML отчёт
+
+CRITICAL OUTPUT FORMAT:
+- Return ONLY raw HTML for Telegram (parse_mode=HTML)
+- NO markdown: no **, no ##, no ```, no tables
+- Start with 📅 Недельный дайджест
+- Allowed tags: , , , , 
+- Be concise - Telegram has 4096 char limit"""
+
+        try:
+            env = os.environ.copy()
+            if self.todoist_api_key:
+                env["TODOIST_API_KEY"] = self.todoist_api_key
+
+            result = subprocess.run(
+                [
+                    "claude",
+                    "--print",
+                    "--dangerously-skip-permissions",
+                    "--mcp-config",
+                    str(self._mcp_config_path),
+                    "-p",
+                    prompt,
+                ],
+                cwd=self.vault_path.parent,
+                capture_output=True,
+                text=True,
+                timeout=DEFAULT_TIMEOUT,
+                check=False,
+                env=env,
+            )
+
+            if result.returncode != 0:
+                logger.error("Weekly digest failed: %s", result.stderr)
+                return {
+                    "error": result.stderr or "Weekly digest failed",
+                    "processed_entries": 0,
+                }
+
+            output = result.stdout.strip()
+
+            # Save to summaries/ and update MOC
+            try:
+                summary_path = self._save_weekly_summary(output, today)
+                self._update_weekly_moc(summary_path)
+            except Exception as e:
+                logger.warning("Failed to save weekly summary: %s", e)
+
+            return {
+                "report": output,
+                "processed_entries": 1,
+            }
+
+        except subprocess.TimeoutExpired:
+            logger.error("Weekly digest timed out")
+            return {"error": "Weekly digest timed out", "processed_entries": 0}
+        except FileNotFoundError:
+            logger.error("Claude CLI not found")
+            return {"error": "Claude CLI not installed", "processed_entries": 0}
+        except Exception as e:
+            logger.exception("Unexpected error during weekly digest")
+            return {"error": str(e), "processed_entries": 0}
diff --git a/src/d_brain/services/session.py b/src/d_brain/services/session.py
new file mode 100644
index 0000000..1f51ff5
--- /dev/null
+++ b/src/d_brain/services/session.py
@@ -0,0 +1,106 @@
+"""Session persistence service.
+
+Stores all bot interactions in JSONL format for history and analytics.
+Inspired by Clawdbot's session persistence pattern.
+"""
+
+import json
+from datetime import datetime
+from pathlib import Path
+from typing import Any
+
+
+class SessionStore:
+    """Persistent session storage in JSONL format.
+
+    Each user gets their own session file at vault/.sessions/{user_id}.jsonl.
+    Entries are append-only for reliability and simplicity.
+    """
+
+    def __init__(self, vault_path: Path | str) -> None:
+        self.sessions_dir = Path(vault_path) / ".sessions"
+        self.sessions_dir.mkdir(exist_ok=True)
+
+    def _get_session_file(self, user_id: int) -> Path:
+        return self.sessions_dir / f"{user_id}.jsonl"
+
+    def append(self, user_id: int, entry_type: str, **data: Any) -> None:
+        """Append entry to user's session file.
+
+        Args:
+            user_id: Telegram user ID
+            entry_type: Type of entry (voice, text, photo, forward, command, etc.)
+            **data: Additional data to store (text, duration, msg_id, etc.)
+        """
+        entry = {
+            "ts": datetime.now().astimezone().isoformat(),
+            "type": entry_type,
+            **data,
+        }
+        path = self._get_session_file(user_id)
+        with path.open("a", encoding="utf-8") as f:
+            f.write(json.dumps(entry, ensure_ascii=False) + "\n")
+
+    def get_recent(self, user_id: int, limit: int = 50) -> list[dict]:
+        """Get recent session entries.
+
+        Args:
+            user_id: Telegram user ID
+            limit: Maximum number of entries to return
+
+        Returns:
+            List of session entries, most recent last
+        """
+        path = self._get_session_file(user_id)
+        if not path.exists():
+            return []
+
+        entries = []
+        with path.open("r", encoding="utf-8") as f:
+            for line in f:
+                if line.strip():
+                    try:
+                        entries.append(json.loads(line))
+                    except json.JSONDecodeError:
+                        continue  # Skip malformed lines
+
+        return entries[-limit:]
+
+    def get_today(self, user_id: int) -> list[dict]:
+        """Get today's session entries.
+
+        Args:
+            user_id: Telegram user ID
+
+        Returns:
+            List of today's entries
+        """
+        today = datetime.now().date().isoformat()
+        return [
+            e
+            for e in self.get_recent(user_id, limit=200)
+            if e.get("ts", "").startswith(today)
+        ]
+
+    def get_stats(self, user_id: int, days: int = 7) -> dict[str, int]:
+        """Get usage statistics for the last N days.
+
+        Args:
+            user_id: Telegram user ID
+            days: Number of days to analyze
+
+        Returns:
+            Dict with counts by entry type
+        """
+        from datetime import timedelta
+
+        cutoff = (datetime.now() - timedelta(days=days)).isoformat()
+        entries = self.get_recent(user_id, limit=1000)
+
+        stats: dict[str, int] = {}
+        for entry in entries:
+            if entry.get("ts", "") >= cutoff:
+                entry_type = entry.get("type", "unknown")
+                stats[entry_type] = stats.get(entry_type, 0) + 1
+
+        return stats
diff --git a/src/d_brain/services/storage.py b/src/d_brain/services/storage.py
new file mode 100644
index 0000000..4655e38
--- /dev/null
+++ b/src/d_brain/services/storage.py
@@ -0,0 +1,85 @@
+"""Vault storage service for saving entries."""
+
+from datetime import date, datetime
+from pathlib import Path
+
+
+class VaultStorage:
+    """Service for storing entries in Obsidian vault."""
+
+    def __init__(self, vault_path: Path) -> None:
+        self.vault_path = Path(vault_path)
+        self.daily_path = self.vault_path / "daily"
+        self.attachments_path = self.vault_path / "attachments"
+
+    def _ensure_dirs(self) -> None:
+        """Ensure required directories exist."""
+        self.daily_path.mkdir(parents=True, exist_ok=True)
+        self.attachments_path.mkdir(parents=True, exist_ok=True)
+
+    def get_daily_file(self, day: date) -> Path:
+        """Get path to daily file for given date."""
+        self._ensure_dirs()
+        return self.daily_path / f"{day.isoformat()}.md"
+
+    def read_daily(self, day: date) -> str:
+        """Read content of daily file."""
+        file_path = self.get_daily_file(day)
+        if not file_path.exists():
+            return ""
+        return file_path.read_text(encoding="utf-8")
+
+    def append_to_daily(
+        self,
+        text: str,
+        timestamp: datetime,
+        msg_type: str,
+    ) -> None:
+        """Append entry to daily file.
+
+        Args:
+            text: Content to append
+            timestamp: Entry timestamp
+            msg_type: Type marker like [voice], [text], [photo], [forward from: Name]
+        """
+        self._ensure_dirs()
+        file_path = self.get_daily_file(timestamp.date())
+
+        time_str = timestamp.strftime("%H:%M")
+        entry = f"\n## {time_str} {msg_type}\n{text}\n"
+
+        with file_path.open("a", encoding="utf-8") as f:
+            f.write(entry)
+
+    def get_attachments_dir(self, day: date) -> Path:
+        """Get attachments directory for given date."""
+        dir_path = self.attachments_path / day.isoformat()
+        dir_path.mkdir(parents=True, exist_ok=True)
+        return dir_path
+
+    def save_attachment(
+        self,
+        data: bytes,
+        day: date,
+        timestamp: datetime,
+        extension: str = "jpg",
+    ) -> str:
+        """Save attachment and return relative path for Obsidian embed.
+
+        Args:
+            data: File bytes
+            day: Date for organizing
+            timestamp: Timestamp for filename
+            extension: File extension
+
+        Returns:
+            Relative path for Obsidian embed: attachments/YYYY-MM-DD/img-HHMMSS.ext
+        """
+        dir_path = self.get_attachments_dir(day)
+        time_str = timestamp.strftime("%H%M%S")
+        filename = f"img-{time_str}.{extension}"
+        file_path = dir_path / filename
+
+        file_path.write_bytes(data)
+
+        return f"attachments/{day.isoformat()}/{filename}"
diff --git a/src/d_brain/services/transcription.py b/src/d_brain/services/transcription.py
new file mode 100644
index 0000000..5b55c04
--- /dev/null
+++ b/src/d_brain/services/transcription.py
@@ -0,0 +1,47 @@
+"""Deepgram transcription service."""
+
+import logging
+
+from deepgram import AsyncDeepgramClient
+
+logger = logging.getLogger(__name__)
+
+
+class DeepgramTranscriber:
+    """Service for transcribing audio using Deepgram Nova-3."""
+
+    def __init__(self, api_key: str) -> None:
+        self.client = AsyncDeepgramClient(api_key=api_key)
+
+    async def transcribe(self, audio_bytes: bytes) -> str:
+        """Transcribe audio bytes to text.
+
+        Args:
+            audio_bytes: Audio file content
+
+        Returns:
+            Transcribed text
+
+        Raises:
+            Exception: If transcription fails
+        """
+        logger.info("Starting transcription, audio size: %d bytes", len(audio_bytes))
+
+        response = await self.client.listen.v1.media.transcribe_file(
+            request=audio_bytes,
+            model="nova-3",
+            language="ru",
+            punctuate=True,
+            smart_format=True,
+        )
+
+        transcript = (
+            response.results.channels[0].alternatives[0].transcript
+            if response.results
+            and response.results.channels
+            and response.results.channels[0].alternatives
+            else ""
+        )
+
+        logger.info("Transcription complete: %d chars", len(transcript))
+        return transcript
diff --git a/uv.lock b/uv.lock
new file mode 100644
index 0000000..de074b5
--- /dev/null
+++ b/uv.lock
@@ -0,0 +1,1146 @@
+version = 1
+revision = 3
+requires-python = ">=3.12"
+
+[[package]]
+name = "agent-second-brain"
+version = "1.0.0"
+source = { editable = "." }
+dependencies = [
+    { name = "aiogram" },
+    { name = "deepgram-sdk" },
+    { name = "httpx" },
+    { name = "pydantic" },
+    { name = "pydantic-settings" },
+    { name = "todoist-api-python" },
+]
+
+[package.optional-dependencies]
+dev = [
+    { name = "mypy" },
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+    { name = "ruff" },
+]
+
+[package.dev-dependencies]
+dev = [
+    { name = "pytest" },
+    { name = "pytest-asyncio" },
+]
+
+[package.metadata]
+requires-dist = [
+    { name = "aiogram", specifier = ">=3.0" },
+    { name = "deepgram-sdk" },
+    { name = "httpx" },
+    { name = "mypy", marker = "extra == 'dev'" },
+    { name = "pydantic", specifier = ">=2.0" },
+    { name = "pydantic-settings" },
+    { name = "pytest", marker = "extra == 'dev'" },
+    { name = "pytest-asyncio", marker = "extra == 'dev'" },
+    { name = "ruff", marker = "extra == 'dev'" },
+    { name = "todoist-api-python", specifier = ">=3.1.0" },
+]
+provides-extras = ["dev"]
+
+[package.metadata.requires-dev]
+dev = [
+    { name = "pytest", specifier = ">=9.0.2" },
+    { name = "pytest-asyncio", specifier = ">=1.3.0" },
+]
+
+[[package]]
+name = "aiofiles"
+version = "25.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/41/c3/534eac40372d8ee36ef40df62ec129bee4fdb5ad9706e58a29be53b2c970/aiofiles-25.1.0.tar.gz", hash = "sha256:a8d728f0a29de45dc521f18f07297428d56992a742f0cd2701ba86e44d23d5b2", size = 46354, upload-time = "2025-10-09T20:51:04.358Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/bc/8a/340a1555ae33d7354dbca4faa54948d76d89a27ceef032c8c3bc661d003e/aiofiles-25.1.0-py3-none-any.whl", hash = "sha256:abe311e527c862958650f9438e859c1fa7568a141b22abcd015e120e86a85695", size = 14668, upload-time = "2025-10-09T20:51:03.174Z" },
+]
+
+[[package]]
+name = "aiogram"
+version = "3.24.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "aiofiles" },
+    { name = "aiohttp" },
+    { name = "certifi" },
+    { name = "magic-filter" },
+    { name = "pydantic" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/fd/2f/04f47e81def8f2168679b1551e665e7ee02cf063e7bddace9fb5d1ce2f35/aiogram-3.24.0.tar.gz", hash = "sha256:ec547ede5bfa8a7a4f5fb02c75391333fc43b6f3de6a6d3f00a32e27628df5f6", size = 1713321, upload-time = "2026-01-02T00:56:55.3Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/22/a5/7ba5f75b56f87a956b9e5a3e823bcbb5b55fc968914a16f3c7aa659cfc89/aiogram-3.24.0-py3-none-any.whl", hash = "sha256:eb3cc05b0ec53c7e24d7eada5c069aee2f431332e2e7bc2c8adf30d13b02f715", size = 706866, upload-time = "2026-01-02T00:56:53.115Z" },
+]
+
+[[package]]
+name = "aiohappyeyeballs"
+version = "2.6.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/26/30/f84a107a9c4331c14b2b586036f40965c128aa4fee4dda5d3d51cb14ad54/aiohappyeyeballs-2.6.1.tar.gz", hash = "sha256:c3f9d0113123803ccadfdf3f0faa505bc78e6a72d1cc4806cbd719826e943558", size = 22760, upload-time = "2025-03-12T01:42:48.764Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0f/15/5bf3b99495fb160b63f95972b81750f18f7f4e02ad051373b669d17d44f2/aiohappyeyeballs-2.6.1-py3-none-any.whl", hash = "sha256:f349ba8f4b75cb25c99c5c2d84e997e485204d2902a9597802b0371f09331fb8", size = 15265, upload-time = "2025-03-12T01:42:47.083Z" },
+]
+
+[[package]]
+name = "aiohttp"
+version = "3.13.3"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "aiohappyeyeballs" },
+    { name = "aiosignal" },
+    { name = "attrs" },
+    { name = "frozenlist" },
+    { name = "multidict" },
+    { name = "propcache" },
+    { name = "yarl" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/50/42/32cf8e7704ceb4481406eb87161349abb46a57fee3f008ba9cb610968646/aiohttp-3.13.3.tar.gz", hash = "sha256:a949eee43d3782f2daae4f4a2819b2cb9b0c5d3b7f7a927067cc84dafdbb9f88", size = 7844556, upload-time = "2026-01-03T17:33:05.204Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a0/be/4fc11f202955a69e0db803a12a062b8379c970c7c84f4882b6da17337cc1/aiohttp-3.13.3-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:b903a4dfee7d347e2d87697d0713be59e0b87925be030c9178c5faa58ea58d5c", size = 739732, upload-time = "2026-01-03T17:30:14.23Z" },
+    { url = "https://files.pythonhosted.org/packages/97/2c/621d5b851f94fa0bb7430d6089b3aa970a9d9b75196bc93bb624b0db237a/aiohttp-3.13.3-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:a45530014d7a1e09f4a55f4f43097ba0fd155089372e105e4bff4ca76cb1b168", size = 494293, upload-time = "2026-01-03T17:30:15.96Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/43/4be01406b78e1be8320bb8316dc9c42dbab553d281c40364e0f862d5661c/aiohttp-3.13.3-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:27234ef6d85c914f9efeb77ff616dbf4ad2380be0cda40b4db086ffc7ddd1b7d", size = 493533, upload-time = "2026-01-03T17:30:17.431Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/a8/5a35dc56a06a2c90d4742cbf35294396907027f80eea696637945a106f25/aiohttp-3.13.3-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:d32764c6c9aafb7fb55366a224756387cd50bfa720f32b88e0e6fa45b27dcf29", size = 1737839, upload-time = "2026-01-03T17:30:19.422Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/62/4b9eeb331da56530bf2e198a297e5303e1c1ebdceeb00fe9b568a65c5a0c/aiohttp-3.13.3-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:b1a6102b4d3ebc07dad44fbf07b45bb600300f15b552ddf1851b5390202ea2e3", size = 1703932, upload-time = "2026-01-03T17:30:21.756Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/f6/af16887b5d419e6a367095994c0b1332d154f647e7dc2bd50e61876e8e3d/aiohttp-3.13.3-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c014c7ea7fb775dd015b2d3137378b7be0249a448a1612268b5a90c2d81de04d", size = 1771906, upload-time = "2026-01-03T17:30:23.932Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/83/397c634b1bcc24292fa1e0c7822800f9f6569e32934bdeef09dae7992dfb/aiohttp-3.13.3-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2b8d8ddba8f95ba17582226f80e2de99c7a7948e66490ef8d947e272a93e9463", size = 1871020, upload-time = "2026-01-03T17:30:26Z" },
+    { url = "https://files.pythonhosted.org/packages/86/f6/a62cbbf13f0ac80a70f71b1672feba90fdb21fd7abd8dbf25c0105fb6fa3/aiohttp-3.13.3-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9ae8dd55c8e6c4257eae3a20fd2c8f41edaea5992ed67156642493b8daf3cecc", size = 1755181, upload-time = "2026-01-03T17:30:27.554Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/87/20a35ad487efdd3fba93d5843efdfaa62d2f1479eaafa7453398a44faf13/aiohttp-3.13.3-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:01ad2529d4b5035578f5081606a465f3b814c542882804e2e8cda61adf5c71bf", size = 1561794, upload-time = "2026-01-03T17:30:29.254Z" },
+    { url = "https://files.pythonhosted.org/packages/de/95/8fd69a66682012f6716e1bc09ef8a1a2a91922c5725cb904689f112309c4/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:bb4f7475e359992b580559e008c598091c45b5088f28614e855e42d39c2f1033", size = 1697900, upload-time = "2026-01-03T17:30:31.033Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/66/7b94b3b5ba70e955ff597672dad1691333080e37f50280178967aff68657/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:c19b90316ad3b24c69cd78d5c9b4f3aa4497643685901185b65166293d36a00f", size = 1728239, upload-time = "2026-01-03T17:30:32.703Z" },
+    { url = "https://files.pythonhosted.org/packages/47/71/6f72f77f9f7d74719692ab65a2a0252584bf8d5f301e2ecb4c0da734530a/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:96d604498a7c782cb15a51c406acaea70d8c027ee6b90c569baa6e7b93073679", size = 1740527, upload-time = "2026-01-03T17:30:34.695Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/b4/75ec16cbbd5c01bdaf4a05b19e103e78d7ce1ef7c80867eb0ace42ff4488/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:084911a532763e9d3dd95adf78a78f4096cd5f58cdc18e6fdbc1b58417a45423", size = 1554489, upload-time = "2026-01-03T17:30:36.864Z" },
+    { url = "https://files.pythonhosted.org/packages/52/8f/bc518c0eea29f8406dcf7ed1f96c9b48e3bc3995a96159b3fc11f9e08321/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:7a4a94eb787e606d0a09404b9c38c113d3b099d508021faa615d70a0131907ce", size = 1767852, upload-time = "2026-01-03T17:30:39.433Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/f2/a07a75173124f31f11ea6f863dc44e6f09afe2bca45dd4e64979490deab1/aiohttp-3.13.3-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:87797e645d9d8e222e04160ee32aa06bc5c163e8499f24db719e7852ec23093a", size = 1722379, upload-time = "2026-01-03T17:30:41.081Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/4a/1a3fee7c21350cac78e5c5cef711bac1b94feca07399f3d406972e2d8fcd/aiohttp-3.13.3-cp312-cp312-win32.whl", hash = "sha256:b04be762396457bef43f3597c991e192ee7da460a4953d7e647ee4b1c28e7046", size = 428253, upload-time = "2026-01-03T17:30:42.644Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/b7/76175c7cb4eb73d91ad63c34e29fc4f77c9386bba4a65b53ba8e05ee3c39/aiohttp-3.13.3-cp312-cp312-win_amd64.whl", hash = "sha256:e3531d63d3bdfa7e3ac5e9b27b2dd7ec9df3206a98e0b3445fa906f233264c57", size = 455407, upload-time = "2026-01-03T17:30:44.195Z" },
+    { url = "https://files.pythonhosted.org/packages/97/8a/12ca489246ca1faaf5432844adbfce7ff2cc4997733e0af120869345643a/aiohttp-3.13.3-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:5dff64413671b0d3e7d5918ea490bdccb97a4ad29b3f311ed423200b2203e01c", size = 734190, upload-time = "2026-01-03T17:30:45.832Z" },
+    { url = "https://files.pythonhosted.org/packages/32/08/de43984c74ed1fca5c014808963cc83cb00d7bb06af228f132d33862ca76/aiohttp-3.13.3-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:87b9aab6d6ed88235aa2970294f496ff1a1f9adcd724d800e9b952395a80ffd9", size = 491783, upload-time = "2026-01-03T17:30:47.466Z" },
+    { url = "https://files.pythonhosted.org/packages/17/f8/8dd2cf6112a5a76f81f81a5130c57ca829d101ad583ce57f889179accdda/aiohttp-3.13.3-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:425c126c0dc43861e22cb1c14ba4c8e45d09516d0a3ae0a3f7494b79f5f233a3", size = 490704, upload-time = "2026-01-03T17:30:49.373Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/40/a46b03ca03936f832bc7eaa47cfbb1ad012ba1be4790122ee4f4f8cba074/aiohttp-3.13.3-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7f9120f7093c2a32d9647abcaf21e6ad275b4fbec5b55969f978b1a97c7c86bf", size = 1720652, upload-time = "2026-01-03T17:30:50.974Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/7e/917fe18e3607af92657e4285498f500dca797ff8c918bd7d90b05abf6c2a/aiohttp-3.13.3-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:697753042d57f4bf7122cab985bf15d0cef23c770864580f5af4f52023a56bd6", size = 1692014, upload-time = "2026-01-03T17:30:52.729Z" },
+    { url = "https://files.pythonhosted.org/packages/71/b6/cefa4cbc00d315d68973b671cf105b21a609c12b82d52e5d0c9ae61d2a09/aiohttp-3.13.3-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:6de499a1a44e7de70735d0b39f67c8f25eb3d91eb3103be99ca0fa882cdd987d", size = 1759777, upload-time = "2026-01-03T17:30:54.537Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/e3/e06ee07b45e59e6d81498b591fc589629be1553abb2a82ce33efe2a7b068/aiohttp-3.13.3-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:37239e9f9a7ea9ac5bf6b92b0260b01f8a22281996da609206a84df860bc1261", size = 1861276, upload-time = "2026-01-03T17:30:56.512Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/24/75d274228acf35ceeb2850b8ce04de9dd7355ff7a0b49d607ee60c29c518/aiohttp-3.13.3-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:f76c1e3fe7d7c8afad7ed193f89a292e1999608170dcc9751a7462a87dfd5bc0", size = 1743131, upload-time = "2026-01-03T17:30:58.256Z" },
+    { url = "https://files.pythonhosted.org/packages/04/98/3d21dde21889b17ca2eea54fdcff21b27b93f45b7bb94ca029c31ab59dc3/aiohttp-3.13.3-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:fc290605db2a917f6e81b0e1e0796469871f5af381ce15c604a3c5c7e51cb730", size = 1556863, upload-time = "2026-01-03T17:31:00.445Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/84/da0c3ab1192eaf64782b03971ab4055b475d0db07b17eff925e8c93b3aa5/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:4021b51936308aeea0367b8f006dc999ca02bc118a0cc78c303f50a2ff6afb91", size = 1682793, upload-time = "2026-01-03T17:31:03.024Z" },
+    { url = "https://files.pythonhosted.org/packages/ff/0f/5802ada182f575afa02cbd0ec5180d7e13a402afb7c2c03a9aa5e5d49060/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:49a03727c1bba9a97d3e93c9f93ca03a57300f484b6e935463099841261195d3", size = 1716676, upload-time = "2026-01-03T17:31:04.842Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/8c/714d53bd8b5a4560667f7bbbb06b20c2382f9c7847d198370ec6526af39c/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:3d9908a48eb7416dc1f4524e69f1d32e5d90e3981e4e37eb0aa1cd18f9cfa2a4", size = 1733217, upload-time = "2026-01-03T17:31:06.868Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/79/e2176f46d2e963facea939f5be2d26368ce543622be6f00a12844d3c991f/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:2712039939ec963c237286113c68dbad80a82a4281543f3abf766d9d73228998", size = 1552303, upload-time = "2026-01-03T17:31:08.958Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/6a/28ed4dea1759916090587d1fe57087b03e6c784a642b85ef48217b0277ae/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:7bfdc049127717581866fa4708791220970ce291c23e28ccf3922c700740fdc0", size = 1763673, upload-time = "2026-01-03T17:31:10.676Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/35/4a3daeb8b9fab49240d21c04d50732313295e4bd813a465d840236dd0ce1/aiohttp-3.13.3-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:8057c98e0c8472d8846b9c79f56766bcc57e3e8ac7bfd510482332366c56c591", size = 1721120, upload-time = "2026-01-03T17:31:12.575Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/9f/d643bb3c5fb99547323e635e251c609fbbc660d983144cfebec529e09264/aiohttp-3.13.3-cp313-cp313-win32.whl", hash = "sha256:1449ceddcdbcf2e0446957863af03ebaaa03f94c090f945411b61269e2cb5daf", size = 427383, upload-time = "2026-01-03T17:31:14.382Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/f1/ab0395f8a79933577cdd996dd2f9aa6014af9535f65dddcf88204682fe62/aiohttp-3.13.3-cp313-cp313-win_amd64.whl", hash = "sha256:693781c45a4033d31d4187d2436f5ac701e7bbfe5df40d917736108c1cc7436e", size = 453899, upload-time = "2026-01-03T17:31:15.958Z" },
+    { url = "https://files.pythonhosted.org/packages/99/36/5b6514a9f5d66f4e2597e40dea2e3db271e023eb7a5d22defe96ba560996/aiohttp-3.13.3-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:ea37047c6b367fd4bd632bff8077449b8fa034b69e812a18e0132a00fae6e808", size = 737238, upload-time = "2026-01-03T17:31:17.909Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/49/459327f0d5bcd8c6c9ca69e60fdeebc3622861e696490d8674a6d0cb90a6/aiohttp-3.13.3-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:6fc0e2337d1a4c3e6acafda6a78a39d4c14caea625124817420abceed36e2415", size = 492292, upload-time = "2026-01-03T17:31:19.919Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/0b/b97660c5fd05d3495b4eb27f2d0ef18dc1dc4eff7511a9bf371397ff0264/aiohttp-3.13.3-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:c685f2d80bb67ca8c3837823ad76196b3694b0159d232206d1e461d3d434666f", size = 493021, upload-time = "2026-01-03T17:31:21.636Z" },
+    { url = "https://files.pythonhosted.org/packages/54/d4/438efabdf74e30aeceb890c3290bbaa449780583b1270b00661126b8aae4/aiohttp-3.13.3-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:48e377758516d262bde50c2584fc6c578af272559c409eecbdd2bae1601184d6", size = 1717263, upload-time = "2026-01-03T17:31:23.296Z" },
+    { url = "https://files.pythonhosted.org/packages/71/f2/7bddc7fd612367d1459c5bcf598a9e8f7092d6580d98de0e057eb42697ad/aiohttp-3.13.3-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:34749271508078b261c4abb1767d42b8d0c0cc9449c73a4df494777dc55f0687", size = 1669107, upload-time = "2026-01-03T17:31:25.334Z" },
+    { url = "https://files.pythonhosted.org/packages/00/5a/1aeaecca40e22560f97610a329e0e5efef5e0b5afdf9f857f0d93839ab2e/aiohttp-3.13.3-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:82611aeec80eb144416956ec85b6ca45a64d76429c1ed46ae1b5f86c6e0c9a26", size = 1760196, upload-time = "2026-01-03T17:31:27.394Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/f8/0ff6992bea7bd560fc510ea1c815f87eedd745fe035589c71ce05612a19a/aiohttp-3.13.3-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2fff83cfc93f18f215896e3a190e8e5cb413ce01553901aca925176e7568963a", size = 1843591, upload-time = "2026-01-03T17:31:29.238Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/d1/e30e537a15f53485b61f5be525f2157da719819e8377298502aebac45536/aiohttp-3.13.3-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bbe7d4cecacb439e2e2a8a1a7b935c25b812af7a5fd26503a66dadf428e79ec1", size = 1720277, upload-time = "2026-01-03T17:31:31.053Z" },
+    { url = "https://files.pythonhosted.org/packages/84/45/23f4c451d8192f553d38d838831ebbc156907ea6e05557f39563101b7717/aiohttp-3.13.3-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:b928f30fe49574253644b1ca44b1b8adbd903aa0da4b9054a6c20fc7f4092a25", size = 1548575, upload-time = "2026-01-03T17:31:32.87Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/ed/0a42b127a43712eda7807e7892c083eadfaf8429ca8fb619662a530a3aab/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:7b5e8fe4de30df199155baaf64f2fcd604f4c678ed20910db8e2c66dc4b11603", size = 1679455, upload-time = "2026-01-03T17:31:34.76Z" },
+    { url = "https://files.pythonhosted.org/packages/2e/b5/c05f0c2b4b4fe2c9d55e73b6d3ed4fd6c9dc2684b1d81cbdf77e7fad9adb/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:8542f41a62bcc58fc7f11cf7c90e0ec324ce44950003feb70640fc2a9092c32a", size = 1687417, upload-time = "2026-01-03T17:31:36.699Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/6b/915bc5dad66aef602b9e459b5a973529304d4e89ca86999d9d75d80cbd0b/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:5e1d8c8b8f1d91cd08d8f4a3c2b067bfca6ec043d3ff36de0f3a715feeedf926", size = 1729968, upload-time = "2026-01-03T17:31:38.622Z" },
+    { url = "https://files.pythonhosted.org/packages/11/3b/e84581290a9520024a08640b63d07673057aec5ca548177a82026187ba73/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:90455115e5da1c3c51ab619ac57f877da8fd6d73c05aacd125c5ae9819582aba", size = 1545690, upload-time = "2026-01-03T17:31:40.57Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/04/0c3655a566c43fd647c81b895dfe361b9f9ad6d58c19309d45cff52d6c3b/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:042e9e0bcb5fba81886c8b4fbb9a09d6b8a00245fd8d88e4d989c1f96c74164c", size = 1746390, upload-time = "2026-01-03T17:31:42.857Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/53/71165b26978f719c3419381514c9690bd5980e764a09440a10bb816ea4ab/aiohttp-3.13.3-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:2eb752b102b12a76ca02dff751a801f028b4ffbbc478840b473597fc91a9ed43", size = 1702188, upload-time = "2026-01-03T17:31:44.984Z" },
+    { url = "https://files.pythonhosted.org/packages/29/a7/cbe6c9e8e136314fa1980da388a59d2f35f35395948a08b6747baebb6aa6/aiohttp-3.13.3-cp314-cp314-win32.whl", hash = "sha256:b556c85915d8efaed322bf1bdae9486aa0f3f764195a0fb6ee962e5c71ef5ce1", size = 433126, upload-time = "2026-01-03T17:31:47.463Z" },
+    { url = "https://files.pythonhosted.org/packages/de/56/982704adea7d3b16614fc5936014e9af85c0e34b58f9046655817f04306e/aiohttp-3.13.3-cp314-cp314-win_amd64.whl", hash = "sha256:9bf9f7a65e7aa20dd764151fb3d616c81088f91f8df39c3893a536e279b4b984", size = 459128, upload-time = "2026-01-03T17:31:49.2Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/2a/3c79b638a9c3d4658d345339d22070241ea341ed4e07b5ac60fb0f418003/aiohttp-3.13.3-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:05861afbbec40650d8a07ea324367cb93e9e8cc7762e04dd4405df99fa65159c", size = 769512, upload-time = "2026-01-03T17:31:51.134Z" },
+    { url = "https://files.pythonhosted.org/packages/29/b9/3e5014d46c0ab0db8707e0ac2711ed28c4da0218c358a4e7c17bae0d8722/aiohttp-3.13.3-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:2fc82186fadc4a8316768d61f3722c230e2c1dcab4200d52d2ebdf2482e47592", size = 506444, upload-time = "2026-01-03T17:31:52.85Z" },
+    { url = "https://files.pythonhosted.org/packages/90/03/c1d4ef9a054e151cd7839cdc497f2638f00b93cbe8043983986630d7a80c/aiohttp-3.13.3-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:0add0900ff220d1d5c5ebbf99ed88b0c1bbf87aa7e4262300ed1376a6b13414f", size = 510798, upload-time = "2026-01-03T17:31:54.91Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/76/8c1e5abbfe8e127c893fe7ead569148a4d5a799f7cf958d8c09f3eedf097/aiohttp-3.13.3-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:568f416a4072fbfae453dcf9a99194bbb8bdeab718e08ee13dfa2ba0e4bebf29", size = 1868835, upload-time = "2026-01-03T17:31:56.733Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/ac/984c5a6f74c363b01ff97adc96a3976d9c98940b8969a1881575b279ac5d/aiohttp-3.13.3-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:add1da70de90a2569c5e15249ff76a631ccacfe198375eead4aadf3b8dc849dc", size = 1720486, upload-time = "2026-01-03T17:31:58.65Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/9a/b7039c5f099c4eb632138728828b33428585031a1e658d693d41d07d89d1/aiohttp-3.13.3-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:10b47b7ba335d2e9b1239fa571131a87e2d8ec96b333e68b2a305e7a98b0bae2", size = 1847951, upload-time = "2026-01-03T17:32:00.989Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/02/3bec2b9a1ba3c19ff89a43a19324202b8eb187ca1e928d8bdac9bbdddebd/aiohttp-3.13.3-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:3dd4dce1c718e38081c8f35f323209d4c1df7d4db4bab1b5c88a6b4d12b74587", size = 1941001, upload-time = "2026-01-03T17:32:03.122Z" },
+    { url = "https://files.pythonhosted.org/packages/37/df/d879401cedeef27ac4717f6426c8c36c3091c6e9f08a9178cc87549c537f/aiohttp-3.13.3-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:34bac00a67a812570d4a460447e1e9e06fae622946955f939051e7cc895cfab8", size = 1797246, upload-time = "2026-01-03T17:32:05.255Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/15/be122de1f67e6953add23335c8ece6d314ab67c8bebb3f181063010795a7/aiohttp-3.13.3-cp314-cp314t-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:a19884d2ee70b06d9204b2727a7b9f983d0c684c650254679e716b0b77920632", size = 1627131, upload-time = "2026-01-03T17:32:07.607Z" },
+    { url = "https://files.pythonhosted.org/packages/12/12/70eedcac9134cfa3219ab7af31ea56bc877395b1ac30d65b1bc4b27d0438/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:5f8ca7f2bb6ba8348a3614c7918cc4bb73268c5ac2a207576b7afea19d3d9f64", size = 1795196, upload-time = "2026-01-03T17:32:09.59Z" },
+    { url = "https://files.pythonhosted.org/packages/32/11/b30e1b1cd1f3054af86ebe60df96989c6a414dd87e27ad16950eee420bea/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:b0d95340658b9d2f11d9697f59b3814a9d3bb4b7a7c20b131df4bcef464037c0", size = 1782841, upload-time = "2026-01-03T17:32:11.445Z" },
+    { url = "https://files.pythonhosted.org/packages/88/0d/d98a9367b38912384a17e287850f5695c528cff0f14f791ce8ee2e4f7796/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:a1e53262fd202e4b40b70c3aff944a8155059beedc8a89bba9dc1f9ef06a1b56", size = 1795193, upload-time = "2026-01-03T17:32:13.705Z" },
+    { url = "https://files.pythonhosted.org/packages/43/a5/a2dfd1f5ff5581632c7f6a30e1744deda03808974f94f6534241ef60c751/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_riscv64.whl", hash = "sha256:d60ac9663f44168038586cab2157e122e46bdef09e9368b37f2d82d354c23f72", size = 1621979, upload-time = "2026-01-03T17:32:15.965Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/f0/12973c382ae7c1cccbc4417e129c5bf54c374dfb85af70893646e1f0e749/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:90751b8eed69435bac9ff4e3d2f6b3af1f57e37ecb0fbeee59c0174c9e2d41df", size = 1822193, upload-time = "2026-01-03T17:32:18.219Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/5f/24155e30ba7f8c96918af1350eb0663e2430aad9e001c0489d89cd708ab1/aiohttp-3.13.3-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:fc353029f176fd2b3ec6cfc71be166aba1936fe5d73dd1992ce289ca6647a9aa", size = 1769801, upload-time = "2026-01-03T17:32:20.25Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/f8/7314031ff5c10e6ece114da79b338ec17eeff3a079e53151f7e9f43c4723/aiohttp-3.13.3-cp314-cp314t-win32.whl", hash = "sha256:2e41b18a58da1e474a057b3d35248d8320029f61d70a37629535b16a0c8f3767", size = 466523, upload-time = "2026-01-03T17:32:22.215Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/63/278a98c715ae467624eafe375542d8ba9b4383a016df8fdefe0ae28382a7/aiohttp-3.13.3-cp314-cp314t-win_amd64.whl", hash = "sha256:44531a36aa2264a1860089ffd4dce7baf875ee5a6079d5fb42e261c704ef7344", size = 499694, upload-time = "2026-01-03T17:32:24.546Z" },
+]
+
+[[package]]
+name = "aiosignal"
+version = "1.4.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "frozenlist" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/61/62/06741b579156360248d1ec624842ad0edf697050bbaf7c3e46394e106ad1/aiosignal-1.4.0.tar.gz", hash = "sha256:f47eecd9468083c2029cc99945502cb7708b082c232f9aca65da147157b251c7", size = 25007, upload-time = "2025-07-03T22:54:43.528Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/fb/76/641ae371508676492379f16e2fa48f4e2c11741bd63c48be4b12a6b09cba/aiosignal-1.4.0-py3-none-any.whl", hash = "sha256:053243f8b92b990551949e63930a839ff0cf0b0ebbe0597b0f3fb19e1a0fe82e", size = 7490, upload-time = "2025-07-03T22:54:42.156Z" },
+]
+
+[[package]]
+name = "annotated-types"
+version = "0.7.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/ee/67/531ea369ba64dcff5ec9c3402f9f51bf748cec26dde048a2f973a4eea7f5/annotated_types-0.7.0.tar.gz", hash = "sha256:aff07c09a53a08bc8cfccb9c85b05f1aa9a2a6f23728d790723543408344ce89", size = 16081, upload-time = "2024-05-20T21:33:25.928Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/78/b6/6307fbef88d9b5ee7421e68d78a9f162e0da4900bc5f5793f6d3d0e34fb8/annotated_types-0.7.0-py3-none-any.whl", hash = "sha256:1f02e8b43a8fbbc3f3e0d4f0f4bfc8131bcb4eebe8849b8e5c773f3a1c582a53", size = 13643, upload-time = "2024-05-20T21:33:24.1Z" },
+]
+
+[[package]]
+name = "anyio"
+version = "4.12.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/96/f0/5eb65b2bb0d09ac6776f2eb54adee6abe8228ea05b20a5ad0e4945de8aac/anyio-4.12.1.tar.gz", hash = "sha256:41cfcc3a4c85d3f05c932da7c26d0201ac36f72abd4435ba90d0464a3ffed703", size = 228685, upload-time = "2026-01-06T11:45:21.246Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/38/0e/27be9fdef66e72d64c0cdc3cc2823101b80585f8119b5c112c2e8f5f7dab/anyio-4.12.1-py3-none-any.whl", hash = "sha256:d405828884fc140aa80a3c667b8beed277f1dfedec42ba031bd6ac3db606ab6c", size = 113592, upload-time = "2026-01-06T11:45:19.497Z" },
+]
+
+[[package]]
+name = "attrs"
+version = "25.4.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6b/5c/685e6633917e101e5dcb62b9dd76946cbb57c26e133bae9e0cd36033c0a9/attrs-25.4.0.tar.gz", hash = "sha256:16d5969b87f0859ef33a48b35d55ac1be6e42ae49d5e853b597db70c35c57e11", size = 934251, upload-time = "2025-10-06T13:54:44.725Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3a/2a/7cc015f5b9f5db42b7d48157e23356022889fc354a2813c15934b7cb5c0e/attrs-25.4.0-py3-none-any.whl", hash = "sha256:adcf7e2a1fb3b36ac48d97835bb6d8ade15b8dcce26aba8bf1d14847b57a3373", size = 67615, upload-time = "2025-10-06T13:54:43.17Z" },
+]
+
+[[package]]
+name = "certifi"
+version = "2026.1.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e0/2d/a891ca51311197f6ad14a7ef42e2399f36cf2f9bd44752b3dc4eab60fdc5/certifi-2026.1.4.tar.gz", hash = "sha256:ac726dd470482006e014ad384921ed6438c457018f4b3d204aea4281258b2120", size = 154268, upload-time = "2026-01-04T02:42:41.825Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e6/ad/3cc14f097111b4de0040c83a525973216457bbeeb63739ef1ed275c1c021/certifi-2026.1.4-py3-none-any.whl", hash = "sha256:9943707519e4add1115f44c2bc244f782c0249876bf51b6599fee1ffbedd685c", size = 152900, upload-time = "2026-01-04T02:42:40.15Z" },
+]
+
+[[package]]
+name = "charset-normalizer"
+version = "3.4.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/13/69/33ddede1939fdd074bce5434295f38fae7136463422fe4fd3e0e89b98062/charset_normalizer-3.4.4.tar.gz", hash = "sha256:94537985111c35f28720e43603b8e7b43a6ecfb2ce1d3058bbe955b73404e21a", size = 129418, upload-time = "2025-10-14T04:42:32.879Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/f3/85/1637cd4af66fa687396e757dec650f28025f2a2f5a5531a3208dc0ec43f2/charset_normalizer-3.4.4-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:0a98e6759f854bd25a58a73fa88833fba3b7c491169f86ce1180c948ab3fd394", size = 208425, upload-time = "2025-10-14T04:40:53.353Z" },
+    { url = "https://files.pythonhosted.org/packages/9d/6a/04130023fef2a0d9c62d0bae2649b69f7b7d8d24ea5536feef50551029df/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b5b290ccc2a263e8d185130284f8501e3e36c5e02750fc6b6bdeb2e9e96f1e25", size = 148162, upload-time = "2025-10-14T04:40:54.558Z" },
+    { url = "https://files.pythonhosted.org/packages/78/29/62328d79aa60da22c9e0b9a66539feae06ca0f5a4171ac4f7dc285b83688/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74bb723680f9f7a6234dcf67aea57e708ec1fbdf5699fb91dfd6f511b0a320ef", size = 144558, upload-time = "2025-10-14T04:40:55.677Z" },
+    { url = "https://files.pythonhosted.org/packages/86/bb/b32194a4bf15b88403537c2e120b817c61cd4ecffa9b6876e941c3ee38fe/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f1e34719c6ed0b92f418c7c780480b26b5d9c50349e9a9af7d76bf757530350d", size = 161497, upload-time = "2025-10-14T04:40:57.217Z" },
+    { url = "https://files.pythonhosted.org/packages/19/89/a54c82b253d5b9b111dc74aca196ba5ccfcca8242d0fb64146d4d3183ff1/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:2437418e20515acec67d86e12bf70056a33abdacb5cb1655042f6538d6b085a8", size = 159240, upload-time = "2025-10-14T04:40:58.358Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/10/d20b513afe03acc89ec33948320a5544d31f21b05368436d580dec4e234d/charset_normalizer-3.4.4-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:11d694519d7f29d6cd09f6ac70028dba10f92f6cdd059096db198c283794ac86", size = 153471, upload-time = "2025-10-14T04:40:59.468Z" },
+    { url = "https://files.pythonhosted.org/packages/61/fa/fbf177b55bdd727010f9c0a3c49eefa1d10f960e5f09d1d887bf93c2e698/charset_normalizer-3.4.4-cp312-cp312-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:ac1c4a689edcc530fc9d9aa11f5774b9e2f33f9a0c6a57864e90908f5208d30a", size = 150864, upload-time = "2025-10-14T04:41:00.623Z" },
+    { url = "https://files.pythonhosted.org/packages/05/12/9fbc6a4d39c0198adeebbde20b619790e9236557ca59fc40e0e3cebe6f40/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:21d142cc6c0ec30d2efee5068ca36c128a30b0f2c53c1c07bd78cb6bc1d3be5f", size = 150647, upload-time = "2025-10-14T04:41:01.754Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/1f/6a9a593d52e3e8c5d2b167daf8c6b968808efb57ef4c210acb907c365bc4/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:5dbe56a36425d26d6cfb40ce79c314a2e4dd6211d51d6d2191c00bed34f354cc", size = 145110, upload-time = "2025-10-14T04:41:03.231Z" },
+    { url = "https://files.pythonhosted.org/packages/30/42/9a52c609e72471b0fc54386dc63c3781a387bb4fe61c20231a4ebcd58bdd/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:5bfbb1b9acf3334612667b61bd3002196fe2a1eb4dd74d247e0f2a4d50ec9bbf", size = 162839, upload-time = "2025-10-14T04:41:04.715Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/5b/c0682bbf9f11597073052628ddd38344a3d673fda35a36773f7d19344b23/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_riscv64.whl", hash = "sha256:d055ec1e26e441f6187acf818b73564e6e6282709e9bcb5b63f5b23068356a15", size = 150667, upload-time = "2025-10-14T04:41:05.827Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/24/a41afeab6f990cf2daf6cb8c67419b63b48cf518e4f56022230840c9bfb2/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:af2d8c67d8e573d6de5bc30cdb27e9b95e49115cd9baad5ddbd1a6207aaa82a9", size = 160535, upload-time = "2025-10-14T04:41:06.938Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/e5/6a4ce77ed243c4a50a1fecca6aaaab419628c818a49434be428fe24c9957/charset_normalizer-3.4.4-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:780236ac706e66881f3b7f2f32dfe90507a09e67d1d454c762cf642e6e1586e0", size = 154816, upload-time = "2025-10-14T04:41:08.101Z" },
+    { url = "https://files.pythonhosted.org/packages/a8/ef/89297262b8092b312d29cdb2517cb1237e51db8ecef2e9af5edbe7b683b1/charset_normalizer-3.4.4-cp312-cp312-win32.whl", hash = "sha256:5833d2c39d8896e4e19b689ffc198f08ea58116bee26dea51e362ecc7cd3ed26", size = 99694, upload-time = "2025-10-14T04:41:09.23Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/2d/1e5ed9dd3b3803994c155cd9aacb60c82c331bad84daf75bcb9c91b3295e/charset_normalizer-3.4.4-cp312-cp312-win_amd64.whl", hash = "sha256:a79cfe37875f822425b89a82333404539ae63dbdddf97f84dcbc3d339aae9525", size = 107131, upload-time = "2025-10-14T04:41:10.467Z" },
+    { url = "https://files.pythonhosted.org/packages/d0/d9/0ed4c7098a861482a7b6a95603edce4c0d9db2311af23da1fb2b75ec26fc/charset_normalizer-3.4.4-cp312-cp312-win_arm64.whl", hash = "sha256:376bec83a63b8021bb5c8ea75e21c4ccb86e7e45ca4eb81146091b56599b80c3", size = 100390, upload-time = "2025-10-14T04:41:11.915Z" },
+    { url = "https://files.pythonhosted.org/packages/97/45/4b3a1239bbacd321068ea6e7ac28875b03ab8bc0aa0966452db17cd36714/charset_normalizer-3.4.4-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:e1f185f86a6f3403aa2420e815904c67b2f9ebc443f045edd0de921108345794", size = 208091, upload-time = "2025-10-14T04:41:13.346Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/62/73a6d7450829655a35bb88a88fca7d736f9882a27eacdca2c6d505b57e2e/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:6b39f987ae8ccdf0d2642338faf2abb1862340facc796048b604ef14919e55ed", size = 147936, upload-time = "2025-10-14T04:41:14.461Z" },
+    { url = "https://files.pythonhosted.org/packages/89/c5/adb8c8b3d6625bef6d88b251bbb0d95f8205831b987631ab0c8bb5d937c2/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3162d5d8ce1bb98dd51af660f2121c55d0fa541b46dff7bb9b9f86ea1d87de72", size = 144180, upload-time = "2025-10-14T04:41:15.588Z" },
+    { url = "https://files.pythonhosted.org/packages/91/ed/9706e4070682d1cc219050b6048bfd293ccf67b3d4f5a4f39207453d4b99/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:81d5eb2a312700f4ecaa977a8235b634ce853200e828fbadf3a9c50bab278328", size = 161346, upload-time = "2025-10-14T04:41:16.738Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/0d/031f0d95e4972901a2f6f09ef055751805ff541511dc1252ba3ca1f80cf5/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5bd2293095d766545ec1a8f612559f6b40abc0eb18bb2f5d1171872d34036ede", size = 158874, upload-time = "2025-10-14T04:41:17.923Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/83/6ab5883f57c9c801ce5e5677242328aa45592be8a00644310a008d04f922/charset_normalizer-3.4.4-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a8a8b89589086a25749f471e6a900d3f662d1d3b6e2e59dcecf787b1cc3a1894", size = 153076, upload-time = "2025-10-14T04:41:19.106Z" },
+    { url = "https://files.pythonhosted.org/packages/75/1e/5ff781ddf5260e387d6419959ee89ef13878229732732ee73cdae01800f2/charset_normalizer-3.4.4-cp313-cp313-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:bc7637e2f80d8530ee4a78e878bce464f70087ce73cf7c1caf142416923b98f1", size = 150601, upload-time = "2025-10-14T04:41:20.245Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/57/71be810965493d3510a6ca79b90c19e48696fb1ff964da319334b12677f0/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f8bf04158c6b607d747e93949aa60618b61312fe647a6369f88ce2ff16043490", size = 150376, upload-time = "2025-10-14T04:41:21.398Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/d5/c3d057a78c181d007014feb7e9f2e65905a6c4ef182c0ddf0de2924edd65/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:554af85e960429cf30784dd47447d5125aaa3b99a6f0683589dbd27e2f45da44", size = 144825, upload-time = "2025-10-14T04:41:22.583Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/8c/d0406294828d4976f275ffbe66f00266c4b3136b7506941d87c00cab5272/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:74018750915ee7ad843a774364e13a3db91682f26142baddf775342c3f5b1133", size = 162583, upload-time = "2025-10-14T04:41:23.754Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/24/e2aa1f18c8f15c4c0e932d9287b8609dd30ad56dbe41d926bd846e22fb8d/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_riscv64.whl", hash = "sha256:c0463276121fdee9c49b98908b3a89c39be45d86d1dbaa22957e38f6321d4ce3", size = 150366, upload-time = "2025-10-14T04:41:25.27Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/5b/1e6160c7739aad1e2df054300cc618b06bf784a7a164b0f238360721ab86/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:362d61fd13843997c1c446760ef36f240cf81d3ebf74ac62652aebaf7838561e", size = 160300, upload-time = "2025-10-14T04:41:26.725Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/10/f882167cd207fbdd743e55534d5d9620e095089d176d55cb22d5322f2afd/charset_normalizer-3.4.4-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a26f18905b8dd5d685d6d07b0cdf98a79f3c7a918906af7cc143ea2e164c8bc", size = 154465, upload-time = "2025-10-14T04:41:28.322Z" },
+    { url = "https://files.pythonhosted.org/packages/89/66/c7a9e1b7429be72123441bfdbaf2bc13faab3f90b933f664db506dea5915/charset_normalizer-3.4.4-cp313-cp313-win32.whl", hash = "sha256:9b35f4c90079ff2e2edc5b26c0c77925e5d2d255c42c74fdb70fb49b172726ac", size = 99404, upload-time = "2025-10-14T04:41:29.95Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/26/b9924fa27db384bdcd97ab83b4f0a8058d96ad9626ead570674d5e737d90/charset_normalizer-3.4.4-cp313-cp313-win_amd64.whl", hash = "sha256:b435cba5f4f750aa6c0a0d92c541fb79f69a387c91e61f1795227e4ed9cece14", size = 107092, upload-time = "2025-10-14T04:41:31.188Z" },
+    { url = "https://files.pythonhosted.org/packages/af/8f/3ed4bfa0c0c72a7ca17f0380cd9e4dd842b09f664e780c13cff1dcf2ef1b/charset_normalizer-3.4.4-cp313-cp313-win_arm64.whl", hash = "sha256:542d2cee80be6f80247095cc36c418f7bddd14f4a6de45af91dfad36d817bba2", size = 100408, upload-time = "2025-10-14T04:41:32.624Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/35/7051599bd493e62411d6ede36fd5af83a38f37c4767b92884df7301db25d/charset_normalizer-3.4.4-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:da3326d9e65ef63a817ecbcc0df6e94463713b754fe293eaa03da99befb9a5bd", size = 207746, upload-time = "2025-10-14T04:41:33.773Z" },
+    { url = "https://files.pythonhosted.org/packages/10/9a/97c8d48ef10d6cd4fcead2415523221624bf58bcf68a802721a6bc807c8f/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:8af65f14dc14a79b924524b1e7fffe304517b2bff5a58bf64f30b98bbc5079eb", size = 147889, upload-time = "2025-10-14T04:41:34.897Z" },
+    { url = "https://files.pythonhosted.org/packages/10/bf/979224a919a1b606c82bd2c5fa49b5c6d5727aa47b4312bb27b1734f53cd/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:74664978bb272435107de04e36db5a9735e78232b85b77d45cfb38f758efd33e", size = 143641, upload-time = "2025-10-14T04:41:36.116Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/33/0ad65587441fc730dc7bd90e9716b30b4702dc7b617e6ba4997dc8651495/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:752944c7ffbfdd10c074dc58ec2d5a8a4cd9493b314d367c14d24c17684ddd14", size = 160779, upload-time = "2025-10-14T04:41:37.229Z" },
+    { url = "https://files.pythonhosted.org/packages/67/ed/331d6b249259ee71ddea93f6f2f0a56cfebd46938bde6fcc6f7b9a3d0e09/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d1f13550535ad8cff21b8d757a3257963e951d96e20ec82ab44bc64aeb62a191", size = 159035, upload-time = "2025-10-14T04:41:38.368Z" },
+    { url = "https://files.pythonhosted.org/packages/67/ff/f6b948ca32e4f2a4576aa129d8bed61f2e0543bf9f5f2b7fc3758ed005c9/charset_normalizer-3.4.4-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:ecaae4149d99b1c9e7b88bb03e3221956f68fd6d50be2ef061b2381b61d20838", size = 152542, upload-time = "2025-10-14T04:41:39.862Z" },
+    { url = "https://files.pythonhosted.org/packages/16/85/276033dcbcc369eb176594de22728541a925b2632f9716428c851b149e83/charset_normalizer-3.4.4-cp314-cp314-manylinux_2_31_riscv64.manylinux_2_39_riscv64.whl", hash = "sha256:cb6254dc36b47a990e59e1068afacdcd02958bdcce30bb50cc1700a8b9d624a6", size = 149524, upload-time = "2025-10-14T04:41:41.319Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/f2/6a2a1f722b6aba37050e626530a46a68f74e63683947a8acff92569f979a/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:c8ae8a0f02f57a6e61203a31428fa1d677cbe50c93622b4149d5c0f319c1d19e", size = 150395, upload-time = "2025-10-14T04:41:42.539Z" },
+    { url = "https://files.pythonhosted.org/packages/60/bb/2186cb2f2bbaea6338cad15ce23a67f9b0672929744381e28b0592676824/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:47cc91b2f4dd2833fddaedd2893006b0106129d4b94fdb6af1f4ce5a9965577c", size = 143680, upload-time = "2025-10-14T04:41:43.661Z" },
+    { url = "https://files.pythonhosted.org/packages/7d/a5/bf6f13b772fbb2a90360eb620d52ed8f796f3c5caee8398c3b2eb7b1c60d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:82004af6c302b5d3ab2cfc4cc5f29db16123b1a8417f2e25f9066f91d4411090", size = 162045, upload-time = "2025-10-14T04:41:44.821Z" },
+    { url = "https://files.pythonhosted.org/packages/df/c5/d1be898bf0dc3ef9030c3825e5d3b83f2c528d207d246cbabe245966808d/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_riscv64.whl", hash = "sha256:2b7d8f6c26245217bd2ad053761201e9f9680f8ce52f0fcd8d0755aeae5b2152", size = 149687, upload-time = "2025-10-14T04:41:46.442Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/42/90c1f7b9341eef50c8a1cb3f098ac43b0508413f33affd762855f67a410e/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:799a7a5e4fb2d5898c60b640fd4981d6a25f1c11790935a44ce38c54e985f828", size = 160014, upload-time = "2025-10-14T04:41:47.631Z" },
+    { url = "https://files.pythonhosted.org/packages/76/be/4d3ee471e8145d12795ab655ece37baed0929462a86e72372fd25859047c/charset_normalizer-3.4.4-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:99ae2cffebb06e6c22bdc25801d7b30f503cc87dbd283479e7b606f70aff57ec", size = 154044, upload-time = "2025-10-14T04:41:48.81Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/6f/8f7af07237c34a1defe7defc565a9bc1807762f672c0fde711a4b22bf9c0/charset_normalizer-3.4.4-cp314-cp314-win32.whl", hash = "sha256:f9d332f8c2a2fcbffe1378594431458ddbef721c1769d78e2cbc06280d8155f9", size = 99940, upload-time = "2025-10-14T04:41:49.946Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/51/8ade005e5ca5b0d80fb4aff72a3775b325bdc3d27408c8113811a7cbe640/charset_normalizer-3.4.4-cp314-cp314-win_amd64.whl", hash = "sha256:8a6562c3700cce886c5be75ade4a5db4214fda19fede41d9792d100288d8f94c", size = 107104, upload-time = "2025-10-14T04:41:51.051Z" },
+    { url = "https://files.pythonhosted.org/packages/da/5f/6b8f83a55bb8278772c5ae54a577f3099025f9ade59d0136ac24a0df4bde/charset_normalizer-3.4.4-cp314-cp314-win_arm64.whl", hash = "sha256:de00632ca48df9daf77a2c65a484531649261ec9f25489917f09e455cb09ddb2", size = 100743, upload-time = "2025-10-14T04:41:52.122Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/4c/925909008ed5a988ccbb72dcc897407e5d6d3bd72410d69e051fc0c14647/charset_normalizer-3.4.4-py3-none-any.whl", hash = "sha256:7a32c560861a02ff789ad905a2fe94e3f840803362c84fecf1851cb4cf3dc37f", size = 53402, upload-time = "2025-10-14T04:42:31.76Z" },
+]
+
+[[package]]
+name = "colorama"
+version = "0.4.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/d8/53/6f443c9a4a8358a93a6792e2acffb9d9d5cb0a5cfd8802644b7b1c9a02e4/colorama-0.4.6.tar.gz", hash = "sha256:08695f5cb7ed6e0531a20572697297273c47b8cae5a63ffc6d6ed5c201be6e44", size = 27697, upload-time = "2022-10-25T02:36:22.414Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d1/d6/3965ed04c63042e047cb6a3e6ed1a63a35087b6a609aa3a15ed8ac56c221/colorama-0.4.6-py2.py3-none-any.whl", hash = "sha256:4f1d9991f5acc0ca119f9d443620b77f9d6b33703e51011c16baf57afb285fc6", size = 25335, upload-time = "2022-10-25T02:36:20.889Z" },
+]
+
+[[package]]
+name = "dataclass-wizard"
+version = "0.39.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/36/ea/6b2811092feecbe9d672e3641196ac5fcbec6664074da5dec8b9fd9b9059/dataclass_wizard-0.39.1.tar.gz", hash = "sha256:1679948ed7c62103f40b34df97d03b35e6b2ad50f58173fdbe30074e2e4730f2", size = 361190, upload-time = "2026-01-06T03:30:57.054Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/27/a0/a221942b3fbbafaea4e211744d298366b6a9712c1aa336b05fc1c865ac0c/dataclass_wizard-0.39.1-py3-none-any.whl", hash = "sha256:3324e59eca705882eb34e2b3989b2beadd8c2b523e6269d4002cf1a4a5bf703b", size = 215344, upload-time = "2026-01-06T03:30:54.915Z" },
+]
+
+[[package]]
+name = "deepgram-sdk"
+version = "5.3.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "httpx" },
+    { name = "pydantic" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "websockets" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b8/76/ba0f925f955e171ed789c7f3626251c78786cce09ddc122ac92fe1cc508d/deepgram_sdk-5.3.1.tar.gz", hash = "sha256:87336787c3072d324a0fa412364668adec73175a9f6f0fdd4f91983f734c2842", size = 171393, upload-time = "2026-01-08T14:08:28.617Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c6/97/af202d6e77403e675d0e48d2a9ccba78437d1537858c9d1667af6d823116/deepgram_sdk-5.3.1-py3-none-any.whl", hash = "sha256:13e9d77552130da51d54c229900b393f96942333ea8e74be0364f8aa8e6afbc5", size = 505950, upload-time = "2026-01-08T14:08:26.574Z" },
+]
+
+[[package]]
+name = "frozenlist"
+version = "1.8.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2d/f5/c831fac6cc817d26fd54c7eaccd04ef7e0288806943f7cc5bbf69f3ac1f0/frozenlist-1.8.0.tar.gz", hash = "sha256:3ede829ed8d842f6cd48fc7081d7a41001a56f1f38603f9d49bf3020d59a31ad", size = 45875, upload-time = "2025-10-06T05:38:17.865Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/69/29/948b9aa87e75820a38650af445d2ef2b6b8a6fab1a23b6bb9e4ef0be2d59/frozenlist-1.8.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:78f7b9e5d6f2fdb88cdde9440dc147259b62b9d3b019924def9f6478be254ac1", size = 87782, upload-time = "2025-10-06T05:36:06.649Z" },
+    { url = "https://files.pythonhosted.org/packages/64/80/4f6e318ee2a7c0750ed724fa33a4bdf1eacdc5a39a7a24e818a773cd91af/frozenlist-1.8.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:229bf37d2e4acdaf808fd3f06e854a4a7a3661e871b10dc1f8f1896a3b05f18b", size = 50594, upload-time = "2025-10-06T05:36:07.69Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/94/5c8a2b50a496b11dd519f4a24cb5496cf125681dd99e94c604ccdea9419a/frozenlist-1.8.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:f833670942247a14eafbb675458b4e61c82e002a148f49e68257b79296e865c4", size = 50448, upload-time = "2025-10-06T05:36:08.78Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/bd/d91c5e39f490a49df14320f4e8c80161cfcce09f1e2cde1edd16a551abb3/frozenlist-1.8.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:494a5952b1c597ba44e0e78113a7266e656b9794eec897b19ead706bd7074383", size = 242411, upload-time = "2025-10-06T05:36:09.801Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/83/f61505a05109ef3293dfb1ff594d13d64a2324ac3482be2cedc2be818256/frozenlist-1.8.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:96f423a119f4777a4a056b66ce11527366a8bb92f54e541ade21f2374433f6d4", size = 243014, upload-time = "2025-10-06T05:36:11.394Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/cb/cb6c7b0f7d4023ddda30cf56b8b17494eb3a79e3fda666bf735f63118b35/frozenlist-1.8.0-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3462dd9475af2025c31cc61be6652dfa25cbfb56cbbf52f4ccfe029f38decaf8", size = 234909, upload-time = "2025-10-06T05:36:12.598Z" },
+    { url = "https://files.pythonhosted.org/packages/31/c5/cd7a1f3b8b34af009fb17d4123c5a778b44ae2804e3ad6b86204255f9ec5/frozenlist-1.8.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c4c800524c9cd9bac5166cd6f55285957fcfc907db323e193f2afcd4d9abd69b", size = 250049, upload-time = "2025-10-06T05:36:14.065Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/01/2f95d3b416c584a1e7f0e1d6d31998c4a795f7544069ee2e0962a4b60740/frozenlist-1.8.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:d6a5df73acd3399d893dafc71663ad22534b5aa4f94e8a2fabfe856c3c1b6a52", size = 256485, upload-time = "2025-10-06T05:36:15.39Z" },
+    { url = "https://files.pythonhosted.org/packages/ce/03/024bf7720b3abaebcff6d0793d73c154237b85bdf67b7ed55e5e9596dc9a/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:405e8fe955c2280ce66428b3ca55e12b3c4e9c336fb2103a4937e891c69a4a29", size = 237619, upload-time = "2025-10-06T05:36:16.558Z" },
+    { url = "https://files.pythonhosted.org/packages/69/fa/f8abdfe7d76b731f5d8bd217827cf6764d4f1d9763407e42717b4bed50a0/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:908bd3f6439f2fef9e85031b59fd4f1297af54415fb60e4254a95f75b3cab3f3", size = 250320, upload-time = "2025-10-06T05:36:17.821Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/3c/b051329f718b463b22613e269ad72138cc256c540f78a6de89452803a47d/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:294e487f9ec720bd8ffcebc99d575f7eff3568a08a253d1ee1a0378754b74143", size = 246820, upload-time = "2025-10-06T05:36:19.046Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/ae/58282e8f98e444b3f4dd42448ff36fa38bef29e40d40f330b22e7108f565/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:74c51543498289c0c43656701be6b077f4b265868fa7f8a8859c197006efb608", size = 250518, upload-time = "2025-10-06T05:36:20.763Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/96/007e5944694d66123183845a106547a15944fbbb7154788cbf7272789536/frozenlist-1.8.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:776f352e8329135506a1d6bf16ac3f87bc25b28e765949282dcc627af36123aa", size = 239096, upload-time = "2025-10-06T05:36:22.129Z" },
+    { url = "https://files.pythonhosted.org/packages/66/bb/852b9d6db2fa40be96f29c0d1205c306288f0684df8fd26ca1951d461a56/frozenlist-1.8.0-cp312-cp312-win32.whl", hash = "sha256:433403ae80709741ce34038da08511d4a77062aa924baf411ef73d1146e74faf", size = 39985, upload-time = "2025-10-06T05:36:23.661Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/af/38e51a553dd66eb064cdf193841f16f077585d4d28394c2fa6235cb41765/frozenlist-1.8.0-cp312-cp312-win_amd64.whl", hash = "sha256:34187385b08f866104f0c0617404c8eb08165ab1272e884abc89c112e9c00746", size = 44591, upload-time = "2025-10-06T05:36:24.958Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/06/1dc65480ab147339fecc70797e9c2f69d9cea9cf38934ce08df070fdb9cb/frozenlist-1.8.0-cp312-cp312-win_arm64.whl", hash = "sha256:fe3c58d2f5db5fbd18c2987cba06d51b0529f52bc3a6cdc33d3f4eab725104bd", size = 40102, upload-time = "2025-10-06T05:36:26.333Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/40/0832c31a37d60f60ed79e9dfb5a92e1e2af4f40a16a29abcc7992af9edff/frozenlist-1.8.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:8d92f1a84bb12d9e56f818b3a746f3efba93c1b63c8387a73dde655e1e42282a", size = 85717, upload-time = "2025-10-06T05:36:27.341Z" },
+    { url = "https://files.pythonhosted.org/packages/30/ba/b0b3de23f40bc55a7057bd38434e25c34fa48e17f20ee273bbde5e0650f3/frozenlist-1.8.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:96153e77a591c8adc2ee805756c61f59fef4cf4073a9275ee86fe8cba41241f7", size = 49651, upload-time = "2025-10-06T05:36:28.855Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/ab/6e5080ee374f875296c4243c381bbdef97a9ac39c6e3ce1d5f7d42cb78d6/frozenlist-1.8.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:f21f00a91358803399890ab167098c131ec2ddd5f8f5fd5fe9c9f2c6fcd91e40", size = 49417, upload-time = "2025-10-06T05:36:29.877Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/4e/e4691508f9477ce67da2015d8c00acd751e6287739123113a9fca6f1604e/frozenlist-1.8.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:fb30f9626572a76dfe4293c7194a09fb1fe93ba94c7d4f720dfae3b646b45027", size = 234391, upload-time = "2025-10-06T05:36:31.301Z" },
+    { url = "https://files.pythonhosted.org/packages/40/76/c202df58e3acdf12969a7895fd6f3bc016c642e6726aa63bd3025e0fc71c/frozenlist-1.8.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eaa352d7047a31d87dafcacbabe89df0aa506abb5b1b85a2fb91bc3faa02d822", size = 233048, upload-time = "2025-10-06T05:36:32.531Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/c0/8746afb90f17b73ca5979c7a3958116e105ff796e718575175319b5bb4ce/frozenlist-1.8.0-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:03ae967b4e297f58f8c774c7eabcce57fe3c2434817d4385c50661845a058121", size = 226549, upload-time = "2025-10-06T05:36:33.706Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/eb/4c7eefc718ff72f9b6c4893291abaae5fbc0c82226a32dcd8ef4f7a5dbef/frozenlist-1.8.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:f6292f1de555ffcc675941d65fffffb0a5bcd992905015f85d0592201793e0e5", size = 239833, upload-time = "2025-10-06T05:36:34.947Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/4e/e5c02187cf704224f8b21bee886f3d713ca379535f16893233b9d672ea71/frozenlist-1.8.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:29548f9b5b5e3460ce7378144c3010363d8035cea44bc0bf02d57f5a685e084e", size = 245363, upload-time = "2025-10-06T05:36:36.534Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/96/cb85ec608464472e82ad37a17f844889c36100eed57bea094518bf270692/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:ec3cc8c5d4084591b4237c0a272cc4f50a5b03396a47d9caaf76f5d7b38a4f11", size = 229314, upload-time = "2025-10-06T05:36:38.582Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/6f/4ae69c550e4cee66b57887daeebe006fe985917c01d0fff9caab9883f6d0/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:517279f58009d0b1f2e7c1b130b377a349405da3f7621ed6bfae50b10adf20c1", size = 243365, upload-time = "2025-10-06T05:36:40.152Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/58/afd56de246cf11780a40a2c28dc7cbabbf06337cc8ddb1c780a2d97e88d8/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:db1e72ede2d0d7ccb213f218df6a078a9c09a7de257c2fe8fcef16d5925230b1", size = 237763, upload-time = "2025-10-06T05:36:41.355Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/36/cdfaf6ed42e2644740d4a10452d8e97fa1c062e2a8006e4b09f1b5fd7d63/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:b4dec9482a65c54a5044486847b8a66bf10c9cb4926d42927ec4e8fd5db7fed8", size = 240110, upload-time = "2025-10-06T05:36:42.716Z" },
+    { url = "https://files.pythonhosted.org/packages/03/a8/9ea226fbefad669f11b52e864c55f0bd57d3c8d7eb07e9f2e9a0b39502e1/frozenlist-1.8.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:21900c48ae04d13d416f0e1e0c4d81f7931f73a9dfa0b7a8746fb2fe7dd970ed", size = 233717, upload-time = "2025-10-06T05:36:44.251Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/0b/1b5531611e83ba7d13ccc9988967ea1b51186af64c42b7a7af465dcc9568/frozenlist-1.8.0-cp313-cp313-win32.whl", hash = "sha256:8b7b94a067d1c504ee0b16def57ad5738701e4ba10cec90529f13fa03c833496", size = 39628, upload-time = "2025-10-06T05:36:45.423Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/cf/174c91dbc9cc49bc7b7aab74d8b734e974d1faa8f191c74af9b7e80848e6/frozenlist-1.8.0-cp313-cp313-win_amd64.whl", hash = "sha256:878be833caa6a3821caf85eb39c5ba92d28e85df26d57afb06b35b2efd937231", size = 43882, upload-time = "2025-10-06T05:36:46.796Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/17/502cd212cbfa96eb1388614fe39a3fc9ab87dbbe042b66f97acb57474834/frozenlist-1.8.0-cp313-cp313-win_arm64.whl", hash = "sha256:44389d135b3ff43ba8cc89ff7f51f5a0bb6b63d829c8300f79a2fe4fe61bcc62", size = 39676, upload-time = "2025-10-06T05:36:47.8Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/5c/3bbfaa920dfab09e76946a5d2833a7cbdf7b9b4a91c714666ac4855b88b4/frozenlist-1.8.0-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:e25ac20a2ef37e91c1b39938b591457666a0fa835c7783c3a8f33ea42870db94", size = 89235, upload-time = "2025-10-06T05:36:48.78Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/d6/f03961ef72166cec1687e84e8925838442b615bd0b8854b54923ce5b7b8a/frozenlist-1.8.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:07cdca25a91a4386d2e76ad992916a85038a9b97561bf7a3fd12d5d9ce31870c", size = 50742, upload-time = "2025-10-06T05:36:49.837Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/bb/a6d12b7ba4c3337667d0e421f7181c82dda448ce4e7ad7ecd249a16fa806/frozenlist-1.8.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:4e0c11f2cc6717e0a741f84a527c52616140741cd812a50422f83dc31749fb52", size = 51725, upload-time = "2025-10-06T05:36:50.851Z" },
+    { url = "https://files.pythonhosted.org/packages/bc/71/d1fed0ffe2c2ccd70b43714c6cab0f4188f09f8a67a7914a6b46ee30f274/frozenlist-1.8.0-cp313-cp313t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:b3210649ee28062ea6099cfda39e147fa1bc039583c8ee4481cb7811e2448c51", size = 284533, upload-time = "2025-10-06T05:36:51.898Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/1f/fb1685a7b009d89f9bf78a42d94461bc06581f6e718c39344754a5d9bada/frozenlist-1.8.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:581ef5194c48035a7de2aefc72ac6539823bb71508189e5de01d60c9dcd5fa65", size = 292506, upload-time = "2025-10-06T05:36:53.101Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/3b/b991fe1612703f7e0d05c0cf734c1b77aaf7c7d321df4572e8d36e7048c8/frozenlist-1.8.0-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:3ef2d026f16a2b1866e1d86fc4e1291e1ed8a387b2c333809419a2f8b3a77b82", size = 274161, upload-time = "2025-10-06T05:36:54.309Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/ec/c5c618767bcdf66e88945ec0157d7f6c4a1322f1473392319b7a2501ded7/frozenlist-1.8.0-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:5500ef82073f599ac84d888e3a8c1f77ac831183244bfd7f11eaa0289fb30714", size = 294676, upload-time = "2025-10-06T05:36:55.566Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/ce/3934758637d8f8a88d11f0585d6495ef54b2044ed6ec84492a91fa3b27aa/frozenlist-1.8.0-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:50066c3997d0091c411a66e710f4e11752251e6d2d73d70d8d5d4c76442a199d", size = 300638, upload-time = "2025-10-06T05:36:56.758Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/4f/a7e4d0d467298f42de4b41cbc7ddaf19d3cfeabaf9ff97c20c6c7ee409f9/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:5c1c8e78426e59b3f8005e9b19f6ff46e5845895adbde20ece9218319eca6506", size = 283067, upload-time = "2025-10-06T05:36:57.965Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/48/c7b163063d55a83772b268e6d1affb960771b0e203b632cfe09522d67ea5/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:eefdba20de0d938cec6a89bd4d70f346a03108a19b9df4248d3cf0d88f1b0f51", size = 292101, upload-time = "2025-10-06T05:36:59.237Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/d0/2366d3c4ecdc2fd391e0afa6e11500bfba0ea772764d631bbf82f0136c9d/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:cf253e0e1c3ceb4aaff6df637ce033ff6535fb8c70a764a8f46aafd3d6ab798e", size = 289901, upload-time = "2025-10-06T05:37:00.811Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/94/daff920e82c1b70e3618a2ac39fbc01ae3e2ff6124e80739ce5d71c9b920/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:032efa2674356903cd0261c4317a561a6850f3ac864a63fc1583147fb05a79b0", size = 289395, upload-time = "2025-10-06T05:37:02.115Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/20/bba307ab4235a09fdcd3cc5508dbabd17c4634a1af4b96e0f69bfe551ebd/frozenlist-1.8.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:6da155091429aeba16851ecb10a9104a108bcd32f6c1642867eadaee401c1c41", size = 283659, upload-time = "2025-10-06T05:37:03.711Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/00/04ca1c3a7a124b6de4f8a9a17cc2fcad138b4608e7a3fc5877804b8715d7/frozenlist-1.8.0-cp313-cp313t-win32.whl", hash = "sha256:0f96534f8bfebc1a394209427d0f8a63d343c9779cda6fc25e8e121b5fd8555b", size = 43492, upload-time = "2025-10-06T05:37:04.915Z" },
+    { url = "https://files.pythonhosted.org/packages/59/5e/c69f733a86a94ab10f68e496dc6b7e8bc078ebb415281d5698313e3af3a1/frozenlist-1.8.0-cp313-cp313t-win_amd64.whl", hash = "sha256:5d63a068f978fc69421fb0e6eb91a9603187527c86b7cd3f534a5b77a592b888", size = 48034, upload-time = "2025-10-06T05:37:06.343Z" },
+    { url = "https://files.pythonhosted.org/packages/16/6c/be9d79775d8abe79b05fa6d23da99ad6e7763a1d080fbae7290b286093fd/frozenlist-1.8.0-cp313-cp313t-win_arm64.whl", hash = "sha256:bf0a7e10b077bf5fb9380ad3ae8ce20ef919a6ad93b4552896419ac7e1d8e042", size = 41749, upload-time = "2025-10-06T05:37:07.431Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/c8/85da824b7e7b9b6e7f7705b2ecaf9591ba6f79c1177f324c2735e41d36a2/frozenlist-1.8.0-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:cee686f1f4cadeb2136007ddedd0aaf928ab95216e7691c63e50a8ec066336d0", size = 86127, upload-time = "2025-10-06T05:37:08.438Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/e8/a1185e236ec66c20afd72399522f142c3724c785789255202d27ae992818/frozenlist-1.8.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:119fb2a1bd47307e899c2fac7f28e85b9a543864df47aa7ec9d3c1b4545f096f", size = 49698, upload-time = "2025-10-06T05:37:09.48Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/93/72b1736d68f03fda5fdf0f2180fb6caaae3894f1b854d006ac61ecc727ee/frozenlist-1.8.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:4970ece02dbc8c3a92fcc5228e36a3e933a01a999f7094ff7c23fbd2beeaa67c", size = 49749, upload-time = "2025-10-06T05:37:10.569Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/b2/fabede9fafd976b991e9f1b9c8c873ed86f202889b864756f240ce6dd855/frozenlist-1.8.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:cba69cb73723c3f329622e34bdbf5ce1f80c21c290ff04256cff1cd3c2036ed2", size = 231298, upload-time = "2025-10-06T05:37:11.993Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/3b/d9b1e0b0eed36e70477ffb8360c49c85c8ca8ef9700a4e6711f39a6e8b45/frozenlist-1.8.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:778a11b15673f6f1df23d9586f83c4846c471a8af693a22e066508b77d201ec8", size = 232015, upload-time = "2025-10-06T05:37:13.194Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/94/be719d2766c1138148564a3960fc2c06eb688da592bdc25adcf856101be7/frozenlist-1.8.0-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0325024fe97f94c41c08872db482cf8ac4800d80e79222c6b0b7b162d5b13686", size = 225038, upload-time = "2025-10-06T05:37:14.577Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/09/6712b6c5465f083f52f50cf74167b92d4ea2f50e46a9eea0523d658454ae/frozenlist-1.8.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:97260ff46b207a82a7567b581ab4190bd4dfa09f4db8a8b49d1a958f6aa4940e", size = 240130, upload-time = "2025-10-06T05:37:15.781Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/d4/cd065cdcf21550b54f3ce6a22e143ac9e4836ca42a0de1022da8498eac89/frozenlist-1.8.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:54b2077180eb7f83dd52c40b2750d0a9f175e06a42e3213ce047219de902717a", size = 242845, upload-time = "2025-10-06T05:37:17.037Z" },
+    { url = "https://files.pythonhosted.org/packages/62/c3/f57a5c8c70cd1ead3d5d5f776f89d33110b1addae0ab010ad774d9a44fb9/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:2f05983daecab868a31e1da44462873306d3cbfd76d1f0b5b69c473d21dbb128", size = 229131, upload-time = "2025-10-06T05:37:18.221Z" },
+    { url = "https://files.pythonhosted.org/packages/6c/52/232476fe9cb64f0742f3fde2b7d26c1dac18b6d62071c74d4ded55e0ef94/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:33f48f51a446114bc5d251fb2954ab0164d5be02ad3382abcbfe07e2531d650f", size = 240542, upload-time = "2025-10-06T05:37:19.771Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/85/07bf3f5d0fb5414aee5f47d33c6f5c77bfe49aac680bfece33d4fdf6a246/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:154e55ec0655291b5dd1b8731c637ecdb50975a2ae70c606d100750a540082f7", size = 237308, upload-time = "2025-10-06T05:37:20.969Z" },
+    { url = "https://files.pythonhosted.org/packages/11/99/ae3a33d5befd41ac0ca2cc7fd3aa707c9c324de2e89db0e0f45db9a64c26/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:4314debad13beb564b708b4a496020e5306c7333fa9a3ab90374169a20ffab30", size = 238210, upload-time = "2025-10-06T05:37:22.252Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/60/b1d2da22f4970e7a155f0adde9b1435712ece01b3cd45ba63702aea33938/frozenlist-1.8.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:073f8bf8becba60aa931eb3bc420b217bb7d5b8f4750e6f8b3be7f3da85d38b7", size = 231972, upload-time = "2025-10-06T05:37:23.5Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/ab/945b2f32de889993b9c9133216c068b7fcf257d8595a0ac420ac8677cab0/frozenlist-1.8.0-cp314-cp314-win32.whl", hash = "sha256:bac9c42ba2ac65ddc115d930c78d24ab8d4f465fd3fc473cdedfccadb9429806", size = 40536, upload-time = "2025-10-06T05:37:25.581Z" },
+    { url = "https://files.pythonhosted.org/packages/59/ad/9caa9b9c836d9ad6f067157a531ac48b7d36499f5036d4141ce78c230b1b/frozenlist-1.8.0-cp314-cp314-win_amd64.whl", hash = "sha256:3e0761f4d1a44f1d1a47996511752cf3dcec5bbdd9cc2b4fe595caf97754b7a0", size = 44330, upload-time = "2025-10-06T05:37:26.928Z" },
+    { url = "https://files.pythonhosted.org/packages/82/13/e6950121764f2676f43534c555249f57030150260aee9dcf7d64efda11dd/frozenlist-1.8.0-cp314-cp314-win_arm64.whl", hash = "sha256:d1eaff1d00c7751b7c6662e9c5ba6eb2c17a2306ba5e2a37f24ddf3cc953402b", size = 40627, upload-time = "2025-10-06T05:37:28.075Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/c7/43200656ecc4e02d3f8bc248df68256cd9572b3f0017f0a0c4e93440ae23/frozenlist-1.8.0-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:d3bb933317c52d7ea5004a1c442eef86f426886fba134ef8cf4226ea6ee1821d", size = 89238, upload-time = "2025-10-06T05:37:29.373Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/29/55c5f0689b9c0fb765055629f472c0de484dcaf0acee2f7707266ae3583c/frozenlist-1.8.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:8009897cdef112072f93a0efdce29cd819e717fd2f649ee3016efd3cd885a7ed", size = 50738, upload-time = "2025-10-06T05:37:30.792Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/7d/b7282a445956506fa11da8c2db7d276adcbf2b17d8bb8407a47685263f90/frozenlist-1.8.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:2c5dcbbc55383e5883246d11fd179782a9d07a986c40f49abe89ddf865913930", size = 51739, upload-time = "2025-10-06T05:37:32.127Z" },
+    { url = "https://files.pythonhosted.org/packages/62/1c/3d8622e60d0b767a5510d1d3cf21065b9db874696a51ea6d7a43180a259c/frozenlist-1.8.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:39ecbc32f1390387d2aa4f5a995e465e9e2f79ba3adcac92d68e3e0afae6657c", size = 284186, upload-time = "2025-10-06T05:37:33.21Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/14/aa36d5f85a89679a85a1d44cd7a6657e0b1c75f61e7cad987b203d2daca8/frozenlist-1.8.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:92db2bf818d5cc8d9c1f1fc56b897662e24ea5adb36ad1f1d82875bd64e03c24", size = 292196, upload-time = "2025-10-06T05:37:36.107Z" },
+    { url = "https://files.pythonhosted.org/packages/05/23/6bde59eb55abd407d34f77d39a5126fb7b4f109a3f611d3929f14b700c66/frozenlist-1.8.0-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:2dc43a022e555de94c3b68a4ef0b11c4f747d12c024a520c7101709a2144fb37", size = 273830, upload-time = "2025-10-06T05:37:37.663Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/3f/22cff331bfad7a8afa616289000ba793347fcd7bc275f3b28ecea2a27909/frozenlist-1.8.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:cb89a7f2de3602cfed448095bab3f178399646ab7c61454315089787df07733a", size = 294289, upload-time = "2025-10-06T05:37:39.261Z" },
+    { url = "https://files.pythonhosted.org/packages/a4/89/5b057c799de4838b6c69aa82b79705f2027615e01be996d2486a69ca99c4/frozenlist-1.8.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:33139dc858c580ea50e7e60a1b0ea003efa1fd42e6ec7fdbad78fff65fad2fd2", size = 300318, upload-time = "2025-10-06T05:37:43.213Z" },
+    { url = "https://files.pythonhosted.org/packages/30/de/2c22ab3eb2a8af6d69dc799e48455813bab3690c760de58e1bf43b36da3e/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:168c0969a329b416119507ba30b9ea13688fafffac1b7822802537569a1cb0ef", size = 282814, upload-time = "2025-10-06T05:37:45.337Z" },
+    { url = "https://files.pythonhosted.org/packages/59/f7/970141a6a8dbd7f556d94977858cfb36fa9b66e0892c6dd780d2219d8cd8/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:28bd570e8e189d7f7b001966435f9dac6718324b5be2990ac496cf1ea9ddb7fe", size = 291762, upload-time = "2025-10-06T05:37:46.657Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/15/ca1adae83a719f82df9116d66f5bb28bb95557b3951903d39135620ef157/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:b2a095d45c5d46e5e79ba1e5b9cb787f541a8dee0433836cea4b96a2c439dcd8", size = 289470, upload-time = "2025-10-06T05:37:47.946Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/83/dca6dc53bf657d371fbc88ddeb21b79891e747189c5de990b9dfff2ccba1/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:eab8145831a0d56ec9c4139b6c3e594c7a83c2c8be25d5bcf2d86136a532287a", size = 289042, upload-time = "2025-10-06T05:37:49.499Z" },
+    { url = "https://files.pythonhosted.org/packages/96/52/abddd34ca99be142f354398700536c5bd315880ed0a213812bc491cff5e4/frozenlist-1.8.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:974b28cf63cc99dfb2188d8d222bc6843656188164848c4f679e63dae4b0708e", size = 283148, upload-time = "2025-10-06T05:37:50.745Z" },
+    { url = "https://files.pythonhosted.org/packages/af/d3/76bd4ed4317e7119c2b7f57c3f6934aba26d277acc6309f873341640e21f/frozenlist-1.8.0-cp314-cp314t-win32.whl", hash = "sha256:342c97bf697ac5480c0a7ec73cd700ecfa5a8a40ac923bd035484616efecc2df", size = 44676, upload-time = "2025-10-06T05:37:52.222Z" },
+    { url = "https://files.pythonhosted.org/packages/89/76/c615883b7b521ead2944bb3480398cbb07e12b7b4e4d073d3752eb721558/frozenlist-1.8.0-cp314-cp314t-win_amd64.whl", hash = "sha256:06be8f67f39c8b1dc671f5d83aaefd3358ae5cdcf8314552c57e7ed3e6475bdd", size = 49451, upload-time = "2025-10-06T05:37:53.425Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/a3/5982da14e113d07b325230f95060e2169f5311b1017ea8af2a29b374c289/frozenlist-1.8.0-cp314-cp314t-win_arm64.whl", hash = "sha256:102e6314ca4da683dca92e3b1355490fed5f313b768500084fbe6371fddfdb79", size = 42507, upload-time = "2025-10-06T05:37:54.513Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/9a/e35b4a917281c0b8419d4207f4334c8e8c5dbf4f3f5f9ada73958d937dcc/frozenlist-1.8.0-py3-none-any.whl", hash = "sha256:0c18a16eab41e82c295618a77502e17b195883241c563b00f0aa5106fc4eaa0d", size = 13409, upload-time = "2025-10-06T05:38:16.721Z" },
+]
+
+[[package]]
+name = "h11"
+version = "0.16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/01/ee/02a2c011bdab74c6fb3c75474d40b3052059d95df7e73351460c8588d963/h11-0.16.0.tar.gz", hash = "sha256:4e35b956cf45792e4caa5885e69fba00bdbc6ffafbfa020300e549b208ee5ff1", size = 101250, upload-time = "2025-04-24T03:35:25.427Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/04/4b/29cac41a4d98d144bf5f6d33995617b185d14b22401f75ca86f384e87ff1/h11-0.16.0-py3-none-any.whl", hash = "sha256:63cf8bbe7522de3bf65932fda1d9c2772064ffb3dae62d55932da54b31cb6c86", size = 37515, upload-time = "2025-04-24T03:35:24.344Z" },
+]
+
+[[package]]
+name = "httpcore"
+version = "1.0.9"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "h11" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/06/94/82699a10bca87a5556c9c59b5963f2d039dbd239f25bc2a63907a05a14cb/httpcore-1.0.9.tar.gz", hash = "sha256:6e34463af53fd2ab5d807f399a9b45ea31c3dfa2276f15a2c3f00afff6e176e8", size = 85484, upload-time = "2025-04-24T22:06:22.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/7e/f5/f66802a942d491edb555dd61e3a9961140fd64c90bce1eafd741609d334d/httpcore-1.0.9-py3-none-any.whl", hash = "sha256:2d400746a40668fc9dec9810239072b40b4484b640a8c38fd654a024c7a1bf55", size = 78784, upload-time = "2025-04-24T22:06:20.566Z" },
+]
+
+[[package]]
+name = "httpx"
+version = "0.28.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "anyio" },
+    { name = "certifi" },
+    { name = "httpcore" },
+    { name = "idna" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/b1/df/48c586a5fe32a0f01324ee087459e112ebb7224f646c0b5023f5e79e9956/httpx-0.28.1.tar.gz", hash = "sha256:75e98c5f16b0f35b567856f597f06ff2270a374470a5c2392242528e3e3e42fc", size = 141406, upload-time = "2024-12-06T15:37:23.222Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2a/39/e50c7c3a983047577ee07d2a9e53faf5a69493943ec3f6a384bdc792deb2/httpx-0.28.1-py3-none-any.whl", hash = "sha256:d909fcccc110f8c7faf814ca82a9a4d816bc5a6dbfea25d6591d6985b8ba59ad", size = 73517, upload-time = "2024-12-06T15:37:21.509Z" },
+]
+
+[[package]]
+name = "idna"
+version = "3.11"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/6f/6d/0703ccc57f3a7233505399edb88de3cbd678da106337b9fcde432b65ed60/idna-3.11.tar.gz", hash = "sha256:795dafcc9c04ed0c1fb032c2aa73654d8e8c5023a7df64a53f39190ada629902", size = 194582, upload-time = "2025-10-12T14:55:20.501Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/0e/61/66938bbb5fc52dbdf84594873d5b51fb1f7c7794e9c0f5bd885f30bc507b/idna-3.11-py3-none-any.whl", hash = "sha256:771a87f49d9defaf64091e6e6fe9c18d4833f140bd19464795bc32d966ca37ea", size = 71008, upload-time = "2025-10-12T14:55:18.883Z" },
+]
+
+[[package]]
+name = "iniconfig"
+version = "2.3.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/34/14ca021ce8e5dfedc35312d08ba8bf51fdd999c576889fc2c24cb97f4f10/iniconfig-2.3.0.tar.gz", hash = "sha256:c76315c77db068650d49c5b56314774a7804df16fee4402c1f19d6d15d8c4730", size = 20503, upload-time = "2025-10-18T21:55:43.219Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cb/b1/3846dd7f199d53cb17f49cba7e651e9ce294d8497c8c150530ed11865bb8/iniconfig-2.3.0-py3-none-any.whl", hash = "sha256:f631c04d2c48c52b84d0d0549c99ff3859c98df65b3101406327ecc7d53fbf12", size = 7484, upload-time = "2025-10-18T21:55:41.639Z" },
+]
+
+[[package]]
+name = "librt"
+version = "0.7.8"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e7/24/5f3646ff414285e0f7708fa4e946b9bf538345a41d1c375c439467721a5e/librt-0.7.8.tar.gz", hash = "sha256:1a4ede613941d9c3470b0368be851df6bb78ab218635512d0370b27a277a0862", size = 148323, upload-time = "2026-01-14T12:56:16.876Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/56/04/79d8fcb43cae376c7adbab7b2b9f65e48432c9eced62ac96703bcc16e09b/librt-0.7.8-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:9b6943885b2d49c48d0cff23b16be830ba46b0152d98f62de49e735c6e655a63", size = 57472, upload-time = "2026-01-14T12:55:08.528Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/ba/60b96e93043d3d659da91752689023a73981336446ae82078cddf706249e/librt-0.7.8-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:46ef1f4b9b6cc364b11eea0ecc0897314447a66029ee1e55859acb3dd8757c93", size = 58986, upload-time = "2026-01-14T12:55:09.466Z" },
+    { url = "https://files.pythonhosted.org/packages/7c/26/5215e4cdcc26e7be7eee21955a7e13cbf1f6d7d7311461a6014544596fac/librt-0.7.8-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:907ad09cfab21e3c86e8f1f87858f7049d1097f77196959c033612f532b4e592", size = 168422, upload-time = "2026-01-14T12:55:10.499Z" },
+    { url = "https://files.pythonhosted.org/packages/0f/84/e8d1bc86fa0159bfc24f3d798d92cafd3897e84c7fea7fe61b3220915d76/librt-0.7.8-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:2991b6c3775383752b3ca0204842743256f3ad3deeb1d0adc227d56b78a9a850", size = 177478, upload-time = "2026-01-14T12:55:11.577Z" },
+    { url = "https://files.pythonhosted.org/packages/57/11/d0268c4b94717a18aa91df1100e767b010f87b7ae444dafaa5a2d80f33a6/librt-0.7.8-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:03679b9856932b8c8f674e87aa3c55ea11c9274301f76ae8dc4d281bda55cf62", size = 192439, upload-time = "2026-01-14T12:55:12.7Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/56/1e8e833b95fe684f80f8894ae4d8b7d36acc9203e60478fcae599120a975/librt-0.7.8-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3968762fec1b2ad34ce57458b6de25dbb4142713e9ca6279a0d352fa4e9f452b", size = 191483, upload-time = "2026-01-14T12:55:13.838Z" },
+    { url = "https://files.pythonhosted.org/packages/17/48/f11cf28a2cb6c31f282009e2208312aa84a5ee2732859f7856ee306176d5/librt-0.7.8-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:bb7a7807523a31f03061288cc4ffc065d684c39db7644c676b47d89553c0d714", size = 185376, upload-time = "2026-01-14T12:55:15.017Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/6a/d7c116c6da561b9155b184354a60a3d5cdbf08fc7f3678d09c95679d13d9/librt-0.7.8-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:ad64a14b1e56e702e19b24aae108f18ad1bf7777f3af5fcd39f87d0c5a814449", size = 206234, upload-time = "2026-01-14T12:55:16.571Z" },
+    { url = "https://files.pythonhosted.org/packages/61/de/1975200bb0285fc921c5981d9978ce6ce11ae6d797df815add94a5a848a3/librt-0.7.8-cp312-cp312-win32.whl", hash = "sha256:0241a6ed65e6666236ea78203a73d800dbed896cf12ae25d026d75dc1fcd1dac", size = 44057, upload-time = "2026-01-14T12:55:18.077Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/cd/724f2d0b3461426730d4877754b65d39f06a41ac9d0a92d5c6840f72b9ae/librt-0.7.8-cp312-cp312-win_amd64.whl", hash = "sha256:6db5faf064b5bab9675c32a873436b31e01d66ca6984c6f7f92621656033a708", size = 50293, upload-time = "2026-01-14T12:55:19.179Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/cf/7e899acd9ee5727ad8160fdcc9994954e79fab371c66535c60e13b968ffc/librt-0.7.8-cp312-cp312-win_arm64.whl", hash = "sha256:57175aa93f804d2c08d2edb7213e09276bd49097611aefc37e3fa38d1fb99ad0", size = 43574, upload-time = "2026-01-14T12:55:20.185Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/fe/b1f9de2829cf7fc7649c1dcd202cfd873837c5cc2fc9e526b0e7f716c3d2/librt-0.7.8-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:4c3995abbbb60b3c129490fa985dfe6cac11d88fc3c36eeb4fb1449efbbb04fc", size = 57500, upload-time = "2026-01-14T12:55:21.219Z" },
+    { url = "https://files.pythonhosted.org/packages/eb/d4/4a60fbe2e53b825f5d9a77325071d61cd8af8506255067bf0c8527530745/librt-0.7.8-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:44e0c2cbc9bebd074cf2cdbe472ca185e824be4e74b1c63a8e934cea674bebf2", size = 59019, upload-time = "2026-01-14T12:55:22.256Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/37/61ff80341ba5159afa524445f2d984c30e2821f31f7c73cf166dcafa5564/librt-0.7.8-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:4d2f1e492cae964b3463a03dc77a7fe8742f7855d7258c7643f0ee32b6651dd3", size = 169015, upload-time = "2026-01-14T12:55:23.24Z" },
+    { url = "https://files.pythonhosted.org/packages/1c/86/13d4f2d6a93f181ebf2fc953868826653ede494559da8268023fe567fca3/librt-0.7.8-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:451e7ffcef8f785831fdb791bd69211f47e95dc4c6ddff68e589058806f044c6", size = 178161, upload-time = "2026-01-14T12:55:24.826Z" },
+    { url = "https://files.pythonhosted.org/packages/88/26/e24ef01305954fc4d771f1f09f3dd682f9eb610e1bec188ffb719374d26e/librt-0.7.8-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:3469e1af9f1380e093ae06bedcbdd11e407ac0b303a56bbe9afb1d6824d4982d", size = 193015, upload-time = "2026-01-14T12:55:26.04Z" },
+    { url = "https://files.pythonhosted.org/packages/88/a0/92b6bd060e720d7a31ed474d046a69bd55334ec05e9c446d228c4b806ae3/librt-0.7.8-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:f11b300027ce19a34f6d24ebb0a25fd0e24a9d53353225a5c1e6cadbf2916b2e", size = 192038, upload-time = "2026-01-14T12:55:27.208Z" },
+    { url = "https://files.pythonhosted.org/packages/06/bb/6f4c650253704279c3a214dad188101d1b5ea23be0606628bc6739456624/librt-0.7.8-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:4adc73614f0d3c97874f02f2c7fd2a27854e7e24ad532ea6b965459c5b757eca", size = 186006, upload-time = "2026-01-14T12:55:28.594Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/00/1c409618248d43240cadf45f3efb866837fa77e9a12a71481912135eb481/librt-0.7.8-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:60c299e555f87e4c01b2eca085dfccda1dde87f5a604bb45c2906b8305819a93", size = 206888, upload-time = "2026-01-14T12:55:30.214Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/83/b2cfe8e76ff5c1c77f8a53da3d5de62d04b5ebf7cf913e37f8bca43b5d07/librt-0.7.8-cp313-cp313-win32.whl", hash = "sha256:b09c52ed43a461994716082ee7d87618096851319bf695d57ec123f2ab708951", size = 44126, upload-time = "2026-01-14T12:55:31.44Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/0b/c59d45de56a51bd2d3a401fc63449c0ac163e4ef7f523ea8b0c0dee86ec5/librt-0.7.8-cp313-cp313-win_amd64.whl", hash = "sha256:f8f4a901a3fa28969d6e4519deceab56c55a09d691ea7b12ca830e2fa3461e34", size = 50262, upload-time = "2026-01-14T12:55:33.01Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/b9/973455cec0a1ec592395250c474164c4a58ebf3e0651ee920fef1a2623f1/librt-0.7.8-cp313-cp313-win_arm64.whl", hash = "sha256:43d4e71b50763fcdcf64725ac680d8cfa1706c928b844794a7aa0fa9ac8e5f09", size = 43600, upload-time = "2026-01-14T12:55:34.054Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/73/fa8814c6ce2d49c3827829cadaa1589b0bf4391660bd4510899393a23ebc/librt-0.7.8-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:be927c3c94c74b05128089a955fba86501c3b544d1d300282cc1b4bd370cb418", size = 57049, upload-time = "2026-01-14T12:55:35.056Z" },
+    { url = "https://files.pythonhosted.org/packages/53/fe/f6c70956da23ea235fd2e3cc16f4f0b4ebdfd72252b02d1164dd58b4e6c3/librt-0.7.8-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:7b0803e9008c62a7ef79058233db7ff6f37a9933b8f2573c05b07ddafa226611", size = 58689, upload-time = "2026-01-14T12:55:36.078Z" },
+    { url = "https://files.pythonhosted.org/packages/1f/4d/7a2481444ac5fba63050d9abe823e6bc16896f575bfc9c1e5068d516cdce/librt-0.7.8-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:79feb4d00b2a4e0e05c9c56df707934f41fcb5fe53fd9efb7549068d0495b758", size = 166808, upload-time = "2026-01-14T12:55:37.595Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/3c/10901d9e18639f8953f57c8986796cfbf4c1c514844a41c9197cf87cb707/librt-0.7.8-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b9122094e3f24aa759c38f46bd8863433820654927370250f460ae75488b66ea", size = 175614, upload-time = "2026-01-14T12:55:38.756Z" },
+    { url = "https://files.pythonhosted.org/packages/db/01/5cbdde0951a5090a80e5ba44e6357d375048123c572a23eecfb9326993a7/librt-0.7.8-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7e03bea66af33c95ce3addf87a9bf1fcad8d33e757bc479957ddbc0e4f7207ac", size = 189955, upload-time = "2026-01-14T12:55:39.939Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/b4/e80528d2f4b7eaf1d437fcbd6fc6ba4cbeb3e2a0cb9ed5a79f47c7318706/librt-0.7.8-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:f1ade7f31675db00b514b98f9ab9a7698c7282dad4be7492589109471852d398", size = 189370, upload-time = "2026-01-14T12:55:41.057Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/ab/938368f8ce31a9787ecd4becb1e795954782e4312095daf8fd22420227c8/librt-0.7.8-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:a14229ac62adcf1b90a15992f1ab9c69ae8b99ffb23cb64a90878a6e8a2f5b81", size = 183224, upload-time = "2026-01-14T12:55:42.328Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/10/559c310e7a6e4014ac44867d359ef8238465fb499e7eb31b6bfe3e3f86f5/librt-0.7.8-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:5bcaaf624fd24e6a0cb14beac37677f90793a96864c67c064a91458611446e83", size = 203541, upload-time = "2026-01-14T12:55:43.501Z" },
+    { url = "https://files.pythonhosted.org/packages/f8/db/a0db7acdb6290c215f343835c6efda5b491bb05c3ddc675af558f50fdba3/librt-0.7.8-cp314-cp314-win32.whl", hash = "sha256:7aa7d5457b6c542ecaed79cec4ad98534373c9757383973e638ccced0f11f46d", size = 40657, upload-time = "2026-01-14T12:55:44.668Z" },
+    { url = "https://files.pythonhosted.org/packages/72/e0/4f9bdc2a98a798511e81edcd6b54fe82767a715e05d1921115ac70717f6f/librt-0.7.8-cp314-cp314-win_amd64.whl", hash = "sha256:3d1322800771bee4a91f3b4bd4e49abc7d35e65166821086e5afd1e6c0d9be44", size = 46835, upload-time = "2026-01-14T12:55:45.655Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/3d/59c6402e3dec2719655a41ad027a7371f8e2334aa794ed11533ad5f34969/librt-0.7.8-cp314-cp314-win_arm64.whl", hash = "sha256:5363427bc6a8c3b1719f8f3845ea53553d301382928a86e8fab7984426949bce", size = 39885, upload-time = "2026-01-14T12:55:47.138Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/9c/2481d80950b83085fb14ba3c595db56330d21bbc7d88a19f20165f3538db/librt-0.7.8-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:ca916919793a77e4a98d4a1701e345d337ce53be4a16620f063191f7322ac80f", size = 59161, upload-time = "2026-01-14T12:55:48.45Z" },
+    { url = "https://files.pythonhosted.org/packages/96/79/108df2cfc4e672336765d54e3ff887294c1cc36ea4335c73588875775527/librt-0.7.8-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:54feb7b4f2f6706bb82325e836a01be805770443e2400f706e824e91f6441dde", size = 61008, upload-time = "2026-01-14T12:55:49.527Z" },
+    { url = "https://files.pythonhosted.org/packages/46/f2/30179898f9994a5637459d6e169b6abdc982012c0a4b2d4c26f50c06f911/librt-0.7.8-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:39a4c76fee41007070f872b648cc2f711f9abf9a13d0c7162478043377b52c8e", size = 187199, upload-time = "2026-01-14T12:55:50.587Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/da/f7563db55cebdc884f518ba3791ad033becc25ff68eb70902b1747dc0d70/librt-0.7.8-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ac9c8a458245c7de80bc1b9765b177055efff5803f08e548dd4bb9ab9a8d789b", size = 198317, upload-time = "2026-01-14T12:55:51.991Z" },
+    { url = "https://files.pythonhosted.org/packages/b3/6c/4289acf076ad371471fa86718c30ae353e690d3de6167f7db36f429272f1/librt-0.7.8-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:95b67aa7eff150f075fda09d11f6bfb26edffd300f6ab1666759547581e8f666", size = 210334, upload-time = "2026-01-14T12:55:53.682Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/7f/377521ac25b78ac0a5ff44127a0360ee6d5ddd3ce7327949876a30533daa/librt-0.7.8-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:535929b6eff670c593c34ff435d5440c3096f20fa72d63444608a5aef64dd581", size = 211031, upload-time = "2026-01-14T12:55:54.827Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/b1/e1e96c3e20b23d00cf90f4aad48f0deb4cdfec2f0ed8380d0d85acf98bbf/librt-0.7.8-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:63937bd0f4d1cb56653dc7ae900d6c52c41f0015e25aaf9902481ee79943b33a", size = 204581, upload-time = "2026-01-14T12:55:56.811Z" },
+    { url = "https://files.pythonhosted.org/packages/43/71/0f5d010e92ed9747e14bef35e91b6580533510f1e36a8a09eb79ee70b2f0/librt-0.7.8-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:cf243da9e42d914036fd362ac3fa77d80a41cadcd11ad789b1b5eec4daaf67ca", size = 224731, upload-time = "2026-01-14T12:55:58.175Z" },
+    { url = "https://files.pythonhosted.org/packages/22/f0/07fb6ab5c39a4ca9af3e37554f9d42f25c464829254d72e4ebbd81da351c/librt-0.7.8-cp314-cp314t-win32.whl", hash = "sha256:171ca3a0a06c643bd0a2f62a8944e1902c94aa8e5da4db1ea9a8daf872685365", size = 41173, upload-time = "2026-01-14T12:55:59.315Z" },
+    { url = "https://files.pythonhosted.org/packages/24/d4/7e4be20993dc6a782639625bd2f97f3c66125c7aa80c82426956811cfccf/librt-0.7.8-cp314-cp314t-win_amd64.whl", hash = "sha256:445b7304145e24c60288a2f172b5ce2ca35c0f81605f5299f3fa567e189d2e32", size = 47668, upload-time = "2026-01-14T12:56:00.261Z" },
+    { url = "https://files.pythonhosted.org/packages/fc/85/69f92b2a7b3c0f88ffe107c86b952b397004b5b8ea5a81da3d9c04c04422/librt-0.7.8-cp314-cp314t-win_arm64.whl", hash = "sha256:8766ece9de08527deabcd7cb1b4f1a967a385d26e33e536d6d8913db6ef74f06", size = 40550, upload-time = "2026-01-14T12:56:01.542Z" },
+]
+
+[[package]]
+name = "magic-filter"
+version = "1.0.12"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/e6/08/da7c2cc7398cc0376e8da599d6330a437c01d3eace2f2365f300e0f3f758/magic_filter-1.0.12.tar.gz", hash = "sha256:4751d0b579a5045d1dc250625c4c508c18c3def5ea6afaf3957cb4530d03f7f9", size = 11071, upload-time = "2023-10-01T12:33:19.006Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/cc/75/f620449f0056eff0ec7c1b1e088f71068eb4e47a46eb54f6c065c6ad7675/magic_filter-1.0.12-py3-none-any.whl", hash = "sha256:e5929e544f310c2b1f154318db8c5cdf544dd658efa998172acd2e4ba0f6c6a6", size = 11335, upload-time = "2023-10-01T12:33:17.711Z" },
+]
+
+[[package]]
+name = "multidict"
+version = "6.7.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/1a/c2/c2d94cbe6ac1753f3fc980da97b3d930efe1da3af3c9f5125354436c073d/multidict-6.7.1.tar.gz", hash = "sha256:ec6652a1bee61c53a3e5776b6049172c53b6aaba34f18c9ad04f82712bac623d", size = 102010, upload-time = "2026-01-26T02:46:45.979Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/8d/9c/f20e0e2cf80e4b2e4b1c365bf5fe104ee633c751a724246262db8f1a0b13/multidict-6.7.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:a90f75c956e32891a4eda3639ce6dd86e87105271f43d43442a3aedf3cddf172", size = 76893, upload-time = "2026-01-26T02:43:52.754Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/cf/18ef143a81610136d3da8193da9d80bfe1cb548a1e2d1c775f26b23d024a/multidict-6.7.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:3fccb473e87eaa1382689053e4a4618e7ba7b9b9b8d6adf2027ee474597128cd", size = 45456, upload-time = "2026-01-26T02:43:53.893Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/65/1caac9d4cd32e8433908683446eebc953e82d22b03d10d41a5f0fefe991b/multidict-6.7.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:b0fa96985700739c4c7853a43c0b3e169360d6855780021bfc6d0f1ce7c123e7", size = 43872, upload-time = "2026-01-26T02:43:55.041Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/3b/d6bd75dc4f3ff7c73766e04e705b00ed6dbbaccf670d9e05a12b006f5a21/multidict-6.7.1-cp312-cp312-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:cb2a55f408c3043e42b40cc8eecd575afa27b7e0b956dfb190de0f8499a57a53", size = 251018, upload-time = "2026-01-26T02:43:56.198Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/80/c959c5933adedb9ac15152e4067c702a808ea183a8b64cf8f31af8ad3155/multidict-6.7.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:eb0ce7b2a32d09892b3dd6cc44877a0d02a33241fafca5f25c8b6b62374f8b75", size = 258883, upload-time = "2026-01-26T02:43:57.499Z" },
+    { url = "https://files.pythonhosted.org/packages/86/85/7ed40adafea3d4f1c8b916e3b5cc3a8e07dfcdcb9cd72800f4ed3ca1b387/multidict-6.7.1-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:c3a32d23520ee37bf327d1e1a656fec76a2edd5c038bf43eddfa0572ec49c60b", size = 242413, upload-time = "2026-01-26T02:43:58.755Z" },
+    { url = "https://files.pythonhosted.org/packages/d2/57/b8565ff533e48595503c785f8361ff9a4fde4d67de25c207cd0ba3befd03/multidict-6.7.1-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:9c90fed18bffc0189ba814749fdcc102b536e83a9f738a9003e569acd540a733", size = 268404, upload-time = "2026-01-26T02:44:00.216Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/50/9810c5c29350f7258180dfdcb2e52783a0632862eb334c4896ac717cebcb/multidict-6.7.1-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:da62917e6076f512daccfbbde27f46fed1c98fee202f0559adec8ee0de67f71a", size = 269456, upload-time = "2026-01-26T02:44:02.202Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/8d/5e5be3ced1d12966fefb5c4ea3b2a5b480afcea36406559442c6e31d4a48/multidict-6.7.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bfde23ef6ed9db7eaee6c37dcec08524cb43903c60b285b172b6c094711b3961", size = 256322, upload-time = "2026-01-26T02:44:03.56Z" },
+    { url = "https://files.pythonhosted.org/packages/31/6e/d8a26d81ac166a5592782d208dd90dfdc0a7a218adaa52b45a672b46c122/multidict-6.7.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:3758692429e4e32f1ba0df23219cd0b4fc0a52f476726fff9337d1a57676a582", size = 253955, upload-time = "2026-01-26T02:44:04.845Z" },
+    { url = "https://files.pythonhosted.org/packages/59/4c/7c672c8aad41534ba619bcd4ade7a0dc87ed6b8b5c06149b85d3dd03f0cd/multidict-6.7.1-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:398c1478926eca669f2fd6a5856b6de9c0acf23a2cb59a14c0ba5844fa38077e", size = 251254, upload-time = "2026-01-26T02:44:06.133Z" },
+    { url = "https://files.pythonhosted.org/packages/7b/bd/84c24de512cbafbdbc39439f74e967f19570ce7924e3007174a29c348916/multidict-6.7.1-cp312-cp312-musllinux_1_2_i686.whl", hash = "sha256:c102791b1c4f3ab36ce4101154549105a53dc828f016356b3e3bcae2e3a039d3", size = 252059, upload-time = "2026-01-26T02:44:07.518Z" },
+    { url = "https://files.pythonhosted.org/packages/fa/ba/f5449385510825b73d01c2d4087bf6d2fccc20a2d42ac34df93191d3dd03/multidict-6.7.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:a088b62bd733e2ad12c50dad01b7d0166c30287c166e137433d3b410add807a6", size = 263588, upload-time = "2026-01-26T02:44:09.382Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/11/afc7c677f68f75c84a69fe37184f0f82fce13ce4b92f49f3db280b7e92b3/multidict-6.7.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:3d51ff4785d58d3f6c91bdbffcb5e1f7ddfda557727043aa20d20ec4f65e324a", size = 259642, upload-time = "2026-01-26T02:44:10.73Z" },
+    { url = "https://files.pythonhosted.org/packages/2b/17/ebb9644da78c4ab36403739e0e6e0e30ebb135b9caf3440825001a0bddcb/multidict-6.7.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:fc5907494fccf3e7d3f94f95c91d6336b092b5fc83811720fae5e2765890dfba", size = 251377, upload-time = "2026-01-26T02:44:12.042Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/a4/840f5b97339e27846c46307f2530a2805d9d537d8b8bd416af031cad7fa0/multidict-6.7.1-cp312-cp312-win32.whl", hash = "sha256:28ca5ce2fd9716631133d0e9a9b9a745ad7f60bac2bccafb56aa380fc0b6c511", size = 41887, upload-time = "2026-01-26T02:44:14.245Z" },
+    { url = "https://files.pythonhosted.org/packages/80/31/0b2517913687895f5904325c2069d6a3b78f66cc641a86a2baf75a05dcbb/multidict-6.7.1-cp312-cp312-win_amd64.whl", hash = "sha256:fcee94dfbd638784645b066074b338bc9cc155d4b4bffa4adce1615c5a426c19", size = 46053, upload-time = "2026-01-26T02:44:15.371Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/5b/aba28e4ee4006ae4c7df8d327d31025d760ffa992ea23812a601d226e682/multidict-6.7.1-cp312-cp312-win_arm64.whl", hash = "sha256:ba0a9fb644d0c1a2194cf7ffb043bd852cea63a57f66fbd33959f7dae18517bf", size = 43307, upload-time = "2026-01-26T02:44:16.852Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/22/929c141d6c0dba87d3e1d38fbdf1ba8baba86b7776469f2bc2d3227a1e67/multidict-6.7.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:2b41f5fed0ed563624f1c17630cb9941cf2309d4df00e494b551b5f3e3d67a23", size = 76174, upload-time = "2026-01-26T02:44:18.509Z" },
+    { url = "https://files.pythonhosted.org/packages/c7/75/bc704ae15fee974f8fccd871305e254754167dce5f9e42d88a2def741a1d/multidict-6.7.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:84e61e3af5463c19b67ced91f6c634effb89ef8bfc5ca0267f954451ed4bb6a2", size = 45116, upload-time = "2026-01-26T02:44:19.745Z" },
+    { url = "https://files.pythonhosted.org/packages/79/76/55cd7186f498ed080a18440c9013011eb548f77ae1b297206d030eb1180a/multidict-6.7.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:935434b9853c7c112eee7ac891bc4cb86455aa631269ae35442cb316790c1445", size = 43524, upload-time = "2026-01-26T02:44:21.571Z" },
+    { url = "https://files.pythonhosted.org/packages/e9/3c/414842ef8d5a1628d68edee29ba0e5bcf235dbfb3ccd3ea303a7fe8c72ff/multidict-6.7.1-cp313-cp313-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:432feb25a1cb67fe82a9680b4d65fb542e4635cb3166cd9c01560651ad60f177", size = 249368, upload-time = "2026-01-26T02:44:22.803Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/32/befed7f74c458b4a525e60519fe8d87eef72bb1e99924fa2b0f9d97a221e/multidict-6.7.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e82d14e3c948952a1a85503817e038cba5905a3352de76b9a465075d072fba23", size = 256952, upload-time = "2026-01-26T02:44:24.306Z" },
+    { url = "https://files.pythonhosted.org/packages/03/d6/c878a44ba877f366630c860fdf74bfb203c33778f12b6ac274936853c451/multidict-6.7.1-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:4cfb48c6ea66c83bcaaf7e4dfa7ec1b6bbcf751b7db85a328902796dfde4c060", size = 240317, upload-time = "2026-01-26T02:44:25.772Z" },
+    { url = "https://files.pythonhosted.org/packages/68/49/57421b4d7ad2e9e60e25922b08ceb37e077b90444bde6ead629095327a6f/multidict-6.7.1-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:1d540e51b7e8e170174555edecddbd5538105443754539193e3e1061864d444d", size = 267132, upload-time = "2026-01-26T02:44:27.648Z" },
+    { url = "https://files.pythonhosted.org/packages/b7/fe/ec0edd52ddbcea2a2e89e174f0206444a61440b40f39704e64dc807a70bd/multidict-6.7.1-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:273d23f4b40f3dce4d6c8a821c741a86dec62cded82e1175ba3d99be128147ed", size = 268140, upload-time = "2026-01-26T02:44:29.588Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/73/6e1b01cbeb458807aa0831742232dbdd1fa92bfa33f52a3f176b4ff3dc11/multidict-6.7.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d624335fd4fa1c08a53f8b4be7676ebde19cd092b3895c421045ca87895b429", size = 254277, upload-time = "2026-01-26T02:44:30.902Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/b2/5fb8c124d7561a4974c342bc8c778b471ebbeb3cc17df696f034a7e9afe7/multidict-6.7.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:12fad252f8b267cc75b66e8fc51b3079604e8d43a75428ffe193cd9e2195dfd6", size = 252291, upload-time = "2026-01-26T02:44:32.31Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/96/51d4e4e06bcce92577fcd488e22600bd38e4fd59c20cb49434d054903bd2/multidict-6.7.1-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:03ede2a6ffbe8ef936b92cb4529f27f42be7f56afcdab5ab739cd5f27fb1cbf9", size = 250156, upload-time = "2026-01-26T02:44:33.734Z" },
+    { url = "https://files.pythonhosted.org/packages/db/6b/420e173eec5fba721a50e2a9f89eda89d9c98fded1124f8d5c675f7a0c0f/multidict-6.7.1-cp313-cp313-musllinux_1_2_i686.whl", hash = "sha256:90efbcf47dbe33dcf643a1e400d67d59abeac5db07dc3f27d6bdeae497a2198c", size = 249742, upload-time = "2026-01-26T02:44:35.222Z" },
+    { url = "https://files.pythonhosted.org/packages/44/a3/ec5b5bd98f306bc2aa297b8c6f11a46714a56b1e6ef5ebda50a4f5d7c5fb/multidict-6.7.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:5c4b9bfc148f5a91be9244d6264c53035c8a0dcd2f51f1c3c6e30e30ebaa1c84", size = 262221, upload-time = "2026-01-26T02:44:36.604Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/f7/e8c0d0da0cd1e28d10e624604e1a36bcc3353aaebdfdc3a43c72bc683a12/multidict-6.7.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:401c5a650f3add2472d1d288c26deebc540f99e2fb83e9525007a74cd2116f1d", size = 258664, upload-time = "2026-01-26T02:44:38.008Z" },
+    { url = "https://files.pythonhosted.org/packages/52/da/151a44e8016dd33feed44f730bd856a66257c1ee7aed4f44b649fb7edeb3/multidict-6.7.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:97891f3b1b3ffbded884e2916cacf3c6fc87b66bb0dde46f7357404750559f33", size = 249490, upload-time = "2026-01-26T02:44:39.386Z" },
+    { url = "https://files.pythonhosted.org/packages/87/af/a3b86bf9630b732897f6fc3f4c4714b90aa4361983ccbdcd6c0339b21b0c/multidict-6.7.1-cp313-cp313-win32.whl", hash = "sha256:e1c5988359516095535c4301af38d8a8838534158f649c05dd1050222321bcb3", size = 41695, upload-time = "2026-01-26T02:44:41.318Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/35/e994121b0e90e46134673422dd564623f93304614f5d11886b1b3e06f503/multidict-6.7.1-cp313-cp313-win_amd64.whl", hash = "sha256:960c83bf01a95b12b08fd54324a4eb1d5b52c88932b5cba5d6e712bb3ed12eb5", size = 45884, upload-time = "2026-01-26T02:44:42.488Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/61/42d3e5dbf661242a69c97ea363f2d7b46c567da8eadef8890022be6e2ab0/multidict-6.7.1-cp313-cp313-win_arm64.whl", hash = "sha256:563fe25c678aaba333d5399408f5ec3c383ca5b663e7f774dd179a520b8144df", size = 43122, upload-time = "2026-01-26T02:44:43.664Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/b3/e6b21c6c4f314bb956016b0b3ef2162590a529b84cb831c257519e7fde44/multidict-6.7.1-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:c76c4bec1538375dad9d452d246ca5368ad6e1c9039dadcf007ae59c70619ea1", size = 83175, upload-time = "2026-01-26T02:44:44.894Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/76/23ecd2abfe0957b234f6c960f4ade497f55f2c16aeb684d4ecdbf1c95791/multidict-6.7.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:57b46b24b5d5ebcc978da4ec23a819a9402b4228b8a90d9c656422b4bdd8a963", size = 48460, upload-time = "2026-01-26T02:44:46.106Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/57/a0ed92b23f3a042c36bc4227b72b97eca803f5f1801c1ab77c8a212d455e/multidict-6.7.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:e954b24433c768ce78ab7929e84ccf3422e46deb45a4dc9f93438f8217fa2d34", size = 46930, upload-time = "2026-01-26T02:44:47.278Z" },
+    { url = "https://files.pythonhosted.org/packages/b5/66/02ec7ace29162e447f6382c495dc95826bf931d3818799bbef11e8f7df1a/multidict-6.7.1-cp313-cp313t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:3bd231490fa7217cc832528e1cd8752a96f0125ddd2b5749390f7c3ec8721b65", size = 242582, upload-time = "2026-01-26T02:44:48.604Z" },
+    { url = "https://files.pythonhosted.org/packages/58/18/64f5a795e7677670e872673aca234162514696274597b3708b2c0d276cce/multidict-6.7.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:253282d70d67885a15c8a7716f3a73edf2d635793ceda8173b9ecc21f2fb8292", size = 250031, upload-time = "2026-01-26T02:44:50.544Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/ed/e192291dbbe51a8290c5686f482084d31bcd9d09af24f63358c3d42fd284/multidict-6.7.1-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:0b4c48648d7649c9335cf1927a8b87fa692de3dcb15faa676c6a6f1f1aabda43", size = 228596, upload-time = "2026-01-26T02:44:51.951Z" },
+    { url = "https://files.pythonhosted.org/packages/1e/7e/3562a15a60cf747397e7f2180b0a11dc0c38d9175a650e75fa1b4d325e15/multidict-6.7.1-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:98bc624954ec4d2c7cb074b8eefc2b5d0ce7d482e410df446414355d158fe4ca", size = 257492, upload-time = "2026-01-26T02:44:53.902Z" },
+    { url = "https://files.pythonhosted.org/packages/24/02/7d0f9eae92b5249bb50ac1595b295f10e263dd0078ebb55115c31e0eaccd/multidict-6.7.1-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:1b99af4d9eec0b49927b4402bcbb58dea89d3e0db8806a4086117019939ad3dd", size = 255899, upload-time = "2026-01-26T02:44:55.316Z" },
+    { url = "https://files.pythonhosted.org/packages/00/e3/9b60ed9e23e64c73a5cde95269ef1330678e9c6e34dd4eb6b431b85b5a10/multidict-6.7.1-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:6aac4f16b472d5b7dc6f66a0d49dd57b0e0902090be16594dc9ebfd3d17c47e7", size = 247970, upload-time = "2026-01-26T02:44:56.783Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/06/538e58a63ed5cfb0bd4517e346b91da32fde409d839720f664e9a4ae4f9d/multidict-6.7.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:21f830fe223215dffd51f538e78c172ed7c7f60c9b96a2bf05c4848ad49921c3", size = 245060, upload-time = "2026-01-26T02:44:58.195Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/2f/d743a3045a97c895d401e9bd29aaa09b94f5cbdf1bd561609e5a6c431c70/multidict-6.7.1-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:f5dd81c45b05518b9aa4da4aa74e1c93d715efa234fd3e8a179df611cc85e5f4", size = 235888, upload-time = "2026-01-26T02:44:59.57Z" },
+    { url = "https://files.pythonhosted.org/packages/38/83/5a325cac191ab28b63c52f14f1131f3b0a55ba3b9aa65a6d0bf2a9b921a0/multidict-6.7.1-cp313-cp313t-musllinux_1_2_i686.whl", hash = "sha256:eb304767bca2bb92fb9c5bd33cedc95baee5bb5f6c88e63706533a1c06ad08c8", size = 243554, upload-time = "2026-01-26T02:45:01.054Z" },
+    { url = "https://files.pythonhosted.org/packages/20/1f/9d2327086bd15da2725ef6aae624208e2ef828ed99892b17f60c344e57ed/multidict-6.7.1-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:c9035dde0f916702850ef66460bc4239d89d08df4d02023a5926e7446724212c", size = 252341, upload-time = "2026-01-26T02:45:02.484Z" },
+    { url = "https://files.pythonhosted.org/packages/e8/2c/2a1aa0280cf579d0f6eed8ee5211c4f1730bd7e06c636ba2ee6aafda302e/multidict-6.7.1-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:af959b9beeb66c822380f222f0e0a1889331597e81f1ded7f374f3ecb0fd6c52", size = 246391, upload-time = "2026-01-26T02:45:03.862Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/03/7ca022ffc36c5a3f6e03b179a5ceb829be9da5783e6fe395f347c0794680/multidict-6.7.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:41f2952231456154ee479651491e94118229844dd7226541788be783be2b5108", size = 243422, upload-time = "2026-01-26T02:45:05.296Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/1d/b31650eab6c5778aceed46ba735bd97f7c7d2f54b319fa916c0f96e7805b/multidict-6.7.1-cp313-cp313t-win32.whl", hash = "sha256:df9f19c28adcb40b6aae30bbaa1478c389efd50c28d541d76760199fc1037c32", size = 47770, upload-time = "2026-01-26T02:45:06.754Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/5b/2d2d1d522e51285bd61b1e20df8f47ae1a9d80839db0b24ea783b3832832/multidict-6.7.1-cp313-cp313t-win_amd64.whl", hash = "sha256:d54ecf9f301853f2c5e802da559604b3e95bb7a3b01a9c295c6ee591b9882de8", size = 53109, upload-time = "2026-01-26T02:45:08.044Z" },
+    { url = "https://files.pythonhosted.org/packages/3d/a3/cc409ba012c83ca024a308516703cf339bdc4b696195644a7215a5164a24/multidict-6.7.1-cp313-cp313t-win_arm64.whl", hash = "sha256:5a37ca18e360377cfda1d62f5f382ff41f2b8c4ccb329ed974cc2e1643440118", size = 45573, upload-time = "2026-01-26T02:45:09.349Z" },
+    { url = "https://files.pythonhosted.org/packages/91/cc/db74228a8be41884a567e88a62fd589a913708fcf180d029898c17a9a371/multidict-6.7.1-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8f333ec9c5eb1b7105e3b84b53141e66ca05a19a605368c55450b6ba208cb9ee", size = 75190, upload-time = "2026-01-26T02:45:10.651Z" },
+    { url = "https://files.pythonhosted.org/packages/d5/22/492f2246bb5b534abd44804292e81eeaf835388901f0c574bac4eeec73c5/multidict-6.7.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:a407f13c188f804c759fc6a9f88286a565c242a76b27626594c133b82883b5c2", size = 44486, upload-time = "2026-01-26T02:45:11.938Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/4f/733c48f270565d78b4544f2baddc2fb2a245e5a8640254b12c36ac7ac68e/multidict-6.7.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:0e161ddf326db5577c3a4cc2d8648f81456e8a20d40415541587a71620d7a7d1", size = 43219, upload-time = "2026-01-26T02:45:14.346Z" },
+    { url = "https://files.pythonhosted.org/packages/24/bb/2c0c2287963f4259c85e8bcbba9182ced8d7fca65c780c38e99e61629d11/multidict-6.7.1-cp314-cp314-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:1e3a8bb24342a8201d178c3b4984c26ba81a577c80d4d525727427460a50c22d", size = 245132, upload-time = "2026-01-26T02:45:15.712Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/f9/44d4b3064c65079d2467888794dea218d1601898ac50222ab8a9a8094460/multidict-6.7.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:97231140a50f5d447d3164f994b86a0bed7cd016e2682f8650d6a9158e14fd31", size = 252420, upload-time = "2026-01-26T02:45:17.293Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/13/78f7275e73fa17b24c9a51b0bd9d73ba64bb32d0ed51b02a746eb876abe7/multidict-6.7.1-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:6b10359683bd8806a200fd2909e7c8ca3a7b24ec1d8132e483d58e791d881048", size = 233510, upload-time = "2026-01-26T02:45:19.356Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/25/8167187f62ae3cbd52da7893f58cb036b47ea3fb67138787c76800158982/multidict-6.7.1-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:283ddac99f7ac25a4acadbf004cb5ae34480bbeb063520f70ce397b281859362", size = 264094, upload-time = "2026-01-26T02:45:20.834Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/e7/69a3a83b7b030cf283fb06ce074a05a02322359783424d7edf0f15fe5022/multidict-6.7.1-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:538cec1e18c067d0e6103aa9a74f9e832904c957adc260e61cd9d8cf0c3b3d37", size = 260786, upload-time = "2026-01-26T02:45:22.818Z" },
+    { url = "https://files.pythonhosted.org/packages/fe/3b/8ec5074bcfc450fe84273713b4b0a0dd47c0249358f5d82eb8104ffe2520/multidict-6.7.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:7eee46ccb30ff48a1e35bb818cc90846c6be2b68240e42a78599166722cea709", size = 248483, upload-time = "2026-01-26T02:45:24.368Z" },
+    { url = "https://files.pythonhosted.org/packages/48/5a/d5a99e3acbca0e29c5d9cba8f92ceb15dce78bab963b308ae692981e3a5d/multidict-6.7.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:fa263a02f4f2dd2d11a7b1bb4362aa7cb1049f84a9235d31adf63f30143469a0", size = 248403, upload-time = "2026-01-26T02:45:25.982Z" },
+    { url = "https://files.pythonhosted.org/packages/35/48/e58cd31f6c7d5102f2a4bf89f96b9cf7e00b6c6f3d04ecc44417c00a5a3c/multidict-6.7.1-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:2e1425e2f99ec5bd36c15a01b690a1a2456209c5deed58f95469ffb46039ccbb", size = 240315, upload-time = "2026-01-26T02:45:27.487Z" },
+    { url = "https://files.pythonhosted.org/packages/94/33/1cd210229559cb90b6786c30676bb0c58249ff42f942765f88793b41fdce/multidict-6.7.1-cp314-cp314-musllinux_1_2_i686.whl", hash = "sha256:497394b3239fc6f0e13a78a3e1b61296e72bf1c5f94b4c4eb80b265c37a131cd", size = 245528, upload-time = "2026-01-26T02:45:28.991Z" },
+    { url = "https://files.pythonhosted.org/packages/64/f2/6e1107d226278c876c783056b7db43d800bb64c6131cec9c8dfb6903698e/multidict-6.7.1-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:233b398c29d3f1b9676b4b6f75c518a06fcb2ea0b925119fb2c1bc35c05e1601", size = 258784, upload-time = "2026-01-26T02:45:30.503Z" },
+    { url = "https://files.pythonhosted.org/packages/4d/c1/11f664f14d525e4a1b5327a82d4de61a1db604ab34c6603bb3c2cc63ad34/multidict-6.7.1-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:93b1818e4a6e0930454f0f2af7dfce69307ca03cdcfb3739bf4d91241967b6c1", size = 251980, upload-time = "2026-01-26T02:45:32.603Z" },
+    { url = "https://files.pythonhosted.org/packages/e1/9f/75a9ac888121d0c5bbd4ecf4eead45668b1766f6baabfb3b7f66a410e231/multidict-6.7.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:f33dc2a3abe9249ea5d8360f969ec7f4142e7ac45ee7014d8f8d5acddf178b7b", size = 243602, upload-time = "2026-01-26T02:45:34.043Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/e7/50bf7b004cc8525d80dbbbedfdc7aed3e4c323810890be4413e589074032/multidict-6.7.1-cp314-cp314-win32.whl", hash = "sha256:3ab8b9d8b75aef9df299595d5388b14530839f6422333357af1339443cff777d", size = 40930, upload-time = "2026-01-26T02:45:36.278Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/bf/52f25716bbe93745595800f36fb17b73711f14da59ed0bb2eba141bc9f0f/multidict-6.7.1-cp314-cp314-win_amd64.whl", hash = "sha256:5e01429a929600e7dab7b166062d9bb54a5eed752384c7384c968c2afab8f50f", size = 45074, upload-time = "2026-01-26T02:45:37.546Z" },
+    { url = "https://files.pythonhosted.org/packages/97/ab/22803b03285fa3a525f48217963da3a65ae40f6a1b6f6cf2768879e208f9/multidict-6.7.1-cp314-cp314-win_arm64.whl", hash = "sha256:4885cb0e817aef5d00a2e8451d4665c1808378dc27c2705f1bf4ef8505c0d2e5", size = 42471, upload-time = "2026-01-26T02:45:38.889Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/6d/f9293baa6146ba9507e360ea0292b6422b016907c393e2f63fc40ab7b7b5/multidict-6.7.1-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:0458c978acd8e6ea53c81eefaddbbee9c6c5e591f41b3f5e8e194780fe026581", size = 82401, upload-time = "2026-01-26T02:45:40.254Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/68/53b5494738d83558d87c3c71a486504d8373421c3e0dbb6d0db48ad42ee0/multidict-6.7.1-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:c0abd12629b0af3cf590982c0b413b1e7395cd4ec026f30986818ab95bfaa94a", size = 48143, upload-time = "2026-01-26T02:45:41.635Z" },
+    { url = "https://files.pythonhosted.org/packages/37/e8/5284c53310dcdc99ce5d66563f6e5773531a9b9fe9ec7a615e9bc306b05f/multidict-6.7.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:14525a5f61d7d0c94b368a42cff4c9a4e7ba2d52e2672a7b23d84dc86fb02b0c", size = 46507, upload-time = "2026-01-26T02:45:42.99Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/fc/6800d0e5b3875568b4083ecf5f310dcf91d86d52573160834fb4bfcf5e4f/multidict-6.7.1-cp314-cp314t-manylinux1_i686.manylinux_2_28_i686.manylinux_2_5_i686.whl", hash = "sha256:17307b22c217b4cf05033dabefe68255a534d637c6c9b0cc8382718f87be4262", size = 239358, upload-time = "2026-01-26T02:45:44.376Z" },
+    { url = "https://files.pythonhosted.org/packages/41/75/4ad0973179361cdf3a113905e6e088173198349131be2b390f9fa4da5fc6/multidict-6.7.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:7a7e590ff876a3eaf1c02a4dfe0724b6e69a9e9de6d8f556816f29c496046e59", size = 246884, upload-time = "2026-01-26T02:45:47.167Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/9c/095bb28b5da139bd41fb9a5d5caff412584f377914bd8787c2aa98717130/multidict-6.7.1-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:5fa6a95dfee63893d80a34758cd0e0c118a30b8dcb46372bf75106c591b77889", size = 225878, upload-time = "2026-01-26T02:45:48.698Z" },
+    { url = "https://files.pythonhosted.org/packages/07/d0/c0a72000243756e8f5a277b6b514fa005f2c73d481b7d9e47cd4568aa2e4/multidict-6.7.1-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:a0543217a6a017692aa6ae5cc39adb75e587af0f3a82288b1492eb73dd6cc2a4", size = 253542, upload-time = "2026-01-26T02:45:50.164Z" },
+    { url = "https://files.pythonhosted.org/packages/c0/6b/f69da15289e384ecf2a68837ec8b5ad8c33e973aa18b266f50fe55f24b8c/multidict-6.7.1-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f99fe611c312b3c1c0ace793f92464d8cd263cc3b26b5721950d977b006b6c4d", size = 252403, upload-time = "2026-01-26T02:45:51.779Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/76/b9669547afa5a1a25cd93eaca91c0da1c095b06b6d2d8ec25b713588d3a1/multidict-6.7.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9004d8386d133b7e6135679424c91b0b854d2d164af6ea3f289f8f2761064609", size = 244889, upload-time = "2026-01-26T02:45:53.27Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/a9/a50d2669e506dad33cfc45b5d574a205587b7b8a5f426f2fbb2e90882588/multidict-6.7.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:e628ef0e6859ffd8273c69412a2465c4be4a9517d07261b33334b5ec6f3c7489", size = 241982, upload-time = "2026-01-26T02:45:54.919Z" },
+    { url = "https://files.pythonhosted.org/packages/c5/bb/1609558ad8b456b4827d3c5a5b775c93b87878fd3117ed3db3423dfbce1b/multidict-6.7.1-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:841189848ba629c3552035a6a7f5bf3b02eb304e9fea7492ca220a8eda6b0e5c", size = 232415, upload-time = "2026-01-26T02:45:56.981Z" },
+    { url = "https://files.pythonhosted.org/packages/d8/59/6f61039d2aa9261871e03ab9dc058a550d240f25859b05b67fd70f80d4b3/multidict-6.7.1-cp314-cp314t-musllinux_1_2_i686.whl", hash = "sha256:ce1bbd7d780bb5a0da032e095c951f7014d6b0a205f8318308140f1a6aba159e", size = 240337, upload-time = "2026-01-26T02:45:58.698Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/29/fdc6a43c203890dc2ae9249971ecd0c41deaedfe00d25cb6564b2edd99eb/multidict-6.7.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:b26684587228afed0d50cf804cc71062cc9c1cdf55051c4c6345d372947b268c", size = 248788, upload-time = "2026-01-26T02:46:00.862Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/14/a153a06101323e4cf086ecee3faadba52ff71633d471f9685c42e3736163/multidict-6.7.1-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:9f9af11306994335398293f9958071019e3ab95e9a707dc1383a35613f6abcb9", size = 242842, upload-time = "2026-01-26T02:46:02.824Z" },
+    { url = "https://files.pythonhosted.org/packages/41/5f/604ae839e64a4a6efc80db94465348d3b328ee955e37acb24badbcd24d83/multidict-6.7.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:b4938326284c4f1224178a560987b6cf8b4d38458b113d9b8c1db1a836e640a2", size = 240237, upload-time = "2026-01-26T02:46:05.898Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/60/c3a5187bf66f6fb546ff4ab8fb5a077cbdd832d7b1908d4365c7f74a1917/multidict-6.7.1-cp314-cp314t-win32.whl", hash = "sha256:98655c737850c064a65e006a3df7c997cd3b220be4ec8fe26215760b9697d4d7", size = 48008, upload-time = "2026-01-26T02:46:07.468Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/f7/addf1087b860ac60e6f382240f64fb99f8bfb532bb06f7c542b83c29ca61/multidict-6.7.1-cp314-cp314t-win_amd64.whl", hash = "sha256:497bde6223c212ba11d462853cfa4f0ae6ef97465033e7dc9940cdb3ab5b48e5", size = 53542, upload-time = "2026-01-26T02:46:08.809Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/81/4629d0aa32302ef7b2ec65c75a728cc5ff4fa410c50096174c1632e70b3e/multidict-6.7.1-cp314-cp314t-win_arm64.whl", hash = "sha256:2bbd113e0d4af5db41d5ebfe9ccaff89de2120578164f86a5d17d5a576d1e5b2", size = 44719, upload-time = "2026-01-26T02:46:11.146Z" },
+    { url = "https://files.pythonhosted.org/packages/81/08/7036c080d7117f28a4af526d794aab6a84463126db031b007717c1a6676e/multidict-6.7.1-py3-none-any.whl", hash = "sha256:55d97cc6dae627efa6a6e548885712d4864b81110ac76fa4e534c03819fa4a56", size = 12319, upload-time = "2026-01-26T02:46:44.004Z" },
+]
+
+[[package]]
+name = "mypy"
+version = "1.19.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "librt", marker = "platform_python_implementation != 'PyPy'" },
+    { name = "mypy-extensions" },
+    { name = "pathspec" },
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/f5/db/4efed9504bc01309ab9c2da7e352cc223569f05478012b5d9ece38fd44d2/mypy-1.19.1.tar.gz", hash = "sha256:19d88bb05303fe63f71dd2c6270daca27cb9401c4ca8255fe50d1d920e0eb9ba", size = 3582404, upload-time = "2025-12-15T05:03:48.42Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/06/8a/19bfae96f6615aa8a0604915512e0289b1fad33d5909bf7244f02935d33a/mypy-1.19.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:a8174a03289288c1f6c46d55cef02379b478bfbc8e358e02047487cad44c6ca1", size = 13206053, upload-time = "2025-12-15T05:03:46.622Z" },
+    { url = "https://files.pythonhosted.org/packages/a5/34/3e63879ab041602154ba2a9f99817bb0c85c4df19a23a1443c8986e4d565/mypy-1.19.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:ffcebe56eb09ff0c0885e750036a095e23793ba6c2e894e7e63f6d89ad51f22e", size = 12219134, upload-time = "2025-12-15T05:03:24.367Z" },
+    { url = "https://files.pythonhosted.org/packages/89/cc/2db6f0e95366b630364e09845672dbee0cbf0bbe753a204b29a944967cd9/mypy-1.19.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b64d987153888790bcdb03a6473d321820597ab8dd9243b27a92153c4fa50fd2", size = 12731616, upload-time = "2025-12-15T05:02:44.725Z" },
+    { url = "https://files.pythonhosted.org/packages/00/be/dd56c1fd4807bc1eba1cf18b2a850d0de7bacb55e158755eb79f77c41f8e/mypy-1.19.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c35d298c2c4bba75feb2195655dfea8124d855dfd7343bf8b8c055421eaf0cf8", size = 13620847, upload-time = "2025-12-15T05:03:39.633Z" },
+    { url = "https://files.pythonhosted.org/packages/6d/42/332951aae42b79329f743bf1da088cd75d8d4d9acc18fbcbd84f26c1af4e/mypy-1.19.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:34c81968774648ab5ac09c29a375fdede03ba253f8f8287847bd480782f73a6a", size = 13834976, upload-time = "2025-12-15T05:03:08.786Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/63/e7493e5f90e1e085c562bb06e2eb32cae27c5057b9653348d38b47daaecc/mypy-1.19.1-cp312-cp312-win_amd64.whl", hash = "sha256:b10e7c2cd7870ba4ad9b2d8a6102eb5ffc1f16ca35e3de6bfa390c1113029d13", size = 10118104, upload-time = "2025-12-15T05:03:10.834Z" },
+    { url = "https://files.pythonhosted.org/packages/de/9f/a6abae693f7a0c697dbb435aac52e958dc8da44e92e08ba88d2e42326176/mypy-1.19.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:e3157c7594ff2ef1634ee058aafc56a82db665c9438fd41b390f3bde1ab12250", size = 13201927, upload-time = "2025-12-15T05:02:29.138Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/a4/45c35ccf6e1c65afc23a069f50e2c66f46bd3798cbe0d680c12d12935caa/mypy-1.19.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:bdb12f69bcc02700c2b47e070238f42cb87f18c0bc1fc4cdb4fb2bc5fd7a3b8b", size = 12206730, upload-time = "2025-12-15T05:03:01.325Z" },
+    { url = "https://files.pythonhosted.org/packages/05/bb/cdcf89678e26b187650512620eec8368fded4cfd99cfcb431e4cdfd19dec/mypy-1.19.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f859fb09d9583a985be9a493d5cfc5515b56b08f7447759a0c5deaf68d80506e", size = 12724581, upload-time = "2025-12-15T05:03:20.087Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/32/dd260d52babf67bad8e6770f8e1102021877ce0edea106e72df5626bb0ec/mypy-1.19.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:c9a6538e0415310aad77cb94004ca6482330fece18036b5f360b62c45814c4ef", size = 13616252, upload-time = "2025-12-15T05:02:49.036Z" },
+    { url = "https://files.pythonhosted.org/packages/71/d0/5e60a9d2e3bd48432ae2b454b7ef2b62a960ab51292b1eda2a95edd78198/mypy-1.19.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:da4869fc5e7f62a88f3fe0b5c919d1d9f7ea3cef92d3689de2823fd27e40aa75", size = 13840848, upload-time = "2025-12-15T05:02:55.95Z" },
+    { url = "https://files.pythonhosted.org/packages/98/76/d32051fa65ecf6cc8c6610956473abdc9b4c43301107476ac03559507843/mypy-1.19.1-cp313-cp313-win_amd64.whl", hash = "sha256:016f2246209095e8eda7538944daa1d60e1e8134d98983b9fc1e92c1fc0cb8dd", size = 10135510, upload-time = "2025-12-15T05:02:58.438Z" },
+    { url = "https://files.pythonhosted.org/packages/de/eb/b83e75f4c820c4247a58580ef86fcd35165028f191e7e1ba57128c52782d/mypy-1.19.1-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:06e6170bd5836770e8104c8fdd58e5e725cfeb309f0a6c681a811f557e97eac1", size = 13199744, upload-time = "2025-12-15T05:03:30.823Z" },
+    { url = "https://files.pythonhosted.org/packages/94/28/52785ab7bfa165f87fcbb61547a93f98bb20e7f82f90f165a1f69bce7b3d/mypy-1.19.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:804bd67b8054a85447c8954215a906d6eff9cabeabe493fb6334b24f4bfff718", size = 12215815, upload-time = "2025-12-15T05:02:42.323Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/c6/bdd60774a0dbfb05122e3e925f2e9e846c009e479dcec4821dad881f5b52/mypy-1.19.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:21761006a7f497cb0d4de3d8ef4ca70532256688b0523eee02baf9eec895e27b", size = 12740047, upload-time = "2025-12-15T05:03:33.168Z" },
+    { url = "https://files.pythonhosted.org/packages/32/2a/66ba933fe6c76bd40d1fe916a83f04fed253152f451a877520b3c4a5e41e/mypy-1.19.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:28902ee51f12e0f19e1e16fbe2f8f06b6637f482c459dd393efddd0ec7f82045", size = 13601998, upload-time = "2025-12-15T05:03:13.056Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/da/5055c63e377c5c2418760411fd6a63ee2b96cf95397259038756c042574f/mypy-1.19.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:481daf36a4c443332e2ae9c137dfee878fcea781a2e3f895d54bd3002a900957", size = 13807476, upload-time = "2025-12-15T05:03:17.977Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/09/4ebd873390a063176f06b0dbf1f7783dd87bd120eae7727fa4ae4179b685/mypy-1.19.1-cp314-cp314-win_amd64.whl", hash = "sha256:8bb5c6f6d043655e055be9b542aa5f3bdd30e4f3589163e85f93f3640060509f", size = 10281872, upload-time = "2025-12-15T05:03:05.549Z" },
+    { url = "https://files.pythonhosted.org/packages/8d/f4/4ce9a05ce5ded1de3ec1c1d96cf9f9504a04e54ce0ed55cfa38619a32b8d/mypy-1.19.1-py3-none-any.whl", hash = "sha256:f1235f5ea01b7db5468d53ece6aaddf1ad0b88d9e7462b86ef96fe04995d7247", size = 2471239, upload-time = "2025-12-15T05:03:07.248Z" },
+]
+
+[[package]]
+name = "mypy-extensions"
+version = "1.1.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/a2/6e/371856a3fb9d31ca8dac321cda606860fa4548858c0cc45d9d1d4ca2628b/mypy_extensions-1.1.0.tar.gz", hash = "sha256:52e68efc3284861e772bbcd66823fde5ae21fd2fdb51c62a211403730b916558", size = 6343, upload-time = "2025-04-22T14:54:24.164Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/79/7b/2c79738432f5c924bef5071f933bcc9efd0473bac3b4aa584a6f7c1c8df8/mypy_extensions-1.1.0-py3-none-any.whl", hash = "sha256:1be4cccdb0f2482337c4743e60421de3a356cd97508abadd57d47403e94f5505", size = 4963, upload-time = "2025-04-22T14:54:22.983Z" },
+]
+
+[[package]]
+name = "packaging"
+version = "26.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/65/ee/299d360cdc32edc7d2cf530f3accf79c4fca01e96ffc950d8a52213bd8e4/packaging-26.0.tar.gz", hash = "sha256:00243ae351a257117b6a241061796684b084ed1c516a08c48a3f7e147a9d80b4", size = 143416, upload-time = "2026-01-21T20:50:39.064Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/b7/b9/c538f279a4e237a006a2c98387d081e9eb060d203d8ed34467cc0f0b9b53/packaging-26.0-py3-none-any.whl", hash = "sha256:b36f1fef9334a5588b4166f8bcd26a14e521f2b55e6b9de3aaa80d3ff7a37529", size = 74366, upload-time = "2026-01-21T20:50:37.788Z" },
+]
+
+[[package]]
+name = "pathspec"
+version = "1.0.4"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/fa/36/e27608899f9b8d4dff0617b2d9ab17ca5608956ca44461ac14ac48b44015/pathspec-1.0.4.tar.gz", hash = "sha256:0210e2ae8a21a9137c0d470578cb0e595af87edaa6ebf12ff176f14a02e0e645", size = 131200, upload-time = "2026-01-27T03:59:46.938Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/ef/3c/2c197d226f9ea224a9ab8d197933f9da0ae0aac5b6e0f884e2b8d9c8e9f7/pathspec-1.0.4-py3-none-any.whl", hash = "sha256:fb6ae2fd4e7c921a165808a552060e722767cfa526f99ca5156ed2ce45a5c723", size = 55206, upload-time = "2026-01-27T03:59:45.137Z" },
+]
+
+[[package]]
+name = "pluggy"
+version = "1.6.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f9/e2/3e91f31a7d2b083fe6ef3fa267035b518369d9511ffab804f839851d2779/pluggy-1.6.0.tar.gz", hash = "sha256:7dcc130b76258d33b90f61b658791dede3486c3e6bfb003ee5c9bfb396dd22f3", size = 69412, upload-time = "2025-05-15T12:30:07.975Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/54/20/4d324d65cc6d9205fabedc306948156824eb9f0ee1633355a8f7ec5c66bf/pluggy-1.6.0-py3-none-any.whl", hash = "sha256:e920276dd6813095e9377c0bc5566d94c932c33b27a3e3945d8389c374dd4746", size = 20538, upload-time = "2025-05-15T12:30:06.134Z" },
+]
+
+[[package]]
+name = "propcache"
+version = "0.4.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/9e/da/e9fc233cf63743258bff22b3dfa7ea5baef7b5bc324af47a0ad89b8ffc6f/propcache-0.4.1.tar.gz", hash = "sha256:f48107a8c637e80362555f37ecf49abe20370e557cc4ab374f04ec4423c97c3d", size = 46442, upload-time = "2025-10-08T19:49:02.291Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/a2/0f/f17b1b2b221d5ca28b4b876e8bb046ac40466513960646bda8e1853cdfa2/propcache-0.4.1-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:e153e9cd40cc8945138822807139367f256f89c6810c2634a4f6902b52d3b4e2", size = 80061, upload-time = "2025-10-08T19:46:46.075Z" },
+    { url = "https://files.pythonhosted.org/packages/76/47/8ccf75935f51448ba9a16a71b783eb7ef6b9ee60f5d14c7f8a8a79fbeed7/propcache-0.4.1-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:cd547953428f7abb73c5ad82cbb32109566204260d98e41e5dfdc682eb7f8403", size = 46037, upload-time = "2025-10-08T19:46:47.23Z" },
+    { url = "https://files.pythonhosted.org/packages/0a/b6/5c9a0e42df4d00bfb4a3cbbe5cf9f54260300c88a0e9af1f47ca5ce17ac0/propcache-0.4.1-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:f048da1b4f243fc44f205dfd320933a951b8d89e0afd4c7cacc762a8b9165207", size = 47324, upload-time = "2025-10-08T19:46:48.384Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/d3/6c7ee328b39a81ee877c962469f1e795f9db87f925251efeb0545e0020d0/propcache-0.4.1-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:ec17c65562a827bba85e3872ead335f95405ea1674860d96483a02f5c698fa72", size = 225505, upload-time = "2025-10-08T19:46:50.055Z" },
+    { url = "https://files.pythonhosted.org/packages/01/5d/1c53f4563490b1d06a684742cc6076ef944bc6457df6051b7d1a877c057b/propcache-0.4.1-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:405aac25c6394ef275dee4c709be43745d36674b223ba4eb7144bf4d691b7367", size = 230242, upload-time = "2025-10-08T19:46:51.815Z" },
+    { url = "https://files.pythonhosted.org/packages/20/e1/ce4620633b0e2422207c3cb774a0ee61cac13abc6217763a7b9e2e3f4a12/propcache-0.4.1-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:0013cb6f8dde4b2a2f66903b8ba740bdfe378c943c4377a200551ceb27f379e4", size = 238474, upload-time = "2025-10-08T19:46:53.208Z" },
+    { url = "https://files.pythonhosted.org/packages/46/4b/3aae6835b8e5f44ea6a68348ad90f78134047b503765087be2f9912140ea/propcache-0.4.1-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:15932ab57837c3368b024473a525e25d316d8353016e7cc0e5ba9eb343fbb1cf", size = 221575, upload-time = "2025-10-08T19:46:54.511Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/a5/8a5e8678bcc9d3a1a15b9a29165640d64762d424a16af543f00629c87338/propcache-0.4.1-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:031dce78b9dc099f4c29785d9cf5577a3faf9ebf74ecbd3c856a7b92768c3df3", size = 216736, upload-time = "2025-10-08T19:46:56.212Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/63/b7b215eddeac83ca1c6b934f89d09a625aa9ee4ba158338854c87210cc36/propcache-0.4.1-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:ab08df6c9a035bee56e31af99be621526bd237bea9f32def431c656b29e41778", size = 213019, upload-time = "2025-10-08T19:46:57.595Z" },
+    { url = "https://files.pythonhosted.org/packages/57/74/f580099a58c8af587cac7ba19ee7cb418506342fbbe2d4a4401661cca886/propcache-0.4.1-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:4d7af63f9f93fe593afbf104c21b3b15868efb2c21d07d8732c0c4287e66b6a6", size = 220376, upload-time = "2025-10-08T19:46:59.067Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/ee/542f1313aff7eaf19c2bb758c5d0560d2683dac001a1c96d0774af799843/propcache-0.4.1-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:cfc27c945f422e8b5071b6e93169679e4eb5bf73bbcbf1ba3ae3a83d2f78ebd9", size = 226988, upload-time = "2025-10-08T19:47:00.544Z" },
+    { url = "https://files.pythonhosted.org/packages/8f/18/9c6b015dd9c6930f6ce2229e1f02fb35298b847f2087ea2b436a5bfa7287/propcache-0.4.1-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:35c3277624a080cc6ec6f847cbbbb5b49affa3598c4535a0a4682a697aaa5c75", size = 215615, upload-time = "2025-10-08T19:47:01.968Z" },
+    { url = "https://files.pythonhosted.org/packages/80/9e/e7b85720b98c45a45e1fca6a177024934dc9bc5f4d5dd04207f216fc33ed/propcache-0.4.1-cp312-cp312-win32.whl", hash = "sha256:671538c2262dadb5ba6395e26c1731e1d52534bfe9ae56d0b5573ce539266aa8", size = 38066, upload-time = "2025-10-08T19:47:03.503Z" },
+    { url = "https://files.pythonhosted.org/packages/54/09/d19cff2a5aaac632ec8fc03737b223597b1e347416934c1b3a7df079784c/propcache-0.4.1-cp312-cp312-win_amd64.whl", hash = "sha256:cb2d222e72399fcf5890d1d5cc1060857b9b236adff2792ff48ca2dfd46c81db", size = 41655, upload-time = "2025-10-08T19:47:04.973Z" },
+    { url = "https://files.pythonhosted.org/packages/68/ab/6b5c191bb5de08036a8c697b265d4ca76148efb10fa162f14af14fb5f076/propcache-0.4.1-cp312-cp312-win_arm64.whl", hash = "sha256:204483131fb222bdaaeeea9f9e6c6ed0cac32731f75dfc1d4a567fc1926477c1", size = 37789, upload-time = "2025-10-08T19:47:06.077Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/df/6d9c1b6ac12b003837dde8a10231a7344512186e87b36e855bef32241942/propcache-0.4.1-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:43eedf29202c08550aac1d14e0ee619b0430aaef78f85864c1a892294fbc28cf", size = 77750, upload-time = "2025-10-08T19:47:07.648Z" },
+    { url = "https://files.pythonhosted.org/packages/8b/e8/677a0025e8a2acf07d3418a2e7ba529c9c33caf09d3c1f25513023c1db56/propcache-0.4.1-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:d62cdfcfd89ccb8de04e0eda998535c406bf5e060ffd56be6c586cbcc05b3311", size = 44780, upload-time = "2025-10-08T19:47:08.851Z" },
+    { url = "https://files.pythonhosted.org/packages/89/a4/92380f7ca60f99ebae761936bc48a72a639e8a47b29050615eef757cb2a7/propcache-0.4.1-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:cae65ad55793da34db5f54e4029b89d3b9b9490d8abe1b4c7ab5d4b8ec7ebf74", size = 46308, upload-time = "2025-10-08T19:47:09.982Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/48/c5ac64dee5262044348d1d78a5f85dd1a57464a60d30daee946699963eb3/propcache-0.4.1-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:333ddb9031d2704a301ee3e506dc46b1fe5f294ec198ed6435ad5b6a085facfe", size = 208182, upload-time = "2025-10-08T19:47:11.319Z" },
+    { url = "https://files.pythonhosted.org/packages/c6/0c/cd762dd011a9287389a6a3eb43aa30207bde253610cca06824aeabfe9653/propcache-0.4.1-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:fd0858c20f078a32cf55f7e81473d96dcf3b93fd2ccdb3d40fdf54b8573df3af", size = 211215, upload-time = "2025-10-08T19:47:13.146Z" },
+    { url = "https://files.pythonhosted.org/packages/30/3e/49861e90233ba36890ae0ca4c660e95df565b2cd15d4a68556ab5865974e/propcache-0.4.1-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:678ae89ebc632c5c204c794f8dab2837c5f159aeb59e6ed0539500400577298c", size = 218112, upload-time = "2025-10-08T19:47:14.913Z" },
+    { url = "https://files.pythonhosted.org/packages/f1/8b/544bc867e24e1bd48f3118cecd3b05c694e160a168478fa28770f22fd094/propcache-0.4.1-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:d472aeb4fbf9865e0c6d622d7f4d54a4e101a89715d8904282bb5f9a2f476c3f", size = 204442, upload-time = "2025-10-08T19:47:16.277Z" },
+    { url = "https://files.pythonhosted.org/packages/50/a6/4282772fd016a76d3e5c0df58380a5ea64900afd836cec2c2f662d1b9bb3/propcache-0.4.1-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:4d3df5fa7e36b3225954fba85589da77a0fe6a53e3976de39caf04a0db4c36f1", size = 199398, upload-time = "2025-10-08T19:47:17.962Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/ec/d8a7cd406ee1ddb705db2139f8a10a8a427100347bd698e7014351c7af09/propcache-0.4.1-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:ee17f18d2498f2673e432faaa71698032b0127ebf23ae5974eeaf806c279df24", size = 196920, upload-time = "2025-10-08T19:47:19.355Z" },
+    { url = "https://files.pythonhosted.org/packages/f6/6c/f38ab64af3764f431e359f8baf9e0a21013e24329e8b85d2da32e8ed07ca/propcache-0.4.1-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:580e97762b950f993ae618e167e7be9256b8353c2dcd8b99ec100eb50f5286aa", size = 203748, upload-time = "2025-10-08T19:47:21.338Z" },
+    { url = "https://files.pythonhosted.org/packages/d6/e3/fa846bd70f6534d647886621388f0a265254d30e3ce47e5c8e6e27dbf153/propcache-0.4.1-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:501d20b891688eb8e7aa903021f0b72d5a55db40ffaab27edefd1027caaafa61", size = 205877, upload-time = "2025-10-08T19:47:23.059Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/39/8163fc6f3133fea7b5f2827e8eba2029a0277ab2c5beee6c1db7b10fc23d/propcache-0.4.1-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:9a0bd56e5b100aef69bd8562b74b46254e7c8812918d3baa700c8a8009b0af66", size = 199437, upload-time = "2025-10-08T19:47:24.445Z" },
+    { url = "https://files.pythonhosted.org/packages/93/89/caa9089970ca49c7c01662bd0eeedfe85494e863e8043565aeb6472ce8fe/propcache-0.4.1-cp313-cp313-win32.whl", hash = "sha256:bcc9aaa5d80322bc2fb24bb7accb4a30f81e90ab8d6ba187aec0744bc302ad81", size = 37586, upload-time = "2025-10-08T19:47:25.736Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/ab/f76ec3c3627c883215b5c8080debb4394ef5a7a29be811f786415fc1e6fd/propcache-0.4.1-cp313-cp313-win_amd64.whl", hash = "sha256:381914df18634f5494334d201e98245c0596067504b9372d8cf93f4bb23e025e", size = 40790, upload-time = "2025-10-08T19:47:26.847Z" },
+    { url = "https://files.pythonhosted.org/packages/59/1b/e71ae98235f8e2ba5004d8cb19765a74877abf189bc53fc0c80d799e56c3/propcache-0.4.1-cp313-cp313-win_arm64.whl", hash = "sha256:8873eb4460fd55333ea49b7d189749ecf6e55bf85080f11b1c4530ed3034cba1", size = 37158, upload-time = "2025-10-08T19:47:27.961Z" },
+    { url = "https://files.pythonhosted.org/packages/83/ce/a31bbdfc24ee0dcbba458c8175ed26089cf109a55bbe7b7640ed2470cfe9/propcache-0.4.1-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:92d1935ee1f8d7442da9c0c4fa7ac20d07e94064184811b685f5c4fada64553b", size = 81451, upload-time = "2025-10-08T19:47:29.445Z" },
+    { url = "https://files.pythonhosted.org/packages/25/9c/442a45a470a68456e710d96cacd3573ef26a1d0a60067e6a7d5e655621ed/propcache-0.4.1-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:473c61b39e1460d386479b9b2f337da492042447c9b685f28be4f74d3529e566", size = 46374, upload-time = "2025-10-08T19:47:30.579Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/bf/b1d5e21dbc3b2e889ea4327044fb16312a736d97640fb8b6aa3f9c7b3b65/propcache-0.4.1-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:c0ef0aaafc66fbd87842a3fe3902fd889825646bc21149eafe47be6072725835", size = 48396, upload-time = "2025-10-08T19:47:31.79Z" },
+    { url = "https://files.pythonhosted.org/packages/f4/04/5b4c54a103d480e978d3c8a76073502b18db0c4bc17ab91b3cb5092ad949/propcache-0.4.1-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f95393b4d66bfae908c3ca8d169d5f79cd65636ae15b5e7a4f6e67af675adb0e", size = 275950, upload-time = "2025-10-08T19:47:33.481Z" },
+    { url = "https://files.pythonhosted.org/packages/b4/c1/86f846827fb969c4b78b0af79bba1d1ea2156492e1b83dea8b8a6ae27395/propcache-0.4.1-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c07fda85708bc48578467e85099645167a955ba093be0a2dcba962195676e859", size = 273856, upload-time = "2025-10-08T19:47:34.906Z" },
+    { url = "https://files.pythonhosted.org/packages/36/1d/fc272a63c8d3bbad6878c336c7a7dea15e8f2d23a544bda43205dfa83ada/propcache-0.4.1-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:af223b406d6d000830c6f65f1e6431783fc3f713ba3e6cc8c024d5ee96170a4b", size = 280420, upload-time = "2025-10-08T19:47:36.338Z" },
+    { url = "https://files.pythonhosted.org/packages/07/0c/01f2219d39f7e53d52e5173bcb09c976609ba30209912a0680adfb8c593a/propcache-0.4.1-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:a78372c932c90ee474559c5ddfffd718238e8673c340dc21fe45c5b8b54559a0", size = 263254, upload-time = "2025-10-08T19:47:37.692Z" },
+    { url = "https://files.pythonhosted.org/packages/2d/18/cd28081658ce597898f0c4d174d4d0f3c5b6d4dc27ffafeef835c95eb359/propcache-0.4.1-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:564d9f0d4d9509e1a870c920a89b2fec951b44bf5ba7d537a9e7c1ccec2c18af", size = 261205, upload-time = "2025-10-08T19:47:39.659Z" },
+    { url = "https://files.pythonhosted.org/packages/7a/71/1f9e22eb8b8316701c2a19fa1f388c8a3185082607da8e406a803c9b954e/propcache-0.4.1-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:17612831fda0138059cc5546f4d12a2aacfb9e47068c06af35c400ba58ba7393", size = 247873, upload-time = "2025-10-08T19:47:41.084Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/65/3d4b61f36af2b4eddba9def857959f1016a51066b4f1ce348e0cf7881f58/propcache-0.4.1-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:41a89040cb10bd345b3c1a873b2bf36413d48da1def52f268a055f7398514874", size = 262739, upload-time = "2025-10-08T19:47:42.51Z" },
+    { url = "https://files.pythonhosted.org/packages/2a/42/26746ab087faa77c1c68079b228810436ccd9a5ce9ac85e2b7307195fd06/propcache-0.4.1-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:e35b88984e7fa64aacecea39236cee32dd9bd8c55f57ba8a75cf2399553f9bd7", size = 263514, upload-time = "2025-10-08T19:47:43.927Z" },
+    { url = "https://files.pythonhosted.org/packages/94/13/630690fe201f5502d2403dd3cfd451ed8858fe3c738ee88d095ad2ff407b/propcache-0.4.1-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:6f8b465489f927b0df505cbe26ffbeed4d6d8a2bbc61ce90eb074ff129ef0ab1", size = 257781, upload-time = "2025-10-08T19:47:45.448Z" },
+    { url = "https://files.pythonhosted.org/packages/92/f7/1d4ec5841505f423469efbfc381d64b7b467438cd5a4bbcbb063f3b73d27/propcache-0.4.1-cp313-cp313t-win32.whl", hash = "sha256:2ad890caa1d928c7c2965b48f3a3815c853180831d0e5503d35cf00c472f4717", size = 41396, upload-time = "2025-10-08T19:47:47.202Z" },
+    { url = "https://files.pythonhosted.org/packages/48/f0/615c30622316496d2cbbc29f5985f7777d3ada70f23370608c1d3e081c1f/propcache-0.4.1-cp313-cp313t-win_amd64.whl", hash = "sha256:f7ee0e597f495cf415bcbd3da3caa3bd7e816b74d0d52b8145954c5e6fd3ff37", size = 44897, upload-time = "2025-10-08T19:47:48.336Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/ca/6002e46eccbe0e33dcd4069ef32f7f1c9e243736e07adca37ae8c4830ec3/propcache-0.4.1-cp313-cp313t-win_arm64.whl", hash = "sha256:929d7cbe1f01bb7baffb33dc14eb5691c95831450a26354cd210a8155170c93a", size = 39789, upload-time = "2025-10-08T19:47:49.876Z" },
+    { url = "https://files.pythonhosted.org/packages/8e/5c/bca52d654a896f831b8256683457ceddd490ec18d9ec50e97dfd8fc726a8/propcache-0.4.1-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:3f7124c9d820ba5548d431afb4632301acf965db49e666aa21c305cbe8c6de12", size = 78152, upload-time = "2025-10-08T19:47:51.051Z" },
+    { url = "https://files.pythonhosted.org/packages/65/9b/03b04e7d82a5f54fb16113d839f5ea1ede58a61e90edf515f6577c66fa8f/propcache-0.4.1-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:c0d4b719b7da33599dfe3b22d3db1ef789210a0597bc650b7cee9c77c2be8c5c", size = 44869, upload-time = "2025-10-08T19:47:52.594Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/fa/89a8ef0468d5833a23fff277b143d0573897cf75bd56670a6d28126c7d68/propcache-0.4.1-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:9f302f4783709a78240ebc311b793f123328716a60911d667e0c036bc5dcbded", size = 46596, upload-time = "2025-10-08T19:47:54.073Z" },
+    { url = "https://files.pythonhosted.org/packages/86/bd/47816020d337f4a746edc42fe8d53669965138f39ee117414c7d7a340cfe/propcache-0.4.1-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c80ee5802e3fb9ea37938e7eecc307fb984837091d5fd262bb37238b1ae97641", size = 206981, upload-time = "2025-10-08T19:47:55.715Z" },
+    { url = "https://files.pythonhosted.org/packages/df/f6/c5fa1357cc9748510ee55f37173eb31bfde6d94e98ccd9e6f033f2fc06e1/propcache-0.4.1-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:ed5a841e8bb29a55fb8159ed526b26adc5bdd7e8bd7bf793ce647cb08656cdf4", size = 211490, upload-time = "2025-10-08T19:47:57.499Z" },
+    { url = "https://files.pythonhosted.org/packages/80/1e/e5889652a7c4a3846683401a48f0f2e5083ce0ec1a8a5221d8058fbd1adf/propcache-0.4.1-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:55c72fd6ea2da4c318e74ffdf93c4fe4e926051133657459131a95c846d16d44", size = 215371, upload-time = "2025-10-08T19:47:59.317Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/f2/889ad4b2408f72fe1a4f6a19491177b30ea7bf1a0fd5f17050ca08cfc882/propcache-0.4.1-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:8326e144341460402713f91df60ade3c999d601e7eb5ff8f6f7862d54de0610d", size = 201424, upload-time = "2025-10-08T19:48:00.67Z" },
+    { url = "https://files.pythonhosted.org/packages/27/73/033d63069b57b0812c8bd19f311faebeceb6ba31b8f32b73432d12a0b826/propcache-0.4.1-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:060b16ae65bc098da7f6d25bf359f1f31f688384858204fe5d652979e0015e5b", size = 197566, upload-time = "2025-10-08T19:48:02.604Z" },
+    { url = "https://files.pythonhosted.org/packages/dc/89/ce24f3dc182630b4e07aa6d15f0ff4b14ed4b9955fae95a0b54c58d66c05/propcache-0.4.1-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:89eb3fa9524f7bec9de6e83cf3faed9d79bffa560672c118a96a171a6f55831e", size = 193130, upload-time = "2025-10-08T19:48:04.499Z" },
+    { url = "https://files.pythonhosted.org/packages/a9/24/ef0d5fd1a811fb5c609278d0209c9f10c35f20581fcc16f818da959fc5b4/propcache-0.4.1-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:dee69d7015dc235f526fe80a9c90d65eb0039103fe565776250881731f06349f", size = 202625, upload-time = "2025-10-08T19:48:06.213Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/02/98ec20ff5546f68d673df2f7a69e8c0d076b5abd05ca882dc7ee3a83653d/propcache-0.4.1-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:5558992a00dfd54ccbc64a32726a3357ec93825a418a401f5cc67df0ac5d9e49", size = 204209, upload-time = "2025-10-08T19:48:08.432Z" },
+    { url = "https://files.pythonhosted.org/packages/a0/87/492694f76759b15f0467a2a93ab68d32859672b646aa8a04ce4864e7932d/propcache-0.4.1-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:c9b822a577f560fbd9554812526831712c1436d2c046cedee4c3796d3543b144", size = 197797, upload-time = "2025-10-08T19:48:09.968Z" },
+    { url = "https://files.pythonhosted.org/packages/ee/36/66367de3575db1d2d3f3d177432bd14ee577a39d3f5d1b3d5df8afe3b6e2/propcache-0.4.1-cp314-cp314-win32.whl", hash = "sha256:ab4c29b49d560fe48b696cdcb127dd36e0bc2472548f3bf56cc5cb3da2b2984f", size = 38140, upload-time = "2025-10-08T19:48:11.232Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/2a/a758b47de253636e1b8aef181c0b4f4f204bf0dd964914fb2af90a95b49b/propcache-0.4.1-cp314-cp314-win_amd64.whl", hash = "sha256:5a103c3eb905fcea0ab98be99c3a9a5ab2de60228aa5aceedc614c0281cf6153", size = 41257, upload-time = "2025-10-08T19:48:12.707Z" },
+    { url = "https://files.pythonhosted.org/packages/34/5e/63bd5896c3fec12edcbd6f12508d4890d23c265df28c74b175e1ef9f4f3b/propcache-0.4.1-cp314-cp314-win_arm64.whl", hash = "sha256:74c1fb26515153e482e00177a1ad654721bf9207da8a494a0c05e797ad27b992", size = 38097, upload-time = "2025-10-08T19:48:13.923Z" },
+    { url = "https://files.pythonhosted.org/packages/99/85/9ff785d787ccf9bbb3f3106f79884a130951436f58392000231b4c737c80/propcache-0.4.1-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:824e908bce90fb2743bd6b59db36eb4f45cd350a39637c9f73b1c1ea66f5b75f", size = 81455, upload-time = "2025-10-08T19:48:15.16Z" },
+    { url = "https://files.pythonhosted.org/packages/90/85/2431c10c8e7ddb1445c1f7c4b54d886e8ad20e3c6307e7218f05922cad67/propcache-0.4.1-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:c2b5e7db5328427c57c8e8831abda175421b709672f6cfc3d630c3b7e2146393", size = 46372, upload-time = "2025-10-08T19:48:16.424Z" },
+    { url = "https://files.pythonhosted.org/packages/01/20/b0972d902472da9bcb683fa595099911f4d2e86e5683bcc45de60dd05dc3/propcache-0.4.1-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:6f6ff873ed40292cd4969ef5310179afd5db59fdf055897e282485043fc80ad0", size = 48411, upload-time = "2025-10-08T19:48:17.577Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/e3/7dc89f4f21e8f99bad3d5ddb3a3389afcf9da4ac69e3deb2dcdc96e74169/propcache-0.4.1-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:49a2dc67c154db2c1463013594c458881a069fcf98940e61a0569016a583020a", size = 275712, upload-time = "2025-10-08T19:48:18.901Z" },
+    { url = "https://files.pythonhosted.org/packages/20/67/89800c8352489b21a8047c773067644e3897f02ecbbd610f4d46b7f08612/propcache-0.4.1-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:005f08e6a0529984491e37d8dbc3dd86f84bd78a8ceb5fa9a021f4c48d4984be", size = 273557, upload-time = "2025-10-08T19:48:20.762Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/a1/b52b055c766a54ce6d9c16d9aca0cad8059acd9637cdf8aa0222f4a026ef/propcache-0.4.1-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:5c3310452e0d31390da9035c348633b43d7e7feb2e37be252be6da45abd1abcc", size = 280015, upload-time = "2025-10-08T19:48:22.592Z" },
+    { url = "https://files.pythonhosted.org/packages/48/c8/33cee30bd890672c63743049f3c9e4be087e6780906bfc3ec58528be59c1/propcache-0.4.1-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:4c3c70630930447f9ef1caac7728c8ad1c56bc5015338b20fed0d08ea2480b3a", size = 262880, upload-time = "2025-10-08T19:48:23.947Z" },
+    { url = "https://files.pythonhosted.org/packages/0c/b1/8f08a143b204b418285c88b83d00edbd61afbc2c6415ffafc8905da7038b/propcache-0.4.1-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:8e57061305815dfc910a3634dcf584f08168a8836e6999983569f51a8544cd89", size = 260938, upload-time = "2025-10-08T19:48:25.656Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/12/96e4664c82ca2f31e1c8dff86afb867348979eb78d3cb8546a680287a1e9/propcache-0.4.1-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:521a463429ef54143092c11a77e04056dd00636f72e8c45b70aaa3140d639726", size = 247641, upload-time = "2025-10-08T19:48:27.207Z" },
+    { url = "https://files.pythonhosted.org/packages/18/ed/e7a9cfca28133386ba52278136d42209d3125db08d0a6395f0cba0c0285c/propcache-0.4.1-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:120c964da3fdc75e3731aa392527136d4ad35868cc556fd09bb6d09172d9a367", size = 262510, upload-time = "2025-10-08T19:48:28.65Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/76/16d8bf65e8845dd62b4e2b57444ab81f07f40caa5652b8969b87ddcf2ef6/propcache-0.4.1-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:d8f353eb14ee3441ee844ade4277d560cdd68288838673273b978e3d6d2c8f36", size = 263161, upload-time = "2025-10-08T19:48:30.133Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/70/c99e9edb5d91d5ad8a49fa3c1e8285ba64f1476782fed10ab251ff413ba1/propcache-0.4.1-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:ab2943be7c652f09638800905ee1bab2c544e537edb57d527997a24c13dc1455", size = 257393, upload-time = "2025-10-08T19:48:31.567Z" },
+    { url = "https://files.pythonhosted.org/packages/08/02/87b25304249a35c0915d236575bc3574a323f60b47939a2262b77632a3ee/propcache-0.4.1-cp314-cp314t-win32.whl", hash = "sha256:05674a162469f31358c30bcaa8883cb7829fa3110bf9c0991fe27d7896c42d85", size = 42546, upload-time = "2025-10-08T19:48:32.872Z" },
+    { url = "https://files.pythonhosted.org/packages/cb/ef/3c6ecf8b317aa982f309835e8f96987466123c6e596646d4e6a1dfcd080f/propcache-0.4.1-cp314-cp314t-win_amd64.whl", hash = "sha256:990f6b3e2a27d683cb7602ed6c86f15ee6b43b1194736f9baaeb93d0016633b1", size = 46259, upload-time = "2025-10-08T19:48:34.226Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/2d/346e946d4951f37eca1e4f55be0f0174c52cd70720f84029b02f296f4a38/propcache-0.4.1-cp314-cp314t-win_arm64.whl", hash = "sha256:ecef2343af4cc68e05131e45024ba34f6095821988a9d0a02aa7c73fcc448aa9", size = 40428, upload-time = "2025-10-08T19:48:35.441Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/5a/bc7b4a4ef808fa59a816c17b20c4bef6884daebbdf627ff2a161da67da19/propcache-0.4.1-py3-none-any.whl", hash = "sha256:af2a6052aeb6cf17d3e46ee169099044fd8224cbaf75c76a2ef596e8163e2237", size = 13305, upload-time = "2025-10-08T19:49:00.792Z" },
+]
+
+[[package]]
+name = "pydantic"
+version = "2.12.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "pydantic-core" },
+    { name = "typing-extensions" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/69/44/36f1a6e523abc58ae5f928898e4aca2e0ea509b5aa6f6f392a5d882be928/pydantic-2.12.5.tar.gz", hash = "sha256:4d351024c75c0f085a9febbb665ce8c0c6ec5d30e903bdb6394b7ede26aebb49", size = 821591, upload-time = "2025-11-26T15:11:46.471Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5a/87/b70ad306ebb6f9b585f114d0ac2137d792b48be34d732d60e597c2f8465a/pydantic-2.12.5-py3-none-any.whl", hash = "sha256:e561593fccf61e8a20fc46dfc2dfe075b8be7d0188df33f221ad1f0139180f9d", size = 463580, upload-time = "2025-11-26T15:11:44.605Z" },
+]
+
+[[package]]
+name = "pydantic-core"
+version = "2.41.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/71/70/23b021c950c2addd24ec408e9ab05d59b035b39d97cdc1130e1bce647bb6/pydantic_core-2.41.5.tar.gz", hash = "sha256:08daa51ea16ad373ffd5e7606252cc32f07bc72b28284b6bc9c6df804816476e", size = 460952, upload-time = "2025-11-04T13:43:49.098Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/5f/5d/5f6c63eebb5afee93bcaae4ce9a898f3373ca23df3ccaef086d0233a35a7/pydantic_core-2.41.5-cp312-cp312-macosx_10_12_x86_64.whl", hash = "sha256:f41a7489d32336dbf2199c8c0a215390a751c5b014c2c1c5366e817202e9cdf7", size = 2110990, upload-time = "2025-11-04T13:39:58.079Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/32/9c2e8ccb57c01111e0fd091f236c7b371c1bccea0fa85247ac55b1e2b6b6/pydantic_core-2.41.5-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:070259a8818988b9a84a449a2a7337c7f430a22acc0859c6b110aa7212a6d9c0", size = 1896003, upload-time = "2025-11-04T13:39:59.956Z" },
+    { url = "https://files.pythonhosted.org/packages/68/b8/a01b53cb0e59139fbc9e4fda3e9724ede8de279097179be4ff31f1abb65a/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:e96cea19e34778f8d59fe40775a7a574d95816eb150850a85a7a4c8f4b94ac69", size = 1919200, upload-time = "2025-11-04T13:40:02.241Z" },
+    { url = "https://files.pythonhosted.org/packages/38/de/8c36b5198a29bdaade07b5985e80a233a5ac27137846f3bc2d3b40a47360/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:ed2e99c456e3fadd05c991f8f437ef902e00eedf34320ba2b0842bd1c3ca3a75", size = 2052578, upload-time = "2025-11-04T13:40:04.401Z" },
+    { url = "https://files.pythonhosted.org/packages/00/b5/0e8e4b5b081eac6cb3dbb7e60a65907549a1ce035a724368c330112adfdd/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:65840751b72fbfd82c3c640cff9284545342a4f1eb1586ad0636955b261b0b05", size = 2208504, upload-time = "2025-11-04T13:40:06.072Z" },
+    { url = "https://files.pythonhosted.org/packages/77/56/87a61aad59c7c5b9dc8caad5a41a5545cba3810c3e828708b3d7404f6cef/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:e536c98a7626a98feb2d3eaf75944ef6f3dbee447e1f841eae16f2f0a72d8ddc", size = 2335816, upload-time = "2025-11-04T13:40:07.835Z" },
+    { url = "https://files.pythonhosted.org/packages/0d/76/941cc9f73529988688a665a5c0ecff1112b3d95ab48f81db5f7606f522d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:eceb81a8d74f9267ef4081e246ffd6d129da5d87e37a77c9bde550cb04870c1c", size = 2075366, upload-time = "2025-11-04T13:40:09.804Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/43/ebef01f69baa07a482844faaa0a591bad1ef129253ffd0cdaa9d8a7f72d3/pydantic_core-2.41.5-cp312-cp312-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d38548150c39b74aeeb0ce8ee1d8e82696f4a4e16ddc6de7b1d8823f7de4b9b5", size = 2171698, upload-time = "2025-11-04T13:40:12.004Z" },
+    { url = "https://files.pythonhosted.org/packages/b1/87/41f3202e4193e3bacfc2c065fab7706ebe81af46a83d3e27605029c1f5a6/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_aarch64.whl", hash = "sha256:c23e27686783f60290e36827f9c626e63154b82b116d7fe9adba1fda36da706c", size = 2132603, upload-time = "2025-11-04T13:40:13.868Z" },
+    { url = "https://files.pythonhosted.org/packages/49/7d/4c00df99cb12070b6bccdef4a195255e6020a550d572768d92cc54dba91a/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_armv7l.whl", hash = "sha256:482c982f814460eabe1d3bb0adfdc583387bd4691ef00b90575ca0d2b6fe2294", size = 2329591, upload-time = "2025-11-04T13:40:15.672Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/6a/ebf4b1d65d458f3cda6a7335d141305dfa19bdc61140a884d165a8a1bbc7/pydantic_core-2.41.5-cp312-cp312-musllinux_1_1_x86_64.whl", hash = "sha256:bfea2a5f0b4d8d43adf9d7b8bf019fb46fdd10a2e5cde477fbcb9d1fa08c68e1", size = 2319068, upload-time = "2025-11-04T13:40:17.532Z" },
+    { url = "https://files.pythonhosted.org/packages/49/3b/774f2b5cd4192d5ab75870ce4381fd89cf218af999515baf07e7206753f0/pydantic_core-2.41.5-cp312-cp312-win32.whl", hash = "sha256:b74557b16e390ec12dca509bce9264c3bbd128f8a2c376eaa68003d7f327276d", size = 1985908, upload-time = "2025-11-04T13:40:19.309Z" },
+    { url = "https://files.pythonhosted.org/packages/86/45/00173a033c801cacf67c190fef088789394feaf88a98a7035b0e40d53dc9/pydantic_core-2.41.5-cp312-cp312-win_amd64.whl", hash = "sha256:1962293292865bca8e54702b08a4f26da73adc83dd1fcf26fbc875b35d81c815", size = 2020145, upload-time = "2025-11-04T13:40:21.548Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/22/91fbc821fa6d261b376a3f73809f907cec5ca6025642c463d3488aad22fb/pydantic_core-2.41.5-cp312-cp312-win_arm64.whl", hash = "sha256:1746d4a3d9a794cacae06a5eaaccb4b8643a131d45fbc9af23e353dc0a5ba5c3", size = 1976179, upload-time = "2025-11-04T13:40:23.393Z" },
+    { url = "https://files.pythonhosted.org/packages/87/06/8806241ff1f70d9939f9af039c6c35f2360cf16e93c2ca76f184e76b1564/pydantic_core-2.41.5-cp313-cp313-macosx_10_12_x86_64.whl", hash = "sha256:941103c9be18ac8daf7b7adca8228f8ed6bb7a1849020f643b3a14d15b1924d9", size = 2120403, upload-time = "2025-11-04T13:40:25.248Z" },
+    { url = "https://files.pythonhosted.org/packages/94/02/abfa0e0bda67faa65fef1c84971c7e45928e108fe24333c81f3bfe35d5f5/pydantic_core-2.41.5-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:112e305c3314f40c93998e567879e887a3160bb8689ef3d2c04b6cc62c33ac34", size = 1896206, upload-time = "2025-11-04T13:40:27.099Z" },
+    { url = "https://files.pythonhosted.org/packages/15/df/a4c740c0943e93e6500f9eb23f4ca7ec9bf71b19e608ae5b579678c8d02f/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:0cbaad15cb0c90aa221d43c00e77bb33c93e8d36e0bf74760cd00e732d10a6a0", size = 1919307, upload-time = "2025-11-04T13:40:29.806Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/e3/6324802931ae1d123528988e0e86587c2072ac2e5394b4bc2bc34b61ff6e/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:03ca43e12fab6023fc79d28ca6b39b05f794ad08ec2feccc59a339b02f2b3d33", size = 2063258, upload-time = "2025-11-04T13:40:33.544Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/d4/2230d7151d4957dd79c3044ea26346c148c98fbf0ee6ebd41056f2d62ab5/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:dc799088c08fa04e43144b164feb0c13f9a0bc40503f8df3e9fde58a3c0c101e", size = 2214917, upload-time = "2025-11-04T13:40:35.479Z" },
+    { url = "https://files.pythonhosted.org/packages/e6/9f/eaac5df17a3672fef0081b6c1bb0b82b33ee89aa5cec0d7b05f52fd4a1fa/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:97aeba56665b4c3235a0e52b2c2f5ae9cd071b8a8310ad27bddb3f7fb30e9aa2", size = 2332186, upload-time = "2025-11-04T13:40:37.436Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/4e/35a80cae583a37cf15604b44240e45c05e04e86f9cfd766623149297e971/pydantic_core-2.41.5-cp313-cp313-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:406bf18d345822d6c21366031003612b9c77b3e29ffdb0f612367352aab7d586", size = 2073164, upload-time = "2025-11-04T13:40:40.289Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/e3/f6e262673c6140dd3305d144d032f7bd5f7497d3871c1428521f19f9efa2/pydantic_core-2.41.5-cp313-cp313-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:b93590ae81f7010dbe380cdeab6f515902ebcbefe0b9327cc4804d74e93ae69d", size = 2179146, upload-time = "2025-11-04T13:40:42.809Z" },
+    { url = "https://files.pythonhosted.org/packages/75/c7/20bd7fc05f0c6ea2056a4565c6f36f8968c0924f19b7d97bbfea55780e73/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_aarch64.whl", hash = "sha256:01a3d0ab748ee531f4ea6c3e48ad9dac84ddba4b0d82291f87248f2f9de8d740", size = 2137788, upload-time = "2025-11-04T13:40:44.752Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/8d/34318ef985c45196e004bc46c6eab2eda437e744c124ef0dbe1ff2c9d06b/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_armv7l.whl", hash = "sha256:6561e94ba9dacc9c61bce40e2d6bdc3bfaa0259d3ff36ace3b1e6901936d2e3e", size = 2340133, upload-time = "2025-11-04T13:40:46.66Z" },
+    { url = "https://files.pythonhosted.org/packages/9c/59/013626bf8c78a5a5d9350d12e7697d3d4de951a75565496abd40ccd46bee/pydantic_core-2.41.5-cp313-cp313-musllinux_1_1_x86_64.whl", hash = "sha256:915c3d10f81bec3a74fbd4faebe8391013ba61e5a1a8d48c4455b923bdda7858", size = 2324852, upload-time = "2025-11-04T13:40:48.575Z" },
+    { url = "https://files.pythonhosted.org/packages/1a/d9/c248c103856f807ef70c18a4f986693a46a8ffe1602e5d361485da502d20/pydantic_core-2.41.5-cp313-cp313-win32.whl", hash = "sha256:650ae77860b45cfa6e2cdafc42618ceafab3a2d9a3811fcfbd3bbf8ac3c40d36", size = 1994679, upload-time = "2025-11-04T13:40:50.619Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/8b/341991b158ddab181cff136acd2552c9f35bd30380422a639c0671e99a91/pydantic_core-2.41.5-cp313-cp313-win_amd64.whl", hash = "sha256:79ec52ec461e99e13791ec6508c722742ad745571f234ea6255bed38c6480f11", size = 2019766, upload-time = "2025-11-04T13:40:52.631Z" },
+    { url = "https://files.pythonhosted.org/packages/73/7d/f2f9db34af103bea3e09735bb40b021788a5e834c81eedb541991badf8f5/pydantic_core-2.41.5-cp313-cp313-win_arm64.whl", hash = "sha256:3f84d5c1b4ab906093bdc1ff10484838aca54ef08de4afa9de0f5f14d69639cd", size = 1981005, upload-time = "2025-11-04T13:40:54.734Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/28/46b7c5c9635ae96ea0fbb779e271a38129df2550f763937659ee6c5dbc65/pydantic_core-2.41.5-cp314-cp314-macosx_10_12_x86_64.whl", hash = "sha256:3f37a19d7ebcdd20b96485056ba9e8b304e27d9904d233d7b1015db320e51f0a", size = 2119622, upload-time = "2025-11-04T13:40:56.68Z" },
+    { url = "https://files.pythonhosted.org/packages/74/1a/145646e5687e8d9a1e8d09acb278c8535ebe9e972e1f162ed338a622f193/pydantic_core-2.41.5-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:1d1d9764366c73f996edd17abb6d9d7649a7eb690006ab6adbda117717099b14", size = 1891725, upload-time = "2025-11-04T13:40:58.807Z" },
+    { url = "https://files.pythonhosted.org/packages/23/04/e89c29e267b8060b40dca97bfc64a19b2a3cf99018167ea1677d96368273/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:25e1c2af0fce638d5f1988b686f3b3ea8cd7de5f244ca147c777769e798a9cd1", size = 1915040, upload-time = "2025-11-04T13:41:00.853Z" },
+    { url = "https://files.pythonhosted.org/packages/84/a3/15a82ac7bd97992a82257f777b3583d3e84bdb06ba6858f745daa2ec8a85/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:506d766a8727beef16b7adaeb8ee6217c64fc813646b424d0804d67c16eddb66", size = 2063691, upload-time = "2025-11-04T13:41:03.504Z" },
+    { url = "https://files.pythonhosted.org/packages/74/9b/0046701313c6ef08c0c1cf0e028c67c770a4e1275ca73131563c5f2a310a/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:4819fa52133c9aa3c387b3328f25c1facc356491e6135b459f1de698ff64d869", size = 2213897, upload-time = "2025-11-04T13:41:05.804Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/cd/6bac76ecd1b27e75a95ca3a9a559c643b3afcd2dd62086d4b7a32a18b169/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:2b761d210c9ea91feda40d25b4efe82a1707da2ef62901466a42492c028553a2", size = 2333302, upload-time = "2025-11-04T13:41:07.809Z" },
+    { url = "https://files.pythonhosted.org/packages/4c/d2/ef2074dc020dd6e109611a8be4449b98cd25e1b9b8a303c2f0fca2f2bcf7/pydantic_core-2.41.5-cp314-cp314-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:22f0fb8c1c583a3b6f24df2470833b40207e907b90c928cc8d3594b76f874375", size = 2064877, upload-time = "2025-11-04T13:41:09.827Z" },
+    { url = "https://files.pythonhosted.org/packages/18/66/e9db17a9a763d72f03de903883c057b2592c09509ccfe468187f2a2eef29/pydantic_core-2.41.5-cp314-cp314-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:2782c870e99878c634505236d81e5443092fba820f0373997ff75f90f68cd553", size = 2180680, upload-time = "2025-11-04T13:41:12.379Z" },
+    { url = "https://files.pythonhosted.org/packages/d3/9e/3ce66cebb929f3ced22be85d4c2399b8e85b622db77dad36b73c5387f8f8/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_aarch64.whl", hash = "sha256:0177272f88ab8312479336e1d777f6b124537d47f2123f89cb37e0accea97f90", size = 2138960, upload-time = "2025-11-04T13:41:14.627Z" },
+    { url = "https://files.pythonhosted.org/packages/a6/62/205a998f4327d2079326b01abee48e502ea739d174f0a89295c481a2272e/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_armv7l.whl", hash = "sha256:63510af5e38f8955b8ee5687740d6ebf7c2a0886d15a6d65c32814613681bc07", size = 2339102, upload-time = "2025-11-04T13:41:16.868Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/0d/f05e79471e889d74d3d88f5bd20d0ed189ad94c2423d81ff8d0000aab4ff/pydantic_core-2.41.5-cp314-cp314-musllinux_1_1_x86_64.whl", hash = "sha256:e56ba91f47764cc14f1daacd723e3e82d1a89d783f0f5afe9c364b8bb491ccdb", size = 2326039, upload-time = "2025-11-04T13:41:18.934Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/e1/e08a6208bb100da7e0c4b288eed624a703f4d129bde2da475721a80cab32/pydantic_core-2.41.5-cp314-cp314-win32.whl", hash = "sha256:aec5cf2fd867b4ff45b9959f8b20ea3993fc93e63c7363fe6851424c8a7e7c23", size = 1995126, upload-time = "2025-11-04T13:41:21.418Z" },
+    { url = "https://files.pythonhosted.org/packages/48/5d/56ba7b24e9557f99c9237e29f5c09913c81eeb2f3217e40e922353668092/pydantic_core-2.41.5-cp314-cp314-win_amd64.whl", hash = "sha256:8e7c86f27c585ef37c35e56a96363ab8de4e549a95512445b85c96d3e2f7c1bf", size = 2015489, upload-time = "2025-11-04T13:41:24.076Z" },
+    { url = "https://files.pythonhosted.org/packages/4e/bb/f7a190991ec9e3e0ba22e4993d8755bbc4a32925c0b5b42775c03e8148f9/pydantic_core-2.41.5-cp314-cp314-win_arm64.whl", hash = "sha256:e672ba74fbc2dc8eea59fb6d4aed6845e6905fc2a8afe93175d94a83ba2a01a0", size = 1977288, upload-time = "2025-11-04T13:41:26.33Z" },
+    { url = "https://files.pythonhosted.org/packages/92/ed/77542d0c51538e32e15afe7899d79efce4b81eee631d99850edc2f5e9349/pydantic_core-2.41.5-cp314-cp314t-macosx_10_12_x86_64.whl", hash = "sha256:8566def80554c3faa0e65ac30ab0932b9e3a5cd7f8323764303d468e5c37595a", size = 2120255, upload-time = "2025-11-04T13:41:28.569Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/3d/6913dde84d5be21e284439676168b28d8bbba5600d838b9dca99de0fad71/pydantic_core-2.41.5-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:b80aa5095cd3109962a298ce14110ae16b8c1aece8b72f9dafe81cf597ad80b3", size = 1863760, upload-time = "2025-11-04T13:41:31.055Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/f0/e5e6b99d4191da102f2b0eb9687aaa7f5bea5d9964071a84effc3e40f997/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:3006c3dd9ba34b0c094c544c6006cc79e87d8612999f1a5d43b769b89181f23c", size = 1878092, upload-time = "2025-11-04T13:41:33.21Z" },
+    { url = "https://files.pythonhosted.org/packages/71/48/36fb760642d568925953bcc8116455513d6e34c4beaa37544118c36aba6d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:72f6c8b11857a856bcfa48c86f5368439f74453563f951e473514579d44aa612", size = 2053385, upload-time = "2025-11-04T13:41:35.508Z" },
+    { url = "https://files.pythonhosted.org/packages/20/25/92dc684dd8eb75a234bc1c764b4210cf2646479d54b47bf46061657292a8/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:5cb1b2f9742240e4bb26b652a5aeb840aa4b417c7748b6f8387927bc6e45e40d", size = 2218832, upload-time = "2025-11-04T13:41:37.732Z" },
+    { url = "https://files.pythonhosted.org/packages/e2/09/f53e0b05023d3e30357d82eb35835d0f6340ca344720a4599cd663dca599/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:bd3d54f38609ff308209bd43acea66061494157703364ae40c951f83ba99a1a9", size = 2327585, upload-time = "2025-11-04T13:41:40Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/4e/2ae1aa85d6af35a39b236b1b1641de73f5a6ac4d5a7509f77b814885760c/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:2ff4321e56e879ee8d2a879501c8e469414d948f4aba74a2d4593184eb326660", size = 2041078, upload-time = "2025-11-04T13:41:42.323Z" },
+    { url = "https://files.pythonhosted.org/packages/cd/13/2e215f17f0ef326fc72afe94776edb77525142c693767fc347ed6288728d/pydantic_core-2.41.5-cp314-cp314t-manylinux_2_5_i686.manylinux1_i686.whl", hash = "sha256:d0d2568a8c11bf8225044aa94409e21da0cb09dcdafe9ecd10250b2baad531a9", size = 2173914, upload-time = "2025-11-04T13:41:45.221Z" },
+    { url = "https://files.pythonhosted.org/packages/02/7a/f999a6dcbcd0e5660bc348a3991c8915ce6599f4f2c6ac22f01d7a10816c/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_aarch64.whl", hash = "sha256:a39455728aabd58ceabb03c90e12f71fd30fa69615760a075b9fec596456ccc3", size = 2129560, upload-time = "2025-11-04T13:41:47.474Z" },
+    { url = "https://files.pythonhosted.org/packages/3a/b1/6c990ac65e3b4c079a4fb9f5b05f5b013afa0f4ed6780a3dd236d2cbdc64/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_armv7l.whl", hash = "sha256:239edca560d05757817c13dc17c50766136d21f7cd0fac50295499ae24f90fdf", size = 2329244, upload-time = "2025-11-04T13:41:49.992Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/02/3c562f3a51afd4d88fff8dffb1771b30cfdfd79befd9883ee094f5b6c0d8/pydantic_core-2.41.5-cp314-cp314t-musllinux_1_1_x86_64.whl", hash = "sha256:2a5e06546e19f24c6a96a129142a75cee553cc018ffee48a460059b1185f4470", size = 2331955, upload-time = "2025-11-04T13:41:54.079Z" },
+    { url = "https://files.pythonhosted.org/packages/5c/96/5fb7d8c3c17bc8c62fdb031c47d77a1af698f1d7a406b0f79aaa1338f9ad/pydantic_core-2.41.5-cp314-cp314t-win32.whl", hash = "sha256:b4ececa40ac28afa90871c2cc2b9ffd2ff0bf749380fbdf57d165fd23da353aa", size = 1988906, upload-time = "2025-11-04T13:41:56.606Z" },
+    { url = "https://files.pythonhosted.org/packages/22/ed/182129d83032702912c2e2d8bbe33c036f342cc735737064668585dac28f/pydantic_core-2.41.5-cp314-cp314t-win_amd64.whl", hash = "sha256:80aa89cad80b32a912a65332f64a4450ed00966111b6615ca6816153d3585a8c", size = 1981607, upload-time = "2025-11-04T13:41:58.889Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/ed/068e41660b832bb0b1aa5b58011dea2a3fe0ba7861ff38c4d4904c1c1a99/pydantic_core-2.41.5-cp314-cp314t-win_arm64.whl", hash = "sha256:35b44f37a3199f771c3eaa53051bc8a70cd7b54f333531c59e29fd4db5d15008", size = 1974769, upload-time = "2025-11-04T13:42:01.186Z" },
+    { url = "https://files.pythonhosted.org/packages/09/32/59b0c7e63e277fa7911c2fc70ccfb45ce4b98991e7ef37110663437005af/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_10_12_x86_64.whl", hash = "sha256:7da7087d756b19037bc2c06edc6c170eeef3c3bafcb8f532ff17d64dc427adfd", size = 2110495, upload-time = "2025-11-04T13:42:49.689Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/81/05e400037eaf55ad400bcd318c05bb345b57e708887f07ddb2d20e3f0e98/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-macosx_11_0_arm64.whl", hash = "sha256:aabf5777b5c8ca26f7824cb4a120a740c9588ed58df9b2d196ce92fba42ff8dc", size = 1915388, upload-time = "2025-11-04T13:42:52.215Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/0d/e3549b2399f71d56476b77dbf3cf8937cec5cd70536bdc0e374a421d0599/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:c007fe8a43d43b3969e8469004e9845944f1a80e6acd47c150856bb87f230c56", size = 1942879, upload-time = "2025-11-04T13:42:56.483Z" },
+    { url = "https://files.pythonhosted.org/packages/f7/07/34573da085946b6a313d7c42f82f16e8920bfd730665de2d11c0c37a74b5/pydantic_core-2.41.5-graalpy312-graalpy250_312_native-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:76d0819de158cd855d1cbb8fcafdf6f5cf1eb8e470abe056d5d161106e38062b", size = 2139017, upload-time = "2025-11-04T13:42:59.471Z" },
+]
+
+[[package]]
+name = "pydantic-settings"
+version = "2.12.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pydantic" },
+    { name = "python-dotenv" },
+    { name = "typing-inspection" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/43/4b/ac7e0aae12027748076d72a8764ff1c9d82ca75a7a52622e67ed3f765c54/pydantic_settings-2.12.0.tar.gz", hash = "sha256:005538ef951e3c2a68e1c08b292b5f2e71490def8589d4221b95dab00dafcfd0", size = 194184, upload-time = "2025-11-10T14:25:47.013Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c1/60/5d4751ba3f4a40a6891f24eec885f51afd78d208498268c734e256fb13c4/pydantic_settings-2.12.0-py3-none-any.whl", hash = "sha256:fddb9fd99a5b18da837b29710391e945b1e30c135477f484084ee513adb93809", size = 51880, upload-time = "2025-11-10T14:25:45.546Z" },
+]
+
+[[package]]
+name = "pygments"
+version = "2.19.2"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/b0/77/a5b8c569bf593b0140bde72ea885a803b82086995367bf2037de0159d924/pygments-2.19.2.tar.gz", hash = "sha256:636cb2477cec7f8952536970bc533bc43743542f70392ae026374600add5b887", size = 4968631, upload-time = "2025-06-21T13:39:12.283Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/c7/21/705964c7812476f378728bdf590ca4b771ec72385c533964653c68e86bdc/pygments-2.19.2-py3-none-any.whl", hash = "sha256:86540386c03d588bb81d44bc3928634ff26449851e99741617ecb9037ee5ec0b", size = 1225217, upload-time = "2025-06-21T13:39:07.939Z" },
+]
+
+[[package]]
+name = "pytest"
+version = "9.0.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "colorama", marker = "sys_platform == 'win32'" },
+    { name = "iniconfig" },
+    { name = "packaging" },
+    { name = "pluggy" },
+    { name = "pygments" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/d1/db/7ef3487e0fb0049ddb5ce41d3a49c235bf9ad299b6a25d5780a89f19230f/pytest-9.0.2.tar.gz", hash = "sha256:75186651a92bd89611d1d9fc20f0b4345fd827c41ccd5c299a868a05d70edf11", size = 1568901, upload-time = "2025-12-06T21:30:51.014Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/3b/ab/b3226f0bd7cdcf710fbede2b3548584366da3b19b5021e74f5bde2a8fa3f/pytest-9.0.2-py3-none-any.whl", hash = "sha256:711ffd45bf766d5264d487b917733b453d917afd2b0ad65223959f59089f875b", size = 374801, upload-time = "2025-12-06T21:30:49.154Z" },
+]
+
+[[package]]
+name = "pytest-asyncio"
+version = "1.3.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "pytest" },
+    { name = "typing-extensions", marker = "python_full_version < '3.13'" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/90/2c/8af215c0f776415f3590cac4f9086ccefd6fd463befeae41cd4d3f193e5a/pytest_asyncio-1.3.0.tar.gz", hash = "sha256:d7f52f36d231b80ee124cd216ffb19369aa168fc10095013c6b014a34d3ee9e5", size = 50087, upload-time = "2025-11-10T16:07:47.256Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/e5/35/f8b19922b6a25bc0880171a2f1a003eaeb93657475193ab516fd87cac9da/pytest_asyncio-1.3.0-py3-none-any.whl", hash = "sha256:611e26147c7f77640e6d0a92a38ed17c3e9848063698d5c93d5aa7aa11cebff5", size = 15075, upload-time = "2025-11-10T16:07:45.537Z" },
+]
+
+[[package]]
+name = "python-dotenv"
+version = "1.2.1"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/f0/26/19cadc79a718c5edbec86fd4919a6b6d3f681039a2f6d66d14be94e75fb9/python_dotenv-1.2.1.tar.gz", hash = "sha256:42667e897e16ab0d66954af0e60a9caa94f0fd4ecf3aaf6d2d260eec1aa36ad6", size = 44221, upload-time = "2025-10-26T15:12:10.434Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/14/1b/a298b06749107c305e1fe0f814c6c74aea7b2f1e10989cb30f544a1b3253/python_dotenv-1.2.1-py3-none-any.whl", hash = "sha256:b81ee9561e9ca4004139c6cbba3a238c32b03e4894671e181b671e8cb8425d61", size = 21230, upload-time = "2025-10-26T15:12:09.109Z" },
+]
+
+[[package]]
+name = "requests"
+version = "2.32.5"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "certifi" },
+    { name = "charset-normalizer" },
+    { name = "idna" },
+    { name = "urllib3" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/c9/74/b3ff8e6c8446842c3f5c837e9c3dfcfe2018ea6ecef224c710c85ef728f4/requests-2.32.5.tar.gz", hash = "sha256:dbba0bac56e100853db0ea71b82b4dfd5fe2bf6d3754a8893c3af500cec7d7cf", size = 134517, upload-time = "2025-08-18T20:46:02.573Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/1e/db/4254e3eabe8020b458f1a747140d32277ec7a271daf1d235b70dc0b4e6e3/requests-2.32.5-py3-none-any.whl", hash = "sha256:2462f94637a34fd532264295e186976db0f5d453d1cdd31473c85a6a161affb6", size = 64738, upload-time = "2025-08-18T20:46:00.542Z" },
+]
+
+[[package]]
+name = "ruff"
+version = "0.14.14"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/2e/06/f71e3a86b2df0dfa2d2f72195941cd09b44f87711cb7fa5193732cb9a5fc/ruff-0.14.14.tar.gz", hash = "sha256:2d0f819c9a90205f3a867dbbd0be083bee9912e170fd7d9704cc8ae45824896b", size = 4515732, upload-time = "2026-01-22T22:30:17.527Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/d2/89/20a12e97bc6b9f9f68343952da08a8099c57237aef953a56b82711d55edd/ruff-0.14.14-py3-none-linux_armv6l.whl", hash = "sha256:7cfe36b56e8489dee8fbc777c61959f60ec0f1f11817e8f2415f429552846aed", size = 10467650, upload-time = "2026-01-22T22:30:08.578Z" },
+    { url = "https://files.pythonhosted.org/packages/a3/b1/c5de3fd2d5a831fcae21beda5e3589c0ba67eec8202e992388e4b17a6040/ruff-0.14.14-py3-none-macosx_10_12_x86_64.whl", hash = "sha256:6006a0082336e7920b9573ef8a7f52eec837add1265cc74e04ea8a4368cd704c", size = 10883245, upload-time = "2026-01-22T22:30:04.155Z" },
+    { url = "https://files.pythonhosted.org/packages/b8/7c/3c1db59a10e7490f8f6f8559d1db8636cbb13dccebf18686f4e3c9d7c772/ruff-0.14.14-py3-none-macosx_11_0_arm64.whl", hash = "sha256:026c1d25996818f0bf498636686199d9bd0d9d6341c9c2c3b62e2a0198b758de", size = 10231273, upload-time = "2026-01-22T22:30:34.642Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/6e/5e0e0d9674be0f8581d1f5e0f0a04761203affce3232c1a1189d0e3b4dad/ruff-0.14.14-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl", hash = "sha256:f666445819d31210b71e0a6d1c01e24447a20b85458eea25a25fe8142210ae0e", size = 10585753, upload-time = "2026-01-22T22:30:31.781Z" },
+    { url = "https://files.pythonhosted.org/packages/23/09/754ab09f46ff1884d422dc26d59ba18b4e5d355be147721bb2518aa2a014/ruff-0.14.14-py3-none-manylinux_2_17_armv7l.manylinux2014_armv7l.whl", hash = "sha256:3c0f18b922c6d2ff9a5e6c3ee16259adc513ca775bcf82c67ebab7cbd9da5bc8", size = 10286052, upload-time = "2026-01-22T22:30:24.827Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/cc/e71f88dd2a12afb5f50733851729d6b571a7c3a35bfdb16c3035132675a0/ruff-0.14.14-py3-none-manylinux_2_17_i686.manylinux2014_i686.whl", hash = "sha256:1629e67489c2dea43e8658c3dba659edbfd87361624b4040d1df04c9740ae906", size = 11043637, upload-time = "2026-01-22T22:30:13.239Z" },
+    { url = "https://files.pythonhosted.org/packages/67/b2/397245026352494497dac935d7f00f1468c03a23a0c5db6ad8fc49ca3fb2/ruff-0.14.14-py3-none-manylinux_2_17_ppc64.manylinux2014_ppc64.whl", hash = "sha256:27493a2131ea0f899057d49d303e4292b2cae2bb57253c1ed1f256fbcd1da480", size = 12194761, upload-time = "2026-01-22T22:30:22.542Z" },
+    { url = "https://files.pythonhosted.org/packages/5b/06/06ef271459f778323112c51b7587ce85230785cd64e91772034ddb88f200/ruff-0.14.14-py3-none-manylinux_2_17_ppc64le.manylinux2014_ppc64le.whl", hash = "sha256:01ff589aab3f5b539e35db38425da31a57521efd1e4ad1ae08fc34dbe30bd7df", size = 12005701, upload-time = "2026-01-22T22:30:20.499Z" },
+    { url = "https://files.pythonhosted.org/packages/41/d6/99364514541cf811ccc5ac44362f88df66373e9fec1b9d1c4cc830593fe7/ruff-0.14.14-py3-none-manylinux_2_17_s390x.manylinux2014_s390x.whl", hash = "sha256:1cc12d74eef0f29f51775f5b755913eb523546b88e2d733e1d701fe65144e89b", size = 11282455, upload-time = "2026-01-22T22:29:59.679Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/71/37daa46f89475f8582b7762ecd2722492df26421714a33e72ccc9a84d7a5/ruff-0.14.14-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl", hash = "sha256:bb8481604b7a9e75eff53772496201690ce2687067e038b3cc31aaf16aa0b974", size = 11215882, upload-time = "2026-01-22T22:29:57.032Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/10/a31f86169ec91c0705e618443ee74ede0bdd94da0a57b28e72db68b2dbac/ruff-0.14.14-py3-none-manylinux_2_31_riscv64.whl", hash = "sha256:14649acb1cf7b5d2d283ebd2f58d56b75836ed8c6f329664fa91cdea19e76e66", size = 11180549, upload-time = "2026-01-22T22:30:27.175Z" },
+    { url = "https://files.pythonhosted.org/packages/fd/1e/c723f20536b5163adf79bdd10c5f093414293cdf567eed9bdb7b83940f3f/ruff-0.14.14-py3-none-musllinux_1_2_aarch64.whl", hash = "sha256:e8058d2145566510790eab4e2fad186002e288dec5e0d343a92fe7b0bc1b3e13", size = 10543416, upload-time = "2026-01-22T22:30:01.964Z" },
+    { url = "https://files.pythonhosted.org/packages/3e/34/8a84cea7e42c2d94ba5bde1d7a4fae164d6318f13f933d92da6d7c2041ff/ruff-0.14.14-py3-none-musllinux_1_2_armv7l.whl", hash = "sha256:e651e977a79e4c758eb807f0481d673a67ffe53cfa92209781dfa3a996cf8412", size = 10285491, upload-time = "2026-01-22T22:30:29.51Z" },
+    { url = "https://files.pythonhosted.org/packages/55/ef/b7c5ea0be82518906c978e365e56a77f8de7678c8bb6651ccfbdc178c29f/ruff-0.14.14-py3-none-musllinux_1_2_i686.whl", hash = "sha256:cc8b22da8d9d6fdd844a68ae937e2a0adf9b16514e9a97cc60355e2d4b219fc3", size = 10733525, upload-time = "2026-01-22T22:30:06.499Z" },
+    { url = "https://files.pythonhosted.org/packages/6a/5b/aaf1dfbcc53a2811f6cc0a1759de24e4b03e02ba8762daabd9b6bd8c59e3/ruff-0.14.14-py3-none-musllinux_1_2_x86_64.whl", hash = "sha256:16bc890fb4cc9781bb05beb5ab4cd51be9e7cb376bf1dd3580512b24eb3fda2b", size = 11315626, upload-time = "2026-01-22T22:30:36.848Z" },
+    { url = "https://files.pythonhosted.org/packages/2c/aa/9f89c719c467dfaf8ad799b9bae0df494513fb21d31a6059cb5870e57e74/ruff-0.14.14-py3-none-win32.whl", hash = "sha256:b530c191970b143375b6a68e6f743800b2b786bbcf03a7965b06c4bf04568167", size = 10502442, upload-time = "2026-01-22T22:30:38.93Z" },
+    { url = "https://files.pythonhosted.org/packages/87/44/90fa543014c45560cae1fffc63ea059fb3575ee6e1cb654562197e5d16fb/ruff-0.14.14-py3-none-win_amd64.whl", hash = "sha256:3dde1435e6b6fe5b66506c1dff67a421d0b7f6488d466f651c07f4cab3bf20fd", size = 11630486, upload-time = "2026-01-22T22:30:10.852Z" },
+    { url = "https://files.pythonhosted.org/packages/9e/6a/40fee331a52339926a92e17ae748827270b288a35ef4a15c9c8f2ec54715/ruff-0.14.14-py3-none-win_arm64.whl", hash = "sha256:56e6981a98b13a32236a72a8da421d7839221fa308b223b9283312312e5ac76c", size = 10920448, upload-time = "2026-01-22T22:30:15.417Z" },
+]
+
+[[package]]
+name = "todoist-api-python"
+version = "3.2.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "annotated-types" },
+    { name = "dataclass-wizard" },
+    { name = "requests" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/bf/6e/1ff0e0e098f2196f6eda3f20ebe0653a978abee5345f5ed1dfd1a9b5bbdc/todoist_api_python-3.2.1.tar.gz", hash = "sha256:22c60230cc616437846f9a6469dddd97548545ef916d2bea98b2ca2f522d92f9", size = 20689, upload-time = "2026-01-22T17:07:13.254Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/2d/7c/6baa538db710f8d9cc4ed15f1f757ab9bc8564941d9c3291b9d7fcee7746/todoist_api_python-3.2.1-py3-none-any.whl", hash = "sha256:1091e9b557291380abd79245efe961b0f2261c7b4eb16e52beccfc6357320e95", size = 23541, upload-time = "2026-01-22T17:07:12.311Z" },
+]
+
+[[package]]
+name = "typing-extensions"
+version = "4.15.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/72/94/1a15dd82efb362ac84269196e94cf00f187f7ed21c242792a923cdb1c61f/typing_extensions-4.15.0.tar.gz", hash = "sha256:0cea48d173cc12fa28ecabc3b837ea3cf6f38c6d1136f85cbaaf598984861466", size = 109391, upload-time = "2025-08-25T13:49:26.313Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/18/67/36e9267722cc04a6b9f15c7f3441c2363321a3ea07da7ae0c0707beb2a9c/typing_extensions-4.15.0-py3-none-any.whl", hash = "sha256:f0fa19c6845758ab08074a0cfa8b7aecb71c999ca73d62883bc25cc018c4e548", size = 44614, upload-time = "2025-08-25T13:49:24.86Z" },
+]
+
+[[package]]
+name = "typing-inspection"
+version = "0.4.2"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "typing-extensions" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/55/e3/70399cb7dd41c10ac53367ae42139cf4b1ca5f36bb3dc6c9d33acdb43655/typing_inspection-0.4.2.tar.gz", hash = "sha256:ba561c48a67c5958007083d386c3295464928b01faa735ab8547c5692e87f464", size = 75949, upload-time = "2025-10-01T02:14:41.687Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/dc/9b/47798a6c91d8bdb567fe2698fe81e0c6b7cb7ef4d13da4114b41d239f65d/typing_inspection-0.4.2-py3-none-any.whl", hash = "sha256:4ed1cacbdc298c220f1bd249ed5287caa16f34d44ef4e9c3d0cbad5b521545e7", size = 14611, upload-time = "2025-10-01T02:14:40.154Z" },
+]
+
+[[package]]
+name = "urllib3"
+version = "2.6.3"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/c7/24/5f1b3bdffd70275f6661c76461e25f024d5a38a46f04aaca912426a2b1d3/urllib3-2.6.3.tar.gz", hash = "sha256:1b62b6884944a57dbe321509ab94fd4d3b307075e0c2eae991ac71ee15ad38ed", size = 435556, upload-time = "2026-01-07T16:24:43.925Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/39/08/aaaad47bc4e9dc8c725e68f9d04865dbcb2052843ff09c97b08904852d84/urllib3-2.6.3-py3-none-any.whl", hash = "sha256:bf272323e553dfb2e87d9bfd225ca7b0f467b919d7bbd355436d3fd37cb0acd4", size = 131584, upload-time = "2026-01-07T16:24:42.685Z" },
+]
+
+[[package]]
+name = "websockets"
+version = "16.0"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/04/24/4b2031d72e840ce4c1ccb255f693b15c334757fc50023e4db9537080b8c4/websockets-16.0.tar.gz", hash = "sha256:5f6261a5e56e8d5c42a4497b364ea24d94d9563e8fbd44e78ac40879c60179b5", size = 179346, upload-time = "2026-01-10T09:23:47.181Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/84/7b/bac442e6b96c9d25092695578dda82403c77936104b5682307bd4deb1ad4/websockets-16.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:71c989cbf3254fbd5e84d3bff31e4da39c43f884e64f2551d14bb3c186230f00", size = 177365, upload-time = "2026-01-10T09:22:46.787Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/fe/136ccece61bd690d9c1f715baaeefd953bb2360134de73519d5df19d29ca/websockets-16.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:8b6e209ffee39ff1b6d0fa7bfef6de950c60dfb91b8fcead17da4ee539121a79", size = 175038, upload-time = "2026-01-10T09:22:47.999Z" },
+    { url = "https://files.pythonhosted.org/packages/40/1e/9771421ac2286eaab95b8575b0cb701ae3663abf8b5e1f64f1fd90d0a673/websockets-16.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:86890e837d61574c92a97496d590968b23c2ef0aeb8a9bc9421d174cd378ae39", size = 175328, upload-time = "2026-01-10T09:22:49.809Z" },
+    { url = "https://files.pythonhosted.org/packages/18/29/71729b4671f21e1eaa5d6573031ab810ad2936c8175f03f97f3ff164c802/websockets-16.0-cp312-cp312-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:9b5aca38b67492ef518a8ab76851862488a478602229112c4b0d58d63a7a4d5c", size = 184915, upload-time = "2026-01-10T09:22:51.071Z" },
+    { url = "https://files.pythonhosted.org/packages/97/bb/21c36b7dbbafc85d2d480cd65df02a1dc93bf76d97147605a8e27ff9409d/websockets-16.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e0334872c0a37b606418ac52f6ab9cfd17317ac26365f7f65e203e2d0d0d359f", size = 186152, upload-time = "2026-01-10T09:22:52.224Z" },
+    { url = "https://files.pythonhosted.org/packages/4a/34/9bf8df0c0cf88fa7bfe36678dc7b02970c9a7d5e065a3099292db87b1be2/websockets-16.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:a0b31e0b424cc6b5a04b8838bbaec1688834b2383256688cf47eb97412531da1", size = 185583, upload-time = "2026-01-10T09:22:53.443Z" },
+    { url = "https://files.pythonhosted.org/packages/47/88/4dd516068e1a3d6ab3c7c183288404cd424a9a02d585efbac226cb61ff2d/websockets-16.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:485c49116d0af10ac698623c513c1cc01c9446c058a4e61e3bf6c19dff7335a2", size = 184880, upload-time = "2026-01-10T09:22:55.033Z" },
+    { url = "https://files.pythonhosted.org/packages/91/d6/7d4553ad4bf1c0421e1ebd4b18de5d9098383b5caa1d937b63df8d04b565/websockets-16.0-cp312-cp312-win32.whl", hash = "sha256:eaded469f5e5b7294e2bdca0ab06becb6756ea86894a47806456089298813c89", size = 178261, upload-time = "2026-01-10T09:22:56.251Z" },
+    { url = "https://files.pythonhosted.org/packages/c3/f0/f3a17365441ed1c27f850a80b2bc680a0fa9505d733fe152fdf5e98c1c0b/websockets-16.0-cp312-cp312-win_amd64.whl", hash = "sha256:5569417dc80977fc8c2d43a86f78e0a5a22fee17565d78621b6bb264a115d4ea", size = 178693, upload-time = "2026-01-10T09:22:57.478Z" },
+    { url = "https://files.pythonhosted.org/packages/cc/9c/baa8456050d1c1b08dd0ec7346026668cbc6f145ab4e314d707bb845bf0d/websockets-16.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:878b336ac47938b474c8f982ac2f7266a540adc3fa4ad74ae96fea9823a02cc9", size = 177364, upload-time = "2026-01-10T09:22:59.333Z" },
+    { url = "https://files.pythonhosted.org/packages/7e/0c/8811fc53e9bcff68fe7de2bcbe75116a8d959ac699a3200f4847a8925210/websockets-16.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:52a0fec0e6c8d9a784c2c78276a48a2bdf099e4ccc2a4cad53b27718dbfd0230", size = 175039, upload-time = "2026-01-10T09:23:01.171Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/82/39a5f910cb99ec0b59e482971238c845af9220d3ab9fa76dd9162cda9d62/websockets-16.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:e6578ed5b6981005df1860a56e3617f14a6c307e6a71b4fff8c48fdc50f3ed2c", size = 175323, upload-time = "2026-01-10T09:23:02.341Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/28/0a25ee5342eb5d5f297d992a77e56892ecb65e7854c7898fb7d35e9b33bd/websockets-16.0-cp313-cp313-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:95724e638f0f9c350bb1c2b0a7ad0e83d9cc0c9259f3ea94e40d7b02a2179ae5", size = 184975, upload-time = "2026-01-10T09:23:03.756Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/66/27ea52741752f5107c2e41fda05e8395a682a1e11c4e592a809a90c6a506/websockets-16.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:c0204dc62a89dc9d50d682412c10b3542d748260d743500a85c13cd1ee4bde82", size = 186203, upload-time = "2026-01-10T09:23:05.01Z" },
+    { url = "https://files.pythonhosted.org/packages/37/e5/8e32857371406a757816a2b471939d51c463509be73fa538216ea52b792a/websockets-16.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:52ac480f44d32970d66763115edea932f1c5b1312de36df06d6b219f6741eed8", size = 185653, upload-time = "2026-01-10T09:23:06.301Z" },
+    { url = "https://files.pythonhosted.org/packages/9b/67/f926bac29882894669368dc73f4da900fcdf47955d0a0185d60103df5737/websockets-16.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:6e5a82b677f8f6f59e8dfc34ec06ca6b5b48bc4fcda346acd093694cc2c24d8f", size = 184920, upload-time = "2026-01-10T09:23:07.492Z" },
+    { url = "https://files.pythonhosted.org/packages/3c/a1/3d6ccdcd125b0a42a311bcd15a7f705d688f73b2a22d8cf1c0875d35d34a/websockets-16.0-cp313-cp313-win32.whl", hash = "sha256:abf050a199613f64c886ea10f38b47770a65154dc37181bfaff70c160f45315a", size = 178255, upload-time = "2026-01-10T09:23:09.245Z" },
+    { url = "https://files.pythonhosted.org/packages/6b/ae/90366304d7c2ce80f9b826096a9e9048b4bb760e44d3b873bb272cba696b/websockets-16.0-cp313-cp313-win_amd64.whl", hash = "sha256:3425ac5cf448801335d6fdc7ae1eb22072055417a96cc6b31b3861f455fbc156", size = 178689, upload-time = "2026-01-10T09:23:10.483Z" },
+    { url = "https://files.pythonhosted.org/packages/f3/1d/e88022630271f5bd349ed82417136281931e558d628dd52c4d8621b4a0b2/websockets-16.0-cp314-cp314-macosx_10_15_universal2.whl", hash = "sha256:8cc451a50f2aee53042ac52d2d053d08bf89bcb31ae799cb4487587661c038a0", size = 177406, upload-time = "2026-01-10T09:23:12.178Z" },
+    { url = "https://files.pythonhosted.org/packages/f2/78/e63be1bf0724eeb4616efb1ae1c9044f7c3953b7957799abb5915bffd38e/websockets-16.0-cp314-cp314-macosx_10_15_x86_64.whl", hash = "sha256:daa3b6ff70a9241cf6c7fc9e949d41232d9d7d26fd3522b1ad2b4d62487e9904", size = 175085, upload-time = "2026-01-10T09:23:13.511Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/f4/d3c9220d818ee955ae390cf319a7c7a467beceb24f05ee7aaaa2414345ba/websockets-16.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:fd3cb4adb94a2a6e2b7c0d8d05cb94e6f1c81a0cf9dc2694fb65c7e8d94c42e4", size = 175328, upload-time = "2026-01-10T09:23:14.727Z" },
+    { url = "https://files.pythonhosted.org/packages/63/bc/d3e208028de777087e6fb2b122051a6ff7bbcca0d6df9d9c2bf1dd869ae9/websockets-16.0-cp314-cp314-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:781caf5e8eee67f663126490c2f96f40906594cb86b408a703630f95550a8c3e", size = 185044, upload-time = "2026-01-10T09:23:15.939Z" },
+    { url = "https://files.pythonhosted.org/packages/ad/6e/9a0927ac24bd33a0a9af834d89e0abc7cfd8e13bed17a86407a66773cc0e/websockets-16.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:caab51a72c51973ca21fa8a18bd8165e1a0183f1ac7066a182ff27107b71e1a4", size = 186279, upload-time = "2026-01-10T09:23:17.148Z" },
+    { url = "https://files.pythonhosted.org/packages/b9/ca/bf1c68440d7a868180e11be653c85959502efd3a709323230314fda6e0b3/websockets-16.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:19c4dc84098e523fd63711e563077d39e90ec6702aff4b5d9e344a60cb3c0cb1", size = 185711, upload-time = "2026-01-10T09:23:18.372Z" },
+    { url = "https://files.pythonhosted.org/packages/c4/f8/fdc34643a989561f217bb477cbc47a3a07212cbda91c0e4389c43c296ebf/websockets-16.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:a5e18a238a2b2249c9a9235466b90e96ae4795672598a58772dd806edc7ac6d3", size = 184982, upload-time = "2026-01-10T09:23:19.652Z" },
+    { url = "https://files.pythonhosted.org/packages/dd/d1/574fa27e233764dbac9c52730d63fcf2823b16f0856b3329fc6268d6ae4f/websockets-16.0-cp314-cp314-win32.whl", hash = "sha256:a069d734c4a043182729edd3e9f247c3b2a4035415a9172fd0f1b71658a320a8", size = 177915, upload-time = "2026-01-10T09:23:21.458Z" },
+    { url = "https://files.pythonhosted.org/packages/8a/f1/ae6b937bf3126b5134ce1f482365fde31a357c784ac51852978768b5eff4/websockets-16.0-cp314-cp314-win_amd64.whl", hash = "sha256:c0ee0e63f23914732c6d7e0cce24915c48f3f1512ec1d079ed01fc629dab269d", size = 178381, upload-time = "2026-01-10T09:23:22.715Z" },
+    { url = "https://files.pythonhosted.org/packages/06/9b/f791d1db48403e1f0a27577a6beb37afae94254a8c6f08be4a23e4930bc0/websockets-16.0-cp314-cp314t-macosx_10_15_universal2.whl", hash = "sha256:a35539cacc3febb22b8f4d4a99cc79b104226a756aa7400adc722e83b0d03244", size = 177737, upload-time = "2026-01-10T09:23:24.523Z" },
+    { url = "https://files.pythonhosted.org/packages/bd/40/53ad02341fa33b3ce489023f635367a4ac98b73570102ad2cdd770dacc9a/websockets-16.0-cp314-cp314t-macosx_10_15_x86_64.whl", hash = "sha256:b784ca5de850f4ce93ec85d3269d24d4c82f22b7212023c974c401d4980ebc5e", size = 175268, upload-time = "2026-01-10T09:23:25.781Z" },
+    { url = "https://files.pythonhosted.org/packages/74/9b/6158d4e459b984f949dcbbb0c5d270154c7618e11c01029b9bbd1bb4c4f9/websockets-16.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:569d01a4e7fba956c5ae4fc988f0d4e187900f5497ce46339c996dbf24f17641", size = 175486, upload-time = "2026-01-10T09:23:27.033Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/2d/7583b30208b639c8090206f95073646c2c9ffd66f44df967981a64f849ad/websockets-16.0-cp314-cp314t-manylinux1_x86_64.manylinux_2_28_x86_64.manylinux_2_5_x86_64.whl", hash = "sha256:50f23cdd8343b984957e4077839841146f67a3d31ab0d00e6b824e74c5b2f6e8", size = 185331, upload-time = "2026-01-10T09:23:28.259Z" },
+    { url = "https://files.pythonhosted.org/packages/45/b0/cce3784eb519b7b5ad680d14b9673a31ab8dcb7aad8b64d81709d2430aa8/websockets-16.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:152284a83a00c59b759697b7f9e9cddf4e3c7861dd0d964b472b70f78f89e80e", size = 186501, upload-time = "2026-01-10T09:23:29.449Z" },
+    { url = "https://files.pythonhosted.org/packages/19/60/b8ebe4c7e89fb5f6cdf080623c9d92789a53636950f7abacfc33fe2b3135/websockets-16.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:bc59589ab64b0022385f429b94697348a6a234e8ce22544e3681b2e9331b5944", size = 186062, upload-time = "2026-01-10T09:23:31.368Z" },
+    { url = "https://files.pythonhosted.org/packages/88/a8/a080593f89b0138b6cba1b28f8df5673b5506f72879322288b031337c0b8/websockets-16.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:32da954ffa2814258030e5a57bc73a3635463238e797c7375dc8091327434206", size = 185356, upload-time = "2026-01-10T09:23:32.627Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/b6/b9afed2afadddaf5ebb2afa801abf4b0868f42f8539bfe4b071b5266c9fe/websockets-16.0-cp314-cp314t-win32.whl", hash = "sha256:5a4b4cc550cb665dd8a47f868c8d04c8230f857363ad3c9caf7a0c3bf8c61ca6", size = 178085, upload-time = "2026-01-10T09:23:33.816Z" },
+    { url = "https://files.pythonhosted.org/packages/9f/3e/28135a24e384493fa804216b79a6a6759a38cc4ff59118787b9fb693df93/websockets-16.0-cp314-cp314t-win_amd64.whl", hash = "sha256:b14dc141ed6d2dde437cddb216004bcac6a1df0935d79656387bd41632ba0bbd", size = 178531, upload-time = "2026-01-10T09:23:35.016Z" },
+    { url = "https://files.pythonhosted.org/packages/6f/28/258ebab549c2bf3e64d2b0217b973467394a9cea8c42f70418ca2c5d0d2e/websockets-16.0-py3-none-any.whl", hash = "sha256:1637db62fad1dc833276dded54215f2c7fa46912301a24bd94d45d46a011ceec", size = 171598, upload-time = "2026-01-10T09:23:45.395Z" },
+]
+
+[[package]]
+name = "yarl"
+version = "1.22.0"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "idna" },
+    { name = "multidict" },
+    { name = "propcache" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/57/63/0c6ebca57330cd313f6102b16dd57ffaf3ec4c83403dcb45dbd15c6f3ea1/yarl-1.22.0.tar.gz", hash = "sha256:bebf8557577d4401ba8bd9ff33906f1376c877aa78d1fe216ad01b4d6745af71", size = 187169, upload-time = "2025-10-06T14:12:55.963Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/75/ff/46736024fee3429b80a165a732e38e5d5a238721e634ab41b040d49f8738/yarl-1.22.0-cp312-cp312-macosx_10_13_universal2.whl", hash = "sha256:e340382d1afa5d32b892b3ff062436d592ec3d692aeea3bef3a5cfe11bbf8c6f", size = 142000, upload-time = "2025-10-06T14:09:44.631Z" },
+    { url = "https://files.pythonhosted.org/packages/5a/9a/b312ed670df903145598914770eb12de1bac44599549b3360acc96878df8/yarl-1.22.0-cp312-cp312-macosx_10_13_x86_64.whl", hash = "sha256:f1e09112a2c31ffe8d80be1b0988fa6a18c5d5cad92a9ffbb1c04c91bfe52ad2", size = 94338, upload-time = "2025-10-06T14:09:46.372Z" },
+    { url = "https://files.pythonhosted.org/packages/ba/f5/0601483296f09c3c65e303d60c070a5c19fcdbc72daa061e96170785bc7d/yarl-1.22.0-cp312-cp312-macosx_11_0_arm64.whl", hash = "sha256:939fe60db294c786f6b7c2d2e121576628468f65453d86b0fe36cb52f987bd74", size = 94909, upload-time = "2025-10-06T14:09:48.648Z" },
+    { url = "https://files.pythonhosted.org/packages/60/41/9a1fe0b73dbcefce72e46cf149b0e0a67612d60bfc90fb59c2b2efdfbd86/yarl-1.22.0-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:e1651bf8e0398574646744c1885a41198eba53dc8a9312b954073f845c90a8df", size = 372940, upload-time = "2025-10-06T14:09:50.089Z" },
+    { url = "https://files.pythonhosted.org/packages/17/7a/795cb6dfee561961c30b800f0ed616b923a2ec6258b5def2a00bf8231334/yarl-1.22.0-cp312-cp312-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:b8a0588521a26bf92a57a1705b77b8b59044cdceccac7151bd8d229e66b8dedb", size = 345825, upload-time = "2025-10-06T14:09:52.142Z" },
+    { url = "https://files.pythonhosted.org/packages/d7/93/a58f4d596d2be2ae7bab1a5846c4d270b894958845753b2c606d666744d3/yarl-1.22.0-cp312-cp312-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:42188e6a615c1a75bcaa6e150c3fe8f3e8680471a6b10150c5f7e83f47cc34d2", size = 386705, upload-time = "2025-10-06T14:09:54.128Z" },
+    { url = "https://files.pythonhosted.org/packages/61/92/682279d0e099d0e14d7fd2e176bd04f48de1484f56546a3e1313cd6c8e7c/yarl-1.22.0-cp312-cp312-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:f6d2cb59377d99718913ad9a151030d6f83ef420a2b8f521d94609ecc106ee82", size = 396518, upload-time = "2025-10-06T14:09:55.762Z" },
+    { url = "https://files.pythonhosted.org/packages/db/0f/0d52c98b8a885aeda831224b78f3be7ec2e1aa4a62091f9f9188c3c65b56/yarl-1.22.0-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:50678a3b71c751d58d7908edc96d332af328839eea883bb554a43f539101277a", size = 377267, upload-time = "2025-10-06T14:09:57.958Z" },
+    { url = "https://files.pythonhosted.org/packages/22/42/d2685e35908cbeaa6532c1fc73e89e7f2efb5d8a7df3959ea8e37177c5a3/yarl-1.22.0-cp312-cp312-musllinux_1_2_aarch64.whl", hash = "sha256:1e8fbaa7cec507aa24ea27a01456e8dd4b6fab829059b69844bd348f2d467124", size = 365797, upload-time = "2025-10-06T14:09:59.527Z" },
+    { url = "https://files.pythonhosted.org/packages/a2/83/cf8c7bcc6355631762f7d8bdab920ad09b82efa6b722999dfb05afa6cfac/yarl-1.22.0-cp312-cp312-musllinux_1_2_armv7l.whl", hash = "sha256:433885ab5431bc3d3d4f2f9bd15bfa1614c522b0f1405d62c4f926ccd69d04fa", size = 365535, upload-time = "2025-10-06T14:10:01.139Z" },
+    { url = "https://files.pythonhosted.org/packages/25/e1/5302ff9b28f0c59cac913b91fe3f16c59a033887e57ce9ca5d41a3a94737/yarl-1.22.0-cp312-cp312-musllinux_1_2_ppc64le.whl", hash = "sha256:b790b39c7e9a4192dc2e201a282109ed2985a1ddbd5ac08dc56d0e121400a8f7", size = 382324, upload-time = "2025-10-06T14:10:02.756Z" },
+    { url = "https://files.pythonhosted.org/packages/bf/cd/4617eb60f032f19ae3a688dc990d8f0d89ee0ea378b61cac81ede3e52fae/yarl-1.22.0-cp312-cp312-musllinux_1_2_s390x.whl", hash = "sha256:31f0b53913220599446872d757257be5898019c85e7971599065bc55065dc99d", size = 383803, upload-time = "2025-10-06T14:10:04.552Z" },
+    { url = "https://files.pythonhosted.org/packages/59/65/afc6e62bb506a319ea67b694551dab4a7e6fb7bf604e9bd9f3e11d575fec/yarl-1.22.0-cp312-cp312-musllinux_1_2_x86_64.whl", hash = "sha256:a49370e8f711daec68d09b821a34e1167792ee2d24d405cbc2387be4f158b520", size = 374220, upload-time = "2025-10-06T14:10:06.489Z" },
+    { url = "https://files.pythonhosted.org/packages/e7/3d/68bf18d50dc674b942daec86a9ba922d3113d8399b0e52b9897530442da2/yarl-1.22.0-cp312-cp312-win32.whl", hash = "sha256:70dfd4f241c04bd9239d53b17f11e6ab672b9f1420364af63e8531198e3f5fe8", size = 81589, upload-time = "2025-10-06T14:10:09.254Z" },
+    { url = "https://files.pythonhosted.org/packages/c8/9a/6ad1a9b37c2f72874f93e691b2e7ecb6137fb2b899983125db4204e47575/yarl-1.22.0-cp312-cp312-win_amd64.whl", hash = "sha256:8884d8b332a5e9b88e23f60bb166890009429391864c685e17bd73a9eda9105c", size = 87213, upload-time = "2025-10-06T14:10:11.369Z" },
+    { url = "https://files.pythonhosted.org/packages/44/c5/c21b562d1680a77634d748e30c653c3ca918beb35555cff24986fff54598/yarl-1.22.0-cp312-cp312-win_arm64.whl", hash = "sha256:ea70f61a47f3cc93bdf8b2f368ed359ef02a01ca6393916bc8ff877427181e74", size = 81330, upload-time = "2025-10-06T14:10:13.112Z" },
+    { url = "https://files.pythonhosted.org/packages/ea/f3/d67de7260456ee105dc1d162d43a019ecad6b91e2f51809d6cddaa56690e/yarl-1.22.0-cp313-cp313-macosx_10_13_universal2.whl", hash = "sha256:8dee9c25c74997f6a750cd317b8ca63545169c098faee42c84aa5e506c819b53", size = 139980, upload-time = "2025-10-06T14:10:14.601Z" },
+    { url = "https://files.pythonhosted.org/packages/01/88/04d98af0b47e0ef42597b9b28863b9060bb515524da0a65d5f4db160b2d5/yarl-1.22.0-cp313-cp313-macosx_10_13_x86_64.whl", hash = "sha256:01e73b85a5434f89fc4fe27dcda2aff08ddf35e4d47bbbea3bdcd25321af538a", size = 93424, upload-time = "2025-10-06T14:10:16.115Z" },
+    { url = "https://files.pythonhosted.org/packages/18/91/3274b215fd8442a03975ce6bee5fe6aa57a8326b29b9d3d56234a1dca244/yarl-1.22.0-cp313-cp313-macosx_11_0_arm64.whl", hash = "sha256:22965c2af250d20c873cdbee8ff958fb809940aeb2e74ba5f20aaf6b7ac8c70c", size = 93821, upload-time = "2025-10-06T14:10:17.993Z" },
+    { url = "https://files.pythonhosted.org/packages/61/3a/caf4e25036db0f2da4ca22a353dfeb3c9d3c95d2761ebe9b14df8fc16eb0/yarl-1.22.0-cp313-cp313-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:b4f15793aa49793ec8d1c708ab7f9eded1aa72edc5174cae703651555ed1b601", size = 373243, upload-time = "2025-10-06T14:10:19.44Z" },
+    { url = "https://files.pythonhosted.org/packages/6e/9e/51a77ac7516e8e7803b06e01f74e78649c24ee1021eca3d6a739cb6ea49c/yarl-1.22.0-cp313-cp313-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:e5542339dcf2747135c5c85f68680353d5cb9ffd741c0f2e8d832d054d41f35a", size = 342361, upload-time = "2025-10-06T14:10:21.124Z" },
+    { url = "https://files.pythonhosted.org/packages/d4/f8/33b92454789dde8407f156c00303e9a891f1f51a0330b0fad7c909f87692/yarl-1.22.0-cp313-cp313-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:5c401e05ad47a75869c3ab3e35137f8468b846770587e70d71e11de797d113df", size = 387036, upload-time = "2025-10-06T14:10:22.902Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/9a/c5db84ea024f76838220280f732970aa4ee154015d7f5c1bfb60a267af6f/yarl-1.22.0-cp313-cp313-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:243dda95d901c733f5b59214d28b0120893d91777cb8aa043e6ef059d3cddfe2", size = 397671, upload-time = "2025-10-06T14:10:24.523Z" },
+    { url = "https://files.pythonhosted.org/packages/11/c9/cd8538dc2e7727095e0c1d867bad1e40c98f37763e6d995c1939f5fdc7b1/yarl-1.22.0-cp313-cp313-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bec03d0d388060058f5d291a813f21c011041938a441c593374da6077fe21b1b", size = 377059, upload-time = "2025-10-06T14:10:26.406Z" },
+    { url = "https://files.pythonhosted.org/packages/a1/b9/ab437b261702ced75122ed78a876a6dec0a1b0f5e17a4ac7a9a2482d8abe/yarl-1.22.0-cp313-cp313-musllinux_1_2_aarch64.whl", hash = "sha256:b0748275abb8c1e1e09301ee3cf90c8a99678a4e92e4373705f2a2570d581273", size = 365356, upload-time = "2025-10-06T14:10:28.461Z" },
+    { url = "https://files.pythonhosted.org/packages/b2/9d/8e1ae6d1d008a9567877b08f0ce4077a29974c04c062dabdb923ed98e6fe/yarl-1.22.0-cp313-cp313-musllinux_1_2_armv7l.whl", hash = "sha256:47fdb18187e2a4e18fda2c25c05d8251a9e4a521edaed757fef033e7d8498d9a", size = 361331, upload-time = "2025-10-06T14:10:30.541Z" },
+    { url = "https://files.pythonhosted.org/packages/ca/5a/09b7be3905962f145b73beb468cdd53db8aa171cf18c80400a54c5b82846/yarl-1.22.0-cp313-cp313-musllinux_1_2_ppc64le.whl", hash = "sha256:c7044802eec4524fde550afc28edda0dd5784c4c45f0be151a2d3ba017daca7d", size = 382590, upload-time = "2025-10-06T14:10:33.352Z" },
+    { url = "https://files.pythonhosted.org/packages/aa/7f/59ec509abf90eda5048b0bc3e2d7b5099dffdb3e6b127019895ab9d5ef44/yarl-1.22.0-cp313-cp313-musllinux_1_2_s390x.whl", hash = "sha256:139718f35149ff544caba20fce6e8a2f71f1e39b92c700d8438a0b1d2a631a02", size = 385316, upload-time = "2025-10-06T14:10:35.034Z" },
+    { url = "https://files.pythonhosted.org/packages/e5/84/891158426bc8036bfdfd862fabd0e0fa25df4176ec793e447f4b85cf1be4/yarl-1.22.0-cp313-cp313-musllinux_1_2_x86_64.whl", hash = "sha256:e1b51bebd221006d3d2f95fbe124b22b247136647ae5dcc8c7acafba66e5ee67", size = 374431, upload-time = "2025-10-06T14:10:37.76Z" },
+    { url = "https://files.pythonhosted.org/packages/bb/49/03da1580665baa8bef5e8ed34c6df2c2aca0a2f28bf397ed238cc1bbc6f2/yarl-1.22.0-cp313-cp313-win32.whl", hash = "sha256:d3e32536234a95f513bd374e93d717cf6b2231a791758de6c509e3653f234c95", size = 81555, upload-time = "2025-10-06T14:10:39.649Z" },
+    { url = "https://files.pythonhosted.org/packages/9a/ee/450914ae11b419eadd067c6183ae08381cfdfcb9798b90b2b713bbebddda/yarl-1.22.0-cp313-cp313-win_amd64.whl", hash = "sha256:47743b82b76d89a1d20b83e60d5c20314cbd5ba2befc9cda8f28300c4a08ed4d", size = 86965, upload-time = "2025-10-06T14:10:41.313Z" },
+    { url = "https://files.pythonhosted.org/packages/98/4d/264a01eae03b6cf629ad69bae94e3b0e5344741e929073678e84bf7a3e3b/yarl-1.22.0-cp313-cp313-win_arm64.whl", hash = "sha256:5d0fcda9608875f7d052eff120c7a5da474a6796fe4d83e152e0e4d42f6d1a9b", size = 81205, upload-time = "2025-10-06T14:10:43.167Z" },
+    { url = "https://files.pythonhosted.org/packages/88/fc/6908f062a2f77b5f9f6d69cecb1747260831ff206adcbc5b510aff88df91/yarl-1.22.0-cp313-cp313t-macosx_10_13_universal2.whl", hash = "sha256:719ae08b6972befcba4310e49edb1161a88cdd331e3a694b84466bd938a6ab10", size = 146209, upload-time = "2025-10-06T14:10:44.643Z" },
+    { url = "https://files.pythonhosted.org/packages/65/47/76594ae8eab26210b4867be6f49129861ad33da1f1ebdf7051e98492bf62/yarl-1.22.0-cp313-cp313t-macosx_10_13_x86_64.whl", hash = "sha256:47d8a5c446df1c4db9d21b49619ffdba90e77c89ec6e283f453856c74b50b9e3", size = 95966, upload-time = "2025-10-06T14:10:46.554Z" },
+    { url = "https://files.pythonhosted.org/packages/ab/ce/05e9828a49271ba6b5b038b15b3934e996980dd78abdfeb52a04cfb9467e/yarl-1.22.0-cp313-cp313t-macosx_11_0_arm64.whl", hash = "sha256:cfebc0ac8333520d2d0423cbbe43ae43c8838862ddb898f5ca68565e395516e9", size = 97312, upload-time = "2025-10-06T14:10:48.007Z" },
+    { url = "https://files.pythonhosted.org/packages/d1/c5/7dffad5e4f2265b29c9d7ec869c369e4223166e4f9206fc2243ee9eea727/yarl-1.22.0-cp313-cp313t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:4398557cbf484207df000309235979c79c4356518fd5c99158c7d38203c4da4f", size = 361967, upload-time = "2025-10-06T14:10:49.997Z" },
+    { url = "https://files.pythonhosted.org/packages/50/b2/375b933c93a54bff7fc041e1a6ad2c0f6f733ffb0c6e642ce56ee3b39970/yarl-1.22.0-cp313-cp313t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:2ca6fd72a8cd803be290d42f2dec5cdcd5299eeb93c2d929bf060ad9efaf5de0", size = 323949, upload-time = "2025-10-06T14:10:52.004Z" },
+    { url = "https://files.pythonhosted.org/packages/66/50/bfc2a29a1d78644c5a7220ce2f304f38248dc94124a326794e677634b6cf/yarl-1.22.0-cp313-cp313t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:ca1f59c4e1ab6e72f0a23c13fca5430f889634166be85dbf1013683e49e3278e", size = 361818, upload-time = "2025-10-06T14:10:54.078Z" },
+    { url = "https://files.pythonhosted.org/packages/46/96/f3941a46af7d5d0f0498f86d71275696800ddcdd20426298e572b19b91ff/yarl-1.22.0-cp313-cp313t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:6c5010a52015e7c70f86eb967db0f37f3c8bd503a695a49f8d45700144667708", size = 372626, upload-time = "2025-10-06T14:10:55.767Z" },
+    { url = "https://files.pythonhosted.org/packages/c1/42/8b27c83bb875cd89448e42cd627e0fb971fa1675c9ec546393d18826cb50/yarl-1.22.0-cp313-cp313t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:9d7672ecf7557476642c88497c2f8d8542f8e36596e928e9bcba0e42e1e7d71f", size = 341129, upload-time = "2025-10-06T14:10:57.985Z" },
+    { url = "https://files.pythonhosted.org/packages/49/36/99ca3122201b382a3cf7cc937b95235b0ac944f7e9f2d5331d50821ed352/yarl-1.22.0-cp313-cp313t-musllinux_1_2_aarch64.whl", hash = "sha256:3b7c88eeef021579d600e50363e0b6ee4f7f6f728cd3486b9d0f3ee7b946398d", size = 346776, upload-time = "2025-10-06T14:10:59.633Z" },
+    { url = "https://files.pythonhosted.org/packages/85/b4/47328bf996acd01a4c16ef9dcd2f59c969f495073616586f78cd5f2efb99/yarl-1.22.0-cp313-cp313t-musllinux_1_2_armv7l.whl", hash = "sha256:f4afb5c34f2c6fecdcc182dfcfc6af6cccf1aa923eed4d6a12e9d96904e1a0d8", size = 334879, upload-time = "2025-10-06T14:11:01.454Z" },
+    { url = "https://files.pythonhosted.org/packages/c2/ad/b77d7b3f14a4283bffb8e92c6026496f6de49751c2f97d4352242bba3990/yarl-1.22.0-cp313-cp313t-musllinux_1_2_ppc64le.whl", hash = "sha256:59c189e3e99a59cf8d83cbb31d4db02d66cda5a1a4374e8a012b51255341abf5", size = 350996, upload-time = "2025-10-06T14:11:03.452Z" },
+    { url = "https://files.pythonhosted.org/packages/81/c8/06e1d69295792ba54d556f06686cbd6a7ce39c22307100e3fb4a2c0b0a1d/yarl-1.22.0-cp313-cp313t-musllinux_1_2_s390x.whl", hash = "sha256:5a3bf7f62a289fa90f1990422dc8dff5a458469ea71d1624585ec3a4c8d6960f", size = 356047, upload-time = "2025-10-06T14:11:05.115Z" },
+    { url = "https://files.pythonhosted.org/packages/4b/b8/4c0e9e9f597074b208d18cef227d83aac36184bfbc6eab204ea55783dbc5/yarl-1.22.0-cp313-cp313t-musllinux_1_2_x86_64.whl", hash = "sha256:de6b9a04c606978fdfe72666fa216ffcf2d1a9f6a381058d4378f8d7b1e5de62", size = 342947, upload-time = "2025-10-06T14:11:08.137Z" },
+    { url = "https://files.pythonhosted.org/packages/e0/e5/11f140a58bf4c6ad7aca69a892bff0ee638c31bea4206748fc0df4ebcb3a/yarl-1.22.0-cp313-cp313t-win32.whl", hash = "sha256:1834bb90991cc2999f10f97f5f01317f99b143284766d197e43cd5b45eb18d03", size = 86943, upload-time = "2025-10-06T14:11:10.284Z" },
+    { url = "https://files.pythonhosted.org/packages/31/74/8b74bae38ed7fe6793d0c15a0c8207bbb819cf287788459e5ed230996cdd/yarl-1.22.0-cp313-cp313t-win_amd64.whl", hash = "sha256:ff86011bd159a9d2dfc89c34cfd8aff12875980e3bd6a39ff097887520e60249", size = 93715, upload-time = "2025-10-06T14:11:11.739Z" },
+    { url = "https://files.pythonhosted.org/packages/69/66/991858aa4b5892d57aef7ee1ba6b4d01ec3b7eb3060795d34090a3ca3278/yarl-1.22.0-cp313-cp313t-win_arm64.whl", hash = "sha256:7861058d0582b847bc4e3a4a4c46828a410bca738673f35a29ba3ca5db0b473b", size = 83857, upload-time = "2025-10-06T14:11:13.586Z" },
+    { url = "https://files.pythonhosted.org/packages/46/b3/e20ef504049f1a1c54a814b4b9bed96d1ac0e0610c3b4da178f87209db05/yarl-1.22.0-cp314-cp314-macosx_10_13_universal2.whl", hash = "sha256:34b36c2c57124530884d89d50ed2c1478697ad7473efd59cfd479945c95650e4", size = 140520, upload-time = "2025-10-06T14:11:15.465Z" },
+    { url = "https://files.pythonhosted.org/packages/e4/04/3532d990fdbab02e5ede063676b5c4260e7f3abea2151099c2aa745acc4c/yarl-1.22.0-cp314-cp314-macosx_10_13_x86_64.whl", hash = "sha256:0dd9a702591ca2e543631c2a017e4a547e38a5c0f29eece37d9097e04a7ac683", size = 93504, upload-time = "2025-10-06T14:11:17.106Z" },
+    { url = "https://files.pythonhosted.org/packages/11/63/ff458113c5c2dac9a9719ac68ee7c947cb621432bcf28c9972b1c0e83938/yarl-1.22.0-cp314-cp314-macosx_11_0_arm64.whl", hash = "sha256:594fcab1032e2d2cc3321bb2e51271e7cd2b516c7d9aee780ece81b07ff8244b", size = 94282, upload-time = "2025-10-06T14:11:19.064Z" },
+    { url = "https://files.pythonhosted.org/packages/a7/bc/315a56aca762d44a6aaaf7ad253f04d996cb6b27bad34410f82d76ea8038/yarl-1.22.0-cp314-cp314-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:f3d7a87a78d46a2e3d5b72587ac14b4c16952dd0887dbb051451eceac774411e", size = 372080, upload-time = "2025-10-06T14:11:20.996Z" },
+    { url = "https://files.pythonhosted.org/packages/3f/3f/08e9b826ec2e099ea6e7c69a61272f4f6da62cb5b1b63590bb80ca2e4a40/yarl-1.22.0-cp314-cp314-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:852863707010316c973162e703bddabec35e8757e67fcb8ad58829de1ebc8590", size = 338696, upload-time = "2025-10-06T14:11:22.847Z" },
+    { url = "https://files.pythonhosted.org/packages/e3/9f/90360108e3b32bd76789088e99538febfea24a102380ae73827f62073543/yarl-1.22.0-cp314-cp314-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:131a085a53bfe839a477c0845acf21efc77457ba2bcf5899618136d64f3303a2", size = 387121, upload-time = "2025-10-06T14:11:24.889Z" },
+    { url = "https://files.pythonhosted.org/packages/98/92/ab8d4657bd5b46a38094cfaea498f18bb70ce6b63508fd7e909bd1f93066/yarl-1.22.0-cp314-cp314-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:078a8aefd263f4d4f923a9677b942b445a2be970ca24548a8102689a3a8ab8da", size = 394080, upload-time = "2025-10-06T14:11:27.307Z" },
+    { url = "https://files.pythonhosted.org/packages/f5/e7/d8c5a7752fef68205296201f8ec2bf718f5c805a7a7e9880576c67600658/yarl-1.22.0-cp314-cp314-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:bca03b91c323036913993ff5c738d0842fc9c60c4648e5c8d98331526df89784", size = 372661, upload-time = "2025-10-06T14:11:29.387Z" },
+    { url = "https://files.pythonhosted.org/packages/b6/2e/f4d26183c8db0bb82d491b072f3127fb8c381a6206a3a56332714b79b751/yarl-1.22.0-cp314-cp314-musllinux_1_2_aarch64.whl", hash = "sha256:68986a61557d37bb90d3051a45b91fa3d5c516d177dfc6dd6f2f436a07ff2b6b", size = 364645, upload-time = "2025-10-06T14:11:31.423Z" },
+    { url = "https://files.pythonhosted.org/packages/80/7c/428e5812e6b87cd00ee8e898328a62c95825bf37c7fa87f0b6bb2ad31304/yarl-1.22.0-cp314-cp314-musllinux_1_2_armv7l.whl", hash = "sha256:4792b262d585ff0dff6bcb787f8492e40698443ec982a3568c2096433660c694", size = 355361, upload-time = "2025-10-06T14:11:33.055Z" },
+    { url = "https://files.pythonhosted.org/packages/ec/2a/249405fd26776f8b13c067378ef4d7dd49c9098d1b6457cdd152a99e96a9/yarl-1.22.0-cp314-cp314-musllinux_1_2_ppc64le.whl", hash = "sha256:ebd4549b108d732dba1d4ace67614b9545b21ece30937a63a65dd34efa19732d", size = 381451, upload-time = "2025-10-06T14:11:35.136Z" },
+    { url = "https://files.pythonhosted.org/packages/67/a8/fb6b1adbe98cf1e2dd9fad71003d3a63a1bc22459c6e15f5714eb9323b93/yarl-1.22.0-cp314-cp314-musllinux_1_2_s390x.whl", hash = "sha256:f87ac53513d22240c7d59203f25cc3beac1e574c6cd681bbfd321987b69f95fd", size = 383814, upload-time = "2025-10-06T14:11:37.094Z" },
+    { url = "https://files.pythonhosted.org/packages/d9/f9/3aa2c0e480fb73e872ae2814c43bc1e734740bb0d54e8cb2a95925f98131/yarl-1.22.0-cp314-cp314-musllinux_1_2_x86_64.whl", hash = "sha256:22b029f2881599e2f1b06f8f1db2ee63bd309e2293ba2d566e008ba12778b8da", size = 370799, upload-time = "2025-10-06T14:11:38.83Z" },
+    { url = "https://files.pythonhosted.org/packages/50/3c/af9dba3b8b5eeb302f36f16f92791f3ea62e3f47763406abf6d5a4a3333b/yarl-1.22.0-cp314-cp314-win32.whl", hash = "sha256:6a635ea45ba4ea8238463b4f7d0e721bad669f80878b7bfd1f89266e2ae63da2", size = 82990, upload-time = "2025-10-06T14:11:40.624Z" },
+    { url = "https://files.pythonhosted.org/packages/ac/30/ac3a0c5bdc1d6efd1b41fa24d4897a4329b3b1e98de9449679dd327af4f0/yarl-1.22.0-cp314-cp314-win_amd64.whl", hash = "sha256:0d6e6885777af0f110b0e5d7e5dda8b704efed3894da26220b7f3d887b839a79", size = 88292, upload-time = "2025-10-06T14:11:42.578Z" },
+    { url = "https://files.pythonhosted.org/packages/df/0a/227ab4ff5b998a1b7410abc7b46c9b7a26b0ca9e86c34ba4b8d8bc7c63d5/yarl-1.22.0-cp314-cp314-win_arm64.whl", hash = "sha256:8218f4e98d3c10d683584cb40f0424f4b9fd6e95610232dd75e13743b070ee33", size = 82888, upload-time = "2025-10-06T14:11:44.863Z" },
+    { url = "https://files.pythonhosted.org/packages/06/5e/a15eb13db90abd87dfbefb9760c0f3f257ac42a5cac7e75dbc23bed97a9f/yarl-1.22.0-cp314-cp314t-macosx_10_13_universal2.whl", hash = "sha256:45c2842ff0e0d1b35a6bf1cd6c690939dacb617a70827f715232b2e0494d55d1", size = 146223, upload-time = "2025-10-06T14:11:46.796Z" },
+    { url = "https://files.pythonhosted.org/packages/18/82/9665c61910d4d84f41a5bf6837597c89e665fa88aa4941080704645932a9/yarl-1.22.0-cp314-cp314t-macosx_10_13_x86_64.whl", hash = "sha256:d947071e6ebcf2e2bee8fce76e10faca8f7a14808ca36a910263acaacef08eca", size = 95981, upload-time = "2025-10-06T14:11:48.845Z" },
+    { url = "https://files.pythonhosted.org/packages/5d/9a/2f65743589809af4d0a6d3aa749343c4b5f4c380cc24a8e94a3c6625a808/yarl-1.22.0-cp314-cp314t-macosx_11_0_arm64.whl", hash = "sha256:334b8721303e61b00019474cc103bdac3d7b1f65e91f0bfedeec2d56dfe74b53", size = 97303, upload-time = "2025-10-06T14:11:50.897Z" },
+    { url = "https://files.pythonhosted.org/packages/b0/ab/5b13d3e157505c43c3b43b5a776cbf7b24a02bc4cccc40314771197e3508/yarl-1.22.0-cp314-cp314t-manylinux2014_aarch64.manylinux_2_17_aarch64.manylinux_2_28_aarch64.whl", hash = "sha256:1e7ce67c34138a058fd092f67d07a72b8e31ff0c9236e751957465a24b28910c", size = 361820, upload-time = "2025-10-06T14:11:52.549Z" },
+    { url = "https://files.pythonhosted.org/packages/fb/76/242a5ef4677615cf95330cfc1b4610e78184400699bdda0acb897ef5e49a/yarl-1.22.0-cp314-cp314t-manylinux2014_armv7l.manylinux_2_17_armv7l.manylinux_2_31_armv7l.whl", hash = "sha256:d77e1b2c6d04711478cb1c4ab90db07f1609ccf06a287d5607fcd90dc9863acf", size = 323203, upload-time = "2025-10-06T14:11:54.225Z" },
+    { url = "https://files.pythonhosted.org/packages/8c/96/475509110d3f0153b43d06164cf4195c64d16999e0c7e2d8a099adcd6907/yarl-1.22.0-cp314-cp314t-manylinux2014_ppc64le.manylinux_2_17_ppc64le.manylinux_2_28_ppc64le.whl", hash = "sha256:c4647674b6150d2cae088fc07de2738a84b8bcedebef29802cf0b0a82ab6face", size = 363173, upload-time = "2025-10-06T14:11:56.069Z" },
+    { url = "https://files.pythonhosted.org/packages/c9/66/59db471aecfbd559a1fd48aedd954435558cd98c7d0da8b03cc6c140a32c/yarl-1.22.0-cp314-cp314t-manylinux2014_s390x.manylinux_2_17_s390x.manylinux_2_28_s390x.whl", hash = "sha256:efb07073be061c8f79d03d04139a80ba33cbd390ca8f0297aae9cce6411e4c6b", size = 373562, upload-time = "2025-10-06T14:11:58.783Z" },
+    { url = "https://files.pythonhosted.org/packages/03/1f/c5d94abc91557384719da10ff166b916107c1b45e4d0423a88457071dd88/yarl-1.22.0-cp314-cp314t-manylinux2014_x86_64.manylinux_2_17_x86_64.manylinux_2_28_x86_64.whl", hash = "sha256:e51ac5435758ba97ad69617e13233da53908beccc6cfcd6c34bbed8dcbede486", size = 339828, upload-time = "2025-10-06T14:12:00.686Z" },
+    { url = "https://files.pythonhosted.org/packages/5f/97/aa6a143d3afba17b6465733681c70cf175af89f76ec8d9286e08437a7454/yarl-1.22.0-cp314-cp314t-musllinux_1_2_aarch64.whl", hash = "sha256:33e32a0dd0c8205efa8e83d04fc9f19313772b78522d1bdc7d9aed706bfd6138", size = 347551, upload-time = "2025-10-06T14:12:02.628Z" },
+    { url = "https://files.pythonhosted.org/packages/43/3c/45a2b6d80195959239a7b2a8810506d4eea5487dce61c2a3393e7fc3c52e/yarl-1.22.0-cp314-cp314t-musllinux_1_2_armv7l.whl", hash = "sha256:bf4a21e58b9cde0e401e683ebd00f6ed30a06d14e93f7c8fd059f8b6e8f87b6a", size = 334512, upload-time = "2025-10-06T14:12:04.871Z" },
+    { url = "https://files.pythonhosted.org/packages/86/a0/c2ab48d74599c7c84cb104ebd799c5813de252bea0f360ffc29d270c2caa/yarl-1.22.0-cp314-cp314t-musllinux_1_2_ppc64le.whl", hash = "sha256:e4b582bab49ac33c8deb97e058cd67c2c50dac0dd134874106d9c774fd272529", size = 352400, upload-time = "2025-10-06T14:12:06.624Z" },
+    { url = "https://files.pythonhosted.org/packages/32/75/f8919b2eafc929567d3d8411f72bdb1a2109c01caaab4ebfa5f8ffadc15b/yarl-1.22.0-cp314-cp314t-musllinux_1_2_s390x.whl", hash = "sha256:0b5bcc1a9c4839e7e30b7b30dd47fe5e7e44fb7054ec29b5bb8d526aa1041093", size = 357140, upload-time = "2025-10-06T14:12:08.362Z" },
+    { url = "https://files.pythonhosted.org/packages/cf/72/6a85bba382f22cf78add705d8c3731748397d986e197e53ecc7835e76de7/yarl-1.22.0-cp314-cp314t-musllinux_1_2_x86_64.whl", hash = "sha256:c0232bce2170103ec23c454e54a57008a9a72b5d1c3105dc2496750da8cfa47c", size = 341473, upload-time = "2025-10-06T14:12:10.994Z" },
+    { url = "https://files.pythonhosted.org/packages/35/18/55e6011f7c044dc80b98893060773cefcfdbf60dfefb8cb2f58b9bacbd83/yarl-1.22.0-cp314-cp314t-win32.whl", hash = "sha256:8009b3173bcd637be650922ac455946197d858b3630b6d8787aa9e5c4564533e", size = 89056, upload-time = "2025-10-06T14:12:13.317Z" },
+    { url = "https://files.pythonhosted.org/packages/f9/86/0f0dccb6e59a9e7f122c5afd43568b1d31b8ab7dda5f1b01fb5c7025c9a9/yarl-1.22.0-cp314-cp314t-win_amd64.whl", hash = "sha256:9fb17ea16e972c63d25d4a97f016d235c78dd2344820eb35bc034bc32012ee27", size = 96292, upload-time = "2025-10-06T14:12:15.398Z" },
+    { url = "https://files.pythonhosted.org/packages/48/b7/503c98092fb3b344a179579f55814b613c1fbb1c23b3ec14a7b008a66a6e/yarl-1.22.0-cp314-cp314t-win_arm64.whl", hash = "sha256:9f6d73c1436b934e3f01df1e1b21ff765cd1d28c77dfb9ace207f746d4610ee1", size = 85171, upload-time = "2025-10-06T14:12:16.935Z" },
+    { url = "https://files.pythonhosted.org/packages/73/ae/b48f95715333080afb75a4504487cbe142cae1268afc482d06692d605ae6/yarl-1.22.0-py3-none-any.whl", hash = "sha256:1380560bdba02b6b6c90de54133c81c9f2a453dee9912fe58c1dcced1edb7cff", size = 46814, upload-time = "2025-10-06T14:12:53.872Z" },
+]
diff --git a/vault/.claude-plugin/plugin.json b/vault/.claude-plugin/plugin.json
new file mode 100644
index 0000000..6bf2b0c
--- /dev/null
+++ b/vault/.claude-plugin/plugin.json
@@ -0,0 +1,31 @@
+{
+  "name": "d-brain",
+  "version": "2.0.0",
+  "description": "Voice-first personal assistant for capturing thoughts and tasks via Telegram, with goal tracking and Obsidian integration",
+  "author": {
+    "name": "[Your Name]",
+    "url": "https://github.com/[yourusername]"
+  },
+  "license": "MIT",
+  "capabilities": {
+    "agents": true,
+    "skills": true,
+    "rules": true
+  },
+  "integrations": {
+    "telegram": "Voice/text/photo capture",
+    "todoist": "Task management via MCP",
+    "obsidian": "PKM vault storage",
+    "deepgram": "Voice transcription"
+  },
+  "keywords": [
+    "voice-capture",
+    "telegram-bot",
+    "todoist",
+    "obsidian",
+    "pkm",
+    "goals",
+    "productivity",
+    "personal-assistant"
+  ]
+}
diff --git a/vault/.claude/CLAUDE.md b/vault/.claude/CLAUDE.md
new file mode 100644
index 0000000..5c2271d
--- /dev/null
+++ b/vault/.claude/CLAUDE.md
@@ -0,0 +1,249 @@
+# Agent Second Brain
+
+Voice-first personal assistant for capturing thoughts and managing tasks via Telegram.
+
+## EVERY SESSION BOOTSTRAP
+
+**Before doing anything else, read these files in order:**
+
+1. `vault/MEMORY.md` — curated long-term memory (preferences, decisions, context)
+2. `vault/.memory-config.json` — memory decay configuration
+3. `vault/daily/YYYY-MM-DD.md` — today's entries
+4. `vault/daily/YYYY-MM-DD.md` — yesterday's entries (for continuity)
+5. `vault/goals/3-weekly.md` — this week's ONE Big Thing
+6. `vault/.session/handoff.md` — previous session context (if exists)
+
+**Don't ask permission, just do it.** This ensures context continuity across sessions.
+
+---
+
+## SESSION END PROTOCOL
+
+**Before ending a significant session, write to today's daily:**
+
+```markdown
+## HH:MM [text]
+Session summary: [what was discussed/decided/created]
+- Key decision: [if any]
+- Created: [[link]] [if any files created]
+- Next action: [if any]
+```
+
+**Also update `vault/MEMORY.md` if:**
+- New key decision was made
+- User preference discovered
+- Important fact learned
+- Active context changed significantly
+
+**Update `vault/.session/handoff.md`:**
+- Last Session: what was done
+- Key Decisions: if any
+- In Progress: unfinished work
+- Next Steps: what to do next
+- Observations: friction signals, patterns, ideas (type: `[friction]`, `[pattern]`, `[idea]`)
+
+---
+
+## Mission
+
+Help user stay aligned with goals, capture valuable insights, and maintain clarity.
+
+## Directory Structure
+
+| Folder | Purpose |
+|--------|---------|
+| `daily/` | Raw daily entries (YYYY-MM-DD.md) |
+| `goals/` | Goal cascade (3y → yearly → monthly → weekly) |
+| `thoughts/` | Processed notes by category |
+| `MOC/` | Maps of Content indexes |
+| `attachments/` | Photos by date |
+| `business/` | Business data (CRM, network, events) |
+| `projects/` | Side projects (clients, leads) |
+
+## Business Context
+
+**Entry point:** `business/_index.md`
+
+```
+business/
+├── _index.md       ← Start here (stats, overview)
+├── crm/            ← Client records (companies + deals in one file)
+├── network/        ← Company structure, partners
+└── events/         ← Events, conferences
+```
+
+Search: `business/crm/{kebab-case}.md` (e.g. `acme-corp.md`, `client-b.md`)
+
+## Projects Context
+
+**Entry point:** `projects/_index.md`
+
+```
+projects/
+├── _index.md       ← Start here
+├── clients/        ← Project clients
+├── leads/          ← Leads
+└── projects/       ← Active projects
+```
+
+## Current Focus
+
+See [[goals/3-weekly]] for this week's ONE Big Thing.
+See [[goals/2-monthly]] for monthly priorities.
+
+## Goals Hierarchy
+
+```
+goals/0-vision-3y.md    → 3-year vision by life areas
+goals/1-yearly-YYYY.md  → Annual goals + quarterly breakdown
+goals/2-monthly.md      → Current month's top 3 priorities
+goals/3-weekly.md       → This week's focus + ONE Big Thing
+```
+
+## Entry Format
+
+```markdown
+## HH:MM [type]
+Content
+```
+
+Types: `[voice]`, `[text]`, `[forward from: Name]`, `[photo]`
+
+## Processing Workflow
+
+Run daily processing via `/process` command or automatically at 21:00.
+
+### 3-Phase Pipeline:
+1. **CAPTURE** — Read daily entries → classify → JSON
+2. **EXECUTE** — Create Todoist tasks, save thoughts, update CRM → JSON
+3. **REFLECT** — Generate HTML report, update MEMORY, record observations
+
+Each phase = fresh Claude context for better quality.
+
+## Card Template (agent-memory)
+
+**Skill:** `.claude/skills/agent-memory/SKILL.md`
+
+All new vault cards follow the agent-memory template:
+
+```yaml
+---
+type: crm|lead|contact|project|personal|note
+description: >-
+  One line — what a searcher will see in results
+tags: [tag1, tag2]        # 2-5 tags, lowercase
+status: active|draft|pending|done|inactive
+industry: FMCG            # for CRM/leads
+region: US                 # ISO codes
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+# Auto fields (don't edit manually):
+last_accessed: YYYY-MM-DD
+relevance: 0.85
+tier: active
+---
+```
+
+**Rules:**
+- `description` — REQUIRED. Write as a search snippet, NOT "contact" or "crm"
+- `tags` — REQUIRED. 2-5 tags, lowercase, hyphen-separated
+- `status` ≠ `tier`: status = business status, tier = memory (automatic)
+- One fact = one place (DRY). References via [[wikilinks]]
+- Decay engine: `uv run .claude/skills/agent-memory/scripts/memory-engine.py decay .`
+
+## Skills & References
+
+| Skill | Purpose |
+|-------|---------|
+| `dbrain-processor` | Main daily processing (3-phase pipeline) |
+| `graph-builder` | Vault link analysis and building |
+| `vault-health` | Health scoring, MOC generation, link repair |
+| `agent-memory` | Card template, decay engine, tiered search |
+| `todoist-ai` | Todoist task management via MCP |
+
+- **Processing:** `.claude/skills/dbrain-processor/SKILL.md`
+- **Graph Builder:** `.claude/skills/graph-builder/SKILL.md`
+- **Vault Health:** `.claude/skills/vault-health/SKILL.md`
+- **Agent Memory:** `.claude/skills/agent-memory/SKILL.md`
+- **Todoist:** `.claude/skills/todoist-ai/SKILL.md`
+- **Rules:** `.claude/rules/` (daily, thoughts, goals, obsidian-markdown, weekly-reflection)
+- **Docs:** `.claude/docs/`
+
+## Graph Builder
+
+**Purpose:** Analysis and maintenance of vault link structure.
+
+**Architecture:**
+1. `scripts/analyze.py` — deterministic vault traversal
+2. `scripts/add_links.py` — batch link addition
+3. Agent — semantic links for orphan files
+
+**Usage:**
+```bash
+# Analyze vault
+uv run vault/.claude/skills/graph-builder/scripts/analyze.py
+
+# Result
+vault/.graph/vault-graph.json  # JSON graph with stats
+vault/.graph/report.md         # Human-readable report
+```
+
+**Domains:**
+| Domain | Path | Hub |
+|--------|------|-----|
+| Personal | thoughts/, goals/, daily/ | MEMORY.md |
+| Business | business/crm/, business/network/ | business/_index.md |
+| Projects | projects/clients/, projects/leads/ | projects/_index.md |
+
+## Available Agents
+
+| Agent | Purpose |
+|-------|---------|
+| `weekly-digest` | Weekly review with goal progress |
+| `goal-aligner` | Check task-goal alignment |
+| `note-organizer` | Organize vault, fix links |
+| `inbox-processor` | GTD-style inbox processing |
+
+## Path-Specific Rules
+
+See `.claude/rules/` for format requirements:
+- `daily-format.md` — daily files format
+- `thoughts-format.md` — thought notes format
+- `goals-format.md` — goals format
+- `telegram-report.md` — HTML report format
+- `obsidian-markdown.md` — Obsidian syntax rules
+- `weekly-reflection.md` — weekly reflection template
+
+## Report Format
+
+Reports use Telegram HTML:
+- `bold` for headers
+- `italic` for metadata
+- Only allowed tags: b, i, code, pre, a
+
+## Quick Commands
+
+| Command | Action |
+|---------|--------|
+| `/process` | Run daily processing |
+| `/do` | Execute arbitrary request |
+| `/weekly` | Generate weekly digest |
+| `/align` | Check goal alignment |
+| `/organize` | Organize vault |
+| `/graph` | Analyze vault links |
+
+## Customization
+
+For personal overrides: create `CLAUDE.local.md`
+
+## Learnings (from experience)
+
+1. **Don't rewrite working code** without reason (KISS, DRY, YAGNI)
+2. **Don't add checks** that weren't there — let the agent decide
+3. **Don't propose solutions** without studying git log/diff first
+4. **Don't break architecture** (process.sh → Claude → skill is correct)
+5. **Problems are usually simple** (e.g., sed one-liner for HTML fix)
+
+---
+
+*System Version: 3.0*
diff --git a/vault/.claude/agents/goal-aligner.md b/vault/.claude/agents/goal-aligner.md
new file mode 100644
index 0000000..ef14461
--- /dev/null
+++ b/vault/.claude/agents/goal-aligner.md
@@ -0,0 +1,141 @@
+---
+name: goal-aligner
+description: Check alignment between tasks in Todoist and goals in vault. Find orphan tasks and stale goals.
+---
+
+# Goal Aligner Agent
+
+Ensures tasks and goals stay in sync.
+
+## When to Run
+
+- Weekly during digest
+- On demand via `/align` command
+- When too many unaligned tasks detected
+
+## Workflow
+
+### Step 1: Load All Goals
+
+```
+Read goals/0-vision-3y.md → Life areas
+Read goals/1-yearly-2025.md → Yearly goals
+Read goals/2-monthly.md → Monthly priorities
+Read goals/3-weekly.md → ONE Big Thing
+```
+
+Extract goal keywords for matching.
+
+### Step 2: Get All Active Tasks
+
+```
+mcp__todoist__find-tasks
+  responsibleUserFiltering: "all"
+  limit: 100
+```
+
+### Step 3: Analyze Alignment
+
+For each task:
+
+1. **Check description** for goal references
+2. **Match keywords** against goals
+3. **Classify:**
+   - ✅ Aligned — has goal reference
+   - 🔶 Possibly aligned — keyword match
+   - ❌ Orphan — no connection
+
+### Step 4: Find Stale Goals
+
+For each yearly goal:
+
+1. **Count recent activity:**
+   - Tasks completed in last 7 days
+   - Notes saved with goal tag
+   - Progress updates
+
+2. **Classify:**
+   - ✅ Active — activity in 7 days
+   - 🟡 Quiet — no activity 7-14 days
+   - 🔴 Stale — no activity 14+ days
+
+### Step 5: Generate Report
+
+Format: Telegram HTML
+
+```html
+🎯 Alignment Check
+
+📋 Задачи без связи с целями:
+{if orphan tasks:}
+• {task_name} — Предложение: {goal}
+{else:}
+✅ Все задачи связаны с целями
+
+🎯 Цели без активности:
+{if stale goals:}
+• 🔴 {goal} — {days} дней без активности
+• 🟡 {goal} — {days} дней без активности
+{else:}
+✅ Все цели активны
+
+📊 Распределение по целям:
+• {goal}: {N} активных задач
+• {goal}: {M} активных задач
+• Без цели: {K} задач
+
+💡 Рекомендации:
+{recommendations based on analysis}
+
+Действия:
+• Начать: {goal to focus on}
+• Остановить: {tasks not aligned}
+• Продолжить: {aligned work}
+```
+
+### Step 6: Suggest Fixes
+
+For orphan tasks, suggest:
+1. Which goal it might relate to
+2. Or mark as "operational"
+
+For stale goals:
+1. Suggest next action
+2. Or reconsider goal relevance
+
+## Alignment Scoring
+
+| Score | Meaning |
+|-------|---------|
+| 90-100% | Excellent alignment |
+| 70-89% | Good, minor gaps |
+| 50-69% | Needs attention |
+| <50% | Serious misalignment |
+
+```
+Score = (Aligned Tasks / Total Tasks) × 100
+```
+
+## Auto-Fix Options
+
+If enabled, agent can:
+
+1. **Add goal references** to task descriptions
+2. **Create follow-up tasks** for stale goals
+3. **Archive** completed goals
+
+## Start/Stop/Continue Framework
+
+Based on analysis, recommend:
+
+**Start:**
+- Goals with low activity that matter
+- New initiatives from stale areas
+
+**Stop:**
+- Tasks not aligned with any goal
+- Goals that no longer resonate
+
+**Continue:**
+- Well-aligned, progressing work
+- High-impact activities
diff --git a/vault/.claude/agents/inbox-processor.md b/vault/.claude/agents/inbox-processor.md
new file mode 100644
index 0000000..e3600cd
--- /dev/null
+++ b/vault/.claude/agents/inbox-processor.md
@@ -0,0 +1,171 @@
+---
+name: inbox-processor
+description: GTD-style processing of incoming entries. Decide action for each item - do now, schedule, delegate, save, or delete.
+---
+
+# Inbox Processor Agent
+
+Applies GTD methodology to process unhandled items.
+
+## When to Run
+
+- When daily file has many unprocessed entries
+- During weekly review
+- On demand via `/inbox` command
+
+## GTD Decision Tree
+
+For each entry, ask:
+
+```
+Is it actionable?
+├─ NO → Is it useful?
+│       ├─ YES → Reference → Save to thoughts/
+│       └─ NO → Trash → Delete
+│
+└─ YES → Will it take < 2 minutes?
+         ├─ YES → Do it now
+         └─ NO → Is it a single action?
+                 ├─ YES → Schedule in Todoist
+                 └─ NO → Create project
+```
+
+## Workflow
+
+### Step 1: Load Unprocessed Items
+
+```
+Read daily/{today}.md
+Find entries without "processed" marker
+```
+
+### Step 2: Classify Each Item
+
+Apply GTD decision tree:
+
+| Decision | Action |
+|----------|--------|
+| Do Now | Execute immediately, report done |
+| Schedule | Create task in Todoist |
+| Project | Create task + note in thoughts/projects/ |
+| Reference | Save to thoughts/{category}/ |
+| Waiting | Create task with "waiting" label |
+| Trash | Mark for deletion |
+
+### Step 3: Execute Actions
+
+**Do Now (<2 min):**
+- Simple lookups, quick replies
+- Report completion immediately
+
+**Schedule (single task):**
+```
+mcp__todoist__add-tasks
+  content: {task}
+  dueString: {date}
+  priority: {p1-p4}
+```
+
+**Project (multi-step):**
+1. Create parent task in Todoist
+2. Add subtasks for first steps
+3. Create note in thoughts/projects/
+4. Link task and note
+
+**Reference:**
+1. Classify: idea/learning/reflection
+2. Save to thoughts/{category}/
+3. Build links
+4. Update MOC
+
+**Waiting:**
+```
+mcp__todoist__add-tasks
+  content: "Waiting: {description}"
+  labels: ["waiting"]
+  dueString: "in 3 days"  # follow-up
+```
+
+**Trash:**
+- Mark entry with ~~strikethrough~~
+- Or move to archive section
+
+### Step 4: Mark as Processed
+
+Add marker to each entry:
+```markdown
+## 14:30 [voice] ✓
+Content...
+```
+
+Or add footer:
+```markdown
+---
+processed: 2024-12-20T21:00:00
+```
+
+### Step 5: Generate Report
+
+Format: Telegram HTML
+
+```html
+📥 Inbox Processing Complete
+
+📊 Обработано записей: {N}
+
+⚡ Сделано сразу: {quick_actions}
+• {action 1}
+• {action 2}
+
+📅 Запланировано: {scheduled}
+• {task} ({date})
+
+🎯 Создано проектов: {projects}
+• {project_name}
+
+📓 Сохранено: {saved}
+• {note} → {category}/
+
+⏳ Ожидание: {waiting}
+• {item}
+
+🗑️ Удалено: {deleted}
+
+📭 Inbox теперь: {remaining} items
+{if remaining == 0: ✨ Inbox Zero!}
+```
+
+## Quick Actions
+
+Things that can be "Done Now":
+- Simple web searches
+- Quick calculations
+- Short answers to questions
+- File organization
+- Quick message replies
+
+## Project Indicators
+
+Entry needs project if:
+- Multiple steps mentioned
+- "Need to research"
+- "Then... after that..."
+- Timeline spans days/weeks
+- Multiple people involved
+
+## Reference Categories
+
+| Keywords | Category |
+|----------|----------|
+| "интересная идея", "что если" | idea |
+| "узнал", "оказывается", "TIL" | learning |
+| "понял", "осознал", "урок" | reflection |
+| "проект", "задумка", "план" | project |
+
+## Inbox Zero Philosophy
+
+Goal is not just empty inbox, but:
+- Every item has a home
+- Decisions are made, not deferred
+- Nothing falls through cracks
+- Mind is clear for focus work
diff --git a/vault/.claude/agents/note-organizer.md b/vault/.claude/agents/note-organizer.md
new file mode 100644
index 0000000..d0467b1
--- /dev/null
+++ b/vault/.claude/agents/note-organizer.md
@@ -0,0 +1,158 @@
+---
+name: note-organizer
+description: Organize vault, find orphan notes, suggest connections, update MOC indexes, consolidate duplicates.
+---
+
+# Note Organizer Agent
+
+Keeps the vault organized and connected.
+
+## When to Run
+
+- Weekly maintenance
+- When vault grows cluttered
+- On demand via `/organize` command
+
+## Workflow
+
+### Step 1: Scan Vault
+
+```
+Glob thoughts/**/*.md
+Glob daily/**/*.md
+Glob goals/**/*.md
+```
+
+Build index of all notes with:
+- File path
+- Title
+- Tags
+- Links (outgoing)
+- Frontmatter
+
+### Step 2: Find Orphan Notes
+
+A note is orphan if:
+- No incoming links from other notes
+- Not listed in any MOC
+- Has no related notes in frontmatter
+
+```
+For each note in thoughts/:
+  Check if any other note links to it
+  Check if listed in MOC/
+  If neither → mark as orphan
+```
+
+### Step 3: Suggest Connections
+
+For each orphan note:
+
+1. **Extract keywords** from title and content
+2. **Search for related notes** using keywords
+3. **Check goals** for topic overlap
+4. **Suggest links** ranked by relevance
+
+### Step 4: Find Duplicates
+
+Look for similar notes:
+
+1. **Title similarity** — fuzzy match
+2. **Content overlap** — key phrases
+3. **Same topic** — tag match
+
+Flag potential duplicates for review.
+
+### Step 5: Update MOC Indexes
+
+For each MOC file:
+
+1. **List all notes** in corresponding category
+2. **Group by topic** or date
+3. **Add missing entries**
+4. **Remove dead links**
+
+MOC structure:
+```markdown
+# MOC: Ideas
+
+## Recent
+- [[2024-12-20-new-idea]] — Brief description
+
+## By Topic
+### AI & Voice
+- [[voice-agents-architecture]]
+- [[chatterbox-tts]]
+
+### Productivity
+- [[daily-routine-optimization]]
+```
+
+### Step 6: Generate Report
+
+Format: Telegram HTML
+
+```html
+🗂️ Vault Organization Report
+
+📊 Статистика:
+• Всего заметок: {N}
+• В thoughts/: {M}
+• В daily/: {K}
+
+🔗 Связность:
+• Связанных: {connected}%
+• Изолированных: {orphans}
+
+📭 Orphan Notes:
+{for each orphan:}
+• {note_title}
+  → Предложение: [[{suggested_link}]]
+
+🔄 Возможные дубликаты:
+{for each duplicate pair:}
+• {note1} ≈ {note2}
+
+📑 MOC Updates:
+• {moc_name}: +{added} / -{removed}
+
+💡 Рекомендации:
+{actionable suggestions}
+```
+
+### Step 7: Optional Auto-Fix
+
+If enabled:
+
+1. **Add backlinks** to orphan notes
+2. **Update MOC** with new entries
+3. **Merge duplicates** (with confirmation)
+
+## Connection Quality Score
+
+```
+Score = (Notes with 2+ links / Total Notes) × 100
+```
+
+| Score | Quality |
+|-------|---------|
+| 80%+ | Excellent |
+| 60-79% | Good |
+| 40-59% | Needs work |
+| <40% | Fragmented |
+
+## MOC Categories
+
+| MOC | Covers |
+|-----|--------|
+| MOC-ideas.md | thoughts/ideas/ |
+| MOC-learnings.md | thoughts/learnings/ |
+| MOC-projects.md | thoughts/projects/ |
+| MOC-reflections.md | thoughts/reflections/ |
+
+## Link Discovery Strategies
+
+1. **Topic match** — same tags or keywords
+2. **Temporal proximity** — notes from same period
+3. **Goal alignment** — notes under same goal
+4. **Reference chain** — A links to B, B links to C → suggest A↔C
diff --git a/vault/.claude/agents/weekly-digest.md b/vault/.claude/agents/weekly-digest.md
new file mode 100644
index 0000000..702f7e7
--- /dev/null
+++ b/vault/.claude/agents/weekly-digest.md
@@ -0,0 +1,138 @@
+---
+name: weekly-digest
+description: Generate weekly digest with goal progress, wins, challenges, and next week planning. Run on Sundays.
+---
+
+# Weekly Digest Agent
+
+Analyzes the past week and generates comprehensive digest report.
+
+## When to Run
+
+- Every Sunday evening
+- On demand via `/weekly` command
+
+## Workflow
+
+### Step 1: Collect Week Data
+
+1. **Read all daily files for the week:**
+   ```
+   daily/YYYY-MM-DD.md (7 files)
+   ```
+
+2. **Get completed tasks from Todoist:**
+   ```
+   mcp__todoist__find-completed-tasks
+     since: {monday}
+     until: {sunday}
+   ```
+
+3. **Get current goals:**
+   ```
+   Read goals/1-yearly-2025.md
+   Read goals/2-monthly.md
+   Read goals/3-weekly.md
+   ```
+
+### Step 2: Analyze Progress
+
+Calculate for each yearly goal:
+- Tasks completed related to goal
+- Notes saved related to goal
+- Progress delta (this week vs last week)
+
+### Step 3: Identify Wins & Challenges
+
+**Wins:**
+- Completed tasks marked as important
+- Goals with progress increase
+- Streak maintained (habits)
+
+**Challenges:**
+- Overdue tasks
+- Goals without activity
+- Incomplete ONE Big Thing
+
+### Step 4: Plan Next Week
+
+1. **Update weekly focus:**
+   - Suggest new ONE Big Thing
+   - Based on goal alignment
+
+2. **Recommend priorities:**
+   - Top 3 tasks for next week
+   - Based on goals + overdue
+
+### Step 5: Generate Report
+
+Format: Telegram HTML
+
+```html
+📅 Недельный дайджест: {WEEK}
+
+🎯 ONE Big Thing на прошлой неделе:
+{status: ✅ Выполнено | ❌ Не выполнено | 🟡 Частично}
+{description}
+
+🏆 Победы недели:
+• {win 1}
+• {win 2}
+• {win 3}
+
+⚔️ Вызовы:
+• {challenge 1}
+• {challenge 2}
+
+📊 Статистика:
+• Задач выполнено: {N}
+• Заметок сохранено: {M}
+• Голосовых сообщений: {K}
+
+📈 Прогресс по целям:
+• {goal}: {old}% → {new}% {delta_emoji}
+• {goal}: {old}% → {new}% {delta_emoji}
+
+⚠️ Требует внимания:
+• {stale goals or overdue items}
+
+🎯 ONE Big Thing на следующую неделю:
+{suggested ONE thing}
+
+⚡ Топ-3 приоритета:
+1. {task}
+2. {task}
+3. {task}
+
+---
+Неделя {week_number} завершена
+```
+
+## Progress Delta Emojis
+
+| Change | Emoji |
+|--------|-------|
+| +10% or more | 🚀 |
+| +1% to +9% | 📈 |
+| No change | ➡️ |
+| -1% to -9% | 📉 |
+| -10% or more | 🔻 |
+
+## Update Files
+
+After generating digest:
+
+1. **Archive current weekly:**
+   ```
+   Rename goals/3-weekly.md → goals/archive/3-weekly-{WEEK}.md
+   ```
+
+2. **Create new weekly:**
+   ```
+   Create goals/3-weekly.md with new ONE Big Thing
+   ```
+
+3. **Update monthly if needed:**
+   ```
+   Update progress in goals/2-monthly.md
+   ```
diff --git a/vault/.claude/docs/notebooklm-quick-start.md b/vault/.claude/docs/notebooklm-quick-start.md
new file mode 100644
index 0000000..932c9f8
--- /dev/null
+++ b/vault/.claude/docs/notebooklm-quick-start.md
@@ -0,0 +1,280 @@
+---
+type: note
+title: NotebookLM MCP CLI - Quick Start
+---
+# NotebookLM MCP CLI - Quick Start
+
+> **Установлено:** 1 февраля 2026
+> **Версия:** 0.2.10
+> **GitHub:** https://github.com/jacob-bd/notebooklm-mcp-cli
+
+---
+
+## Зачем нужен NotebookLM
+
+**Для обработки больших массивов данных:**
+- Клиентские исследования и анализ
+- Подготовка презентаций и брифингов
+- Генерация подкастов из документации
+- Создание обучающих материалов (флэшкарты, майндмэпы)
+- Анализ конкурентов
+
+---
+
+## 🚀 Быстрый старт
+
+### 1. Установка
+
+```bash
+uv tool install notebooklm-mcp-cli
+```
+
+**Установлены компоненты:**
+- `nlm` — CLI команда
+- `notebooklm-mcp` — MCP сервер (уже в конфиге)
+- `notebooklm-mcp-auth` — аутентификация
+
+### 2. Аутентификация
+
+```bash
+notebooklm-mcp-auth --file
+```
+
+**Инструкция:**
+1. Открой Chrome → https://notebooklm.google.com
+2. Открой DevTools (Cmd+Option+I)
+3. Вкладка **Network** → фильтр: `batchexecute`
+4. Кликни на любой ноутбук (появится запрос)
+5. Найди **Request Headers** → строку `cookie:`
+6. Скопируй значение (правый клик → Copy value)
+7. Создай файл `~/cookies.txt` и вставь туда
+8. Запусти: `notebooklm-mcp-auth --file ~/cookies.txt`
+
+**Проверка:**
+```bash
+nlm list notebook
+```
+
+---
+
+## 📚 Основные команды
+
+### Управление ноутбуками
+
+```bash
+# Список всех ноутбуков
+nlm list notebook
+
+# Создать ноутбук
+nlm create notebook "Название"
+
+# Детали ноутбука
+nlm get notebook "Название"
+
+# Удалить ноутбук
+nlm delete notebook "Название"
+
+# Переименовать
+nlm rename notebook "Старое" --new-name "Новое"
+```
+
+### Добавление источников
+
+```bash
+# URL
+nlm add source --url https://example.com --notebook "My Research"
+
+# YouTube видео
+nlm add source --youtube https://youtube.com/watch?v=VIDEO_ID --notebook "My Research"
+
+# Текст
+nlm add source --text "Ваш текст здесь" --notebook "My Research"
+
+# Google Drive файл
+nlm add source --drive-file "FILE_ID" --notebook "My Research"
+
+# Список источников
+nlm list source --notebook "My Research"
+```
+
+### Запросы и анализ
+
+```bash
+# Задать вопрос к ноутбуку
+nlm query "В чём основные инсайты?" --notebook "My Research"
+
+# Получить описание
+nlm describe notebook "My Research"
+
+# Получить raw контент из источника
+nlm content source "SOURCE_ID"
+```
+
+### Генерация контента
+
+```bash
+# Audio overview (подкаст)
+nlm audio create --notebook "My Research"
+
+# Video overview
+nlm video create --notebook "My Research"
+
+# Slides (презентация)
+nlm slides create --notebook "My Research"
+
+# Mind map
+nlm mindmap create --notebook "My Research"
+
+# Infographic
+nlm infographic create --notebook "My Research"
+
+# Flashcards
+nlm flashcards create --notebook "My Research"
+
+# Briefing document
+nlm report create --notebook "My Research"
+
+# Quiz
+nlm quiz create --notebook "My Research"
+```
+
+### Синхронизация
+
+```bash
+# Синхронизировать Google Drive источники
+nlm sync --notebook "My Research"
+
+# Список устаревших источников
+nlm stale --notebook "My Research"
+```
+
+### Шеринг
+
+```bash
+# Сделать ноутбук публичным
+nlm share notebook "My Research" --public
+
+# Поделиться с конкретным пользователем
+nlm share notebook "My Research" --email user@example.com
+```
+
+---
+
+## 🔧 Использование через MCP
+
+### Через mcp-cli (рекомендуется)
+
+```bash
+# Список инструментов
+mcp-cli info notebooklm
+
+# Создать ноутбук
+mcp-cli call notebooklm create_notebook '{"title": "Research"}'
+
+# Добавить источник
+mcp-cli call notebooklm add_source '{
+  "notebook_id": "...",
+  "url": "https://example.com"
+}'
+
+# Запрос
+mcp-cli call notebooklm query '{
+  "notebook_id": "...",
+  "query": "What are the main points?"
+}'
+
+# Генерация подкаста
+mcp-cli call notebooklm create_audio '{
+  "notebook_id": "..."
+}'
+```
+
+### Из Claude Code
+
+```markdown
+Используй NotebookLM для анализа этих статей:
+- https://example.com/article1
+- https://example.com/article2
+
+Создай ноутбук "Competitor Analysis" и сгенерируй:
+1. Briefing document
+2. Mind map
+3. Audio overview (подкаст)
+```
+
+---
+
+## 💡 Use Cases
+
+### 1. Client Research
+
+```bash
+nlm create notebook "Client Research: Acme Campaign"
+nlm add source --url https://competitor1.com --notebook "Client Research: Acme Campaign"
+nlm add source --url https://competitor2.com --notebook "Client Research: Acme Campaign"
+nlm query "What patterns in mechanics?" --notebook "Client Research: Acme Campaign"
+nlm slides create --notebook "Client Research: Acme Campaign"
+nlm report create --notebook "Client Research: Acme Campaign"
+```
+
+### 2. Training Materials
+
+```bash
+nlm create notebook "AI Training Materials"
+nlm add source --url https://docs.anthropic.com --notebook "AI Training Materials"
+nlm add source --youtube https://youtube.com/watch?v=... --notebook "AI Training Materials"
+nlm flashcards create --notebook "AI Training Materials"
+nlm mindmap create --notebook "AI Training Materials"
+nlm quiz create --notebook "AI Training Materials"
+```
+
+### 3. Content Generation
+
+```bash
+nlm create notebook "Content Ideas"
+nlm add source --url https://research-article.com --notebook "Content Ideas"
+nlm audio create --notebook "Content Ideas"  # Podcast
+nlm infographic create --notebook "Content Ideas"  # Infographic
+```
+
+---
+
+## ⚠️ Важно
+
+- **Cookie-based auth** — токены хранятся локально, обновляются автоматически
+- **Undocumented API** — может сломаться после обновлений Google
+- **Personal use** — не для продакшена, только эксперименты
+- **Rate limits** — Google может ограничить при частых запросах
+
+---
+
+## 📝 Профили
+
+Если нужно несколько Google аккаунтов:
+
+```bash
+# Аутентификация с профилем
+nlm login --profile work
+nlm login --profile personal
+
+# Переключение
+nlm login switch work
+
+# Список профилей
+nlm login profile list
+
+# Использование конкретного профиля
+nlm list notebook --profile work
+```
+
+---
+
+## 🔗 Ссылки
+
+- **GitHub:** https://github.com/jacob-bd/notebooklm-mcp-cli
+- **MEMORY.md:** `vault/MEMORY.md` — секция "NotebookLM"
+- **MCP Config:** `~/.config/mcp/mcp_servers.json`
+
+---
+
+*Created: 2026-02-01*
diff --git a/vault/.claude/rules/daily-format.md b/vault/.claude/rules/daily-format.md
new file mode 100644
index 0000000..dd091bf
--- /dev/null
+++ b/vault/.claude/rules/daily-format.md
@@ -0,0 +1,72 @@
+---
+paths: "daily/**/*.md"
+---
+
+# Daily Notes Format
+
+Rules for daily capture files in `daily/` folder.
+
+## File Naming
+
+- Format: `YYYY-MM-DD.md`
+- Example: `2024-12-20.md`
+- One file per day
+
+## Entry Format
+
+Each entry follows this structure:
+
+```markdown
+## HH:MM [type]
+Content of the entry
+```
+
+### Entry Types
+
+| Type | Description |
+|------|-------------|
+| `[voice]` | Transcribed voice message |
+| `[text]` | Direct text message |
+| `[forward from: Name]` | Forwarded message with source |
+| `[photo]` | Image with embed |
+
+### Photo Entries
+
+Photos include Obsidian embed:
+
+```markdown
+## 14:30 [photo]
+![[attachments/2024-12-20/img-143025.jpg]]
+
+Optional description or transcribed text from photo
+```
+
+## Processing Rules
+
+When processing daily files:
+
+1. **Read chronologically** — entries are timestamped
+2. **Classify each entry** — task, idea, reflection, learning, project
+3. **Check for photos** — analyze with vision if present
+4. **Extract actionable items** — create tasks in Todoist
+5. **Save valuable thoughts** — move to `thoughts/` categories
+6. **Mark as processed** — after successful processing
+
+## Do NOT
+
+- Modify original entries
+- Delete entries before archiving
+- Change timestamps
+- Add content between entries
+
+## After Processing
+
+Add processing marker at end of file:
+
+```markdown
+---
+processed: 2024-12-20T21:00:00
+thoughts: 3
+tasks: 2
+---
+```
diff --git a/vault/.claude/rules/goals-format.md b/vault/.claude/rules/goals-format.md
new file mode 100644
index 0000000..e754abb
--- /dev/null
+++ b/vault/.claude/rules/goals-format.md
@@ -0,0 +1,103 @@
+---
+paths: "goals/**/*.md"
+---
+
+# Goals Format
+
+Rules for goal files in `goals/` folder.
+
+## File Structure
+
+```
+goals/
+├── 0-vision-3y.md   # 3-year vision by life areas
+├── 1-yearly-2025.md # Annual goals with quarterly breakdown
+├── 2-monthly.md     # Current month priorities
+└── 3-weekly.md      # This week's focus + ONE Big Thing
+```
+
+## Hierarchy Principle
+
+Goals cascade from long-term to daily:
+
+```
+3-Year Vision (life direction)
+    → Yearly Goals (annual objectives)
+        → Monthly Focus (current priorities)
+            → Weekly Plan (this week's actions)
+                → Daily Tasks (today in Todoist)
+```
+
+## Required Frontmatter
+
+```yaml
+---
+type: vision | yearly | monthly | weekly
+period: 2025 | 2024-12 | 2024-W51
+updated: YYYY-MM-DD
+---
+```
+
+## Progress Tracking
+
+Use consistent progress format:
+
+| Symbol | Meaning |
+|--------|---------|
+| 🔴 | 0-25% — Not started |
+| 🟡 | 26-50% — In progress |
+| 🟢 | 51-75% — Good progress |
+| ✅ | 76-100% — Complete |
+
+Example:
+```markdown
+| Goal | Progress | Status |
+|------|----------|--------|
+| Ship MVP | 65% | 🟢 |
+| Fitness routine | 30% | 🟡 |
+```
+
+## ONE Big Thing
+
+Weekly file MUST contain ONE Big Thing:
+
+```markdown
+## ONE Big Thing
+
+> **If I accomplish nothing else, I will:**
+> [Single most important outcome]
+```
+
+This is read by dbrain-processor for context.
+
+## Goal Limits
+
+- **Yearly:** Max 3 goals per life area
+- **Monthly:** Max 3 top priorities
+- **Weekly:** ONE Big Thing + 3 Must Do tasks
+
+## Linking Goals to Tasks
+
+When creating tasks, reference goals:
+
+```markdown
+- [ ] [Task] — Связь: [[1-yearly-2025#Career]]
+```
+
+## Stale Goal Warning
+
+Goals without activity for 7+ days trigger warning in report.
+
+Track "last touched" via:
+- Task completion in Todoist
+- Note saved related to goal
+- Progress % update
+
+## Review Cadence
+
+| Level | Review Frequency |
+|-------|------------------|
+| Vision | Quarterly |
+| Yearly | Monthly |
+| Monthly | Weekly |
+| Weekly | Daily |
diff --git a/vault/.claude/rules/obsidian-markdown.md b/vault/.claude/rules/obsidian-markdown.md
new file mode 100644
index 0000000..2be7374
--- /dev/null
+++ b/vault/.claude/rules/obsidian-markdown.md
@@ -0,0 +1,154 @@
+---
+type: note
+title: Obsidian Markdown Rules
+---
+# Obsidian Markdown Rules
+
+Rules for writing valid Obsidian Flavored Markdown in vault files.
+Source: adapted from kepano/obsidian-skills (MIT).
+
+## Wiki-Links
+
+```markdown
+[[Note Name]]                    Basic link
+[[Note Name|Display Text]]       Link with alias
+[[Note Name#Heading]]            Link to heading
+[[#Heading in same note]]        Same-note heading link
+[[Note Name#^block-id]]          Link to block
+```
+
+### Block References
+
+Add `^block-id` at end of any paragraph to make it linkable:
+
+```markdown
+This paragraph can be linked to. ^my-block
+
+> Quote block content
+^quote-id
+```
+
+Then link with `[[Note#^my-block]]`.
+
+## Embeds
+
+```markdown
+![[Note Name]]                   Embed full note
+![[Note Name#Heading]]           Embed section
+![[image.png]]                   Embed image
+![[image.png|300]]               Image with width
+![[image.png|640x480]]           Image with dimensions
+![[document.pdf#page=3]]         PDF page
+```
+
+## Callouts
+
+```markdown
+> [!note]
+> Basic note callout.
+
+> [!warning] Custom Title
+> Warning with title.
+
+> [!tip]- Collapsed by default
+> Foldable content.
+```
+
+### Types we should use in vault:
+
+| Type | When to use |
+|------|-------------|
+| `[!warning]` | Blockers, risks, urgent items |
+| `[!info]` | Context, background info |
+| `[!tip]` | Recommendations, best practices |
+| `[!todo]` | Action items |
+| `[!success]` | Wins, completed milestones |
+| `[!question]` | Open questions |
+| `[!example]` | Examples, templates |
+
+## Tables with Wiki-Links
+
+Escape pipes inside wiki-links in tables:
+
+```markdown
+| Client | Link |
+|--------|------|
+| Client | [[business/crm/acme-corp\|Acme Corp]] |
+```
+
+## Comments
+
+Obsidian-native comments (hidden in reading view):
+
+```markdown
+%%This is hidden in reading view%%
+
+%%
+Multi-line hidden block.
+Only visible in edit mode.
+%%
+```
+
+Use `%%` for Obsidian, `` for HTML-compatible comments.
+Our processing markers (``) stay as HTML comments since they're parsed by scripts.
+
+## Tags
+
+Valid tag characters:
+- Letters (any language), numbers, `_`, `-`, `/`
+- Numbers cannot be first character
+- `/` creates nested tags: `#business/client`
+
+```markdown
+#tag #nested/tag #tag-with-dashes
+
+# In frontmatter:
+tags:
+  - tag1
+  - nested/tag2
+```
+
+## Properties (Frontmatter)
+
+### Types
+
+| Type | Example |
+|------|---------|
+| Text | `title: My Title` |
+| Number | `rating: 4.5` |
+| Checkbox | `completed: true` |
+| Date | `date: 2024-01-15` |
+| Date+Time | `due: 2024-01-15T14:30:00` |
+| List | `tags: [one, two]` |
+| Links | `related: "[[Other Note]]"` |
+
+### Default properties (special meaning in Obsidian)
+
+- `tags` — searchable tags
+- `aliases` — alternative names (found via search/link autocomplete)
+- `cssclasses` — custom CSS classes
+
+## Escaping
+
+```markdown
+\*not italic\*
+\#not heading
+1\. not a list
+```
+
+## Footnotes
+
+```markdown
+Text with footnote[^1].
+
+[^1]: Footnote content.
+
+Inline footnote^[content here].
+```
+
+## Do NOT
+
+- Use `%%` comments for processing markers (keep `` for scripts)
+- Use block references (`^id`) in daily notes (too granular)
+- Add `aliases` to CRM files (use wiki-link aliases instead)
+- Use Mermaid/LaTeX unless specifically needed
diff --git a/vault/.claude/rules/telegram-report.md b/vault/.claude/rules/telegram-report.md
new file mode 100644
index 0000000..153aae1
--- /dev/null
+++ b/vault/.claude/rules/telegram-report.md
@@ -0,0 +1,136 @@
+---
+paths: "**/REPORT*.md"
+---
+
+# Telegram Report Formatting
+
+Rules for generating HTML reports for Telegram.
+
+## CRITICAL: Output Format
+
+**Return RAW HTML only. No markdown wrappers.**
+
+WRONG:
+```html
+Title
+```
+
+CORRECT:
+Title
+
+The output goes directly to Telegram `parse_mode=HTML`. Any markdown syntax will break parsing.
+
+## Allowed Tags
+
+- `` or `` — bold (section headers)
+- `` or `` — italic (metadata, clarifications)
+- `` — inline code (commands, paths)
+- `
` — code blocks (rarely needed)
+- ``, ``, `` — strikethrough
+- `` — underline
+- `text` — links
+
+## FORBIDDEN
+
+- Markdown syntax: `**`, `##`, `-`, `*`, backticks
+- Markdown code blocks: triple backticks
+- Tables (not supported by Telegram)
+- Unsupported tags: `
`, ``, `
`, `

`, `` +- Unescaped `<` and `>` in text (use `<` `>`) +- Nested same tags: `text` + +## Report Template + +📊 Обработка за {DATE} + +🎯 Текущий фокус: +{ONE_BIG_THING from goals/3-weekly.md} + +📓 Сохранено мыслей: {N} +• {emoji} {title} → {category}/ + +✅ Создано задач: {M} +• {task_name} ({priority}, {due_date}) + +📅 Загрузка на неделю: +Пн: {n} | Вт: {n} | Ср: {n} | Чт: {n} | Пт: {n} | Сб: {n} | Вс: {n} + +⚠️ Требует внимания: +• {count} просроченных задач +• Цель "{goal}" без активности {days} дней + +🔗 Новые связи: +• [[Note A]] ↔ [[Note B]] + +⚡ Топ-3 приоритета на завтра: +1. {task} ({goal link if exists}) +2. {task} +3. {task} + +📈 Прогресс по целям: +• {goal}: {progress}% {status_emoji} + +--- +Обработано за {time} + +## Section Emojis + +📊 Title +🎯 Focus +📓 Thoughts saved +✅ Tasks created +📅 Week load +⚠️ Attention needed +🔗 New links +⚡ Priorities +📈 Goal progress + +## Category Emojis (Thoughts) + +💡 idea +🪞 reflection +🎯 project +📚 learning + +## Priority Format + +p1 → (p1, urgent) +p2 → (p2, {date}) +p3 → (p3, {date}) +p4 → (no priority) + +## Progress Emojis + +🔴 0-25% +🟡 26-50% +🟢 51-75% +✅ 76-100% + +## Error Report + +❌ Ошибка обработки + +Причина: {error_message} + +Файл:{file_path} + +Попробуйте /process снова или проверьте логи + +## Empty Report + +📭 Нет записей для обработки + +Файл daily/{date}.md пуст или не найден. + +Добавьте голосовые сообщения или текст в течение дня + +## Validation Rules + +Before sending report: +1. All tags are properly closed +2. No raw < or > in text +3. No markdown syntax anywhere +4. No tables +5. Total length under 4096 characters + +If over 4096 chars, truncate "Новые связи" section first. diff --git a/vault/.claude/rules/thoughts-format.md b/vault/.claude/rules/thoughts-format.md new file mode 100644 index 0000000..f620354 --- /dev/null +++ b/vault/.claude/rules/thoughts-format.md @@ -0,0 +1,109 @@ +--- +paths: "thoughts/**/*.md" +--- + +# Thoughts Format + +Rules for notes in `thoughts/` folder and its subfolders. + +## Folder Structure + +``` +thoughts/ +├── ideas/ # Creative ideas, concepts +├── reflections/ # Personal reflections, lessons +├── projects/ # Project-related notes +└── learnings/ # Knowledge, discoveries +``` + +## File Naming + +- Format: `YYYY-MM-DD-slug.md` +- Slug: lowercase, hyphens, descriptive +- Example: `2024-12-20-voice-agent-architecture.md` + +## Frontmatter (Required) + +```yaml +--- +date: 2024-12-20 +type: idea | reflection | project | learning +tags: [relevant, tags] +source: daily/2024-12-20.md +related: [] +--- +``` + +## Content Structure + +```markdown +# Title + +## Summary +One paragraph summary of the key insight. + +## Details +Full content of the thought. + +## Action Items +- [ ] Any tasks that emerged +- [ ] Follow-up actions + +## Related +- [[Link to related note]] +- [[goals/1-yearly-2025#Section]] +``` + +## Tags Convention + +Use hierarchical tags: + +``` +#type/idea +#type/learning +#topic/ai +#topic/productivity +#project/d-brain +#status/active +``` + +## Wiki-Links + +When saving a thought: + +1. **Search for related notes** in thoughts/ +2. **Check MOC indexes** for topic clusters +3. **Link to relevant goals** in goals/ +4. **Add backlinks** to source daily note + +Example: +```markdown +Extracted from [[daily/2024-12-20]]. +Related to [[Voice Agents]] and [[goals/1-yearly-2025#AI Development]]. +``` + +## Category Guidelines + +### ideas/ +- Novel concepts, inventions +- Business ideas +- Creative solutions +- "What if..." thoughts + +### reflections/ +- Personal insights +- Lessons learned +- Emotional processing +- Gratitude, wins + +### projects/ +- Project-specific notes +- Meeting notes +- Status updates +- Decisions made + +### learnings/ +- New knowledge +- Book/article insights +- Technical discoveries +- "TIL" moments diff --git a/vault/.claude/rules/weekly-reflection.md b/vault/.claude/rules/weekly-reflection.md new file mode 100644 index 0000000..f46100b --- /dev/null +++ b/vault/.claude/rules/weekly-reflection.md @@ -0,0 +1,82 @@ +--- +type: note +paths: "thoughts/reflections/YYYY-W*" +--- + +# Weekly Reflection Format + +Rules for weekly system reflections (triggered on Sundays or by `/weekly`). + +## Purpose + +Analyze accumulated observations → find patterns → propose improvements. +This is the **operational learning loop** — the system learns from its own friction. + +## When to Generate + +- Every Sunday (automatically or via `/weekly`) +- When observations in `.session/handoff.md` reach ≥10 + +## File Location + +`thoughts/reflections/YYYY-WNN-system-reflection.md` + +## Template + +```markdown +--- +date: YYYY-MM-DD +type: reflection +description: "Week NN system analysis: N friction signals, M patterns found, K proposals" +tags: [system, reflection, weekly] +source: .session/handoff.md +related: [] +--- + +# Week NN System Reflection + +## Friction Patterns + +- **mcp-cli timeouts:** N occurrences — [root cause hypothesis] +- **Empty daily files:** N of 7 days — [pattern: weekends?] +- **Broken links:** N new this week — [source: CRM imports?] + +## Improvements Applied + +- [fix] Description of what was improved +- [fix] Another improvement + +## Proposals + +1. [proposal] Description — target file: `path/to/file` +2. [proposal] Another proposal — target: `scripts/process.sh` + +## Graph Health +Score: NN/100 (↑/↓ N vs last week) +- Orphans: N (was M) +- Broken links: N (was M) +- Avg links/file: X.XX +- Description coverage: Y% + +## Observations Cleared + +Moved N observations to this reflection file. +``` + +## Process + +1. Read `.session/handoff.md` → collect `## Observations` +2. Read `.graph/health-history.json` → get this week's trend +3. Group observations by type (friction/pattern/idea) +4. Find recurring patterns (same issue >2 times) +5. Propose concrete improvements (file + change) +6. Write reflection file +7. Clear processed observations from handoff.md (keep unprocessed) +8. Add reflection to daily log + +## Tags + +Use `#system` tag for all system reflections. +Cross-reference with: +- `[[MEMORY.md]]` — if proposals become decisions +- `[[goals/3-weekly]]` — if proposals affect weekly focus diff --git a/vault/.claude/skills/agent-memory/SKILL.md b/vault/.claude/skills/agent-memory/SKILL.md new file mode 100644 index 0000000..9fc2973 --- /dev/null +++ b/vault/.claude/skills/agent-memory/SKILL.md @@ -0,0 +1,206 @@ +--- +type: note +description: >- +last_accessed: 2026-02-26 +relevance: 1.0 +tier: active +name: agent-memory +Use when: (1) setting up memory for a new agent, (2) diagnosing memory bloat or context +Triggers: "memory management", "organize vault", "memory decay", "forgetting curve", +--- + +# Agent Memory Management + +Memory system with automatic decay, tiered search, and creative recall. +Works with any directory of markdown files. + +## Quick Start + +### 1. Scan existing files +```bash +python3 scripts/memory-engine.py scan +``` +Reports: file count, YAML coverage, size, recommendations. + +### 2. Bootstrap YAML frontmatter +```bash +python3 scripts/memory-engine.py init [--dry-run] +``` +Adds `relevance`, `last_accessed`, `tier` to files missing frontmatter. +Infers `type` from directory path. Infers dates from YAML fields, git log, or file mtime. + +### 3. Run decay +```bash +python3 scripts/memory-engine.py decay [--dry-run] +``` +Updates all cards: recalculates relevance scores and reassigns tiers. +Schedule daily via cron for automatic forgetting. + +### 4. Touch on read +```bash +python3 scripts/memory-engine.py touch +``` +Resets card to active (relevance=1.0). Call this when reading a card to answer a question. + +### 5. Creative recall +```bash +python3 scripts/memory-engine.py creative +``` +Random sample from cold/archive tiers. Read these cards and look for unexpected connections. + +### 6. Health check +```bash +python3 scripts/memory-engine.py stats +``` +Shows tier distribution, context budget, stale card count. + +## Core Concepts + +### Three-Layer Architecture + +| Layer | What | Size Target | Loaded | +|-------|------|-------------|--------| +| Hot context | State file (volatile focus, blockers) | <4KB | Every turn | +| Searchable vault | Cards with YAML, one per entity | Unlimited | On demand | +| Archive | Old logs, completed work | Unlimited | Deep/creative only | + +**Rule:** Each fact lives in ONE place. If it's in a card, don't also put it in the state file. +See [references/architecture.md](references/architecture.md) for full design rationale. + +### Forgetting Curve + +Cards have `relevance: 0.0-1.0` that decays linearly over time: +- Day 0: 1.0 (just accessed) +- Day 7: 0.90 → tier: active +- Day 21: 0.69 → tier: warm +- Day 33: 0.50 → tier: cold +- Day 60+: 0.10 (floor) → tier: archive + +`core` tier is manual-only — for identity, security, pricing. Never auto-demoted. + +### Tier-Aware Search + +| Mode | Tiers searched | When | +|------|---------------|------| +| heartbeat | core + active | Quick checks, monitoring | +| normal | active + warm | Most questions | +| deep | all tiers | Strategy, OSINT, complex analysis | +| creative | random cold+archive | Brainstorming, ideation | + +See [references/search-protocols.md](references/search-protocols.md) for detailed protocols. + +### YAML Frontmatter + +Minimum required fields (managed by engine): +```yaml +--- +relevance: 0.85 +last_accessed: 2026-02-25 +tier: active +--- +``` + +See [references/yaml-schema.md](references/yaml-schema.md) for full schema with domain-specific fields. + +## Daily Files (Episodic Memory) + +Daily files (`memory/YYYY-MM-DD.md`) are the agent's episodic memory — what happened each day. +They follow the same decay system as vault cards. **Never delete them.** + +### Lifecycle + +``` +Day 0: Created (end of day cron or manual) → tier: active, relevance: 1.0 +Day 1-7: Auto-loaded at session start (today+yesterday) → tier: active +Day 8-21: Searchable but not auto-loaded → tier: warm +Day 22-60: Deep search only → tier: cold +Day 60+: Creative mode or explicit recall → tier: archive +``` + +### YAML Frontmatter for Daily Files + +Add to each daily file (engine handles this via `init` or `decay`): +```yaml +--- +type: daily +date: 2026-02-18 +relevance: 0.76 +last_accessed: 2026-02-18 +tier: warm +--- +``` + +### Session Loading Protocol + +At session start, load only active-tier daily files: +``` +1. Read today's daily file (if exists) +2. Read yesterday's daily file (if exists) +3. Stop. Don't load older files. +``` + +For questions about the past ("what happened last week?"), search warm/cold tier dailies on demand. + +### Why Never Delete + +1. **Disk cost ≈ zero.** 30 daily files ≈ 300KB. Irrelevant savings. +2. **Context is lost forever.** A knowledge graph captures entities but not reasoning, tone, or "why." +3. **Semantic search works on old files.** A query about "Red Bull tender" finds the relevant daily file regardless of age. +4. **Creative mode surfaces old context.** Forgotten daily entries become unexpected inspiration. +5. **Re-reading from source (Telegram, email) is expensive.** 100+ messages per day × API calls × LLM summarization > keeping a 10KB file. + +### Compression (Optional) + +If daily files grow large (>20KB), compress old ones instead of deleting: +1. Extract key decisions, contacts, and outcomes into vault cards +2. Trim the daily file to a 20-line summary +3. Keep the summary with its YAML frontmatter intact + +This preserves searchability while reducing storage. But even without compression, a year of daily files is ~4MB — negligible. + +## Configuration + +Generate default config: +```bash +python3 scripts/memory-engine.py config +``` + +Creates `.memory-config.json`: +```json +{ + "tiers": {"active": 7, "warm": 21, "cold": 60}, + "decay_rate": 0.015, + "relevance_floor": 0.1, + "skip_patterns": ["_index.md"], + "type_inference": {"crm/": "crm", "leads/": "lead"}, + "use_git_dates": true +} +``` + +Adjust tier thresholds and decay rate to match your domain's natural rhythm. +Fast-moving domains (sales): tighter thresholds (active=3, warm=10, cold=30). +Slow domains (research): wider thresholds (active=14, warm=45, cold=120). + +## Cron Integration + +Add decay to daily maintenance (OpenClaw example): +```json +{ + "name": "memory-decay", + "schedule": {"kind": "cron", "expr": "0 22 * * *", "tz": "UTC"}, + "payload": {"kind": "agentTurn", "message": "Run: python3 scripts/memory-engine.py decay vault/crm/"} +} +``` + +## Anti-Patterns + +| Don't | Do Instead | +|-------|------------| +| Load all contacts into state file | Keep them in vault cards, search on demand | +| Create "knowledge graph" that duplicates vault | Vault IS the graph. Use index files for navigation | +| Store same fact in 3 files | One card per entity, reference via links | +| Delete old daily files to "save space" | Keep all dailies, let tier decay handle visibility | +| Auto-load all daily files at session start | Load only today + yesterday; search older on demand | +| Search all 500 cards for every question | Check index first, filter by tier, then search | +| Touch every card during bulk operations | Only touch on meaningful read/update | +| Build elaborate review systems | Let decay handle it — if you don't use it, it fades | diff --git a/vault/.claude/skills/agent-memory/references/architecture.md b/vault/.claude/skills/agent-memory/references/architecture.md new file mode 100644 index 0000000..c5125ab --- /dev/null +++ b/vault/.claude/skills/agent-memory/references/architecture.md @@ -0,0 +1,198 @@ +--- +type: note +title: Memory Architecture +last_accessed: 2026-02-26 +relevance: 1.0 +tier: active +--- +# Memory Architecture + +## The Problem + +AI agents forget everything between sessions. Common solutions (dump everything into context, vector-search everything) create bloat and noise. Human memory works differently: it has layers, it decays, and it surprises you with random connections. + +## Design Principles + +### Single Source of Truth (DRY) +Each fact lives in ONE place. If a contact exists in a CRM card, don't also list them in a "key contacts" section of your state file. Instead, reference them: `see vault/crm/alice.md`. + +**Violation test:** Search for any person/project name. If it appears in 3+ files with substantive detail, you have a DRY violation. + +### Context is a Shared Resource (KISS) +Every byte loaded per turn costs tokens. An agent loading 40KB of context files is burning ~10,000 tokens before the conversation starts. Measure your context budget: +- State file (volatile): target <4KB +- Config files: target <15KB total +- Per-turn overhead = sum of all always-loaded files + +### Build Only What You Use (YAGNI) +Don't create "knowledge graphs," "daily digests," or "weekly reviews" unless you actively query them. If a cron job generates a report nobody reads, it's waste. + +## Three-Layer Architecture + +``` +Layer 1: HOT CONTEXT (always loaded, <4KB) + └── State file — volatile: active focus, blockers, reminders + NOT: contacts, history, reference, tools + +Layer 2: SEARCHABLE VAULT (on-demand, unlimited) + └── Cards with YAML frontmatter — one file per entity + Searched via: semantic search, grep, graph traversal + Organized by: domain directories + index files (MOC) + +Layer 3: ARCHIVE (deep search only) + └── Old daily logs, completed projects, cold contacts + Still searchable but excluded from default queries +``` + +### Layer 1: Hot Context + +This is what's loaded every turn. Must be ruthlessly slim. + +**Include:** Current week's focus, active blockers, 3-5 pending items, security rules, navigation hints. + +**Exclude:** Contact lists (use vault), tool docs (separate file), event history (daily files), anything searchable. + +**Audit:** If your state file exceeds 80 lines, something belongs in Layer 2. + +### Layer 2: Searchable Vault + +One markdown file per entity (person, project, company, idea). YAML frontmatter enables filtering and automation. + +**Directory structure:** +``` +vault/ +├── crm/ # contacts and companies +│ ├── clients/ +│ ├── leads/ +│ └── personal/ +├── projects/ # active and past projects +├── MOC/ # Maps of Content (index files) +└── .graph/ # computed graph data +``` + +**Why one file per entity:** Enables granular decay, individual relevance scoring, and precise search results. A single "contacts.md" with 200 entries can't decay — the whole file is either loaded or not. + +### Layer 2b: Daily Files (Episodic Memory) + +Daily logs (`memory/YYYY-MM-DD.md`) sit between vault and archive. They capture the raw narrative of each day — conversations, decisions, reasoning, context that doesn't fit neatly into entity cards. + +**Never delete daily files.** The decay system handles visibility: +- Active (0-7 days): loaded at session start +- Warm (8-21 days): searchable, not auto-loaded +- Cold (22-60 days): deep search only +- Archive (60+): creative mode, explicit queries + +**Why keep everything:** +- Disk: 365 daily files ≈ 4MB. Irrelevant cost. +- Context: knowledge graphs capture entities but lose reasoning and tone. +- Search: semantic search finds old dailies just as well as new ones. +- Source rebuild: re-reading 100+ Telegram messages is far more expensive than keeping a 10KB summary. + +**Compression:** If a daily file exceeds 20KB, extract key facts into vault cards and trim the daily to a 20-line summary. Keep the YAML frontmatter intact. + +### Layer 3: Archive + +One-off analysis reports. Completed project retrospectives. Generated artifacts that served a temporary purpose. These are still searchable but excluded from default queries. Daily files are NOT archive — they stay in `memory/` with tier-based visibility. + +## Forgetting Curve + +Inspired by Ebbinghaus (1885): memory strength decays over time without reinforcement. + +### Relevance Score + +Each card has `relevance: 0.0-1.0` in its frontmatter. Decays linearly: + +``` +relevance = max(floor, 1.0 - days_since_access × rate) + +Default: rate=0.015, floor=0.1 +→ After 7 days: 0.90 +→ After 21 days: 0.69 +→ After 33 days: 0.50 +→ After 60 days: 0.10 (floor) +``` + +### Tier Assignment + +Based on days since `last_accessed`: + +| Tier | Days | Description | +|------|------|-------------| +| core | manual | Never auto-assigned. Identity, security, pricing. | +| active | 0-7 | Hot context. Searched in all modes. | +| warm | 8-21 | Default search radius. Gradually fading. | +| cold | 22-60 | Deep search only. Mostly forgotten. | +| archive | 60+ | Creative mode or explicit recall only. | + +### Touch Protocol + +When an agent reads or references a card, it should reset the card: +```bash +python3 memory-engine.py touch +``` +This sets `last_accessed` to today, `relevance` to 1.0, and `tier` to active. + +**When to touch:** +- Agent reads card content to answer a question +- Agent updates card with new information +- User explicitly mentions the entity + +**When NOT to touch:** +- Card appears in search results but isn't opened +- Automated scan (decay script itself) +- Bulk operations + +## Search Protocols + +Different tasks need different search depths: + +### Heartbeat Mode (fast checks) +Search: core + active only. +Use for: quick status checks, routine monitoring, simple questions. +Cost: minimal — only hot cards in scope. + +### Normal Mode (default) +Search: core + active + warm. +Use for: most questions, task execution, lookups. +Cost: moderate — includes fading but recent cards. + +### Deep Mode (complex tasks) +Search: all tiers. +Use for: strategy, OSINT, complex analysis, "find everything about X." +Cost: high — full vault scan. + +### Creative Mode (divergent thinking) +Method: random sample from cold + archive tiers. +Use for: brainstorming, finding unexpected connections, "what if" scenarios. +Not semantic search — deliberately random to surface forgotten associations. + +```bash +python3 memory-engine.py creative 5 vault/ +``` + +## Multi-Agent Shared Memory + +When multiple agents share a vault: + +1. **Shared YAML schema** — all agents use same frontmatter fields +2. **Each agent touches on read** — keeps decay accurate across agents +3. **One vault, one truth** — don't fork the vault per agent +4. **Conflict resolution** — last write wins for metadata; append-only for history sections + +## Context Budget Calculator + +Measure your actual per-turn cost: + +``` +Always-loaded files: + STATE.md _____ bytes + CONFIG.md _____ bytes + IDENTITY.md _____ bytes + RULES.md _____ bytes + ───────────────────────── + Total context: _____ bytes ÷ 4 ≈ _____ tokens + +Target: <25KB (6,000 tokens) for always-loaded context +``` + +Every 1KB saved = ~250 tokens freed per turn for actual conversation. diff --git a/vault/.claude/skills/agent-memory/references/search-protocols.md b/vault/.claude/skills/agent-memory/references/search-protocols.md new file mode 100644 index 0000000..95eef61 --- /dev/null +++ b/vault/.claude/skills/agent-memory/references/search-protocols.md @@ -0,0 +1,125 @@ +--- +type: note +title: Search Protocols +last_accessed: 2026-02-26 +relevance: 1.0 +tier: active +--- +# Search Protocols + +## Protocol Selection + +Before searching, classify the task: + +| Signal | Mode | Search Radius | +|--------|------|---------------| +| Quick status check, monitoring | heartbeat | core + active | +| Normal question, lookup | normal | active + warm | +| "Find everything about X" | deep | all tiers | +| Strategy, OSINT, complex analysis | deep | all tiers | +| Brainstorm, "what if", ideation | creative | random from cold+archive | + +## Search Order (All Modes) + +1. **Index files first** — MOC or `_index.md` files are pre-built navigation. Check them before searching. +2. **Follow links** — If an index points to `[[crm/acme]]`, read the card directly. Don't search for "Acme." +3. **Semantic search** — Only when indexes don't cover the query. +4. **Grep** — Last resort for exact strings, IDs, phone numbers. + +## Tier Filtering + +### Pre-filter with grep +```bash +# Find all active cards +grep -rl "^tier: active" vault/crm/ + +# Find all cold+ cards for deep search +grep -rl "^tier: \(cold\|archive\)" vault/crm/ + +# Find high-relevance cards +grep -l "^relevance: 0\.9" vault/crm/ +``` + +### Combine with semantic search +1. Grep for tier → get file list +2. Read relevant files → answer question + +This is cheaper than searching all 400+ cards semantically. + +## Heartbeat Protocol + +Heartbeats are frequent, automated checks. Minimize cost: + +1. Read state file (always loaded) +2. Check only `core` + `active` tier cards matching current projects +3. Skip warm/cold/archive entirely +4. Total reads: 0-5 files per heartbeat + +## Normal Protocol + +Default for user questions: + +1. Check index/MOC for direct link +2. If not found: semantic search with default radius (active + warm) +3. Read top 3-5 results +4. Touch any card you read: `memory-engine.py touch ` + +## Deep Protocol + +For complex, multi-step analysis: + +1. Check indexes +2. Semantic search across ALL tiers (no filtering) +3. Read all relevant results (up to 10-15 files) +4. Cross-reference cards for connections +5. Touch all read cards + +## Creative Protocol + +Deliberately non-directed. Goal: surface unexpected connections. + +```bash +python3 memory-engine.py creative 5 vault/ +``` + +1. Get 5 random cards from cold/archive +2. Read each one +3. For each card, ask: "How could this connect to my current task?" +4. If a connection exists → touch the card (promotes it back to active) +5. If no connection → leave it (continues to decay) + +### When to use creative mode +- Stuck on a problem +- Looking for new business angles +- User says "brainstorm" or "what if" +- Exploring forgotten knowledge +- Weekly reflection sessions + +### What makes it work +Human creativity often comes from random associations — shower thoughts, dreams, serendipitous encounters. Creative mode simulates this by pulling forgotten cards back into working memory. The randomness is the feature, not a bug. + +## Touch Discipline + +Touching a card resets its decay. Over-touching defeats the purpose. + +**Touch when:** +- You read the card's content to answer a question +- You update the card with new information +- User explicitly discusses the entity + +**Don't touch when:** +- Card appears in search results but you didn't open it +- Running automated scans or reports +- Bulk migration or formatting changes +- Card mentioned in passing but not substantively used + +## Cost Awareness + +| Mode | Typical reads | Token cost | +|------|---------------|------------| +| Heartbeat | 0-5 files | ~2K tokens | +| Normal | 3-8 files | ~5K tokens | +| Deep | 10-20 files | ~15K tokens | +| Creative | 5 files | ~3K tokens | + +Optimize by reading index files first — they're cheap navigation that prevents expensive full-text searches. diff --git a/vault/.claude/skills/agent-memory/references/yaml-schema.md b/vault/.claude/skills/agent-memory/references/yaml-schema.md new file mode 100644 index 0000000..0efab89 --- /dev/null +++ b/vault/.claude/skills/agent-memory/references/yaml-schema.md @@ -0,0 +1,189 @@ +--- +type: note +title: YAML Frontmatter Schema +last_accessed: 2026-02-26 +relevance: 1.0 +tier: active +--- +# YAML Frontmatter Schema + +## Canonical Schema (all card types) + +Every card MUST have this structure. Fields marked (auto) are managed by memory-engine.py. +Fields marked (required) must be written by the agent when creating a card. + +```yaml +--- +# ── identity ── +type: crm # (required) crm | lead | contact | project | personal | daily | note +description: >- # (required) One-line summary. What is this card about? + Key client in [industry], active deal $XXK, [project description] + +# ── classification ── +tags: [fmcg, active-deal, uz] # (required) 2-5 freeform tags for grep filtering +status: active # (required) universal: active|draft|pending|done|inactive; CRM-only: prospect|negotiation|won|lost +industry: FMCG # (optional) For CRM/leads +region: UZ # (optional) ISO country codes +source: referral # (optional) How this entity entered the system +priority: High # (optional) High | Medium | Low + +# ── ownership ── +owner: [Your Name] # (optional) Who owns this relationship +responsible: [Your Name] # (optional) Who is doing the work + +# ── dates ── +created: 2026-01-15 # (recommended) When card was first created +updated: 2026-02-20 # (recommended) When content was last meaningfully changed + +# ── deal tracking ── +deal_status: negotiation # (optional) For active deals +deal_deadline: 2026-03-15 # (optional) Deal close date + +# ── memory system (auto) ── +last_accessed: 2026-02-25 # (auto) When card was last read/touched +relevance: 0.85 # (auto) 0.0-1.0, decays over time +tier: active # (auto) core | active | warm | cold | archive +--- +``` + +## Required Fields Explained + +### `description` (string, one line) +The single most important field for search quality. Write a concise summary that answers: +"If someone searches for this entity, what should they see in results?" + +Good: `"Event Specialist, [Company] [Country], tender 2026"` +Bad: `"контакт"` (too vague) +Bad: (empty — defeats the purpose of the entire system) + +### `tags` (list, 2-5 items) +Cross-cutting labels for fast grep filtering. Use lowercase, hyphens. +```yaml +tags: [hot-lead, ai-training, enterprise, follow-up] +``` +Search: `grep -rl "hot-lead" vault/crm/` + +### `type` (enum) +| Type | When | +|------|------| +| crm | Existing client/company | +| lead | Potential client | +| contact | Person (not a lead/client) | +| project | Active or past project | +| personal | Family, friends | +| daily | Daily log file | +| note | Everything else | + +### `status` (enum, normalized) +Domain-specific lifecycle. NOT the same as `tier` (which is memory-system lifecycle). + +**Universal (all card types):** + +| Status | Meaning | +|--------|---------| +| `active` | Currently relevant, in use, engaged | +| `draft` | Work in progress, not finalized | +| `pending` | Waiting for external input or decision | +| `done` | Completed, kept for reference | +| `inactive` | Was active, went quiet or outdated | + +**CRM-specific (only for type: crm, lead, crm-lead, client):** + +| Status | Meaning | +|--------|---------| +| `prospect` | Identified lead, no deep engagement yet | +| `negotiation` | Proposal/KP sent, in talks | +| `won` | Deal closed positively | +| `lost` | Rejected, didn't pursue, conflict | + +**ONLY these 9 values.** No Russian, no mixed case, no free-text. + +Typical lifecycle by type: +- **crm/lead:** prospect → active → negotiation → won/lost +- **project:** draft → active → done +- **contact:** active → inactive +- **note/knowledge:** draft → active → inactive (outdated) +- **personal:** active → inactive +- **daily:** no status needed (has `date` field) + +When in doubt: CRM → `prospect`, everything else → `active`. + +## Memory System Fields (auto-managed) + +### `relevance` (float, 0.0-1.0) +Computed by decay engine. Do not manually edit unless marking as `core`. +- 1.0 = just accessed +- 0.5 = ~33 days old +- 0.1 = floor (60+ days) + +### `tier` (enum) +Computed by decay engine based on `last_accessed`. +- `core` — only manually assigned, never auto-demoted. Use for: identity, security rules, pricing. +- `active` — 0-7 days since access. Searched in all modes. +- `warm` — 8-21 days. Searched in normal+ modes. +- `cold` — 22-60 days. Deep search only. +- `archive` — 60+ days. Creative mode or explicit queries. + +### `last_accessed` (ISO date) +Updated by `touch` command (graduated: +1 tier per touch). + +## Agent Protocol for New Cards + +When creating ANY new card: +1. ALWAYS include: `type`, `description`, `tags`, `status` +2. Write `description` as if it's a search result snippet — concise, informative +3. Add 2-5 `tags` that cross-cut directory structure +4. Run `memory-engine.py touch ` after creation +5. The engine will auto-add `relevance`, `last_accessed`, `tier` on next decay run + +## Field Semantics + +### `relevance` (float, 0.0-1.0) +Computed by decay engine. Do not manually edit unless marking as `core`. +- 1.0 = just accessed +- 0.5 = ~33 days old +- 0.1 = floor (60+ days) + +### `tier` (enum) +Computed by decay engine based on `last_accessed`. +- `core` — only manually assigned, never auto-demoted. Use for: identity, security rules, pricing, critical reference. +- `active` — 0-7 days since access. Searched in all modes. +- `warm` — 8-21 days. Searched in normal+ modes. +- `cold` — 22-60 days. Deep search only. +- `archive` — 60+ days. Creative mode or explicit queries. + +### `last_accessed` (ISO date) +Updated by `touch` command when agent reads the card. Also updated by decay engine on first run (inferred from `updated`, `created`, git log, or file mtime). + +### `type` (string) +Auto-inferred from directory path if not present. Configurable via `type_inference` in `.memory-config.json`. + +### `tags` (list) +Freeform. Useful for cross-cutting concerns that don't fit directory structure. +```yaml +tags: [hot-lead, ai-training, enterprise, follow-up] +``` +Search: `grep -rl "hot-lead" vault/crm/` + +## Configuration + +Type inference mapping in `.memory-config.json`: +```json +{ + "type_inference": { + "crm/clients/": "crm", + "crm/leads/": "lead", + "crm/personal/": "personal", + "projects/": "project" + } +} +``` + +When `memory-engine.py init` encounters a file without `type`, it checks the file path against these patterns. + +## Frontmatter Tips + +1. **Don't duplicate content.** If the H1 heading says "# Acme Corp", you don't need `title: Acme Corp` — the engine infers it. +2. **Tags > nested directories.** A flat `crm/` with tags is more flexible than `crm/hot/enterprise/ai/`. +3. **Status is domain-specific.** The memory system uses `tier` for lifecycle; `status` is for your business logic (active/won/lost/churned). +4. **`updated` vs `last_accessed`**: `updated` = when content changed; `last_accessed` = when anyone read it. Both matter for decay; the engine uses whichever is most recent. diff --git a/vault/.claude/skills/agent-memory/scripts/memory-engine.py b/vault/.claude/skills/agent-memory/scripts/memory-engine.py new file mode 100644 index 0000000..6251022 --- /dev/null +++ b/vault/.claude/skills/agent-memory/scripts/memory-engine.py @@ -0,0 +1,645 @@ +#!/usr/bin/env python3 +""" +memory-engine.py — Universal memory management for AI agents. + +Implements Ebbinghaus-inspired forgetting curve with tiered recall. +Works with any directory of markdown files. + +Commands: + scan [dir] Analyze files, report stats (no changes) + init [dir] Add YAML frontmatter to files missing it + decay [dir] Update relevance scores and tiers + touch Reset file to active (on read/use) + creative [dir] Random N cards from cold/archive tiers + stats [dir] Show tier distribution and health metrics + +Options: + --config Config JSON (default: .memory-config.json in target dir) + --dry-run Preview changes without writing + --verbose Show per-file details + +Config (.memory-config.json): +{ + "tiers": { + "active": 7, // days threshold + "warm": 21, + "cold": 60 + // beyond cold = archive + }, + "decay_rate": 0.015, // relevance loss per day (linear) + "relevance_floor": 0.1, // minimum relevance + "skip_patterns": ["_index.md", "MOC-*"], + "type_inference": { + "crm/": "crm", + "leads/": "lead", + "personal/": "personal" + }, + "use_git_dates": true +} +""" + +import os +import re +import sys +import json +import random +import subprocess +from datetime import datetime, date +from pathlib import Path +from typing import Optional + +# ─── defaults ─────────────────────────────────────────────────── + +DEFAULT_CONFIG = { + "tiers": {"active": 7, "warm": 21, "cold": 60}, + "decay_rate": 0.015, + "relevance_floor": 0.1, + "skip_patterns": ["_index.md"], + "type_inference": {}, + "use_git_dates": True, +} + +TODAY = date.today() + +# ─── YAML frontmatter parsing ────────────────────────────────── + +def parse_frontmatter(content: str) -> tuple[dict, str, bool]: + """Parse YAML frontmatter. Returns (fields, body, had_yaml).""" + if content.startswith("---\n"): + end = content.find("\n---\n", 4) + if end != -1: + yaml_block = content[4:end] + body = content[end + 5:] + fields = {} + for line in yaml_block.split("\n"): + if ":" in line: + key, _, val = line.partition(":") + fields[key.strip()] = val.strip() + return fields, body, True + return {}, content, False + + +def build_frontmatter(fields: dict, field_order: list[str] | None = None) -> str: + """Build YAML frontmatter from dict, preserving field order.""" + if field_order is None: + field_order = [ + "type", "title", "description", "tags", + "industry", "source", "priority", "status", "region", + "owner", "responsible", "domain", "related", "client", + "deal_status", "deal_deadline", "deadline", + "created", "updated", "last_accessed", "relevance", "tier", + ] + lines = [] + used = set() + for key in field_order: + if key in fields: + lines.append(f"{key}: {fields[key]}") + used.add(key) + for key, val in fields.items(): + if key not in used: + lines.append(f"{key}: {val}") + return "---\n" + "\n".join(lines) + "\n---\n" + + +# ─── date resolution ─────────────────────────────────────────── + +def get_git_date(filepath: Path) -> date | None: + """Last git commit date for file.""" + try: + result = subprocess.run( + ["git", "log", "-1", "--format=%aI", "--", str(filepath)], + capture_output=True, text=True, + cwd=filepath.parent, timeout=5, + ) + if result.returncode == 0 and result.stdout.strip(): + return date.fromisoformat(result.stdout.strip()[:10]) + except Exception: + pass + return None + + +def get_best_date(fields: dict, filepath: Path, use_git: bool = True) -> date: + """Most recent date from YAML fields, git history, or file mtime.""" + candidates = [] + for field in ["last_accessed", "updated", "created"]: + val = fields.get(field, "") + try: + candidates.append(date.fromisoformat(val[:10])) + except (ValueError, IndexError): + continue + if use_git: + git_date = get_git_date(filepath) + if git_date: + candidates.append(git_date) + if not candidates: + mtime = os.path.getmtime(filepath) + candidates.append(date.fromtimestamp(mtime)) + return max(candidates) + + +# ─── core logic ───────────────────────────────────────────────── + +def calc_relevance(days: int, rate: float, floor: float) -> float: + """Linear decay with floor.""" + return round(max(floor, 1.0 - days * rate), 2) + + +def calc_tier(days: int, tiers: dict, current_tier: str = "") -> str: + """Assign tier based on days since last access.""" + if current_tier == "core": + return "core" # never auto-demote core + sorted_tiers = sorted(tiers.items(), key=lambda x: x[1]) + for tier_name, threshold in sorted_tiers: + if days <= threshold: + return tier_name + return "archive" + + +def infer_type(filepath: Path, type_map: dict) -> str: + """Infer card type from path using configurable mapping.""" + path_str = str(filepath) + for pattern, card_type in type_map.items(): + if pattern in path_str: + return card_type + return "note" + + +def should_skip(filepath: Path, patterns: list[str]) -> bool: + """Check if file matches skip patterns.""" + import fnmatch + name = filepath.name + for pattern in patterns: + if fnmatch.fnmatch(name, pattern): + return True + return False + + +def infer_title(body: str) -> str: + """Extract title from first H1 heading.""" + for line in body.split("\n")[:10]: + if line.startswith("# "): + return line[2:].strip() + return "" + + +# ─── config ───────────────────────────────────────────────────── + +def load_config(target_dir: Path, config_path: str | None = None) -> dict: + """Load config from file or return defaults.""" + if config_path: + p = Path(config_path) + else: + p = target_dir / ".memory-config.json" + if p.exists(): + with open(p) as f: + user = json.load(f) + # Merge with defaults + config = {**DEFAULT_CONFIG, **user} + config["tiers"] = {**DEFAULT_CONFIG["tiers"], **user.get("tiers", {})} + return config + return DEFAULT_CONFIG.copy() + + +def save_default_config(target_dir: Path): + """Write default config file.""" + p = target_dir / ".memory-config.json" + with open(p, "w") as f: + json.dump(DEFAULT_CONFIG, f, indent=2) + print(f" wrote default config: {p}") + + +# ─── commands ─────────────────────────────────────────────────── + +def find_cards(target_dir: Path, config: dict) -> list[Path]: + """Find all markdown files, respecting skip patterns.""" + cards = sorted(target_dir.rglob("*.md")) + return [c for c in cards if c.exists() and not c.is_symlink() and not should_skip(c, config["skip_patterns"])] + + +def cmd_scan(target_dir: Path, config: dict, verbose: bool = False): + """Analyze files without changes.""" + cards = find_cards(target_dir, config) + with_yaml = 0 + without_yaml = 0 + has_relevance = 0 + has_tier = 0 + total_bytes = 0 + + for card in cards: + content = card.read_text(encoding="utf-8", errors="replace") + total_bytes += len(content.encode("utf-8")) + fields, body, had_yaml = parse_frontmatter(content) + if had_yaml: + with_yaml += 1 + else: + without_yaml += 1 + if "relevance" in fields: + has_relevance += 1 + if "tier" in fields: + has_tier += 1 + if verbose and not had_yaml: + print(f" no yaml: {card.relative_to(target_dir)}") + + print(f"\n scan results for {target_dir}:") + print(f" total files: {len(cards)}") + print(f" with yaml: {with_yaml}") + print(f" without yaml: {without_yaml}") + print(f" has relevance: {has_relevance}") + print(f" has tier: {has_tier}") + print(f" total size: {total_bytes / 1024:.0f} KB") + print(f" avg file size: {total_bytes / max(len(cards), 1) / 1024:.1f} KB") + + if without_yaml: + print(f"\n → run 'init' to add YAML frontmatter to {without_yaml} files") + if not has_relevance: + print(f" → run 'decay' to add relevance scores and tiers") + + +def cmd_init(target_dir: Path, config: dict, dry_run: bool = False, verbose: bool = False): + """Add YAML frontmatter to files missing it.""" + cards = find_cards(target_dir, config) + added = 0 + + for card in cards: + content = card.read_text(encoding="utf-8", errors="replace") + fields, body, had_yaml = parse_frontmatter(content) + if had_yaml: + continue + + # Create minimal frontmatter + new_fields = { + "type": infer_type(card, config["type_inference"]), + } + title = infer_title(body) + if title: + new_fields["title"] = title + + ref_date = get_best_date({}, card, config["use_git_dates"]) + new_fields["last_accessed"] = ref_date.isoformat() + days = max(0, (TODAY - ref_date).days) + new_fields["relevance"] = str(calc_relevance(days, config["decay_rate"], config["relevance_floor"])) + new_fields["tier"] = calc_tier(days, config["tiers"]) + + new_content = build_frontmatter(new_fields) + body + if not dry_run: + card.write_text(new_content, encoding="utf-8") + added += 1 + if verbose: + print(f" {'[dry] ' if dry_run else ''}init: {card.relative_to(target_dir)} → {new_fields['tier']}") + + print(f"\n {'DRY RUN — ' if dry_run else ''}init results:") + print(f" files processed: {len(cards)}") + print(f" frontmatter added: {added}") + + +def cmd_decay(target_dir: Path, config: dict, dry_run: bool = False, verbose: bool = False): + """Update relevance and tiers based on time decay.""" + cards = find_cards(target_dir, config) + results = [] + + for card in cards: + content = card.read_text(encoding="utf-8", errors="replace") + fields, body, had_yaml = parse_frontmatter(content) + + ref_date = get_best_date(fields, card, config["use_git_dates"]) + days = max(0, (TODAY - ref_date).days) + + old_tier = fields.get("tier", "") + new_relevance = calc_relevance(days, config["decay_rate"], config["relevance_floor"]) + new_tier = calc_tier(days, config["tiers"], old_tier) + + if "last_accessed" not in fields: + fields["last_accessed"] = ref_date.isoformat() + if "type" not in fields: + fields["type"] = infer_type(card, config["type_inference"]) + + fields["relevance"] = str(new_relevance) + fields["tier"] = new_tier + + new_content = build_frontmatter(fields) + body + changed = new_content != content + + if changed and not dry_run: + card.write_text(new_content, encoding="utf-8") + + results.append({ + "path": str(card.relative_to(target_dir)), + "days": days, + "relevance": new_relevance, + "tier": new_tier, + "changed": changed, + }) + + if verbose and changed: + print(f" {'[dry] ' if dry_run else ''}{card.relative_to(target_dir)}: {old_tier or '?'}→{new_tier} r={new_relevance}") + + # Stats + tiers = {} + changed_count = sum(1 for r in results if r["changed"]) + for r in results: + tiers[r["tier"]] = tiers.get(r["tier"], 0) + 1 + avg_rel = sum(r["relevance"] for r in results) / max(len(results), 1) + + print(f"\n {'DRY RUN — ' if dry_run else ''}decay results:") + print(f" total: {len(results)}, changed: {changed_count}") + print(f" avg relevance: {avg_rel:.2f}") + for tier in ["core", "active", "warm", "cold", "archive"]: + count = tiers.get(tier, 0) + bar = "█" * (count // 3) + if count: + print(f" {tier:8s}: {count:4d} {bar}") + + +def cmd_touch(filepath: str, config: dict): + """Promote a file one tier up (graduated recall). + + archive → cold → warm → active → active (refresh) + Each touch promotes one level, not straight to top. + Natural spaced repetition: multiple reads = stronger memory. + """ + p = Path(filepath) + if not p.exists(): + print(f" error: {filepath} not found") + sys.exit(1) + + content = p.read_text(encoding="utf-8", errors="replace") + fields, body, had_yaml = parse_frontmatter(content) + + if fields.get("tier") == "core": + fields["last_accessed"] = TODAY.isoformat() + fields["relevance"] = "1.0" + new_content = build_frontmatter(fields) + body + p.write_text(new_content, encoding="utf-8") + print(f" touched: {filepath} → core (refreshed)") + return + + tiers_cfg = config["tiers"] + # Promotion targets: set last_accessed to midpoint of next-higher tier + # archive → cold: midpoint of cold range + # cold → warm: midpoint of warm range + # warm → active: midpoint of active range + # active → active: today (refresh) + cold_threshold = tiers_cfg.get("cold", 60) + warm_threshold = tiers_cfg.get("warm", 21) + active_threshold = tiers_cfg.get("active", 7) + + current_tier = fields.get("tier", "archive") + if current_tier == "archive": + # Promote to cold: set last_accessed to midpoint of cold range + target_days = (warm_threshold + cold_threshold) // 2 + new_tier = "cold" + elif current_tier == "cold": + # Promote to warm: midpoint of warm range + target_days = (active_threshold + warm_threshold) // 2 + new_tier = "warm" + elif current_tier == "warm": + # Promote to active: midpoint of active range + target_days = active_threshold // 2 + new_tier = "active" + else: + # Already active: refresh to today + target_days = 0 + new_tier = "active" + + from datetime import timedelta + new_date = TODAY - timedelta(days=target_days) + new_relevance = calc_relevance(target_days, config["decay_rate"], config["relevance_floor"]) + + fields["last_accessed"] = new_date.isoformat() + fields["relevance"] = str(new_relevance) + fields["tier"] = new_tier + + new_content = build_frontmatter(fields) + body + p.write_text(new_content, encoding="utf-8") + print(f" touched: {filepath} → {current_tier}→{new_tier}, relevance={new_relevance}") + + +def cmd_creative(n: int, target_dir: Path, config: dict): + """Random sample from cold/archive tiers for divergent thinking.""" + cards = find_cards(target_dir, config) + cold_cards = [] + + for card in cards: + content = card.read_text(encoding="utf-8", errors="replace") + fields, body, had_yaml = parse_frontmatter(content) + tier = fields.get("tier", "") + if tier in ("cold", "archive", "warm"): + title = fields.get("title", "") or infer_title(body) + cold_cards.append({ + "path": str(card.relative_to(target_dir)), + "tier": tier, + "relevance": fields.get("relevance", "?"), + "title": title, + "last_accessed": fields.get("last_accessed", "?"), + }) + + if not cold_cards: + print(" no cold/archive cards found — memory is too fresh") + return + + sample = random.sample(cold_cards, min(n, len(cold_cards))) + print(f"\n 🎲 creative recall — {len(sample)} random cards:") + for card in sample: + print(f" [{card['tier']}] {card['title'] or card['path']}") + print(f" {card['path']} (r={card['relevance']}, last={card['last_accessed']})") + print(f"\n read these cards and look for unexpected connections to your current task") + + +def cmd_daily(target_dir: Path, config: dict, dry_run: bool = False, verbose: bool = False): + """Bootstrap and decay daily files (YYYY-MM-DD.md pattern).""" + date_pattern = re.compile(r"^\d{4}-\d{2}-\d{2}\.md$") + daily_files = sorted( + f for f in target_dir.rglob("*.md") + if date_pattern.match(f.name) + ) + + if not daily_files: + print(f" no daily files (YYYY-MM-DD.md) found in {target_dir}") + return + + results = [] + for f in daily_files: + content = f.read_text(encoding="utf-8", errors="replace") + fields, body, had_yaml = parse_frontmatter(content) + + # Extract date from filename + file_date = date.fromisoformat(f.stem) + days = max(0, (TODAY - file_date).days) + + # Use file_date as reference (not git/mtime — daily files are date-intrinsic) + la = fields.get("last_accessed", "") + try: + last_acc = date.fromisoformat(la[:10]) + # Use most recent of: file_date, last_accessed + ref_days = max(0, (TODAY - max(file_date, last_acc)).days) + except (ValueError, IndexError): + ref_days = days + + new_relevance = calc_relevance(ref_days, config["decay_rate"], config["relevance_floor"]) + old_tier = fields.get("tier", "") + new_tier = calc_tier(ref_days, config["tiers"], old_tier) + + fields["type"] = "daily" + fields["date"] = file_date.isoformat() + if "last_accessed" not in fields: + fields["last_accessed"] = file_date.isoformat() + fields["relevance"] = str(new_relevance) + fields["tier"] = new_tier + + new_content = build_frontmatter(fields) + body + changed = new_content != content + + if changed and not dry_run: + f.write_text(new_content, encoding="utf-8") + + results.append({ + "file": f.name, + "date": file_date.isoformat(), + "days": ref_days, + "relevance": new_relevance, + "tier": new_tier, + "changed": changed, + }) + + if verbose: + print(f" {'[dry] ' if dry_run else ''}{f.name}: {old_tier or '?'}→{new_tier} r={new_relevance} ({ref_days}d)") + + # Summary + tiers = {} + for r in results: + tiers[r["tier"]] = tiers.get(r["tier"], 0) + 1 + changed_count = sum(1 for r in results if r["changed"]) + + print(f"\n {'DRY RUN — ' if dry_run else ''}daily results:") + print(f" files: {len(results)}, changed: {changed_count}") + for tier in ["active", "warm", "cold", "archive"]: + count = tiers.get(tier, 0) + if count: + dates = [r["date"] for r in results if r["tier"] == tier] + print(f" {tier:8s}: {count:3d} ({dates[0]}..{dates[-1]})") + + +def cmd_stats(target_dir: Path, config: dict): + """Show comprehensive memory health stats.""" + cards = find_cards(target_dir, config) + tiers = {} + total_bytes = 0 + stale_count = 0 + no_yaml = 0 + + for card in cards: + content = card.read_text(encoding="utf-8", errors="replace") + total_bytes += len(content.encode("utf-8")) + fields, body, had_yaml = parse_frontmatter(content) + if not had_yaml: + no_yaml += 1 + tier = fields.get("tier", "unknown") + tiers[tier] = tiers.get(tier, 0) + 1 + try: + la = date.fromisoformat(fields.get("last_accessed", "")[:10]) + if (TODAY - la).days > 90: + stale_count += 1 + except (ValueError, IndexError): + pass + + print(f"\n memory health — {target_dir}") + print(f" {'─' * 40}") + print(f" total cards: {len(cards)}") + print(f" total size: {total_bytes / 1024:.0f} KB") + print(f" without yaml: {no_yaml}") + print(f" stale (>90 days): {stale_count}") + print(f" {'─' * 40}") + print(f" tier distribution:") + for tier in ["core", "active", "warm", "cold", "archive", "unknown"]: + count = tiers.get(tier, 0) + if count: + pct = count / len(cards) * 100 + bar = "█" * int(pct / 2) + print(f" {tier:8s}: {count:4d} ({pct:4.1f}%) {bar}") + + # Context budget estimate (assuming ~4 chars per token) + active_bytes = 0 + for card in cards: + content = card.read_text(encoding="utf-8", errors="replace") + fields, _, _ = parse_frontmatter(content) + if fields.get("tier") in ("core", "active"): + active_bytes += len(content.encode("utf-8")) + print(f" {'─' * 40}") + print(f" active context: {active_bytes / 1024:.0f} KB (~{active_bytes // 4:,} tokens)") + print(f" total context: {total_bytes / 1024:.0f} KB (~{total_bytes // 4:,} tokens)") + + +# ─── main ─────────────────────────────────────────────────────── + +def main(): + args = sys.argv[1:] + if not args or args[0] in ("-h", "--help"): + print(__doc__) + sys.exit(0) + + cmd = args[0] + dry_run = "--dry-run" in args + verbose = "--verbose" in args + + # Find config path + config_path = None + if "--config" in args: + idx = args.index("--config") + config_path = args[idx + 1] if idx + 1 < len(args) else None + + # Find target directory (first non-flag argument after command) + target = None + for a in args[1:]: + if not a.startswith("-") and a != config_path: + target = a + break + + if cmd == "touch": + if not target: + print(" error: touch requires a file path") + sys.exit(1) + config = load_config(Path(target).parent, config_path) + cmd_touch(target, config) + return + + if cmd == "creative": + n = 5 + creative_dir = None + for a in args[1:]: + if not a.startswith("-"): + try: + n = int(a) + except ValueError: + creative_dir = a + target_dir = Path(creative_dir) if creative_dir else Path(".") + config = load_config(target_dir, config_path) + cmd_creative(n, target_dir, config) + return + + target_dir = Path(target) if target else Path(".") + if not target_dir.is_dir(): + print(f" error: {target_dir} is not a directory") + sys.exit(1) + + config = load_config(target_dir, config_path) + + if cmd == "scan": + cmd_scan(target_dir, config, verbose) + elif cmd == "init": + cmd_init(target_dir, config, dry_run, verbose) + elif cmd == "decay": + cmd_decay(target_dir, config, dry_run, verbose) + elif cmd == "daily": + cmd_daily(target_dir, config, dry_run, verbose) + elif cmd == "stats": + cmd_stats(target_dir, config) + elif cmd == "config": + save_default_config(target_dir) + else: + print(f" unknown command: {cmd}") + print(" commands: scan, init, decay, daily, touch, creative, stats, config") + sys.exit(1) + + +if __name__ == "__main__": + main() diff --git a/vault/.claude/skills/dbrain-processor/SKILL.md b/vault/.claude/skills/dbrain-processor/SKILL.md new file mode 100644 index 0000000..f00e116 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/SKILL.md @@ -0,0 +1,620 @@ +--- +type: note +description: Personal assistant for processing daily voice/text entries from Telegram. Classifies content, creates Todoist tasks aligned with goals, saves thoughts to Obsidian with wiki-links, generates HTML reports. Integrates Your Business context (clients, projects, CRM). Triggers on /process command or daily 21:00 cron. +name: dbrain-processor +allowed-tools: Bash(mcp-cli:*) +depends_on: [graph-builder, todoist-ai, agent-memory, vault-health] +--- + +# d-brain Processor + +Process daily entries → tasks (Todoist) + thoughts (Obsidian) + HTML report (Telegram). + +Integrates with Your Business data for business context. + +## CRITICAL: Output Format + +**ALWAYS return RAW HTML. No exceptions. No markdown. Ever.** + +Your final output goes directly to Telegram with `parse_mode=HTML`. + +Rules: +1. ALWAYS return HTML report — even if entries already processed +2. ALWAYS use the template below — no free-form text +3. NEVER use markdown syntax (**, ##, ```, -) +4. NEVER explain what you did in plain text — put it in HTML report + +WRONG: +```html +Title +``` + +CORRECT: +Title + +## Todoist через mcp-cli + +**ВСЕГДА используй mcp-cli для Todoist.** Не используй прямые MCP tools. + +### Базовые команды: + +```bash +# Задачи на сегодня (проверка workload) +mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}' + +# Создать задачу +mcp-cli call todoist add-tasks '{"tasks": [{"content": "Task", "dueString": "tomorrow", "priority": 2}]}' + +# Найти задачи по label +mcp-cli call todoist find-tasks '{"labels": ["process-goal"]}' + +# Завершить задачи +mcp-cli call todoist complete-tasks '{"ids": ["task_id"]}' + +# Обзор +mcp-cli call todoist get-overview '{}' +``` + +### Приоритеты: +- 1 = p1 (highest) +- 2 = p2 (high) +- 3 = p3 (medium) +- 4 = p4 (default) + +## CRITICAL: mcp-cli Usage + +**СНАЧАЛА ВЫЗОВИ КОМАНДУ. ПОТОМ ДУМАЙ.** + +### Обязательный алгоритм: + +``` +1. ВЫЗОВИ: mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}' + ↓ + Получил результат? → Продолжай + ↓ + Ошибка? → Читай файлы 30 секунд, потом ВЫЗОВИ СНОВА + ↓ + 3 ошибки подряд? → Покажи ТОЧНЫЙ текст ошибки +``` + +### ЗАПРЕЩЕНО: + +- ❌ "Todoist недоступен" +- ❌ "mcp-cli не работает" +- ❌ "добавь вручную" +- ❌ Решать что не работает БЕЗ вызова команды + +### ОБЯЗАТЕЛЬНО: + +- ✅ ВЫЗВАТЬ команду через Bash +- ✅ Если ошибка — подождать, вызвать снова +- ✅ 3 retry перед любыми выводами +- ✅ Показать task ID если создан + +## Processing Flow + +1. **Load personal context** — Read goals/1-yearly, goals/2-monthly, goals/3-weekly +2. **Load business context**: + - Read `business/_index.md` — Your Business (клиенты, проекты, CRM) + - Read `projects/_index.md` — личные проекты (если релевантно) +3. **Read daily** — daily/YYYY-MM-DD.md +4. **Check workload** — `mcp-cli call todoist find-tasks-by-date '{"startDate": "today", "daysCount": 7}'` +5. **CHECK PROCESS GOALS** — `mcp-cli call todoist find-tasks '{"labels": ["process-goal"]}'` + → If empty or stale: generate from goals, create recurring tasks +6. **Process entries** — Classify → task or thought, detect business mentions +7. **Build links** — Connect notes with [[wiki-links]], link to business entities +8. **Generate HTML report** — include process goals status + business activity +9. **Log actions to daily** — append action log entry (see below) +10. **Evolve MEMORY.md** — update long-term memory if needed (see below) +11. **Capture observations** — record friction signals to handoff.md (see below) + +## ОБЯЗАТЕЛЬНО: Логирование в daily/ + +**После ЛЮБЫХ изменений в vault — СРАЗУ пиши в `daily/YYYY-MM-DD.md`:** + +Формат: +``` +## HH:MM [text] +{Описание действий} + +**Создано/Обновлено:** +- [[path/to/file|Name]] — описание +``` + +**Что логировать:** +- Создание файлов в thoughts/ +- Обновление business/ или projects/ +- Создание задач в Todoist (с task ID) +- Синхронизация с внешними системами + +**Пример:** +``` +## 14:30 [text] +Обработка ежедневных записей + +**Создано задач:** 3 +- "Follow-up Acme Corp" (id: 8501234567, p2, завтра) +- "Подготовить КП Unilever" (id: 8501234568, p2, пятница) + +**Сохранено мыслей:** 1 +- [[thoughts/ideas/product-launch|Product Launch]] — идея запуска +``` + +**Зачем:** Audit trail + контекст для будущих обработок. + +## Evolve MEMORY.md (Step 10 Detail) + +**ЦЕЛЬ:** Поддерживать MEMORY.md актуальным. Не добавлять, а ЭВОЛЮЦИОНИРОВАТЬ. + +### Когда обновлять MEMORY.md + +Проверь после обработки entries — есть ли информация достойная долгосрочной памяти? + +### Write Rules: Что достойно MEMORY.md + +**ПИСАТЬ:** +- ✅ Key decisions с impact (pivot, tool choice, architecture change) +- ✅ Изменения в pipeline (новый лид, закрытая сделка, изменение статуса) +- ✅ Финансовые изменения (оплаты получены, долги, новые контракты) +- ✅ Новые паттерны/инсайты (learnings) +- ✅ Изменения в Active Context (новый ONE Big Thing, Hot Projects) +- ✅ Новые ключевые контакты (с context) + +**НЕ ПИСАТЬ:** +- ❌ Ежедневные мелочи (встречи, звонки без impact) +- ❌ Временные заметки (оставить в daily/) +- ❌ Дубликаты того что уже есть +- ❌ Детали проектов (оставить в business/crm/, projects/) +- ❌ Тривиальные задачи + +### Как обновлять (evolve, не append) + +**Принцип:** Новое ЗАМЕНЯЕТ устаревшее, не добавляется рядом. + +| Ситуация | Действие | +|----------|----------| +| Новое противоречит старому | ЗАМЕНИТЬ старую информацию | +| Новое дополняет старое | Добавить в существующую секцию | +| Информация устарела | Удалить или архивировать | + +**Пример 1 — Изменение статуса проекта:** +``` +Old: "| Acme Corp NCP Meals | p1 | Активная разработка | $XXK |" +New info: "Acme Corp NCP Meals сдан клиенту" +→ ЗАМЕНИТЬ на: "| Acme Corp NCP Meals | ✅ | Завершён | $XXK |" +``` + +**Пример 2 — Новое решение:** +``` +Добавить в Key Decisions таблицу: +| 2026-02-01 | Отказ от X в пользу Y | причина | impact | +``` + +**Пример 3 — Изменение в pipeline:** +``` +Old: "| LogisticsLead | Hot | $XXK |" +New info: "LogisticsLead подписал контракт" +→ Удалить из Pipeline +→ Добавить в Hot Projects или Financial Context +``` + +### Секции MEMORY.md для обновления + +| Секция | Когда обновлять | +|--------|-----------------| +| Active Context | Изменение ONE Big Thing, Hot Projects, Pipeline | +| Key Decisions | Новое решение с impact | +| Financial Context | Оплаты, долги, контракты | +| Key People | Новый важный контакт | +| Learnings | Новый паттерн/инсайт | +| Current Crisis | Изменение в текущей критической ситуации | + +### Формат Edit + +Используй Edit tool для точечных изменений: + +``` +Edit MEMORY.md: +old_string: "| LogisticsLead | Hot | $XXK |" +new_string: "| LogisticsLead | ✅ Signed | $XXK |" +``` + +### В отчёте + +Если обновил MEMORY.md, добавь секцию: + +```html +🧠 MEMORY.md обновлён: +• Active Context → Hot Projects updated +• Key Decisions → +1 новое решение +``` + +## Capture Observations (Step 11 Detail) + +**ЦЕЛЬ:** Записывать friction signals, паттерны и идеи для улучшения системы. + +### Когда записывать + +После обработки проверь — были ли проблемы или наблюдения? + +| Тип | Когда | +|-----|-------| +| `[friction]` | mcp-cli errors, timeouts, empty daily, broken links, unexpected data | +| `[pattern]` | Повторяющийся паттерн (задачи всегда overdue, daily пустой по выходным) | +| `[idea]` | Идея для улучшения pipeline, schema, отчёта | + +### Формат + +Append в `vault/.session/handoff.md` секцию `## Observations`: + +```markdown +## Observations +- [friction] YYYY-MM-DD: mcp-cli timeout 3x на todoist — retry спас, но -60 сек +- [pattern] YYYY-MM-DD: daily без entries 2 дня подряд — выходные? +- [idea] YYYY-MM-DD: CRM карточки без deal_deadline = невидимые дедлайны +``` + +### Правила + +- Одна строка на наблюдение (конкретика, не абстракции) +- Дата обязательна +- Не повторять уже записанные observations +- Когда observations ≥10 → сигнал для system improvement session + +### В отчёте + +Если записаны observations, добавь: + +```html +👁 Observations: +• [friction] mcp-cli timeout 3x +``` + +--- + +## Process Goals Check (Step 5 Detail) + +**ОБЯЗАТЕЛЬНО выполни этот шаг при каждом /process:** + +### 1. Проверь существующие process goals + +```bash +mcp-cli call todoist find-tasks '{"labels": ["process-goal"], "limit": 20}' +``` + +### 2. Если process goals ОТСУТСТВУЮТ — создай их + +Читай goals файлы и генерируй process commitments: + +| Goal Level | Source | Process Pattern | +|------------|--------|-----------------| +| Weekly ONE Big Thing | goals/3-weekly.md | 2h deep work ежедневно | +| Monthly Top 3 | goals/2-monthly.md | 1 action/день на приоритет | +| Yearly Focus | goals/1-yearly-*.md | 30 мин/день на стратегию | + +**Создай recurring tasks:** + +```bash +mcp-cli call todoist add-tasks '{"tasks": [ + {"content": "2h deep work: [ONE Big Thing]", "dueString": "every weekday at 6am", "priority": 2, "labels": ["process-goal"]}, + {"content": "1 outreach/день: [monthly priority]", "dueString": "every weekday", "priority": 3, "labels": ["process-goal"]}, + {"content": "30 мин продуктовые идеи", "dueString": "every day", "priority": 4, "labels": ["process-goal"]} +]}' +``` + +**Лимит:** Max 5-7 активных process goals. + +### 3. Если process goals ЕСТЬ — проверь статус + +- Активные (upcoming) → ✅ показать в отчёте +- Просроченные (overdue) → ⚠️ предупредить +- Устаревшие (не связаны с текущими целями) → рекомендовать удалить + +### 4. Включи в отчёт + +```html +📋 Process Goals: +• 2h deep work: [Client Project] → ✅ активен +• 1 outreach/день → ⚠️ просрочен +{N} активных | {M} требуют внимания +``` + +## Entry Format + +## HH:MM [type] +Content + +Types: [voice], [text], [forward from: Name], [photo] + +## Business Context Integration + +**ТОЧКА ВХОДА:** `business/_index.md` — читай для понимания бизнес-контекста. + +### Структура: +``` +business/ +├── _index.md ← Статистика, обзор +├── crm/ ← ВСЁ: компании + сделки + проекты в одном файле +├── network/ ← Структура холдинга +└── events/ ← Мероприятия +``` + +### Распознавание упоминаний + +При обработке entries ищи упоминания клиентов и проектов: + +| Паттерн | Действие | +|---------|----------| +| "звонил [Client]" | Найти `business/crm/{client}.md`, добавить связь | +| "по проекту [Client]" | Найти `business/crm/{client}.md` | +| "встреча с [Client]" | Создать задачу + связать с `business/crm/{client}.md` | +| "отправил КП для [Client]" | Связать с `business/crm/{client}.md` | + +### Поиск клиента по имени + +1. Имя → kebab-case: "Acme Corp" → `acme-corp`, "Bi Group" → `bi-group` +2. Искать: `business/crm/{kebab-case}.md` +3. Если не найден — fuzzy search по `grep -l "{name}" business/crm/` + +### Создание связей + +Когда упомянут клиент/проект, добавляй wiki-links: + +**В задачу:** +``` +"Follow-up [[business/crm/acme-corp|Acme Corp]] по снекам" +``` + +**В thought:** +``` +Связано с: [[business/crm/techco|TechCo]], [[business/crm/phonebrand-smm|PhoneBrand SMM]] +``` + +### Приоритет задач с бизнесом + +| Условие | Приоритет | +|---------|-----------| +| Клиент с priority: High + deadline | p1 | +| Активный проект (In progress) | p2 | +| Клиент с priority: High | p2 | +| Клиент с priority: Mid | p3 | +| Prospect без срочности | p4 | + +## Classification + +task → Todoist (see references/todoist.md) +idea/reflection/learning → thoughts/ (see references/classification.md) +client/project mention → link to Business/Projects + create task if actionable + +## Projects Context Integration + +**Точка входа:** `projects/_index.md` + +### Структура: +``` +projects/ +├── _index.md # Clients overview +├── clients/ # Clients +└── leads/ # Leads +``` + +### Распознавание упоминаний + +| Паттерн | Файл | +|---------|------| +| "[Client A]" | projects/clients/{client-a}.md | +| "[Client B]" | projects/clients/{client-b}.md | +| "AI обучение", "воркшоп" | projects/ контекст | + +### Отличие от Business + +- **Business** = основной бизнес +- **Projects** = личные проекты (консалтинг, обучение) + +Если entry упоминает AI/ML обучение — ищи в projects/ сначала. + +## Contacts Context Integration + +**Точка входа:** `contacts/_index.md` + +### Распознавание имён в entries + +Ищи паттерны: +- "созвонился с [Contact] из [Client]" +- "встреча с @username" +- "Имя Фамилия написал" + +### Классификация + +| Индикатор | Категория | Vault Link | +|-----------|-----------|------------| +| Known business clients | business | `business/crm/{client}` | +| AI/обучение expertise, known leads | projects | `projects/leads/{name}` | +| Остальные | personal | — | + +### В отчёте + +Если в entries упомянуты люди, добавь секцию: + +```html +👤 Упомянуто контактов: +• [Contact Name] (business → [[business/crm/acme-corp]]) +• [Contact Name] (personal) +``` + +## Priority Rules + +p1 — Client deadline, urgent +p2 — Aligns with ONE Big Thing or monthly priority +p3 — Aligns with yearly goal +p4 — Operational, no goal alignment + +## Process Goals Preference + +When creating tasks, prefer PROCESS over OUTCOME formulations. + +**Outcome (less effective):** +- "Закрыть сделку с X" +- "Запустить продукт" +- "Подготовить программу" + +**Process (more effective):** +- "Отправить follow-up клиенту X" (actionable, controllable) +- "2h deep work на MVP" (time-bounded) +- "Показать драфт программы коллеге" (checkpoint) + +**When to transform:** +- Entry sounds vague/outcome-focused → make it specific/process-focused +- User says "нужно сделать X" → create actionable next step, not X itself +- Goal mentioned → create task that MOVES TOWARD goal, not goal itself + +See: references/process-goals.md for patterns and examples. + +## Thought Categories + +💡 idea → thoughts/ideas/ +🪞 reflection → thoughts/reflections/ +🎯 project → thoughts/projects/ +📚 learning → thoughts/learnings/ + +## HTML Report Template + +Output RAW HTML (no markdown, no code blocks): + +📊 Обработка за {DATE} + +🎯 Текущий фокус: +{ONE_BIG_THING} + +📓 Сохранено мыслей: {N} +• {emoji} {title} → {category}/ + +✅ Создано задач: {M} +• {task} ({priority}, {due}) + +🏢 Business Activity: +• {client} — {action} +• {project} — {status update} +Упомянуто клиентов: {N} | Проектов: {M} + +📋 Process Goals: +• {process goal 1} → {status} +• {process goal 2} → {status} +{N} активных | {M} требуют внимания +Создано новых: {K} + +📅 Загрузка на неделю: +Пн: {n} | Вт: {n} | Ср: {n} | Чт: {n} | Пт: {n} | Сб: {n} | Вс: {n} + +⚠️ Требует внимания: +• {overdue or stale goals} + +🔗 Новые связи: +• [[Note A]] ↔ [[Note B]] + +⚡ Топ-3 приоритета: +1. {task} +2. {task} +3. {task} + +📈 Прогресс: +• {goal}: {%} {emoji} + +🧠 MEMORY.md: +• {section} → {change description} +(если обновлено) + +--- +Обработано за {duration} + +## If Already Processed + +If all entries have `` marker, return status report: + +📊 Статус за {DATE} + +🎯 Текущий фокус: +{ONE_BIG_THING} + +📋 Process Goals: +• {process goal 1} → {status} +• {process goal 2} → {status} +{N} активных | {M} требуют внимания + +📅 Загрузка на неделю: +Пн: {n} | Вт: {n} | Ср: {n} | Чт: {n} | Пт: {n} | Сб: {n} | Вс: {n} + +⚠️ Требует внимания: +• {overdue count} просроченных +• {today count} на сегодня + +⚡ Топ-3 приоритета: +1. {task} +2. {task} +3. {task} + +--- +Записи уже обработаны ранее + +## Allowed HTML Tags + + — bold (headers) + — italic (metadata) + — commands, paths + — strikethrough + — underline +text — links + +## FORBIDDEN in Output + +NO markdown: **, ##, -, *, backticks +NO code blocks (triple backticks) +NO tables +NO unsupported tags: div, span, br, p, table + +Max length: 4096 characters. + +## References + +Read these files as needed: +- references/about.md — User profile, decision filters +- references/classification.md — Entry classification rules +- references/todoist.md — Task creation details + recurring patterns +- references/goals.md — Goal alignment logic +- references/process-goals.md — Process vs outcome goals, transformation patterns +- references/links.md — Wiki-links building +- references/rules.md — Mandatory processing rules +- references/report-template.md — Full HTML report spec +- references/business.md — Business client/project context, search patterns +- references/contacts.md — Contacts search and classification + +## Business Quick Reference + +**Точка входа:** `business/_index.md` + +**Поиск клиента:** +``` +grep -l "Acme Corp" business/crm/ +→ business/crm/acme-corp.md +``` + +**Активные сделки:** +``` +grep -l "deal_status:" business/crm/ +``` + +**High priority клиенты:** +``` +grep -l "priority: High" business/crm/ +``` + +**Frontmatter полей:** +- type: crm +- industry, priority, status, region, owner, responsible +- deal_status, deal_deadline (для активных сделок) +- updated + +## Relevant Skills + +- [[vault/.claude/skills/graph-builder/SKILL|graph-builder]] — Vault graph analysis +- [[vault/.claude/skills/todoist-ai/SKILL|todoist-ai]] — Todoist task management diff --git a/vault/.claude/skills/dbrain-processor/phases/capture.md b/vault/.claude/skills/dbrain-processor/phases/capture.md new file mode 100644 index 0000000..3f78e77 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/phases/capture.md @@ -0,0 +1,98 @@ +# Phase 1: CAPTURE + +Read daily entries, classify them, and output structured JSON. + +## Input +- `daily/{DATE}.md` — today's entries +- `goals/3-weekly.md` — current week focus +- `goals/2-monthly.md` — monthly priorities +- `goals/1-yearly-2026.md` — yearly goals + +## Task + +1. Read `daily/{DATE}.md` +2. For each entry (## HH:MM [type] block), classify: + - **task** — actionable item → will become Todoist task + - **idea** → will be saved to thoughts/ideas/ + - **reflection** → thoughts/reflections/ + - **learning** → thoughts/learnings/ + - **project** → thoughts/projects/ + - **crm_update** — mentions business client → update CRM + - **skip** — already processed or not actionable +3. Detect entity mentions (company names, people, projects) +4. Align with goals (which goal does this serve?) + +## Output Format + +Print ONLY valid JSON (no markdown, no explanation): + +```json +{ + "date": "2026-02-19", + "one_big_thing": "[Client A] NCP: POST-LAUNCH stabilization", + "entries": [ + { + "time": "10:30", + "type": "voice", + "content": "Called Acme Corp about the project, discussed KPI", + "classification": "task", + "task_content": "Follow-up Acme Corp: send KPI report", + "task_priority": 2, + "task_due": "tomorrow", + "entities": ["business/crm/acme-corp"], + "goal_alignment": "ONE Big Thing" + }, + { + "time": "14:00", + "type": "text", + "content": "AI agents need layered memory", + "classification": "idea", + "title": "AI agents need layered memory with decay scoring", + "description": "Pattern from analysis. Active memories decay if unused.", + "category": "ideas", + "tags": ["ai", "agents", "memory"], + "entities": [], + "goal_alignment": "yearly/AI Development" + } + ], + "stats": { + "total_entries": 5, + "tasks": 2, + "thoughts": 2, + "crm_updates": 1, + "skipped": 0 + } +} +``` + +## Classification Rules + +### Task indicators +- "нужно", "надо", "сделать", "позвонить", "отправить", "подготовить" +- Deadline mentions (завтра, в пятницу, до конца недели) +- Follow-up mentions + +### Thought indicators +- Insights, patterns, observations +- "понял что", "интересно что", "заметил" +- No clear action required + +### CRM indicators +- Company name mention (known clients from CRM) +- Deal/project status change +- Meeting/call with client + +### Process goal formulation +When creating task_content, prefer PROCESS over OUTCOME: +- WRONG: "Закрыть сделку с Acme Corp" +- RIGHT: "Отправить follow-up Acme Corp: KPI отчёт за февраль" + +### Prose-as-title for thoughts +When creating thought titles, use CLAIMS not topic labels: +- WRONG: "Agent Memory System" (topic label) +- RIGHT: "AI agents need layered memory with decay scoring" (specific claim) +Test: "Since [[title]], ..." should read naturally. + +## Important +- Mark entries with `` as "skip" +- Output ONLY JSON — no explanation, no markdown wrapping diff --git a/vault/.claude/skills/dbrain-processor/phases/execute.md b/vault/.claude/skills/dbrain-processor/phases/execute.md new file mode 100644 index 0000000..bf0c8e1 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/phases/execute.md @@ -0,0 +1,101 @@ +# Phase 2: EXECUTE + +Read capture.json from Phase 1. Create Todoist tasks, save thoughts, update CRM. + +## Input +- `.session/capture.json` — output from Phase 1 +- `business/_index.md` — business context +- `projects/_index.md` — projects context + +## Task + +### 1. Create Todoist tasks + +For each entry with `classification: "task"`: + +```bash +mcp-cli call todoist add-tasks '{"tasks": [{"content": "...", "dueString": "...", "priority": N}]}' +``` + +Record created task IDs. + +### 2. Check process goals + +```bash +mcp-cli call todoist find-tasks '{"labels": ["process-goal"]}' +``` + +If missing or stale → create from goals. + +### 3. Save thoughts + +For each entry with classification idea/reflection/learning/project: +- Create file in `thoughts/{category}/YYYY-MM-DD-slug.md` +- Include frontmatter with description field (retrieval filter, ~150 chars) +- Add wiki-links to related entities +- Add typed relationships in Related section: + ```markdown + ## Related + - [[business/crm/acme-corp|Acme Corp]] — context: discussed during project review + ``` + +### 4. Update CRM + +For entries with `classification: "crm_update"`: +- Update relevant `business/crm/*.md` or `projects/clients/*.md` +- Update deal_status, status, or add notes + +### 5. Build links + +For all created/updated files: +- Search for related notes in vault +- Add wiki-links with context phrases +- Update frontmatter `related:[]` + +### 6. Check workload + +```bash +mcp-cli call todoist find-tasks-by-date '{"startDate": "today", "daysCount": 7}' +``` + +## mcp-cli retry algorithm + +``` +1. Call mcp-cli +2. Error? Wait 10 sec, read vault files +3. Call again +4. Error? Wait 20 sec +5. Call third time — GUARANTEED to work +``` + +NEVER say "MCP unavailable". Always retry 3x. + +## Output Format + +Print ONLY valid JSON: + +```json +{ + "tasks_created": [ + {"id": "8501234567", "content": "Follow-up Acme Corp", "priority": 2, "due": "tomorrow"} + ], + "thoughts_saved": [ + {"path": "thoughts/ideas/2026-02-19-layered-memory.md", "title": "AI agents need layered memory", "category": "ideas"} + ], + "crm_updated": [ + {"path": "business/crm/acme-corp.md", "change": "Added meeting note"} + ], + "links_created": [ + {"from": "thoughts/ideas/2026-02-19-layered-memory.md", "to": "business/crm/acme-corp.md", "context": "discussed during project review"} + ], + "process_goals": { + "active": 5, + "overdue": 1, + "created": 0 + }, + "workload": { + "mon": 3, "tue": 2, "wed": 4, "thu": 1, "fri": 2, "sat": 0, "sun": 0 + }, + "observations": [] +} +``` diff --git a/vault/.claude/skills/dbrain-processor/phases/reflect.md b/vault/.claude/skills/dbrain-processor/phases/reflect.md new file mode 100644 index 0000000..ae11e42 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/phases/reflect.md @@ -0,0 +1,94 @@ +# Phase 3: REFLECT + +Read execute results. Generate HTML report. Update MEMORY. Write observations. Log to daily. + +## Input +- `.session/capture.json` — from Phase 1 +- `.session/execute.json` — from Phase 2 +- `MEMORY.md` — long-term memory +- `.session/handoff.md` — session context +- `.graph/health-history.json` — vault health trend + +## Task + +### 1. Generate HTML report + +Use the template from SKILL.md. Include: + +- ONE Big Thing (from capture.json) +- Thoughts saved (from execute.json) +- Tasks created (with IDs) +- Process goals status +- Workload by day +- Vault Health score (from latest health-history.json entry) +- Top 3 priorities +- Observations (if any) + +### 2. Log actions to daily + +Append to `daily/{DATE}.md`: + +```markdown +## HH:MM [text] +d-brain processing + +**Tasks created:** N +- "Task content" (id: XXXX, priority, due) + +**Thoughts saved:** M +- [[path/to/thought|Title]] — category + +**CRM updated:** K +- [[business/crm/client]] — change description +``` + +### 3. Evolve MEMORY.md + +Check if any information from today deserves long-term memory: +- New key decisions +- Pipeline changes (new lead, closed deal, status change) +- Financial changes +- Active Context updates + +Rules: +- New info REPLACES outdated (don't append duplicates) +- Only write significant changes + +### 4. Capture observations + +If problems occurred during processing, append to `.session/handoff.md` under `## Observations`: + +```markdown +- [friction] 2026-02-19: mcp-cli timeout on todoist — retried 3x +- [pattern] 2026-02-19: daily had only 2 entries — low activity day +``` + +### 5. Update handoff.md + +Update session context: +- Last Session: what was processed +- Key Decisions: if any +- In Progress: incomplete items +- Next Steps: what to do next + +## Output Format + +Return RAW HTML report (no markdown, no code blocks). Goes directly to Telegram. + +Follow the HTML template exactly: +- Only use: ``, ``, ``, ``, ``, `` +- NO: `
`, `
`, `
`, markdown syntax +- Max 4096 characters + +### Vault Health section (add to report): + +```html +📊 Vault Health: {score}/100 +Orphans: {N} | Broken: {M} | Avg links: {X} | Desc: {Y}% +``` + +## CRITICAL + +- Output is RAW HTML only +- No markdown syntax anywhere +- All HTML tags must be properly closed diff --git a/vault/.claude/skills/dbrain-processor/references/about.md b/vault/.claude/skills/dbrain-processor/references/about.md new file mode 100644 index 0000000..1046694 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/references/about.md @@ -0,0 +1,28 @@ +# About [Your Name] + +## Who I Am +[Your Name], [age]. [Your role/title] at [Your Company]. + +## What I Do +- [Main business activity] +- [Side projects/interests] + +## My Team +| Name | Role | +|------|------| +| [Your Name] | [Your Role] | +| [Team Member] | [Their Role] | + +## Working Style +- Timezone: [Your Timezone] +- Working hours: [Your preferred hours] +- Languages: [Your languages] + +## Values +- [Value 1] +- [Value 2] +- [Value 3] + +## Key Clients/Projects +- [Client/Project 1] — [Brief description] +- [Client/Project 2] — [Brief description] diff --git a/vault/.claude/skills/dbrain-processor/references/business-context.md b/vault/.claude/skills/dbrain-processor/references/business-context.md new file mode 100644 index 0000000..db0e4ff --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/references/business-context.md @@ -0,0 +1,26 @@ +# Business Context + +## Company Overview +[Your Company Name] — [what the company does]. + +## CRM Structure +``` +business/ +├── _index.md ← Start here (stats, overview) +├── crm/ ← Client records (companies + deals) +└── network/ ← Company structure, partners +``` + +## Key Metrics +- Total CRM records: [N] +- Active deals: [N] +- Industries: [list your industries] + +## Deal Tracking Fields +| Field | Values | +|-------|--------| +| status | Active, Prospect, Dormant | +| deal_status | In Progress, Tender, Proposal Sent | +| priority | High, Mid, Low | +| region | [Your regions] | +| owner | [Your Name] | diff --git a/vault/.claude/skills/dbrain-processor/references/classification.md b/vault/.claude/skills/dbrain-processor/references/classification.md new file mode 100644 index 0000000..54a2fd2 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/references/classification.md @@ -0,0 +1,201 @@ +# Entry Classification + +## Work Domains → Categories + +Based on user's work context (see [ABOUT.md](ABOUT.md)): + +### Client Work +Брифы, стратегии, креатив, кампании, KPI, предложения + +**Keywords:** [Client A], [Client B], [Client C], клиент, бриф, презентация, дедлайн, KPI + +**→ Category:** task (p1-p2) → Todoist + +### AI & Tech +Инструменты, модели, промпты, пайплайны, агенты + +**Keywords:** GPT, Claude, модель, агент, API, пайплайн, автоматизация, интеграция + +**→ Category:** learning или project → thoughts/ + +### Product +Идеи, гипотезы, MVP, юнит-экономика + +**Keywords:** продукт, SaaS, MVP, гипотеза, монетизация, юнит-экономика, стартап + +**→ Category:** idea или project → thoughts/ + +### Company Ops +Команда, процессы, автоматизация, найм, управление, финансы + +**Keywords:** команда, найм, процесс, HR, финансы, [Your Business], агентство + +**→ Category:** task или project (depends on urgency) + +### Content +Посты, идеи, тезисы для Telegram и LinkedIn + +**Keywords:** пост, @yourbrand, LinkedIn, контент, тезис, статья + +**→ Category:** idea → thoughts/ideas/ или task если с дедлайном + +--- + +## Decision Tree + +``` +Entry text contains... +│ +├─ Client brand or deadline? ────────────────────> TASK (p1-p2) +│ ([Client A], [Client B], клиент, дедлайн, презентация) +│ +├─ Operational/urgent? ──────────────────────────> TASK (p2-p3) +│ (нужно сделать, не забыть, позвонить, встреча) +│ +├─ AI/tech learning? ────────────────────────────> LEARNING +│ (узнал, модель, агент, интеграция) +│ +├─ Product/SaaS idea? ───────────────────────────> IDEA или PROJECT +│ (продукт, MVP, гипотеза, SaaS) +│ +├─ Strategic thinking? ──────────────────────────> PROJECT +│ (стратегия, план, R&D, долгосрочно) +│ +├─ Personal insight? ────────────────────────────> REFLECTION +│ (понял, осознал, философия) +│ +└─ Content idea? ────────────────────────────────> IDEA + (пост, тезис, контент) +``` + +--- + +## Business Client Detection + +Entry mentions a known client (see business-context.md)? + +``` +├─ + deadline/urgency? → TASK (p1-p2) + client label +├─ + статус ("отправили КП", "выиграли")? → TASK + flag for CRM note +├─ + встреча/звонок? → TASK (p2) + [[client]] link +└─ просто упоминание? → Add [[client]] link only +``` + +### CRM Status Keywords (для информации в отчёте) + +| Keywords | Интерпретация | +|----------|---------------| +| "подписали", "выиграли", "получили" | Позитивный исход | +| "отказали", "проиграли", "не пошли" | Негативный исход | +| "отправили КП", "подали" | В процессе | +| "ждём ответ", "на рассмотрении" | Ожидание | + +--- + +## Apply Decision Filters + +Перед сохранением спроси: +- Это масштабируется? +- Это можно автоматизировать? +- Это усиливает экспертизу или бренд? +- Это приближает к продукту или SaaS? + +Если да на 2+ вопроса → повысить приоритет. + +--- + +## Photo Entries + +For `[photo]` entries: + +1. Analyze image content via vision +2. Determine domain: + - Screenshot клиентского материала → Client Work + - Схема/диаграмма → AI & Tech или Product + - Текст/статья → Learning +3. Add description to daily file + +--- + +## Output Locations + +| Category | Destination | Priority | +|----------|-------------|----------| +| task (client) | Todoist | p1-p2 | +| task (ops) | Todoist | p2-p3 | +| task (content) | Todoist | p3-p4 | +| idea | thoughts/ideas/ | — | +| reflection | thoughts/reflections/ | — | +| project | thoughts/projects/ | — | +| learning | thoughts/learnings/ | — | + +--- + +## File Naming + +``` +thoughts/{category}/{YYYY-MM-DD}-short-title.md +``` + +Examples: +``` +thoughts/ideas/2024-12-16-saas-pricing-model.md +thoughts/projects/2024-12-16-ai-agents-pipeline.md +thoughts/learnings/2024-12-16-claude-mcp-setup.md +``` + +--- + +## Thought Structure + +Use preferred format: + +```markdown +--- +date: {YYYY-MM-DD} +type: {category} +domain: {Client Work|AI & Tech|Product|Agency Ops|Content} +tags: [tag1, tag2] +--- + +## Context +[Что привело к мысли] + +## Insight +[Ключевая идея] + +## Implication +[Что это значит для [Your Business]/продукта/стратегии] + +## Next Action +[Конкретный шаг — не абстрактный] +``` + +--- + +## Anti-Patterns (ИЗБЕГАТЬ) + +При создании мыслей НЕ делать: +- Абстрактные рассуждения без Next Action +- Академическая теория без применения к [Your Business]/продукту +- Повторы без синтеза (кластеризуй похожие!) +- Хаотичные списки без приоритетов +- Задачи типа "подумать о..." (конкретизируй!) + +--- + +## MOC Updates + +After creating thought file, add link to: +``` +MOC/MOC-{category}s.md +``` + +Group by domain when relevant: +```markdown +## AI & Tech +- [[2024-12-16-claude-mcp-setup]] - MCP integration + +## Product +- [[2024-12-16-saas-pricing-model]] - Pricing research +``` diff --git a/vault/.claude/skills/dbrain-processor/references/contacts.md b/vault/.claude/skills/dbrain-processor/references/contacts.md new file mode 100644 index 0000000..4c6783c --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/references/contacts.md @@ -0,0 +1,12 @@ +# Contacts + +## Search Protocol +When looking for a person or contact: +1. Search vault CRM files by name +2. Check daily files for recent mentions +3. Search by company association + +## Contact Sources +- CRM cards in `business/crm/` +- Project records in `projects/` +- Daily logs for recent interactions diff --git a/vault/.claude/skills/dbrain-processor/references/goals.md b/vault/.claude/skills/dbrain-processor/references/goals.md new file mode 100644 index 0000000..1d99743 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/references/goals.md @@ -0,0 +1,135 @@ +# Goals Integration + +## ALWAYS Do First + +Before processing daily entries: + +1. **Read current focus:** + ``` + Read goals/3-weekly.md → Extract ONE Big Thing + ``` + +2. **Read yearly goals:** + ``` + Read goals/1-yearly-2025.md → Know active goals by area + ``` + +3. **Check monthly priorities:** + ``` + Read goals/2-monthly.md → Top 3 priorities + ``` + +## Goal Alignment + +When creating a task, ask: + +1. **Does it connect to ONE Big Thing?** + - Yes → add to task description: `→ Weekly focus` + - No → continue checking + +2. **Does it connect to monthly priority?** + - Yes → add: `→ Monthly: [Priority name]` + - No → continue checking + +3. **Does it connect to yearly goal?** + - Yes → add: `→ Goal: [Goal name]` + - No → mark as "operational" + +## Task Priority Boost + +If task aligns with goals, consider priority bump: + +| Alignment | Default | Boost to | +|-----------|---------|----------| +| ONE Big Thing | p3 | p2 | +| Monthly priority | p3 | p2-p3 | +| Yearly goal | p4 | p3 | +| No alignment | p4 | p4 | + +## Saving Thoughts + +When saving to thoughts/: + +1. **Check goal relevance:** + - Scan goals/1-yearly-2025.md for matching areas + - If matches → add link in frontmatter: + ```yaml + related: + - "[[goals/1-yearly-2025#Career & Business]]" + ``` + +2. **Tag with goal area:** + ``` + #goal/career + #goal/health + #goal/learning + ``` + +## Goal Progress Tracking + +Track goal activity by: + +- Task created → goal is "active" +- Thought saved → goal is "active" +- No activity 7+ days → "stale" +- No activity 14+ days → "warning" + +## Report Section + +Add to report: + +``` +📈 Прогресс по целям: +{for each active yearly goal with recent activity:} +• {goal}: {progress}% {status_emoji} + +{if stale goals:} +⚠️ Требует внимания: +• Цель "{goal}" без активности {days} дней +``` + +## Goal File Parsing + +### 3-weekly.md — Find ONE Big Thing + +Look for pattern: +```markdown +> **If I accomplish nothing else, I will:** +> [THE ONE THING] +``` + +### 1-yearly-2025.md — Find Active Goals + +Look for tables: +```markdown +| Goal | Progress | Status | +|------|----------|--------| +| Goal name | X% | 🟡 | +``` + +### 2-monthly.md — Find Top 3 + +Look for section: +```markdown +## Top 3 Priorities + +1. **[Priority 1]** +2. **[Priority 2]** +3. **[Priority 3]** +``` + +## Example Alignment + +Entry: "Нужно подготовить презентацию для клиента X" + +Check: +- ONE Big Thing: "Ship MVP" → Not related +- Monthly #1: "Client deliverables" → Related +- Yearly: "Client Revenue" → Related + +Result: +``` +Task: Подготовить презентацию для клиента X +Description: → Monthly: Client deliverables → Goal: Client Revenue +Priority: p2 (boosted from p3) +``` diff --git a/vault/.claude/skills/dbrain-processor/references/links.md b/vault/.claude/skills/dbrain-processor/references/links.md new file mode 100644 index 0000000..d919653 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/references/links.md @@ -0,0 +1,209 @@ +# Wiki-Links Building + +## Purpose + +Build connections between notes to create a knowledge graph. + +## When Saving a Thought + +### Step 1: Search for Related Notes + +Search thoughts/ for related content: + +``` +Grep "keyword1" in thoughts/**/*.md +Grep "keyword2" in thoughts/**/*.md +``` + +Keywords to search: +- Main topic of the thought +- Key entities (people, projects, technologies) +- Domain terms + +### Step 2: Check MOC Indexes + +Read relevant MOC files: + +``` +MOC/ +├── MOC-ideas.md +├── MOC-projects.md +├── MOC-learnings.md +└── MOC-reflections.md +``` + +Find related entries. + +### Step 3: Link to Goals + +Check if thought relates to goals: + +``` +Read goals/1-yearly-2025.md +Find matching goal areas +``` + +### Step 4: Add Links to Note (with context) + +In the thought file, add **typed relationships** — each link explains WHY it's connected: + +**In frontmatter (for graph analysis):** +```yaml +related: + - "[[thoughts/ideas/2024-12-15-voice-agents]]" + - "[[goals/1-yearly-2026#AI Development]]" +``` + +**In content (inline):** +```markdown +This connects to [[Voice Agents Architecture]] we explored earlier. +``` + +**In Related section (with context phrases):** +```markdown +## Related +- [[thoughts/ideas/voice-agents-architecture|Voice Agents]] — extends: real-time TTS pipeline +- [[business/crm/acme-corp|Acme Corp]] — context: NCP campaign uses similar approach +- [[goals/1-yearly-2026#AI Development]] — supports: yearly AI skill goal +``` + +### Relationship Types + +Use context phrases after `—` to explain the connection: + +| Type | When to use | Example | +|------|------------|---------| +| extends | Builds on another idea | `— extends: adds TTS to voice pipeline` | +| context | Background/origin of idea | `— context: emerged from client project` | +| supports | Aligns with a goal | `— supports: Q1 revenue target` | +| contradicts | Challenges existing note | `— contradicts: previous approach was sync` | +| enables | Makes something possible | `— enables: automated daily reports` | +| requires | Dependency | `— requires: mcp-cli working` | + +### Step 5: Update MOC Index + +Add new note to appropriate MOC: + +```markdown +# MOC: Ideas + +## Recent +- [[thoughts/ideas/2024-12-20-new-idea.md]] — Brief description + +## By Topic +### AI & Voice +- [[thoughts/ideas/2024-12-20-new-idea.md]] +- [[thoughts/ideas/2024-12-15-voice-agents.md]] +``` + +### Step 6: Add Backlinks + +In related notes, add backlink to new note if highly relevant. + +## Link Format + +### Internal Links +```markdown +[[Note Name]] # Simple link +[[Note Name|Display Text]] # With alias +[[folder/Note Name]] # With path +[[Note Name#Section]] # To heading +``` + +### Link to Goals +```markdown +[[goals/1-yearly-2025#Career & Business]] +[[goals/3-weekly]] — ONE Big Thing +``` + +--- + +## Business Entity Links + +### Формат связей + +| Тип | Формат | Пример | +|-----|--------|--------| +| Клиент | `[[business/crm/{name}\|Display]]` | `[[business/crm/acme-corp\|Acme Corp]]` | +| Проект | `[[projects/{name}\|Display]]` | `[[projects/project-alpha\|Project Alpha]]` | +| CRM Lead | `[[business/crm/{name}\|Display]]` | `[[business/crm/techco\|TechCo]]` | + +### Где добавлять связи (с typed context) + +**В daily file (комментарий):** +```markdown +## 10:30 [voice] +Позвонил в Acme Corp по проекту + +``` + +**В thoughts (Related section с context phrases):** +```markdown +## Related +- [[business/crm/techco|TechCo]] — context: обсуждение BTL стратегии +- [[business/crm/phonebrand|PhoneBrand]] — extends: SMM стратегия 2026 +``` + +**В задаче Todoist (description):** +``` +Description: "Клиент: [[business/crm/acme-corp|Acme Corp]]" +``` + +--- + +## Report Section + +Track new links created: + +``` +🔗 Новые связи: +• [[Note A]] ↔ [[Note B]] +• [[New Thought]] → [[Related Project]] +``` + +## Example Workflow + +New thought: "Chatterbox TTS can be used for voice agents" + +1. **Search:** + - Grep "voice" in thoughts/ → finds [[Voice Agents Architecture]] + - Grep "TTS" in thoughts/ → no results + - Grep "Chatterbox" → no results + +2. **Check MOC:** + - MOC-learnings.md has "AI & Voice" section + +3. **Goals:** + - 1-yearly-2025.md has "AI Development" goal + +4. **Create links:** + ```yaml + related: + - "[[thoughts/ideas/voice-agents-architecture.md]]" + - "[[goals/1-yearly-2025#AI Development]]" + ``` + +5. **Update MOC-learnings.md:** + ```markdown + ### AI & Voice + - [[thoughts/learnings/2024-12-20-chatterbox-tts.md]] — TTS for voice agents + ``` + +6. **Report:** + ``` + 🔗 Новые связи: + • [[Chatterbox TTS]] ↔ [[Voice Agents Architecture]] + ``` + +## Orphan Detection + +A note is "orphan" if: +- No incoming links from other notes +- No related notes in frontmatter +- Not listed in any MOC + +Flag orphans for review: +``` +⚠️ Изолированные заметки: +• [[thoughts/ideas/orphan-note.md]] +``` diff --git a/vault/.claude/skills/dbrain-processor/references/process-goals.md b/vault/.claude/skills/dbrain-processor/references/process-goals.md new file mode 100644 index 0000000..d20f2c7 --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/references/process-goals.md @@ -0,0 +1,108 @@ +# Process Goals + +## Concept + +**Outcome goals** focus on WHAT you want to achieve: +- "Close the deal" +- "Hit $1M ARR" +- "Launch the product" + +**Process goals** focus on HOW you do it: +- "Reach out to 100 potential clients" +- "Send 5 proposals per week" +- "Conduct 3 customer interviews this week" + +## Why Process Goals Work Better + +Based on research (meta-analysis of 27 experiments in sports): + +1. **Control** — You control actions, not outcomes. "Close deal" creates anxiety; "send 3 follow-ups" is actionable. +2. **Confidence** — Process goals turn challenge into achievable steps, boosting self-efficacy. +3. **Focus** — Daily clarity on what to do, not vague aspiration. + +## How to Transform + +| Outcome Goal | Process Goal | +|--------------|--------------| +| "Закрыть сделку с [Client A]" | "Отправлять 1 follow-up в день клиенту [Client A]" | +| "Запустить продукт" | "2h deep work на MVP каждое утро" | +| "Привлечь 10 клиентов" | "Написать 5 outreach сообщений в день" | +| "Подготовить программу" | "30 мин research аналогов ежедневно" | +| "Найти партнёра" | "1 нетворкинг сообщение в день" | + +## Patterns for Process Goals + +### Time Blocks +Regular dedicated time for deep work: +- "2h deep work на [project] каждое утро 6-8am" +- "1h research [topic] после обеда" + +### Frequency Commitments +Consistent action cadence: +- "1 outreach message в день" +- "3 customer calls в неделю" +- "5 proposals в неделю" + +### Checkpoints +Review milestones: +- "Показать драфт 1 человеку до пятницы" +- "Review прогресс с ментором в среду" + +### Streaks +Daily habits: +- "30 мин движения каждый день" +- "10 мин journaling утром" + +## When Processing Voice Entries + +If user says outcome goal, consider transforming: + +``` +User: "Нужно закрыть сделку с [Client A]" + +BAD: Create task "Закрыть сделку с [Client A]" p1 +→ Vague, creates anxiety, unclear next action + +GOOD: Create task "Отправить follow-up [Client A] с обновлённым КП" p1 due:tomorrow +→ Specific, actionable, controllable +``` + +## For Weekly Planning + +When generating Process Commitments for ONE Big Thing: + +1. **Ask:** What daily/weekly habits would make this inevitable? +2. **Limit:** 3-5 process commitments max +3. **Prioritize:** Time blocks > Frequency > Checkpoints +4. **Create:** Recurring tasks in Todoist with appropriate patterns + +## Recurring Task Patterns + +Map process goals to Todoist dueString: + +| Process | dueString | +|---------|-----------| +| "каждое утро" | "every day at 6am" | +| "каждый день" | "every day" | +| "каждый рабочий день" | "every weekday" | +| "3 раза в неделю" | "every monday, wednesday, friday" | +| "раз в неделю" | "every week" | +| "до пятницы" | "friday" (one-time) | + +## Anti-Patterns + +Avoid creating process goals that are: +- Too vague: "Работать над проектом" (how much? when?) +- Too ambitious: "4h deep work 5 days a week" (unsustainable) +- Untrackable: "Думать о стратегии" (not measurable) + +Good process goals are: +- Specific in action +- Bounded in time/frequency +- Trackable (done/not done) + +## Reference + +Based on: Meta-analysis of 27 experiments in sports showing process goals significantly outperform outcome/performance goals. + +See also: "The Success Equation" by Mauboussin — Results = Skill + Luck. Focus on skill (process) is the only controllable strategy. diff --git a/vault/.claude/skills/dbrain-processor/references/report-template.md b/vault/.claude/skills/dbrain-processor/references/report-template.md new file mode 100644 index 0000000..a549e6f --- /dev/null +++ b/vault/.claude/skills/dbrain-processor/references/report-template.md @@ -0,0 +1,141 @@ +# HTML Report Template + +## CRITICAL: Output Format + +**Return RAW HTML text only. No markdown wrappers.** + +WRONG (markdown code block): +```html +Title +``` + +CORRECT (raw HTML): +Title + +Output goes directly to Telegram `parse_mode=HTML`. + +## Allowed Tags + + or — bold + or — italic + — inline code +
 — code blocks
+ or  or  — strikethrough
+ — underline
+text — links
+
+## FORBIDDEN
+
+NO markdown: **, ##, -, *, backticks
+NO code blocks with triple backticks
+NO tables (Telegram doesn't support)
+NO unsupported tags: div, span, br, p, table, tr, td
+
+## Template
+
+📊 Обработка за {DATE}
+
+🎯 Текущий фокус:
+{ONE_BIG_THING from goals/3-weekly.md}
+
+📓 Сохранено мыслей: {N}
+• {emoji} {title} → {category}/
+
+✅ Создано задач: {M}
+• {task_name} ({priority}, {due})
+
+🏢 Business:
+• {client_name} — {action/status}
+{N} клиентов упомянуто
+
+📅 Загрузка на неделю:
+Пн: {n} | Вт: {n} | Ср: {n} | Чт: {n} | Пт: {n} | Сб: {n} | Вс: {n}
+
+⚠️ Требует внимания:
+• {count} просроченных задач
+• Цель "{goal}" без активности {days} дней
+
+🔗 Новые связи:
+• [[Note A]] ↔ [[Note B]]
+
+⚡ Топ-3 приоритета на завтра:
+1. {task} ({goal if aligned})
+2. {task}
+3. {task}
+
+📈 Прогресс по целям:
+• {goal_name}: {progress}% {emoji}
+
+---
+Обработано за {duration}
+
+## Section Rules
+
+### Focus (🎯)
+Read from goals/3-weekly.md, find "ONE Big Thing" section.
+If not found: "Не задан — обновите goals/3-weekly.md"
+
+### Thoughts (📓)
+Count saved, list with category emoji:
+💡 idea, 🪞 reflection, 🎯 project, 📚 learning
+
+### Tasks (✅)
+Count created, list with priority and due date.
+Format: • Task name (p2, friday)
+
+### Business Activity (🏢)
+Show ONLY if client/project mentions exist.
+- Max 5 clients
+- If CRM status changed → add note
+- Format: • {Client} — {action}
+- Footer: {N} клиентов упомянуто
+
+### Week Load (📅)
+Call find-tasks-by-date for 7 days.
+Format: Пн: 4 | Вт: 2 | ...
+
+### Attention (⚠️)
+Show only if issues exist.
+Check overdue tasks and stale goals (7+ days no activity).
+
+### Links (🔗)
+Show only if new links created.
+Format: • [[Note A]] ↔ [[Note B]]
+
+### Priorities (⚡)
+Get tomorrow's tasks from Todoist, sort by priority, show top 3.
+
+### Goals Progress (📈)
+Read goals/1-yearly-2026.md, show goals with recent activity.
+Emojis: 🔴 0-25%, 🟡 26-50%, 🟢 51-75%, ✅ 76-100%
+
+## Error Report
+
+❌ Ошибка обработки
+
+Причина: {error_message}
+Файл: {file_path}
+
+Попробуйте /process снова
+
+## Empty Report
+
+📭 Нет записей для обработки
+
+Файл daily/{date}.md пуст.
+
+Добавьте записи в течение дня
+
+## Length Limit
+
+Telegram max: 4096 characters.
+If exceeds: truncate "Новые связи" first, then keep only top 3 goals.
+
+## Validation Checklist
+
+Before returning report:
+1. All tags closed
+2. No raw < or > in text (use < >)
+3. No markdown syntax
+4. No tables
+5. Length under 4096 chars
diff --git a/vault/.claude/skills/dbrain-processor/references/rules.md b/vault/.claude/skills/dbrain-processor/references/rules.md
new file mode 100644
index 0000000..d26ca17
--- /dev/null
+++ b/vault/.claude/skills/dbrain-processor/references/rules.md
@@ -0,0 +1,85 @@
+# Critical Processing Rules
+
+See [ABOUT.md](ABOUT.md) for user context and preferences.
+
+## Rule 1: Skip Processed Entries
+
+```
+If entry contains ``
+
+## Rule 4: Consider Workload
+
+**BEFORE creating tasks:**
+
+1. Call `find-tasks-by-date` with `startDate: "today"`, `daysCount: 7`
+2. Count tasks per day
+3. If target day has 3+ tasks → shift to next day with less load
+
+## Rule 5: Mark After Processing
+
+After EACH processed entry, add marker:
+
+```markdown
+
+```
+
+For tasks with details:
+```markdown
+
+```
+
+## Rule 6: Apply Decision Filters
+
+Before saving any thought or task, check:
+- Это масштабируется?
+- Это можно автоматизировать?
+- Это усиливает экспертизу [Your Business]?
+- Это приближает к продукту/SaaS?
+
+If 2+ yes → boost priority.
+
+## Rule 7: Avoid Anti-Patterns
+
+NEVER create:
+- Абстрактные задачи без Next Action ("Подумать о...")
+- Хаотичные списки без приоритетов
+- Повторы без синтеза
+- Академическая теория без применения
+
+See [ABOUT.md](ABOUT.md) → Anti-Patterns section.
+
+---
+
+## Checklist Before Completion
+
+- [ ] All new entries processed
+- [ ] No duplicates in Todoist
+- [ ] All tasks have dates and concrete actions
+- [ ] Decision filters applied
+- [ ] Anti-patterns avoided
+- [ ] MOC files updated
+- [ ] Report generated
diff --git a/vault/.claude/skills/dbrain-processor/references/todoist.md b/vault/.claude/skills/dbrain-processor/references/todoist.md
new file mode 100644
index 0000000..310f9c2
--- /dev/null
+++ b/vault/.claude/skills/dbrain-processor/references/todoist.md
@@ -0,0 +1,280 @@
+# Todoist Integration
+
+## Task Links Format
+
+ВАЖНО: Todoist изменил формат ссылок. Используй НОВЫЙ формат:
+
+✅ Правильно: `https://app.todoist.com/app/task/{task_id}`
+❌ Устарело: `https://todoist.com/showTask?id={task_id}`
+❌ Устарело: `https://todoist.com/app/task/{task_id}`
+
+Если MCP tool вернул task с `url` полем — используй его напрямую.
+Если нужно построить ссылку из task_id — используй формат выше.
+
+---
+
+## Todoist через mcp-cli
+
+**ВСЕГДА используй mcp-cli. НЕ используй MCP tools напрямую.**
+
+### Reading Tasks
+
+```bash
+# Обзор всех проектов
+mcp-cli call todoist get-overview '{}'
+
+# Поиск по тексту, проекту, секции
+mcp-cli call todoist find-tasks '{"searchText": "keyword"}'
+
+# Задачи по дате
+mcp-cli call todoist find-tasks-by-date '{"startDate": "today", "daysCount": 7}'
+```
+
+### Writing Tasks
+
+```bash
+# Создать задачу
+mcp-cli call todoist add-tasks '{"tasks": [{"content": "Task", "dueString": "tomorrow", "priority": 2}]}'
+
+# Завершить задачу
+mcp-cli call todoist complete-tasks '{"ids": ["task_id"]}'
+
+# Обновить задачу
+mcp-cli call todoist update-tasks '{"tasks": [{"id": "task_id", "content": "New title"}]}'
+```
+
+---
+
+## Pre-Creation Checklist
+
+### 1. Check Workload (REQUIRED)
+
+```bash
+mcp-cli call todoist find-tasks-by-date '{"startDate": "today", "daysCount": 7, "limit": 50}'
+```
+
+Build workload map:
+```
+Mon: 2 tasks
+Tue: 4 tasks  ← overloaded
+Wed: 1 task
+Thu: 3 tasks  ← at limit
+Fri: 2 tasks
+Sat: 0 tasks
+Sun: 0 tasks
+```
+
+### 2. Check Duplicates (REQUIRED)
+
+```bash
+mcp-cli call todoist find-tasks '{"searchText": "key words from new task"}'
+```
+
+If similar exists → mark as duplicate, don't create.
+
+---
+
+## Priority by Domain
+
+Based on user's work context (see [ABOUT.md](ABOUT.md)):
+
+| Domain | Default Priority | Override |
+|--------|-----------------|----------|
+| Client Work | p1-p2 | — |
+| Agency Ops (urgent) | p2 | — |
+| Agency Ops (regular) | p3 | — |
+| Content (with deadline) | p2-p3 | — |
+| Product/R&D | p4 | масштабируемость → p3 |
+| AI & Tech | p4 | автоматизация → p3 |
+
+### Priority Keywords
+
+| Keywords in text | Priority |
+|-----------------|----------|
+| срочно, критично, дедлайн клиента | p1 |
+| важно, приоритет, до конца недели | p2 |
+| нужно, надо, не забыть | p3 |
+| (strategic, R&D, long-term) | p4 |
+
+### Apply Decision Filters for Priority Boost
+
+If entry matches 2+ filters → boost priority by 1 level:
+- Это масштабируется?
+- Это можно автоматизировать?
+- Это усиливает экспертизу [Your Business]?
+- Это приближает к продукту/SaaS?
+
+---
+
+## Date Mapping
+
+| Context | dueString |
+|---------|-----------|
+| **Client deadline** | exact date |
+| **Urgent ops** | today / tomorrow |
+| **This week** | friday |
+| **Next week** | next monday |
+| **Strategic/R&D** | in 7 days |
+| **Not specified** | in 3 days |
+
+### Russian → dueString
+
+| Russian | dueString |
+|---------|-----------|
+| сегодня | today |
+| завтра | tomorrow |
+| послезавтра | in 2 days |
+| в понедельник | monday |
+| в пятницу | friday |
+| на этой неделе | friday |
+| на следующей неделе | next monday |
+| через неделю | in 7 days |
+| 15 января | January 15 |
+
+---
+
+## Task Creation
+
+```bash
+mcp-cli call todoist add-tasks '{"tasks": [{"content": "Task title", "dueString": "friday", "priority": 4}]}'
+```
+
+С projectId:
+```bash
+mcp-cli call todoist add-tasks '{"tasks": [{"content": "Task title", "dueString": "friday", "priority": 4, "projectId": "..."}]}'
+```
+
+### Task Title Style
+
+User prefers: прямота, ясность, конкретика
+
+✅ Good:
+- "Отправить презентацию [Client A]"
+- "Созвон с командой по AI-агентам"
+- "Написать пост про Claude MCP"
+
+❌ Bad:
+- "Подумать о презентации"
+- "Что-то с клиентом"
+- "Разобраться с AI"
+
+### Workload Balancing
+
+If target day has 3+ tasks:
+1. Find next day with < 3 tasks
+2. Use that day instead
+3. Mention in report: "сдвинуто на {day} (перегрузка)"
+
+---
+
+## Project Detection
+
+Based on work domains:
+
+| Keywords | Project |
+|----------|---------|
+| [Client A], [Client B], клиент, бренд | Client Work |
+| [Your Business], агентство, команда, найм | Agency Ops |
+| продукт, SaaS, MVP | Product |
+| пост, @yourbrand, контент | Content |
+
+If unclear → use Inbox (no projectId).
+
+---
+
+## Client Labels
+
+При создании задач связанных с клиентом, добавляй label.
+
+### Format
+`client:{kebab-case-name}`
+
+### Примеры
+- client:acme-corp
+- client:techco
+- client:phonebrand
+
+### Использование
+```bash
+mcp-cli call todoist add-tasks '{"tasks": [{"content": "Follow-up [Client A] по проекту", "labels": ["client:acme-corp", "deadline"]}]}'
+```
+
+### Фильтр в Todoist
+`@client:acme-corp` — все задачи по [Client A]
+
+---
+
+## Anti-Patterns (НЕ СОЗДАВАТЬ)
+
+Based on user preferences:
+
+- ❌ "Подумать о..." → конкретизируй действие
+- ❌ "Разобраться с..." → что именно сделать?
+- ❌ Абстрактные задачи без Next Action
+- ❌ Дубликаты существующих задач
+- ❌ Задачи без дат
+
+---
+
+## Error Handling
+
+CRITICAL: Никогда не предлагай "добавить вручную".
+
+If `add-tasks` fails:
+1. Include EXACT error message in report
+2. Continue with next entry
+3. Don't mark as processed
+4. User will see error and can debug
+
+WRONG output:
+  "Не удалось добавить (MCP недоступен). Добавь вручную: Task title"
+
+CORRECT output:
+  "Ошибка создания задачи: [exact error from MCP tool]"
+
+---
+
+## Recurring Tasks for Process Goals
+
+When creating process commitments → use dueString with recurring pattern.
+
+### Recurring Patterns
+
+| Process Description | dueString |
+|---------------------|-----------|
+| каждое утро в 6 | every day at 6am |
+| каждый день | every day |
+| каждый рабочий день | every weekday |
+| 3 раза в неделю | every monday, wednesday, friday |
+| раз в неделю | every week |
+| каждый понедельник | every monday |
+| каждую пятницу | every friday |
+
+### Example: Creating Process Goal Tasks
+
+```bash
+mcp-cli call todoist add-tasks '{"tasks": [
+  {"content": "2h deep work: программа [Client B]", "dueString": "every day at 6am", "priority": 2, "labels": ["process-goal"]},
+  {"content": "1 outreach для поиска 2го спикера", "dueString": "every weekday", "priority": 3, "labels": ["process-goal"]}
+]}'
+```
+
+### Label for Process Goals
+
+Use label `process-goal` for recurring tasks created from Process Commitments.
+This allows easy filtering and cleanup.
+
+### When to Create Recurring
+
+Create recurring tasks when:
+- Generating weekly digest (new week planning)
+- User explicitly asks for process goal setup
+- Transforming outcome goal to process (if user confirms)
+
+### Cleanup Stale Recurring
+
+In weekly digest, check:
+```bash
+mcp-cli call todoist find-tasks '{"labels": ["process-goal"]}'
+```
+If task from previous week → warn user to complete or delete
diff --git a/vault/.claude/skills/graph-builder/SKILL.md b/vault/.claude/skills/graph-builder/SKILL.md
new file mode 100644
index 0000000..3dc5fd6
--- /dev/null
+++ b/vault/.claude/skills/graph-builder/SKILL.md
@@ -0,0 +1,210 @@
+---
+name: graph-builder
+description: Analyze and build knowledge graph links in Obsidian vault. Runs a deterministic script for analysis, then the agent adds semantic links to orphan files. Three domains: Personal, Business, Projects.
+allowed-tools: Bash(uv run:*), Bash(rg:*), Read, Edit
+depends_on: []
+---
+
+# Graph Builder
+
+Analyze vault link structure and build meaningful connections between notes.
+
+## Architecture
+
+```
++------------------------------------------+
+|  1. SCRIPT analyze.py (deterministic)    |
+|     -> vault-graph.json + report.md      |
++-----------------+------------------------+
+                  |
+                  v
++------------------------------------------+
+|  2. AGENT (you)                          |
+|     -> orphan analysis                   |
+|     -> semantic links                    |
+|     -> frontmatter updates               |
+|     -> HTML report                       |
++------------------------------------------+
+```
+
+## Trigger
+
+- `/graph` -- manual run
+- After `dbrain-processor` in chain (optional)
+- Weekly: full rebuild
+
+---
+
+## STEP 1: Run the script
+
+```bash
+uv run vault/.claude/skills/graph-builder/scripts/analyze.py
+```
+
+**Script does:**
+1. Traverses all .md files in vault/
+2. Parses frontmatter
+3. Extracts wiki-links `[[path]]` and `[[path|alias]]`
+4. Determines domain (business, projects, personal)
+5. Finds orphan files (no links)
+6. Finds broken links
+7. Generates `vault/.graph/vault-graph.json`
+8. Generates `vault/.graph/report.md`
+
+**CRITICAL:** Always run the script first! It provides up-to-date data.
+
+---
+
+## STEP 2: Read script output
+
+Read `vault/.graph/vault-graph.json`:
+
+```json
+{
+  "stats": {
+    "total_files": 331,
+    "orphan_files": 147,
+    "broken_links": 167
+  },
+  "orphans": ["path/to/file.md", ...],
+  "broken_links": [{"from": "...", "to": "..."}, ...]
+}
+```
+
+---
+
+## STEP 3: Analyze orphan files
+
+For each orphan file (start with **non-daily** files):
+
+1. **Read the file content**
+2. **Find potential links:**
+   - Company mentions -> `business/crm/{company}.md`
+   - People mentions -> search in contacts/
+   - Tags -> files with matching tags
+   - Dates -> daily/ for that day
+   - Topics -> thoughts/learnings/, MOC/
+
+3. **Suggest links** -- add to frontmatter `related: []`
+
+### Link search patterns
+
+| Mention | Link |
+|---------|------|
+| Acme Corp, Acme | `[[business/crm/acme-corp]]` |
+| PhoneBrand | `[[business/crm/phone-brand]]` |
+| TechCo | `[[business/crm/tech-co]]` |
+| SchoolCo | `[[projects/leads/school-co]]` |
+| AutoDealer | `[[projects/leads/auto-dealer]]` |
+| AI, Claude, GPT | thoughts/learnings/ with AI topic |
+
+---
+
+## STEP 4: Update frontmatter
+
+**Link format in frontmatter:**
+
+```yaml
+---
+type: learning
+domain: personal
+tags: [ai, marketing]
+related:
+  - "[[business/crm/acme-corp]]"
+  - "[[projects/leads/school-co]]"
+  - "[[thoughts/learnings/agent-memory-system]]"
+---
+```
+
+**Rules:**
+- Only add real links (file exists)
+- Do not duplicate existing links
+- Maximum 5-7 links per file
+- Use `"[[path]]"` format with quotes
+
+---
+
+## STEP 5: Update MOC (if needed)
+
+Check MOC files:
+- `MOC/MOC-learnings.md` -- add new learnings
+- `MOC/MOC-projects.md` -- create if missing
+
+---
+
+## STEP 6: HTML report
+
+**Return RAW HTML for Telegram:**
+
+Graph Builder Report
+
+Analyzed:
+- Files: {total_files}
+- Links: {total_links}
+- Orphans: {orphan_files}
+- Broken links: {broken_links}
+
+Business: {files} files, {links} links
+Projects: {files} files, {links} links
+Personal: {files} files, {links} links
+
+Links added: {count}
+- {file1} -> {file2}
+- {file3} -> {file4}
+
+Needs attention:
+- {broken_count} broken links
+- {orphan_count} orphan files
+
+Details: vault/.graph/report.md
+
+---
+
+## Three domains
+
+### Personal
+- `thoughts/` -- learnings, ideas, reflections
+- `goals/` -- yearly, monthly, weekly
+- `daily/` -- raw entries
+- **Hub:** `MEMORY.md`
+
+### Business
+- `business/crm/` -- clients + deals (N files)
+- `business/network/` -- org structure
+- **Hub:** `business/_index.md`
+
+### Projects
+- `projects/clients/` -- project clients
+- `projects/leads/` -- leads
+- **Hub:** `projects/_index.md`
+
+---
+
+## Orphan processing priority
+
+1. **business/crm/** -- business-critical, many orphans
+2. **thoughts/learnings/** -- valuable knowledge
+3. **projects/** -- active projects
+4. **daily/** -- old entries (low priority)
+
+---
+
+## Do not
+
+- Do not change file content (only frontmatter)
+- Do not add links to non-existent files
+- Do not process files in .obsidian/, attachments/, backup/
+- Do not create new files without reason
+
+---
+
+## References
+
+- `references/domains.md` -- domain details
+- `references/entities.md` -- entity patterns
+- `references/frontmatter.md` -- frontmatter schema
+
+## Relevant Skills
+
+- [[vault/.claude/skills/vault-health/SKILL|vault-health]] -- Health scoring, MOC generation, link repair (depends on this skill)
+- [[vault/.claude/skills/dbrain-processor/SKILL|dbrain-processor]] -- Daily entry processing
diff --git a/vault/.claude/skills/graph-builder/references/domains.md b/vault/.claude/skills/graph-builder/references/domains.md
new file mode 100644
index 0000000..0052055
--- /dev/null
+++ b/vault/.claude/skills/graph-builder/references/domains.md
@@ -0,0 +1,123 @@
+# Domains
+
+Three knowledge organization domains in the vault.
+
+## Personal
+
+**Path:** `thoughts/`, `goals/`, `daily/`, `MOC/`, `MEMORY.md`
+
+**Content:**
+- Personal thoughts and reflections
+- Goals (yearly -> monthly -> weekly)
+- Daily entries
+- Learnings and ideas
+
+**Hub:** `MEMORY.md` -- central context
+
+**Frontmatter:**
+```yaml
+domain: personal
+type: learning | reflection | idea | project
+```
+
+---
+
+## Business
+
+**Path:** `business/`
+
+**Structure:**
+```
+business/
++-- _index.md       # Entry point, dataview queries
++-- crm/            # Clients + deals
+|   +-- acme-corp.md
+|   +-- client-b.md
+|   +-- ...
++-- network/        # Org structure (Your Holding)
+|   +-- founders.md
+|   +-- partner-a.md
+|   +-- partner-b.md
++-- events/         # Events
+```
+
+**Hub:** `business/_index.md`
+
+**Frontmatter (CRM):**
+```yaml
+domain: business
+type: crm
+industry: FMCG | Electronics | Banks | Pharma | Retail
+priority: High | Mid | Low
+status: Active | Prospect | Dormant | Declined
+region: UZ | KZ | BY
+owner: [Your Name] | [Team Member]
+deal_status: In progress | Tender | Proposal sent
+deal_deadline: YYYY-MM-DD
+```
+
+**Key clients:**
+- Client-A (FMCG, High, Active)
+- Client-B (Electronics, High, Active)
+- Client-C (Electronics, Mid, Active)
+- Client-D (FMCG, Mid, Prospect)
+
+---
+
+## Projects
+
+**Path:** `projects/`
+
+**Structure:**
+```
+projects/
++-- _index.md       # Entry point
++-- clients/        # Project clients
+|   +-- client-a.md
+|   +-- client-b.md
+|   +-- client-c.md
+|   +-- client-d.md
++-- leads/          # Leads
+    +-- lead-a.md
+    +-- lead-b.md
+```
+
+**Hub:** `projects/_index.md`
+
+**Frontmatter:**
+```yaml
+domain: projects
+type: client | lead
+company: Name
+industry: Auto | IT | Retail | Education
+status: APPROVED | Proposal sent | Hot | Cold
+responsible: Name
+```
+
+**Difference from Business:**
+- Business = main business (agency, services)
+- Projects = personal side projects (consulting, training)
+
+---
+
+## Cross-domain links
+
+| Link | Example |
+|------|---------|
+| Projects -> Business | `lead-a` -> `partner-b` (partner) |
+| Personal -> Business | `learning` -> `acme-corp` (case from practice) |
+| Personal -> Projects | `learning` -> `client-a` (insight from training) |
+| Business -> Contacts | `acme-corp` -> contacts (contacts) |
+
+---
+
+## Determining domain by path
+
+```python
+def get_domain(path: Path) -> str:
+    if "business" in path.parts:
+        return "business"
+    elif "projects" in path.parts:
+        return "projects"
+    return "personal"
+```
diff --git a/vault/.claude/skills/graph-builder/references/entities.md b/vault/.claude/skills/graph-builder/references/entities.md
new file mode 100644
index 0000000..09cca3e
--- /dev/null
+++ b/vault/.claude/skills/graph-builder/references/entities.md
@@ -0,0 +1,157 @@
+# Entity Extraction Patterns
+
+Patterns for finding entities in text.
+
+## Companies (Business CRM)
+
+### Exact matches
+
+| Pattern | File |
+|---------|------|
+| Client-A, ClientA | `business/crm/client-a.md` |
+| Client-B | `business/crm/client-b.md` |
+| Client-C | `business/crm/client-c.md` |
+| Client-D | `business/crm/client-d.md` |
+| Client-E | `business/crm/client-e.md` |
+| Client-F | `business/crm/client-f.md` |
+| Client-G | `business/crm/client-g.md` |
+| Client-H | `business/crm/client-h.md` |
+| Client-I | `business/crm/client-i.md` |
+| Client-J | `business/crm/client-j.md` |
+
+### Regex for companies
+
+```python
+COMPANY_PATTERNS = [
+    r'\b(Client-A|ClientA)\b',
+    r'\b(Client-B)\b',
+    r'\b(Client-C)\b',
+    r'\b(Client-D)\b',
+    r'\b(Client-E)\b',
+    r'\bClient-F\b',
+    r'\b(Client-G)\b',
+    r'\bClient-H\b',
+    r'\bClient-I\b',
+]
+```
+
+---
+
+## Companies (Projects)
+
+| Pattern | File |
+|---------|------|
+| Project-Client-A | `projects/clients/project-client-a.md` |
+| Project-Client-B | `projects/clients/project-client-b.md` |
+| Project-Client-C | `projects/clients/project-client-c.md` |
+| Project-Client-D | `projects/clients/project-client-d.md` |
+| Lead-A | `projects/leads/lead-a.md` |
+| Lead-B | `projects/leads/lead-b.md` |
+
+---
+
+## People
+
+### Name format
+
+```python
+# Names in your language
+LOCAL_NAME = r'[A-Z][a-z]+\s+[A-Z][a-z]+'
+# Examples: [First Name] [Last Name]
+
+# English names
+ENGLISH_NAME = r'[A-Z][a-z]+\s+[A-Z][a-z]+'
+# Examples: [First Name] [Last Name]
+```
+
+### Telegram handles
+
+```python
+TELEGRAM_HANDLE = r'@([a-zA-Z0-9_]+)'
+# Examples: @username1, @username2, @username3
+```
+
+---
+
+## Projects
+
+### Project patterns
+
+```python
+PROJECT_PATTERNS = [
+    r'project\s+([A-Za-z0-9\s]+)',
+    r'(?:NCP|SMM|BTL|ATL)\s+([A-Za-z]+)',
+    r'tender\s+([A-Za-z]+)',
+]
+```
+
+### Active projects
+
+| Mention | Link |
+|---------|------|
+| Client-A Campaign | `business/crm/client-a.md` |
+| Client-B SMM | `business/crm/client-b.md` |
+| Client-C Project | `business/crm/client-c.md` |
+
+---
+
+## Topics (for learnings)
+
+| Keywords | Links to |
+|----------|----------|
+| Claude, AI agent, LLM | `thoughts/learnings/` with AI |
+| Second Brain, Obsidian, PKM | Methodology |
+| Zettelkasten, graph | Knowledge organization |
+| Prompt, prompt engineering | AI techniques |
+| Marketing, SMM, content | Business |
+
+---
+
+## Finding file for entity
+
+```python
+def find_file_for_entity(entity: str, vault_path: Path) -> Path | None:
+    """Find file for an entity."""
+
+    # Normalize: Client-A -> client-a
+    slug = entity.lower().replace(" ", "-")
+
+    # Search in CRM
+    crm_path = vault_path / "business" / "crm" / f"{slug}.md"
+    if crm_path.exists():
+        return crm_path
+
+    # Search in Projects
+    for subdir in ["clients", "leads"]:
+        path = vault_path / "projects" / subdir / f"{slug}.md"
+        if path.exists():
+            return path
+
+    # Fuzzy search by filename
+    for f in vault_path.rglob("*.md"):
+        if slug in f.stem.lower():
+            return f
+
+    return None
+```
+
+---
+
+## Link normalization
+
+```python
+def normalize_link(link: str) -> str:
+    """Normalize wiki-link."""
+
+    # Remove section: [[file#section]] -> file
+    link = link.split("#")[0]
+
+    # Remove alias: [[file|alias]] -> file
+    link = link.split("|")[0]
+
+    # Add .md if missing
+    if not link.endswith(".md"):
+        link = link + ".md"
+
+    return link
+```
diff --git a/vault/.claude/skills/graph-builder/references/frontmatter.md b/vault/.claude/skills/graph-builder/references/frontmatter.md
new file mode 100644
index 0000000..eab5a9a
--- /dev/null
+++ b/vault/.claude/skills/graph-builder/references/frontmatter.md
@@ -0,0 +1,252 @@
+# Frontmatter Schema
+
+YAML frontmatter schema for vault files.
+
+## Basic schema (all files)
+
+```yaml
+---
+type: string       # Record type (see below)
+domain: string     # business | projects | personal
+description: string # Retrieval filter ~150 chars (NOT summary -- adds scope/mechanism/implication beyond title)
+tags: [string]     # Tags for categorization
+related: [string]  # Wiki-links to related files
+created: date      # Creation date (YYYY-MM-DD)
+updated: date      # Update date
+---
+```
+
+### Description field
+
+**NOT a summary** -- description adds information BEYOND the title, does not repeat it.
+This is a **retrieval filter**: the agent reads title + description and decides whether to open the file.
+
+**Rules:**
+- ~150 characters max
+- Adds scope, mechanism or implication
+- Does NOT repeat the title
+- Specifics > abstractions
+
+**Examples:**
+
+```yaml
+# CRM (title = acme-corp.md):
+description: "Major FMCG client, Project $XXK active deal, promo codes in progress"
+
+# Thought (title = 2026-02-05-hormonal-agent-algorithm.md):
+description: "4 hormones as sine waves + noise -> mood -> intentions. Gives agent free will."
+
+# Learning (title = 2026-01-30-session-persistence.md):
+description: "JSONL append-only files for interaction history. Pattern from Clawdbot."
+```
+
+---
+
+## Record types
+
+### Personal domain
+
+| type | Folder | Description |
+|------|--------|-------------|
+| learning | thoughts/learnings/ | Knowledge, discoveries, TIL |
+| idea | thoughts/ideas/ | Ideas, concepts |
+| reflection | thoughts/reflections/ | Reflections, conclusions |
+| project | thoughts/projects/ | Project notes |
+
+### Business domain
+
+| type | Folder | Description |
+|------|--------|-------------|
+| crm | business/crm/ | Client + deals |
+| network | business/network/ | Org structure |
+| event | business/events/ | Events |
+
+### Projects domain
+
+| type | Folder | Description |
+|------|--------|-------------|
+| client | projects/clients/ | Project client |
+| lead | projects/leads/ | Lead |
+
+---
+
+## CRM Schema (business/crm/)
+
+```yaml
+---
+type: crm
+domain: business
+description: string          # Retrieval filter: key client context (~150 chars)
+industry: FMCG | Electronics | Banks | Pharma | Retail | Auto | IT | Telecom
+priority: High | Mid | Low
+status: Active | Prospect | Dormant | Declined
+region: UZ | KZ | BY | Global
+owner: [Your Name] | [Team Member]
+responsible: string          # Responsible person on client side
+
+# Active deal (if any)
+deal_status: In progress | Tender | Proposal sent | Meeting held
+deal_deadline: YYYY-MM-DD
+
+# Links
+related:
+  - "[[thoughts/learnings/...]]"
+
+updated: YYYY-MM-DD
+---
+```
+
+**Example:**
+
+```yaml
+---
+type: crm
+domain: business
+industry: FMCG
+priority: High
+status: Active
+region: UZ, KZ
+owner: [Your Name]
+deal_status: In progress
+deal_deadline: 2026-02-09
+updated: 2026-01-29
+---
+```
+
+---
+
+## Learning Schema (thoughts/learnings/)
+
+```yaml
+---
+type: learning
+domain: personal
+description: string          # Retrieval filter: key insight (~150 chars)
+tags: [ai, marketing, automation, ...]
+source: daily/YYYY-MM-DD.md | URL | @mention
+related:
+  - "[[business/crm/acme-corp]]"
+  - "[[projects/leads/lead-a]]"
+created: YYYY-MM-DD
+---
+```
+
+**Example:**
+
+```yaml
+---
+type: learning
+domain: personal
+tags: [ai, marketing, panel]
+source: event
+related:
+  - "[[projects/leads/lead-a]]"
+  - "[[business/network/partner-a]]"
+created: 2026-01-27
+---
+```
+
+---
+
+## Projects Client Schema
+
+```yaml
+---
+type: client
+domain: projects
+description: string          # Retrieval filter: client type and status (~150 chars)
+company: string
+industry: Auto | IT | Retail | Pharma | Education | Finance
+region: BY | UZ | KZ | RU
+status: APPROVED | Proposal sent | In progress | Completed
+responsible: string
+budget: string              # Optional
+related:
+  - "[[thoughts/learnings/...]]"
+updated: YYYY-MM-DD
+---
+```
+
+---
+
+## Projects Lead Schema
+
+```yaml
+---
+type: lead
+domain: projects
+description: string          # Retrieval filter: who and why (~150 chars)
+company: string
+industry: Education | IT | ...
+region: UZ | ...
+status: Hot | Warm | Cold | Contacted | Proposal sent
+source: string              # Where lead came from
+responsible: string
+next_action: string         # Next step
+related: []
+updated: YYYY-MM-DD
+---
+```
+
+---
+
+## Related format
+
+**Correct:**
+
+```yaml
+related:
+  - "[[business/crm/acme-corp]]"
+  - "[[thoughts/learnings/agent-memory-system]]"
+```
+
+**Incorrect:**
+
+```yaml
+# Without quotes (may break YAML)
+related:
+  - [[business/crm/acme-corp]]
+
+# With alias in frontmatter (redundant)
+related:
+  - "[[business/crm/acme-corp|Acme Corp]]"
+```
+
+---
+
+## Adding links by agent
+
+When updating frontmatter:
+
+1. **Read** existing frontmatter
+2. **Get** current `related: []`
+3. **Add** new links (no duplicates)
+4. **Verify** that files exist
+5. **Write** updated frontmatter
+
+```python
+def add_related(content: str, new_links: list[str]) -> str:
+    """Add links to frontmatter."""
+
+    # Parse frontmatter
+    match = re.match(r'^---\n(.*?)\n---', content, re.DOTALL)
+    if not match:
+        return content
+
+    fm = yaml.safe_load(match.group(1)) or {}
+
+    # Get current links
+    existing = set(fm.get("related", []))
+
+    # Add new (format with quotes)
+    for link in new_links:
+        formatted = f'[[{link}]]' if not link.startswith('[[') else link
+        existing.add(formatted)
+
+    # Update
+    fm["related"] = sorted(list(existing))
+
+    # Write
+    new_fm = yaml.dump(fm, allow_unicode=True, default_flow_style=False)
+    return f"---\n{new_fm}---\n" + content[match.end():]
+```
diff --git a/vault/.claude/skills/graph-builder/scripts/add_links.py b/vault/.claude/skills/graph-builder/scripts/add_links.py
new file mode 100644
index 0000000..2a2669a
--- /dev/null
+++ b/vault/.claude/skills/graph-builder/scripts/add_links.py
@@ -0,0 +1,247 @@
+#!/usr/bin/env python3
+"""
+Link Builder for Obsidian Vault
+
+Suggests and adds wiki-links based on content analysis.
+Run with: uv run add_links.py [vault_path] [--dry-run]
+"""
+
+import re
+import sys
+from pathlib import Path
+from collections import defaultdict
+
+
+def extract_existing_links(content: str) -> set[str]:
+    """Extract existing [[wiki-links]] from content."""
+    pattern = r'\[\[([^\]|]+)(?:\|[^\]]+)?\]\]'
+    return set(re.findall(pattern, content))
+
+
+def find_mentions(content: str, note_titles: set[str]) -> list[tuple[str, int]]:
+    """Find mentions of note titles in content without existing links."""
+    existing = extract_existing_links(content)
+    mentions = []
+
+    for title in note_titles:
+        if title in existing:
+            continue
+        if len(title) < 3:  # Skip very short titles
+            continue
+
+        # Case-insensitive search for title
+        pattern = rf'\b{re.escape(title)}\b'
+        for match in re.finditer(pattern, content, re.IGNORECASE):
+            mentions.append((title, match.start()))
+
+    return mentions
+
+
+def suggest_moc_links(note_path: Path, moc_mapping: dict[str, str]) -> list[str]:
+    """Suggest MOC links based on domain/tags."""
+    suggestions = []
+    domain = note_path.parts[0] if len(note_path.parts) > 1 else None
+
+    if domain and domain in moc_mapping:
+        suggestions.append(moc_mapping[domain])
+
+    return suggestions
+
+
+def build_moc_mapping(vault_path: Path) -> dict[str, str]:
+    """Build mapping from domains to their MOC files."""
+    mapping = {}
+    moc_dir = vault_path / "MOC"
+
+    if moc_dir.exists():
+        for moc_file in moc_dir.glob("*.md"):
+            moc_name = moc_file.stem
+            # Map common domain patterns
+            domain_patterns = {
+                "ideas": "thoughts",
+                "learnings": "thoughts",
+                "reflections": "thoughts",
+                "projects": "projects",
+                "goals": "goals",
+            }
+            for pattern, domain in domain_patterns.items():
+                if pattern.lower() in moc_name.lower():
+                    mapping[domain] = moc_name
+
+    return mapping
+
+
+def analyze_and_suggest(vault_path: Path) -> dict:
+    """Analyze vault and suggest new links."""
+    suggestions: dict[str, list[dict]] = defaultdict(list)
+
+    # Collect all note titles
+    md_files = list(vault_path.rglob("*.md"))
+    md_files = [
+        f for f in md_files
+        if not any(part.startswith('.') for part in f.relative_to(vault_path).parts)
+    ]
+
+    note_titles = {f.stem for f in md_files}
+    moc_mapping = build_moc_mapping(vault_path)
+
+    for md_file in md_files:
+        rel_path = md_file.relative_to(vault_path)
+        title = md_file.stem
+        content = md_file.read_text(encoding="utf-8", errors="ignore")
+
+        # Find unlinked mentions
+        mentions = find_mentions(content, note_titles - {title})
+        for mentioned_title, position in mentions:
+            suggestions[title].append({
+                "type": "mention",
+                "target": mentioned_title,
+                "position": position,
+                "reason": f"'{mentioned_title}' mentioned but not linked",
+            })
+
+        # Suggest MOC links for orphan notes
+        existing_links = extract_existing_links(content)
+        moc_suggestions = suggest_moc_links(rel_path, moc_mapping)
+        for moc in moc_suggestions:
+            if moc not in existing_links:
+                suggestions[title].append({
+                    "type": "moc",
+                    "target": moc,
+                    "reason": f"Should link to [[{moc}]] MOC",
+                })
+
+    return dict(suggestions)
+
+
+def apply_link(file_path: Path, target: str, dry_run: bool = True) -> bool:
+    """Add a link to a note's related section."""
+    content = file_path.read_text(encoding="utf-8")
+
+    # Check if link already exists
+    if f"[[{target}]]" in content:
+        return False
+
+    # Find or create "Related" section
+    related_pattern = r'^## Related\s*$'
+    match = re.search(related_pattern, content, re.MULTILINE)
+
+    if match:
+        # Add to existing Related section
+        insert_pos = match.end()
+        new_content = content[:insert_pos] + f"\n- [[{target}]]" + content[insert_pos:]
+    else:
+        # Add Related section at end
+        new_content = content.rstrip() + f"\n\n## Related\n\n- [[{target}]]\n"
+
+    if dry_run:
+        print(f"[DRY RUN] Would add [[{target}]] to {file_path.name}")
+        return True
+
+    file_path.write_text(new_content, encoding="utf-8")
+    print(f"Added [[{target}]] to {file_path.name}")
+    return True
+
+
+def format_suggestions(suggestions: dict) -> str:
+    """Format suggestions as readable report."""
+    if not suggestions:
+        return "No link suggestions found. Vault is well-connected!"
+
+    lines = [
+        "# Link Suggestions",
+        "",
+        f"Found suggestions for {len(suggestions)} notes:",
+        "",
+    ]
+
+    for note, items in sorted(suggestions.items()):
+        lines.append(f"## [[{note}]]")
+        for item in items:
+            lines.append(f"- {item['type'].upper()}: Link to [[{item['target']}]]")
+            lines.append(f"  - Reason: {item['reason']}")
+        lines.append("")
+
+    return "\n".join(lines)
+
+
+def format_html(suggestions: dict) -> str:
+    """Format suggestions as Telegram HTML."""
+    if not suggestions:
+        return "✅ No link suggestions\n\nVault is well-connected!"
+
+    total = sum(len(v) for v in suggestions.values())
+
+    lines = [
+        f"🔗 Link Suggestions",
+        "",
+        f"Found: {total} suggestions for {len(suggestions)} notes",
+        "",
+    ]
+
+    # Show top 10 suggestions
+    count = 0
+    for note, items in sorted(suggestions.items(), key=lambda x: -len(x[1])):
+        if count >= 10:
+            remaining = total - count
+            lines.append(f"\n... and {remaining} more suggestions")
+            break
+        for item in items:
+            lines.append(f"• [[{note}]] → [[{item['target']}]]")
+            count += 1
+            if count >= 10:
+                break
+
+    return "\n".join(lines)
+
+
+def main():
+    dry_run = "--dry-run" in sys.argv or "-n" in sys.argv
+    apply_mode = "--apply" in sys.argv
+
+    # Get vault path
+    vault_path = None
+    for arg in sys.argv[1:]:
+        if not arg.startswith("-"):
+            vault_path = Path(arg)
+            break
+
+    if vault_path is None:
+        # Default: assume script is in vault/.claude/skills/graph-builder/scripts/
+        vault_path = Path(__file__).parent.parent.parent.parent.parent
+
+    if not vault_path.exists():
+        print(f"Error: Vault path not found: {vault_path}", file=sys.stderr)
+        sys.exit(1)
+
+    suggestions = analyze_and_suggest(vault_path)
+
+    if apply_mode:
+        # Apply all suggestions
+        applied = 0
+        for note, items in suggestions.items():
+            note_path = vault_path / f"{note}.md"
+            # Try to find the actual file
+            matches = list(vault_path.rglob(f"{note}.md"))
+            matches = [m for m in matches if not str(m).startswith('.')]
+
+            if matches:
+                note_path = matches[0]
+                for item in items:
+                    if apply_link(note_path, item["target"], dry_run):
+                        applied += 1
+
+        print(f"\n{'[DRY RUN] Would apply' if dry_run else 'Applied'} {applied} links")
+    else:
+        # Just report
+        if "--html" in sys.argv:
+            print(format_html(suggestions))
+        elif "--json" in sys.argv:
+            import json
+            print(json.dumps(suggestions, indent=2))
+        else:
+            print(format_suggestions(suggestions))
+
+
+if __name__ == "__main__":
+    main()
diff --git a/vault/.claude/skills/graph-builder/scripts/analyze.py b/vault/.claude/skills/graph-builder/scripts/analyze.py
new file mode 100644
index 0000000..d85bb8f
--- /dev/null
+++ b/vault/.claude/skills/graph-builder/scripts/analyze.py
@@ -0,0 +1,219 @@
+#!/usr/bin/env python3
+"""
+Graph Analyzer for Obsidian Vault
+
+Analyzes wiki-link structure and generates statistics.
+Run with: uv run analyze.py [vault_path]
+"""
+
+import re
+import sys
+from collections import defaultdict
+from pathlib import Path
+
+
+def extract_links(content: str) -> list[str]:
+    """Extract [[wiki-links]] from content."""
+    pattern = r'\[\[([^\]|]+)(?:\|[^\]]+)?\]\]'
+    return re.findall(pattern, content)
+
+
+def get_note_title(path: Path) -> str:
+    """Get note title from filename."""
+    return path.stem
+
+
+def analyze_vault(vault_path: Path) -> dict:
+    """Analyze vault link structure."""
+    notes: dict[str, dict] = {}
+    links_from: dict[str, set] = defaultdict(set)  # note -> set of linked notes
+    links_to: dict[str, set] = defaultdict(set)    # note -> set of notes linking to it
+
+    # Collect all markdown files
+    md_files = list(vault_path.rglob("*.md"))
+
+    # Skip hidden directories and .claude
+    md_files = [
+        f for f in md_files
+        if not any(part.startswith('.') for part in f.relative_to(vault_path).parts)
+    ]
+
+    # Build note index
+    for md_file in md_files:
+        rel_path = md_file.relative_to(vault_path)
+        title = get_note_title(md_file)
+        domain = str(rel_path.parts[0]) if len(rel_path.parts) > 1 else "root"
+
+        notes[title] = {
+            "path": str(rel_path),
+            "domain": domain,
+            "size": md_file.stat().st_size,
+        }
+
+    # Analyze links
+    for md_file in md_files:
+        title = get_note_title(md_file)
+        content = md_file.read_text(encoding="utf-8", errors="ignore")
+
+        for link in extract_links(content):
+            # Handle links with paths like [[folder/note]]
+            link_title = link.split("/")[-1] if "/" in link else link
+
+            links_from[title].add(link_title)
+            links_to[link_title].add(title)
+
+    # Calculate statistics
+    orphans = []
+    for title, info in notes.items():
+        incoming = len(links_to.get(title, set()))
+        outgoing = len(links_from.get(title, set()))
+        info["incoming"] = incoming
+        info["outgoing"] = outgoing
+        info["total_links"] = incoming + outgoing
+
+        # Orphan: no incoming AND no outgoing links
+        # Exclude MOC and root-level files from orphan detection
+        if incoming == 0 and outgoing == 0:
+            if info["domain"] not in ("MOC", "root"):
+                orphans.append(title)
+
+    # Domain statistics
+    domain_stats: dict[str, dict] = defaultdict(lambda: {"count": 0, "links": 0})
+    for title, info in notes.items():
+        domain = info["domain"]
+        domain_stats[domain]["count"] += 1
+        domain_stats[domain]["links"] += info["total_links"]
+
+    for domain in domain_stats:
+        count = domain_stats[domain]["count"]
+        if count > 0:
+            domain_stats[domain]["avg_links"] = domain_stats[domain]["links"] / count
+
+    # Most connected notes
+    most_connected = sorted(
+        notes.items(),
+        key=lambda x: x[1]["total_links"],
+        reverse=True
+    )[:10]
+
+    return {
+        "total_notes": len(notes),
+        "total_links": sum(len(v) for v in links_from.values()),
+        "orphans": orphans,
+        "orphan_count": len(orphans),
+        "domain_stats": dict(domain_stats),
+        "most_connected": [(t, n["total_links"]) for t, n in most_connected],
+        "notes": notes,
+        "links_from": {k: list(v) for k, v in links_from.items()},
+        "links_to": {k: list(v) for k, v in links_to.items()},
+    }
+
+
+def format_report(stats: dict) -> str:
+    """Format analysis as readable report."""
+    lines = [
+        "# Vault Graph Analysis",
+        "",
+        "## Overview",
+        "",
+        f"- **Total notes:** {stats['total_notes']}",
+        f"- **Total links:** {stats['total_links']}",
+        f"- **Orphan notes:** {stats['orphan_count']}",
+        "",
+    ]
+
+    # Most connected
+    if stats["most_connected"]:
+        lines.append("## Most Connected Notes")
+        lines.append("")
+        for title, count in stats["most_connected"][:5]:
+            lines.append(f"- [[{title}]] ({count} links)")
+        lines.append("")
+
+    # Domain stats
+    lines.append("## Domain Statistics")
+    lines.append("")
+    lines.append("| Domain | Notes | Avg Links |")
+    lines.append("|--------|-------|-----------|")
+    for domain, data in sorted(stats["domain_stats"].items()):
+        avg = data.get("avg_links", 0)
+        lines.append(f"| {domain}/ | {data['count']} | {avg:.1f} |")
+    lines.append("")
+
+    # Orphans
+    if stats["orphans"]:
+        lines.append("## Orphan Notes (need links)")
+        lines.append("")
+        for title in stats["orphans"][:20]:
+            note = stats["notes"][title]
+            lines.append(f"- [[{title}]] ({note['domain']}/)")
+        if len(stats["orphans"]) > 20:
+            lines.append(f"- ... and {len(stats['orphans']) - 20} more")
+        lines.append("")
+
+    return "\n".join(lines)
+
+
+def format_html(stats: dict) -> str:
+    """Format analysis as Telegram HTML."""
+    orphan_count = stats["orphan_count"]
+    orphan_emoji = "⚠️" if orphan_count > 10 else "✅"
+
+    lines = [
+        f"📊 Vault Graph Analysis",
+        "",
+        f"📝 Total notes: {stats['total_notes']}",
+        f"🔗 Total links: {stats['total_links']}",
+        f"{orphan_emoji} Orphan notes: {orphan_count}",
+        "",
+    ]
+
+    # Most connected
+    if stats["most_connected"]:
+        lines.append("🏆 Most connected:")
+        for title, count in stats["most_connected"][:3]:
+            lines.append(f"• [[{title}]] ({count})")
+        lines.append("")
+
+    # Weakest domain
+    weakest = min(
+        stats["domain_stats"].items(),
+        key=lambda x: x[1].get("avg_links", 0)
+    )
+    lines.append(f"⚡ Weakest domain: {weakest[0]}/ (avg {weakest[1].get('avg_links', 0):.1f} links)")
+
+    # Orphan preview
+    if stats["orphans"]:
+        lines.append("")
+        lines.append("📋 Sample orphans:")
+        for title in stats["orphans"][:5]:
+            lines.append(f"• {title}")
+
+    return "\n".join(lines)
+
+
+def main():
+    if len(sys.argv) > 1:
+        vault_path = Path(sys.argv[1])
+    else:
+        # Default: assume script is in vault/.claude/skills/graph-builder/scripts/
+        vault_path = Path(__file__).parent.parent.parent.parent.parent
+
+    if not vault_path.exists():
+        print(f"Error: Vault path not found: {vault_path}", file=sys.stderr)
+        sys.exit(1)
+
+    stats = analyze_vault(vault_path)
+
+    # Output format based on args
+    if "--html" in sys.argv:
+        print(format_html(stats))
+    elif "--json" in sys.argv:
+        import json
+        print(json.dumps(stats, indent=2))
+    else:
+        print(format_report(stats))
+
+
+if __name__ == "__main__":
+    main()
diff --git a/vault/.claude/skills/todoist-ai/SKILL.md b/vault/.claude/skills/todoist-ai/SKILL.md
new file mode 100644
index 0000000..d15b575
--- /dev/null
+++ b/vault/.claude/skills/todoist-ai/SKILL.md
@@ -0,0 +1,81 @@
+---
+name: todoist-ai
+description: Todoist integration via mcp-cli for task management
+depends_on: []
+---
+
+# todoist-ai
+
+Todoist integration via mcp-cli.
+
+## CRITICAL
+
+**ALWAYS use mcp-cli. DO NOT use MCP tools directly.**
+
+```bash
+# Today's tasks
+mcp-cli call todoist find-tasks-by-date '{"startDate": "today"}'
+
+# Create task
+mcp-cli call todoist add-tasks '{"tasks": [{"content": "Task", "dueString": "tomorrow", "priority": 2}]}'
+
+# Complete task
+mcp-cli call todoist complete-tasks '{"ids": ["task_id"]}'
+
+# Overview
+mcp-cli call todoist get-overview '{}'
+```
+
+## Description
+
+A set of tools to connect to AI agents, to allow them to use Todoist on a user's behalf. Uses mcp-cli wrapper for stable connections.
+
+**Repository:** [Doist/todoist-ai](https://github.com/Doist/todoist-ai)
+**Language:** TypeScript
+**Stars:** 212
+**License:** MIT License
+
+## When to Use This Skill
+
+Use this skill when you need to:
+- Create, update, or complete tasks in Todoist
+- Check workload or task status
+- Look up API documentation
+- Find usage examples
+
+## Quick Reference
+
+### Repository Info
+- **Homepage:**
+- **Topics:**
+- **Open Issues:** 18
+- **Last Updated:** 2025-12-13
+
+### Languages
+- **TypeScript:** 98.0%
+- **JavaScript:** 2.0%
+
+### Recent Releases
+- **v5.2.0** (2025-11-27): v5.2.0
+- **v5.1.1** (2025-11-27): v5.1.1
+- **v5.1.0** (2025-11-20): v5.1.0
+
+## Available References
+
+- `references/README.md` - Complete README documentation
+- `references/CHANGELOG.md` - Version history and changes
+- `references/issues.md` - Recent GitHub issues
+- `references/releases.md` - Release notes
+- `references/file_structure.md` - Repository structure
+
+## Usage
+
+See README.md for complete usage instructions and examples.
+
+---
+
+**Generated by Skill Seeker** | GitHub Repository Scraper
+
+## Relevant Skills
+
+- [[vault/.claude/skills/dbrain-processor/SKILL|dbrain-processor]] — Daily entry processing
diff --git a/vault/.claude/skills/todoist-ai/references/CHANGELOG.md b/vault/.claude/skills/todoist-ai/references/CHANGELOG.md
new file mode 100644
index 0000000..099ae9f
--- /dev/null
+++ b/vault/.claude/skills/todoist-ai/references/CHANGELOG.md
@@ -0,0 +1,461 @@
+# Changelog
+
+## [5.2.0](https://github.com/Doist/todoist-ai/compare/v5.1.1...v5.2.0) (2025-11-27)
+
+
+### Features
+
+* Add isUncompletable parameter support to add/update tools ([#230](https://github.com/Doist/todoist-ai/issues/230)) ([0c295ac](https://github.com/Doist/todoist-ai/commit/0c295ac7d7d1b81f5512b1c782eaba4ef24aeafd))
+
+## [5.1.1](https://github.com/Doist/todoist-ai/compare/v5.1.0...v5.1.1) (2025-11-27)
+
+
+### Bug Fixes
+
+* **deps:** Update `@doist/todoist-api-typescript` to 6.1.12 ([#229](https://github.com/Doist/todoist-ai/issues/229)) ([54e3552](https://github.com/Doist/todoist-ai/commit/54e3552b68d648a042bac9991cb600fd8f8f5be1))
+* **deps:** update dependency @modelcontextprotocol/sdk to v1.22.0 ([#227](https://github.com/Doist/todoist-ai/issues/227)) ([b20c05e](https://github.com/Doist/todoist-ai/commit/b20c05e3273ff6a565380cdddb9be5743ba7bb66))
+
+## [5.1.0](https://github.com/Doist/todoist-ai/compare/v5.0.2...v5.1.0) (2025-11-20)
+
+
+### Features
+
+* add read-only and destructive hints to all tools ([#222](https://github.com/Doist/todoist-ai/issues/222)) ([5d8ce22](https://github.com/Doist/todoist-ai/commit/5d8ce225c92a688834881bde13d5956bbe7e59ff))
+
+## [5.0.2](https://github.com/Doist/todoist-ai/compare/v5.0.1...v5.0.2) (2025-11-19)
+
+
+### Bug Fixes
+
+* **find-projects:** resolve search pagination issue and update PROJECTS_MAX ([#223](https://github.com/Doist/todoist-ai/issues/223)) ([b0772d1](https://github.com/Doist/todoist-ai/commit/b0772d1dd688188cc70dcdd50989208fd18f9c39))
+
+## [5.0.1](https://github.com/Doist/todoist-ai/compare/v5.0.0...v5.0.1) (2025-11-18)
+
+
+### Bug Fixes
+
+* **deps:** update production dependencies ([#220](https://github.com/Doist/todoist-ai/issues/220)) ([f6121b0](https://github.com/Doist/todoist-ai/commit/f6121b0fcc7bf432e07df7a8ef9c11291ba09dfb))
+
+## [5.0.0](https://github.com/Doist/todoist-ai/compare/v4.17.4...v5.0.0) (2025-11-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* semantic priority values (P1, P2, P3, P4) instead of numeric ([#217](https://github.com/Doist/todoist-ai/issues/217))
+
+### Features
+
+* semantic priority values (P1, P2, P3, P4) instead of numeric ([#217](https://github.com/Doist/todoist-ai/issues/217)) ([9bb906b](https://github.com/Doist/todoist-ai/commit/9bb906b48d836898bf616df60cef38aaa7ae2894))
+
+## [4.17.4](https://github.com/Doist/todoist-ai/compare/v4.17.3...v4.17.4) (2025-11-13)
+
+
+### Bug Fixes
+
+* correct priority inversion for task outputs ([#216](https://github.com/Doist/todoist-ai/issues/216)) ([b4b4809](https://github.com/Doist/todoist-ai/commit/b4b4809f129d6aa029f0ef4aa28352760c879aee))
+* **deps:** pin dependencies ([#212](https://github.com/Doist/todoist-ai/issues/212)) ([2049ebf](https://github.com/Doist/todoist-ai/commit/2049ebf4e5eedd2465650c79c16e39f04a5e4ddd))
+
+## [4.17.3](https://github.com/Doist/todoist-ai/compare/v4.17.2...v4.17.3) (2025-11-06)
+
+
+### Bug Fixes
+
+* **deps:** Bump `@doist/todoist-api-typescript` package ([#210](https://github.com/Doist/todoist-ai/issues/210)) ([85fbfb5](https://github.com/Doist/todoist-ai/commit/85fbfb591f2e4ee165b71ff1386a39ab96d7e31a))
+
+## [4.17.2](https://github.com/Doist/todoist-ai/compare/v4.17.1...v4.17.2) (2025-11-06)
+
+
+### Bug Fixes
+
+* enforce output schemas for tools (follow-up) ([#208](https://github.com/Doist/todoist-ai/issues/208)) ([c83772a](https://github.com/Doist/todoist-ai/commit/c83772a7c29314891b1e031dce9f07d954b4e4a5))
+
+## [4.17.1](https://github.com/Doist/todoist-ai/compare/v4.17.0...v4.17.1) (2025-11-06)
+
+
+### Bug Fixes
+
+* enforce output schemas for tools ([#205](https://github.com/Doist/todoist-ai/issues/205)) ([9b1d593](https://github.com/Doist/todoist-ai/commit/9b1d59317dbe5277b6f4126388a2402cf3c35e8e))
+
+## [4.17.0](https://github.com/Doist/todoist-ai/compare/v4.16.1...v4.17.0) (2025-11-05)
+
+
+### Features
+
+* Add output schema to all tools ([#203](https://github.com/Doist/todoist-ai/issues/203)) ([7663388](https://github.com/Doist/todoist-ai/commit/76633886dde65880cd049733431aa9d4a5038b84))
+
+## [4.16.1](https://github.com/Doist/todoist-ai/compare/v4.16.0...v4.16.1) (2025-11-05)
+
+
+### Bug Fixes
+
+* Show next steps only for paginated tools and clarify as suggestions ([#201](https://github.com/Doist/todoist-ai/issues/201)) ([f969615](https://github.com/Doist/todoist-ai/commit/f9696155fe931b6c40859c1a2f7e82a859253288))
+
+## [4.16.0](https://github.com/Doist/todoist-ai/compare/v4.15.1...v4.16.0) (2025-11-03)
+
+
+### Features
+
+* Extend "inbox" project ID support to 7 additional tools ([#198](https://github.com/Doist/todoist-ai/issues/198)) ([5bab0f9](https://github.com/Doist/todoist-ai/commit/5bab0f94ab2d997d71870202294af3c5d3ac7784))
+
+## [4.15.1](https://github.com/Doist/todoist-ai/compare/v4.15.0...v4.15.1) (2025-10-31)
+
+
+### Bug Fixes
+
+* Allow `inbox` as a project id ([#193](https://github.com/Doist/todoist-ai/issues/193)) ([fe4a91f](https://github.com/Doist/todoist-ai/commit/fe4a91fe2daa7f97473b97de54385e03358a8122))
+
+## [4.15.0](https://github.com/Doist/todoist-ai/compare/v4.14.5...v4.15.0) (2025-10-26)
+
+
+### Features
+
+* Add deadline support to add-tasks and update-tasks ([#186](https://github.com/Doist/todoist-ai/issues/186)) ([8f795c8](https://github.com/Doist/todoist-ai/commit/8f795c8949f40d10bf629933793d8cb4607dcb58))
+* Add parentId support to update-projects tool ([#184](https://github.com/Doist/todoist-ai/issues/184)) ([0185b83](https://github.com/Doist/todoist-ai/commit/0185b836fff1359c8303de20bcc37c8f86138180))
+
+## [4.14.5](https://github.com/Doist/todoist-ai/compare/v4.14.4...v4.14.5) (2025-10-25)
+
+
+### Bug Fixes
+
+* Remove nullable type from update_tasks to fix Gemini API compatibility ([#181](https://github.com/Doist/todoist-ai/issues/181)) ([c97be7f](https://github.com/Doist/todoist-ai/commit/c97be7f39ae48d837562fd303b67ed81e8935c18))
+
+## [4.14.4](https://github.com/Doist/todoist-ai/compare/v4.14.3...v4.14.4) (2025-10-24)
+
+
+### Bug Fixes
+
+* Add actions: write permission to trigger workflows ([6863953](https://github.com/Doist/todoist-ai/commit/6863953b6e92fd8b35f4692b5c609ad42631722a))
+
+## [4.14.3](https://github.com/Doist/todoist-ai/compare/v4.14.2...v4.14.3) (2025-10-24)
+
+
+### Bug Fixes
+
+* Add --repo flag to gh workflow run command ([f61caa8](https://github.com/Doist/todoist-ai/commit/f61caa8c7aabce166484b95b70886aa4049c904c))
+
+## [4.14.2](https://github.com/Doist/todoist-ai/compare/v4.14.1...v4.14.2) (2025-10-24)
+
+
+### Bug Fixes
+
+* Trigger publish workflow automatically from release-please ([#174](https://github.com/Doist/todoist-ai/issues/174)) ([081bc2b](https://github.com/Doist/todoist-ai/commit/081bc2ba5abfdc3bf4bfe3c282f29570877b977c))
+
+## [4.14.1](https://github.com/Doist/todoist-ai/compare/v4.14.0...v4.14.1) (2025-10-24)
+
+
+### Bug Fixes
+
+* Update todoist-typescript-sdk to 5.7.1 (follow-up) ([#172](https://github.com/Doist/todoist-ai/issues/172)) ([b4f8dc3](https://github.com/Doist/todoist-ai/commit/b4f8dc3ffa4c3dd7489ece03be5a0f391130a2ce))
+
+## [4.14.0](https://github.com/Doist/todoist-ai/compare/v4.13.5...v4.14.0) (2025-10-23)
+
+
+### Features
+
+* Add find-activity tool ([#169](https://github.com/Doist/todoist-ai/issues/169)) ([1abf67f](https://github.com/Doist/todoist-ai/commit/1abf67f3a99191582cf0b5ea2516420f1278dc9a))
+
+## [4.13.5](https://github.com/Doist/todoist-ai/compare/v4.13.4...v4.13.5) (2025-10-23)
+
+
+### Bug Fixes
+
+* clarify find-completed-tasks scope ([#167](https://github.com/Doist/todoist-ai/issues/167)) ([f110669](https://github.com/Doist/todoist-ai/commit/f11066934d4f6b790599d0f89db416a32437edd3))
+
+## [4.13.4](https://github.com/Doist/todoist-ai/compare/v4.13.3...v4.13.4) (2025-10-23)
+
+
+### Bug Fixes
+
+* Test publish workflow (no functional changes) ([#164](https://github.com/Doist/todoist-ai/issues/164)) ([68afb4c](https://github.com/Doist/todoist-ai/commit/68afb4ce06366cc022a1718e6cd0c3525c5aab48))
+
+## [4.13.3](https://github.com/Doist/todoist-ai/compare/v4.13.2...v4.13.3) (2025-10-23)
+
+
+### Bug Fixes
+
+* Switch to using `moveTask` instead of `moveTasks` ([#160](https://github.com/Doist/todoist-ai/issues/160)) ([34e3fc6](https://github.com/Doist/todoist-ai/commit/34e3fc67922379bf0aef39a9e7f1939ded5f0e08))
+
+## [4.13.2](https://github.com/Doist/todoist-ai/compare/v4.13.1...v4.13.2) (2025-10-22)
+
+
+### Bug Fixes
+
+* Output `checked` for the `fetch` tool ([#158](https://github.com/Doist/todoist-ai/issues/158)) ([f0a6eaf](https://github.com/Doist/todoist-ai/commit/f0a6eaf62a915cfab289f1b5181770ccd11d0bdb))
+
+## [4.13.1](https://github.com/Doist/todoist-ai/compare/v4.13.0...v4.13.1) (2025-10-22)
+
+
+### Bug Fixes
+
+* Remove `updatedAt` ([#155](https://github.com/Doist/todoist-ai/issues/155)) ([3f3f345](https://github.com/Doist/todoist-ai/commit/3f3f3458f9d54f4f347dfb7c34892fb3cda7ff3b))
+
+## [4.13.0](https://github.com/Doist/todoist-ai/compare/v4.12.0...v4.13.0) (2025-10-21)
+
+
+### Features
+
+* Expose completion and modification metadata in task mapping ([#153](https://github.com/Doist/todoist-ai/issues/153)) ([1e2d3b3](https://github.com/Doist/todoist-ai/commit/1e2d3b3f461e75be8cc63ae3a4e070d113f5c4da))
+* extend responsibleUser filtering to more tools ([#149](https://github.com/Doist/todoist-ai/issues/149)) ([c146d74](https://github.com/Doist/todoist-ai/commit/c146d749eb097e1d383dda00e6a09e05389969dd))
+
+## [4.12.0](https://github.com/Doist/todoist-ai/compare/v4.11.0...v4.12.0) (2025-10-14)
+
+
+### Features
+
+* In find-tasks-by-date use backend filtering for responsible user ([#145](https://github.com/Doist/todoist-ai/issues/145)) ([5d1e140](https://github.com/Doist/todoist-ai/commit/5d1e1400f639e8c802019421eb0437ef39c67a64))
+
+## [4.11.0](https://github.com/Doist/todoist-ai/compare/v4.10.0...v4.11.0) (2025-10-13)
+
+
+### Features
+
+* Improve findCompletedTasks to handle user timezones ([#143](https://github.com/Doist/todoist-ai/issues/143)) ([c27d897](https://github.com/Doist/todoist-ai/commit/c27d8973d0ea9342f8b1e56659fca900f920ddb3))
+
+## [4.10.0](https://github.com/Doist/todoist-ai/compare/v4.9.4...v4.10.0) (2025-10-10)
+
+
+### Features
+
+* add OpenAI-compliant `search` and `fetch` tools ([#134](https://github.com/Doist/todoist-ai/issues/134)) ([153289c](https://github.com/Doist/todoist-ai/commit/153289c5cf02b2da6b3f4cf6e8a7c681b3ee3aec))
+* Clarify content vs description usage and Markdown support ([#139](https://github.com/Doist/todoist-ai/issues/139)) ([cb410a2](https://github.com/Doist/todoist-ai/commit/cb410a2c16670ec07ee2d812ba961075c3f20dda))
+
+## [4.9.4](https://github.com/Doist/todoist-ai/compare/v4.9.3...v4.9.4) (2025-10-06)
+
+
+### Bug Fixes
+
+* Ensures null fields are not returned ([#130](https://github.com/Doist/todoist-ai/issues/130)) ([a016011](https://github.com/Doist/todoist-ai/commit/a0160115b6fff4b96751056506494e43f582527c))
+
+## [4.9.3](https://github.com/Doist/todoist-ai/compare/v4.9.2...v4.9.3) (2025-10-02)
+
+
+### Bug Fixes
+
+* dayCount and overdue only fixes ([#128](https://github.com/Doist/todoist-ai/issues/128)) ([d020c06](https://github.com/Doist/todoist-ai/commit/d020c0622fb5c9a71b5f666406529236db76bdef))
+
+## [4.9.2](https://github.com/Doist/todoist-ai/compare/v4.9.1...v4.9.2) (2025-10-02)
+
+
+### Bug Fixes
+
+* allow add-tasks to work with only content parameter ([#126](https://github.com/Doist/todoist-ai/issues/126)) ([27bda34](https://github.com/Doist/todoist-ai/commit/27bda346f465a1a2ab7a0ab833c151093a4d7044))
+
+## [4.9.1](https://github.com/Doist/todoist-ai/compare/v4.9.0...v4.9.1) (2025-10-01)
+
+
+### Bug Fixes
+
+* Enhance task filtering by responsible user and update related tools ([#121](https://github.com/Doist/todoist-ai/issues/121)) ([cea0917](https://github.com/Doist/todoist-ai/commit/cea0917a8b2bd1f056e1b08f14e9cb858b9711a5))
+* preserve markdown in tasks content and description ([#124](https://github.com/Doist/todoist-ai/issues/124)) ([0cc48fe](https://github.com/Doist/todoist-ai/commit/0cc48fe93595213729d794b7b6c92d54072cf6d5))
+
+## [4.9.0](https://github.com/Doist/todoist-ai/compare/v4.8.0...v4.9.0) (2025-09-30)
+
+
+### Features
+
+* add parentId support to add-projects tool ([#122](https://github.com/Doist/todoist-ai/issues/122)) ([84019d1](https://github.com/Doist/todoist-ai/commit/84019d1403fff67d33de5bf756a40da28b88171e))
+
+## [4.8.0](https://github.com/Doist/todoist-ai/compare/v4.7.1...v4.8.0) (2025-09-29)
+
+
+### Features
+
+* merge overdue into today's tasks in find-tasks-by-date tool ([#108](https://github.com/Doist/todoist-ai/issues/108)) ([f86e69d](https://github.com/Doist/todoist-ai/commit/f86e69d3ac4861a1b99ebdc8f25f135c6d6adeeb))
+
+## [4.7.1](https://github.com/Doist/todoist-ai/compare/v4.7.0...v4.7.1) (2025-09-29)
+
+
+### Bug Fixes
+
+* Convert the API priorities into a consumable priority ([#115](https://github.com/Doist/todoist-ai/issues/115)) ([e4cc62f](https://github.com/Doist/todoist-ai/commit/e4cc62f5e456c517995aaf9b8e22153923a55ff7))
+
+## [4.7.0](https://github.com/Doist/todoist-ai/compare/v4.6.1...v4.7.0) (2025-09-25)
+
+
+### Features
+
+* Document the MCP setup better, including the remote endpoint ([#109](https://github.com/Doist/todoist-ai/issues/109)) ([e1e69e2](https://github.com/Doist/todoist-ai/commit/e1e69e27e91675775e7f4ea0bef709a17722131c))
+
+## [4.6.1](https://github.com/Doist/todoist-ai/compare/v4.6.0...v4.6.1) (2025-09-24)
+
+
+### Bug Fixes
+
+* Update package.json with `mcpName` ([#106](https://github.com/Doist/todoist-ai/issues/106)) ([df19306](https://github.com/Doist/todoist-ai/commit/df19306adb13ff6416a37e4b49a6d2e5ab5c459f))
+
+## [4.6.0](https://github.com/Doist/todoist-ai/compare/v4.5.2...v4.6.0) (2025-09-24)
+
+
+### Features
+
+* add label support for add-tasks and update-tasks tools ([#103](https://github.com/Doist/todoist-ai/issues/103)) ([a4bc708](https://github.com/Doist/todoist-ai/commit/a4bc7085b5a63402970841e586ce985cab9022d0))
+
+## [4.5.2](https://github.com/Doist/todoist-ai/compare/v4.5.1...v4.5.2) (2025-09-24)
+
+
+### Miscellaneous Chores
+
+* Release 4.5.2 ([11df6f2](https://github.com/Doist/todoist-ai/commit/11df6f2c03e31bffd02a6c4f1a5176158e434e05))
+
+## [4.5.1](https://github.com/Doist/todoist-ai/compare/v4.5.0...v4.5.1) (2025-09-23)
+
+
+### Bug Fixes
+
+* fix priority levels ([#98](https://github.com/Doist/todoist-ai/issues/98)) ([64db2ff](https://github.com/Doist/todoist-ai/commit/64db2ff97f3ede0c5cff14d1c58f8fed63a9d742))
+
+## [4.5.0](https://github.com/Doist/todoist-ai/compare/v4.4.0...v4.5.0) (2025-09-11)
+
+
+### Features
+
+* add task assignment management ([#81](https://github.com/Doist/todoist-ai/issues/81)) ([b9b1691](https://github.com/Doist/todoist-ai/commit/b9b16916dec8f18efc37631d77f97354fae2194a))
+
+## [4.4.0](https://github.com/Doist/todoist-ai/compare/v4.3.0...v4.4.0) (2025-09-10)
+
+
+### Features
+
+* Add user's id to user_info tool ([#84](https://github.com/Doist/todoist-ai/issues/84)) ([706ed8f](https://github.com/Doist/todoist-ai/commit/706ed8fdfd11199808ca9824d4c66e8211d773c1))
+
+## [4.3.0](https://github.com/Doist/todoist-ai/compare/v4.2.0...v4.3.0) (2025-09-09)
+
+
+### Features
+
+* Add user-info tool and upgrade Todoist API ([#82](https://github.com/Doist/todoist-ai/issues/82)) ([b583fe1](https://github.com/Doist/todoist-ai/commit/b583fe1045ea38fbe25dfa804df9ebe958f2881d))
+
+## [4.2.0](https://github.com/Doist/todoist-ai/compare/v4.1.0...v4.2.0) (2025-08-29)
+
+
+### Features
+
+* Add support for filtering by label ([#71](https://github.com/Doist/todoist-ai/issues/71)) ([b608d32](https://github.com/Doist/todoist-ai/commit/b608d32f7636a175dc62ca388892e9aef0834712))
+
+## [4.1.0](https://github.com/Doist/todoist-ai/compare/v4.0.0...v4.1.0) (2025-08-23)
+
+
+### Features
+
+* export comment tools ([#63](https://github.com/Doist/todoist-ai/issues/63)) ([cec2999](https://github.com/Doist/todoist-ai/commit/cec2999b8ca1f660f26b37cffb3803e863f60be0))
+
+## [4.0.0](https://github.com/Doist/todoist-ai/compare/v3.0.0...v4.0.0) (2025-08-22)
+
+
+### ⚠ BREAKING CHANGES
+
+* restructure management tools into specialized add/update tools ([#59](https://github.com/Doist/todoist-ai/issues/59))
+
+### Features
+
+* add comment tools ([#58](https://github.com/Doist/todoist-ai/issues/58)) ([7d6ffca](https://github.com/Doist/todoist-ai/commit/7d6ffcacd326ef755aba691436d44d6b534f6b4b))
+* add todoist base url to dev setup, plus doc improvements ([#62](https://github.com/Doist/todoist-ai/issues/62)) ([e0e5a78](https://github.com/Doist/todoist-ai/commit/e0e5a78d1358b82d5f2661a41ffe193015296154))
+* parallelize add-tasks with per-task context ([#60](https://github.com/Doist/todoist-ai/issues/60)) ([816d099](https://github.com/Doist/todoist-ai/commit/816d099551974bad3e0663c1d77334b692aaa76a))
+* restructure management tools into specialized add/update tools ([#59](https://github.com/Doist/todoist-ai/issues/59)) ([0c4dcf7](https://github.com/Doist/todoist-ai/commit/0c4dcf7c4e420eadea15bf825599f4c3cd72cbfc))
+
+## [3.0.0](https://github.com/Doist/todoist-ai/compare/v2.2.2...v3.0.0) (2025-08-21)
+
+
+### ⚠ BREAKING CHANGES
+
+* verb-first tool names, unify find-by-container into find-tasks ([#53](https://github.com/Doist/todoist-ai/issues/53))
+* Remove single update task and replace with multiple ([#47](https://github.com/Doist/todoist-ai/issues/47))
+
+### Features
+
+* Improve tool output UX with LLM-readable responses ([#49](https://github.com/Doist/todoist-ai/issues/49)) ([7c25696](https://github.com/Doist/todoist-ai/commit/7c25696926bbaee158482cbc75595e80959e1c12))
+* Remove single update task and replace with multiple ([#47](https://github.com/Doist/todoist-ai/issues/47)) ([8a9b7cf](https://github.com/Doist/todoist-ai/commit/8a9b7cf119a405a2849ab95c437a344961790686))
+* verb-first tool names, unify find-by-container into find-tasks ([#53](https://github.com/Doist/todoist-ai/issues/53)) ([dbada71](https://github.com/Doist/todoist-ai/commit/dbada719d98df4bb91a52a0a7af8afb6ad6f3fae))
+
+## [2.2.2](https://github.com/Doist/todoist-ai/compare/v2.2.1...v2.2.2) (2025-08-16)
+
+
+### Bug Fixes
+
+* correct bin path in package.json for npx support ([#39](https://github.com/Doist/todoist-ai/issues/39)) ([816021d](https://github.com/Doist/todoist-ai/commit/816021dc3572dd476818981388fac634794d7e21))
+
+## [2.2.1](https://github.com/Doist/todoist-ai/compare/v2.2.0...v2.2.1) (2025-08-16)
+
+
+### Bug Fixes
+
+* correct bin field format in package.json for npx support ([#37](https://github.com/Doist/todoist-ai/issues/37)) ([a50fa75](https://github.com/Doist/todoist-ai/commit/a50fa75d737bc6f4503442830565c3d4a942c9af))
+
+## [2.2.0](https://github.com/Doist/todoist-ai/compare/v2.1.0...v2.2.0) (2025-08-16)
+
+
+### Features
+
+* Add npx support for MCP server usage ([#33](https://github.com/Doist/todoist-ai/issues/33)) ([5ed0c5f](https://github.com/Doist/todoist-ai/commit/5ed0c5f40615ab4afb61d0fcd9796c97e666b1f9))
+
+## [2.1.0](https://github.com/Doist/todoist-ai/compare/v2.0.1...v2.1.0) (2025-08-15)
+
+
+### Features
+
+* add support for task duration when adding or updating tasks ([#28](https://github.com/Doist/todoist-ai/issues/28)) ([a0c6702](https://github.com/Doist/todoist-ai/commit/a0c6702dd446173c86675ecadd975506ce594c42))
+
+## [2.0.1](https://github.com/Doist/todoist-ai/compare/v2.0.0...v2.0.1) (2025-08-14)
+
+
+### Bug Fixes
+
+* convert project from CommonJS to ES modules to resolve MCP initialization ([#24](https://github.com/Doist/todoist-ai/issues/24)) ([f817e04](https://github.com/Doist/todoist-ai/commit/f817e045a711f90b4f74464a480dd1aa8f7e1027))
+* resolve task move operations using correct Todoist API methods ([#22](https://github.com/Doist/todoist-ai/issues/22)) ([3b8f509](https://github.com/Doist/todoist-ai/commit/3b8f50943f517ae76b754923f7a8c5563880e9ba))
+
+## [2.0.0](https://github.com/Doist/todoist-ai/compare/v1.1.0...v2.0.0) (2025-08-13)
+
+
+### ⚠ BREAKING CHANGES
+
+* Consolidate MCP tools to reduce tool count ([#14](https://github.com/Doist/todoist-ai/issues/14))
+
+### Features
+
+* Consolidate MCP tools to reduce tool count ([#14](https://github.com/Doist/todoist-ai/issues/14)) ([f0ccdf8](https://github.com/Doist/todoist-ai/commit/f0ccdf8fd17f046fdb8d0938dea94163fd916a7c))
+
+
+### Bug Fixes
+
+* update release-please action to googleapis/release-please-action@v4 ([7fbb5fd](https://github.com/Doist/todoist-ai/commit/7fbb5fdd3f435e68a9b2ba054247d29e82fcc465))
+
+## [1.1.0](https://github.com/Doist/todoist-ai/compare/v1.0.0...v1.1.0) (2025-08-13)
+
+
+### Features
+
+* Adds completed tasks tool ([#8](https://github.com/Doist/todoist-ai/issues/8)) ([d0ffad1](https://github.com/Doist/todoist-ai/commit/d0ffad10a331c16f14b4d738ed7ac368fd8e44b4))
+
+
+### Bug Fixes
+
+* add issues permission for release-please workflow ([0974fa4](https://github.com/Doist/todoist-ai/commit/0974fa45aa8578eafd2e9e1355a997ee09dce391))
+
+## 1.0.0 (2025-08-12)
+
+
+### Features
+
+* add tasks-add-multiple and tasks-update-one tools ([f7432e7](https://github.com/Doist/todoist-ai/commit/f7432e7f8c4121ed2bf71b424fe17d03e59aed23))
+* add tasks-complete-one and tasks-delete-one tools ([1ef6a99](https://github.com/Doist/todoist-ai/commit/1ef6a99e2733226d85932b930a41dc9ff92d0ef9))
+* allow configuring the base URL for the Todoist API ([332c11a](https://github.com/Doist/todoist-ai/commit/332c11aec34ace9890fda36ef9356a7c417b22d1))
+* allow configuring the base URL for the Todoist API ([c56b3a3](https://github.com/Doist/todoist-ai/commit/c56b3a36207fb211188737f05f472ebcee6e7fc5))
+
+## [0.1.4](https://github.com/doist/todoist-ai/compare/v0.1.3...v0.1.4) (2025-01-XX)
+
+### Features
+
+* allow configuring the base URL for the Todoist API ([332c11a](https://github.com/doist/todoist-ai/commit/332c11a))
+
+### Bug Fixes
+
+* remove esm build, use single tsconfig for cjs ([24a1336](https://github.com/doist/todoist-ai/commit/24a1336))
+* remove tools subpath, export tools from index.ts ([2e13489](https://github.com/doist/todoist-ai/commit/2e13489))
+
+### Miscellaneous Chores
+
+* rename tool files to match the tool name ([997780a](https://github.com/doist/todoist-ai/commit/997780a))
+
+---
+
+*Note: This changelog will be automatically maintained by [release-please](https://github.com/googleapis/release-please) starting from the next release.*
diff --git a/vault/.claude/skills/todoist-ai/references/README.md b/vault/.claude/skills/todoist-ai/references/README.md
new file mode 100644
index 0000000..acec81a
--- /dev/null
+++ b/vault/.claude/skills/todoist-ai/references/README.md
@@ -0,0 +1,189 @@
+# Todoist AI and MCP SDK
+
+Library for connecting AI agents to Todoist. Includes tools that can be integrated into LLMs,
+enabling them to access and modify a Todoist account on the user's behalf.
+
+These tools can be used both through an MCP server, or imported directly in other projects to
+integrate them to your own AI conversational interfaces.
+
+## Using tools
+
+### 1. Add this repository as a dependency
+
+```sh
+npm install @doist/todoist-ai
+```
+
+### 2. Import the tools and plug them to an AI
+
+Here's an example using [Vercel's AI SDK](https://ai-sdk.dev/docs/ai-sdk-core/generating-text#streamtext).
+
+```js
+import { findTasksByDate, addTasks } from "@doist/todoist-ai";
+import { TodoistApi } from "@doist/todoist-api-typescript";
+import { streamText } from "ai";
+
+// Create Todoist API client
+const client = new TodoistApi(process.env.TODOIST_API_KEY);
+
+// Helper to wrap tools with the client
+function wrapTool(tool, todoistClient) {
+    return {
+        ...tool,
+        execute(args) {
+            return tool.execute(args, todoistClient);
+        },
+    };
+}
+
+const result = streamText({
+    model: yourModel,
+    system: "You are a helpful Todoist assistant",
+    tools: {
+        findTasksByDate: wrapTool(findTasksByDate, client),
+        addTasks: wrapTool(addTasks, client),
+    },
+});
+```
+
+## Using as an MCP server
+
+### Quick Start
+
+You can run the MCP server directly with npx:
+
+```bash
+npx @doist/todoist-ai
+```
+
+### Setup Guide
+
+The Todoist AI MCP server is available as a streamable HTTP service for easy integration with various AI clients:
+
+**Primary URL (Streamable HTTP):** `https://ai.todoist.net/mcp`
+
+#### Claude Desktop
+
+1. Open Settings → Connectors → Add custom connector
+2. Enter `https://ai.todoist.net/mcp` and complete OAuth authentication
+
+#### Cursor
+
+Create a configuration file:
+- **Global:** `~/.cursor/mcp.json`
+- **Project-specific:** `.cursor/mcp.json`
+
+```json
+{
+  "mcpServers": {
+    "todoist": {
+      "command": "npx",
+      "args": ["-y", "mcp-remote", "https://ai.todoist.net/mcp"]
+    }
+  }
+}
+```
+
+Then enable the server in Cursor settings if prompted.
+
+#### Claude Code (CLI)
+
+Firstly configure Claude so it has a new MCP available using this command:
+
+```bash
+claude mcp add --transport http todoist https://ai.todoist.net/mcp
+```
+
+Then launch `claude`, execute `/mcp`, then select the `todoist` MCP server.
+
+This will take you through a wizard to authenticate using your browser with Todoist. Once complete you will be able to use todoist in `claude`.
+
+
+#### Visual Studio Code
+
+1. Open Command Palette → MCP: Add Server
+2. Select HTTP transport and use:
+
+```json
+{
+  "servers": {
+    "todoist": {
+      "type": "http",
+      "url": "https://ai.todoist.net/mcp"
+    }
+  }
+}
+```
+
+#### Other MCP Clients
+
+```bash
+npx -y mcp-remote https://ai.todoist.net/mcp
+```
+
+For more details on setting up and using the MCP server, including creating custom servers, see [docs/mcp-server.md](docs/mcp-server.md).
+
+## Features
+
+A key feature of this project is that tools can be reused, and are not written specifically for use in an MCP server. They can be hooked up as tools to other conversational AI interfaces (e.g. Vercel's AI SDK).
+
+This project is in its early stages. Expect more and/or better tools soon.
+
+Nevertheless, our goal is to provide a small set of tools that enable complete workflows, rather than just atomic actions, striking a balance between flexibility and efficiency for LLMs.
+
+For our design philosophy, guidelines, and development patterns, see [docs/tool-design.md](docs/tool-design.md).
+
+### Available Tools
+
+For a complete list of available tools, see the [src/tools](src/tools) directory.
+
+#### OpenAI MCP Compatibility
+
+This server includes `search` and `fetch` tools that follow the [OpenAI MCP specification](https://platform.openai.com/docs/mcp), enabling seamless integration with OpenAI's MCP protocol. These tools return JSON-encoded results optimized for OpenAI's requirements while maintaining compatibility with the broader MCP ecosystem.
+
+## Dependencies
+
+-   MCP server using the official [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/typescript-sdk?tab=readme-ov-file#installation)
+-   Todoist Typescript API client [@doist/todoist-api-typescript](https://github.com/Doist/todoist-api-typescript)
+
+## MCP Server Setup
+
+See [docs/mcp-server.md](docs/mcp-server.md) for full instructions on setting up the MCP server.
+
+## Local Development Setup
+
+See [docs/dev-setup.md](docs/dev-setup.md) for full instructions on setting up this repository locally for development and contributing.
+
+### Quick Start
+
+After cloning and setting up the repository:
+
+- `npm start` - Build and run the MCP inspector for testing
+- `npm run dev` - Development mode with auto-rebuild and restart
+
+## Releasing
+
+This project uses [release-please](https://github.com/googleapis/release-please) to automate version management and package publishing.
+
+### How it works
+
+1. Make your changes using [Conventional Commits](https://www.conventionalcommits.org/):
+
+    - `feat:` for new features (minor version bump)
+    - `fix:` for bug fixes (patch version bump)
+    - `feat!:` or `fix!:` for breaking changes (major version bump)
+    - `docs:` for documentation changes
+    - `chore:` for maintenance tasks
+    - `ci:` for CI changes
+
+2. When commits are pushed to `main`:
+
+    - Release-please automatically creates/updates a release PR
+    - The PR includes version bump and changelog updates
+    - Review the PR and merge when ready
+
+3. After merging the release PR:
+    - A new GitHub release is automatically created
+    - A new tag is created
+    - The `publish` workflow is triggered
+    - The package is published to npm
diff --git a/vault/.claude/skills/todoist-ai/references/file_structure.md b/vault/.claude/skills/todoist-ai/references/file_structure.md
new file mode 100644
index 0000000..c90a169
--- /dev/null
+++ b/vault/.claude/skills/todoist-ai/references/file_structure.md
@@ -0,0 +1,139 @@
+# Repository File Structure
+
+Total items: 133
+
+```
+📁 .claude
+📁 .cursor
+📄 .cursorrules
+📄 .env.example
+📁 .github
+📄 .gitignore
+📁 .husky
+📄 .nvmrc
+📁 .vscode
+📄 CHANGELOG.md
+📄 LICENSE.txt
+📄 README.md
+📄 biome.json
+📁 docs
+📄 openai-mcp-tools.md
+📄 package-lock.json
+📄 package.json
+📄 renovate.json
+📁 scripts
+📁 src
+📄 tsconfig.json
+📄 vite.config.ts
+  📄 claude.md
+  📄 settings.json
+  📄 mcp.json
+  📁 rules
+  📄 PULL_REQUEST_TEMPLATE.md
+  📄 release-please-config.json
+  📄 release-please-manifest.json
+  📁 workflows
+  📄 pre-commit
+  📄 pre-push
+  📄 extensions.json
+  📄 settings.json
+  📄 dev-setup.md
+  📄 mcp-server.md
+  📄 tool-design.md
+  📄 test-executable.cjs
+  📄 validate-schemas.ts
+  📄 filter-helpers.ts
+  📄 index.ts
+  📄 main.ts
+  📄 mcp-helpers.ts
+  📄 mcp-server.ts
+  📄 todoist-tool.ts
+  📄 tool-helpers.test.ts
+  📄 tool-helpers.ts
+  📁 tools
+  📁 utils
+    📄 context7.mdc
+    📄 typescript.mdc
+    📄 check-semantic-pull-request.yml
+    📄 ci.yml
+    📄 publish.yml
+    📄 release-please.yml
+    📁 __tests__
+    📄 add-comments.ts
+    📄 add-projects.ts
+    📄 add-sections.ts
+    📄 add-tasks.ts
+    📄 complete-tasks.ts
+    📄 delete-object.ts
+    📄 fetch.ts
+    📄 find-activity.ts
+    📄 find-comments.ts
+    📄 find-completed-tasks.ts
+    📄 find-project-collaborators.ts
+    📄 find-projects.ts
+    📄 find-sections.ts
+    📄 find-tasks-by-date.ts
+    📄 find-tasks.ts
+    📄 get-overview.ts
+    📄 manage-assignments.ts
+    📄 search.ts
+    📄 update-comments.ts
+    📄 update-projects.ts
+    📄 update-sections.ts
+    📄 update-tasks.ts
+    📄 user-info.ts
+    📄 assignment-validator.ts
+    📄 constants.ts
+    📄 duration-parser.test.ts
+    📄 duration-parser.ts
+    📄 labels.ts
+    📄 output-schemas.ts
+    📄 priorities.ts
+    📄 response-builders.ts
+    📄 sanitize-data.test.ts
+    📄 sanitize-data.ts
+    📄 test-helpers.ts
+    📄 tool-names.ts
+    📄 user-resolver.ts
+      📁 __snapshots__
+      📄 add-comments.test.ts
+      📄 add-projects.test.ts
+      📄 add-sections.test.ts
+      📄 add-tasks.test.ts
+      📄 assignment-integration.test.ts
+      📄 complete-tasks.test.ts
+      📄 delete-object.test.ts
+      📄 fetch.test.ts
+      📄 find-activity.test.ts
+      📄 find-comments.test.ts
+      📄 find-completed-tasks.test.ts
+      📄 find-projects.test.ts
+      📄 find-sections.test.ts
+      📄 find-tasks-by-date.test.ts
+      📄 find-tasks.test.ts
+      📄 get-overview.test.ts
+      📄 search.test.ts
+      📄 tool-annotations.test.ts
+      📄 update-comments.test.ts
+      📄 update-projects.test.ts
+      📄 update-sections.test.ts
+      📄 update-tasks.test.ts
+      📄 user-info.test.ts
+        📄 add-comments.test.ts.snap
+        📄 add-projects.test.ts.snap
+        📄 add-sections.test.ts.snap
+        📄 add-tasks.test.ts.snap
+        📄 complete-tasks.test.ts.snap
+        📄 delete-object.test.ts.snap
+        📄 find-activity.test.ts.snap
+        📄 find-comments.test.ts.snap
+        📄 find-completed-tasks.test.ts.snap
+        📄 find-projects.test.ts.snap
+        📄 find-sections.test.ts.snap
+        📄 find-tasks-by-date.test.ts.snap
+        📄 find-tasks.test.ts.snap
+        📄 get-overview.test.ts.snap
+        📄 update-comments.test.ts.snap
+        📄 update-projects.test.ts.snap
+        📄 update-sections.test.ts.snap
+```
diff --git a/vault/.claude/skills/todoist-ai/references/issues.md b/vault/.claude/skills/todoist-ai/references/issues.md
new file mode 100644
index 0000000..f97883e
--- /dev/null
+++ b/vault/.claude/skills/todoist-ai/references/issues.md
@@ -0,0 +1,65 @@
+# GitHub Issues
+
+Recent issues from the repository (18 total).
+
+## Open Issues (4)
+
+### #26: Dependency Dashboard
+**Labels:** No labels | **Created:** 2025-08-14
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/26)
+
+### #241: Is there a OpenAPI json spec available?
+**Labels:** No labels | **Created:** 2025-12-12
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/241)
+
+### #239: server times out frequently, needs frequent reauthentication in claude code
+**Labels:** No labels | **Created:** 2025-12-08
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/239)
+
+### #162: Remove Zod v4 dependency blocker
+**Labels:** No labels | **Created:** 2025-10-23
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/162)
+
+
+## Recently Closed Issues (14)
+
+### #240: Cannot connect with mcp-remote@0.1.31
+**Labels:** No labels | **Closed:** 2025-12-08
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/240)
+
+### #192: Claude Code requires reconnection too frequently
+**Labels:** No labels | **Closed:** 2025-11-13
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/192)
+
+### #215: Claude Code : Adding Task "P1" vs reading tasks are inverted
+**Labels:** No labels | **Closed:** 2025-11-13
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/215)
+
+### #206: MCPs are not working
+**Labels:** No labels | **Closed:** 2025-11-06
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/206)
+
+### #94: This MCP server can't be used by ChatGPT to search information because it doesn't implement our specification: search action not found
+**Labels:** No labels | **Closed:** 2025-09-17
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/94)
+
+### #76: parentId parameter ignored in add-projects and update-projects - fails to create/update project hierarchy
+**Labels:** No labels | **Closed:** 2025-10-26
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/76)
+
+### #179: Bug: update_tasks tool schema appears incompatible with Gemini API
+**Labels:** No labels | **Closed:** 2025-10-25
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/179)
+
+### #35: Release-Please v4 publish workflow not triggering automatically - requires manual re-tagging
+**Labels:** No labels | **Closed:** 2025-10-26
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/35)
+
+### #42: # Feature Request: Add Deadline Support
+**Labels:** enhancement, good first issue | **Closed:** 2025-10-26
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/42)
+
+### #136: TypeError: client.getUser is not a function when following Vercel AI SDK example
+**Labels:** No labels | **Closed:** 2025-10-26
+[View on GitHub](https://github.com/Doist/todoist-ai/issues/136)
+
diff --git a/vault/.claude/skills/todoist-ai/references/releases.md b/vault/.claude/skills/todoist-ai/references/releases.md
new file mode 100644
index 0000000..b11fdfc
--- /dev/null
+++ b/vault/.claude/skills/todoist-ai/references/releases.md
@@ -0,0 +1,688 @@
+# Releases
+
+Version history for this repository (47 releases).
+
+## v5.2.0: v5.2.0
+**Published:** 2025-11-27
+
+## [5.2.0](https://github.com/Doist/todoist-ai/compare/v5.1.1...v5.2.0) (2025-11-27)
+
+
+### Features
+
+* Add isUncompletable parameter support to add/update tools ([#230](https://github.com/Doist/todoist-ai/issues/230)) ([0c295ac](https://github.com/Doist/todoist-ai/commit/0c295ac7d7d1b81f5512b1c782eaba4ef24aeafd))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v5.2.0)
+
+---
+
+## v5.1.1: v5.1.1
+**Published:** 2025-11-27
+
+## [5.1.1](https://github.com/Doist/todoist-ai/compare/v5.1.0...v5.1.1) (2025-11-27)
+
+
+### Bug Fixes
+
+* **deps:** Update `@doist/todoist-api-typescript` to 6.1.12 ([#229](https://github.com/Doist/todoist-ai/issues/229)) ([54e3552](https://github.com/Doist/todoist-ai/commit/54e3552b68d648a042bac9991cb600fd8f8f5be1))
+* **deps:** update dependency @modelcontextprotocol/sdk to v1.22.0 ([#227](https://github.com/Doist/todoist-ai/issues/227)) ([b20c05e](https://github.com/Doist/todoist-ai/commit/b20c05e3273ff6a565380cdddb9be5743ba7bb66))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v5.1.1)
+
+---
+
+## v5.1.0: v5.1.0
+**Published:** 2025-11-20
+
+## [5.1.0](https://github.com/Doist/todoist-ai/compare/v5.0.2...v5.1.0) (2025-11-20)
+
+
+### Features
+
+* add read-only and destructive hints to all tools ([#222](https://github.com/Doist/todoist-ai/issues/222)) ([5d8ce22](https://github.com/Doist/todoist-ai/commit/5d8ce225c92a688834881bde13d5956bbe7e59ff))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v5.1.0)
+
+---
+
+## v5.0.2: v5.0.2
+**Published:** 2025-11-19
+
+## [5.0.2](https://github.com/Doist/todoist-ai/compare/v5.0.1...v5.0.2) (2025-11-19)
+
+
+### Bug Fixes
+
+* **find-projects:** resolve search pagination issue and update PROJECTS_MAX ([#223](https://github.com/Doist/todoist-ai/issues/223)) ([b0772d1](https://github.com/Doist/todoist-ai/commit/b0772d1dd688188cc70dcdd50989208fd18f9c39))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v5.0.2)
+
+---
+
+## v5.0.1: v5.0.1
+**Published:** 2025-11-18
+
+## [5.0.1](https://github.com/Doist/todoist-ai/compare/v5.0.0...v5.0.1) (2025-11-18)
+
+
+### Bug Fixes
+
+* **deps:** update production dependencies ([#220](https://github.com/Doist/todoist-ai/issues/220)) ([f6121b0](https://github.com/Doist/todoist-ai/commit/f6121b0fcc7bf432e07df7a8ef9c11291ba09dfb))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v5.0.1)
+
+---
+
+## v5.0.0: v5.0.0
+**Published:** 2025-11-14
+
+## [5.0.0](https://github.com/Doist/todoist-ai/compare/v4.17.4...v5.0.0) (2025-11-14)
+
+
+### ⚠ BREAKING CHANGES
+
+* semantic priority values (P1, P2, P3, P4) instead of numeric ([#217](https://github.com/Doist/todoist-ai/issues/217))
+
+### Features
+
+* semantic priority values (P1, P2, P3, P4) instead of numeric ([#217](https://github.com/Doist/todoist-ai/issues/217)) ([9bb906b](https://github.com/Doist/todoist-ai/commit/9bb906b48d836898bf616df60cef38aaa7ae2894))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v5.0.0)
+
+---
+
+## v4.17.4: v4.17.4
+**Published:** 2025-11-13
+
+## [4.17.4](https://github.com/Doist/todoist-ai/compare/v4.17.3...v4.17.4) (2025-11-13)
+
+
+### Bug Fixes
+
+* correct priority inversion for task outputs ([#216](https://github.com/Doist/todoist-ai/issues/216)) ([b4b4809](https://github.com/Doist/todoist-ai/commit/b4b4809f129d6aa029f0ef4aa28352760c879aee))
+* **deps:** pin dependencies ([#212](https://github.com/Doist/todoist-ai/issues/212)) ([2049ebf](https://github.com/Doist/todoist-ai/commit/2049ebf4e5eedd2465650c79c16e39f04a5e4ddd))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.17.4)
+
+---
+
+## v4.17.3: v4.17.3
+**Published:** 2025-11-06
+
+## [4.17.3](https://github.com/Doist/todoist-ai/compare/v4.17.2...v4.17.3) (2025-11-06)
+
+
+### Bug Fixes
+
+* **deps:** Bump `@doist/todoist-api-typescript` package ([#210](https://github.com/Doist/todoist-ai/issues/210)) ([85fbfb5](https://github.com/Doist/todoist-ai/commit/85fbfb591f2e4ee165b71ff1386a39ab96d7e31a))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.17.3)
+
+---
+
+## v4.17.2: v4.17.2
+**Published:** 2025-11-06
+
+## [4.17.2](https://github.com/Doist/todoist-ai/compare/v4.17.1...v4.17.2) (2025-11-06)
+
+
+### Bug Fixes
+
+* enforce output schemas for tools (follow-up) ([#208](https://github.com/Doist/todoist-ai/issues/208)) ([c83772a](https://github.com/Doist/todoist-ai/commit/c83772a7c29314891b1e031dce9f07d954b4e4a5))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.17.2)
+
+---
+
+## v4.17.1: v4.17.1
+**Published:** 2025-11-06
+
+## [4.17.1](https://github.com/Doist/todoist-ai/compare/v4.17.0...v4.17.1) (2025-11-06)
+
+
+### Bug Fixes
+
+* enforce output schemas for tools ([#205](https://github.com/Doist/todoist-ai/issues/205)) ([9b1d593](https://github.com/Doist/todoist-ai/commit/9b1d59317dbe5277b6f4126388a2402cf3c35e8e))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.17.1)
+
+---
+
+## v4.17.0: v4.17.0
+**Published:** 2025-11-05
+
+## [4.17.0](https://github.com/Doist/todoist-ai/compare/v4.16.1...v4.17.0) (2025-11-05)
+
+
+### Features
+
+* Add output schema to all tools ([#203](https://github.com/Doist/todoist-ai/issues/203)) ([7663388](https://github.com/Doist/todoist-ai/commit/76633886dde65880cd049733431aa9d4a5038b84))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.17.0)
+
+---
+
+## v4.16.1: v4.16.1
+**Published:** 2025-11-05
+
+## [4.16.1](https://github.com/Doist/todoist-ai/compare/v4.16.0...v4.16.1) (2025-11-05)
+
+
+### Bug Fixes
+
+* Show next steps only for paginated tools and clarify as suggestions ([#201](https://github.com/Doist/todoist-ai/issues/201)) ([f969615](https://github.com/Doist/todoist-ai/commit/f9696155fe931b6c40859c1a2f7e82a859253288))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.16.1)
+
+---
+
+## v4.16.0: v4.16.0
+**Published:** 2025-11-03
+
+## [4.16.0](https://github.com/Doist/todoist-ai/compare/v4.15.1...v4.16.0) (2025-11-03)
+
+
+### Features
+
+* Extend "inbox" project ID support to 7 additional tools ([#198](https://github.com/Doist/todoist-ai/issues/198)) ([5bab0f9](https://github.com/Doist/todoist-ai/commit/5bab0f94ab2d997d71870202294af3c5d3ac7784))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.16.0)
+
+---
+
+## v4.15.1: v4.15.1
+**Published:** 2025-10-31
+
+## [4.15.1](https://github.com/Doist/todoist-ai/compare/v4.15.0...v4.15.1) (2025-10-31)
+
+
+### Bug Fixes
+
+* Allow `inbox` as a project id ([#193](https://github.com/Doist/todoist-ai/issues/193)) ([fe4a91f](https://github.com/Doist/todoist-ai/commit/fe4a91fe2daa7f97473b97de54385e03358a8122))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.15.1)
+
+---
+
+## v4.15.0: v4.15.0
+**Published:** 2025-10-26
+
+## [4.15.0](https://github.com/Doist/todoist-ai/compare/v4.14.5...v4.15.0) (2025-10-26)
+
+
+### Features
+
+* Add deadline support to add-tasks and update-tasks ([#186](https://github.com/Doist/todoist-ai/issues/186)) ([8f795c8](https://github.com/Doist/todoist-ai/commit/8f795c8949f40d10bf629933793d8cb4607dcb58))
+* Add parentId support to update-projects tool ([#184](https://github.com/Doist/todoist-ai/issues/184)) ([0185b83](https://github.com/Doist/todoist-ai/commit/0185b836fff1359c8303de20bcc37c8f86138180))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.15.0)
+
+---
+
+## v4.14.5: v4.14.5
+**Published:** 2025-10-25
+
+## [4.14.5](https://github.com/Doist/todoist-ai/compare/v4.14.4...v4.14.5) (2025-10-25)
+
+
+### Bug Fixes
+
+* Remove nullable type from update_tasks to fix Gemini API compatibility ([#181](https://github.com/Doist/todoist-ai/issues/181)) ([c97be7f](https://github.com/Doist/todoist-ai/commit/c97be7f39ae48d837562fd303b67ed81e8935c18))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.14.5)
+
+---
+
+## v4.14.4: v4.14.4
+**Published:** 2025-10-24
+
+## [4.14.4](https://github.com/Doist/todoist-ai/compare/v4.14.3...v4.14.4) (2025-10-24)
+
+
+### Bug Fixes
+
+* Add actions: write permission to trigger workflows ([6863953](https://github.com/Doist/todoist-ai/commit/6863953b6e92fd8b35f4692b5c609ad42631722a))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.14.4)
+
+---
+
+## v4.14.3: v4.14.3
+**Published:** 2025-10-24
+
+## [4.14.3](https://github.com/Doist/todoist-ai/compare/v4.14.2...v4.14.3) (2025-10-24)
+
+
+### Bug Fixes
+
+* Add --repo flag to gh workflow run command ([f61caa8](https://github.com/Doist/todoist-ai/commit/f61caa8c7aabce166484b95b70886aa4049c904c))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.14.3)
+
+---
+
+## v4.14.2: v4.14.2
+**Published:** 2025-10-24
+
+## [4.14.2](https://github.com/Doist/todoist-ai/compare/v4.14.1...v4.14.2) (2025-10-24)
+
+
+### Bug Fixes
+
+* Trigger publish workflow automatically from release-please ([#174](https://github.com/Doist/todoist-ai/issues/174)) ([081bc2b](https://github.com/Doist/todoist-ai/commit/081bc2ba5abfdc3bf4bfe3c282f29570877b977c))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.14.2)
+
+---
+
+## v4.14.1: v4.14.1
+**Published:** 2025-10-24
+
+## [4.14.1](https://github.com/Doist/todoist-ai/compare/v4.14.0...v4.14.1) (2025-10-24)
+
+
+### Bug Fixes
+
+* Update todoist-typescript-sdk to 5.7.1 (follow-up) ([#172](https://github.com/Doist/todoist-ai/issues/172)) ([b4f8dc3](https://github.com/Doist/todoist-ai/commit/b4f8dc3ffa4c3dd7489ece03be5a0f391130a2ce))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.14.1)
+
+---
+
+## v4.14.0: v4.14.0
+**Published:** 2025-10-23
+
+## [4.14.0](https://github.com/Doist/todoist-ai/compare/v4.13.5...v4.14.0) (2025-10-23)
+
+
+### Features
+
+* Add find-activity tool ([#169](https://github.com/Doist/todoist-ai/issues/169)) ([1abf67f](https://github.com/Doist/todoist-ai/commit/1abf67f3a99191582cf0b5ea2516420f1278dc9a))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.14.0)
+
+---
+
+## v4.13.5: v4.13.5
+**Published:** 2025-10-23
+
+## [4.13.5](https://github.com/Doist/todoist-ai/compare/v4.13.4...v4.13.5) (2025-10-23)
+
+
+### Bug Fixes
+
+* clarify find-completed-tasks scope ([#167](https://github.com/Doist/todoist-ai/issues/167)) ([f110669](https://github.com/Doist/todoist-ai/commit/f11066934d4f6b790599d0f89db416a32437edd3))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.13.5)
+
+---
+
+## v4.13.4: v4.13.4
+**Published:** 2025-10-23
+
+## [4.13.4](https://github.com/Doist/todoist-ai/compare/v4.13.3...v4.13.4) (2025-10-23)
+
+
+### Bug Fixes
+
+* Test publish workflow (no functional changes) ([#164](https://github.com/Doist/todoist-ai/issues/164)) ([68afb4c](https://github.com/Doist/todoist-ai/commit/68afb4ce06366cc022a1718e6cd0c3525c5aab48))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.13.4)
+
+---
+
+## v4.13.3: v4.13.3
+**Published:** 2025-10-23
+
+## [4.13.3](https://github.com/Doist/todoist-ai/compare/v4.13.2...v4.13.3) (2025-10-23)
+
+
+### Bug Fixes
+
+* Switch to using `moveTask` instead of `moveTasks` ([#160](https://github.com/Doist/todoist-ai/issues/160)) ([34e3fc6](https://github.com/Doist/todoist-ai/commit/34e3fc67922379bf0aef39a9e7f1939ded5f0e08))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.13.3)
+
+---
+
+## v4.13.2: v4.13.2
+**Published:** 2025-10-22
+
+## [4.13.2](https://github.com/Doist/todoist-ai/compare/v4.13.1...v4.13.2) (2025-10-22)
+
+
+### Bug Fixes
+
+* Output `checked` for the `fetch` tool ([#158](https://github.com/Doist/todoist-ai/issues/158)) ([f0a6eaf](https://github.com/Doist/todoist-ai/commit/f0a6eaf62a915cfab289f1b5181770ccd11d0bdb))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.13.2)
+
+---
+
+## v4.13.1: v4.13.1
+**Published:** 2025-10-22
+
+## [4.13.1](https://github.com/Doist/todoist-ai/compare/v4.13.0...v4.13.1) (2025-10-22)
+
+
+### Bug Fixes
+
+* Remove `updatedAt` ([#155](https://github.com/Doist/todoist-ai/issues/155)) ([3f3f345](https://github.com/Doist/todoist-ai/commit/3f3f3458f9d54f4f347dfb7c34892fb3cda7ff3b))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.13.1)
+
+---
+
+## v4.13.0: v4.13.0
+**Published:** 2025-10-21
+
+## [4.13.0](https://github.com/Doist/todoist-ai/compare/v4.12.0...v4.13.0) (2025-10-21)
+
+
+### Features
+
+* Expose completion and modification metadata in task mapping ([#153](https://github.com/Doist/todoist-ai/issues/153)) ([1e2d3b3](https://github.com/Doist/todoist-ai/commit/1e2d3b3f461e75be8cc63ae3a4e070d113f5c4da))
+* extend responsibleUser filtering to more tools ([#149](https://github.com/Doist/todoist-ai/issues/149)) ([c146d74](https://github.com/Doist/todoist-ai/commit/c146d749eb097e1d383dda00e6a09e05389969dd))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.13.0)
+
+---
+
+## v4.12.0: v4.12.0
+**Published:** 2025-10-14
+
+## [4.12.0](https://github.com/Doist/todoist-ai/compare/v4.11.0...v4.12.0) (2025-10-14)
+
+
+### Features
+
+* In find-tasks-by-date use backend filtering for responsible user ([#145](https://github.com/Doist/todoist-ai/issues/145)) ([5d1e140](https://github.com/Doist/todoist-ai/commit/5d1e1400f639e8c802019421eb0437ef39c67a64))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.12.0)
+
+---
+
+## v4.11.0: v4.11.0
+**Published:** 2025-10-13
+
+## [4.11.0](https://github.com/Doist/todoist-ai/compare/v4.10.0...v4.11.0) (2025-10-13)
+
+
+### Features
+
+* Improve findCompletedTasks to handle user timezones ([#143](https://github.com/Doist/todoist-ai/issues/143)) ([c27d897](https://github.com/Doist/todoist-ai/commit/c27d8973d0ea9342f8b1e56659fca900f920ddb3))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.11.0)
+
+---
+
+## v4.10.0: v4.10.0
+**Published:** 2025-10-10
+
+## [4.10.0](https://github.com/Doist/todoist-ai/compare/v4.9.4...v4.10.0) (2025-10-10)
+
+
+### Features
+
+* add OpenAI-compliant `search` and `fetch` tools ([#134](https://github.com/Doist/todoist-ai/issues/134)) ([153289c](https://github.com/Doist/todoist-ai/commit/153289c5cf02b2da6b3f4cf6e8a7c681b3ee3aec))
+* Clarify content vs description usage and Markdown support ([#139](https://github.com/Doist/todoist-ai/issues/139)) ([cb410a2](https://github.com/Doist/todoist-ai/commit/cb410a2c16670ec07ee2d812ba961075c3f20dda))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.10.0)
+
+---
+
+## v4.9.4: v4.9.4
+**Published:** 2025-10-06
+
+## [4.9.4](https://github.com/Doist/todoist-ai/compare/v4.9.3...v4.9.4) (2025-10-06)
+
+
+### Bug Fixes
+
+* Ensures null fields are not returned ([#130](https://github.com/Doist/todoist-ai/issues/130)) ([a016011](https://github.com/Doist/todoist-ai/commit/a0160115b6fff4b96751056506494e43f582527c))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.9.4)
+
+---
+
+## v4.9.3: v4.9.3
+**Published:** 2025-10-02
+
+## [4.9.3](https://github.com/Doist/todoist-ai/compare/v4.9.2...v4.9.3) (2025-10-02)
+
+
+### Bug Fixes
+
+* dayCount and overdue only fixes ([#128](https://github.com/Doist/todoist-ai/issues/128)) ([d020c06](https://github.com/Doist/todoist-ai/commit/d020c0622fb5c9a71b5f666406529236db76bdef))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.9.3)
+
+---
+
+## v4.9.2: v4.9.2
+**Published:** 2025-10-02
+
+## [4.9.2](https://github.com/Doist/todoist-ai/compare/v4.9.1...v4.9.2) (2025-10-02)
+
+
+### Bug Fixes
+
+* allow add-tasks to work with only content parameter ([#126](https://github.com/Doist/todoist-ai/issues/126)) ([27bda34](https://github.com/Doist/todoist-ai/commit/27bda346f465a1a2ab7a0ab833c151093a4d7044))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.9.2)
+
+---
+
+## v4.9.1: v4.9.1
+**Published:** 2025-10-01
+
+## [4.9.1](https://github.com/Doist/todoist-ai/compare/v4.9.0...v4.9.1) (2025-10-01)
+
+
+### Bug Fixes
+
+* Enhance task filtering by responsible user and update related tools ([#121](https://github.com/Doist/todoist-ai/issues/121)) ([cea0917](https://github.com/Doist/todoist-ai/commit/cea0917a8b2bd1f056e1b08f14e9cb858b9711a5))
+* preserve markdown in tasks content and description ([#124](https://github.com/Doist/todoist-ai/issues/124)) ([0cc48fe](https://github.com/Doist/todoist-ai/commit/0cc48fe93595213729d794b7b6c92d54072cf6d5))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.9.1)
+
+---
+
+## v4.8.0: v4.8.0
+**Published:** 2025-09-29
+
+## [4.8.0](https://github.com/Doist/todoist-ai/compare/v4.7.1...v4.8.0) (2025-09-29)
+
+
+### Features
+
+* merge overdue into today's tasks in find-tasks-by-date tool ([#108](https://github.com/Doist/todoist-ai/issues/108)) ([f86e69d](https://github.com/Doist/todoist-ai/commit/f86e69d3ac4861a1b99ebdc8f25f135c6d6adeeb))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.8.0)
+
+---
+
+## v4.7.1: v4.7.1
+**Published:** 2025-09-29
+
+## [4.7.1](https://github.com/Doist/todoist-ai/compare/v4.7.0...v4.7.1) (2025-09-29)
+
+
+### Bug Fixes
+
+* Convert the API priorities into a consumable priority ([#115](https://github.com/Doist/todoist-ai/issues/115)) ([e4cc62f](https://github.com/Doist/todoist-ai/commit/e4cc62f5e456c517995aaf9b8e22153923a55ff7))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.7.1)
+
+---
+
+## v4.7.0: v4.7.0
+**Published:** 2025-09-25
+
+## [4.7.0](https://github.com/Doist/todoist-ai/compare/v4.6.1...v4.7.0) (2025-09-25)
+
+
+### Features
+
+* Document the MCP setup better, including the remote endpoint ([#109](https://github.com/Doist/todoist-ai/issues/109)) ([e1e69e2](https://github.com/Doist/todoist-ai/commit/e1e69e27e91675775e7f4ea0bef709a17722131c))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.7.0)
+
+---
+
+## v4.6.1: v4.6.1
+**Published:** 2025-09-24
+
+## [4.6.1](https://github.com/Doist/todoist-ai/compare/v4.6.0...v4.6.1) (2025-09-24)
+
+
+### Bug Fixes
+
+* Update package.json with `mcpName` ([#106](https://github.com/Doist/todoist-ai/issues/106)) ([df19306](https://github.com/Doist/todoist-ai/commit/df19306adb13ff6416a37e4b49a6d2e5ab5c459f))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.6.1)
+
+---
+
+## v4.6.0: v4.6.0
+**Published:** 2025-09-24
+
+## [4.6.0](https://github.com/Doist/todoist-ai/compare/v4.5.2...v4.6.0) (2025-09-24)
+
+
+### Features
+
+* add label support for add-tasks and update-tasks tools ([#103](https://github.com/Doist/todoist-ai/issues/103)) ([a4bc708](https://github.com/Doist/todoist-ai/commit/a4bc7085b5a63402970841e586ce985cab9022d0))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.6.0)
+
+---
+
+## v4.5.2: v4.5.2
+**Published:** 2025-09-24
+
+## [4.5.2](https://github.com/Doist/todoist-ai/compare/v4.5.1...v4.5.2) (2025-09-24)
+
+
+### Miscellaneous Chores
+
+* Release 4.5.2 ([11df6f2](https://github.com/Doist/todoist-ai/commit/11df6f2c03e31bffd02a6c4f1a5176158e434e05))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.5.2)
+
+---
+
+## v4.5.0: v4.5.0
+**Published:** 2025-09-11
+
+## [4.5.0](https://github.com/Doist/todoist-ai/compare/v4.4.0...v4.5.0) (2025-09-11)
+
+
+### Features
+
+* add task assignment management ([#81](https://github.com/Doist/todoist-ai/issues/81)) ([b9b1691](https://github.com/Doist/todoist-ai/commit/b9b16916dec8f18efc37631d77f97354fae2194a))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.5.0)
+
+---
+
+## v4.4.0: v4.4.0
+**Published:** 2025-09-10
+
+## [4.4.0](https://github.com/Doist/todoist-ai/compare/v4.3.0...v4.4.0) (2025-09-10)
+
+
+### Features
+
+* Add user's id to user_info tool ([#84](https://github.com/Doist/todoist-ai/issues/84)) ([706ed8f](https://github.com/Doist/todoist-ai/commit/706ed8fdfd11199808ca9824d4c66e8211d773c1))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.4.0)
+
+---
+
+## v4.3.0: v4.3.0
+**Published:** 2025-09-09
+
+## [4.3.0](https://github.com/Doist/todoist-ai/compare/v4.2.0...v4.3.0) (2025-09-09)
+
+
+### Features
+
+* Add user-info tool and upgrade Todoist API ([#82](https://github.com/Doist/todoist-ai/issues/82)) ([b583fe1](https://github.com/Doist/todoist-ai/commit/b583fe1045ea38fbe25dfa804df9ebe958f2881d))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.3.0)
+
+---
+
+## v4.2.0: v4.2.0
+**Published:** 2025-08-29
+
+## [4.2.0](https://github.com/Doist/todoist-ai/compare/v4.1.0...v4.2.0) (2025-08-29)
+
+
+### Features
+
+* Add support for filtering by label ([#71](https://github.com/Doist/todoist-ai/issues/71)) ([b608d32](https://github.com/Doist/todoist-ai/commit/b608d32f7636a175dc62ca388892e9aef0834712))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v4.2.0)
+
+---
+
+## v3.0.0: v3.0.0
+**Published:** 2025-08-22
+
+## [3.0.0](https://github.com/Doist/todoist-ai/compare/v2.2.2...v3.0.0) (2025-08-21)
+
+
+### ⚠ BREAKING CHANGES
+
+* verb-first tool names, unify find-by-container into find-tasks ([#53](https://github.com/Doist/todoist-ai/issues/53))
+* Remove single update task and replace with multiple ([#47](https://github.com/Doist/todoist-ai/issues/47))
+
+### Features
+
+* Improve tool output UX with LLM-readable responses ([#49](https://github.com/Doist/todoist-ai/issues/49)) ([7c25696](https://github.com/Doist/todoist-ai/commit/7c25696926bbaee158482cbc75595e80959e1c12))
+* Remove single update task and replace with multiple ([#47](https://github.com/Doist/todoist-ai/issues/47)) ([8a9b7cf](https://github.com/Doist/todoist-ai/commit/8a9b7cf119a405a2849ab95c437a344961790686))
+* verb-first tool names, unify find-by-container into find-tasks ([#53](https://github.com/Doist/todoist-ai/issues/53)) ([dbada71](https://github.com/Doist/todoist-ai/commit/dbada719d98df4bb91a52a0a7af8afb6ad6f3fae))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v3.0.0)
+
+---
+
+## v2.0.0: v2.0.0
+**Published:** 2025-08-13
+
+## [2.0.0](https://github.com/Doist/todoist-ai/compare/v1.1.0...v2.0.0) (2025-08-13)
+
+
+### ⚠ BREAKING CHANGES
+
+* Consolidate MCP tools to reduce tool count ([#14](https://github.com/Doist/todoist-ai/issues/14))
+
+### Features
+
+* Consolidate MCP tools to reduce tool count ([#14](https://github.com/Doist/todoist-ai/issues/14)) ([f0ccdf8](https://github.com/Doist/todoist-ai/commit/f0ccdf8fd17f046fdb8d0938dea94163fd916a7c))
+
+
+### Bug Fixes
+
+* update release-please action to googleapis/release-please-action@v4 ([7fbb5fd](https://github.com/Doist/todoist-ai/commit/7fbb5fdd3f435e68a9b2ba054247d29e82fcc465))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v2.0.0)
+
+---
+
+## v1.1.0: v1.1.0
+**Published:** 2025-08-13
+
+## [1.1.0](https://github.com/Doist/todoist-ai/compare/v1.0.0...v1.1.0) (2025-08-13)
+
+
+### Features
+
+* Adds completed tasks tool ([#8](https://github.com/Doist/todoist-ai/issues/8)) ([d0ffad1](https://github.com/Doist/todoist-ai/commit/d0ffad10a331c16f14b4d738ed7ac368fd8e44b4))
+
+[View on GitHub](https://github.com/Doist/todoist-ai/releases/tag/v1.1.0)
+
+---
+
diff --git a/vault/.claude/skills/vault-health/SKILL.md b/vault/.claude/skills/vault-health/SKILL.md
new file mode 100644
index 0000000..d1da7f9
--- /dev/null
+++ b/vault/.claude/skills/vault-health/SKILL.md
@@ -0,0 +1,249 @@
+---
+type: note
+description: "Vault health monitoring, MOC generation, link repair, and system evolution. Use this skill when checking vault quality metrics, regenerating MOC indexes, fixing broken links, finding backlinks, or triggering weekly system reflections. Also use it when the user mentions health score, link density, orphans, dead-ends, or description coverage."
+name: vault-health
+depends_on: [graph-builder]
+---
+
+# Vault Health
+
+Monitoring and improving knowledge graph health. Built on patterns from [arscontexta](https://github.com/agenticnotetaking/arscontexta) — derivation engine for Claude Code.
+
+## Origin
+
+Skill based on arscontexta analysis (Heinrich's derivation engine, 249 research claims).
+
+Key adopted patterns:
+- **Health scoring** — composite metric for quantitative vault assessment
+- **Explicit wikilinks in MOC** — instead of dataview (invisible to agents)
+- **Operational learning loop** — observations → patterns → improvements
+- **Typed relationships** — links with context phrases, not bare `related:[]`
+- **Description as retrieval filter** — progressive disclosure for agents
+
+---
+
+## Quick Start
+
+```bash
+# Full diagnostics (health score, orphans, broken links, dead-ends)
+uv run vault/.claude/skills/graph-builder/scripts/analyze.py
+
+# Regenerate MOC with explicit wikilinks
+uv run vault/.claude/skills/vault-health/scripts/generate_moc.py
+
+# Find who links to a file
+bash vault/.claude/skills/vault-health/scripts/backlinks.sh "business/crm/acme-corp"
+
+# Find and fix broken links (dry run)
+uv run vault/.claude/skills/vault-health/scripts/fix_links.py
+
+# Apply fixes
+uv run vault/.claude/skills/vault-health/scripts/fix_links.py --apply
+```
+
+---
+
+## Health Score
+
+Composite metric in analyze.py. Formula:
+
+```
+health_score = 100
+    - (orphan_ratio × 30)         # orphans = knowledge loss
+    - (broken_ratio × 30)         # broken links = fragmentation
+    - max(0, (3 - avg_links) × 15)  # target: 3+ links/file
+    - ((1 - desc_ratio) × 10)     # description coverage
+```
+
+### Metrics and targets
+
+| Metric | Target | How to improve |
+|--------|--------|----------------|
+| Health Score | >80 | All other metrics |
+| Avg links/file | >3.0 | generate_moc.py, typed relationships |
+| Broken links | <50 | fix_links.py, manual review |
+| Orphans | <30 | graph-builder orphan resolution |
+| Dead-ends | <100 | Add backlinks to CRM |
+| Desc coverage | >50% | Add description to frontmatter |
+
+### Trend tracking
+
+History stored in `.graph/health-history.json` (up to 90 entries). Each analyze.py run adds a data point.
+
+```bash
+# View trend
+cat vault/.graph/health-history.json | python3 -c "
+import json, sys
+data = json.load(sys.stdin)
+for d in data[-10:]:
+    print(f\"{d['date']}: {d['health_score']}/100 | links: {d['total_links']} | broken: {d['broken_links']}\")
+"
+```
+
+---
+
+## MOC Generation
+
+`generate_moc.py` creates Maps of Content with **explicit wikilinks and context phrases** (arscontexta pattern). Dataview queries preserved at end of files.
+
+### What it generates
+
+**MOC-business.md:**
+- Active Deals (with deadline and deal value)
+- High Priority clients
+- Grouping by industry (FMCG, Banks, Retail, ...)
+- Within industry: Active first, then Prospect
+
+**MOC-projects.md:**
+- Hot/Active leads
+- Clients
+- Projects, Resources
+
+### Wikilink format
+
+```markdown
+- [[business/crm/acme-corp\|Acme Corp]] — Active, p1, Project $XXK, deadline YYYY-MM-DD
+```
+
+Each link contains: status, priority, deal info, region, deadline — agent sees context without opening file.
+
+### When to run
+
+- After adding new CRM files
+- After updating status/deal_status in CRM
+- Recommended: weekly or when changes in `business/crm/` / `projects/`
+
+---
+
+## Link Repair
+
+### fix_links.py
+
+Finds broken links and suggests fixes via fuzzy stem matching.
+
+**Strategies:**
+1. **Trailing backslash** — Obsidian table escaping artifact (`\|`)
+2. **Wrong prefix** — `crm/company` → `business/crm/company`
+3. **Stem match** — `old-name` → finds `new-name.md` by stem match
+
+**Exclusions:** backup directories, attachment embeds, directory links.
+
+```bash
+# Dry run — shows suggestions
+uv run vault/.claude/skills/vault-health/scripts/fix_links.py
+
+# Apply
+uv run vault/.claude/skills/vault-health/scripts/fix_links.py --apply
+```
+
+### backlinks.sh
+
+Find files linking TO specified file (incoming links).
+
+```bash
+# Who links to Acme Corp?
+bash vault/.claude/skills/vault-health/scripts/backlinks.sh "business/crm/acme-corp"
+
+# Who links to MEMORY.md?
+bash vault/.claude/skills/vault-health/scripts/backlinks.sh "MEMORY"
+```
+
+### Dead-end detection
+
+Dead-end = file with outgoing links but no incoming (knows about others, but nobody knows about it). Detected by analyze.py, output in report.md.
+
+---
+
+## Weekly Reflection
+
+Operational learning loop: observations → patterns → proposals.
+
+### Trigger
+
+- Every Sunday
+- When observations in `.session/handoff.md` reach ≥10
+
+### Process
+
+1. Read `.session/handoff.md` → collect `## Observations`
+2. Read `.graph/health-history.json` → week's trend
+3. Group observations by type (friction/pattern/idea)
+4. Find recurring patterns (>2 occurrences)
+5. Propose concrete improvements (file + change)
+6. Write reflection file
+7. Clear processed observations from handoff.md
+
+### Output
+
+```
+thoughts/reflections/YYYY-WNN-system-reflection.md
+```
+
+Detailed template: `.claude/rules/weekly-reflection.md`
+
+### Observation format
+
+In `.session/handoff.md`, section `## Observations`:
+
+```markdown
+- [friction] 2026-02-19: mcp-cli timeout 3x — retry saved, -60 sec
+- [pattern] 2026-02-19: 65 "broken links" were attachment embeds
+- [idea] 2026-02-19: generate_moc.py in process.sh chain
+```
+
+Types: `friction` (something broke/slow), `pattern` (recurring), `idea` (improvement).
+
+---
+
+## Typed Relationships
+
+When adding links between files, use context phrases (arscontexta pattern):
+
+| Type | When | Example |
+|------|------|---------|
+| **extends** | Develops an idea | `[[note]] — extends: deepens analysis` |
+| **context** | Background info | `[[note]] — context: meeting where discussed` |
+| **supports** | Supports a goal | `[[goal]] — supports: annual target` |
+| **contradicts** | Contradicts | `[[note]] — contradicts: different approach` |
+| **enables** | Makes possible | `[[tool]] — enables: workflow` |
+| **requires** | Dependency | `[[resource]] — requires: API key` |
+
+---
+
+## Description Guidelines
+
+Description = retrieval filter, NOT summary. Adds information BEYOND title.
+
+```yaml
+# WRONG (repeats title):
+# title: "Acme Corp"
+description: "Company Acme Corp"
+
+# RIGHT (adds retrieval info):
+# title: "Acme Corp"
+description: "Key client in [industry], active deal $XXK, [project] in progress"
+```
+
+Target: ~150 chars. Scope, mechanism, implication — not retelling.
+
+---
+
+## Automation in process.sh
+
+analyze.py runs **automatically** every day through `scripts/process.sh`:
+- If daily is empty → graph-only rebuild
+- After full processing → final rebuild
+
+generate_moc.py, fix_links.py, backlinks.sh — manual run as needed.
+
+---
+
+## References
+
+- `references/arscontexta-patterns.md` — patterns from arscontexta, adapted for agent-second-brain
+- `.claude/rules/weekly-reflection.md` — template for weekly reflections
+
+## Relevant Skills
+
+- [[vault/.claude/skills/graph-builder/SKILL|graph-builder]] — core graph analysis (analyze.py)
+- [[vault/.claude/skills/dbrain-processor/SKILL|dbrain-processor]] — daily processing pipeline
diff --git a/vault/.claude/skills/vault-health/references/arscontexta-patterns.md b/vault/.claude/skills/vault-health/references/arscontexta-patterns.md
new file mode 100644
index 0000000..789a5e4
--- /dev/null
+++ b/vault/.claude/skills/vault-health/references/arscontexta-patterns.md
@@ -0,0 +1,105 @@
+---
+type: note
+title: Arscontexta Patterns for dbrain
+last_accessed: 2026-02-19
+relevance: 0.91
+tier: active
+---
+# Arscontexta Patterns for dbrain
+
+Паттерны из [arscontexta](https://github.com/agenticnotetaking/arscontexta), адаптированные для dbrain vault.
+
+## Source
+
+arscontexta — derivation engine для Claude Code (Heinrich). 249 research claims из cognitive science, network theory, Zettelkasten, agent architecture. Каждое архитектурное решение трейсится к конкретному claim.
+
+## Adopted Patterns
+
+### 1. Health Scoring (quantitative vault assessment)
+
+**Claim:** Системы без метрик деградируют незаметно.
+
+**Реализация:** `analyze.py` → `health_score` → `health-history.json`
+
+Формула: 100 - orphan_penalty(30) - broken_penalty(30) - density_penalty(15) - desc_penalty(10)
+
+### 2. Phase Isolation (fresh context per phase)
+
+**Claim:** `[[LLM attention degrades as context fills]]`
+
+**Реализация:** 3-phase pipeline в process.sh:
+- CAPTURE: classify entries → JSON (minimal context)
+- EXECUTE: create tasks, save thoughts → JSON (MCP tools)
+- REFLECT: generate report, update MEMORY (read-only)
+
+JSON handoff между фазами. Fallback на монолит при ошибке.
+
+### 3. Operational Learning Loop (observations → improvements)
+
+**Claim:** `[[operational-learning-loop]]` (INVARIANT primitive в arscontexta)
+
+**Реализация:**
+- `handoff.md` → `## Observations` (friction/pattern/idea)
+- dbrain-processor Step 11: автоматический capture
+- Weekly reflection: анализ observations → proposals
+
+### 4. Description as Retrieval Filter
+
+**Claim:** `[[descriptions are retrieval filters not summaries]]`
+
+**Реализация:** `description: string` в frontmatter schema. Adds scope/mechanism beyond title. ~150 chars.
+
+### 5. Prose-as-Title (claims, not labels)
+
+**Claim:** `[[note titles should function as APIs enabling sentence transclusion]]`
+
+**Реализация:** Для thoughts/ (не CRM): title = specific claim.
+Test: `Since [[title]], ...` reads naturally.
+
+### 6. Explicit Wikilinks in MOC
+
+**Claim:** MOC должен быть видим для agents и graph analysis, не только для Obsidian renderer.
+
+**Реализация:** `generate_moc.py` — 286 explicit wikilinks с context phrases.
+Dataview сохранён для Obsidian UX.
+
+### 7. Typed Relationships
+
+**Claim:** `related:[]` без контекста = бесполезно. Нужен тип связи.
+
+**Реализация:** 6 типов: extends, context, supports, contradicts, enables, requires.
+
+### 8. Orient Phase (OODA loop)
+
+**Claim:** Не тратить ресурсы на обработку пустого.
+
+**Реализация:** Pre-flight checks в process.sh: daily exists, size > 50 bytes, handoff exists, graph freshness.
+
+## Consciously NOT Adopted
+
+| Pattern | Why not |
+|---------|---------|
+| Three-space restructure (self/notes/ops) | dbrain already has functional equivalent |
+| Full 6Rs pipeline | 6 Claude calls too expensive for automated daily pipeline |
+| PostToolUse hooks (schema validation) | analyze.py on rebuild sufficient for 655 files |
+| Per-claim task queue (ops/queue/) | Todoist is our task manager |
+| Semantic search (qmd MCP) | Hub navigation + rg sufficient at current scale |
+| Personality layer | Not needed for automated processor |
+| Derivation manifest | System grown organically, not derived |
+
+## 8 Architectural Dimensions
+
+arscontexta projects each system onto 8 axes. dbrain position:
+
+| Axis | dbrain | Notes |
+|------|--------|-------|
+| Granularity | Mixed | CRM=entity (coarse), thoughts=atomic |
+| Organization | Hierarchical | 3 domains with _index.md hubs |
+| Linking | Explicit | Wikilinks |
+| Processing | Medium | 3 phases (not 6Rs) |
+| Navigation | Medium | MOC + _index hubs |
+| Maintenance | Automated | systemd timer |
+| Schema | Dense | 3 typed schemas (CRM, Learning, Aimasters) |
+| Automation | Convention + script | No hooks, process.sh + analyze.py |
+
+Key constraint: Atomic granularity REQUIRES explicit linking + deep navigation. Our mixed approach (CRM coarse + thoughts atomic) = conscious trade-off, compensated by hub navigation.
diff --git a/vault/.claude/skills/vault-health/scripts/add_descriptions.py b/vault/.claude/skills/vault-health/scripts/add_descriptions.py
new file mode 100644
index 0000000..8d61fde
--- /dev/null
+++ b/vault/.claude/skills/vault-health/scripts/add_descriptions.py
@@ -0,0 +1,318 @@
+#!/usr/bin/env python3
+"""
+Add description field to frontmatter of vault files.
+
+Strategy by file type:
+- CRM files: "{title} — {type}, {industry}, {status}, {deal_status}"
+- Thoughts: first non-empty paragraph after frontmatter, truncated to 150 chars
+- MOC: "Map of Content: {topic}, N entries"
+- Goals: from first paragraph
+- Summaries: "Weekly summary for {week}"
+- Other: first paragraph, truncated to 150 chars
+
+Skips:
+- daily/ files (don't need descriptions per convention)
+- Files that already have description field
+
+Usage:
+  uv run vault/.claude/skills/vault-health/scripts/add_descriptions.py          # dry-run
+  uv run vault/.claude/skills/vault-health/scripts/add_descriptions.py --apply  # apply
+"""
+
+import json
+import re
+import sys
+from pathlib import Path
+
+SCRIPT_DIR = Path(__file__).parent
+VAULT_PATH = SCRIPT_DIR.parents[3]
+GRAPH_PATH = VAULT_PATH / ".graph" / "vault-graph.json"
+
+IGNORE_DIRS = {".obsidian", "attachments", ".git", ".graph", ".claude", ".trash"}
+IGNORE_PATTERNS = {"backup", ".backup", "archive"}
+
+
+def load_graph():
+    if not GRAPH_PATH.exists():
+        print("Error: vault-graph.json not found. Run analyze.py first.")
+        sys.exit(1)
+    return json.loads(GRAPH_PATH.read_text(encoding="utf-8"))
+
+
+def parse_frontmatter(content: str) -> dict[str, str]:
+    """Extract YAML frontmatter as simple key-value pairs."""
+    match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
+    if not match:
+        return {}
+    fm = {}
+    for line in match.group(1).split("\n"):
+        if ":" in line and not line.strip().startswith("-") and not line.strip().startswith("#"):
+            key, _, value = line.partition(":")
+            key = key.strip()
+            value = value.strip().strip('"').strip("'")
+            if key and value and not value.startswith("[") and not value.startswith("{"):
+                fm[key] = value
+    return fm
+
+
+def get_body_after_frontmatter(content: str) -> str:
+    """Get content after frontmatter."""
+    match = re.match(r"^---\n.*?\n---\n?", content, re.DOTALL)
+    if match:
+        return content[match.end():]
+    return content
+
+
+def extract_first_paragraph(body: str) -> str:
+    """Extract first non-empty, non-heading paragraph from body."""
+    lines = body.split("\n")
+    paragraph_lines = []
+    in_paragraph = False
+
+    for line in lines:
+        stripped = line.strip()
+
+        # Skip empty lines before paragraph starts
+        if not stripped and not in_paragraph:
+            continue
+
+        # Skip headings, callouts, code blocks, links-only lines
+        if stripped.startswith(("#", ">", "```", "---", "| ", "- [[", "![")):
+            if in_paragraph:
+                break
+            continue
+
+        if stripped:
+            in_paragraph = True
+            paragraph_lines.append(stripped)
+        elif in_paragraph:
+            break
+
+    text = " ".join(paragraph_lines)
+    # Remove wikilinks: [[path|text]] → text, [[path]] → path
+    text = re.sub(r"\[\[([^\]|]+)\|([^\]]+)\]\]", r"\2", text)
+    text = re.sub(r"\[\[([^\]]+)\]\]", r"\1", text)
+    # Remove markdown formatting
+    text = re.sub(r"\*\*([^*]+)\*\*", r"\1", text)
+    text = re.sub(r"\*([^*]+)\*", r"\1", text)
+    text = re.sub(r"`([^`]+)`", r"\1", text)
+    return text.strip()
+
+
+def truncate(text: str, max_len: int = 150) -> str:
+    """Truncate text to max_len on word boundary."""
+    if len(text) <= max_len:
+        return text
+    truncated = text[:max_len]
+    # Find last space
+    last_space = truncated.rfind(" ")
+    if last_space > max_len // 2:
+        truncated = truncated[:last_space]
+    return truncated.rstrip(".,;: ") + "..."
+
+
+def generate_description(rel_path: str, content: str, fm: dict) -> str | None:
+    """Generate a description for a file based on its type and content."""
+
+    # CRM files (business/crm/, projects/crm/)
+    if any(rel_path.startswith(p) for p in ("business/crm/", "projects/crm/")):
+        # Extract title from H1 or filename
+        title_match = re.search(r"^# (.+)$", content, re.MULTILINE)
+        title = title_match.group(1).strip() if title_match else Path(rel_path).stem.replace("-", " ").title()
+
+        parts = []
+        if fm.get("type"):
+            parts.append(fm["type"])
+        if fm.get("industry"):
+            parts.append(fm["industry"])
+        if fm.get("status"):
+            parts.append(fm["status"])
+        if fm.get("deal_status"):
+            parts.append(fm["deal_status"])
+        if fm.get("region"):
+            parts.append(fm["region"])
+
+        if parts:
+            return truncate(f"{title} — {', '.join(parts)}")
+        return truncate(f"{title} — CRM record")
+
+    # Projects files
+    if rel_path.startswith("projects/"):
+        title_match = re.search(r"^# (.+)$", content, re.MULTILINE)
+        title = title_match.group(1).strip() if title_match else Path(rel_path).stem.replace("-", " ").title()
+
+        parts = []
+        if fm.get("type"):
+            parts.append(fm["type"])
+        if fm.get("industry"):
+            parts.append(fm["industry"])
+        if fm.get("status"):
+            parts.append(fm["status"])
+        if parts:
+            return truncate(f"{title} — {', '.join(parts)}")
+
+        body = get_body_after_frontmatter(content)
+        para = extract_first_paragraph(body)
+        if para:
+            return truncate(para)
+        return truncate(f"{title} — Projects")
+
+    # MOC files
+    if rel_path.startswith("MOC/"):
+        topic = Path(rel_path).stem.removeprefix("MOC-").replace("-", " ").title()
+        link_count = content.count("[[")
+        return f"Map of Content: {topic}, {link_count} entries"
+
+    # Thoughts
+    if rel_path.startswith("thoughts/"):
+        body = get_body_after_frontmatter(content)
+        para = extract_first_paragraph(body)
+        if para:
+            return truncate(para)
+        # Fallback: use filename
+        stem = Path(rel_path).stem
+        # Remove date prefix if present
+        stem = re.sub(r"^\d{4}-\d{2}-\d{2}-", "", stem)
+        return stem.replace("-", " ").capitalize()
+
+    # Goals
+    if rel_path.startswith("goals/"):
+        body = get_body_after_frontmatter(content)
+        para = extract_first_paragraph(body)
+        if para:
+            return truncate(para)
+        return f"Goal: {Path(rel_path).stem.replace('-', ' ')}"
+
+    # Summaries
+    if rel_path.startswith("summaries/"):
+        stem = Path(rel_path).stem
+        week_match = re.search(r"(\d{4}-W\d{2})", stem)
+        if week_match:
+            return f"Weekly summary for {week_match.group(1)}"
+        return f"Summary: {stem.replace('-', ' ')}"
+
+    # Contacts
+    if rel_path.startswith("contacts/"):
+        body = get_body_after_frontmatter(content)
+        para = extract_first_paragraph(body)
+        if para:
+            return truncate(para)
+        return f"Contacts: {Path(rel_path).stem.replace('-', ' ')}"
+
+    # _index files
+    if Path(rel_path).stem == "_index":
+        parent = Path(rel_path).parent.name
+        return f"Index and entry point for {parent}"
+
+    # MEMORY.md
+    if Path(rel_path).name == "MEMORY.md":
+        return "Long-term memory and key decisions"
+
+    # Default: first paragraph
+    body = get_body_after_frontmatter(content)
+    para = extract_first_paragraph(body)
+    if para:
+        return truncate(para)
+
+    return None
+
+
+def add_description_to_frontmatter(content: str, description: str) -> str:
+    """Add description field to frontmatter."""
+    # Escape quotes in description
+    safe_desc = description.replace('"', '\\"')
+
+    if content.startswith("---\n"):
+        match = re.match(r"^(---\n)(.*?)(\n---)", content, re.DOTALL)
+        if match:
+            before = match.group(1)
+            fm_body = match.group(2)
+            after = match.group(3)
+            rest = content[match.end():]
+            return f'{before}description: "{safe_desc}"\n{fm_body}{after}{rest}'
+    else:
+        # Create minimal frontmatter
+        return f'---\ndescription: "{safe_desc}"\n---\n{content}'
+
+    return content
+
+
+def main():
+    apply = "--apply" in sys.argv
+
+    graph = load_graph()
+    nodes = graph.get("nodes", {})
+
+    # Get all non-daily files
+    all_files = [
+        f for f in VAULT_PATH.rglob("*.md")
+        if not any(d in f.parts for d in IGNORE_DIRS)
+        and not any(p in str(f) for p in IGNORE_PATTERNS)
+    ]
+
+    print(f"Total markdown files: {len(all_files)}")
+    print(f"Mode: {'APPLY' if apply else 'DRY-RUN'}")
+    print()
+
+    added = 0
+    skipped_daily = 0
+    already_has = 0
+    no_description = 0
+    errors = 0
+
+    for file_path in sorted(all_files):
+        rel_path = str(file_path.relative_to(VAULT_PATH))
+
+        # Skip daily files
+        if rel_path.startswith("daily/"):
+            skipped_daily += 1
+            continue
+
+        try:
+            content = file_path.read_text(encoding="utf-8")
+        except Exception:
+            errors += 1
+            continue
+
+        # Check if already has description
+        fm = parse_frontmatter(content)
+        if fm.get("description"):
+            already_has += 1
+            continue
+
+        # Also check raw frontmatter for description: field
+        fm_match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
+        if fm_match and "description:" in fm_match.group(1):
+            already_has += 1
+            continue
+
+        description = generate_description(rel_path, content, fm)
+        if not description:
+            no_description += 1
+            if "--verbose" in sys.argv:
+                print(f"  NO DESC: {rel_path}")
+            continue
+
+        print(f"  {rel_path}: \"{description[:80]}{'...' if len(description) > 80 else ''}\"")
+        added += 1
+
+        if apply:
+            new_content = add_description_to_frontmatter(content, description)
+            file_path.write_text(new_content, encoding="utf-8")
+
+    non_daily = len(all_files) - skipped_daily
+    coverage = (already_has + added) / max(non_daily, 1) * 100
+
+    print(f"\n{'='*50}")
+    print(f"Non-daily files: {non_daily}")
+    print(f"Already had description: {already_has}")
+    print(f"Descriptions added: {added}")
+    print(f"Could not generate: {no_description}")
+    print(f"Errors: {errors}")
+    print(f"Projected coverage: {coverage:.1f}%")
+    if apply:
+        print(f"Files modified: {added}")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/vault/.claude/skills/vault-health/scripts/backlinks.sh b/vault/.claude/skills/vault-health/scripts/backlinks.sh
new file mode 100755
index 0000000..ce02961
--- /dev/null
+++ b/vault/.claude/skills/vault-health/scripts/backlinks.sh
@@ -0,0 +1,20 @@
+#!/bin/bash
+# Find all files that link to a given target
+# Usage: bash backlinks.sh "business/crm/acme-corp"
+#        bash backlinks.sh "thoughts/ideas/sample-idea"
+
+set -e
+
+VAULT_DIR="$(cd "$(dirname "$0")/../../.." && pwd)"
+TARGET="${1%.md}"
+
+if [ -z "$TARGET" ]; then
+    echo "Usage: backlinks.sh "
+    echo "Example: backlinks.sh business/crm/acme-corp"
+    exit 1
+fi
+
+# Search for wikilinks to target (with or without .md, with or without alias)
+rg -l "\[\[$TARGET" "$VAULT_DIR" --glob '*.md' 2>/dev/null | \
+    sed "s|$VAULT_DIR/||" | \
+    sort
diff --git a/vault/.claude/skills/vault-health/scripts/connect_orphans.py b/vault/.claude/skills/vault-health/scripts/connect_orphans.py
new file mode 100644
index 0000000..4ccddda
--- /dev/null
+++ b/vault/.claude/skills/vault-health/scripts/connect_orphans.py
@@ -0,0 +1,169 @@
+#!/usr/bin/env python3
+"""
+Connect orphan and weakly-connected files by adding related links to hub files.
+
+Strategy:
+- business/crm/* → related: ["[[business/_index]]"]
+- projects/crm/* → related: ["[[projects/_index]]"]
+- daily/* (old) → skip (expected orphans)
+- templates/* → skip
+- projects/* → related: ["[[projects/_index]]"]
+- business/* → related: ["[[business/_index]]"]
+- thoughts/* → related: ["[[MEMORY]]"]
+- Other → related: ["[[MEMORY]]"]
+
+Also processes weakly_connected files (total_links < 2) with same logic.
+
+Usage:
+  uv run vault/.claude/skills/vault-health/scripts/connect_orphans.py          # dry-run
+  uv run vault/.claude/skills/vault-health/scripts/connect_orphans.py --apply  # apply
+"""
+
+import json
+import re
+import sys
+from pathlib import Path
+
+SCRIPT_DIR = Path(__file__).parent
+VAULT_PATH = SCRIPT_DIR.parents[3]
+GRAPH_PATH = VAULT_PATH / ".graph" / "vault-graph.json"
+
+# Hub mapping by path prefix
+HUB_MAP = [
+    ("business/crm/", '[[business/_index]]'),
+    ("projects/crm/", '[[projects/_index]]'),
+    ("business/network/", '[[business/_index]]'),
+    ("business/events/", '[[business/_index]]'),
+    ("business/", '[[business/_index]]'),
+    ("projects/clients/", '[[projects/_index]]'),
+    ("projects/leads/", '[[projects/_index]]'),
+    ("projects/", '[[projects/_index]]'),
+    ("thoughts/", '[[MEMORY]]'),
+    ("goals/", '[[MEMORY]]'),
+    ("contacts/", '[[MEMORY]]'),
+    ("MOC/", '[[MEMORY]]'),
+    ("summaries/", '[[MEMORY]]'),
+    (".session/", '[[MEMORY]]'),
+]
+
+SKIP_PREFIXES = ("daily/", "templates/", ".claude/", ".graph/")
+
+
+def load_graph():
+    if not GRAPH_PATH.exists():
+        print("Error: vault-graph.json not found. Run analyze.py first.")
+        sys.exit(1)
+    return json.loads(GRAPH_PATH.read_text(encoding="utf-8"))
+
+
+def get_hub_for_path(rel_path: str) -> str | None:
+    """Determine the hub link for a given file path."""
+    if any(rel_path.startswith(p) for p in SKIP_PREFIXES):
+        return None
+    for prefix, hub in HUB_MAP:
+        if rel_path.startswith(prefix):
+            return hub
+    return '[[MEMORY]]'
+
+
+def has_frontmatter(content: str) -> bool:
+    """Check if content has YAML frontmatter."""
+    return content.startswith("---\n")
+
+
+def has_related_field(content: str) -> bool:
+    """Check if frontmatter already has a related field."""
+    match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
+    if match:
+        return "related:" in match.group(1)
+    return False
+
+
+def has_description_field(content: str) -> bool:
+    """Check if frontmatter already has a description field."""
+    match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
+    if match:
+        return "description:" in match.group(1)
+    return False
+
+
+def add_related_to_frontmatter(content: str, hub_link: str) -> str:
+    """Add related field to existing frontmatter or create new frontmatter."""
+    if has_related_field(content):
+        return content  # Already has related
+
+    if has_frontmatter(content):
+        # Insert related before closing ---
+        match = re.match(r"^(---\n)(.*?)(\n---)", content, re.DOTALL)
+        if match:
+            before = match.group(1)
+            fm_body = match.group(2)
+            after = match.group(3)
+            rest = content[match.end():]
+            return f"{before}{fm_body}\nrelated:\n  - \"{hub_link}\"{after}{rest}"
+    else:
+        # Create minimal frontmatter
+        return f"---\nrelated:\n  - \"{hub_link}\"\n---\n{content}"
+
+    return content
+
+
+def main():
+    apply = "--apply" in sys.argv
+
+    graph = load_graph()
+    orphans = graph.get("orphans", [])
+    weakly_connected = graph.get("weakly_connected", [])
+
+    # Combine: orphans + weakly_connected for maximum link density improvement
+    targets = set(orphans + weakly_connected)
+
+    print(f"Orphans: {len(orphans)}")
+    print(f"Weakly connected: {len(weakly_connected)}")
+    print(f"Total targets: {len(targets)}")
+    print(f"Mode: {'APPLY' if apply else 'DRY-RUN'}")
+    print()
+
+    connected = 0
+    skipped = 0
+    already_has = 0
+    errors = 0
+
+    for rel_path in sorted(targets):
+        hub_link = get_hub_for_path(rel_path)
+        if hub_link is None:
+            skipped += 1
+            continue
+
+        file_path = VAULT_PATH / rel_path
+        if not file_path.exists():
+            errors += 1
+            print(f"  MISSING: {rel_path}")
+            continue
+
+        content = file_path.read_text(encoding="utf-8")
+
+        if has_related_field(content):
+            already_has += 1
+            continue
+
+        new_content = add_related_to_frontmatter(content, hub_link)
+
+        if new_content != content:
+            tag = "ORPHAN" if rel_path in orphans else "WEAK"
+            print(f"  [{tag}] {rel_path} → {hub_link}")
+            connected += 1
+            if apply:
+                file_path.write_text(new_content, encoding="utf-8")
+
+    print(f"\n{'='*50}")
+    print(f"Connected: {connected}")
+    print(f"Skipped (daily/template/internal): {skipped}")
+    print(f"Already has related: {already_has}")
+    print(f"Missing files: {errors}")
+    if apply:
+        print(f"Files modified: {connected}")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/vault/.claude/skills/vault-health/scripts/fix_links.py b/vault/.claude/skills/vault-health/scripts/fix_links.py
new file mode 100644
index 0000000..90a092e
--- /dev/null
+++ b/vault/.claude/skills/vault-health/scripts/fix_links.py
@@ -0,0 +1,393 @@
+#!/usr/bin/env python3
+"""
+Fix broken wiki-links in vault using pattern matching and heuristics.
+
+Patterns handled:
+1. Trailing backslash: [[business/crm/acme-corp]] with trailing backslash → clean
+2. Wrong prefix: [[crm/projects/X]] → [[projects/clients/X]] or [[projects/leads/X]]
+3. Stem match: [[acme-corp]] → [[business/crm/acme-corp]] (when unique match exists)
+4. CRM sub-project → parent: [[business/crm/client-a-smm]] → [[business/crm/client-a]]
+5. business/projects/ → parent CRM: [[business/projects/brand-x-campaign-2026]] → [[business/crm/brand-x]]
+6. Plaintext company names (self-refs): [[Acme]] inside acme.md → remove wikilink
+7. Goals aliases: [[3-weekly-2026-W05]] → remove
+8. Internal paths (.claude/, vault/, scripts/): [[.claude/CLAUDE]] → `code ref`
+9. Stub/concept links: [[craftsmanship]], [[ai-philosophy]] → plain text
+10. Misc: attachments, meals.md, etc. → remove wikilink
+
+Usage:
+  uv run vault/.claude/skills/vault-health/scripts/fix_links.py          # dry-run
+  uv run vault/.claude/skills/vault-health/scripts/fix_links.py --apply  # apply fixes
+"""
+
+import json
+import re
+import sys
+from pathlib import Path
+from collections import defaultdict
+
+SCRIPT_DIR = Path(__file__).parent
+VAULT_PATH = SCRIPT_DIR.parents[3]
+GRAPH_PATH = VAULT_PATH / ".graph" / "vault-graph.json"
+
+IGNORE_DIRS = {".obsidian", "attachments", ".git", ".graph", ".claude", ".trash"}
+EXCLUDE_PATTERNS = {"backup", ".backup", "business.backup"}
+
+# Pattern A: CRM sub-project → parent CRM file
+CRM_PARENT_MAP = {
+    "client-a-smm": "client-a",
+    "brand-x-meals-ncp": "brand-x",
+    "brand-x-smm-region": "brand-x",
+    "client-b-smm": "client-b",
+    "client-c-wh": "client-c",
+    "client-d-smm": "client-d",
+    "client-e-influencers": "client-e",
+    "techco-region": "techco",
+    "brand-x-sub-smm": "brand-x",
+    "brand-x-snacks-2026": "brand-x",
+    "techco-eats-city": None,  # no parent — remove link
+    "techco-eats-tc": None,  # no parent — remove link
+    "brand-y": "brand-y-campaign",
+}
+
+# Pattern B: business/projects/ → parent CRM
+PROJECT_CLIENT_MAP = {
+    "brand-x-meals-ncp-2026": "brand-x",
+    "client-a-smm-strategy-2026": "client-a",
+    "client-a-smm": "client-a",
+    "client-c-wellness": "client-c",
+    "client-f-budget-2026": "client-f",
+    "automaker-a-strategy-2026": "automaker-a",
+    "client-d-smm-tender": "client-d",
+    "automaker-b-bot-smm": "automaker-b",
+    "client-b-baby-2026": "client-b",
+    "brand-x-snacks-2026": "brand-x",
+    "fmcg-co-region-rfi": "fmcg-co",
+    "automaker-c-smm-tender": "automaker-c",
+    "tobacco-co-hr-brand": "tobacco-co",
+    "retailer-a-comstrat": "retailer-a",
+}
+
+# Pattern F: Stub/concept links that won't become files → remove wikilink
+STUB_LINKS = {
+    "craftsmanship", "ai-philosophy", "quality", "second-brain", "telegram-bot",
+    "note", "title", "frontend-design", "accessibility", "vault-processor",
+    "wikilinks", "sample-stub-link",
+}
+
+# Direct replacements for known mismatches
+DIRECT_REPLACE_MAP = {
+    "business/network/partner-alias": "business/network/partner-full-name",
+    "thoughts/ideas/sample-algorithm": "thoughts/ideas/2026-02-05-sample-agent-algorithm",
+}
+
+# Pattern F extended: Long sentence-links from external sources
+SENTENCE_LINK_PREFIXES = [
+    "LLM attention degrades",
+    "fresh context per task",
+    "note titles should function",
+    "Agent Memory System",
+    "AI agents need layered memory",
+]
+
+
+def load_graph():
+    """Load vault-graph.json."""
+    if not GRAPH_PATH.exists():
+        print("Error: vault-graph.json not found. Run analyze.py first.")
+        sys.exit(1)
+    return json.loads(GRAPH_PATH.read_text(encoding="utf-8"))
+
+
+def build_stem_index():
+    """Build index: stem → [full_paths]."""
+    index = defaultdict(list)
+    md_files = [
+        f for f in VAULT_PATH.rglob("*.md")
+        if not any(d in f.parts for d in IGNORE_DIRS)
+        and not any(p in str(f) for p in EXCLUDE_PATTERNS)
+    ]
+    for f in md_files:
+        rel = str(f.relative_to(VAULT_PATH))
+        stem = f.stem
+        index[stem].append(rel)
+        # Also index by path without .md
+        index[rel.removesuffix(".md")].append(rel)
+    return index
+
+
+def find_crm_file(client_name: str) -> str | None:
+    """Find CRM file for a client name in business/crm/."""
+    for prefix in ["business/crm/"]:
+        candidate = VAULT_PATH / f"{prefix}{client_name}.md"
+        if candidate.exists():
+            return f"{prefix}{client_name}"
+    return None
+
+
+def suggest_fix(broken_from: str, broken_to: str, stem_index: dict) -> tuple[str | None, str]:
+    """Suggest a fix for a broken link target.
+
+    Returns (suggestion, action) where action is:
+    - 'replace': replace the wikilink target
+    - 'remove': remove the wikilink, keep display text
+    - 'none': no fix found
+    """
+    target = broken_to
+
+    # Direct replacement map (known mismatches)
+    if target in DIRECT_REPLACE_MAP:
+        replacement = DIRECT_REPLACE_MAP[target]
+        # Verify the target file exists
+        if (VAULT_PATH / f"{replacement}.md").exists():
+            return replacement, "replace"
+
+    # Pattern 1: Trailing backslash
+    if target.endswith("\\"):
+        clean = target.rstrip("\\")
+        if clean in stem_index:
+            return clean, "replace"
+        if clean + ".md" in stem_index:
+            return clean, "replace"
+        stem = Path(clean).stem
+        if stem in stem_index and len(stem_index[stem]) == 1:
+            return stem_index[stem][0].removesuffix(".md"), "replace"
+
+    # Pattern 2: Wrong prefix (crm/projects/X → projects/clients/X or projects/leads/X)
+    if target.startswith("crm/projects/"):
+        name = target.removeprefix("crm/projects/").rstrip("\\")
+        for prefix in ["projects/clients/", "projects/leads/"]:
+            candidate = prefix + name
+            if candidate in stem_index or candidate + ".md" in stem_index:
+                return candidate, "replace"
+
+    # Pattern A: CRM sub-project → parent
+    for crm_prefix in ["business/crm/"]:
+        if target.startswith(crm_prefix):
+            sub_name = target.removeprefix(crm_prefix)
+            if sub_name in CRM_PARENT_MAP:
+                parent = CRM_PARENT_MAP[sub_name]
+                if parent is None:
+                    return None, "remove"
+                parent_path = find_crm_file(parent)
+                if parent_path:
+                    return parent_path, "replace"
+
+    # Pattern B: business/projects/ → parent CRM
+    if target.startswith("business/projects/"):
+        project_name = target.removeprefix("business/projects/")
+        if project_name in PROJECT_CLIENT_MAP:
+            client = PROJECT_CLIENT_MAP[project_name]
+            parent_path = find_crm_file(client)
+            if parent_path:
+                return parent_path, "replace"
+
+    # Pattern C: Plaintext company names (self-references inside CRM files)
+    # e.g. business/crm/acme-corp.md has [[Acme Corp]] — remove the wikilink
+    if not "/" in target and target[0:1].isupper() and broken_from.startswith(("business/crm/", "projects/crm/")):
+        return None, "remove"
+
+    # Pattern D: Goals aliases (3-weekly-2026-W05 etc.)
+    if re.match(r"3-weekly-2026-W\d+", target):
+        return None, "remove"
+
+    # Pattern E: Internal paths (.claude/, vault/, scripts/, ~/)
+    if any(target.startswith(p) for p in [".claude/", "vault/", "scripts/", "../", "~/"]):
+        return None, "remove"
+
+    # Pattern F: Stub/concept links
+    if target in STUB_LINKS:
+        return None, "remove"
+
+    # Pattern F extended: Sentence-links from external sources
+    for prefix in SENTENCE_LINK_PREFIXES:
+        if target.startswith(prefix):
+            return None, "remove"
+
+    # Pattern G: Known unmatchable files → remove
+    known_removable = {
+        "contacts/partner-org.json", "meals.md", "brand-x-tasks-handoff.md",
+        "thoughts/reflections/2026-01-03-data-backup",
+        "2026-01-05-project-ssr-migration",
+    }
+    if target in known_removable:
+        return None, "remove"
+
+    # Attachments → remove wikilink (they're embeds, not graph nodes)
+    if target.startswith("attachments/"):
+        return None, "remove"
+
+    # thoughts/ references that don't exist → check if stem exists
+    if target.startswith("thoughts/"):
+        stem = Path(target).stem
+        if stem in stem_index and len(stem_index[stem]) == 1:
+            return stem_index[stem][0].removesuffix(".md"), "replace"
+
+    # Pattern 3: Stem-only match (e.g. "acme-corp" → "business/crm/acme-corp")
+    stem = Path(target.rstrip("\\")).stem
+    if stem in stem_index:
+        matches = stem_index[stem]
+        if len(matches) == 1:
+            return matches[0].removesuffix(".md"), "replace"
+
+    # Projects paths that might resolve differently
+    if target.startswith("projects/"):
+        stem = Path(target).stem
+        if stem in stem_index and len(stem_index[stem]) == 1:
+            return stem_index[stem][0].removesuffix(".md"), "replace"
+
+    # business/network/ that doesn't exist
+    if target.startswith("business/network/"):
+        stem = Path(target).stem
+        if stem in stem_index and len(stem_index[stem]) == 1:
+            return stem_index[stem][0].removesuffix(".md"), "replace"
+
+    # Final fallback: if the link has a path (contains /) and target doesn't exist → remove
+    # This catches remaining broken paths like projects/leads/contact-name, etc.
+    if "/" in target:
+        target_path = VAULT_PATH / f"{target}.md"
+        if not target_path.exists():
+            return None, "remove"
+
+    return None, "none"
+
+
+def apply_replace(file_path: Path, old_link: str, new_link: str) -> bool:
+    """Replace broken link target in file."""
+    content = file_path.read_text(encoding="utf-8")
+
+    # Match [[old_link]], [[old_link|alias]], [[old_link#section]], [[old_link\|alias]] (table-escaped)
+    escaped = re.escape(old_link)
+    pattern = rf"\[\[{escaped}(\\?[|\]#])"
+    replacement = f"[[{new_link}\\1"
+
+    new_content = re.sub(pattern, replacement, content)
+
+    if new_content != content:
+        file_path.write_text(new_content, encoding="utf-8")
+        return True
+    return False
+
+
+def apply_remove(file_path: Path, old_link: str) -> bool:
+    """Remove wikilink, keeping display text or link target as plain text."""
+    content = file_path.read_text(encoding="utf-8")
+
+    escaped = re.escape(old_link)
+
+    # [[old_link|Display Text]] → Display Text
+    pattern_with_alias = rf"\[\[{escaped}\|([^\]]+)\]\]"
+    new_content = re.sub(pattern_with_alias, r"\1", content)
+
+    if new_content != content:
+        file_path.write_text(new_content, encoding="utf-8")
+        return True
+
+    # [[old_link]] → old_link (just the text)
+    # For paths, use just the stem; for names, use as-is
+    if "/" in old_link:
+        display = Path(old_link).stem.replace("-", " ").title()
+    else:
+        display = old_link
+
+    pattern_plain = rf"\[\[{escaped}\]\]"
+    new_content = re.sub(pattern_plain, display, content)
+
+    if new_content != content:
+        file_path.write_text(new_content, encoding="utf-8")
+        return True
+
+    return False
+
+
+def main():
+    apply = "--apply" in sys.argv
+
+    graph = load_graph()
+    broken_links = graph.get("broken_links", [])
+    stem_index = build_stem_index()
+
+    print(f"Broken links: {len(broken_links)}")
+    print(f"Mode: {'APPLY' if apply else 'DRY-RUN'}")
+    print()
+
+    # Group by source file
+    by_source = defaultdict(list)
+    for bl in broken_links:
+        by_source[bl["from"]].append(bl["to"])
+
+    replacements = []
+    removals = []
+    unfixable = []
+
+    for source, targets in sorted(by_source.items()):
+        for target in targets:
+            suggestion, action = suggest_fix(source, target, stem_index)
+            if action == "replace" and suggestion:
+                replacements.append((source, target, suggestion))
+            elif action == "remove":
+                removals.append((source, target))
+            else:
+                unfixable.append((source, target))
+
+    # Deduplicate
+    seen = set()
+    unique_replacements = []
+    for src, old, new in replacements:
+        key = (src, old, new)
+        if key not in seen:
+            seen.add(key)
+            unique_replacements.append((src, old, new))
+    replacements = unique_replacements
+
+    seen_removals = set()
+    unique_removals = []
+    for src, old in removals:
+        key = (src, old)
+        if key not in seen_removals:
+            seen_removals.add(key)
+            unique_removals.append((src, old))
+    removals = unique_removals
+
+    print(f"Replacements: {len(replacements)}")
+    print(f"Removals: {len(removals)}")
+    print(f"Unfixable: {len(unfixable)}")
+    print()
+
+    if replacements:
+        print("=== REPLACEMENTS ===")
+        applied = 0
+        for src, old, new in replacements:
+            print(f"  {src}: [[{old}]] → [[{new}]]")
+            if apply:
+                src_path = VAULT_PATH / src
+                if src_path.exists() and apply_replace(src_path, old, new):
+                    applied += 1
+        if apply:
+            print(f"\nApplied: {applied}/{len(replacements)} replacements")
+
+    if removals:
+        print("\n=== REMOVALS (wikilink → plain text) ===")
+        removed = 0
+        for src, old in removals:
+            print(f"  {src}: [[{old}]] → plain text")
+            if apply:
+                src_path = VAULT_PATH / src
+                if src_path.exists() and apply_remove(src_path, old):
+                    removed += 1
+        if apply:
+            print(f"\nRemoved: {removed}/{len(removals)} wikilinks")
+
+    if unfixable:
+        print("\n=== UNFIXABLE (manual review needed) ===")
+        for src, target in unfixable:
+            print(f"  {src} → {target}")
+
+    # Summary
+    total_fixed = len(replacements) + len(removals)
+    print(f"\n{'='*50}")
+    print(f"Total fixable: {total_fixed}/{len(broken_links)}")
+    print(f"Unfixable: {len(unfixable)}")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/vault/.claude/skills/vault-health/scripts/generate_moc.py b/vault/.claude/skills/vault-health/scripts/generate_moc.py
new file mode 100644
index 0000000..af9d1cc
--- /dev/null
+++ b/vault/.claude/skills/vault-health/scripts/generate_moc.py
@@ -0,0 +1,534 @@
+#!/usr/bin/env python3
+"""
+Generate explicit-wikilinks MOC files for Business and Projects.
+
+Reads CRM/client/lead files, extracts frontmatter, groups by industry,
+and generates MOC markdown with explicit wikilinks:
+  - [[business/crm/acme-corp|Acme Corp]] — Active, High priority, POST-LAUNCH deal
+
+Output:
+  - vault/MOC/MOC-business.md — Business CRM Map of Content
+  - vault/MOC/MOC-projects.md — Projects Map of Content
+
+Usage:
+  uv run vault/.claude/skills/graph-builder/scripts/generate_moc.py
+"""
+
+import re
+from pathlib import Path
+from collections import defaultdict
+from datetime import datetime
+
+# Paths
+SCRIPT_DIR = Path(__file__).parent
+VAULT_PATH = SCRIPT_DIR.parents[3]  # vault/.claude/skills/graph-builder/scripts -> vault
+MOC_DIR = VAULT_PATH / "MOC"
+BUSINESS_CRM_DIR = VAULT_PATH / "business" / "crm"
+PROJECTS_DIR = VAULT_PATH / "projects"
+
+
+def parse_frontmatter(content: str) -> dict[str, str]:
+    """Extract YAML frontmatter as simple key-value pairs."""
+    match = re.match(r"^---\n(.*?)\n---", content, re.DOTALL)
+    if not match:
+        return {}
+    fm = {}
+    for line in match.group(1).split("\n"):
+        if ":" in line and not line.strip().startswith("-") and not line.strip().startswith("#"):
+            key, _, value = line.partition(":")
+            key = key.strip()
+            value = value.strip().strip('"').strip("'")
+            if key and value and not value.startswith("[") and not value.startswith("{"):
+                fm[key] = value
+    return fm
+
+
+def extract_title(content: str) -> str | None:
+    """Extract first H1 heading from markdown content."""
+    match = re.search(r"^# (.+)$", content, re.MULTILINE)
+    if match:
+        return match.group(1).strip()
+    return None
+
+
+def build_context_phrase(fm: dict[str, str]) -> str:
+    """Build a context phrase from frontmatter fields.
+
+    Pattern: status, priority, deal_status, region
+    Example: "Active, High priority, POST-LAUNCH deal"
+    """
+    parts = []
+
+    status = fm.get("status", "")
+    if status:
+        parts.append(status)
+
+    priority = fm.get("priority", "")
+    if priority:
+        parts.append(f"{priority} priority")
+
+    deal_status = fm.get("deal_status", "")
+    if deal_status:
+        parts.append(f"{deal_status} deal")
+
+    region = fm.get("region", "")
+    if region:
+        parts.append(region)
+
+    return ", ".join(parts)
+
+
+def relative_path(file_path: Path) -> str:
+    """Get vault-relative path without .md extension."""
+    rel = file_path.relative_to(VAULT_PATH)
+    return str(rel).removesuffix(".md")
+
+
+def generate_business_moc() -> str:
+    """Generate MOC-business.md content with explicit wikilinks grouped by industry."""
+
+    # Collect all CRM files
+    records: list[dict] = []
+    for md_file in sorted(BUSINESS_CRM_DIR.glob("*.md")):
+        content = md_file.read_text(encoding="utf-8")
+        fm = parse_frontmatter(content)
+        title = extract_title(content) or md_file.stem.replace("-", " ").title()
+        rel = relative_path(md_file)
+
+        records.append({
+            "path": rel,
+            "title": title,
+            "industry": fm.get("industry", "Unknown"),
+            "status": fm.get("status", ""),
+            "priority": fm.get("priority", ""),
+            "deal_status": fm.get("deal_status", ""),
+            "region": fm.get("region", ""),
+            "updated": fm.get("updated", ""),
+            "fm": fm,
+        })
+
+    # Group by industry
+    by_industry: dict[str, list[dict]] = defaultdict(list)
+    for rec in records:
+        by_industry[rec["industry"]].append(rec)
+
+    # Sort industries by count (descending), then alphabetically
+    sorted_industries = sorted(
+        by_industry.keys(),
+        key=lambda ind: (-len(by_industry[ind]), ind),
+    )
+
+    # Count active deals and high priority
+    active_deals = [r for r in records if r["deal_status"] and r["deal_status"] not in ("StandBy", "Отказано")]
+    high_priority = [r for r in records if r["priority"] == "High"]
+
+    now = datetime.now().strftime("%Y-%m-%d")
+
+    lines = [
+        "# MOC - Business",
+        "",
+        "> Map of Content for Business CRM data",
+        f"> Generated: {now} | {len(records)} records, {len(active_deals)} active deals, {len(high_priority)} high priority",
+        "",
+        "[[business/_index|Business Data Overview]]",
+        "",
+        "---",
+        "",
+    ]
+
+    # Active Deals section (explicit wikilinks)
+    if active_deals:
+        lines.append(f"## Active Deals ({len(active_deals)})")
+        lines.append("")
+        # Sort by deal_deadline if available, then by title
+        for rec in sorted(active_deals, key=lambda r: (r.get("fm", {}).get("deal_deadline", "9999"), r["title"])):
+            ctx = build_context_phrase(rec["fm"])
+            deadline = rec["fm"].get("deal_deadline", "")
+            deadline_str = f", deadline {deadline}" if deadline else ""
+            lines.append(f"- [[{rec['path']}|{rec['title']}]] — {ctx}{deadline_str}")
+        lines.append("")
+        lines.append("---")
+        lines.append("")
+
+    # High Priority section (explicit wikilinks)
+    if high_priority:
+        lines.append(f"## High Priority ({len(high_priority)})")
+        lines.append("")
+        for rec in sorted(high_priority, key=lambda r: (r["industry"], r["title"])):
+            ctx = build_context_phrase(rec["fm"])
+            lines.append(f"- [[{rec['path']}|{rec['title']}]] — {ctx}")
+        lines.append("")
+        lines.append("---")
+        lines.append("")
+
+    # By Industry sections
+    lines.append("## By Industry")
+    lines.append("")
+
+    for industry in sorted_industries:
+        industry_records = by_industry[industry]
+        lines.append(f"### {industry} ({len(industry_records)})")
+        lines.append("")
+
+        # Sort: active/in-work first, then by title
+        def sort_key(r: dict) -> tuple:
+            status_order = 0
+            s = r["status"].lower()
+            if s in ("active", "в работе"):
+                status_order = 0
+            elif "tender" in s or "negotiation" in s:
+                status_order = 1
+            elif s == "prospect":
+                status_order = 2
+            else:
+                status_order = 3
+            return (status_order, r["title"])
+
+        for rec in sorted(industry_records, key=sort_key):
+            ctx = build_context_phrase(rec["fm"])
+            if ctx:
+                lines.append(f"- [[{rec['path']}|{rec['title']}]] — {ctx}")
+            else:
+                lines.append(f"- [[{rec['path']}|{rec['title']}]]")
+        lines.append("")
+
+    # Dataview blocks (preserved at the end)
+    lines.extend([
+        "---",
+        "",
+        "## Dataview: Active Deals",
+        "",
+        "```dataview",
+        'TABLE deal_status as "Status", deal_deadline as "Deadline", industry',
+        'FROM "business/crm"',
+        'WHERE deal_status != null AND deal_status != "StandBy" AND deal_status != "Отказано"',
+        "SORT deal_deadline ASC",
+        "LIMIT 15",
+        "```",
+        "",
+        "## Dataview: High Priority",
+        "",
+        "```dataview",
+        "TABLE industry, status, deal_status",
+        'FROM "business/crm"',
+        'WHERE priority = "High"',
+        "SORT deal_status DESC",
+        "LIMIT 20",
+        "```",
+        "",
+        "## Dataview: By Industry",
+        "",
+        "```dataview",
+        "TABLE WITHOUT ID",
+        '  industry as "Industry",',
+        '  length(rows) as "Count"',
+        'FROM "business/crm"',
+        "GROUP BY industry",
+        "SORT length(rows) DESC",
+        "```",
+        "",
+        "## Dataview: By Status",
+        "",
+        "```dataview",
+        "TABLE WITHOUT ID",
+        '  status as "Status",',
+        '  length(rows) as "Count"',
+        'FROM "business/crm"',
+        "GROUP BY status",
+        "SORT length(rows) DESC",
+        "```",
+        "",
+        "## Dataview: Recently Updated",
+        "",
+        "```dataview",
+        "TABLE industry, status, priority",
+        'FROM "business/crm"',
+        "SORT file.mtime DESC",
+        "LIMIT 20",
+        "```",
+        "",
+    ])
+
+    return "\n".join(lines)
+
+
+def generate_projects_moc() -> str:
+    """Generate MOC-projects.md with explicit wikilinks."""
+
+    now = datetime.now().strftime("%Y-%m-%d")
+
+    # Collect clients
+    clients: list[dict] = []
+    clients_dir = PROJECTS_DIR / "clients"
+    if clients_dir.exists():
+        for md_file in sorted(clients_dir.glob("*.md")):
+            content = md_file.read_text(encoding="utf-8")
+            fm = parse_frontmatter(content)
+            title = extract_title(content) or md_file.stem.replace("-", " ").title()
+            rel = relative_path(md_file)
+            clients.append({
+                "path": rel,
+                "title": title,
+                "industry": fm.get("industry", "Unknown"),
+                "status": fm.get("status", ""),
+                "region": fm.get("region", ""),
+                "company": fm.get("company", title),
+                "fm": fm,
+            })
+
+    # Collect leads
+    leads: list[dict] = []
+    leads_dir = PROJECTS_DIR / "leads"
+    if leads_dir.exists():
+        for md_file in sorted(leads_dir.glob("*.md")):
+            content = md_file.read_text(encoding="utf-8")
+            fm = parse_frontmatter(content)
+            title = extract_title(content) or md_file.stem.replace("-", " ").title()
+            rel = relative_path(md_file)
+            leads.append({
+                "path": rel,
+                "title": title,
+                "industry": fm.get("industry", "Unknown"),
+                "status": fm.get("status", ""),
+                "company": fm.get("company", title),
+                "potential": fm.get("potential", ""),
+                "region": fm.get("region", ""),
+                "fm": fm,
+            })
+
+    # Collect projects
+    projects: list[dict] = []
+    projects_dir = PROJECTS_DIR / "projects"
+    if projects_dir.exists():
+        for md_file in sorted(projects_dir.glob("*.md")):
+            content = md_file.read_text(encoding="utf-8")
+            fm = parse_frontmatter(content)
+            title = extract_title(content) or md_file.stem.replace("-", " ").title()
+            rel = relative_path(md_file)
+            projects.append({
+                "path": rel,
+                "title": title,
+                "status": fm.get("status", ""),
+                "fm": fm,
+            })
+
+    # Collect standalone files (resources, reports, etc.)
+    standalone: list[dict] = []
+    for md_file in sorted(PROJECTS_DIR.glob("*.md")):
+        if md_file.name == "_index.md":
+            continue
+        content = md_file.read_text(encoding="utf-8")
+        fm = parse_frontmatter(content)
+        title = extract_title(content) or md_file.stem.replace("-", " ").title()
+        rel = relative_path(md_file)
+        standalone.append({
+            "path": rel,
+            "title": title,
+            "fm": fm,
+        })
+
+    # Collect events
+    events: list[dict] = []
+    events_dir = PROJECTS_DIR / "events"
+    if events_dir.exists():
+        for md_file in sorted(events_dir.glob("*.md")):
+            content = md_file.read_text(encoding="utf-8")
+            fm = parse_frontmatter(content)
+            title = extract_title(content) or md_file.stem.replace("-", " ").title()
+            rel = relative_path(md_file)
+            events.append({
+                "path": rel,
+                "title": title,
+                "status": fm.get("status", ""),
+                "fm": fm,
+            })
+
+    # Collect reports
+    reports: list[dict] = []
+    reports_dir = PROJECTS_DIR / "reports"
+    if reports_dir.exists():
+        for md_file in sorted(reports_dir.glob("*.md")):
+            content = md_file.read_text(encoding="utf-8")
+            fm = parse_frontmatter(content)
+            title = extract_title(content) or md_file.stem.replace("-", " ").title()
+            rel = relative_path(md_file)
+            reports.append({
+                "path": rel,
+                "title": title,
+                "fm": fm,
+            })
+
+    total = len(clients) + len(leads) + len(projects) + len(standalone) + len(events) + len(reports)
+
+    lines = [
+        "# MOC - Projects",
+        "",
+        "> Map of Content for Projects",
+        f"> Generated: {now} | {len(clients)} clients, {len(leads)} leads, {len(projects)} projects",
+        "",
+        "[[projects/_index|Projects Overview]]",
+        "",
+        "---",
+        "",
+    ]
+
+    # Clients
+    if clients:
+        lines.append(f"## Clients ({len(clients)})")
+        lines.append("")
+        for rec in sorted(clients, key=lambda r: r["title"]):
+            parts = []
+            if rec["status"]:
+                parts.append(rec["status"])
+            if rec["industry"] and rec["industry"] != "Unknown":
+                parts.append(rec["industry"])
+            if rec["region"]:
+                parts.append(rec["region"])
+            ctx = ", ".join(parts)
+            if ctx:
+                lines.append(f"- [[{rec['path']}|{rec['title']}]] — {ctx}")
+            else:
+                lines.append(f"- [[{rec['path']}|{rec['title']}]]")
+        lines.append("")
+
+    # Leads
+    if leads:
+        # Split into hot/active and others
+        hot_leads = [l for l in leads if l["status"].lower() in ("hot", "qualified", "follow-up sent", "proposal sent")]
+        other_leads = [l for l in leads if l not in hot_leads]
+
+        lines.append(f"## Leads ({len(leads)})")
+        lines.append("")
+
+        if hot_leads:
+            lines.append("### Hot / Active")
+            lines.append("")
+            for rec in sorted(hot_leads, key=lambda r: r["title"]):
+                parts = []
+                if rec["status"]:
+                    parts.append(rec["status"])
+                if rec["company"] and rec["company"] != rec["title"]:
+                    parts.append(rec["company"])
+                if rec["potential"]:
+                    parts.append(rec["potential"])
+                if rec["region"]:
+                    parts.append(rec["region"])
+                ctx = ", ".join(parts)
+                if ctx:
+                    lines.append(f"- [[{rec['path']}|{rec['title']}]] — {ctx}")
+                else:
+                    lines.append(f"- [[{rec['path']}|{rec['title']}]]")
+            lines.append("")
+
+        if other_leads:
+            lines.append("### Other Leads")
+            lines.append("")
+            for rec in sorted(other_leads, key=lambda r: r["title"]):
+                parts = []
+                if rec["status"]:
+                    parts.append(rec["status"])
+                if rec["company"] and rec["company"] != rec["title"]:
+                    parts.append(rec["company"])
+                if rec["potential"]:
+                    parts.append(rec["potential"])
+                if rec["region"]:
+                    parts.append(rec["region"])
+                ctx = ", ".join(parts)
+                if ctx:
+                    lines.append(f"- [[{rec['path']}|{rec['title']}]] — {ctx}")
+                else:
+                    lines.append(f"- [[{rec['path']}|{rec['title']}]]")
+            lines.append("")
+
+    # Projects
+    if projects:
+        lines.append(f"## Projects ({len(projects)})")
+        lines.append("")
+        for rec in sorted(projects, key=lambda r: r["title"]):
+            status = rec["status"]
+            if status:
+                lines.append(f"- [[{rec['path']}|{rec['title']}]] — {status}")
+            else:
+                lines.append(f"- [[{rec['path']}|{rec['title']}]]")
+        lines.append("")
+
+    # Events
+    if events:
+        lines.append(f"## Events ({len(events)})")
+        lines.append("")
+        for rec in sorted(events, key=lambda r: r["path"]):
+            status = rec["status"]
+            if status:
+                lines.append(f"- [[{rec['path']}|{rec['title']}]] — {status}")
+            else:
+                lines.append(f"- [[{rec['path']}|{rec['title']}]]")
+        lines.append("")
+
+    # Reports
+    if reports:
+        lines.append(f"## Reports ({len(reports)})")
+        lines.append("")
+        for rec in sorted(reports, key=lambda r: r["path"]):
+            lines.append(f"- [[{rec['path']}|{rec['title']}]]")
+        lines.append("")
+
+    # Standalone files
+    if standalone:
+        lines.append(f"## Resources ({len(standalone)})")
+        lines.append("")
+        for rec in sorted(standalone, key=lambda r: r["title"]):
+            lines.append(f"- [[{rec['path']}|{rec['title']}]]")
+        lines.append("")
+
+    # Dataview blocks (preserved)
+    lines.extend([
+        "---",
+        "",
+        "## Dataview: Leads",
+        "",
+        "```dataview",
+        "TABLE company, industry, status, responsible",
+        'FROM "projects/leads"',
+        "SORT updated DESC",
+        "```",
+        "",
+        "## Dataview: Clients",
+        "",
+        "```dataview",
+        "TABLE company, industry, status",
+        'FROM "projects/clients"',
+        "SORT updated DESC",
+        "```",
+        "",
+    ])
+
+    return "\n".join(lines)
+
+
+def main():
+    """Generate both MOC files."""
+    MOC_DIR.mkdir(exist_ok=True)
+
+    # Generate Business MOC
+    biz_content = generate_business_moc()
+    biz_path = MOC_DIR / "MOC-business.md"
+    biz_path.write_text(biz_content, encoding="utf-8")
+    print(f"Generated: {biz_path.relative_to(VAULT_PATH)}")
+
+    # Generate Projects MOC
+    proj_content = generate_projects_moc()
+    proj_path = MOC_DIR / "MOC-projects.md"
+    proj_path.write_text(proj_content, encoding="utf-8")
+    print(f"Generated: {proj_path.relative_to(VAULT_PATH)}")
+
+    # Stats
+    biz_links = biz_content.count("[[")
+    proj_links = proj_content.count("[[")
+    print(f"\nStats:")
+    print(f"  Business: {biz_links} wikilinks")
+    print(f"  Projects: {proj_links} wikilinks")
+    print(f"  Total:    {biz_links + proj_links} explicit wikilinks")
+
+
+if __name__ == "__main__":
+    main()
diff --git a/vault/.memory-config.json b/vault/.memory-config.json
new file mode 100644
index 0000000..ac57f3c
--- /dev/null
+++ b/vault/.memory-config.json
@@ -0,0 +1,13 @@
+{
+  "tiers": {"active": 7, "warm": 21, "cold": 60},
+  "decay_rate": 0.015,
+  "relevance_floor": 0.1,
+  "skip_patterns": ["_index.md"],
+  "type_inference": {
+    "crm/": "crm",
+    "leads/": "lead",
+    "clients/": "client",
+    "projects/": "project"
+  },
+  "use_git_dates": true
+}
diff --git a/vault/MEMORY.md b/vault/MEMORY.md
new file mode 100644
index 0000000..a057735
--- /dev/null
+++ b/vault/MEMORY.md
@@ -0,0 +1,75 @@
+# Long-term Memory
+
+Curated knowledge that persists across sessions. Part of the 3-layer memory architecture (hot context → searchable vault → archive). See `.claude/skills/agent-memory/SKILL.md` for details.
+
+## User Profile
+
+| Field | Value |
+|-------|-------|
+| Name | [Your name] |
+| Timezone | [Your timezone, e.g., UTC+5] |
+| Location | [City/Country] |
+| Primary language | [e.g., Russian/English] |
+
+## Preferences
+
+### Tech Stack
+- Languages: [e.g., Python, TypeScript]
+- Frameworks: [e.g., React, FastAPI]
+- Tools: [e.g., Cursor, Claude Code]
+
+### Communication Style
+- Preferred response language: [Russian/English/Mixed]
+- Detail level: [Brief/Detailed]
+- Code comments: [Minimal/Verbose]
+
+### Habits
+- Morning routine: [if relevant]
+- Work hours: [e.g., 10:00-19:00]
+- Planning cadence: [weekly/daily]
+
+## Key Decisions
+
+| Date | Decision | Context |
+|------|----------|---------|
+| YYYY-MM-DD | Example: Use uv instead of pip | Better dependency management |
+
+## Active Context
+
+### ONE Big Thing (This Week)
+
+- [ ] [Current week's main focus]
+
+### Hot Projects
+1. [Project name] — [status/next action]
+
+### Pipeline/Leads
+
+- [Lead name] — [status]
+
+## Key People
+
+| Name | Role | Contact | Notes |
+|------|------|---------|-------|
+| [Name] | [Role] | [Telegram/Email] | [Context] |
+
+## Learnings
+
+### What Worked
+- [Pattern/approach that was successful]
+
+### What Didn't Work
+- [Anti-pattern to avoid]
+
+### Rules to Remember
+- [Important rule discovered during work]
+
+## Quick Links
+
+- [[goals/3-weekly]] — Weekly focus
+- [[goals/2-monthly]] — Monthly priorities
+- [[MOC/index]] — Maps of Content
+
+---
+
+*Last updated: YYYY-MM-DD*
diff --git a/vault/MOC/MOC-ideas.md b/vault/MOC/MOC-ideas.md
new file mode 100644
index 0000000..b0520c5
--- /dev/null
+++ b/vault/MOC/MOC-ideas.md
@@ -0,0 +1,9 @@
+# Ideas
+
+## Recent
+
+
+
+## By Topic
+
+
diff --git a/vault/MOC/MOC-learnings.md b/vault/MOC/MOC-learnings.md
new file mode 100644
index 0000000..b3716de
--- /dev/null
+++ b/vault/MOC/MOC-learnings.md
@@ -0,0 +1,19 @@
+# Learnings
+
+Map of Content for learnings and insights.
+
+## Recent
+
+
+
+## By Topic
+
+### Topic 1
+
+
+### Topic 2
+
+
+---
+
+*Updated automatically by the processor*
diff --git a/vault/MOC/MOC-projects.md b/vault/MOC/MOC-projects.md
new file mode 100644
index 0000000..a5e6743
--- /dev/null
+++ b/vault/MOC/MOC-projects.md
@@ -0,0 +1,15 @@
+# Projects
+
+Map of Content for project notes.
+
+## Active
+
+
+
+## Archive
+
+
+
+---
+
+*Updated automatically by the processor*
diff --git a/vault/MOC/MOC-reflections.md b/vault/MOC/MOC-reflections.md
new file mode 100644
index 0000000..a12e1b3
--- /dev/null
+++ b/vault/MOC/MOC-reflections.md
@@ -0,0 +1,19 @@
+# Reflections
+
+Map of Content for personal reflections.
+
+## Recent
+
+
+
+## By Theme
+
+### Theme 1
+
+
+### Theme 2
+
+
+---
+
+*Updated automatically by the processor*
diff --git a/vault/MOC/MOC-weekly.md b/vault/MOC/MOC-weekly.md
new file mode 100644
index 0000000..c8dddc0
--- /dev/null
+++ b/vault/MOC/MOC-weekly.md
@@ -0,0 +1,15 @@
+# Weekly Summary
+
+Map of Content for weekly summaries.
+
+## Current Week
+
+
+
+## Previous Weeks
+
+
+
+---
+
+*Updated automatically by the processor*
diff --git a/vault/blog/2025-01-10-vibe-coding-guide.md b/vault/blog/2025-01-10-vibe-coding-guide.md
new file mode 100644
index 0000000..6ee5e3b
--- /dev/null
+++ b/vault/blog/2025-01-10-vibe-coding-guide.md
@@ -0,0 +1,197 @@
+---
+title: "Как начать вайб-кодинг: практическое руководство для не-программистов"
+excerpt: "Вайб-кодинг превращает идеи в работающий код без технического бэкграунда. Разбираем инструменты, настройку и промпты."
+category: "Практика"
+publishedAt: "2025-01-10"
+readingTime: 9
+image: "https://imagedelivery.net/LVzF3_XVrx_tp99EAqRbDA/a7c10129-a212-4b3e-6ea3-8830a026b500/public"
+tags:
+  - Vibe Coding
+  - Claude Code
+  - Gemini
+  - AI-разработка
+  - Корпоративное обучение AI
+  - Внедрение AI в бизнес
+author:
+  name: "Сергей Шима"
+  role: "Chief AI Officer, TDI Group"
+  image: "/shima.webp"
+---
+
+На корпоративных тренингах по AI для бизнеса вайб-кодинг - самая горячая тема последних месяцев. Руководители хотят понять, как создавать рабочие инструменты без штата разработчиков. Маркетологи спрашивают про автоматизацию рутины. И все без исключения хотят попробовать сами.
+
+Последний год я плотно работаю с AI-кодированием. Полноценным full-stack разработчиком не стал, но продуктивность выросла в разы. Построил десяток рабочих инструментов для агентства. И теперь вижу: этот навык меняет правила игры для всех, у кого есть идеи, но нет времени на годы изучения программирования.
+
+## Что такое вайб-кодинг
+
+Термин придумал Андрей Карпати из OpenAI. Суть проста: ты описываешь, что хочешь получить, а AI пишет код. Не нужно знать синтаксис Python или разбираться в фреймворках. Нужно уметь формулировать задачи и понимать логику того, что строишь.
+
+Это принципиально отличается от традиционного программирования. Там ты должен знать, как именно написать функцию. Здесь - объяснить, что эта функция должна делать. Сдвиг от "как" к "что".
+
+На практике это работает так: открываешь Claude или Gemini, описываешь проект словами, получаешь готовый код. Запускаешь. Видишь ошибки. Скармливаешь ошибки обратно в AI. Получаешь исправления. Итерируешь до результата.
+
+## Выбор инструментов
+
+Инструментов для вайб-кодинга десятки. Но для старта достаточно трёх, покрывающих 99% задач.
+
+### Google AI Studio - песочница для экспериментов
+
+[Google AI Studio](https://aistudio.google.com/) - бесплатная веб-платформа для тестирования идей. Минимум обязательств, максимум свободы. Идеально для первых проектов, когда ещё непонятно, взлетит идея или нет.
+
+Я использую AI Studio как черновик. Прошу Claude написать базовый код, переношу сюда, смотрю что получается. Если идея рабочая - переключаюсь на более серьёзные инструменты.
+
+### Google Antigravity - для визуально красивых проектов
+
+[Google Antigravity](https://antigravity.google/) - полноценная IDE с мультимодельной поддержкой. Главное преимущество: [Gemini 3 Pro](https://ai.google.dev/) отлично работает с фронтендом и интерфейсами.
+
+Плюсы: экономичный по токенам, хорошо держит большой контекст, генерирует красивый UI. Минусы: жрёт батарею, периодически крашится, баги в интерфейсе.
+
+На одном из недавних проектов строил через Antigravity симуляцию соревнования между LLM. Визуальная часть получилась на уровне, который руками бы делал неделю.
+
+### Claude Code - для серьёзных задач
+
+[Claude от Anthropic](https://claude.ai) - мой основной рабочий инструмент. Два варианта использования: веб-версия для лёгких проектов и [Claude Code](https://code.claude.com/docs/en/quickstart) для полного контроля через терминал.
+
+Плюсы: точность, хорошая работа со сложными workflow, много обучающих материалов. Минус: дорого.
+
+Простая матрица выбора:
+- Проверить идею за 15 минут → Google AI Studio
+- Фронтенд и красивый интерфейс → Google Antigravity + Gemini 3 Pro
+- Бэкенд, сложная логика, продвинутые проекты → Claude Code + Opus 4.5
+
+## Настройка инструментов
+
+### Google AI Studio
+
+Заходишь на [aistudio.google.com](https://aistudio.google.com/). Вкладка "Build". Переключаешься на Gemini 3 Pro. В System Instructions вставляешь базовый промпт:
+
+```
+You are a world-class senior full-stack engineer and visionary UI/UX designer. Your goal is to vibe code - create fully functional, aesthetically breathtaking applications in a single response.
+
+CORE PRINCIPLES:
+
+- DESIGN FIRST: Use Tailwind CSS with focus on typography, spacing, subtle shadows/animations
+- COMPLETE IMPLEMENTATION: Never say "implementation goes here" - write every line
+- TECH STACK: React 18+, TypeScript, Tailwind CSS, Lucide Icons
+```
+
+Этот промпт заставляет модель выдавать готовый код, а не заглушки.
+
+### Google Antigravity
+
+Скачиваешь с [antigravity.google](https://antigravity.google/). Выбираешь версию под свою систему (macOS, Windows). Запускаешь установщик. Можешь импортировать настройки из VS Code или начать с чистого листа.
+
+### Claude Code
+
+Сначала ставишь [Claude Desktop](https://claude.com/download). Потом [Node.js](https://nodejs.org/en). Дальше по [официальной документации](https://code.claude.com/docs/en/quickstart) - там пошагово расписано.
+
+## Процесс создания проекта
+
+Делю любой проект на три фазы: планирование, сборка, отладка.
+
+### Планирование
+
+В Claude Code есть режим Plan. Активируется двойным нажатием Shift + Tab в терминале. Модель переключается в режим исследования: собирает контекст, задаёт уточняющие вопросы, формирует структуру проекта.
+
+Результат - файл с планом: что будет создаваться, в какой последовательности, какие зависимости нужны.
+
+Для других инструментов использую голосовой ввод в GPT-4. Надиктовываю всё, что знаю о проекте: название, цель, чего точно не хочу, технические ограничения. Модель структурирует этот поток сознания в связный план.
+
+### Сборка
+
+В Claude Code переключаешься обратно из Plan Mode (те же Shift + Tab дважды). Claude начинает создавать файлы по плану.
+
+Для других инструментов генерируешь "мега-промпт" - подробную инструкцию для начала работы. Структура:
+
+```
+PROJECT: [название]
+GOAL: [что должно получиться]
+TECH STACK: [технологии]
+CORE FEATURES:
+- Feature 1: [описание]
+- Feature 2: [описание]
+CONSTRAINTS: [чего избегать]
+OUTPUT: [формат результата]
+```
+
+Если планировал голосом через GPT, просишь его сгенерировать такой мега-промпт на основе сессии. Получается связный документ для вайб-кодинг инструмента.
+
+### Отладка
+
+"Практика показывает: 80% времени в вайб-кодинге уходит на отладку, а не на генерацию."
+
+Несколько техник, которые работают:
+
+**Стек LLM.** Используй две модели параллельно. Например, Gemini 3 в Antigravity для основной работы, Opus 4.5 в отдельной вкладке Claude для сложных багов. Разные модели видят проблемы по-разному.
+
+**Grok 4 Heavy для дебага.** Недооценённый инструмент для поиска ошибок. Хорошо работает там, где другие буксуют.
+
+**Прямая подача ошибок.** В Claude Code копируешь текст ошибки прямо в чат. Модель обычно понимает контекст и выдаёт исправление.
+
+**Команды для глубокого анализа.** "Think harder" или "think step by step" включают расширенное рассуждение. Помогает в запутанных случаях.
+
+**Декомпозиция.** Большая проблема - это набор маленьких. Разбивай на части, решай по одной.
+
+## Промптинг: JSON-формат
+
+"JSON-промпты увеличивают точность ответов в среднем на 25-30%."
+
+Модели лучше понимают структурированные запросы. Вместо свободного текста используй JSON:
+
+```json
+{
+  "task": "create_function",
+  "name": "calculate_discount",
+  "inputs": ["price", "discount_percent"],
+  "output": "final_price",
+  "constraints": ["handle_negative_values", "round_to_2_decimals"]
+}
+```
+
+Это особенно полезно для повторяющихся задач. Один раз создал шаблон - используешь постоянно.
+
+## Ресурсы для развития
+
+Anthropic выпустили [лучшие практики для Claude Code](https://www.anthropic.com/engineering/claude-code-best-practices). Рекомендую как обязательное чтение. Можно даже скормить этот документ Claude как контекст проекта.
+
+Reddit-сообщества для помощи: r/VibeCoding, r/ClaudeAI, r/ClaudeCode. Там реальные кейсы, разборы ошибок, советы практиков.
+
+Google публикует бесплатные курсы и PDF по AI-разработке. Много полезного для базового понимания.
+
+## Что это даёт бизнесу
+
+"При внедрении AI в бизнес-процессы вайб-кодинг сокращает время создания прототипа с недель до часов."
+
+На корпоративных тренингах по AI я вижу типичную картину. Компания хочет автоматизировать процесс. Идёт к разработчикам. Те оценивают в месяц работы и приличный бюджет. Проект откладывается.
+
+С вайб-кодингом тот же результат достигается за дни. Не идеальный код, не масштабируемая архитектура - но рабочий инструмент, который решает конкретную задачу.
+
+Маркетолог может собрать дашборд для отслеживания метрик. Руководитель проекта - инструмент для автоматизации отчётов. HR - бота для первичного скрининга резюме. Без привлечения IT-отдела.
+
+Это не замена профессиональной разработке. Это способ проверить идеи быстро и дёшево. Понять, что работает, что нет. И уже потом, если нужно, привлекать разработчиков для масштабирования.
+
+## Честные ограничения
+
+Вайб-кодинг - это инструмент, а не магия.
+
+Сложные системы с высокими требованиями к безопасности и производительности всё ещё требуют профессионалов. AI-сгенерированный код может содержать уязвимости, которые новичок не заметит. Масштабирование на миллионы пользователей - отдельная история.
+
+Но для внутренних инструментов, прототипов, автоматизации рутины - работает отлично.
+
+## Начни сегодня
+
+Минимальный путь: открой [Google AI Studio](https://aistudio.google.com/), опиши простой проект в пару предложений, посмотри что получится. Не нужно ничего устанавливать, регистрация через Google-аккаунт.
+
+"На практике показывает: первый рабочий прототип через вайб-кодинг появляется за 2-3 часа, даже у тех, кто никогда не программировал."
+
+При внедрении AI в бизнес вайб-кодинг становится базовым навыком для всех, кто работает с данными и процессами. Не обязательно становиться разработчиком. Достаточно научиться формулировать задачи так, чтобы AI их понял.
+
+---
+
+**Ссылки:**
+
+- [Google AI Studio](https://aistudio.google.com/)
+- [Google Antigravity](https://antigravity.google/)
+- [Claude Code Quickstart](https://code.claude.com/docs/en/quickstart)
+- [Claude Code Best Practices](https://www.anthropic.com/engineering/claude-code-best-practices)
+- [Gemini API Documentation](https://ai.google.dev/)
diff --git a/vault/blog/2026-01-08-consumer-ai-2030-predictions.md b/vault/blog/2026-01-08-consumer-ai-2030-predictions.md
new file mode 100644
index 0000000..39ac5ca
--- /dev/null
+++ b/vault/blog/2026-01-08-consumer-ai-2030-predictions.md
@@ -0,0 +1,132 @@
+---
+title: "Consumer AI в 2030: семь прогнозов, которые изменят рынок"
+excerpt: "Почему устройства без экранов провалятся, куда движется рынок AI-чатботов и что станет самым быстрорастущим AI-продуктом."
+category: "Аналитика"
+publishedAt: "2026-01-08"
+readingTime: 7
+image: "/blog/placeholder.webp"
+tags:
+  - Consumer AI
+  - AI-чатботы
+  - Корпоративное обучение AI
+  - Внедрение AI в бизнес
+  - Тренды AI 2030
+author:
+  name: "Сергей Шима"
+  role: "Chief AI Officer, TDI Group"
+  image: "/shima.webp"
+---
+
+На корпоративных тренингах по AI один из главных вопросов: куда всё это движется? Компании хотят понимать, какие технологии внедрять сейчас, а какие - подождать. Разберу семь прогнозов о consumer AI до 2030 года, которые стоит учитывать при внедрении AI в бизнес.
+
+## Устройства без экранов провалятся
+
+Помните волну "AI-пинов", браслетов и прочих гаджетов, которые должны были заменить смартфоны? Они не взлетят. И вот почему.
+
+Телефоны мы используем для пассивного потребления. Открыл ленту - листаешь, смотришь. Голосовой интерфейс хорош как дополнение, но плох как основной способ взаимодействия.
+
+Три фундаментальных ограничения голоса:
+
+Социальный контекст. Голосом можно пользоваться только когда ты один. В офисе, метро, кафе - неудобно.
+
+Инициатива. Каждое взаимодействие нужно начинать самому. Иначе устройство становится навязчивым.
+
+Скорость восприятия. Нельзя просто бросить взгляд и понять контекст. Текст на экране воспринимается в разы быстрее речи.
+
+> "Практика показывает: за последние два года ни один screenless-девайс не вышел за пределы нишевой аудитории гиков."
+
+Смартфоны слишком мощная платформа. Бороться с зависимостью от ленточного контента и параллельно оправдывать зарядку ещё одного устройства - задача практически невыполнимая.
+
+## "Всегда слушающие" устройства тоже не работают
+
+Девайсы типа [Rewind Pendant](https://www.rewind.ai/) или аналогов, которые записывают всё вокруг, упираются в простую проблему. Наша жизнь недостаточно интересна для постоянной записи.
+
+Для рабочих созвонов уже есть [Granola](https://www.granola.ai/), [Otter.ai](https://otter.ai/) и десятки аналогов. Отдельное устройство не нужно.
+
+Парадокс записи. Большинство разговоров не имеют значения. А те, что имеют, - как раз те, которые никто не рискнёт записывать. Важное свидание. Разговор по душам с другом. Сессия с терапевтом. Критически важное собеседование.
+
+При этом из Gmail-аккаунта можно узнать о человеке больше, чем из записей его случайных разговоров. Что покупает, куда ездит, на что подписан.
+
+Ситуация может измениться с переходом от аудио к видео. Но тогда возникнут ещё более острые вопросы о социальной приемлемости постоянной записи.
+
+## Mini-apps откроют эру пользовательского софта
+
+Mini-apps сделают с софтом то же, что короткие видео сделали с контентом. Это один из самых интересных трендов для внедрения AI в бизнес-процессы.
+
+Полноценные приложения слишком сложны в создании. Авторизация, интеграции, база данных, инфраструктура. Но описать одну идею, один сценарий, один экран - может почти каждый.
+
+> "На корпоративных тренингах показываю: создать работающий mini-app через [Claude Artifacts](https://support.anthropic.com/en/articles/9487310-what-are-artifacts-and-how-do-i-use-them) занимает 10-15 минут."
+
+Ирония в том, что онбординг в некоторых приложениях сегодня занимает больше времени, чем создание собственного мини-приложения с нуля. 10+ минут экранов, пушей и попыток продать подписку.
+
+Это открывает эпоху UGC-софта - пользовательского программного обеспечения. И с ним, возможно, первое настоящее consumer super-app в западном мире. В Азии такие платформы уже есть - [WeChat](https://www.wechat.com/) с его mini-programs. Запад пока отстаёт.
+
+## К 2030 останутся два типа AI-чатботов
+
+Сегодня есть [ChatGPT](https://openai.com/chatgpt) и его аналоги плюс сотни нишевых ботов. К 2030 году рынок консолидируется в два больших направления.
+
+Первое. AI-ассистент типа ChatGPT. Фокус на поиске информации, задачах, продуктивности. Ключевое требование - надёжность и предсказуемость. Всегда отвечает на запрос.
+
+Второе. AI-компаньон. Фокус на качестве жизни пользователя. Ключевое требование - ощущение живого общения. Проявляет инициативу, удивляет, строит отношения.
+
+Они не могут существовать в одном продукте. У них противоположные требования к поведению.
+
+Ассистент должен быть надёжным.
+Компаньон должен казаться живым.
+
+> "По моему опыту, компании пытаются смешать оба подхода в одном продукте и получают посредственный результат в обоих направлениях."
+
+Примеры второго направления уже есть. [Replika](https://replika.com/), [Character.AI](https://character.ai/). Но пока это нишевые продукты. К 2030 кто-то из них или новый игрок выйдет на массовый рынок.
+
+## Performance-маркетинг для приложений мёртв
+
+Слишком много студий в Восточной Европе, Турции, Израиле играют в одну и ту же игру. CAC/LTV арбитраж. Схема простая: мониторить App Store, копировать любой продукт с трекшеном за пару дней, тестировать сотни креативов и воронок.
+
+Продукт не имеет значения. Люди покупают подписки ещё до того, как видят сам продукт. Это выдавливает все маржи к нулю.
+
+> "Практика показывает: платная реклама работает как буст, но не как бизнес-модель."
+
+На корпоративных тренингах по AI вижу это регулярно. Компании пытаются масштабировать AI-продукты через performance и упираются в потолок. Работает только когда есть реальное продуктовое преимущество, которое генерирует органику и сарафан.
+
+## Самый быстрорастущий AI-продукт будет… предсказуем
+
+Как только стоимость генерации видео в реальном времени упадёт достаточно для монетизации, появится самый быстрорастущий consumer-продукт в истории. AI-вебкам.
+
+Бесконечная персонализация. Доступность 24/7. Ценообразование на порядок ниже, чем у живых людей.
+
+[OnlyFans](https://onlyfans.com/) с его $6+ млрд выручки будет выглядеть скромно. Этический аспект - отдельная тема. Но с точки зрения бизнес-модели, это очевидный сценарий.
+
+## Кто решит проблему AI-discovery - получит всё
+
+Обычные люди не знают, что делать с пустым текстовым полем кроме чата и поиска. Это affordances командной строки. И это главное ограничение текущего AI-интерфейса.
+
+Чат и поиск - огромные use cases. Но их сотни больше, и все они заперты за интерфейсом командной строки.
+
+> "На корпоративных тренингах трачу 40% времени на то, чтобы показать людям, что AI умеет делать помимо ответов на вопросы."
+
+Кто разберётся, как показывать возможности AI вместо того, чтобы заставлять пользователей промптить - станет следующей большой consumer-платформой.
+
+Частичные решения уже есть. [Claude Projects](https://support.anthropic.com/en/articles/9517075-what-are-projects) с preset-промптами. [Custom GPTs](https://openai.com/index/introducing-gpts/) от OpenAI. [Gems](https://blog.google/products/gemini/google-gemini-update-august-2024/) от Google. Но это полумеры. Полноценного решения пока нет.
+
+## Что это значит для бизнеса
+
+При внедрении AI в бизнес-процессы важно отделять хайп от реальных трендов.
+
+Screenless-устройства и "всегда слушающие" гаджеты - хайп. Не стоит строить на них стратегию.
+
+Mini-apps и UGC-софт - реальный тренд. Возможность для корпоративного обучения AI: учить команды создавать internal tools через no-code и AI.
+
+Консолидация чатботов - неизбежность. Выбирайте, в каком направлении развивать AI-продукты.
+
+Discovery problem - возможность. Кто внутри компании научится показывать коллегам возможности AI, станет незаменимым.
+
+При корпоративном обучении AI эти тренды определяют, какие навыки развивать в команде. Не промпт-инжиниринг как таковой, а понимание возможностей и ограничений технологии.
+
+---
+
+**Ссылки:**
+
+- [Claude Artifacts Documentation](https://support.anthropic.com/en/articles/9487310-what-are-artifacts-and-how-do-i-use-them)
+- [Claude Projects](https://support.anthropic.com/en/articles/9517075-what-are-projects)
+- [OpenAI Custom GPTs](https://openai.com/index/introducing-gpts/)
+- [WeChat Mini Programs](https://developers.weixin.qq.com/miniprogram/en/dev/)
diff --git a/vault/goals/0-vision-3y.md b/vault/goals/0-vision-3y.md
new file mode 100644
index 0000000..6879d3d
--- /dev/null
+++ b/vault/goals/0-vision-3y.md
@@ -0,0 +1,108 @@
+---
+type: vision
+horizon: 3-years
+period: 2025-2027
+updated: YYYY-MM-DD
+---
+
+# Vision 2025-2027
+
+## Life Mission
+
+
+
+
+---
+
+## Life Areas
+
+### Career & Business
+
+**3-Year Vision:**
+
+
+**Key Milestones:**
+- [ ] Milestone 1
+- [ ] Milestone 2
+- [ ] Milestone 3
+
+---
+
+### Health & Energy
+
+**3-Year Vision:**
+
+
+**Key Milestones:**
+- [ ] Milestone 1
+- [ ] Milestone 2
+- [ ] Milestone 3
+
+---
+
+### Relationships & Family
+
+**3-Year Vision:**
+
+
+**Key Milestones:**
+- [ ] Milestone 1
+- [ ] Milestone 2
+- [ ] Milestone 3
+
+---
+
+### Personal Growth
+
+**3-Year Vision:**
+
+
+**Key Milestones:**
+- [ ] Milestone 1
+- [ ] Milestone 2
+- [ ] Milestone 3
+
+---
+
+### Financial
+
+**3-Year Vision:**
+
+
+**Key Milestones:**
+- [ ] Milestone 1
+- [ ] Milestone 2
+- [ ] Milestone 3
+
+---
+
+### Creativity & Joy
+
+**3-Year Vision:**
+
+
+**Key Milestones:**
+- [ ] Milestone 1
+- [ ] Milestone 2
+- [ ] Milestone 3
+
+---
+
+## Quarterly Review Questions
+
+1. Which goals still align with my values?
+2. What has changed that affects these goals?
+3. What am I willing to sacrifice to achieve these?
+4. Who can help me?
+
+---
+
+## Links
+
+- [[1-yearly-2025]] - This year's goals
+- [[2-monthly]] - Current month focus
+- [[3-weekly]] - This week's plan
+
+---
+
+*Next Review: Q1 2025*
diff --git a/vault/goals/1-yearly-YYYY.md b/vault/goals/1-yearly-YYYY.md
new file mode 100644
index 0000000..52ffc8f
--- /dev/null
+++ b/vault/goals/1-yearly-YYYY.md
@@ -0,0 +1,107 @@
+---
+type: yearly
+period: YYYY
+updated: YYYY-MM-DD
+---
+
+# Goals YYYY
+
+## Annual Theme
+
+
+
+
+---
+
+## Career & Business
+
+### Goal 1: [Your Goal]
+
+
+**Success Metrics:**
+- [ ] Metric 1
+- [ ] Metric 2
+
+**Quarterly Milestones:**
+- Q1: [milestone]
+- Q2: [milestone]
+- Q3: [milestone]
+- Q4: [milestone]
+
+---
+
+## Health & Energy
+
+### Goal 1: [Your Goal]
+
+
+**Success Metrics:**
+- [ ] Metric 1
+- [ ] Metric 2
+
+---
+
+## Relationships
+
+### Goal 1: [Your Goal]
+
+
+**Success Metrics:**
+- [ ] Metric 1
+- [ ] Metric 2
+
+---
+
+## Personal Growth
+
+### Goal 1: [Your Goal]
+
+
+**Success Metrics:**
+- [ ] Metric 1
+- [ ] Metric 2
+
+---
+
+## Financial
+
+### Goal 1: [Your Goal]
+
+
+**Success Metrics:**
+- [ ] Metric 1
+- [ ] Metric 2
+
+---
+
+## Progress Dashboard
+
+| Area | Goal | Progress | Status |
+|------|------|----------|--------|
+| Career | [goal] | 0% | --- |
+| Health | [goal] | 0% | --- |
+| Relationships | [goal] | 0% | --- |
+| Growth | [goal] | 0% | --- |
+| Financial | [goal] | 0% | --- |
+
+---
+
+## Monthly Review Log
+
+| Month | Key Wins | Adjustments |
+|-------|----------|-------------|
+| Jan | | |
+| Feb | | |
+| Mar | | |
+
+---
+
+## Links
+
+- [[0-vision-3y]] - 3-year vision
+- [[2-monthly]] - Current month focus
+- [[3-weekly]] - This week's plan
+
+---
+
+*Next Review: End of January*
diff --git a/vault/goals/2-monthly.md b/vault/goals/2-monthly.md
new file mode 100644
index 0000000..67e7e6c
--- /dev/null
+++ b/vault/goals/2-monthly.md
@@ -0,0 +1,95 @@
+---
+type: monthly
+period: YYYY-MM
+updated: YYYY-MM-DD
+---
+
+# Monthly Focus
+
+## Top 3 Priorities
+
+### Priority 1: [Your Top Priority]
+
+
+**Why it matters:** [connection to yearly goal]
+
+**Key Actions:**
+- [ ] Action 1
+- [ ] Action 2
+- [ ] Action 3
+
+**Definition of Done:** [clear outcome]
+
+---
+
+### Priority 2: [Second Priority]
+
+**Why it matters:** [connection to yearly goal]
+
+**Key Actions:**
+- [ ] Action 1
+- [ ] Action 2
+- [ ] Action 3
+
+**Definition of Done:** [clear outcome]
+
+---
+
+### Priority 3: [Third Priority]
+
+**Why it matters:** [connection to yearly goal]
+
+**Key Actions:**
+- [ ] Action 1
+- [ ] Action 2
+- [ ] Action 3
+
+**Definition of Done:** [clear outcome]
+
+---
+
+## NOT Doing This Month
+
+
+-
+-
+-
+
+---
+
+## Weekly Check-ins
+
+| Week | Progress | Blockers | Adjustments |
+|------|----------|----------|-------------|
+| W1 | | | |
+| W2 | | | |
+| W3 | | | |
+| W4 | | | |
+
+---
+
+## End of Month Review
+
+**What worked:**
+-
+
+**What didn't work:**
+-
+
+**Key learnings:**
+-
+
+**Next month focus:**
+-
+
+---
+
+## Links
+
+- [[0-vision-3y]] - 3-year vision
+- [[1-yearly-2025]] - Annual goals
+- [[3-weekly]] - This week's plan
+
+---
+
+*Next Review: End of month*
diff --git a/vault/goals/3-weekly.md b/vault/goals/3-weekly.md
new file mode 100644
index 0000000..7a1a559
--- /dev/null
+++ b/vault/goals/3-weekly.md
@@ -0,0 +1,127 @@
+---
+type: weekly
+week: YYYY-WWW
+updated: YYYY-MM-DD
+---
+
+# Weekly Focus
+
+## ONE Big Thing
+
+> **If I accomplish nothing else, I will:**
+> [Single most important outcome for this week]
+
+
+
+---
+
+## Week at a Glance
+
+**Week:** [X] of 52
+**Energy Level:** [High/Medium/Low]
+**Available Hours:** [X] hours focused work
+
+---
+
+## Priority Tasks
+
+### Must Do (Non-negotiable)
+
+- [ ] Task 1 — Связь: [[1-yearly-2025#Goal]]
+- [ ] Task 2
+- [ ] Task 3
+
+### Should Do (Important)
+
+- [ ] Task 1
+- [ ] Task 2
+
+### Could Do (If time permits)
+
+- [ ] Task 1
+- [ ] Task 2
+
+---
+
+## Daily Plan
+
+### Monday
+
+- [ ] Task 1
+- [ ] Task 2
+
+### Tuesday
+
+- [ ] Task 1
+- [ ] Task 2
+
+### Wednesday
+
+- [ ] Task 1
+- [ ] Task 2
+
+### Thursday
+
+- [ ] Task 1
+- [ ] Task 2
+
+### Friday
+
+- [ ] Task 1
+- [ ] Task 2
+
+### Weekend
+
+- [ ] Rest / Family time
+- [ ] Optional task
+
+---
+
+## Key Meetings & Events
+
+| Day | Time | Event | Prep |
+|-----|------|-------|------|
+| Mon | | | |
+| Tue | | | |
+
+---
+
+## Habits Tracker
+
+| Habit | Mon | Tue | Wed | Thu | Fri | Sat | Sun |
+|-------|-----|-----|-----|-----|-----|-----|-----|
+| [Habit 1] | | | | | | | |
+| [Habit 2] | | | | | | | |
+| [Habit 3] | | | | | | | |
+
+---
+
+## End of Week Review
+
+### What Worked
+
+-
+
+### What Didn't Work
+
+-
+
+### Lessons Learned
+
+-
+
+### Next Week Focus
+
+>
+
+---
+
+## Links
+
+- [[2-monthly]] - Monthly priorities
+- [[1-yearly-2025]] - Yearly goals
+- Previous: [[3-weekly-YYYY-WXX]]
+
+---
+
+*Week Started: YYYY-MM-DD*
diff --git a/vault/summaries/.gitkeep b/vault/summaries/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/vault/templates/crm-template.md b/vault/templates/crm-template.md
new file mode 100644
index 0000000..d0332c4
--- /dev/null
+++ b/vault/templates/crm-template.md
@@ -0,0 +1,37 @@
+---
+type: crm
+description: >-
+  [One-line summary: industry, key deal, what makes this client notable]
+tags: [industry, region, deal-type]
+status: prospect
+industry: [FMCG|Electronics|Banks|Pharma|Retail|Auto|IT|Telecom]
+region: [ISO country code]
+owner: [Your Name]
+priority: [High|Mid|Low]
+deal_status: [In Progress|Tender|Proposal Sent]
+deal_deadline: YYYY-MM-DD
+created: YYYY-MM-DD
+updated: YYYY-MM-DD
+---
+
+# [Company Name]
+
+## Overview
+- **Industry:** [industry]
+- **Region:** [countries]
+- **Contact:** [key contact person]
+
+## Active Deals
+
+### [Deal Name]
+- **Status:** [deal_status]
+- **Value:** $[amount]
+- **Deadline:** [date]
+- **Details:** [what the deal involves]
+
+## History
+- YYYY-MM-DD: [First contact / how we met]
+- YYYY-MM-DD: [Key milestone]
+
+## Notes
+[Any important context about this client]
diff --git a/vault/templates/daily-template.md b/vault/templates/daily-template.md
new file mode 100644
index 0000000..43ac756
--- /dev/null
+++ b/vault/templates/daily-template.md
@@ -0,0 +1,4 @@
+# {{date}}
+
+
+