context-engine is the top-level workspace that coordinates the graph crates in context-stack, the viewer and operator tooling in memory-viewers, and the repo-local configuration and install surfaces that bind them together.
The root-level repo_map.toon file is the compact structural index for this repository.
Refresh it with:
cargo run -p peek-cli -- . --repo-map --output repo_map.toonUse peek repo_map.toon --grep "crates" for bounded inspection or decode/query it
as TOON when automation needs machine-readable structure.
| Child repo or folder | What it contains | Direct README |
|---|---|---|
| context-stack | Graph, search, insert, and read crates plus extracted support dependencies. | context-stack/README.md |
| memory-viewers | Viewer binaries, CLI/MCP/HTTP tooling, and shared viewer runtime packages. | memory-viewers/README.md |
| config | Shared tracing and repository configuration. | config/README.md |
context-stack child READMEs:
- context-stack/context-api/README.md
- context-stack/context-trace/README.md
- context-stack/context-search/README.md
- context-stack/context-insert/README.md
- context-stack/context-read/README.md
memory-viewers child READMEs:
The shared installer in install-tools.sh refreshes the executable Rust binaries and installable tooling surfaced by this repository:
The companion installer in install-extensions.sh packages and installs the workspace's VS Code extensions into your local VS Code profile:
-
memory-viewers/memory-api/tools/ticket-vscode/package.json exposes the
ticket-vscodeextension package and the repo-local VSIX install workflow. -
memory-viewers/README.md covers the top-level viewer workflows and the
spec-viewerandticket-viewerbinaries. -
memory-viewers/viewer-api/README.md covers the
viewer-ctlbinary and thetrunk-backed frontend toolchain. -
memory-viewers/memory-api/README.md covers the
rule,spec,ticket, andauditCLIs, thecargo llvm-covcoverage collector used byaudit, and the MCP and HTTP surfaces behind them. -
tools/viewer/doc-viewer/README.md covers the
doc-viewerbinary. -
tools/viewer/log-viewer/README.md covers the
log-viewerbinary.
git submodule update --init --recursive
bash tools/checkout-submodule-branches.shgit submodule update --init --recursivefollows the Git submodule workflow documented in Git Tools - Submodules.- tools/checkout-submodule-branches.sh attaches initialized submodules to their configured tracking branches when you need to edit them.
- Once the submodules are attached, continue from context-stack/README.md and memory-viewers/README.md for repository-local commands.
cargo test --workspace
cargo doc --workspace --opencargo test --workspaceis documented in The Cargo Book: cargo test.cargo doc --workspace --openis documented in The Cargo Book: cargo doc.- Crate-specific validation entry points live in context-stack/README.md and the child READMEs linked above.