@mmerterden/multi-agent-pipeline 20.18.0 → 20.19.0

package/CHANGELOG.md

@@ -16,6 +16,12 @@ Internal file-layout changes that don't affect the slash-command surface are sti
 
 ## [Unreleased]
 
+## [20.19.0] - 2026-10-09
+
+### Changed
+
+- `/multi-agent:update` ends with a note of what the update brought, in the user's language: every release between the installed and the new version (not only the last one, and not cut at 40 lines), grouped as new, fixed, changed and removed, plus each stack plugin the refresh moved and what its releases added. The note is written from `release-notes.mjs`, which reads the new release's CHANGELOG and each updated plugin's CHANGELOG and never fails the update; internal-only entries are left out and nothing is added that the CHANGELOGs do not say.
+
 ## [20.18.0] - 2026-10-09
 
 ### Added

package/docs/facts.json

@@ -1,7 +1,7 @@
 {
   "$comment": "Generated by pipeline/scripts/gen-facts.mjs. Do not hand-edit: the site reads this, and a number edited here instead of at its source is the drift this file removes.",
   "generatedAt": "2026-10-09",
-  "version": "20.18.0",
+  "version": "20.19.0",
   "phaseSchema": 2,
   "phases": [
     {

package/manifest.json

@@ -1,12 +1,12 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "20.18.0",
-  "commit": "896371483bce326d6cb68a1f9609ebb99e7575d6",
-  "generatedAt": "2026-10-09T05:37:30.195Z",
+  "version": "20.19.0",
+  "commit": "6db35d97282cfe57fab9bb66a0da8bc6696aca99",
+  "generatedAt": "2026-10-09T11:19:00.589Z",
   "algorithm": "sha256",
-  "fileCount": 1356,
+  "fileCount": 1357,
   "files": {
-    "CHANGELOG.md": "76773c616fec7b75d1db838ce716c2f25caebb605762c786c89381dc5aeb6141",
+    "CHANGELOG.md": "273977981d9581cd702e05f063930ef2cff624a76b687472cf0fef545e7adad3",
     "LICENSE": "8d8c51aaf1e1538b180c69965fa038db71be86798cc3e26a143bebfefe16a43e",
     "README.md": "1336cf131fdc0dbab1dd8b90fcd5614bd19d27b92b4f91ab99c3108d61cb51e1",
     "README.tr.md": "7979b32e6c72aedc3a6affe85f33b2840e72f056a836e8546566d259b236ff29",
@@ -33,7 +33,7 @@
     "docs/best-practices.md": "f8b75b0d38b5896a6a852bb30a1edddeb24dab8b5b7b1d9313290e1241c72024",
     "docs/ecosystem.md": "d504124f421748744599f6974ec71d52664affc47740665651cca5ddc17d0c71",
     "docs/engineering.md": "550528cd47c7d2c921729c68d0782a00ac8e77a4bdfec479f6749f9c3235d188",
-    "docs/facts.json": "fd737a1eef03c1cdda33d9d4173556998b39c7bc2d3cfca06c3bcb887a18ce20",
+    "docs/facts.json": "80256de517e282de9b5a6e135a270d45a0590ab77ef579fafd171d644ce917b0",
     "docs/features.md": "87ae163280fe05b36ff9f664b1bf9d98b697cc498731d47298751b439fa7a35c",
     "docs/performance.md": "bbf2f3922c25dcba0c1a9e69ef420e3871a729af5b35009a49b48a5d3c5cd151",
     "docs/recovery-guide.md": "59a8f1b66b34cb9ff5507b3d54dac3b9915e184aa044d9c758d18cac818d510e",
@@ -63,7 +63,7 @@
     "install/templates/multi-agent-autopilot-awake.plist.template": "ddd25c76c56fcbb38a89de8e35637372d70ace993d6bc487a88ca9cfb702fe1f",
     "install/templates/multi-agent-autopilot.plist.template": "122c8a61cd927edd99375d6e3da40f1d42bcceed5b6641785c8b28bb930bc77e",
     "install/unattended-profile-legacy.json": "f52e86b998956f09ad306b1735a6c10b58580d7082d8a55665a4c6bb15c3aa1f",
-    "package.json": "ea701923f2dbd97b1c712d609729f9cea25b3ccbf18eb447d9a604e22fc20e9b",
+    "package.json": "c45fc8e778927b72b074d2692f8fd895186b1adc1c752cfa2e18ff41c6822d49",
     "pipeline/agents/android-architect.md": "11fb74543cb0ebcf9525ca6654fe95d53da7229e0bf4a1149b31fd9005abc453",
     "pipeline/agents/backend-architect.md": "b02a606c301e4714131aed70ae6d16eeb77fbc819a001e2752cff2488d4246de",
     "pipeline/agents/bulk-reader.md": "6597052cd7d205bac2b1c7633f5232fe1a40730664a913b8eb77efd5a786dc25",
@@ -142,7 +142,7 @@
     "pipeline/commands/multi-agent/test/SKILL.md": "5a67be2b1ec0321e79f8b7f35be53676e349e55a4f8ca09a07f0de89dadac8c4",
     "pipeline/commands/multi-agent/testflight-validation/SKILL.md": "38fa8d3d3c8340d025e100c53a70183cbad22665b7ddccbb6102c05986cce489",
     "pipeline/commands/multi-agent/uninstall/SKILL.md": "b2124820a6e10cdd72be71df2183aad4f8bd8988ec90248c88599c1514f7d9ab",
-    "pipeline/commands/multi-agent/update/SKILL.md": "b87d2b9b284860eb14f5973f640b09de2993493cc1e3676bf14bb877927966ed",
+    "pipeline/commands/multi-agent/update/SKILL.md": "4b9ca40382eb2bd06f8b1a483d6232d1e9941d6e6288a21e83fa977482a1bae7",
     "pipeline/commands/sim-test.md": "b09038b9511108c77fae5e0c11f8515b5c64eb8b63a77fe8c2ff5907ddd0313a",
     "pipeline/contract/CHANGELOG.md": "0813f5737219bafad3eb4daf809b9754937fae8533e07caf3850e30b2685662b",
     "pipeline/contract/README.md": "6239eb0877d70e70d63db74bae3499599b0425c80c71eceb6bb0a981523eaa89",
@@ -483,7 +483,7 @@
     "pipeline/schemas/unattended-profile.json": "05bc095b6328ff77b7bee8b008becf9aa20f1dabeab3b0fc174b97cad421e23b",
     "pipeline/schemas/unattended-profile.schema.json": "a9c0979f0d0742826e410fdbfe1ae1c4a56b05b4e638eec42d4c276d6f48f701",
     "pipeline/schemas/worktrees.schema.json": "4e15c413c00811814eee734d86734ad9e1d34a37737f7df641b389ce5d8d134b",
-    "pipeline/scripts/README.md": "937adf6f34ce18fc07d91d6556abcdd39debf2df7819c3f16e009430dc0549a7",
+    "pipeline/scripts/README.md": "4cdf7054cddbe5cdcb08460f68782f2347a26c8c343d8ef8418714464672b36c",
     "pipeline/scripts/_autopilot-config.mjs": "0f42d2791f1d71c4aad5a0735ca56fef1ed27d275b72f99d8ca8f95fcb8aa83a",
     "pipeline/scripts/_autopilot-ops.mjs": "5e84d628482434c8f09dc69601c73ab70e928af15c2f068d998d2f61bd692d1a",
     "pipeline/scripts/_autopilot-outcomes.mjs": "5b2423814d979ed5c657473290083b296f7245d40507c866e7931b2771001236",
@@ -617,6 +617,7 @@
     "pipeline/scripts/prune-logs.sh": "c5587b33104c7253e07be8cce8249b50014c52dfdf232de637811ffdd88e95e4",
     "pipeline/scripts/purge.sh": "95c60b272ae47209893dba9b17528538592bb5636da47940a02734cd9b4f0ce5",
     "pipeline/scripts/record-phase.mjs": "041dc262e54f38b66299f45c44db7918812e599a773f5a3dc78cfd09ab5e155e",
+    "pipeline/scripts/release-notes.mjs": "05430926cf679534978bcc79c160a6787aaf04831b8b8489d8bbc9fa343a14af",
     "pipeline/scripts/render-agent-log-cost.sh": "6c58c1f5754ff5754485a0c1b66f4cd713575d2e8ebb1630aedf2f87fe34ef4d",
     "pipeline/scripts/render-cost-summary.sh": "ce9647332ab9a3e518af98f52a6fc70baab9fd3c09ec5f9e85bae2d67078a5e3",
     "pipeline/scripts/render-work-summary.sh": "ee4db04ebc145cc2fc7fa9a533d42b7da4da191710ef67c883502ca83b2aa67c",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mmerterden/multi-agent-pipeline",
-  "version": "20.18.0",
+  "version": "20.19.0",
   "description": "6-phase AI development pipeline with full orchestration on Claude Code, Copilot CLI and Codex CLI. Analysis, planning, TDD, CLI-aware parallel review with consensus surfacing + Fable triage, default-FAIL evidence gates, secret + intent guards, per-phase cost ledger, persistent learnings memory, wiki generation, commit automation. Token-preserving uninstall.",
   "type": "module",
   "main": "index.js",

package/pipeline/commands/multi-agent/update/SKILL.md

@@ -100,9 +100,13 @@ and every later block that needs them starts by sourcing it.
 
 4b. **Update the stack plugins** (catalog refresh, then every installed plugin in its own scope):
    ```bash
-   bash "$HOME/.claude/scripts/plugin-refresh.sh" {owner}
+   REFRESH_LOG="${TMPDIR:-/tmp}/multi-agent-plugin-refresh.log"
+   bash "$HOME/.claude/scripts/plugin-refresh.sh" {owner} > "$REFRESH_LOG" 2>&1
+   rc=$?
+   cat "$REFRESH_LOG"
+   echo "plugin-refresh exit: $rc"
    ```
-   A non-zero exit means a step failed and the CLI's own error is already on screen. Report it to the user; do not retry silently.
+   A non-zero exit means a step failed and the CLI's own error is already on screen. Report it to the user; do not retry silently. The log feeds step 6, which tells the user what each updated plugin brought.
 
 4c. **Prune retired adapter files** (Cursor / Antigravity / Copilot Chat were removed in v10.7.0 - the pipeline targets Claude Code, Copilot CLI and Codex CLI):
    ```bash
@@ -139,19 +143,41 @@ and every later block that needs them starts by sourcing it.
    or an SSH key on the personal account (the "Personal account" step in
    `$HOME/.claude/multi-agent-refs/features/usage-reporting.md`).
 
-6. **Show the new version and its changes** (from the packaged CHANGELOG - there is no git history on this channel):
+6. **Tell the user what the update brought.** Read the notes, then write the summary yourself:
    ```bash
    . "${TMPDIR:-/tmp}/multi-agent-update.env" || { echo "Run step 1 first."; exit 1; }
    NEW=$(tr -d '[:space:]' < "$HOME/.claude/.pipeline-version" 2>/dev/null)
-   echo ""
-   echo "✓ Updated: v$CUR → v$NEW"
-   echo ""
-   echo "Changes:"
-   awk -v new="## [$NEW]" -v cur="## [$CUR]" \
-     'index($0,new){on=1} on&&index($0,cur){exit} on' \
-     "$UPD_DIR/package/CHANGELOG.md" | head -40
+   NOTES="$UPD_DIR/package/pipeline/scripts/release-notes.mjs"
+   [ -f "$NOTES" ] || NOTES="$HOME/.claude/scripts/release-notes.mjs"
+   LOG="$UPD_DIR/package/CHANGELOG.md"
+   [ -f "$LOG" ] || LOG=/nonexistent
+   node "$NOTES" --changelog "$LOG" --from "$CUR" --to "$NEW" \
+     --plugins-dir "$HOME/.claude/plugins/marketplaces/multi-agent-plugins/plugins" \
+     --plugin-refresh-log "${TMPDIR:-/tmp}/multi-agent-plugin-refresh.log"
    ```
 
+   The JSON holds every release between the old and the new version (not only
+   the last one) and, for each plugin the refresh moved, that plugin's releases.
+   Turn it into a short note in `outputLanguage`, written for the person using
+   the pipeline, not for its maintainers:
+
+   - First line: `✓ Updated: v<CUR> → v<NEW>`, then one line per updated plugin
+     (`ai-ios-toolkit 0.20.0 → 0.21.0`).
+   - Then up to four groups, each only when it has entries: **New** (added),
+     **Fixed**, **Changed**, **Removed** (Turkish: Yeni, Düzeltilen, Değişen,
+     Kaldırılan). Put security entries first under Fixed.
+   - One plain sentence per item about what the user notices or can now do.
+     Merge items that say the same thing; leave out internal-only entries
+     (smoke tests, CI, refactors, budgets, docs) unless they change what a user
+     sees. At most about eight items per group; when more were dropped, say how
+     many and that the full list is in the CHANGELOG.
+   - Use only what the JSON says. Never invent a feature or a fix, and never
+     guess why something changed.
+   - Last line, when anything needs action: what to do (restart Claude Code for
+     plugin changes, run a command a release asks for).
+
+   With empty notes and no plugin updates, print only the version line.
+
 7. **Smoke test (optional)** - the release tarball ships exactly two smokes for this purpose:
    ```bash
    . "${TMPDIR:-/tmp}/multi-agent-update.env" || { echo "Run step 1 first."; exit 1; }
@@ -165,18 +191,19 @@ and every later block that needs them starts by sourcing it.
 ## Output
 
 ```
-Current: v15.6.0   Latest: v15.6.1
-  -> npm pack @{npm-scope}/multi-agent-pipeline@15.6.1
+Current: v15.6.0   Latest: v15.7.0
+  -> npm pack @{npm-scope}/multi-agent-pipeline@15.7.0
   -> node install.js --installed (Claude Code; no Copilot CLI or Codex CLI stamp, not installed)
   -> migrate-prefs.mjs (0 changes  -  already v2.6.0)
 
-✓ Updated: v15.6.0 → v15.6.1
+✓ Updated: v15.6.0 → v15.7.0
+  ai-ios-toolkit 0.19.0 → 0.20.0
 
-Changes:
-  ## [15.6.1] - 2026-08-19
-  ### Fixed
-  - Usage report reads the tracker as it is actually written
-  ...
+New
+  - iOS design review: critiques a screen against the HIG from screenshots.
+Fixed
+  - The usage report reads the tracker as it is written.
+Restart Claude Code to load the updated plugins.
 
 Verification:
   schema-validation: 27/27 pass

package/pipeline/scripts/README.md

@@ -85,6 +85,7 @@ Shell scripts invoked during pipeline execution.
 - `github-ssh-setup.sh`  -  first-run SSH key setup helper
 - `update-check.sh`  -  cached registry read (`dist-tags.latest` + `dist-tags.required`); always exit 0
 - `require-supported-version.sh`  -  turns the `force` signal into exit 3; fails open offline
+- `release-notes.mjs`  -  every release between the installed and the new version, grouped by kind, plus each plugin the refresh moved; feeds the update summary
 - `sync-parity-check.sh`  -  manual parity verification helper
 
 ## Node.js helpers (74 `.mjs` files)

package/pipeline/scripts/release-notes.mjs

@@ -0,0 +1,167 @@
+#!/usr/bin/env node
+/**
+ * release-notes.mjs  -  what an update brought, grouped so the user can be told.
+ *
+ * `/multi-agent:update` runs this from the release it just unpacked, against that
+ * release's CHANGELOG: every version after the one that was installed, up to the
+ * one now installed, with its bullets grouped by kind (added, changed, fixed,
+ * removed, ...). A jump across many releases is reported whole, not cut at a line
+ * count. The same is done for each stack plugin the plugin refresh moved, read
+ * from that plugin's CHANGELOG in the marketplace checkout.
+ *
+ * The output is data for the update step, which summarizes it for the user in
+ * their language. It never fails an update: a missing or unreadable CHANGELOG is
+ * empty notes and exit 0.
+ *
+ * Usage:
+ *   release-notes.mjs --changelog <CHANGELOG.md> --from <old> --to <new>
+ *                     [--plugins-dir <marketplace>/plugins --plugin-refresh-log <file>]
+ *
+ * stdout: JSON `{ pipeline: Notes, plugins: [{ name, from, to, notes: Notes }] }`
+ * where Notes is `{ from, to, versions: [{ version, date, sections }], counts }`.
+ */
+
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+import { runMain } from "../lib/fatal.mjs";
+
+const RELEASE_RE = /^## \[(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)\](?:\s*-\s*(.+))?\s*$/;
+const SECTION_RE = /^### (.+?)\s*$/;
+
+function cmp(a, b) {
+  const [pa, qa = ""] = a.split("-");
+  const [pb, qb = ""] = b.split("-");
+  const x = pa.split(".").map(Number);
+  const y = pb.split(".").map(Number);
+  for (let i = 0; i < 3; i++) if (x[i] !== y[i]) return x[i] - y[i];
+  if (qa === qb) return 0;
+  if (!qa) return 1;
+  if (!qb) return -1;
+  return qa < qb ? -1 : 1;
+}
+
+/**
+ * Released versions in a Keep a Changelog file, newest first as written.
+ * `## [Unreleased]` is skipped; a bullet's wrapped lines are joined.
+ *
+ * @param {string} text
+ * @returns {{version: string, date: string|null, sections: Record<string, string[]>}[]}
+ */
+export function parseChangelog(text) {
+  const releases = [];
+  let release = null;
+  let section = null;
+  let bullet = null;
+  const flush = () => {
+    if (bullet !== null && release && section) release.sections[section].push(bullet.trim());
+    bullet = null;
+  };
+  for (const line of String(text || "").split("\n")) {
+    if (line.startsWith("## ")) {
+      flush();
+      const m = RELEASE_RE.exec(line);
+      release = m ? { version: m[1], date: m[2]?.trim() || null, sections: {} } : null;
+      if (release) releases.push(release);
+      section = null;
+      continue;
+    }
+    if (!release) continue;
+    const s = SECTION_RE.exec(line);
+    if (s) {
+      flush();
+      section = s[1].toLowerCase();
+      release.sections[section] ||= [];
+      continue;
+    }
+    if (!section) continue;
+    if (/^[-*] /.test(line)) {
+      flush();
+      bullet = line.slice(2);
+    } else if (bullet !== null && /^\s+\S/.test(line)) {
+      bullet += " " + line.trim();
+    } else if (!line.trim()) {
+      flush();
+    }
+  }
+  flush();
+  return releases;
+}
+
+/**
+ * Releases after `from` up to and including `to`, newest first, with a count of
+ * bullets per section across all of them.
+ *
+ * @param {string} text
+ * @param {{from: string, to: string}} range
+ */
+export function releaseNotes(text, { from, to }) {
+  const versions = parseChangelog(text)
+    .filter((r) => cmp(r.version, from) > 0 && cmp(r.version, to) <= 0)
+    .sort((a, b) => cmp(b.version, a.version));
+  const counts = {};
+  for (const v of versions) {
+    for (const [k, items] of Object.entries(v.sections))
+      counts[k] = (counts[k] || 0) + items.length;
+  }
+  return { from, to, versions, counts };
+}
+
+/**
+ * Plugins the refresh moved, from the CLI's own lines
+ * (`Plugin "<name>" updated from <a> to <b> for scope ...`). A plugin updated in
+ * several scopes is reported once, from the oldest version any of them had.
+ *
+ * @param {string} output
+ * @returns {{name: string, from: string, to: string}[]}
+ */
+export function pluginUpdates(output) {
+  const byName = new Map();
+  const re = /Plugin "([^"]+)" updated from (\S+) to (\S+)/g;
+  for (const m of String(output || "").matchAll(re)) {
+    const [, name, from, to] = m;
+    const seen = byName.get(name);
+    if (!seen) byName.set(name, { name, from, to });
+    else {
+      if (cmp(from, seen.from) < 0) seen.from = from;
+      if (cmp(to, seen.to) > 0) seen.to = to;
+    }
+  }
+  return [...byName.values()];
+}
+
+function read(path) {
+  try {
+    return existsSync(path) ? readFileSync(path, "utf8") : "";
+  } catch {
+    return "";
+  }
+}
+
+function arg(argv, name) {
+  const i = argv.indexOf(name);
+  return i >= 0 ? argv[i + 1] : undefined;
+}
+
+export function main(argv = process.argv.slice(2)) {
+  const from = arg(argv, "--from") || "0.0.0";
+  const to = arg(argv, "--to") || from;
+  const pipeline = releaseNotes(read(arg(argv, "--changelog") || ""), { from, to });
+
+  const pluginsDir = arg(argv, "--plugins-dir");
+  const refreshLog = arg(argv, "--plugin-refresh-log");
+  const plugins = [];
+  if (pluginsDir && refreshLog) {
+    for (const u of pluginUpdates(read(refreshLog))) {
+      const notes = releaseNotes(read(join(pluginsDir, u.name, "CHANGELOG.md")), u);
+      plugins.push({ ...u, notes });
+    }
+  }
+  process.stdout.write(JSON.stringify({ pipeline, plugins }, null, 2) + "\n");
+  return 0;
+}
+
+if (import.meta.url === pathToFileURL(process.argv[1] || "").href) {
+  runMain("release-notes", () => main());
+}