Milo 0.3.0
Agent-native scaffolding and verification, Kida 0.7 templates, terminal layout filters, and contract hardening.
Feature release focused on agent-native CLI authoring, stricter template contracts, release stewardship, and command/MCP/schema parity hardening.
Highlights
- Agent-native authoring —
milo new <name>scaffolds a tested CLI project, andmilo verify <path>runs import, schema, dispatch, in-process MCP, and subprocess MCP transport checks. - Agent repair loops — MCP validation errors now carry structured argument and constraint context;
llms.txtoutput marks required, optional, and defaulted inputs more clearly. - Kida 0.7 adoption — Milo now uses
kida-templates>=0.7.0,<0.8.0, with inline component compilation and validated template calls enabled by default. - Strict undefined templates — Stock templates already satisfy strict rendering. User templates that relied on silent undefined fallbacks now raise
UndefinedError; passget_env(strict_undefined=False)to keep loose rendering. - Terminal layout filters — New display-cell filters and open-rule helpers make table, frame, divider, meter, and truncation output align by rendered cell width.
- Steward system — Scoped
AGENTS.mdfiles define ownership, contract checklists, consultation triggers, and review expectations across core, docs, tests, templates, examples, site, benchmarks, and scaffold domains.
Added
milo componentsfor listing bundled and user-defined Kida component defs, with--jsonoutput for tooling and--pathfor extra template directories.milo.livere-exports forLiveRenderer,Spinner,stream_to_terminal, andterminal_env.function_to_schema(..., warn_missing_docs=True)to surface undocumented typed parameters during verification.form_schema()for form introspection.- Agent docs, testing guidance, migration recipes, example docs, and optional Markdown snippet verification.
- Silent-exception linting with explicit
# silent: <reason>annotations. - Output-gallery guidance, scaffolded verification coverage, terminal cleanup checks, dispatch lock edge coverage, and display-cell rendering benchmarks.
Changed
get_env()defaults toinline_components=Trueandvalidate_calls=True, and acceptsenable_capturefor static-site and capture flows.- Gateway, registry, and saga executor pools use Kida workload-aware worker sizing.
pipeline_progressandpipeline_detailtemplates include flush boundaries to encode their streaming contract.- Documentation site navigation is reorganized around reader intent: About, Get Started, Build CLIs, Build Apps, Quality and Operations, Reference, Examples, and Applied Tutorials.
- Steward guidance now includes evidence-backed review finding format, collateral update rules, synthesis requirements, and parity-matrix expectations.
- Internal code adopts more Python 3.14 patterns, including PEP 695 type aliases, pattern matching in form key handlers, and frozen/slotted dataclasses in tests.
Fixed
- Contract regressions found in the project-wide bugbash across command dispatch, MCP, schema generation, app runtime, flow, form,
llms.txt, and docs. - Context injection parity, JSON-RPC invalid-request handling, gateway progress routing, Store shutdown/listener serialization, and CLI/schema contract drift.