wallfacer-core 0.8.1

Runtime fuzzing and invariant-testing harness for MCP servers — catch crashes, hangs, schema drift, and state leaks before they ship.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

//! Plan-based execution layer.
//!
//! Phase C moves the orchestration logic that used to live in
//! `mcp-wallfacer-cli`'s command modules into the core, so that:
//!
//! * commands stay below 200 LOC and are limited to argument parsing,
//!   reporter selection, and exit-code mapping;
//! * plans are testable without spawning a real MCP server, via
//!   [`exec::MockClient`];
//! * alternate front-ends (web UI, library use) can drive the same plans
//!   with a custom [`reporter::Reporter`].
//!
//! Each plan owns its own input arguments and produces a typed report. The
//! plan executes against any [`exec::McpExec`] (the production [`Client`]
//! or [`exec::MockClient`]) and notifies a [`reporter::Reporter`] live as
//! findings happen.
//!
//! [`Client`]: crate::client::Client

pub mod destructive;
pub mod differential;
pub mod exec;
pub mod fuzz;
pub mod glob;
pub mod pack;
pub mod property;
pub mod reporter;
pub mod sequence;
pub mod torture;

pub use destructive::{DestructiveDetector, ToolClassification};
pub use differential::{DifferentialPlan, DifferentialReport};
pub use exec::{McpExec, MockClient};
pub use fuzz::{FuzzOutcome, FuzzPlan, FuzzReport, SkippedTool};
pub use pack::{
    embedded_pack_names, embedded_pack_source, resolve as resolve_pack, EmbeddedLoader,
    LayeredLoader, PackError, PackLoader, EMBEDDED_PACKS,
};
pub use property::{parse_invariants, MissingTool, PropertyPlan, PropertyReport};
pub use reporter::{NoopReporter, Reporter, RunInfo};
pub use sequence::{
    evaluate_sequence_fixture, SequenceFixtureOutcome, SequencePlan, SequenceReport,
    SkippedSequence,
};
pub use torture::{parse_duration, TortureMode, TortureReport, TortureRun};