Lora Manager Runtime Context

LoRA Manager Runtime Context

Core Rules

• Treat runtime state as local user data. Prefer read-only inspection unless the user explicitly asks for mutation.
• Never print secret-like settings values. Redact keys containing key, token, secret, password, auth, or credential, including civitai_api_key.
• Resolve paths from the runtime configuration before guessing. Settings-directory precedence (highest first):
  1. Explicit override — env LORA_MANAGER_SETTINGS_DIR or standalone --settings-path (also accepted by the inspect script as --settings-path DIR). Pins EVERYTHING (settings.json, cache/, wildcards/, backups/, logs/, stats/) under the given directory; bypasses portable mode and the user config dir. Common when inspecting a sandboxed/E2E instance.
  2. Portable — repository <repo-root>/settings.json with "use_portable_settings": true (or LORA_MANAGER_PORTABLE=1): settings dir = <repo-root>.
  3. Default — ~/.config/ComfyUI-LoRA-Manager on this machine (platformdirs.user_config_dir("ComfyUI-LoRA-Manager", appauthor=False)).
• Use the active library when selecting per-library caches and paths. Read active_library from settings; fall back to default if missing.
• Normalize and expand ~ before comparing paths. Symlinks are common in this repo.

Quick Start

Use the bundled helper for a safe first pass:

python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py summary
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py caches

The script redacts sensitive settings, opens SQLite databases read-only, and reports inaccessible or locked databases as warnings.

For focused checks:

python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py recipes
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py model --path /path/to/model.safetensors
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py sqlite --db /path/to/cache.sqlite --limit 3

To inspect a sandboxed/E2E instance that pins its settings directory:

# --settings-path DIR (or LORA_MANAGER_SETTINGS_DIR) works with every subcommand:
python .agents/skills/lora-manager-runtime-context/scripts/inspect_runtime_context.py \
  --settings-path /tmp/opencode/<plan>-e2e/settings summary

Runtime Path Rules

• Settings directory: resolve via py/utils/settings_paths.py — get_settings_dir() honors the LORA_MANAGER_SETTINGS_DIR / programmatic override first, then portable mode, then platformdirs.user_config_dir("ComfyUI-LoRA-Manager", appauthor=False). The inspect script mirrors this precedence in resolve_settings_path().
• Settings file: <settings_dir>/settings.json.
• Cache root: <settings_dir>/cache.
• Canonical cache files:
  • Model cache: cache/model/<active_library>.sqlite.
  • Recipe cache: cache/recipe/<active_library>.sqlite.
  • Model update cache: cache/model_update/<active_library>.sqlite.
  • Recipe FTS: cache/fts/recipe_fts.sqlite.
  • Tag FTS: cache/fts/tag_fts.sqlite.
  • Symlink map: cache/symlink/symlink_map.json.
  • Download history: cache/download_history/downloaded_versions.sqlite.
  • aria2 state: cache/aria2/downloads.json.
• Legacy cache locations may exist; prefer canonical paths unless diagnosing migrations.

Data Location Rules

• Model roots come from settings.folder_paths and the active library payload under settings.libraries[active_library].
• Model metadata JSON sidecars live next to the model file as <model basename>.metadata.json.
• Recipes root is settings.recipes_path when it is a non-empty string. If empty, use the first configured LoRA root plus /recipes.
• Recipe JSON files are named *.recipe.json under the recipes root and may be nested in folders.
• Example image root is settings.example_images_path.
• If multiple libraries are configured, example images are stored under <example_images_path>/<sanitized_library>/<sha256>/; otherwise they are under <example_images_path>/<sha256>/.

Useful Cache Tables

• Model cache: models, model_tags, hash_index, excluded_models.
• Recipe cache: recipes, cache_metadata.
• Model update cache: model_update_status, model_update_versions.
• Tag FTS cache: tags, fts_metadata, plus FTS internal tables.
• Recipe FTS cache: recipe_rowid, fts_metadata, plus FTS internal tables.
• Download history: downloaded_model_versions.

Prefer querying only counts, schema, and a few sample rows unless the user asks for full output.