Release 0.7.6

.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "bauto",
       "source": "./src/automator/data/skills",
       "description": "Automation-mode skills driven by the bmad-auto orchestrator: interactive escalation resolution (bmad-auto-resolve) and deferred-work sweep triage (bmad-auto-sweep) — the inner dev primitive (which self-reviews and commits) is the upstream bmad-dev-auto skill",
-      "version": "0.7.5",
+      "version": "0.7.6",
       "author": {
         "name": "pinkyd"
       },

CHANGELOG.md

@@ -5,6 +5,38 @@ All notable changes to `bmad-auto` are documented here. The format is based on
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html). While the project is pre-1.0,
 breaking changes may land in a minor release.
 
+## [0.7.6] — 2026-06-28
+
+### Changed
+
+- **The OS is now abstracted behind a registry of seams, so a non-tmux/native-Windows port is new
+  files plus one registration line each — no core edits.** The terminal multiplexer is selected
+  through a registry (`register_multiplexer`, by `sys.platform` with a `BMAD_AUTO_MUX_BACKEND`
+  override) rather than hardcoded in `get_multiplexer()`, and the tmux backend split into a reusable
+  `BaseTmuxBackend` extension point — every tmux invocation funnels through one overridable `_run()`
+  primitive — with `TmuxMultiplexer` as a thin POSIX leaf, so a tmux-family backend (an eventual
+  "psmux") overrides only the spawn primitive and the few divergent methods.
+- **Process-lifecycle primitives moved behind a `ProcessHost` seam.** Politely-stop / force-kill /
+  liveness / PID-reuse-identity now route through `get_process_host()` (registered like the
+  multiplexer, with a `BMAD_AUTO_PROCESS_HOST` override); a `WindowsProcessHost` ships ready to
+  register. Hook registration no longer hardcodes `python3` — it takes the interpreter prefix from
+  `ProcessHost.hook_interpreter()` (POSIX `python3`; Windows `uv run --no-project python`), and
+  `bmad-auto validate` runs a platform preflight that reports the selected backend's readiness and
+  names the process host. Behavior on Linux/macOS/WSL is unchanged.
+- **The bundled Unity plugin's teardown delegates pid lifecycle to `ProcessHost` and its helper
+  scripts run under the orchestrator's own interpreter.** Plugin helper scripts are spawned via
+  `sys.executable` (not a PATH-resolved `python3`), so a bundled script may import `automator` seams;
+  `unity_teardown.py` now reaps leaked Editor/MCP processes through `get_process_host()` instead of
+  re-implementing kill/liveness, gaining Windows behavior for free.
+
+### Added
+
+- **A consolidated [porting guide](docs/porting-to-a-new-os.md)** maps the four OS seams (terminal
+  multiplexer, process lifecycle, hook interpreter, validate preflight), their registries and
+  test-override env vars, and exactly what a native-Windows port costs end to end. The
+  adapter-/plugin-authoring guides, ROADMAP, README, and FEATURES are updated to the post-registry
+  world.
+
 ## [0.7.5] — 2026-06-28
 
 ### Added
@@ -716,6 +748,7 @@ enforced in CI.
   implementation phase, driven by a Python control loop with hook-based session transport and
   resumable on-disk run state.
 
+[0.7.6]: https://github.com/bmad-code-org/bmad-auto/releases/tag/v0.7.6
 [0.7.5]: https://github.com/bmad-code-org/bmad-auto/releases/tag/v0.7.5
 [0.7.4]: https://github.com/bmad-code-org/bmad-auto/releases/tag/v0.7.4
 [0.7.3]: https://github.com/bmad-code-org/bmad-auto/releases/tag/v0.7.3

README.md

@@ -39,7 +39,7 @@ Inspired by the original [bmad-automator](https://github.com/bmad-code-org/bmad-
 ## Requirements
 
 - **Python 3.11+**, **tmux**, and a supported coding CLI — `claude` by default; `codex` and `gemini` via [profiles](#other-coding-clis).
-- **Linux or macOS** (or **Windows via WSL**, which _is_ Linux — it runs as-is). tmux is the one terminal-multiplexer backend today, but it now sits behind a pluggable seam (`TerminalMultiplexer`), so a native-Windows backend can slot in later without touching the engine — see the [adapter authoring guide](docs/adapter-authoring-guide.md#two-axes-cli-vs-transport). Native Windows is not yet shipped.
+- **Linux or macOS** (or **Windows via WSL**, which _is_ Linux — it runs as-is). tmux is the one terminal-multiplexer backend today, but it now sits behind a pluggable **registry** of OS seams (transport, process lifecycle, hook interpreter), so a native-Windows backend slots in as new files + a registration line each, with no engine edits — see [Porting bmad-auto to a new OS](docs/porting-to-a-new-os.md). Native Windows is not yet shipped.
 - A **BMAD v6 project** (`_bmad/bmm/config.yaml`, a `sprint-status.yaml` from `bmad-sprint-planning`) with the upstream `bmad-dev-auto` skill and the automator skill module from this repo installed (`bmad-auto-resolve`, `bmad-auto-sweep` — see [Installing the skill module](#installing-the-skill-module)). Standard BMAD skills stay untouched.
 
 ## Quick start
@@ -62,7 +62,7 @@ bmad-auto tui                    # …or drive everything from the dashboard
 | Command                                                  | What it does                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
 | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `bmad-auto init`                                         | Install the bundled `bmad-auto-*` skills, the hook relay, `.automator/policy.toml`, and a runs-dir gitignore. `--cli <profile>` (repeatable) targets specific agents; `--no-skills` / `--force-skills` control skill copying.                                                                                                                                                                                                                                                       |
-| `bmad-auto validate`                                     | Preflight every prerequisite: BMAD config, sprint-status, git, tmux, CLI binary, hook registration.                                                                                                                                                                                                                                                                                                                                                                                 |
+| `bmad-auto validate`                                     | Preflight every prerequisite: BMAD config, sprint-status, git, CLI binary, hook registration, and a platform check that reports the selected multiplexer's readiness and process host.                                                                                                                                                                                                                                                                                              |
 | `bmad-auto run`                                          | Drive the dev → review → verify → commit loop. `--epic N`, `--story KEY`, `--max-stories N`, `--dry-run`.                                                                                                                                                                                                                                                                                                                                                                           |
 | `bmad-auto sweep`                                        | Triage + execute open `deferred-work.md` entries. `--no-prompt`, `--decisions-only`, `--max-bundles N`, `--repeat`, `--max-cycles N`, `--dry-run`.                                                                                                                                                                                                                                                                                                                                  |
 | `bmad-auto resume <run-id>`                              | Continue a run paused at a gate, escalation, or interruption.                                                                                                                                                                                                                                                                                                                                                                                                                       |