Stash/stash-docs

Fork 0

Decision: seeking a memo from its transcript #6

Open

agent wants to merge 8 commits from m2-03-transcript-seek-decision into main

agent commented

2026-08-09 16:06:38 -04:00

Member

The decision file behind stash-ios#44 (M2-03).

This branch carries five earlier decision files as well as mine. main here has only the
initial commit — the decisions for the documents directory, the Record control, the unfinalised
tail, the two readers, and the audio session were committed locally on a branch called
m1-13-control-decision and never pushed. They are ancestors of my commit, so they arrive with
it. Flagging rather than quietly shipping six commits under one title; say if you would rather
they went separately.

Mine records why the cue under the playhead is the last one that started rather than the one
whose range contains it, why file order is preserved for reading while a sorted copy answers the
time lookup, why following is abandoned on interaction and resumed only by asking, and why cue
text lost its selectability. It also records the measurement: a one-hour memo seeking from cues
near the end landed within about half a second of the words.

The decision file behind stash-ios#44 (M2-03). **This branch carries five earlier decision files as well as mine.** `main` here has only the initial commit — the decisions for the documents directory, the Record control, the unfinalised tail, the two readers, and the audio session were committed locally on a branch called `m1-13-control-decision` and never pushed. They are ancestors of my commit, so they arrive with it. Flagging rather than quietly shipping six commits under one title; say if you would rather they went separately. Mine records why the cue under the playhead is the last one that *started* rather than the one whose range contains it, why file order is preserved for reading while a sorted copy answers the time lookup, why following is abandoned on interaction and resumed only by asking, and why cue text lost its selectability. It also records the measurement: a one-hour memo seeking from cues near the end landed within about half a second of the words.

agent added 6 commits

2026-08-09 16:06:38 -04:00

The documents directory is the user's 701894a74d

The decision behind stash-ios #12: UIFileSharingEnabled and
LSSupportsOpeningDocumentsInPlace, and why UISupportsDocumentBrowser and
coordinated access were both rejected.

First file here, so it also sets the shape: decisions/YYYY-MM-DD-what.md, one
per decision, recording why the alternative was rejected.

Decision: starting a recording from a control b88a8094a2

Records why the Record control is a button rather than a toggle, and why it
opens the app rather than recording in place: iOS does not permit an app to
start audio recording from the background, which was measured on a device
with the phone unlocked, not reasoned about.

Also what adopting AudioRecordingIntent obliges — the Live Activity becomes a
condition of the recording continuing, which inverts the rule that the lock
screen can never fail one.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Decision: keeping the unfinalised transcript tail 75f6b3d6f3

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Decision: two readers for one file format b2d70035e4

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Decision: handing the audio session between capture and playback 8b5efd44a4

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

Decision: seeking a memo from its transcript 4e274f890d

Why the cue under the playhead is the last one that started rather than the one
whose range contains it, why file order is preserved for reading while a sorted
copy answers the lookup, why following is abandoned on interaction and resumed
only by asking, and why cue text lost its selectability.

Records what a one-hour memo measured: the audio landed within about half a
second of the words when seeking from cues near the end.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

agent referenced this pull request from Stash/stash-ios

2026-08-09 16:06:55 -04:00

M2-03: Seek from the transcript #30

agent added 1 commit

2026-08-09 17:26:51 -04:00

Decision: asking for location bbf29d4ade

Recording a route is opt-in, off on a fresh install, and the opt-in ships
before anything that collects. Always authorization, superseding the When
In Use call of 2026-08-08 — with what it costs written beside it, since
iOS is no longer what enforces "only while recording". Full precision is
never asked for in code, because the only API for it grants temporarily
and re-asking around every recording was ruled out.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

agent added 1 commit

2026-08-09 18:15:39 -04:00

A memo is up to three files 84df485de9

The filenames, the shared parts folder and its numbering, and which path may
delete which file. Recorded here because these are the cross-client contract:
the vault's inbox processing and every other client read these names, and the
reasoning otherwise lives only in an iOS branch.

The GPX element layout is not here. That is a separate decision, recorded with
the work that writes the first track.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

agent force-pushed m2-03-transcript-seek-decision from 84df485de9 to bbf29d4ade

2026-08-09 18:20:56 -04:00

Compare

agent added 1 commit

2026-08-09 20:56:41 -04:00

Decision: the track is a GPX file 43070b2ccb

Records the format M2-07 writes: GPX 1.1, absolute UTC time and altitude
native, speed and course in Garmin's TrackPointExtension v2, horizontal
accuracy under a Stash namespace rather than coerced into <hdop>.

Also records why JSON was rejected, that this amends decision 3 of the M2
planning round, and what a gap and a withdrawn consent look like on disk.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

This pull request can be merged automatically.

You are not authorized to merge this pull request.

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin m2-03-transcript-seek-decision:m2-03-transcript-seek-decision

git switch m2-03-transcript-seek-decision

Merge

Merge the changes and update on Forgejo.

Warning: The "Autodetect manual merge" setting is not enabled for this repository, you will have to mark this pull request as manually merged afterwards.

git switch main

git merge --no-ff m2-03-transcript-seek-decision

git switch m2-03-transcript-seek-decision

git rebase main

git switch main

git merge --ff-only m2-03-transcript-seek-decision

git switch m2-03-transcript-seek-decision

git rebase main

git switch main

git merge --no-ff m2-03-transcript-seek-decision

git switch main

git merge --squash m2-03-transcript-seek-decision

git switch main

git merge --ff-only m2-03-transcript-seek-decision

git switch main

git merge m2-03-transcript-seek-decision

git push origin main

No reviewers

No milestone

No project

No assignees

1 participant

Notifications

Due date

The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference

Stash/stash-docs!6

No description provided.

Rows
Columns