LegacyExodus
The platform architecture

From structural understanding to governed transformation.

LegacyExodus is building a verification-driven software modernization platform. Today’s deterministic JS/TS foundation turns source structure and program flow into inspectable evidence. Future stages govern code transformation and independent verification.

01 VYRIXSCOUT · VERIFIED 02 NOLARASTRUCT · PARTIAL FOUNDATION 03 ZELVOXFORGE · PLANNED 04 VYMOSGATE · PLANNED
Platform architecture

The four-stage migration pipeline

LegacyExodus is designed as a continuous, four-stage pipeline that advances from raw repository discovery to independently verified target code. We separate what is currently verified from what remains active roadmap architecture.

FOUR-STAGE GOVERNED MIGRATION ARCHITECTURE
Verified Foundation Partial Foundation Target Architecture
STAGE 01 · DISCOVER THE SYSTEM

VyrixScout

IMPLEMENTATION STATUSVERIFIED

Inventory the repository without assumptions. Classify source files, identify workspace boundaries, resolve module topologies, and construct deterministic dependency maps before any code transformation begins.

Inputs

  • Git repository or filesystem tree
  • Package manifests (package.json, lockfiles)
  • Configuration files (tsconfig.json, module resolvers)

Capabilities

  • Deterministic repository inventory
  • Source classification & file typing
  • Module topology & workspace mapping
  • Dependency signal extraction
  • Package & monorepo resolution

Outputs

  • Normalized source inventory and file registry
  • Module topology and dependency adjacency graph
  • Project structure classification and package boundaries
BUSINESS VALUE

Eliminates blind spots. Engineering leaders gain immediate, factual visibility into codebase scale, module coupling, and migration complexity before committing budget.

Explore the system model

Intelligence across the codebase.

Select a topic, inspect its relationships, and see the boundary between the current foundation and future architecture.

INTELLIGENCE EXPLORERJS / TS · SCHEMATIC
DOCUMENTED FOUNDATIONSelect a node to inspect

Source repositoryJavaScript and TypeScript are the current analysis focus. This repository layout is schematic.

Repository intelligence

VyrixScout inventories files and reconstructs modules and dependencies. Discovery establishes the system boundary before deeper analysis.

inventory.json · modules · dependency relationships

The analysis foundation

Documented capabilities in the engineering foundation, with explicit boundaries.

DOCUMENTED IMPLEMENTED · VyrixScout

Repository discovery & dependency intelligence

A repository contains more than its directory tree. Module relationships and resolution rules determine how its parts connect.

Approach
Inventory source files, resolve module references, and reconstruct dependency graphs for JavaScript and TypeScript.
Output
Repository inventory and dependency relationships.
Benefit
An inspectable starting point for understanding boundaries and dependencies.
DOCUMENTED IMPLEMENTED · NolaraStruct

Syntax, scopes & semantic relationships

Text search cannot reliably explain which declaration a name refers to or how a function is called.

Approach
Parse with Babel, normalize ASTs, model scopes and symbols, account for destructuring and hoisting, and reconstruct semantic call graphs.
Output
Normalized syntax, symbol relationships, and call-graph evidence.
Benefit
A more structured view of code relationships than isolated file inspection.
DOCUMENTED IMPLEMENTED · NolaraStruct

Control flow, data flow & taint foundations

Branches and values move across functions. Understanding those paths is necessary before assessing a change.

Approach
Build control-flow and data-flow representations, with documented interprocedural taint-flow foundations.
Output
CFG and DFG relationships, plus scoped taint-flow evidence.
Benefit
A basis for examining potential execution paths and value propagation. Coverage remains bounded by static-analysis assumptions.
DOCUMENTED IMPLEMENTED · Evidence infrastructure

Structured artifacts & reproducible reuse

Understanding is hard to revisit when analysis results are transient or dependent on an unrecorded run.

