Skip to content

v3.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 06 Jul 01:30
· 74 commits to main since this release
v3.0.0
ed504e2

3.0.0 (2026-07-06)

  • docs(v3)!: terminology sweep + v3 docs; retire MA_COMMAND references (fcaf4c2)
  • feat!: mdflow v3 — markdown agents that evolve (7d521a6)
  • feat(engine)!: resolution ladder with a default engine; engine: replaces tool: (0889b9f)

Bug Fixes

  • command: dedupe shell arg escaping (bbbc9d0)
  • core: wire MdflowError handling in config and entrypoint (5af774b)
  • imports: constrain markerless root fallback (fb0af00)
  • imports: harden path and URL import validation (06e0a1a)
  • tests: restore green baseline before v3 work (9ab4620), closes #13

Features

  • adapters: add portable agent spec with provider-agnostic frontmatter translation (0497bd1)
  • adapters: pi (hermetic default engine), cursor-agent, and agy (Antigravity) (d421ae8)
  • cli: add --json output mode for scripting and CI integration (cb0b4a7)
  • context: add context provider registry with git, tree, and rg providers (f7b4671)
  • context: wire context providers into import parser and expansion (f598322)
  • engine: filename rung only claims runnable engines; eval --filter guardrail (b7a245f)
  • errors: add MdflowError base and ValidationError (b866d59)
  • eval,engine: repo-bound eval cases; description/route are reserved keys (6bff9af)
  • eval: md eval — behavioral eval suites for flows with a trust ledger (ebb5082)
  • guardrails: enforce _max_prompt_tokens; adhoc engines match the ladder (f7ebb68)
  • output: add structured output extraction, validation, and sink module (53dd2ff)
  • output: wire structured output processing into CLI runner and post-run menu (a250771)
  • pi: Codex-subscription auth bridge + adapter prepareEnv hook (07668c4)
  • registry: add agent registry with install/remove/list and lockfile integrity (b54807d)
  • schema: enforce typed _inputs and parse result unions (28dfcc1)
  • skill: installable agent skill — npx skills add johnlindquist/mdflow (ad2b0e8)
  • spike: add Bun p-queue compatibility PoC (b3887cd)
  • telemetry: add run telemetry logging (7bd4781)
  • workflow: add multi-step workflow engine with DAG execution and step caching (5287827)

BREAKING CHANGES

  • engine: replaces tool:, bare .md files run on the resolved
    engine or print as documents, description/route are reserved frontmatter
    keys. See the v3 commit series for details.

Co-Authored-By: Claude Fable 5 noreply@anthropic.com

Conflicts:

CHANGELOG.md

package.json

  • docs and examples now describe v3 semantics (engine:,
    default engine pi, document rule for frontmatter-less files).

Co-Authored-By: Claude Fable 5 noreply@anthropic.com

  • bare .md files no longer error with COMMAND_MISSING — they
    either run on the resolved engine (frontmatter present) or print as
    documents (no frontmatter). Frontmatter tool:/_tool: still resolve but warn;
    use engine:. --engine is the canonical flag; --_command/-_c/--tool remain as
    deprecated aliases. resolveCommand() no longer throws for missing commands.

Co-Authored-By: Claude Fable 5 noreply@anthropic.com

Assets 2
Loading