# reci

> Compile declarative CI recipes into fully-wired GitHub Actions workflows with typed data-flow validation.


## Pages

- [reci](index.html.md): Compile declarative CI recipes into fully-wired GitHub Actions workflows with typed data-flow valida...
- [API reference](api.html.md): | `reci`   | reci — Compile declarative CI recipes into GitHub Actions workflows.   |
- [reci](_autosummary/reci.html.md): reci — Compile declarative CI recipes into GitHub Actions workflows.
- [reci.action_spec](_autosummary/reci.action_spec.html.md): Action contract model — parsed from `action.yml` metadata.
- [reci.adapters](_autosummary/reci.adapters.html.md): Config adapter registry.
- [reci.adapters.base](_autosummary/reci.adapters.base.html.md): ConfigAdapter protocol — interface for reading/writing CI config.
- [reci.adapters.package_json](_autosummary/reci.adapters.package_json.html.md): PackageJsonAdapter — reads `"ci"` key from package.json.
- [reci.adapters.pyproject](_autosummary/reci.adapters.pyproject.html.md): PyprojectTomlAdapter — reads `[tool.ci]` via tomlkit, round-trip preserving.
- [reci.adapters.wads](_autosummary/reci.adapters.wads.html.md): WadsAdapter — reads `[tool.wads.ci]` for backward compatibility.
- [reci.adapters.yaml_adapter](_autosummary/reci.adapters.yaml_adapter.html.md): YamlAdapter — reads `.ci.yml` via ruamel.yaml.
- [reci.compiler](_autosummary/reci.compiler.html.md): Compiler — recipe + action specs + config → GitHub Actions workflow YAML.
- [reci.config](_autosummary/reci.config.html.md): Config resolution — flat dict with scoped overrides.
- [reci.graph](_autosummary/reci.graph.html.md): Recipe DAG — computational graph built on `graphlib`.
- [reci.recipe](_autosummary/reci.recipe.html.md): Recipe model — declarative CI pipeline description.
- [reci.recipe_checks](_autosummary/reci.recipe_checks.html.md): Whole-recipe checks that need the recipe text and the config, not the step graph.
- [reci.validation](_autosummary/reci.validation.html.md): Validation system — ESLint-style severity, ruff-style rule prefixes.
- [reci.validation.formatters](_autosummary/reci.validation.formatters.html.md): Output formatters for validation reports.
- [reci.validation.report](_autosummary/reci.validation.report.html.md): Core validation data structures.
- [reci.validation.rules](_autosummary/reci.validation.rules.html.md): Validation rule registry and runner.
- [reci.validation.rules.action](_autosummary/reci.validation.rules.action.html.md): Action metadata validation rules (ACT001–ACT003).
- [reci.validation.rules.config_rules](_autosummary/reci.validation.rules.config_rules.html.md): Config validation rules (CONF001–CONF003).
- [reci.validation.rules.dag](_autosummary/reci.validation.rules.dag.html.md): DAG structure validation rules (DAG001–DAG004).
- [reci.validation.rules.flow](_autosummary/reci.validation.rules.flow.html.md): Data-flow validation rules (FLOW001–FLOW007).
- [reci.validation.rules.purity](_autosummary/reci.validation.rules.purity.html.md): Purity validation rules (PURE001–PURE003).
- [reci.yaml_gen](_autosummary/reci.yaml_gen.html.md): YAML I/O wrapper using ruamel.yaml (YAML 1.2).
- [For AI agents](ai-agents.html.md): `reci` ships artifacts for coding agents alongside its code. This page lists
- [About this build](about-this-build.html.md): This documentation was built on **2026-10-13 23:26 UTC** from commit <a href="https://github.com/i2m...

## Optional

- [reci.md](reci.md): Complete documentation in a single file.

## Build

- [build_info.json](build_info.json): build provenance (commit, version, tool versions, whether the docs match the package)