grm Functional Specification

• Functional Sub-Spec: Authentication & Chat Management
  • Requirements Traceability
  • Detailed Functional Descriptions
• Functional Sub-Spec: Message CRUD & Export Engine
  • Requirements Traceability
  • Detailed Functional Descriptions
• Functional Sub-Spec: File & Media Attachment
  • Requirements Traceability
  • Detailed Functional Descriptions
• Functional Sub-Spec: File Upload & Attachment Download Engine
  • Requirements Traceability
  • Detailed Functional Descriptions
• Functional Sub-Spec: Supergroup Forum Topics (Threads)
  • Requirements Traceability
  • Detailed Functional Descriptions
• Functional Sub-Spec: Supergroup Forum Topics CRUD Operations
  • Requirements Traceability
  • Detailed Functional Descriptions
• Rich Text, Topic Custom Emojis & Branding Spec
  • Functional Requirements
• Functional Specification: Chat Folder Management
  • Overview
  • Functional Requirements
• [FUNC-014] Universal Cross-Domain Search Functional Specification
  • Overview
  • Requirements
  • Specification Status: In Progress / Unresolved
• Story & Emoji Status Management Spec
  • Overview
  • Functional Requirements
• Functional Specification: CLI Options & Output
  • Overview
  • GNU Option Design Principles
  • Global Options (GNU Long & POSIX Short Pairs)
  • Subcommand GNU Options Matrix
  • Examples
• Functional Specification: Subcommand Help & Autocompletion
  • Overview
  • Subcommand Help Screens
  • Shell Autocompletion Architecture
  • Installation Targets
• Functional Specification: Human & LLM Friendly Output Engine
  • Overview
  • Key Features & Requirements
  • Output Format Matrix
  • Examples

Overview

The grm (Group & Telegram Manager CLI) utility provides a fast, dependable command-line interface for full CRUD management across Telegram entities: Chats, Private/Public Groups, Channels, Forum Topics, Messages, File Downloads/Uploads, Chat Folder Organization, Universal Cross-Domain Search, Telegram Stories, and Custom Emoji Statuses.

Core Functional Requirements

• [FUNC-001]: Interactive & Non-Interactive Telegram User Authentication via TDLib.

• [FUNC-002]: Full Chat & Group CRUD (Create Groups/Channels, Read Info/List, Update Title/Desc/Pin, Delete/Leave).

• [FUNC-003]: Full Message CRUD (Create/Send, Read/List/Search/Info, Update/Edit, Delete for self/everyone).

• [FUNC-006]: Message History Export Engine (CSV and JSON formats).

• [FUNC-007]: File & Media Upload Dispatch (Documents, Images, Video, Audio).

• [FUNC-008]: File & Media Attachment Download Engine (Single & Bulk Download per Chat/Topic).

• [FUNC-009]: Supergroup Forum Topics CRUD (Create Topic, Read List/Info, Update Edit/Close/Reopen/Pin, Delete Topic).

• [FUNC-010]: Telegram Rich Text Entity Formatting (Markdown V2 / HTML via TDLib parseTextEntities).

• [FUNC-011]: Supergroup Forum Topic Custom Emoji Icons (-e | --emoji).

• [FUNC-012]: Project Branding & Visual Logo Assets (Crystal Shard / Facet Visual Identity).

• [FUNC-013]: Chat Folder Management (Create/List/Edit/Delete chat folders and filter chat listings by folder).

• [FUNC-014]: Universal Cross-Domain Search (Unified server-side and local search across chats, messages, and contacts).

• [FUNC-015]: Telegram Stories & Custom Emoji Status Management (Full story lifecycle, interactive sticker overlays, viewers analytics, profile pinning, reactions, privacy management, stealth mode, and custom status badges).