- add ProjectIndexer service that performs asyncio-backed scans and stores metadata in SQLite\n- introduce domain models for project index snapshots and register service exports\n- cover async scanning, incremental refresh, and exclusion patterns via Behave scenarios\n\nISSUES CLOSED: #5237

@@ -0,0 +1,37 @@
+Feature: Project indexer

@@ -0,0 +12,4 @@
+
+
+@given("a temporary project directory with files:")
+def step_create_temp_project(context) -> None:

@@ -0,0 +26,4 @@
+    ProjectIndexMetadata,
+    ProjectIndexSnapshot,
+)
+from cleveragents.domain.models.core.repo_index import IndexStatus

@@ -0,0 +87,4 @@
+    records: dict[str, _FileStat] = {}
+    for path, size, mtime, content_hash in cursor.fetchall():
+        records[path] = _FileStat(
+            absolute_path=Path(path),

@@ -0,0 +19,4 @@
+
+from pydantic import BaseModel, ConfigDict, Field, ValidationInfo, field_validator
+
+from cleveragents.domain.models.core.repo_index import IndexStatus

@@ -0,0 +12,4 @@
+
+
+@given("a temporary project directory with files:")
+def step_create_temp_project(context) -> None:

@@ -0,0 +30,4 @@
+
+from cleveragents.application.services.project_indexer_persistence import (
+    ProjectIndexStore,
+    _FileStat,

@@ -0,0 +87,4 @@
+    records: dict[str, _FileStat] = {}
+    for path, size, mtime, content_hash in cursor.fetchall():
+        records[path] = _FileStat(
+            absolute_path=Path(path),

@@ -0,0 +19,4 @@
+
+from pydantic import BaseModel, ConfigDict, Field, ValidationInfo, field_validator
+
+from cleveragents.domain.models.core.repo_index import IndexStatus

@@ -0,0 +12,4 @@
+
+
+@given("a temporary project directory with files:")
+def step_create_temp_project(context) -> None:

@@ -0,0 +30,4 @@
+
+from cleveragents.application.services.project_indexer_persistence import (
+    ProjectIndexStore,
+    _FileStat,

@@ -0,0 +26,4 @@
+    ProjectIndexMetadata,
+    ProjectIndexSnapshot,
+)
+from cleveragents.domain.models.core.repo_index import IndexStatus

@@ -0,0 +87,4 @@
+    records: dict[str, _FileStat] = {}
+    for path, size, mtime, content_hash in cursor.fetchall():
+        records[path] = _FileStat(
+            absolute_path=Path(path),

@@ -0,0 +19,4 @@
+
+from pydantic import BaseModel, ConfigDict, Field, ValidationInfo, field_validator
+
+from cleveragents.domain.models.core.repo_index import IndexStatus

@@ -0,0 +62,4 @@
+        """Prevent absolute or parent-relative paths."""
+
+        # ``PurePosixPath`` normalises separators without touching drive letters.
+        from pathlib import PurePosixPath

@@ -0,0 +12,4 @@
+
+
+@given("a temporary project directory with files:")
+def step_create_temp_project(context) -> None:

@@ -0,0 +26,4 @@
+    ProjectIndexMetadata,
+    ProjectIndexSnapshot,
+)
+from cleveragents.domain.models.core.repo_index import IndexStatus

@@ -0,0 +79,4 @@
+    )
+
+
+def load_existing_stats(conn: sqlite3.Connection) -> dict[str, _FileStat]:

@@ -0,0 +19,4 @@
+
+from pydantic import BaseModel, ConfigDict, Field, ValidationInfo, field_validator
+
+from cleveragents.domain.models.core.repo_index import IndexStatus

@@ -0,0 +12,4 @@
+
+
+@given("a temporary project directory with files:")
+def step_create_temp_project(context) -> None:

@@ -0,0 +26,4 @@
+    ProjectIndexMetadata,
+    ProjectIndexSnapshot,
+)
+from cleveragents.domain.models.core.repo_index import IndexStatus

@@ -0,0 +87,4 @@
+    records: dict[str, _FileStat] = {}
+    for path, size, mtime, content_hash in cursor.fetchall():
+        records[path] = _FileStat(
+            absolute_path=Path(path),

@@ -0,0 +19,4 @@
+
+from pydantic import BaseModel, ConfigDict, Field, ValidationInfo, field_validator
+
+from cleveragents.domain.models.core.repo_index import IndexStatus