[AZ-666] [AZ-673] [AZ-648] ignored set + UDS VLM + mission FSM batch 5
ci/woodpecker/push/build-arm Pipeline failed

AZ-666 mapobjects_store:
- internal/ignored.rs (HashSet<(mgrs, class_group)> for O(1) suppression)
- internal/passes.rs (per-region PassTracker with observed-id set and
  end-of-pass removed-candidate sweep)
- Classification::Ignored wired into classify; apply_decline +
  is_ignored + pass_start + end_of_pass on MapObjectsStoreHandle
- new tests/ignored_and_sweep.rs (3 AC + 2 supplementary)

AZ-673 vlm_client:
- internal/peer_cred.rs (Linux SO_PEERCRED via libc getsockopt;
  PeerCredOutcome::SkippedNonLinux on macOS dev hosts per
  description.md §8)
- internal/prompt.rs (pre-send ROI size + format + prompt
  non-emptiness validation)
- internal/wire.rs (length-prefixed JSON envelope with base64 ROI)
- internal/uds_client.rs (tokio UnixStream client; bounded
  reconnect; hard-stop on peer-cred mismatch; per-request deadline)
- VlmClient with both eager (open/connect) and lazy (new) ctor
- workspace Cargo.toml: base64 + libc as workspace deps

AZ-648 mission_executor:
- internal/types.rs (Variant, MissionState, TransitionKey,
  Telemetry, TransitionEvent, StepOutcome)
- internal/driver.rs (MissionDriver trait + DriverError +
  DriverAction)
- internal/fsm.rs (variant-agnostic Transition + FsmCore + step_one
  with per-transition retry budget keyed by TransitionKey)
- internal/multirotor.rs + internal/fixed_wing.rs (typed transition
  tables; multirotor has Armed/TakeOff, fixed-wing parks in
  WaitAuto for operator AUTO)
- public API: MissionExecutor::run spawns the FSM task and returns
  a clone-safe MissionExecutorHandle (state, health, subscribe,
  paused_reason, retry_count)
- new tests/state_machine.rs (AC-1..AC-4 via ScriptedDriver fake;
  SITL conformance lands with AZ-649 telemetry forwarding)

Workspace: cargo fmt + clippy -D warnings clean; full
cargo test --workspace --all-features green (1 ignored = AZ-665
perf gate). Tasks moved todo/ → done/, autodev state set to batch
6 selection.

