ui-automation-control-plane

Reference: Cache Governance

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

Retention Tiers

Tier Auto GC Default Description
evidence_keep false Canonical run, release, and audit evidence that should stay out of routine runtime GC unless a higher-level retention policy explicitly says otherwise.
disposable_generated true Generated reports, logs, and QA byproducts that are safe to regenerate and may participate in routine runtime GC.
runtime_state false Stateful runtime ledgers or active execution surfaces that require TTL and active-use validation before cleanup.
scratch true Ephemeral cache, temp, and bridge outputs that may be aggressively cleaned once they are no longer in active use.

Runtime Classes

ID Path Owner Tier Purpose Retention (days) Archiveable Cleanup Scope
logs logs runtime runtime_state structured runtime logs, dev process logs, and CI/test log bundles 7 false logs
artifacts artifacts orchestrator evidence_keep canonical run bundles, CI artifacts, and machine-readable evidence 30 true runs
cache cache runtime scratch repo-level transient cache files and cleanup markers 7 false cache
reports reports qa-platform evidence_keep generated report surfaces that are not promoted into run bundles 14 true extras
temp temp runtime scratch temp-only execution scratch space that can be dropped after each run 1 false extras
dev dev runtime runtime_state dev-up pid files, port markers, and runtime-gc preflight state for the current local stack 7 false extras
metrics metrics runtime runtime_state GC state, RUM summary, and cache lifecycle telemetry 14 true extras
backups backups runtime evidence_keep runtime cache snapshots for rollback and incident preservation 30 true backups
automation automation services/api/universal-platform runtime_state automation sessions, task state, lifecycle state, generated runtime-side data, and transient pytest-created automation leftovers under pytest-* directories 14 true automation
coverage coverage qa-platform disposable_generated canonical coverage artifacts for frontend, apps-web, and backend 7 true extras
container_gates container-gates ci-platform disposable_generated container gate summaries plus run-scoped host bridge metadata; runner-temp/node/python/browser bridge roots must be dropped after successful runs and stale run directories age out after 3 days 3 true extras
container_runs container-runs ci-platform scratch per-run runner-temp bridges for node_modules, pnpm store, python env, and browser state 3 false extras
docs_gate docs-gate docs-governance disposable_generated docs gate logs grouped by run id 7 true extras
lint_all lint-all qa-platform disposable_generated lint-all logs grouped by run id 7 true extras
pytest_cache pytest-cache backend scratch canonical pytest cache relocated under runtime root 7 false extras
test-output test-output qa-platform runtime_state sqlite databases and intermediate state for services/api/integration/frontend nonstub tests 7 false extras
test-results test-results qa-platform disposable_generated Playwright raw result bundles for frontend and harness e2e/ct runs 7 true extras

Machine Cache Must Stay Outside Repo

pnpm store, uv cache, pip cache, Playwright browser download cache

Repo Runtime Outputs

Class Canonical Paths Blocked Root Paths
coverage .runtime-cache/coverage, .runtime-cache/coverage/backend-coverage.xml, .runtime-cache/coverage/apps/command-center/lcov.info, .runtime-cache/coverage/apps-web/lcov.info .coverage, coverage, coverage.xml, htmlcov
mutation .runtime-cache/reports/mutation, .runtime-cache/reports/mutation/latest-summary.json, .runtime-cache/temp/mutation-workspaces/py .mutmut-cache, mutants, stryker.log
e2e .runtime-cache/test-results, .runtime-cache/reports/playwright, .runtime-cache/logs/frontend-e2e test-results, playwright-report
transient_python .runtime-cache/temp, .runtime-cache/pytest-cache ui_automation_control_plane.egg-info, .pytest_cache
gate_logs .runtime-cache/docs-gate, .runtime-cache/lint-all, .runtime-cache/container-gates docs-gate, lint-all, container-gates
automation_runtime .runtime-cache/automation, .runtime-cache/logs/automation automation-runtime
test_state .runtime-cache/test-output test-output

