Expand description
smix-authoring-propose — the fenced authoring-proposal tier.
A failed flow run leaves a structured bundle on disk (run-summary.json,
*.fail.tree.json, failure.json, screenshots). This crate turns that
bundle, via a local claude CLI, into a Proposal: a machine-checkable
list of edits over the real smix_adapter_maestro::Step /
smix_selector::Selector vocabulary — never an invented predicate smix has
no verb for.
It is an authoring aid, fenced the same way as smix-ai-tier: deletable,
opt-in, non-deterministic. Nothing that senses or acts depends on it.
Structs§
- AiTier
Config - Re-exported so a CLI wire needs only this crate as a dependency, not
smix-ai-tierdirectly — keeping the authoring-propose fence’s allowlist to a single crate. How to reach the judge. - Proposal
- A machine-checkable set of edits over a flow’s
Vec<Step>.
Enums§
- Amend
Error - Why
propose_and_amendcould not turn a failed flow + its bundle into an amended flow yaml. Each arm names the stage that failed; nothing is swallowed and no stage falls back to an empty amend. - Apply
Error - Why
applycould not turn aProposalinto an amended flow. - Proposal
Edit - One structured edit. Internally tagged on
op; the tag value is the variant name lowerCamelCased (replaceSelector,insertStep,reorderStep,replaceStep), while the payload fields stay snake_case to mirror howclaudenaturally names them. - Proposal
Error - Why a
ProposalfailedProposal::validate.
Functions§
- apply
- Validate a
Proposalthen apply its edits to a copy ofsteps, returning the amended flow. Validation runs first (index bounds + insert-wait policy); a failure propagates asApplyError::Invalidrather than a partial mutation. Edits apply in the order the model emitted them. - parse_
proposal_ reply - Pull a
Proposalout of a model reply, tolerating prose around the JSON object — the same forgiving extractionsmix-ai-tieruses for verdicts. - propose_
and_ amend - Glue the C2/C3 pieces into one device-free primitive: read
flow_path, parse it, ask a localclaudeto propose edits from the on-diskbundle_dir, apply them, and emit the amended flow as maestro yaml. - propose_
from_ bundle - Ask a local
claudeto read a failed flow’s bundle and propose edits.