Skip to content

flowfig 0.2.0

Choose a tag to compare

View all tags
@iamalvisng iamalvisng released this 30 Sep 03:14
· 290 commits to main since this release
v0.2.0
ef50e57

Figures that link to the code they draw, a GitHub Action that checks them on every pull request, and an MCP server for agents with no shell.

npx flowfig verify docs/*.svg   # fails when a linked file or symbol is gone

New

  • Code links. A box, an edge or a hop takes "source": "src/auth/login.ts#verifyPassword". The link is stored in the SVG with the spec.
  • flowfig verify. Checks every link and reports missing-file, missing-symbol and no-source. Options: --root, --strict, --json.
  • flowfig diff old.svg new.svg. Shows what changed between two figures: boxes, edges, steps, messages, groups and the rail. --md for a PR comment, --json for a script.
  • GitHub Action. uses: iamalvisng/flowfig@v0.2.0 runs verify on every figure in a PR. For each changed SVG, it comments the old and new image with the diff, and it names each figure whose linked code the PR changes.
  • flowfig mcp. An MCP server over stdio with the tools docs, check, render, verify and diff.
  • flowfig init registers the MCP server for Claude Code, Cursor, GitHub Copilot, Gemini CLI and Kiro. It adds one entry and never replaces an entry that you changed. --no-mcp skips it.
  • New entry point flowfig/verify for Node. flowfig and flowfig/svg still load in a browser.

Improvements

  • Agents now add code links to their figures and run verify before they reply.

Fixes

  • flowfig --help, -h and help print the usage.
  • A rail with many messages over several steps no longer reports a false label-overlap.
  • A clean render prints 0 errors, 0 warnings.
  • flowfig --spec on a missing file prints a message, not a stack trace.

Requirements

  • Node 18 or later.
  • React 18 or later, only for the <Flow /> player.

Upgrade

No breaking change. Figures without links pass verify with a no-source warning.

Full Changelog: v0.1.0...v0.2.0

Assets 2
Loading