Release 1.0.84: project changelog at finish, corrected README

.aether/version.json

@@ -1,4 +1,4 @@
 {
-  "updated_at": "2026-09-21T09:30:42.090861Z",
-  "version": "1.0.83"
+  "updated_at": "2026-09-21T10:09:59.079322Z",
+  "version": "1.0.84"
 }

.codex/CODEX.md

@@ -491,4 +491,4 @@ export AETHER_PLATFORM=codex
 
 ---
 
-*Updated for Aether v1.0.83 — 2026-09-21*
+*Updated for Aether v1.0.84 — 2026-09-21*

.opencode/OPENCODE.md

@@ -188,4 +188,4 @@ aether integrity
 aether update --force --download-binary
 ```
 
-*Updated for Aether v1.0.83 — 2026-09-21*
+*Updated for Aether v1.0.84 — 2026-09-21*

AGENTS.md

@@ -1,6 +1,6 @@
 # AGENTS.md -- Aether Development Guide (Codex CLI)
 
-> **Current Version:** v1.0.83
+> **Current Version:** v1.0.84
 > **Last Updated:** 2026-07-27
 > **Platform:** Codex CLI (OpenAI)
 
@@ -20,7 +20,7 @@ OpenCode, and Codex CLI.
 
 | What | Count/Status |
 |------|--------------|
-| Version | v1.0.83 |
+| Version | v1.0.84 |
 | Agent definitions | 27 castes; OpenCode also ships 1 restricted infrastructure router |
 | Skills | 86 (55 colony + 31 domain) |
 | Go binary | `aether` CLI (Go binary in cmd/) |
@@ -991,4 +991,4 @@ data files clean, and test coverage comprehensive as features evolve.
 
 ---
 
-*Updated for Aether v1.0.83 — 2026-09-21*
+*Updated for Aether v1.0.84 — 2026-09-21*

CHANGELOG.md

@@ -5,6 +5,26 @@ All notable changes to the Aether Colony project will be documented in this file
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.0.84] - 2026-09-21
+
+### Added
+
+- **Marking a project finished now writes it into the project's changelog.**
+  A dated entry with the project's goal and one line per phase is added to
+  `CHANGELOG.md` in the project folder, newest first, and the file is created
+  if there is none. A project closed before every phase was finished says so
+  and marks the unfinished phases. Running the same finish twice adds nothing
+  twice, and a changelog problem can never stop or undo the finish itself.
+
+### Changed
+
+- **The README was corrected against the current program.** Install
+  instructions are honest about which routes are behind the source, the worked
+  example shows one helper per build instead of four, the live view is
+  described as one inline screen, commands and folders that no longer exist
+  are gone, reliability figures with no evidence behind them were removed, and
+  the history now reaches this release.
+
 ## [1.0.83] - 2026-09-21
 
 All four fixes came from the owner's first morning of real use.
@@ -323,9 +343,9 @@ phases of work.
   you before it's marked complete**, closing a gap where a seal could be
   recorded without a clear owner confirmation.
 - **The `aether pause` command is now the standard name** for stopping work
-  at a safe point (the older `pause-colony` name still works as an alias),
-  and running `aether update` now restores that alias automatically if it
-  ever goes missing.
+  at a safe point (the older, longer name still works as an alias), and
+  running `aether update` now restores that alias automatically if it ever
+  goes missing.
 
 ### Fixed
 

CLAUDE.md

@@ -1,6 +1,6 @@
 # CLAUDE.md — Aether Development Guide
 
-> **Current Version:** v1.0.83
+> **Current Version:** v1.0.84
 > **Last Updated:** 2026-08-17
 
 > ## READ THIS BEFORE YOU WRITE ANYTHING TO THE OWNER
@@ -26,7 +26,7 @@
 
 | What | Count/Status |
 |------|--------------|
-| Version | v1.0.83 |
+| Version | v1.0.84 |
 | Slash commands | 64 (Claude) + 64 (OpenCode); Codex uses nine public ant skills + native CLI + 27 TOML agents |
 | Agent definitions | 27 |
 | Skills | 86 (55 colony + 31 domain) |
@@ -1127,10 +1127,33 @@ Metrics tracked:
 
 ## Changelog System
 
-Automated changelog collection:
-
-- `changelog-append` — Append entry to CHANGELOG.md
-- `changelog-collect-plan-data` — Collect plan data for changelog
+**Marking a project finished writes it into the project's changelog.** After
+`/ant-seal` has committed, the program adds one entry to `CHANGELOG.md` in the
+project folder: the date, the project's goal, and one line per phase, newest
+entry first but never above a hand-kept "Unreleased" section. If the folder has
+no changelog yet, one is created (owner's ruling, 2026-09-21). A project closed
+before every phase was finished says so, and marks the unfinished phases — it is
+never written up as complete. Running the same finish again adds nothing twice.
+The entry is a courtesy written *after* the finish: it cannot fail, delay or
+undo it, it never writes through a shortcut link or over anything that is not
+an ordinary file, and a problem is reported as one plain line.
+
+Locked by `TestFinishingAProjectWritesItsChangelogEntry` (the real
+init-to-finished path, so a writer nothing calls fails this by name),
+`TestProjectChangelogEntryShapeAndPlacement`,
+`TestProjectChangelogCreatesTheFileWhenMissing`,
+`TestProjectChangelogIsHonestAboutAForcedFinish`, and
+`TestProjectChangelogNeverWritesThroughALinkAndNeverFails`.
+
+Two older commands, `changelog-append` and `changelog-collect-plan-data`, still
+exist but nothing in the program calls them; they are on the list of features
+that were built and never switched on, and the behaviour above does not use
+them. Nothing updates a project's README automatically.
+
+*For dummies: when you mark a project finished, Aether adds a short dated note
+to that project's changelog saying what the goal was and which phases got done
+— and starts the file for you if there isn't one. If you closed the project
+early, the note says so rather than pretending it all got finished.*
 
 ---
 
@@ -1801,4 +1824,4 @@ For Codex-specific rules and agents, see `.codex/CODEX.md`
 
 ---
 
-*Updated for Aether v1.0.83 — 2026-09-21*
+*Updated for Aether v1.0.84 — 2026-09-21*