Skip to content

Document v2.7.0 week 1: sync, scanner, retirements, Audible and Bridge core - #271

Merged
KodeStar merged 10 commits into
mainfrom
docs/v270-week1-rows
Nov 10, 2026
Merged

KodeStar merged 10 commits into
mainfrom
docs/v270-week1-rows

Conversation

@KodeStar

Copy link
Copy Markdown
Owner

Documents the v2.7.0 week 1 server and Bridge changes, following the User Guide readability rules.

  • Server (server#356, #357, #358):
    • The path cap's routes and order.
    • Sync v2: a finish marks its session.
    • Audible sync: preorders left out, the length rule, stale refusals ignored, drm_free, and audible_sign_in now sync-only.
    • Renditions: a timeout is remembered as a refusal.
    • Scanner: the in-process probe with --ffprobe "", slow shares leave a book whole, CJK search, and Health's plain unreadable line.
    • The retired launcher options, setup fields and admin enrichment route.
    • Household members signed out with the owner.
    • Smaller changes: library_grant 409, the /next folder fallback, the read-along -gz ETag, member name rules, OPML busy, unknown library kinds.
    • Migrations 0071 and 0073.
  • Bridge (bridge#63 and the Audible follow-ups PR):
    • Re-assert a place on Audible once, migration 0014, and the 14-day delivered-preorder cap.
    • Overlong matches, twins and bare series titles; coded poll refusals and drm_free.
    • The optional agent step, the light theme, a detect after a cancel keeping its transcript, the Jobs tab wording, and migration 0013.
  • User Guide: the same changes in plain words (Health, install without ffprobe, search, end of book, Audible, Add a Bridge, accounts, invites).
  • Screenshots: admin/health-issues.png, admin/bridge-setup.png and admin/settings-bridge-paired.png, recaptured with the agent step optional.

Verification: npm run build (broken links and anchors fail it). Review: /simplify and /code-review high, with every claim spot-checked against the server and Bridge code. That check corrected the path-cap route list and removed leftover launcher wording.

Merge after the Bridge's Audible follow-ups PR, which it also documents.

Pairs with KodeStar/audiosilo-server#356, #357, #358 and KodeStar/audiosilo-bridge#63.

Row 3 (server#284, #289, #291, #303, bridge#60's server part): a sync
finish marks its session, a late span keeps the session's speed; the
4096-byte path cap comes first and covers every path route; a timed-out
rendition is a remembered refusal; Audible sync leaves preorders out, uses
one length rule, ignores a stale refusal (0071), moves titles after the
places; drm_free is an import code and audible_sign_in only a sync's.

Row 5a (server#175, #178, #269, #272, #276): the in-process probe runs with
no ffprobe, bounded reads on a hung share keep a stored book whole, scan
revision 4, CJK search, Health's plain unreadable line, toolfetch fallbacks.

Row 5b (docs#235, server#179, #182, #190, #212, #254, #265, #285): the
launcher embedder API, the setup library fields and the admin enrichment PUT
retired; household members signed out with the owner; library_grant 409;
/next's pending folder; read-along gzip ETag; member name rules; OPML busy;
unknown library kinds and 0073.

Part of v2.7.0 week 1.
Row 4 (bridge#40, #43, #46, #51, #56, #60): a place the Audible app
overwrote is re-asserted once per written place (0014, reasserted); an
over-cap match goes out contested; twins aren't enriched; bare series
titles have no work key; a refused poll fails coded; drm_free; a delivered
preorder the library never lists drops after 14 days; filled_at unused.

Row 6 (bridge#13, #24, #31, #35, #36, #37): the agent setup item is
optional; a detect after a cancel takes up the cancelled chapters run;
give-way waits wake on a job end; the page follows the system colour
scheme; the Jobs tab names kinds in words and leads a park with its hint;
migration 0013.

Part of v2.7.0 week 1.
Lengths and chapters without ffprobe, Health's unreadable line and a share
that stops answering, Chinese and Japanese search, the next unscanned
folder after a series, household members signed out with a password
change or Sign out everywhere, the optional agent step and the Bridge
page's light theme, detecting chapters again after a cancel, and Audible's
DRM-free MP3 reason, preorder sync and the older-place re-assert.

Part of v2.7.0 week 1.
The stand-in Bridge's checklist marks the agent optional, as bridge#36 made
it (2 of 4 required steps done), and Health > Issues is captured from the
v2.7.0 scan branch, whose unreadable-file rows read as one plain line.

Part of v2.7.0 week 1.
The ffmpeg section said AudioSilo reads most files itself with no
condition, while the paragraph below tied that to FFmpeg 7.1 or 8.1.
With any other version ffprobe reads every file, so the opening line
now names ffprobe's job and the version paragraph carries the rule.
Merge the two optional-steps paragraphs on the Bridge page, reword the
next-folder sentence on the end-of-book page, drop "as before" from two
reference pages, and fix the paired Bridge screenshot hint to 3 of 4
required steps now that the agent step is optional.
The path cap section said every route taking a ?path= answers 400 path
is too long, the Bridge's Audible listening route included. That route
rejects the one event invalid instead, and the podcast routes and the
Bridge's ASIN enrichment answer their usual 400 invalid_request.
The settings locked row still listed the launcher reason, and the
engine table and the notification test still spoke of embedders, which
the launcher no longer supports since 2.7.0.
The console offers Details only for a probe failure; other unreadable
rows show their message inline.
Settings > Bridge still showed the agent step as required (4 of 5). Captured
again from server main, which has this week's changes, it reads 3 of 4 with
the agent step marked Optional, as admin/bridge-setup.png does.

Part of v2.7.0 week 1.
@KodeStar
KodeStar merged commit 526394d into main Nov 10, 2026
1 check passed
@KodeStar
KodeStar deleted the docs/v270-week1-rows branch November 10, 2026 09:03
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