feat(notifications): ORCH-042 Telegram tracker bump mode + russification #52

Merged

admin merged 7 commits from feature/ORCH-042-telegram-live-tracker-bump into main 2026-06-06 13:48:56 +03:00

Conversation 0 Commits 7 Files Changed 18 +1230 -25

admin commented 2026-06-06 13:14:25 +03:00

Owner

Copy Link

Summary

• bump mode for the Telegram live-tracker (ORCH_TRACKER_MODE → Settings.tracker_mode, default edit): re-creates the task card at the bottom of the chat on each update (delete_telegram → silent send_telegram → repoint tracker_message_id). Invariant "one card per task" preserved — ≤1 new message per call, repoint only on successful send, delete result never gates the send. New never-raising delete_telegram helper. Anything ≠ bump resolves to edit (zero regression, never crashes on garbage value).
• Card text (both modes): Подтверждение BRD label, ✅ after approve-gate (⏸️/⏳ kept while waiting), Russian stage labels (Анализ / Архитектура / Разработка / Код ревью / Тестирование / Внедрение), final 📦 Внедрено.
• Docs in the same PR: CHANGELOG.md, docs/architecture/internals.md (live-tracker section: modes + ORCH_TRACKER_MODE + delete_telegram), .env.example.

No DB migrations, no API changes, no QG/stage changes. Public signatures unchanged. ADR: docs/work-items/ORCH-042/06-adr/ADR-001-tracker-bump-mode.md.

Test plan

• pytest tests/ -q — 494 passed
• New tests/test_tracker_bump.py (TC-07..TC-17)
• New tests/test_config.py (TC-01)
• tests/test_telegram_tracker.py updated (TC-02, TC-18..TC-22, Russian asserts)
• ruff check src/config.py src/notifications.py clean

Refs: ORCH-042

## Summary - **bump mode** for the Telegram live-tracker (`ORCH_TRACKER_MODE` → `Settings.tracker_mode`, default `edit`): re-creates the task card at the bottom of the chat on each update (`delete_telegram` → silent `send_telegram` → repoint `tracker_message_id`). Invariant "one card per task" preserved — ≤1 new message per call, repoint only on successful send, delete result never gates the send. New never-raising `delete_telegram` helper. Anything ≠ `bump` resolves to `edit` (zero regression, never crashes on garbage value). - **Card text** (both modes): `Подтверждение BRD` label, ✅ after approve-gate (⏸️/⏳ kept while waiting), Russian stage labels (Анализ / Архитектура / Разработка / Код ревью / Тестирование / Внедрение), final `📦 Внедрено`. - **Docs in the same PR:** `CHANGELOG.md`, `docs/architecture/internals.md` (live-tracker section: modes + `ORCH_TRACKER_MODE` + `delete_telegram`), `.env.example`. No DB migrations, no API changes, no QG/stage changes. Public signatures unchanged. ADR: `docs/work-items/ORCH-042/06-adr/ADR-001-tracker-bump-mode.md`. ## Test plan - [x] `pytest tests/ -q` — 494 passed - [x] New `tests/test_tracker_bump.py` (TC-07..TC-17) - [x] New `tests/test_config.py` (TC-01) - [x] `tests/test_telegram_tracker.py` updated (TC-02, TC-18..TC-22, Russian asserts) - [x] `ruff check src/config.py src/notifications.py` clean Refs: ORCH-042

admin added 4 commits 2026-06-06 13:14:25 +03:00

docs: init ORCH-042 business request 3f23897327

analyst(ET): auto-commit from analyst run_id=167 66100855f6

architect(ET): auto-commit from architect run_id=168 0ac50b8c73

feat(notifications): add bump mode + russify Telegram live-tracker ... 05c17135c1

ORCH-042: new ORCH_TRACKER_MODE (Settings.tracker_mode, default edit) selects
the live-tracker card behaviour. bump mode re-creates the card at the bottom of
the chat on every update (delete_telegram + send silently + repoint message_id),
keeping the "one card per task" invariant: <=1 new message per call, repoint
only on successful send, delete result never gates the send. New never-raising
delete_telegram helper. Anything != "bump" resolves to edit (zero regression).

Also russify/cosmetic-fix the card text (both modes): "Подтверждение BRD" label,
✅ after approve-gate, Russian stage labels, "📦 Внедрено". Docs updated in the
same PR (CHANGELOG, internals.md, .env.example).

Refs: ORCH-042

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

admin added 1 commit 2026-06-06 13:16:33 +03:00

reviewer(ET): auto-commit from reviewer run_id=170 52cfe51bd8

admin added 1 commit 2026-06-06 13:17:47 +03:00

tester(ET): auto-commit from tester run_id=171 6ef28efccd

admin added 1 commit 2026-06-06 13:20:04 +03:00

deployer(ET): auto-commit from deployer run_id=172 753eea37fc

admin merged commit 3441f01650 into main 2026-06-06 13:48:56 +03:00

admin referenced this issue from a commit 2026-06-06 13:48:56 +03:00

Merge pull request 'feat(notifications): ORCH-042 Telegram tracker bump mode + russification' (#52) from feature/ORCH-042-telegram-live-tracker-bump into main

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

admin

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: admin/orchestrator#52