Update TODO.md

Author: TheMaster1127

TODO.md

@@ -1,134 +1,96 @@
 # TODO / PLAN FOR HTVM V3
 
-## ⚠️ **WARNING: This is a Development Plan, Not a Promise** ⚠️
+## The Strategic Roadmap for HTVM V3
 
-> This document outlines the **planned** development roadmap for HTVM V3. It is a living document, and the features, their order, and release versions are **subject to change** based on development realities and shifting priorities. This is a guide, not a guarantee.
+### ⚠️ **WARNING: This is a Development Plan, Not a Promise** ⚠️
+
+> This document outlines the strategic vision for the development of HTVM Version 3. It is a living document, meaning priorities may shift and the order of implementation is flexible. The goal is to build upon the stable foundation of V2 and deliver the next Version of personalized programming.
 
 ---
 
-### **1. Package the HT-IDE**
--   `[✅]` Build Electron to generate standalone executables for all platforms to **eliminate the NPM requirement for users.**
+### **Core Engine & Parser Enhancements**
+*Fundamental upgrades that expand the power and flexibility of the HTVM engine.*
+
+-   `[50%]` **Finalize the Plugin API & Marketplace ("The Freedom API")**
+    -   *Objective:* Solidify the hook system and establish the community marketplace, empowering users to extend HTVM's syntax.
 
-### **2. Implement the HTVM Plugin API & Marketplace ("The Freedom API")**
--   `[✅]` Architect and implement the core API with stable hook points in the parser and transpiler.
--   `[✅]` Create the `htvm-marketplace` GitHub repository and contribution guidelines.
--   `[✅]` Build the "Plugin Manager" feature into the IDE, including fetching from the marketplace, installing, and managing plugins.
--   `[ ]`  **YouTube Release (v2.1):** "HTVM's New Plugin API & Marketplace: Build Your Own Syntax! (v2.1 Update & Tutorial)"
+-   `[ ]` **Achieve Total Syntax Configuration**
+    -   *Objective:* De-hardcode all remaining syntax elements (`gui`, `when`, `maps`, `subout`, etc.) into configurable rules, enabling ultimate language personalization.
 
-### **3. Implement the HTVM Debugger**
--   `[ ]` Build the debugger within the HT-IDE by injecting `input()` calls at breakpoints to display variable states.
--   **YouTube Release (v2.2):** "Introducing the HTVM Debugger"
+-   `[ ]` **Implement Static One-Time Inference (SOTI)**
+    -   *Objective:* Introduce optional static typing without the boilerplate, allowing for greater type safety and performance when targeting static languages.
 
-### **4. Implement Total Syntax Configuration**
--   `[ ]` Break down previously hard-coded syntaxes (`gui`, `when`, `subout` etc...) into configurable rules in `HTVM-instructions.txt`.
+-   `[ ]` **Build the Advanced Alias Engine**
+    -   *Objective:* Allow for infinite keyword aliasing via `.htvmprofile`, making the IDE and parser fully aware of a developer's personal vocabulary.
 
-### **5. Implement Major GUI Enhancements**
--   `[ ]` Add new GUI commands and improve existing ones based on the new total syntax configuration capabilities.
--   **YouTube Release (v2.3):** "How to Use GUIs in HTVM (New v2.3 Features & Tutorial)"
+-   `[ ]` **Architect & Implement Native Map/Dictionary Support**
+    -   *Objective:* Design a core, customizable syntax for key-value pairs (maps, dictionaries, hashmaps) and ensure it can be transpiled effectively to all target languages.
 
-### **6. Implement New Language Constructs (Liner & Flowcall)**
--   `[ ]` **Liner:** Implement the weighted conditional block.
--   `[ ]` **Flowcall:** Implement the named-input block.
--   **YouTube Release (v2.4):** "New HTVM Constructs: Liner & Flowcall Explained (v2.4 Update)"
+-   `[ ]` **Build The Definitive `For` Construct**
+    -   *Objective:* Create a powerful polymorphic iteration engine that can intelligently loop over any data type (strings, arrays, maps, ranges) with a consistent syntax.
+
+---
 
-### **7. Implement the "Writability vs. Readability" Engine (The Transformer)**
--   `[ ]` Develop the shorthand-to-code expansion logic and hotkey integration.
--   **YouTube Release (v2.5):** "Code at the Speed of Thought: HTVM's IDE New Feature (v2.5)"
+### **Developer Experience & Tooling**
+*Features focused on making the day-to-day process of writing, debugging, and managing HTVM code faster and more intuitive.*
 
