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 |