Documentation
¶
Overview ¶
Command fakemodule is a deterministic module used to test the host's module boundary without involving Facet, Midden, a network, or a paid provider.
It is a REAL detached module: the host discovers and executes it exactly as it would any other, over the same two verbs and the same wire contract. That is the point -- a mock inside the host would test the host's idea of a module, whereas this tests the boundary itself.
It also deliberately misbehaves on demand. Capabilities under fake.misbehave produce the protocol violations the host must survive: stdout pollution, oversized output, a hung process, a path escaping its root, and a process that ignores termination. Those paths exist so the host's bounds are proven against a real process rather than a fixture.
fakemodule module describe --json fakemodule module invoke <capability> --input <request.json>