fsmp 0.1.1

FSM Prompter — a CLI that steers AI agents through workflows by re-prompting them at each transition
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

//! `fsmp` — FSM Prompter: prompt-driven workflows backed by extended finite
//! state machines.
//!
//! A **definition** ([`model::Definition`]) is a static workflow, authored
//! ahead of the run — by a person, or by an agent working with one — and kept
//! in version control: states carrying prose guidance, guarded transitions
//! with effects, read-only params, and mutable context. The agent driving a
//! machine never authors or mutates its own definition. An **instance**
//! ([`model::Instance`]) is one live run — a snapshot of the definition taken
//! at creation, plus the current state, the context, and a transition log.
//!
//! The pieces:
//!
//! - [`model`] — the data types for definitions and instances.
//! - [`engine`] — guard evaluation, effect application, and `{var}`
//!   interpolation, implemented as methods on [`model::Instance`].
//! - [`render`] — turns an instance into the step text an agent acts on
//!   (prose or JSON).
//! - [`lint`] — checks a definition for authoring problems (unreachable
//!   states, dead ends, unknown targets) without instantiating it.
//! - [`store`] — definition parsing/validation and the on-disk instance
//!   layout under `$FSMP_HOME` (default `~/.fsmp`).
//! - [`guide`] — the embedded authoring/driving reference docs.
//!
//! The primary interface is the `fsmp` CLI (this crate's binary), whose
//! primary user is an AI coding agent driving one transition at a time. This
//! library exposes the same engine for embedding in another transport or
//! harness. The API is pre-1.0 and may change.

pub mod engine;
pub mod guide;
pub mod lint;
pub mod model;
pub mod render;
pub mod store;