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

# Live state

> Canonical live state of the Nika Diamond rewrite. Every number driven by `scripts/refresh-status.sh`. Drift caught by hygiene vector 23.

export const Ecosystem = () => <CardGroup cols={3}>
    <Card title="nika.sh" icon="globe" href="https://nika.sh">
      The site — what Nika is, in one scroll.
    </Card>
    <Card title="Language spec" icon="file-contract" href="https://github.com/supernovae-st/nika-spec">
      `nika: v1`, Apache-2.0. The contract these docs explain.
    </Card>
    <Card title="Engine source" icon="gem" href="https://github.com/supernovae-st/nika">
      Rust, AGPL-3.0-or-later. Every commit public.
    </Card>
    <Card title="Editor extension" icon="puzzle-piece" href="https://marketplace.visualstudio.com/items?itemName=supernovae.nika-lang">
      VS Code · Cursor · Windsurf — check-as-you-type, DAG view, trace replay.
    </Card>
    <Card title="Homebrew tap" icon="beer-mug-empty" href="https://github.com/supernovae-st/homebrew-tap">
      `brew install supernovae-st/tap/nika` for the latest tagged CLI release.
    </Card>
    <Card title="SuperNovae" icon="star" href="https://supernovae.studio">
      The Paris studio crafting Nika. 🦋
    </Card>
  </CardGroup>;

export const STATUS = {
  head: "95962d5cd",
  branch: "main",
  version: "0.91.0",
  cratesWorkspace: 39,
  cratesAdmitted: 39,
  cratesTarget: "42",
  wipCrates: [],
  libTests: 2989,
  clippyWarnings: 0,
  adrs: 62,
  adrsAccepted: 42,
  adrsProposed: 18,
  providers: 32,
  capabilityRules: 49,
  hygieneVectors: 38,
  hygieneGreen: 28,
  hygieneYellow: 3,
  hygieneRed: 0,
  lastUpdated: "2026-06-25"
};

