Skip to content

docs: record that index state lives in Postgres and the admin pages read only that - #84

Merged
johnf merged 1 commit into
mainfrom
worktree-adr-index-state-postgres
Nov 17, 2026
Merged

johnf merged 1 commit into
mainfrom
worktree-adr-index-state-postgres

Conversation

@johnf

@johnf johnf commented Nov 17, 2026

Copy link
Copy Markdown
Collaborator

Summary

Records the decision from #71 (a ticket on the indexer redesign map, #65) as ADR 0007, and adds two glossary terms: Index state and Indexed version. Documentation only; no code changes.

Postgres (our own tables)
├── index jobs      # the queue: waiting, running, failed
├── crate records   # name, indexed version, when, entity and file counts
└── workers         # heartbeats

API, CLI ──add──▶ index jobs ◀──claim── worker
                                  └──▶ writes the record as its last step
admin pages ──read──▶ jobs + records + workers   (never the repository)

Follows ADR 0005 (#80), which this ADR refers to. ADR 0006 is taken by #83.

Evidence

  • Before: no record of where index state lives; stateCache in src/ocfl.ts is in memory.
    After: docs/adr/0007-index-state-lives-in-postgres.md; pre-commit checks (biome, tsc, knip) pass.

Merge Danger

Door: two-way

Documentation of a decision; nothing is built on it yet.

Blast Radius: none

GLOSSARY.md is also touched by #79, #80 and #83, in other places, so a rebase may be needed depending on merge order.

…ead only that

ADR 0007 and the glossary terms Index state and Indexed version, from #71.
@johnf
johnf force-pushed the worktree-adr-index-state-postgres branch from efbe099 to c460af2 Compare November 17, 2026 02:18
@johnf
johnf merged commit a17cab4 into main Nov 17, 2026
4 checks passed
@johnf
johnf deleted the worktree-adr-index-state-postgres branch November 17, 2026 02:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant