Kobez Technical Cheatsheet

Repository map

/home/loca/dev/kobez/
├── kolbez.zip                 read-only received archive
├── kolbez-organized/         deterministic governed library
├── tools/                    standard-library organizer and validator
├── app/                      SvelteKit gallery and deployment files
└── q5vault/                  this wiki source

Runtime contract

LIB_DIR=/home/loca/dev/kobez/kolbez-organized
DATA_DIR=/home/loca/klbz
HOST=127.0.0.1
PORT=51909
KLBZ_AGENT_BIN=/home/loca/.local/bin/omp
KLBZ_MAX_AGENTS=2
KLBZ_TURN_TIMEOUT_MS=300000

klbz.service runs the adapter-node build. klbz.loca.zone proxies to loopback port 51909; the complete gallery is protected by the Authelia klbz.loca.zone one-factor rule.

API routes

• GET /api/manifest — twelve gallery groups plus library and generated assets.
• GET /api/asset/[...path] — contained library/generated file access; ?download=1 forces attachment.
• POST /api/zip — validates up to 200 selected paths and streams kobez-selection.zip.
• GET /api/stream — server-sent chat deltas, completion, errors, heartbeats, and manifest invalidation.
• POST /api/collab — creates a twelve-hex collaboration session.
• GET /api/collab/[id] — returns parsed transcript and turn status.
• POST /api/collab/[id] — appends a request and starts one headless OMP turn.

flowchart LR
  B[Browser] --> M[Manifest]
  B --> F[Contained asset route]
  B --> Z[ZIP stream]
  B --> S[SSE stream]
  B --> C[Collab API]
  C --> O[Headless OMP]
  O --> D[DATA_DIR collab out]
  D --> M

Build and validate

cd /home/loca/dev/kobez
python3 -B tools/organize.py --out /tmp/kolbez-check.tmp
python3 -B tools/validate.py --root kolbez-organized
cd app
npm run check
npm run build

The received kolbez.zip is immutable. Never execute packaged Python, JavaScript, or HTML while validating the archive.

Agent invocation

Each turn starts with this direct invocation and ignored stdin:

spawn(KLBZ_AGENT_BIN, ['-p', '--auto-approve', '@'+briefingPath], {cwd: workspace, stdio: ['ignore','pipe','pipe'], env: {...process.env}})

The briefing confines work to the session workspace. Every visible deliverable belongs in out/.

Collaboration storage

/home/loca/klbz/collab/<12-hex>/
├── session.json
├── chat.md
├── briefing.md
├── asset/
└── out/

---

loca.zone · Kobez Gallery