mojic 1.0.0 → 1.0.2

package/CONTRIBUTING.md

@@ -1,14 +1,14 @@
-# Contributing to Emojic
+# Contributing to Mojic
 
 First off, thanks for taking the time to contribute! 🎉
 
-The following is a set of guidelines for contributing to Emojic. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
+The following is a set of guidelines for contributing to Mojic. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
 
 ## How Can I Contribute?
 
 ### Reporting Bugs
 
-This section guides you through submitting a bug report for Emojic. Following these guidelines helps maintainers and the community understand your report, reproduce the behavior, and find related reports.
+This section guides you through submitting a bug report for Mojic. Following these guidelines helps maintainers and the community understand your report, reproduce the behavior, and find related reports.
 
 * **Use a clear and descriptive title** for the issue to identify the problem.
 * **Describe the exact steps which reproduce the problem** in as many details as possible.
@@ -16,11 +16,11 @@ This section guides you through submitting a bug report for Emojic. Following th
 
 ### Suggesting Enhancements
 
-This section guides you through submitting an enhancement suggestion for Emojic, including completely new features and minor improvements to existing functionality.
+This section guides you through submitting an enhancement suggestion for Mojic, including completely new features and minor improvements to existing functionality.
 
 * **Use a clear and descriptive title** for the issue to identify the suggestion.
 * **Provide a step-by-step description of the suggested enhancement** in as many details as possible.
-* **Explain why this enhancement would be useful** to most Emojic users.
+* **Explain why this enhancement would be useful** to most Mojic users.
 
 ## Styleguides
 
@@ -29,11 +29,10 @@ This section guides you through submitting an enhancement suggestion for Emojic,
 * Use the present tense ("Add feature" not "Added feature")
 * Use the imperative mood ("Move cursor to..." not "Moves cursor to...")
 * Limit the first line to 72 characters or less
-* Reference issues and pull requests liberally after the first line
 
-### Emojic Code Style
+### Mojic Code Style
 
-* If you are writing Emojic examples, try to make them as unreadable as possible.
-* Use `😒` for `int` whenever possible.
+* **Cipher Logic:** Changes to `CipherEngine.js` must ensure backward compatibility with the header format.
+* **Streams:** Always use `StringDecoder` when handling text streams to prevent multi-byte emoji corruption.
 
-Happy Hacking! 🚀
+Happy Hacking! 🚀

package/README.md

@@ -1,70 +1,67 @@
-# Emojic 🤯
+# Mojic 🔒🔮
 
-> A chaotic, emoji-based C transpiler and IDE. Write C code using emojis, compile it, or transform normal C into a cursed emoji nightmare.
+> **Obfuscate C source code into a randomized stream of emojis using password-seeded encryption.**
 
+**Mojic** (Magic + Emoji + Logic) is a CLI tool that transforms readable C code into an unreadable mess of emojis. Unlike simple substitution ciphers, Mojic uses your password to seed a Pseudo-Random Number Generator (PRNG), creating a unique "Emoji Universe" for every password.
 
-## What is this?
+## 🚀 Features
 
-**Emojic** is a dangerous experiment in compiler theory. It allows you to write valid C code using emojis as preprocessor definitions. It comes with a full-stack **Emojic Studio** IDE that lets you:
+* **🔐 Seeded Shuffling:** Your password derives a seed that shuffles the emoji mapping. Two different passwords will produce completely different emoji outputs for the same file.
+* **🌚 Moon Header Protocol:** The file header (Salt + Auth Hash) is encoded using only Moon and Clock emojis to allow metadata reading before decryption.
+* **📂 Recursive Processing:** Encrypt or decrypt entire project directories with one flag.
+* **🔄 Security Rotation:** Rotate passwords or re-scramble the entropy of encrypted files without seeing the plaintext.
+* **⚡ Stream Based:** Handles large files efficiently using Node.js streams.
 
-1.  **Compile Emojic to C**: Turn `😒 😊😂🤣👌` into `int main()`.
-2.  **Transform C to Emojic**: Turn your clean code into an unreadable emoji mess.
-3.  **Run in Cloud**: Execute your cursed code instantly via the `compiler.amit.is-a.dev` backend.
+## 📦 Installation
 
