Kevin Veen-BirkenbachandClaude Opus 5.5
8ba45efd04
The kvb-hub is a local review hub in a container bound to 127.0.0.1: one page, JSON APIs and an MCP endpoint for the operator's inbox, asks, decisions, staged-commit reviews, the radio stream, the agent graph, the worktree tree, push-to-talk and read-aloud radio (Piper, whisper.cpp) and an optional LLM command line. The hub is only a relay. The host executors in hub/client (the runner user service, the PermissionRequest hook and the approval CLI the commit skills call) verify a WebAuthn passkey signature against keys pinned outside every sandbox, refuse replays and fail closed. scripts/hub.sh with make hub-install, hub-check, hub-pin, hub-runner and hub-hook installs and checks the hub; hub-hook writes ~/.claude/settings.json after a backup. make watch-check shows a stuck watch hook. The new kvb-git-diff skill and the commit skills route reviews through the hub; the test_hub_* suites replace test_hub.py. Security review (kvb-think-criticize, three skeptics) fixed four holes: signed rules auto-approved chained shell commands; the client and LLM openers followed redirects, the LLM one with its bearer key; the worktree scan ran git fsmonitor and filter commands from agent-writable repos; compose set no memory, pids or health limits. Documented until core requirement 093, on the operator's word: the hub page is trusted while signing and pinning, local processes can forge the unsigned operator actions, and the container reads the host /tmp. Committed on the operator's word despite the gate: the passkey path is not yet verified live. Accepted MEDUSA false positives (137 findings on 115 lines, rows in security-accepted.jsonl): EXA002 x17, MEDUSA-MM-SCAN-058 x12, B603 x8, MEDUSA-FTSC-SCAN-089 x7, MEDUSA-PRIV-SCAN-762 x6, AIC-EXFIL-005 x5, EXA006 x5, MEDUSA-FTSCAN-231 x5, WEB-SSRF x5, MEDUSA-INF-SCAN-2057 x3, RH005 x3, TC001 x3, LO002 x2, MEDUSA-AEXP-SCAN-096 x2, MEDUSA-CGS-SCAN-028 x2, MEDUSA-INF-SCAN-1350 x2, MEDUSA-INF-SCAN-2369 x2, MEDUSA-INF-SCAN-2440 x2, MEDUSA-INF-SCAN-2638 x2, MLSC-SERIAL-002 x2, PL002 x2, PQC005 x2, SAST-PATH-001 x2, TC004 x2, TC005 x2, TC006 x2, TC007 x2, AA-146, EXA007, FINE-050, GB-ENCODE-001, GB-ENCODE-003, MEDUSA-CGS-SCAN-029, MEDUSA-CGS-SCAN-103, MEDUSA-DP-SCAN-1034, MEDUSA-DP-SCAN-1916, MEDUSA-DP-SCAN-954, MEDUSA-EXF26-TOOL-004, MEDUSA-FT-TRIGGER-005, MEDUSA-INF-SCAN-2206, MEDUSA-INF-SCAN-2457, MEDUSA-INF-WEB-003, MEDUSA-INFRA-SCAN-030, MEDUSA-MP-SCAN-1135, MEDUSA-RLHF-POISON-002, MEDUSA-RT-SCAN-006, MM-ENCODE-001, MP-124, PQC001, PQC002, PQC006, RP001, TC009, TC010, WEB-FLASK-004. 🎯 Fix: 80 % 💥 Break: 4 % 💸 Cost: 129 % ⏱️ Time: – 🛡️ Security: 100 % 💰 Value: ? 🏆 Score: 60 🚦 Gate: ⛔ fix 80 % < 90; cost 129 % > 100: ask the operator before the commit ``` /home/kevinveenbirkenbach/Repositories/github.com/kevinveenbirkenbach/skills/.worktrees/feature/kvb-hub ``` Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
133 lines
3.8 KiB
YAML
133 lines
3.8 KiB
YAML
name: kvb-hub
|
|
|
|
services:
|
|
hub:
|
|
build: .
|
|
image: kvb-hub:local
|
|
restart: unless-stopped
|
|
init: true
|
|
user: "${KVB_HUB_USER:?written into .env by scripts/install.sh}"
|
|
read_only: true
|
|
cap_drop:
|
|
- ALL
|
|
security_opt:
|
|
- no-new-privileges:true
|
|
mem_limit: 2g
|
|
pids_limit: 256
|
|
healthcheck:
|
|
test: ["CMD", "python3", "-c", "import socket; socket.create_connection(('127.0.0.1', 8080), 2).close()"]
|
|
interval: 30s
|
|
timeout: 5s
|
|
retries: 3
|
|
ports:
|
|
- "127.0.0.1:${KVB_HUB_PORT:?set in .env}:8080"
|
|
extra_hosts:
|
|
- "host.docker.internal:host-gateway"
|
|
command:
|
|
- --bind
|
|
- 0.0.0.0
|
|
- --listen-port
|
|
- "8080"
|
|
- --public-port
|
|
- "${KVB_HUB_PORT:?set in .env}"
|
|
- --council
|
|
- /tmp/agents-council
|
|
- --pages
|
|
- /tmp/kvb-git-diff
|
|
- --state
|
|
- /state
|
|
- --host-state
|
|
- "${KVB_HUB_STATE:?written into .env by scripts/install.sh}"
|
|
- --skills
|
|
- /skills
|
|
- --transcripts
|
|
- /projects
|
|
- --templates
|
|
- /app/templates
|
|
- --repos
|
|
- "${KVB_HUB_REPOS:?written into .env by scripts/install.sh}"
|
|
- --worktrees
|
|
- "${KVB_HUB_WORKTREES:?written into .env by scripts/install.sh}"
|
|
- --timers
|
|
- /timers
|
|
- --llm-url
|
|
- "${KVB_HUB_LLM_URL}"
|
|
- --llm-model
|
|
- "${KVB_HUB_LLM_MODEL}"
|
|
- --llm-key-file
|
|
- /run/kvb-hub/llm.key
|
|
- --piper
|
|
- /opt/piper/bin/piper
|
|
- --voices
|
|
- /opt/voices
|
|
- --operator-voice
|
|
- "${KVB_HUB_OPERATOR_VOICE:?set in .env}"
|
|
- --whisper
|
|
- /opt/whisper/whisper-cli
|
|
- --whisper-model
|
|
- /opt/whisper/ggml-base-q8_0.bin
|
|
- --scratch
|
|
- /scratch
|
|
- --approvers
|
|
- /approvers/approvers.json
|
|
tmpfs:
|
|
- /scratch:size=64m,mode=1777,noexec,nosuid,nodev
|
|
volumes:
|
|
- type: bind
|
|
source: /tmp
|
|
target: /tmp
|
|
read_only: true
|
|
- type: bind
|
|
source: "${KVB_HUB_COUNCIL:?written into .env by scripts/install.sh}"
|
|
target: /tmp/agents-council
|
|
bind:
|
|
create_host_path: false
|
|
- type: bind
|
|
source: "${KVB_HUB_SKILLS:?written into .env by scripts/install.sh}"
|
|
target: /skills
|
|
read_only: true
|
|
bind:
|
|
create_host_path: false
|
|
- type: bind
|
|
source: "${KVB_HUB_PROJECTS:?written into .env by scripts/install.sh}"
|
|
target: /projects
|
|
read_only: true
|
|
bind:
|
|
create_host_path: false
|
|
- type: bind
|
|
source: "${KVB_HUB_STATE:?written into .env by scripts/install.sh}"
|
|
target: /state
|
|
bind:
|
|
create_host_path: false
|
|
- type: bind
|
|
source: "${KVB_HUB_REPOS:?written into .env by scripts/install.sh}"
|
|
target: "${KVB_HUB_REPOS:?written into .env by scripts/install.sh}"
|
|
read_only: true
|
|
bind:
|
|
create_host_path: false
|
|
- type: bind
|
|
source: "${KVB_HUB_WORKTREES:?written into .env by scripts/install.sh}"
|
|
target: "${KVB_HUB_WORKTREES:?written into .env by scripts/install.sh}"
|
|
read_only: true
|
|
bind:
|
|
create_host_path: false
|
|
- type: bind
|
|
source: "${KVB_HUB_TIMERS:?written into .env by scripts/install.sh}"
|
|
target: /timers
|
|
read_only: true
|
|
bind:
|
|
create_host_path: false
|
|
- type: bind
|
|
source: "${KVB_HUB_APPROVERS:?written into .env by scripts/install.sh}"
|
|
target: /approvers
|
|
read_only: true
|
|
bind:
|
|
create_host_path: false
|
|
- type: bind
|
|
# /dev/null is an empty key file, which server.py --llm-key-file reads as no key
|
|
source: "${KVB_HUB_LLM_KEY_FILE:-/dev/null}"
|
|
target: /run/kvb-hub/llm.key
|
|
read_only: true
|
|
bind:
|
|
create_host_path: false
|