Skip to content

an open-source alternative to the dots, bots and muses of the world, run an office of claude code/codex like agents on your laptop, sandboxes or anywhere, uses your existing subscriptions

release(0.3.8): fix the download links, and gate them so they can't rot again

Chaitanya Giri0e51ce257c1a
diff --git a/RELEASE.md b/RELEASE.md
index bb8871f7..a82ec32a 100644
--- a/RELEASE.md
+++ b/RELEASE.md
@@ -66,27 +66,29 @@ Apple Silicon and Intel.
### 🍎 macOS
| Build | File |
|---|---|
-| Universal (Apple Silicon + Intel) | [`Munder-Difflin-0.3.2-mac-universal.dmg`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.3.2-mac-universal.dmg) |
+| Universal (Apple Silicon + Intel) | [`Munder-Difflin-0.3.8-mac-universal.dmg`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.3.8-mac-universal.dmg) |
### πŸͺŸ Windows
| Build | File |
|---|---|
-| Installer (x64) β€” *recommended* | [`Munder-Difflin-0.3.2-win-x64-setup.exe`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.3.2-win-x64-setup.exe) |
-| Portable (x64, no install) | [`Munder-Difflin-0.3.2-win-x64-portable.exe`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.3.2-win-x64-portable.exe) |
+| Installer (x64) β€” *recommended* | [`Munder-Difflin-0.3.8-win-x64-setup.exe`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.3.8-win-x64-setup.exe) |
+| Portable (x64, no install) | [`Munder-Difflin-0.3.8-win-x64-portable.exe`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.3.8-win-x64-portable.exe) |
### 🐧 Linux
| Build | File |
|---|---|
-| AppImage (x86_64) | [`Munder-Difflin-0.3.2-linux-x86_64.AppImage`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.3.2-linux-x86_64.AppImage) |
+| AppImage (x86_64) | [`Munder-Difflin-0.3.8-linux-x86_64.AppImage`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/Munder-Difflin-0.3.8-linux-x86_64.AppImage) |
### πŸ“¦ Source
-[Source code (zip)](https://github.com/chaitanyagiri/munder-difflin/archive/refs/tags/v0.3.2.zip) Β·
-[Source code (tar.gz)](https://github.com/chaitanyagiri/munder-difflin/archive/refs/tags/v0.3.2.tar.gz)
+[Source code (zip)](https://github.com/chaitanyagiri/munder-difflin/archive/refs/tags/v0.3.8.zip) Β·
+[Source code (tar.gz)](https://github.com/chaitanyagiri/munder-difflin/archive/refs/tags/v0.3.8.tar.gz)
> **Verify your download:** [`SHA256SUMS.txt`](https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/SHA256SUMS.txt) β€” then `shasum -a 256 -c SHA256SUMS.txt` (macOS/Linux) or `Get-FileHash` (Windows).
-> The links above always point at the **latest** release (`/releases/latest/download/…`),
-> so this page stays correct across versions.
+> The filenames above carry a version number, so they only resolve while this is the
+> latest release. If a link 404s you are reading an old release page β€” grab the current
+> build from the [**releases page**](https://github.com/chaitanyagiri/munder-difflin/releases/latest),
+> which is always right.
---
diff --git a/docs/index.html b/docs/index.html
index 0bb561f4..b5856c5b 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -1203,7 +1203,7 @@
// download picker β€” pick macOS / Windows / Linux, click starts the download
(function () {
var REPO = 'chaitanyagiri/munder-difflin';
- var REL = '0.3.5'; // fallback version; live links are resolved from the GitHub API below
+ var REL = '0.3.8'; // fallback version; live links are resolved from the GitHub API below
var BASE = 'https://github.com/' + REPO + '/releases/latest/download/';
var PLATFORMS = [
{ key: 'mac', icon: '🍎', os: 'macOS', sub: 'Universal · Apple Silicon + Intel', match: 'mac-universal.dmg', file: 'Munder-Difflin-' + REL + '-mac-universal.dmg' },
diff --git a/package.json b/package.json
index bf20f0b3..92a4d22f 100644
--- a/package.json
+++ b/package.json
@@ -1,6 +1,6 @@
{
"name": "munder-difflin",
- "version": "0.3.7",
+ "version": "0.3.8",
"private": true,
"description": "Local multi-agent harness for Claude Code: autonomous agents that message, route, and remember β€” coordinated by a GOD orchestrator and visualized as avatars at work.",
"main": "out/main/index.js",
@@ -20,6 +20,7 @@
"typecheck:web": "tsc --noEmit -p tsconfig.web.json",
"typecheck": "npm run typecheck:node && npm run typecheck:web",
"test:focused": "node --test test/codex-remote.test.cjs test/control.test.cjs test/provider-automation.test.cjs test/provider-config.test.cjs test/queue-delivery.test.cjs test/terminal-automation.test.cjs test/terminal-recovery.test.cjs test/roster.test.cjs test/proc-kill.test.cjs test/expand-tilde.test.cjs test/hive-cwd.test.cjs test/hive-hook-node.test.cjs test/hive-roster-injection.test.cjs test/hive-runtime-path.test.cjs test/cli-install-ladder.test.cjs test/node-install.test.cjs test/office-gl-recovery.test.cjs test/update-state.test.cjs test/transcript-project-dir.test.cjs",
+ "check:links": "node tools/check-release-links.cjs",
"dist": "npm run build && electron-builder",
"dist:mac": "npm run build && electron-builder --mac",
"dist:win": "npm run build && electron-builder --win",
diff --git a/tools/check-release-links.cjs b/tools/check-release-links.cjs
new file mode 100644
index 00000000..d8ce16a6
--- /dev/null
+++ b/tools/check-release-links.cjs
@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+'use strict';
+
+/**
+ * Release gate: every download link we advertise must actually resolve.
+ *
+ * WHY THIS EXISTS. RELEASE.md is published verbatim as the GitHub release body,
+ * and its download table links to
+ * `/releases/latest/download/Munder-Difflin-<version>-<platform>.<ext>`. That URL
+ * form requires the EXACT filename present in whichever release is currently
+ * "latest", and electron-builder bakes ${version} into every artifact name β€” so a
+ * version string left behind in RELEASE.md turns all four download links into
+ * hard 404s the moment the next release ships.
+ *
+ * That is not hypothetical. The table sat pinned at 0.3.2 from v0.3.4 through
+ * v0.3.7, and mac DMG downloads fell from 118 and 76 on v0.3.2/v0.3.3 to single
+ * digits on every release after. Nothing failed, nothing warned; the release
+ * simply stopped being installable for anyone arriving through GitHub, and the
+ * page even claimed the opposite ("stays correct across versions").
+ *
+ * Two modes:
+ * (default) offline β€” every advertised version string matches package.json.
+ * Run this BEFORE tagging, when the assets do not exist yet.
+ * --live also HEADs each URL and requires 200. Run this AFTER publishing
+ * the release, which is the only moment the answer is meaningful.
+ */
+
+const fs = require('node:fs');
+const path = require('node:path');
+
+const root = path.join(__dirname, '..');
+const version = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8')).version;
+const releaseMd = fs.readFileSync(path.join(root, 'RELEASE.md'), 'utf8');
+
+const problems = [];
+
+// β€” 1. every pinned artifact name must carry the current version β€”
+const assetRe = /Munder-Difflin-(\d+\.\d+\.\d+)-([^\s`)]+)/g;
+const assets = new Set();
+for (const m of releaseMd.matchAll(assetRe)) {
+ if (m[1] !== version) {
+ problems.push(`RELEASE.md advertises Munder-Difflin-${m[1]}-${m[2]} but package.json says ${version}`);
+ }
+ assets.add(`Munder-Difflin-${m[1]}-${m[2]}`);
+}
+if (assets.size === 0) problems.push('RELEASE.md advertises no download assets at all β€” did the table move?');
+
+// β€” 2. source tarball tags too; a stale tag silently ships last release's source β€”
+for (const m of releaseMd.matchAll(/archive\/refs\/tags\/v(\d+\.\d+\.\d+)/g)) {
+ if (m[1] !== version) {
+ problems.push(`RELEASE.md links source for tag v${m[1]} but package.json says ${version}`);
+ }
+}
+
+// β€” 3. the website's fallback version (used when the GitHub API call fails) β€”
+const indexHtml = path.join(root, 'docs/index.html');
+if (fs.existsSync(indexHtml)) {
+ const m = /var REL = '(\d+\.\d+\.\d+)'/.exec(fs.readFileSync(indexHtml, 'utf8'));
+ if (m && m[1] !== version) {
+ problems.push(`docs/index.html download fallback is ${m[1]}, package.json says ${version}`);
+ }
+}
+
+async function checkLive() {
+ const base = 'https://github.com/chaitanyagiri/munder-difflin/releases/latest/download/';
+ for (const name of [...assets, 'SHA256SUMS.txt']) {
+ let status = 0;
+ try {
+ // GitHub 302s asset downloads to a CDN, so follow it; HEAD is enough.
+ status = (await fetch(base + name, { method: 'HEAD', redirect: 'follow' })).status;
+ } catch (e) {
+ problems.push(`${name} β€” request failed: ${e.message}`);
+ continue;
+ }
+ if (status !== 200) problems.push(`${name} β€” HTTP ${status} (advertised but not downloadable)`);
+ else console.log(` ok ${name}`);
+ }
+}
+
+(async () => {
+ if (process.argv.includes('--live')) {
+ console.log(`Checking advertised downloads for v${version} against the live latest release…`);
+ await checkLive();
+ }
+ if (problems.length) {
+ console.error(`\nβœ— release links are wrong (${problems.length}):`);
+ for (const p of problems) console.error(` - ${p}`);
+ console.error('\nFix RELEASE.md / docs/index.html to match package.json before releasing.');
+ process.exit(1);
+ }
+ console.log(`βœ“ release links consistent at v${version}`);
+})();