Expand description
Batch, cursor-based git-history ingester (ADR-088 §5). One-shot: walks
local git history plus (optionally) gh-fetched issues and pull
requests, and writes commit / issue / pull_request notes through
the standard create verb. See crates/khive-pack-git/docs/api/ingest.md for
the full module overview.
Structs§
- Ingest
Include - Which record kinds a
run_ingestpass processes.Defaultselects all three — the CLI’s historical behavior and thegit.digestverb’s default (ADR-088 Amendment 1). - Ingest
Options - Options for one ingest pass.
- Ingest
Report - Outcome of one ingest pass. Serializable so CLI callers can emit it as JSON.
Functions§
- resolve_
project_ id - Resolve
raw(a full UUID or an 8+ hex prefix) to an existingprojectentity id, unfiltered by namespace. ReturnsOk(None)when no entity matches; never creates one. Used by thegit.digestverb handler to resolve an explicitly suppliedprojectargument. - run_
ingest - Run one ingest pass over
opts.repo: issues + PRs first (viagh, when available), then commits (via localgit log), each bounded byopts.max_itemsand cursor-resumable (call again while the returnedIngestReport.doneisfalse). Returns an error only for a failure that aborts the whole pass (e.g. an unresolvableopts.project); per-record failures are collected inIngestReport.warningsinstead. See crates/khive-pack-git/docs/api/ingest.md#run_ingest_with_commit_recovery for why this has no self-healing recovery (unlike the verb-handler path).