From a5ee32d2820e6c6d5785987064234a68f9235288 Mon Sep 17 00:00:00 2001 From: Vladimir Date: Tue, 1 Sep 2026 16:07:50 +0800 Subject: [PATCH] release: prepare Simulator Broker 0.1.0-alpha.6 Why: - Publish the merged service-recovery CTA and resident-service project-init fixes in installable artifacts. - Keep the public CLI, app, documentation, and four-asset contract aligned for promotion readiness. Changed: - Bumped current package, install, support, Formula, Cask, and release-spec references to 0.1.0-alpha.6. - Added concise Alpha 6 notes and pinned Formula/Cask to the frozen operator-built CLI and notarized app bytes. Verification: - spec-only profile and 51/51 public front-door tests passed on the final pinned tree. - Full validation passed: broker core 294/294, client 258/258, harness adoption 24/24, macOS app 172/172, and public surface 262 files. - Clean install and portable-package smokes passed correlated launch, snapshot-decode, and refresh proof. - Raw CLI/npm/app audits, exact checksums, Developer ID signature, hardened runtime, secure timestamp, notarization, staple, Gatekeeper, and arm64+x86_64 checks passed. Affected: - Public release metadata, newcomer install guidance, package versions, Homebrew Formula/Cask pins, and tagged-release specification. Refs: - https://github.com/fiveonecode/simulator-broker/pull/41 - https://github.com/fiveonecode/simulator-broker/pull/43 - https://github.com/fiveonecode/simulator-broker/issues/42 Session: - task-sessions/alpha6-release-20260901 --- .github/ISSUE_TEMPLATE/install-failure.yml | 4 ++-- CHANGELOG.md | 16 ++++++++++++++++ Casks/simulator-broker.rb | 4 ++-- Formula/simbroker.rb | 4 ++-- README.md | 6 +++--- SECURITY.md | 10 +++++----- docs/getting-started.md | 6 +++--- package-lock.json | 4 ++-- package.json | 2 +- packages/simbroker/README.md | 2 +- packages/simbroker/package.json | 2 +- spec/README.md | 2 +- spec/build-and-test.md | 2 +- 13 files changed, 40 insertions(+), 24 deletions(-) diff --git a/.github/ISSUE_TEMPLATE/install-failure.yml b/.github/ISSUE_TEMPLATE/install-failure.yml index 8e55fdc..c006d4e 100644 --- a/.github/ISSUE_TEMPLATE/install-failure.yml +++ b/.github/ISSUE_TEMPLATE/install-failure.yml @@ -9,7 +9,7 @@ body: Simulator Broker is **Alpha**, **macOS-only**, and needs **Xcode** to create or run iOS Simulators. Install the CLI with `brew install fiveonecode/simulator-broker/simbroker` or - `npm install -g` of the `simbroker-0.1.0-alpha.5.tgz` from GitHub + `npm install -g` of the `simbroker-0.1.0-alpha.6.tgz` from GitHub Releases. Install the operator app with `brew install --cask fiveonecode/simulator-broker/simulator-broker`. @@ -23,7 +23,7 @@ body: label: What install path did you use? options: - Homebrew (`brew install fiveonecode/simulator-broker/simbroker`) - - npm (`npm install -g` of `simbroker-0.1.0-alpha.5.tgz` from GitHub Releases) + - npm (`npm install -g` of `simbroker-0.1.0-alpha.6.tgz` from GitHub Releases) - Homebrew cask (`brew install --cask fiveonecode/simulator-broker/simulator-broker`) - CLI-only (`bash scripts/install_local.sh --cli-only`) - Contributor app + CLI (`npm run install:local`) diff --git a/CHANGELOG.md b/CHANGELOG.md index 9f79920..d037e57 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -7,6 +7,22 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0 ## [Unreleased] +## [0.1.0-alpha.6] - 2026-09-01 + +Alpha 6 is the promotion-readiness follow-up to Alpha 5. It keeps the same +installation and four-custom-asset contract while correcting two first-run and +recovery clarity gaps found during live two-host validation. + +### Fixed + +- A configured Mac whose local controller is stopped now offers **Start + service** in the app instead of the misleading **Finish setup** label; + genuinely unfinished setup states retain their setup-specific actions. +- `simbroker project init` now resolves repository identity in the caller + before dispatching through a resident `brokerd`, so the documented no-flag + newcomer flow works even when the service was launched from another + directory. + ## [0.1.0-alpha.5] - 2026-09-01 Alpha 5 is the provenance-safe recovery release for the immutable failed diff --git a/Casks/simulator-broker.rb b/Casks/simulator-broker.rb index 742a8f0..f42aee2 100644 --- a/Casks/simulator-broker.rb +++ b/Casks/simulator-broker.rb @@ -1,6 +1,6 @@ cask "simulator-broker" do - version "0.1.0-alpha.5" - sha256 "4fcad6743f4a4d6e8cf3fe427d43814c2e4348e9709bbe264a7d275bb252c30a" + version "0.1.0-alpha.6" + sha256 "cc964e3e552a0f5dd6691a12edf5c048fde1b7ff505cadf35637694ccb8a0a30" url "https://github.com/fiveonecode/simulator-broker/releases/download/v#{version}/Simulator-Broker-#{version}.zip" name "Simulator Broker" diff --git a/Formula/simbroker.rb b/Formula/simbroker.rb index 8dc08e5..d9afd4d 100644 --- a/Formula/simbroker.rb +++ b/Formula/simbroker.rb @@ -1,8 +1,8 @@ class Simbroker < Formula desc "Local iOS Simulator control plane CLI" homepage "https://github.com/fiveonecode/simulator-broker" - url "https://github.com/fiveonecode/simulator-broker/releases/download/v0.1.0-alpha.5/simulator-broker-0.1.0-alpha.5-cli.tar.gz" - sha256 "429c6477ff3a85f90a660693bda5527963a89942a8e8052eee31086a5ecc3ddd" + url "https://github.com/fiveonecode/simulator-broker/releases/download/v0.1.0-alpha.6/simulator-broker-0.1.0-alpha.6-cli.tar.gz" + sha256 "400791caaf5de9a0eecffc3f9ff48798280a44b25de2f2688a00a15a45489960" license "MIT" depends_on macos: :sonoma diff --git a/README.md b/README.md index dfdd1ef..5ca5da0 100644 --- a/README.md +++ b/README.md @@ -79,7 +79,7 @@ simbroker idle enable --grace-seconds <60-86400> --actor-type human --actor-id < Other CLI install options: ```bash -npm install -g https://github.com/fiveonecode/simulator-broker/releases/download/v0.1.0-alpha.5/simbroker-0.1.0-alpha.5.tgz +npm install -g https://github.com/fiveonecode/simulator-broker/releases/download/v0.1.0-alpha.6/simbroker-0.1.0-alpha.6.tgz simbroker --help ``` @@ -102,8 +102,8 @@ are also attached to those releases. The archive contains a versioned top-level directory: ```bash -tar -xzf simulator-broker-0.1.0-alpha.5-cli.tar.gz -./simulator-broker-0.1.0-alpha.5-cli/bin/simbroker --help +tar -xzf simulator-broker-0.1.0-alpha.6-cli.tar.gz +./simulator-broker-0.1.0-alpha.6-cli/bin/simbroker --help ``` `simbroker` help and `simbroker doctor` print human-readable text by default. diff --git a/SECURITY.md b/SECURITY.md index 14fd9e9..d5ed9b9 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -3,13 +3,13 @@ ## Supported Versions Security fixes are considered for the current `main` branch and for the latest -tagged Alpha (`0.1.0-alpha.5`). Older Alpha tags are not supported. The +tagged Alpha (`0.1.0-alpha.6`). Older Alpha tags are not supported. The published Alpha has exactly four custom GitHub Release assets: -1. `simulator-broker-0.1.0-alpha.5-cli.tar.gz` -2. `simulator-broker-0.1.0-alpha.5-cli.tar.gz.sha256` -3. `simbroker-0.1.0-alpha.5.tgz` -4. `Simulator-Broker-0.1.0-alpha.5.zip` +1. `simulator-broker-0.1.0-alpha.6-cli.tar.gz` +2. `simulator-broker-0.1.0-alpha.6-cli.tar.gz.sha256` +3. `simbroker-0.1.0-alpha.6.tgz` +4. `Simulator-Broker-0.1.0-alpha.6.zip` The Homebrew formula and cask install the matching CLI and signed, notarized app archives. GitHub's generated source archives appear separately. diff --git a/docs/getting-started.md b/docs/getting-started.md index f7b8489..1921d15 100644 --- a/docs/getting-started.md +++ b/docs/getting-started.md @@ -51,7 +51,7 @@ does not require XcodeGen. The app still needs the CLI installed separately. ## Install the CLI with npm ```bash -npm install -g https://github.com/fiveonecode/simulator-broker/releases/download/v0.1.0-alpha.5/simbroker-0.1.0-alpha.5.tgz +npm install -g https://github.com/fiveonecode/simulator-broker/releases/download/v0.1.0-alpha.6/simbroker-0.1.0-alpha.6.tgz command -v simbroker simbroker --help ``` @@ -76,8 +76,8 @@ To install from a tagged Alpha without cloning, download then run: ```bash -tar -xzf simulator-broker-0.1.0-alpha.5-cli.tar.gz -./simulator-broker-0.1.0-alpha.5-cli/bin/simbroker --help +tar -xzf simulator-broker-0.1.0-alpha.6-cli.tar.gz +./simulator-broker-0.1.0-alpha.6-cli/bin/simbroker --help ``` The archive is the Node CLI only and contains that versioned top-level diff --git a/package-lock.json b/package-lock.json index afcdec3..5c0cc15 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "simulator-broker-app", - "version": "0.1.0-alpha.5", + "version": "0.1.0-alpha.6", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "simulator-broker-app", - "version": "0.1.0-alpha.5", + "version": "0.1.0-alpha.6", "license": "MIT", "engines": { "node": ">=20" diff --git a/package.json b/package.json index 8725fd4..dbed959 100644 --- a/package.json +++ b/package.json @@ -34,7 +34,7 @@ "test:package-smoke": "bash ./scripts/package_smoke.sh", "verify:public-surface": "node client/public-surface.mjs" }, - "version": "0.1.0-alpha.5", + "version": "0.1.0-alpha.6", "description": "Local simulator broker and macOS operator app for coordinated iOS Simulator workflows", "license": "MIT", "repository": { diff --git a/packages/simbroker/README.md b/packages/simbroker/README.md index 42cb317..708f956 100644 --- a/packages/simbroker/README.md +++ b/packages/simbroker/README.md @@ -4,7 +4,7 @@ Alpha CLI for Simulator Broker. Node.js 20 or newer is required. Creating and running iOS Simulators still requires macOS and Xcode. ```bash -npm install -g https://github.com/fiveonecode/simulator-broker/releases/download/v0.1.0-alpha.5/simbroker-0.1.0-alpha.5.tgz +npm install -g https://github.com/fiveonecode/simulator-broker/releases/download/v0.1.0-alpha.6/simbroker-0.1.0-alpha.6.tgz simbroker --help ``` diff --git a/packages/simbroker/package.json b/packages/simbroker/package.json index 37fe17a..2447040 100644 --- a/packages/simbroker/package.json +++ b/packages/simbroker/package.json @@ -1,6 +1,6 @@ { "name": "simbroker", - "version": "0.1.0-alpha.5", + "version": "0.1.0-alpha.6", "private": false, "description": "CLI for the local iOS Simulator control plane", "license": "MIT", diff --git a/spec/README.md b/spec/README.md index a77d76a..2ecd300 100644 --- a/spec/README.md +++ b/spec/README.md @@ -56,7 +56,7 @@ This repo exists to develop a reusable local simulator broker: - local install, local-debug portable packaging, Release distribution packaging, and onboarding flows now exist through `install_local.sh`, `install_local.sh --cli-only`, `package_local.sh`, `package_distribution.sh`, `test:install-smoke`, `test:package-smoke`, `host init --bootstrap-config`, and `project init` - the published onboarding docs now distinguish CLI-only install, repo-local contributor app+CLI install, local-debug portable bundling, and signed distribution packaging; a new login shell should resolve `simbroker` after install without sourcing `env.sh` - `CONTRIBUTING.md` publishes a public-patch track (Node.js 20 and the Node test suites, no harness session) and a labeled maintainer/agent harness track; `agent:complete` enforcement is unchanged -- tagged Alpha `0.1.0-alpha.5` publishes exactly four custom GitHub Release assets: a CLI tarball from `scripts/package_cli.sh`, its SHA-256 checksum, the packable npm CLI, and a notarized operator app zip. The tag workflow runs the public docs, public-surface, broker-core, client, and harness-adoption checks on GitHub-hosted Ubuntu before attaching the first three assets; the operator attaches the app zip after Developer ID signing and notarization. GitHub's generated source archives are not custom assets. Public pull-request CI remains split between Ubuntu and macOS, while the macOS app suite and home-path public-surface scan stay local. +- tagged Alpha `0.1.0-alpha.6` publishes exactly four custom GitHub Release assets: a CLI tarball from `scripts/package_cli.sh`, its SHA-256 checksum, the packable npm CLI, and a notarized operator app zip. The tag workflow runs the public docs, public-surface, broker-core, client, and harness-adoption checks on GitHub-hosted Ubuntu before attaching the first three assets; the operator attaches the app zip after Developer ID signing and notarization. GitHub's generated source archives are not custom assets. Public pull-request CI remains split between Ubuntu and macOS, while the macOS app suite and home-path public-surface scan stay local. - public pull-request CI and the tagged-release workflow run `npm run test:docs` so archive paths, install guidance, and workflow gates cannot drift without a failing check diff --git a/spec/build-and-test.md b/spec/build-and-test.md index 9742ca0..95358f4 100644 --- a/spec/build-and-test.md +++ b/spec/build-and-test.md @@ -164,7 +164,7 @@ A first extracted implementation slice now exists: fixtures inject `processController.currentPid` so hardcoded fixture PIDs cannot match the GitHub Actions test-runner pid. Containment still skips the live `process.pid` when `currentPid` is omitted. -- tagged versions such as `v0.1.0-alpha.5` attach exactly four custom assets +- tagged versions such as `v0.1.0-alpha.6` attach exactly four custom assets to a GitHub Release: the CLI tarball, its `.sha256` checksum, the packable `simbroker-.tgz`, and the notarized `Simulator-Broker-.zip`. GitHub-generated source archives are not