day-recap 0.2.1__tar.gz

day_recap-0.2.1/PKG-INFO

@@ -0,0 +1,116 @@
+Metadata-Version: 2.3
+Name: day-recap
+Version: 0.2.1
+Summary: Саммари проделанной работы за день: задачи и принятые решения из git, транскриптов агентов и чатов Telegram
+Author: Vladimir Voronov
+Author-email: Vladimir Voronov <vvoronov@mwnts.ru>
+Requires-Dist: pydantic>=2.13.5
+Requires-Dist: pydantic-settings>=2.15.0
+Requires-Dist: qrcode>=8.2
+Requires-Dist: telethon>=1.45.0
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+
+# day-recap
+
+[Русский](README.ru.md)
+
+[![tests](https://github.com/redb0/day-recap/actions/workflows/test.yaml/badge.svg?branch=main)](https://github.com/redb0/day-recap/actions/workflows/test.yaml)
+[![coverage](https://codecov.io/gh/redb0/day-recap/branch/main/graph/badge.svg)](https://codecov.io/gh/redb0/day-recap)
+![python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue)
+
+Collects a day's work from local git repositories, Cursor transcripts, OpenCode
+sessions, and a Telegram allowlist. Only a confirmed block is appended to the
+Obsidian daily note.
+
+The raw dump stays outside the vault. An empty day does not change the note.
+
+```markdown
+## 🤖 Итоги дня
+
+### Сделано
+- **billing** — сузил окно повторной оплаты до одного счёта
+
+### Решения и обоснования
+Оставили повтор по idempotency-key. Повтор всей корзины отбросили: он списывал деньги второй раз.
+```
+
+## Install and configure
+
+From a checkout of this repository:
+
+```sh
+uv tool install --editable .
+mkdir -p ~/.config/day-recap
+cp config.example.toml ~/.config/day-recap/config.toml
+```
+
+Run `day-recap init` in your own terminal, not in the agent chat. Do not
+type `api_id` or `api_hash` into the chat. `init` asks `qr` or `code`. `qr`
+prints a code to scan: Settings → Devices → Link desktop device. `code` waits
+for the login code in the Telegram service chat. `--login qr` or `--login code`
+skips the question. `--relogin` signs in again.
+
+`day-recap chats` prints a table and ready `[[telegram.chats]]` blocks.
+Paste the blocks you want into the `[telegram]` section. Only those chats are
+read into the raw dump.
+
+| Section | What it sets |
+| --- | --- |
+| `[notes]` | Where to write the daily note. |
+| `[state]` | Where raw dumps are stored. |
+| `[git]` | Which directories to walk and whose commits to take. |
+| `[transcripts]` | Cursor JSONL roots and how messages are trimmed. |
+| `[opencode]` | OpenCode database and the same trim. |
+| `[telegram]` | Whether the source is on, and the allowlist. |
+| `[summary]` | Size threshold. |
+
+Keys and defaults are in [`config.example.toml`](config.example.toml).
+
+- The size threshold is 100000 bytes.
+- Raw dumps are kept for 14 days.
+- `~/.config/day-recap/.env` is mode 600.
+
+## In the agent
+
+Copy [`SKILL.md`](SKILL.md) to `~/.agents/skills/day-recap/SKILL.md`.
+
+```text
+/day-recap
+/day-recap yesterday
+/day-recap 2026-10-05
+```
+
+The date is `today`, `yesterday`, or `YYYY-MM-DD`. With no date, the window
+runs from local midnight to the moment you start.
+
+The skill shows a draft and asks what you decided and what you rejected. The
+note changes only after a separate yes. An empty day does not change the note.
+With no Telegram session the other sources are still collected, and the block
+contains the line «Telegram недоступен, чаты не учтены».
+
+## Other commands
+
+`collect` stores a raw dump. `show` prints the day status, or one source when
+you name it. The source is optional: `git`, `transcripts`, `opencode`, or
+`telegram`. Both take `--date` (`today`, `yesterday`, or `YYYY-MM-DD`) and
+`--config PATH`.
+
+`write` reads the block from stdin. It needs `--date YYYY-MM-DD` and
+`--body -`, and takes `--config PATH`. Without `--apply` the note stays
+unchanged.
+
+```sh
+day-recap collect --date yesterday
+day-recap show git --date 2026-10-05
+day-recap write --date 2026-10-05 --body - --apply
+```
+
+## Development
+
+```sh
+just lint    # ruff
+just fmt     # ruff format
+just types   # mypy
+just test    # pytest
+```

day_recap-0.2.1/README.md

@@ -0,0 +1,103 @@
+# day-recap
+
+[Русский](README.ru.md)
+
+[![tests](https://github.com/redb0/day-recap/actions/workflows/test.yaml/badge.svg?branch=main)](https://github.com/redb0/day-recap/actions/workflows/test.yaml)
+[![coverage](https://codecov.io/gh/redb0/day-recap/branch/main/graph/badge.svg)](https://codecov.io/gh/redb0/day-recap)
+![python 3.12+](https://img.shields.io/badge/python-3.12%2B-blue)
+
+Collects a day's work from local git repositories, Cursor transcripts, OpenCode
+sessions, and a Telegram allowlist. Only a confirmed block is appended to the
+Obsidian daily note.
+
+The raw dump stays outside the vault. An empty day does not change the note.
+
+```markdown
+## 🤖 Итоги дня
+
+### Сделано
+- **billing** — сузил окно повторной оплаты до одного счёта
+
+### Решения и обоснования
+Оставили повтор по idempotency-key. Повтор всей корзины отбросили: он списывал деньги второй раз.
+```
+
+## Install and configure
+
+From a checkout of this repository:
+
+```sh
+uv tool install --editable .
+mkdir -p ~/.config/day-recap
+cp config.example.toml ~/.config/day-recap/config.toml
+```
+
+Run `day-recap init` in your own terminal, not in the agent chat. Do not
+type `api_id` or `api_hash` into the chat. `init` asks `qr` or `code`. `qr`
+prints a code to scan: Settings → Devices → Link desktop device. `code` waits
+for the login code in the Telegram service chat. `--login qr` or `--login code`
+skips the question. `--relogin` signs in again.
+
+`day-recap chats` prints a table and ready `[[telegram.chats]]` blocks.
+Paste the blocks you want into the `[telegram]` section. Only those chats are
+read into the raw dump.
+
+| Section | What it sets |
+| --- | --- |
+| `[notes]` | Where to write the daily note. |
+| `[state]` | Where raw dumps are stored. |
+| `[git]` | Which directories to walk and whose commits to take. |
+| `[transcripts]` | Cursor JSONL roots and how messages are trimmed. |
+| `[opencode]` | OpenCode database and the same trim. |
+| `[telegram]` | Whether the source is on, and the allowlist. |
+| `[summary]` | Size threshold. |
+
+Keys and defaults are in [`config.example.toml`](config.example.toml).
+
+- The size threshold is 100000 bytes.
+- Raw dumps are kept for 14 days.
+- `~/.config/day-recap/.env` is mode 600.
+
+## In the agent
+
+Copy [`SKILL.md`](SKILL.md) to `~/.agents/skills/day-recap/SKILL.md`.
+
+```text
+/day-recap
+/day-recap yesterday
+/day-recap 2026-10-05
+```
+
+The date is `today`, `yesterday`, or `YYYY-MM-DD`. With no date, the window
+runs from local midnight to the moment you start.
+
+The skill shows a draft and asks what you decided and what you rejected. The
+note changes only after a separate yes. An empty day does not change the note.
+With no Telegram session the other sources are still collected, and the block
+contains the line «Telegram недоступен, чаты не учтены».
+
+## Other commands
+
+`collect` stores a raw dump. `show` prints the day status, or one source when
+you name it. The source is optional: `git`, `transcripts`, `opencode`, or
+`telegram`. Both take `--date` (`today`, `yesterday`, or `YYYY-MM-DD`) and
+`--config PATH`.
+
+`write` reads the block from stdin. It needs `--date YYYY-MM-DD` and
+`--body -`, and takes `--config PATH`. Without `--apply` the note stays
+unchanged.
+
+```sh
+day-recap collect --date yesterday
+day-recap show git --date 2026-10-05
+day-recap write --date 2026-10-05 --body - --apply
+```
+
+## Development
+
+```sh
+just lint    # ruff
+just fmt     # ruff format
+just types   # mypy
+just test    # pytest
+```

day_recap-0.2.1/app/atomic.py

@@ -0,0 +1,36 @@
+"""Замена файла целиком: обрыв не оставляет обрезанный текст."""
+
+import os
+import tempfile
+from pathlib import Path
+
+
+def replace_text(path: Path, text: str, *, mode: int | None = None) -> None:
+    """Записать текст через временный файл и `os.replace`.
+
+    Args:
+        path: Куда положить готовый текст.
+        text: Содержимое.
+        mode: Права нового файла. `None` — оставить режим существующего
+            или `0o644`, если файла ещё нет.
+
+    Raises:
+        OSError: Каталог недоступен или замена не удалась.
+    """
+    chosen = _mode(path) if mode is None else mode
+    fd, name = tempfile.mkstemp(dir=path.parent, prefix=f".{path.name}.", suffix=".tmp")
+    tmp = Path(name)
+    try:
+        os.fchmod(fd, chosen)
+        with os.fdopen(fd, "w", encoding="utf-8", newline="") as handle:
+            handle.write(text)
+        tmp.replace(path)
+    except OSError:
+        tmp.unlink(missing_ok=True)
+        raise
+
+
+def _mode(path: Path) -> int:
+    if path.is_file():
+        return path.stat().st_mode & 0o777
+    return 0o644

day_recap-0.2.1/app/cli.py

@@ -0,0 +1,350 @@
+"""Точка входа команды `day-recap`."""
+
+import argparse
+import asyncio
+import getpass
+import sys
+from collections.abc import Sequence
+from datetime import date
+from importlib.metadata import version
+from pathlib import Path
+
+from app.collectors.telegram.chats import load_chats
+from app.collectors.telegram.init import run_init
+from app.config import Config, load_config
+from app.errors import ErrorCode, SummaryError
+from app.notes.writer import write_note
+from app.summary.collect import (
+    RELATIVE_DAYS,
+    SOURCES,
+    CollectedDay,
+    SourceName,
+    collect_and_store,
+    load_stored_day,
+    local_now,
+    resolve_day,
+)
+from app.summary.models import Dump, GitDump, SessionDump, SourceStatus, TelegramDump, Window
+from app.summary.show import render_git, render_sessions, render_telegram, visible_truncation
+
+DISTRIBUTION = "day-recap"
+_NOT_KEPT = "дамп не сохранён: дата старше ретенции"
+
+
+def build_parser() -> argparse.ArgumentParser:
+    """Собрать разборщик аргументов.
+
+    Returns:
+        Разборщик верхнего уровня.
+    """
+    parser = argparse.ArgumentParser(
+        prog=DISTRIBUTION,
+        description="Саммари проделанной за день работы: задачи и принятые решения.",
+    )
+    parser.add_argument(
+        "--version",
+        action="version",
+        version=f"%(prog)s {version(DISTRIBUTION)}",
+    )
+    commands = parser.add_subparsers(dest="command", required=False)
+    collect = commands.add_parser("collect", help="Собрать сырой дамп за день.")
+    collect.add_argument("source", nargs="?", choices=SOURCES, default=None)
+    collect.add_argument("--date", type=_day_token, default=None)
+    collect.add_argument("--config", type=Path, default=None)
+    show = commands.add_parser("show", help="Показать сводку или тело источника.")
+    show.add_argument("source", nargs="?", choices=SOURCES, default=None)
+    show.add_argument("--date", type=_day_token, default=None)
+    show.add_argument("--config", type=Path, default=None)
+    write = commands.add_parser("write", help="Записать блок итогов в ежедневную заметку.")
+    write.add_argument("--date", type=_iso_day, required=True)
+    write.add_argument("--body", type=_stdin_body, required=True)
+    write.add_argument("--apply", action="store_true")
+    write.add_argument("--config", type=Path, default=None)
+    init = commands.add_parser("init", help="Настроить доступ к Telegram в своём терминале.")
+    init.add_argument("--relogin", action="store_true")
+    init.add_argument("--login", choices=("qr", "code"), default=None)
+    init.add_argument("--config", type=Path, default=None)
+    chats = commands.add_parser("chats", help="Показать чаты и фрагмент конфига.")
+    chats.add_argument("--config", type=Path, default=None)
+    return parser
+
+
+def main(argv: Sequence[str] | None = None) -> int:
+    """Разобрать аргументы и выполнить команду.
+
+    Args:
+        argv: Аргументы без имени программы. `None` — взять из `sys.argv`.
+
+    Returns:
+        Код возврата процесса.
+    """
+    parser = build_parser()
+    args = parser.parse_args(argv)
+    if args.command is None:
+        parser.print_help()
+        return 0
+    try:
+        return _dispatch(args)
+    except SummaryError as error:
+        _print_error(error)
+        return 1
+    except FileNotFoundError as exc:
+        sys.stderr.write(f"Файл конфигурации не найден: {exc}\n")
+        return 1
+
+
+def _day_token(value: str) -> str:
+    if value in RELATIVE_DAYS or _is_iso_day(value):
+        return value
+    message = "ожидается YYYY-MM-DD, today или yesterday"
+    raise argparse.ArgumentTypeError(message)
+
+
+def _iso_day(value: str) -> str:
+    if _is_iso_day(value):
+        return value
+    message = "ожидается YYYY-MM-DD"
+    raise argparse.ArgumentTypeError(message)
+
+
+def _is_iso_day(value: str) -> bool:
+    try:
+        date.fromisoformat(value)
+    except ValueError:
+        return False
+    return True
+
+
+def _stdin_body(value: str) -> str:
+    if value != "-":
+        message = "тело читается из stdin: укажите --body -"
+        raise argparse.ArgumentTypeError(message) from None
+    return value
+
+
+def _dispatch(args: argparse.Namespace) -> int:
+    config = load_config(args.config)
+    if args.command == "collect":
+        return _run_collect(config, args.date, args.source)
+    if args.command == "show":
+        return _run_show(config, args.date, args.source)
+    if args.command == "write":
+        return _run_write(config, args.date, apply=args.apply)
+    if args.command == "init":
+        return _run_init(config, relogin=args.relogin, login=args.login)
+    return _run_chats(config)
+
+
+def _run_collect(config: Config, token: str | None, source: SourceName | None) -> int:
+    day = collect_and_store(config, token, progress=_progress, source=source)
+    sys.stdout.write(_report(day, threshold=config.summary.two_stage_threshold_bytes))
+    return 0
+
+
+def _run_show(config: Config, token: str | None, source: SourceName | None) -> int:
+    day_date, stored = load_stored_day(config, token)
+    if source is None:
+        sys.stdout.write(
+            _report(
+                stored,
+                threshold=config.summary.two_stage_threshold_bytes,
+                empty_date=day_date,
+            ),
+        )
+        return 0
+    sys.stdout.write(_source_text(source, stored))
+    return 0
+
+
+def _source_text(source: SourceName, day: CollectedDay) -> str:
+    dump = _dumps(day)[source]
+    if dump is None:
+        return _source_line(source, None) + "\n"
+    return _body(dump)
+
+
+def _body(dump: Dump) -> str:
+    if isinstance(dump, GitDump):
+        return render_git(dump)
+    if isinstance(dump, TelegramDump):
+        return render_telegram(dump)
+    return render_sessions(dump)
+
+
+def _progress(line: str) -> None:
+    sys.stderr.write(f"{line}\n")
+    sys.stderr.flush()
+
+
+def _run_write(config: Config, token: str, *, apply: bool) -> int:
+    day = resolve_day(token, today=local_now(config.notes.timezone).date())
+    result = write_note(config, day, sys.stdin.read(), apply=apply)
+    sys.stdout.write(result.diff)
+    return 0
+
+
+def _run_init(config: Config, *, relogin: bool, login: str | None) -> int:
+    account = run_init(
+        config,
+        relogin=relogin,
+        login=login,
+        ask=_ask_credential,
+        choose=_ask_login,
+    )
+    sys.stdout.write(f"Вошли как {account}\n")
+    return 0
+
+
+def _ask_login() -> str:
+    while True:
+        answer = input("Вход (qr/code): ").strip().lower()
+        if answer in {"qr", "code"}:
+            return answer
+        sys.stderr.write("Ожидается qr или code.\n")
+
+
+def _ask_credential(key: str) -> str:
+    if key == "TG_API_HASH":
+        return getpass.getpass("TG_API_HASH: ")
+    if key == "TG_API_ID":
+        return input("TG_API_ID (https://my.telegram.org/apps): ")
+    return input("TG_PHONE (+7999…): ")
+
+
+def _run_chats(config: Config) -> int:
+    sys.stdout.write(asyncio.run(load_chats(config)))
+    return 0
+
+
+_STATUS = {
+    SourceStatus.OK: "ok",
+    SourceStatus.EMPTY: "пустой",
+    SourceStatus.DISABLED: "выключен",
+    SourceStatus.UNAVAILABLE: "недоступен",
+}
+
+
+def _report(
+    day: CollectedDay,
+    *,
+    threshold: int,
+    empty_date: date | None = None,
+) -> str:
+    shown = _day_date(day, empty_date)
+    shared = _shared_window(day)
+    lines = [
+        *_heading(day),
+        f"дата: {shown.isoformat()}",
+        f"байты: {day.total_bytes}",
+        f"порог: {threshold}",
+        f"порог превышен: {_exceeded(day.total_bytes, threshold)}",
+    ]
+    if shared is not None:
+        lines.append(_window_text(shared))
+    lines.extend(
+        _source_line(name, dump) + _window_suffix(dump, shared=shared is not None)
+        for name, dump in _dumps(day).items()
+    )
+    lines.extend(_notes(day))
+    return "\n".join(lines) + "\n"
+
+
+def _dumps(day: CollectedDay) -> dict[SourceName, Dump | None]:
+    return {
+        "git": day.git,
+        "transcripts": day.transcripts,
+        "opencode": day.opencode,
+        "telegram": day.telegram,
+    }
+
+
+def _shared_window(day: CollectedDay) -> Window | None:
+    windows = [dump.window for dump in _dumps(day).values() if dump is not None]
+    if not windows or any(item != windows[0] for item in windows):
+        return None
+    return windows[0]
+
+
+def _window_text(window: Window) -> str:
+    return f"окно: {window.from_.isoformat()}..{window.to.isoformat()}"
+
+
+def _window_suffix(dump: Dump | None, *, shared: bool) -> str:
+    if shared or dump is None:
+        return ""
+    return ", " + _window_text(dump.window)
+
+
+def _heading(day: CollectedDay) -> list[str]:
+    if day.directory is not None:
+        return [str(day.directory)]
+    if any(dump is not None for dump in _dumps(day).values()):
+        return [_NOT_KEPT]
+    return []
+
+
+def _day_date(day: CollectedDay, fallback: date | None) -> date:
+    for dump in _dumps(day).values():
+        if dump is not None:
+            return dump.date
+    if fallback is not None:
+        return fallback
+    message = "в дне нет ни одного дампа"
+    raise RuntimeError(message)
+
+
+def _exceeded(total: int, threshold: int) -> str:
+    if total > threshold:
+        return "да"
+    return "нет"
+
+
+def _source_line(name: SourceName, dump: Dump | None) -> str:
+    if name == "git":
+        return _git_line(dump if isinstance(dump, GitDump) else None)
+    if name == "telegram":
+        return _telegram_line(dump if isinstance(dump, TelegramDump) else None)
+    return _session_line(name, dump if isinstance(dump, SessionDump) else None)
+
+
+def _login_code(dump: GitDump | SessionDump | TelegramDump) -> str:
+    if dump.code in {ErrorCode.NO_SESSION, ErrorCode.NO_CREDENTIALS}:
+        return f", code: {dump.code}"
+    return ""
+
+
+def _git_line(dump: GitDump | None) -> str:
+    if dump is None:
+        return "git: не собран, репозиториев: 0, коммитов: 0"
+    commits = sum(len(repo.commits) for repo in dump.repos)
+    return (
+        f"git: {_STATUS[dump.status]}{_login_code(dump)}, "
+        f"репозиториев: {len(dump.repos)}, коммитов: {commits}"
+    )
+
+
+def _session_line(name: str, dump: SessionDump | None) -> str:
+    if dump is None:
+        return f"{name}: не собран, сессий: 0"
+    return f"{name}: {_STATUS[dump.status]}{_login_code(dump)}, сессий: {len(dump.sessions)}"
+
+
+def _telegram_line(dump: TelegramDump | None) -> str:
+    if dump is None:
+        return "telegram: не собран, чатов: 0, unlisted: 0"
+    return (
+        f"telegram: {_STATUS[dump.status]}{_login_code(dump)}, "
+        f"чатов: {len(dump.chats)}, unlisted: {dump.unlisted_active}"
+    )
+
+
+def _notes(day: CollectedDay) -> list[str]:
+    notes: list[str] = []
+    for dump in _dumps(day).values():
+        if dump is not None:
+            notes.extend(visible_truncation(note) for note in dump.truncations)
+    return notes
+
+
+def _print_error(error: SummaryError) -> None:
+    sys.stderr.write(f"code: {error.code}\n{error.message}\n{error.hint}\n")

day_recap-0.2.1/app/collectors/__init__.py

@@ -0,0 +1 @@
+"""Сборщики источников day-recap."""