Welcome to Nexus! This extension transforms VS Code into a powerful, streamlined Integrated Development Environment (IDE) for the Ingenium core insurance system. It enhances your workflow without altering the core Ingenium source code.
✨ Why Choose Nexus?
Nexus is built on several key pillars to boost your productivity:
⏱️ Lightning-Fast Setup: Get your complete development environment ready in under 5 minutes.
⚡️ Smart & Automated Compilation: Compile all modified files across your workspace with a single command (Ctrl+Shift+B).
🐛 Simplified Debugging: Start debugging Ingenium programs and batch jobs with a single keypress (F5).
🔒 Enhanced Security: Automatically encrypt and protect your sensitive database credentials.
🛠️ Powerful Command-Line Suite:
icomp: An intelligent compiler for Ingenium source code.
irun: A cross-platform tool to run batch jobs, with debugging support, replacing the obsolete ooRexx.
iman: A worker manager with advanced features like auto-scaling and infinite loop detection.
idb: A cross-platform database utility for managing schemas. It can export/import DDL and baseline data, helping to refresh and synchronize databases across environments (ST, AT, PRD).
🏁 Getting Started
Requirements
Windows operating system.
Rocket COBOL (rocketsoftware.rocket-cobol): The extension will prompt you to install this dependency on first launch.
Installation Steps
Install Extension: Search for "Binean Nova" in the VS Code Marketplace and click Install.
Open Project: Open the root folder of your Ingenium source code (File > Open Folder...).
Initialize Workspace: Open the Command Palette (Ctrl+Shift+P) and run the Nova: Initialize Workspace command. This creates the necessary configuration files in a .vscode folder.
⚠️ Note: If you already have a .vscode folder, please back it up before running this command.
Configure Environment: Open the .vscode/settings.json file and update the paths and database information (binean.nova.*, binean.ing.*) to match your local setup.
Generate Environment Script: Open the Command Palette (Ctrl+Shift+P) and run the Nova: Update Configuration command. This will create a "Binean Nova" shortcut on your Desktop.
💻 How to Use
The Golden Rule
💡 IMPORTANT: Always launch VS Code from the "Binean Nova" desktop shortcut and then type the vci command. This ensures VS Code inherits the correctly configured environment, allowing debugging and build features to work properly.
Debugging
Open your COBOL source file and set breakpoints.
Switch to the "Run and Debug" view (Ctrl+Shift+D).
Select the Ingenium: Launch Program configuration from the dropdown and press F5 to start.
Building
Build Current File: With a COBOL file open, press Ctrl+Alt+B.
Build All Modified Files: Press Ctrl+Shift+B to compile all modified programs in your workspace.
🗺️ Project Roadmap
Nexus is an evolving project designed to modernize the Ingenium ecosystem in phases. All enhancements are implemented while ensuring the core system operates continuously without interruption.
Phase 1: Nexus (Current)
Goal: Enhance developer productivity with a modern IDE and a suite of "plug and play" command-line tools that work without altering Ingenium's source code.
Phase 2: Orbit (Upcoming)
Goal: Transition Ingenium towards a service-oriented architecture.
Key Feature: Introduction of ihost, a cross-platform tool that will replace iman and expose Ingenium functionalities as a micro-API service (REST, MIR).
Phase 3: Vision (Future)
Goal: Deliver a superior user experience by modernizing the front-end.
Key Feature: Replace the legacy "Path Finder" with Nova UI, a faster, more responsive interface built with modern web technologies (React/SolidJS).
Phase 4: Apex (Long-term)
Goal: Incrementally re-engineer the core system for future-proof performance and maintainability.
Key Feature: The creation of Nova App, a new core built with high-performance Rust, designed to incrementally replace Ingenium's legacy business logic.
📚 Reference
Available Commands
Nova: Initialize Workspace: Initializes the workspace with default configuration files.
Nova: Update Configuration: Updates the environment script (nova.cmd) and desktop shortcut.
Nova: Build Current File: Compiles the currently active COBOL file.
Nova: Build All: Compiles all modified files in the workspace.
Configuration Settings
Nova
binean.nova.NOVA_INST_DIR: Path to the Nova installation directory. (Default: ~/.nova)
binean.nova.NOVA_DEV_DIR: Path to your development workspace. (Default: ~/dev)
