> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# stackkit registry

> Manage the embedded StackKits registry snapshot

Manage the embedded StackKits registry snapshot.

Manage the OSS-safe registry snapshot baked into the CLI binary.

The snapshot lives at internal/registry/data/registry\_snapshot.json. Inspect the embedded data or reproduce it deterministically from the local CUE tree.

```bash theme={null}
stackkit registry [flags]
```

Subcommands: [`stackkit registry artifacts`](#stackkit-registry-artifacts), [`stackkit registry bake-from-cue`](#stackkit-registry-bake-from-cue), [`stackkit registry emit-cue`](#stackkit-registry-emit-cue), [`stackkit registry emit-mintlify`](#stackkit-registry-emit-mintlify), [`stackkit registry info`](#stackkit-registry-info)

## stackkit registry artifacts

Print registry/generated artifact pathspecs from the ownership manifest.

Print repository pathspecs from the generated-artifact ownership manifest.

The generate-cue workflow and CI parity gate use this command so bot-owned generated files are explicit. Frozen artifacts remain in their existing paths but are not staged or diffed as generated output until their manifest state changes.

```bash theme={null}
stackkit registry artifacts [flags]
```

| Flag         | Type   | Default                                      | Description                                    |
| ------------ | ------ | -------------------------------------------- | ---------------------------------------------- |
| `--kind`     | string | `all`                                        | Artifact kind filter (all, cue, snapshot)      |
| `--manifest` | string | `internal/registry/generated_artifacts.json` | Generated artifact ownership manifest          |
| `--state`    | string | `generated`                                  | Artifact state filter (all, generated, frozen) |

## stackkit registry bake-from-cue

Produce a registry snapshot from the local Git/CUE tree.

Walk modules/\<slug>/module.cue plus the canonical product definitions, compute their contract hashes, and write the resulting Snapshot to internal/registry/data/registry\_snapshot.json (or `--output`).

This command is the offline OSS bootstrap path and works on a pure checkout of the public kombifyio/stackKits repo.

```bash theme={null}
stackkit registry bake-from-cue [flags]
```

| Flag            | Type   | Default                                         | Description                                    |
| --------------- | ------ | ----------------------------------------------- | ---------------------------------------------- |
| `--modules-dir` | string | `modules`                                       | Directory containing module/\<slug>/module.cue |
| `--output`      | string | `internal/registry/data/registry_snapshot.json` | Output path for the snapshot JSON              |

## stackkit registry emit-cue

Render foundation/generated CUE artifacts from the registry snapshot.

Render foundation/generated/tool\_catalog.cue from the registry snapshot plus the local CUE module tree.

Reads the snapshot JSON (default: internal/registry/data/registry\_snapshot.json, refresh it first via 'registry bake-from-cue'), renders deterministically, and writes the artifact. The header records the snapshot's content\_hash and generated\_at so drift between snapshot and artifact is detectable; CI regenerates from the committed snapshot and diffs.

```bash theme={null}
stackkit registry emit-cue [flags]
```

| Flag            | Type   | Default                                         | Description                                                              |
| --------------- | ------ | ----------------------------------------------- | ------------------------------------------------------------------------ |
| `--input`       | string | `internal/registry/data/registry_snapshot.json` | Snapshot JSON to render from                                             |
| `--modules-dir` | string | `modules`                                       | Directory containing modules/\<slug>/module.cue (service catalog source) |
| `--output-dir`  | string | `foundation/generated`                          | Directory for the rendered CUE files                                     |

## stackkit registry emit-mintlify

Render Mintlify MDX tool documentation from the registry snapshot.

Render guides/stackkits/services/\<slug>.mdx for every tool in the snapshot that carries published content (tool.content != null). Tools without content are skipped — their handwritten MDX is left untouched.

Reads the snapshot JSON (default: internal/registry/data/registry\_snapshot.json) and renders deterministically. The header carries the content\_hash so drift is detectable. CI regenerates from the committed snapshot and diffs.

```bash theme={null}
stackkit registry emit-mintlify [flags]
```

| Flag           | Type   | Default                                         | Description                              |
| -------------- | ------ | ----------------------------------------------- | ---------------------------------------- |
| `--input`      | string | `internal/registry/data/registry_snapshot.json` | Snapshot JSON to render from             |
| `--output-dir` | string | `guides/stackkits/services`                     | Output directory for generated MDX files |

## stackkit registry info

Show a summary of the embedded registry snapshot.

```bash theme={null}
stackkit registry info [flags]
```

| Flag     | Type | Default | Description                              |
| -------- | ---- | ------- | ---------------------------------------- |
| `--json` | bool | —       | Print the full embedded snapshot as JSON |