archive/README.md

# Live Visualizer

A custom live modeling environment for LLM-assisted geometry workflows.

## Core idea

This project is for a modeling tool that combines:
- live model viewing
- editable variables and code
- terminal/log feedback
- LLM-assisted model generation and editing
- multiple visual modes from the same scene state

## Position on build123d

`build123d` should be treated as an important geometry backend, but not baked so deeply into the app that the entire product becomes impossible to evolve.

So the architecture should be:
- custom app shell
- custom scene/state/visualization pipeline
- pluggable geometry adapters
- build123d as the first and best-supported adapter

That keeps the project flexible while still embracing the current best geometry engine for this workflow.

## Initial product shape

Three-pane interface:
- editor / prompt / parameter control
- live viewport
- terminal / logs / agent output

## Near-term goals

1. Create a custom app shell
2. Support build123d as the first geometry adapter
3. Enable live regeneration from script or parameter changes
4. Separate display modes:
   - viewport shaded
   - graphic mass
   - technical/vector
5. Define LLM integration layer:
   - OpenClaw-driven
   - provider-agnostic fallback

## Proposed repo layout

- `apps/viewer` - main app shell
- `packages/core` - scene graph, document model, orchestration types
- `packages/renderer` - viewport and render mode logic
- `packages/llm` - LLM session/provider integration
- `packages/session` - terminal/process/runtime session management
- `packages/ui` - reusable interface components
- `examples/build123d` - test scripts and adapter examples

## Principles

- model first, render second
- one source of geometric truth
- multiple display modes from the same scene
- user can steer with language, numbers, and code
- terminal remains a first-class part of the workflow