vh
ddf20abc7e
Adds VOR_WORLDTREE_KEY + VOR_WORLDTREE_BASE + VOR_WORLDTREE_MODEL to vor's compose environment with sane defaults. Empty key falls back to the in-process MockWorldtree (the /mockup/ surface returns canned fixtures); a real key issued by architect routes LLM calls at the demo Saga instance. Key itself lives in ana-docker:/opt/docker/compose/vor/.env (not in the repo).
vor
Inquisitor UI deployed centrally.
A FastAPI sidecar that renders Claude's /inquisitor markdown as a
fillable form — Claude POSTs sessions, user fills + publishes via
browser, Claude reads the response back.
Server: ana-docker
Port: 7879 (configurable via .env)
Upstream repo: vh/vor
Image: vor:local — built on the host from the git repo by the
deploy playbook. Not pulled from a registry.
Centralized vs local
The upstream README describes a local deployment pattern (Claude
on the workstation posts to 127.0.0.1:8765, response file lives on
the local filesystem). Running vor on ana-docker changes that:
- Claude POSTs to
http://10.250.50.70:7879/api/sessions - The browser opens
http://10.250.50.70:7879/?session=<id> - The response markdown is not written to a path Claude can read
off its own disk; Claude reads it back via
GET /api/sessions/{id}(response_markdownfield) instead.
Trade: central + always-on + multi-device (phone, tablet, second workstation) at the cost of a network round-trip and an HTTP-fetch step in Claude's flow instead of a file read.
Deploy
Two paths — automated (preferred) and manual.
Automated (Gitea Actions, push-to-main)
Every push to main on vh/vor triggers a deploy via the central
gitea-runner. Workflow template lives next to this README at
gitea-workflow-deploy.yaml.example;
copy into the vor repo at .gitea/workflows/deploy.yaml (already
done on first wiring). Reuses the DEPLOY_SSH_KEY and
MGMT_REPO_TOKEN secrets at user scope; no per-repo setup needed
once those exist.
Manual (elway from a workstation)
# First deploy / update to latest main
scripts/elway ana-docker --playbook playbooks/deploy-vor.yaml
# Pin to a specific ref
scripts/elway ana-docker --playbook playbooks/deploy-vor.yaml --var ref=v0.2.0
Path layout (on ana-docker)
| Host path | Container path | Purpose | Restic? |
|---|---|---|---|
/opt/docker/build/vor/ |
— | git checkout used as docker build context | excluded |
/opt/docker/compose/vor/ |
— | compose.yaml + .env | included (via /opt/docker) |
/opt/docker/conf/vor/sessions/ |
/app/sessions |
Claude-posted markdown | included |
/opt/docker/conf/vor/responses/ |
/app/responses |
user-published response markdown | included |