spec - workspace-index-sync.ts

Referenced by3

Labels3

Idea	Status	Tags	Summary	Katz
index_diagnostics	done		Indexing performance diagnostics: measure and inspect time spent indexing a [indexer.index] base. Timing is persisted in a dedicated diagnostic index under application memory ( [app_memory.index_diagnostics_store] ), not in `ideas-index.sqlite`, so history survives Clear & rebuild. Surfaces: [index_diagnostics_webview]. Owned by `@reqlan/analytical` for recording; the extension hosts the webview.	0.145
index_diagnostics_metrics	done		For each sync / index run on a base, record: - wall-clock sum / total duration of the pass - file count ( visited ), skipped-by-mtime count, indexed ( parse / persist attempted ) count, error count - average path depth of visited files ( segments under the base root ) - per-file duration and outcome ( `mtime_skip` \| `mtime_refresh` \| `hash_skip` \| `persisted` \| `error` ) Runs are attributable to a trigger ( `soft_sync` \| `rebuild` \| `enqueue` \| `stale` ). Instrumentation wraps [workspace_index] soft sync and [indexer.nonblocking_index] single-file paths via [diagnostics_store].	0.120
ownership			The [index] / indexer lives in `packages/analytical` ( `@reqlan/analytical` ). Canonical single-base engine: [workspace_index] ( `WorkspaceIndex` facade ). Sync / idle impl: [workspace_index_sync]; one-file parse + persist: [workspace_index_file]; mtime stale diff: [workspace_mtime]. Multi-base registry: one `WorkspaceIndex` per discovered ["../bases/base.rq".base] under [app_memory_doc.application_memory] ( `<base>/.reqlan/` ). Headless entry: [analysis_runtime] via native-only `openAnalysisApi` ( CLI / MCP ). On-disk store path: [application_memory_impl] under `<base>/.reqlan/` — see [app_memory_doc.application_memory].	0.237

Reference labels

"../../../packages/analytical/src/index-store/workspace-index-sync.ts", ../../../packages/analytical/src/index-store/workspace-index-sync.ts, ../../packages/analytical/src/index-store/workspace-index-sync.ts