Module agent 

Agent noun — the AGI-facing CLI surface over ggen_core::agent::PackAgent.

ggen agent <verb> is the third transport over the one authoritative pack lifecycle facade, alongside the Rust library API (ggen_core::agent) and the ggen.packs.* MCP/A2A tools (ggen-a2a-mcp). Every verb emits structured JSON an autonomous agent can parse and chain, covering the full project-bring-up lifecycle an AGI drives to complete a project:

  capabilities → search / list / show → resolve → compatibility
      → install → status → verify        (and remove)

Because every verb routes through the same PackAgent the MCP/A2A surface uses — not a parallel implementation — the three transports cannot drift, and the durable-state contract (lockfile entry with a non-empty digest, a signed provenance receipt) and the fail-closed error behaviour are identical everywhere.

Functions

capabilities

Describe the agent’s operations and capability surfaces — the discovery entry point an agent calls first to learn the contract.

compatibility

Check whether a comma-separated set of packs composes without conflicts (overlapping packages or unloadable packs). The pre-flight before a multi-pack install.

install

Install a pack: write the lockfile with a non-empty digest and emit a signed provenance receipt. --dry_run previews without writing durable state.

list

List all packs in the local registry, optionally filtered by category.

remove

Remove a pack from the project lockfile. Fail-closed: a missing lockfile or an absent pack errors and leaves the lockfile intact.

resolve

Resolve a capability surface (e.g. mcp, web) to concrete pack IDs, optionally narrowed by --projection and --runtime.

search

Relevance-rank packs in the local registry by a text query.

show

Full detail for one pack: metadata, packages, templates, dependencies, and the validation (quality-gate) result.

status

Report installed packs from the project lockfile (--root to inspect another project; default is the current directory).

verify

Verify a provenance receipt against its signing key. Fail-closed: a missing key, malformed receipt, or bad signature yields is_valid: false.