Legacy Published Artifacts

| Path | Status | Reason | | — | — | — |

Cleanup Commands

Cleanup Command Notes

Space Audit Internal Buckets

Bucket Rule Type Selector Reason
safe recursive_dir_name root=services/api, name=__pycache__ Python bytecode cache under service source tree.
safe path path=.runtime-cache/pytest-cache Relocated pytest cache under runtime root.
safe path path=.runtime-cache/container-runs Per-run runner-temp bridges are disposable once a gate succeeds and become TTL cleanup targets after a short-lived diagnostics window.
cautious path path=.runtime-cache/lint-all Generated lint/typecheck logs that are reproducible but still useful during active debugging.
cautious path path=.runtime-cache/coverage Canonical coverage outputs that are reproducible but often inspected during the current verification loop.
cautious path path=.runtime-cache/container-gates Container gate summaries and state breadcrumbs stay available for short-lived diagnosis windows before the 3-day maintenance TTL applies.
verify-first path path=.git/cursor/crepe Non-standard local index payload that looks regenerable but needs producer confirmation before cleanup.
verify-first path path=services/api/mutants Legacy Python mutation workspace residue; source-tree mutants are forbidden steady-state artifacts and must migrate under governed runtime paths.
verify-first path path=.runtime-cache/test-output Intermediate sqlite/test state with runtime-state semantics.
verify-first path path=.runtime-cache/reports Generated report surfaces that may still be referenced by the current verification trail.
verify-first path path=.runtime-cache/automation Runtime-ledger state that needs active-use confirmation before cleanup.
do-not-touch path path=.git/objects Canonical Git object storage, not a disposable runtime cache.

Space Audit External Layers

ID Ownership Bucket Confidence Attributable Bytes Candidate Paths Reason
repo_node_modules_root repo-owned verify-first high true node_modules Repo-local authoritative Node root selected by .npmrc modules-dir; rebuildable via repo-native install and no longer allowed to spill into the parent workspace.
runtime_bridge_node_root workspace-shared verify-first medium false /tmp/uiq-runner/uiq-node-modules Active execution bridge that mirrors shared Node dependencies into runner temp and must stay aligned with shared_dependency_contract.runtime_bridge_root.
uiq_node_modules_fallback workspace-shared do-not-touch medium false ${XDG_CACHE_HOME:-$HOME/.cache}/uiq/node-modules Repo-family fallback Node cache used when no workspace-specific override is exported.
uiq_python_env unknown verify-first medium false ${XDG_CACHE_HOME:-$HOME/.cache}/uiq/python-env Repo-family fallback Python environment that may be shared across related checkouts.
playwright_browser_cache machine-shared do-not-touch high false ${HOME}/Library/Caches/ms-playwright, ${XDG_CACHE_HOME:-$HOME/.cache}/ms-playwright Browser download cache shared by multiple repos and package roots.
uv_cache machine-shared do-not-touch medium false ${XDG_CACHE_HOME:-$HOME/.cache}/uv Machine-level uv cache used by Python bootstrap flows.
corepack_cache machine-shared do-not-touch medium false ${XDG_CACHE_HOME:-$HOME/.cache}/node/corepack Machine-level corepack bootstrap cache.
npm_cacache machine-shared verify-first medium false ${HOME}/.npm/_cacache Shared npm download cache with repo relevance but no single-repo attribution.
docker_cli_config machine-shared do-not-touch high false ${HOME}/.docker Machine Docker CLI config read by containerized repo flows.
docker_desktop_data machine-shared do-not-touch low false ${HOME}/Library/Containers/com.docker.docker Docker Desktop data used by repo flows but not attributable to this repo alone.
uiq_pnpm_virtual_store unknown verify-first low false ${XDG_CACHE_HOME:-$HOME/.cache}/pnpm/uiq-platform-repo UIQ-family pnpm virtual store that may be historical or shared.
This site is open source. Improve this page.