Skip to content

feat(jade): JadeFlow Week 1 foundation — DAG engine, CLI, persistence#4

Open
alex-jadecli wants to merge 1 commit into
mainfrom
claude/jadeflow-orchestration-Roh1w
Open

feat(jade): JadeFlow Week 1 foundation — DAG engine, CLI, persistence#4
alex-jadecli wants to merge 1 commit into
mainfrom
claude/jadeflow-orchestration-Roh1w

Conversation

@alex-jadecli
Copy link
Copy Markdown
Owner

Summary

  • Core DAG engine with @flow/@task decorators, topological sort (Kahn's algorithm), sequential executor with retries, upstream failure propagation, and result passing between tasks
  • SQLAlchemy persistence layer with 6 ORM tables (workflows, runs, tasks, instances, logs, config_store), repository pattern, SQLite backend
  • Typer CLI (jade init, run, status, validate, graph, version) — define workflows in Python and execute from the command line
  • Feature flag system with 3-tier override (defaults → ~/.jade/flags.json → env vars) and cached loading
  • Per-module CLAUDE.md files enforcing scope boundaries across core/, cli/, db/, ai/, plugins/
  • 3 example workflows (hello_world, etl_pipeline with retries, fan-out/fan-in parallel_tasks)
  • 90 unit tests covering all modules — models, state machine, DAG, decorators, executor, flags, DB, CLI

Test plan

  • pytest tests/jade/ -v — 90 tests pass
  • ruff check jade/ tests/jade/ examples/ — clean
  • jade run examples/hello_world.py hello_world — executes successfully
  • jade validate examples/etl_pipeline.py etl_pipeline — validates DAG
  • jade graph examples/parallel_tasks.py parallel_pipeline — renders ASCII DAG

https://claude.ai/code/session_01MsF8rLi2Q2BHcdvdvNfjeC

…LI, and persistence

Complete Week 1 deliverable from the JadeFlow Bible: define workflows in Python
and run them via CLI. Includes:

- Core DAG engine with @flow/@task decorators and topological sort (Kahn's algorithm)
- Sequential executor with retry logic, upstream failure propagation, and result passing
- Task/flow state machines with validated transitions
- SQLAlchemy ORM models (6 tables: workflows, runs, tasks, instances, logs, config)
- Repository pattern for data access
- Typer CLI: jade init, run, status, validate, graph, version
- Feature flag system (defaults + file + env var override, cached)
- Per-module CLAUDE.md files enforcing scope boundaries
- 3 example workflows (hello_world, etl_pipeline, parallel_tasks)
- 90 unit tests covering all modules (100% pass rate)

https://claude.ai/code/session_01MsF8rLi2Q2BHcdvdvNfjeC
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants