vh
9703eb2b6b
Worldtree Conversation API debug TUI. Multi-pane observability dashboard: chat transcript + persona/Vili affect log + tool events + admin events + Bifrost state + tool inventory + (opt-in) raw server log. Design locked at docs/design-brief.md (originated as brokkr-smithy/docs/ratatoskr-design-brief.md). Operator-locked decisions: - Textual application-shell framework (multi-pane dashboard, not REPL). - Separate repo + separate dev team (no Worldtree-source imports). - httpx-sse for SSE consumption (reference Python SSE-resume impl). - Triple version-skew mitigation: spec-pin in pyproject.toml + recorded SSE snapshot tests + conformance smoke. Initial pin: Worldtree v0.19.0 at 55101e909abcd2219833266b6f905c5bc956e0f0. - Persona pane: label-don't-refuse PII posture. - Server-log pane: opt-in via --server-log <path>. - Two-stage Ctrl-C (cancel then exit). - Markdown rendering default-on; --raw opt-out. In the box: - docs/design-brief.md — the locked design with full rationale. - docs/SPEC-PIN.md — Worldtree spec pin + bump procedure. - docs/conversation-api-spec.md + docs/conversation_api.contract.md — vendored Worldtree spec snapshots at the pinned SHA. - pyproject.toml — Python 3.12, hatchling, uv-managed, deps locked. - src/ratatoskr/ — stub package (cli.py raises NotImplementedError). - tests/test_no_worldtree_imports.py — boundary smoke test PASSING. - tests/snapshots/README.md — recording convention for SSE snapshot tests. Not in the box yet: - Gitea remote (operator/infra-ops to register at vh/ratatoskr). - Implementation — the dev team owns this; design brief is the spec. Origin: althing thread 01KS3R34XD3N6HMK91VXESHGW7 (worldtree-dev → brokkr-smithy-dev, 2026-05-20). Volva consulted via thread 01KS3VF6W33N3V5FNMGQ91YNVD.
25 lines
801 B
Plaintext
25 lines
801 B
Plaintext
# ratatoskr — environment variables template.
|
|
# Copy to env.sh (gitignored) and fill in real values; source before running.
|
|
#
|
|
# cp env.sh.template env.sh
|
|
# $EDITOR env.sh
|
|
# source .venv/bin/activate && source env.sh
|
|
|
|
# Project root — auto-detected from this script's location
|
|
export {{PROJECT_NAME_UPPER}}_ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
|
|
# Gitea (when issue tracking lands)
|
|
# export GITEA_URL="https://gitea.phasefinal.com"
|
|
# export GITEA_OWNER="vh"
|
|
# export GITEA_REPO="ratatoskr"
|
|
# export GITEA_TOKEN="<personal-access-token>"
|
|
|
|
# LLM provider keys (when relevant)
|
|
# export ANTHROPIC_API_KEY=""
|
|
# export OPENAI_API_KEY=""
|
|
# export Z_AI_API_KEY=""
|
|
|
|
# Task-board (when relevant)
|
|
# export TASK_BOARD_URL="http://10.250.50.70:7878"
|
|
# export TASK_BOARD_SESSION="ratatoskr"
|