Skip to content

fix: surface workspace, origin, and browser-init in hosted help - #464

Merged
ankitranjan7 merged 3 commits into
mainfrom
fix/discoverability-help
Aug 28, 2026
Merged

fix: surface workspace, origin, and browser-init in hosted help#464
ankitranjan7 merged 3 commits into
mainfrom
fix/discoverability-help

Conversation

@ankitranjan7

@ankitranjan7 ankitranjan7 commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

Cause

Hosted help hid workspace/session/site, unknown site commands omitted browser init, and list origin used a second vocabulary. Packed 0.7.9 also cannot parse command.origin unless Cloud gates it.

Contract

  • Hosted root help lists --workspace <id> (also WEBCMD_WORKSPACE), session, and site.
  • Unknown site command stderr includes To author this command: webcmd browser init <site>/<command>.
  • Reserved roots are WEBCMD_ROOT_COMMANDS plus hosted root-help names (tab is not reserved).
  • List origin strings match local formatCommandOrigin: builtin, plugin:<name>, local, override:<plugin>.
  • This CLI advertises hosted-command-origin-v1 on x-webcmd-client-capabilities so Cloud can include origin. Released 0.7.9 does not send that token.

Cross-repo

Depends on webcmd-cloud#80 to emit origin only for capable clients. Until that ships, this CLI still accepts origin when present and fills builtin for the default/client-owned package.

Tests

npx vitest run src/hosted/core-commands.test.ts src/hosted/client.test.ts src/hosted/manifest.test.ts — 178 passed.

Does not merge.

Expose --workspace/WEBCMD_WORKSPACE, list site/session at the root,
point missing site commands at browser init, and show list origin.
@github-actions

github-actions Bot commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

🟠 Maintainer review suggested — low confidence

The automated review could not reach a fully supported conclusion.

Limitations

  • The automated review returned an invalid structured result.

This review is advisory and does not block merging.

Reserved roots now follow WEBCMD_ROOT_COMMANDS plus hosted root help.
List origin uses builtin/plugin/local/override strings, not a second vocabulary.
Released 0.7.9 rejects extra command.origin. Request the field only
when this client can parse it.
@ankitranjan7
ankitranjan7 merged commit b021073 into main Aug 28, 2026
19 checks passed
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