Files
Gokul 4a3c5b2e73 docs: catch up on everything that landed after v0.7.3 (#107)
v0.7.3 was tagged back in August and then roughly fifty commits
happened. The docs, predictably, noticed none of this.

The README still advertised four TUI tabs when the TUI now has
seven, still listed three runtime modes when there are four, still
declared artifacts/cache/reusable-workflow outputs as "Not
Supported" when all three shipped in #88 and #94, and never
mentioned `wrkflw watch` or the `--event` / `--diff` /
`--changed-files` flags at all. `wrkflw-trigger-filter` and
`wrkflw-watcher` existed in the workspace without READMEs. Two of
the Rust examples referenced a `runtime` field on
`ExecutionConfig` that is actually called `runtime_type`, and
printed a `summary_status` field that doesn't exist. One
`run_wrkflw_tui` example was missing an argument. That kind of
thing.

While at it, BREAKING_CHANGES.md was labeling three entries as
"(v0.7.3)" when the underlying commits all landed *after* the
v0.7.3 tag — so calling them part of that release was, let's say,
a work of fiction. Relabel as "(Unreleased)" with a note up top
pointing at the next release.

New trigger-filter and watcher READMEs are deliberately short —
most users should hit that code through the CLI flags, not by
depending on the crates directly. No point padding them.

Nothing here is a code change. Just the docs finally telling the
truth about what's in the tree.
2026-04-21 23:43:11 +05:30
..

wrkflw-watcher

File-system watcher with trigger-aware workflow execution. Backs the wrkflw watch subcommand.

  • Debounced change detection via notify
  • Per-workflow trigger cache (built on top of wrkflw-trigger-filter) so only workflows whose on: block matches the change set are rerun
  • Built-in ignore list (.git, target, node_modules, .build, build, dist, __pycache__, .tox, .mypy_cache, .pytest_cache, .venv, venv) plus user-supplied --ignore-dir values
  • Concurrency cap per cycle, pending-event bound, and strict-filter mode that rejects degraded event contexts with a loud error
  • Graceful shutdown via the shared shutdown signal

Consumers: wrkflw CLI (watch subcommand). Prefer the CLI unless you are embedding the watcher into another tool.