Skip to content

Run Reconciler

POST
/api/writing/reconcile

Run a full reconciler pass for the active project.

Repairs drift between the filesystem and the SQLite / ChromaDB indexes. Returns a summary of what was repaired. Safe to call repeatedly — every job is idempotent.

Successful Response

ReconcilerReportResponse

Summary of a reconciler pass.

failures lists each per-item skip so the UI can surface them and let the user retry the failed entries instead of having repairs silently disappear.

object
orphanMainsAdopted
required
Orphanmainsadopted
integer
missingFilesMarked
required
Missingfilesmarked
integer
orphanHistoryAdopted
required
Orphanhistoryadopted
integer
chromadbReindexed
required
Chromadbreindexed
integer
autorecoverCleaned
required
Autorecovercleaned
integer
totalActions
required
Totalactions
integer
totalFailures
required
Totalfailures
integer
failures
required
Failures
Array<object>
ReconcilerFailureResponse

A single per-item failure during a reconciler pass.

object
job
required
Job
string
target
required
Target
string
errorType
required
Errortype
string
errorMessage
required
Errormessage
string