docs(src): wave-1 gate polish — rustdoc links, doc typos, redundant test lines

- resolve 2 rustdoc broken-intra-doc-link warnings (ambiguous
  'async_trait' crate/attribute-macro name) in key_source.rs and
  host_key.rs
- fix stray ')' typo in the HostKeySource docs
- rewrite the stale lib.rs architecture line (dependency surface and
  feature graph are landed, not 'landing with implementation start')
- drop a discarded try_sign probe and a redundant None re-assignment
  in tests

Verification: cargo test 47/47 (default + --all-features), clippy
-D warnings (both feature configs, all targets), fmt --check,
cargo doc --no-deps 0 warnings
This commit is contained in:
glm-5.3-flash committed 2026-10-28 07:22:24 +00:00
1 parent 214690b9c2
commit 1bd2588788
4 files changed
+9 -9

No files matched your search

-1
View File
@@ -462,7 +462,6 @@ mod tests {
assert!(!serve.exec_wrapper_configured());
assert!(!serve.tunnel_configured());
serve.exec_wrapper_argv = None;
serve.exec_wrapper_argv = Some(vec!["/bin/sh".into(), "-c".into()]);
assert!(serve.shell_configured());
assert!(serve.exec_wrapper_configured());
+3 -3
View File
@@ -70,9 +70,9 @@ pub struct PresentedHostKey {
///
/// The handle shape is the family's injected-handle pattern
/// (`Arc<dyn HostKeyPolicy>`, the alkcall `IdentityProvider`
/// precedent): object-safe via [`async_trait`], shared by reference —
/// learn-and-record policies hold their state by interior mutability
/// so the same handle serves the dial and any inspection.
/// precedent): object-safe via `async_trait`, shared by
/// reference — learn-and-record policies hold their state by interior
/// mutability so the same handle serves the dial and any inspection.
///
/// **Fail-closed posture**: when a policy cannot decide (its pin
/// store is unavailable, its prompt failed, its metadata source is
+2 -3
View File
@@ -59,7 +59,7 @@ use crate::error::KeySourceError;
///
/// The handle shape is the family's injected-handle pattern
/// (`Arc<dyn KeySource>`, the alkcall `IdentityProvider` precedent):
/// object-safe via [`async_trait`], shared by reference — the vault
/// object-safe via `async_trait`, shared by reference — the vault
/// handle rides the implementation (the assembly clones its
/// [`VaultServiceHandle`] into its source). The crate's ADR-005
/// implementation is [`VaultKeySource`]; an assembly may implement the
@@ -85,7 +85,7 @@ pub trait KeySource: Send + Sync + 'static {
/// [`HostKeySource::load`] when it assembles the server, and a failure
/// means no server is constructed (POC-2 §5; locked vault at
/// bootstrap → [`KeySourceError::Locked`] → fail-closed, never a
/// half-configured server). The crate is policy-blind on host *pin*)
/// half-configured server). The crate is policy-blind on host *pin*
/// trust — that is the [`crate::HostKeyPolicy`] seam's business — this
/// seam is only the *held* material (the client's host pin is public
/// config, never vault material).
@@ -293,7 +293,6 @@ mod tests {
}
fn assert_usable_by_russh(key: &russh::keys::PrivateKey) {
let _ = key.try_sign(b"alkssh w1 key-source usability probe");
assert!(
key.try_sign(b"alkssh w1 key-source usability probe")
.is_ok(),
+4 -2
View File
@@ -19,8 +19,10 @@
//! rest, decrypted at use (ADR-005), never env vars.
//!
//! Architecture: `docs/architecture/` (phase 1 — ADRs 001–006 accepted;
//! the dependency surface and feature graph land with implementation
//! start). See also `docs/research/` and family ADR-003.
//! the dependency surface, feature graph, and wave-1 foundations are
//! landed; the server stack, the mappings, the client direction, and
//! validation are later implementation waves — wave 2 decomposes after
//! this gate). See also `docs/research/` and family ADR-003.
mod config;
mod error;