Approach
Use structured JSON output, streaming serialization, in-memory and SQLite storage providers, snapshot restoration, and deterministic artifact reuse.
Output
Persistable, structured analysis artifacts.
Benefit
Results that can be inspected and reused. Reproducibility does not independently prove semantic correctness.
TARGET ARCHITECTURE · BOUNDED AI

The bounded AI reasoning model

Deterministic evidence defines what is known. AI helps reason about what comes next. Independent verification determines what can be accepted.

We reject the notion that raw LLMs should be given unconstrained read/write access to production codebases. In LegacyExodus, generative reasoning operates within six rigorous governing boundaries:

  1. Versioned Context: The AI gateway receives only immutable, source-grounded graph snapshots produced by NolaraStruct, never speculative or unanchored text prompts.
  2. Structured Inputs & Outputs: All reasoning interchanges use strictly typed JSON schemas with bounded token windows rather than conversational dialogue.
  3. Explicit Evidence References: Every suggested refactor, transformation contract, or risk hypothesis must cite the underlying AST node, CFG edge, or symbol identifier.
  4. Constrained Tool Permissions: Models operate with strictly scoped, read-only graph query tools and isolated execution sandboxes without open network access.
  5. Checkpoints & Gates: Candidate transformations must clear automated structural invariants before reaching compilation or differential test stages.
  6. Human Oversight Authority: The enterprise architect holds final release authority. AI proposes; independent verification tests; engineers approve.

Engineering boundary: vision vs foundation vs roadmap

Platform Vision: An end-to-end governed migration platform that discovers, understands, transforms, and validates complex enterprise codebases across multiple languages.

Available Engineering Foundation: The active, high-performance JavaScript and TypeScript static-analysis CLI. It performs repository inventory (VyrixScout), AST normalization, scope/symbol modeling, semantic call graphs, CFGs, DFGs, and conservative taint facts (NolaraStruct), serializing to streaming JSON, memory, and SQLite.

Roadmap: Automated transformation planning (ZelvoxForge), isolated compiler sandboxing and differential equivalence testing (VymosGate), and language adapters for PHP, Ruby, and Java.

This website does not provide a hosted dashboard or accept proprietary code uploads. Capability status is based on our engineering repository audit as of October 2026.

Read the engineering telemetry and methodology
Planned modernization

Give AI context.
Keep acceptance accountable.

The intended AI gateway supports architecture explanations, risk analysis, transformation strategies, and candidate changes. Source evidence constrains the proposal; verification and human review determine acceptance.

Governed modernizationPLANNED FLOW
  1. 01

    Evidence

    Versioned source context

  2. 02

    Bounded AI

    Typed inputs & limited tools

  3. 03

    Change plan

    Explicit transformation scope

  4. 04

    Candidate

    Proposed target-specific code

  5. 05

    Verification

    Independent checks & results

  6. 06

    Human review

    Approve, revise, or reject

PROPOSALS DO NOT EQUAL PROOF

AI proposes. Independent checks supply evidence. People decide. These future controls require implementation and evaluation.

Long-term direction

Different languages.
Explicit semantic boundaries.

The goal is language-extensible modernization, including cross-language migration where mappings can be established. Additional adapters, intermediate representations, and target generators remain future work.

Language-extensible architectureLONG-TERM VISION
CURRENT FOUNDATION
JSTS

JavaScript / TypeScript

Repository discovery & semantic analysis

EXPLORATORY ECOSYSTEMS
JavaPHPPythonRuby

No shipped adapters or committed sequence.

PLANNED SEMANTIC BRIDGE

Meaning across languages.

Language-aware adapters, structured knowledge & IR, explicit mappings and transformation contracts.

PLANNED

Bounded transformation

Target-specific generation and independent verification.

Rust is an intended target. Other destinations require their own semantic mappings and evidence.

Runtime semanticsTypes & dependenciesErrors & IOState & concurrency
Cross-language migration is a long-term objective. A shared representation alone does not establish language coverage or behavioral equivalence.

Start with understanding.

Follow the engineering, explore the approach, or get in touch.