Skip to content

Prepare for tinycloud 0.3.16: truthful watch segmentation, collections --describe + pagination (skill floor → 0.3.16) - #24

Open
kdr wants to merge 1 commit into
mainfrom
prepare-0.3.16
Open

Prepare for tinycloud 0.3.16: truthful watch segmentation, collections --describe + pagination (skill floor → 0.3.16)#24
kdr wants to merge 1 commit into
mainfrom
prepare-0.3.16

Conversation

@kdr

@kdr kdr commented Jul 30, 2026

Copy link
Copy Markdown
Contributor

Documents the 0.3.16 binary across the skill surfaces:

  • verbs.md: data.segmentation now reports the segmentation that produced
    segments[] (pre-0.3.16 binaries mislabeled shots/chapters runs as
    uniform:20 — trust describe.primary_segmentation there), the
    degenerate-shots note on cut-less footage, collections create --describe
    (API default indexes speech+summary ONLY, immutable post-create), and
    collections show pagination (--limit/--page-token, data.total, page until
    next_page_token is null; pre-0.3.16 capped listings at 50 with a wrong
    has_more and a redacted token).
  • SKILL.md: --describe full in the collections cheat sheet with the
    speech-only-default warning.
  • Floor raised to 0.3.16 (min_version/preflight + 2 new required features:
    library.collections.describe.v1, library.collections.pagination.v1) —
    the skill teaches the new flag and pagination contract.
  • Version bumps: package.json, plugin.json, marketplace.json, README.

DO NOT MERGE until CDN channels.stable = 0.3.16 (the 0.3.15 merge-after-CDN
gate). Wrapper suite 42/42, plugin validate + shellcheck + metadata sync
pass locally.


Note

Low Risk
Documentation and version metadata only in this repo; no installer or launcher logic changes. Skill floor bump can block agents on binaries older than 0.3.16 until users upgrade.

Overview
Ships 0.3.16 across the npm package, Claude plugin metadata, and agent skills, with the skill compatibility floor raised to ≥0.3.16 and two new required feature ids: library.collections.describe.v1 and library.collections.pagination.v1.

Skill/docs now teach behaviors fixed in the 0.3.16 binary: watch’s data.segmentation matches the mode that produced segments[] (with segmentation_note on degenerate shots over cut-less footage), library collections create --describe for media-descriptions modality choice (default speech+summary only, immutable after create), and collections show offset pagination via --limit / --page-token with data.total, has_more, and a usable next_page_token. SKILL.md adds a --describe full example and the speech-only-default warning; CLAUDE.md records the release notes and merge-after-CDN gate.

Reviewed by Cursor Bugbot for commit 1a69573. Bugbot is set up for automated code reviews on this repo. Configure here.

…s --describe + pagination (skill floor → 0.3.16)

Documents the 0.3.16 binary across the skill surfaces:

- verbs.md: data.segmentation now reports the segmentation that produced
  segments[] (pre-0.3.16 binaries mislabeled shots/chapters runs as
  uniform:20 — trust describe.primary_segmentation there), the
  degenerate-shots note on cut-less footage, collections create --describe
  (API default indexes speech+summary ONLY, immutable post-create), and
  collections show pagination (--limit/--page-token, data.total, page until
  next_page_token is null; pre-0.3.16 capped listings at 50 with a wrong
  has_more and a redacted token).
- SKILL.md: --describe full in the collections cheat sheet with the
  speech-only-default warning.
- Floor raised to 0.3.16 (min_version/preflight + 2 new required features:
  library.collections.describe.v1, library.collections.pagination.v1) —
  the skill teaches the new flag and pagination contract.
- Version bumps: package.json, plugin.json, marketplace.json, README.

DO NOT MERGE until CDN channels.stable = 0.3.16 (the 0.3.15 merge-after-CDN
gate). Wrapper suite 42/42, plugin validate + shellcheck + metadata sync
pass locally.
@kdr
kdr requested a review from amyxst July 30, 2026 11:42
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