ghost-link 10.0.0 → 12.0.0

package/README.md

@@ -0,0 +1,73 @@
+# ◢◤ GHOST-LINK V.12
+
+*Ghost-Link is a decentralized, peer-to-peer (P2P) terminal communication suite designed for secure, ephemeral, and encrypted data exchange. It operates without a central server, utilizing a Distributed Hash Table (DHT) to establish direct connections between nodes.*
+
+# Key Features
+
+   **Serverless Protocol:** No central authority or data logging. Connections 
+                            are made node-to-node.
+   **AES-256-GCM Encryption**: Every session uses unique, cryptographically 
+                               derived keys to ensure end-to-end privacy.
+   **Ephemeral Identity:** No accounts and no traces. All session data is 
+                           stored in memory and wiped upon termination.
+   **Secure File Sync:** Integrated P2P file and directory sharing with 
+                         SHA-256 integrity verification.
+   **Dynamic Frequency Shifting:** Owners can shift the entire group to a new 
+                                   room code instantly.
+   **Administrative Control:** The first node to initialize a frequency gains 
+                               Origin (Owner) status to lock rooms or manage peers.
+
+# INSTALLATION & LAUNCH
+
+  *Ensure you have Node.js installed on your system.*
+  *Install the Ghost-Link suite globally via NPM : `npm i -g ghost-link`*
+  *Note: macOS/Linux users may require `sudo` for elevated privileges.*
+
+**EXECUTION**
+  *To start the protocol, simply run the global command: ghost-link*
+
+# HOW TO USE
+
+  **1. INITIALIZATION SEQUENCE**
+   Upon launch, the terminal will prompt you for two parameters:
+   **IDENT:** Enter your temporary alias (e.g., `Shadow`), or leave it 
+   blank and press ENTER to generate a random alias.
+   **FREQ:** Enter a specific room code to join an existing session, or generate custom frequency in format **[X.XXX.XXX.XXX.XXX.XXX.X]** 
+   (Example : *1.345.222.445.991.666.1*)
+   or leave it blank and press ENTER to generate a new, private frequency.
+
+  **2. MESSAGING & COMMANDS**
+    *Once the signal is stabilized, you can type messages normally or use specialized commands:*
+    `<help>` - Displays all available commands.
+    `<share> [path]`- Requests to send a file or folder to the peers.
+    `<reply:ID> [msg]`- Targets a specific message ID to create a threaded 
+                         reply.
+    `<peers>`- Lists all currently manifested nodes on the frequency.
+    `<clear>` - Wipes the current terminal chat history.
+    `<leave>`- Gracefully disconnects your node from the swarm.
+        
+  **3. OWNER-ONLY COMMANDS (ORIGIN NODE)**
+    *The session creator has access to elevated protocol controls:*
+       `<lock>`: Prevents new nodes from joining the frequency.
+       `<unlock>`: Opens the frequency for new connections.
+       `<kick> .` : Opens a menu to terminate a specific peer's connection.
+       `<end>` : Sends a global kill-signal to dissolve the session for      
+                 everyone.
+
+# FILE TRANSFERS
+
+   *Files are automatically saved to your system's default **Downloads** folder under a directory named **Ghost-Link**.*
+
+   **Integrity**: Files are hashed during transit. If the SHA-256 hash does not match upon arrival, the transfer is marked as corrupt.
+
+   **Directories**: Ghost-Link automatically packages, transfers, and extracts folders seamlessly.
+           
+# SECURITY ARCHITECTURE
+   
+  Ghost-Link utilizes a **Zero-Trust** model:
+
+   **Key Derivation**: Room codes are processed via **scrypt** with a hard-coded salt to derive a 32-byte secret key.
+
+   **Packet Security**: Every message is a Buffer containing a 12-byte IV, a 16-byte Auth Tag, and the Encrypted Payload.
+
+   **Nonce Verification**: To prevent replay attacks, the system tracks and ignores duplicate nonces within a sliding window.