Beta v0.135.5-beta.3232

What's new

• Preserve code-only retirement checkpoint (#930)

Local branches and dirty checkouts contain unfinished code that would be lost during retirement cleanup. This PR preserves their inspected code deltas as 11 inert binary Git patches, with base/head commits, source identifiers, SHA-256 hashes, and recovery instructions in the manifest. It does not integrate or claim completion of those features.

The archive excludes local planning material, contextual prose, settings, runtime state, and sensitive fixtures. The root naming exception is limited to this retirement checkpoint directory.

Validation: all 11 patch hashes and file counts matched the manifest; each patch passed git apply --cached --check against a fresh index at its recorded base; archive paths passed the exclusion audit; Gitleaks found no leaks; the full applicable Lefthook pre-commit suite passed. A sibling archive directory still fails root naming.

Review

Nothing to report.

Contract match: yes — archive, privacy boundary, manifest, and scoped lint exception match the brief

Important findings open: 0

Manual install

Automated build from commit 5ab1377 -- not a tagged release.
Download the .zip, unzip, and drag mill.app to Applications. The app is not Apple-notarized: first launch is blocked with "Apple could not verify…" -- click Done (not Move to Trash), then System Settings → Privacy & Security → scroll to the mill message → Open Anyway (one time only). Terminal alternative: /usr/bin/xattr -dr com.apple.quarantine /Applications/mill.app.
Every later merge to main updates in-app via Settings → Updates → Update now -- no rebuild, no repeat of this step.

v0.5.0

0.5.0 (2026-08-22)

Features

• a card's context flows into its attached action runs (goal 0126 slice 1) (#267) (f734454)
• apply-atlas-docs-sync -- mirror a docs folder into Atlas, idempotently (goal 0108 slice 2) (#248) (d8431b5)
• apply-notify -- a workflow can say it finished (goal 0114) (#252) (8981645)
• arrange is an action -- positions sovereign, one-shot Auto-arrange, side-anchored edges (goal 0089) (#196) (3f9b193)
• Atlas AI companion panel -- conversational, proposing, never autonomous (goal 0101 slice 1) (#326) (8fc09bf)
• atlas attribute-value facets -- Fields menu, key-merged options facets, Field:Value chips (goal 0129 slice 3) (#287) (0af1114)
• atlas capture doors -- instant file landing, prescoped import, paste, scratchpad inbox (goal 0081 A3) (#190) (9d251dd)
• atlas containment -- area drawing, marker-box grouping, drag filing, context-aware menus (goal 0081 A2) (#189) (61cd09c)
• atlas creation core -- tray, placement popover, sticky notes, promotion (goal 0081 A1) (#187) (d411bf1)
• Atlas interaction overhaul -- unified click model, flip retirement, keyboard nav (goals 0102/0104/0106 slice A) (#227) (15409e7)
• Atlas linking you can trust — drop anywhere, honest handles, hover actions (goal 0124 slice 2) (#263) (90a7b4f)
• atlas over MCP -- read tools, cards resource, guarded card-write through the pending-approval plane (goal 0083) (#195) (5f5c76d)
• atlas page at scale -- entry cap with expander, lazy mirror previews (goal 0073 slice B) (#177) (3fdff16)
• Atlas perspectives frontend -- switcher, board filtering, membership (goal 0095 slice 2, ADR-0041) (#229) (fb05b6b)
• atlas read-is-edit page -- in-place typed controls, slot-row links, chip navigation (goal 0081 A5) (#193) (3b1e233)
• atlas selection tray -- visible selection outline + Group/Delete action surface (goal 0092 follow-up) (#203) (f2e914e)
• atlas session restore -- viewed level and open card survive restart (goal 0091 lite) (#198) (83d5e60)
• atlas shift-click select -- toggle membership without the box (goal 0092) (#199) (5b08e7f)
• atlas typed link slots -- flip-face rows, instant slot-drag linking, quiet edges, kind-aware menus (goal 0081 A4) (#191) (c3f90e7)
• Atlassian PAT seeds — Confluence read + Jira search examples (goal 0111) (#259) (f8d2162)
• away-capture -- Quick Panel Save-as-note door (goal 0090) (#202) (a6e67b3)
• beta channel -- rolling pre-release feed + pre-swap/version-change backup guards (goal 0100) (#222) (0ff99a3)
• browser-tab notification for a parked approval (goal 0132 slice A) (#361) (26d5932)
• canvas surfaces the step I/O contract (ADR-0042, goal 0119 slice 2) (#256) (4ecbe5f)
• canvas tool registry -- Card/Note/Area/Table migrate onto it (goal 0169 slice 1) (#355) (7ebcfa5)
• card actions -- attach and run multiple callable workflows per card (goal 0084) (#197) (105bbcf)
• card-reference fields with kind-compatibility filtering (goal 0152 slice 2) (#315) (78de9b5)
• channel-aware updates -- update-now on release builds, notify-and-instruct on source builds (goal 0082) (#184) (0f82180)
• CodeMirror-backed CodeEditor for code-shaped inputs (goal 0120) (#261) (d63115e)
• configurable MCP access address (goal 0116 added item) (#329) (9bc3e71)
• container-delete confirm + export mirror-bytes note (goal 0149 safe fixes) (#310) (259420d)
• context menus everywhere -- inventory rows, work tabs, panes, edges (goal 0075 completion) (#178) (15d96e3)
• contextual shortcuts complete -- help overlay, cmd-K via registry precedence, quick-access parity (goal 0071) (#181) (193ade3)
• copy/paste clones -- Atlas board + workflow canvas (goal 0153) (#316) (d312fef)
• creation is the toolbar -- Table tool + size picker join Card/Note/Area, the + Add menu is retired, placement decides containment (goal 0139) (#293) (d394a2e)
• credential pre-flight -- a missing integration secret surfaces before the run (goal 0127 slice 3) (#282) (b9cda4f)
• delivery evidence ledger mirror + seeded Kind (goal 0164 L1) (#334) (d3e786d)
• density reads on every major surface (goal 0150) (#308) (2d3c01d)
• display density -- Comfortable/Compact appearance preference (goal 0096) (#213) (b00bfe0)
• drag out of containment -- frame children are draggable and re-parent on crossing the edge (goal 0141) (#295) (2b2528f)
• enable axe-core's WCAG 2 A/AA rules -- a second, independent a11y audit pass (goal 0157) (#327) (e5fafd2)
• enforce the Go ports/adapters boundary against wails/v3/pkg/application (goal 0168) ([#351](...

v0.4.0

Highlights — the Atlas release

Mill now has a second surface: Atlas — a map of where your truth lives. A detective-board canvas of typed cards (documents, people, topics — your own kinds) that you arrange, connect, and zoom through like one continuous map:

• One board, every level. Areas render as frames with their contents visible inside; zooming into one is a camera move, not a page change. Detail follows distance: full cards up close, compact chips and honest "+ N more" tiles one level down, bare counts beyond — and the same rule shapes the lines, so relationships draw as clean area-to-area arteries instead of spaghetti.
• Three gestures, everywhere. Click flips a card to its working summary. Double-click commits — into a place, or open a card's full page. ⌘K flies you to anything by name (↵ lands your eye there, ⌘↵ opens it). ⌘-click opens directly; ⌘↑ steps back up. Right-click works too — cards and workflow steps both carry real context menus.
• Cards carry provenance. Source link, mirrored file with freshness, a refresh workflow behind "Update now" — run through the same guardrail gate as everything else, with the receipt linked. Share any card or space as clean context for an AI or a colleague.
• Built for real density. Boards stay readable at dozens of cards: capped frame previews, auto-arranged layouts that seat related things together, and cards that never overlap by accident.

Also in this release: workflows survive schema change (field evolution with tombstones, key immutability, delete-integrity), published decision versions with runs stamped against the exact version they used, automatic rolling backups + export-everything/import with a documented bring-your-own-Postgres path, a phone-usable companion mode, and a per-surface command palette section with rebindable shortcuts throughout.

Install

Download the .zip, unzip, and drag mill.app to Applications — no build needed. The app is not Apple-notarized, so the first launch is blocked with "Apple could not verify…" — click Done (not Move to Trash), then System Settings → Privacy & Security → scroll to the mill message → Open Anyway (one time only; on pre-Sequoia macOS, right-click → Open works instead). Terminal alternative: xattr -d com.apple.quarantine /Applications/mill.app. Verify the download came from this repo's CI: gh attestation verify <the .zip> -R alicoding/mill. Prefer building from source? git clone + the README's few commands work on any Mac.

What's Changed

• feat: run analytics v2 -- duration KPI, trigger recency, step-type failure breakdown (goal 0051) by @alicoding in #139
• feat: atlas domain + service -- user-declared kinds, cards, links, spaces (goal 0061 slice A, ADR-0038) by @alicoding in #140
• feat: atlas surface -- spaces, drill, card overlay, lens, quick-panel cards (goal 0061 slice B, ADR-0038) by @alicoding in #141
• feat: atlas contract family, guarded update-now, receipt provenance (goal 0061 slice C, ADR-0036/0038) by @alicoding in #142
• chore: docs anti-rot public side -- package-comment floor, AGENTS.md, README truth (goal 0049) by @alicoding in #143
• feat: schema evolution guards -- key immutability, deprecation, field tombstones, delete integrity (goal 0046 slice 1, ADR-0040) by @alicoding in #144
• feat: decision versions -- publish, pinned resolution, run stamping (goal 0046 slice 2, ADR-0040) by @alicoding in #145
• feat: node complexity facet -- required metadata + palette progressive disclosure (goal 0047) by @alicoding in #146
• chore: step vocabulary sweep -- MCP descriptions + root document stepTypes alias (goal 0052 leftovers) by @alicoding in #147
• test: e2e flake hardening -- retire the recurring retry classes (goal 0062) by @alicoding in #148
• feat: atlas-workflow integration -- card steps, kind-scoped trigger, guarded writes (goal 0066, ADR-0035/0038) by @alicoding in #149
• feat: data stewardship -- vacuum-into backups, seeded backup workflow, export-everything (goal 0065) by @alicoding in #150
• feat: atlas share model -- card/space context copy, mirror folders, kind evolution (goal 0063, ADR-0038) by @alicoding in #151
• feat: atlas projections -- mirror rendering, traceability matrix, coverage (goal 0064, ADR-0038) by @alicoding in #152
• test: root-cause CI shard-trio flakes -- canvas click landed on the wrong node (goal 0069) by @alicoding in #154
• feat: mobile companion pass -- responsive shell, five phone jobs, install story (goal 0068) by @alicoding in #153
• fix: atlas canvas drag lag -- proper React Flow state ownership + memoized card node by @alicoding in #155
• fix: the app names itself -- Mill version in footer and Settings, Docs links to Mill by @alicoding in #156
• feat: synced-folder onboarding -- consent-first scan, kind suggestions, preview import (goal 0067) by @alicoding in #157
• docs: design/UX contracts are orchestrator work-product, never delegated by @alicoding in #158
• fix: atlas root is My space -- auto-enter, chip dedupe, visible view-mode control by @alicoding in #159
• feat: atlas one-map -- region frames, note cards with flip, drawn links (goal 0072 slice A) by @alicoding in #160
• feat: atlas camera navigation + command-K jump (goal 0072 slice B) by @alicoding in #161
• feat: atlas card page -- typed contents, meta rail, group flip (goal 0072 slice C) by @alicoding in #162
• fix: atlas count chips pluralize correctly by @alicoding in #163
• fix: atlas live pass -- board fills pane, floating link edges, page reads-first, retired-kind migration by @alicoding in #164
• feat: atlas semantic zoom -- preview cap, region chips, link reattachment, dense fixture (goal 0073 slice A) by @alicoding in #165
• fix: atlas page gutters + lens never hides a region frame by @alicoding in #166
• feat: atlas gesture model -- click glances, double-click commits, chips flip (goal 0074) by @alicoding in #167
• feat: atlas free-mode overlap resolution -- frames never overlap, arrivals place clear (goal 0073) by @alicoding in #168
• feat: atlas line semantic zoom -- edges lift to area-level arteries (goal 0073) by @alicoding in #169
• feat: link-adjacent auto-arrange + surface-scoped shortcuts (goals 0073/0071) by @alicoding in #171
• feat: context-menu architecture -- one Primer-native menu, Atlas cards + canvas steps wired (goal 0075) by @alicoding in #172
• chore: v0.4.0 -- the Atlas release by @alicoding in #173
• chore: build config version follows v0.4.0 by @alicoding in #174
• docs: DoR gains the integration-surfaces triage by @alicoding in #175

Full Changelog: v0.3.0...v0.4.0

v0.3.0

Install

Download the .zip, unzip, and drag mill.app to Applications — no build needed. The app is not Apple-notarized, so the first launch is blocked with "Apple could not verify…" — click Done (not Move to Trash), then System Settings → Privacy & Security → scroll to the mill message → Open Anyway (one time only; on pre-Sequoia macOS, right-click → Open works instead). Terminal alternative: xattr -d com.apple.quarantine /Applications/mill.app. Verify the download came from this repo's CI: gh attestation verify <the .zip> -R alicoding/mill. Prefer building from source? git clone + the README's few commands work on any Mac.

What's Changed

• docs: close goal 0045 — v0.2.0 live, cadence rule locked by @alicoding in #89
• fix: install notes match current-macOS Gatekeeper flow by @alicoding in #90
• docs: goal 0046 queued — schema evolution without breaking history by @alicoding in #91
• docs: goal 0047 queued — node audience/complexity facet by @alicoding in #92
• docs: goal 0043 pickup — mechanism already built; registry entry added by @alicoding in #93
• feat: cmd+shift+bracket aliases for tab cycling by @alicoding in #94
• feat: unsaved-changes close guard for canvas tabs (goal 0048) by @alicoding in #95
• docs: queue goals 0049-0051 (docs anti-rot, structure audit, analytics v2) by @alicoding in #96
• docs: goal 0044 — far-side bridge requirements captured by @alicoding in #97
• docs: queue goal 0052 — contract maturity (generated schema + versioned envelope) by @alicoding in #98
• docs: goal 0052 — import/export symmetry, schema per envelope by @alicoding in #99
• docs: goal 0052 — root contract document + filterable node discovery by @alicoding in #100
• docs: queue goal 0053 — step vocabulary, sequenced before 0052 by @alicoding in #101
• docs: queue goal 0054 — step designer + declare-vs-code boundary by @alicoding in #102
• docs: goal 0044 — JIT scratch-capture dry-run scenario by @alicoding in #103
• docs: goal 0044 — diagram round-trip verdict by @alicoding in #105
• docs: goal 0044 — boundary guard on scratch-capture gaps by @alicoding in #106
• fix: updater matches macos-named release assets; version drift gated by @alicoding in #104
• docs: queue goals 0055-0056 — canvas notes, workbench boundary by @alicoding in #107
• feat: apply-file-write node -- scratch-capture apply step (goal 0044) by @alicoding in #108
• docs: goal 0044 scenario-1 dry run -- six named gaps recorded by @alicoding in #109
• feat: user-facing vocabulary says step, not node (goal 0053) by @alicoding in #110
• docs: goal 0057 queued -- live-sync audit (no reload, ever) by @alicoding in #112
• fix: runs panel updates live -- run start/completion emit mill-data-changed by @alicoding in #111
• fix: live-sync completeness -- run lifecycle emits + hotkey/keybinding vocabulary (goal 0057) by @alicoding in #113
• docs: goal 0057 delivered -- live-sync audit archived by @alicoding in #114
• chore: regenerate dataevent bindings doc comment by @alicoding in #115
• release: v0.3.0 -- close guard signed off, goal 0048 archived by @alicoding in #116

Full Changelog: v0.2.0...v0.3.0

v0.2.0

Install

Download the .zip, unzip, and drag mill.app to Applications — no build needed. The app is not Apple-notarized, so the first launch is blocked with “Apple could not verify…” — click Done (not Move to Trash), then System Settings → Privacy & Security → scroll to the mill message → Open Anyway (one time only; on pre-Sequoia macOS, right-click → Open works instead). Terminal alternative: xattr -d com.apple.quarantine /Applications/mill.app. Verify the download came from this repo's CI: gh attestation verify <the .zip> -R alicoding/mill. Prefer building from source? git clone + the README's few commands work on any Mac.

What's Changed

• docs: close goal 0041 — OSS trust standards delivered, v0.1.0 live by @alicoding in #81
• docs: close goal 0041 — OSS trust standards delivered, v0.1.0 live by @alicoding in #82
• docs: goal 0044 capture-path research recorded + two ADR corrections by @alicoding in #85
• feat: markdown fidelity pass 2 — five Confluence conversion rules (goal 0042) by @alicoding in #84
• fix: releases ship a launchable Mill.app zip, not the raw binary by @alicoding in #86
• chore: version 0.2.0 + release-cadence rule in SPEC (goal 0045) by @alicoding in #87
• fix: release notes block was invalid YAML + workflow-lint gate by @alicoding in #88

Full Changelog: v0.1.0...v0.2.0

v0.1.0

Note

The mill-0.1.0-macos-arm64 asset is a raw binary, not a double-clickable app — run it from a terminal (chmod +x mill-0.1.0-macos-arm64 && xattr -d com.apple.quarantine mill-0.1.0-macos-arm64 && ./mill-0.1.0-macos-arm64), or use v0.2.0+, which ships a proper mill.app you can drag to Applications.

What's Changed

• feat: comment-hygiene — constraints not narrative, rule + gate + sweep (goal 0038) by @alicoding in #55
• docs: close goal 0024 — CI/CD architecture acceptance verified live by @alicoding in #56
• feat: one-shot dock bounce on parked approvals while away (Standing #9) by @alicoding in #57
• feat: workflow-row hotkey-trigger hints in palette + Quick Panel (goal 0015 close) by @alicoding in #58
• fix: pin task dev's MCP listener to 8091 (never contend with the managed server) by @alicoding in #59
• fix: UX copy voice — product copy, not spec narrative (goal 0040) by @alicoding in #60
• docs: README hero — theme-aware banner, badge row, live canvas screenshot by @alicoding in #61
• docs: goal 0041 (OSS trust standards) opened + goal 0021 Phase 4 research recorded by @alicoding in #62
• feat: OSS trust standards — Scorecard mechanical wave + community files (goal 0041) by @alicoding in #63
• docs: goal 0041 CodeQL first-run triage recorded by @alicoding in #70
• build(deps-dev): Bump eslint-plugin-react-refresh from 0.5.3 to 0.5.4 in /frontend in the npm-dependencies group by @dependabot[bot] in #64
• build(deps): Bump github/codeql-action/upload-sarif from 4.37.4 to 4.37.6 in the github-actions group by @dependabot[bot] in #69
• build(deps-dev): bump globals from 15.15.0 to 17.9.0 in /frontend by @alicoding in #71
• build(deps): bump react and react-dom from 18.3.1 to 19.2.8 in /frontend by @alicoding in #72
• feat: Mill's own app mark — icon, favicon, rail logo (goal 0001 wave 4) by @alicoding in #73
• build(deps-dev): Bump typescript-eslint from 8.66.0 to 8.67.0 in /frontend in the npm-dependencies group by @dependabot[bot] in #74
• chore: version 0.1.0 — first tagged release (goal 0041) by @alicoding in #76
• build(deps-dev): bump typescript from 5.9.3 to 6.0.3 in /frontend by @alicoding in #77
• fix: Confluence markdown table fidelity + fixture corpus (goal 0021 Phase 4) by @alicoding in #78
• fix: release build no longer launches the app on the runner by @alicoding in #79
• fix: build task's help echo executed 'task run' via backtick substitution by @alicoding in #80

Full Changelog: https://github.com/alicoding/mill/commits/v0.1.0