Skip to content
Skills Library
DevOps & cloud · Automation

release-wavefunction-dmg

/release-wavefunction-dmg

Build, verify and hand over a Developer ID-signed, notarized Wavefunction DMG on this Mac with npm run release:local, then relaunch the local app. Use when the user asks for a new DMG, a signed or notarized build, or a release build to install on another Mac or send to someone.

Licence
MIT
Last repository change
07.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 07.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Build, verify and hand over a Developer ID-signed, notarized Wavefunction DMG on this Mac with npm run release:local, then relaunch the local app. Use when the user asks for a new DMG, a signed or notarized build, or a release build to install on another Mac or send to someone.

Original author description

Build, verify and hand over a Developer ID-signed, notarized Wavefunction DMG on this Mac with npm run release:local, then relaunch the local app. Use when the user asks for a new DMG, a signed or notarized build, or a release build to install on another Mac or send to someone.

How it works

  1. Prepare
  2. Close the app
  3. Build
  4. Verify
  5. Hand over
  6. Relaunch
  7. Report
Original SKILL.md headings · 74 lines, 723 words
SKILL.md preview
---
name: release-wavefunction-dmg
description: Build, verify and hand over a Developer ID-signed, notarized Wavefunction DMG on this Mac with npm run release:local, then relaunch the local app. Use when the user asks for a new DMG, a signed or notarized build, or a release build to install on another Mac or send to someone.
---

# Build a notarized Wavefunction DMG

`npm run release:local` runs the Release workflow's steps on this Mac, so it costs no GitHub Actions minutes. It installs dependencies from the lockfiles, builds the backend and app, and collects the notices. Then it signs with the Developer ID in the keychains, notarizes and staples the app and the DMG, and writes the release files to `dist/release`. It tags, pushes and uploads nothing.

## Prepare

- **Commit.** Build the commit the user asked for. After merges that is usually the tip of `main`. Check the branch, commit and working tree, and preserve unrelated edits. The script says `with uncommitted changes` when the tree is dirty, untracked files included; report that instead of naming a clean commit.
- **Settings file.** `~/.config/wavefunction/release.env` names the notarization key's file, its Issuer ID, and optionally the key id and updater key path. It holds paths and ids only. If a setting or file is missing, the script stops and names it.
- **Credentials stay the user's.** Tell the user what belongs in the settings file. Never ask for, print, copy or upload key material: not the `.p8`, the `.p12`, its password or the updater key.
- **Several signers.** With more than one Developer ID in the keychains, the script stops. Ask the user which one, then set `APPLE_SIGNING_IDENTITY`.

## Close the app

The build writes `src-tauri/target/release/bundle/macos/Wavefunction.app`, which the local app usually runs from. Close it first, exactly as [rebuild-wavefunction](../rebuild-wavefunction/SKILL.md) describes:

- check `/api/activity` immediately before quitting, and ask if work is active or unknown;
- quit through the normal Quit action or AppleScript;
- wait for the app and its sidecar to exit;
- never force-kill.

Before quitting, note project, thread and skill counts from the read-only API, so you can compare them after the relaunch.

## Build

From the repository root, run it in the background with its log in a task-owned temporary file:

```sh
npm run release:local
```

- **Duration.** It takes roughly 15 to 25 minutes. Most of that is the two notarization submissions, which wait on Apple.
- **Keychain prompt.** The first signing can raise a macOS prompt to let `codesign` use the Developer ID key. Tell the user to choose **Always Allow**; do not click it for them. The build waits while the prompt is open.
- **When it finishes.** On success the log ends with `Notarized, stapled and accepted by Gatekeeper: <dmg>`. On failure, report the step and its message. A rejected notarization names the `xcrun notarytool log <id>` command that explains it.

## Verify

```sh
backend/.venv/bin/python scripts/verify-release.py dist/release
```

It checks:

- every file against `SHA256SUMS`;
- that Gatekeeper accepts the DMG, and the app inside it, as notarized Developer ID, and both staples validate;
- `syspolicy_check distribution`;
- that the bundled third-party notices are present;
- the app's identifier and version;
- that the updater archive holds only the app, with no macOS `._` entries, and its signature, against the public key in `tauri.conf.json`, and that `latest.json` matches it.

It mounts the DMG read-only in a temporary folder and detaches it. Report a failure as the release not verified, and do not hand it over.

## Hand over

- **Replace the Desktop copy.** If `~/Desktop/Wavefunction-<version>-macos-<arch>.dmg` exists, move it to `~/.Trash/` under a unique name, such as one with the commit or time. Never delete it.
- **Copy and confirm.** Copy the new DMG to the Desktop and confirm its SHA-256 matches `dist/release/SHA256SUMS`.
- **Installing.** To install, the user opens the DMG and drags Wavefunction to Applications, replacing an older copy.

## Relaunch

- **Launch.** Open the rebuilt `src-tauri/target/release/bundle/macos/Wavefunction.app`. It is now Developer ID-signed and notarized.
- **Check health.** Poll `/health`. Compare the project, thread and skill counts with those taken before quitting, using the verify steps in [rebuild-wavefunction](../rebuild-wavefunction/SKILL.md). Never print backend arguments or tokens.

## Report

Tell the user:

- the DMG path on the Desktop;
- the commit it was built from, and whether the tree was clean;
- the verification result;
- that the app was relaunched, and whether the counts matched.

The build does not authorize tagging, uploading to a GitHub release, publishing a release, or changing repository visibility. In-app updates read `latest.json` from a published GitHub release. Until the user asks for these files to be uploaded and published, installed apps will not see this build as an update.

Versions

The database has no other skills named release-wavefunction-dmg.

Database snapshot: 13.11.2026 · package version 5c91439961ea (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100rebuild-wavefunction
    Rebuild and relaunch the local Wavefunction macOS app with its bundled Python sidecar while preserving conversations, projects, skills, and credentials. Use when the user requests an app rebuild or restart after changes.
  • 100package-wavefunction-install-kit
    Build and verify a shareable Wavefunction macOS app ZIP and checksum using its bundled Python runtime. Use when the user asks for an install kit, test kit, or app archive for another Mac.
  • 90mac-app
    Build, bundle, sign and ship a macOS app with SwiftPM and the Command Line Tools only, no Xcode project. Use when creating a menu bar or desktop Mac app from the terminal, turning a Swift package into a .app, fixing macOS permission (TCC) prompts that never appear or keep…
  • 100release-lotion
    Release the Lotion macOS notes app to GitHub using the lotion-release CLI tool. Use this skill whenever the user wants to publish a new version, create a release, ship an update, cut a build, push a release to GitHub, or update the appcast. Also use when they mention archiving,…
  • 98socai-release
    Create, monitor, troubleshoot, and verify socai desktop GitHub releases from the command line with gh. Use when publishing a new release, triggering .github/workflows/release.yml, choosing patch/minor/major bumps, checking release workflow runs, or validating the latest macOS…
  • 100release-bucket-list
    Release the Bucket List macOS app (Cloudflare R2 client) to GitHub using the bucketlist-release CLI tool. Use this skill whenever the user wants to publish a new version, create a release, ship an update, cut a build, push a release to GitHub, or update the appcast. Also use…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.