Replaces the broken-script-generated imports in src/ and tests/ with
clean direct imports from the destination modules. Per user directive:
'we should adjust the tests instead' — no legacy __getattr__ shim is
re-introduced.
Key fixes:
- src/mcp_client.py: remove self-import (MCPServerConfig etc. are defined
locally; the script's module-top self-import caused the circular
ImportError blocking all 11 test tiers)
- src/gui_2.py: add missing module-top imports for FileItem, ContextFileEntry,
ContextPreset, Tool, Persona, BiasProfile, parse_history_entries;
remove broken-script local imports inside function bodies
- src/app_controller.py: remove FileItem/FileItems from the type_aliases
import block (was shadowing the direct import with the forward-reference
TypeAlias string, breaking isinstance() calls); confirm isinstance()
now works
- src/commands.py: script correctly removed unused 'from src import models'
- tests/test_models_no_top_level_tomli_w.py: import save_config_to_disk
from src.project (no legacy shim back in models.py)
- tests/test_rag_engine_ready_status_bug.py: import RAGConfig and
VectorStoreConfig from src.mcp_client
- tests/test_gui_2_result.py: patch src.gui_2.Persona/BiasProfile
(gui_2 binds at module load; src.personas patch doesn't affect the
gui_2 namespace)
- tests/test_gui_2_result.py: patch src.gui_2.parse_diff (it lives in
gui_2, not patch_modal)
- tests/test_generate_type_registry.py: Metadata is now a dataclass in
src_type_aliases.md (not a TypeAlias in type_aliases.md); src_models.md
is no longer generated (src/models.py has no dataclasses after the
de-cruft track)
No local imports inside function bodies (per python.md §17.9a). All
new imports are at module top with surgical edits.
Per post_module_taxonomy_de_cruft_20260627 Phase 2 (FR7 continued).
The previous migration commit (8f11340b) handled the
'from src.models import X' pattern (85 sites). This commit handles
the 'models.<moved_class>' attribute access pattern (44 sites in 20
files), which the __getattr__ shim previously supported.
The migration was performed by the one-time script
scripts/tier2/artifacts/post_module_taxonomy_de_cruft_20260627/migrate_models_attr.py
which:
1. For each 'models.<moved_class>' reference, replaces it with the
bare class name (e.g., 'models.MCPConfiguration' -> 'MCPConfiguration')
2. Adds the import 'from src.<destination> import <moved_class>' at
the top of the file (deduplicated if the import already exists)
3. Skips moved classes that the file already imports directly
The migration script inserts the import after the 'from __future__
import annotations' line if present; otherwise it adds the import
to the destination module's existing import block. Two files
required manual fixes because the script's regex didn't handle them:
- src/rag_engine.py: uses 'from src import models' (not 'from
src.models import X'); the class is accessed
via 'models.RAGConfig'. Replaced with a
direct 'from src.mcp_client import RAGConfig'
import and removed the 'from src import models'.
- tests/test_project_context_20260627.py: uses the parens-style
multi-line 'from src.models import (X, Y, Z)'.
Replaced with the parens-style direct import.
After this commit:
- 'models.MCPConfiguration', 'models.FileItem', 'models.Ticket', etc.
no longer work in src/ and tests/ (the AttributeError raises
because models.py no longer has the __getattr__ entries for
moved classes)
- All consumer files have direct imports of the moved classes
Total: 44 'models.<moved_class>' references rewritten across 20 files.
The bug: when the local embedding provider fails to initialize
(e.g. sentence-transformers not installed), RAGEngine.__init__
leaves self.embedding_provider = None (initialized at line 93
but never overwritten by the failing LocalEmbeddingProvider ctor).
The constructor returns. _sync_rag_engine's else branch then
sets status to 'ready' - a lie. The RAG panel shows 'ready'.
The user triggers a retrieval. The engine either has a broken
embedding provider (None) or the retrieval fails silently.
The RAG context never appears in the AI's history.
The fix: in _sync_rag_engine's _task, after RAGEngine(...)
returns, check if engine.embedding_provider is None. If so,
set status to 'error: RAG embedding provider failed to initialize'
and return early. This prevents:
- The engine from being assigned to self.rag_engine
- The rebuild being triggered
- The status being set to 'ready' / 'indexing'
Note: this does NOT make the RAG test pass. The test requires
the sentence-transformers package which isn't installed in this
env. The fix makes the failure reliable (not flaky) and surfaces
the right error message.
TDD: 3 tests added in tests/test_rag_engine_ready_status_bug.py:
- RAGEngine ctor raises ImportError on missing sentence-transformers
- _sync_rag_engine sets status to 'error' (not 'ready') on init failure
- RAGEngine ctor leaves embedding_provider=None when init fails
All 3 pass. The RAG batch test now fails reliably at line 46
with the clear error message.
ed