Visual ADM Generator (The Context Wrangler)

A VS Code extension that turns highlighted code or markdown into a validated Aggregated Domain Model (ADM) — the source of truth for the Virgo deterministic compiler.

Foundation LLM: GitHub Copilot (default)

Out of the box the extension uses your signed-in GitHub Copilot session via VS Code's built-in Language Model API (vscode.lm). No API key, no setup — auth and consent are handled by VS Code, and the extension never touches a token.

BYOK fallback (OpenAI / Anthropic) is available for users without Copilot. Keys are stored in the OS keychain via SecretStorage, never in plaintext.

Capabilities

Command	Description	Status
`Visual ADM: Generate from Selection`	Highlight text → LLM → write `VISUAL_ADM.md`	✅ Step 1
`Visual ADM: Select LLM Provider`	Switch between Copilot / OpenAI / Anthropic	✅ Step 1
`Visual ADM: Show Domain Graph`	Interactive Mermaid webview sidecar (live-updating)	✅ Step 2
`Visual ADM: Sync Code to ADM`	Deterministic AST/code parse (TS/JS + Java) → ADM	✅ Step 2
`Visual ADM: Validate Invariants`	Deterministic AST + schema linter (boundary / drift / encapsulation)	✅ Step 3
`Visual ADM: Deep Rule Audit`	On-demand LLM semantic BDD verification (Copilot / BYOK)	✅ Step 3
`Visual ADM: Compile to Spring Boot Engine`	One-click `POST /spout/compile` upsell hook	✅ Step 3
`Visual ADM: Configure API Key`	Store a BYOK key (OpenAI/Anthropic only)	✅ Step 1

Setup

Run npm install
Press F5 to launch an Extension Development Host
(Optional) Run Visual ADM: Configure API Key if you'd rather use BYOK
Highlight some code, then run Visual ADM: Generate from Selection

Configuration

visualAdm.llmProvider — copilot (default) | openai | anthropic
visualAdm.llmModel — optional model/family override (e.g. gpt-4o, claude-sonnet-4-6). Empty = auto-select.
visualAdm.spoutApiUrl — Simway Spout API base URL for Compile to Spring Boot Engine (Step 3).

Development

npm install
npm run compile    # type-check + build to dist/

The strict schema lives in Virgo_ADM_Schema.json (mirrored in src/adm/schema.ts).

Visual ADM Generator