@ferris1225/pi-subagents 4.2.12 → 4.2.13

package/CHANGELOG.md

@@ -0,0 +1,61 @@
+# Changelog
+
+Published versions of `@ferris1225/pi-subagents`. Unpublished numbers
+(`4.2.3`, `4.2.6`, `4.2.9`–`4.2.11`) never shipped on npm; their changes
+landed in the next published release.
+
+## 4.2.13
+
+- README: table of contents, a What's new lead-in, and a pointer at this
+  changelog. Release notes describe the live `main` → npm path.
+
+## 4.2.12
+
+- Executor confirms each named defect on current code before editing.
+- Footer settled counts stay on the line only while a sibling is live, and
+  widget truncation no longer lies about what was cut.
+- Merging to `main` publishes an unpublished `package.json` version to npm
+  and opens a matching GitHub Release.
+
+## 4.2.8
+
+- Always-visible footer roll-up: `subagents 2 running · 1 repo lane · 3 done`.
+- `wait: true` streams progress onto the tool card and reports child token
+  spend as the call's own usage.
+- Completions are held while context compaction rewrites history, then
+  released on success, failure, or abort.
+- A delivered result no longer enters the parent context a second time.
+- Isolated worktrees link `node_modules`.
+- Widget worktree badge is spelled out (`worktree:a91f3c`).
+
+## 4.2.7
+
+- Executor routing is a single self-contained deliverable; `thinking` can
+  be set per dispatch.
+- Child prompt temp directories are removed recursively.
+
+## 4.2.5
+
+- The threads manifest lives per project, beside that project's artifacts.
+
+## 4.2.4
+
+- Explorer findings are one-line retrieval leads.
+- Worktree recovery retries cleanup when the patch was already applied.
+
+## 4.2.2
+
+- A single artifact the main agent must fully absorb stays an inline read;
+  re-reads are bounded.
+
+## 4.2.1
+
+- Upgraded configs prune retired built-in roles so the setup wizard never
+  mixes old and new names.
+
+## 4.2.0
+
+- Built-in team is `explorer` and `executor`. The old
+  `worker` / `cleaner` / `documenter` / `synthesizer` / `reviewer` set is
+  gone.
+- Live widget splits each run into an identity line and a dim activity line.

package/README.md

@@ -10,6 +10,34 @@ A managed engineering team for [pi](https://github.com/earendil-works/pi): two
 focused sub-agents, durable threads, and Git worktree
 isolation. You install it once and your main agent delegates on its own.
 
+## What's new
+
+**4.2.13** — this page now leads with current changes and keeps the 4.2 line
+in [CHANGELOG.md](./CHANGELOG.md).
+
+**4.2.12**
+
+- The executor confirms a named defect on current code before it edits.
+- Footer settled counts stay honest, and only while a sibling is still live.
+- Merging to `main` publishes npm and opens a matching GitHub Release.
+
+## Contents
+
+- [Why](#why)
+- [Install](#install)
+- [The team](#the-team)
+- [Dispatching work](#dispatching-work)
+- [Parallel edits](#parallel-edits)
+- [Threads: resume, stop](#threads-resume-stop)
+- [Live status and results](#live-status-and-results)
+- [Models, thinking, and tools](#models-thinking-and-tools)
+- [Configuration](#configuration)
+- [Custom agents](#custom-agents)
+- [Storage and cleanup](#storage-and-cleanup)
+- [Development](#development)
+- [Changelog](#changelog)
+- [Release](#release)
+
 ## Why
 
 Delegation is supposed to remove coordination work. Most sub-agent launchers stop
@@ -374,23 +402,29 @@ There are no bundled runtime dependencies; pi and TypeBox are peers. The source
 split by responsibility: dispatch policy, thread lifecycle, RPC
 transport, worktree integration, completion delivery, tools, and TUI status.
 
-## Release
+## Changelog
 
-Merging to `main` publishes `@ferris1225/pi-subagents` when `package.json`
-carries a version npm does not have yet, then opens a matching GitHub Release.
-Do not `npm publish` from a laptop.
+The 4.2 line lives in [CHANGELOG.md](./CHANGELOG.md). Latest published
+version is **4.2.13**.
 
-One-time setup — pick one:
+| Version | What changed |
+| ------- | ------------ |
+| 4.2.13  | README navigation, What's new, and this changelog. |
+| 4.2.12  | Confirm-before-fix; honest footer counts; `main` publishes npm + GitHub Release. |
+| 4.2.8   | Footer roll-up; wait-path token usage; hold completions across compaction. |
+| 4.2.7   | Sharper executor routing; per-dispatch `thinking`. |
+| 4.2.5   | Per-project threads manifest. |
+| 4.2.4   | One-line explorer findings; recovery cleanup retry. |
+| 4.2.2   | Single-artifact reads stay inline. |
+| 4.2.1   | Prune retired roles from upgraded configs. |
+| 4.2.0   | Team is `explorer` + `executor`; two-line live widget. |
 
-1. **Trusted publisher (preferred):** on the
-   [npm package page](https://www.npmjs.com/package/@ferris1225/pi-subagents)
-   add a GitHub Actions trusted publisher for `MCapricorns/pi-subagents` with
-   workflow filename `publish.yml` (no path, environment left blank).
-2. **Token:** create an npm automation token and store it as the repository
-   Actions secret `NPM_TOKEN`.
+## Release
 
-If the first run fails because neither is configured, add the publisher or
-secret and re-run the **Publish** workflow from the Actions tab.
+Merging to `main` publishes `@ferris1225/pi-subagents` when `package.json`
+carries a version npm does not have yet, then opens a matching GitHub Release.
+Do not `npm publish` from a laptop. The workflow is
+`.github/workflows/publish.yml` (npm trusted publisher or `NPM_TOKEN`).
 
 ## License
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ferris1225/pi-subagents",
-  "version": "4.2.12",
-  "description": "A managed sub-agent team for pi: specialized roles, pre-commit documentation sync, retained threads, auto-fix chains, model fallback, and Git worktree isolation.",
+  "version": "4.2.13",
+  "description": "A managed sub-agent team for pi: explorer and executor roles, durable threads, model fallback, and Git worktree isolation.",
   "type": "module",
   "license": "MIT",
   "repository": {
@@ -28,6 +28,7 @@
     "src",
     "agents",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "pi": {