ResQ Crates

A comprehensive Rust CLI/TUI toolset and DSA library for the ResQ autonomous drone platform.

Overview

This monorepo contains 10 published Rust crates: a zero-dependency data structures library, a unified CLI entry point, a shared TUI component library, and 7 specialized developer tools. Every TUI tool shares a common look and feel via resq-tui, and all tools are accessible through the unified resq CLI.

Architecture

graph TB
subgraph Libraries
DSA[resq-dsa\nData Structures & Algorithms\nzero deps, no_std]
TUI[resq-tui\nShared TUI Components\nRatatui + Crossterm]
end
subgraph CLI[Unified CLI]
RESQ[resq-cli\nresq binary]
end
subgraph Tools[Developer Tools]
PERF[resq-perf\nPerformance Dashboard]
FLAME[resq-flame\nCPU Profiler]
BIN[resq-bin\nBinary Analyzer]
CLEAN[resq-clean\nWorkspace Cleaner]
end
RESQ -->|resq perf| PERF
RESQ -->|resq flame| FLAME
RESQ -->|resq asm| BIN
RESQ -->|resq clean| CLEAN
TUI -.-> PERF
TUI -.-> FLAME
TUI -.-> BIN
TUI -.-> CLEAN
RESQ -.-> TUI

Loading

Packages

Crate	Description	crates.io
resq-dsa	Data structures and algorithms -- zero dependencies, no_std
resq-cli	Unified CLI entry point (resq binary)
resq-tui	Shared Ratatui component library for all TUI tools
resq-perf	Performance monitoring dashboard
resq-flame	CPU profiler and flame graph generator
resq-bin	Machine code and binary analyzer
resq-clean	Interactive workspace cleaner

---

Quick Start

cargo install resq-cli
resq help

CLI Commands

All tools are accessible through the unified resq binary, or can be installed and run independently.

Command	Tool	Description
resq audit	resq-cli	Security audit (OSV/dependency scanning)
resq perf	resq-perf	Real-time performance metrics
resq flame	resq-flame	CPU profiling and flame graph generation
resq asm	resq-bin	Binary/machine code analysis
resq clean	resq-clean	Interactive workspace cleaner
resq copyright	resq-cli	Apache-2.0 license header enforcement
resq secrets	resq-cli	Secret scanning
resq cost	resq-cli	Dependency cost analysis
resq tree-shake	resq-cli	Unused dependency detection
resq pre-commit	resq-cli	Pre-commit hook runner

---

resq-dsa

Production-grade data structures and algorithms with zero external dependencies. Supports no_std environments with the alloc crate.

cargo add resq-dsa

Data Structures

Structure	Description	Key Operations
BloomFilter	Probabilistic set membership	add, has, union, intersection
CountMinSketch	Probabilistic frequency estimation	increment, estimate
Graph<Id>	Weighted directed graph	bfs, dijkstra, astar
BoundedHeap<T>	K-nearest neighbors heap	insert, to_sorted, peek
Trie	Prefix tree with autocomplete	insert, search, starts_with
rabin_karp	Rolling-hash string search	Pattern matching with all indices

Example: Graph Pathfinding

use resq_dsa::graph::Graph;letmut g = Graph::<&str>::new();
g.add_edge("base","waypoint-1",100);
g.add_edge("waypoint-1","target",50);
g.add_edge("base","target",200);let(path, cost) = g.dijkstra(&"base",&"target").unwrap();assert_eq!(path, vec!["base","waypoint-1","target"]);assert_eq!(cost,150);

Example: Bloom Filter

use resq_dsa::bloom::BloomFilter;letmut bf = BloomFilter::new(1000,0.01);
bf.add("drone-001");assert!(bf.has("drone-001"));// definitely addedassert!(!bf.has("drone-999"));// definitely NOT added

See the full resq-dsa README for complete API reference with complexity tables.

---

Examples

The examples/ directory has runnable demos for every tool. Highlights:

# Run all resq-dsa examples
cargo run -p resq-dsa --example bloom_dedup
cargo run -p resq-dsa --example graph_routing
cargo run -p resq-dsa --example combined_pipeline
# See the full list
cat examples/README.md

Each tool also has usage guides in examples/resq-<tool>/ with sample configs, mock data, and step-by-step instructions.

---

Documentation

API docs are auto-generated and deployed to GitHub Pages on every push to master:

resq-software.github.io/crates

Generate locally:

cargo doc --workspace --no-deps --open

---

Workspace Structure

crates/
├── resq-dsa/ # Data structures library (no_std, zero deps)
├── resq-tui/ # Shared TUI components (Ratatui + Crossterm)
├── resq-cli/ # Unified CLI entry point
├── resq-bin/ # Binary analyzer
├── resq-clean/ # Workspace cleaner
├── resq-flame/ # CPU profiler
└── resq-perf/ # Performance dashboard

---

Development

Prerequisites

• Rust: Latest stable toolchain via rustup (pinned in rust-toolchain.toml). Edition 2021.
• Nix (optional): For reproducible development environments, use nix develop.
• Docker (optional): For containerized builds and deployment tools.

Build

git clone https://github.com/resq-software/crates.git
cd crates
cargo build --release --workspace

Test

# Run all tests
cargo test --workspace
# Run only resq-dsa tests (including ignored complexity tests)
cargo test -p resq-dsa -- --include-ignored

Lint

cargo clippy --workspace -- -D warnings
cargo fmt --all --check

Cargo Aliases

Alias	Description
cargo resq	Run the ResQ CLI
cargo health	Launch health monitor
cargo logs	Launch log viewer
cargo perf	Launch performance dashboard
cargo deploy	Launch deployment TUI
cargo flame	Launch flame graph profiler
cargo bin	Launch binary explorer
cargo cleanup	Launch workspace cleaner
cargo check-all	Fastest correctness check
cargo t	Run all workspace tests
cargo c	Run clippy on all targets

Docker

docker build -t resq-cli .
docker run --rm resq-cli --help

---

Contributing

We follow Conventional Commits.

1. Branch: Use feat/, fix/, or refactor/ prefixes.
2. Quality: Run cargo clippy --workspace -- -D warnings before submitting.
3. Tests: All CI workflows must pass, including osv-scan.
4. Headers: Run resq copyright to enforce Apache-2.0 license headers on new source files.
5. Agent Guides: Run ./agent-sync.sh if you modify AGENTS.md or CLAUDE.md.

---

License

Copyright 2026 ResQ. Licensed under the Apache License, Version 2.0.