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 authoringmilo new <name> scaffolds a tested CLI project, and milo 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 useskida-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 raiseUndefinedError; pass get_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 — ScopedAGENTS.mdfiles define ownership, contract checklists, consultation triggers, and review expectations across core, docs, tests, templates, examples, site, benchmarks, and scaffold domains.

Added

  • milo components for listing bundled and user-defined Kida component defs, with --json output for tooling and --pathfor extra template directories.
  • milo.live re-exports for LiveRenderer, Spinner, stream_to_terminal, and terminal_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 to inline_components=True and validate_calls=True, and accepts enable_capturefor static-site and capture flows.
  • Gateway, registry, and saga executor pools use Kida workload-aware worker sizing.
  • pipeline_progress and pipeline_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.