chore: refactor release automation and optimize commit extension (#3)

* docs(readme): update installation instructions and extension table

* chore: add changelog extraction script and auto-release workflow

* docs(changelog): document auto-release workflow and command updates

* docs(changelog): document sandbox runtime toggling and commit extension overhaul

* docs(changelog): add release notes summary

* refactor(commit): optimize token usage and consolidate ai calls

* docs: update changelog

Author: kostyay

.github/scripts/extract-changelog.py

@@ -0,0 +1,98 @@
+#!/usr/bin/env python3
+"""Extract release notes from CHANGELOG.md.
+
+Tries in order:
+  1. Body under "## Unreleased"
+  2. Body under a heading matching the given version (e.g. ## 1.2.0, ## [1.2.0](...))
+  3. Git commit log since the last tag
+
+Usage:
+    python extract-changelog.py <version> <output-file>
+"""
+
+import re
+import subprocess
+import sys
+from pathlib import Path
+
+
+def extract_section(changelog: str, heading_match: str) -> str:
+    """Return the body text between a ## heading matching `heading_match` and the next ## heading."""
+    lines = changelog.splitlines()
+    capturing = False
+    body: list[str] = []
+
+    for line in lines:
+        if line.startswith("## "):
+            if capturing:
+                break
+            # Strip markdown link syntax: ## [1.2.0](url) - date  ->  1.2.0
+            title = re.sub(r"^## \[?", "", line)
+            title = re.sub(r"[\]( -].*", "", title).strip()
+            if title == heading_match:
+                capturing = True
+                continue
+        elif capturing:
+            body.append(line)
+
+    return "\n".join(body).strip()
+
+
+def git_log_fallback() -> str:
+    """Return commit messages since the last tag, or all commits if no tags exist."""
+    try:
+        base = subprocess.check_output(
+            ["git", "describe", "--tags", "--abbrev=0"],
+            stderr=subprocess.DEVNULL,
+            text=True,
+        ).strip()
+    except subprocess.CalledProcessError:
+        base = subprocess.check_output(
+            ["git", "rev-list", "--max-parents=0", "HEAD"],
+            text=True,
+        ).strip()
+
+    log = subprocess.check_output(
+        ["git", "log", f"{base}..HEAD", "--pretty=format:* %s"],
+        text=True,
+    ).strip()
+    return log
+
+
+def main() -> None:
+    if len(sys.argv) != 3:
+        print(f"Usage: {sys.argv[0]} <version> <output-file>", file=sys.stderr)
+        sys.exit(1)
+
+    version = sys.argv[1]
+    output_path = Path(sys.argv[2])
+
+    changelog_path = Path("CHANGELOG.md")
+    if not changelog_path.exists():
+        print("CHANGELOG.md not found, falling back to git log", file=sys.stderr)
+        output_path.write_text(git_log_fallback())
+        return
+
+    changelog = changelog_path.read_text()
+
+    # 1. Try "Unreleased"
+    notes = extract_section(changelog, "Unreleased")
+    if notes:
+        print(f"Extracted release notes from '## Unreleased' ({len(notes)} chars)")
+        output_path.write_text(notes)
+        return
+
+    # 2. Try version match
+    notes = extract_section(changelog, version)
+    if notes:
+        print(f"Extracted release notes from '## {version}' ({len(notes)} chars)")
+        output_path.write_text(notes)
+        return
+
+    # 3. Fallback to git log
+    print("No changelog section found, falling back to git log", file=sys.stderr)
+    output_path.write_text(git_log_fallback())
+
+
+if __name__ == "__main__":
+    main()

.github/workflows/npm-publish.yml

@@ -0,0 +1,50 @@
+name: Auto Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Read version from package.json
+        id: version
+        run: |
+          VERSION=$(node -p "require('./package.json').version")
+          echo "version=$VERSION" >> "$GITHUB_OUTPUT"
+          echo "tag=v$VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Check if tag already exists
+        id: check
+        run: |
+          if git rev-parse "v${{ steps.version.outputs.version }}" >/dev/null 2>&1; then
+            echo "exists=true" >> "$GITHUB_OUTPUT"
+          else
+            echo "exists=false" >> "$GITHUB_OUTPUT"
+          fi
+
+      - name: Extract changelog
+        if: steps.check.outputs.exists == 'false'
+        run: python3 .github/scripts/extract-changelog.py "${{ steps.version.outputs.version }}" /tmp/release-notes.md
+
+      - name: Create tag and GitHub release
+        if: steps.check.outputs.exists == 'false'
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: |
+          TAG="${{ steps.version.outputs.tag }}"
+          git tag "$TAG"
+          git push origin "$TAG"
+          gh release create "$TAG" \
+            --title "$TAG" \
+            --notes-file /tmp/release-notes.md

.github/workflows/release.yml

@@ -2,6 +2,7 @@
 
 All notable changes to agent-stuff are documented here.
 
+
 ## git-rebase-master
 
 Added `/git-rebase-master` command that fetches the latest `main` or `master`
@@ -16,6 +17,10 @@ new `autoBranch` option on `performCommit`.
 `/commit-push-pr` now creates PRs in ready mode by default instead of draft
 mode, streamlining the publish workflow for most use cases.
 
+## docs/update-readme-and-sandbox
+
+The commit extension was overhauled to dramatically reduce token consumption by gathering changelog context deterministically through git/gh commands and calling the model once for summary generation, with the new `/merge-pr` command streamlining the full pre-merge workflow including changelog updates, incremental PR description refresh, and squash-merge with cleanup. The sandbox extension now supports runtime toggling via `/sandbox on` and `/sandbox off` commands with a visual status indicator, eliminating the need to restart. An auto-release workflow now replaces the npm-publish pipeline, automatically creating GitHub tags and releases on main merges when `package.json` version changes, with release notes extracted from `CHANGELOG.md` via a new Python script that falls back to the git commit log. (#3)
+
 ## Unreleased
 
 * Added the `/plan` command for read-only planning mode with interactive brainstorming via the `ask_question` tool. Supports Shift+Tab mode toggle and an always-visible mode status indicator.

CHANGELOG.md

@@ -6,13 +6,7 @@ Extensions, skills, and themes for [Pi](https://buildwithpi.ai/), the coding age
 
 ## Installation
 
-Install as a Pi package (extensions, skills, and themes are all discovered automatically):
-
-```bash
-pi install npm:kostyay-agent-stuff
-```
-
-Or install from git:
+Install from git (extensions, skills, and themes are all discovered automatically):
 
 ```bash
 pi install git:github.com/kostyay/agent-stuff
@@ -32,6 +26,7 @@ All extensions live in [`pi-extensions/`](pi-extensions). Each file is a self-co
 |-----------|-------------|
 | [`answer.ts`](pi-extensions/answer.ts) | Extracts questions from assistant responses and presents an interactive TUI for answering them one by one |
 | [`clear.ts`](pi-extensions/clear.ts) | `/clear` command — starts a new session (alias for `/new`) |
+| [`commit.ts`](pi-extensions/commit.ts) | `/commit` command — stages all changes, generates a Conventional Commits message via LLM, creates a side branch if on the default branch |
 | [`context.ts`](pi-extensions/context.ts) | `/context` command — shows loaded extensions, skills, AGENTS.md/CLAUDE.md, and token usage |
 | [`control.ts`](pi-extensions/control.ts) | Session control via Unix domain sockets for inter-session communication |
 | [`files.ts`](pi-extensions/files.ts) | `/files` command — file browser merging git status with session-referenced files, plus diff/edit actions |
@@ -42,10 +37,10 @@ All extensions live in [`pi-extensions/`](pi-extensions). Each file is a self-co
 | [`prompt-editor.ts`](pi-extensions/prompt-editor.ts) | Prompt mode selector (default/fast/precise) with per-mode model & thinking persistence |
 | [`review.ts`](pi-extensions/review.ts) | `/review` command — code review for uncommitted changes, PRs, or specific commits with optional auto-fix loop |
 | [`session-breakdown.ts`](pi-extensions/session-breakdown.ts) | `/session-breakdown` command — analyzes session usage (cost by model) with a GitHub-style activity graph |
+| [`simplify.ts`](pi-extensions/simplify.ts) | `/simplify` command — detects the dominant language of uncommitted changes and runs the matching code-simplifier skill |
 | [`status-bar.ts`](pi-extensions/status-bar.ts) | Rich two-line footer with model, context meter, token counts, cost, git status, and tool tally |
 | [`todos.ts`](pi-extensions/todos.ts) | File-backed todo manager with a TUI for listing and editing todos |
 | [`whimsical.ts`](pi-extensions/whimsical.ts) | Replaces "Thinking..." with random phrases like "Reticulating splines..." and "Consulting the void..." |
-| [`commit.ts`](pi-extensions/commit.ts) | `/commit` command — stages all changes, generates a Conventional Commits message via LLM, creates a side branch if on the default branch |
 
 ## Skills
 
@@ -82,6 +77,7 @@ Custom themes live in [`pi-themes/`](pi-themes).
 ├── skills/            # Agent skills (SKILL.md per skill)
 ├── pi-themes/         # Custom themes
 ├── plumbing-commands/ # Release automation templates
+├── Makefile           # Release and changelog targets
 ├── AGENTS.md          # Agent-facing coding conventions
 ├── CHANGELOG.md       # Release history
 └── package.json       # Pi package manifest