fabro/docs
Bryan Helmkamp 3db2c237e2
Unify fabro run foreground to use create + start + attach (#141)
## Summary

- **Unify foreground and detach code paths**: Both `fabro run` modes now
go through the same `create_run() + start_run()` pipeline, with
foreground adding `attach_run()`. Only `--preflight` remains as a
special case.
- **Fix three bugs in create→start→attach path**: (1) `_run_engine`
crashed for `.fabro` workflows by hardcoding `run.toml` — now falls back
to `graph.fabro`; (2) `attach_run` couldn't detect crashed engines due
to zombie processes — `start_run` now returns the `Child` handle; (3)
`create_run` ignored `--run-id`.
- **Configure nextest slow-timeout profiles**: Tighten unit test timeout
to 2s slow / 4s kill, add `e2e` profile with 10s/30s. Switch CI and docs
to `cargo nextest run`.

## Test plan

- [ ] `cargo nextest run --workspace` passes with new timeout profiles
- [ ] `fabro run <workflow>` works in foreground mode (create + start +
attach)
- [ ] `fabro run --detach <workflow>` prints run ID and exits
- [ ] `fabro attach <run>` works standalone (without child handle)
- [ ] `fabro resume <run>` works for both `.toml` and `.fabro` workflows

🤖 Generated with [Claude Code](https://claude.com/claude-code)

---------

Co-authored-by: Fabro <noreply@fabro.sh>
Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 22:48:09 -04:00
..
administration Update roadmap and standardize on Graphviz terminology 2026-03-16 20:01:33 -04:00
agents Move sandbox lifecycle into the engine (#22) 2026-03-16 22:00:05 -04:00
api-reference Fix missing skip_clone field in OpenAPI spec and conformance test 2026-03-19 13:36:49 -04:00
changelog Extract fabro resume subcommand (#137) 2026-03-22 13:45:06 -04:00
core-concepts Extract fabro resume subcommand (#137) 2026-03-22 13:45:06 -04:00
examples Add SVG workflow diagram for REPL Handoff example 2026-03-17 10:32:48 -04:00
execution Unify fabro run foreground to use create + start + attach (#141) 2026-03-22 22:48:09 -04:00
getting-started Remove empty stub doc pages and fix broken links 2026-03-17 08:25:05 -04:00
human-tools Unify fabro run foreground to use create + start + attach (#141) 2026-03-22 22:48:09 -04:00
images Add SVG workflow diagram for REPL Handoff example 2026-03-17 10:32:48 -04:00
integrations Extract fabro resume subcommand (#137) 2026-03-22 13:45:06 -04:00
languages Add fabro language for syntax highlighting in docs 2026-03-17 09:43:14 -04:00
logo Fix logo SVG viewBox clipping the right edge of the O 2026-03-14 14:11:36 -04:00
reference Extract fabro resume subcommand (#137) 2026-03-22 13:45:06 -04:00
tutorials Update roadmap and standardize on Graphviz terminology 2026-03-16 20:01:33 -04:00
workflows Unify fabro run foreground to use create + start + attach (#141) 2026-03-22 22:48:09 -04:00
.mintignore Fix Mintlify dev server: valid navbar URL and ignore AGENTS.md 2026-03-05 16:29:50 -05:00
docs.json Add Node Outcomes docs page and fix status gaps across docs 2026-03-21 10:05:36 -04:00
dot-highlight.js Remove debug markers from dot-highlight script 2026-03-17 10:23:48 -04:00
favicon.svg Rebrand docs site from Arc to Fabro 2026-03-11 21:27:58 -04:00