klasp-agents-codex 0.3.1

Codex agent surface for klasp — writes the AGENTS.md managed-block that documents the gate.
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

//! `klasp-agents-codex` — Codex `AgentSurface` impl.
//!
//! v0.2 W1 shipped the AGENTS.md managed-block writer. W2 (#28, this
//! module set) layers the git `pre-commit` / `pre-push` hook writer on
//! top, with conflict detection for husky / lefthook / pre-commit
//! framework. W3 (#29) wires `klasp install --agent codex` through the
//! CLI and surfaces the [`git_hooks::HookWarning`]s in the install
//! output.

pub mod agents_md;
pub mod git_hooks;
pub mod surface;

// Crate-root re-exports below mirror the W1 shape: AGENTS.md helpers
// keep their unprefixed names (the v0.2 W1 PR exported them at the
// crate root, and downstream callers — including W3 — depend on that).
// The git-hook helpers, which name-clash on `MANAGED_START` /
// `MANAGED_END` / `install_block` / `uninstall_block`, are exposed via
// the `git_hooks` submodule path only — `git_hooks::install_block(…)`,
// not a root-level `install_hook_block`. Keeping the file-format choice
// in the import path makes mis-routing (e.g. shell helpers applied to
// markdown) impossible at the type level.
pub use agents_md::{
    contains_block, install_block, render_managed_block, uninstall_block, AgentsMdError,
    DEFAULT_BLOCK_BODY, MANAGED_END, MANAGED_START,
};
// `HookError` stays accessible via the `git_hooks` submodule path for the
// few callers that need it (it's the return type of the pure block-writer
// helpers `install_block` / `uninstall_block` / `contains_block`); we
// don't surface it at the crate root because the public install / uninstall
// API on `CodexSurface` returns `InstallError`, not `HookError`.
pub use git_hooks::{HookConflict, HookKind, HookWarning};
pub use surface::{CodexInstallReport, CodexSurface};