docs(indistinguishable): record why the 542 default could not be retired #705

Merged

coilyco-ops merged 1 commit from docs/indistinguishable-542-resolution into main

2026-08-13 20:06:58 +00:00

coilyco-ops commented

2026-08-13 20:05:25 +00:00

Member

The entry for issue 542 in docs/sirens-echo-indistinguishable-values.md was written before the fix and ends on a conclusion the fix did not follow:

Fixing one caller does not retire a default that is also a live service.

True, and incomplete in the way that matters. The default could not be retired at all. Echo's own deployment sets no instance name and relies on it, so renaming the fallback would have renamed a live service and refusing to start would have crash-looped it. The resolution was narrower: refuse the default only where it lies, which is an unset name paired with a definition that is not Echo's.

That is the part worth recording, because the doc's whole subject is defaults that read as real values. A reader who takes the current entry at face value concludes the fix is "stop defaulting", tries it, and breaks Echo.

Constraint worth noting

The file was 75 lines and 3934 characters after the edit, against caps of 80 lines and 4000 characters. Fitting the resolution meant tightening the existing sentences rather than only appending, and dropping a second cross-reference that would have cost about 105 characters. This is issue 537's pressure showing up again in the same file, and it is recorded here rather than argued there.

ward exec gate PASS on all six steps.

closes #704

The entry for [issue 542](https://forgejo.coilysiren.me/coilyco-gaming/sirens-echo/issues/542) in `docs/sirens-echo-indistinguishable-values.md` was written before the fix and ends on a conclusion the fix did not follow: > Fixing one caller does not retire a default that is also a live service. True, and incomplete in the way that matters. **The default could not be retired at all.** Echo's own deployment sets no instance name and relies on it, so renaming the fallback would have renamed a live service and refusing to start would have crash-looped it. The resolution was narrower: refuse the default only where it lies, which is an unset name paired with a definition that is not Echo's. That is the part worth recording, because the doc's whole subject is defaults that read as real values. A reader who takes the current entry at face value concludes the fix is "stop defaulting", tries it, and breaks Echo. ## Constraint worth noting The file was 75 lines and 3934 characters after the edit, against caps of 80 lines and 4000 characters. Fitting the resolution meant tightening the existing sentences rather than only appending, and dropping a second cross-reference that would have cost about 105 characters. This is [issue 537](https://forgejo.coilysiren.me/coilyco-gaming/sirens-echo/issues/537)'s pressure showing up again in the same file, and it is recorded here rather than argued there. `ward exec gate` PASS on all six steps. closes #704

coilyco-ops added 1 commit

2026-08-13 20:05:25 +00:00

docs(indistinguishable): record why the 542 default could not be retired

ci / image-build (pull_request) Successful in 18s

Details

ci / test (pull_request) Successful in 36s

Details

ci / publish-echo-image (pull_request) Has been skipped

Details

ci / publish-observed (pull_request) Has been skipped

Details

4ffc89b96e

The entry ended on "fixing one caller does not retire a default that is also a
live service", which is true and reads as a prescription to stop defaulting.
Echo's own deployment sets no instance name, so that would have renamed a live
service. The default is refused only where it lies instead.

Tightened the existing sentences rather than appending: the file is at 78 lines
and 3934 characters against caps of 80 and 4000.

closes #704

Co-authored-by: Kai Siren <coilysiren@gmail.com>
Co-authored-by: Claude <noreply@anthropic.com>

coilyco-ops requested review from coilysiren

2026-08-13 20:05:25 +00:00

coilyco-ops referenced this pull request

2026-08-13 20:05:43 +00:00

An evaluation run emits bare lookup spans with no root, which is honest now and still not useful #542

coilyco-ops merged commit 88cb2fa40d into main

2026-08-13 20:06:58 +00:00

coilyco-ops referenced this pull request from a commit

2026-08-13 20:06:59 +00:00

Merge pull request 'docs(indistinguishable): record why the 542 default could not be retired' (#705) from docs/indistinguishable-542-resolution into main