-### **8. Implement Static One-Time Inference (SOTI)**
--   `[ ]` Re-architect the parser's variable handling to infer and lock a variable's type upon its first assignment.
--   **YouTube Release (v2.6):** "Static Typing Without the Boilerplate: HTVM's New SOTI Engine (v2.6)"
+-   `[✅]` **Package the Standalone HT-IDE**
+    -   *Objective:* Finalize and distribute the Electron-based IDE to remove the NPM dependency for users.
 
-### **9. Implement the Advanced Alias Engine**
--   `[ ]` Implement `.htvmprofile` parsing for infinite keyword aliasing. Integrate into the parser, IDE syntax highlighting, and autocompletion.
--   **YouTube Release (v2.7):** "Code Your Way: HTVM's Infinite Alias Engine"
+-   `[ ]` **Implement the HTVM Debugger**
+    -   *Objective:* Build the integrated debugger that uses injected `input()` calls to provide state inspection directly within the IDE's workflow.
 
-### **10. Implement Personalized Styling & Bidirectional Formatting (The Code War Eliminator)**
--   `[ ]` Implement the `.htvmprofile` `style_config` parser and the non-destructive rendering system in the IDE, including the **Intelligent Name Collision Detection Algorithm.**
--   **YouTube Release (v2.8):** "Ending the Code Wars: HTVM's Personalized Styling Engine (v2.8)"
+-   `[ ]` **Implement "The Transformer" Engine (Writability vs. Readability)**
+    -   *Objective:* Create the shorthand-to-code expansion logic, allowing for rapid, compressed coding that expands into fully readable code, solving a timeless programming trade-off.
 
-### **11. Implement the New `For` Construct (The Definitive Iteration Engine)**
--   `[ ]` Build the full polymorphic engine for all data types, including the `A_` variable suite.
--   **YouTube Release (v2.9):** "The Ultimate Loop: Introducing HTVM's New 'For' Construct (v2.9 Update)"
+-   `[ ]` **Create the V2-to-V3 Instruction File Converter**
+    -   *Objective:* Build a utility to ensure backward compatibility and a smooth transition for existing instruction files to the new V3 format.
 
-### **12. Add New Language Targets (GDScript, AngelScript, C)**
--   `[ ]` Extend the transpiler engine and built-ins for all three languages. Update documentation to reflect 18 languages and create `LANGS.md`.
--   **YouTube Release (v2.10) - Titles:**
-    -   "HTVM for Godot: Full GDScript Support is Here!"
-    -   "HTVM Now Supports AngelScript"
-    -   "HTVM Now Supports C"
+---
 
-### **13. Implement The Metaconfigurator (Customizable Config Files)**
--   `[ ]` Extend the IDE/engine to parse and convert between different instruction file formats (JSON, YAML, INI).
--   **YouTube Release (v2.11):** "Your Config, Your Way: HTVM's Metaconfigurator (v2.11)"
+### **The Code War Eliminator: Personalized Styling Engine**
+*The philosophical heart of HTVM V3, solving the human problems of programming style and collaboration.*
 
-### **14. Implement Pythonic Indentation Style (Experimental)**
--   `[ ]` Implement the new feature, framing it as a completely new addition to HTVM.
--   **YouTube Release (v2.12, if successful):** "Introducing Pythonic Indentation Style to HTVM"
+-   `[ ]` **Implement Personalized Styling & Bidirectional Formatting**
+    -   *Objective:* Build the system that reads styling preferences from a `.htvmprofile` and renders code in a user's preferred format (tabs, spaces, brace style, naming conventions) without altering the source file. This includes the Intelligent Name Collision Detection Algorithm.
 
-### **15. Implement "AI Language Creator"**
--   `[ ]` Engineer the master prompt for the LLM and build the IDE interface to generate `HTVM-instructions.txt` files from plain English.
--   **YouTube Release (v2.13):** "HTVM: AI-Assisted Language Generation is Here"
+---
 
-### **16. Implement V2-to-V3 Instruction File Converter**
--   `[ ]` Create a utility to migrate old instruction files to the new V3 format.
--   **YouTube Release (v2.14):** "HTVM V2 to V3 Converter"
+### **High-Level Language Constructs & Features**
+*New, expressive tools that developers can use directly in their HTVM code.*
 
-### **17. Update the Website & Documentation**
--   `[ ]` Update the HTVM Language Creator website and all documentation for every new V3 feature.
+-   `[ ]` **Implement Major GUI Enhancements**
+    -   *Objective:* Expand the GUI command set with new controls and capabilities, building upon the new Total Syntax Configuration system.
 
-### **18. HTVM v3.0 Grand Launch**
--   `[ ]` Produce and release the definitive launch video: **"HTVM v3: The Future of Programming is Here."**
+-   `[ ]` **Implement New Language Constructs (Liner & Flowcall)**
+    -   *Objective:* Build the planned weighted conditional block (`Liner`) and the named-input block (`Flowcall`) to offer new ways to express complex logic.
 
 ---
 
