# PUBLIC_API — mgf-fed

> Tracks the live `__all__` of `mgf.fed` (AP-10 / DOC-08). The machine companion
> [`PUBLIC_API.json`](PUBLIC_API.json) is generated from `__all__` and pinned in CI. May be ahead
> of the published registry during a release window (REL-03).

`mgf-fed` is primarily a **CLI tool**, not an import library — its real interface is the
`mgf-fed` command surface, not a Python API. The importable public surface is intentionally minimal.

## `mgf.fed`

| Name | Tier | Notes |
|---|---|---|
| `__version__` | **stable** | the package version (AP-13: in sync with `pyproject.toml`). |

All other modules are single-underscore **private** (`mgf.fed._status`, `_drift`, `_gates`,
`_localci`, `_index`, `_release`, `_scaffold`, `_registry`, `_doctor`, `_roster`, `_template`,
`__main__`) — internal to the CLI, **not** a supported import surface (AP-14).

## CLI surface (the operational interface)

`mgf-fed {status, drift-check, local-index, gates, local-ci, release-local, release-remote,
scaffold, registry, doctor}` — **stable** for the documented flags; run `mgf-fed --help` /
`mgf-fed <cmd> --help`. New subcommands/flags are additive; removals follow a deprecation cycle (AP-04).
