Add human-friendly v0.4.0 changelog

Author: Adjanour

CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+This changelog tracks user-visible improvements to SESS.
+
+## v0.4.0 - 2026-04-02
+
+SESS now includes a first pass at built-in session analytics, so you can see what you worked on without opening the SQLite database by hand.
+
+### What's new
+
+- Added `sess history` to show recent sessions for the current project.
+- Added `sess stats` to show totals such as session count, total time, average duration, and longest session.
+- Added `sess report` as a compact summary view that combines stats with recent session activity.
+- Added `--all` support to `sess history`, `sess stats`, and `sess report` for cross-project views across every tracked repository on the machine.
+
+### Why it matters
+
+- You can answer simple questions like "what was I working on last week?" or "which repo has consumed most of my time lately?" directly from the CLI.
+- Cross-project analytics make SESS more useful when you regularly move between multiple repositories.
+- The new report command gives you a fast status summary without stitching together multiple commands.
+
+### Notes
+
+- This release builds on the existing session workflow introduced in earlier versions. It does not change `sess start`, `sess pause`, `sess resume`, or `sess end` behavior.
+- Analytics are still local-only and read from the existing SQLite database at `~/.sess-cli/sess.db`.
+
+## v0.3.1
+
+Previous release. See the GitHub release page for details:
+https://github.com/Orctatech-Engineering-Team/sess-cli/releases/tag/v0.3.1

README.md

@@ -161,4 +161,5 @@ sudo install -m 0755 sess /usr/local/bin/sess
 ## Releases
 
 - [Latest release](https://github.com/Orctatech-Engineering-Team/sess-cli/releases/latest)
+- [v0.4.0 release](https://github.com/Orctatech-Engineering-Team/sess-cli/releases/tag/v0.4.0)
 - [v0.3.1 release](https://github.com/Orctatech-Engineering-Team/sess-cli/releases/tag/v0.3.1)

docs/releases/v0.4.0.md

@@ -0,0 +1,58 @@
+# SESS v0.4.0
+
+SESS v0.4.0 adds the first user-facing analytics commands.
+
+Instead of treating session data as something buried in SQLite, you can now inspect recent work directly from the CLI, either for the current repository or across every tracked project on your machine.
+
+## Highlights
+
+- `sess history` shows recent sessions, including paused, active, and ended work.
+- `sess stats` shows totals, averages, longest-session data, and PR counts.
+- `sess report` gives you a compact summary with both aggregate metrics and recent sessions.
+- `--all` support on `history`, `stats`, and `report` lets you view cross-project activity without changing directories.
+
+## Example commands
+
+```bash
+sess history
+sess history --all --limit 10
+sess stats
+sess stats --all
+sess report
+sess report --all
+```
+
+## Installation
+
+### Quick install
+
+```bash
+curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.4.0/install.sh | sudo bash
+```
+
+By default this installs `sess` to `/usr/local/bin/sess`.
+
+To install into `/usr/bin` instead:
+
+```bash
+curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.4.0/install.sh | sudo env SESS_INSTALL_DIR=/usr/bin bash
+```
+
+### Manual install
+
+```bash
+curl -fsSL https://github.com/Orctatech-Engineering-Team/sess-cli/releases/download/v0.4.0/sess-linux-amd64.tar.gz | tar xz
+sudo install -m 0755 sess /usr/local/bin/sess
+```
+
+### Verify
+
+```bash
+sess --version
+```
+
+Expected output:
+
+```text
+SESS v0.4.0
+```