Refs: _docs/03_implementation/batch_05_cycle1_report.md
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
Oleksandr Bezdieniezhnykh
2026-05-19 16:54:00 +03:00
parent 69c0629350
commit b5cc0c321c
30 changed files with 3343 additions and 111 deletions
+156
View File
@@ -0,0 +1,156 @@
//! Wire framing for NanoLLM UDS IPC.
//!
//! Single request → single response, length-prefixed JSON:
//!
//! ```text
//! uint32 BE length || JSON payload
//! ```
//!
//! The request payload is `{"prompt": "...", "roi_b64": "..."}`. The
//! response payload is a `shared::models::vlm::VlmAssessment` JSON
//! object — the same shape `VlmProvider::assess` returns. AZ-674 will
//! add schema-version validation on top of this; AZ-673 leaves the
//! body un-validated beyond `serde_json::from_slice`.
use base64::Engine;
use serde::{Deserialize, Serialize};
use shared::models::vlm::VlmAssessment;
use tokio::io::{AsyncRead, AsyncReadExt, AsyncWrite, AsyncWriteExt};
/// Hard maximum on any single inbound frame. Defends against a peer
/// (or a corrupted peer) declaring an arbitrarily large length.
pub const MAX_FRAME_BYTES: u32 = 8 * 1024 * 1024;
#[derive(Debug, Serialize, Deserialize)]
pub struct AssessRequest {
pub prompt: String,
/// Base64-encoded ROI bytes. Kept inline in the JSON envelope so
/// the wire is one read/write per direction.
pub roi_b64: String,
}
#[derive(Debug, thiserror::Error)]
pub enum WireError {
#[error("io: {0}")]
Io(#[from] std::io::Error),
#[error("frame too large: {0} bytes (max {MAX_FRAME_BYTES})")]
FrameTooLarge(u32),
#[error("json: {0}")]
Json(#[from] serde_json::Error),
#[error("unexpected eof while reading frame body")]
UnexpectedEof,
}
pub async fn write_request<W: AsyncWrite + Unpin>(
w: &mut W,
prompt: &str,
roi: &[u8],
) -> Result<(), WireError> {
let req = AssessRequest {
prompt: prompt.to_string(),
roi_b64: base64::engine::general_purpose::STANDARD.encode(roi),
};
let body = serde_json::to_vec(&req)?;
let len = body.len() as u32;
if len > MAX_FRAME_BYTES {
return Err(WireError::FrameTooLarge(len));
}
w.write_all(&len.to_be_bytes()).await?;
w.write_all(&body).await?;
w.flush().await?;
Ok(())
}
pub async fn read_response<R: AsyncRead + Unpin>(r: &mut R) -> Result<VlmAssessment, WireError> {
let mut lenbuf = [0u8; 4];
r.read_exact(&mut lenbuf).await?;
let len = u32::from_be_bytes(lenbuf);
if len > MAX_FRAME_BYTES {
return Err(WireError::FrameTooLarge(len));
}
let mut body = vec![0u8; len as usize];
let n = r.read_exact(&mut body).await?;
if n != body.len() {
return Err(WireError::UnexpectedEof);
}
let assessment: VlmAssessment = serde_json::from_slice(&body)?;
Ok(assessment)
}
#[cfg(test)]
mod tests {
use super::*;
use shared::models::vlm::{VlmLabel, VlmStatus};
use tokio::io::duplex;
#[tokio::test]
async fn round_trip_request_and_response() {
// Arrange
let (mut a, mut b) = duplex(64 * 1024);
let prompt = "describe";
let roi = b"\xff\xd8\xff\xe0\x00\x10JFIF".to_vec();
// Act — client side writes the request, fixture side reads it
// and writes back a canned response.
let fixture = tokio::spawn(async move {
// Read request frame.
let mut lenbuf = [0u8; 4];
b.read_exact(&mut lenbuf).await.unwrap();
let len = u32::from_be_bytes(lenbuf) as usize;
let mut req_buf = vec![0u8; len];
b.read_exact(&mut req_buf).await.unwrap();
let req: AssessRequest = serde_json::from_slice(&req_buf).unwrap();
assert_eq!(req.prompt, "describe");
assert_eq!(
base64::engine::general_purpose::STANDARD
.decode(req.roi_b64)
.unwrap()
.as_slice(),
b"\xff\xd8\xff\xe0\x00\x10JFIF"
);
// Write canned response.
let response = VlmAssessment {
label: VlmLabel::ConfirmedConcealedPosition,
confidence: 0.91,
evidence_spans: vec!["foliage".into()],
reason: "match".into(),
status: VlmStatus::Ok,
latency_ms: 12,
model_version: "VILA1.5-3B-int4".into(),
};
let body = serde_json::to_vec(&response).unwrap();
let len = body.len() as u32;
b.write_all(&len.to_be_bytes()).await.unwrap();
b.write_all(&body).await.unwrap();
b.flush().await.unwrap();
});
write_request(&mut a, prompt, &roi).await.unwrap();
let resp = read_response(&mut a).await.unwrap();
fixture.await.unwrap();
// Assert
assert_eq!(resp.status, VlmStatus::Ok);
assert_eq!(resp.label, VlmLabel::ConfirmedConcealedPosition);
assert_eq!(resp.model_version, "VILA1.5-3B-int4");
}
#[tokio::test]
async fn rejects_oversized_inbound_frame() {
// Arrange
let (mut a, mut b) = duplex(64);
let huge = MAX_FRAME_BYTES + 1;
b.write_all(&huge.to_be_bytes()).await.unwrap();
b.flush().await.unwrap();
// Act
let err = read_response(&mut a).await.unwrap_err();
// Assert
assert!(matches!(err, WireError::FrameTooLarge(n) if n == huge));
}
}