EKOSdocs
Docs / Usage Build

Index Management

Inspect, verify, repair, migrate and clean an index.

Task Command
Size and health ekos status, ekos ledger status, ekos doctor
Growth over time (JSON) ekos ledger timeline
Write history of an object ekos ledger audit <id>
Verify sealed segments; heal a torn tail or stale index ekos ledger repair
Migrate storage format ekos ledger migrate (v2 compact) / --v3 (fact engine)
Which input kinds produced nothing ekos coverage (--strict to fail on one)
Is the ledger behind the sources? ekos freshness; a line in ekos status and ekos doctor
Broken or ambiguous references ekos check refs
Clear the artifact cache ekos clean
Branch a ledger ekos branch create|list|merge|delete
Artifact store maintenance ekos artifact repack
Back up / restore the whole home ekos home backup, ekos home restore

ledger repair applies to the fact-engine ledger. See Backup & Recovery.

What a commit leaves beside the ledger

Some results are files in the state directory (.ekos/, or a home project's state/), not ledger entries:

File Written by Holds
committed-manifest.json ekos commit the files the ledger reflects (size, time; a hash with [freshness] content-hash)
conflicts/current.json ekos commit the current conflicts and their counts
semantics/current.json ekos commit with [semantics] the ids of the latest business-semantics run
integrity/current.json ekos commit the cross-reference findings ekos check refs --from-index reads
xref-ignore.toml you suppressions for ekos check refs: [[ignore]] with fingerprint, target or source, and a mandatory reason
runs/<stamp>-<command>.jsonl every pipeline stage and changing command the run log