Metadata-Version: 2.4
Name: eawf
Version: 0.5.4
Summary: Eä Workflow — agent-driven development framework
Project-URL: Homepage, https://github.com/Elementarno9/eawf
Project-URL: Repository, https://github.com/Elementarno9/eawf
Project-URL: Documentation, https://github.com/Elementarno9/eawf/tree/main/docs
Project-URL: Issues, https://github.com/Elementarno9/eawf/issues
Project-URL: Changelog, https://github.com/Elementarno9/eawf/blob/main/CHANGELOG.md
Author-email: Elementarno9 <edwardpro9@gmail.com>
License: MIT
License-File: LICENSE
Requires-Python: >=3.14
Requires-Dist: click<8.4,>=8.1
Requires-Dist: jinja2>=3.1.0
Requires-Dist: orjson>=3.11.9
Requires-Dist: portalocker>=3.2.0
Requires-Dist: pydantic>=2.13.4
Requires-Dist: pyyaml>=6.0.3
Requires-Dist: questionary>=2.1.1
Requires-Dist: rich>=15.0.0
Requires-Dist: textual>=8.0
Requires-Dist: typer<0.26,>=0.25.1
Provides-Extra: docs
Requires-Dist: mkdocs-material>=9.5; extra == 'docs'
Requires-Dist: mkdocs>=1.6; extra == 'docs'
Provides-Extra: windows
Requires-Dist: pywin32>=306; extra == 'windows'
Description-Content-Type: text/markdown

# eawf — Eä Workflow

State-first, agent-driven development framework. Parallel waves, strict
schema, Claude Code adapter.

## Install

```bash
git clone <repo> && cd eawf && uv sync
# or, install as a tool from the local checkout:
uv tool install --from . eawf
```

## Quickstart (new project)

```bash
cd /path/to/your/repo
eawf init                            # interactive wizard
eawf plugin install claude           # render local .claude/ skills/agents/hooks
eawf phase open --auto --title "Bootstrap"
```

## Workflow

```
research → plan → execute (parallel waves) → cherry-pick → ship phase
```

Use slash commands `/research`, `/prep`, `/audit`, `/ship`, `/review`,
`/polish`, or `/flow` to drive the lifecycle.

## Contributing

See [CONTRIBUTING.md](CONTRIBUTING.md) for local development setup,
harness plugin setup, and verification commands.

## What gets committed

- `.ea/state.json` — canonical project ledger. The **eawfd daemon** is the
  sole canonical mutator; the `eawf` state CLI proxies mutations to it over
  JSON-RPC and falls back to a direct `portalocker` write only when the
  daemon is unavailable (CI / one-shot / recovery). Read access is free.
- `AGENTS.md` — agent contract (regenerated by `eawf sync`; user region
  preserved on re-render).

The Claude Code plugin tree (`.claude/` + `CLAUDE.md`) and any user-local
files (`.claude/settings.local.json`) stay gitignored — they are
machine-specific renders, not committed assets. Re-render anytime via
`eawf plugin install claude`.

## Docs

See `docs/` — architecture, CLI surface, schemas, policy. Start with the
[source map](docs/architecture/source-map.md) for a one-line-per-package
index of `src/eawf/`, then the [architecture overview](docs/architecture/overview.md).

## License

MIT — see `LICENSE`.
