Metadata-Version: 2.4
Name: ai-hats-tracker
Version: 0.3.0
Summary: Standalone task-card schema, worktree-free task FSM, and backlog CLI for the ai-hats framework (TaskCard + TaskManager + `task`/`attach`).
Project-URL: Homepage, https://github.com/muratovv/ai-hats
Project-URL: Repository, https://github.com/muratovv/ai-hats
Project-URL: Changelog, https://github.com/muratovv/ai-hats/blob/master/packages/ai-hats-tracker/CHANGELOG.md
Author-email: muratovv <f@muratovv.me>
License-Expression: MIT
License-File: LICENSE
Keywords: ai-hats,backlog,state-machine,task,tracker
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Requires-Dist: ai-hats-core>=0.4.0
Requires-Dist: click>=8.1
Requires-Dist: filelock>=3.12
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: rich>=13.0
Provides-Extra: wt
Requires-Dist: ai-hats-wt>=0.2.1; extra == 'wt'
Description-Content-Type: text/markdown

# ai-hats-tracker

A standalone **task-card schema + worktree-free task state machine**: create a
task, walk it through the `brainstorm → plan → execute → document → review →
done` lifecycle, link cards, log work, and render `STATE.md` — on a bare
directory, with no configuration.

`ai-hats-tracker` is the tracker core extracted from the
[ai-hats](https://github.com/muratovv/ai-hats) framework. It has no dependency on
the `ai-hats` integrator: everything below runs against a plain directory with no
`ai-hats.yaml`, no composition, and no worktree engine. Its only runtime
dependencies are [`ai-hats-core`](https://pypi.org/project/ai-hats-core/)
(dependency-free filesystem primitives), [`pydantic`](https://pypi.org/project/pydantic/),
[`PyYAML`](https://pypi.org/project/PyYAML/), and
[`filelock`](https://pypi.org/project/filelock/).

## Install

```sh
pip install ai-hats-tracker
```

Requires Python 3.11+.

## Status

Version `0.1.0`: the TaskCard schema and the worktree-free task FSM. The
standalone backlog CLI (0.2.0) and hypotheses/proposals (0.3.0) follow in later
increments.

## License

MIT. See the [ai-hats repository](https://github.com/muratovv/ai-hats) for the
full license and contribution guide.
