History backfill command
Summary
Add commitlm backfill to generate documentation for existing commits (e.g., to seed a new project knowledge base).
Motivation
Creates historical docs for onboarding and auditing.
CLI proposal
commitlm backfill [--since <rev> | --last N] [--until <rev>] [--reverse] [--dry-run] [--provider ... --model ...]
Scope
- Writes to
docs/history/<short-hash>_<slug>.md (same content structure as post-commit docs).
- Rate-limit aware (configurable delay).
- Respects Include/Exclude patterns (see related issue).
Tasks
Acceptance criteria
Test plan
Create a repo with 5 commits; run commitlm backfill --last 3; verify 3 files created; re-run is a no-op.
History backfill command
Summary
Add
commitlm backfillto generate documentation for existing commits (e.g., to seed a new project knowledge base).Motivation
Creates historical docs for onboarding and auditing.
CLI proposal
Scope
docs/history/<short-hash>_<slug>.md(same content structure as post-commit docs).Tasks
git rev-list) or GitPython.--dry-runto print planned work only.Acceptance criteria
--reverse.Test plan
Create a repo with 5 commits; run
commitlm backfill --last 3; verify 3 files created; re-run is a no-op.