spec - index_diagnostics

Summary

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.ts soft sync and nonblocking_index single-file paths via index-diagnostics-store.ts.

Jump to outbound references

Jump to inbound references

Key	Value
implementation	index-diagnostics-store.ts, workspace-index-file.ts, workspace-index-sync.ts, workspace-index.ts
status	done
tests	index-diagnostics.test.ts

Key

Value

implementation

index-diagnostics-store.ts, workspace-index-file.ts, workspace-index-sync.ts, workspace-index.ts

status

done

tests

index-diagnostics.test.ts

Kind	Idea	Path	Snippet
file_reference	../../../packages/analytical/src/index-store/workspace-index.ts	packages/analytical/src/index-store/workspace-index.ts	workspace-index.ts
references	nonblocking_index	reqlan rq/indexer/indexer.rq	nonblocking_index
file_reference	../../../packages/analytical/src/index-store/index-diagnostics-store.ts	packages/analytical/src/index-store/index-diagnostics-store.ts	index-diagnostics-store.ts
file_reference	"../../../packages/analytical/src/index-store/workspace-index-file.ts"	packages/analytical/src/index-store/workspace-index-file.ts	workspace-index-file.ts
file_reference	"../../../packages/analytical/src/index-store/workspace-index-sync.ts"	packages/analytical/src/index-store/workspace-index-sync.ts	workspace-index-sync.ts
file_reference	"../../../packages/analytical/test/index-diagnostics.test.ts"	packages/analytical/test/index-diagnostics.test.ts	index-diagnostics.test.ts
comment_link	index_diagnostics_metrics	reqlan rq/extension/index-host/packages/analytical/src/index-store/index-diagnostics-store.ts	* rq:index_diagnostics_metrics
comment_link	index_diagnostics_metrics	reqlan rq/extension/index-host/packages/analytical/src/index-store/workspace-index-file.ts	* rq:index_diagnostics_metrics
comment_link	index_diagnostics_metrics	reqlan rq/extension/index-host/packages/analytical/src/index-store/workspace-index-sync.ts	* rq:index_diagnostics_metrics
comment_link	index_diagnostics_metrics	reqlan rq/extension/index-host/packages/analytical/src/index-store/workspace-index.ts	* rq:index_diagnostics_metrics
comment_link	index_diagnostics_metrics	reqlan rq/extension/index-host/packages/analytical/test/index-diagnostics.test.ts	* rq:index_diagnostics_metrics

Kind

Idea

Path

Snippet

file_reference

../../../packages/analytical/src/index-store/workspace-index.ts

packages/analytical/src/index-store/workspace-index.ts

workspace-index.ts

references

nonblocking_index

reqlan rq/indexer/indexer.rq

nonblocking_index

file_reference

../../../packages/analytical/src/index-store/index-diagnostics-store.ts

packages/analytical/src/index-store/index-diagnostics-store.ts

index-diagnostics-store.ts

file_reference

"../../../packages/analytical/src/index-store/workspace-index-file.ts"

packages/analytical/src/index-store/workspace-index-file.ts

workspace-index-file.ts

file_reference

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

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

workspace-index-sync.ts

file_reference

"../../../packages/analytical/test/index-diagnostics.test.ts"

packages/analytical/test/index-diagnostics.test.ts

index-diagnostics.test.ts

comment_link

index_diagnostics_metrics

reqlan rq/extension/index-host/packages/analytical/src/index-store/index-diagnostics-store.ts

* rq:index_diagnostics_metrics

comment_link

index_diagnostics_metrics

reqlan rq/extension/index-host/packages/analytical/src/index-store/workspace-index-file.ts

* rq:index_diagnostics_metrics

comment_link

index_diagnostics_metrics

reqlan rq/extension/index-host/packages/analytical/src/index-store/workspace-index-sync.ts

* rq:index_diagnostics_metrics

comment_link

index_diagnostics_metrics

reqlan rq/extension/index-host/packages/analytical/src/index-store/workspace-index.ts

* rq:index_diagnostics_metrics

comment_link

index_diagnostics_metrics

reqlan rq/extension/index-host/packages/analytical/test/index-diagnostics.test.ts

* rq:index_diagnostics_metrics

Kind	Idea	Path	Snippet
references	index_diagnostics_store	reqlan rq/extension/index-host/index.rq	index_diagnostics_metrics
references	diagnostics_sqlite	reqlan rq/indexer/diagnostics-schema.rq	index_diagnostics_metrics
references	sync_runs_table	reqlan rq/indexer/diagnostics-schema.rq	index_diagnostics_metrics
references	index_diagnostics_timing	reqlan rq/indexer/indexer.rq	index_diagnostics_metrics

Kind

Idea

Path

Snippet

references

index_diagnostics_store

reqlan rq/extension/index-host/index.rq

index_diagnostics_metrics

references

diagnostics_sqlite

reqlan rq/indexer/diagnostics-schema.rq

index_diagnostics_metrics