Skip to content

runtime_topology.generated.md

Latest commit

 

History

History
83 lines (63 loc) · 3.94 KB

runtime_topology.generated.md

File metadata and controls

83 lines (63 loc) · 3.94 KB
Raw

Runtime Topology Reference

AUTO-GENERATED from ops/compose/docker-compose.yml, contracts/governance/governance.defaults.env, contracts/runtime/filesystem_layout.yaml, pyproject.toml, package.json, .env.example. Do not edit manually. Navigation note: this page is the shared runtime-topology reference for README / docs/usage / docs/architecture, and it is the canonical anchor for executable gates and default entry facts. Public docs use semantic placeholders to avoid over-publishing local workspace layouts. <workspace-root> means a user-chosen persistent workspace directory; <repo-runtime-cache> means the repo-local runtime cache directory.

Compose Services

service ports network_mode command
movi-ci — default —
movi-web-api ${MOVI_WEB_API_PORT:-18080}:18080, ${MOVI_WEBUI_PORT:-5173}:5173 default bash tooling/runtime/run_web_api.sh --host 0.0.0.0 --port 18080
movi-webui — service:movi-web-api bash tooling/runtime/run_webui.sh --host 0.0.0.0 --port 5173

Runtime Paths

key value
GOVERNANCE_PERSISTENT_ARTIFACTS_DIR <workspace-root>/.movi/artifacts
GOVERNANCE_RUNTIME_BUILD_DIR <repo-runtime-cache>/build
GOVERNANCE_RUNTIME_CACHE_ROOT <repo-runtime-cache>
GOVERNANCE_RUNTIME_CI_CONTRACT_DIR <repo-runtime-cache>/ci-contract
GOVERNANCE_RUNTIME_CI_DIR <repo-runtime-cache>/ci
GOVERNANCE_RUNTIME_CODEGEN_DIR <repo-runtime-cache>/codegen
GOVERNANCE_RUNTIME_ENV_FILE <workspace-root>/.movi/env/runtime.env
GOVERNANCE_RUNTIME_LOG_DIR <repo-runtime-cache>/logs
GOVERNANCE_RUNTIME_MUTMUT_CACHE_FILE <repo-runtime-cache>/test/mutation/.mutmut-cache
GOVERNANCE_RUNTIME_TEMP_DIR <repo-runtime-cache>/tmp
GOVERNANCE_RUNTIME_TEST_DIR <repo-runtime-cache>/test
GOVERNANCE_RUNTIME_VENV_DIR ~/.cache/movi-organizer/venv/default
GOVERNANCE_WEBUI_LOCK_HASH_FILE <repo-runtime-cache>/build/apps/webui/.movi_webui_lock_hash

Default Runtime Knobs

key default
GEMINI_MODEL gemini-3-flash-preview

Cleanup Rails

  • repo-local residue: bash tooling/cleanup/prune_repo_runtime.sh Trim checkout-local runtime noise under .
  • machine cache: bash tooling/cleanup/prune_machine_cache.sh --safe, bash tooling/cleanup/prune_machine_cache.sh --rebuildable, bash tooling/cleanup/prune_machine_cache.sh --aggressive-host Governed host-side cache lane; host venv is fallback-only in the container-first model.
  • docker runtime: bash tooling/cleanup/prune_docker_runtime.sh --dry-run, bash tooling/cleanup/prune_docker_runtime.sh --rebuildable, bash tooling/cleanup/prune_docker_runtime.sh --aggressive Canonical runtime rail backed by the current Docker image, named volumes, and repo-related build cache.
  • destructive workspace reset: bash tooling/runtime/runtime_reset.sh --confirm-workspace-reset Clears workspace .movi state; not a routine cache cleanup command.

Container-First Defaults

  • Canonical Docker image: movi-ci:local
  • Protected Docker volumes: movi-web-stack_movi_playwright, movi-web-stack_movi_venv
  • Optional Docker volumes: movi-web-stack_movi_webui_node_modules
  • Shared-related surface: docker build cache

Entrypoints

Python entrypoints

  • movi-organizer -> apps.cli.movi_organizer:main
  • movi-web-api -> apps.api.server:main
  • movi-mcp -> apps.mcp.server:main

Package smoke required entrypoints

  • movi-organizer
  • movi-web-api
  • movi-mcp

Workspace scripts

  • dev:stack -> bash tooling/runtime/run_web_stack.sh --mode local
  • dev:stack:compose -> bash tooling/runtime/run_web_stack.sh --mode compose
  • build -> bash tooling/runtime/run_webui_task.sh build

WebUI scripts

  • dev -> vite
  • build -> tsc -b && vite build
  • test -> vitest run
  • lint -> eslint . --max-warnings=0