khive-pack-git 0.5.0

Git-lifecycle pack — commit/issue/pull_request provenance notes over the notes substrate (ADR-088)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42

//! `khive-pack-git` — the git-lifecycle pack (ADR-088, amended by ADR-088
//! Amendment 1 and ADR-108).
//!
//! Contributes three note kinds (`commit`, `issue`, `pull_request`) that make
//! repository provenance queryable through the KG graph, one read/ingest
//! agent-facing verb, `git.digest(source, project?, max_items?, include?)`
//! (`handlers`), that drives the batch, cursor-based ingester (`ingest`)
//! against either a local path or a remote `https://` URL (cloned/fetched
//! into a daemon-owned scratch cache, `cache`), and three write verbs
//! (`write_handlers`, ADR-108) that shell to system git with hardened,
//! allowlisted argv construction (`write_argv`). See
//! `docs/adr/ADR-088-git-lifecycle-pack.md`,
//! `docs/adr/ADR-088-amendment-1-git-digest.md`, and
//! `docs/adr/ADR-108-git-write-surface.md`.
//!
//! | Verb | Args | What it does |
//! | ---- | ---- | ------------ |
//! | `git.digest` | `source`, `project?`, `max_items?`, `include?` | Ingest commit/issue/PR provenance from a local path or `https://` URL, bounded and cursor-resumable |
//! | `git.commit` | `repo`, `message`, `paths?`, `author?` | Stage and commit against a local repo; returns the resulting SHA |
//! | `git.branch` | `repo`, `name`, `from?` | Create a branch, optionally from a named ref/SHA |
//! | `git.push` | `repo`, `branch`, `remote?` | Push a branch to a remote; force-push is always denied |
//!
//! `kkernel git-ingest` remains the unbounded, all-kinds admin CLI path over
//! the same shared `ingest::run_ingest` core.

pub mod cache;
pub mod handlers;
pub mod hook;
pub mod ingest;
mod pack;
#[cfg(test)]
mod recovery_tests;
pub mod refs;
pub mod source;
pub(crate) mod vocab;
pub mod write_argv;
pub mod write_handlers;
#[cfg(test)]
mod write_handlers_tests;
pub mod write_policy;

pub use pack::GitPack;