# Tasks

**Path:** `/Users/rbutare/websites/apps/docgen`

## Done

- [x] Core CLI (`docgen.py`) with argparse
- [x] Extractors: Python, JS, PHP, Shell, CSS, SQL, HTML
- [x] Markdown & HTML report renderers
- [x] Version + purpose heuristics
- [x] Bootstrap installer (`install.sh`)
- [x] `install-local.sh` for binary install
- [x] Test harness (`test.sh`)
- [x] Example files for all supported languages
- [x] README / STATUS / TASKS / FAQ

## Next (optional)

- [ ] TypeScript / TSX extractor
- [ ] Stronger JSDoc / PHPDoc `@param` / `@return` parsing
- [ ] Shell positional-arg inference from `$1` usage
- [ ] Optional JSON report format
- [ ] Git pre-commit / CI example workflow
- [ ] Config file (include/exclude globs)
- [ ] Improve JS docblock attachment

## Ideas

- Watch mode (`-w`) for live regen
- Diff against previous docs run
- Cross-file call graph (lightweight)