Tools

trusty-common — documentation

The foundational shared library of the trusty-* workspace — the one internal crate every other trusty-* tool links. Started as a bag of utilities (tracing, OpenRouter chat, port-walking, daemon address resolution) and absorbed seven formerly standalone micro-crates (MCP/RPC primitives, the embedder, the symbol graph, the memory-palace engine, ticketing, monitor TUIs) behind opt-in feature flags (issue #5).

Canonical specification

The authoritative what / why / gap reference lives in spec/ — start there:

Document	Purpose
`spec/README.md`	Index, summary, status legend, reading order.
`spec/PRD.md`	Vision, goals/non-goals, personas (the other crates), functional requirements by subsystem.
`spec/ARCHITECTURE.md`	The feature-flag model, cross-crate consumption, design conventions, module map.
`spec/COMPONENTS.md`	Per-subsystem specs with `src/` citations.

Architecture Decision Records (Nygard format) live in decisions/ — see 0001-consolidate-library-micro-crates.md.

Layout

This directory follows the standard layout used across all published trusty-* crates:

Subdir	Contents
`spec/`	Canonical PRD / Architecture / Components specification set.
`decisions/`	Architecture Decision Records (Nygard format).
`regression-testing/`	Versioned performance/quality snapshots, baseline measurements, alternate-corpus baselines.
`research/`	Investigation docs, audits, decision documents.
`sessions/`	Engineering-session summaries — narrative + reasoning.

See docs/trusty-search/ for a worked example of the populated layout.