Skip to content

Prepare for tinycloud 0.3.11: connector source metadata + connectors inspect - #18

Merged
kdr merged 1 commit into
mainfrom
island-basket
Jul 16, 2026
Merged

Prepare for tinycloud 0.3.11: connector source metadata + connectors inspect#18
kdr merged 1 commit into
mainfrom
island-basket

Conversation

@kdr

@kdr kdr commented Jul 16, 2026

Copy link
Copy Markdown
Contributor

Summary

Stages the dist repo for tinycloud 0.3.11 (built from the private source repo with Cloudglue SDK 0.7.19 / API spec v0.7.9 — connector source metadata for all six metadata-bearing providers).

Version parity → 0.3.11 across package.json, .claude-plugin/plugin.json, .claude-plugin/marketplace.json (×2), tinycloud-skill.json skill_version, README pins, and CLAUDE.md examples + CDN prose.

Doc updates, two tiers:

Valid for the shipped 0.3.10 binary today (server-side behavior — flags pass through):

  • verbs.md: real per-connector filter matrix — --from/--to on every provider except S3/GCS (Zoom and Gong default to a 6-month lookback), --title-search on Grain/Zoom/Drive/Dropbox/Gong; synced files carry provider source_metadata from all six providers; filtered pages can come back short or empty while more remain — page until next_page_token is null
  • glossary.md: connector list corrected — Loom was never a connector (it syncs via direct URL ingestion); added the missing Gong and Recall

Gated on 0.3.11+ (needs the new binary):

  • library connectors inspect [<connector-id>] <uri-or-share-link> (feature library.connectors.inspect.v1) — provider-metadata peek without materializing a file; docs include the graceful-degradation path on older binaries (unknown-command error → fall back to idempotent connectors sync and read source_metadata from the envelope)
  • per-file provider metadata on connectors files rows

Floor decision: min_version stays 0.3.7, required_features unchanged — inspect is a convenience, not a core video op (same additive pattern as 0.3.8 hard clips and 0.3.10 login). Preflight untouched.

Contract delta for reference: verbs 16 → 16 (inspect is a library subcommand), features 31 → 32, command_spec_revision unchanged.

Do not merge until the live CDN serves 0.3.11 (channels.stable = 0.3.11 + pinned v0.3.11 tarballs/sidecars, generate-manifest --check green) — the live-CDN CI legs and the npm publish gate depend on it.

Test plan

  • npm test 42/42 (offline unit + skills + e2e-local)
  • claude plugin validate . green
  • scripts/smoke-test.sh 16/16 against a locally built 0.3.11 binary (EXPECTED_VERSION=0.3.11)
  • Live API verification with all 8 connector types connected: metadata rows (grain/zoom), zoom --from beyond the 6-month window, drive --title-search (folders exempt), inspect with auto-resolved and explicit connector ids, S3 rejected client-side
  • Released 0.3.10 binary confirmed: listing rows have no metadata field and connectors inspect fails cleanly — hence the 0.3.11+ gating above

Note

Low Risk
Distribution and documentation-only changes with no launcher logic edits; main operational risk is publishing or merging before CDN 0.3.11 artifacts exist.

Overview
Stages tinycloud 0.3.11 across package.json, Claude plugin/marketplace metadata, tinycloud-skill.json skill_version, README install pins, and maintainer examples in CLAUDE.md (smoke tests, fixture CDN, manifest checks, CDN stable channel prose).

Connector docs in verbs.md and glossary.md now cover SDK 0.7.19 behavior: synced files expose provider source_metadata for Grain, Zoom, Recall, Google Drive, Dropbox, and Gong; library connectors files rows can include per-item metadata on 0.3.11+; a clearer filter matrix (--from/--to, --title-search, Zoom/Gong six-month defaults, paging caveats); and library connectors inspect (feature library.connectors.inspect.v1) to peek metadata without creating a file, with fallback guidance for older binaries. The glossary drops Loom as a connector and adds Gong/Recall.

Compatibility unchanged: min_version stays 0.3.7 and required_features is untouched—inspect is documented as additive, not a new preflight gate. Verb count remains 16 (inspect is a library subcommand); contract notes features 31→32.

Merge is intended only after the live CDN serves 0.3.11 so live-CDN CI and npm publish gates pass.

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

…inspect

Version parity (package.json, plugin.json, marketplace.json, skill_version,
README pin, CLAUDE.md examples + CDN prose) for the 0.3.11 binary, plus doc
updates for the Cloudglue SDK 0.7.19 / spec v0.7.9 connector changes:

- verbs.md: real per-connector filter matrix (--from/--to on every provider
  except S3/GCS, Zoom+Gong 6-month lookback, --title-search on five
  providers), source_metadata populated by all six metadata-bearing
  providers on sync, filtered-pagination guidance (page until
  next_page_token is null) - all server-side, valid for 0.3.10 too
- verbs.md: `connectors inspect [<id>] <uri>` (0.3.11+, feature
  library.connectors.inspect.v1) - provider-metadata peek without creating
  a file, with a `connectors sync` fallback for older binaries; per-file
  provider `metadata` on `connectors files` rows (0.3.11+)
- glossary.md: connector list corrected (Loom was never a connector;
  added Gong and Recall)

Skill floor stays 0.3.7; required_features unchanged (additive pattern -
inspect is convenience, not a core video op).
@kdr
kdr requested a review from amyxst July 16, 2026 19:24
@kdr
kdr merged commit 65b7c64 into main Jul 16, 2026
7 checks passed
@kdr
kdr deleted the island-basket branch July 16, 2026 23:01
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.

2 participants