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

# Monogram Logos

> Inspect and validate possibility-band evidence over the Monogram Semantics Store before product Monogram absorbs a surface.

Monogram Logos is the possibility-band foundry. It reads the
[Monogram Semantics](/ai-clis/monogram-semantics) Store to map evidence for one
symbol, validate the same evidence repository-wide, and emit the compile-time
band registry that currently ships.

Logos is a prover, not a ranker. It never mutates Monogram ranking and reports
`ranking_ready=false` on candidate/repository review reports even when it can
describe candidate-local evidence. `emit` is a compile-time registry listing,
not a ranking-readiness report.

*Published contract: `monogram-logos 0.2.1`, OpenCLIs build
`2026-07-12-191924`. The executing binary, OpenCLIs registry, and public CDN
metadata agree on this release.*

The binary has **exactly 3 operational root commands**. Root `help`, `--help`,
and `-h` print the complete guide; subcommands reject their own `--help` with
exit 1. `version`, `--version`, and `-V` are identity forms.

## The Foundry Loop

```text theme={null}
MAP       inspect   per-symbol evidence
GUARD     compile-time core tests; no runtime verb
VALIDATE  survey    repository-wide evidence
EMIT      emit      shipped band registry
```

## Complete Command Reference

| Command   | What it does                                                                                                                                                                                                     | Important controls                                                                    |
| --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `inspect` | Maps one candidate symbol to FunctionIR, effects, callers/callees, forward/reverse reach, lifecycle sequence, structural roles, type/module hits, Tauri bridges, and score-debug requirements.                   | `--query <symbol>`, `--project <path>`, `--db <file>`, `--limit`, `--depth`, `--json` |
| `survey`  | Builds a repository-wide review over Store/resolution/effect/bridge/module stats, metrics, complexity, hubs, smells, unsafe reach, injection surfaces, Tauri links, dead handlers, orphan modules, and examples. | `--project <path>`, `--db <file>`, `--limit`, `--depth`, `--json`                     |
| `emit`    | Prints the shipped possibility-band registry with language, primitive, fixed predicate, and honesty note.                                                                                                        | `--json`; no repository index required.                                               |

No runtime `guard` command exists. GUARD is enforced by tests in
`lib-monogram-logos-core`.

## Store Behavior

With an explicit `--db`, `inspect` and `survey` read the selected semantics
database without rebuilding it. Without `--db`, they can index the selected
project first. The default Store resolution follows Monogram's home:

```text theme={null}
${MONOGRAM_HOME | ~/.monolex}/monogram/{name}-{hash6}.semantics.db
```

That distinction matters when reproducibility is required: pin `--db` to prove
which snapshot produced the report.

## Standard Workflow

```bash theme={null}
monogram-semantics index /path/to/project
monogram-logos inspect --query resolve_calls --project /path/to/project --json
monogram-logos survey --project /path/to/project --json
monogram-logos emit --json
```

## Retired Surface

The old in-tool verdict dashboards `analyze`, `seat-tags`,
`compare-monogram`, `compiler-understanding`, `meaning-groups`, and
`monogram-roadmap` are not commands in this release. Tool-vs-tool lift belongs
in [Monobench](/ai-clis/monobench/overview) arms; everyday code navigation and
absorbed MAP behavior belong in [Monogram](/ai-clis/monogram/overview).

## Release Platforms

The `0.2.1` CDN metadata publishes five artifacts. Intel macOS is not present.

| Platform key      | Binary               |
| ----------------- | -------------------- |
| `darwin-aarch64`  | `monogram-logos`     |
| `linux-aarch64`   | `monogram-logos`     |
| `linux-x86_64`    | `monogram-logos`     |
| `windows-aarch64` | `monogram-logos.exe` |
| `windows-x86_64`  | `monogram-logos.exe` |

The installed macOS ARM payload is Developer ID signed. `emit` needs no Store;
`inspect` and `survey` prove only the Store snapshot they actually read.

## Relationships

| Tool                                              | Ownership                                                         |
| ------------------------------------------------- | ----------------------------------------------------------------- |
| [Monogram](/ai-clis/monogram/overview)            | Product navigation, native MAP behavior, ranking, and score-debug |
| [Monogram Semantics](/ai-clis/monogram-semantics) | The structural Store and graph/effect evidence Logos reads        |
| [Monogram Language](/ai-clis/monogram-language)   | Corpus-derived language evidence and gated future-prior review    |
| [Monobench](/ai-clis/monobench/overview)          | External arm-level behavior and lift measurement                  |