Macaroni Messenger 1.05
Date: 2026-06-15
Release type: technical hygiene patch.
Main idea:
The code should not cook itself.
What Changed
- Removed the permanent smoke harness from the repo.
- Set the rule: if smoke is needed, write a scratch script in
/tmpor/private/tmp, run it, delete it. - Updated development docs for that rule.
- Updated provider docs: fake Contents API checks are possible, but they do not have to live in the repo.
- Clarified encryption implementation docs: a test tarp should not sit next to one HTML file.
- Added short section comments to
messenger.html. - Labeled constants/state.
- Labeled I18N.
- Labeled DOM/language helpers.
- Labeled Protocol v1 helpers.
- Labeled plugin boundary.
- Labeled Encryption 1.01.
- Labeled GitHub adapter.
- Labeled generic host helpers.
- Labeled remote adapter registry.
- Labeled profile/settings.
- Labeled IndexedDB storage.
- Labeled local test repo.
- Labeled rendering.
- Labeled chat info/membership.
- Labeled outbox/sync.
- Labeled event binding.
- Labeled browser support/public debug handles.
- Aligned the public adapter contract:
ensureBranchis now visible in the methods list. - Added
readHeadandensureBranchtowindow.MacaroniGitHub. - Added
sourceBranchandstorageBranchtowindow.MacaroniRemoteAdapters. - Did not split
messenger.htmlinto modules. - Did not add a bundler.
- Did not add a test framework.
- Did not add dependency injection.
- Did not start pretending this is enterprise.
Why
Macaroni Messenger is still one HTML file.
That is not an accident.
That is a product boundary.
But one file does not have to be a swamp.
So 1.05 does a simple thing:
keep one file,
but put road signs inside it
So a person can open messenger.html, spend an evening reading it, laugh in a few places, think in a few others, and not immediately call an exorcist with Prettier.
About Smoke
The permanent smoke harness was useful.
But it started turning the repo into a suitcase full of test socks.
The rule is simpler now:
need a check -> scratch script in /tmp
check passed -> scratch script deleted
repo stays clean
Checks are not banned.
They just do not live in the product as pets.
What Did Not Change
- Macaroni Protocol v1 did not change.
.macaroni/layout did not change.- Storage branch did not change.
- Encryption 1.01 did not change.
- Git-host adapters did not change behavior.
- UI did not change behavior.
- Backend is still absent.
messenger.htmlis still one file.
Result
Version 1.05 looks like a release about comments.
That is intentional.
Not a new feature.
Just tidied up before the code started cooking itself instead of macaroni.