# Agrarian Self-Hosted AI Development Stack

This stack is meant to reduce pressure on Codex over time, not replace it
immediately. The first production target is supervised local assistance:
repository awareness, documentation, small safe edits, tests/builds, and clear
Codex escalation when local tooling is over its head.

## Current Services

- Gitea:
  `http://192.168.5.21:3000/nathan/agrarian-game.git`
- Ollama:
  `http://192.168.5.23:11434`
- Open WebUI:
  `http://192.168.5.26:8085`
- Local AI worker VM:
  `LinaAI / 192.168.5.27`
- Primary Unreal/Linux development VM:
  `unreal-engine / 192.168.5.20`

## Current Local Model

- `qwen2.5-coder:7b`
- Role:
  repo summaries, documentation, small patch suggestions, test generation,
  straightforward scripts, and structured handoff preparation.
- Not the role:
  broad Unreal architecture changes, risky save/multiplayer/economy rewrites,
  security-sensitive code, or autonomous merges.

## Operating Model

1. Local AI gathers context and proposes small changes.
2. Work happens on a branch, not directly on `main`.
3. The agent reports risk, files inspected, commands run, and confidence.
4. Tests/builds decide whether a change is acceptable.
5. After two failed local attempts, stop and escalate.
6. Codex escalation uses the npm Codex CLI, not the API.
7. Human review controls merges.

## Codex Escalation

Use `Scripts/ai_codex_escalate.sh` with a completed task status file. The
script prefers a locally installed `codex` command and falls back to
`npx -y @openai/codex exec`.

On `LinaAI`, the npm Codex CLI is installed, but it still needs an authenticated
Codex login before cloud escalation can run:

```bash
ssh nathan@192.168.5.27
codex login
```

Codex should be called for:

- confidence below `0.65`,
- two failed build/test attempts,
- Unreal compile errors that persist,
- tasks touching save systems, multiplayer, auth, payments, AGR wallet
  integration, marketplace logic, migrations, or core architecture,
- patches that grow beyond the intended small scope,
- contradictions between local model output and official/project docs.

## VM Boundaries

- `LinaAI` owns local AI coding tools, Aider, Codex CLI escalation wrappers,
  repo indexing, documentation generation, and small supervised branch work.
- `unreal-engine` owns Unreal Engine source, editor builds, commandlets, and
  game compile/package verification.
- Keep these roles separated so AI tooling experiments do not destabilize the
  Unreal build host.

## Immediate Next Work

- Verify Open WebUI model selection uses the Ollama backend at
  `http://192.168.5.23:11434`.
- Use Aider from `LinaAI`, not from `unreal-engine`.
- Authenticate the npm Codex CLI on `LinaAI` so escalation can run from the AI
  worker VM.
- Build project memory inside this repo under `Docs/` rather than creating a
  separate documentation repository.
- Add small local-agent tasks first: summarize systems, write docs, generate
  tests, inspect logs, and prepare Codex handoffs.