Skip to content
Documentation menu

Tools

trusty-common — documentation

The foundational shared library of the trusty-* workspace: tracing, daemon and configuration helpers, model clients, memory/search support, ticketing, and other cross-package utilities behind opt-in features. Some former micro-crates were consolidated here; MCP protocol primitives were later extracted into trusty-mcp under ADR-0040.

Historical product baseline

The spec/ set records the library's earlier consolidation model. Use the crate README, accepted ADRs, and source for the current feature and module surface:

DocumentPurpose
spec/README.mdIndex, summary, status legend, reading order.
spec/PRD.mdVision, goals/non-goals, personas (the other crates), functional requirements by subsystem.
spec/ARCHITECTURE.mdThe feature-flag model, cross-crate consumption, design conventions, module map.
spec/COMPONENTS.mdPer-subsystem specs with src/ citations.

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

Layout

This library has the following extended documentation:

SubdirContents
spec/Historical PRD / architecture / component baseline.
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 ADR-0040 for the later MCP extraction boundary.