-### **HTVM V3 To-Do List (In Order)**
-
-#### **2/22 Done!**
-
-1.  `[✅]` IDE Packaging
-2.  `[50%]` HTVM Plugin API & Marketplace
-3.  `[ ]` HTVM Debugger
-4.  `[ ]` Total Syntax Configuration
-5.  `[ ]` GUI Enhancements
-6.  `[ ]` Liner (New Language Constructs)
-7.  `[ ]` Flowcall (New Language Constructs)
-8.  `[ ]` Writability Engine ("The Transformer")
-9.  `[ ]` Static One-Time Inference (SOTI)
-10. `[ ]` Advanced Alias Engine
-11. `[ ]` Personalized Styling Engine (Code War Eliminator)
-12. `[ ]` The `For` Construct (Definitive Iteration Engine)
-13. `[ ]` New Language Target: GDScript
-14. `[ ]` New Language Target: AngelScript
-15. `[ ]` New Language Target: C
-16. `[ ]` Metaconfigurator (Customizable Config Files)
-17. `[ ]` Pythonic Indentation (Experimental)
-18. `[ ]` AI Language Creator
-19. `[ ]` V2-to-V3 Converter
-20. `[ ]` Update the Website
-21. `[ ]` Update the Documentation
-22. `[ ]` Finish HTVM v3
-
-### **Videos To Make:**
-
-#### **0/17 Done!**
-
-1. `[ ]` HTVM's New Plugin API & Marketplace: Build Your Own Syntax! (v2.1 Update & Tutorial)
-2. `[ ]` Introducing the HTVM Debugger (v2.2)
-3. `[ ]` How to Use GUIs in HTVM (v2.3 Features & Tutorial)
-4. `[ ]` New HTVM Constructs: Liner & Flowcall Explained (v2.4 Update)
-5. `[ ]` Code at the Speed of Thought: HTVM's IDE New Feature (v2.5)
-6. `[ ]` Static Typing Without the Boilerplate: HTVM's New SOTI Engine (v2.6)
-7. `[ ]` Code Your Way: HTVM's Infinite Alias Engine (v2.7)
-8. `[ ]` Ending the Code Wars: HTVM's Personalized Styling Engine (v2.8)
-9. `[ ]` The Ultimate Loop: Introducing HTVM's New 'For' Construct (v2.9 Update)
-10. `[ ]` HTVM for Godot: Full GDScript Support is Here! (v2.10)
-11. `[ ]` HTVM Now Supports AngelScript (v2.10)
-12. `[ ]` HTVM Now Supports C (v2.10)
-13. `[ ]` Your Config, Your Way: HTVM's Metaconfigurator (v2.11)
-14. `[ ]` Introducing Pythonic Indentation Style to HTVM (v2.12)
-15. `[ ]` HTVM: AI-Assisted Language Generation is Here (v2.13)
-16. `[ ]` HTVM V2 to V3 Converter (v2.14)
-17. `[ ]` HTVM v3: The Future of Programming is Here.
+### **Ecosystem & Platform Expansion**
+*Goals that extend HTVM's reach, making it compatible with more platforms and lowering the barrier to entry.*
+
+-   `[ ]` **Add New Language Targets**
+    -   *Objective:* Extend the transpiler to support **C**, **GDScript**, and **AngelScript**, bringing the total number of target languages to 18.
+
+-   `[ ]` **Implement The Metaconfigurator**
+    -   *Objective:* Allow instruction files to be defined in multiple formats (JSON, YAML, INI), giving users more control over their configuration workflow.
+
+-   `[ ]` **Implement Pythonic Indentation Style (Experimental)**
+    -   *Objective:* Research and build the logic to support indentation-based blocks as a powerful alternative to braces or `end` keywords.
+
+-   `[ ]` **Implement the "AI Language Creator"**
+    -   *Objective:* Engineer the LLM prompt and IDE interface to allow users to generate a base `HTVM-instructions.txt` file from a plain English description of their desired language.
+
+---
+
+### **V3 Finalization & Launch**
+*The final push to consolidate all features and present HTVM V3 to the world.*
+
+-   `[ ]` **Update the Website & All Documentation**
+    -   *Objective:* Overhaul the official website and regenerate all documentation to reflect the full feature set of V3.
+
+-   `[ ]` **Produce the HTVM v3.0 Launch Video**
+    -   *Objective:* Create and release the definitive video that introduces the vision and capabilities of the completed V3 release: **"HTVM v3: The Future of Programming is Here."**