Skip to content

docs: record the fourth field session - #37

Merged
antoinevalentinHA merged 1 commit into
masterfrom
docs/field-session-4
Aug 21, 2026
Merged

docs: record the fourth field session#37
antoinevalentinHA merged 1 commit into
masterfrom
docs/field-session-4

Conversation

@antoinevalentinHA

Copy link
Copy Markdown
Owner

Documentation only. Records a fourth field session and corrects what it contradicts.

What the session adds

The first to run the released commit (0.4.3-fork.1 at 45e3a55), and the first to exercise the provenance check on a device. Earlier sessions could only show that reusing a conversion could be correct and that timestamps could not establish it. This one produced a verdict: a converted pack was compared against the source it was supposedly made from, and the two were proven to differ.

Two phases:

  • Nine adds of previously unseen UUIDs — index 33 → 42, nine Pack added., no incident, and no question asked, since none had a conversion to reuse.
  • Three same-UUID replacements on packs whose content had genuinely changed — each 42 → 41 then 41 → 42, mismatch every time, re-converting sent the right content. Final state 42 packs, no INVALID_STATE_ERR, no libusb error, no HTTP 500.

Two behaviours are observed here for the first time. Replacing a pack has to be done as delete then transfer, which is the refusal of a pre-existing content folder seen from the outside. And the dialog says which of its two answers it is giving, so the verdict is readable on screen without a log — the two wordings are quoted from the shipped strings rather than paraphrased.

The section also records why 0.4.3-fork.1 does not name a build: the version is fixed rather than a snapshot, so master kept declaring it after moving past 45e3a55. A field report has to give the commit, and say whether the runtime was the published asset or a local rebuild. This one was a local rebuild — same tree as the published archive, different binary.

What it contradicted

Four passages are corrected because the new section would otherwise sit against them in the same file:

Was Is
tying a conversion to its source "is still an open problem" put in the past, and marked solved since for conversions made after the work landed
Not proven: "that a given converted instance was produced from a given source" narrowed to conversions made before provenance was recorded
What is still open: "C7-1 … did not make it knowable" same narrowing; later conversions carry a record and are checked against it
"two sessions" exercising the reworked write path three — the first session predates that code

The READMEs move from three documented sessions to four, in both languages.

Naming

Packs are designated neutrally — personal pack 57, continuing the numbering the file already uses — and identified by the leading bytes of their UUIDs, which is what carries the uniqueness evidence. No work titles, verified across the whole tracked tree. The UUIDs of the packs that were added but not replaced are not reproduced: they carry no evidence.

Left alone deliberately

Two claims under What is still open are stale for reasons unrelated to this session, so they are flagged rather than fixed here: that retrying a failed upload has no defined semantics (it is now explicitly refused), and that nothing reports partial states at connection time (a listing exists, with no caller). Separate matter.

The FAT incident, the limits, and everything the sessions do not establish are untouched. No crash-safety is claimed anywhere.

No code, no test, no POM, no workflow, no TESTING.md. No tag created or modified, no release modified.

🤖 Generated with Claude Code

The first session to run the released commit, and the first to exercise
the provenance check on a device. It is also the first to produce a
verdict rather than a doubt: a converted pack was compared against the
source it was supposedly made from, and the two were proven to differ.

Two phases are recorded. Nine adds of previously unseen UUIDs took the
index from 33 to 42 with no incident and no question asked, since none of
them had a conversion to reuse. Three same-UUID replacements, on packs
whose content had genuinely changed, each produced a mismatch, and
re-converting sent the right content.

Two things are observed here for the first time. Replacing a pack has to
be done as delete-then-transfer, which is the refusal of a pre-existing
content folder seen from the outside. And the dialog says which of its
two answers it is giving, so the verdict is readable on screen without a
log — the wording is quoted from the shipped strings rather than
paraphrased.

Four passages the new section would have contradicted are corrected. The
third session's conclusion that tying a conversion to its source was an
open problem is put in the past and marked solved for conversions made
since; the same claim is narrowed where it appears under Not proven and
under What is still open; and the count of sessions exercising the
reworked write path goes from two to three. The READMEs move from three
documented sessions to four.

Packs are designated neutrally and identified by the leading bytes of
their UUIDs, as the rest of the file already does. No work titles.

Left alone deliberately, being stale for reasons unrelated to this
session: the claims that retrying a failed upload has no defined
semantics, and that nothing reports partial states at connection time.

Documentation only. No code, no test, no tag, no release.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@antoinevalentinHA
antoinevalentinHA merged commit c7715a3 into master Aug 21, 2026
3 checks passed
@antoinevalentinHA
antoinevalentinHA deleted the docs/field-session-4 branch August 21, 2026 16:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant