content-ingestion-agent/README.md

KAB Content Ingestion Agent

A contract-first, tenant-isolated ingestion service for GitHub and SharePoint. It supports full, incremental, scheduled, on-demand, and webhook-triggered synchronization and publishes governed normalized documents to a KAB-compatible store.

Quick start

python -m venv .venv && . .venv/bin/activate
pip install -e '.[dev]'
pytest -q

The implementation uses dependency-injected HTTP, secret, cursor, and publication ports; production adapters can be supplied without changing connector logic. See docs/operations.md, docs/examples.md, and spec/ingestion-contract.md.

Security defaults: tenant is mandatory, ACLs are deny-by-default, secrets are referenced rather than stored, and webhook signatures are verified before work is queued.