antigravity-telegram 0.0.0-stage → 0.2.12

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 denoyey (https://github.com/denoyey)
+
+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.

package/README.md

@@ -1,3 +1,317 @@
-# Temporary Holding Version
+<div align="center">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+  <a href="https://github.com/denoyey/antigravity-telegram"><img src="docs/images/banner.svg" alt="Antigravity Telegram Banner" width="100%" /></a>
+
+  <br/><br/>
+
+  <h1>🚀 Antigravity Telegram</h1>
+
+  <p>
+    <strong>Control your Antigravity AI IDE from anywhere — directly from Telegram.</strong><br>
+    <em>A local-first, privacy-focused remote control gateway powered by the Chrome DevTools Protocol (CDP).</em>
+  </p>
+
+  <p>
+    <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" alt="License" /></a>
+    <img src="https://img.shields.io/badge/node-%3E%3D18-brightgreen?style=flat-square&logo=node.js" alt="Node.js" />
+    <img src="https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey?style=flat-square" alt="Platform" />
+    <img src="https://img.shields.io/badge/version-0.2.12-blue?style=flat-square" alt="Version" />
+    <a href="docs/prd/README.md"><img src="https://img.shields.io/badge/PRD-10%20Modules-purple?style=flat-square" alt="PRD Suite" /></a>
+    <img src="https://img.shields.io/badge/security-Zero--Trust%20Audited-success?style=flat-square" alt="Security Audited" />
+  </p>
+
+  <p>
+    <a href="#-quick-start"><b>Quick Start</b></a> •
+    <a href="#-key-capabilities"><b>Key Capabilities</b></a> •
+    <a href="#️-command-reference"><b>Command Reference</b></a> •
+    <a href="#️-architecture--interaction-flow"><b>Architecture</b></a> •
+    <a href="#-technical-documentation-suite"><b>PRD Documentation</b></a>
+  </p>
+
+</div>
+
+---
+
+## 📖 Overview
+
+**Antigravity Telegram** is a lightweight, local-first bridge that connects your smartphone or any Telegram client directly to your desktop [Antigravity IDE](https://antigravity.dev).
+
+Whether you are commuting, having coffee, or working away from your desk, Antigravity Telegram enables you to supervise long-running coding agents, review file edits, approve command executions, send voice notes, and receive real-time code output.
+
+**100% Local & Private**: Unlike cloud-hosted relays, Antigravity Telegram runs entirely on your host machine. Telemetry, credentials, prompts, and source code never pass through external intermediate servers. The bot relies exclusively on outbound HTTPS long-polling to Telegram servers; zero inbound listening ports are exposed to the Internet.
+
+```
++-----------------------------------------------------------------------------------------+
+|                              ANTIGRAVITY TELEGRAM TOPOLOGY                              |
++-----------------------------------------------------------------------------------------+
+|  [ Telegram App (Mobile / Desktop) ]                                                    |
+|                 ^                                                                       |
+|                 | Outbound HTTPS Long-Polling (getUpdates)                              |
+|                 v                                                                       |
+|  [ Local Workstation (100% Host Resident) ]                                             |
+|    ├── 1. Gateway Tier    : Grammy Bot Engine + Whitelist Auth Guard                     |
+|    ├── 2. Persistence Tier: SQLite Database (antigravity.db via BaseRepository)         |
+|    ├── 3. Domain Engine   : Dual-Stream ResponseMonitor + ApprovalDetector              |
+|    └── 4. CDP Bridge      : WebSocket ws://127.0.0.1 (Chrome DevTools Protocol)         |
+|                 |                                                                       |
+|                 v                                                                       |
+|  [ Antigravity IDE (Chromium Renderer DOM) ]                                            |
+|    └── Event-Driven MutationObserver (<100ms real-time updates)                         |
++-----------------------------------------------------------------------------------------+
+```
+
+---
+
+## ✨ Key Capabilities
+
+- **⚡ Event-Driven Real-Time Sync (<100ms)**  
+  Leverages native browser `MutationObserver` bindings via CDP. Assistant outputs, tool calls, and status changes are captured in real-time with sub-100ms latency and minimal host CPU overhead (<1.0% when idle).
+
+- **📂 Smart Forum Topic Workspace Routing**  
+  In Telegram Supergroups, each project directory is bound to its own **Forum Topic**. Messages sent in a topic automatically preserve that repository's context, session state, and concurrency locks.
+
+- **⏱️ Dual-Stream Progress Reporting**  
+  Intelligently separates internal reasoning/tool logs (Thinking, File Diffs, Command Runs) from final assistant code responses. Updates are smoothly throttled to avoid Telegram rate-limit penalties.
+
+- **🎙️ On-Device Voice Transcription (Local Whisper)**  
+  Send voice notes directly from Telegram. Transcribed locally using [whisper.cpp](https://github.com/ggerganov/whisper.cpp) via `ffmpeg-static`. Audio data is processed in memory and never sent to external speech APIs.
+
+- **✅ Remote Interactive Approvals**  
+  When Antigravity requests confirmation for file modifications or terminal commands, you receive a diff preview with interactive buttons (`Approve`, `Reject`, `Auto-Accept`) right on your phone.
+
+- **🛡️ Defense-in-Depth Security (Audited)**  
+  - **Zero-Trust Whitelist**: Only authorized Telegram user IDs are processed; all unauthorized messages are dropped silently.
+  - **Path Traversal Defense**: All paths are resolved with canonical `realpathSync` validation against `WORKSPACE_BASE_DIR`, preventing symlink escapes.
+  - **Safe DOM Injection**: Prompts are inserted using native `Input.insertText`, eliminating JavaScript evaluation and template injection risks.
+  - **Parameterized SQLite**: 100% prepared SQL statements, preventing SQL injection.
+
+- **🧱 Clean Object-Oriented Architecture**  
+  Built with reusable OOP patterns (`BaseRepository`, `BaseService`, `ICommandHandler`), making components maintainable and extensible across other developer bot projects.
+
+---
+
+## 🚀 Quick Start
+
+### Prerequisites
+
+- **Node.js**: `v18.0.0` or higher
+- **Antigravity IDE**: Installed on host machine
+- **Telegram Bot**: Created in 1 minute via [@BotFather](https://t.me/BotFather)
+
+> [!NOTE]
+> **macOS Users**: Ensure Xcode Command Line Tools are installed (`xcode-select --install`) to compile native C++ SQLite bindings (`better-sqlite3`).
+
+### 1. Installation
+
+#### Global Install via npm (Recommended)
+```bash
+npm install -g antigravity-telegram
+```
+
+#### Or Install from Source
+```bash
+git clone https://github.com/denoyey/antigravity-telegram.git
+cd antigravity-telegram
+npm install
+npm run build
+```
+
+### 2. Interactive Setup Wizard
+
+Run the interactive setup wizard to configure your Telegram Bot Token, Allowed User IDs, and Workspace Root Directory:
+```bash
+antigravity-telegram setup
+```
+
+The configuration is saved securely to `.env` or `~/.config/antigravity-telegram-remote/config.json` with `600` file permissions.
+
+### 3. Launch Antigravity with CDP Debugging
+
+Antigravity Telegram interacts with Antigravity through its Chrome DevTools Protocol port. Launch Antigravity with debugging enabled:
+```bash
+antigravity-telegram open
+```
+
+### 4. Start the Telegram Bot
+
+In your terminal, start the bot daemon:
+```bash
+antigravity-telegram start
+```
+
+> [!TIP]
+> If you experience connection issues or want to verify your setup, run the diagnostic doctor:
+> ```bash
+> antigravity-telegram doctor
+> ```
+
+---
+
+## ⌨️ Command Reference
+
+### CLI Commands (Terminal)
+
+| Command | Description |
+| :--- | :--- |
+| `antigravity-telegram setup` | Run the interactive setup and configuration wizard. |
+| `antigravity-telegram open` | Scan available ports and launch Antigravity with CDP enabled. |
+| `antigravity-telegram start` | Start the Telegram bot gateway. |
+| `antigravity-telegram doctor` | Diagnose environment, Node version, CDP connectivity, and database health. |
+| `antigravity-telegram --verbose` | Start with verbose debug-level logging. |
+
+*(Note: `antigravity-telegram-remote` is supported as an alias for all CLI commands).*
+
+### Telegram Slash Commands (Chat / Topic)
+
+| Slash Command | Context | Description |
+| :--- | :--- | :--- |
+| `/project` | Topic / DM | Open interactive menu to select and bind a workspace to the current topic. |
+| `/status` | Any | View active CDP connection, bound workspace, current AI model, and token quota. |
+| `/new` | Topic / DM | Start a fresh conversational session in the bound workspace, clearing history. |
+| `/chat` | Topic / DM | Browse and switch between previous chat sessions saved for this workspace. |
+| `/screenshot` | Topic / DM | Capture an instant high-resolution PNG screenshot of the Antigravity IDE window. |
+| `/model` | Any | Switch active AI model (Gemini Pro, Flash, Claude Sonnet, etc.) with 1 tap. |
+| `/mode` | Any | Toggle operation modes (`Fast`, `Plan`, `Code`, `Ask`). |
+| `/stop` | Topic / DM | Immediately halt the executing prompt or command in the bound workspace. |
+| `/autoaccept` | Any | Configure auto-approval mode (`ALL`, `SAFE_ONLY`, `OFF`) for file edits and commands. |
+| `/template` | Any | Manage and quickly inject reusable prompt templates from SQLite. |
+| `/cleanup [days]`| Any | Purge inactive sessions and reclaim database storage (default: 30 days). |
+| `/help` | Any | Display human-crafted cheat sheet and keyboard shortcuts. |
+
+---
+
+## 🏗️ Architecture & Interaction Flow
+
+```mermaid
+sequenceDiagram
+    autonumber
+    actor User as Telegram Client (Phone)
+    participant Gateway as Grammy Bot Gateway
+    participant Lock as Workspace Mutex
+    participant Monitor as ResponseMonitor
+    participant CDP as CdpService (ws://127.0.0.1)
+    participant IDE as Antigravity IDE (DOM)
+
+    User->>Gateway: Send prompt or voice note in Project Topic
+    Gateway->>Gateway: Verify User ID ∈ ALLOWED_USER_IDS
+    Gateway->>Lock: Acquire exclusive lock for workspace
+    alt Workspace is busy
+        Lock-->>Gateway: Locked (Busy)
+        Gateway-->>User: "⏳ Workspace is busy. Please wait for completion."
+    else Lock acquired
+        Lock-->>Gateway: Granted
+        Gateway->>CDP: Focus Workspace & Insert Text via Input.insertText
+        CDP->>IDE: Inject text & press Enter
+        loop While Generation Active
+            IDE-->>CDP: DOM Mutation Event (window.onAntigravityDomChange)
+            CDP-->>Monitor: Stream delta chunk (<100ms)
+            Monitor-->>Gateway: Format valid Telegram HTML
+            Gateway-->>User: Edit status/response message (Throttled >=1.5s)
+        end
+        IDE-->>CDP: Stop button absent (3 consecutive confirmations)
+        CDP-->>Monitor: onComplete()
+        Gateway->>Lock: Release workspace lock
+        Gateway-->>User: Final formatted code response delivered
+    end
+```
+
+---
+
+## 📚 Technical Documentation Suite
+
+Antigravity Telegram maintains an exhaustive, modular technical documentation suite:
+
+- **[Master Agent Guide (.agents/AGENTS.md)](.agents/AGENTS.md)**: Master engineering guide, OOP standards, threat models, contributor workflows, and maintenance rules.
+- **[Product Requirements Document (PRD) Suite (docs/prd/)](docs/prd/README.md)**:
+  - **[01. Overview & Objectives](docs/prd/01-overview-and-objectives.md)**: Vision, personas, problem statement, OKRs, and scope.
+  - **[02. System Architecture](docs/prd/02-system-architecture.md)**: 3-tier design, CDP WebSocket engine, and Event-Driven DOM pipeline.
+  - **[03. Functional Specifications](docs/prd/03-functional-specifications.md)**: Slash commands, Forum Topic isolation, streaming, and approvals.
+  - **[04. Security Architecture & Threat Model](docs/prd/04-security-and-threat-model.md)**: Complete CWE/OWASP defense matrix and zero-trust guidelines.
+  - **[05. Data Architecture & Persistence](docs/prd/05-data-design-and-storage.md)**: SQLite schemas, prepared statement caching, and lockfiles.
+  - **[06. UX & Non-AI-Slop Interface Design](docs/prd/06-user-experience-and-interface.md)**: Human-crafted design charter, visual hierarchy, and error UX.
+  - **[07. OOP Architecture & Reusability](docs/prd/07-oop-design-and-reusability.md)**: BaseRepository, BaseService, and reusable command patterns.
+  - **[08. Testing Strategy & QA](docs/prd/08-testing-and-quality-assurance.md)**: Jest testing pyramid, mock CDP fixtures, and verification checklist.
+  - **[09. Maintenance & Documentation Policy](docs/prd/09-maintenance-and-evolution-rules.md)**: Mandatory auto-update rules for code and documentation.
+
+---
+
+## ⚙️ Configuration Reference
+
+Configuration options can be supplied via environment variables (`.env`) or JSON config (`config.json`):
+
+| Variable | Type | Default | Description |
+| :--- | :--- | :--- | :--- |
+| `TELEGRAM_BOT_TOKEN` | `string` | **Required** | Secret token obtained from Telegram @BotFather. |
+| `ALLOWED_USER_IDS` | `string` | **Required** | Comma-separated list of numerical Telegram User IDs allowed to access the bot. |
+| `WORKSPACE_BASE_DIR` | `string` | `~/Code` | Root directory containing your development repositories. |
+| `USE_TOPICS` | `boolean` | `true` | Map individual workspaces to dedicated Telegram Forum Topics. |
+| `AUTO_APPROVE_FILE_EDITS` | `string`| `OFF` | Auto-approval policy (`OFF`, `SAFE_ONLY`, `ALL`). |
+| `ANTIGRAVITY_PATH` | `string` | Auto-detected | Explicit path to the Antigravity executable. |
+| `LOG_LEVEL` | `string` | `info` | Logging verbosity (`debug`, `info`, `warn`, `error`). |
+
+---
+
+## 🔒 Mandatory Documentation Auto-Update Policy
+
+> [!IMPORTANT]
+> **Strict Repository Rule**:  
+> Whenever any feature, command, configuration variable, database schema, or architectural component in this repository is modified, **the corresponding documentation in `docs/prd/` and this `README.md` MUST be updated in the exact same turn or commit**. Outdated documentation is treated as a critical regression.
+
+---
+
+## 🤝 Contributing
+
+We welcome community contributions! Please adhere to our development standards:
+
+1. Fork the repository and create your feature branch (`git checkout -b feature/my-feature`).
+2. Write clean TypeScript code conforming to the OOP principles in `src/database/baseRepository.ts` and `src/services/baseService.ts`.
+3. Verify all tests pass and compilation succeeds:
+   ```bash
+   npm test
+   npm run build
+   ```
+4. Update the relevant PRD documents in `docs/prd/` and `README.md`.
+5. Submit a detailed Pull Request.
+
+Detailed guidelines, code conventions, and our Code of Conduct are maintained in **[.agents/AGENTS.md](.agents/AGENTS.md)**.
+
+---
+
+## 📄 License
+
+This project is licensed under the terms of the [MIT License](LICENSE).
+
+---
+
+## 🙏 Acknowledgements & Attribution
+
+<div align="center">
+
+> ### 💖 Special Thanks to the Original Creator
+>
+> This project proudly builds upon the pioneering architecture of **[optimistengineer/remoat](https://github.com/optimistengineer/remoat)**.  
+> We express our heartfelt gratitude to the original creators and contributors for innovating the core concept of controlling desktop AI coding assistants through the Chrome DevTools Protocol and Telegram.
+
+</div>
+
+### 🌟 Lineage & Engineering Evolution
+
+```
+[ optimistengineer/remoat ] ──► Foundational Concept: Local CDP Bridge & Telegram Gateway
+             │
+             ▼
+[ Antigravity Telegram (denoyey) ] ──► Audited, Overhauled & Modular Architecture
+```
+
+| Architecture Area | Upstream Foundation (`remoat`) | Antigravity Telegram Enhancement |
+| :--- | :--- | :--- |
+| **DOM Synchronization** | 2-second polling intervals | **Event-Driven `MutationObserver`** + CDP Binding (`<100ms` instant delta updates) |
+| **Path Traversal Security**| Standard path normalization | **Canonical `realpathSync`** resolution (hardened defense against symlink escapes) |
+| **Software Architecture** | Flat procedural handlers | **Modular OOP Architecture** (`BaseRepository`, `BaseService`, `CommandRegistry`) |
+| **Audio & Voice Support** | Text only | **On-Device Whisper (`whisper.cpp`)** local voice transcription (zero cloud leakage) |
+| **Visual Attachments** | Text prompts only | **Screenshot streaming** & direct image upload injection into Antigravity IDE |
+| **Documentation Suite** | Basic README | **Comprehensive 10-Module PRD Suite** + Master Agent Guide (`.agents/AGENTS.md`) |
+| **Internationalization** | Basic locales | **Full Multi-Language Support** (`en`, `vi`, `ja`) with unified i18n engine |
+
+> [!TIP]
+> If you find this project useful, please take a moment to also star and support the original upstream repository at **[github.com/optimistengineer/remoat](https://github.com/optimistengineer/remoat)**!

package/dist/bin/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/cli.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const commander_1 = require("commander");
+const package_json_1 = require("../../package.json");
+const start_1 = require("./commands/start");
+const doctor_1 = require("./commands/doctor");
+const setup_1 = require("./commands/setup");
+const open_1 = require("./commands/open");
+const configLoader_1 = require("../utils/configLoader");
+const welcome_1 = require("./welcome");
+const program = new commander_1.Command()
+    .name('antigravity-telegram')
+    .description('Control your Antigravity AI IDE remotely via Telegram')
+    .version(package_json_1.version)
+    .option('--verbose', 'Show debug-level logging')
+    .option('--quiet', 'Only show errors');
+// Default action: no subcommand → start or setup
+program.action(async () => {
+    const hasConfig = configLoader_1.ConfigLoader.configExists();
+    const hasEnv = fs.existsSync(path.resolve(process.cwd(), '.env'));
+    if (!hasConfig && !hasEnv) {
+        (0, welcome_1.printWelcome)();
+        return (0, setup_1.setupAction)();
+    }
+    else {
+        return (0, start_1.startAction)(program.opts(), program);
+    }
+});
+program
+    .command('start')
+    .description('Start the Telegram bot daemon')
+    .action((_opts, cmd) => (0, start_1.startAction)(cmd.parent.opts(), cmd.parent));
+program
+    .command('doctor')
+    .description('Diagnose environment, Node version, and CDP connectivity')
+    .action(doctor_1.doctorAction);
+program
+    .command('setup')
+    .description('Run interactive configuration wizard')
+    .action(setup_1.setupAction);
+program
+    .command('open')
+    .description('Launch Antigravity IDE with CDP debugging enabled')
+    .action(open_1.openAction);
+program.parse();
+//# sourceMappingURL=cli.js.map

package/dist/bin/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,uCAAyB;AACzB,2CAA6B;AAC7B,yCAAoC;AACpC,qDAA6C;AAC7C,4CAA+C;AAC/C,8CAAiD;AACjD,4CAA+C;AAC/C,0CAA6C;AAC7C,wDAAqD;AACrD,uCAAyC;AAEzC,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE;KACxB,IAAI,CAAC,sBAAsB,CAAC;KAC5B,WAAW,CAAC,uDAAuD,CAAC;KACpE,OAAO,CAAC,sBAAO,CAAC;KAChB,MAAM,CAAC,WAAW,EAAE,0BAA0B,CAAC;KAC/C,MAAM,CAAC,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAE3C,iDAAiD;AACjD,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,EAAE;IACtB,MAAM,SAAS,GAAG,2BAAY,CAAC,YAAY,EAAE,CAAC;IAC9C,MAAM,MAAM,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;IAElE,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,EAAE,CAAC;QACxB,IAAA,sBAAY,GAAE,CAAC;QACf,OAAO,IAAA,mBAAW,GAAE,CAAC;IACzB,CAAC;SAAM,CAAC;QACJ,OAAO,IAAA,mBAAW,EAAC,OAAO,CAAC,IAAI,EAAE,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,OAAO;KACF,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,+BAA+B,CAAC;KAC5C,MAAM,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,IAAA,mBAAW,EAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;AAExE,OAAO;KACF,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,0DAA0D,CAAC;KACvE,MAAM,CAAC,qBAAY,CAAC,CAAC;AAE1B,OAAO;KACF,OAAO,CAAC,OAAO,CAAC;KAChB,WAAW,CAAC,sCAAsC,CAAC;KACnD,MAAM,CAAC,mBAAW,CAAC,CAAC;AAEzB,OAAO;KACF,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,mDAAmD,CAAC;KAChE,MAAM,CAAC,iBAAU,CAAC,CAAC;AAExB,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/bin/commands/doctor.d.ts

@@ -0,0 +1 @@
+export declare function doctorAction(): Promise<void>;

package/dist/bin/commands/doctor.js

@@ -0,0 +1,211 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.doctorAction = doctorAction;
+const http = __importStar(require("http"));
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const cdpPorts_1 = require("../../utils/cdpPorts");
+const configLoader_1 = require("../../utils/configLoader");
+const pathUtils_1 = require("../../utils/pathUtils");
+const logger_1 = require("../../utils/logger");
+const ok = (msg) => console.log(`  ${logger_1.COLORS.green}[OK]${logger_1.COLORS.reset} ${msg}`);
+const warn = (msg) => console.log(`  ${logger_1.COLORS.yellow}[--]${logger_1.COLORS.reset} ${msg}`);
+const fail = (msg) => console.log(`  ${logger_1.COLORS.red}[!!]${logger_1.COLORS.reset} ${msg}`);
+const hint = (msg) => console.log(`       ${logger_1.COLORS.dim}${msg}${logger_1.COLORS.reset}`);
+function checkPort(port) {
+    return new Promise((resolve) => {
+        const req = http.get(`http://127.0.0.1:${port}/json/list`, (res) => {
+            let data = '';
+            res.on('data', (chunk) => (data += chunk));
+            res.on('end', () => {
+                try {
+                    const parsed = JSON.parse(data);
+                    resolve(Array.isArray(parsed));
+                }
+                catch {
+                    resolve(false);
+                }
+            });
+        });
+        req.on('error', () => resolve(false));
+        req.setTimeout(2000, () => {
+            req.destroy();
+            resolve(false);
+        });
+    });
+}
+function checkEnvFile() {
+    const envPath = path.resolve(process.cwd(), '.env');
+    return { exists: fs.existsSync(envPath), path: envPath };
+}
+function checkRequiredEnvVars() {
+    const required = ['TELEGRAM_BOT_TOKEN', 'ALLOWED_USER_IDS'];
+    // Also check config.json values
+    let persisted = {};
+    try {
+        const configPath = configLoader_1.ConfigLoader.getConfigFilePath();
+        if (fs.existsSync(configPath)) {
+            persisted = JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        }
+    }
+    catch { /* ignore parse errors here */ }
+    const configKeyMap = {
+        TELEGRAM_BOT_TOKEN: 'telegramBotToken',
+        ALLOWED_USER_IDS: 'allowedUserIds',
+    };
+    return required.map((name) => ({
+        name,
+        set: Boolean(process.env[name]) || Boolean(persisted[configKeyMap[name]]),
+    }));
+}
+async function doctorAction() {
+    console.log(`\n${logger_1.COLORS.cyan}antigravity-telegram doctor${logger_1.COLORS.reset}\n`);
+    let allOk = true;
+    // 1. Config directory check
+    const configDir = configLoader_1.ConfigLoader.getConfigDir();
+    if (fs.existsSync(configDir)) {
+        ok(`Config directory exists: ${configDir}`);
+    }
+    else {
+        warn(`Config directory not found: ${configDir}`);
+        hint('Run: antigravity-telegram setup  (optional if using .env)');
+    }
+    // 2. Config file check
+    const configFilePath = configLoader_1.ConfigLoader.getConfigFilePath();
+    if (configLoader_1.ConfigLoader.configExists()) {
+        ok(`Config file found: ${configFilePath}`);
+    }
+    else {
+        warn(`Config file not found: ${configFilePath} (optional — .env fallback used)`);
+    }
+    // 3. .env file check
+    const env = checkEnvFile();
+    if (env.exists) {
+        // Load .env so subsequent checks can see the variables
+        require('dotenv').config({ path: env.path });
+        ok(`.env file found: ${env.path}`);
+    }
+    else {
+        if (!configLoader_1.ConfigLoader.configExists()) {
+            fail(`.env file not found: ${env.path}`);
+            allOk = false;
+        }
+        else {
+            warn(`.env file not found: ${env.path} (not needed — config.json used)`);
+        }
+    }
+    // 4. Required environment variables (checks both .env and config.json)
+    const vars = checkRequiredEnvVars();
+    for (const v of vars) {
+        if (v.set) {
+            ok(`${v.name} is set`);
+        }
+        else {
+            fail(`${v.name} is NOT set`);
+            allOk = false;
+        }
+    }
+    // 5. Node.js version check
+    const nodeVersion = process.versions.node;
+    const major = parseInt(nodeVersion.split('.')[0], 10);
+    if (major >= 18) {
+        ok(`Node.js ${nodeVersion}`);
+    }
+    else {
+        fail(`Node.js ${nodeVersion} (>= 18.0.0 required)`);
+        allOk = false;
+    }
+    // 6. Platform-specific checks
+    const platform = os.platform();
+    if (platform === 'darwin') {
+        // Check Xcode Command Line Tools (needed for native module compilation)
+        try {
+            (0, child_process_1.execFileSync)('xcode-select', ['-p'], { stdio: 'pipe' });
+            ok('Xcode Command Line Tools installed');
+        }
+        catch {
+            warn('Xcode Command Line Tools not found');
+            hint('Install with: xcode-select --install');
+            hint('Required for native dependencies (better-sqlite3)');
+        }
+        // Check if Antigravity.app exists
+        const antigravityPath = process.env.ANTIGRAVITY_PATH;
+        if (antigravityPath) {
+            if (fs.existsSync(antigravityPath)) {
+                ok(`Antigravity found: ${antigravityPath}`);
+            }
+            else {
+                fail(`ANTIGRAVITY_PATH set but not found: ${antigravityPath}`);
+                allOk = false;
+            }
+        }
+        else if (fs.existsSync('/Applications/Antigravity.app')) {
+            ok('Antigravity.app found in /Applications');
+        }
+        else {
+            warn('Antigravity.app not found in /Applications');
+            hint('Install Antigravity, or set ANTIGRAVITY_PATH in .env');
+        }
+    }
+    // 7. CDP port check
+    console.log(`\n  ${logger_1.COLORS.dim}Checking CDP ports...${logger_1.COLORS.reset}`);
+    let cdpOk = false;
+    for (const port of cdpPorts_1.CDP_PORTS) {
+        const alive = await checkPort(port);
+        if (alive) {
+            ok(`CDP port ${port} is responding`);
+            cdpOk = true;
+        }
+    }
+    if (!cdpOk) {
+        fail('No CDP ports responding');
+        hint(`Run: antigravity-telegram open`);
+        hint(`Or manually: ${(0, pathUtils_1.getAntigravityCdpHint)(9222)}`);
+        allOk = false;
+    }
+    // Summary
+    console.log('');
+    if (allOk) {
+        console.log(`  ${logger_1.COLORS.green}All checks passed!${logger_1.COLORS.reset}`);
+    }
+    else {
+        console.log(`  ${logger_1.COLORS.red}Some checks failed. Please fix the issues above.${logger_1.COLORS.reset}`);
+        process.exitCode = 1;
+    }
+}
+//# sourceMappingURL=doctor.js.map

package/dist/bin/commands/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../../src/bin/commands/doctor.ts"],"names":[],"mappings":"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"}

package/dist/bin/commands/open.d.ts

@@ -0,0 +1 @@
+export declare function openAction(): Promise<void>;