pmv2 telegram_connector Topics

For Agents

Living index of themes for this project. Each H2 is a topic; bullets are wikilinks to related notes. Updated by obsidian-documenter when documenting work. Read by historian at bootstrap. Topics kept alphabetical.

Architecture

• telegram-connector-complete — master overview: status, wire contracts, NATS config, observability, deployment
• telegram-connector-overview — service summary, wire contracts, env matrix, build status (legacy)
• telegram-connector-outbound-design — outbound relay design: ack/nak/term, rate limiting, resilience, consumer reconnect
• telegram-connector-inbound-framework — inbound framework: traits, auth, perms, restart-replay safety
• telegram-connector-inbound-commands — inbound commands: command reference, dispatch, ops publishing, reply correlation
• task7-lib-bin-split-relay-loop-tests — Task 7: lib/bin Cargo split, relay loop, graceful shutdown, integration tests

Build & Contracts

• connector-contracts-verification-playbook — verify connector against un-pushed pmv2-contracts via workspace-root local-path [patch]; authoritative cargo pass/fail through the rtk hook
• per-source-spend-caps-730 — #730 shipped pinned pmv2-contracts 9ce3975; #732 blocked on a contract transport carrying producer fields

Commands & Operations

• telegram-connector-inbound-commands — /autotrade, /halt, /status, /enable, /disable, /reload-commands
• per-source-spend-caps-730 — /autotrade conf [source] <key> <value> per-source overrides; verbatim conf help

Decisions

• per-source-spend-caps-730 — PM owns canonical config-key list (DRY); #732 global-config /status listing deferred pending contract transport

NATS / JetStream

• telegram-connector-complete — NATS subjects, stream config, NKey permissions
• telegram-connector-outbound-design — outbound consumer, dedup window, rate limiting
• nats-jetstream-message-source — Task 5: pull consumer impl, NatsSource/NatsMessage, async-nats 0.49 API notes, Disposition→AckKind mapping

Testing

• task7-lib-bin-split-relay-loop-tests — wiremock integration tests (happy→Ack, 429→Nak, 400→Term); nats_smoke skeleton
• connector-contracts-verification-playbook — authoritative cargo gate under the rtk hook; build/test against un-pushed contracts

Security & Reliability

• security-reliability-fixes-bab38c4 — bot token leak fix, config hardening, token preflight

Trait Design

• telegram-connector-outbound-design — MessageSource, TelegramClient, Disposition
• telegram-connector-inbound-commands — UpdateSource, Publisher, dispatch trait seams
• nats-jetstream-message-source — Task 4 trait seam: Disposition, IncomingMessage, MessageSource
• per-source-spend-caps-730 — Command::reply_is_verbatim(&args) default trait method for raw vs. prettified replies