@cloudglue/tinycloud 0.3.7 → 0.3.8

package/README.md

@@ -17,11 +17,11 @@ The npm package is a small launcher: on first run it downloads the matching
 platform distribution from Cloudglue's CDN (cached under
 `~/.tinycloud/versions/<version>/`), verifies its checksum, and execs the real
 binary. The package version pins the binary version, so
-`npx @cloudglue/tinycloud@0.3.7` always runs tinycloud 0.3.7. It also adds two
+`npx @cloudglue/tinycloud@0.3.8` always runs tinycloud 0.3.8. It also adds two
 wrapper commands:
 
 ```bash
-tinycloud install --version 0.3.7   # pre-download a version
+tinycloud install --version 0.3.8   # pre-download a version
 tinycloud install --latest          # install latest stable and pin to it
 tinycloud update                    # move to latest stable, prune old versions
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cloudglue/tinycloud",
-  "version": "0.3.7",
+  "version": "0.3.8",
   "description": "Agent CLI for deep video and image work, by Cloudglue. Downloads the tinycloud binary on first run.",
   "bin": {
     "tinycloud": "bin/tinycloud.js"

package/skills/tinycloud/SKILL.md

@@ -127,6 +127,8 @@ tinycloud publish list --json
 tinycloud publish video ./demo.mp4 --visibility public --json
 # Share a single moment — also returns data.moment_url (0.3.5+)
 tinycloud publish video ./demo.mp4 --clip-start 18 --clip-end 33 --json
+# Hard clip — the share page plays ONLY the moment (0.3.8+)
+tinycloud publish video ./demo.mp4 --clip-start 18 --clip-end 33 --clip-only --json
 ```
 
 Per-verb details and all flags: [reference/verbs.md](reference/verbs.md).
@@ -203,7 +205,8 @@ Authoring your own recipes: [reference/workflow-authoring.md](reference/workflow
   `data.embed_snippet` (`<cg-video>`), which only plays on a private site of
   the same account. When writing HTML around an embed, use the component's
   built-ins (`autoplay`+`muted`, `loop`, `start-time`, `exclusive`,
-  `clip-start`/`clip-end` to frame one "back to moment" clip; JS
+  `clip-start`/`clip-end` to frame one "back to moment" clip — plus
+  `clip-only`, 0.3.8+, to play nothing but that window; JS
   `playSegment(start, end?)`) and the container components
   (`<cg-playlist>`, `<cg-grid>`, `<cg-chapters>`) rather than hand-rolled
   players, galleries, or segment-list JS — details in

package/skills/tinycloud/reference/glossary.md

@@ -108,12 +108,15 @@ connector?" or an envelope field needs explaining.
   an HLS stream; one active share per (file, visibility). Adding
   `--clip-start`/`--clip-end` (seconds, 0.3.5+) also returns `data.moment_url`,
   the share page bounded to that "back to moment" window (also reachable as
-  `?s=<start>&e=<end>` on a `share_url`). Private shares
+  `?s=<start>&e=<end>` on a `share_url`); adding `--clip-only` (0.3.8+,
+  feature `publish.video.moment.hard.v1`) upgrades it to a hard clip —
+  `&clip=hard`, the page plays only the moment. Private shares
   embed via the `data.embed_snippet` `<cg-video>` tag, which only plays on a
   private published site of the same account. The embed has playback
   attributes (`autoplay`+`muted`, `loop`, `start-time`, `poster`,
   `accent-color`, `exclusive`, and `clip-start`/`clip-end` to frame a single
-  "back to moment" clip) and a JS API (`playSegment`, `seekTo`, media
+  "back to moment" clip — `clip-only`, 0.3.8+, plays nothing but that
+  window) and a JS API (`playSegment`, `seekTo`, media
   events re-dispatched on the element) for custom site HTML, and plays
   standalone or inside the container components (`<cg-playlist>`,
   `<cg-grid>`, `<cg-chapters>`) — see reference/verbs.md.

package/skills/tinycloud/reference/verbs.md

@@ -313,7 +313,7 @@ generated site name, or your `--name` label.
 
 ```bash
 tinycloud publish video <source> [--visibility public|private]   # default public
-  [--name <title>] [--segment-id <id>] [--clip-start <s> --clip-end <e>] --json
+  [--name <title>] [--segment-id <id>] [--clip-start <s> --clip-end <e> [--clip-only]] --json
 tinycloud publish video list [--in <source>] [--visibility public|private] --json
 tinycloud publish video unpublish <share-id | source> --json   # --visibility disambiguates
 ```
@@ -340,6 +340,17 @@ feature id.
   private-share sign-in. Optional — omit it for a plain full-video share. The
   same window is just `?s=<start>&e=<end>` appended to a `share_url`, so you
   can hand-build a moment link from an existing share without re-publishing.
+- Hard clip (0.3.8+): add `--clip-only` to a `--clip-start`/`--clip-end` pair
+  (it requires both — the command errors before anything uploads) and
+  `data.moment_url` ends in `?s=<start>&e=<end>&clip=hard`: the share page
+  plays ONLY the moment (trimmed stream; the seek bar is the clip) instead of
+  the full video with a "back to moment" overlay. The flag survives the
+  pending → re-run flow (the `next` hint carries it), and the same suffix
+  works hand-built on an existing `share_url`. Gated by the
+  `publish.video.moment.hard.v1` feature id; older share pages ignore
+  `&clip=hard` and fall back to the soft window. It shapes the viewing
+  experience, not access control — anyone with the bare `share_url` still has
+  the whole video; restrict access with `--visibility private`.
 
 When generating custom site HTML around a `<cg-video>` embed, use the
 component's built-ins instead of reinventing them. It defaults to a
@@ -360,7 +371,13 @@ live playhead, snaps the first play to `clip-start`, and auto-pauses at
 "↺ Back to moment" pill — a manual scrub-out is never forced back. Both are
 required and `clip-end` is ignored unless it is greater than `clip-start`; the
 pair is `<cg-video>`-only (not read on `<cg-playlist-item>`/`<cg-grid-item>`).
-Rule of thumb: one moment → `clip-start`/`clip-end` on a `<cg-video>`; several
+Adding `clip-only` (embed v6, 0.3.8+) hardens the window: the player shows
+only the clip, with the timeline re-based to it — no badge, strip, or pill,
+because there is nothing to scrub back to. It is honored only alongside a
+valid `clip-start`/`clip-end` pair, and older embed scripts ignore it,
+degrading to the soft behavior above.
+Rule of thumb: one moment → `clip-start`/`clip-end` on a `<cg-video>`
+(`clip-only` if viewers should see nothing but the moment); several
 segments a viewer navigates between → `<cg-chapters>` (below).
 
 For multi-video or segment-navigation pages, prefer the container components

package/skills/tinycloud/tinycloud-skill.json

@@ -1,5 +1,5 @@
 {
-  "skill_version": "0.3.7",
+  "skill_version": "0.3.8",
   "tinycloud": {
     "min_version": "0.3.7",
     "supported_range": ">=0.3.7 <0.4.0",