Package org.ek9lang.mcp.oracle

package org.ek9lang.mcp.oracle
Oracle Contextual Query Interface for the EK9 compiler.

Provides structured semantic queries over compiled EK9 programs, enabling AI agents to ask the compiler for authoritative information about symbols, scopes, constructs, and execution flow at any source location.

The Oracle exposes information the compiler already computes during Phases 0-10. No new analysis is required — this is a view layer over existing compiler internals.

Query levels:

  • Level 0 (Symbol): Type, state, mutability, available operations
  • Level 1 (Scope): Visible symbols, active guards, purity constraints
  • Level 2 (Flow): Execution paths, complexity, data flow (requires IR)
  • Level 3 (Construct): Fields, methods, operators, inheritance
  • Level 4 (Module): Exports, imports, dependency graph