-## 🚀 Features
+```bash
+npm install -g mojic
+```
+
+## 🛠️ Usage
+
+### 1. Encrypting Code (`encode`)
+Turns a `.c` file into a `.mojic` file.
+
+```bash
+# Encrypt a single file
+mojic encode main.c
+
+# Encrypt an entire directory recursively
+mojic encode ./src -r
+```
+*You will be prompted to create a password. This password is required to decrypt.*
+
+### 2. Decrypting Code (`decode`)
+Restores the original C code from a `.mojic` file.
+
+```bash
+# Decrypt a single file
+mojic decode main.mojic
+
+# Decrypt an entire directory recursively
+mojic decode ./src -r
+```
+
+### 3. Security & Rotation Tools (`srt`)
+Manage encrypted files without revealing their contents.
+
+```bash
+# Change the password of an encrypted file
+mojic srt --pass secret.mojic
 
-- **Dynamic Token Analysis**: Automatically detects keywords in your C code.
-- **Custom Mapping**: Choose which emojis represent `int`, `return`, or `;`.
-- **Live Terminal**: Real-time output streaming via WebSockets.
-- **Dark Mode IDE**: A VS Code-like experience in the browser.
-
-## 🛠️ Installation & Deployment
-
-This project is designed to be deployed on **Vercel** (Frontend + API).
-
-1.  **Clone the repo**
-    ```bash
-    git clone [https://github.com/notamitgamer/](https://github.com/notamitgamer/)emojic.git
-    cd emojic
-    ```
-
-2.  **Install Backend Dependencies**
-    ```bash
-    pip install -r requirements.txt
-    ```
-
-3.  **Run Locally**
-    ```bash
-    python api/index.py
-    # Open index.html in your browser
-    ```
-
-## 😒 Example Code
-
-```c
-/* The Hello World of Emojic */
-#include<stdio.h>
-
-#define 😒 int
-#define 😊 main
-#define 😂 (
-#define 🤣 )
-#define ❤️ printf
-#define 😍 ;
-#define 🙌 return
-#define 👌 {
-#define 😘 }
-
-😒 😊😂🤣👌
-    ❤️😂"Hello World!\n"🤣😍
-    🙌 0😍
-😘
+# Re-shuffle the encryption (New Salt) with the SAME password
+# (Useful if you want to change the visual emoji pattern without changing the password)
+mojic srt --re secret.mojic
 ```
 
-## 🤝 Contributing
+## 🧠 How it Works
 
-We welcome chaos! Please see [CONTRIBUTING.md](CONTRIBUTING.md) for details.
+1.  **Key Derivation:** Mojic uses **PBKDF2** to derive a 32-bit seed and an Auth Hash from your password and a random Salt.
+2.  **The Shuffle:** It uses a custom **Mulberry32 PRNG** seeded with your key to shuffle a "Universe" of ~1500 emojis.
+3.  **Tokenization:** C keywords (`int`, `return`, `void`) are tokenized and mapped to unique emojis from the shuffled universe. Remaining characters map to other emojis.
+4.  **The Header:** The Salt and Auth Hash are written to the top of the file using a fixed "Header Alphabet" (🌑🌒🌓🌔...) so the tool can verify your password before attempting decryption.
 
 ## 📄 License
 
-This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+This project is licensed under the Apache License 2.0 - see the [LICENSE](LICENSE) file for details.

package/SECURITY.md

@@ -2,8 +2,12 @@
 
 ## Reporting a Vulnerability
 
-We take security seriously, even if this project is a joke.
+We take security seriously.
 
-If you discover a security vulnerability within Emojic, please send an e-mail to **amitdutta4255@gmail.com**. All security vulnerabilities will be promptly addressed.
+If you discover a security vulnerability within Mojic (e.g., in the `CipherEngine` logic or the PRNG implementation), please send an e-mail to **amitdutta4255@gmail.com**. All security vulnerabilities will be promptly addressed.
 
 **Please do not open public issues for security vulnerabilities.**
+
+### Scope
+* **Supported:** Issues regarding key derivation, salt collisions, or stream buffer overflows.
+* **Not Supported:** Brute-forcing weak passwords (users are responsible for password strength).

package/bin/mojic.js

@@ -12,7 +12,7 @@ import { CipherEngine } from '../lib/CipherEngine.js';
 program
     .name('mojic')
     .description('Obfuscate C source code into emojis')
-    .version('1.0.0')
+    .version('1.0.2')
     .addHelpCommand('help [command]', 'Display help for command')
     .showHelpAfterError();
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mojic",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Obfuscate C source code into emojis using password-seeded mapping",
   "main": "bin/mojic.js",
   "bin": {