## Stack

- **Language:** Python 3.11+
- **CLI:** Typer + Rich
- **Config:** TOML
- **Packaging:** setuptools + setuptools_scm (`src/` layout)
- **Tests:** pytest

## Dev Commands

```bash
# Recommended: install latest development code
make dev-install

# Run tests
make test
# or: python3 -m pytest tests/ -q

# Build distribution packages
make dist
make release-prep
make check-dist

# Run the assistant
cya "your natural language request here"
cya --help
cya --explain-context "show me what context would be collected"
cya retrospect

# Version / inspection
make version
git status --short
rg --files
```

Current memory baseline: **Profile 0** (local JSON + activation + retrospection).
Profile 1 verbal reflections shipped as a minimal spike (CYA-WP-0005); production
hardening tracked in CYA-WP-0006.