ui-automation-control-plane

Reference: Runtime Paths

Generated from configs/governance/runtime-paths.yaml. Do not edit this file manually.

• Runtime root: .runtime-cache

Path Contract

Class	Paths
log_roots	.runtime-cache/logs, .runtime-cache/logs/runtime, .runtime-cache/logs/automation, .runtime-cache/logs/test-matrix, .runtime-cache/logs/frontend-e2e, .runtime-cache/logs/ci
artifact_roots	.runtime-cache/artifacts/runs, .runtime-cache/artifacts/ci, .runtime-cache/artifacts/config, .runtime-cache/artifacts/proof-campaigns
report_roots	.runtime-cache/reports, .runtime-cache/reports/playwright, .runtime-cache/reports/mutation
runtime_data_roots	.runtime-cache/automation, .runtime-cache/cache, .runtime-cache/container-runs, .runtime-cache/temp, .runtime-cache/dev, .runtime-cache/metrics, .runtime-cache/coverage, .runtime-cache/container-gates, .runtime-cache/docs-gate, .runtime-cache/lint-all, .runtime-cache/pytest-cache, .runtime-cache/test-output, .runtime-cache/test-results, .runtime-cache/backups

CI Path Contract

• Raw text logs: .runtime-cache/logs/ci
• Structured reports: .runtime-cache/artifacts/ci
• Forbidden legacy paths: .runtime-cache/ci

Forbidden Nested Runtime Roots

tooling/automation/.runtime-cache, tests/frontend-e2e/.runtime-cache, tests/web-harness/tests/e2e/.runtime-cache, tests/web-harness/tests/ct/.runtime-cache

Machine Cache Contract

• Forbidden repo paths: .venv, .runtime-cache/ms-playwright
• External roots: UIQ_NODE_MODULES_DIR, UIQ_PNPM_STORE_DIR, UIQ_PYTHON_ENV_ROOT, UV_CACHE_DIR, PIP_CACHE_DIR, PLAYWRIGHT_BROWSERS_PATH

Shared Dependency Contract

• Authoritative workspace node root: node_modules
• Repo-family fallback node root: ${XDG_CACHE_HOME:-$HOME/.cache}/uiq/node-modules
• Runtime bridge root: /tmp/uiq-runner/uiq-node-modules
• Runtime bridge must not dangle: true

Repo-local node_modules is the authoritative Node root for the current public workspace., Repo-family ~/.cache/uiq/node-modules remains a fallback/shared cache layer, not the primary workspace truth., Runtime bridge roots under .runtime-cache/container-runs/<gate>/<run_id> are scratch surfaces; successful gate runs must clear the current run bridge immediately, and stale run roots age out on the 3-day TTL., Container-gate Docker config staging under .runtime-cache/container-runs/uiq-docker-config is a scratch sidecar and must not outlive the same 3-day maintenance window., Contract tests that temporarily rebind node_modules must restore the repo-local authoritative root before exit so later gates do not inherit a scratch topology.

Drift Contract

• Unmanaged runtime root patterns: .runtime-cache/pnpm-install-safe.*
• Forbidden workspace artifact names: .runtime-cache, mutants

Repo-local install sandboxes under the runtime root are unmanaged drift, not valid steady-state runtime classes., Workspace-local runtime roots and source-tree mutation workspaces must not survive command completion., Transient node-governance-entry concurrency fixtures under .runtime-cache/node-governance-entry-concurrency.* are runtime pollution, not durable runtime classes, and must self-clean on every exit path.

This site is open source. Improve this page.