Handover: $VQ_WORKDIR for basissetdev on planetx/mars

To: basissetdev chat
From: vq queue chat (via semiempirical chat)
Date: 2026-05-25

TL;DR

Stop writing scratch files into ~/gitlab/vibeqc-*/ on planetx/mars. vq now provides $VQ_WORKDIR — a clean, per-job scratch directory. Use it. The git checkouts are managed by vq admin update; any untracked or modified file blocks the next fleet deploy.

What you get

$VQ_WORKDIR is set in the environment of every vq-dispatched job:

import os
workdir = os.environ["VQ_WORKDIR"]
# Absolute path, exists, empty, owned by you, mode 0700
# Lives outside any git checkout
# Persists for the full job lifetime

Submit patterns

# Single run, auto-cleanup after completion
vq submit basis_opt.py --clean-tmp --tag basisset-opt

# Parallel sweep across N candidate basis sets
vq submit basis_opt.py --array 30 --clean-tmp --tag basisset-sweep
# Each element gets its own jobid → own workdir → own cleanup

# Inspect workdir of a running job
vq status <jobid>

Forbidden list

  • Do NOT write into ~/gitlab/vibeqc-{dev,release,queue}/

  • Do NOT git pull / pip install -e . / make inside them

  • Do NOT touch /etc/vq/ or /opt/vq/

Current state (2026-05-25)

  • vq daemons: v0.7.2 on mars + planetx (workdir mechanism active)

  • vibeqc-dev on fleet hosts: stale (PM6 build-break on main — fix pending in this commit)

  • Basissetdev populate bug: 141 modified .g94 files + deleted vdzp.ecp rescued to fleet branches. Every deploy re-triggers the dirty-tree blocker until populate is decoupled from pip install -e .

Pointers

  • Full protocol: vibe-queue/docs/agent_interaction.md

  • Hardening doc: vibe-queue/docs/v0_7_1_lamports_clock_design.md

  • Bug reports / feature asks → queue chat (submit with --tag pr-request)