3.4 KiB
3.4 KiB
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 |
|
Sub2API | git-restore | 29 |
|
162 | e2fcea7c8a9e0df7a91925fb2a9beabd922058868310effc908f95df2d78b218 | 2026-08-12.3 | 3 | null | 2026-08-19T02:32:30.066112+00:00 | 2026-09-23T15:09:30.180462+00:00 |
|
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).