<Info>
  This page is the single source of truth for current engine state. Every
  number imports `STATUS` from [`/snippets/_status-snapshot.mdx`](https://github.com/supernovae-st/nika/blob/main/docs/mintlify/snippets/_status-snapshot.mdx),
  which is auto-generated by [`scripts/mintlify-snapshot.sh`](https://github.com/supernovae-st/nika/blob/main/scripts/mintlify-snapshot.sh)
  from the canonical [`scripts/refresh-status.sh`](https://github.com/supernovae-st/nika/blob/main/scripts/refresh-status.sh).
  Drift between docs and engine state fails hygiene vector 23.

  **Last updated:** {STATUS.lastUpdated} · **HEAD** `{STATUS.head}` · **branch** `{STATUS.branch}`.
</Info>

## At a glance

<CardGroup cols={3}>
  <Card title="Admitted" icon="cube">
    **{STATUS.cratesAdmitted}** / {STATUS.cratesTarget} crates past 12 gates
  </Card>

  <Card title="Library tests" icon="flask">
    **{STATUS.libTests}** passing · {STATUS.clippyWarnings} clippy warnings
  </Card>

  <Card title="Hygiene" icon="shield-check">
    **{STATUS.hygieneGreen}** / {STATUS.hygieneVectors} vectors green · {STATUS.hygieneRed} RED
  </Card>

  <Card title="ADRs" icon="scroll">
    **{STATUS.adrs}** total · {STATUS.adrsAccepted} Accepted · {STATUS.adrsProposed} Proposed
  </Card>

  <Card title="Providers" icon="server">
    **{STATUS.providers}** LLM providers in the catalog
  </Card>

  <Card title="Capability rules" icon="grid">
    **{STATUS.capabilityRules}** rules in `model-capabilities.toml`
  </Card>
</CardGroup>

## Canonical block

The engine's `refresh-status.sh` emits this block; every status doc quotes
it verbatim (MEMORY.md, CLAUDE.md, ROADMAP.md, this page).

| field              | value                                                                                                           |
| ------------------ | --------------------------------------------------------------------------------------------------------------- |
| branch             | `{STATUS.branch}`                                                                                               |
| HEAD               | `{STATUS.head}`                                                                                                 |
| workspace version  | v{STATUS.version}                                                                                               |
| crates (workspace) | {STATUS.cratesWorkspace}                                                                                        |
| crates (admitted)  | {STATUS.cratesAdmitted} / {STATUS.cratesTarget}                                                                 |
| crates (WIP)       | {STATUS.wipCrates.length} — {STATUS.wipCrates.length ? STATUS.wipCrates.join(", ") : "none"}                    |
| library tests      | {STATUS.libTests} passed, 0 failed                                                                              |
| clippy             | {STATUS.clippyWarnings} warnings                                                                                |
| ADRs               | {STATUS.adrs} ({STATUS.adrsAccepted} Accepted + {STATUS.adrsProposed} Proposed)                                 |
| hygiene vectors    | {STATUS.hygieneVectors} ({STATUS.hygieneGreen} green / {STATUS.hygieneYellow} yellow / {STATUS.hygieneRed} red) |
| providers          | {STATUS.providers}                                                                                              |
| capability rules   | {STATUS.capabilityRules}                                                                                        |

## How to refresh

<CodeGroup>
  ```bash Local theme={"system"}
  git clone https://github.com/supernovae-st/nika.git
  cd nika
  bash scripts/refresh-status.sh                  # full refresh (runs cargo test + clippy)
  bash scripts/refresh-status.sh --quick          # skip cargo
  bash scripts/mintlify-snapshot.sh --quick       # regenerate _status-snapshot.mdx
  ```

  ```bash CI theme={"system"}
  # Auto-refresh every push to main:
  bash scripts/mintlify-snapshot.sh
  git diff --exit-code docs/mintlify/snippets/_status-snapshot.mdx \
    || git commit -am "chore(mintlify): refresh status snapshot"
  ```
</CodeGroup>

## Drift protection

<Check>
  Hygiene vector 23 (`check-status-claims-sync.sh`) greps status docs for
  stale numbers. A PR that updates tests without refreshing the snapshot
  fails CI.
</Check>

## What's admitted today

The generated snapshot above is the source of truth: **{STATUS.cratesAdmitted}
/ {STATUS.cratesTarget}** Diamond crates are admitted, with WIP
**{STATUS.wipCrates.length ? STATUS.wipCrates.join(", ") : "none"}**. The
admitted set spans the foundation crates, kernel traits, local/effect crates,
providers, all four verbs, runtime, LSP, MCP, and CLI surfaces needed for the
first public release candidate.

## What's locked (decisions the project won't revisit)

* **{STATUS.cratesTarget} crate architecture** — confirmed by POST\_AUDIT\_REVISIONS 2026-04-14; reached additively across 1.x minors.
* **Real semver toward 1.0** — 0.90.0 is the first public release-candidate; 1.0 ships when release gates are green. Quality over speed.
* **Layer discipline** — L0 zero I/O, L0.5 traits only, strict downward deps, cargo-deny enforced. See [Layers](/architecture/layers).
* **12 gates per crate** — no exceptions. See [Admission](/architecture/admission).
* **Zero `.unwrap()` / `.expect(` in `src/`** — `?` propagation; `workspace.lints.clippy.unwrap_used = "deny"`.
* **Not an extraction** — every crate written fresh, legacy as reference only.
* **TDD with mutation ≥ 90%** — RED before GREEN; `cargo mutants -p <crate>` gates admission.
* **`#[non_exhaustive]` on every public type** — see [Forward-compat invariants](/architecture/forward-compat-invariants).

## What's next

<AccordionGroup>
  <Accordion title="L0-completion crates">
    The remaining Diamond target crates are additive hardening work, not
    prerequisites for the shipped 0.90 release-candidate surface. See the
    roadmap for the exact current sequence.
  </Accordion>

  <Accordion title="1.0 release hardening">
    The user-facing front door is already installable. The 1.0 work is about
    proving the release checklist, docs, editor setup, and shadow-zone gates
    stay true end-to-end.
  </Accordion>

  <Accordion title="The Connectome (sovereign memory) — post-foundation">
    **Separate count** from the {STATUS.cratesTarget} Diamond crates.
    1 L2 orchestrator (`nika-connectome`) + 10 L1 satellites (hnsw, bm25, rrf, rerank,
    fsrs, rdfs-reasoner, temporal, graph-algos, autodesc). Plugs into
    `MemoryStore` / `EmbeddingProvider` trait reservations in `nika-kernel`
    — no breaking changes. Design tracked via ADR-004 + ADRs 029-032.
  </Accordion>
</AccordionGroup>

## What's NOT in scope

Explicitly removed or deferred by POST\_AUDIT\_REVISIONS 2026-04-14:

| What                         | Why                                     | Status               |
| ---------------------------- | --------------------------------------- | -------------------- |
| `nika-sdk`                   | 0 consumers, speculative                | Deleted              |
| `nika-napi` / `nika-py`      | W1 speculative, rebuild Act 3 if needed | Deferred             |
| `nika-tui`                   | W1 speculative                          | Deferred to post-1.0 |
| `nika-macros`                | No proc macros in L0 (Q1 locked)        | Never a crate        |
| `nika-lsp-core`              | Merged into `nika-lsp`                  | Module, not crate    |
| `nika-policy` / `nika-cache` | Modules in `nika-runtime`               | Not crates           |
| `nika-storage`               | Module in `nika-daemon`                 | Not a crate          |

## See also

<CardGroup cols={2}>
  <Card title="Constellation" icon="diagram-project" href="/reference/constellation">
    Visual map of admitted / WIP / planned crates by layer.
  </Card>

  <Card title="Admission" icon="check-double" href="/architecture/admission">
    The 12 gates every crate passes before joining.
  </Card>

  <Card title="Error codes" icon="triangle-exclamation" href="/reference/error-codes">
    NIKA-XXX code reference per crate range.
  </Card>

  <Card title="CHANGELOG" icon="clock-rotate-left" href="https://github.com/supernovae-st/nika/blob/main/CHANGELOG.md">
    Every crate admission with verified numbers.
  </Card>
</CardGroup>

## The Nika ecosystem

<Ecosystem />