Function add_single_file

openkb/cli.py:442–447

Convert, index, and compile a single document under the KB mutation lock.

(
    file_path: Path, kb_dir: Path, *, stage: bool = True
)

def add_single_file(
    file_path: Path, kb_dir: Path, *, stage: bool = True
) -> Literal["added", "skipped", "failed"]:
    """Convert, index, and compile a single document under the KB mutation lock."""
    with kb_ingest_lock(kb_dir / ".openkb"):
        return _add_single_file_locked(file_path, kb_dir, stage=stage)


def _add_single_file_locked(