wrap

Wrap up

Close the task: mark it done in TASKS.md, append a CHANGELOG entry, and summarize what shipped.

The lightweight end-of-task ritual that replaces a ticket system. Leaves a durable trail in two committed files — no external service, no time accounting.

Input: optional. If the current branch maps to a TASKS.md entry, use that; otherwise ask which task this wraps (or summarize from the branch's commits).

---

Step 1 — Figure out what shipped

BRANCH=$(git symbolic-ref --short HEAD 2>/dev/null || true)   # empty when detached
BASE="${BASE_BRANCH:-main}"
git log "origin/$BASE..HEAD" --pretty=format:"- %s" 2>/dev/null || git log -10 --pretty=format:"- %s"

Summarize the change in one line a user (or future you) would understand — not a restatement of the commit subjects, the actual outcome ("Reports can now be exported to CSV").

Step 2 — Update TASKS.md

Move the active entry to the Done section, check it off, and stamp the finish date:

- [x] **{title}** — `{branch}` — {start date} → {YYYY-MM-DD}

If there was no TASKS.md entry (the change skipped /plan), add it straight to Done.

Step 3 — Append to CHANGELOG.md

Add a line under ## [Unreleased], grouped by kind (Keep a Changelog style). Create the file from the template if missing.

## [Unreleased]
### Added
- {user-facing summary}        # for feat
### Fixed
- {user-facing summary}        # for fix
### Changed
- {user-facing summary}        # for refactor/behavior change

Only log what's worth a reader's attention — internal chores/tests usually don't need an entry.

Step 4 — Commit the bookkeeping

git add TASKS.md CHANGELOG.md
git commit -m "docs: update tasks and changelog"

(If the PR is already merged and you're on main, commit there; otherwise this rides along on the branch — your call. Mention which you did.)

Output

====================================
WRAP
====================================
Task:      {title}  → done
Shipped:   {one-line outcome}
CHANGELOG: + entry under [Unreleased] / {section}
TASKS.md:  moved to Done

Open tasks remaining: {n}
====================================
Done. 🎉
====================================