MemRelay/projects/d5a7f581-c442-4554-87b9-ee723b8b0258/curated/development/Metrix – Common Issues & Resolutions.md

title, type, permalink, stable_id, scope, project_id, workspace_type, usage_profile_id, preference_context, document_type, revision, source_memory_ids, source_checkpoint_ids, source_file_ids, source_git_commit, source_git_commits, source_agent_sync_ids, model_connection, model_name, source_count, source_revisions, source_dispositions, cited_source_ids, job_cited_source_ids, conflicts, supersedes, preferences, source_cursor, source_hash, prompt_version, schema_version, curation_job_id, created_at, updated_at, tags, restored_from_commit

title	type	permalink	stable_id	scope	project_id	workspace_type	usage_profile_id	preference_context	document_type	revision	source_memory_ids	source_checkpoint_ids	source_file_ids	source_git_commit	source_git_commits	source_agent_sync_ids	model_connection	model_name	source_count	source_revisions	source_dispositions	cited_source_ids	job_cited_source_ids	conflicts	supersedes	preferences	source_cursor	source_hash	prompt_version	schema_version	curation_job_id	created_at	updated_at	tags	restored_from_commit
Metrix – Common Issues & Resolutions	curated	main/projects/d5a7f581-c442-4554-87b9-ee723b8b0258/curated/development/metrix-common-issues-resolutions	1e1b9a7e-5897-4c82-b267-279a8c54b150	project	d5a7f581-c442-4554-87b9-ee723b8b0258	development	null	development	troubleshooting	1				e660bc7bb4fc5ccda47decb4d514874a148ed9b2	e660bc7bb4fc5ccda47decb4d514874a148ed9b2		Sub2API	git-restore	29		processed unchanged unsupported skipped 29 0 0 0						162	e2fcea7c8a9e0df7a91925fb2a9beabd922058868310effc908f95df2d78b218	2026-08-12.3	3	null	2026-08-19T02:32:30.066112+00:00	2026-09-23T15:09:30.180462+00:00	troubleshooting issues	6a6a895eaf

Troubleshooting Summary (compiled from baseline)

#	Symptom	Cause	Solution
1	Windows directory rename locked (git status “cannot move”)	IDE holds handle on .git	Stop IDE, move .git aside, rename, move back, git submodule sync
2	/health endpoint never returns	Async handler performed blocking I/O	Convert handler to regular def (thread‑pool)
3	Docker exec sessions disconnect after ~3 s	Default socket timeout	After exec_start, call socket.settimeout(None)
4	Missing api_enabled flag → forbidden error	Flag absent in core/config.py	Add api_enabled: bool = True (configurable)
5	Hard‑coded credentials in pypi_mirror.py	Placeholder left in code	Use environment variables or Vaultwarden for secrets
6	create-module.mjs typo (___SNAKE___snapshot)	Template typo	Fix placeholder to correct name
7	pytest.ini points to empty test dir	No tests present	Add test files or update config
8	Generic except Exception: pass in container exec WS	Swallows errors	Replace with logged exception + WebSocket close
9	Permission expansion not applied (resource:* → read)	Expansion logic missing	Ensure expand_permissions runs during seeding
10	Shiki theme not syncing on UI theme change	Shiki instance not updated	Watch appStore.dark, call shiki.setTheme
11	Terminal copy‑paste fails on Windows named pipes	Missing error handling	Add UI toast & fallback to TCP
12	Column‑width reset on reload	Width stored only in localStorage	Persist via /api/user/preferences
13	Duplicate CGI merge strategy undefined	No config option	Add duplicate_cgi_merge setting (`highest
14	Internal PyPI cache grows unbounded	No eviction policy	Background job to delete oldest wheels when limits exceeded
15	Re‑reported missing api_enabled flag (duplicate)	See #4	—

These solutions have been applied where marked ✅ Completed in the task list. Remaining items are tracked in the High‑Priority Open Work Items table (source curated_baseline:13ffa178‑e9cf‑4735‑8da4‑e1d4cf683a52).