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]
        HEALTH[resq-health\nService Health Monitor]
        DEPLOY[resq-deploy\nDeployment Manager]
        LOGS[resq-logs\nLog Aggregator]
        PERF[resq-perf\nPerformance Dashboard]
        FLAME[resq-flame\nCPU Profiler]
        BIN[resq-bin\nBinary Analyzer]
        CLEAN[resq-clean\nWorkspace Cleaner]
    end

    RESQ -->|resq health| HEALTH
    RESQ -->|resq deploy| DEPLOY
    RESQ -->|resq logs| LOGS
    RESQ -->|resq perf| PERF
    RESQ -->|resq flame| FLAME
    RESQ -->|resq asm| BIN
    RESQ -->|resq clean| CLEAN

    TUI -.-> HEALTH
    TUI -.-> DEPLOY
    TUI -.-> LOGS
    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-health	Service health monitoring dashboard
resq-deploy	Kubernetes and Docker Compose deployment TUI
resq-logs	Log aggregator and stream viewer
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 health	resq-health	Service health monitoring dashboard
resq deploy	resq-deploy	Kubernetes/Docker Compose deployment TUI
resq logs	resq-logs	Aggregate and stream service logs
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;

let mut 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;

let mut bf = BloomFilter::new(1000, 0.01);
bf.add("drone-001");
assert!(bf.has("drone-001"));   // definitely added
assert!(!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-deploy/    # Deployment manager
├── resq-flame/     # CPU profiler
├── resq-health/    # Health monitor
├── resq-logs/      # Log aggregator
└── 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.